diff options
Diffstat (limited to 'Build/source/libs/zziplib/zziplib-src/docs/Makefile.am')
-rw-r--r-- | Build/source/libs/zziplib/zziplib-src/docs/Makefile.am | 281 |
1 files changed, 281 insertions, 0 deletions
diff --git a/Build/source/libs/zziplib/zziplib-src/docs/Makefile.am b/Build/source/libs/zziplib/zziplib-src/docs/Makefile.am new file mode 100644 index 00000000000..ec0dd845747 --- /dev/null +++ b/Build/source/libs/zziplib/zziplib-src/docs/Makefile.am @@ -0,0 +1,281 @@ +AUTOMAKE_OPTIONS = 1.4 foreign +AUTOTOOL_VERSION=autoconf-2.52 automake-1.5 libtool-1.4.2 + +PYRUN = PYTHONDONTWRITEBYTECODE=1 $(PYDEFS) @PYTHON@ $(PYFLAGS) +PLRUN = PERL_DL_NONLAZY=1 $(PLDEFS) @PERL@ $(PLFLAGS) +DELETE = echo deleting... + +doc_FILES = README.MSVC6 README.SDL COPYING.MPL COPYING.LIB COPYING.ZLIB \ + zziplib.html zzipmmapped.html zzipfseeko.html +htm_FILES = zzip-index.htm zzip-zip.htm zzip-file.htm zzip-sdl-rwops.htm \ + zzip-extio.htm zzip-xor.htm zzip-crypt.htm zzip-cryptoid.htm \ + zzip-api.htm zzip-basics.htm zzip-extras.htm zzip-parse.htm \ + 64on32.htm future.htm fseeko.htm mmapped.htm memdisk.htm \ + configs.htm sfx-make.htm developer.htm download.htm \ + history.htm referentials.htm faq.htm copying.htm notes.htm \ + functions.htm zip-php.htm +htms_FILES = changes.htm +SDL = @top_srcdir@/SDL +SDL_RWOPS = $(SDL)/SDL_rwops_zzcat.c \ + $(SDL)/SDL_rwops_zzip.c $(SDL)/SDL_rwops_zzip.h +changelog = @top_srcdir@/ChangeLog + +EXTRA_DIST = make-doc.py $(doc_FILES) $(htm_FILES) $(SDL_RWOPS) \ + make-doc.pl make-dbk.pl mksite.sh mksite.pl body.htm \ + $(zzipdoc_FILES) sdocbook.css \ + zziplib-manpages.dbk zziplib-master.dbk \ + zziplib-manpages.tar +CLEANFILES = *.pc *.omf +DISTCLEANFILES = zziplib.spec manpages.tar htmpages.tar *.html *.xml + +zzipdoc_FILES = makedocs.py zzipdoc/__init__.py \ + zzipdoc/commentmarkup.py zzipdoc/match.py \ + zzipdoc/dbk2htm.py zzipdoc/htm2dbk.py \ + zzipdoc/functionheader.py zzipdoc/options.py \ + zzipdoc/functionlisthtmlpage.py zzipdoc/textfileheader.py \ + zzipdoc/functionlistreference.py zzipdoc/textfile.py \ + zzipdoc/functionprototype.py zzipdoc/htmldocument.py \ + zzipdoc/docbookdocument.py + +html_FILES = $(htm_FILES:.htm=.html) $(htms_FILES:.htm=.html) \ + $(htm_FILES:.htm=.print.html) $(htms_FILES:.htm=.print.html) \ + site.html site.print.html + +all : all-am default +default : doc @MAINTAINER_MODE_FALSE@ mans +clean-doc clean-docs : clean-unpack + - rm $(DISTCLEANFILES) + - rm $(MAINTAINERCLEANFILES) +install-data-local : @MAINTAINER_MODE_FALSE@ install-mans + +# ------------------------------------------------------------------- +zziplib.spec : @top_srcdir@/$(PACKAGE).spec + @ cp $? $@ # the two zzip-doc.* will grep thru zziplib.spec +doc : $(doc_FILES) site.html +docs : doc manpages.tar htmpages.tar +# docu : docs +docu : + - rm zziplib2.html zzipmmapped.html zzipfseeko.html + $(MAKE) manpages.tar htmpages.tar DELETE=exit + +zziplib.html: zziplib.xml +zziplib.xml: zziplib.spec $(srcdir)/Makefile.am \ + $(srcdir)/zzipdoc/*.py \ + $(srcdir)/makedocs.py @top_srcdir@/zzip/*.c + $(PYRUN) $(srcdir)/makedocs.py @top_srcdir@/zzip/*.c $(zziplib) \ + "--package=$(PACKAGE)" "--version=$(VERSION)" \ + "--onlymainheader=zzip/lib.h" "--output=zziplib" + test -s zziplib.docbook && mv zziplib.docbook zziplib.xml +zzipmmapped.html: zzipmmapped.xml +zzipmmapped.xml: zziplib.spec $(srcdir)/Makefile.am \ + $(srcdir)/zzipdoc/*.py \ + $(srcdir)/makedocs.py @top_srcdir@/zzip/*.c + $(PYRUN) $(srcdir)/makedocs.py @top_srcdir@/zzip/*.c $(zziplib) \ + "--package=$(PACKAGE)" "--version=$(VERSION)" \ + "--onlymainheader=zzip/mmapped.h" "--output=zzipmmapped" + test -s zzipmmapped.docbook && mv zzipmmapped.docbook zzipmmapped.xml +zzipfseeko.html: zzipfseeko.xml +zzipfseeko.xml: zziplib.spec $(srcdir)/Makefile.am \ + $(srcdir)/zzipdoc/*.py \ + $(srcdir)/makedocs.py @top_srcdir@/zzip/*.c + $(PYRUN) $(srcdir)/makedocs.py @top_srcdir@/zzip/*.c $(zziplib) \ + "--package=$(PACKAGE)" "--version=$(VERSION)" \ + "--onlymainheader=zzip/fseeko.h" "--output=zzipfseeko" + test -s zzipfseeko.docbook && mv zzipfseeko.docbook zzipfseeko.xml + +omfdir=${datadir}/omf +pkgomfdir=${omfdir}/${PACKAGE} +pkgdocdir=${mandir}/../doc/${PACKAGE} +bins = @top_srcdir@/bins +DOCEXAMPLES = $(bins)/zzdir.c $(bins)/zzcat.c \ + $(bins)/zzobfuscated.c $(bins)/zziptest.c \ + $(bins)/zzxordir.c $(bins)/zzxorcat.c \ + $(bins)/zzxorcopy.c $(SDL_RWOPS) + +install-docs: $(doc_FILES) $(man_FILES) site.html htmpages.tar + $(mkinstalldirs) $(DESTDIR)$(pkgdocdir) + $(INSTALL_DATA) $(html_FILES) $(DESTDIR)$(pkgdocdir) + for i in $(doc_FILES) $(DOCEXAMPLES) $(changelog) $(srcdir)/README.* \ + ; do $(INSTALL_DATA) `test -f $$i || echo $(srcdir)/`$$i \ + $(DESTDIR)$(pkgdocdir) ; done + cd $(DESTDIR)$(pkgdocdir) && ln -sf zzip-index.html index.html + $(mkinstalldirs) $(DESTDIR)$(pkgdocdir)/man + @ echo $(PAX_TAR_EXTRACT) htmpages.tar '>>>' $(DESTDIR)$(pkgdocdir)/man/ \ + ; test -f htmpages.tar || cd "$srcdir" \ + ; P=`pwd` ; test -s htmpages.tar || exit 1 \ + ; cd $(DESTDIR)$(pkgdocdir)/man && $(PAX_TAR_EXTRACT) $$P/htmpages.tar \ + ; true + +install-doc : install-docs $(PACKAGE)-doc.omf + $(mkinstalldirs) $(DESTDIR)$(pkgomfdir) + $(INSTALL_DATA) $(PACKAGE)-doc.omf $(DESTDIR)$(pkgomfdir)/ + - test ".$(DESTDIR)" != "." || scrollkeeper-update + +SOURCEFORGE_GROUP=zziplib +SOURCEFORGE_HOST=web.sourceforge.net +SOURCEFORGE_PATH=/home/groups/z/zz/zziplib/htdocs +www: upload-sourceforge +upload-sourceforge: + $(MAKE) install-docs DESTDIR=/tmp/zziplib-htdocs-$$USER/ + echo scp ... $(SOURCEFORGE_HOST):$(SOURCEFORGE_PATH)/ ; sleep 4 + scp -r /tmp/zziplib-htdocs-$$USER/$(pkgdocdir)/* \ + $$USER,$(SOURCEFORGE_GROUP)@$(SOURCEFORGE_HOST):$(SOURCEFORGE_PATH) + rm -r /tmp/zziplib-htdocs-$$USER/ + +# ------------------------------------------------------------ package manpages +mans : manpages +install-mans : install-man3 + +man3 man manpages : manpages.tar +html htm htmpages : htmpages.tar + +zziplib-manpages.tar : manpages.tar + test -s "$@" || test -s "$(srcdir)/$@" +manpages.tar : zziplib.xml zzipmmapped.xml zzipfseeko.xml + : "unix man format of the manpages - goes to ../share/man/man3" + @ if test "$(XMLTO)" != ":" \ + ; then echo going to regenerate "$@" in subdir "'"man"'" \ + ; echo 'test ! -d man3 || rm man3/* ; test -d man3 || mkdir man3' \ + ; test ! -d man3 || rm man3/* ; test -d man3 || mkdir man3 \ + ; echo '$(XMLTO) -o man3 man zziplib.xml' \ + ; $(XMLTO) -o man3 man zziplib.xml \ + ; echo '$(XMLTO) -o man3 man zzipmmapped.xml' \ + ; $(XMLTO) -o man3 man zzipmmapped.xml \ + ; echo '$(XMLTO) -o man3 man zzipfseeko.xml' \ + ; $(XMLTO) -o man3 man zzipfseeko.xml \ + ; if test -d man3/man3; then mv man3 man3_ \ + ; mv man3_/man3 man3; rm -r man3_; fi \ + ; echo 'chmod 664 man3/*.3' \ + ; chmod 664 man3/*.3 \ + ; echo '$(PAX_TAR_CREATE) "$@" man3/' \ + ; $(PAX_TAR_CREATE) "$@" man3/ \ + ; echo '$(DELETE); rm man3/*.3 ; rmdir man3' \ + ; $(DELETE); rm man3/*.3 ; rmdir man3 \ + ; fi ; true + @ if test -s $@ \ + ; then echo cp $@ zziplib-$@ "(saved)"; cp $@ zziplib-$@ \ + ; else echo cp $(srcdir)/zziplib-$@ $@; cp $(srcdir)/zziplib-$@ $@ \ + ; fi + +zziplib-htmpages.tar : htmpages.tar + test -s "$@" || test -s "$(srcdir)/$@" +htmpages.tar : zziplib.xml zzipmmapped.xml zzipfseeko.xml zziplib-manpages.dbk + : "html format of the manpages - put into zziplib/htdocs/man/*" + @ if test "$(XMLTO)" != ":" \ + ; then echo going to regenerate "$@" in subdir "'"html"'" \ + ; echo 'test ! -d html || rm /* ; test -d html || mkdir html' \ + ; test ! -d html || rm html/* ; test -d html || mkdir html \ + ; echo 'cp $(srcdir)/zziplib-manpages.dbk zziplib-manpages.xml' \ + ; cp $(srcdir)/zziplib-manpages.dbk zziplib-manpages.xml \ + ; echo '$(XMLTO) -o html html zziplib-manpages.xml | tee written.lst' \ + ; $(XMLTO) -o html html zziplib-manpages.xml | tee written.lst \ + ; echo '$(PAX_TAR_CREATE) $@ html/*.*' \ + ; $(PAX_TAR_CREATE) $@ html/*.* \ + ; echo '$(DELETE); rm html/*.* ; rmdir html' \ + ; $(DELETE); rm html/*.* ; rmdir html \ + ; fi ; true + @ if test -s $@ \ + ; then echo cp $@ zziplib-$@ "(saved)"; cp $@ zziplib-$@ \ + ; else echo cp $(srcdir)/zziplib-$@ $@; cp $(srcdir)/zziplib-$@ $@ \ + ; fi + +install-man3 : manpages.tar + $(mkinstalldirs) $(DESTDIR)$(mandir)/man3 + P=`pwd` ; test -s manpages.tar || exit 1 \ + ; cd $(DESTDIR)$(mandir) && $(PAX_TAR_EXTRACT) $$P/manpages.tar \ + ; true + +unpack : manpages.tar htmpages.tar + test -s manpages.tar && test -s htmpages.tar + (rm -rf _htm && mkdir _htm && cd _htm && $(PAX_TAR_EXTRACT) ../htmpages.tar) + (rm -rf _man && mkdir _man && cd _man && $(PAX_TAR_EXTRACT) ../manpages.tar) +clean-unpack : + rm -rf _htm + rm -rf _man + +# --------------------------------------------------------------- OMF handling +spec_file=$(top_srcdir)/$(PACKAGE).spec +DOCSERIES= 775fb73e-1874-11d7-93e9-e18cd7ea3c2e +FROMSPEC= $(spec_file) | head -1 | sed -e 's,<,\<,g' -e 's,>,\>,g' +DATESPEC= `date +%Y-%m-%d` + +$(PACKAGE)-doc.omf : $(spec_file) Makefile + : "OMF for the html documentation - a copy of zziplib.sf.net" + echo '<?xml version="1.0" encoding="ISO-8859-1" standalone="no"?>' >$@ + echo '<omf><resource><creator> Guido Draheim </creator>' >>$@ + grep Packager $(FROMSPEC) | sed -e 's,Packager *: *, <maintainer>,' \ + -e '/<maintainer>/s,$$,</maintainer>,' >>$@ + grep Summary $(FROMSPEC) | sed -e 's,Summary *: *, <title>,' \ + -e '/<title>/s,$$,</title>,' >>$@ + echo ' <date>'$(DATESPEC)'</date>' >>$@ + echo ' <version identifier="$(VERSION)" date="'$(DATESPEC)'"/>' >>$@ + grep Group $(FROMSPEC) | sed -e 's,Group *: *, <subject category=",' \ + -e 's,/,|,g' -e '/<subject/s,$$," />,' >>$@ + echo ' <format mime="text/html"/>' >>$@ + pkgdocdir=`echo "$(pkgdocdir)" | sed -e "s|/[a-z][a-z]*/[.][.]/|/|"` \ + echo ' <identifier url="file:'"$$pkgdocdir"'/zzip-index.html"/>' >>$@ + echo ' <language code="C"/>' >>$@ + echo ' <relation seriesid="$(DOCSERIES)"/>' >>$@ + echo ' <rights type="GNU LGPL" holder="Guido Draheim"' >>$@ + pkgdocdir=`echo "$(pkgdocdir)" | sed -e "s|/[a-z][a-z]*/[.][.]/|/|"` \ + echo ' license="'"$$pkgdocdir"')/COPYING.LIB"/>' >>$@ + echo '</resource></omf>' >>$@ + +DOCBOOKDTD= -//OASIS/DTD Docbook V4.1.2//EN +MANSERIES= a302c642-1888-11d7-86f6-ba4b52ef847d +$(PACKAGE)-man.omf : $(PACKAGE)-doc.omf $(PACKAGE).xml + : "OMF for functions reference - the docbook master of the manpages" + sed -e 's,"text/html","text/xml" dtd="$(DOCBOOKDTD)",' \ + -e 's,</title>, (Function Reference)</title>,' \ + -e 's,/index.html,/xml/manpages.xml,' \ + -e 's,$(DOCSERIES),$(MANSERIES),' $(PACKAGE)-doc.omf > $@ + test -s $@ || rm $@ + +omf : $(PACKAGE)-doc.omf $(PACKAGE)-man.omf +install-omf : omf zziplib.xml zzipmmapped.xml zzipfseeko.xml + : "not installed by default anymore - 'make install-doc' has one OMF" + $(mkinstalldirs) $(DESTDIR)$(pkgomfdir) + $(INSTALL_DATA) $(PACKAGE)-doc.omf $(DESTDIR)$(pkgomfdir)/ + $(mkinstalldirs) $(DESTDIR)$(pkgdocdir) + $(INSTALL_DATA) $(srcdir)/zziplib-manpages.xml \ + $(DESTDIR)$(pkgdocdir)/xml/manpages.xml + $(INSTALL_DATA) zziplib.xml zzipmmapped.xml zzipfseeko.xml \ + $(DESTDIR)$(pkgdocdir)/xml/ + $(INSTALL_DATA) $(PACKAGE)-man.omf $(DESTDIR)$(pkgomfdir)/ + - test ".$(DESTDIR)" != "." || scrollkeeper-update -v + +# ----------------------------------------------- mksite.sh for the main html +site.htm : body.htm + cp $(srcdir)/body.htm site.htm +mksite_sh_args = --VERSION=$(VERSION) --xml --src-dir=$(srcdir) --print +site.html : body.htm site.htm mksite.sh $(htm_FILES) $(htms_FILES) + cp $(srcdir)/body.htm site.htm + perl $(srcdir)/mksite.pl $(mksite_sh_args) site.htm || \ + $(SHELL) $(srcdir)/mksite.sh $(mksite_sh_args) site.htm + +changes.htm : $(top_srcdir)/ChangeLog Makefile + echo "<pre>" > $@ ; cat $(top_srcdir)/ChangeLog \ + | sed -e "s,\\&,\\&\\;,g" \ + -e "s,<,\\<\\;,g" -e "s,>,\\>\\;,g" \ + -e "/^[A-Z].*[12][09][09][09]/s,\\(.*\\),<b>&</b>," \ + -e "/^[0-9]/s,\\(.*\\),<b>&</b>," >> $@ ; echo "</pre>" >>$@ + +# ----------------------------------------------- create pdf via docbook xml +# sorry, the xmlto / docbook-xsl are too broken to rebuild the PDF anymore + +zzip.xml : $(htm_FILES) zziplib.xml make-dbk.pl + : '@PERL@ make-dbk.pl $(htm_FILES) zziplib.xml >$@' + @PYTHON@ $(srcdir)/zzipdoc/htm2dbk.py $(htm_FILES) zziplib.xml >$@ + test -s "$@" || rm "$@" + +zzip.html : zzip.xml + xmlto html-nochunks zzip.xml +zzip.pdf : zzip.xml + xmlto pdf zzip.xml + +zziplib.pdf : $(htm_FILES) $(srcdir)/zziplib-master.dbk mksite.pl + cp $(srcdir)/zziplib-master.dbk zziplib.docbook + xmlto pdf zziplib.docbook ; rm zziplib.docbook + test -s zziplib.pdf + +pdfs : zziplib.pdf |