Corrections to properly install GNOME2 docs

svn: r1404
This commit is contained in:
Alex Roitman
2003-03-27 16:52:40 +00:00
parent 2f851b93d9
commit 35ded7ba00
9 changed files with 3329 additions and 104 deletions

View File

@@ -1,11 +1,11 @@
# Process this file with automake to produce Makefile.in
SUBDIRS = gramps-manual extending-gramps
SUBDIRS = gramps-manual
man_IN_FILES = gramps.1.in
man_MANS = ${man_IN_FILES:.1.in=.1}
EXTRA_DIST = $(man_MANS) $(man_IN_FILES) sgmldocs.make
EXTRA_DIST = $(man_MANS) $(man_IN_FILES) xmldocs.make omf.make
gramps.1: $(top_builddir)/config.status gramps.1.in
cd $(top_builddir) && CONFIG_FILES=doc/$@ $(SHELL) ./config.status

View File

@@ -1,53 +1,7 @@
SGML_FILES = gramps-manual.sgml
figs = \
figures/addmedia.png \
figures/druidpg1.png \
figures/editbookmarks.png \
figures/ep-address.png \
figures/ep-altname.png \
figures/ep-attributes.png \
figures/ep-event.png \
figures/ep-gallery.png \
figures/ep-general.png \
figures/ep-internet.png \
figures/ep-lds.png \
figures/ep-notes.png \
figures/familyview.png \
figures/filter.png \
figures/globalmedia.png \
figures/gotobookmark.png \
figures/localmedia.png \
figures/mainwin.png \
figures/mediaview.png \
figures/opendb.png \
figures/pedegreesel.png \
figures/pedegreeview.png \
figures/peoplelist.png \
figures/placelist.png \
figures/prefs-bars.png \
figures/prefs-colors.png \
figures/prefs-dates.png \
figures/prefs-disp.png \
figures/prefs-find.png \
figures/prefs-gen.png \
figures/prefs-guess.png \
figures/prefs-ids.png \
figures/prefs-main.png \
figures/prefs-media.png \
figures/prefs-report.png \
figures/prefs-research.png \
figures/prefs-revision.png \
figures/reportsel.png \
figures/revcontrol.png \
figures/savecomment.png \
figures/sourcelist.png \
figures/sourcerefsel.png \
figures/toolsel.png
figdir = figures
docname = gramps-manual
lang = C
omffile = gramps-manual-C.omf
sgml_ents =
include $(top_srcdir)/doc/sgmldocs.make
entities = legal.xml
include $(top_srcdir)/doc/xmldocs.make
dist-hook: app-dist-hook

View File

@@ -1,14 +1,18 @@
<?xml version="1.0" standalone="no"?>
<?xml version="1.0" encoding="UTF-8"?>
<omf>
<resource>
<title>
GRAMPS User Manual
</title>
<subject>
<category>GNOME|Applications</category>
</subject>
<format mime="text/sgml"/>
<identifier url="gramps-manual.sgml"/>
<creator>Alex Roitman shura@alex.neuro.umn.edu</creator>
<title>GRAMPS Manual</title>
<date>2003-03-25</date>
<version identifier="2.0" date="2003-03-25" description="GNOME2 Compliant GRAMPS Manual"/>
<subject category="GNOME|Applications"/>
<description>User Manual for GRAMPS.</description>
<type>User Manual</type>
<format mime="text/xml" dtd="-//OASIS//DTD DocBook XML V4.1.2//EN"/>
<identifier url=""/>
<language code="C"/>
<relation seriesid="aa15a444-5ed9-11d7-8329-d7319c90009c"/>
<rights type="GNU FDL" license.version="1.1" license="http://www.gnu.org/licenses/fdl.html" holder="Alex Roitman"/>
</resource>
</omf>

File diff suppressed because it is too large Load Diff

53
doc/omf.make Normal file
View File

