seahorse r2403 - in trunk: . help help/C



Author: sadam
Date: Wed Aug 27 19:22:47 2008
New Revision: 2403
URL: http://svn.gnome.org/viewvc/seahorse?rev=2403&view=rev

Log:
2008-08-27  Adam Schreiber  <sadam clemson edu>

    * help/seahorse.omf.in: Change series id so that the manual shows up
    * help/C/seahorse.xml: Updated manual.


Modified:
   trunk/ChangeLog
   trunk/help/C/seahorse.xml
   trunk/help/seahorse.omf.in

Modified: trunk/help/C/seahorse.xml
==============================================================================
--- trunk/help/C/seahorse.xml	(original)
+++ trunk/help/C/seahorse.xml	Wed Aug 27 19:22:47 2008
@@ -2,7 +2,7 @@
 <!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" 
 "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd"; [
 	<!ENTITY legal SYSTEM "legal.xml">
-	<!ENTITY appversion "0.9.9">
+	<!ENTITY appversion "2.24.x">
 	<!ENTITY manrevision "3.1">
 	<!ENTITY date "July 2005">
 	<!ENTITY app "Passwords and Encryption Keys">
@@ -52,6 +52,16 @@
 		</publisher>
 		<revhistory>
 			<revision>
+				<revnumber>&app; Manual V0.10.1</revnumber>
+				<date>August 2008</date>
+				<revdescription>
+					<para role="author">
+						Adam Schreiber
+						<email>sadam clemson edu</email>
+					</para>
+				</revdescription>	
+			</revision>
+			<revision>
 				<revnumber>&app; Manual V0.9.1</revnumber>
 				<date>November 2006</date>
 				<revdescription>
@@ -123,32 +133,6 @@
       <ulink url="http://www.gnupg.org"; type="http">Gnu Privacy Guard (GPG)</ulink> and 
       integrates with multiple components of the <ulink url="http://www.gnome.org";>GNOME</ulink> desktop. 
     </para>
- 			<para>
-				Features of <application>&app;</application> include:
-			<itemizedlist>
-				<listitem>
-					<para>
-						A drop-in replacement for <application>gpg-agent</application>
-					</para>
-				</listitem>
-				<listitem>
-					<para>
-						A DNS-SD HKP &key; server
-					</para>
-				</listitem>
-				<listitem>
-					<para>
-						Plugins for <application><ulink url="ghelp:gedit" type="help">Gedit</ulink></application>, <application><ulink url="ghelp:user-guide?nautilus">Nautilus</ulink></application> 
-						and <application><ulink url="ghelp:epiphany">Epiphany</ulink></application>
-					</para>
-				</listitem>
-				<listitem>
-					<para>
-						A panel applet for encrypting text on the clipboard
-					</para>
-				</listitem>
-			</itemizedlist>
-			</para>
 			<para>
 				With <application>&app;</application> you can:
 				<itemizedlist>
@@ -165,12 +149,6 @@
 				<listitem>
 					<para>Backup your keys and keyring,</para>
 				</listitem>
-				<listitem>
-					<para>Cache your passphrase so you don't have to keep typing it,</para>
-				</listitem>
-				<listitem>
-					<para>Encrypt and decrypt the clipboard.</para>
-				</listitem>
 				</itemizedlist>
 			</para>
 	</sect1>
@@ -1311,357 +1289,51 @@
 			</itemizedlist>		
 		</para>
 	</sect1>
-
-  <sect1 id="file-manager">
-    <title>File Manager Integration</title>
-    <para>
-      <application>&app;</application> integrates with <application><ulink url="ghelp:user-guide?nautilus">Nautilus</ulink></application>.  You can encrypt, decrypt, sign and verify files as well as import public keys from the file manager window without launching <application>&app;</application>.
-    </para>
-    <sect2 id="encrypt-fm">
-      <title>Encrypting Files</title>
-      <para>
-	To encrypt files from the file manager, perform the following steps:
-	<itemizedlist>
-	  <listitem>
-	    <para>
-	      Select one or more files from the file manager,
-	    </para>
-	  </listitem>
-	  <listitem>
-	    <para>   
-	      Right click on any selected file and choose <guimenuitem>Encrypt</guimenuitem>,
-	    </para>
-	  </listitem>
-	  <listitem>
-	    <para>
-	      Select the people you would like to encrypt the file to, and then click <guibutton>OK</guibutton>.
-	    </para>
-	  </listitem>
-	</itemizedlist>
-      </para>
-    </sect2>
-    <sect2 id="sign-fm">
-      <title>Signing Files</title>
-      <para>
-	To sign files from the file manager, perform the following steps:
-	<itemizedlist>
-	  <listitem>
-	    <para>
-	      Select one or more files from the file manager,
-	    </para>
-	  </listitem>
-	  <listitem>
-	    <para>
-	      Right click on any selected file and choose <guimenuitem>Sign</guimenuitem>,
-	    </para>
-	  </listitem>
-	  <listitem>
-	    <para>
-	      If asked, enter the passphrase of your private key.
-	    </para>
-	  </listitem>
-	</itemizedlist>
-      </para>
-    </sect2>
-    <sect2 id="decrypt-fm">
-      <title>Decrypting Files</title>
-      <para>
-	To decrypt an encrypted file from the file manager, perform the following steps:
-	<itemizedlist>
-	  <listitem>
-	    <para>
-	      Double click on the file you want to decrypt,
-	    </para>
-	  </listitem>
-	  <listitem>
-	    <para>
-	      If asked, enter the passphrase of your private key.
-	    </para>
-	  </listitem>
-	</itemizedlist>
-      </para>
-    </sect2>
-    <sect2 id="verify-fm">
-      <title>Verifing Signatures</title> 
-      <para>
-	To verify files, simply double click on the the detached signature file.
-      </para>
-      <note><para>Detached signature file names often take the form
-	  &lt;file name&gt;.sig</para></note>
-    </sect2>
-  </sect1>
-  
-  <sect1 id="text-editor">
-    <title>Text Editor Integration</title>
-    <para>
-      To enable Text Encryption plugin in <application><ulink url="ghelp:gedit" type="help">Gedit</ulink></application>, the GNOME text editor, perform the following steps:
-      <itemizedlist>
-	<listitem>
-	  <para>
-	    Run <application>Gedit</application> by choosing 
-	    <menuchoice>
-	      <guimenu>Applications</guimenu>
-	      <guimenuitem>Accessories</guimenuitem>
-	      <guimenuitem>Text Editor</guimenuitem>
-	    </menuchoice>,
-	    </para>
-	</listitem>
-	<listitem>
-	  <para>
-	    Choose      
-	    <menuchoice>
-	      <guimenu>Edit</guimenu>
-	      <guimenuitem>Preferences</guimenuitem>
-	    </menuchoice>,
-	  </para>
-	</listitem>
-	<listitem>
-	  <para>
-	    In the <guilabel>Plugin</guilabel> tab, select the <guilabel>Text Encryption</guilabel> plugin.
-	  </para>
-	</listitem>
-      </itemizedlist>
-    </para>
-    <sect2 id="encrypt-te">
-      <title>Encrypting Text</title>
-      <para>
-	To encrypt a selection of text from <application>Gedit</application>, perform the following steps:
-	<itemizedlist>
-	  <listitem>
-	    <para>
-	      Select the text you want to encrypt, and choose 
-	      <menuchoice>
-		<guimenu>Edit</guimenu>
-		<guimenuitem>Encrypt</guimenuitem>
-	      </menuchoice>,
-	    </para>
-	  </listitem>
-	  <listitem>
-	    <para>
-	      Select the people you want to encrypt the text to, and click <guilabel>OK</guilabel>.
-	    </para>
-	  </listitem>
-	</itemizedlist>
-	You can now copy or save the encrypted text.
-      </para>
-    </sect2>
-    <sect2 id="sign-te">
-      <title>Signing Text</title>
-      <para>
-	To sign a selection of text from <application>Gedit</application>, perform the following steps:
-	<itemizedlist>
-	  <listitem>
-	    <para>
-	      Select the text you want to sign and choose 
-	      <menuchoice>
-		<guimenu>Edit</guimenu>
-		<guimenuitem>Sign</guimenuitem>
-	      </menuchoice>,
-	      </para>
-	  </listitem>
-	  <listitem>
-	    <para>
-	      If asked, enter the passphrase of your private key.
-	    </para>
-	  </listitem>
-	</itemizedlist>
-	You can now copy or save the signed text.
-      </para>
-    </sect2>
-    <sect2 id="decryptverify-te">
-      <title>Decrypting/Verifing Text</title>
-      <para>
-	To decrypt and/or verify a selection of text from <application>Gedit</application>, perform the following steps:
-	<itemizedlist>
-	  <listitem>
-	    <para>
-	      Select the text you want to decrypt/verify and choose 
-	      <menuchoice>
-		<guimenu>Edit</guimenu>
-		<guimenuitem>Decrypt/Verify</guimenuitem>
-	      </menuchoice>,
-	      </para>
-	  </listitem>
-	  <listitem>
-	    <para>
-	      If asked, enter the passphrase of your private key.
-	    </para>
-	  </listitem>
-	</itemizedlist>
-	You can now copy or save the decrypted text.
-      </para>
-    </sect2>
-  </sect1>
   
-  <sect1 id="preferences">
+  <sect1 id="prefs">
     <title>Preferences</title>
     <para>
-      This section describes the preferences settable in <application>&app;</application>.
-    </para>
-
-    <sect2 id="view-preferences">
-      <title>View preferences</title>
-      <para>
-	These options control which columns are visible in the key manager. 
-      </para>
-      <para>
-	To access these options choose 
-	<menuchoice>
-	  <guimenu>View</guimenu>
-	</menuchoice> 
-	from the menubar.
-      </para>
-      <para>
-	<variablelist>
-	  <varlistentry>
-	    <term><guimenuitem>Types</guimenuitem></term>
-	    <listitem>
-	      <para>
-		Shows the <guilabel>Type</guilabel> column, indicating whether the key 
-		is an OpenPGP, SSH key or a S/MIME certificate.
-	      </para>
-	      <note>
-		<para>
-		  Certificates are not yet supported.
-		</para>
-	      </note>
-	    </listitem>
-	  </varlistentry>
-	  <varlistentry>
-	    <term><guimenuitem>Expiry</guimenuitem></term>
-	    <listitem>
-	      <para>
-		Shows the <guilabel>Expiration Date</guilabel> column, indicating the date 
-		after which a key can no longer be used to encrypt or to sign.
-	      </para>
-	    </listitem>
-	  </varlistentry>
-	  <varlistentry>
-	    <term><guimenuitem>Trust</guimenuitem></term>
-	    <listitem>
-	      <para>
-		Shows the <guilabel>Trust</guilabel> column, indicating the level at which you trust 
-		the person to verify the identity of other people when they sign keys.
-	      </para>
-	    </listitem>
-	  </varlistentry>
-	  <varlistentry>
-	    <term><guimenuitem>Validity</guimenuitem></term>
-	    <listitem>
-	      <para>
-		Shows the <guilabel>Validity</guilabel> column, indicating how well you know the key belongs to 
-		the person claiming it as their own.
-	      </para>
-	    </listitem>
-	  </varlistentry>
-	</variablelist>
-      </para>
-    </sect2>
-    
-    <sect2 id="encrypt-pref">
-      <title>Encryption Preferences</title>
-      <para>
-	This section describes the preferences settable by choosing 
-	<menuchoice>
-	  <guimenu>System</guimenu>
-	  <guimenuitem>Preferences</guimenuitem>
-	  <guimenuitem>Encryption Preferences</guimenuitem>
-	</menuchoice> from the panel or
+      This section describes the preferences settable in <application>&app;</application> by choosing 
 	<menuchoice>
 	  <guimenu>Edit</guimenu>
 	  <guimenuitem>Preferences</guimenuitem>
 	</menuchoice> from within <application>&app;</application>.
       </para>
-      
-      <sect3 id="prefs">
-	<title>Encryption Settings</title>
-	<para>
-	</para>
-	<variablelist>
-	  <varlistentry>
-	    <term><guilabel>Default Key</guilabel></term>
-	    <listitem>
-	      <para>
-		This is the key that will be used by  <application>&app;</application> to sign files. 
-		It will also be the key that files will be encrypted to 
-		if encrypt to self is selected.
-	      </para>
-	    </listitem>
-	  </varlistentry>
-	  <varlistentry>
-	    <term><guilabel>When encrypting, always include myself as a recipient</guilabel></term>
-	    <listitem>
-	      <para>
-		Sets the encrypt to self option, whether or not you will be added to the recipients list for 
-		all files encrypted by <application>&app;</application>.
-	      </para>
-	      <note>
-		<para>
-		  If you do not select this and you do not select yourself as a 
-		  recipient you will not be unable to decrypt any files you encrypt.
-		</para>
-	      </note>
-	    </listitem>
-	  </varlistentry>
-	</variablelist>
-      </sect3>
-      
-      <sect3 id="password-cache">
-	<title>Passphrase Cache</title>
-	<para>
-	  Enabling <application>&app;</application>'s passphrase caching ability will allow you to 
-	  perform many operations that require entering your passphrase without 
-	  re-entering it every time. <command>seahorse-daemon</command> takes the 
-	  place of <command>gpg-agent</command>. Letting the cached passphrases 
-	  expire is usually a good idea. This will then require re-entering your 
-	  passphrase, but adds security.
-	</para>
-	<variablelist>
-	  <varlistentry>
-	    <term><guilabel>Never remember passphrases</guilabel></term>
-	    <listitem>
-	      <para>
-		Sets to not remember any passphrase.
-	      </para>
-	    </listitem>
-	  </varlistentry>
-	  <varlistentry>
-	    <term><guilabel>Remember passphrases for ... minutes</guilabel></term>
-	    <listitem>
-	      <para>
-		Sets the amount of time, in minutes, for storing passphrases. 
-		Use the spin box to set the desired time.
-	      </para>
-	    </listitem>
-	  </varlistentry>
-	  <varlistentry>
-	    <term><guilabel>Always remember passphrases whenever logged in</guilabel></term>
-	    <listitem>
-	      <para>
-		Sets to remember any passphrases whenever you are logged in the session.
-	      </para>
-	    </listitem>
-	  </varlistentry>
-	  <varlistentry>
-	    <term><guilabel>Ask me before using a cached passphrase</guilabel></term>
-	    <listitem>
-	      <para>
-		Sets to ask you before using a stored passphrase.
-	      </para>
-	    </listitem>
-	  </varlistentry>
-	  <varlistentry>
-	    <term><guilabel>Automatically load Secure Shell keys</guilabel></term>
-	    <listitem>
-	      <para>
-		Sets to automatically cache any Secure Shell key.
-	      </para>
-	    </listitem>
-	  </varlistentry>
-	</variablelist>
-      </sect3>
 
-      <sect3 id="key-servers">
+        <sect2 id="keyring">
+        	<title>Password Keyrings</title>
+        	<sect3>
+        	    <title>Creating Keyrings</title>
+            	<para>
+            	    You can create a new keyring by pressing <guibutton>Add Keyring</guibutton>. 
+            	    Enter a name for the new keyring and press <guibutton>Add</guibutton>.
+            	</para>
+        	</sect3>
+        	<sect3>
+        	    <title>Changing Keyring Passwords</title>
+            	<para>
+            	  To change the unlock password of the keyring, first select the appropriate keyring and then 
+            	  press <guibutton>Change Unlock Password</guibutton> button. You will then be prompted to
+            	  type the old password in the <guilabel>Old password</guilabel> text box, the new password in the
+            	  <guilabel>New password</guilabel> text box and
+            	  confirm it in the <guilabel>Confirm password</guilabel> text box. 
+            	  To apply the settings, press <guibutton>Change</guibutton>.
+            	  If the old password is correct, you will get a status
+            	  message indicating the success of the operation. If the
+            	  old password is not correct you will be asked to check
+            	  its correctness. 
+            	</para>
+        	</sect3>
+        	<sect3>
+        	    <title>Removing Keyrings</title>
+        	    <para>
+        	        To remove a keyring, , first select the appropriate keyring and then 
+            	  press <guibutton>Remove Keyring</guibutton> button.
+        	    </para>
+        	</sect3>
+        </sect2>
+
+    <sect2 id="key-servers">
 	<title>Key Servers</title>
 	<para>
 	  Keep your and other's keys up to date by syncing keys periodically with 
@@ -1695,9 +1367,9 @@
 	    </listitem>
 	  </varlistentry>
 	</variablelist>
-      </sect3>
+      </sect2>
 
-      <sect3 id="key-sharing">
+      <sect2 id="key-sharing">
 	<title>Key Sharing</title>
 	<para>
 	  Key Sharing is provided by DNS-SD, also known as Bonjour or Rendevous.  
@@ -1705,36 +1377,7 @@
 	  to the remote search dialog. Using these local "key servers" will most 
 	  likely be faster than accessing remote servers.
 	</para>
-      </sect3>
-
-      <sect3 id="keyring">
-	<title>GNOME Keyring</title>
-	<para>
-	  You can change the password of the default key ring created
-	  the first time you saved a password, a passphrase to
-	  access a SSH server or any other secret during a GNOME
-	  session.
-	</para>
-	<para>
-	  To change the master password of the key ring, type the
-	  original password in the <guilabel>Original Master
-	    Password</guilabel> text box, the new password in the
-	  <guilabel>New Master Password</guilabel> text box and
-	  confirm it in the <guilabel>Confirm Master
-	    Password</guilabel> text box. To apply the settings, press
-	  <guibutton>Apply</guibutton>.
-	  If the original master password is correct, you will get a status
-	  message indicating the success of the operation. If the
-	  master password is not correct you will be asked to check
-	  its correctness. 
-	</para>
-	<para>
-	  To clear all the text boxes,
-	  press <guibutton>Clear</guibutton>.
-	</para>
-      </sect3>
-
-    </sect2>
+      </sect2>
   </sect1>
       
     <sect1 id="about">

Modified: trunk/help/seahorse.omf.in
==============================================================================
--- trunk/help/seahorse.omf.in	(original)
+++ trunk/help/seahorse.omf.in	Wed Aug 27 19:22:47 2008
@@ -11,7 +11,8 @@
 		<format mime="text/xml" dtd="-//OASIS//DTD DocBook XML V4.1.2//EN"/>
 		<identifier url="seahorse.xml"/>
 		<language code="C"/>
-		<relation seriesid="cf2bed6a-3e28-11d6-88f3-c2f7a14f1d6b"/>
+		<!--relation seriesid="cf2bed6a-3e28-11d6-88f3-c2f7a14f1d6b"/-->
+		<relation seriesid="03ed47bb-3836-8ee2-377e-77a1e590794b70"/>
 		<rights type="GNU FDL" license.version="1.1" license="http://www.gnu.org/licenses/fdl.html"; holder="Jacob Perkins"/>
 	</resource>
 </omf>



[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]