On Fri, Mar 02, 2012 at 09:47:55AM +0200, jaalto wrote: > On 2012-03-01 22:31, Guido Günther wrote: > | > | > I'd like to propose a manual page for gbp.conf file. > | > | Thanks for your report. Since the options are identical to the command > | line options I wonder if we really need a separate man page? > > Ah, in that case the page will be easier to write. > > | Maybe we need to point out more clearly that the command line > | options can also be given in gbp.conf and mark those which can't? > > I still think separate gbp.conf could clarify things. I was thinking > something along line: > > > NAME > > SYNOPSIS > > DESCRIPTION > > <Explain the file syntax. What the SECTION names are: > a special "DEFAULT", then according to each COMMAND. > Explain that key=value pairs is COMMAND sections are > derived from each command's options. Explain comment > marker '#' etc.> > > [section name] > <option> = value > > Special notes... like, that "filter"option can be > defined in multiple ways To cumulatively add more > excludes: > > filter = .svn > filter = .bzr > > Or use the Python way: > > filter = [ '.svn', '.bzr' ] > > EXAMPLES > > > <Present a typical gbp.conf file> > Yes, it makes sense and is indeed very useful. Care enough to send a patch? Cheers, -- Guido
-- To UNSUBSCRIBE, email to debian-bugs-dist-requ...@lists.debian.org with a subject of "unsubscribe". Trouble? Contact listmas...@lists.debian.org
