X-Git-Url: http://git.tremily.us/?a=blobdiff_plain;f=doc%2Finstall.txt;h=5f783253912531ceb8f87b4d2c07f5cf52e28a89;hb=02ac30a50da20ddae8d1ba141aa351b46ad560a1;hp=c61dcf1b49800bee5e4701aadc0b39bf1a367687;hpb=08d0c6648e124506db9c5fd977a566d1151f38dc;p=hooke.git

diff --git a/doc/install.txt b/doc/install.txt
index c61dcf1..5f78325 100644
--- a/doc/install.txt
+++ b/doc/install.txt
@@ -2,27 +2,51 @@
 Installing Hooke
 ****************
 
+Packages
+========
+
+Gentoo
+------
+
+I've packaged Hooke's `wtk` branch for Gentoo.  You need layman_ and
+my `wtk overlay`_.  With the `doc` flag enabled, you will also need
+the `science overlay`_ (for `dev-python/numpydoc`).  Set up all of
+that with::
+
+    # emerge -av app-portage/layman
+    # layman --add science
+    # layman --add wtk
+    # emerge -av sci-physics/hooke
+
+.. _layman: http://layman.sourceforge.net/
+.. _wtk overlay: http://www.physics.drexel.edu/~wking/unfolding-disasters/posts/Gentoo_overlay/
+.. _science overlay: http://overlays.gentoo.org/proj/science/wiki/en
+
+
 Dependencies
 ============
 
 Hooke is routinely run successfully on Windows and Linux based
-systems. It is possible to run it happily on Mac OS X too (though
-install can be a bit trickier). Technically, Hooke should run wherever
-the Python_ programming language is installed.
+systems. It is possible to run it happily on Mac OS X (though install
+can be a bit trickier). Technically, Hooke should run wherever the
+Python_ programming language is installed.
 
 You'll need the following Python modules:
 
 * Numpy_
 * Scipy_
+* PyYAML_ (for saving and loading playlists)
 * Matplotlib_ (for generating plots)
 * wxPython_ (for the GUI)
 
+.. _Python: http://www.python.org/
 .. _Numpy: http://numpy.scipy.org/
 .. _Scipy: http://www.scipy.org/
-.. _Python: http://www.python.org/
+.. _PyYAML: http://pyyaml.org/
 .. _Matplotlib: http://matplotlib.sourceforge.net/
 .. _wxPython: http://www.wxpython.org/
 
+
 Getting the source
 ==================
 
@@ -30,26 +54,27 @@ Hooke_ is available as an Subversion_ repository::
 
     $ svn checkout http://hooke.googlecode.com/svn/trunk/ hooke
 
-.. There is also a `GUI fork`_ (Rolf Schmidt)::
+There is also a `GUI fork`_ (Rolf Schmidt)::
 
-..    $ svn checkout http://hooke.googlecode.com/svn/trunk/ hooke
+    $ svn checkout http://hooke.googlecode.com/svn/branches/illysam/ hooke
 
-And a `fork`_ versioned in Git_ (W. Trevor King)::
+And a `fork`_ versioned in Mercurial_ (W. Trevor King)::
 
-    $ git clone http://www.physics.drexel.edu/~wking/code/git/hooke.git/ hooke
+    $ hg clone http://www.physics.drexel.edu/~wking/code/hg/hgwebdir.cgi/hooke/ hooke
+    $ hg update wtk
 
 There are also periodic bundled releases.  See the homepage for each
 fork for details.  For example, get the most recent snapshot of
 Trevor's fork in zip form with::
 
-     $ wget -o hooke.zip http://www.physics.drexel.edu/~wking/code/git/git.php?p=hooke.git&dl=zip&h=HEAD
+     $ wget -O hooke.zip http://www.physics.drexel.edu/~wking/code/hg/hgwebdir.cgi/hooke/archive/tip.zip
      $ unzip hooke.zip
 
 .. _Hooke: http://code.google.com/p/hooke/
 .. _GUI fork: http://code.google.com/p/hooke/wiki/HookeGUI
-.. _fork: http://www.physics.drexel.edu/~wking/code/git/git.php?p=hooke.git
+.. _fork: http://www.physics.drexel.edu/~wking/code/hg/hgwebdir.cgi/hooke/
 .. _Subversion: http://subversion.tigris.org/
-.. _Git: http://git-scm.com/
+.. _Mercurial: http://mercurial.selenic.com/
 
 
 Installation
@@ -65,13 +90,36 @@ to install Hooke.  Run::
 
 to see a list of installation options you may want to configure.
 
+If you install Hooke, you should probably setup a system- or user-wide
+configuration file (:doc:`config`), and replace any relative paths
+with appropriate absolute paths.  For example::
+
+    # Commands for managing a command stack (similar to macros).
+    [command_stack plugin]
+    # Directory containing command stack files.
+    path = resources/command_stack
+
+    # wxWindows graphical user interface.
+    [gui user interface]
+    # Path to the hooke icon image.
+    icon image = /usr/share/hooke/doc/img/microscope.ico
+    # Path to the Hooke splash screen image.
+    splash screen image = /usr/share/hooke/doc/img/hooke.jpg
+    # Directory containing perspective files.
+    perspective path = ~/.hooke/resources/gui/perspective
+
+
 Running Hooke from the source directory
 =======================================
 
 If you like, you can avoid installation by running Hooke directly from
 it's source directory::
 
-     $ wget -o hooke.zip http://www.physics.drexel.edu/~wking/code/git/git.php?p=hooke.git&dl=zip&h=HEAD
+     $ wget -O hooke.zip http://www.physics.drexel.edu/~wking/code/hg/hgwebdir.cgi/hooke/archive/tip.zip
      $ unzip hooke.zip
      $ cd hooke
-     $ python bin/hooke
+     $ python bin/hk.py
+
+You may need to give the full path for Python on Windows systems, and
+also check that the current working directory (`.`) is in your
+`PYTHONPATH`.  See :manpage:`python(1)` for details.