All of lore.kernel.org
 help / color / mirror / Atom feed
* how to build Documentation/DocBook/
@ 2015-07-17 12:40 Ahmed Soliman
  2015-07-17 13:18 ` Luis de Bethencourt
  0 siblings, 1 reply; 3+ messages in thread
From: Ahmed Soliman @ 2015-07-17 12:40 UTC (permalink / raw)
  To: kernelnewbies

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' on page iii undefined
 on input line 1159.


LaTeX Warning: Reference `0:queues' on page iii undefined on input line 1199.


LaTeX Warning: Reference `0:queue-declaring' on page iii undefined on input lin
e 1225.


LaTeX Warning: Reference `0:queue-waitqueue' on page iii undefined on input lin
e 1250.


LaTeX Warning: Reference `0:queue-waking' on page iii undefined on input line 1
275.


LaTeX Warning: Reference `0:atomic-ops' on page iii undefined on input line 130
9.


LaTeX Warning: Reference `0:symbols' on page iii undefined on input line 1343.


LaTeX Warning: Reference `0:sym-exportsymbols' on page iii undefined on input l
ine 1380.


LaTeX Warning: Reference `0:sym-exportsymbols-gpl' on page iii undefined on inp
ut line 1416.


LaTeX Warning: Reference `0:conventions' on page iii undefined on input line 14
50.


LaTeX Warning: Reference `0:conventions-doublelinkedlist' on page iii undefined
 on input line 1482.


LaTeX Warning: Reference `0:convention-returns' on page iii undefined on input
line 1507.


LaTeX Warning: Reference `0:conventions-borkedcompile' on page iii undefined on
 input line 1532.


LaTeX Warning: Reference `0:conventions-initialising' on page iii undefined on
input line 1557.


LaTeX Warning: Reference `0:conventions-gnu-extns' on page iii undefined on inp
ut line 1582.


LaTeX Warning: Reference `0:conventions-cplusplus' on page iii undefined on inp
ut line 1607.


LaTeX Warning: Reference `0:conventions-ifdef' on page iii undefined on input l
ine 1632.


LaTeX Warning: Reference `0:submitting' on page iii undefined on input line 166
6.


LaTeX Warning: Reference `0:cantrips' on page iii undefined on input line 1700.



LaTeX Warning: Reference `0:credits' on page iii undefined on input line 1734.


Package Fancyhdr Warning: \fancyfoot's `E' option without twoside option is use
less on input line 1734.

[3.0.30]

Package Fancyhdr Warning: \fancyfoot's `E' option without twoside option is use
less on input line 1825.


Package Fancyhdr Warning: \fancyhead's `E' option without twoside option is use
less on input line 1825.


Package Fancyhdr Warning: \fancyfoot's `E' option without twoside option is use
less on input line 1917.

pdfTeX warning (ext4): destination with the same identifier (name{page.1}) has
been already used, duplicate ignored
<to be read again>
                   \relax
l.1917   \endPar{}\endNode{}\endSeq{}\endSpS
                                            {}\endNode{}\Node% [1.0.30]

Package Fancyhdr Warning: \fancyfoot's `E' option without twoside option is use
less on input line 2004.


Package Fancyhdr Warning: \fancyhead's `E' option without twoside option is use
less on input line 2004.


Package Fancyhdr Warning: \fancyfoot's `E' option without twoside option is use
less on input line 2499.

pdfTeX warning (ext4): destination with the same identifier (name{page.2}) has
been already used, duplicate ignored
<to be read again>
                   \relax
l.2499    \endPar{}
                   \endNode{}\Node% [2.0.30] [3.0.30]

Package Fancyhdr Warning: \fancyfoot's `E' option without twoside option is use
less on input line 2978.


Package Fancyhdr Warning: \fancyhead's `E' option without twoside option is use
less on input line 2978.


Package Fancyhdr Warning: \fancyfoot's `E' option without twoside option is use
less on input line 3217.

[4.0.30]

Package Fancyhdr Warning: \fancyfoot's `E' option without twoside option is use
less on input line 3304.


Package Fancyhdr Warning: \fancyhead's `E' option without twoside option is use
less on input line 3304.


