make asciidoc and xmlto building git man pages

classic Classic list List threaded Threaded
2 messages Options
Reply | Threaded
Open this post in threaded view
|

make asciidoc and xmlto building git man pages

Karl Godt
Administrator
Git gives here : https://www.kernel.org/pub/software/scm/git/

I never got around some
# xmlto
  errors about could not load some http://...

FOR YEARS !!

Today I finally digged into it and behold :
 
xmlto
 is a shell script .


Make sure that this block of code looks like
[code]
# Make verbosity level uniformly available to called scripts
VERBOSE=1
export VERBOSE

# Disable network entities
XSLTOPTS="$XSLTOPTS"

# The names parameter for the XSLT stylesheet
XSLTPARAMS=""

# Enable XInclude
XSLTOPTS="$XSLTOPTS --xinclude"

SKIP_VALIDATION=1
[/code]

SKIP_VALIDATION had been always set to 0 which causes the first error
and
XSLTOPTS were set to XSLTOPTS="$XSLTOPTS --nonet"  

So getting the http://docbook.sourceforge.net/release/xsl/current/manpages/docbook.xsl was just not possible , even if installing all kinds of docbook-xml|xsl packages to all thinkable places in /usr or /usr/local .. LOL

/usr/bin/xsltproc   --xinclude \
 -o "/tmp/xmlto.B20103/git-grep.proc" \
 /tmp/xmlto-xsl.D20096 \
 "/root/Downloads/git-1.8.2.3/Documentation/git-grep.xml"
    ASCIIDOC git-gui.xml
    XMLTO git-gui.1
Source format: docbook / root element: nodes: 
Format script: /usr/share/xmlto/format/docbook/man
Convert to troff
Real stylesheet: http://docbook.sourceforge.net/release/xsl/current/manpages/docbook.xsl
Stylesheet: /tmp/xmlto-xsl.S21238

But this takes hours to finish .
Better download the already packed man or html pages from
https://www.kernel.org/pub/software/scm/git/
and drop them into --prefix=/PREFIX/share/man and ./doc and unpack them there .

 
Reply | Threaded
Open this post in threaded view
|

Re: make asciidoc and xmlto building git man pages

Karl Godt
Administrator
make man

has now finished ...

2 hours for 178 manual pages ...