]> git.tuebingen.mpg.de Git - dss.git/blobdiff - INSTALL
Include the NEWS file in the web page.
[dss.git] / INSTALL
diff --git a/INSTALL b/INSTALL
index 58a03fbae85a5e73962d53b2fa3364c6e9c47bf8..ff4274b26b3560f404aaaf73591deb6efa998c61 100644 (file)
--- a/INSTALL
+++ b/INSTALL
@@ -2,14 +2,25 @@ Type
 
        make
 
 
        make
 
-in the dss source directory to build the dss executable. You
-likely need a recent version of gnu gengetopt,
-ftp://ftp.gnu.org/pub/gnu/gengetopt/, to compile dss.
+in the dss source directory to build the dss executable and copy it to
+some directory that is included in your PATH, e.g. to $HOME/bin or to
+/usr/local/bin.
+
+Note that you'll likely need a recent version of
+ftp://ftp.gnu.org/pub/gnu/gengetopt/ (gnu gengetopt) to compile dss.
+
+Optionally, type
+
+        make man
+
+to create the man page of dss. This invokes help2man so make sure
+that help2man is installed on your system. Note that the man page is
+just the nroff variant of the output of "dss --detailed-help".
 
 dss is known to compile on Linux, MacOS, Solaris, FreeBSD and
 
 dss is known to compile on Linux, MacOS, Solaris, FreeBSD and
-NetBSD. However, it is run-tested on Linux only.
+NetBSD. However, it is run-tested only on Linux.
 
 
-Also make sure that rsync, http://rsync.samba.org/, is installed on
+Also make sure that http://rsync.samba.org/ (rsync) is installed on
 your system. Version 2.6.1 or newer is required.
 
 Example:
 your system. Version 2.6.1 or newer is required.
 
 Example:
@@ -36,21 +47,21 @@ as follows:
 Then execute the commands
 
        mkdir /baz/qux
 Then execute the commands
 
        mkdir /baz/qux
-       ./dss --run
+       dss --run
 
 In order to print the list of all snapshots created so far, use
 
 
 In order to print the list of all snapshots created so far, use
 
-       ./dss --list
+       dss --ls
 
 Yes, it's really that easy. Of course, dss supports many more
 features and config options such as taking snapshots from remote
 
 Yes, it's really that easy. Of course, dss supports many more
 features and config options such as taking snapshots from remote
-hosts and several hooks that are executed whenever on certain events,
-for example whenever a snapshot was created successfully.  Try
+hosts and several hooks that are executed on certain events, for
+example whenever a snapshot was created successfully.  Try
 
 
-       ./dss -h
+       dss -h
 
 for an overview of all supported command line options or
 
 
 for an overview of all supported command line options or
 
-       ./dss --detailed-help
+       dss --detailed-help
 
 for the full help text.
 
 for the full help text.