'\" t
.\"     Title: DAPS
.\"    Author: Frank Sundermeyer <fsundermeyer@opensuse.org>
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\"      Date: 01/10/2020
.\"    Manual: daps
.\"    Source: DAPS @DAPS_VERSION@
.\"  Language: English
.\"
.TH "DAPS" "1" "01/10/2020" "DAPS @DAPS_VERSION@" "daps"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
daps-autobuild \- Automatically build books from several DAPS projects hosted on subversion or git\&.
.SH "SYNOPSIS"
.HP \w'\fBdaps\-autobuild\fR\ 'u
\fBdaps\-autobuild\fR {\-\-config\ \fIPATH_TO_CONFIG\-FILE\fR} [\fIOPTIONS\fR]
.SH "DESCRIPTION"
.PP
daps\-autobuild is designed to automatically build/rebuild documents from several DAPS projects hosted on subversion or git\&. The build results (HTML, single HTML, and/or PDF) can be copied to a remote server (using rsync)\&. If run regularly (e\&.g\&. via cron), rebuilds will only be triggered if changes in the project repository have occurred\&.
.PP
daps\-autobuild needs an XML configuration file providing all the data needed to build the books (see FIXME for details)\&. Specifying this file with
\fB\-\-config\fR
is mandatory\&. The script automatically validates the configuration file with each run\&. To manually validate the configuration file, use
\fB\-\-validate\fR\&.
.SH "OPTIONS"
.PP
\-\-config \fIPATH_TO_CONFIG\-FILE\fR
.RS 4
Path to config file\&. Can be specified relative or absolute\&. Default: unset
.RE
.PP
\-\-debug
.RS 4
In case of a build failure, show a verbose DAPS log\&. Default: disabled
.RE
.PP
\-\-force
.RS 4
Documents will only be rebuild when the git/svn repository has changed since the last build\&. Use this option to force a rebuild even when the repository has not changed\&. Default: disabled (rebuilds on changes only)
.RE
.PP
\-\-help
.RS 4
Display the script\*(Aqs help message\&.
.RE
.PP
\-\-helpconfig
.RS 4
Show help on the config file\&.
.RE
.PP
\-\-nosync
.RS 4
Do not rsync the manuals\&. Default: disabled (rsync will be done)
.RE
.PP
\-\-notify
.RS 4
In case of build failures send a notification to the e\-mail address specified with <maintainer/> in the config file\&. Will be ignored if maintainer is not set\&. Default: disabled (No notification e\-mails)
.RE
.PP
\-\-schema\fIPATH_TO_SCHEMA\-FILE\fR
.RS 4
Path to the schema used to validate the config file\&. Default: /usr/share/xml/daps/schema/daps\-autobuild\&.rnc
.RE
.PP
\-\-sections \fISECT1 SECT2 \&.\&.\&.\fR
.RS 4
Space\-separated list of sets that should be build\&. The sets need to be configured in the config file\&. Default: not set (all sets from the config file will be build)
.RE
.PP
\-\-validate
.RS 4
Validate the config file specified with \-\-config\&. Other options except \-\-schema will be ignored\&.
.RE
.SH "SEE ALSO"
.PP
\m[blue]\fB\%https://opensuse.github.io/daps/\fR\m[]
.RS 4
DAPS project homepage
.RE
.SH "AUTHOR"
.PP
\fBFrank Sundermeyer\fR <\&fsundermeyer@opensuse\&.org\&>
.RS 4
Developer
.RE