From: Johannes Schindelin Date: Mon, 19 Nov 2007 13:35:43 GMT Subject: Re: [PATCH] Documentation: fix git-clone manpage not to refer to itself Message-ID: In-Reply-To: <87ejeq1131.fsf@osv.gnss.ru> Hi, On Fri, 16 Nov 2007, Sergei Organov wrote: > +ifndef::git-clone[] It is laudable that you want to fix the _generated_ documentation, but there are two things to keep in mind: - it does _nothing_ to help readers of the sources, and asciidoc was chosen purposely because the source is human-readable, and - it makes writing the perl script to do a very tiny subset of asciidoc formatting much harder. We encounter enough problems with the different versions of asciidoc/docbook combinations that I think this perl script would be actually useful. I know that the user manual uses some advanced features, too, but it did not use ifdef in the main text, for example, let alone nested ifdefs, which your patch would encourage much more than the source before. Ciao, Dscho