GNOME.org
 

[baobab/mallard-documentation: 5/27] Improve scan-* and protocol pages

commit f244b24fa2d15b7b1b7ff4c306e2df34d8672280
Author: Julita Inca <yrazes gmail com>
Date:   Wed Dec 21 17:41:48 2011 -0500

    Improve scan-* and protocol pages

 help/C/custom-location.page |    8 ++++--
 help/C/ftp.page             |   25 ++++++++++++++--------
 help/C/scan-home.page       |    3 +-
 help/C/scan-remote.page     |   49 ++++++++++++++++++++++++++++---------------
 help/C/ssh.page             |   20 ++++++++---------
 help/C/web-dav.page         |   31 ++++++++++++++++++++-------
 help/C/windows-share.page   |   21 +++++++++--------
 7 files changed, 97 insertions(+), 60 deletions(-)
---
diff --git a/help/C/custom-location.page b/help/C/custom-location.page
index d67f4b9..6997ad1 100644
--- a/help/C/custom-location.page
+++ b/help/C/custom-location.page
@@ -17,8 +17,10 @@
 
   <comment><cite date="2011-12-19" href="mailto:yrazes gmail com">Julita Inca</cite>
   <p>This assumes the reader knows there are many forms to establish connection remotely to scan folders.</p></comment>
- 
-  <p>If you selected <gui>Custom Location</gui> as a Service type, you can configure it by doing:</p>
-  <p><gui>Location (URI)</gui></p>                                       
+
+  <p>If you selected <gui>Custom Location</gui> as a Service type:</p>
+  <p>Type in <gui>Location (URI)</gui> the URL of your Web site, with a slightly modification. The modification refers
+     in replacing "https" with "davs". For example, instead of "https://example.edu.pe:8443/";; you have to type
+     "davs://example.edu.pe:8443/".</p>
 
 </page>
diff --git a/help/C/ftp.page b/help/C/ftp.page
index b687bf5..ab03f98 100644
--- a/help/C/ftp.page
+++ b/help/C/ftp.page
@@ -16,17 +16,24 @@
   <title>File Transfer Protocol</title>
 
   <comment><cite date="2011-12-17" href="mailto:yrazes gmail com">Julita Inca</cite>
-  <p>This assumes the reader knows there are many forms to establish connection remotely to scan folders.</p></comment>
+    <p>This assumes the reader knows there are many forms to establish connection remotely to scan folders.</p>
+  </comment>
+  
+  <p>You can access a remote server by using FTP Protocol:</p>
 
   <steps>
-        <item><p>Click <gui>FTP (with login)</gui> as a Service type.</p></item>
-	<item><p>Write the name your server to establish the connection on  <gui>Server</gui>.</p></item>
-        <item><p>Add some <gui>Optional information</gui></p>
-            <p>The <gui>Port</gui> of this protocol is 21.</p>
-	    <p>The <gui>Folder</gui> is the folder you want to scan, consider <gui>/</gui> to write the specific route</p>
-            <p>The <gui>User Name</gui>is the name of the home of the server.</p></item>
+    <item><p>Click <gui>FTP (with login)</gui> as a Service type.</p></item>
+    <item><p>Write the name or address server to establish the connection.</p></item>
+    <item><p>Add some <gui>Optional information</gui></p>
+      <p>The <gui>Port</gui> to connect to on the server is 21.</p>
+      <p>The <gui>Folder</gui> you want to scan has to be written considering the initial route <gui>/</gui>.</p>
+      <p>The <gui>User Name</gui> is the name of the account used to connect to the server.</p></item>
   </steps>
-
-  <p>You can read more about this protocol <link xref="http://www.ietf.org/rfc/rfc959.txt";>here</link></p>
+  
+  <note style="important">
+    <p>If you select <gui>Public FTP</gui> as a Service type the user name information is not neccesary because the user is usually anonymous.</p>
+  </note>
+ 
+  <p>You can read more about this protocol <link href="http://www.ietf.org/rfc/rfc959.txt";>here</link>.</p>
 
 </page>
