threads / discuss / 9180

having problems with building the manpages

Subject: having problems with building the manpages

## tl;dr

3 messages between Jul 23, 2007 and Jul 24, 2007.

replies: 2people: 2as markdown or json

VMiklos· Jul 23, 2007, 18:23 UTC · lore

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· Jul 23, 2007, 18:40 UTC · re: VMiklos · lore

Re: having problems with building the manpages

On Mon, 23 Jul 2007, VMiklos wrote:

Show 41 quoted lines

> 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· Jul 24, 2007, 07:38 UTC · re: Julian Phillips · lore

Re: having problems with building the manpages

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