ok, i'm sure i'm doing something trivially idiotic here, but i
wanted to comment out a section of device-drivers.tmpl (the I2O
section, since it's been moved in linux-next), so i made the following
tiny change:
===============
diff --git a/Documentation/DocBook/device-drivers.tmpl b/Documentation/DocBook/device-drivers.tmpl
index f213058..278cff7 100644
--- a/Documentation/DocBook/device-drivers.tmpl
+++ b/Documentation/DocBook/device-drivers.tmpl
@@ -190,6 +190,7 @@ X!Edrivers/pnp/system.c
!Idrivers/message/fusion/mptfc.c
!Idrivers/message/fusion/mptlan.c
</sect1>
+<!-- Removed by rday
<sect1><title>I2O message devices</title>
!Iinclude/linux/i2o.h
!Idrivers/message/i2o/core.h
@@ -207,6 +208,7 @@ X!Edrivers/pnp/system.c
!Idrivers/message/i2o/i2o_scsi.c
!Idrivers/message/i2o/i2o_proc.c
</sect1>
+-->
</chapter>
<chapter id="snddev">
=================
as in, i just commented out the section in question, as i've seen
done in numerous places in .tmpl files, and i ran "make htmldocs", and
got the following weirdness:
==========
HTML Documentation/DocBook/device-drivers.html
/home/rpjday/k/git/Documentation/DocBook/device-drivers.xml:35805:
parser error : Double hyphen within comment: <!-- Removed by rday
<sect1><title>I2O message de
<!-- include/linux/i2o.h -->
^
/home/rpjday/k/git/Documentation/DocBook/device-drivers.xml:42849:
parser error : Opening and ending tag mismatch: chapter line 28979 and
sect1
</sect1>
^
/home/rpjday/k/git/Documentation/DocBook/device-drivers.xml:42851:
parser error : Opening and ending tag mismatch: book line 5 and
chapter
</chapter>
^
/home/rpjday/k/git/Documentation/DocBook/device-drivers.xml:42853:
parser error : Extra content at the end of the document
<chapter id="snddev">
^
unable to parse
/home/rpjday/k/git/Documentation/DocBook/device-drivers.xml
=============
a double hyphen within a comment? sure enough, if i go to the
generated XML file, i see:
... snip ...
</sect1>
<!-- Removed by rday
<sect1><title>I2O message devices</title>
<!-- include/linux/i2o.h -->
<refentry id="API-i2o-driver-notify-controller-add">
<refentryinfo>
... snip ...
i don't get it ... why is my comment not removing all of that
content ... why is the reference to include/linux/i2o.h still there,
also commented, which appears to be what is causing the error?
what am i doing stupidly?
rday
--
========================================================================
Robert P. J. Day Ottawa, Ontario, CANADA
http://crashcourse.ca
Twitter: http://twitter.com/rpjday
LinkedIn: http://ca.linkedin.com/in/rpjday
========================================================================
--
To unsubscribe from this list: send the line "unsubscribe linux-doc" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at http://vger.kernel.org/majordomo-info.html
