Skip to content

Commit 4793785

Browse files
author
Linus Torvalds
committed
into home.transmeta.com:/home/torvalds/v2.5/linux
2 parents 91ea389 + 184a56c commit 4793785

File tree

6 files changed

+83
-59
lines changed

6 files changed

+83
-59
lines changed

Documentation/DocBook/Makefile

Lines changed: 31 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -39,8 +39,8 @@ htmldocs: $(HTML)
3939

4040
###
4141
#External programs used
42-
KERNELDOC=$(objtree)/scripts/kernel-doc
43-
DOCPROC=$(objtree)/scripts/docproc
42+
KERNELDOC = scripts/kernel-doc
43+
DOCPROC = scripts/docproc
4444

4545
###
4646
# DOCPROC is used for two purposes:
@@ -50,14 +50,14 @@ DOCPROC=$(objtree)/scripts/docproc
5050
# The following rules are used to generate the .sgml documentation
5151
# required to generate the final targets. (ps, pdf, html).
5252
quiet_cmd_docproc = DOCPROC $@
53-
cmd_docproc = $(DOCPROC) doc $< >$@
53+
cmd_docproc = $(DOCPROC) doc $< >$@
5454
define rule_docproc
55-
set -e
56-
$(if $($(quiet)cmd_$(1)),echo ' $($(quiet)cmd_$(1))';)
57-
$(cmd_$(1)); \
58-
( \
59-
echo 'cmd_$@ := $(cmd_$(1))'; \
60-
echo $@: `$(DOCPROC) depend $<`; \
55+
set -e; \
56+
$(if $($(quiet)cmd_$(1)),echo ' $($(quiet)cmd_$(1))';) \
57+
$(cmd_$(1)); \
58+
( \
59+
echo 'cmd_$@ := $(cmd_$(1))'; \
60+
echo $@: `$(DOCPROC) depend $<`; \
6161
) > $(dir $@).$(notdir $@).cmd
6262
endef
6363

@@ -96,41 +96,55 @@ $(obj)/parportbook.ps $(obj)/parportbook.pdf: $(EPS-parportbook) $(PNG-parportbo
9696
###
9797
# Rules to generate postscript, PDF and HTML
9898
# db2html creates a directory. Generate a html file used for timestamp
99+
100+
quiet_cmd_db2ps = DB2PS $@
101+
cmd_db2ps = db2ps -o $(dir $@) $<
99102
%.ps : %.sgml
100103
@(which db2ps > /dev/null 2>&1) || \
101104
(echo "*** You need to install DocBook stylesheets ***"; \
102105
exit 1)
103-
$(call do_cmd,DB2PS $@,db2ps -o $(dir $@) $<)
106+
$(call cmd,db2ps)
104107

108+
quiet_cmd_db2pdf = DB2PDF $@
109+
cmd_db2pdf = db2pdf -o $(dir $@) $<
105110
%.pdf : %.sgml
106111
@(which db2pdf > /dev/null 2>&1) || \
107112
(echo "*** You need to install DocBook stylesheets ***"; \
108113
exit 1)
109-
$(call do_cmd,DB2PDF $@,db2pdf -o $(dir $@) $<)
114+
$(call cmd,db2pdf)
115+
116+
quiet_cmd_db2html = DB2HTML $@
117+
cmd_db2html = db2html -o $(patsubst %.html,%,$@) $< && \
118+
echo '<a HREF="$(patsubst %.html,%,$(notdir $@))/book1.html"> \
119+
Goto $(patsubst %.html,%,$(notdir $@))</a><p>' > $@
110120

111121
%.html: %.sgml
112122
@(which db2html > /dev/null 2>&1) || \
113123
(echo "*** You need to install DocBook stylesheets ***"; \
114124
exit 1)
115125
@rm -rf $@ $(patsubst %.html,%,$@)
116-
$(call do_cmd,DB2HTML $@,db2html -o $(patsubst %.html,%,$@) $< && \
117-
echo '<a HREF="$(patsubst %.html,%,$(notdir $@))/book1.html">\
118-
Goto $(patsubst %.html,%,$(notdir $@))</a><p>' > $@)
126+
$(call cmd,db2html)
119127
@if [ ! -z "$(PNG-$(basename $(notdir $@)))" ]; then \
120128
cp $(PNG-$(basename $(notdir $@))) $(patsubst %.html,%,$@); fi
121129

122130
###
123131
# Rules to generate postscripts and PNG imgages from .fig format files
132+
quiet_cmd_fig2eps = FIG2EPS $@
133+
cmd_fig2eps = fig2dev -Leps $< $@
134+
124135
%.eps: %.fig
125-
$(call do_cmd,FIG2DEV -Leps $@,fig2dev -Leps $< $@)
136+
$(call cmd,fig2eps)
137+
138+
quiet_cmd_fig2png = FIG2PNG $@
139+
cmd_fig2png = fig2dev -Lpng $< $@
126140

127141
%.png: %.fig
128-
$(call do_cmd,FIG2DEV -Lpng $@,fig2dev -Lpng $< $@)
142+
$(call cmd,fig2png)
129143

130144
###
131145
# Rule to convert a .c file to inline SGML documentation
132146
%.sgml: %.c
133-
@echo ' Generating $@'
147+
@echo ' GEN $@'
134148
@( \
135149
echo "<programlisting>"; \
136150
expand --tabs=8 < $< | \

Documentation/DocBook/kernel-api.tmpl

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -79,6 +79,7 @@ KAO -->
7979
</sect1>
8080
<sect1><title>String Manipulation</title>
8181
!Ilib/string.c
82+
!Elib/string.c
8283
</sect1>
8384
<sect1><title>Bit Operations</title>
8485
!Iinclude/asm-i386/bitops.h
@@ -176,7 +177,7 @@ X!Ekernel/module.c
176177
!Edrivers/pci/pci.c
177178
</sect1>
178179
<sect1><title>PCI Hotplug Support Library</title>
179-
!Edrivers/hotplug/pci_hotplug_core.c
180+
!Edrivers/pci/hotplug/pci_hotplug_core.c
180181
</sect1>
181182
<sect1><title>MCA Architecture</title>
182183
<sect2><title>MCA Device Functions</title>

0 commit comments

Comments
 (0)