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 ifneq ($(strip $(MAKEINFO
)),)
33 info: libc.
info dir-add.
info
36 # Get glibc's configuration info.
37 ifneq (,$(wildcard ..
/Makeconfig
))
41 # Set chapters and chapters-incl[12].
43 chapters
: libc.texinfo
46 # @includes in chapter files
47 -include chapters-incl1
48 chapters-incl1
: $(chapters
)
50 chapters-incl1
:= $(filter-out summary.texi
,$(chapters-incl1
))
53 # @includes in files included by chapter files, if any
54 -include chapters-incl2
55 chapters-incl2
: $(chapters-incl1
)
59 chapters-incl
:= $(chapters-incl1
) $(chapters-incl2
)
62 (echo
'$(@F) :=' \\ ;\
63 $(AWK
) '$$1 == "@include" { print $$2 " \\" }' $^
) > $@.new
67 libc.
dvi libc.
info: $(chapters
) summary.texi
$(chapters-incl
)
76 # Generate the summary from the Texinfo source files for each chapter.
77 summary.texi
: stamp-summary
;
78 stamp-summary
: summary.awk
$(chapters
) $(chapters-incl
)
80 |
sort -df
+1 -2 | tr
'\014' '\012' > summary-tmp
81 .
/move-if-change summary-tmp summary.texi
82 # touch is broken on our machines. Sigh.
85 # Generate a file which can be added to the `dir' content to provide direct
86 # access to the documentation of the function, variables, and other
88 dir-add.texinfo
: xtract-typefun.awk
$(chapters
) $(chapters-incl
)
89 $(SHELL
) -c
'(echo "@dircategory GNU C library functions"; \
92 echo "@end direntry";)' > $@.new
95 # Generate Texinfo files from the C source for the example programs.
96 %.c.texi
: examples
/%.c
97 sed
-e
's,[{}],@&,g' \
98 -e
's,/\*\(@.*\)\*/,\1,g' \
99 -e
's,/\* *,/* @r{,g' -e
's, *\*/,} */,' \
100 -e
's/\(@[a-z][a-z]*\)@{\([^}]*\)@}/\1{\2}/g'\
105 minimal-dist
= summary.awk move-if-change libc.texinfo
$(chapters
) \
106 $(patsubst %.c.texi
,examples
/%.c
, \
107 $(filter-out summary.texi
,$(chapters-incl
)))
108 doc-only-dist
= Makefile COPYING.LIB mkinstalldirs
109 distribute
= $(minimal-dist
) \
110 $(patsubst examples
/%.c
,%.c.texi
,$(filter examples
/%.c
, \
112 libc.
info* libc.?? libc.??s texinfo.
tex summary.texi \
113 stamp-summary chapters chapters-incl1 chapters-incl2 \
114 xtract-typefun.awk dir-add.texinfo dir-add.
info dir \
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.
info* dir-add.
info $(common-objpfx
)stub-manual
145 -rm -f
$(foreach o
,$(object-suffixes-for-libc
),$(objpfx
)stamp
$o)
148 indices
= cp fn pg tp vr ky
150 -rm -f chapters chapters-incl
* summary.texi stamp-summary
*.c.texi
151 -rm -f
$(foreach index
,$(indices
),libc.
$(index
) libc.
$(index
)s
)
152 -rm -f libc.log libc.aux libc.toc dir-add.texi
154 .PHONY
: install subdir_install
installdirs install-data
155 install-data subdir_install
: install
156 ifneq ($(strip $(MAKEINFO
)),)
157 install: $(inst_infodir
)/libc.
info dir-add.
info
158 @if
$(SHELL
) -c
'$(INSTALL_INFO) --version' >/dev
/null
2>&1; then \
159 test -f
$(inst_infodir
)/dir || cp
dir $(inst_infodir
);\
160 $(INSTALL_INFO
) --info-dir
=$(inst_infodir
) $(inst_infodir
)/libc.
info;\
161 $(INSTALL_INFO
) --info-dir
=$(inst_infodir
) dir-add.
info;\
164 # Catchall implicit rule for other installation targets from the parent.
167 $(inst_infodir
)/libc.
info: libc.
info installdirs
168 for file in
$<*; do \
169 name
=`basename $$file`; \
170 $(INSTALL_DATA
) $$file \
171 `echo $@ | sed "s,$<\$$,$$name,"`; \
174 installdirs: $(firstword $(wildcard mkinstalldirs ..
/mkinstalldirs
))
175 $(dir $<)$(notdir $<) $(inst_infodir
)
178 dist: # glibc-doc-$(edition).tar.gz
180 ifneq (,$(wildcard ..
/Make-dist
))
182 $(MAKE
) -f
$< $(Make-dist-args
)
188 TAGS
: $(minimal-dist
)
191 # The parent makefile sometimes invokes us with targets `subdir_REAL-TARGET'.
193 # For targets we don't define, do nothing.
196 # These are targets that each glibc subdirectory is expected to understand.
197 # ../Rules defines them for code subdirectories; for us, they are no-ops.
198 # None of these should be `subdir_TARGET'; those targets are transformed
199 # by the implicit rule above into `TARGET' deps.
200 glibc-targets
:= lib objects objs others tests lint.out \
201 echo-headers echo-distinfo stubs
202 .PHONY
: $(glibc-targets
)
205 # Create stamp files if they don't exist, so the parent makefile's rules for
206 # updating the library archives are happy with us, and never think we have
207 # changed the library.
208 lib
: $(foreach o
,$(object-suffixes-for-libc
),$(objpfx
)stamp
$o)
209 stubs
: $(common-objpfx
)stub-manual
210 $(common-objpfx
)stub-manual ..
/po
/manual.pot
$(objpfx
)stamp
%:
211 $(make-target-directory
)
215 # Make the target directory if it doesn't exist, using the `mkinstalldirs'
216 # script that does `mkdir -p' even if `mkdir' doesn't support that flag.
217 define make-target-directory
218 $(addprefix $(..
).
/mkinstalldirs
,\
219 $(filter-out $(wildcard $(@D
:%/=%)),$(@D
:%/=%)))
222 # The top-level glibc Makefile expects subdir_install to update the stubs file.
223 subdir_install
: stubs
225 # Get rid of these variables if they came from the parent.