diff --git a/help/C/scan-home.page b/help/C/scan-home.page
index 82ad56a..4387fb3 100644
--- a/help/C/scan-home.page
+++ b/help/C/scan-home.page
@@ -25,7 +25,6 @@
 
   <title>Scan your <file>Home</file> folder</title>
 
-
   <comment>
     <cite date="2011-12-17" href="mailto:yrazes gmail com">Julita Inca</cite>
     <p>This assumes the reader knows how to know about the tree file system in
@@ -49,7 +48,7 @@
 
   <p>To scan your <file>Home</file> folder:</p>
   <list>
-    <item><p>Select <guiseq><gui>Analyzer</gui> <gui>Scan Home
+    <item><p>Select <guiseq><gui>Analyzer</gui><gui>Scan Home
     Folder</gui></guiseq> from the menu</p>.</item>
     <item><p>Click <gui>Scan Home</gui> in the toolbar</p>.</item>
     <item><p>Press <keyseq><key>CTRL</key><key>S</key></keyseq>.</p></item>
diff --git a/help/C/scan-remote.page b/help/C/scan-remote.page
index d492cb3..3667ac6 100644
--- a/help/C/scan-remote.page
+++ b/help/C/scan-remote.page
@@ -13,35 +13,50 @@
     <desc>Scan folders from wherever you are from other computer.</desc>
   </info>
 
-    <title>Scan Remote Folder</title>
+  <title>Scan Remote Folder</title>
 
-    <comment><cite date="2011-12-19" href="mailto:yrazes gmail com">Julita Inca</cite>
-    <p>This assumes the reader knows when to use the communication protocols. 
-    By the end of this page, the reader will be able to scan remote folders.</p></comment>
+  <comment><cite date="2011-12-19" href="mailto:yrazes gmail com">Julita Inca</cite>
+  <p>This assumes the reader knows when to use the communication protocols. 
+  By the end of this page, the reader will be able to scan remote folders.</p></comment>
 
-   <p>You can scan remote folders by selecting <guiseq><gui>Analyzer</gui><gui>Scan Remote Folder</gui></guiseq> from the menu,
-    or by clicking <gui>Scan a remote folder</gui> in the toolbar.</p>
+  <p>Maybe you are an admin of an Intranet file server and one day you are greeted with 
+  an urgent notice that nobody in the company can save any folder on it because the disks are completely full. 
+  You can also may need to trim down the size of a server to get its filesystem to fit on another
+  server so that you can move it from a physical server to a virtual server. Whichever can be the case,
+  you can scan remotely from other computer.</p> 
 
-   <p>Choose one of these protocols to start the scanning process:</p>
+  <note style="advanced">
+    <p>Make sure your remote computer is in the same network of the server and your account has the local permissions.</p>
+  </note>
+ 
+  <p>To start the scanning, select <guiseq><gui>Analyzer</gui><gui>Scan Remote Folder</gui></guiseq> from the menu,
+  or click <gui>Scan a remote folder</gui> in the toolbar.</p>
+
+  <p>Choose one of following protocols:</p>
 
   <list>
-	<item><p><link xref="ssh"><gui>SSH</gui></link> is an acronym for Secure Shell.  
+	<item><p><link xref="ssh">SSH</link> is an acronym for Secure Shell.  
         It is a protocol for secure remote login and other secure network services over an insecure network.</p></item>
 
-	<item><p><link xref="ftp"><gui>FTP (with login)</gui></link>: it is an acronym for File Transfer Protocol. 
-	It is used to promote sharing of files (computer programs and/or data), to encourage indirect or implicit (via programs) 
-	use of remote computers, to shield a user from variations in file storage systems among hosts, and to transfer data reliably and 		efficiently. FTP, though usable directly by a user at a terminal, is designed mainly for use by programs.</p></item>
+	<item><p><link xref="ftp">FTP (with login)</link> is an acronym for File Transfer Protocol. 
+	It is used to sharing and transfering folders reliably and efficiently. You can scan from remote computers 
+        shielding a user account.</p></item>
 
