* doc/gramps-manual/C/authors.xml: Add list of contributors.

* doc/gramps-manual/C/getstart.xml: Update.
* doc/gramps-manual/C/gramps-manual.xml: Update.
* doc/gramps-manual/C/legal.xml: Update.
* doc/gramps-manual/C/preface.xml: Update.
* doc/gramps-manual/C/figures/first-open.png: New shot.


svn: r4034

ChangeLog

@@ -1,3 +1,11 @@
+2005-02-15 Alex Roitman  <shura@alex.neuro.umn.edu>
+	* doc/gramps-manual/C/authors.xml: Add list of contributors.
+	* doc/gramps-manual/C/getstart.xml: Update.
+	* doc/gramps-manual/C/gramps-manual.xml: Update.
+	* doc/gramps-manual/C/legal.xml: Update.
+	* doc/gramps-manual/C/preface.xml: Update.
+	* doc/gramps-manual/C/figures/first-open.png: New shot.
+
 2005-02-14 Alex Roitman  <shura@alex.neuro.umn.edu>
 	* src/plugins/DetAncestralReport.py: Typos.
 	* src/plugins/DetDescendantReport.py: Typos.

doc/gramps-manual/C/authors.xml

@@ -24,14 +24,69 @@
 
     <title>About GRAMPS</title> 
     <para> &app; was written by Donald N. Allingham
-      (<email>dallingham@users.sourceforge.net</email>). 
+      (<email>dallingham@users.sourceforge.net</email>).</para>
+      
+      <para>
+      The somewhat incomplete list of contributors includes (in alphabetical order):
+      <itemizedlist>
+<listitem><para>Alexandre Duret-Lutz</para></listitem>
+<listitem><para>Alexander Bogdashevsky</para></listitem>
+<listitem><para>Alexander Roitman</para></listitem>
+<listitem><para>Arkadiusz Lipiec</para></listitem>
+<listitem><para>Bernd Felsche</para></listitem>
+<listitem><para>David R. Hampton</para></listitem>
+<listitem><para>Bernd Schandl</para></listitem>
+<listitem><para>Billy C. Earney</para></listitem>
+<listitem><para>Bruce J. DeGrasse</para></listitem>
+<listitem><para>Donald A. Peterson</para></listitem>
+<listitem><para>Douglas S. Blank</para></listitem>
+<listitem><para>Eero Tamminen</para></listitem>
+<listitem><para>Egyeki Gergely</para></listitem>
+<listitem><para>Frederick Noronha</para></listitem>
+<listitem><para>Frode Jemtland</para></listitem>
+<listitem><para>Gary Shao</para></listitem>
+<listitem><para>Greg Kuperberg</para></listitem>
+<listitem><para>Guillaume Pratte</para></listitem>
+<listitem><para>James Treacy</para></listitem>
+<listitem><para>Jason Salaz</para></listitem>
+<listitem><para>Jeffrey C. Ollie</para></listitem>
+<listitem><para>Jens Arvidsson</para></listitem>
+<listitem><para>Jesper Zedlitz</para></listitem>
+<listitem><para>Jim Smart</para></listitem>
+<listitem><para>Julio Sanchez</para></listitem>
+<listitem><para>Lars Kr. Lundin</para></listitem>
+<listitem><para>Laurent Protois</para></listitem>
+<listitem><para>Leonid Mamtchenkov</para></listitem>
+<listitem><para>Lorenzo Cappelletti</para></listitem>
+<listitem><para>Marcos Bedinelli</para></listitem>
+<listitem><para>Martin Hawlisch</para></listitem>
+<listitem><para>Martin Senftleben</para></listitem>
+<listitem><para>Matthieu Pupat</para></listitem>
+<listitem><para>Michel Guitel</para></listitem>
+<listitem><para>Nathan Bullock</para></listitem>
+<listitem><para>Pier Luigi Cinquantini</para></listitem>
+<listitem><para>Radek Malcic</para></listitem>
+<listitem><para>Radu Bogdan Mare</para></listitem>
+<listitem><para>Richard Bos</para></listitem>
+<listitem><para>Samuel Tardieu</para></listitem>
+<listitem><para>Sebastian Voecking</para></listitem>
+<listitem><para>Steve Hall</para></listitem>
+<listitem><para>Steve Swales</para></listitem>
+<listitem><para>Tim Waugh</para></listitem>
+<listitem><para>Tino Meinen</para></listitem>
+<listitem><para>Xing Wang</para></listitem>
+      </itemizedlist>
+If you know of somebody else who should be listed here, please let us know.
+      </para>
+      
+      <para>
       To find more information about &app;, please visit the 
       <ulink url="http://gramps.sourceforge.net" type="http">GRAMPS Project 
       Web page</ulink>. </para>
     <para>
       To report a bug or make a suggestion regarding this application or
       this manual, use the help menu in &app;, or follow the directions 
