Commits

Steve Borho  committed 6d45bd1

doc: fill in preface details

  • Participants
  • Parent commits 21589e7

Comments (0)

Files changed (1)

File doc/source/preface.txt

 Audience
 ========
 
-This book is written for computer literate folk who want to use Mercurial to manage their data, but are
-uncomfortable using the command line client to do so. Since TortoiseHG is a windows shell extension
-it's assumed that the user is familiar with the windows explorer and knows how to use it.
-TortoiseHG comes with a simple python application, hgtk, which allows you to launch the TortoiseHg dialogs
-on any platform that supports Mercurial, and PyGtk. This is the easiest way to start using TortoiseHg on Linux
-and Mac OS X.
+This book is written for computer literate folk who want to use
+Mercurial to manage their data, but are uncomfortable using the command
+line client to do so. Since TortoiseHG is a windows shell extension it's
+assumed that the user is familiar with the windows explorer and knows
+how to use it.  TortoiseHG comes with a simple python application, hgtk,
+which allows you to launch the TortoiseHg dialogs on any platform that
+supports Mercurial, and PyGtk. This is the easiest way to start using
+TortoiseHg on Linux and Mac OS X.
 
 
 Reading guide
 =============
 
-This Preface explains a little about the TortoiseHG project, the community of people who work on it,
-and the licensing conditions for using it and distributing it.
+This Preface explains a little about the TortoiseHG project, the
+community of people who work on it, and the licensing conditions for
+using it and distributing it.
 
-The :doc:`intro`, explains what TortoiseHG is, what it does, where it comes from and the
-basics for installing it on your PC.
+The :doc:`intro`, explains what TortoiseHG is, what it does, where it
+comes from and the basics for installing it on your PC.
 
-The Chapter 2 and others. TODO when the structure of the manual is enough stable.
+The remaining chapters describe the tools that are part of TortoiseHg.
 
 TortoiseHG is free!
 ===================
 
-TODO
+TortoiseHg is released under 
+`GPLv2 <http://www.gnu.org/licenses/gpl-2.0.html>`_.  You are free to
+install it on as many computers as you like, and to redistribute it
+according to the GPLv2 license.
 
 Community
 =========
 
-TODO
+Mailing Lists:
+
+* `Users <https://lists.sourceforge.net/lists/listinfo/tortoisehg-discuss>`_
+* `Developers <https://lists.sourceforge.net/lists/listinfo/tortoisehg-develop>`_
+
+Our `wiki <http://bitbucket.org/tortoisehg/stable>`_ is on BitBucket.
 
 Acknowledgement
 ===============
 
-TODO
+Thanks to the many people who contribute to the TortoiseHg project.  It
+take a community of developers, translators, and users to build a
+truly useful tool.  Especially users who care enough to report bugs and
+file feature requests.
 
 Conventions used in this manual
 ===============================
     Indicates a label, button or anything that appears in user interfaces.
 	
 :menuselection:`TortoiseHG... --> About`
-    Indicates a menu choice, or a combination of menu choice, tab selection and GUI label.
-    For example :menuselection:`TortoiseHG... --> Global settings --> Commit --> User name`
-    means do something in :guilabel:`User name` label under :guilabel:`Commit` tab selectable from the
-    menu choice :menuselection:`TortoiseHG... --> Global settings`.
+    Indicates a menu choice, or a combination of menu choice, tab
+    selection and GUI label.  For example
+    :menuselection:`TortoiseHG...  --> Global settings --> Commit --> User name`
+    means do something in :guilabel:`User name` label under
+    :guilabel:`Commit` tab selectable from the menu choice
+    :menuselection:`TortoiseHG... --> Global settings`.
 
 :file:`.hg/hgrc`
     Indicates a filename or directory name.
 
 :command:`hgtk log`
-    Indicates a command to digit in command window.
+    Indicates a command to enter into command window.
 
 .. note::
     This is a note.
 
 .. warning::
-    An important note. Pay attention.
+    An important note. Pay attention.