2005-11-18 [colin] 1.9.100cvs22
authorColin Leroy <colin@colino.net>
Fri, 18 Nov 2005 23:18:14 +0000 (23:18 +0000)
committerColin Leroy <colin@colino.net>
Fri, 18 Nov 2005 23:18:14 +0000 (23:18 +0000)
* src/prefs_account.c
Fix layout in news and mbox accounts
* manual/account.xml
* manual/advanced.xml
New contents for Paul to check :)

ChangeLog
PATCHSETS
configure.ac
manual/account.xml
manual/advanced.xml
src/prefs_account.c

index a0ebebf..ff34e27 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,11 @@
+2005-11-18 [colin]     1.9.100cvs22
+
+       * src/prefs_account.c
+               Fix layout in news and mbox accounts
+       * manual/account.xml
+       * manual/advanced.xml
+               New contents for Paul to check :)
+
 2005-11-18 [wwp]       1.9.100cvs21
 
        * src/gtk/quicksearch.c
index 90767b0..53aaa4f 100644 (file)
--- a/PATCHSETS
+++ b/PATCHSETS
 ( cvs diff -u -r 1.382.2.193 -r 1.382.2.194 src/compose.c;  cvs diff -u -r 1.96.2.84 -r 1.96.2.85 src/textview.c;  ) > 1.9.100cvs19.patchset
 ( cvs diff -u -r 1.96.2.85 -r 1.96.2.86 src/textview.c;  ) > 1.9.100cvs20.patchset
 ( cvs diff -u -r 1.1.2.26 -r 1.1.2.27 src/gtk/quicksearch.c;  ) > 1.9.100cvs21.patchset
+( cvs diff -u -r 1.105.2.41 -r 1.105.2.42 src/prefs_account.c;  cvs diff -u -r 1.1.2.1 -r 1.1.2.2 manual/account.xml;  cvs diff -u -r 1.1.2.1 -r 1.1.2.2 manual/advanced.xml;  ) > 1.9.100cvs22.patchset
index d3fd947..c14d57e 100644 (file)
@@ -11,7 +11,7 @@ MINOR_VERSION=9
 MICRO_VERSION=100
 INTERFACE_AGE=0
 BINARY_AGE=0
-EXTRA_VERSION=21
+EXTRA_VERSION=22
 EXTRA_RELEASE=
 EXTRA_GTK2_VERSION=
 
index bb8018f..28979ea 100644 (file)
@@ -5,30 +5,59 @@
   <section id="account_basic">
     <title>Basic preferences</title>
     <para>
+    The first tab of the account preferences contains, as its name indicates, basic account data. In this tab you can specify your name, email address, organization and basic connection information.  The name of the account is just the name Sylpheed-Claws will use when referring to this account, for example in the account switcher at the lower right-hand corner of the main window.  The server information lets you specify the receiving protocol to use (which is not modifiable for existing accounts), the server(s) used to receive or send your emails (usually pop.isp.com and smtp.isp.com) and your login on the receiving server.  
+    </para>
+    <para>
+    In the Receive tab, you'll be able to change the default behaviour of Sylpheed-Claws, for example to leave messages on the server for a while, prevent downloading of too big mails, or specify whether you want the filtering rules to apply to this account's mails or not.
+    </para>
+    <para>
+    The Send tab contains preferences about special headers you'd want to add to your outgoing emails, like an X-Face, and authentication information for sending emails. Most of the time, your ISP allows its subscribers to send email via the SMTP server without authenticating, but in some setups, you have to identify yourself before sending. There are different possibilities for doing that. The best one, when available, is SMTP AUTH; when it isn't available, you'll usually use POP-before-SMTP, which connects to the POP server (which is authenticated), disconnects, and sends the mail. 
+    </para>
+    <para>
+    The Compose tab allows to change the behaviour of the Composition window when used with the account. For example, you can specify a signature to use automatically, and to set default Cc, Bcc or Reply-To address.
+    </para>
+    <para>
+    In the privacy tab, you can choose the default level of paranoia for your account. You might want all outgoing emails to be digitally signed and/or encrypted. Signing all outgoing emails, not only important ones, will for example allow you to protect yourself from faked mails sent on your behalf to coworkers. This can help solving embarrassing situations.
     </para>
-  </section>
-
-  <section id="account_prefs">
-    <title>Preferences for writting</title>
     <para>
