From f6e360f6ca0b4e3b510f82546a1daada592b18b6 Mon Sep 17 00:00:00 2001 From: Guido Günther Date: Fri, 6 Oct 2017 12:01:32 +0200 Subject: manpages: reindent for better layout --- docs/Makefile | 3 + docs/manpages/gbp.conf.xml | 317 ++++++++++++++++++++++----------------------- 2 files changed, 161 insertions(+), 159 deletions(-) diff --git a/docs/Makefile b/docs/Makefile index ae8be4cd..e6e94c2c 100644 --- a/docs/Makefile +++ b/docs/Makefile @@ -49,6 +49,9 @@ $(MANUAL)/index.html: manual.xml chapters/*.xml manpages/*.xml common.ent $(VERS /usr/share/gtk-doc/data/*.css \ $(MANUAL) +$(MANUAL)/gbp.pdf: manual.xml chapters/*.xml manpages/*.xml common.ent $(VERSION_ENT) + xsltproc -o $(MANUAL)/ /usr/share/gtk-doc/data/gtk-doc.xsl $< + css: $(MANUAL)/gbp.css $(MANUAL)/gbp.svg $(MANUAL)/gbp.css $(MANUAL)/gbp.svg: gbp.css gbp.svg cp gbp.css gbp.svg $(MANUAL)/ diff --git a/docs/manpages/gbp.conf.xml b/docs/manpages/gbp.conf.xml index 322340d7..0e5dd978 100644 --- a/docs/manpages/gbp.conf.xml +++ b/docs/manpages/gbp.conf.xml @@ -58,152 +58,151 @@ sections. Comments start with a hash sign (). The overall layout is: - - [DEFAULT] - # This section is for global settings. Affects all commands. - # Options set here have the lowest priority. - key = value + + # This section is for global settings. Affects all commands. + # Options set here have the lowest priority. + key = value - [<command>] - # Specific sections for each command, like buildpackage - # Options set here have lower priority than command line options - key = value - [remote-config <name>] - # Specific sections for a remote configuration. This can be used several - # times to set up remote configuration for gbp create-remote-repo - key = value - - - The sections for each command are named like the command (without &gbp;) surrounded - by square brackets (e.g. ). - For backwards compatibility, command sections starting with git- or - gbp- are also supported but will provoke a warning when parsed by - &gbp;. - + # Specific sections for each command, like buildpackage + # Options set here have lower priority than command line options + key = value - - The keys in the - =value pairs are named - like the command-line options of the corresponding command (with the - '--' stripped off) and can hold the same values, but see below for - details. In case of &gbp-buildpackage; and &gbp-buildpackage-rpm; - the key needs '--git-' instead of '--' stripped off. - - - For example, - the manual page documents - the =directory - option which can be turned into configuration file setting by - dropping the - prefix: - + [remote-config <name>] + # Specific sections for a remote configuration. This can be used several + # times to set up remote configuration for gbp create-remote-repo + key = value + + + The sections for each command are named like the command (without &gbp;) surrounded + by square brackets (e.g. ). + For backwards compatibility, command sections starting with git- or + gbp- are also supported but will provoke a warning when parsed by + &gbp;. + - - [buildpackage] - export-dir = directory - + + The keys in the + =value pairs are named + like the command-line options of the corresponding command (with the + '--' stripped off) and can hold the same values, but see below for + details. In case of &gbp-buildpackage; and &gbp-buildpackage-rpm; + the key needs '--git-' instead of '--' stripped off. + + + For example, + the manual page documents + the =directory + option which can be turned into configuration file setting by + dropping the + prefix: + - - Options that can be repeated on the command line take Python-like - lists in the config file. For example, - the command has the - =pattern option - which can be turned into a configuration file option like this: - + + [buildpackage] + export-dir = directory + - - [import-orig] - filter = [ '.svn', '.hg' ] - + + Options that can be repeated on the command line take Python-like + lists in the config file. For example, + the command has the + =pattern option + which can be turned into a configuration file option like this: + - -Boolean options can be either or . For example, - has the and - options which translate to: - - - [import-orig] - pristine-tar = True - + + [import-orig] + filter = [ '.svn', '.hg' ] + -and + + Boolean options can be either or . For example, + has the and + options which translate to: + + + [import-orig] + pristine-tar = True + + + and - - [import-orig] - pristine-tar = False - -respectively. - - - To see the current set of values that would be applied after parsing the - configuration files, use . - - - - - gbp import-dscs and git-pbuilder -can't be configured via gbp.conf. - - + + [import-orig] + pristine-tar = False + + respectively. + + + To see the current set of values that would be applied after parsing the + configuration files, use . + + + + + gbp import-dscs and git-pbuilder + can't be configured via gbp.conf. + + - - can additionally parse remote site -configurations from gbp.conf. For example, a configuration like: - + + can additionally parse remote site + configurations from gbp.conf. For example, a configuration like: + - -[remote-config pkg-libvirt] -# Location of the repository -remote-url-pattern = ssh://git.debian.org/git/pkg-libvirt/%(pkg)s -# Template dir to passed to git-init -template-dir = /srv/alioth.debian.org/chroot/home/groups/pkg-libvirt/git-template - + + [remote-config pkg-libvirt] + # Location of the repository + remote-url-pattern = ssh://git.debian.org/git/pkg-libvirt/%(pkg)s + # Template dir to passed to git-init + template-dir = /srv/alioth.debian.org/chroot/home/groups/pkg-libvirt/git-template + - -can be used to create remote repositories for the pkg-libvirt project using: - + + can be used to create remote repositories for the pkg-libvirt project using: + - -gbp-create-remote-repo --remote-config=pkg-libvirt - + + gbp-create-remote-repo --remote-config=pkg-libvirt + - -This can be useful if you're often creating new remote repositories for -different projects. - + + This can be useful if you're often creating new remote repositories for + different projects. + EXAMPLES - -An example set up for packaging work: - + + An example set up for packaging work: + - - # $HOME/.gbp.conf + + # $HOME/.gbp.conf - [DEFAULT] - pristine-tar = True - cleaner = fakeroot debian/rules clean + [DEFAULT] + pristine-tar = True + cleaner = fakeroot debian/rules clean - [buildpackage] - export-dir = ../build-area/ + [buildpackage] + export-dir = ../build-area/ - [import-orig] - dch = False - filter = [ + [import-orig] + dch = False + filter = [ '.svn', '.hg', '.bzr', 'CVS', 'debian/*', '*/debian/*' - ] - filter-pristine-tar = True + ] + filter-pristine-tar = True - [import-dsc] - filter = [ + [import-dsc] + filter = [ 'CVS', '.cvsignore', '.hg', @@ -211,59 +210,59 @@ An example set up for packaging work: '.bzr', '.bzrignore', '.gitignore' - ] + ] - # End of file - - + # End of file + + - - ENVIRONMENT - + + ENVIRONMENT + - GBP_CONF_FILES - Colon separated list of files to parse. The default is -the above list of configuration files. + GBP_CONF_FILES + Colon separated list of files to parse. The default is + the above list of configuration files. GBP_DISABLE_SECTION_DEPRECTATION Don't print a deprecation warning when &gbp; - encounters a section starting - with git- - or gbp-. + encounters a section starting + with git- + or gbp-. - - + + - - FILES - - See /etc/git-buildpackage/gbp.conf for an example. - - + + FILES + + See /etc/git-buildpackage/gbp.conf for an example. + + - - SEE ALSO - - , - , - , - , - , - , - , - , - - The Git-Buildpackage Manual - - - - AUTHORS - &dhusername; &dhemail; - This manual page is based on a POD version by Jari Aalto jari.aalto@cante.net. - Released under license GNU GPL version 2 or (at your option) any later. + + SEE ALSO + + , + , + , + , + , + , + , + , + + The Git-Buildpackage Manual + + + + AUTHORS + &dhusername; &dhemail; + This manual page is based on a POD version by Jari Aalto jari.aalto@cante.net. + Released under license GNU GPL version 2 or (at your option) any later. version. - + -- cgit v1.2.3