@@ -0,0 +1,53 @@
#
# No modifications of this Makefile should be necessary.
#
# This file contains the build instructions for installing OMF files. It is
# generally called from the makefiles for particular formats of documentation.
#
# Note that you must configure your package with --localstatedir=/var/lib
# so that the scrollkeeper-update command below will update the database
# in the standard scrollkeeper directory.
#
# If it is impossible to configure with --localstatedir=/var/lib, then
# modify the definition of scrollkeeper_localstate_dir so that
# it points to the correct location. Note that you must still use
# $(localstatedir) in this or when people build RPMs it will update
# the real database on their system instead of the one under RPM_BUILD_ROOT.
#
# Note: This make file is not incorporated into xmldocs.make because, in
# general, there will be other documents install besides XML documents
# and the makefiles for these formats should also include this file.
#
# About this file:
# This file was taken from scrollkeeper_example2, a package illustrating
# how to install documentation and OMF files for use with ScrollKeeper
# 0.3.x and 0.4.x. For more information, see:
# http://scrollkeeper.sourceforge.net/
# Version: 0.1.2 (last updated: March 20, 2002)
#
omf_dest_dir=$(datadir)/omf/@PACKAGE@
scrollkeeper_localstate_dir = $(localstatedir)/scrollkeeper
omf: omf_timestamp
omf_timestamp: $(omffile)
-for file in $(omffile); do \
scrollkeeper-preinstall $(docdir)/$(docname).xml $(srcdir)/$$file $(srcdir)/$$file.out; \
done
touch omf_timestamp
install-data-hook-omf:
$(mkinstalldirs) $(DESTDIR)$(omf_dest_dir)
for file in $(omffile); do \
$(INSTALL_DATA) $(srcdir)/$$file.out $(DESTDIR)$(omf_dest_dir)/$$file; \
done
-scrollkeeper-update -p $(scrollkeeper_localstate_dir) -o $(DESTDIR)$(omf_dest_dir)
uninstall-local-omf:
-for file in $(srcdir)/*.omf; do \
basefile=`basename $$file`; \
rm -f $(omf_dest_dir)/$$basefile; \
done
-rmdir $(omf_dest_dir)
-scrollkeeper-update -p $(scrollkeeper_localstate_dir)

95
doc/xmldocs.make Normal file
View File

@@ -0,0 +1,95 @@
#
# No modifications of this Makefile should be necessary.
#
# To use this template:
# 1) Define: figdir, docname, lang, omffile, and entities in
# your Makefile.am file for each document directory,
# although figdir, omffile, and entities may be empty
# 2) Make sure the Makefile in (1) also includes
# "include $(top_srcdir)/doc/xmldocs.make" and
# "dist-hook: app-dist-hook".
# 3) Optionally define 'entities' to hold xml entities which
# you would also like installed
# 4) Figures must go under $(figdir)/ and be in PNG format
# 5) You should only have one document per directory
# 6) Note that the figure directory, $(figdir)/, should not have its
# own Makefile since this Makefile installs those figures.
#
# example Makefile.am:
# figdir = figures
# docname = scrollkeeper-manual
# lang = C
# omffile=scrollkeeper-manual-C.omf
# entities = fdl.xml
# include $(top_srcdir)/help/xmldocs.make
# dist-hook: app-dist-hook
#
# About this file:
# This file was taken from scrollkeeper_example2, a package illustrating
# how to install documentation and OMF files for use with ScrollKeeper
# 0.3.x and 0.4.x. For more information, see:
# http://scrollkeeper.sourceforge.net/
# Version: 0.1.2 (last updated: March 20, 2002)
#
# ************* Begin of section some packagers may need to modify **************
# This variable (docdir) specifies where the documents should be installed.
# This default value should work for most packages.
docdir = $(datadir)/@PACKAGE@/doc/$(docname)/$(lang)
# ************** You should not have to edit below this line *******************
xml_files = $(entities) $(docname).xml
omf_dir=$(top_srcdir)/omf-install
EXTRA_DIST = $(xml_files) $(omffile)
CLEANFILES = omf_timestamp
include $(top_srcdir)/doc/omf.make
all: omf
$(docname).xml: $(entities)
-ourdir=`pwd`; \
cd $(srcdir); \
cp $(entities) $$ourdir
app-dist-hook:
if test "$(figdir)"; then \
$(mkinstalldirs) $(distdir)/$(figdir); \
for file in $(srcdir)/$(figdir)/*.png; do \
basefile=`echo $$file | sed -e 's,^.*/,,'`; \
$(INSTALL_DATA) $$file $(distdir)/$(figdir)/$$basefile; \
done \
fi
install-data-local: omf
$(mkinstalldirs) $(DESTDIR)$(docdir)
for file in $(xml_files); do \
cp $(srcdir)/$$file $(DESTDIR)$(docdir); \
done
if test "$(figdir)"; then \
$(mkinstalldirs) $(DESTDIR)$(docdir)/$(figdir); \
for file in $(srcdir)/$(figdir)/*.png; do \
basefile=`echo $$file | sed -e 's,^.*/,,'`; \
$(INSTALL_DATA) $$file $(DESTDIR)$(docdir)/$(figdir)/$$basefile; \
done \
fi
install-data-hook: install-data-hook-omf
uninstall-local: uninstall-local-doc uninstall-local-omf
uninstall-local-doc:
-if test "$(figdir)"; then \
for file in $(srcdir)/$(figdir)/*.png; do \
basefile=`echo $$file | sed -e 's,^.*/,,'`; \
rm -f $(docdir)/$(figdir)/$$basefile; \
done; \
rmdir $(DESTDIR)$(docdir)/$(figdir); \
fi
-for file in $(xml_files); do \
rm -f $(DESTDIR)$(docdir)/$$file; \
done
-rmdir $(DESTDIR)$(docdir)