alexandria-book-collection-manager 0.6.9.pre1

data/share/gnome/help/alexandria/C/bugs.xml

@@ -0,0 +1,18 @@
+<!-- 
+  This is part of the Alexandria Manual.
+  Copyright (C)  2005  Liam Davison
+  Copyright (C)  2007  Cathal Mc Ginley
+  See the file alexandria.xml for copying conditions.
+-->
+
+<!-- ============= Bugs ================================== -->
+<!-- This section is optional and is commented out by default. 
+     You can use it to describe known bugs and limitations of the 
+	  program if there are any - please be frank and list all
+     problems you know of. 
+  
+  <section id="alexandria-bugs">
+  <title>Known Bugs and Limitations</title>
+  <para> </para>
+ </section>
+-->

data/share/gnome/help/alexandria/C/editing-book-properties.xml

@@ -0,0 +1,124 @@
+<!-- 
+  This is part of the Alexandria Manual.
+  Copyright (C)  2005  Liam Davison
+  Copyright (C)  2007  Cathal Mc Ginley
+  See the file alexandria.xml for copying conditions.
+-->
+
+<!-- ============= Editing Book Properties Subsection =========== -->
+
+<section id="editing-book-properties">
+  <title>Editing Book Properties</title>
+  <para>You can use &app; to edit and update your book information:
+  <itemizedlist>
+    <listitem><para><xref linkend="editing-info"/></para></listitem>
+    <listitem><para><xref linkend="changing-cover-image"/></para></listitem>
+    <listitem><para><xref linkend="loaning-books"/></para></listitem>
+    <listitem><para><xref linkend="editing-notes"/></para></listitem>
+  </itemizedlist></para>
+
+  <!-- ======== Editing information ========= -->
+  <section id="editing-info">
+    <title>Editing basic information</title>
+    <para>To edit a book, simply double-click on the book image in the
+    main window, or choose
+    <menuchoice><guimenu>Library</guimenu><guimenuitem>Properties</guimenuitem></menuchoice>.
+    The following window will appear, where you can change the books'
+    Title, ISBN, Authors, Publisher, Binding and Rating.</para>
+    <figure id="editing-info-fig">
+      <title>Editing a book with &app;</title>
+      <screenshot>
+	<mediaobject>
+	  <imageobject>
+	    <imagedata fileref="figures/editing_book_properties_info.png" format="PNG"/>
+	  </imageobject>
+	  <!-- EPS versions of the figures are not required at the moment. -->
+	  <!-- 
+	       <imageobject>
+	       <imagedata fileref="figures/image.eps" format="EPS"/>
+	       </imageobject>
+	  -->
+	  <textobject>
+	    <phrase>Shows &app; editing a book.</phrase>
+	  </textobject>
+	</mediaobject>
+      </screenshot>
+    </figure>
+    <para>To add a author, click on the <guibutton>+</guibutton> next
+    to the author list, then type the new name. To remove an author,
+    select the name and click <guibutton>-</guibutton>. To edit a
+    name, click twice on the name.</para>
+    <tip><para>You can rate a book by clicking on the stars. To clear the rating, click on the space immediately to the left of the first star. Your favourite books - those with five stars - will have a small heart icon in the Icon view of the main window.</para></tip>
+  </section>
+
+  <!-- ======== Editing from list view ========= -->
+  <section id="editing-from-list-view">
+    <title>Editing from the List View</title>
+
+    <para>You can change the properties for Read, Own and Want from
+    the List View by clicking on the check box for the given
+    property. As in the book properties dialog, however, clicking on
+    Want will have no effect if Own is selected.</para>
+
+    <para>A book's Rating is not editable directly from the List View
+    simply by clicking on the rating stars. However, right-clicking
+    from either the List or Icon View will bring up a popup menu, from
+    which you can change the Rating of a book. </para>
+
+  </section>
+
+  <!-- ======== Changing cover images ========= -->
+  <section id="changing-cover-image">
+    <title>Changing cover images</title>
+    <para>To supply a book cover image, click on the existing cover
+    image (or the image of a book if no cover is available). A
+    standard file selection dialog will open. Navigate to the cover
+    image file on your system - which can be in JPEG, PNG or GIF
+    format - and click <guibutton>Open</guibutton>. The image will be
+    scaled to fit into the <guilabel>Edit Book</guilabel>
+    dialog.</para>
+  </section>
+
+  <!-- ======== Loaning books ========= -->
+  <section id="loaning-books">
+    <title>Loaning books</title>
+    <para>To mark a book as loaned, firstly open the Edit Book dialog
+    as in <xref linkend="editing-info"/>. Then click on the
+    <guilabel>Loaning</guilabel> tab. Click on the <guilabel>This book
+    is loaned</guilabel> checkbox to mark the book as loaned. You can
+    fill in the <guilabel>To</guilabel> field to specify who the book
+    is loaned to. And click on the <guilabel>Since</guilabel>
+    drop-down menu to specify the date the book was loaned on.</para>
+    <figure id="loaning-fig">
+      <title>Loaning a book in &app;</title>
+      <screenshot>
+	<mediaobject>
+	  <imageobject>
+	    <imagedata fileref="figures/editing_book_properties_loaning.png" format="PNG"/>
+	  </imageobject>
+	  <!-- EPS versions of the figures are not required at the moment. -->
+	  <!-- 
+	       <imageobject>
+	       <imagedata fileref="figures/image.eps" format="EPS"/>
+	       </imageobject>
+	  -->
+	  <textobject>
+	    <phrase>Shows &app; loaning a book.</phrase>
+	  </textobject>
+	</mediaobject>
+      </screenshot>
+    </figure>
+  </section>
+
+  <!-- ========== Adding notes ========== -->
+  <section id="editing-notes">
+    <title>Adding and editing notes</title>
+    <para>&app; allows you to store addition notes about your books -
+    maybe a personal review, or useful page references. To add or edit
+    a note, firstly open the Edit Book dialogue as in <xref
+    linkend="editing-info"/>. Then click on the
+    <guilabel>Notes</guilabel> tab. You can type your plain-text notes
+    in this field.</para>
+  </section>
+
+</section>

