Setting up basics of build system. Still needs some tweaking.

2001-03-12  Dan Mueth  <dan@eazel.com>

        Setting up basics of build system.  Still needs some tweaking.

        * AUTHORS:
        * COPYING:
        * COPYING-DOCS:
        * Makefile.am:
        * autogen.sh:
        * configure.in:
        * gnome-user-docs.spec.in:
        * sgmldocs.make:
        * omf-install/Makefile.am:
        * introduction-to-gnome/Makefile.am:
        * introduction-to-gnome/C/Makefile.am:

        Removing these for now, until we can fix up the build to
        properly do PS docs.

        * introduction-to-gnome/C/figures/Makefile:
        * introduction-to-gnome/C/figures/gnome-logo-large.png:
        * introduction-to-gnome/C/figures/img2eps:

        Renaming gnome-intro... to introduction-to-gnome...
        Sasha wrote these docs.

        * introduction-to-gnome/C/gnome-intro-C.omf:
        * introduction-to-gnome/C/gnome-intro.sgml:
        * introduction-to-gnome/C/introduction-to-gnome-C.omf:
        * introduction-to-gnome/C/introduction-to-gnome.sgml:

18 files changed, 1022 insertions, 180 deletions

diff --git a/AUTHORS b/AUTHORS
new file mode 100644
index 0000000..28ca701
--- /dev/null
+++ b/AUTHORS
@@ -0,0 +1,2 @@
+Dan Mueth       <dan@eazel.com>
+Laszlo Kovacs   <laszlo.kovacs@sun.com>
diff --git a/COPYING b/COPYING
new file mode 100644
index 0000000..79aa372
--- /dev/null
+++ b/COPYING
@@ -0,0 +1,358 @@
+		GNU Free Documentation License
+		   Version 1.1, March 2000
+
+ Copyright (C) 2000  Free Software Foundation, Inc.
+     59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
+ Everyone is permitted to copy and distribute verbatim copies
+ of this license document, but changing it is not allowed.
+
+
+0. PREAMBLE
+
+The purpose of this License is to make a manual, textbook, or other
+written document "free" in the sense of freedom: to assure everyone
+the effective freedom to copy and redistribute it, with or without
+modifying it, either commercially or noncommercially.  Secondarily,
+this License preserves for the author and publisher a way to get
+credit for their work, while not being considered responsible for
+modifications made by others.
+
+This License is a kind of "copyleft", which means that derivative
+works of the document must themselves be free in the same sense.  It
+complements the GNU General Public License, which is a copyleft
+license designed for free software.
+
+We have designed this License in order to use it for manuals for free
+software, because free software needs free documentation: a free
+program should come with manuals providing the same freedoms that the
+software does.  But this License is not limited to software manuals;
+it can be used for any textual work, regardless of subject matter or
+whether it is published as a printed book.  We recommend this License
+principally for works whose purpose is instruction or reference.
+
+
+1. APPLICABILITY AND DEFINITIONS
+
+This License applies to any manual or other work that contains a
+notice placed by the copyright holder saying it can be distributed
+under the terms of this License.  The "Document", below, refers to any
+such manual or work.  Any member of the public is a licensee, and is
+addressed as "you".
+
+A "Modified Version" of the Document means any work containing the
+Document or a portion of it, either copied verbatim, or with
+modifications and/or translated into another language.
+
+A "Secondary Section" is a named appendix or a front-matter section of
+the Document that deals exclusively with the relationship of the
+publishers or authors of the Document to the Document's overall subject
+(or to related matters) and contains nothing that could fall directly
+within that overall subject.  (For example, if the Document is in part a
+textbook of mathematics, a Secondary Section may not explain any
+mathematics.)  The relationship could be a matter of historical
+connection with the subject or with related matters, or of legal,
+commercial, philosophical, ethical or political position regarding
+them.
+
+The "Invariant Sections" are certain Secondary Sections whose titles
+are designated, as being those of Invariant Sections, in the notice
+that says that the Document is released under this License.
+
+The "Cover Texts" are certain short passages of text that are listed,
+as Front-Cover Texts or Back-Cover Texts, in the notice that says that
+the Document is released under this License.
+
+A "Transparent" copy of the Document means a machine-readable copy,
+represented in a format whose specification is available to the
+general public, whose contents can be viewed and edited directly and
+straightforwardly with generic text editors or (for images composed of
+pixels) generic paint programs or (for drawings) some widely available
+drawing editor, and that is suitable for input to text formatters or
+for automatic translation to a variety of formats suitable for input
+to text formatters.  A copy made in an otherwise Transparent file
+format whose markup has been designed to thwart or discourage
+subsequent modification by readers is not Transparent.  A copy that is
+not "Transparent" is called "Opaque".
+
+Examples of suitable formats for Transparent copies include plain
+ASCII without markup, Texinfo input format, LaTeX input format, SGML
+or XML using a publicly available DTD, and standard-conforming simple
+HTML designed for human modification.  Opaque formats include
+PostScript, PDF, proprietary formats that can be read and edited only
+by proprietary word processors, SGML or XML for which the DTD and/or
+processing tools are not generally available, and the
+machine-generated HTML produced by some word processors for output
+purposes only.
+
+The "Title Page" means, for a printed book, the title page itself,
+plus such following pages as are needed to hold, legibly, the material
+this License requires to appear in the title page.  For works in
+formats which do not have any title page as such, "Title Page" means
+the text near the most prominent appearance of the work's title,
+preceding the beginning of the body of the text.
+
+
+2. VERBATIM COPYING
+
+You may copy and distribute the Document in any medium, either
+commercially or noncommercially, provided that this License, the
+copyright notices, and the license notice saying this License applies
+to the Document are reproduced in all copies, and that you add no other
+conditions whatsoever to those of this License.  You may not use
+technical measures to obstruct or control the reading or further
+copying of the copies you make or distribute.  However, you may accept
+compensation in exchange for copies.  If you distribute a large enough
+number of copies you must also follow the conditions in section 3.
+
+You may also lend copies, under the same conditions stated above, and
+you may publicly display copies.
+
+
+3. COPYING IN QUANTITY
+
+If you publish printed copies of the Document numbering more than 100,
+and the Document's license notice requires Cover Texts, you must enclose
+the copies in covers that carry, clearly and legibly, all these Cover
+Texts: Front-Cover Texts on the front cover, and Back-Cover Texts on
+the back cover.  Both covers must also clearly and legibly identify
+you as the publisher of these copies.  The front cover must present
+the full title with all words of the title equally prominent and
+visible.  You may add other material on the covers in addition.
+Copying with changes limited to the covers, as long as they preserve
+the title of the Document and satisfy these conditions, can be treated
+as verbatim copying in other respects.
+
+If the required texts for either cover are too voluminous to fit
+legibly, you should put the first ones listed (as many as fit
+reasonably) on the actual cover, and continue the rest onto adjacent
+pages.
+
+If you publish or distribute Opaque copies of the Document numbering
+more than 100, you must either include a machine-readable Transparent
+copy along with each Opaque copy, or state in or with each Opaque copy
+a publicly-accessible computer-network location containing a complete
+Transparent copy of the Document, free of added material, which the
+general network-using public has access to download anonymously at no
+charge using public-standard network protocols.  If you use the latter
+option, you must take reasonably prudent steps, when you begin
+distribution of Opaque copies in quantity, to ensure that this
+Transparent copy will remain thus accessible at the stated location
+until at least one year after the last time you distribute an Opaque
+copy (directly or through your agents or retailers) of that edition to
+the public.
+
+It is requested, but not required, that you contact the authors of the
+Document well before redistributing any large number of copies, to give
+them a chance to provide you with an updated version of the Document.
+
+
+4. MODIFICATIONS
+
+You may copy and distribute a Modified Version of the Document under
+the conditions of sections 2 and 3 above, provided that you release
+the Modified Version under precisely this License, with the Modified
+Version filling the role of the Document, thus licensing distribution
+and modification of the Modified Version to whoever possesses a copy
+of it.  In addition, you must do these things in the Modified Version:
+
+A. Use in the Title Page (and on the covers, if any) a title distinct
+   from that of the Document, and from those of previous versions
+   (which should, if there were any, be listed in the History section
+   of the Document).  You may use the same title as a previous version
+   if the original publisher of that version gives permission.
+B. List on the Title Page, as authors, one or more persons or entities
+   responsible for authorship of the modifications in the Modified
+   Version, together with at least five of the principal authors of the
+   Document (all of its principal authors, if it has less than five).
+C. State on the Title page the name of the publisher of the
+   Modified Version, as the publisher.
+D. Preserve all the copyright notices of the Document.
+E. Add an appropriate copyright notice for your modifications
+   adjacent to the other copyright notices.
+F. Include, immediately after the copyright notices, a license notice
+   giving the public permission to use the Modified Version under the
+   terms of this License, in the form shown in the Addendum below.
+G. Preserve in that license notice the full lists of Invariant Sections
+   and required Cover Texts given in the Document's license notice.
+H. Include an unaltered copy of this License.
+I. Preserve the section entitled "History", and its title, and add to
+   it an item stating at least the title, year, new authors, and
+   publisher of the Modified Version as given on the Title Page.  If
+   there is no section entitled "History" in the Document, create one
+   stating the title, year, authors, and publisher of the Document as
+   given on its Title Page, then add an item describing the Modified
+   Version as stated in the previous sentence.
+J. Preserve the network location, if any, given in the Document for
+   public access to a Transparent copy of the Document, and likewise
+   the network locations given in the Document for previous versions
+   it was based on.  These may be placed in the "History" section.
+   You may omit a network location for a work that was published at
+   least four years before the Document itself, or if the original
+   publisher of the version it refers to gives permission.
+K. In any section entitled "Acknowledgements" or "Dedications",
+   preserve the section's title, and preserve in the section all the
+   substance and tone of each of the contributor acknowledgements
+   and/or dedications given therein.
+L. Preserve all the Invariant Sections of the Document,
+   unaltered in their text and in their titles.  Section numbers
+   or the equivalent are not considered part of the section titles.
+M. Delete any section entitled "Endorsements".  Such a section
+   may not be included in the Modified Version.
+N. Do not retitle any existing section as "Endorsements"
+   or to conflict in title with any Invariant Section.
+
+If the Modified Version includes new front-matter sections or
+appendices that qualify as Secondary Sections and contain no material
+copied from the Document, you may at your option designate some or all
+of these sections as invariant.  To do this, add their titles to the
+list of Invariant Sections in the Modified Version's license notice.
+These titles must be distinct from any other section titles.
+
+You may add a section entitled "Endorsements", provided it contains
+nothing but endorsements of your Modified Version by various
+parties--for example, statements of peer review or that the text has
+been approved by an organization as the authoritative definition of a
+standard.
+
+You may add a passage of up to five words as a Front-Cover Text, and a
+passage of up to 25 words as a Back-Cover Text, to the end of the list
+of Cover Texts in the Modified Version.  Only one passage of
+Front-Cover Text and one of Back-Cover Text may be added by (or
+through arrangements made by) any one entity.  If the Document already
+includes a cover text for the same cover, previously added by you or
+by arrangement made by the same entity you are acting on behalf of,
+you may not add another; but you may replace the old one, on explicit
+permission from the previous publisher that added the old one.
+
+The author(s) and publisher(s) of the Document do not by this License
+give permission to use their names for publicity for or to assert or
+imply endorsement of any Modified Version.
+
+
+5. COMBINING DOCUMENTS
+
+You may combine the Document with other documents released under this
+License, under the terms defined in section 4 above for modified
+versions, provided that you include in the combination all of the
+Invariant Sections of all of the original documents, unmodified, and
+list them all as Invariant Sections of your combined work in its
+license notice.
+
+The combined work need only contain one copy of this License, and
+multiple identical Invariant Sections may be replaced with a single
+copy.  If there are multiple Invariant Sections with the same name but
+different contents, make the title of each such section unique by
+adding at the end of it, in parentheses, the name of the original
+author or publisher of that section if known, or else a unique number.
+Make the same adjustment to the section titles in the list of
+Invariant Sections in the license notice of the combined work.
+
+In the combination, you must combine any sections entitled "History"
+in the various original documents, forming one section entitled
+"History"; likewise combine any sections entitled "Acknowledgements",
+and any sections entitled "Dedications".  You must delete all sections
+entitled "Endorsements."
+
+
+6. COLLECTIONS OF DOCUMENTS
+
+You may make a collection consisting of the Document and other documents
+released under this License, and replace the individual copies of this
+License in the various documents with a single copy that is included in
+the collection, provided that you follow the rules of this License for
+verbatim copying of each of the documents in all other respects.
+
+You may extract a single document from such a collection, and distribute
+it individually under this License, provided you insert a copy of this
+License into the extracted document, and follow this License in all
+other respects regarding verbatim copying of that document.
+
+
+
+7. AGGREGATION WITH INDEPENDENT WORKS
+
+A compilation of the Document or its derivatives with other separate
+and independent documents or works, in or on a volume of a storage or
+distribution medium, does not as a whole count as a Modified Version
+of the Document, provided no compilation copyright is claimed for the
+compilation.  Such a compilation is called an "aggregate", and this
+License does not apply to the other self-contained works thus compiled
+with the Document, on account of their being thus compiled, if they
+are not themselves derivative works of the Document.
+
+If the Cover Text requirement of section 3 is applicable to these
+copies of the Document, then if the Document is less than one quarter
+of the entire aggregate, the Document's Cover Texts may be placed on
+covers that surround only the Document within the aggregate.
+Otherwise they must appear on covers around the whole aggregate.
+
+
+8. TRANSLATION
+
+Translation is considered a kind of modification, so you may
+distribute translations of the Document under the terms of section 4.
+Replacing Invariant Sections with translations requires special
+permission from their copyright holders, but you may include
+translations of some or all Invariant Sections in addition to the
+original versions of these Invariant Sections.  You may include a
+translation of this License provided that you also include the
+original English version of this License.  In case of a disagreement
+between the translation and the original English version of this
+License, the original English version will prevail.
+
+
+9. TERMINATION
+
+You may not copy, modify, sublicense, or distribute the Document except
+as expressly provided for under this License.  Any other attempt to
+copy, modify, sublicense or distribute the Document is void, and will
+automatically terminate your rights under this License.  However,
+parties who have received copies, or rights, from you under this
+License will not have their licenses terminated so long as such
+parties remain in full compliance.
+
+
+10. FUTURE REVISIONS OF THIS LICENSE
+
+The Free Software Foundation may publish new, revised versions
+of the GNU Free Documentation License from time to time.  Such new
+versions will be similar in spirit to the present version, but may
+differ in detail to address new problems or concerns. See
+http:///www.gnu.org/copyleft/.
+
+Each version of the License is given a distinguishing version number.
+If the Document specifies that a particular numbered version of this
+License "or any later version" applies to it, you have the option of
+following the terms and conditions either of that specified version or
+of any later version that has been published (not as a draft) by the
+Free Software Foundation.  If the Document does not specify a version
+number of this License, you may choose any version ever published (not
+as a draft) by the Free Software Foundation.
+
+
+ADDENDUM: How to use this License for your documents
+
+To use this License in a document you have written, include a copy of
+the License in the document and put the following copyright and
+license notices just after the title page:
+
+      Copyright (c)  YEAR  YOUR NAME.
+      Permission is granted to copy, distribute and/or modify this document
+      under the terms of the GNU Free Documentation License, Version 1.1
+      or any later version published by the Free Software Foundation;
+      with the Invariant Sections being LIST THEIR TITLES, with the
+      Front-Cover Texts being LIST, and with the Back-Cover Texts being LIST.
+      A copy of the license is included in the section entitled "GNU
+      Free Documentation License".
+
+If you have no Invariant Sections, write "with no Invariant Sections"
+instead of saying which ones are invariant.  If you have no
+Front-Cover Texts, write "no Front-Cover Texts" instead of
+"Front-Cover Texts being LIST"; likewise for Back-Cover Texts.
+
+If your document contains nontrivial examples of program code, we
+recommend releasing these examples in parallel under your choice of
+free software license, such as the GNU General Public License,
+to permit their use in free software.
+
+
diff --git a/COPYING-DOCS b/COPYING-DOCS
new file mode 100644
index 0000000..b42936b
--- /dev/null
+++ b/COPYING-DOCS
@@ -0,0 +1,355 @@
+		GNU Free Documentation License
+		   Version 1.1, March 2000
+
+ Copyright (C) 2000  Free Software Foundation, Inc.
+     59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
+ Everyone is permitted to copy and distribute verbatim copies
+ of this license document, but changing it is not allowed.
+
+
+0. PREAMBLE
+
+The purpose of this License is to make a manual, textbook, or other
+written document "free" in the sense of freedom: to assure everyone
+the effective freedom to copy and redistribute it, with or without
+modifying it, either commercially or noncommercially.  Secondarily,
+this License preserves for the author and publisher a way to get
+credit for their work, while not being considered responsible for
+modifications made by others.
+
+This License is a kind of "copyleft", which means that derivative
+works of the document must themselves be free in the same sense.  It
+complements the GNU General Public License, which is a copyleft
+license designed for free software.
+
+We have designed this License in order to use it for manuals for free
+software, because free software needs free documentation: a free
+program should come with manuals providing the same freedoms that the
+software does.  But this License is not limited to software manuals;
+it can be used for any textual work, regardless of subject matter or
+whether it is published as a printed book.  We recommend this License
+principally for works whose purpose is instruction or reference.
+
+
+1. APPLICABILITY AND DEFINITIONS
+
+This License applies to any manual or other work that contains a
+notice placed by the copyright holder saying it can be distributed
+under the terms of this License.  The "Document", below, refers to any
+such manual or work.  Any member of the public is a licensee, and is
+addressed as "you".
+
+A "Modified Version" of the Document means any work containing the
+Document or a portion of it, either copied verbatim, or with
+modifications and/or translated into another language.
+
+A "Secondary Section" is a named appendix or a front-matter section of
+the Document that deals exclusively with the relationship of the
+publishers or authors of the Document to the Document's overall subject
+(or to related matters) and contains nothing that could fall directly
+within that overall subject.  (For example, if the Document is in part a
+textbook of mathematics, a Secondary Section may not explain any
+mathematics.)  The relationship could be a matter of historical
+connection with the subject or with related matters, or of legal,
+commercial, philosophical, ethical or political position regarding
+them.
+
+The "Invariant Sections" are certain Secondary Sections whose titles
+are designated, as being those of Invariant Sections, in the notice
+that says that the Document is released under this License.
+
+The "Cover Texts" are certain short passages of text that are listed,
+as Front-Cover Texts or Back-Cover Texts, in the notice that says that
+the Document is released under this License.
+
+A "Transparent" copy of the Document means a machine-readable copy,
+represented in a format whose specification is available to the
+general public, whose contents can be viewed and edited directly and
+straightforwardly with generic text editors or (for images composed of
+pixels) generic paint programs or (for drawings) some widely available
+drawing editor, and that is suitable for input to text formatters or
+for automatic translation to a variety of formats suitable for input
+to text formatters.  A copy made in an otherwise Transparent file
+format whose markup has been designed to thwart or discourage
+subsequent modification by readers is not Transparent.  A copy that is
+not "Transparent" is called "Opaque".
+
+Examples of suitable formats for Transparent copies include plain
+ASCII without markup, Texinfo input format, LaTeX input format, SGML
+or XML using a publicly available DTD, and standard-conforming simple
+HTML designed for human modification.  Opaque formats include
+PostScript, PDF, proprietary formats that can be read and edited only
+by proprietary word processors, SGML or XML for which the DTD and/or
+processing tools are not generally available, and the
+machine-generated HTML produced by some word processors for output
+purposes only.
+
+The "Title Page" means, for a printed book, the title page itself,
+plus such following pages as are needed to hold, legibly, the material
+this License requires to appear in the title page.  For works in
+formats which do not have any title page as such, "Title Page" means
+the text near the most prominent appearance of the work's title,
+preceding the beginning of the body of the text.
+
+
+2. VERBATIM COPYING
+
+You may copy and distribute the Document in any medium, either
+commercially or noncommercially, provided that this License, the
+copyright notices, and the license notice saying this License applies
+to the Document are reproduced in all copies, and that you add no other
+conditions whatsoever to those of this License.  You may not use
+technical measures to obstruct or control the reading or further
+copying of the copies you make or distribute.  However, you may accept
+compensation in exchange for copies.  If you distribute a large enough
+number of copies you must also follow the conditions in section 3.
+
+You may also lend copies, under the same conditions stated above, and
+you may publicly display copies.
+
+
+3. COPYING IN QUANTITY
+
+If you publish printed copies of the Document numbering more than 100,
+and the Document's license notice requires Cover Texts, you must enclose
+the copies in covers that carry, clearly and legibly, all these Cover
+Texts: Front-Cover Texts on the front cover, and Back-Cover Texts on
+the back cover.  Both covers must also clearly and legibly identify
+you as the publisher of these copies.  The front cover must present
+the full title with all words of the title equally prominent and
+visible.  You may add other material on the covers in addition.
+Copying with changes limited to the covers, as long as they preserve
+the title of the Document and satisfy these conditions, can be treated
+as verbatim copying in other respects.
+
+If the required texts for either cover are too voluminous to fit
+legibly, you should put the first ones listed (as many as fit
+reasonably) on the actual cover, and continue the rest onto adjacent
+pages.
+
+If you publish or distribute Opaque copies of the Document numbering
+more than 100, you must either include a machine-readable Transparent
+copy along with each Opaque copy, or state in or with each Opaque copy
+a publicly-accessible computer-network location containing a complete
+Transparent copy of the Document, free of added material, which the
+general network-using public has access to download anonymously at no
+charge using public-standard network protocols.  If you use the latter
+option, you must take reasonably prudent steps, when you begin
+distribution of Opaque copies in quantity, to ensure that this
+Transparent copy will remain thus accessible at the stated location
+until at least one year after the last time you distribute an Opaque
+copy (directly or through your agents or retailers) of that edition to
+the public.
+
+It is requested, but not required, that you contact the authors of the
+Document well before redistributing any large number of copies, to give
+them a chance to provide you with an updated version of the Document.
+
+
+4. MODIFICATIONS
+
+You may copy and distribute a Modified Version of the Document under
+the conditions of sections 2 and 3 above, provided that you release
+the Modified Version under precisely this License, with the Modified
+Version filling the role of the Document, thus licensing distribution
+and modification of the Modified Version to whoever possesses a copy
+of it.  In addition, you must do these things in the Modified Version:
+
+A. Use in the Title Page (and on the covers, if any) a title distinct
+   from that of the Document, and from those of previous versions
+   (which should, if there were any, be listed in the History section
+   of the Document).  You may use the same title as a previous version
+   if the original publisher of that version gives permission.
+B. List on the Title Page, as authors, one or more persons or entities
+   responsible for authorship of the modifications in the Modified
+   Version, together with at least five of the principal authors of the
+   Document (all of its principal authors, if it has less than five).
+C. State on the Title page the name of the publisher of the
+   Modified Version, as the publisher.
+D. Preserve all the copyright notices of the Document.
+E. Add an appropriate copyright notice for your modifications
+   adjacent to the other copyright notices.
+F. Include, immediately after the copyright notices, a license notice
+   giving the public permission to use the Modified Version under the
+   terms of this License, in the form shown in the Addendum below.
+G. Preserve in that license notice the full lists of Invariant Sections
+   and required Cover Texts given in the Document's license notice.
+H. Include an unaltered copy of this License.
+I. Preserve the section entitled "History", and its title, and add to
+   it an item stating at least the title, year, new authors, and
+   publisher of the Modified Version as given on the Title Page.  If
+   there is no section entitled "History" in the Document, create one
+   stating the title, year, authors, and publisher of the Document as
+   given on its Title Page, then add an item describing the Modified
+   Version as stated in the previous sentence.
+J. Preserve the network location, if any, given in the Document for
+   public access to a Transparent copy of the Document, and likewise
+   the network locations given in the Document for previous versions
+   it was based on.  These may be placed in the "History" section.
+   You may omit a network location for a work that was published at
+   least four years before the Document itself, or if the original
+   publisher of the version it refers to gives permission.
+K. In any section entitled "Acknowledgements" or "Dedications",
+   preserve the section's title, and preserve in the section all the
+   substance and tone of each of the contributor acknowledgements
+   and/or dedications given therein.
+L. Preserve all the Invariant Sections of the Document,
+   unaltered in their text and in their titles.  Section numbers
+   or the equivalent are not considered part of the section titles.
+M. Delete any section entitled "Endorsements".  Such a section
+   may not be included in the Modified Version.
+N. Do not retitle any existing section as "Endorsements"
+   or to conflict in title with any Invariant Section.
+
+If the Modified Version includes new front-matter sections or
+appendices that qualify as Secondary Sections and contain no material
+copied from the Document, you may at your option designate some or all
+of these sections as invariant.  To do this, add their titles to the
+list of Invariant Sections in the Modified Version's license notice.
+These titles must be distinct from any other section titles.
+
+You may add a section entitled "Endorsements", provided it contains
+nothing but endorsements of your Modified Version by various
+parties--for example, statements of peer review or that the text has
+been approved by an organization as the authoritative definition of a
+standard.
+
+You may add a passage of up to five words as a Front-Cover Text, and a
+passage of up to 25 words as a Back-Cover Text, to the end of the list
+of Cover Texts in the Modified Version.  Only one passage of
+Front-Cover Text and one of Back-Cover Text may be added by (or
+through arrangements made by) any one entity.  If the Document already
+includes a cover text for the same cover, previously added by you or
+by arrangement made by the same entity you are acting on behalf of,
+you may not add another; but you may replace the old one, on explicit
+permission from the previous publisher that added the old one.
+
+The author(s) and publisher(s) of the Document do not by this License
+give permission to use their names for publicity for or to assert or
+imply endorsement of any Modified Version.
+
+
+5. COMBINING DOCUMENTS
+
+You may combine the Document with other documents released under this
+License, under the terms defined in section 4 above for modified
+versions, provided that you include in the combination all of the
+Invariant Sections of all of the original documents, unmodified, and
+list them all as Invariant Sections of your combined work in its
+license notice.
+
+The combined work need only contain one copy of this License, and
+multiple identical Invariant Sections may be replaced with a single
+copy.  If there are multiple Invariant Sections with the same name but
+different contents, make the title of each such section unique by
+adding at the end of it, in parentheses, the name of the original
+author or publisher of that section if known, or else a unique number.
+Make the same adjustment to the section titles in the list of
+Invariant Sections in the license notice of the combined work.
+
+In the combination, you must combine any sections entitled "History"
+in the various original documents, forming one section entitled
+"History"; likewise combine any sections entitled "Acknowledgements",
+and any sections entitled "Dedications".  You must delete all sections
+entitled "Endorsements."
+
+
+6. COLLECTIONS OF DOCUMENTS
+
+You may make a collection consisting of the Document and other documents
+released under this License, and replace the individual copies of this
+License in the various documents with a single copy that is included in
+the collection, provided that you follow the rules of this License for
+verbatim copying of each of the documents in all other respects.
+
+You may extract a single document from such a collection, and distribute
+it individually under this License, provided you insert a copy of this
+License into the extracted document, and follow this License in all
+other respects regarding verbatim copying of that document.
+
+
+7. AGGREGATION WITH INDEPENDENT WORKS
+
+A compilation of the Document or its derivatives with other separate
+and independent documents or works, in or on a volume of a storage or
+distribution medium, does not as a whole count as a Modified Version
+of the Document, provided no compilation copyright is claimed for the
+compilation.  Such a compilation is called an "aggregate", and this
+License does not apply to the other self-contained works thus compiled
+with the Document, on account of their being thus compiled, if they
+are not themselves derivative works of the Document.
+
+If the Cover Text requirement of section 3 is applicable to these
+copies of the Document, then if the Document is less than one quarter
+of the entire aggregate, the Document's Cover Texts may be placed on
+covers that surround only the Document within the aggregate.
+Otherwise they must appear on covers around the whole aggregate.
+
+
+8. TRANSLATION
+
+Translation is considered a kind of modification, so you may
+distribute translations of the Document under the terms of section 4.
+Replacing Invariant Sections with translations requires special
+permission from their copyright holders, but you may include
+translations of some or all Invariant Sections in addition to the
+original versions of these Invariant Sections.  You may include a
+translation of this License provided that you also include the
+original English version of this License.  In case of a disagreement
+between the translation and the original English version of this
+License, the original English version will prevail.
+
+
+9. TERMINATION
+
+You may not copy, modify, sublicense, or distribute the Document except
+as expressly provided for under this License.  Any other attempt to
+copy, modify, sublicense or distribute the Document is void, and will
+automatically terminate your rights under this License.  However,
+parties who have received copies, or rights, from you under this
+License will not have their licenses terminated so long as such
+parties remain in full compliance.
+
+
+10. FUTURE REVISIONS OF THIS LICENSE
+
+The Free Software Foundation may publish new, revised versions
+of the GNU Free Documentation License from time to time.  Such new
+versions will be similar in spirit to the present version, but may
+differ in detail to address new problems or concerns.  See
+http://www.gnu.org/copyleft/.
+
+Each version of the License is given a distinguishing version number.
+If the Document specifies that a particular numbered version of this
+License "or any later version" applies to it, you have the option of
+following the terms and conditions either of that specified version or
+of any later version that has been published (not as a draft) by the
+Free Software Foundation.  If the Document does not specify a version
+number of this License, you may choose any version ever published (not
+as a draft) by the Free Software Foundation.
+
+
+ADDENDUM: How to use this License for your documents
+
+To use this License in a document you have written, include a copy of
+the License in the document and put the following copyright and
+license notices just after the title page:
+
+      Copyright (c)  YEAR  YOUR NAME.
+      Permission is granted to copy, distribute and/or modify this document
+      under the terms of the GNU Free Documentation License, Version 1.1
+      or any later version published by the Free Software Foundation;
+      with the Invariant Sections being LIST THEIR TITLES, with the
+      Front-Cover Texts being LIST, and with the Back-Cover Texts being LIST.
+      A copy of the license is included in the section entitled "GNU
+      Free Documentation License".
+
+If you have no Invariant Sections, write "with no Invariant Sections"
+instead of saying which ones are invariant.  If you have no
+Front-Cover Texts, write "no Front-Cover Texts" instead of
+"Front-Cover Texts being LIST"; likewise for Back-Cover Texts.
+
+If your document contains nontrivial examples of program code, we
+recommend releasing these examples in parallel under your choice of
+free software license, such as the GNU General Public License,
+to permit their use in free software.
diff --git a/ChangeLog b/ChangeLog
index 59ce19e..f1aebaf 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,34 @@
+2001-03-12  Dan Mueth  <dan@eazel.com>
+
+	Setting up basics of build system.  Still needs some tweaking.
+
+	* AUTHORS:
+	* COPYING:
+	* COPYING-DOCS:
+	* Makefile.am:
+	* autogen.sh:
+	* configure.in:
+	* gnome-user-docs.spec.in:
+	* sgmldocs.make:
+	* omf-install/Makefile.am:
+	* introduction-to-gnome/Makefile.am:
+	* introduction-to-gnome/C/Makefile.am:
+
+	Removing these for now, until we can fix up the build to
+	properly do PS docs.
+
+	* introduction-to-gnome/C/figures/Makefile:
+	* introduction-to-gnome/C/figures/gnome-logo-large.png:
+	* introduction-to-gnome/C/figures/img2eps:
+	
+	Renaming gnome-intro... to introduction-to-gnome...
+	Sasha wrote these docs.
+	
+	* introduction-to-gnome/C/gnome-intro-C.omf:
+	* introduction-to-gnome/C/gnome-intro.sgml:
+	* introduction-to-gnome/C/introduction-to-gnome-C.omf:
+	* introduction-to-gnome/C/introduction-to-gnome.sgml:
+
 2001-02-25 Dan Mueth <dan@eazel.com>
 
 	* HACKING: Added this file
