1 # Copyright (C) 1992, 93, 94, 95, 96, 97, 98 Free Software Foundation, Inc.
2 # This file is part of the GNU C Library.
4 # The GNU C Library is free software; you can redistribute it and/or
5 # modify it under the terms of the GNU Library General Public License
6 # as published by the Free Software Foundation; either version 2 of
7 # the License, or (at your option) any later version.
9 # The GNU C Library is distributed in the hope that it will be useful,
10 # but WITHOUT ANY WARRANTY; without even the implied warranty of
11 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
12 # Library General Public License for more details.
14 # You should have received a copy of the GNU Library General Public
15 # License along with the GNU C Library; see the file COPYING.LIB. If not,
16 # write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
17 # Boston, MA 02111-1307, USA.
19 # Makefile for the GNU C Library manual.
22 export subdir
:= $(subdir
)
25 INSTALL_INFO
= install-info
31 # Get glibc's configuration info.
32 ifneq (,$(wildcard ..
/Makeconfig
))
40 ifneq ($(strip $(MAKEINFO
)),)
42 info: libc.
info dir-add.
info
47 move-if-change
= .
/move-if-change
49 mkinstalldirs
= $(..
)scripts
/mkinstalldirs
51 chapters
= $(addsuffix .texi
, \
52 intro errno memory ctype string mbyte locale \
53 message search pattern io stdio llio filesys \
54 pipe socket terminal math arith time setjmp \
55 signal startup process job nss users sysinfo conf
)
56 add-chapters
= $(wildcard $(foreach d
, $(add-ons
), ..
/$d/$d.texi
))
57 appendices
= lang.texi header.texi
install.texi maint.texi contrib.texi
60 texis
: texis.awk
$(chapters
) $(add-chapters
) $(appendices
) lgpl.texinfo
64 nonexamples
= $(filter-out $(add-chapters
) %.c.texi
, $(texis
))
65 examples
= $(filter %.c.texi
, $(texis
))
67 # Kludge: implicit rule so Make knows the one command does it all.
68 chapters.
% top-menu.
%: libc-texinfo.sh
$(texis
)
69 AWK
=$(AWK
) $(SHELL
) $< '$(chapters)' '$(add-chapters)' '$(appendices)'
71 libc.
dvi libc.
info: chapters.texi top-menu.texi
74 # Generate the summary from the Texinfo source files for each chapter.
75 summary.texi
: stamp-summary
;
76 stamp-summary
: summary.awk
$(filter-out summary.texi
, $(texis
))
77 $(AWK
) -f
$^ |
sort -df
+1 -2 | tr
'\014' '\012' > summary-tmp
78 $(move-if-change
) summary-tmp summary.texi
81 # Generate a file which can be added to the `dir' content to provide direct
82 # access to the documentation of the function, variables, and other
84 dir-add.
info: xtract-typefun.awk
$(texis
)
85 (echo
"INFO-DIR-SECTION GNU C library functions:"; \
86 echo
"START-INFO-DIR-ENTRY"; \
87 $(AWK
) -f
$^ |
sort; \
88 echo
"END-INFO-DIR-ENTRY") > $@.new
91 # Generate Texinfo files from the C source for the example programs.
92 %.c.texi
: examples
/%.c
93 sed
-e
's,[{}],@&,g' \
94 -e
's,/\*\(@.*\)\*/,\1,g' \
95 -e
's,/\* *,/* @r{,g' -e
's, *\*/,} */,' \
96 -e
's/\(@[a-z][a-z]*\)@{\([^}]*\)@}/\1{\2}/g'\
107 minimal-dist
= summary.awk texis.awk libc-texinfo.sh libc.texinfo \
108 $(filter-out summary.texi
, $(nonexamples
)) \
109 $(patsubst %.c.texi
,examples
/%.c
, $(examples
))
111 doc-only-dist
= Makefile COPYING.LIB
112 distribute
= $(minimal-dist
) $(examples
) texis stdio-fp.c \
113 libc.
info* libc.?? libc.??s texinfo.
tex stamp-summary \
114 xtract-typefun.awk dir-add.texinfo dir-add.
info dir \
115 chapters.texi top-menu.texi summary.texi
116 export distribute
:= $(distribute
)
118 tar-it
= tar chovf
$@
$^
120 manual.
tar: $(doc-only-dist
) $(minimal-dist
) ; $(tar-it
)
121 mandist.
tar: $(doc-only-dist
) $(distribute
) ; $(tar-it
)
123 edition
:= $(shell sed
-n
's/^@set EDITION \([0-9][0-9.]*\)[^0-9.]*.*$$/\1/p' \
126 glibc-doc-
$(edition
).
tar: $(doc-only-dist
) $(distribute
)
127 @
rm -f glibc-doc-
$(edition
)
128 ln
-s . glibc-doc-
$(edition
)
129 tar chovf
$@
$(addprefix glibc-doc-
$(edition
)/,$^
)
130 rm -f glibc-doc-
$(edition
)
133 compress
-c
$< > $@.new
136 gzip
-9 -c
$< > $@.new
139 uuencode
$< < $< > $@.new
142 .PHONY
: mostlyclean distclean realclean clean
144 -rm -f libc.
dvi libc.tmp libc.
info* dir-add.
info
145 -rm -f
$(objpfx
)stubs
$(objpfx
)distinfo
146 -rm -f
$(foreach o
,$(object-suffixes-for-libc
),$(objpfx
)stamp
$o)
149 indices
= cp fn pg tp vr ky
151 -rm -f texis summary.texi stamp-summary
*.c.texi
152 -rm -f
$(foreach index
,$(indices
),libc.
$(index
) libc.
$(index
)s
)
153 -rm -f libc.log libc.aux libc.toc dir-add.texinfo
154 -rm -f top-menu.texi chapters.texi
156 .PHONY
: install subdir_install
installdirs install-data
157 install-data subdir_install
: install
158 ifneq ($(strip $(MAKEINFO
)),)
159 # There are two variants of install-info out there. The GNU version
160 # knows about the INFO-DIR-SECTION tag, the Debian version doesn't.
161 ifneq ($(OLD_DEBIAN_INSTALL_INFO
),yes
)
162 install: $(inst_infodir
)/libc.
info dir-add.
info
163 @if
$(SHELL
) -c
'$(INSTALL_INFO) --version' >/dev
/null
2>&1; then \
164 test -f
$(inst_infodir
)/dir || cp
dir $(inst_infodir
);\
165 $(INSTALL_INFO
) --info-dir
=$(inst_infodir
) $(inst_infodir
)/libc.
info;\
166 $(INSTALL_INFO
) --info-dir
=$(inst_infodir
) dir-add.
info;\
169 install: $(inst_infodir
)/libc.
info dir-add.
info
170 @if
$(SHELL
) -c
'$(INSTALL_INFO) --version' >/dev
/null
2>&1; then \
171 test -f
$(inst_infodir
)/dir || cp
dir $(inst_infodir
);\
172 $(INSTALL_INFO
) --info-dir
=$(inst_infodir
) \
173 --section
'^GNU Libraries:' 'GNU Libraries:' \
174 $(inst_infodir
)/libc.
info;\
175 $(INSTALL_INFO
) --info-dir
=$(inst_infodir
) \
176 --section
'^GNU C Library functions:' 'GNU C Library functions:' \
181 # Catchall implicit rule for other installation targets from the parent.
184 $(inst_infodir
)/libc.
info: libc.
info installdirs
185 for file in
$<*; do \
186 $(INSTALL_DATA
) $$file $(@D
)/$$file; \
190 $(mkinstalldirs
) $(inst_infodir
)
193 dist: # glibc-doc-$(edition).tar.gz
195 ifneq (,$(wildcard ..
/Make-dist
))
197 $(MAKE
) -f
$< $(Make-dist-args
)
203 TAGS
: $(minimal-dist
)
206 # The parent makefile sometimes invokes us with targets `subdir_REAL-TARGET'.
208 # For targets we don't define, do nothing.
211 # These are targets that each glibc subdirectory is expected to understand.
212 # ../Rules defines them for code subdirectories; for us, they are no-ops.
213 # None of these should be `subdir_TARGET'; those targets are transformed
214 # by the implicit rule above into `TARGET' deps.
215 glibc-targets
:= lib objects objs others tests lint.out \
216 echo-headers echo-distinfo
217 .PHONY
: $(glibc-targets
)
220 # Create stamp files if they don't exist, so the parent makefile's rules for
221 # updating the library archives are happy with us, and never think we have
222 # changed the library.
223 lib
: $(foreach o
,$(object-suffixes-for-libc
),$(objpfx
)stamp
$o)
226 stubs
: $(objpfx
)stubs
228 $(objpfx
)stubs ..
/po
/manual.pot
$(objpfx
)stamp
%:
229 $(make-target-directory
)
232 # Make the target directory if it doesn't exist, using the `mkinstalldirs'
233 # script that does `mkdir -p' even if `mkdir' doesn't support that flag.
234 define make-target-directory
235 $(addprefix $(mkinstalldirs
) ,\
236 $(filter-out $(wildcard $(@D
:%/=%)),$(@D
:%/=%)))
239 # The top-level glibc Makefile expects subdir_install to update the stubs file.
240 subdir_install
: stubs
242 # Get rid of these variables if they came from the parent.