X-Git-Url: http://git.tremily.us/?a=blobdiff_plain;f=doc%2Fconfig.txt;h=6b72780835f729ae95283b3b580a12e778f0bf60;hb=86827710f8124701deee14dc93eefe3fd6c234af;hp=6f0359b638d72502d5d93362cc62c2d6d1612bde;hpb=defc6247d72ec6507df5d408ca82a34388edec0d;p=hooke.git

diff --git a/doc/config.txt b/doc/config.txt
index 6f0359b..6b72780 100644
--- a/doc/config.txt
+++ b/doc/config.txt
@@ -22,23 +22,35 @@ Examples
 
 Run::
 
-    $ hooke --example-config-file
+    $ ./bin/hk.py --save-config -c ''
 
-To print a well commented example config file to stdout.
+or::
+
+    $ ./bin/hk.py -c 'save_config --output .hooke.cfg'
+
+To write a well commented example config file to :file:`.hooke.cfg`.
 
 
 Finding configuration files
 ---------------------------
 
-The default search path follows the `Filesystem Hierarchy
-Standard`_, and so will probably need adjustment for non-*nix systems.
-The default path list is
+The default search path follows the `Filesystem Hierarchy Standard`_,
+and so will probably need adjustment for non-\*nix systems.  The
+default path list is
 
-* /usr/share/hooke/hooke.cfg
-* /etc/hooke/hooke.cfg
-* ~/.hooke.cfg
+* :file:`/usr/share/hooke/hooke.cfg`
+* :file:`/etc/hooke/hooke.cfg`
+* :file:`~/.hooke.cfg`
+* :file:`./.hooke.cfg`
 
 but alternatives can be specified from the command line launching
 Hooke.
 
-_ ..Filesystem Hierarchy Standard: http://www.pathname.com/fhs/
+.. _Filesystem Hierarchy Standard: http://www.pathname.com/fhs/
+
+.. todo:: Implement command-line specified config file.
+
+.. warning:: Any changes you make to the configuration during a Hooke
+  run will *not be saved* when Hooke exits.  To save the changes,
+  either run the `save config` command before closing Hooke, or start
+  Hooke with the ``--save-config`` option.