From 72d8e0ab83d16e5dedd323354fa37d9f52ca1b1e Mon Sep 17 00:00:00 2001 From: Dan Mueth Date: Mon, 12 Mar 2001 08:20:35 +0000 Subject: Setting up basics of build system. Still needs some tweaking. 2001-03-12 Dan Mueth 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: --- AUTHORS | 2 + COPYING | 358 ++++++ COPYING-DOCS | 355 ++++++ ChangeLog | 31 + Makefile.am | 6 + NEWS | 0 autogen.sh | 15 + configure.in | 28 + gnome-user-docs.spec.in | 54 + introduction-to-gnome/C/Makefile.am | 101 +- introduction-to-gnome/C/figures/Makefile | 18 - .../C/figures/gnome-logo-large.png | Bin 23473 -> 0 bytes introduction-to-gnome/C/figures/img2eps | 58 - introduction-to-gnome/C/gnome-intro-C.omf | 14 - introduction-to-gnome/C/gnome-intro.sgml | 1235 -------------------- .../C/introduction-to-gnome-C.omf | 14 + introduction-to-gnome/C/introduction-to-gnome.sgml | 1233 +++++++++++++++++++ introduction-to-gnome/Makefile.am | 4 - omf-install/Makefile.am | 33 + sgmldocs.make | 125 ++ 20 files changed, 2263 insertions(+), 1421 deletions(-) create mode 100644 AUTHORS create mode 100644 COPYING create mode 100644 COPYING-DOCS create mode 100644 Makefile.am create mode 100644 NEWS create mode 100755 autogen.sh create mode 100644 configure.in create mode 100644 gnome-user-docs.spec.in delete mode 100644 introduction-to-gnome/C/figures/Makefile delete mode 100644 introduction-to-gnome/C/figures/gnome-logo-large.png delete mode 100755 introduction-to-gnome/C/figures/img2eps delete mode 100644 introduction-to-gnome/C/gnome-intro-C.omf delete mode 100755 introduction-to-gnome/C/gnome-intro.sgml create mode 100644 introduction-to-gnome/C/introduction-to-gnome-C.omf create mode 100644 introduction-to-gnome/C/introduction-to-gnome.sgml create mode 100644 omf-install/Makefile.am create mode 100644 sgmldocs.make diff --git a/AUTHORS b/AUTHORS new file mode 100644 index 0000000..28ca701 --- /dev/null +++ b/AUTHORS @@ -0,0 +1,2 @@ +Dan Mueth +Laszlo Kovacs 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 + + 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 * 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 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 +- Update as we move to its own module +* Mon Nov 27 2000 Kenny Graunke +- 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 Binary files a/introduction-to-gnome/C/figures/gnome-logo-large.png and /dev/null differ 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/gnome-intro-C.omf deleted file mode 100644 index cf9eee1..0000000 --- a/introduction-to-gnome/C/gnome-intro-C.omf +++ /dev/null @@ -1,14 +0,0 @@ - - - - - Introduction to Gnome - - - GNOME - - - - - - \ No newline at end of file diff --git a/introduction-to-gnome/C/gnome-intro.sgml b/introduction-to-gnome/C/gnome-intro.sgml deleted file mode 100755 index 16236c8..0000000 --- a/introduction-to-gnome/C/gnome-intro.sgml +++ /dev/null @@ -1,1235 +0,0 @@ - -
- - Introduction to Gnome - - - Gnome - Documentation Team - - - - - - - This is a beta draft of Introduction to Gnome for Gnome 1.4 - - - - - 2000, 2001 - - Red Hat, Inc., David A. Wheeler, Alexander Kirillov - - - - - - 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 no Invariant - Sections, no Front-Cover Texts, and no Back-Cover Texts. You - may obtain a copy of the GNU Free Documentation - License from the Free Software Foundation by - visiting their Web - site or by writing to: Free Software Foundation, Inc., - 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. - - - Many of the names used by companies to distinguish their - products and services are claimed as trademarks. Where those - names appear in any Gnome documentation, and those trademarks - are made aware to the members of the Gnome Documentation - Project, the names have been printed in caps or initial caps. - - - - - - - - - What is Gnome? - - Gnome is a user-friendly graphical desktop environment for UNIX and - UNIX-like systems that enables users to easily use and configure - their computers. Gnome includes a panel (for starting - applications and displaying status), a desktop (where data and - applications can be placed), a set of standard desktop tools and - applications, and a set of conventions that make it easy for - applications to cooperate and be consistent with each other. - Users of other operating systems or environments should feel - right at home using the powerful graphics-driven environment - Gnome provides. Gnome runs on a number of UNIX-like operating - systems, including Linux, FreeBSD, and Solaris. - - Gnome is completely open source (free software) developed by - hundreds of programmers around the world. Both the source code - and ready-to-run binaries of Gnome are available for download on - the Internet; they are distributed under the terms of GNU General Public - License (and its cousins, Lesser General Public License and - Free Documentation - License for libraries and documentation - respectively). In particular, this means that everyone is free - to use, copy or distribute Gnome. If you would like to learn - more about the Gnome project please visit the Gnome web site. - - - Gnome is highly configurable, enabling you to set your desktop - the way you want it to look and feel. Gnome supports many human - languages, and more are added every month. Gnome even supports - several Drag and Drop protocols for maximum interoperability - with non-Gnome applications. - - - - Gnome comes from the acronym for the GNU Network Object Model - Environment (GNOME). Gnome is a part of the larger GNU project, - started in 1984 to develop a completely free UNIX-like operating - system. For more information, visit the GNU Website. - - - This guide describes Gnome 1.4 which the latest (as of February - 2001) release of Gnome. - - - - - About This Guide - - This guide gives you a short introduction to Gnome. It is not - intended to cover all details of Gnome; if you need more - information, you should read detailed manuals listed in . Also, this guide assumes you already have - Gnome installed; if you need help installing Gnome, please check - the instructions on Gnome Website. - - - - This guide was written by the members of Gnome - Documentation Project (GDP). If you have any comments or - suggestions about this guide - or if you can offer any other help in improving or translating - Gnome documentation, please send an e-mail to - docs@gnome.org, or visit GDP Web - Site. - - The authors of this guide assume that you are - using the default configuration of Gnome (that is, default GTK - theme and sawfish window manager with - MicroGUI theme). Gnome is highly - configurable, so it is easy to change not only the look but also - the behavior of Gnome; however, we recommend that you do so only - after you already have some experience with Gnome. - - - - - Mouse Conventions Used in This Guide - - Before describing Gnome, let us introduce some terms used not - only in this guide but in all Gnome documents. Most importantly, - we need to clarify the use of mouse buttons and clicks. - - - Most Gnome documents assume that you are using a standard (for - UNIX) 3-button mouse and talk about left, right, and middle - mouse buttons; if a document says click without - explicitly specifying the button, the left button is - assumed. Some documents use notations mouse button - 1, mouse button 2 and mouse button - 3 (or MB1, MB2, MB3 for short) for left, middle, and - right buttons respectively. - - - If you are using a two-button mouse, you can emulate the middle - mouse button by pressing left and right buttons simultaneoulsy; - if you have a wheel mouse, the wheel can be used in place of the - middle mouse button. - - - You can switch the roles of the buttons using Gnome - Control Center. Many left-handers choose to reverse the - right and left buttons. If you have done so, you need to use the - right mouse button whenever document instructs you to click, and use - left mouse button whenever a document talks - about right-clicking or mouse button 3. - - - If you use a mouse with some unusual placement of buttons, a - trackball, or some other input device, you need to find out - which buttons correspond to right, - left and middle; this information - can usually be found in the manual which came with your - device. Usually, left button (MB1) is the one - under your index finger. - - - - - - - - First glance at Gnome: Desktop and Panel - - shows an example of Gnome - running. Gnome is very configurable, so your screen may look - quite different. - - -
- Sample Gnome Display. - - Sample Gnome Display - - - -
- - - - Panel - - The long bar at the bottom of is - a Gnome Panel. It contains a number of useful things, such as - - - The Main Menu: this is the - button with the stylized footprint. Clicking this button - brings up a menu containing all Gnome applications - and commands, including the logout command. - - - - - Application launchers: these are buttons that start - various programs. For example, the toolbox button - starts the Gnome Control Center - (for configuring your system). - - - - - Panel applets: these are are tiny programs designed to - work inside the Panel. For example, the - clock applet on the far right - shows the current time, and - tasklist applet (in the - middle of the panel) shows the list of all application - windows on your desktop (this will be discussed in - detail in ). - - - - - As with all Gnome components, Panel is highly - configurable: you can add or remove application launchers and - applets, edit the Main Menu, change Panel - background, or even create new Panels. For example, to move an - object, drag it to the new location using the middle mouse button; to configure - an object, get help on it, or remove it from the Panel, - right-click on it and select the appropriate item from the - pop-up menu. To hide the Panel when you are - not using it, click on one of the Hide - buttons (with small arrows) at the ends of the - Panel. - - More Panel operations are available from the - Panel menu, which you can open by - right-clicking in any empty space on the Panel (for example, - in the hide arrows) and selecting Panel - from the menu. The Panel menu also contains Panel manual, which describes - all these options and more. - - - - Desktop - - Everything outside the Panel is called - desktop. You can place icons for files, applications, - and other items on the desktop (a default collection of icons is - installed with Gnome), after which you can double-click on an item - to use it: - - - - - If the item is a program, that program will start. - - - - - If it is a data file, the appropriate program will start - up with that data loaded. - - - - - - If it is a directory, the File Manager will start and show - the contents of that directory. Your desktop will probably - have a icon showing a house and labeled - yourname's - Home. Double-clicking on this icon will start - the File Manager at your home directory. - - - - - The easiest way to place an item on the desktop is to - drag-and-drop a file from the File Manager window. This will be - discussed in more detail in . Once - the item is placed on the desktop, you can move it around the - desktop using the left mouse button, or you can click on it - with the right mouse button to bring up the - pop-up menu which allows you to delete the - item or change its properties. - - - - - - Using the Mouse - - As you have already seen, you can do almost anything just by - clicking with your mouse. Here are some conventions which work - almost anywhere in Gnome: - - - - - Clicking on an item with the left mouse button selects - (hilights) it. If you need to select several objects, hold down - CTRL key while clicking. - - - Double-clicking on an item runs the default action for - this item (running an application, opening the file, etc.) - - - Clicking on an item with the right mouse button brings up - the context menu, which contains all the commands and - information available for this item. If you have selected - a group of items, right-clicking on any of them will bring - up the context menu which applies to all of these items. - - - You can - select text anywhere on the screen using the left mouse - button, and then insert this text into any other place on - the screen which accepts text input, by clicking with the - middle mouse button. - - - - In addition, clicking with the right mouse button on any empty - space on your desktop brings up a pop-up - menu, which allows you to change desktop background or other - properties, or add a new item to the desktop. Clicking on the - desktop with the middle mouse button produces the default menu - for your window manager (see ). - - - - - - Logging Out - - To log out of Gnome, click on the Main Menu - button and select Log out. Gnome - will prompt you for confirmation; it will also give you an - option to save the session — that is, information about - currently open applications and their location on the screen - will be saved, so that when you login next time, the same - applications will be in the same places (this only works for - applications which are fully Gnome-compliant). - - - - - - - - Working With Windows - - The graphical system used by all UNIX-like operating systems, X - Window System, allows you to have several windows on your - screen, with a different application running each in each - window. By itself, however, X Window System can only do very - low-level operations, so it is always used in conjunction with - another piece of software, called window manager. A window - manager provides windows' borders and buttons, allows you to - move, close, and resize windows, etc. Gnome can work with many - window managers. The most popular are: - - Enlightenment and - Sawfish (formerly known as - Sawmill). Each window manager can use many different styles of - window decorations and buttons (this is referred to as - window manager theme). Since it is impossible to - cover them all, in this section we only describe the default - window manager shipped with Gnome, - Sawfish, and its default theme - (MicroGUI). An example of the window border in - the MicroGUI theme is shown in - - - -
- Window Border in MicroGUI Style. - - Window border in MicroGUI style - - - -
- - - So, what can you do with windows? - - - - - Closing, minimizing, and maximizing windows - - - - To close a window, click on the button with the - small yellow x in the right side of the window - border. If the application has any unsaved data, it will - prompt you to save it. - - - To maximize a window, i.e. make it fill the entire - screen (except for the part taken by the panels), click - on the button with small yellow up - arrow. Clicking on this arrow once again will restore - the window to its original size. - - To minimize (hide or iconify) a window, click on the - button with small yellow down arrow. The - window will disappear from screen. However, it is not - lost forever — the application in this window continues - running, no data is lost — it is just temporarily - hidden. All minimized windows are shown in the tasklist - applet and can be restored as described below. - - A convenient alternative to minimizing windows is - shading them. When you shade a window, it - rolls up into its own title bar, so the - title bar is the only part of the window left on - screen. To shade a window, double-click on the title - bar; to unshade, double-click again. Try it! - - - - - - Raising and lowering windows - - - Windows on your screen can overlap, so that one of - the windows is on top of another. You can - raise a window (i.e., put it on top of - all others) by clicking on the window title bar. You can - also switch a window from raised to lowered and back by - clicking on the title bar with the middle mouse button, or by - clicking anywhere inside the window with the right mouse - button while holding down ALT key. - - - - - - Focus - - - Of all the windows on your screen, only one is active - (in computer parlance, focused), which means - that anything you type on the keyboard will be sent to the - application running in that window. (It does not mean that the - applications in other windows are idle — they can - be running as well.) To help you see which window has - focus, the title bar of this window has different color - (left side is blue, as opposed to gray for all other - windows). To change focus to another window, just click - anywhere in this window. You can also click in the - window title bar to focus and raise the window - simultaneously. - - - - - - Moving and resizing windows - - - To move a window, drag its title bar to a new - location using left mouse button (i.e., click in the - title bar and move the mouse without releasing the - button). You can also move a window by clicking anywhere - inside the window while holding down the - ALT key. - - - To resize a window, place the mouse cursor on any of the - window borders (except the top one) or corners. The - mouse cursor will change to an arrow pushing a line or - corner, allowing you to drag the border or corner to a new - position. - - - - - - - - Tasklist - - All the windows on your desktop (including the minimized ones) - are shown in the tasklist, located - on your Panel. For each window, a mini-icon and beginning of - the window title is shown. To restore a minimized window, just click - on its title in the tasklist. Right-clicking on the window - title brings up the pop-up menu whihc - allows you to shade a window, close it, or kill the - application running in the window. The last option should only - be used when an application is frozen and does not respond to - close window command. If you kill an - application, you lose all unsaved data! - - - - - Window Operations Menu - - Sawfish also provides a menu for - each window; this menu contains all the operations for this - window described above, and then some. To access this menu, - click on the button in the left side of the window title bar - (with the small triangle pointing down). You can also invoke - this menu by right-clicking in the window title or clicking - anywhere in the window with the middle mouse button while holding - down the ALT key. - - - - Desktop Menu - - Finally, Sawfish also provides a - desktop menu; it can be accessed by clicking on any - empty space of the desktop with the middle mouse button. It - contains the following options: - - - - - Windows - - - - Provides list of all windows, including minimized - ones. Selecting one of these windows restores it (if it - was minimized) and raises it over other windows. Very - convenient if you have so many windows that the one you - need is completely covered by others. - - - - - - Workspaces - - - Allows you to switch from one workspace to another, - create and delete workspaces. See - Sawfish manual for details. - - - - - - Programs - - - - Same as Programs section - of the Main Menu. - - - - - - Customize - - - - Allows the user to customize all properties of the - Sawfish behavior. For a new - user, we recommend trying various - Appearance settings, but leaving - all other subsections alone. - - - - - - Help - - - - Provides links to Sawfish web - page, Sawfish manual (beware: - this is not a user's manual but rather a manual for - people who write extensions/customizations to - Sawfish using LISP - programming language), link to Gnome Users - Guide, and to Gnome Web - site. - - - - - - - - - - - Nautilus: Gnome File Manager, Help Browser, and More - - Gnome 1.4 includes a graphical shell, - Nautilus. It combines file manager, - help browser, web browser, FTP client, and much more. To launch - it, select Nautilus in the - Main Menu, or just dpuble-click on any directory - icon on your desktop. - - - Managing Your Files With Nautilus - - - As most modern graphic file managers, - Nautilus shows the contents of a - selected directory using icons to represent files and - subdirectories. Double-clicking on any file or directory opens - it (for data files, it starts the appropriate application - which opens this file). Right-clicking on a file or directory - produces a pop-up menu. Using this menu, - you can delete or rename the file, view and change file - properties or permissions, and more. - - Nautilus also provides an easy - way to move files between directories. To move move a file - from one directory to another, open each directory in a - different Nautilus window by selecting - New window from the - Nautilus File menu. - Select the file you need, and drag it from one window into another - using the mouse. You can also drag a file or directory to the desktop. - - Nautilus provides many more - tools to manipulate your files. It is also highly - customizable, so you can easily change the way files are - displayed (for example, you can choose a custom icon for a - given file). For detailed description of all these - possibilities, read Nautilus manual. - - - - Reading Documentation With Nautilus - - In addition to being a file manager, - Nautilus is also a help browser: - you can use it to read documentation installed on your - system. This includes not only Gnome documentation, but also - UNIX-style manual pages (manpages), GNU info pages - (documentation format used GNU project utilities), and other - types of documentation. To view the list of all documentation - installed on your system, click on the - Help tab in the left panel of - Nautilus. - - - - - - - Customizing - - Gnome is highly configurable — you can change almost - anything: background color, key bindings, location of panels - and contents of the Main Menu, and more. - Most of these changes are done using Gnome Control - Center, which can be found in - Settings submenu of the Main - Menu; this menu also allows you to access a specific - section of the Gnome Control Center. - The Control Center has its own - detailed documentation which you should consult before making - any changes. - - - Here we would like to give just an overview of the most commonly - used options of the Gnome Control - Center. - - - - Background - - - You can change the desktop background by selecting - Background in the - Desktop section of Gnome - Control Center. (A quicker alternative to - access this section is to right-click on any empty space on - your desktop and select Change Desktop - Background from the pop-up - menu). - - - - - Theme Selector - - - - Theme Selector allows you to change the - desktop theme (also known as GTK theme). This changes the - appearance of the Main Menu, as well as - menus, toolbars, scrollbars, checkbuttons and other elements - of graphical user interface for all Gnome applications. Many - users find the default GTK theme rather dull, so the first - thing they do is switching to another one. - - - - - Sawfish window manager - - - - This section - allows you to change settings for the window manager. In - particular, in the Appearance - subsection you can change the frame style (theme), which - determines the window borders and buttons. You can also - change the font used for window title bars. If you - are a new user, we recommend that you do not change - other settings. - - - - - Session - - - - In this section you can define - the startup programs (that is, programs that are run every - time you log in), enable or disable login hints and logout - confirmation dialog. - - - - - - In addition, you can change properties of various items — - most notably, panels and icons on your desktop — by - clicking on them with the right mouse button and selecting - Properties from the - pop-up menu. In this way, you can change the - caption of an icon, size and background color (or even - background image) of the Panel, and much more. - - - - Almost every Gnome application has its own - preferences settings (look for - Preferences or Settings in - the menus), so you can change, for example, colors used by the Gnome - Terminal or make it transparent — the possibilities are - unlimited! - - - - - - Gnome Applications and Utilities - - Gnome comes with many applications and utilities; in addition, - Gnome allows you to use any third party applications such as - Netscape), KDE applications, or other - applications and utilities installed on your system. Here is a - list of some of the most useful tools and applications which you - can find in Gnome's Main Menu (this is not a - complete list!) - - - - Applications - - - These include office and productivity applications - such as - - - Gnumeric - — a full-featured Excel-compatible spreadsheet - - - - AbiWord — a lightweight - word processing application - - - - Gnome Calendar to help - you manage your busy schedule - - - Several text editors, from simple and - easy to use gedit to the - (arguably) the most powerful text editor ever created, - Emacs (which is not a Gnome - appication) - - - - - - - - Graphics - - - - - Gimp — - image editing program for power users; rivals - Photoshop - - - Image viewers such as Eye of - Gnome, GQview and - xv - - - - - - - Utilities - - - Among other things, here you will find - - - Calculator - - - - Gnome Search - tool which you can use to find a file - on your system - - - - gfloppy for formatting - floppy disks - - - - GDictfor - looking up a word in one of the many dictionaries - freely available on the Internet - - - - - - - Multimedia - - - - Here you will find CD player, - Mixer (which also can be used - to adjust volume of your speakers), and an MP3 player - XMMS. - - - - - - System - - - - This submenu contains utilities for managing your - system. You can find out detailed information about your - processor, memory, and operating system using - System Info, check how much - space you have left on your disks using Gnome - DiskFree, or view all the processes (jobs) - which are currently running on your computer using - System monitor. In addition, - System monitor also shows you - load level for the processor and memory, and allows you to - kill a stalled or otherwise unwanted job. - - - This submenu also contains tools for managing software - installed on your system, namely - GnoRPM and Helix - Gnome Update (if you are using the - distribution of Gnome prepared by Helix Code, Inc.). - GnoRPM allows you to view all - software packages installed on your system (if you are - using a distribution of Linux based on RPM packages, such - as Red Hat, SuSe, or Mandrake); it also allows you to remove, - update, or install new packages. - Helix Gnome Update provides an - extremely easy, almost one-click, way to update your - Gnome installation. Both of these utilities , however, require - that you have system administrator (root) privileges. - - - And finally, the same submenu also contains various - terminal emulators (xterm, - Color xterm, - Gnome Terminal) letting you use - the most powerful (although not most user friendly) interface - ever created — the command line prompt. - - - - - Internet - - - - Here, you will find Netscape web - browser, X-Chat for Internet Relay - Chat (IRC), Gnome-ICU for talking - with other people using ICQ protocol, and - gftp which is a graphical tool - for FTP file transfers. Note that Gnome file manager, - Nautilus, also has built-in FTP - capabilities, so gftp is needed - only in those rare cases when you need something really - complicated (for example, transferring files using secure - version of FTP, based on ssh). - - - - - Games - - - - Lots of them — just try! - - - - - - - - - - - Help - I Am in Trouble! - - Everyone runs into trouble sooner or later. Here is some - advice on how to handle the most common problems: - - - - Killing a Stalled Application - - If an application is stalled or frozen — that is, if it - does not respond to your mouse clicks and keyboard commands, - you can either wait and hope that it wakes up, or kill it. If - you decide to kill it (NOTE: You will lose all unsaved data), - start the Gnome System monitor - (from System submenu of the - Main Menu), right-click on the frozen - application name, and select Kill - now. Using Gnome System - monitor also allows you to find and kill all - helper processes started by this application. - - - If a Gnome application freezes or crashes (unexpectedly dies) - repeatedly, you should file a bug report as described in . - - - - My Whole System Froze! - - If your whole system is frozen and is not responding, do not - hurry to push the reset button on the computer - — this is usually the worst solution. Most probably, it is - not the operating system itself that is frozen (UNIX systems are - known for stability), but just the graphical part, X Window - System. In this case, you can try to restart X Window System by - simultaneously pressing - - CTRL-ALT-Backspace. - This should work for - the implementation of X Window system used on Linux and *BSD, - XFree86 — unless it was disabled by your system - administrator. Of course, in this way you also lose all unsaved - data, but at least you do not risk to mess up the whole file - system. - - - - - - - My Whole Gnome Configuration is Messed Up! - - If you have more serious problems than just desktop icons — - for example, if your panel is missing — the radical solution - is to remove all your Gnome configuration files and start from - scratch. This is an emergency solution, as you lose all - configuration settings and will need to configure your menus, - panels, etc. again from scratch, that is, from the default Gnome - configuration. However, this only affects Gnome configuration, - so your data files and settings for non-Gnome applications - remain intact. - - To remove all your Gnome configuration files and return - to the original Gnome configuration, logout then log in again - holding down keys CTRL and - SHIFT (immediately after entering your - password in the login dialog). You will be presented a dialog, - offering you the choice to reset the saved session (that is, - which applications were open when you last logged out); reset - your Gnome configuration settings; or both. - - - Finally, if you have really severe problems and your system - freezes or becomes otherwise unusable as soon as you login, - you have one last option. You can select - Failsafe session type instead of - the default Gnome in the login - screen. Both Gnome and KDE Login Managers support this. In - this session type, Gnome is not started; instead, you are - presented with a single terminal window. This is almost - guaranteed to start OK, and if you know how to use - command-line tools to find and fix your problem, you have a - chance. Otherwise, ask an expert. - - - - - - - Where to Find More Information - - Documentation Included with Gnome - - Gnome includes detailed documentation for the majority - of applications, utilities and other components, such as Panel - or Nautilus file manager. You can view the list of all Gnome - documents installed on your system using the Help - Contents tab in Nautilus. So, if you want to - know more about one of these components, read the appropriate - manual. - - - In addition to the manuals for individual components, Gnome - documentation also includes: - - - - - - Frequently Asked Questions - - - - This document contains answers to some of the most - commonly asked questions about Gnome. - - - - - - - If you are new to UNIX/Linux... - - - - - This short document gives the minimal necessary - information about UNIX and UNIX-like operating systems, - including such things as filenames, paths and - directories, permissions, symbolic links and most - confusing of them all, the notion of - mounting. If you never used UNIX system - before, be sure to read this. - - - - - - Glossary - - - Gives brief explanation of some of computer-related - terms you may see in Gnome documentation, from ASCII to X - Window System. - - - - - - - Gnome Resources on the Internet - - In addition to documentation shipped with Gnome, there is also - wealth of information available on the Internet. A good - starting point is, of course, the Gnome Website. There you - will find instructions for installing Gnome, reviews and tips, - developer information, and more. - - - If you can not find an answer to your question there, you - may ask other Gnome users and developers on Gnome mailing list - (subscription instructions can be found here). - Note, however, that this list is for Gnome-related questions - only (do not ask how to configure X Window System, for instance), - and it is impolite (to say the least) to ask a question without - first checking if this question is already answered in available - documents such as Gnome FAQ. - - - - Everything Not Gnome - - You should realize that Gnome is just part of your computer - system. If you want to unleash the full potential of your - computer, you need to understand not just Gnome but also the - underlying operating system (UNIX/Linux/FreeBSD), various - tools and utilities included with it, and its graphics system - (X Window System). Each of these components usually comes with - its own documentation. Most of UNIX commands and utilities are - documented in so-called manual pages, or man pages - for short. You can view them using Nautilus - (see ). This documentation is usually - very detailed and more technical than most users would like. - Another documentation format used by utilities from the - GNU project is called info pages. They, too, - can be viewed using Nautilus. Many - applications also have documentation in other formats. Sometimes - it is not easy to find documentation for a given application — - try looking in the directory /usr/doc. - - Documentation for operating system itself varies from one - system to another. The best advice is to check the printed manual - which came with your system. For Linux, a good source of information - is the Linux Documentation Project (LDP); you can read or their - documentation on the Internet (at http://www.linuxdoc.org). - Virtually all Linux distributions also include copies of LDP - documents; usually they are found at - /usr/doc/LDP or - /usr/doc/HOWTO. - - - And of course, there are a number of books available about all - flavors of UNIX/Linux, Gnome, and about anything else you might - be interested in. Check your local bookstore. - - - - - Feedback - - If you have any comments, suggestions, or complaints about this - guide, please send them to Gnome Documentation project at - docs@gnome.org. - - - If you find a bug in one of Gnome applications, please report - it! The developers do read these reports and try to fix all - reported bugs. The easiest way to send a bug report is to use - Gnome Bug Report Tool, found in the - Utilities submenu of the Main - Menu. This tool will be automatically started if a - Gnome application crashes. It should also be used for submitting - suggestions or requests for new features for Gnome applications: - just select Severity: enhancement in the - appropriate window of Gnome Bug Report - Tool. - - - If you have questions about Gnome, or want to discuss Gnome - with other users and developers, you should subscribe to the - Gnome mailing list as described in . - - -
- - - - - - - - diff --git a/introduction-to-gnome/C/introduction-to-gnome-C.omf b/introduction-to-gnome/C/introduction-to-gnome-C.omf new file mode 100644 index 0000000..f41f83c --- /dev/null +++ b/introduction-to-gnome/C/introduction-to-gnome-C.omf @@ -0,0 +1,14 @@ + + + + + Introduction to GNOME + + + GNOME + + + + + + diff --git a/introduction-to-gnome/C/introduction-to-gnome.sgml b/introduction-to-gnome/C/introduction-to-gnome.sgml new file mode 100644 index 0000000..e255f39 --- /dev/null +++ b/introduction-to-gnome/C/introduction-to-gnome.sgml @@ -0,0 +1,1233 @@ + +
+ + Introduction to Gnome + + + Gnome + Documentation Team + + + + + This is a draft of Introduction to Gnome for Gnome 1.4 + + + + + 2000, 2001 + + Red Hat, Inc., David A. Wheeler, Alexander Kirillov + + + + + + 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 no Invariant + Sections, no Front-Cover Texts, and no Back-Cover Texts. You + may obtain a copy of the GNU Free Documentation + License from the Free Software Foundation by + visiting their Web + site or by writing to: Free Software Foundation, Inc., + 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. + + + Many of the names used by companies to distinguish their + products and services are claimed as trademarks. Where those + names appear in any Gnome documentation, and those trademarks + are made aware to the members of the Gnome Documentation + Project, the names have been printed in caps or initial caps. + + + + + + + + + What is Gnome? + + Gnome is a user-friendly graphical desktop environment for UNIX and + UNIX-like systems that enables users to easily use and configure + their computers. Gnome includes a panel (for starting + applications and displaying status), a desktop (where data and + applications can be placed), a set of standard desktop tools and + applications, and a set of conventions that make it easy for + applications to cooperate and be consistent with each other. + Users of other operating systems or environments should feel + right at home using the powerful graphics-driven environment + Gnome provides. Gnome runs on a number of UNIX-like operating + systems, including Linux, FreeBSD, and Solaris. + + Gnome is completely open source (free software) developed by + hundreds of programmers around the world. Both the source code + and ready-to-run binaries of Gnome are available for download on + the Internet; they are distributed under the terms of GNU General Public + License (and its cousins, Lesser General Public License and + Free Documentation + License for libraries and documentation + respectively). In particular, this means that everyone is free + to use, copy or distribute Gnome. If you would like to learn + more about the Gnome project please visit the Gnome web site. + + + Gnome is highly configurable, enabling you to set your desktop + the way you want it to look and feel. Gnome supports many human + languages, and more are added every month. Gnome even supports + several Drag and Drop protocols for maximum interoperability + with non-Gnome applications. + + + + Gnome comes from the acronym for the GNU Network Object Model + Environment (GNOME). Gnome is a part of the larger GNU project, + started in 1984 to develop a completely free UNIX-like operating + system. For more information, visit the GNU Website. + + + This guide describes Gnome 1.4 which the latest (as of February + 2001) release of Gnome. + + + + + About This Guide + + This guide gives you a short introduction to Gnome. It is not + intended to cover all details of Gnome; if you need more + information, you should read detailed manuals listed in . Also, this guide assumes you already have + Gnome installed; if you need help installing Gnome, please check + the instructions on Gnome Website. + + + + This guide was written by the members of Gnome + Documentation Project (GDP). If you have any comments or + suggestions about this guide + or if you can offer any other help in improving or translating + Gnome documentation, please send an e-mail to + docs@gnome.org, or visit GDP Web + Site. + + The authors of this guide assume that you are + using the default configuration of Gnome (that is, default GTK + theme and sawfish window manager with + MicroGUI theme). Gnome is highly + configurable, so it is easy to change not only the look but also + the behavior of Gnome; however, we recommend that you do so only + after you already have some experience with Gnome. + + + + + Mouse Conventions Used in This Guide + + Before describing Gnome, let us introduce some terms used not + only in this guide but in all Gnome documents. Most importantly, + we need to clarify the use of mouse buttons and clicks. + + + Most Gnome documents assume that you are using a standard (for + UNIX) 3-button mouse and talk about left, right, and middle + mouse buttons; if a document says click without + explicitly specifying the button, the left button is + assumed. Some documents use notations mouse button + 1, mouse button 2 and mouse button + 3 (or MB1, MB2, MB3 for short) for left, middle, and + right buttons respectively. + + + If you are using a two-button mouse, you can emulate the middle + mouse button by pressing left and right buttons simultaneoulsy; + if you have a wheel mouse, the wheel can be used in place of the + middle mouse button. + + + You can switch the roles of the buttons using Gnome + Control Center. Many left-handers choose to reverse the + right and left buttons. If you have done so, you need to use the + right mouse button whenever document instructs you to click, and use + left mouse button whenever a document talks + about right-clicking or mouse button 3. + + + If you use a mouse with some unusual placement of buttons, a + trackball, or some other input device, you need to find out + which buttons correspond to right, + left and middle; this information + can usually be found in the manual which came with your + device. Usually, left button (MB1) is the one + under your index finger. + + + + + + + + First glance at Gnome: Desktop and Panel + + shows an example of Gnome + running. Gnome is very configurable, so your screen may look + quite different. + + +
+ Sample Gnome Display. + + Sample Gnome Display + + + +
+ + + + Panel + + The long bar at the bottom of is + a Gnome Panel. It contains a number of useful things, such as + + + The Main Menu: this is the + button with the stylized footprint. Clicking this button + brings up a menu containing all Gnome applications + and commands, including the logout command. + + + + + Application launchers: these are buttons that start + various programs. For example, the toolbox button + starts the Gnome Control Center + (for configuring your system). + + + + + Panel applets: these are are tiny programs designed to + work inside the Panel. For example, the + clock applet on the far right + shows the current time, and + tasklist applet (in the + middle of the panel) shows the list of all application + windows on your desktop (this will be discussed in + detail in ). + + + + + As with all Gnome components, Panel is highly + configurable: you can add or remove application launchers and + applets, edit the Main Menu, change Panel + background, or even create new Panels. For example, to move an + object, drag it to the new location using the middle mouse button; to configure + an object, get help on it, or remove it from the Panel, + right-click on it and select the appropriate item from the + pop-up menu. To hide the Panel when you are + not using it, click on one of the Hide + buttons (with small arrows) at the ends of the + Panel. + + More Panel operations are available from the + Panel menu, which you can open by + right-clicking in any empty space on the Panel (for example, + in the hide arrows) and selecting Panel + from the menu. The Panel menu also contains Panel manual, which describes + all these options and more. + + + + Desktop + + Everything outside the Panel is called + desktop. You can place icons for files, applications, + and other items on the desktop (a default collection of icons is + installed with Gnome), after which you can double-click on an item + to use it: + + + + + If the item is a program, that program will start. + + + + + If it is a data file, the appropriate program will start + up with that data loaded. + + + + + + If it is a directory, the File Manager will start and show + the contents of that directory. Your desktop will probably + have a icon showing a house and labeled + yourname's + Home. Double-clicking on this icon will start + the File Manager at your home directory. + + + + + The easiest way to place an item on the desktop is to + drag-and-drop a file from the File Manager window. This will be + discussed in more detail in . Once + the item is placed on the desktop, you can move it around the + desktop using the left mouse button, or you can click on it + with the right mouse button to bring up the + pop-up menu which allows you to delete the + item or change its properties. + + + + + + Using the Mouse + + As you have already seen, you can do almost anything just by + clicking with your mouse. Here are some conventions which work + almost anywhere in Gnome: + + + + + Clicking on an item with the left mouse button selects + (hilights) it. If you need to select several objects, hold down + CTRL key while clicking. + + + Double-clicking on an item runs the default action for + this item (running an application, opening the file, etc.) + + + Clicking on an item with the right mouse button brings up + the context menu, which contains all the commands and + information available for this item. If you have selected + a group of items, right-clicking on any of them will bring + up the context menu which applies to all of these items. + + + You can + select text anywhere on the screen using the left mouse + button, and then insert this text into any other place on + the screen which accepts text input, by clicking with the + middle mouse button. + + + + In addition, clicking with the right mouse button on any empty + space on your desktop brings up a pop-up + menu, which allows you to change desktop background or other + properties, or add a new item to the desktop. Clicking on the + desktop with the middle mouse button produces the default menu + for your window manager (see ). + + + + + + Logging Out + + To log out of Gnome, click on the Main Menu + button and select Log out. Gnome + will prompt you for confirmation; it will also give you an + option to save the session — that is, information about + currently open applications and their location on the screen + will be saved, so that when you login next time, the same + applications will be in the same places (this only works for + applications which are fully Gnome-compliant). + + + + + + + + Working With Windows + + The graphical system used by all UNIX-like operating systems, X + Window System, allows you to have several windows on your + screen, with a different application running each in each + window. By itself, however, X Window System can only do very + low-level operations, so it is always used in conjunction with + another piece of software, called window manager. A window + manager provides windows' borders and buttons, allows you to + move, close, and resize windows, etc. Gnome can work with many + window managers. The most popular are: + + Enlightenment and + Sawfish (formerly known as + Sawmill). Each window manager can use many different styles of + window decorations and buttons (this is referred to as + window manager theme). Since it is impossible to + cover them all, in this section we only describe the default + window manager shipped with Gnome, + Sawfish, and its default theme + (MicroGUI). An example of the window border in + the MicroGUI theme is shown in + + + +
+ Window Border in MicroGUI Style. + + Window border in MicroGUI style + + + +
+ + + So, what can you do with windows? + + + + + Closing, minimizing, and maximizing windows + + + + To close a window, click on the button with the + small yellow x in the right side of the window + border. If the application has any unsaved data, it will + prompt you to save it. + + + To maximize a window, i.e. make it fill the entire + screen (except for the part taken by the panels), click + on the button with small yellow up + arrow. Clicking on this arrow once again will restore + the window to its original size. + + To minimize (hide or iconify) a window, click on the + button with small yellow down arrow. The + window will disappear from screen. However, it is not + lost forever — the application in this window continues + running, no data is lost — it is just temporarily + hidden. All minimized windows are shown in the tasklist + applet and can be restored as described below. + + A convenient alternative to minimizing windows is + shading them. When you shade a window, it + rolls up into its own title bar, so the + title bar is the only part of the window left on + screen. To shade a window, double-click on the title + bar; to unshade, double-click again. Try it! + + + + + + Raising and lowering windows + + + Windows on your screen can overlap, so that one of + the windows is on top of another. You can + raise a window (i.e., put it on top of + all others) by clicking on the window title bar. You can + also switch a window from raised to lowered and back by + clicking on the title bar with the middle mouse button, or by + clicking anywhere inside the window with the right mouse + button while holding down ALT key. + + + + + + Focus + + + Of all the windows on your screen, only one is active + (in computer parlance, focused), which means + that anything you type on the keyboard will be sent to the + application running in that window. (It does not mean that the + applications in other windows are idle — they can + be running as well.) To help you see which window has + focus, the title bar of this window has different color + (left side is blue, as opposed to gray for all other + windows). To change focus to another window, just click + anywhere in this window. You can also click in the + window title bar to focus and raise the window + simultaneously. + + + + + + Moving and resizing windows + + + To move a window, drag its title bar to a new + location using left mouse button (i.e., click in the + title bar and move the mouse without releasing the + button). You can also move a window by clicking anywhere + inside the window while holding down the + ALT key. + + + To resize a window, place the mouse cursor on any of the + window borders (except the top one) or corners. The + mouse cursor will change to an arrow pushing a line or + corner, allowing you to drag the border or corner to a new + position. + + + + + + + + Tasklist + + All the windows on your desktop (including the minimized ones) + are shown in the tasklist, located + on your Panel. For each window, a mini-icon and beginning of + the window title is shown. To restore a minimized window, just click + on its title in the tasklist. Right-clicking on the window + title brings up the pop-up menu whihc + allows you to shade a window, close it, or kill the + application running in the window. The last option should only + be used when an application is frozen and does not respond to + close window command. If you kill an + application, you lose all unsaved data! + + + + + Window Operations Menu + + Sawfish also provides a menu for + each window; this menu contains all the operations for this + window described above, and then some. To access this menu, + click on the button in the left side of the window title bar + (with the small triangle pointing down). You can also invoke + this menu by right-clicking in the window title or clicking + anywhere in the window with the middle mouse button while holding + down the ALT key. + + + + Desktop Menu + + Finally, Sawfish also provides a + desktop menu; it can be accessed by clicking on any + empty space of the desktop with the middle mouse button. It + contains the following options: + + + + + Windows + + + + Provides list of all windows, including minimized + ones. Selecting one of these windows restores it (if it + was minimized) and raises it over other windows. Very + convenient if you have so many windows that the one you + need is completely covered by others. + + + + + + Workspaces + + + Allows you to switch from one workspace to another, + create and delete workspaces. See + Sawfish manual for details. + + + + + + Programs + + + + Same as Programs section + of the Main Menu. + + + + + + Customize + + + + Allows the user to customize all properties of the + Sawfish behavior. For a new + user, we recommend trying various + Appearance settings, but leaving + all other subsections alone. + + + + + + Help + + + + Provides links to Sawfish web + page, Sawfish manual (beware: + this is not a user's manual but rather a manual for + people who write extensions/customizations to + Sawfish using LISP + programming language), link to Gnome Users + Guide, and to Gnome Web + site. + + + + + + + + + + + Nautilus: Gnome File Manager, Help Browser, and More + + Gnome 1.4 includes a graphical shell, + Nautilus. It combines file manager, + help browser, web browser, FTP client, and much more. To launch + it, select Nautilus in the + Main Menu, or just dpuble-click on any directory + icon on your desktop. + + + Managing Your Files With Nautilus + + + As most modern graphic file managers, + Nautilus shows the contents of a + selected directory using icons to represent files and + subdirectories. Double-clicking on any file or directory opens + it (for data files, it starts the appropriate application + which opens this file). Right-clicking on a file or directory + produces a pop-up menu. Using this menu, + you can delete or rename the file, view and change file + properties or permissions, and more. + + Nautilus also provides an easy + way to move files between directories. To move move a file + from one directory to another, open each directory in a + different Nautilus window by selecting + New window from the + Nautilus File menu. + Select the file you need, and drag it from one window into another + using the mouse. You can also drag a file or directory to the desktop. + + Nautilus provides many more + tools to manipulate your files. It is also highly + customizable, so you can easily change the way files are + displayed (for example, you can choose a custom icon for a + given file). For detailed description of all these + possibilities, read Nautilus manual. + + + + Reading Documentation With Nautilus + + In addition to being a file manager, + Nautilus is also a help browser: + you can use it to read documentation installed on your + system. This includes not only Gnome documentation, but also + UNIX-style manual pages (manpages), GNU info pages + (documentation format used GNU project utilities), and other + types of documentation. To view the list of all documentation + installed on your system, click on the + Help tab in the left panel of + Nautilus. + + + + + + + Customizing + + Gnome is highly configurable — you can change almost + anything: background color, key bindings, location of panels + and contents of the Main Menu, and more. + Most of these changes are done using Gnome Control + Center, which can be found in + Settings submenu of the Main + Menu; this menu also allows you to access a specific + section of the Gnome Control Center. + The Control Center has its own + detailed documentation which you should consult before making + any changes. + + + Here we would like to give just an overview of the most commonly + used options of the Gnome Control + Center. + + + + Background + + + You can change the desktop background by selecting + Background in the + Desktop section of Gnome + Control Center. (A quicker alternative to + access this section is to right-click on any empty space on + your desktop and select Change Desktop + Background from the pop-up + menu). + + + + + Theme Selector + + + + Theme Selector allows you to change the + desktop theme (also known as GTK theme). This changes the + appearance of the Main Menu, as well as + menus, toolbars, scrollbars, checkbuttons and other elements + of graphical user interface for all Gnome applications. Many + users find the default GTK theme rather dull, so the first + thing they do is switching to another one. + + + + + Sawfish window manager + + + + This section + allows you to change settings for the window manager. In + particular, in the Appearance + subsection you can change the frame style (theme), which + determines the window borders and buttons. You can also + change the font used for window title bars. If you + are a new user, we recommend that you do not change + other settings. + + + + + Session + + + + In this section you can define + the startup programs (that is, programs that are run every + time you log in), enable or disable login hints and logout + confirmation dialog. + + + + + + In addition, you can change properties of various items — + most notably, panels and icons on your desktop — by + clicking on them with the right mouse button and selecting + Properties from the + pop-up menu. In this way, you can change the + caption of an icon, size and background color (or even + background image) of the Panel, and much more. + + + + Almost every Gnome application has its own + preferences settings (look for + Preferences or Settings in + the menus), so you can change, for example, colors used by the Gnome + Terminal or make it transparent — the possibilities are + unlimited! + + + + + + Gnome Applications and Utilities + + Gnome comes with many applications and utilities; in addition, + Gnome allows you to use any third party applications such as + Netscape), KDE applications, or other + applications and utilities installed on your system. Here is a + list of some of the most useful tools and applications which you + can find in Gnome's Main Menu (this is not a + complete list!) + + + + Applications + + + These include office and productivity applications + such as + + + Gnumeric + — a full-featured Excel-compatible spreadsheet + + + + AbiWord — a lightweight + word processing application + + + + Gnome Calendar to help + you manage your busy schedule + + + Several text editors, from simple and + easy to use gedit to the + (arguably) the most powerful text editor ever created, + Emacs (which is not a Gnome + appication) + + + + + + + + Graphics + + + + + Gimp — + image editing program for power users; rivals + Photoshop + + + Image viewers such as Eye of + Gnome, GQview and + xv + + + + + + + Utilities + + + Among other things, here you will find + + + Calculator + + + + Gnome Search + tool which you can use to find a file + on your system + + + + gfloppy for formatting + floppy disks + + + + GDictfor + looking up a word in one of the many dictionaries + freely available on the Internet + + + + + + + Multimedia + + + + Here you will find CD player, + Mixer (which also can be used + to adjust volume of your speakers), and an MP3 player + XMMS. + + + + + + System + + + + This submenu contains utilities for managing your + system. You can find out detailed information about your + processor, memory, and operating system using + System Info, check how much + space you have left on your disks using Gnome + DiskFree, or view all the processes (jobs) + which are currently running on your computer using + System monitor. In addition, + System monitor also shows you + load level for the processor and memory, and allows you to + kill a stalled or otherwise unwanted job. + + + This submenu also contains tools for managing software + installed on your system, namely + GnoRPM and Helix + Gnome Update (if you are using the + distribution of Gnome prepared by Helix Code, Inc.). + GnoRPM allows you to view all + software packages installed on your system (if you are + using a distribution of Linux based on RPM packages, such + as Red Hat, SuSe, or Mandrake); it also allows you to remove, + update, or install new packages. + Helix Gnome Update provides an + extremely easy, almost one-click, way to update your + Gnome installation. Both of these utilities , however, require + that you have system administrator (root) privileges. + + + And finally, the same submenu also contains various + terminal emulators (xterm, + Color xterm, + Gnome Terminal) letting you use + the most powerful (although not most user friendly) interface + ever created — the command line prompt. + + + + + Internet + + + + Here, you will find Netscape web + browser, X-Chat for Internet Relay + Chat (IRC), Gnome-ICU for talking + with other people using ICQ protocol, and + gftp which is a graphical tool + for FTP file transfers. Note that Gnome file manager, + Nautilus, also has built-in FTP + capabilities, so gftp is needed + only in those rare cases when you need something really + complicated (for example, transferring files using secure + version of FTP, based on ssh). + + + + + Games + + + + Lots of them — just try! + + + + + + + + + + + Help - I Am in Trouble! + + Everyone runs into trouble sooner or later. Here is some + advice on how to handle the most common problems: + + + + Killing a Stalled Application + + If an application is stalled or frozen — that is, if it + does not respond to your mouse clicks and keyboard commands, + you can either wait and hope that it wakes up, or kill it. If + you decide to kill it (NOTE: You will lose all unsaved data), + start the Gnome System monitor + (from System submenu of the + Main Menu), right-click on the frozen + application name, and select Kill + now. Using Gnome System + monitor also allows you to find and kill all + helper processes started by this application. + + + If a Gnome application freezes or crashes (unexpectedly dies) + repeatedly, you should file a bug report as described in . + + + + My Whole System Froze! + + If your whole system is frozen and is not responding, do not + hurry to push the reset button on the computer + — this is usually the worst solution. Most probably, it is + not the operating system itself that is frozen (UNIX systems are + known for stability), but just the graphical part, X Window + System. In this case, you can try to restart X Window System by + simultaneously pressing + + CTRL-ALT-Backspace. + This should work for + the implementation of X Window system used on Linux and *BSD, + XFree86 — unless it was disabled by your system + administrator. Of course, in this way you also lose all unsaved + data, but at least you do not risk to mess up the whole file + system. + + + + + + + My Whole Gnome Configuration is Messed Up! + + If you have more serious problems than just desktop icons — + for example, if your panel is missing — the radical solution + is to remove all your Gnome configuration files and start from + scratch. This is an emergency solution, as you lose all + configuration settings and will need to configure your menus, + panels, etc. again from scratch, that is, from the default Gnome + configuration. However, this only affects Gnome configuration, + so your data files and settings for non-Gnome applications + remain intact. + + To remove all your Gnome configuration files and return + to the original Gnome configuration, logout then log in again + holding down keys CTRL and + SHIFT (immediately after entering your + password in the login dialog). You will be presented a dialog, + offering you the choice to reset the saved session (that is, + which applications were open when you last logged out); reset + your Gnome configuration settings; or both. + + + Finally, if you have really severe problems and your system + freezes or becomes otherwise unusable as soon as you login, + you have one last option. You can select + Failsafe session type instead of + the default Gnome in the login + screen. Both Gnome and KDE Login Managers support this. In + this session type, Gnome is not started; instead, you are + presented with a single terminal window. This is almost + guaranteed to start OK, and if you know how to use + command-line tools to find and fix your problem, you have a + chance. Otherwise, ask an expert. + + + + + + + Where to Find More Information + + Documentation Included with Gnome + + Gnome includes detailed documentation for the majority + of applications, utilities and other components, such as Panel + or Nautilus file manager. You can view the list of all Gnome + documents installed on your system using the Help + Contents tab in Nautilus. So, if you want to + know more about one of these components, read the appropriate + manual. + + + In addition to the manuals for individual components, Gnome + documentation also includes: + + + + + + Frequently Asked Questions + + + + This document contains answers to some of the most + commonly asked questions about Gnome. + + + + + + + If you are new to UNIX/Linux... + + + + + This short document gives the minimal necessary + information about UNIX and UNIX-like operating systems, + including such things as filenames, paths and + directories, permissions, symbolic links and most + confusing of them all, the notion of + mounting. If you never used UNIX system + before, be sure to read this. + + + + + + Glossary + + + Gives brief explanation of some of computer-related + terms you may see in Gnome documentation, from ASCII to X + Window System. + + + + + + + Gnome Resources on the Internet + + In addition to documentation shipped with Gnome, there is also + wealth of information available on the Internet. A good + starting point is, of course, the Gnome Website. There you + will find instructions for installing Gnome, reviews and tips, + developer information, and more. + + + If you can not find an answer to your question there, you + may ask other Gnome users and developers on Gnome mailing list + (subscription instructions can be found here). + Note, however, that this list is for Gnome-related questions + only (do not ask how to configure X Window System, for instance), + and it is impolite (to say the least) to ask a question without + first checking if this question is already answered in available + documents such as Gnome FAQ. + + + + Everything Not Gnome + + You should realize that Gnome is just part of your computer + system. If you want to unleash the full potential of your + computer, you need to understand not just Gnome but also the + underlying operating system (UNIX/Linux/FreeBSD), various + tools and utilities included with it, and its graphics system + (X Window System). Each of these components usually comes with + its own documentation. Most of UNIX commands and utilities are + documented in so-called manual pages, or man pages + for short. You can view them using Nautilus + (see ). This documentation is usually + very detailed and more technical than most users would like. + Another documentation format used by utilities from the + GNU project is called info pages. They, too, + can be viewed using Nautilus. Many + applications also have documentation in other formats. Sometimes + it is not easy to find documentation for a given application — + try looking in the directory /usr/doc. + + Documentation for operating system itself varies from one + system to another. The best advice is to check the printed manual + which came with your system. For Linux, a good source of information + is the Linux Documentation Project (LDP); you can read or their + documentation on the Internet (at http://www.linuxdoc.org). + Virtually all Linux distributions also include copies of LDP + documents; usually they are found at + /usr/doc/LDP or + /usr/doc/HOWTO. + + + And of course, there are a number of books available about all + flavors of UNIX/Linux, Gnome, and about anything else you might + be interested in. Check your local bookstore. + + + + + Feedback + + If you have any comments, suggestions, or complaints about this + guide, please send them to Gnome Documentation project at + docs@gnome.org. + + + If you find a bug in one of Gnome applications, please report + it! The developers do read these reports and try to fix all + reported bugs. The easiest way to send a bug report is to use + Gnome Bug Report Tool, found in the + Utilities submenu of the Main + Menu. This tool will be automatically started if a + Gnome application crashes. It should also be used for submitting + suggestions or requests for new features for Gnome applications: + just select Severity: enhancement in the + appropriate window of Gnome Bug Report + Tool. + + + If you have questions about Gnome, or want to discuss Gnome + with other users and developers, you should subscribe to the + Gnome mailing list as described in . + + +
+ + + + + + + + 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: .sgml +# lang This is the document locale +# omffile This is the name of the OMF file. Convention is to name +# it -.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) -- cgit