Bug 252780 Document Roaming Access in Help p=giacomo.magnini@portalis.it r=ben.bucksch sr=me

suite/locales/en-US/chrome/common/help/glossary.xhtml

@@ -520,6 +520,10 @@
   standards and services that facilitate the use of public-key cryptography and
   certificates in a networked environment.</dd>
   
+<dt id="roaming_profile">roaming profile</dt><dd>A user profile (or parts of
+  it) stored on a remote server and used for sharing the same settings and data
+  across multiple computers.</dd>
+
 <dt id="root_ca">root CA</dt><dd>
   The <a href="#certificate_authority">certificate authority (CA)</a> with
   a self-signed certificate at the top of a
@@ -709,7 +713,7 @@
   
 </dl>
 
-<p>Copyright &copy; 2003-2004 The Mozilla Foundation.</p>
+<p>Copyright &copy; 2003-2005 The Mozilla Foundation.</p>
 
 </body>
 </html>

suite/locales/en-US/chrome/common/help/help-glossary.rdf

@@ -82,6 +82,7 @@
         <rdf:li> <rdf:Description nc:name="public key" nc:link="glossary.xhtml#public_key"/> </rdf:li>
         <rdf:li> <rdf:Description nc:name="public-key cryptography" nc:link="glossary.xhtml#public-key_cryptography"/> </rdf:li>
         <rdf:li> <rdf:Description nc:name="public-key infrastructure (PKI)" nc:link="glossary.xhtml#public-key_infrastructure"/> </rdf:li>
+        <rdf:li> <rdf:Description nc:name="roaming profile" nc:link="glossary.xhtml#roaming_profile"/> </rdf:li>
         <rdf:li> <rdf:Description nc:name="root CA" nc:link="glossary.xhtml#root_ca"/> </rdf:li>
         <rdf:li> <rdf:Description nc:name="search engine" nc:link="glossary.xhtml#search_engine"/> </rdf:li>
         <rdf:li> <rdf:Description nc:name="Secure Sockets Layer (SSL)" nc:link="glossary.xhtml#secure_sockets_layer"/> </rdf:li>

suite/locales/en-US/chrome/common/help/help-index1.rdf

@@ -1779,6 +1779,11 @@
        <rdf:Description ID="profiles:renaming"
          nc:name="renaming a profile"
 	 nc:link="profiles_help.xhtml#deleting_or_renaming_a_profile"/>
+     </rdf:li>
+     <rdf:li>
+       <rdf:Description ID="profiles:roaming"
+         nc:name="roaming profile"
+	 nc:link="profiles_help.xhtml#roaming_profiles"/>
      </rdf:li></rdf:Seq>
    </nc:subheadings>
 </rdf:Description>

suite/locales/en-US/chrome/common/help/profiles_help.xhtml

@@ -32,6 +32,10 @@
   <li><a href="#creating_a_new_profile">Creating a New Profile</a></li>
   <li><a href="#deleting_or_renaming_a_profile">Deleting or Renaming a
     Profile</a></li>
+  <li><a href="#roaming_profiles">Roaming Profiles</a></li>
+  <li><a href="#roaming_prefs">Roaming User Preferences</a></li>
+  <li><a href="#roaming_item_selection">Roaming User Preferences - Item
+    selection</a></li>
 </ul>
 </div>
 
@@ -64,6 +68,8 @@
   <li>Click Finish.</li>
 </ol>
 
+<p>[<a href="#managing_profiles">Return to beginning of section</a>]</p>
+
 <h2 id="deleting_or_renaming_a_profile">Deleting or Renaming a Profile</h2>
 
 <p>You may want to delete profiles that you don&apos;t normally use. To delete
@@ -99,7 +105,121 @@
     instructions.</li>
 </ol>
 