Package Fancyhdr Warning: \fancyfoot's `E' option without twoside option is use
less on input line 3601.

[5.0.30]

Package Fancyhdr Warning: \fancyfoot's `E' option without twoside option is use
less on input line 3688.


Package Fancyhdr Warning: \fancyhead's `E' option without twoside option is use
less on input line 3688.


Package Fancyhdr Warning: \fancyfoot's `E' option without twoside option is use
less on input line 3908.

[6.0.30]

Package Fancyhdr Warning: \fancyfoot's `E' option without twoside option is use
less on input line 3995.


Package Fancyhdr Warning: \fancyhead's `E' option without twoside option is use
less on input line 3995.


Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding):
(hyperref)                removing `subscript' on input line 4357.


Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding):
(hyperref)                removing `subscript' on input line 4357.


Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding):
(hyperref)                removing `subscript' on input line 4357.


Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding):
(hyperref)                removing `subscript' on input line 4357.


Package Fancyhdr Warning: \fancyfoot's `E' option without twoside option is use
less on input line 4459.

[7.0.30] [8.0.30]

Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding):
(hyperref)                removing `subscript' on input line 5193.


Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding):
(hyperref)                removing `subscript' on input line 5193.


Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding):
(hyperref)                removing `subscript' on input line 5193.


Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding):
(hyperref)                removing `subscript' on input line 5193.


Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding):
(hyperref)                removing `subscript' on input line 5193.


Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding):
(hyperref)                removing `subscript' on input line 5193.


Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding):
(hyperref)                removing `subscript' on input line 5193.


Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding):
(hyperref)                removing `subscript' on input line 5193.


Overfull \hbox (31.63298pt too wide) in paragraph at lines 5161--5193
\T1/pcr/b/n/15.552 cpu_to_be32()\T1/phv/b/n/17.28 /\T1/pcr/b/n/15.552 be32_to_c
pu()\T1/phv/b/n/17.28 /\T1/pcr/b/n/15.552 cpu_to_le32()\T1/phv/b/n/17.28 /\T1/p
cr/b/n/15.552 le32_to_cpu()

Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding):
(hyperref)                removing `subscript' on input line 5314.


Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding):
(hyperref)                removing `subscript' on input line 5314.


Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding):
(hyperref)                removing `subscript' on input line 5314.


Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding):
(hyperref)                removing `subscript' on input line 5314.

[9.0.30]

Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding):
(hyperref)                removing `subscript' on input line 5409.


Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding):
(hyperref)                removing `subscript' on input line 5409.


Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding):
(hyperref)                removing `subscript' on input line 5409.


Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding):
(hyperref)                removing `subscript' on input line 5409.


Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding):
(hyperref)                removing `subscript' on input line 5486.


Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding):
(hyperref)                removing `subscript' on input line 5486.


Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding):
(hyperref)                removing `subscript' on input line 5601.


Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding):
(hyperref)                removing `subscript' on input line 5601.


Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding):
(hyperref)                removing `subscript' on input line 5601.


Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding):
(hyperref)                removing `subscript' on input line 5601.


Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding):
(hyperref)                removing `subscript' on input line 5601.


Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding):
(hyperref)                removing `subscript' on input line 5601.


Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding):
(hyperref)                removing `subscript' on input line 5703.


Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding):
(hyperref)                removing `subscript' on input line 5703.


Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding):
(hyperref)                removing `subscript' on input line 5703.

[10.0.30]

Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding):
(hyperref)                removing `subscript' on input line 5845.


Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding):
(hyperref)                removing `subscript' on input line 5946.


Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding):
(hyperref)                removing `subscript' on input line 5946.


Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding):
(hyperref)                removing `subscript' on input line 5946.

[11.0.30]

Package Fancyhdr Warning: \fancyfoot's `E' option without twoside option is use
less on input line 6112.


Package Fancyhdr Warning: \fancyhead's `E' option without twoside option is use
less on input line 6112.


Package Fancyhdr Warning: \fancyfoot's `E' option without twoside option is use
less on input line 6462.

[12.0.30]

Package Fancyhdr Warning: \fancyfoot's `E' option without twoside option is use
less on input line 6549.


