<!doctype book PUBLIC "-//Davenport//DTD DocBook V3.0//EN" [
 ]>
 <book id="index">
   <bookinfo>
     <date>1998-10-12</date>
     <title>Pharmacy </title>
     <subtitle>A GNOME Front-end to CVS</subtitle>
   </bookinfo>
   <toc></toc>
   <!-- We are done with the preliminaries, now we can start with
           the body of the document -->
   <chapter id="using">
     <title>Using Pharmacy </title>
     <para>A short explanation of using Pharmacy for your day-to-day CVS needs.</para>
     <sect1 id="setup">
       <title>Setup </title>
       <para>First, one must prepare the application.</para>
       <sect2 id="servers">
       <title>Servers Dialog </title>
       <para>FIXME: screenshot.</para>
       <para>The servers dialog contains a list of servers, aliases, working directories, and other useful information. This dialog can be reached via the <menu>main menu - Repository - Servers...</menu></para>
<para>"Name" is a descriptive name for the server. "CVSROOT" is the equivilant of the CVSROOT enivomental variable or the "-d" option in CVS. An example of a CVSROOT is "". "Working dir" is the directory associated for working with the server.</para>
       </sect2>
       <sect2 id="prefs">
       <title>The Preferences Dialog </title>
       <para>FIXME: describe prefs dialog.</para>
       <para>The editor should contain the command needed to execute an editor
that has it's own window. Good examples are "gvim -f" (the -f is very 
important), "gedit", "nedit", and of course "emacs". You could also try to use
this area to launch a xterm with an editor running in it.</para>
       </sect2>
     </sect1>
     <sect1 id="checkout">
     <title>Checking out modules </title>
     <para>FIXME: checkout screenshot</para>
     <para>"Checkout" will obtain a fresh copy of a module from the CVS server.
Click the "update list" button to generate a list of valid modules. Clicking on
an entry in the list box will place that value in the edit box. Type or select the module name and click "Ok" to begin the checkout of a module.</para>
<para>A directory must be hilighted in the directory-tree for this command to be used.</para>
     </sect1>

     <sect1 id="update">
     <title>Updating modules </title>
     <para>"Update" will patch your copy of the repository, adding and deleting files as needed.</para>
<para>A directory must be hilighted in the directory-tree for this command to be used. Optionally, you may select files to be updated in the file-list. If no files are selected, Pharmacy updated to whole directory and, depending on the options selected, it's subdirectories. The default is to update into subdirectories.</para>
     <para>FIXME: describe update with options</para>

     </sect1>
     <sect1 id="console">
     <title>CVS Console </title>
     <para>FIXME: cvs console screenshoot</para>
     <para>The "CVS console" is a powerful command line. Type any command into
the console and press "go". The command is executed in the selected part of 
the directory tree. Clicking the "stop" button will cancel any command that
Pharmacy can executes, that includes the command executed via menus.</para>
<para>Want a demonstration of how powerful the console is? After grabbing the latest copy of your favorite app. Configure and make the app using the console.
</para>
     </sect1>

   </chapter>
   
   <chapter id="pharmacy">
   <title>About Pharmacy </title>
   <para>Useless information about Pharmacy.</para>
   <sect1 id="authors">
   <title>Authors </title>
   <para>Reklaw (nawalker@earthlink.net) -- main author.</para>
   <para>Magick (Magick@dds.nl) -- prefs dialog.</para>
   </sect1>   
<sect1 id="web">
<title>Web Pages</title>
<para>Pharmacy Home page: http://home.earthlink.net/~nawlaker/pharmacy/</para>
<para>Cyclic (Creators of CVS): http://www.cyclic.com/</para>
</sect1>
   </chapter>
   <chapter id="licence">
<title>Licence</title>
<para>FIXME: Add GPL here</para>
</chapter>
   <appendix id="apx1">
     <title>More Information on CVS </title>
     <para>Although this booklet is quite complete, here I will
       mention some details I never got to.</para>
     <sect1 id="cvscmdline">
       <title>Command Line </title>
       <para>FIXME: describe cvs command line.</para>
     </sect1>
   </appendix>
 </book>