data/share/gnome/help/alexandria/C/exporting.xml

@@ -0,0 +1,81 @@
+<!-- 
+  This is part of the Alexandria Manual.
+  Copyright (C)  2005  Liam Davison
+  Copyright (C)  2007  Cathal Mc Ginley
+  See the file alexandria.xml for copying conditions.
+-->
+
+<!-- ============= Exporting information Subsection ============= -->
+
+<section id="exporting">
+  <title>Exporting Information</title>
+  <para>Information in &app; can be exported for use in other applications. Information can be exported in several formats:
+  <itemizedlist>
+    <listitem><para><xref linkend="exporting-as-onix"/></para></listitem>
+    <listitem><para><xref linkend="exporting-as-Tellico"/></para></listitem>
+    <listitem><para><xref linkend="exporting-as-bibtex"/></para></listitem>
+    <listitem><para><xref linkend="exporting-as-plaintext"/></para></listitem>
+    <listitem><para><xref linkend="exporting-as-web-page"/>, using XHTML and CSS stylesheets</para></listitem>
+  </itemizedlist>
+  </para>
+
+  <section id="exporting-as-onix">
+    <title>Exporting as a compressed ONIX archive</title>
+
+    <para>
+      ONIX is an international standard used by publishers
+      and retailers to define information - title, price,
+      contributors, reviews and many others - about
+      books. For more information about ONIX and its uses,
+      see <ulink url="http://www.editeur.org/"
+      type="http">http://www.editeur.org/</ulink> .</para>
+
+      <para>&app; can gather up all your book information and export it as an archived (.tar.bz2) collection of ONIX files (called ONIX messages). To export your library as an ONIX archive, choose <menuchoice><guimenu>Library</guimenu><guimenuitem>Export</guimenuitem></menuchoice> from the main menu, then choose <guimenuitem>Archived ONIX XML (.onix.tbz2)</guimenuitem> from the <guilabel>Export format</guilabel> menu. Specify a file name and a location to save the archive, and press <guibutton>Export</guibutton>.</para>
+  </section>
+
+  <section id="exporting-as-Tellico">
+    <title>Exporting as a compressed Tellico file</title>
+    <para>Tellico is a standard file format, based on XML, for storing information about book and other collections. &app; can both import and export information in the Tellico format.</para>
+    <para>To export your library as a compressed (.tc) file, choose <guimenuitem>Archived Tellico XML (.tc)</guimenuitem> from the <guilabel>Export format</guilabel> menu in the Export dialogue.</para>
+  </section>
+
+  <section id="exporting-as-bibtex">
+    <title>Exporting as a BibTeX file</title>
+    <para>BibTeX is a LaTeX based file format for storing bibliographic information.</para>
+    <para>To export your library as a BibTeX (.bib) file, choose <guimenuitem>BibTeX (.bib)</guimenuitem> from the <guilabel>Export format</guilabel> menu in the Export dialogue.</para>
+  </section>
+
+  <section id="exporting-as-plaintext">
+    <title>Exporting a list of ISBNs</title>
+    <para>&app; can export a plain test list of ISBNs - perhaps to transfer to another machine. To export a list of ISBNs, choose <guimenuitem>ISBN list (.txt)</guimenuitem> from the <guilabel>Export format</guilabel> menu in the Export dialogue.</para>
+  </section>
+
+  <section id="exporting-as-web-page">
+    <title>Exporting a library as a web page</title>
+    <para>&app; can create a web page from your book library, listing each book complete with cover images. To do this, it creates a directory of images, an XHMTL web page, and a CSS stylesheet. You can choose from different stylesheets to customise the appearance of the web page.</para>
+    <para>To export your library as a web page, <menuchoice><guimenu>Library</guimenu><guimenuitem>Export</guimenuitem></menuchoice> from the main menu, then choose <guimenuitem>HTML Web Page (directory)</guimenuitem> from the <guilabel>Export format</guilabel> menu. Choose a style - or theme - for the web page from the <guimenuitem>Theme</guimenuitem> menu.</para>
+    <figure id="export-as-web-page-fig">
+      <title>Using &app; to create a web page</title>
+      <screenshot>
+	<mediaobject>
+	  <imageobject>
+	    <imagedata fileref="figures/exporting_information_html.png" format="PNG"/>
+	  </imageobject>
+	  <!-- EPS versions of the figures are not required at the moment. -->
+	  <!-- 
+	       <imageobject>
+	       <imagedata fileref="figures/image.eps" format="EPS"/>
+	       </imageobject>
+	  -->
+	  <textobject>
+	    <phrase>Shows &app; exporting a library as a web page.</phrase>
+	  </textobject>
+	</mediaobject>
+      </screenshot>
+    </figure>
+    <para>Type in a name for the directory the web page will be saved in, and press the <guibutton>Export</guibutton> to save the files.</para>
+    <tip>
+      <para>Only one theme, called Clean, is available at present.</para>
+    </tip>
+  </section>
+</section>	

