X-Git-Url: https://pintos-os.org/cgi-bin/gitweb.cgi?a=blobdiff_plain;f=doc%2Fautomake.mk;h=801f278ce653a1fb8956a6c362b227befdd9d390;hb=08e7ac5d6dee8626969223b055fdf44ab1fc964c;hp=0ca4fe2ddeccbd5ed47e2f90df34c4c12ea5e77c;hpb=f6824ecbc579c68db49144fede419ca0acb0f53b;p=pspp

diff --git a/doc/automake.mk b/doc/automake.mk
index 0ca4fe2dde..801f278ce6 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 <http://www.gnu.org/licenses/>.
+
 ## 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,32 +34,207 @@ 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/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% *<property name="help[-_]page">\([^<]*\)</property>%//*[@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-spv: $(EXAMPLE_SPVS)
+example-txts: $(EXAMPLE_TXTS)
+example-texis: $(EXAMPLE_TEXIS)
+example-html: $(EXAMPLE_HTML)
+PHONY += example-spv example-txts example-texis example-html
+
+$(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
+
+# Use pspp to process a syntax file into an output file.
+pspp = src/ui/terminal/pspp
+$(EXAMPLE_SPVS): $(pspp)
+.sps.spv:
+	$(AM_V_GEN)(cd $(top_srcdir)/examples \
+         && $(abs_top_builddir)/$(pspp) ../doc/examples/$(<F) -o - -O format=spv) > $@.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.
+#
+# (For HTML, use sed to include only the contents of <body>.)
+$(EXAMPLE_TXTS) $(EXAMPLE_HTML): $(pspp_output)
+.spv.txt:
+	$(AM_V_GEN)utilities/pspp-output convert $< $@
+.spv.html:
+	$(AM_V_GEN)utilities/pspp-output convert $< - -O format=html \
+	| $(SED) -e '\%</body%,$$d' -e '0,/<body/d' > $@.tmp
+	$(AM_V_at)mv $@.tmp $@
+
+# Convert a text file into a Texinfo file.
+.txt.texi:
+	$(AM_V_GEN)sed 's/@/@@/g' < $< > $@.tmp
+	$(AM_V_at)mv $@.tmp $@
+
+# Insert the link tag for the cascading style sheet.
+# But make sure these operations are idempotent.
+html-local:
+	for h in doc/pspp.html/*.html; do \
+		if grep -Fq '<link rel="stylesheet"' $$h; then continue; fi ; \
+		$(SED) -i -e '/^<\/head>/i \\\
+<link rel="stylesheet" href="pspp-manual.css">' $$h; \
+	done
+
+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