diff --git a/Makefile.am b/Makefile.am
new file mode 100644
index 0000000..87c39d9
--- /dev/null
+++ b/Makefile.am
@@ -0,0 +1,6 @@
+SUBDIRS = \
+	introduction-to-gnome 	\
+	omf-install
+
+EXTRA_DIST = gnome-user-docs.spec COPYING-DOCS
+
diff --git a/NEWS b/NEWS
new file mode 100644
index 0000000..e69de29
--- /dev/null
+++ b/NEWS
diff --git a/autogen.sh b/autogen.sh
new file mode 100755
index 0000000..ec1d624
--- /dev/null
+++ b/autogen.sh
@@ -0,0 +1,15 @@
+#!/bin/sh
+# Run this to generate all the initial makefiles, etc.
+
+srcdir=`dirname $0`
+test -z "$srcdir" && srcdir=.
+
+PKG_NAME="General GNOME User Documentation"
+
+(test -f $srcdir/introduction-to-gnome/C/introduction-to-gnome.sgml) || {
+    echo -n "**Error**: Directory "\`$srcdir\'" does not look like the"
+    echo " top-level gnome directory"
+    exit 1
+}
+
+. $srcdir/macros/autogen.sh
diff --git a/configure.in b/configure.in
new file mode 100644
index 0000000..412a083
--- /dev/null
+++ b/configure.in
@@ -0,0 +1,28 @@
+AC_INIT(introduction-to-gnome)
+
+SCROLLKEEPER_REQUIRED=0.1.4
+AC_SUBST(SCROLLKEEPER_REQUIRED)
+
+AM_INIT_AUTOMAKE(gnome-user-docs, 1.3.0)
+
+AM_MAINTAINER_MODE
+
+dnl ====================================
+dnl = Begin tests for scrollkeeper
+dnl ====================================
+AC_PATH_PROG(SCROLLKEEPER_CONFIG, scrollkeeper-config,no)
+if test x$SCROLLKEEPER_CONFIG = xno; then
+  AC_MSG_ERROR(Couldn't find scrollkeeper-config, please install the scrollkeeper packaga)
+fi
+dnl ====================================
+dnl = End tests for scrollkeeper
+dnl ====================================
+
+
+AC_OUTPUT([
+Makefile
+gnome-user-docs.spec
+introduction-to-gnome/Makefile
+introduction-to-gnome/C/Makefile
+omf-install/Makefile
+])
diff --git a/gnome-user-docs.spec.in b/gnome-user-docs.spec.in
new file mode 100644
index 0000000..8042bb6
--- /dev/null
+++ b/gnome-user-docs.spec.in
@@ -0,0 +1,54 @@
+%define version	@VERSION@
+%define RELEASE	1
+%define rel	%{?CUSTOM_RELEASE} %{!?CUSTOM_RELEASE:%RELEASE}
+%define prefix	/usr
+
+Summary: General GNOME User Documentation
+Name: gnome-user-docs
+Version: %{version}
+Release: %{rel}
+Copyright: FDL
+Distribution: GNOME RPMS
+Source: %{name}-%{version}.tar.gz
+Group: Documentation
+BuildArch: noarch
+BuildRoot: %{_tmppath}/%{name}-buildroot
+Prefix: %{prefix}
+
+Requires:   scrollkeeper >= @SCROLLKEEPER_REQUIRED@
+
+%description
+This package contains general GNOME user documentation which is not 
+directly associated with any particular GNOME application or package.
+
+%prep
+%setup
+%build
+./configure --prefix %{prefix}
+make 
+
+%install
+make prefix=$RPM_BUILD_ROOT/%{prefix} install
+
+%clean 
+rm -rf $RPM_BUILD_ROOT
+
+%post
+which scrollkeeper-update>/dev/null 2>&1 && scrollkeeper-update
+exit 0
+
+%postun
+which scrollkeeper-update>/dev/null 2>&1 && scrollkeeper-update
+exit 0
+
+%files
+%defattr(-, root, root)
+%{prefix}/share/gnome/help
+%{prefix}/share/omf/%{name}
+
+%changelog 
+* Sun Mar 11 2001 Dan Mueth <dan@eazel.com>
+- Update as we move to its own module
+* Mon Nov 27 2000 Kenny Graunke <kwg@teleport.com>
+- Initial cut
+
diff --git a/introduction-to-gnome/C/Makefile.am b/introduction-to-gnome/C/Makefile.am
index 761006f..8f1d3fd 100644
--- a/introduction-to-gnome/C/Makefile.am
+++ b/introduction-to-gnome/C/Makefile.am
@@ -1,93 +1,10 @@
-omffiles=gnome-intro-C.omf
-omf_dir=$(top_srcdir)/omf-install
-
-gnome_user_docs_intro_helpdir = $(datadir)/gnome/help/gnome-intro/C
-
-gnome_user_docs_intro_help_DATA = gnome-intro.sgml
-
-# the "portable" `basename' stand-in should work for the files that we
-# throw at it
-install-data-local: index.html
-	$(mkinstalldirs) $(gnome_user_docs_intro_helpdir)
-	$(mkinstalldirs) $(gnome_user_docs_intro_helpdir)/figs
-	$(mkinstalldirs) $(gnome_user_docs_intro_helpdir)/stylesheet-images
-	$(INSTALL_DATA) $(srcdir)/index.html $(gnome_user_docs_intro_helpdir)/
-	$(INSTALL_DATA) $(srcdir)/gnome-intro.sgml $(gnome_user_docs_intro_helpdir)/
-
-	for file in gnome-intro/*.html; do \
-	  basefile=`echo $$file | sed -e 's,^.*/,,'`; \
-	  $(INSTALL_DATA) $(srcdir)/$$file $(gnome_user_docs_intro_helpdir)/$$basefile; \
-	done
-	for file in gnome-intro/*.css; do \
-	  basefile=`echo $$file | sed -e 's,^.*/,,'`; \
-	  $(INSTALL_DATA) $(srcdir)/$$file $(gnome_user_docs_intro_helpdir)/$$basefile; \
-	done
-	for file in gnome-intro/figs/*.png; do \
-	  basefile=`echo $$file | sed -e 's,^.*/,,'`; \
-	  $(INSTALL_DATA) $(srcdir)/$$file $(gnome_user_docs_intro_helpdir)/figs/$$basefile; \
-	done
-	for file in gnome-intro/stylesheet-images/*.gif; do \
-	  basefile=`echo $$file | sed -e 's,^.*/,,'`; \
-	  $(INSTALL_DATA) $(srcdir)/$$file $(gnome_user_docs_intro_helpdir)/stylesheet-images/$$basefile; \
-	done
-
-EXTRA_DIST = $(gnome_user_docs_intro_help_DATA)
-
-manual-html: index.html
-manual-ps: gnome-intro.ps
-manual-pdf: gnome-intro.pdf
-manual-rtf: gnome-intro.rtf
-manual-all: manual-html manual-ps manual-pdf manual-rtf
-
-all: index.html omf
-
-omf: $(omffiles)
-	-for omffile in $(omffiles); do \
-	  which scrollkeeper-preinstall >/dev/null 2>&1 && scrollkeeper-preinstall $(gnome_user_docs_intro_helpdir)/gnome-intro.sgml $$omffile $(omf_dir)/$$omffile; \
-	done
-
-
-clean:
-	rm -rf gnome-intro
-	rm -rf gnome-intro.junk
-	rm -f figs/*.eps
-	rm -f *.log *.aux *.dvi *.tex
-	rm -rf DB2*OUTPUT*
-	rm -rf DBTO*OUTPUT*
-	rm -f index.html
-
-cvsclean: clean
-	[ -f Makefile.am ] && rm Makefile.in Makefile
-
-gnome-intro.ps: gnome-intro.sgml
-	$(MAKE) -C figs
-	db2ps $<
-
-gnome-intro.pdf: gnome-intro.ps
-	ps2pdf $<
-
-gnome-intro.rtf: gnome-intro.sgml
-	$(MAKE) -C figs
-	db2rtf $<
-
-index.html: gnome-intro/index.html
-	cd $(srcdir) \
-	&& cp gnome-intro/index.html index.html
-
-gnome-intro/index.html: gnome-intro.sgml
-	-(db2html gnome-intro.sgml \
-	&& mkdir -p gnome-intro/figs \
-	&& cp $(srcdir)/figs/*.png gnome-intro/figs || exit 1)
-
-
-dist-hook: all
-	mkdir $(distdir)/gnome-intro
-	mkdir $(distdir)/gnome-intro/figs
-	mkdir $(distdir)/gnome-intro/stylesheet-images
-	cp gnome-intro/*.html $(distdir)/gnome-intro
-	cp gnome-intro.sgml $(distdir)/gnome-intro
-	cp gnome-intro/*.css $(distdir)/gnome-intro
-	cp gnome-intro/figs/*.png $(distdir)/gnome-intro/figs
-	cp gnome-intro/stylesheet-images/*.gif $(distdir)/gnome-intro/stylesheet-images 
-	cp $(omffiles) $(distdir)
+figs = \
+	figures/desktop.png	\
+	figures/microguiborder.png
+docname = introduction-to-gnome
+lang = C
+omffile = introduction-to-gnome-C.omf
+sgml_ents =
+include $(top_srcdir)/sgmldocs.make
+dist-hook: app-dist-hook
 
diff --git a/introduction-to-gnome/C/figures/Makefile b/introduction-to-gnome/C/figures/Makefile
deleted file mode 100644
index a6f3397..0000000
--- a/introduction-to-gnome/C/figures/Makefile
+++ /dev/null
@@ -1,18 +0,0 @@
-#This Makefile converts all of the .png images used in the GDP
-#Handbook to .eps for postscript output. The img2eps script
-#converts the image and scales it to your specifications. You will
-#need to determine the width you would like your image to display on
-#paper before adding the image to this file. The width parameter will
-#scale your image in inches. Make sure to add the new image to the
-#"all" section as well.
-
-all: desktop.eps gnome-logo-large.eps microguiborder.eps
-
-desktop.eps: desktop.png
-	./img2eps desktop.png
-
-gnome-logo-large.eps: gnome-logo-large.png
-	./img2eps gnome-logo-large.png
-
-microguiborder.eps: microguiborder.png
-	./img2eps microguiborder.png
diff --git a/introduction-to-gnome/C/figures/gnome-logo-large.png b/introduction-to-gnome/C/figures/gnome-logo-large.png
deleted file mode 100644
index 495e3c5..0000000
--- a/introduction-to-gnome/C/figures/gnome-logo-large.png
+++ /dev/null
diff --git a/introduction-to-gnome/C/figures/img2eps b/introduction-to-gnome/C/figures/img2eps
deleted file mode 100755
index eebd959..0000000
--- a/introduction-to-gnome/C/figures/img2eps
+++ /dev/null
@@ -1,58 +0,0 @@
-#!/usr/bin/perl
-#
-#
-# convert image to Encapsulated Postscript, with possible scaling of width
-#
-
-$width = "";
-
-if ($ARGV[0] =~ /^--width=(.+)$/) {
-       $width = $1;
-       shift (@ARGV);
-}
-
-#print "width =",$width,"\n";
-
-#print "argv =",$ARGV[0],"\n";
-
-$infile = $ARGV[0];
-
-if (!(-e $infile)) {
-print "File doesn't exist\n";
-exit 1;
-}
-
-$imagesz = `identify $ARGV[0]`;
-
-($name, $size, $rest) =  split / /, $imagesz, 3;
-#print $name, " ", $size, " ", $rest, "\n";
-#print "imagesz = ",$size,"\n";
-
-($x, $y) = split /x/, $size, 2;
-($y, $rest) = split /\+/, $y, 2;
-
-#print $x," by ",$y, "\n";
-
-#
-# if width set, we need to scale
-#
-
-if ($width != "") {
-  $scale = $width * (72.0/$x);
-} else {
-  $scale = 1;
-}
-
-$scale = 72.0/$scale;
-#print "scale = ",$scale,"\n";
-
-$outfile = $infile;
-$outfile =~ s/\.png/\.eps/;
-
-#print $infile," ",$outfile,"\n";
-system("convert $infile tmpimage.pgm");
-#system("giftopnm $infile | ppmtopgm > tmpimage.pgm");
-system("convert -density $scale tmpimage.pgm $outfile");
-system("rm tmpimage.pgm");
-
-
diff --git a/introduction-to-gnome/C/gnome-intro-C.omf b/introduction-to-gnome/C/introduction-to-gnome-C.omf
index cf9eee1..f41f83c 100644
--- a/introduction-to-gnome/C/gnome-intro-C.omf
+++ b/introduction-to-gnome/C/introduction-to-gnome-C.omf
@@ -2,13 +2,13 @@
 <omf>
   <resource>
     <title>
-      Introduction to Gnome
+      Introduction to GNOME
     </title>
     <subject>
       <category>GNOME</category>
     </subject>
     <format mime="text/sgml"/>
-    <identifier url="gnome-intro.sgml"/>
+    <identifier url="introduction-to-gnome.sgml"/>
     <language code="C"/>
   </resource>
-</omf>
\ No newline at end of file
+</omf>
diff --git a/introduction-to-gnome/C/gnome-intro.sgml b/introduction-to-gnome/C/introduction-to-gnome.sgml
index 16236c8..e255f39 100755..100644
--- a/introduction-to-gnome/C/gnome-intro.sgml
+++ b/introduction-to-gnome/C/introduction-to-gnome.sgml
@@ -9,10 +9,8 @@
    </author>
   </authorgroup>
 
-    <graphic fileref="./figs/gnome-logo-large" format="png"></graphic>
-
   <releaseinfo>
-   This is a beta  draft of  Introduction to Gnome for Gnome 1.4
+   This is a draft of Introduction to Gnome for Gnome 1.4
   </releaseinfo>
 
 
@@ -189,7 +187,7 @@
      <title>Sample Gnome Display.</title>
      <screenshot>
       <screeninfo>Sample Gnome Display</screeninfo>
-      <graphic format="png" fileref="./figs/desktop" srccredit="sasha">
+      <graphic format="png" fileref="figures/desktop" srccredit="sasha">
       </graphic>
     </screenshot>
    </figure>
@@ -391,7 +389,7 @@
      <title>Window Border in MicroGUI Style.</title>
      <screenshot>
       <screeninfo>Window border in MicroGUI style</screeninfo>
-      <graphic format="png" fileref="./figs/microguiborder" srccredit="sasha">
+      <graphic format="png" fileref="figures/microguiborder" srccredit="sasha">
       </graphic>
     </screenshot>
    </figure>
diff --git a/introduction-to-gnome/Makefile.am b/introduction-to-gnome/Makefile.am
index c417594..42ffacc 100644
--- a/introduction-to-gnome/Makefile.am
+++ b/introduction-to-gnome/Makefile.am
@@ -1,5 +1 @@
 SUBDIRS = C
-
-cvsclean:
-	$(MAKE) -C C cvsclean
-
diff --git a/omf-install/Makefile.am b/omf-install/Makefile.am
new file mode 100644
index 0000000..787a802
--- /dev/null
+++ b/omf-install/Makefile.am
@@ -0,0 +1,33 @@
+# 
+# Modify the definition of $omf_dest_dir, replacing "gdp-example1" with
+# the name of your package.
+# 
+# No other modifications should be necessary.
+#
+# 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.
+
+omf_dest_dir=$(datadir)/omf/gnome-user-docs
+scrollkeeper_localstate_dir = $(localstatedir)/scrollkeeper
+
+install-data-local:
+	$(mkinstalldirs) $(DESTDIR)$(omf_dest_dir)
+	-for file in $(srcdir)/*.omf; do \
+		$(INSTALL_DATA) $(srcdir)/$$file $(DESTDIR)$(omf_dest_dir); \
+	done
+	-scrollkeeper-update -p $(scrollkeeper_localstate_dir) 
+
+uninstall-local:
+	-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) 
diff --git a/sgmldocs.make b/sgmldocs.make
new file mode 100644
index 0000000..f9f12b5
--- /dev/null
+++ b/sgmldocs.make
@@ -0,0 +1,125 @@
+# To use this template:
+#     1) Define: figs, docname, lang, omffile, sgml_ents although figs, 
+#        omffile, and sgml_ents may be empty in your Makefile.am which 
+#        will "include" this one 
+#     2) Figures must go under figures/ and be in PNG format
+#     3) You should only have one document per directory 
+#
+#        Note that this makefile forces the directory name under
+#        $prefix/share/gnome/help/ to be the same as the SGML filename
+#        of the document.  This is required by GNOME. eg:
+#        $prefix/share/gnome/help/fish_applet/C/fish_applet.sgml
+#                                 ^^^^^^^^^^^   ^^^^^^^^^^^
+# Definitions:
+#   figs         A list of screenshots which will be included in EXTRA_DIST
+#                Note that these should reside in figures/ and should be .png
+#                files, or you will have to make modifications below.
+#   docname      This is the name of the SGML file: <docname>.sgml
+#   lang         This is the document locale
+#   omffile      This is the name of the OMF file.  Convention is to name
+#                it <docname>-<locale>.omf.
+#   sgml_ents    This is a list of SGML entities which must be installed 
+#                with the main SGML file and included in EXTRA_DIST. 
+# eg:
+#   figs = \
+#          figures/fig1.png            \
+#          figures/fig2.png
+#   docname = scrollkeeper-manual
+#   lang = C
+#   omffile=scrollkeeper-manual-C.omf
+#   sgml_ents = fdl.sgml
+#   include $(top_srcdir)/doc/sgmldocs.make
+#   dist-hook: app-dist-hook
+#
+
+docdir = $(datadir)/gnome/help/$(docname)/$(lang)
+
+doc_DATA = index.html
+
+sgml_files = $(sgml_ents) $(docname).sgml
+
+omf_dir=$(top_srcdir)/omf-install
+
+EXTRA_DIST = $(sgml_files) $(doc_DATA) $(omffile) $(figs)
+
+CLEANFILES = omf_timestamp
+
+all: index.html omf
+
+omf: omf_timestamp
+
+omf_timestamp: $(omffile)
+	-for file in $(omffile); do \
+	  scrollkeeper-preinstall $(docdir)/$(docname).sgml $$file $(omf_dir)/$$file; \
+	done
+	touch omf_timestamp
+
+index.html: $(docname)/index.html
+	-cp $(docname)/index.html .
+
+$(docname).sgml: $(sgml_ents)
+        -ourdir=`pwd`;  \
+        cd $(srcdir);   \
+        cp $(sgml_ents) $$ourdir
+
+
+# The weird srcdir trick is because the db2html from the Cygnus RPMs
+# cannot handle relative filenames
+$(docname)/index.html: $(srcdir)/$(docname).sgml
+	-srcdir=`cd $(srcdir) && pwd`; \
+	db2html $$srcdir/$(docname).sgml
+
+app-dist-hook: index.html
+	-$(mkinstalldirs) $(distdir)/$(docname)/stylesheet-images
+	-$(mkinstalldirs) $(distdir)/figures
+	-cp $(srcdir)/$(docname)/*.html $(distdir)/$(docname)
+	-cp $(srcdir)/$(docname)/*.css $(distdir)/$(docname)
+	-cp $(srcdir)/$(docname)/stylesheet-images/*.gif \
+		$(distdir)/$(docname)/stylesheet-images
+	-cp $(srcdir)/figures/*.png \
+		$(distdir)/figures
+
+install-data-am: index.html omf
+	-$(mkinstalldirs) $(DESTDIR)$(docdir)/stylesheet-images
+	-$(mkinstalldirs) $(DESTDIR)$(docdir)/figures
+	-cp $(srcdir)/$(sgml_files) $(DESTDIR)$(docdir)
+	-for file in $(srcdir)/$(docname)/*.html $(srcdir)/$(docname)/*.css; do \
+	  basefile=`echo $$file | sed -e 's,^.*/,,'`; \
+	  $(INSTALL_DATA) $$file $(DESTDIR)$(docdir)/$$basefile; \
+	done
+	-for file in $(srcdir)/figures/*.png; do \
+	  basefile=`echo $$file | sed -e  's,^.*/,,'`; \
+	  $(INSTALL_DATA) $$file $(DESTDIR)$(docdir)/figures/$$basefile; \
+	done
+	-for file in $(srcdir)/$(docname)/stylesheet-images/*.gif; do \
+	  basefile=`echo $$file | sed -e  's,^.*/,,'`; \
+	  $(INSTALL_DATA) $$file $(DESTDIR)$(docdir)/stylesheet-images/$$basefile; \
+	done
+
+$(docname).ps: $(srcdir)/$(docname).sgml
+	-srcdir=`cd $(srcdir) && pwd`; \
+	db2ps $$srcdir/$(docname).sgml
+
+$(docname).rtf: $(srcdir)/$(docname).sgml
+	-srcdir=`cd $(srcdir) && pwd`; \
+	db2ps $$srcdir/$(docname).sgml
+
+uninstall-local:
+	-for file in $(srcdir)/$(docname)/stylesheet-images/*.gif; do \
+	  basefile=`echo $$file | sed -e  's,^.*/,,'`; \
+	  rm -f $(docdir)/stylesheet-images/$$basefile; \
+	done
+	-for file in $(srcdir)/figures/*.png; do \
+	  basefile=`echo $$file | sed -e  's,^.*/,,'`; \
+	  rm -f $(docdir)/figures/$$basefile; \
+	done
+	-for file in $(srcdir)/$(docname)/*.html $(srcdir)/$(docname)/*.css; do \
+	  basefile=`echo $$file | sed -e 's,^.*/,,'`; \
+	  rm -f $(DESTDIR)$(docdir)/$$basefile; \
+	done
+	-for file in $(sgml_files); do \
+	  rm -f $(DESTDIR)$(docdir)/$$file; \
+	done
+	-rmdir $(DESTDIR)$(docdir)/stylesheet-images
+	-rmdir $(DESTDIR)$(docdir)/figures
+	-rmdir $(DESTDIR)$(docdir)