-      in this <ulink url="ghelp:gnome-feedback"  type="help">document</ulink>.
+      on <ulink url="http://gramps.sourceforce.net/contact.html"  type="http">this site.</ulink>
     </para>
 
     <para> This program is distributed under the terms of the GNU

doc/gramps-manual/C/getstart.xml

@@ -25,6 +25,9 @@
 
     <title>Getting Started</title> 
     
+    <para>This chapter provides the most basic information on starting &app; and
+    obtaining help. Please procede to the following chapters for more information.</para>
+
     <!-- ================ Getting Started Subsection ====== -->
     <sect1 id="gramps-start">
     <title>To Start GRAMPS</title>
@@ -45,11 +48,12 @@
         as a command line argument:</para>
 
 	<para>
-	<command>gramps -i</command> <replaceable>filename.ged</replaceable>
+	<command>gramps</command> <filename>filename.grdb</filename>
     	</para> 
 
-    	<para>where <replaceable>filename.ged</replaceable> is the name 
+    	<para>where <filename>filename.grdb</filename> is the name 
-	of the file you	want to open/import. The detailed reference to the 
+	of the file you want to open. The command line provides many more ways
+	to start &app; and perform different tasks. The detailed reference to the 
         command line options is found in the <xref linkend="append-cmdline"/>. 
         </para></listitem>
     </varlistentry>
@@ -88,7 +92,7 @@
 	
 	<para>This information can be entered at any time in the 
 	<guilabel>Preferences</guilabel> dialog, under the 
-	<guilabel>Usage</guilabel> category. 
+	<guilabel>Database/Researcher Information</guilabel> category. 
 	</para>
 
     </sect1>
@@ -113,24 +117,18 @@
       <para>If you would like to open an existing database, check the top radio
       button and click the <guibutton>OK</guibutton> button. You will then be asked to 
       specify the name of your existing database. If you would like to start
-      creating your brand new database from scratch right away, choose new XML
+      creating your brand new database from scratch right away, choose new
       database. </para> 
 
-      <para>NOTE: when starting new database, you should 
+      <para>
-      select an empty <replaceable>DIRECTORY</replaceable> 
+                 <note id="file-notdir-note">
-      and <replaceable>NOT a FILE</replaceable>. Create empty directory if 
+               <title>Selecting file</title>
-      needed. The directory you specify will be used by &app; to store 
+	      <para>
-      database file <replaceable>data.gramps</replaceable> as well as any 
+	      Unlike the version 1.0.X of &app;, this version does not require selecting directory
-      possible copies of media objects. This directory will be updated by &app; 
+	      for the database. Please select filename, as you would in any other application.
-      each time the database is saved. </para> 
+	      </para>
-      
+           </note>
-      <para>NOTE: when opening an existing database, you should 
+           </para> 
-      open a <replaceable>DIRECTORY</replaceable> and 
-      <replaceable>NOT a FILE</replaceable>. The directory you need to open 
-      should contain the  database file <replaceable>data.gramps</replaceable> 
-      as well as any possible copies of media objects. Such a directory is 
-      created by &app; when you start a new database and is updated each time 
-      the database is saved. </para> 
 
       </sect1>
       

doc/gramps-manual/C/gramps-manual.xml

@@ -25,6 +25,13 @@
 <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" 
 "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
 
+  <!-- Information about the entities
+       The legal.xml file contains legal information, there is no need to edit the file. 
+       Use the appversion entity to specify the version of the application.
+       Use the manrevision entity to specify the revision number of this manual.
+       Use the date entity to specify the release date of this manual.
+       Use the app entity to specify the name of the application. -->
+
   <!ENTITY legal SYSTEM "legal.xml">
 
   <!ENTITY appversion "1.2.0">
@@ -32,6 +39,8 @@
   <!ENTITY date "February 2005">
   <!ENTITY app "GRAMPS">
 
+  <!-- The rest of the entities is simply the chapters of the manual.. -->
+
   <!ENTITY preface SYSTEM "preface.xml">
   <!ENTITY getstart SYSTEM "getstart.xml">
   <!ENTITY mainwin SYSTEM "mainwin.xml">
@@ -43,13 +52,6 @@
   <!ENTITY cmdline SYSTEM "cmdline.xml">
   <!ENTITY bugs SYSTEM "bugs.xml">
   <!ENTITY authors SYSTEM "authors.xml">
-
-  <!-- Information about the entities
-       The legal.xml file contains legal information, there is no need to edit the file. 
-       Use the appversion entity to specify the version of the application.
-       Use the manrevision entity to specify the revision number of this manual.
-       Use the date entity to specify the release date of this manual.
-       Use the app entity to specify the name of the application. -->
 ]>
 <!-- 
       (Do not remove this comment block.)
@@ -223,12 +225,15 @@
 
     <releaseinfo>This manual describes version &appversion; of GRAMPS.
     </releaseinfo> 
+
     <legalnotice> 
       <title>Feedback</title> 
