1 # Copyright (C) 1992-2012
2 # Free Software Foundation, Inc.
3 # This file is part of the GNU C Library.
5 # The GNU C Library is free software; you can redistribute it and/or
6 # modify it under the terms of the GNU Lesser General Public
7 # License as published by the Free Software Foundation; either
8 # version 2.1 of the License, or (at your option) any later version.
10 # The GNU C Library is distributed in the hope that it will be useful,
11 # but WITHOUT ANY WARRANTY; without even the implied warranty of
12 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
13 # Lesser General Public License for more details.
15 # You should have received a copy of the GNU Lesser General Public
16 # License along with the GNU C Library; if not, see
17 # <http://www.gnu.org/licenses/>.
19 # Makefile for the GNU C Library manual.
24 INSTALL_INFO
= install-info
26 .PHONY
: dvi pdf
info html
28 # Get glibc's configuration info.
31 dvi: $(objpfx
)libc.
dvi
32 pdf
: $(objpfx
)libc.pdf
35 TEXI2PDF
= texi2dvi --pdf
37 ifneq ($(strip $(MAKEINFO
)),:)
38 info: $(objpfx
)libc.
info
41 chapters
= $(addsuffix .texi
, \
42 intro errno memory ctype string charset locale \
43 message search pattern io stdio llio filesys \
44 pipe socket terminal syslog math arith time \
45 resource setjmp signal startup process job nss \
46 users sysinfo conf crypt debug
)
47 add-chapters
= $(wildcard $(foreach d
, $(add-ons
), ..
/$d/$d.texi
))
48 appendices
= lang.texi header.texi
install.texi maint.texi platform.texi \
50 licenses
= freemanuals.texi lgpl-2.1.texi fdl-1.3.texi
52 -include $(objpfx
)texis
53 $(objpfx
)texis
: texis.awk
$(chapters
) $(add-chapters
) $(appendices
) $(licenses
)
57 nonexamples
= $(filter-out $(add-chapters
) %.c.texi
, $(texis
))
58 examples
= $(filter-out $(foreach d
, $(add-ons
), ..
/$d/%.c.texi
), \
59 $(filter %.c.texi
, $(texis
)))
61 # Generated files directly included from libc.texinfo.
62 libc-texi-generated
= chapters.texi top-menu.texi dir-add.texi \
63 libm-err.texi version.texi
65 # Add path to build dir for generated files
66 texis-path
:= $(filter-out $(libc-texi-generated
) summary.texi
$(examples
), \
68 $(addprefix $(objpfx
),$(filter $(libc-texi-generated
) summary.texi \
69 $(examples
), $(texis
)))
71 # Kludge: implicit rule so Make knows the one command does it all.
72 chapters.
% top-menu.
%: libc-texinfo.sh
$(texis-path
) Makefile
73 AWK
=$(AWK
) $(SHELL
) $< $(objpfx
) \
76 '$(appendices) $(licenses)'
79 $(objpfx
)libc.
dvi $(objpfx
)libc.pdf
$(objpfx
)libc.
info: \
80 $(addprefix $(objpfx
),$(libc-texi-generated
))
81 $(objpfx
)libc.
dvi $(objpfx
)libc.pdf
: texinfo.
tex
83 html
: $(objpfx
)libc
/index.html
84 $(objpfx
)libc
/index.html
: $(addprefix $(objpfx
),$(libc-texi-generated
))
85 $(MAKEINFO
) -P
$(objpfx
) -o
$(objpfx
)libc
--html libc.texinfo
87 # Generate the summary from the Texinfo source files for each chapter.
88 $(objpfx
)summary.texi
: $(objpfx
)stamp-summary
;
89 $(objpfx
)stamp-summary
: summary.awk
$(filter-out $(objpfx
)summary.texi
, \
91 $(AWK
) -f
$^ |
sort -t
'\f' -df
-k
1,1 | tr
'\014' '\012' \
92 > $(objpfx
)summary-tmp
93 $(move-if-change
) $(objpfx
)summary-tmp
$(objpfx
)summary.texi
96 # Generate a file which can be added to the `dir' content to provide direct
97 # access to the documentation of the function, variables, and other
99 $(objpfx
)dir-add.texi
: xtract-typefun.awk
$(texis-path
)
100 (echo
"@dircategory GNU C library functions and macros"; \
102 $(AWK
) -f
$^ |
sort; \
103 echo
"@end direntry") > $@.new
106 # The table with the math errors is generated.
107 $(objpfx
)libm-err.texi
: $(objpfx
)stamp-libm-err
108 $(objpfx
)stamp-libm-err
: libm-err-tab.pl
$(wildcard $(foreach dir,$(sysdirs
),\
109 $(dir)/libm-test-ulps
))
111 $(PERL
) $< $$pwd/..
> $(objpfx
)libm-err-tmp
112 $(move-if-change
) $(objpfx
)libm-err-tmp
$(objpfx
)libm-err.texi
115 # Generate a file with the version number.
116 $(objpfx
)version.texi
: $(objpfx
)stamp-version
;
117 $(objpfx
)stamp-version
: $(common-objpfx
)config.make
118 echo
"@set VERSION $(version)" > $(objpfx
)version-tmp
119 $(move-if-change
) $(objpfx
)version-tmp
$(objpfx
)version.texi
122 # Generate Texinfo files from the C source for the example programs.
123 $(objpfx
)%.c.texi
: examples
/%.c
124 sed
-e
'1,/^\*\/$$/d' \
126 -e
's,/\*\(@.*\)\*/,\1,g' \
127 -e
's,/\* *,/* @r{,g' -e
's, *\*/,} */,' \
128 -e
's/\(@[a-z][a-z]*\)@{\([^}]*\)@}/\1{\2}/g'\
132 $(objpfx
)%.
info: %.texinfo
133 LANGUAGE
=C LC_ALL
=C
$(MAKEINFO
) -P
$(objpfx
) --output
=$@
$<
135 $(objpfx
)%.
dvi: %.texinfo
136 cd
$(objpfx
);$(TEXI2DVI
) -I
$(shell cd
$(<D
) && pwd
) --output
=$@ \
137 $(shell cd
$(<D
) && pwd
)/$<
139 $(objpfx
)%.pdf
: %.texinfo
140 cd
$(objpfx
);$(TEXI2PDF
) -I
$(shell cd
$(<D
) && pwd
) --output
=$@ \
141 $(shell cd
$(<D
) && pwd
)/$<
145 minimal-dist
= summary.awk texis.awk tsort.awk libc-texinfo.sh libc.texinfo \
146 libm-err.texi stamp-libm-err \
147 $(filter-out summary.texi
, $(nonexamples
)) \
148 $(patsubst %.c.texi
,examples
/%.c
, $(examples
))
150 indices
= cp fn pg tp vr ky
151 generated-dirs
:= libc
152 generated
= libc.
dvi libc.pdf libc.tmp libc.
info* \
154 texis summary.texi stamp-summary
*.c.texi \
155 $(foreach index
,$(indices
),libc.
$(index
) libc.
$(index
)s
) \
156 libc.log libc.aux libc.toc \
157 $(libc-texi-generated
) \
158 stamp-libm-err stamp-version
162 .PHONY
: install subdir_install install-data
163 install-data subdir_install
: install
164 ifneq ($(strip $(MAKEINFO
)),:)
165 install: $(inst_infodir
)/libc.
info
166 @if
$(SHELL
) -c
'$(INSTALL_INFO) --version' >/dev
/null
2>&1; then \
167 test -f
$(inst_infodir
)/dir ||
$(INSTALL_DATA
) dir $(inst_infodir
);\
168 $(INSTALL_INFO
) --info-dir
=$(inst_infodir
) $(inst_infodir
)/libc.
info;\
171 # Catchall implicit rule for other installation targets from the parent.
174 $(inst_infodir
)/libc.
info: $(objpfx
)libc.
info
175 $(make-target-directory
)
176 for file in
$<*; do \
177 $(INSTALL_DATA
) $$file $(@D
)/; \
180 TAGS
: $(minimal-dist
)