-	<item><p><link xref="ftp"><gui>Public FTP</gui></link>: File Transfer Protocol for sharing files where it is not necessary to 
-	login with a user name and password, the server creates an anonymus user to do the connection.</p></item>
+	<item><p><link xref="ftp">Public FTP</link> share files where it is not necessary to login with a user 
+        name and password, the server creates an anonymus user to do the connection.</p></item>
 
-	<item><p><link xref="windows-share"><gui>Windows Share</gui></link></p></item>
+	<item><p><link xref="windows-share">Windows Share</link> lets run the client on a linux machine and still be able to 
+        view and manage the Windows shares from a linux machine.</p></item>
 
-	<item><p><link xref="web-dav"><gui>WebDAV (HTTP)</gui></link></p></item>
+	<item><p><link xref="web-dav">WebDAV (HTTP)</link> is an acronym for Web-based Distributed Authoring and Versioning.
+        It is based on methods of Hypertext Transfer Protocol (HTTP) that facilitates collaboration between users
+        in editing and managing documents and files stored on World Wide Web servers.</p></item>
 
-	<item><p><link xref="web-dav"><gui>Secure WebDAV (HTTPS)</gui></link></p></item>
+	<item><p><link xref="web-dav">Secure WebDAV (HTTPS)</link>: Secure WebDAV assure encryption of transfered data 
+        (Web DAV over https will be used).</p></item>
 
-	<item><p><link xref="custom-location"><gui>Custom Location</gui></link></p></item>
+	<item><p><link xref="custom-location">Custom Location</link> enables you to access a particular function
+        from the folder manager.</p></item>
    </list>
 
 </page>
diff --git a/help/C/ssh.page b/help/C/ssh.page
index 72b5aa0..bfc89f4 100644
--- a/help/C/ssh.page
+++ b/help/C/ssh.page
@@ -18,20 +18,18 @@
   <comment><cite date="2011-12-19" href="mailto:yrazes gmail com">Julita Inca</cite>
   <p>This assumes the reader knows there are many forms to establish connection remotely to scan folders.</p></comment>
 
-  <p>Maybe you are an admin of an Intranet file server and one day you are greeted with an urgent notice that nobody in the company 
-  can save any folder on it. The alert when you logged in is that the disks are completely full. In this case you can start solving 
-  your problem by plugging in your SSH credentials and configure the scanning by doing:</p>    
+  <p>Use your SSH credentials and configure the scanning process by doing:</p>    
 
   <steps>
-	<item><p>Click <gui>SSH</gui> as a Service type.</p></item>
- 	<item><p>Write the name your server to establish the connection on  <gui>Server</gui>.</p></item>
-        <item><p>Add some <gui>Optional information</gui></p>
-              <p>The <gui>Port</gui> of this protocol is 22.</p>
-              <p>The <gui>Folder</gui> is the folder you want to scan, consider <gui>/</gui> to write the specific route</p>
-              <p>The <gui>User Name</gui>is the name of the home of the server.</p></item>
+    <item><p>Click <gui>SSH</gui> as a Service type.</p></item>
+    <item><p>Write the name your server to establish the connection on  <gui>Server</gui>.</p></item>
+    <item><p>Add some <gui>Optional information</gui></p>
+      <p>The <gui>Port</gui> of this protocol is 22.</p>
+      <p>The <gui>Folder</gui> is the folder you want to scan, consider <gui>/</gui> to write the specific route</p>
+      <p>The <gui>User Name</gui> is the name of the account used to connect to the server.</p></item>
   </steps>
 
-  <p>You can read more about this <link xref="http://www.ietf.org/rfc/rfc4251.txt";>protocol</link> and 
-  get more help <link xref= "https://live.gnome.org/DejaDup/Help/Restore/WorstCase";>here</link></p>
+  <p>You can read more about this <link href="http://www.ietf.org/rfc/rfc4251.txt";>protocol</link> and 
+  get more help <link href="https://live.gnome.org/DejaDup/Help/Restore/WorstCase";>here</link></p>
 
 </page>