Package Fancyhdr Warning: \fancyhead's `E' option without twoside option is use
less on input line 6549.


Package Fancyhdr Warning: \fancyfoot's `E' option without twoside option is use
less on input line 6787.

[13.0.30]

Package Fancyhdr Warning: \fancyfoot's `E' option without twoside option is use
less on input line 6874.


Package Fancyhdr Warning: \fancyhead's `E' option without twoside option is use
less on input line 6874.


Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding):
(hyperref)                removing `subscript' on input line 7000.


Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding):
(hyperref)                removing `subscript' on input line 7074.


Package hyperref Warning: Token not allowed in a PDF string (PDFDocEncoding):
(hyperref)                removing `subscript' on input line 7074.


Package Fancyhdr Warning: \fancyfoot's `E' option without twoside option is use
less on input line 7113.

[14.0.30]

Package Fancyhdr Warning: \fancyfoot's `E' option without twoside option is use
less on input line 7200.


Package Fancyhdr Warning: \fancyhead's `E' option without twoside option is use
less on input line 7200.


Package Fancyhdr Warning: \fancyfoot's `E' option without twoside option is use
less on input line 7633.

[15.0.30]
! Undefined control sequence.
\Hy at wrapper@babel ...set at display@protect \edef \x
                                                  {#2}\@onelevel at sanitize \x...
l.8111 \endHeadPar{}
                    \endSeq{}\Node%
! Argument of \HyWrap at new@pdflink has an extra }.
<inserted text>
                \par
l.8111 \endHeadPar{}
                    \endSeq{}\Node%
Runaway argument?
! Paragraph ended before \HyWrap at new@pdflink was complete.
<to be read again>
                   \par
l.8111 \endHeadPar{}
                    \endSeq{}\Node%
! Extra \else.
\endHeadPar ...headingTwo}{1}{\HeadingText }\else
                                                  \ifnum \HeadingLevel =3\ad...
l.8111 \endHeadPar{}
                    \endSeq{}\Node%
! Use of \\pdfbookmark doesn't match its definition.
\SetupICs ...mName \endcsname \fi }}\set at fontsize
                                                  \baselinestretch {\fSize }...
l.8129 {1}}

! Use of \\pdfbookmark doesn't match its definition.
\SetupICs ...mName \endcsname \fi }}\set at fontsize
                                                  \baselinestretch {\fSize }...
l.8148 {0}}

! Use of \\pdfbookmark doesn't match its definition.
\SetupICs ...mName \endcsname \fi }}\set at fontsize
                                                  \baselinestretch {\fSize }...
l.8161 {}\endSeq{}}

! Use of \\pdfbookmark doesn't match its definition.
\SetupICs ...mName \endcsname \fi }}\set at fontsize
                                                  \baselinestretch {\fSize }...
l.8161 {}\endSeq{}}

! Use of \\pdfbookmark doesn't match its definition.
\SetupICs ...mName \endcsname \fi }}\set at fontsize
                                                  \baselinestretch {\fSize }...
l.8161 {}\endSeq{}}

! Use of \\pdfbookmark doesn't match its definition.
\SetupICs ...mName \endcsname \fi }}\set at fontsize
                                                  \baselinestretch {\fSize }...
l.8161 {}\endSeq{}}

! Use of \\pdfbookmark doesn't match its definition.
\SetupICs ...mName \endcsname \fi }}\set at fontsize
                                                  \baselinestretch {\fSize }...
l.8161 {}\endSeq{}}

! Use of \\pdfbookmark doesn't match its definition.
\SetupICs ...mName \endcsname \fi }}\set at fontsize
                                                  \baselinestretch {\fSize }...
l.8161 {}\endSeq{}}

! Use of \\pdfbookmark doesn't match its definition.
\SetupICs ...mName \endcsname \fi }}\set at fontsize
                                                  \baselinestretch {\fSize }...
l.8161 {}\endSeq{}}

! Use of \\pdfbookmark doesn't match its definition.
\SetupICs ...mName \endcsname \fi }}\set at fontsize
                                                  \baselinestretch {\fSize }...
l.8169 ... the Kernel\endSeq{}\endNode{}\endSeq{}}

