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

[gnunet]

Author: grothoff
Date: 2008-06-08 15:02:43 -0600 (Sun, 08 Jun 2008)
New Revision: 7093

Modified:
   GNUnet-docs/WWW/user_namespaces.php3
Log:
fixes

Modified: GNUnet-docs/WWW/user_namespaces.php3
===================================================================
--- GNUnet-docs/WWW/user_namespaces.php3        2008-06-08 20:59:38 UTC (rev 
7092)
+++ GNUnet-docs/WWW/user_namespaces.php3        2008-06-08 21:02:43 UTC (rev 
7093)
@@ -3,22 +3,24 @@
 $title = "GNUnet Documentation: A Tutorial for Using Namespaces";
 $description="How to create namespaces, add content to namespaces, update 
content and search namespaces";
 include("html_header.php3");
-H2("Howto Use Namespaces");
+H2("How to use namespaces");
 
 afslogo();
 ANCHOR("setup"); H3("Setup");
 BP();
 W("The first step to start with namespaces is to enable tracking of available 
content.");
+EP();
 IMG("screenshots/gnunet-gtk-namespace-1.png",
     "The 'Advanced' Tab in file-sharing",
     "CENTER",615,492);
+BP();
 W("This option is disabled by default since it would allow an adversary who 
takes control of the current machine to determine what metadata the local user 
has been exposed to.");
 W("Once you are done with your namespace operation, you may want to disable 
the checkbox and press the <tt>Clear</tt> button.");
 W("For this tutorial, we need to enable tracking of available content:");
+EP();
 IMG("screenshots/gnunet-gtk-namespace-2.png",
     "The 'Advanced' Tab in file-sharing with tracking enabled",
     "CENTER",615,492);
-EP();
 
 
 ANCHOR("publish"); H3("Publish Content");
@@ -27,34 +29,41 @@
 W("You could also add files that you did not upload yourself (and that you 
only found by searching the network) to a namespace, but since you could not 
know if those files were of high quality, we generally would advise against 
it.");
 W("The better method would be to download the content, check it and then 
re-publish it.");
 W("For this tutorial, we will assume that the content that you are publishing 
in your namespace is content that you are sharing.");
+EP();
 IMG("screenshots/gnunet-gtk-namespace-3.png",
     "The 'Publication' Tab in file-sharing",
     "CENTER",615,492);
+BP();
 W("As shown in the screenshot, select a file or directory from your local 
disk.");
 W("Any selections of the various options for publishing will work.");
 W("After clicking the <tt>Publish</tt> button, you can edit the meta-data for 
the content.");
+EP();
 IMG("screenshots/gnunet-gtk-namespace-4.png",
     "Edit the meta-data for the publication",
     "CENTER",712,482);
-P();
+BP();
 W("Finally, you should switch to the <tt>Status</tt> tab and wait for your 
upload to complete (blue bar full under Publications).");
+EP();
 IMG("screenshots/gnunet-gtk-namespace-5.png",
     "The status tab shows the progress of uploads and downloads",
     "CENTER",615,492);
-EP();
 
 ANCHOR("create"); H3("Creating the Namespace");
 BP();
 W("If you switch back to the <tt>Advanced</tt> tab, you should now see the 
(tracked) content that you have published since enabling tracking in the 
list.");
+EP();
 IMG("screenshots/gnunet-gtk-namespace-6.png",
     "The 'Advanced' Tab in file-sharing with tracked content",
     "CENTER",615,492);
+BP();
 W("At this point, we can create our first namespace.");
 W("Select <tt>New</tt> and then <tt>Namespace</tt> from the menu.");
 W("A dialog will open where you can enter meta-data describing the 
namespace.");
+EP();
 IMG("screenshots/gnunet-gtk-namespace-7.png",
     "Dialog for entering metadata about the namespace",
     "CENTER",694,459);
+BP();
 W("You should at least provide a brief description, a title or an author.");
 W("Those values will be used for the nickname of the namespace.");
 W("If you fail to specify metadata for any of these types, your namespace will 
be called 'unknown'.");
@@ -71,18 +80,20 @@
 W("Note that part of the process is generating a secret key, so if your system 
seems to hang, type randomly on your keyboard go generate entropy.");
 P();
 W("The <tt>Advanced</tt> tab should now look like this:");
+EP();
 IMG("screenshots/gnunet-gtk-namespace-7.png",
     "Dialog for entering metadata about the namespace",
     "CENTER",615,492);
-EP();
 
 ANCHOR("insert"); H3("Inserting into the Namespace");
 BP();
 W("In order to add content to your namespace, select a file or directory under 
<tt>Available content</tt> and click <tt>Add</tt>.");
 W("A new dialog will pop up where you need to specify an identifier for the 
content.");
+EP();
 IMG("screenshots/gnunet-gtk-namespace-9.png",
     "The 'Advanced' Tab in file-sharing",
     "CENTER",487,177);
+BP();
 W("The identifier is like a keyword, except that users need to use the 
identifier in conjunction with the namespace to find the content.");
 W("While not required, the first bit of content that we will publish in the 
namespace will also be the root of the namespace, hence we will enter 'gpl' for 
the identifier.");
 W("The <tt>Next Identifier</tt> is the identifier that will be used for any 
updates to the content published under <tt>Identifier</tt>.");
@@ -96,38 +107,46 @@
 W("In order to demonstrate updating, we need a second available file.");
 W("Following the same steps that we used for publishing the GPL, we added the 
GPLv3.");
 W("As a result, the <tt>Advanced</tt> tab should look like this:");
+EP();
 IMG("screenshots/gnunet-gtk-namespace-10.png",
     "The 'Advanced' Tab in file-sharing with GPLv3",
     "CENTER",615,492);
+BP();
 W("In the namespace tab, we select the original file that we want to publish 
an update for (here COPYING) and in the <tt>Available Content</tt> list we 
select the updated content (here gpl3.txt).");
 W("We can then press the <tt>Update</tt> button to create an update.");
+EP();
 IMG("screenshots/gnunet-gtk-namespace-11.png",
     "The 'Advanced' Tab in file-sharing",
     "CENTER",510,137);
+BP();
 W("This time, we are not prompted for an identifier -- 'gpl3' is automatically 
chosen for us (since we are updating COPYING).");
 W("We are given the opportunity to specify an identifier for the update to the 
update.");
 W("We can leave <tt>Next Identifier</tt> emtpy to express that there will 
never be an update to 'gpl3'.");
 W("The resulting namespace overview will then look like this:");
+EP();
 IMG("screenshots/gnunet-gtk-namespace-12.png",
     "The 'Advanced' Tab in file-sharing with GPLv3 inserted",
     "CENTER",615,492);
-EP();
 
 
 ANCHOR("search"); H3("Search");
 BP();
 W("Users that have discovered the namespace using a keyword search can then 
select it from the drop-down list in the <tt>Search and Download</tt> tab 
(behind <tt>in namespace</tt>.");
 W("If a namespace is selected, the <tt>Keyword</tt> is automatically set to 
the root of the namespace (here 'gpl'):");
+EP();
 IMG("screenshots/gnunet-gtk-namespace-13.png",
     "The 'Search and Download' Tab in file-sharing with the 'Free Software 
Licenses' namespace selected",
     "CENTER",615,492);
+BP();
 W("The number behind the namespace identifier (here '0') can be used to assign 
the namespace a 'rank'.");
 W("The rank is not used by GNUnet; the idea is that users can use it to 
express (and remember) which namespaces they like best.");
 P();
 W("Now that a namespace has been selected, the <tt>Find</tt> button can be 
used to search it.");
+EP();
 IMG("screenshots/gnunet-gtk-namespace-14.png",
     "The 'Search and Download' Tab in file-sharing with search results for the 
'Free Software Licenses' namespace",
-    "CENTER",615,492);
+    "CENTER",809,691);
+BP();
 W("GNUnet will first find the search result for the identifier 'gpl'.");
 W("Since 'gpl' was specified with an update, GNUnet will then automatically 
search for the update under the identifier 'gpl3'.");
 W("All results found for 'gpl' and its (transitive) updates will be displayed 
in the result list.");