mirror of
https://mirrors.bfsu.edu.cn/git/linux.git
synced 2024-11-28 06:34:12 +08:00
Revert "DocBook: Avoid building man pages repeatedly and inconsistently"
This reverts commit b44158b170
. 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: Masanari Iida <standby24x7@gmail.com>
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
This commit is contained in:
parent
b2c4105b08
commit
e9c9963b43
@ -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>
|
||||
|
Loading…
Reference in New Issue
Block a user