! Use of \\pdfbookmark doesn't match its definition.
\SetupICs ...mName \endcsname \fi }}\set at fontsize
                                                  \baselinestretch {\fSize }...
l.8169 ... the Kernel\endSeq{}\endNode{}\endSeq{}}

! Use of \\pdfbookmark doesn't match its definition.
\SetupICs ...mName \endcsname \fi }}\set at fontsize
                                                  \baselinestretch {\fSize }...
l.8169 ... the Kernel\endSeq{}\endNode{}\endSeq{}}

! Use of \\pdfbookmark doesn't match its definition.
\SetupICs ...mName \endcsname \fi }}\set at fontsize
                                                  \baselinestretch {\fSize }...
l.8169 ... the Kernel\endSeq{}\endNode{}\endSeq{}}

! Use of \\pdfbookmark doesn't match its definition.
\SetupICs ...mName \endcsname \fi }}\set at fontsize
                                                  \baselinestretch {\fSize }...
l.8169 ... the Kernel\endSeq{}\endNode{}\endSeq{}}

! Use of \\pdfbookmark doesn't match its definition.
\SetupICs ...mName \endcsname \fi }}\set at fontsize
                                                  \baselinestretch {\fSize }...
l.8169 ... the Kernel\endSeq{}\endNode{}\endSeq{}}

! Use of \\pdfbookmark doesn't match its definition.
\SetupICs ...mName \endcsname \fi }}\set at fontsize
                                                  \baselinestretch {\fSize }...
l.8169 ... the Kernel\endSeq{}\endNode{}\endSeq{}}

! Use of \\pdfbookmark doesn't match its definition.
\SetupICs ...mName \endcsname \fi }}\set at fontsize
                                                  \baselinestretch {\fSize }...
l.8169 ... the Kernel\endSeq{}\endNode{}\endSeq{}}

! Use of \\pdfbookmark doesn't match its definition.
\SetupICs ...mName \endcsname \fi }}\set at fontsize
                                                  \baselinestretch {\fSize }...
l.8182 {}\endSeq{}}

! Use of \\pdfbookmark doesn't match its definition.
\SetupICs ...mName \endcsname \fi }}\set at fontsize
                                                  \baselinestretch {\fSize }...
l.8182 {}\endSeq{}}

! Use of \\pdfbookmark doesn't match its definition.
\SetupICs ...mName \endcsname \fi }}\set at fontsize
                                                  \baselinestretch {\fSize }...
l.8182 {}\endSeq{}}

! Use of \\pdfbookmark doesn't match its definition.
\SetupICs ...mName \endcsname \fi }}\set at fontsize
                                                  \baselinestretch {\fSize }...
l.8197 {}\endSeq{}}

! Use of \\pdfbookmark doesn't match its definition.
\SetupICs ...mName \endcsname \fi }}\set at fontsize
                                                  \baselinestretch {\fSize }...
l.8197 {}\endSeq{}}

! Use of \\pdfbookmark doesn't match its definition.
\SetupICs ...mName \endcsname \fi }}\set at fontsize
                                                  \baselinestretch {\fSize }...
l.8197 {}\endSeq{}}

! Use of \\pdfbookmark doesn't match its definition.
\SetupICs ...mName \endcsname \fi }}\set at fontsize
                                                  \baselinestretch {\fSize }...
l.8197 {}\endSeq{}}

! Use of \\pdfbookmark doesn't match its definition.
\SetupICs ...mName \endcsname \fi }}\set at fontsize
                                                  \baselinestretch {\fSize }...
l.8197 {}\endSeq{}}

! Use of \\pdfbookmark doesn't match its definition.
\SetupICs ...mName \endcsname \fi }}\set at fontsize
                                                  \baselinestretch {\fSize }...
l.8197 {}\endSeq{}}

! Use of \\pdfbookmark doesn't match its definition.
\SetupICs ...mName \endcsname \fi }}\set at fontsize
                                                  \baselinestretch {\fSize }...
l.8197 {}\endSeq{}}

! Use of \\pdfbookmark doesn't match its definition.
\SetupICs ...mName \endcsname \fi }}\set at fontsize
                                                  \baselinestretch {\fSize }...
