[GNUnet-SVN] r7071 - GNUnet-docs/WWW

[gnunet]

Author: grothoff
Date: 2008-06-07 12:36:44 -0600 (Sat, 07 Jun 2008)
New Revision: 7071

Modified:
   GNUnet-docs/WWW/user_afs.php3
Log:
document auto-share

Modified: GNUnet-docs/WWW/user_afs.php3
===================================================================
--- GNUnet-docs/WWW/user_afs.php3       2008-06-07 18:26:45 UTC (rev 7070)
+++ GNUnet-docs/WWW/user_afs.php3       2008-06-07 18:36:44 UTC (rev 7071)
@@ -23,6 +23,7 @@
 echo "</ul>\n";
 LILI("#afscommands","Shell Commands for File Sharing"); 
 echo "<ul>\n";
+LILI("#gnunetautoshare","gnunet-auto-share");
 LILI("#gnunetinsert","gnunet-insert");
 LILI("#gnunetsearch","gnunet-search");
 LILI("#gnunetdownload","gnunet-download");
@@ -354,6 +355,24 @@
 W("For shell-gurus, five shell commands provide the interface:");
 EP();
 
+ANCHOR("gnunetautoshare");H4("gnunet-auto-share");
+BP();
+W("<tt>gnunet-auto-share</tt> can be used to &quot;automatically&quot; share 
all of the files in a given directory.");
+W("The basic format of the command is");
+EP();
+PRE("$ gnunet-auto-share DIRECTORY-NAME");
+BP();
+W("After being started like this, <tt>gnunet-auto-share</tt> will put itself 
into the background (daemonize) and periodically check if new files have been 
copied into the given directory.");
+W("Working in the background, <tt>gnunet-auto-share</tt> will ensure that all 
files in the given directory are published to <tt>gnunetd</tt> and thus 
available to the network.");
+W("You will need to restart <tt>gnunet-auto-share</tt> whenever your computer 
is rebooted (just like you need to restart <tt>gnunetd</tt>).");
+W("While your distribution may contain a script to automatically restart 
<tt>gnunetd</tt>, it will most likely not contain a script for restarting 
<tt>gnunet-auto-share</tt> since the shared directory needs to be specified.");
+P();
+W("It is possible to manually specify keywords for the top-level files or 
directories shared using <tt>gnunet-auto-share</tt>.");
+W("This can be done by creating an additional configuration file (by default: 
<tt>~/.gnunet/metadata.conf</tt>).");
+W("Use the names of the shared files as section names, the type of the 
metadata as the key and the value of the metadata as the values.");
+W("The <tt>gnunet-auto-share</tt> man page contains a sample 
<tt>metadata.conf</tt> configuration file and more detailed descriptions of the 
various supported options.");
+EP();
+
 ANCHOR("gnunetinsert");H4("gnunet-insert");
 
 BP();