+    The SSL tab is also a security-related one, although this time its setting applies to the transport of your emails and not their storage.  Basically, using SSL encrypts the connection between you and the server, which prevents people from snooping on your connection and be able to read your mails and your password. SSL should be used if it is available.
     </para>
   </section>
 
   <section id="account_types">
     <title>Account types</title>
     <para>
+    We saw earlier that once an account is created, you can't change its type (protocol) anymore. This is because preferences for these different types are quite not the same, and most of the POP3 related options have no interest on IMAP, for example.
+    </para>
+    <para>
+    POP3 is one of the two most used protocol, and is available at almost any ISP on the earth. Its advantage is to allow you to download email locally, which means it'll be really fast to access once you have it on your hard disk. The disadvantage of POP3 is that it is more hard to receive your mail on multiple computers (you'll have to keep them on the server for a few days), and that you won't be able to keep track of which mail you read or not when using another computer.
+    </para>
+    <para>
+    IMAP is the second most used protocol, and its goal is to address the defaults of POP3. When using IMAP, your folder list and your emails are all kept on the server. This slows down a bit navigation as each mail is downloaded on demand, but when you use another computer or email client, you find back your emails the same way you left them, including their status (read, unread, flagged, ...).
+    </para>
+    <para>
+    News (NNTP) is the other name of Usenet, a worldwide infrastructure that allow people to subscribe and post to Newsgroups. The principle is about the same as web forums: public discussions centered on different interests. Usenet exists since the beginning of Internet and can be a great tool to find help or information, as well as a great tool to waste your time!
+    </para>
+    <para>
+    Finally, the 'Local MBOX file' type of account can be used if you run an SMTP server on your computer and/or want to receive your logs easily.
+    </para>
+    <para>
+    The account type 'None, SMTP only' is a special type of account as it won't retrive any email, but rather will allow you to create different identities. They're used to send out emails with various aliases for example.
     </para>
   </section>
 
   <section id="account_multiple">
     <title>Multiple accounts</title>
     <para>
+    You can easily create multiples accounts in Sylpheed-Claws. For POP accounts, you can choose whether to receive the emails from the different accounts in the same folder(s) or not, using the Receive tab preference.  For IMAP and News accounts, each of them will get its own subtree in the folder tree.
+    You can choose which accounts get checked for new mail when using the "Get All" command (or "Get Mail" in the toolbar) by checking the relevant box in their preferences' Receive tab or in the 'G' column of your accounts' list.
     </para>
   </section>
 
   <section id="account_morefilt">
     <title>More filtering</title>
     <para>
+    The filtering rules are global. That means that mails from various accounts can get filtered in other accounts' folders, for example a mail received over POP3 could get filtered in an IMAP account. This is either an useful feature or an annoying one, depending on what you want to do.  If you'd rather avoid that, the best thing to do is to disable Filtering on the accounts, and use Processing rules in the various Inbox folders you specified.
     </para>
   </section>
 
index 8bd21c6..3f9ca12 100644 (file)
@@ -5,18 +5,24 @@
   <section id="adv_actions">
     <title>Actions</title>
     <para>
+    Actions allow you to use all the power of the Unix command-line with your emails. You can define various commands, taking parameters such as the current email file, a list of emails, the currently selected text, and so on. In this way, you'll be able to perform various tasks such as editing a raw mail in your text editor, "hide" what you mean using ROT-13, apply patches contained in emails directly, and so on. The only limit is your imagination. You can configure Actions via the Tools menu.
     </para>
   </section>
 
   <section id="adv_templates">
     <title>Templates</title>
     <para>
+    Templates are used in Composition windows, and are a sort of "model" letters. Templates can be filled with static text and dynamic parts, such as the original sender's name ("Dear %N, ..."), the date, ... When applying a template, the dynamic fields will be replaced with the relevant values. You can configure templates via the Tools menu.
     </para>
   </section>
 
   <section id="adv_processing">
     <title>Processing</title>
     <para>
+    Processing rules are the same as Filtering rules, except that they are applied when entering a folder and apply only to this folder. You can use them to automatically move old mails into an archive folder, or for further dispatching of emails. You can set each folder's Processing rules by right-clicking on it.
+    </para>
+    <para>
+    Processing rules are accompanied by Preprocessing and Postprocessing rules. Like Processing rules, they apply only when opening a folder, but like Filtering rules, they are shared accross all folders. You can configure them from the Tools menu.
     </para>
   </section>
 
     <para>
       Plugins are the mechanism of extending Sylpheed-Claws capabilities. Imagine you want to store your mails in a remote <acronym>SQL</acronym> database. In most mailers out there this is simply impossible without reworking the internals of it. With Sylpheed-Claws you can simply write a plugin to achieve the task.
     </para>