l.8205 ... the Kernel\endSeq{}\endNode{}\endSeq{}}

! Use of \\pdfbookmark doesn't match its definition.
\SetupICs ...mName \endcsname \fi }}\set at fontsize
                                                  \baselinestretch {\fSize }...
l.8205 ... the Kernel\endSeq{}\endNode{}\endSeq{}}

! Use of \\pdfbookmark doesn't match its definition.
\SetupICs ...mName \endcsname \fi }}\set at fontsize
                                                  \baselinestretch {\fSize }...
l.8205 ... the Kernel\endSeq{}\endNode{}\endSeq{}}

! Use of \\pdfbookmark doesn't match its definition.
\SetupICs ...mName \endcsname \fi }}\set at fontsize
                                                  \baselinestretch {\fSize }...
l.8205 ... the Kernel\endSeq{}\endNode{}\endSeq{}}

! Use of \\pdfbookmark doesn't match its definition.
\SetupICs ...mName \endcsname \fi }}\set at fontsize
                                                  \baselinestretch {\fSize }...
l.8205 ... the Kernel\endSeq{}\endNode{}\endSeq{}}

! Use of \\pdfbookmark doesn't match its definition.
\SetupICs ...mName \endcsname \fi }}\set at fontsize
                                                  \baselinestretch {\fSize }...
l.8205 ... the Kernel\endSeq{}\endNode{}\endSeq{}}

! Use of \\pdfbookmark doesn't match its definition.
\SetupICs ...mName \endcsname \fi }}\set at fontsize
                                                  \baselinestretch {\fSize }...
l.8205 ... the Kernel\endSeq{}\endNode{}\endSeq{}}

! Use of \\pdfbookmark doesn't match its definition.
\SetupICs ...mName \endcsname \fi }}\set at fontsize
                                                  \baselinestretch {\fSize }...
l.8205 ... the Kernel\endSeq{}\endNode{}\endSeq{}}

! Use of \\pdfbookmark doesn't match its definition.
\SetupICs ...mName \endcsname \fi }}\set at fontsize
                                                  \baselinestretch {\fSize }...
l.8218 {}\endSeq{}}

! Use of \\pdfbookmark doesn't match its definition.
\SetupICs ...mName \endcsname \fi }}\set at fontsize
                                                  \baselinestretch {\fSize }...
l.8218 {}\endSeq{}}

! Use of \\pdfbookmark doesn't match its definition.
\SetupICs ...mName \endcsname \fi }}\set at fontsize
                                                  \baselinestretch {\fSize }...
l.8218 {}\endSeq{}}

! Use of \\pdfbookmark doesn't match its definition.
\SetupICs ...mName \endcsname \fi }}\set at fontsize
                                                  \baselinestretch {\fSize }...
l.8220 {}
         \Seq%
! Use of \\pdfbookmark doesn't match its definition.
\SetupICs ...mName \endcsname \fi }}\set at fontsize
                                                  \baselinestretch {\fSize }...
l.8220 {}
         \Seq%
! Use of \\pdfbookmark doesn't match its definition.
\SetupICs ...mName \endcsname \fi }}\set at fontsize
                                                  \baselinestretch {\fSize }...
l.8220 {}
         \Seq%
! Use of \\pdfbookmark doesn't match its definition.
\SetupICs ...mName \endcsname \fi }}\set at fontsize
                                                  \baselinestretch {\fSize }...
l.8220 {}
         \Seq%
! Use of \\pdfbookmark doesn't match its definition.
\SetupICs ...mName \endcsname \fi }}\set at fontsize
                                                  \baselinestretch {\fSize }...
l.8220 {}
         \Seq%
! Use of \\pdfbookmark doesn't match its definition.
\SetupICs ...mName \endcsname \fi }}\set at fontsize
                                                  \baselinestretch {\fSize }...
l.8220 {}
         \Seq%
! Use of \\pdfbookmark doesn't match its definition.
\SetupICs ...mName \endcsname \fi }}\set at fontsize
                                                  \baselinestretch {\fSize }...
l.8221 {}
         \Seq%
