Bug 47823 – gentoo-dev-sources fails "make htmldocs"

• Product: Gentoo Linux
• Status: RESOLVED FIXED

[Description David Cozatt 2004-04-14 12:05:39 UTC]

ethelle linux # diff -U 3 ../parportbook.tmpl.2 ../parportbook.tmpl
--- ../parportbook.tmpl.2       2004-04-14 15:17:34.636082824 -0400
+++ ../parportbook.tmpl 2004-04-14 15:16:47.627229256 -0400
@@ -2729,9 +2729,8 @@
  </appendix>

 </book>
-<!-- Additional function to be documented:
---! Ddrivers/parport/init.c (this file doesn't exist any more)
--->
+<!-- Additional function to be documented: -->
+<!-- Ddrivers/parport/init.c (this file doesn't exist any more) -->
 <!-- Local Variables: -->
 <!-- sgml-indent-step: 1 -->
 <!-- sgml-indent-data: 1 -->


Reproducible: Always
Steps to Reproduce:
1.#emerge gentoo-dev-sources 
2.#cd /usr/src/linux(or linux-beta or wherever they happen to be)
3.#make htmldocs

Actual Results:  
Working on: /usr/src/linux/Documentation/DocBook/parportbook.sgml
jade:/usr/src/linux/Documentation/DocBook/parportbook.sgml:4059:2:E: invalid
comment declaration: found character "!" outside comment but inside comment
declaration
jade:/usr/src/linux/Documentation/DocBook/parportbook.sgml:4058:0: comment
declaration started here
jade:/usr/src/linux/Documentation/DocBook/parportbook.sgml:4059:4:E: character
data is not allowed here
make[1]: *** [Documentation/DocBook/parportbook.html] Error 8
make: *** [htmldocs] Error 2


Expected Results:  
 DOCPROC Documentation/DocBook/parportbook.sgml
Warning(drivers/parport/share.c:188): No description found for parameter 'drv'
Warning(drivers/parport/share.c:188): No description found for parameter 'drv'
Warning(drivers/parport/share.c:188): No description found for parameter 'drv'
Warning(drivers/parport/share.c:188): No description found for parameter 'drv'
Warning(drivers/parport/share.c:188): No description found for parameter 'drv'
Warning(drivers/parport/share.c:188): No description found for parameter 'drv'
Warning(drivers/parport/share.c:188): No description found for parameter 'drv'
Warning(drivers/parport/share.c:188): No description found for parameter 'drv'
Warning(drivers/parport/share.c:188): No description found for parameter 'drv'
Warning(drivers/parport/share.c:188): No description found for parameter 'drv'
  DB2HTML Documentation/DocBook/parportbook.html
Using catalogs: /etc/sgml/sgml-docbook-4.1.cat
Using stylesheet: /usr/share/sgml/docbook/utils-0.6.12/docbook-utils.dsl#html
Working on: /usr/src/linux/Documentation/DocBook/parportbook.sgml
Done.

[Comment 1 David Cozatt 2004-04-14 18:59:40 UTC]

oh the version i found this in is is 2.6.5 btw sorry for not including earlier. Haven't checked other kernel versions.

bus_drivr

[Comment 2 Richard Torkar 2004-04-16 02:02:30 UTC]

Created attachment 29407 [details, diff]
parportbook.sgml patch

This is a asimple fix for the parportbook.sgml document. Should be pushed
upstream by gentoo developers.

[Comment 3 Michal Januszewski (RETIRED) 2004-06-20 04:59:14 UTC]

This problem appears to be fixed with the latest g-d-s.