data/share/gnome/help/alexandria/C/getting-started.xml

@@ -0,0 +1,154 @@
+<!-- 
+  This is part of the Alexandria Manual.
+  Copyright (C)  2005  Liam Davison
+  Copyright (C)  2007  Cathal Mc Ginley
+  See the file alexandria.xml for copying conditions.
+-->
+
+<!-- =========== Getting Started ============================== -->
+<!-- Use the Getting Started section to describe the steps required
+     to start the application and to describe the user interface components
+     of the application. If there is other information that it is important
+     for readers to know before they start using the application, you should
+     also include this information here. 
+     If the information about how to get started is very short, you can 
+     include it in the Introduction and omit this section. -->
+<section id="getting-started">
+  <title>Getting Started</title>
+  <section id="start">
+    <title>To Start &app;</title>
+    <para>You can start <application>&app;</application> in the following ways:
+    </para>
+    <variablelist>
+      <varlistentry>
+	<term><guimenu>Applications</guimenu> menu</term>
+	<listitem>
+	  <para>Choose 
+	  <menuchoice>
+	    <guisubmenu>Office </guisubmenu>
+	    <guimenuitem>Alexandria Book Collection Manager</guimenuitem>
+	  </menuchoice>. </para>
+	</listitem>
+      </varlistentry>
+      <varlistentry>
+	<term>Command line</term>
+	<listitem>
+	  <para>To start <application>&app;</application> from a command line, type the following command, 
+	  then press <keycap>Return</keycap>:</para>
+	  <para> 
+	    <command>alexandria</command> 		
+	  </para>
+	</listitem>
+      </varlistentry>
+    </variablelist>
+    <para>&app; will open the most recently accessed library.</para>
+    
+  </section>
+  <section id="when-start">
+    <title>When You Start &app;</title>
+    <para>When you start <application>&app;</application>, the following window is displayed.</para>
+    <!-- ==== Figure ==== -->
+    <figure id="mainwindow-fig">
+      <title>&app; Start Up Window</title>
+      <screenshot>
+	<mediaobject>
+	  <imageobject>
+	    <imagedata fileref="figures/getting_started_first_launched.png" format="PNG"/>
+	  </imageobject>
+	  <!-- EPS versions of the figures are not required at the moment. -->
+	  <!-- 
+	       <imageobject>
+	       <imagedata fileref="figures/image.eps" format="EPS"/>
+	       </imageobject>
+	  -->
+	  <textobject>
+	    <phrase>Shows &app; main window. Contains titlebar,
+	    menubar, toolbar, library list (including smart library
+	    list) and an empty book display area. Menubar contains Library,
+	    Edit, View and Help menus. </phrase>
+	  </textobject>
+	</mediaobject>
+      </screenshot>
+    </figure>
+
+    <!-- ==== End of Figure ==== -->
+    <!-- Include any descriptions of the GUI immediately after the screenshot of the main UI, -->
+    <!-- for example, the items on the menubar and on the toolbar. This section is optional. -->
+
+    <para>The &app; window contains the following elements:</para>
+
+    <variablelist>
+      <varlistentry>
+	<term>Menubar:</term>
+	
+	<listitem>
+	  <para>
+	    The menus on the menubar contain all of the commands you need
+	    to work with libraries and books in &app;.
+	  </para>
+	</listitem>
+      </varlistentry>
+      <varlistentry>
+	<term>Toolbar:</term>
+	<listitem>
+	  <para>The toolbar contains buttons to quickly add new books and
+	  libraries to <application>&app;</application>, plus a search
+	  tool to filter books displayed in the main display area.</para>
+	</listitem>
+      </varlistentry>
+      
+      <varlistentry>
+	<term>Library List:</term>
+	
+	<listitem>
+	  <para>
+	    The library list pane at the left edge of the window
+	    displays the different libraries which have been set up in
+	    &app;. Below the main libraries, there is a list of
+	    <quote>smart libraries</quote> which are a kind of
+	    filtered view on the main libraries.
+	  </para>
+
+	  <para>When &app; starts for the first time, it creates a
+	  library called <quote>My Library</quote>, and a set of
+	  useful smart libraries.</para>
+	  
+	</listitem>
+      </varlistentry>
+
+      <varlistentry>
+	<term>Book display:</term>
+	
+	<listitem>
+	  <para>
+	    The main part of the display lists all the books in the
+	    current library. <application>&app;</application> can display
+	    your books either in an Icon or List view - the List View,
+	    similar to that used in the
+	    <application>Nautilus</application> file manager, displays
+	    detailed information about each book on separate lines.
+	  </para>
+	  
+	  <para>
+	    In the icon view, your favourite books - rated with five stars
+	    - will be shown with a heart icon in the top corner.
+	  </para>
+	</listitem>
+      </varlistentry>
+      
+      <varlistentry>
+	<term>Statusbar:</term>
+	
+	<listitem>
+	  <para>
+	    The statusbar displays information about the current
+	    library in <application>&app;</application>, including
+	    the number of books, and the number of books which have
+	    not been rated.
+	  </para>
+	</listitem>
+      </varlistentry>
+    </variablelist>
+    
+  </section>
+</section>