-      <para>To report a bug or make a suggestion regarding the &app; application or
+    <para>
-      this manual, follow the directions in the <ulink url="ghelp:gnome-feedback"
+      To report a bug or make a suggestion regarding this application or
-	  type="help">GNOME Feedback Page</ulink>. 
+      this manual, use the help menu in &app;, or follow the directions 
+      on <ulink url="http://gramps.sourceforce.net/contact.html"  type="http">this site.</ulink>
     </para>
+
 <!-- Translators may also add here feedback address for translations -->
     </legalnotice> 
   </bookinfo> 

doc/gramps-manual/C/legal.xml

@@ -18,61 +18,4 @@
 	along with this program; if not, write to the Free Software
 	Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
 	</para>
-
-	<para>
-	  Many of the names used by companies to distinguish their
-	  products and services are claimed as trademarks. Where those
-	  names appear in any GNOME documentation, and the members of
-	  the GNOME Documentation Project are made aware of those
-	  trademarks, then the names are in capital letters or initial
-	  capital letters.
-	</para>
-
-	<para>
-	  DOCUMENT AND MODIFIED VERSIONS OF THE DOCUMENT ARE PROVIDED
-	  UNDER  THE TERMS OF THE GNU GENERAL PUBLIC LICENSE
-	  WITH THE FURTHER UNDERSTANDING THAT:
-
-	  <orderedlist>
-		<listitem>
-		  <para>DOCUMENT IS PROVIDED ON AN "AS IS" BASIS,
-                    WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR
-                    IMPLIED, INCLUDING, WITHOUT LIMITATION, WARRANTIES
-                    THAT THE DOCUMENT OR MODIFIED VERSION OF THE
-                    DOCUMENT IS FREE OF DEFECTS MERCHANTABLE, FIT FOR
-                    A PARTICULAR PURPOSE OR NON-INFRINGING. THE ENTIRE
-                    RISK AS TO THE QUALITY, ACCURACY, AND PERFORMANCE
-                    OF THE DOCUMENT OR MODIFIED VERSION OF THE
-                    DOCUMENT IS WITH YOU. SHOULD ANY DOCUMENT OR
-                    MODIFIED VERSION PROVE DEFECTIVE IN ANY RESPECT,
-                    YOU (NOT THE INITIAL WRITER, AUTHOR OR ANY
-                    CONTRIBUTOR) ASSUME THE COST OF ANY NECESSARY
-                    SERVICING, REPAIR OR CORRECTION. THIS DISCLAIMER
-                    OF WARRANTY CONSTITUTES AN ESSENTIAL PART OF THIS
-                    LICENSE. NO USE OF ANY DOCUMENT OR MODIFIED
-                    VERSION OF THE DOCUMENT IS AUTHORIZED HEREUNDER
-                    EXCEPT UNDER THIS DISCLAIMER; AND
-		  </para>
-		</listitem>
-		<listitem>
-		  <para>UNDER NO CIRCUMSTANCES AND UNDER NO LEGAL
-                       THEORY, WHETHER IN TORT (INCLUDING NEGLIGENCE),
-                       CONTRACT, OR OTHERWISE, SHALL THE AUTHOR,
-                       INITIAL WRITER, ANY CONTRIBUTOR, OR ANY
-                       DISTRIBUTOR OF THE DOCUMENT OR MODIFIED VERSION
-                       OF THE DOCUMENT, OR ANY SUPPLIER OF ANY OF SUCH
-                       PARTIES, BE LIABLE TO ANY PERSON FOR ANY
-                       DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR
-                       CONSEQUENTIAL DAMAGES OF ANY CHARACTER
-                       INCLUDING, WITHOUT LIMITATION, DAMAGES FOR LOSS
-                       OF GOODWILL, WORK STOPPAGE, COMPUTER FAILURE OR
-                       MALFUNCTION, OR ANY AND ALL OTHER DAMAGES OR
-                       LOSSES ARISING OUT OF OR RELATING TO USE OF THE
-                       DOCUMENT AND MODIFIED VERSIONS OF THE DOCUMENT,
-                       EVEN IF SUCH PARTY SHALL HAVE BEEN INFORMED OF
-                       THE POSSIBILITY OF SUCH DAMAGES.
-		  </para>
-		</listitem>
-	  </orderedlist>
-	</para>
   </legalnotice>

doc/gramps-manual/C/preface.xml

@@ -120,6 +120,17 @@
 	This approach requires holding all data in memory, so it is only useful for small databases
 	(depending on the available memory size). In such mode, the data is automatically
 	saved upon exit, to mimic the functionality of the real database.
+
+           <warning id="gedcom-inmem1-warn">
+               <title>GEDCOM EDITING</title>
+	      <para>
+		Please keep in mind that some information in GEDCOM file may be lost
+		during import into &app;. Simply opening and viewing the file will not change it.
+		However, if any changes were made and they were not abandoned upon exit,
+		exiting &app; will save the data, with the possible data loss.
+	      </para>
+           </warning>                
+
 	</para></listitem>
       </varlistentry>