! Use of \\pdfbookmark doesn't match its definition.
\SetupICs ...mName \endcsname \fi }}\set at fontsize
                                                  \baselinestretch {\fSize }...
l.8222 {}
         \HeadPar%
! Use of \\pdfbookmark doesn't match its definition.
\SetupICs ...mName \endcsname \fi }}\set at fontsize
                                                  \baselinestretch {\fSize }...
l.8238 {1}}
           Chapter 11. \Seq%
! Use of \\pdfbookmark doesn't match its definition.
\SetupICs ...mName \endcsname \fi }}\set at fontsize
                                                  \baselinestretch {\fSize }...
l.8239 {}
         \Node%
! Use of \\pdfbookmark doesn't match its definition.
\SetupICs ...mName \endcsname \fi }}\set at fontsize
                                                  \baselinestretch {\fSize }...
l.8264 {1}}
           \Seq%
! Use of \\pdfbookmark doesn't match its definition.
\SetupICs ...mName \endcsname \fi }}\set at fontsize
                                                  \baselinestretch {\fSize }...
l.8265 {}
         \endSeq{}\endPar{}\endSeq{}\Node%
! Use of \\pdfbookmark doesn't match its definition.
\SetupICs ...mName \endcsname \fi }}\set at fontsize
                                                  \baselinestretch {\fSize }...
l.8283 {1}}

! Use of \\pdfbookmark doesn't match its definition.
\SetupICs ...mName \endcsname \fi }}\set at fontsize
                                                  \baselinestretch {\fSize }...
l.8296 {1}}
           \Node%
! Use of \\pdfbookmark doesn't match its definition.
\SetupICs ...mName \endcsname \fi }}\set at fontsize
                                                  \baselinestretch {\fSize }...
l.8301 {0}}
           \Par%
! Use of \\pdfbookmark doesn't match its definition.
\SetupICs ...mName \endcsname \fi }}\set at fontsize
                                                  \baselinestretch {\fSize }...
l.8310 {1}}
           \Seq%
! Use of \\pdfbookmark doesn't match its definition.
\SetupICs ...mName \endcsname \fi }}\set at fontsize
                                                  \baselinestretch {\fSize }...
l.8311 {}
         \LineField%
! Use of \\pdfbookmark doesn't match its definition.
\SetupICs ...mName \endcsname \fi }}\set at fontsize
                                                  \baselinestretch {\fSize }...
l.8317 {0}}
           \Character{8226}\endLineField{}\endSeq{}\Node%
! Use of \begin doesn't match its definition.
\LineField ...ieldNIC \FlowObjectSetup {0}\begin {
                                                  LRbox}{\dssslbox }
l.8317 {0}}
           \Character{8226}\endLineField{}\endSeq{}\Node%
! Use of \\pdfbookmark doesn't match its definition.
\SetupICs ...mName \endcsname \fi }}\set at fontsize
                                                  \baselinestretch {\fSize }...
l.8317 {0}}\Character{8226}
                           \endLineField{}\endSeq{}\Node%
! Use of \end doesn't match its definition.
\endLineField ->\end {
                      LRbox}\ifdim \wd \dssslbox >\FieldWidth \def \FieldWid...
l.8317 {0}}\Character{8226}\endLineField
                                        {}\endSeq{}\Node%
! Missing \endcsname inserted.
<to be read again>
                   \expandafter
l.8317 {0}}\Character{8226}\endLineField
                                        {}\endSeq{}\Node%
! Extra \endcsname.
\HyPsd@@LetCommand ...ter \expandafter \endcsname
                                                  \fi \fi
l.8317 {0}}\Character{8226}\endLineField
                                        {}\endSeq{}\Node%
[16.0.30] [17.0.30]

Package Fancyhdr Warning: \fancyfoot's `E' option without twoside option is use
less on input line 8631.


Package Fancyhdr Warning: \fancyhead's `E' option without twoside option is use
less on input line 8631.


Package Fancyhdr Warning: \fancyfoot's `E' option without twoside option is use
less on input line 8905.

[18.0.30] [19.0.30]

Package Fancyhdr Warning: \fancyfoot's `E' option without twoside option is use
less on input line 9046.