data/share/gnome/help/alexandria/C/gnu-fdl-1.2.xml

@@ -0,0 +1,543 @@
+<!-- 
+  Copyright (C) 2000,2001,2002  Free Software Foundation, Inc.
+  51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
+  Everyone is permitted to copy and distribute verbatim copies
+  of this license document, but changing it is not allowed.
+-->
+<appendix id="gfdl">
+  <title>GNU Free Documentation License</title>
+  <subtitle>Version 1.2, November 2002</subtitle>
+  <para>
+    Copyright &copy; 2000, 2001, 2002 Free Software
+    Foundation, <abbrev>Inc.</abbrev>
+    <address>
+      <street>51 Franklin <abbrev>St</abbrev>, Fifth Floor</street>, 
+      <city>Boston</city>, 
+      <state><abbrev>MA</abbrev></state> <postcode>02111-1307</postcode>
+      <country><abbrev role="initialism">USA</abbrev></country>
+    </address>
+
+    Everyone is permitted to copy and distribute verbatim copies of
+    this license document, but changing it is not allowed.
+  </para>
+  
+  <appendixinfo>
+    <title>GNU Free Documentation License</title>
+    <releaseinfo>
+      Version 1.2, November 2002
+    </releaseinfo>
+    
+    <copyright>
+      <year>2000</year>
+      <year>2001</year>
+      <year>2002</year>
+      <holder>Free Software Foundation, <abbrev>Inc.</abbrev></holder>
+    </copyright>
+
+    <corpauthor>
+      <surname>Free Software Foundation</surname>
+    </corpauthor>
+    
+    <legalnotice id="legalnotice">
+      <para>
+	Everyone is permitted to copy and distribute verbatim copies
+	of this license document, but changing it is not allowed.
+      </para>
+    </legalnotice>
+    
+  </appendixinfo>
+
+
+  <section id="Preamble" label="0. ">
+    <title>PREAMBLE</title>
+    <para>
+      The purpose of this License is to make a manual, textbook, or other
+      functional and useful 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.
+    </para>
+    <para>
+      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.
+    </para>
+    <para>
+      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.</para>
+  </section>
+  <section id="Definitions" label="1. ">
+    <title>APPLICABILITY AND DEFINITIONS</title>
+    <para>
+      This License applies to any manual or other work, in any medium, that
+      contains a notice placed by the copyright holder saying it can be
+      distributed under the terms of this License.  Such a notice grants a
+      world-wide, royalty-free license, unlimited in duration, to use that work
+      under the conditions stated herein.  The "Document", below, refers to any
+      such manual or work.  Any member of the public is a licensee, and is
+      addressed as "you".  You accept the license if you copy, modify or
+      distribute the work in a way requiring permission under copyright
+      law.
+    </para>
+    <para>
+      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.
+    </para>
+    <para>
+      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.  (Thus, 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.
+    </para>
+    <para>
+      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.  If a section does not
+      fit the above definition of Secondary then it is not allowed to be
+      designated as Invariant.  The Document may contain zero Invariant
+      Sections.  If the Document does not identify any Invariant Sections then
+      there are none.
+    </para>
+    <para>
+      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 Front-Cover Text may be at
+      most 5 words, and a Back-Cover Text may be at most 25 words.
+    </para>
+    <para>
+      A "Transparent" copy of the Document means a machine-readable copy,
+      represented in a format whose specification is available to the general
+      public, that is suitable for revising the document 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, or absence of markup,
+      has been arranged to thwart or discourage subsequent modification by
+      readers is not Transparent.  An image format is not Transparent if used
+      for any substantial amount of text.  A copy that is not "Transparent" is
+      called "Opaque".
+    </para>
+    <para>
+      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,
+      PostScript or PDF designed for human modification.  Examples of
+      transparent image formats include PNG, XCF and JPG.  Opaque formats
+      include 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, PostScript or PDF produced by some word processors for output
+      purposes only.
+    </para>
+    <para>
+      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.
+    </para>
+    <para>
+      A section "Entitled XYZ" means a named subunit of the Document whose title
+      either is precisely XYZ or contains XYZ in parentheses following text that
+      translates XYZ in another language.  (Here XYZ stands for a specific
+      section name mentioned below, such as "Acknowledgements", "Dedications",
+      "Endorsements", or "History".)  To "Preserve the Title" of such a section
+      when you modify the Document means that it remains a section "Entitled
+      XYZ" according to this definition.
+    </para>
+    <para>
+      The Document may include Warranty Disclaimers next to the notice which
+      states that this License applies to the Document.  These Warranty
+      Disclaimers are considered to be included by reference in this License,
+      but only as regards disclaiming warranties: any other implication that
+      these Warranty Disclaimers may have is void and has no effect on the
+      meaning of this License.
+    </para>
+  </section>
+  <section id="VerbatimCopying" label="2. ">
+    <title>VERBATIM COPYING</title>
+    <para>
+      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.
+    </para>
+    <para>
+      You may also lend copies, under the same conditions stated above, and you
+      may publicly display copies.
+    </para>
+  </section>
+  <section id="QuantityCopying" label="3. ">
+    <title>COPYING IN QUANTITY</title>
+    <para>
+      If you publish printed copies (or copies in media that commonly have
+      printed covers) 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.
+    </para>
+    <para>
+      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.
+    </para>
+    <para>
+      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
+      computer-network location from which the general network-using public has
+      access to download using public-standard network protocols a complete
+      Transparent copy of the Document, free of added material.  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.
+    </para>
+    <para>
+      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.
+    </para>
+  </section>
+  <section id="Modifications" label="4. ">
+    <title>MODIFICATIONS</title>
+    <para>
+      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:
+    </para>
+    <orderedlist numeration="upperalpha">
+      <listitem>
+	<simpara>
+	  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.
+	</simpara>
+      </listitem>
+      <listitem>
+	<simpara>
+	  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 fewer than five),
+	  unless they release you from this requirement.
+	</simpara>
+      </listitem>
+      <listitem>
+	<simpara>
+	  State on the Title page the name of the publisher of the Modified
+	  Version, as the publisher.
+	</simpara>
+      </listitem>
+      <listitem>
+	<simpara>
+	  Preserve all the copyright notices of the Document.
+	</simpara>
+      </listitem>
+      <listitem>
+	<simpara>
+	  Add an appropriate copyright notice for your modifications adjacent to
+	  the other copyright notices.
+	</simpara>
+      </listitem>
+      <listitem>
+	<simpara>
+	  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.
+	</simpara>
+      </listitem>
+      <listitem>
+	<simpara>
+	  Preserve in that license notice the full lists of Invariant Sections
+	  and required Cover Texts given in the Document's license notice.
+	</simpara>
+      </listitem>
+      <listitem>
+	<simpara>
+	  Include an unaltered copy of this License.
+	</simpara>
+      </listitem>
+      <listitem>
+	<simpara>
+	  Preserve the section Entitled "History", Preserve 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.
+	</simpara>
+      </listitem>
+      <listitem>
+	<simpara>
+	  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.
+	</simpara>
+      </listitem>
+      <listitem>
+	<simpara>
+	  For any section Entitled "Acknowledgements" or "Dedications", Preserve
+	  the Title of the section, and preserve in the section all the
+	  substance and tone of each of the contributor acknowledgements and/or
+	  dedications given therein.
+	</simpara>
+      </listitem>
+      <listitem>
+	<simpara>
+	  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.
+	</simpara>
+      </listitem>
+      <listitem>
+	<simpara>
+	  Delete any section Entitled "Endorsements".  Such a section may not be
+	  included in the Modified Version.
+	</simpara>
+      </listitem>
+      <listitem>
+	<simpara>
+	  Do not retitle any existing section to be Entitled "Endorsements" or
+	  to conflict in title with any Invariant Section.
+	</simpara>
+      </listitem>
+      <listitem>
+	<simpara>
+	  Preserve any Warranty Disclaimers.
+	</simpara>
+      </listitem>
+    </orderedlist>
+    <para>
+      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.
+    </para>
+    <para>
+      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.
+    </para>
+    <para>
+      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.
+    </para>
+    <para>
+      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.
+    </para>
+  </section>
+  <section id="Combining" label="5. ">
+    <title>COMBINING DOCUMENTS</title>
+    <para>
+      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, and that
+      you preserve all their Warranty Disclaimers.
+    </para>
+    <para>
+      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.
+    </para>
+    <para>
+      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".
+    </para>
+  </section>
+  <section id="Collections" label="6. ">
+    <title>COLLECTIONS OF DOCUMENTS</title>
+    <para>
+      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.
+    </para>
+    <para>
+      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.
+    </para>
+  </section>
+  <section id="Aggregation" label="7. ">
+    <title>AGGREGATION WITH INDEPENDENT WORKS</title>
+    <para>
+      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, is called an "aggregate" if the copyright resulting
+      from the compilation is not used to limit the legal rights of the
+      compilation's users beyond what the individual works permit.  When the
+      Document is included in an aggregate, this License does not apply to the
+      other works in the aggregate which are not themselves derivative works of
+      the Document.
+    </para>
+    <para>
+      If the Cover Text requirement of section 3 is applicable to these copies
+      of the Document, then if the Document is less than one half of the entire
+      aggregate, the Document's Cover Texts may be placed on covers that bracket
+      the Document within the aggregate, or the electronic equivalent of covers
+      if the Document is in electronic form.  Otherwise they must appear on
+      printed covers that bracket the whole aggregate.
+    </para>
+  </section>
+  <section id="Translation" label="8. ">
+    <title>TRANSLATION</title>
+    <para>
+      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, and all the
+      license notices in the Document, and any Warranty Disclaimers, provided
+      that you also include the original English version of this License and the
+      original versions of those notices and disclaimers.  In case of a
+      disagreement between the translation and the original version of this
+      License or a notice or disclaimer, the original version will prevail.
+    </para>
+    <para>
+      If a section in the Document is Entitled "Acknowledgements",
+      "Dedications", or "History", the requirement (section 4) to Preserve its
+      Title (section 1) will typically require changing the actual title.
+    </para>
+  </section>
+  <section id="Termination" label="9. ">
+    <title>TERMINATION</title>
+    <para>
+      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.
+    </para>
+  </section>
+  <section id="FutureRevisions" label="10. ">
+    <title>FUTURE REVISIONS OF THIS LICENSE</title>
+    <para>
+      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 <ulink
+      url="http://www.gnu.org/copyleft/">http://www.gnu.org/copyleft/</ulink>.
+    </para>
+    <para>
+      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.
+    </para>
+  </section>
+  <section id="HowToUse" label="ADDENDUM: ">
+    <title>How to use this License for your documents</title>
+
+    <para>
+      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:
+    </para>
+    <blockquote>
+      <para>
+	Copyright &copy; YEAR YOUR NAME.
+      </para>
+      <para>
+	Permission is granted to copy, distribute and/or modify this document
+	under the terms of the GNU Free Documentation License, Version 1.2 or
+	any later version published by the Free Software Foundation; with no
+	Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.  A
+	copy of the license is included in the section entitled "GNU Free
+	Documentation License".
+      </para>
+    </blockquote>
+    <para>
+      If you have Invariant Sections, Front-Cover Texts and Back-Cover Texts,
+      replace the "with...Texts." line with this:
+    </para>
+    <blockquote>
+      <para>
+	with the Invariant Sections being LIST THEIR TITLES, with the
+	Front-Cover Texts being LIST, and with the Back-Cover Texts being LIST.
+      </para>
+    </blockquote>
+    <para>
+      If you have Invariant Sections without Cover Texts, or some other
+      combination of the three, merge those two alternatives to suit the
+      situation.
+    </para>
+    <para>
+      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.
+    </para>
+  </section>
+</appendix>