diff --git a/help/C/web-dav.page b/help/C/web-dav.page
index 1e347b8..4a42593 100644
--- a/help/C/web-dav.page
+++ b/help/C/web-dav.page
@@ -15,14 +15,29 @@
 
   <title>WebDAV (HTTP) Protocol</title>
 
-    <comment><cite date="2011-12-19" href="mailto:yrazes gmail com">Julita Inca</cite>
-    <p>This assumes the reader knows there are many forms to establish connection remotely to scan folders.</p></comment>
+  <comment><cite date="2011-12-19" href="mailto:yrazes gmail com">Julita Inca</cite>
+   <p>This assumes the reader knows there are many forms to establish connection remotely to scan folders.</p>
+  </comment>
+ 
+  <p>The WebDAV protocol makes documents on the Web readables and writables. You can create, 
+  change and move documents within a web server or web share. 
+  You can also lock (âoverwrite preventionâ) and make queries of information about author and modified date.</p> 
 
-           <p>If you selected <gui>WebDAV (HTTP)</gui> as a Service type, you can configure it by doing:</p>
-           <p><gui>Server:</gui></p>
-           <p>Optional information:</p>
-           <p><gui>Port:</gui></p>
-           <p><gui>Folder:</gui></p>
-           <p><gui>User Name:</gui></p>
+  <steps>
+     <item><p>Click <gui>WebDAV (HTTP)</gui> as a Service type.</p></item>
+     <item><p>Write the name your server to establish the connection on  <gui>Server</gui>.</p></item>
+     <item><p>Add some <gui>Optional information</gui></p>
+      <p>The <gui>Port</gui> of this protocol is 22880.</p>
+      <p>The <gui>Folder</gui> is the folder you want to scan, consider <gui>/</gui> to write the specific route</p>
+      <p>The <gui>User Name</gui> is the name of the account used to connect to the server.</p></item>
+  </steps>
+  
+  <note style="important">
+   <p>Secure WebDAV requires the port 5006 be opened.</p>
+  </note>
+
+  <note style="tip">
+    <p>You can see more details of the <link href="http://www.ietf.org/rfc/rfc5397.txt";>WebDAV protocol</link> and learn more <link href="http://unixwiz.net/techtips/ms971492-webdav-vuln.html";> here</link>.</p>
+  </note>
 
 </page>
diff --git a/help/C/windows-share.page b/help/C/windows-share.page
index a51a2cc..0e3462a 100644
--- a/help/C/windows-share.page
+++ b/help/C/windows-share.page
@@ -16,15 +16,16 @@
   <title>Windows Share Protocol</title>
 
   <comment><cite date="2011-12-19" href="mailto:yrazes gmail com">Julita Inca</cite>
-  <p>This assumes the reader knows there are many forms to establish connection remotely to scan folders.</p></comment>
-
-  <p>If you selected <gui>Windows Share</gui> as a Service type, you can configure it by doing:</p>
-           <p><gui>Server:</gui></p>
-           <p>Optional information:</p>
-           <p><gui>Share:</gui></p>
-           <p><gui>Folder:</gui></p>
-           <p><gui>User Name:</gui></p>
-           <p><gui>Domain Name:</gui></p>
-
+   <p>This assumes the reader knows there are many forms to establish connection remotely to scan folders.</p>
+  </comment>
 
+  <steps>
+    <item><p>Click <gui>Windows Share</gui> as a Service type.</p></item>
+    <item><p>Write the name your server to establish the connection on  <gui>Server</gui>.</p></item>
+    <item><p>Add some <gui>Optional information</gui>:</p>
+      <p>The name of the Windows <gui>Share</gui>.</p>
+      <p>The <gui>Folder</gui> is the folder you want to scan, consider <gui>/</gui> to write the specific route.</p>
+      <p>The <gui>User Name</gui> is the name of the account used to connect to the server.</p></item>
+      <p>The <gui>Domain Name</gui> is the name of the Windows domain.</p>
+  </steps>
 </page>
[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]