From 0b1e68cb22f92bfe82b3fcbca4d57814cc26ad4f Mon Sep 17 00:00:00 2001 From: Aaron Weber Date: Thu, 21 Sep 2000 18:14:44 +0000 Subject: Switched to the "official" FSF markup. I will have to make changes to the 2000-09-21 Aaron Weber * C/evolution-guide.sgml: Switched to the "official" FSF markup. I will have to make changes to the markup-- adding ids, etc, or switch to another version of the markup. Pending discussion by GDP. * C/apx-authors.sgml: Changed Matt Loper's email address to loper.org; added Jeff Stedfast and Peter Williams to authors list, realphebetized. * C/config-prefs.sgml: Revision to reflect current options labelling. * C/evolution-guide.sgml: Changes to part intros. * C/preface.sgml: Spelling and menu fixes. Will need more work tomorrow. svn path=/trunk/; revision=5540 --- help/C/apx-authors.sgml | 32 +- help/C/apx-fdl.sgml | 1118 ++++++++++++++++++------------------------- help/C/config-prefs.sgml | 227 +++++---- help/C/evolution-guide.sgml | 14 +- help/C/preface.sgml | 36 +- help/ChangeLog | 17 + 6 files changed, 649 insertions(+), 795 deletions(-) (limited to 'help') diff --git a/help/C/apx-authors.sgml b/help/C/apx-authors.sgml index b07f236b8b..89f0dd6bc5 100644 --- a/help/C/apx-authors.sgml +++ b/help/C/apx-authors.sgml @@ -4,26 +4,28 @@ Evolution was written by: Seth Alves: alves@helixcode.com - Anders Carlssonandersca@gnu.org - Damon Chaplin:damon@helixcode.com - Clifford R. Conover rusty@zootweb.com + Anders Carlsson: andersca@gnu.org + Damon Chaplin: damon@helixcode.com + Clifford R. Conover: rusty@zootweb.com Miguel De Icaza: miguel@helixcode.com - Arturo Espinoza arturo@nucleu.unam.mx + Radek Doulik: rodo@helixcode.com + Arturo Espinoza: arturo@nucleu.unam.mx Larry Ewing: lewing@helixcode.com Bertrand Guiheneuf: bertrand@helixcode.com Tuomas Kuosmanen: tigert@gimp.org Christopher J. Lahey: clahey@helixcode.com - Matthew Loper: matt@helixcode.com - Federico Mena: federico@helixcode.com - Eskil Heyn Olsendeity@eski.dk - Nat Friedman: nat@helixcode.com - Ettore Perazzoli:ettore@helixcode.com - Russell Steinthal: rms39@columbia.edu - Peter Teichman: peter@helixcode.com - Chris Toshok: toshok@helixcode.com - Radek Doulik: rodo@helixcode.com - Dan Winship: danw@helixcode.com - Michael Zucchi: notzed@helixcode.com + Matthew Loper: matt@loper.org + Federico Mena: federico@helixcode.com + Eskil Heyn Olsen: deity@eski.dk + Nat Friedman: nat@helixcode.com + Ettore Perazzoli: ettore@helixcode.com + Jeffrey Stedfast: jeff@helixcode.com + Russell Steinthal: rms39@columbia.edu + Peter Teichman: peter@helixcode.com + Chris Toshok: toshok@helixcode.com + Peter Williams: peter@newton.cx + Dan Winship: danw@helixcode.com + Michael Zucchi: notzed@helixcode.com and other dedicated GNOME programmers. diff --git a/help/C/apx-fdl.sgml b/help/C/apx-fdl.sgml index 8b49729cfc..17a3bf3070 100644 --- a/help/C/apx-fdl.sgml +++ b/help/C/apx-fdl.sgml @@ -1,678 +1,466 @@ - GNU Free Documentation License - - Version 1.1, March 2000 - - - - Copyright © 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. - +GNU Free Documentation License + + + + + + 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. +
+ + + 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. + + + + 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. + + + + 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. + + + + 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. + + + + 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: + + + 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. - - - 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. - + + 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). - - - - 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. - + + State on the Title page + the name of the publisher of the Modified Version, as the + publisher. - - - - 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. - + + Preserve all the + copyright notices 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 - . - + + Add an appropriate + copyright notice for your modifications adjacent to the other + copyright notices. - - - - 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." - + + 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. - - - - 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. - + + Preserve in that license + notice the full lists of Invariant Sections and required Cover + Texts given in the Document's license notice. - - - - 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. - + + Include an unaltered + copy of this License. - - - - 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. - + + 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. - - - - 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. - + + 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. - - - - 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. - + + 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. + + + 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. + + + Delete any section + entitled "Endorsements". Such a section may not be included in + the Modified Version. - - - - Addendum - - - 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 © 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. - + + Do not retitle any + existing section as "Endorsements" or to conflict in title with + any Invariant Section. - - - \ No newline at end of file + + + 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. + + + + 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." + + + + 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. + + + + 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. + + + + 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. + + + + 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. + + + + 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. + + + + 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/help/C/config-prefs.sgml b/help/C/config-prefs.sgml index fa3e118a15..7119f13580 100644 --- a/help/C/config-prefs.sgml +++ b/help/C/config-prefs.sgml @@ -14,21 +14,20 @@ Mail Settings - To change your mail settings, first go to your - Inbox. Then select Mail - Settings from the Tools menu. - This will open the mail preferences - window, illustrated in . Mail Preferences are - separated into several categories: + To change your mail settings, select + Settings Mail + configuration in the Inbox. This + will open the mail preferences window, + illustrated in . Mail + preferences are separated into several categories: - Identity + Identies - This allows you to set - your name, email address, and other information. The - default values are the ones found on your system account. + This allows you to create and alter one or more + identities for your email: your name, address, and so + forth. @@ -36,16 +35,19 @@ Sources - Set your mail-checking protocols and servers here. + This tab lets you tell + Evolution where to get the + mail sent to you, and how to get it. - - Sources + + Mail Transport - Set your mail-checking protocols and servers here. + This tab lets you tell + Evolution how to send mail. @@ -54,21 +56,28 @@ News Servers - Specify your News Server preferences here. + If you would like to use + Evolution to read newsgroups, + you can secify your news server preferences here. - - + + Other + + + Miscellaneous mail and news settings, such as HTML + handling preferences, and how long + Evolution should wait before + marking message read. + + + + + @@ -86,19 +95,23 @@ Identity Settings - If you have only one email address, or use automatic - forwarding to funnel multiple addresses to one account, then - you will only need to configure one identity. You may, - however, want more that one. To alter an identity, click on - it in the Identity tab of the + If you have only one email account, or send email from only + one address, you will only need to configure one identity. If + you want, however, you can have multiple identities. This + can be useful if you want to keep personal and professional + email seperate. + + + To add a new identity, simply click + Add. To alter an existing identity, + click on it in the Identity tab of the Preferences window, and then click - Edit. To add a new identity, simply - click Add. + Edit. - In either case, you'll be presented with a dialog box with - four fields: + Evolution will then present you + with a dialog box containing four fields: @@ -131,7 +144,6 @@ - @@ -145,12 +157,9 @@ protocols your network uses, and the names of the servers you'll be using. If you're switching from another groupware or email program, you can almost certainly use the same - settings as you did with that program. Select the - Sources tab in the - Preferences window to tell - Evolution where you want to get - your mail, and click Transports to - determine how you want to send your mail. + settings as you did with that program. Network-related + settings are in the Mail Sources and + Mail Transport tabs. @@ -185,8 +194,10 @@ Username: - Enter your user name here. Eva Lucianne Tester's - user name is eltester. + Enter your user name here. This is often related to + your real name, but not always. Examples include + eltester and + rupert. @@ -194,48 +205,50 @@ Authentication: - Your system administrator will know which type of - authentication your system requires. - Evolution can also detect - what sorts of authentication are available once it - knows where to find the server. + Tell Evolution how to + verify your identity with the server. Your options + vary depending upon the type of server you are + using, and the ways it is configured. Given the + name of a server, + Evolution can detect what + sorts of authentication it offers. - Test values before continuing + Test Settings - If this box is checked, - Evolution will attempt to - make sure that all the other entries in the dialog - window are correct. + Click this button to have + Evolution check to see if + mail sources are configured correctly. - If you choose several mail sources, clicking - Get Mail will refresh any IMAP or + If you have several mail sources, clicking Get + Mail will refresh any IMAP or mbox listings and check and download all POP servers. In other words, Get Mail gets your mail, no matter how many sources you have, or what types they are. - + - Transports + Mail Transports - The Transports tab lets you set how - you will send mail. Evolution currently supports two mail - transport options: SMTP, which uses a - remote mail server, and sendmail, - which uses the sendmail program - on your local system. Sendmail - is more difficult to configure, but offers more flexibility - than SMTP. + The Mail Transports tab lets you set + how you will send mail. Evolution currently supports two + mail transport options: SMTP, which + uses a remote mail server, and + sendmail, which uses the + sendmail program on your local + system. Sendmail is more + difficult to configure, but offers more flexibility than + SMTP. To use SMTP, you'll need to enter the @@ -245,9 +258,8 @@ Evolution can attempt to determine if you have entered a valid server name. To - have it do so, check the box labelled Test these - values before continuing before you click - OK. + have it do so, click the Test + Settings button. @@ -255,18 +267,20 @@ News Servers Newsgroups are so much like mailing lists that there's no - reason not to have access to them right next to your mail. - When you first select the News - Servers tab, you will see a blank box with - three familiar buttons on the right: - Add, Edit, - and Delete. + reason not to keep them right next to your mail. When you + first select the News Servers tab, + you will see a blank box with the three familiar buttons + on the right: Add, + Edit, and + Delete. + Click Add to add a news server; you will be prompted for its name. Enter the name, click OK, and you're done. You can have as many mail servers as you like, of course. News servers - will appear next to your IMAP servers. + will appear next to your IMAP servers in the + folder bar. @@ -277,6 +291,7 @@ contains some miscellaneous configurations that don't have too much to do with each other. + Send messages in HTML format @@ -291,6 +306,17 @@ for more information about HTML mail. + + + Mark Messages as Seen After + + + When you click on a message, + Evolution will wait a + moment before marking it as seen. You can set the + delay, in milliseconds, here. + + Folder Format @@ -314,28 +340,14 @@ - - Managing the Contact Manager - - To set the behavior of your Contact Manager, click on the - Contact Manager tab in the - Preferences window. - - - You can set the following options: - - - - - Configuring the Calendar - - This section discusses calendar-specific preferences. While - looking at your calendar, select - Preferences from the - Edit menu. This will open up the - Preferences window. It contains four - tabs: Time display, + + Configuring the Calendar + + To set your calendar preferences, select + Settings + Calendar Configuration. This + will open up the Preferences window. + It contains four tabs: Time display, Colors, To Do List and Alarms. The calendar preferences window is illustrated in Evolution beep at you for any alarms you have set. If you leave this box unchecked, Evolution will only - alert you to events by opening a dialog box. + alert you to events by opening a dialog box. These beeps + are distict from full-fledged audio alarms. Audio alarms timeout after: - Select this button to have the beeping stop automatically - after a certain number of seconds. + Select this button to have your audio alarms stop + automatically after a certain number of seconds. Enable snoozing for: If you @@ -563,6 +576,22 @@ + + + Managing the Contact Manager + + To set the behavior of your Contact Manager, click on the + Contact Manager tab in the + Preferences window. + + + You can set the following options: + + + + + General Preferences diff --git a/help/C/evolution-guide.sgml b/help/C/evolution-guide.sgml index 0eff8b99a0..9cab3a8bf8 100644 --- a/help/C/evolution-guide.sgml +++ b/help/C/evolution-guide.sgml @@ -102,12 +102,14 @@ Evolution is highly configurable. Usually, when developers say that, they mean that they didn't - test it out thoroughly and have left it to other hackers to - "configure" themselves a working system. But in the case of - Evolution, you can expect that it - will work perfectly well with minimal setup hassle, and that - you can alter its behavior to fit your needs with just a - little more work. + test it out thoroughly and have left it to other programmers + to "configure" themselves a working system. But in the case + of Evolution, you can expect that + it will work perfectly well with minimal setup hassle, and + that you can alter its behavior to fit your needs with just a + little more work. This part of the book will describe that + process, from the quickest glimpse of the Setup Assistant to + an in-depth tour of the preferences dialogs. diff --git a/help/C/preface.sgml b/help/C/preface.sgml index cf40c03d37..5cceac51ea 100644 --- a/help/C/preface.sgml +++ b/help/C/preface.sgml @@ -14,9 +14,11 @@ informed. Evolution's goal is to make the tasks of storing, organizing, and retrieving information - easier, so you can work and cooperate with others. That is, + easier, so you can work and communicate with others. That is, it's a more evolved groupware program, - and an integral part of the Internet-connected desktop. + an integral part of the Internet-connected desktop. On the + inside, it's a powerful database; on the outside, it's a tool + to help you get your work done. Because it's part of the GNOME project, @@ -32,11 +34,12 @@ This is a preview release - Please help develop Evolution - by submitting bug reports when you find bugs. You can do - so by using the Bug Report - Tool (known as bug-buddy - at the command line). + Evolution is not complete, and + still has a lot of flaws. Please help improve it by + letting us know about them. You should do this by + submitting bug reports with the GNOME Bug + Report Tool (known as + bug-buddy at the command line). @@ -308,11 +311,11 @@ - Reply to a message Message + Reply to a Message Select the message to which you want to reply, and - click Click Reply in the + click Reply in the toolbar, or press FIXME @@ -328,7 +331,7 @@ Select the message you want to forward, and - click Click Forward in the + click Forward in the toolbar, or press FIXME @@ -339,6 +342,19 @@ + + Open a Message in a New Window + + + Double-click the message you want to view, or press + + Ctrl + O + + + + + Create Filters and vFolders diff --git a/help/ChangeLog b/help/ChangeLog index 9b98a70bb0..501a85e914 100644 --- a/help/ChangeLog +++ b/help/ChangeLog @@ -1,3 +1,20 @@ +2000-09-21 Aaron Weber + + * C/evolution-guide.sgml: Switched to the "official" FSF markup. + I will have to make changes to the markup-- adding ids, etc, or + switch to another version of the markup. Pending discussion by + GDP. + + * C/apx-authors.sgml: Changed Matt Loper's email address to + loper.org; added Jeff Stedfast and Peter Williams to authors list, + realphebetized. + + * C/config-prefs.sgml: Revision to reflect current options labelling. + + * C/evolution-guide.sgml: Changes to part intros. + + * C/preface.sgml: Spelling and menu fixes. Will need more work tomorrow. + 2000-09-20 Aaron Weber * C/config-prefs.sgml: Fixed sig stuff here and in setupassist. -- cgit v1.2.3