Re: how to build Documentation/DocBook/
On Fri, Jul 17, 2015 at 6:18 AM, Luis de Bethencourt
l...@debethencourt.com wrote:
On 17 July 2015 at 13:40, Ahmed Soliman ahmedsoliman0x...@gmail.com wrote:
I have fresh kernel downloaded by git and I want to know how to build
Documentation/DocBook/ as pdf I have tried
make pdfdocs output
but I got those warnings
Warning(.//include/linux/init.h): no structured comments found
Warning(.//kernel/sys.c): no structured comments found
Warning(.//drivers/dma-buf/seqno-fence.c): no structured comments found
Warning(.//drivers/dma-buf/reservation.c): no structured comments found
Warning(.//include/linux/reservation.h): no structured comments found
Warning(.//include/linux/hsi/hsi.h:150): Excess
struct/union/enum/typedef member 'e_handler' description in
'hsi_client'
Warning(.//include/linux/hsi/hsi.h:150): Excess
struct/union/enum/typedef member 'pclaimed' description in
'hsi_client'
Warning(.//include/linux/hsi/hsi.h:150): Excess
struct/union/enum/typedef member 'nb' description in 'hsi_client'
make[1]: *** [Documentation/DocBook/kernel-hacking.pdf] Error 9
make: *** [pdfdocs] Error 2
and the file output look like this
Which Kernel version are you using? It looks like your error has been fixed
by:
https://git.kernel.org/cgit/linux/kernel/git/torvalds/linux.git/commit/?id=9e39dc1e563e8d390bae42ee80e1e665c18b7de2
Unfortunately. make pdfdocs fails when building DocBook/scsi.pdf in the
latest stable release (4.1.2)
I've been trying to run make pdfdocs with the 4.2-rc3 tree, on Arch
Linux, Fedora 22, and Ubuntu 15.04. A plain 'make pdfdocs' fails on
all of them.
For Arch and Fedora, I've gotten a little further by installing
dblatex (which isn't a default package) and running the ungainly
command
make POSTARGS='--verbose --debug' POSTPOSTARGS='--verbose --debug'
XMLTOFLAGS='-vv -m Documentation/DocBook/stylesheet.xsl
--skip-validation --with-dblatex' pdfdocs
but while that chugged through several books, it failed with
pdflatex -interaction=batchmode filesystems.tex
pdflatex failed
filesystems.tex:9322: Paragraph ended before \@citex was complete.
filesystems.tex:9325: Too many }'s.
filesystems.tex:9325: leading text: }
filesystems.tex:9328: Paragraph ended before \@citex was complete.
filesystems.tex:9331: Too many }'s.
filesystems.tex:9331: leading text:}
and examining the generated TeX file, it does look like a paragraph problem:
\label{see_also}\hyperlabel{see_also}%
\cite{
Journaling the Linux ext2fs Filesystem, LinuxExpo 98, Stephen T$
}
\cite{
Ext3 Journalling FileSystem, OLS 2000, Dr. Stephen Tweedie
}
After fiddling with Documentation/DocBook/filesystems.tmpl to squish
some newlines,
diff --git a/Documentation/DocBook/filesystems.tmpl
b/Documentation/DocBook/filesystems.tmpl
index bcdfdb9a92770..44a0afe5bfb72 100644
--- a/Documentation/DocBook/filesystems.tmpl
+++ b/Documentation/DocBook/filesystems.tmpl
@@ -385,18 +385,12 @@ an example.
sect1 id=see_also
titleSee also/title
para
- citation
- ulink
url=http://kernel.org/pub/linux/kernel/people/sct/ext3/journal-design.ps.gz;
- Journaling the Linux ext2fs Filesystem, LinuxExpo 98,
Stephen Tweedie
- /ulink
- /citation
+ citationulink
url=http://kernel.org/pub/linux/kernel/people/sct/ext3/journal-design.ps.gz;
+ Journaling the Linux ext2fs Filesystem, LinuxExpo 98,
Stephen Tweedie/ulink/citation
/para
para
- citation
- ulink
url=http://olstrans.sourceforge.net/release/OLS2000-ext3/OLS2000-ext3.html;
- Ext3 Journalling FileSystem, OLS 2000, Dr. Stephen Tweedie
- /ulink
- /citation
+ citationulink
url=http://olstrans.sourceforge.net/release/OLS2000-ext3/OLS2000-ext3.html;
+ Ext3 Journalling FileSystem, OLS 2000, Dr. Stephen
Tweedie/ulink/citation
/para
/sect1
filesystems.pdf built, but...
pdflatex -interaction=batchmode drm.tex
pdflatex failed
drm.tex:18707: Illegal unit of measure (pt inserted).
drm.tex:18707: leading text: \setlength{\tabcolsep}{0}
drm.tex:18710: Package array Error: Empty preamble: `l' used.
drm.tex:18710: leading text: \begin{tabular}{}
so again there's some sort of bogus TeX being generated, and this time
I didn't see an obvious fix.
Jim
___
Kernelnewbies mailing list
Kernelnewbies@kernelnewbies.org
http://lists.kernelnewbies.org/mailman/listinfo/kernelnewbies
how to build Documentation/DocBook/
I have fresh kernel downloaded by git and I want to know how to build
Documentation/DocBook/ as pdf I have tried
make pdfdocs output
but I got those warnings
Warning(.//include/linux/init.h): no structured comments found
Warning(.//kernel/sys.c): no structured comments found
Warning(.//drivers/dma-buf/seqno-fence.c): no structured comments found
Warning(.//drivers/dma-buf/reservation.c): no structured comments found
Warning(.//include/linux/reservation.h): no structured comments found
Warning(.//include/linux/hsi/hsi.h:150): Excess
struct/union/enum/typedef member 'e_handler' description in
'hsi_client'
Warning(.//include/linux/hsi/hsi.h:150): Excess
struct/union/enum/typedef member 'pclaimed' description in
'hsi_client'
Warning(.//include/linux/hsi/hsi.h:150): Excess
struct/union/enum/typedef member 'nb' description in 'hsi_client'
make[1]: *** [Documentation/DocBook/kernel-hacking.pdf] Error 9
make: *** [pdfdocs] Error 2
and the file output look like this
DOCPROC Documentation/DocBook/z8530book.xml
PDF Documentation/DocBook/z8530book.pdf
Using catalogs: /etc/sgml/catalog
Using stylesheet: /usr/share/docbook-utils/docbook-utils.dsl#print
Working on: /home/oddcoder/linux/Documentation/DocBook/z8530book.xml
Done.
DOCPROC Documentation/DocBook/device-drivers.xml
PDF Documentation/DocBook/device-drivers.pdf
Using catalogs: /etc/sgml/catalog
Using stylesheet: /usr/share/docbook-utils/docbook-utils.dsl#print
Working on: /home/oddcoder/linux/Documentation/DocBook/device-drivers.xml
Done.
DOCPROC Documentation/DocBook/kernel-hacking.xml
PDF Documentation/DocBook/kernel-hacking.pdf
Using catalogs: /etc/sgml/catalog
Using stylesheet: /usr/share/docbook-utils/docbook-utils.dsl#print
Working on: /home/oddcoder/linux/Documentation/DocBook/kernel-hacking.xml
This is pdfTeX, Version 3.1415926-2.5-1.40.14 (TeX Live 2013/Debian)
restricted \write18 enabled.
entering extended mode
(/home/oddcoder/linux/Documentation/DocBook/kernel-hacking.tex
JadeTeX 2003/04/27: 3.13
(/usr/share/texlive/texmf-dist/tex/latex/psnfss/t1ptm.fd)
Elements will be labelled
Jade begin document sequence at 20
No file kernel-hacking.aux.
(/usr/share/texmf/tex/latex/tipa/t3ptm.fd)
(/usr/share/texlive/texmf-dist/tex/latex/base/ts1cmr.fd)
(/usr/share/texlive/texmf-dist/tex/context/base/supp-pdf.mkii
[Loading MPS to PDF converter (version 2006.09.02).]
) (/usr/share/texlive/texmf-dist/tex/latex/oberdiek/epstopdf-base.sty
(/usr/share/texlive/texmf-dist/tex/latex/oberdiek/grfext.sty)
(/usr/share/texlive/texmf-dist/tex/latex/latexconfig/epstopdf-sys.cfg))
(/usr/share/texlive/texmf-dist/tex/latex/hyperref/nameref.sty
(/usr/share/texlive/texmf-dist/tex/generic/oberdiek/gettitlestring.sty))
(/usr/share/texlive/texmf-dist/tex/latex/psnfss/t1phv.fd) [1.0.30{/var/lib/texm
f/fonts/map/pdftex/updmap/pdftex.map}]
(/usr/share/texlive/texmf-dist/tex/latex/psnfss/ts1ptm.fd) [2.0.30]
Package Fancyhdr Warning: \fancyfoot's `E' option without twoside option is use
less on input line 315.
LaTeX Warning: Reference `0:introduction' on page iii undefined on input line 3
72.
LaTeX Warning: Reference `0:basic-players' on page iii undefined on input line
406.
LaTeX Warning: Reference `0:basics-usercontext' on page iii undefined on input
line 432.
LaTeX Warning: Reference `0:basics-hardirqs' on page iii undefined on input lin
e 457.
LaTeX Warning: Reference `0:basics-softirqs' on page iii undefined on input lin
e 482.
LaTeX Warning: Reference `0:basic-rules' on page iii undefined on input line 51
6.
LaTeX Warning: Reference `0:ioctls' on page iii undefined on input line 550.
LaTeX Warning: Reference `0:deadlock-recipes' on page iii undefined on input li
ne 584.
LaTeX Warning: Reference `0:common-routines' on page iii undefined on input lin
e 618.
(/usr/share/texlive/texmf-dist/tex/latex/psnfss/t1pcr.fd)
LaTeX Warning: Reference `0:routines-printk' on page iii undefined on input lin
e 655.
LaTeX Warning: Reference `0:routines-copy' on page iii undefined on input line
705.
LaTeX Warning: Reference `0:routines-kmalloc' on page iii undefined on input li
ne 746.
LaTeX Warning: Reference `0:routines-current' on page iii undefined on input li
ne 782.
LaTeX Warning: Reference `0:routines-udelay' on page iii undefined on input lin
e 829.
LaTeX Warning: Reference `0:routines-endian' on page iii undefined on input lin
e 880.
LaTeX Warning: Reference `0:routines-local-irqs' on page iii undefined on input
line 921.
LaTeX Warning: Reference `0:routines-softirqs' on page iii undefined on input l
ine 962.
LaTeX Warning: Reference `0:routines-processorids' on page iii undefined on inp
ut line 998.
LaTeX Warning: Reference `0:routines-init' on page iii undefined on input line
1041.
LaTeX Warning: Reference `0:routines-init-again' on page iii undefined on input
line 1082.
LaTeX Warning: Reference `0:routines-moduleexit' on page iii undefined on input
line 1118.
LaTeX Warning: Reference `0:routines-module-use-counters
Re: how to build Documentation/DocBook/
On 17 July 2015 at 13:40, Ahmed Soliman ahmedsoliman0x...@gmail.com wrote: I have fresh kernel downloaded by git and I want to know how to build Documentation/DocBook/ as pdf I have tried make pdfdocs output but I got those warnings Warning(.//include/linux/init.h): no structured comments found Warning(.//kernel/sys.c): no structured comments found Warning(.//drivers/dma-buf/seqno-fence.c): no structured comments found Warning(.//drivers/dma-buf/reservation.c): no structured comments found Warning(.//include/linux/reservation.h): no structured comments found Warning(.//include/linux/hsi/hsi.h:150): Excess struct/union/enum/typedef member 'e_handler' description in 'hsi_client' Warning(.//include/linux/hsi/hsi.h:150): Excess struct/union/enum/typedef member 'pclaimed' description in 'hsi_client' Warning(.//include/linux/hsi/hsi.h:150): Excess struct/union/enum/typedef member 'nb' description in 'hsi_client' make[1]: *** [Documentation/DocBook/kernel-hacking.pdf] Error 9 make: *** [pdfdocs] Error 2 and the file output look like this Which Kernel version are you using? It looks like your error has been fixed by: https://git.kernel.org/cgit/linux/kernel/git/torvalds/linux.git/commit/?id=9e39dc1e563e8d390bae42ee80e1e665c18b7de2 Unfortunately. make pdfdocs fails when building DocBook/scsi.pdf in the latest stable release (4.1.2) Luis ___ Kernelnewbies mailing list Kernelnewbies@kernelnewbies.org http://lists.kernelnewbies.org/mailman/listinfo/kernelnewbies
