# having problems with building the manpages

3 messages from 2007-07-23 to 2007-07-24. Participants: VMiklos, Julian Phillips.
Thread: https://gitlist.dev/t/9180

## VMiklos, 2007-07-23 18:23

Subject: having problems with building the manpages
Message-ID: <20070723182319.GQ31655@genesis.frugalware.org>
URL: https://gitlist.dev/e/20070723182319.GQ31655%40genesis.frugalware.org

```
hi,

the man branch of git.git contains the following lines in git-diff.1:

EXAMPLES
       Various ways to check your working tree

              $ git diff            (1)
              $ git diff --cached   (2)
              $ git diff HEAD       (3)

              1. changes in the working tree not yet staged for the next commit.
              2. changes between the index and your last commit; what you would be committing if you run "git
              commit" without "-a" option.
              3. changes in the working tree since your last commit; what you would be committing if you run
              "git commit -a"

when building the manpages myself i get the followings:

EXAMPLES
       Various ways to check your working tree

               $ git diff            \fB(1)\fR
               $ git diff --cached   \fB(2)\fR
               $ git diff HEAD       \fB(3)\fR
           .sp \fB1. \fRchanges in the working tree not yet staged for the next commit.

           .br \fB2. \fRchanges between the index and your last commit; what you would be committing if you run
           "git commit" without "-a" option.

           .br \fB3. \fRchanges in the working tree since your last commit; what you would be committing if you
           run "git commit -a"

           .br

what can be the problem?

i have asciidoc-8.2.2 and docbook-xml 4.2 installed. i'm building with
ASCIIDOC8=YesPlease.

if i missed any required info, please mention :)

thanks,
- VMiklos

```

## Julian Phillips, 2007-07-23 18:40

Subject: Re: having problems with building the manpages
Message-ID: <Pine.LNX.4.64.0707231937210.32580@beast.quantumfyre.co.uk>
URL: https://gitlist.dev/e/Pine.LNX.4.64.0707231937210.32580%40beast.quantumfyre.co.uk
In-Reply-To: <20070723182319.GQ31655@genesis.frugalware.org>

```
On Mon, 23 Jul 2007, VMiklos wrote:

> hi,
>
> the man branch of git.git contains the following lines in git-diff.1:
>
> EXAMPLES
>       Various ways to check your working tree
>
>              $ git diff            (1)
>              $ git diff --cached   (2)
>              $ git diff HEAD       (3)
>
>              1. changes in the working tree not yet staged for the next commit.
>              2. changes between the index and your last commit; what you would be committing if you run "git
>              commit" without "-a" option.
>              3. changes in the working tree since your last commit; what you would be committing if you run
>              "git commit -a"
>
> when building the manpages myself i get the followings:
>
> EXAMPLES
>       Various ways to check your working tree
>
>               $ git diff            \fB(1)\fR
>               $ git diff --cached   \fB(2)\fR
>               $ git diff HEAD       \fB(3)\fR
>           .sp \fB1. \fRchanges in the working tree not yet staged for the next commit.
>
>           .br \fB2. \fRchanges between the index and your last commit; what you would be committing if you run
>           "git commit" without "-a" option.
>
>           .br \fB3. \fRchanges in the working tree since your last commit; what you would be committing if you
>           run "git commit -a"
>
>           .br
>
> what can be the problem?
>
> i have asciidoc-8.2.2 and docbook-xml 4.2 installed. i'm building with
> ASCIIDOC8=YesPlease.
>
> if i missed any required info, please mention :)

Are you using docbook xsl 1.72?  There are known problems building the 
manpages with that version.  1.71 works, and 1.73 should work when it get 
released.

-- 
Julian

  ---
Kirkland, Illinois, law forbids bees to fly over the village or through
any of its streets.

```

## VMiklos, 2007-07-24 07:38

Subject: Re: having problems with building the manpages
Message-ID: <20070724073819.GS31655@genesis.frugalware.org>
URL: https://gitlist.dev/e/20070724073819.GS31655%40genesis.frugalware.org
In-Reply-To: <Pine.LNX.4.64.0707231937210.32580@beast.quantumfyre.co.uk>

```
Hello,

Na Mon, Jul 23, 2007 at 07:40:04PM +0100, Julian Phillips <julian@quantumfyre.co.uk> pisal(a):
> Are you using docbook xsl 1.72?  There are known problems building the
> manpages with that version.  1.71 works, and 1.73 should work when it
> get released.

yes, i'm was uging 1.72. in the mentime 1.73 has been released, here is
the error i get when using it:

asciidoc -b docbook -d manpage -f asciidoc.conf \
                 -a asciidoc7compatible -agit_version=1.5.2.4 -o git-add.xml+ git-add.txt
mv git-add.xml+ git-add.xml
xmlto -m callouts.xsl man git-add.xml
runtime error: file file:///usr/share/xml/docbook/manpages/other.xsl line 129 element call-template
The called template 'read-character-map' was not found.
Note: meta date   : no date; using generated date                  git-add
Note: meta date   : see http://docbook.sf.net/el/date              git-add
runtime error: file file:///usr/share/xml/docbook/manpages/other.xsl line 537 element call-template
The called template 'apply-character-map' was not found.
Note: Writing git-add.1
error: file /var/tmp/fst/src/git-1.5.2.4/Documentation/git-add.xml
xsltRunStylesheet : run failed
make[1]: *** [git-add.1] Error 1
rm git-add.xml
make[1]: Leaving directory `/var/tmp/fst/src/git-1.5.2.4/Documentation'
make: *** [doc] Error 2

thanks,
- VMiklos

```