-    <para>This is only an example of the possibilities. Already exist a good number of plugins developed for Sylpheed-Claws, and more are to come. The <link linkend="ch_plugins">Extending Sylpheed-Claws section</link> is devoted to all of them.
+    <para>
+      This is only an example of the possibilities. Already exist a good number of plugins developed for Sylpheed-Claws, and more are to come. The <link linkend="ch_plugins">Extending Sylpheed-Claws section</link> is devoted to all of them.
     </para>
   </section>
 
   <section id="adv_hidden">
     <title>Hidden preferences</title>
     <para>
+    There are a number of hidden preferences in Sylpheed-Claws, preferences that some users we wanted to please couldn't live without, but which did not had a place in the GUI in our opinions. You can find the following, and change them while Sylpheed-Claws is not running in ~/.sylpheed-claws/sylpheedrc.
+    <itemizedlist>
+      <listitem><para>bold_unread
+      show unread messages using bold font in summary view
+      </para></listitem>
+      <listitem><para>color_new
+      color (as hex triplet) of folder name when indicating new messages
+      </para></listitem>
+      <listitem><para>cache_max_mem_usage
+      the maximum amount of memory to use to cache messages, in kB.
+      </para></listitem>
+      <listitem><para>cache_min_keep_time
+      the minimum time to keep a cache in memory, in minutes. Caches more recent than this time will not be freed, even if the memory usage is too high.
+      </para></listitem>
+      <listitem><para>enable_hscrollbar
+      enables horizontal scrollbar in summaryview
+      </para></listitem>
+      <listitem><para>enable_rules_hint
+      enable alternate lines in GtkTreeViews
+      </para></listitem>
+      <listitem><para>enable_swap_from
+      display sender's email address in To column in Sent folder instead of recipient's
+      </para></listitem>
+      <listitem><para>folderview_vscrollbar_policy
+      specify the policy of vertical scroll bar of folder view
+      </para></listitem>
+      <listitem><para>hover_timeout
+      time in milliseconds that will cause a folder tree to expand during drag n drop when the mouse cover is held over it
+      </para></listitem>
+      <listitem><para>statusbar_update_step
+      update stepping in progress bars
+      </para></listitem>
+      <listitem><para>textview_cursor_visible
+      display the cursor in the message view
+      </para></listitem>
+      <listitem><para>thread_by_subject_max_age
+      number of days to include a message in a thread when using 'Thread using subject in addition to standard headers'
+      </para></listitem>
+      <listitem><para>toolbar_detachable
+      hide handles in the toolbars
+      </para></listitem>
+      <listitem><para>utf8_instead_of_locale_for_broken_mail
+      use UTF-8 encoding for broken mails instead of current locale
+      </para></listitem>
+      <listitem><para>warn_dnd
+      display a confirmation dialog on drag n drop of folders
+      </para></listitem>
+    </itemizedlist>
+    
     </para>
   </section>
   
index d087047..484803d 100644 (file)
@@ -1199,14 +1199,14 @@ static void prefs_account_basic_create(void)
                (_("This server requires authentication"));
        gtk_widget_show (nntpauth_chkbtn);
        
-       gtk_table_attach (GTK_TABLE (serv_table), nntpauth_chkbtn, 0, 2, 1, 2,
+       gtk_table_attach (GTK_TABLE (serv_table), nntpauth_chkbtn, 0, 2, 6, 7,
                          GTK_FILL, 0, 0, 0);
 
        nntpauth_onconnect_chkbtn = gtk_check_button_new_with_label
                (_("Authenticate on connect"));
        gtk_widget_show (nntpauth_onconnect_chkbtn);
 
-       gtk_table_attach (GTK_TABLE (serv_table), nntpauth_onconnect_chkbtn, 2, 4, 1, 2,
+       gtk_table_attach (GTK_TABLE (serv_table), nntpauth_onconnect_chkbtn, 2, 4, 6, 7,
                          GTK_FILL, 0, 0, 0);
 
        recvserv_entry = gtk_entry_new ();