Package Fancyhdr Warning: \fancyhead's `E' option without twoside option is use
less on input line 9046.


Package Fancyhdr Warning: \fancyfoot's `E' option without twoside option is use
less on input line 9121.

[20.0.30] (/home/oddcoder/linux/Documentation/DocBook/kernel-hacking.aux)

Package rerunfilecheck Warning: File `kernel-hacking.out' has changed.
(rerunfilecheck)                Rerun to get outlines right
(rerunfilecheck)                or use package `bookmark'.


LaTeX Warning: There were undefined references.

 )
(\end occurred inside a group at level 1)

### semi simple group (level 1) entered at line 7128 (\begingroup)
### bottom level
(\end occurred when \ifnum on line 8244 was incomplete)
(\end occurred when \ifnum on line 8111 was incomplete)
(see the transcript file for additional information)pdfTeX warning (dest): name
{0:submitting} has been referenced but does not exist, replaced by a fixed one

{/usr/share/texlive/texmf-dist/fonts/enc/dvips/base/8r.enc}</usr/share/texlive/
texmf-dist/fonts/type1/urw/courier/ucrb8a.pfb></usr/share/texlive/texmf-dist/fo
nts/type1/urw/courier/ucrr8a.pfb></usr/share/texlive/texmf-dist/fonts/type1/urw
/courier/ucrro8a.pfb></usr/share/texlive/texmf-dist/fonts/type1/urw/helvetic/uh
vb8a.pfb></usr/share/texlive/texmf-dist/fonts/type1/urw/helvetic/uhvbo8a.pfb></
usr/share/texlive/texmf-dist/fonts/type1/urw/helvetic/uhvr8a.pfb></usr/share/te
xlive/texmf-dist/fonts/type1/urw/times/utmb8a.pfb></usr/share/texlive/texmf-dis
t/fonts/type1/urw/times/utmr8a.pfb></usr/share/texlive/texmf-dist/fonts/type1/u
rw/times/utmri8a.pfb>
Output written on kernel-hacking.pdf (23 pages, 161706 bytes).
Transcript written on kernel-hacking.log.






and I could only find those pdfs in directory Documentation/DocBook/
1-device-drivers.pdf
2-kernel-hacking.pdf
3-z8530book.pdf
so if there is something that I missed please tell me
note that the building process required docbook-utils and I installed
it by apt-get
thanks in advance

^ permalink raw reply	[flat|nested] 3+ messages in thread

* how to build Documentation/DocBook/
  2015-07-17 12:40 how to build Documentation/DocBook/ Ahmed Soliman
@ 2015-07-17 13:18 ` Luis de Bethencourt
  2015-07-24 21:42   ` Jim Davis
  0 siblings, 1 reply; 3+ messages in thread
From: Luis de Bethencourt @ 2015-07-17 13:18 UTC (permalink / raw)
  To: kernelnewbies

On 17 July 2015 at 13:40, Ahmed Soliman <ahmedsoliman0x666@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
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://lists.kernelnewbies.org/pipermail/kernelnewbies/attachments/20150717/8b5fe4df/attachment.html 

^ permalink raw reply	[flat|nested] 3+ messages in thread

* how to build Documentation/DocBook/
  2015-07-17 13:18 ` Luis de Bethencourt
@ 2015-07-24 21:42   ` Jim Davis
  0 siblings, 0 replies; 3+ messages in thread
From: Jim Davis @ 2015-07-24 21:42 UTC (permalink / raw)
  To: kernelnewbies

On Fri, Jul 17, 2015 at 6:18 AM, Luis de Bethencourt
<luis@debethencourt.com> wrote:
>
> On 17 July 2015 at 13:40, Ahmed Soliman <ahmedsoliman0x666@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">
      <title>See 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>
+      <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>
     </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>
+       <citation><ulink
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

^ permalink raw reply related	[flat|nested] 3+ messages in thread

end of thread, other threads:[~2015-07-24 21:42 UTC | newest]

Thread overview: 3+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2015-07-17 12:40 how to build Documentation/DocBook/ Ahmed Soliman
2015-07-17 13:18 ` Luis de Bethencourt
2015-07-24 21:42   ` Jim Davis

This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.