-<p>Copyright &copy; 2003-2004 The Mozilla Foundation.</p>
+<p>[<a href="#managing_profiles">Return to beginning of section</a>]</p>
+
+<h2 id="roaming_profiles">Roaming Profiles</h2>
+
+<p class="noMac"><strong>Note</strong>: This feature is not yet available in
+  the installer builds of &brandShortName;.</p>
+
+<p>Roaming profiles allow you to store your profile and associated settings on
+  a central server or file share. The advantage of this is that your settings
+  can follow you from one machine to another. For example, you may wish to use
+  &brandShortName; both at work and at home keeping your bookmarks, address
+  book, and other settings in sync, or a company may want to allow its
+  employees to use their &brandShortName; profile on any computer.</p>
+
+<p>Roaming profiles can be stored on a HTTP or FTP server. You will need a
+  user name and password on that server, so that you can have write access
+  to the appropriate directory for storing and retrieving your profile.
+  Alternatively, for computers that use a common file share, you can store
+  the profile in a local directory using the Copy method.</p>
+
+<p>Whenever you start &brandShortName;, your profile is downloaded and whenever you
+  shutdown &brandShortName;, your profile is uploaded.</p>
+
+<p>[<a href="#managing_profiles">Return to beginning of section</a>]</p>
+
+<h2 id="roaming_prefs">Roaming User Preferences</h2>
+
+<p>This section describes how to use the main Roaming User preferences panel.
+  If you&apos;re not already viewing it, follow these steps:</p>
+
+<ol>
+  <li>Open the
+    <span class="mac">&brandShortName;</span> <span class="noMac">Edit</span>
+    menu and choose Preferences.</li>
+  <li>Click on the Roaming User category.</li>
+  <li>Select <strong>Enable remote profile storage</strong> to activate roaming
+    for the current profile.</li>
+  <li>Select one of the following:
+    <ul>
+      <li><strong>HTTP / FTP</strong>: Choose this if you wish to have the
+        profile information copied to a FTP or HTTP server.
+        <ul>
+          <li><strong>Base URL</strong>: Type the URL of the directory where
+            the roaming profile will be stored. This can be an FTP, HTTP or
+            HTTPS URL. FTP is probably easiest to set up on a home network.
+            In other cases, especially when transmitting over the Internet,
+            it is strongly recommended to use HTTPS, because otherwise, all
+            your saved passwords and bookmarks (depending on your Item 
+            Selection) might be read by other people on the same network.
+
+            <p><strong>Examples</strong>:<br/>
+            <kbd>&lt;https://user@http-server/dir/&gt;</kbd><br/>
+            <kbd>&lt;ftp://user@ftp-server//home/user/dir/&gt;</kbd><br/> 
+            <kbd>&lt;ftp://user@ftp-server/dir/&gt;</kbd></p>
+
+          </li>
+          <li><strong>Username</strong>: Type the user name that will be
+            used to access the FTP or HTTP server.</li>
+          <li><strong>Save password</strong>: Enable this option to save the
+            password for the user name that you have supplied.</li>
+          <li><strong>Password</strong>: Type the password for the user name
+            that you supplied.</li>
+        </ul>
+      </li>
+      <li><strong>File Copy</strong>: Choose this if you wish to have the
+        profile information copied to a local directory.
+        <ul>
+          <li>Click <strong>Browse</strong> and select the directory where you
+            wish the profile information to be copied to and retrieved
+            from.</li>
+        </ul>
+      </li>
+    </ul>
+  </li>
+</ol>
+
+<p>[<a href="#managing_profiles">Return to beginning of section</a>]</p>
+
+<h2 id="roaming_item_selection">Roaming User Preferences - Item selection</h2>
+
+<p>By default, only bookmarks, cookies, and the personal addressbook are stored
+  on the roaming server. If all items are greyed out, make sure to have Roaming
+  enabled.To enable or disable roaming of other profile informations, follow
+  these steps:</p>
+
+<ol>
+  <li>Open the
+    <span class="mac">&brandShortName;</span> <span class="noMac">Edit</span>
+    menu and choose Preferences.</li>
+  <li>Under the Roaming User category, click Item Selection. (If no
+    subcategories are visible, double-click Roaming User to expand the
+    list.)</li>
+  <li>Select the items that you wish to be included in the roaming profile
+    synchronization.</li>
+</ol>
+
+<p>You cannot roam your local email, partly because that would take too long.
+  Use IMAP for this purpose.</p>
+
+<p><strong>Note</strong>: If you are using a slow connection, be aware that 
+  some files can be quite large, so this will impact your startup time.
+  &brandShortName; will have to download locally all of the files you
+  selected from the list before being fully functional, and save them back
+  to the remote server when you exit &brandShortName;.</p>
+
+<p>For further information about setting up Roaming Access on a server, see
+  the online document
+  <a href="http://www.klomp.org/mod_roaming/">mod_roaming - Roaming Access
+  module for Apache</a> or <a 
+  href="http://web.archive.org/web/20020605164606/http://help.netscape.com/products/client/communicator/manual_roaming2.html">Manually
+  Implementing Roaming Access</a>.</p>
+
+<p>[<a href="#managing_profiles">Return to beginning of section</a>]</p>
+
+<p>Copyright &copy; 2003-2005 The Mozilla Foundation.</p>
 
 </body>
 </html>

suite/locales/en-US/chrome/common/help/suite-toc.rdf

@@ -1144,6 +1144,9 @@
       <rdf:Seq>
         <rdf:li><rdf:Description ID="profile-help-create" nc:name="Creating a New Profile" nc:link="profiles_help.xhtml#creating_a_new_profile"/> </rdf:li>
         <rdf:li><rdf:Description ID="profile-help-delete" nc:name="Deleting or Renaming a Profile" nc:link="profiles_help.xhtml#deleting_or_renaming_a_profile"/> </rdf:li>
+        <rdf:li><rdf:Description ID="profile-help-roaming" nc:name="Roaming Profiles" nc:link="profiles_help.xhtml#roaming_profiles"/> </rdf:li>
+        <rdf:li><rdf:Description ID="profile-help-roaming-prefs" nc:name="Roaming Preferences" nc:link="profiles_help.xhtml#roaming_prefs"/> </rdf:li>
+        <rdf:li><rdf:Description ID="profile-help-roaming-item-selection" nc:name="Item Selection" nc:link="profiles_help.xhtml#roaming_item_selection"/> </rdf:li>
       </rdf:Seq>
     </nc:subheadings>
   </rdf:Description>