X-Git-Url: https://pintos-os.org/cgi-bin/gitweb.cgi?a=blobdiff_plain;f=doc%2Fautomake.mk;h=9f801bc8accbf3c17b41b6fef7101706f4c29a4e;hb=6a50718dac78d358a703d6c1635afc10e1cd0a6d;hp=4eb3b30016d42dd6cd8e2ff7f00c6bc6ebfcb5b9;hpb=571f85fc18f4b8cafea2d7b8ea6cf2c4cb2b02c8;p=pspp diff --git a/doc/automake.mk b/doc/automake.mk index 4eb3b30016..9f801bc8ac 100644 --- a/doc/automake.mk +++ b/doc/automake.mk @@ -1,17 +1,32 @@ +## PSPP - a program for statistical analysis. +## Copyright (C) 2019, 2020 Free Software Foundation, Inc. +## +## This program is free software: you can redistribute it and/or modify +## it under the terms of the GNU General Public License as published by +## the Free Software Foundation, either version 3 of the License, or +## (at your option) any later version. +## +## This program 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 General Public License for more details. +## +## You should have received a copy of the GNU General Public License +## along with this program. If not, see . + ## Process this file with automake to produce Makefile.in -*- makefile -*- -info_TEXINFOS = doc/pspp.texinfo +info_TEXINFOS = doc/pspp.texi doc/pspp-dev.texi doc_pspp_TEXINFOS = doc/version.texi \ doc/bugs.texi \ doc/command-index.texi \ doc/concept-index.texi \ - doc/configuring.texi \ - doc/data-file-format.texi \ doc/data-io.texi \ doc/data-selection.texi \ doc/expressions.texi \ doc/files.texi \ + doc/combining.texi \ doc/flow-control.texi \ doc/function-index.texi \ doc/installing.texi \ @@ -19,33 +34,201 @@ doc_pspp_TEXINFOS = doc/version.texi \ doc/invoking.texi \ doc/language.texi \ doc/license.texi \ + doc/pspp-convert.texi \ + doc/pspp-output.texi \ + doc/pspp-dump-sav.texi \ + doc/ni.texi \ doc/not-implemented.texi \ - doc/portable-file-format.texi \ - doc/q2c.texi \ doc/statistics.texi \ doc/transformation.texi \ + doc/tutorial.texi \ + doc/tut.texi \ doc/regression.texi \ doc/utilities.texi \ doc/variables.texi \ - doc/fdl.texi + doc/fdl.texi + +doc_pspp_dev_TEXINFOS = doc/version-dev.texi \ + doc/dev/intro.texi \ + doc/dev/concepts.texi \ + doc/dev/syntax.texi \ + doc/dev/data.texi \ + doc/dev/i18n.texi \ + doc/dev/output.texi \ + doc/dev/system-file-format.texi \ + doc/dev/pc+-file-format.texi \ + doc/dev/portable-file-format.texi \ + doc/dev/spv-file-format.texi \ + doc/dev/tlo-file-format.texi \ + doc/dev/encrypted-file-wrappers.texi \ + doc/dev/q2c.texi + +dist_man_MANS += doc/pspp.1 \ + doc/psppire.1 + +EXTRA_DIST += doc/get-commands.pl \ + doc/help-pages-list \ + doc/prepdoc.sh + +$(srcdir)/doc/ni.texi: $(top_srcdir)/src/language/command.def doc/get-commands.pl + $(AM_V_GEN)$(PERL) $(top_srcdir)/doc/get-commands.pl $(top_srcdir)/src/language/command.def > $@ + +$(srcdir)/doc/tut.texi: + $(AM_V_GEN)echo "@set example-dir $(examplesdir)" > $@ + + +doc/pspp.xml: doc/pspp.texi $(doc_pspp_TEXINFOS) doc/help-pages-list +if BROKEN_DOCBOOK_XML + touch $@ +else + $(AM_V_GEN)$(MAKEINFO) $(AM_MAKEINFOFLAGS) --docbook -I $(top_srcdir) \ + $< -o $@ +endif + +docbookdir = $(docdir) +dist_docbook_DATA = doc/pspp.xml + + +CLEANFILES += pspp-dev.dvi $(docbook_DATA) doc/pspp.info* doc/pspp.xml + + +doc: $(INFO_DEPS) $(DVIS) $(PDFS) $(PSS) $(HTMLS) $(dist_docbook_DATA) +PHONY += doc + +doc/help-pages-list: $(UI_FILES) + $(AM_V_GEN)cat $^ | grep '"help[-_]page"' | \ + $(SED) -e 's% *\([^<]*\)%//*[@id='"'"'\1'"'"']%' \ + -e 's%#%'"'"']/*[@id='"'"'%g' > $@,tmp + test -s $@,tmp + mv $@,tmp $@ + +EXTRA_DIST += \ + doc/help-pages-list \ + doc/pspp-manual.css + + +AM_MAKEINFOFLAGS=-I $(top_srcdir)/doc/examples -I $(top_builddir)/doc/examples +am__TEXINFO_TEX_DIR=:$(top_srcdir)/doc/examples:$(top_builddir)/doc/examples + +################# Example programs ############################## + +EXAMPLE_SYNTAX = \ + doc/examples/autorecode.sps \ + doc/examples/chisquare.sps \ + doc/examples/compute.sps \ + doc/examples/count.sps \ + doc/examples/descriptives.sps \ + doc/examples/flip.sps \ + doc/examples/frequencies.sps \ + doc/examples/means.sps \ + doc/examples/one-sample-t.sps \ + doc/examples/independent-samples-t.sps \ + doc/examples/reliability.sps \ + doc/examples/split.sps \ + doc/examples/tutorial1.sps \ + doc/examples/tutorial2.sps \ + doc/examples/tutorial3.sps \ + doc/examples/tutorial4.sps \ + doc/examples/tutorial5.sps \ + doc/examples/tutorial6.sps \ + doc/examples/tutorial7.sps \ + doc/examples/weight.sps + + +EXTRA_DIST += $(EXAMPLE_SYNTAX) + +EXAMPLE_SPVS = $(EXAMPLE_SYNTAX:.sps=.spv) \ + doc/examples/tutorial2a.spv \ + doc/examples/tutorial2b.spv \ + doc/examples/tutorial5a.spv \ + doc/examples/tutorial5b.spv \ + doc/examples/tutorial7a.spv \ + doc/examples/tutorial7b.spv +EXAMPLE_TXTS = $(EXAMPLE_SPVS:.spv=.txt) +EXAMPLE_TEXIS = $(EXAMPLE_TXTS:.txt=.texi) +EXAMPLE_HTML = $(EXAMPLE_SPVS:.spv=.html) +EXAMPLE_PDF = $(EXAMPLE_SPVS:.spv=.pdf) + +example-spv: $(EXAMPLE_SPVS) +example-txts: $(EXAMPLE_TXTS) +example-texis: $(EXAMPLE_TEXIS) +example-html: $(EXAMPLE_HTML) +example-pdf: $(EXAMPLE_PDF) +PHONY += example-spv example-txts example-texis example-html example-pdf + +$(top_builddir)/doc/pspp.info: $(EXAMPLE_TEXIS) +$(top_builddir)/doc/pspp.ps: $(EXAMPLE_TEXIS) +$(top_builddir)/doc/pspp.dvi: $(EXAMPLE_TEXIS) +$(top_builddir)/doc/pspp.html: $(EXAMPLE_HTML) +$(top_builddir)/doc/pspp.pdf: $(EXAMPLE_TEXIS) +$(top_builddir)/doc/pspp.xml: $(EXAMPLE_TEXIS) + +CLEANFILES += $(EXAMPLE_TXTS) $(EXAMPLE_SPVS) $(EXAMPLE_TEXIS) $(EXAMPLE_HTML) +SUFFIXES += .sps .spv .txt .html .texi .pdf + +# Use pspp to process a syntax file into an output file. +pspp = src/ui/terminal/pspp +$(EXAMPLE_SPVS): $(pspp)$(EXEEXT) +.sps.spv: + $(AM_V_GEN)(cd $(top_srcdir)/examples \ + && $(abs_top_builddir)/$(pspp) ../doc/examples/$( $@.tmp + $(AM_V_at)mv $@.tmp $@ + +# In some cases, the tutorial only wants some parts of the output. +pspp_output = utilities/pspp-output +convert = $(AM_V_GEN)$(pspp_output) convert $< $@ +doc/examples/tutorial2a.spv: doc/examples/tutorial2.spv $(pspp_output) + $(convert) --command='Descriptives' +doc/examples/tutorial2b.spv: doc/examples/tutorial2.spv $(pspp_output) + $(convert) --label='Extreme Values' +doc/examples/tutorial5a.spv: doc/examples/tutorial5.spv $(pspp_output) + $(convert) --commands=examine --nth-command=1 --labels=descriptives +doc/examples/tutorial5b.spv: doc/examples/tutorial5.spv $(pspp_output) + $(convert) --commands=examine --nth-command=2 --labels=descriptives +doc/examples/tutorial7a.spv: doc/examples/tutorial7.spv $(pspp_output) + $(convert) --commands=regression --nth-command=1 --subtypes=coefficients +doc/examples/tutorial7b.spv: doc/examples/tutorial7.spv $(pspp_output) + $(convert) --commands=regression --nth-command=2 --subtypes=coefficients + +# Convert an output file into a text file or HTML file. +$(EXAMPLE_TXTS) $(EXAMPLE_HTML): $(pspp_output) +.spv.txt: + $(AM_V_GEN)utilities/pspp-output convert $< $@ +.spv.pdf: + $(AM_V_GEN)utilities/pspp-output convert $< $@ -O left-margin=0pt -O right-margin=0pt -O top-margin=0pt -O bottom-margin=0pt -O paper-size=6x20in -O font-size=12000 --table-look=$(HOME)/pspp/spss15/Looks/report.tlo +.spv.html: + $(AM_V_GEN)utilities/pspp-output convert $< $@ -O format=html -O bare=true + +# Convert a text file into a Texinfo file. +.txt.texi: + $(AM_V_GEN)$(SED) -e 's/@/@@/g' $< > $@ + +AM_MAKEINFOHTMLFLAGS = $(AM_MAKEINFOFLAGS) --css-ref=pspp-manual.css +html-local: + +install-html-local: html-local + $(MKDIR_P) $(DESTDIR)$(prefix)/share/doc/pspp/pspp.html + $(INSTALL_DATA) ${top_srcdir}/doc/pspp-manual.css $(DESTDIR)$(prefix)/share/doc/pspp/pspp.html -nodist_doc_pspp_TEXINFOS = doc/ni.texi + -EXTRA_DIST += doc/pspp.man \ - doc/get-commands.pl \ - $(doc_pspp_TEXINFOS) +desktopdir = $(datadir)/applications -CLEANFILES += doc/pspp.info doc/pspp.info-* $(top_builddir)/doc/ni.texi +doc/org.fsf.pspp.metainfo.xml: doc/org.fsf.pspp.metainfo.xml.in $(POFILES) + $(AM_V_GEN)$(MSGFMT) --xml --template $< -o $@ -d $(top_srcdir)/po || \ + $(MSGFMT) -L appdata --xml --template $< -o $@ -d $(top_srcdir)/po -#Kludge to overcome automake limitations -doc/%.dvi: am__TEXINFO_TEX_DIR=$(top_builddir)/doc +doc/org.fsf.pspp.desktop: doc/org.fsf.pspp.desktop.in $(POFILES) + $(AM_V_GEN)$(MSGFMT) --desktop --template $< -o $@ -d $(top_srcdir)/po -doc/ni.texi: $(top_srcdir)/src/language/command.def doc/get-commands.pl - @mkdir -p doc - @PERL@ $(top_srcdir)/doc/get-commands.pl $(top_srcdir)/src/language/command.def > $@ +CLEANFILES+=doc/org.fsf.pspp.desktop \ + doc/org.fsf.pspp.metainfo.xml +desktop_DATA = doc/org.fsf.pspp.desktop -$(INFO_DEPS): $(top_builddir)/doc/ni.texi -$(HTML_DEPS): $(top_builddir)/doc/ni.texi +appdatadir = $(datadir)/metainfo +dist_appdata_DATA = doc/org.fsf.pspp.metainfo.xml +EXTRA_DIST += doc/org.fsf.pspp.metainfo.xml.in \ + doc/org.fsf.pspp.desktop.in