fltk/documentation/Makefile

312 lines
10 KiB
Makefile

#
# "$Id$"
#
# Documentation makefile for the Fast Light Tool Kit (FLTK).
#
# Copyright 1998-2010 by Bill Spitzak and others.
#
# This 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.
#
# This 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 this library; if not, write to the Free Software
# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
# USA.
#
# Please report all bugs and problems on the following page:
#
# http://www.fltk.org/str.php
#
# Get configuration stuff...
include ../makeinclude
# What media size to use:
# "Universal" size - minimum of US Letter and A4
MEDIA = --size universal
SRC_DOCDIR = ./src
# Standard US Letter
#MEDIA = --size letter
# Standard A4
#MEDIA = --size a4
# 7x8.5in (1/2 legal page) with reduced-size fonts
#MEDIA = --size 7x8.5in --fontsize 9.0
# These are the HTML "source" files...
HTMLFILES = \
$(SRC_DOCDIR)/index.dox \
$(SRC_DOCDIR)/preface.dox \
$(SRC_DOCDIR)/intro.dox \
$(SRC_DOCDIR)/basics.dox \
$(SRC_DOCDIR)/common.dox \
$(SRC_DOCDIR)/editor.dox \
$(SRC_DOCDIR)/drawing.dox \
$(SRC_DOCDIR)/events.dox \
$(SRC_DOCDIR)/subclassing.dox \
$(SRC_DOCDIR)/opengl.dox \
$(SRC_DOCDIR)/fluid.dox \
$(SRC_DOCDIR)/advanced.dox \
$(SRC_DOCDIR)/unicode.dox \
$(SRC_DOCDIR)/enumerations.dox \
$(SRC_DOCDIR)/glut.dox \
$(SRC_DOCDIR)/forms.dox \
$(SRC_DOCDIR)/osissues.dox \
$(SRC_DOCDIR)/migration_1_1.dox \
$(SRC_DOCDIR)/migration_1_3.dox \
$(SRC_DOCDIR)/development.dox \
$(SRC_DOCDIR)/license.dox \
$(SRC_DOCDIR)/examples.dox
IMAGEFILES = \
$(SRC_DOCDIR)/adjuster1.gif \
$(SRC_DOCDIR)/boxtypes.gif \
$(SRC_DOCDIR)/buttons.gif \
$(SRC_DOCDIR)/charts.gif \
$(SRC_DOCDIR)/choice.gif \
$(SRC_DOCDIR)/clock.gif \
$(SRC_DOCDIR)/counter.gif \
$(SRC_DOCDIR)/cubeview.gif \
$(SRC_DOCDIR)/dial.gif \
$(SRC_DOCDIR)/editor.gif \
$(SRC_DOCDIR)/editor-replace.gif \
$(SRC_DOCDIR)/fl_alert.gif \
$(SRC_DOCDIR)/fl_ask.gif \
$(SRC_DOCDIR)/Fl_Check_Button.gif \
$(SRC_DOCDIR)/fl_choice.gif \
$(SRC_DOCDIR)/fl_color_chooser.jpg \
$(SRC_DOCDIR)/Fl_File_Chooser.jpg \
$(SRC_DOCDIR)/Fl_File_Input.gif \
$(SRC_DOCDIR)/FL.gif \
$(SRC_DOCDIR)/Fl_Help_Dialog.gif \
$(SRC_DOCDIR)/fl_input.gif \
$(SRC_DOCDIR)/Fl_Light_Button.gif \
$(SRC_DOCDIR)/fl_message.gif \
$(SRC_DOCDIR)/fl_password.gif \
$(SRC_DOCDIR)/Fl_Return_Button.gif \
$(SRC_DOCDIR)/Fl_Roller.gif \
$(SRC_DOCDIR)/Fl_Round_Button.gif \
$(SRC_DOCDIR)/Fl_Scroll.gif \
$(SRC_DOCDIR)/fl_show_colormap.gif \
$(SRC_DOCDIR)/Fl_Tile.gif \
$(SRC_DOCDIR)/fluid1.gif \
$(SRC_DOCDIR)/fluid2.gif \
$(SRC_DOCDIR)/fluid3-cxx.gif \
$(SRC_DOCDIR)/fluid3-gui.gif \
$(SRC_DOCDIR)/fluid3-style.gif \
$(SRC_DOCDIR)/fluid4.gif \
$(SRC_DOCDIR)/fluid-catgets.gif \
$(SRC_DOCDIR)/fluid-gettext.gif \
$(SRC_DOCDIR)/fluid-org.gif \
$(SRC_DOCDIR)/fluid_prefs.gif \
$(SRC_DOCDIR)/fluid_widget_cxx.gif \
$(SRC_DOCDIR)/fluid_widget_gui.gif \
$(SRC_DOCDIR)/fluid_widget_style.gif \
$(SRC_DOCDIR)/Fl_Value_Input.gif \
$(SRC_DOCDIR)/Fl_Value_Output.gif \
$(SRC_DOCDIR)/hello.C.gif \
$(SRC_DOCDIR)/input_choice.jpg \
$(SRC_DOCDIR)/menubar.gif \
$(SRC_DOCDIR)/menu_button.gif \
$(SRC_DOCDIR)/menu.gif \
$(SRC_DOCDIR)/positioner.gif \
$(SRC_DOCDIR)/resizebox1.gif \
$(SRC_DOCDIR)/resizebox2.gif \
$(SRC_DOCDIR)/round_clock.gif \
$(SRC_DOCDIR)/scrollbar.gif \
$(SRC_DOCDIR)/slider.gif \
$(SRC_DOCDIR)/symbols.gif \
$(SRC_DOCDIR)/tabs.gif \
$(SRC_DOCDIR)/text.gif \
$(SRC_DOCDIR)/valuators.gif \
$(SRC_DOCDIR)/value_slider.gif
EPSFILES = \
$(SRC_DOCDIR)/FL.eps \
$(SRC_DOCDIR)/FL200.eps\
$(SRC_DOCDIR)/Fl_Check_Button.eps \
$(SRC_DOCDIR)/Fl_File_Chooser.eps \
$(SRC_DOCDIR)/Fl_File_Input.eps \
$(SRC_DOCDIR)/Fl_Help_Dialog.eps \
$(SRC_DOCDIR)/Fl_Light_Button.eps \
$(SRC_DOCDIR)/Fl_Return_Button.eps \
$(SRC_DOCDIR)/Fl_Roller.eps \
$(SRC_DOCDIR)/Fl_Round_Button.eps \
$(SRC_DOCDIR)/Fl_Scroll.eps \
$(SRC_DOCDIR)/Fl_Tile.eps \
$(SRC_DOCDIR)/Fl_Value_Input.eps \
$(SRC_DOCDIR)/Fl_Value_Output.eps \
$(SRC_DOCDIR)/adjuster1.eps \
$(SRC_DOCDIR)/boxtypes.eps \
$(SRC_DOCDIR)/buttons.eps \
$(SRC_DOCDIR)/charts.eps \
$(SRC_DOCDIR)/choice.eps \
$(SRC_DOCDIR)/clock.eps \
$(SRC_DOCDIR)/counter.eps \
$(SRC_DOCDIR)/cubeview.eps \
$(SRC_DOCDIR)/dial.eps \
$(SRC_DOCDIR)/editor-replace.eps \
$(SRC_DOCDIR)/editor.eps \
$(SRC_DOCDIR)/fl_alert.eps \
$(SRC_DOCDIR)/fl_ask.eps \
$(SRC_DOCDIR)/fl_choice.eps \
$(SRC_DOCDIR)/fl_color_chooser.eps \
$(SRC_DOCDIR)/fl_input.eps \
$(SRC_DOCDIR)/fl_message.eps \
$(SRC_DOCDIR)/fl_password.eps \
$(SRC_DOCDIR)/fl_show_colormap.eps \
$(SRC_DOCDIR)/fluid-catgets.eps \
$(SRC_DOCDIR)/fluid-gettext.eps \
$(SRC_DOCDIR)/fluid-org.eps \
$(SRC_DOCDIR)/fluid1.eps \
$(SRC_DOCDIR)/fluid2.eps \
$(SRC_DOCDIR)/fluid3-cxx.eps \
$(SRC_DOCDIR)/fluid3-gui.eps \
$(SRC_DOCDIR)/fluid3-style.eps \
$(SRC_DOCDIR)/fluid4.eps \
$(SRC_DOCDIR)/fluid_prefs.eps \
$(SRC_DOCDIR)/fluid_widget_cxx.eps \
$(SRC_DOCDIR)/fluid_widget_gui.eps \
$(SRC_DOCDIR)/fluid_widget_style.eps \
$(SRC_DOCDIR)/hello.C.eps \
$(SRC_DOCDIR)/input_choice.eps \
$(SRC_DOCDIR)/menu.eps \
$(SRC_DOCDIR)/menu_button.eps \
$(SRC_DOCDIR)/menubar.eps \
$(SRC_DOCDIR)/positioner.eps \
$(SRC_DOCDIR)/resizebox1.eps \
$(SRC_DOCDIR)/resizebox2.eps \
$(SRC_DOCDIR)/round_clock.eps \
$(SRC_DOCDIR)/scrollbar.eps \
$(SRC_DOCDIR)/slider.eps \
$(SRC_DOCDIR)/symbols.eps \
$(SRC_DOCDIR)/tabs.eps \
$(SRC_DOCDIR)/text.eps \
$(SRC_DOCDIR)/tiny.eps \
$(SRC_DOCDIR)/valuators.eps \
$(SRC_DOCDIR)/value_slider.eps
MANPAGES = $(SRC_DOCDIR)/fltk.$(CAT3EXT) $(SRC_DOCDIR)/fltk-config.$(CAT1EXT) \
$(SRC_DOCDIR)/fluid.$(CAT1EXT) $(SRC_DOCDIR)/blocks.$(CAT6EXT) \
$(SRC_DOCDIR)/checkers.$(CAT6EXT) $(SRC_DOCDIR)/sudoku.$(CAT6EXT)
all: $(MANPAGES)
alldocs: pdf-dist html $(MANPAGES)
clean:
# $(RM) fltk.ps
$(RM) refman.pdf
$(RMDIR) html latex
$(RM) *~ *.bck *.bck *.bak *.log
$(RM) $(MANPAGES) $(SRC_DOCDIR)/*.0
depend:
install: $(MANPAGES)
echo "Installing documentation files in $(DESTDIR)$(docdir)..."
-$(INSTALL_DIR) $(DESTDIR)$(docdir)
echo Installing file from $(INST_DOC_DIR)
if test -f html/index.html ; then \
for file in html/* ; do \
$(INSTALL_DATA) $$file $(DESTDIR)$(docdir); \
done \
fi
$(INSTALL_DATA) fltk.pdf $(DESTDIR)$(docdir); \
echo "Installing man pages in $(DESTDIR)$(mandir)..."
-$(INSTALL_DIR) $(DESTDIR)$(mandir)/cat1
$(INSTALL_MAN) $(SRC_DOCDIR)/fluid.$(CAT1EXT) $(DESTDIR)$(mandir)/cat1
$(INSTALL_MAN) $(SRC_DOCDIR)/fltk-config.$(CAT1EXT) $(DESTDIR)$(mandir)/cat1
-$(INSTALL_DIR) $(DESTDIR)$(mandir)/cat3
$(INSTALL_MAN) $(SRC_DOCDIR)/fltk.$(CAT3EXT) $(DESTDIR)$(mandir)/cat3
-$(INSTALL_DIR) $(DESTDIR)$(mandir)/man1
$(INSTALL_MAN) $(SRC_DOCDIR)/fluid.man $(DESTDIR)$(mandir)/man1/fluid.1
$(INSTALL_MAN) $(SRC_DOCDIR)/fltk-config.man $(DESTDIR)$(mandir)/man1/fltk-config.1
-$(INSTALL_DIR) $(DESTDIR)$(mandir)/man3
$(INSTALL_MAN) $(SRC_DOCDIR)/fltk.man $(DESTDIR)$(mandir)/man3/fltk.3
install-linux install-osx:
-$(INSTALL_DIR) $(DESTDIR)$(mandir)/cat6
$(INSTALL_MAN) $(SRC_DOCDIR)/blocks.$(CAT6EXT) $(DESTDIR)$(mandir)/cat6
$(INSTALL_MAN) $(SRC_DOCDIR)/checkers.$(CAT6EXT) $(DESTDIR)$(mandir)/cat6
$(INSTALL_MAN) $(SRC_DOCDIR)/sudoku.$(CAT6EXT) $(DESTDIR)$(mandir)/cat6
-$(INSTALL_DIR) $(DESTDIR)$(mandir)/man6
$(INSTALL_MAN) $(SRC_DOCDIR)/blocks.man $(DESTDIR)$(mandir)/man6/blocks.6
$(INSTALL_MAN) $(SRC_DOCDIR)/checkers.man $(DESTDIR)$(mandir)/man6/checkers.6
$(INSTALL_MAN) $(SRC_DOCDIR)/sudoku.man $(DESTDIR)$(mandir)/man6/sudoku.6
uninstall:
$(RMDIR) $(DESTDIR)$(docdir)
$(RM) $(DESTDIR)$(mandir)/cat1/fluid.$(CAT1EXT)
$(RM) $(DESTDIR)$(mandir)/man1/fluid.1
$(RM) $(DESTDIR)$(mandir)/cat1/fltk-config.$(CAT1EXT)
$(RM) $(DESTDIR)$(mandir)/man1/fltk-config.1
$(RM) $(DESTDIR)$(mandir)/cat3/fltk.$(CAT3EXT)
$(RM) $(DESTDIR)$(mandir)/man3/fltk.3
uninstall-linux uninstall-osx:
$(RM) $(DESTDIR)$(mandir)/cat6/blocks.$(CAT6EXT)
$(RM) $(DESTDIR)$(mandir)/cat6/checkers.$(CAT6EXT)
$(RM) $(DESTDIR)$(mandir)/cat6/sudoku.$(CAT6EXT)
$(RM) $(DESTDIR)$(mandir)/man6/blocks.6
$(RM) $(DESTDIR)$(mandir)/man6/checkers.6
$(RM) $(DESTDIR)$(mandir)/man6/sudoku.6
# Base html files are now the readable ones, so this target is not make by
# default...
html: html/index.html
html/index.html: $(HTMLFILES) $(IMAGEFILES) Doxyfile
echo "Generating HTML documentation..."
-$(RMDIR) html
-$(INSTALL_DIR) html
-$(DOXYDOC)
html-dist: html
echo "Stripping HTML files..."
./strip_tags
#fltk.ps: $(HTMLFILES) $(IMAGEFILES)
# echo "Generating PostScript documentation..."
# $(RM) fltk.ps
# -$(HTMLDOC) --verbose --batch $(SRC_DOCDIR)/fltk.book $(MEDIA) -f fltk.ps
pdf-dist: latex/refman.pdf
cp -f latex/refman.pdf fltk.pdf
pdf: latex/refman.pdf
latex/refman.pdf: latex/refman.tex Doxybook $(EPSFILES)
echo "Generating PDF documentation..."
$(DOXYDOC) Doxybook ;\
(cd latex ;\
pdflatex --interaction=nonstopmode refman.tex ;\
makeindex refman.idx ;\
pdflatex --interaction=nonstopmode refman.tex ;\
latex_count=5;\
while egrep -s 'Rerun (LaTeX|to get cross-references right)' refman.log \
&& [ $$latex_count -gt 0 ] ;\
do \
echo "Rerunning latex...." ;\
pdflatex --interaction=nonstopmode refman.tex ;\
latex_count=`expr $$latex_count - 1` ;\
done ; \
cd ..) > pdfall.log
latex/refman.tex: Doxybook $(EPSFILES)
#
# End of "$Id$".
#