提交 e9c9963b 编写于 作者: J Jonathan Corbet

Revert "DocBook: Avoid building man pages repeatedly and inconsistently"

This reverts commit b44158b1.  This commit
introduced warnings and possibly inconsistent results into the doc build
process.  The goal is good but it will need to be achieved another way.
Reported-by: NMasanari Iida <standby24x7@gmail.com>
Signed-off-by: NJonathan Corbet <corbet@lwn.net>
上级 b2c4105b
......@@ -56,13 +56,6 @@ htmldocs: $(HTML)
MAN := $(patsubst %.xml, %.9, $(BOOKS))
mandocs: $(MAN)
@dups=$$(sed -n 's/.*<refname>\([^<]*\)<\/refname>.*/\1/p' \
$(obj)/*.xml.noextra | sort | uniq -d); \
if [ -n "$$dups" ]; then \
echo >&2 "The following manual pages are generated more than once:"; \
printf >&2 '%s\n' "$$dups"; \
exit 1; \
fi
find $(obj)/man -name '*.9' | xargs gzip -nf
installmandocs: mandocs
......@@ -157,7 +150,7 @@ quiet_cmd_db2html = HTML $@
cp $(PNG-$(basename $(notdir $@))) $(patsubst %.html,%,$@); fi
quiet_cmd_db2man = MAN $@
cmd_db2man = if grep -q refentry $<; then xmlif excludeextra=1 <$< >$<.noextra && xmlto man $(XMLTOFLAGS) -o $(obj)/man $<.noextra ; fi
cmd_db2man = if grep -q refentry $<; then xmlto man $(XMLTOFLAGS) -o $(obj)/man $< ; fi
%.9 : %.xml
@(which xmlto > /dev/null 2>&1) || \
(echo "*** You need to install xmlto ***"; \
......@@ -224,7 +217,6 @@ clean-files := $(DOCBOOKS) \
$(patsubst %.xml, %.ps, $(DOCBOOKS)) \
$(patsubst %.xml, %.pdf, $(DOCBOOKS)) \
$(patsubst %.xml, %.html, $(DOCBOOKS)) \
$(patsubst %, %.noextra, $(DOCBOOKS)) \
$(patsubst %.xml, %.9, $(DOCBOOKS)) \
$(index)
......
......@@ -194,13 +194,8 @@ X!Edrivers/pnp/system.c
<chapter id="snddev">
<title>Sound Devices</title>
<?xmlif if excludeextra='1'?>
<?xmlif else?>
!Iinclude/sound/core.h
<?xmlif fi?>
!Esound/sound_core.c
<?xmlif if excludeextra='1'?>
<?xmlif else?>
!Iinclude/sound/pcm.h
!Esound/core/pcm.c
!Esound/core/device.c
......@@ -216,7 +211,6 @@ X!Edrivers/pnp/system.c
!Esound/core/hwdep.c
!Esound/core/pcm_native.c
!Esound/core/memalloc.c
<?xmlif fi?>
<!-- FIXME: Removed for now since no structured comments in source
X!Isound/sound_firmware.c
-->
......
......@@ -488,10 +488,7 @@ These are the same types and constants used by host
side drivers (and usbcore).
</para>
<?xmlif if excludeextra='1'?>
<?xmlif else?>
!Iinclude/linux/usb/ch9.h
<?xmlif fi?>
</sect1>
<sect1 id="core"><title>Core Objects and Methods</title>
......
......@@ -58,11 +58,8 @@
<sect1><title>String Conversions</title>
!Elib/vsprintf.c
<?xmlif if excludeextra='1'?>
<?xmlif else?>
!Finclude/linux/kernel.h kstrtol
!Finclude/linux/kernel.h kstrtoul
<?xmlif fi?>
!Elib/kstrtox.c
</sect1>
<sect1><title>String Manipulation</title>
......@@ -181,10 +178,7 @@ X!Ekernel/module.c
<chapter id="hardware">
<title>Hardware Interfaces</title>
<sect1><title>Interrupt Handling</title>
<?xmlif if excludeextra='1'?>
<?xmlif else?>
!Ekernel/irq/manage.c
<?xmlif fi?>
</sect1>
<sect1><title>DMA Channels</title>
......
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册