mirror of
https://sourceware.org/git/glibc.git
synced 2024-12-22 02:40:08 +00:00
2244ddf2bf
2001-01-17 Ulrich Drepper <drepper@redhat.com> * manual/Makefile (chapters): Add debug. * manual/debug.texi: New file. * manual/examples/execinfo.c: New file. Patch by suckfish@ihug.co.nz.
265 lines
8.3 KiB
Makefile
265 lines
8.3 KiB
Makefile
# Copyright (C) 1992-1999, 2000, 2001 Free Software Foundation, Inc.
|
||
# This file is part of the GNU C Library.
|
||
|
||
# The GNU C Library is free software; you can redistribute it and/or
|
||
# modify it under the terms of the GNU Library General Public License
|
||
# as published by the Free Software Foundation; either version 2 of
|
||
# the License, or (at your option) any later version.
|
||
|
||
# The GNU C Library is distributed in the hope that it will be useful,
|
||
# but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
||
# Library General Public License for more details.
|
||
|
||
# You should have received a copy of the GNU Library General Public
|
||
# License along with the GNU C Library; see the file COPYING.LIB. If not,
|
||
# write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
|
||
# Boston, MA 02111-1307, USA.
|
||
|
||
# Makefile for the GNU C Library manual.
|
||
|
||
subdir := manual
|
||
export subdir := $(subdir)
|
||
|
||
# Allow override
|
||
INSTALL_INFO = install-info
|
||
|
||
.PHONY: all dvi pdf info
|
||
all: dvi
|
||
dvi: libc.dvi
|
||
pdf: libc.pdf
|
||
|
||
# Get glibc's configuration info.
|
||
ifneq (,$(wildcard ../Makeconfig))
|
||
include ../Makeconfig
|
||
else
|
||
MAKEINFO = makeinfo
|
||
TEXI2DVI = texi2dvi
|
||
AWK = gawk
|
||
endif
|
||
|
||
TEXI2PDF = texi2dvi --pdf
|
||
|
||
ifneq ($(strip $(MAKEINFO)),:)
|
||
all: info
|
||
info: libc.info dir-add.info
|
||
endif
|
||
|
||
# scripts we use
|
||
ifndef move-if-change
|
||
move-if-change = ./move-if-change
|
||
endif
|
||
mkinstalldirs = $(..)scripts/mkinstalldirs
|
||
|
||
chapters = $(addsuffix .texi, \
|
||
intro errno memory ctype string charset locale \
|
||
message search pattern io stdio llio filesys \
|
||
pipe socket terminal syslog math arith time \
|
||
resource setjmp signal startup process job nss \
|
||
users sysinfo conf crypt debug)
|
||
add-chapters = $(wildcard $(foreach d, $(add-ons), ../$d/$d.texi))
|
||
appendices = lang.texi header.texi install.texi maint.texi contrib.texi
|
||
|
||
-include texis
|
||
texis: texis.awk $(chapters) $(add-chapters) $(appendices) lgpl.texinfo
|
||
$(AWK) -f $^ > $@.T
|
||
mv -f $@.T $@
|
||
|
||
nonexamples = $(filter-out $(add-chapters) %.c.texi, $(texis))
|
||
examples = $(filter-out $(foreach d, $(add-ons), ../$d/%.c.texi), \
|
||
$(filter %.c.texi, $(texis)))
|
||
|
||
# Kludge: implicit rule so Make knows the one command does it all.
|
||
chapters.% top-menu.%: libc-texinfo.sh $(texis) Makefile
|
||
AWK=$(AWK) $(SHELL) $< '$(chapters)' '$(add-chapters)' '$(appendices)'
|
||
|
||
libc.dvi libc.pdf libc.info: chapters.texi top-menu.texi libm-err.texi
|
||
libc.dvi libc.pdf: texinfo.tex
|
||
|
||
# Generate the summary from the Texinfo source files for each chapter.
|
||
summary.texi: stamp-summary ;
|
||
stamp-summary: summary.awk $(filter-out summary.texi, $(texis))
|
||
$(AWK) -f $^ | sort -t' ' -df +0 -1 | tr '\014' '\012' > summary-tmp
|
||
$(move-if-change) summary-tmp summary.texi
|
||
touch $@
|
||
|
||
# Generate a file which can be added to the `dir' content to provide direct
|
||
# access to the documentation of the function, variables, and other
|
||
# definitions.
|
||
dir-add.info: xtract-typefun.awk $(texis)
|
||
(echo "INFO-DIR-SECTION GNU C library functions"; \
|
||
echo "START-INFO-DIR-ENTRY"; \
|
||
$(AWK) -f $^ | sort; \
|
||
echo "END-INFO-DIR-ENTRY") > $@.new
|
||
mv -f $@.new $@
|
||
|
||
# The table with the math errors is generated.
|
||
libm-err.texi: stamp-libm-err
|
||
stamp-libm-err: libm-err-tab.pl $(wildcard $(foreach dir,$(sysdirs),\
|
||
$(dir)/libm-test-ulps))
|
||
pwd=`pwd`; \
|
||
$(PERL) $< $$pwd/.. > libm-err-tmp
|
||
$(move-if-change) libm-err-tmp libm-err.texi
|
||
touch $@
|
||
|
||
# Generate Texinfo files from the C source for the example programs.
|
||
%.c.texi: examples/%.c
|
||
sed -e 's,[{}],@&,g' \
|
||
-e 's,/\*\(@.*\)\*/,\1,g' \
|
||
-e 's,/\* *,/* @r{,g' -e 's, *\*/,} */,' \
|
||
-e 's/\(@[a-z][a-z]*\)@{\([^}]*\)@}/\1{\2}/g'\
|
||
$< | expand > $@.new
|
||
mv -f $@.new $@
|
||
|
||
%.info: %.texinfo
|
||
LANGUAGE=C LC_ALL=C $(MAKEINFO) $<
|
||
|
||
%.dvi: %.texinfo
|
||
$(TEXI2DVI) $<
|
||
|
||
%.pdf: %.texinfo
|
||
$(TEXI2PDF) $<
|
||
|
||
# Distribution.
|
||
minimal-dist = summary.awk texis.awk tsort.awk libc-texinfo.sh libc.texinfo \
|
||
libm-err.texi stamp-libm-err \
|
||
$(filter-out summary.texi, $(nonexamples)) \
|
||
$(patsubst %.c.texi,examples/%.c, $(examples))
|
||
|
||
doc-only-dist = Makefile COPYING.LIB
|
||
distribute = $(minimal-dist) $(examples) stdio-fp.c \
|
||
libc.info* libc.?? libc.??s texinfo.tex \
|
||
xtract-typefun.awk dir-add.info dir libm-err-tab.pl
|
||
export distribute := $(distribute)
|
||
|
||
tar-it = tar chovf $@ $^
|
||
|
||
manual.tar: $(doc-only-dist) $(minimal-dist) ; $(tar-it)
|
||
mandist.tar: $(doc-only-dist) $(distribute) ; $(tar-it)
|
||
|
||
edition := $(shell sed -n 's/^@set EDITION \([0-9][0-9.]*\)[^0-9.]*.*$$/\1/p' \
|
||
libc.texinfo)
|
||
|
||
glibc-doc-$(edition).tar: $(doc-only-dist) $(distribute)
|
||
@rm -f glibc-doc-$(edition)
|
||
ln -s . glibc-doc-$(edition)
|
||
tar chovf $@ $(addprefix glibc-doc-$(edition)/,$^)
|
||
rm -f glibc-doc-$(edition)
|
||
|
||
%.Z: %
|
||
compress -c $< > $@.new
|
||
mv -f $@.new $@
|
||
%.gz: %
|
||
gzip -9 -c $< > $@.new
|
||
mv -f $@.new $@
|
||
%.uu: %
|
||
uuencode $< < $< > $@.new
|
||
mv -f $@.new $@
|
||
|
||
.PHONY: mostlyclean distclean realclean clean
|
||
mostlyclean:
|
||
-rm -f libc.dvi libc.pdf libc.tmp libc.info* dir-add.info
|
||
-rm -f $(objpfx)stubs $(objpfx)distinfo
|
||
-rm -f $(foreach o,$(object-suffixes-for-libc),$(objpfx)stamp$o)
|
||
clean: mostlyclean
|
||
distclean: clean
|
||
indices = cp fn pg tp vr ky
|
||
realclean: distclean
|
||
-rm -f texis summary.texi stamp-summary *.c.texi
|
||
-rm -f $(foreach index,$(indices),libc.$(index) libc.$(index)s)
|
||
-rm -f libc.log libc.aux libc.toc dir-add.texinfo
|
||
-rm -f top-menu.texi chapters.texi
|
||
|
||
.PHONY: install subdir_install installdirs install-data
|
||
install-data subdir_install: install
|
||
ifneq ($(strip $(MAKEINFO)),:)
|
||
# There are two variants of install-info out there. The GNU version
|
||
# knows about the INFO-DIR-SECTION tag, the Debian version doesn't.
|
||
ifneq ($(OLD_DEBIAN_INSTALL_INFO),yes)
|
||
install: $(inst_infodir)/libc.info dir-add.info
|
||
@if $(SHELL) -c '$(INSTALL_INFO) --version' >/dev/null 2>&1; then \
|
||
test -f $(inst_infodir)/dir || cp dir $(inst_infodir);\
|
||
$(INSTALL_INFO) --info-dir=$(inst_infodir) $(inst_infodir)/libc.info;\
|
||
$(INSTALL_INFO) --info-dir=$(inst_infodir) dir-add.info;\
|
||
else : ; fi
|
||
else
|
||
install: $(inst_infodir)/libc.info dir-add.info
|
||
@if $(SHELL) -c '$(INSTALL_INFO) --version' >/dev/null 2>&1; then \
|
||
test -f $(inst_infodir)/dir || cp dir $(inst_infodir);\
|
||
$(INSTALL_INFO) --info-dir=$(inst_infodir) \
|
||
--section '^GNU Libraries:' 'GNU Libraries:' \
|
||
$(inst_infodir)/libc.info;\
|
||
$(INSTALL_INFO) --info-dir=$(inst_infodir) \
|
||
--section '^GNU C Library functions:' 'GNU C Library functions:' \
|
||
dir-add.info;\
|
||
else : ; fi
|
||
endif
|
||
endif
|
||
# Catchall implicit rule for other installation targets from the parent.
|
||
install-%: ;
|
||
|
||
$(inst_infodir)/libc.info: libc.info installdirs
|
||
for file in $<*; do \
|
||
$(INSTALL_DATA) $$file $(@D)/$$file; \
|
||
done
|
||
|
||
installdirs:
|
||
$(mkinstalldirs) $(inst_infodir)
|
||
|
||
.PHONY: dist
|
||
dist: # glibc-doc-$(edition).tar.gz
|
||
|
||
ifneq (,$(wildcard ../Make-dist))
|
||
dist: ../Make-dist
|
||
$(MAKE) -f $< $(Make-dist-args)
|
||
endif
|
||
|
||
ifndef ETAGS
|
||
ETAGS = etags -T
|
||
endif
|
||
TAGS: $(minimal-dist)
|
||
$(ETAGS) -o $@ $^
|
||
|
||
# The parent makefile sometimes invokes us with targets `subdir_REAL-TARGET'.
|
||
subdir_%: % ;
|
||
# For targets we don't define, do nothing.
|
||
subdir_%: ;
|
||
|
||
# These are targets that each glibc subdirectory is expected to understand.
|
||
# ../Rules defines them for code subdirectories; for us, they are no-ops.
|
||
# None of these should be `subdir_TARGET'; those targets are transformed
|
||
# by the implicit rule above into `TARGET' deps.
|
||
glibc-targets := lib objects objs others tests lint.out \
|
||
echo-headers echo-distinfo
|
||
.PHONY: $(glibc-targets)
|
||
$(glibc-targets):
|
||
|
||
# Create stamp files if they don't exist, so the parent makefile's rules for
|
||
# updating the library archives are happy with us, and never think we have
|
||
# changed the library.
|
||
lib: $(foreach o,$(object-suffixes-for-libc),$(objpfx)stamp$o)
|
||
ifdef objpfx
|
||
.PHONY: stubs
|
||
stubs: $(objpfx)stubs
|
||
endif
|
||
$(objpfx)stubs ../po/manual.pot $(objpfx)stamp%:
|
||
$(make-target-directory)
|
||
touch $@
|
||
|
||
# Make the target directory if it doesn't exist, using the `mkinstalldirs'
|
||
# script that does `mkdir -p' even if `mkdir' doesn't support that flag.
|
||
define make-target-directory
|
||
$(addprefix $(mkinstalldirs) ,\
|
||
$(filter-out $(wildcard $(@D:%/=%)),$(@D:%/=%)))
|
||
endef
|
||
|
||
# The top-level glibc Makefile expects subdir_install to update the stubs file.
|
||
subdir_install: stubs
|
||
|
||
# Get rid of these variables if they came from the parent.
|
||
routines =
|
||
aux =
|
||
sources =
|
||
objects =
|
||
headers =
|