README.claws 32 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878
  1. README.claws
  2. ------------
  3. [last revision: 2004-12-05]
  4. Summary:
  5. 1. What is Sylpheed Claws?
  6. 2. Plugins
  7. 3. Switching between Sylpheed Claws and Sylpheed
  8. 4. Actions
  9. 5. Icon Themes
  10. 6. Spell Checking
  11. 7. Quick Search
  12. 8. Custom toolbar
  13. 9. Partial downloading of POP3 mails
  14. 10. Other things that Claws does differently
  15. 11. Tools
  16. 12. How to contribute
  17. 13. How to request features
  18. 14. Installing Claws from CVS
  19. 15. Release History
  20. 16. Useful Links
  21. 1. What is Sylpheed Claws?
  22. --------------------------
  23. Sylpheed Claws is a extended version of Sylpheed, a light weight mail
  24. user agent for UNIX. Features in this branch may (or may not) end up in
  25. Sylpheed.
  26. Hiroyuki's ChangeLog is also included in the claws-branch distribution,
  27. so it should be easy to spot which features were merged with Sylpheed
  28. (and which features were not).
  29. For brevity Sylpheed Claws is referred to as Claws, and Sylpheed as either
  30. Sylpheed or Main.
  31. 2. Plugins
  32. ----------
  33. All plugins, except SpamAssassin, are built automatically
  34. if the required libraries are present.
  35. Plugins are installed in $PREFIX/lib/sylpheed/plugins/
  36. and have a suffix of '.so'
  37. To load a plugin go to '/Configuration/Plugins' and click
  38. the 'Load Plugin' button.
  39. Select the plugin that you want and click 'OK'
  40. o Clam AntiVirus
  41. Enables the scanning of message attachments in mail
  42. received from a POP, IMAP or LOCAL account using Clam
  43. AntiVirus. It can optionally delete the mail or save it
  44. to a designated folder. Preferences can be found in
  45. 'Configuration/Other Preferences/Filtering/Clam AntiVirus'.
  46. Clam AntiVirus is available from http://clamav.sourceforge.net/
  47. o Dillo HTML Viewer
  48. Enables the viewing of html messages using the Dillo web
  49. browser, version 0.7.0 or newer. It uses Dillo's --local
  50. option by default for safe browsing. Preferences can be
  51. found in 'Configuration/Other Preferences/Message View/
  52. Dillo Browser'. Dillo is available from
  53. http://www.dillo.org/
  54. o Image Viewer
  55. Enables viewing of attached images and replaces the
  56. previous built-in image viewer. Preferences can now be
  57. found in 'Configuration/Other Preferences/Messageview/
  58. Image Viewer'. If the option 'Automatically display
  59. attached images' is not set, the user is presented with
  60. a 'Load Image' button in the messageview and information
  61. about the file.
  62. o MathML Viewer
  63. Enables the viewing of attachments that have the
  64. Content-Type 'text/mathml' using the GtkMathView widget
  65. which is available from
  66. http://helm.cs.unibo.it/mml-widget/
  67. o PGP/MIME
  68. Handles PGP/MIME signed and/or encrypted mails. You can
  69. decrypt mails, verify signatures or sign and encrypt your
  70. own mails.Uses GnuPG/GPGME, <http://www.gnupg.org/gpgme.html>
  71. Relies upon the standard configure option:
  72. --enable-gpgme
  73. o SpamAssassin
  74. Enables the scanning of incoming mail received from a POP,
  75. IMAP or LOCAL account using SpamAssassin. It can optionally
  76. delete mail identified as spam or save it to a designated
  77. folder. Preferences can be found in
  78. 'Configuration/Other Preferences/Filtering/SpamAssassin'.
  79. SpamAssassin is available from http://spamassassin.org
  80. Configure option:
  81. --enable-spamassassin-plugin
  82. o Trayicon
  83. Places an icon in the system tray that indicates whether
  84. you have any new mail. A tooltip also shows the current
  85. new, unread and total number of messages
  86. More plugins can be found here:
  87. http://sylpheed-claws.sourceforge.net/plugins.php
  88. 3. Switching between Sylpheed Claws and Sylpheed
  89. ------------------------------------------------
  90. From Sylpheed to Sylpheed Claws
  91. -------------------------------
  92. From the user perspective Claws is just a fancy Sylpheed, so it uses the
  93. same Sylpheed setting files located in ~/.sylpheed. However, you may wish
  94. to use the ./configure option --with-config-dir=RCDIR, so that you can
  95. preserve your Sylpheed settings.
  96. It's always a good idea to back up all files in ~/.sylpheed in case
  97. you want to switch back to Sylpheed and didn't use the --with-config-dir
  98. option. (You don't have to backup the directories.)
  99. If you use a new configuration directory you will need to manually copy
  100. all of your address book files, ~/.sylpheed/addrbook*
  101. There are some things that frequently come up when switching to Claws:
  102. * What happened to my filter rules?
  103. Claws uses a new filtering system. Your old Sylpheed filter rules will not
  104. be used. In subdirectory tools/ of the distribution there is a Perl script
  105. called filter_conv.pl which converts old filter rules to the claws
  106. filtering system, see tools/README for details. This currently only supports
  107. conversion from Sylpheed's old filtering system, < 0.9.99.
  108. * What happened to the compose email and compose news buttons?
  109. There's a composite button for both composing mail and news. It is toggled
  110. between composing mail and news automatically when a mail or news folder
  111. is selected.
  112. * And to the Preferences and Execute buttons?
  113. Sorry, they're not there.
  114. From Sylpheed Claws to Sylpheed
  115. -------------------------------
  116. Moving from Claws to Sylpheed is also simple. Sylpheed should neglect the things
  117. Claws put in the settings files. This also means that the old rules will work
  118. again.
  119. If you want to switch back to Claws at a later time, and are using the same config
  120. directory for both, make sure you back up at least ~/.sylpheed/matcherrc (the
  121. Claws filtering rules), and ~/.sylpheed/sylpheedrc (which may have some claws
  122. specific settings).
  123. When switching back to Sylpheed you will not lose messages or message flags (color
  124. labels, read / unread status of messages).
  125. 4. Actions
  126. ----------
  127. The "actions" feature is a convenient way for the user to launch external
  128. commands to process a complete message file including headers and body or
  129. just one of its parts. It allows also the use of an external command to
  130. filter the whole text or just a selected part in the message window or in
  131. the compose window. This is a generic tool that allows to do any uncommon
  132. actions on the messages, and thus extends the possibilities of Sylpheed.
  133. For example, Sylpheed does not include the rot13 cyphering algorithm
  134. popular in some newsgroups. It does not support natively armored
  135. encryption or clear signing. It does not support uuencoded messages. As
  136. all these features can be handled by external programs, the actions
  137. provide a convenient way to use them from the menu bar.
  138. a. Usage
  139. --------
  140. To create a new action, go to Configuration -> Actions.... The "Action
  141. Creation" dialog offers to enter the Menu name that will trigger the
  142. command. The created menu will be found in the Tools -> Actions submenu.
  143. By inserting a slash / in the menu name, you create a submenu.
  144. The command is entered in the Command line entry. Note that Sylpheed
  145. stores every single email in a separate file. This allows to use the
  146. following syntax for the command:
  147. * %f denotes the file name of the selected message. If you selected more
  148. than one, then the command will be launched for each message with
  149. the appropriate file name
  150. * %F denotes the list of the file names of the selected message. If only
  151. one message is selected, this amounts to %f, but if more messages
  152. are selected, then the command will be launched only once with the
  153. list of the file names. (You can use both %f and %F in one command:
  154. then the command will be launched for each selected message with
  155. the name of this message and with the list of all selected
  156. messages. I did not find a practical example for this.)
  157. * %p denotes the current selected message part of a multipart message.
  158. The part is decoded accordingly. If the message is not a multipart
  159. message, it denotes the message body.
  160. * Prepending >: this will allow you to send to the command's standard
  161. input a text that you will enter in a dialog window.
  162. * Prepending *: this will allow you to send to the command's standard
  163. input a text that you will enter in a dialog window. But in
  164. contrast to prepending >, the entered text is hidden (useful when
  165. entering passwords).
  166. * Appending an ampersand &: this will run the command asynchronously.
  167. That means "fire and forget". Sylpheed won't wait for the command
  168. to finish, nor will it catch its output or its error messages.
  169. * Prepending the vertical bar | (pipe-in): this will send the current
  170. displayed text or the current selected text from the message view
  171. or the compose window to the command standard input. The command
  172. will silently fail if more than one message is selected.
  173. * Appending the vertical bar | (pipe-out): this will replace the current
  174. displayed text or the current selected text from the message window
  175. or the compose window by the command standard output. The command
  176. will silently fail if more than one message is selected.
  177. Note: It is not possible to use actions containing %f, %F or %p from the
  178. compose window.
  179. When a command is run, and unless it is run asynchronously, Sylpheed will
  180. be insensitive to any interaction and it will wait for the command to
  181. finish. If the command takes too long (5 seconds), it will popup a dialog
  182. window allowing to stop it. This dialog will also be displayed as soon as
  183. the command has some output: error messages or even its standard output
  184. when the command is not a "pipe-out" command. When multiple commands are
  185. being run, they are run in parallel and each command output is separated
  186. from the outputs of the others.
  187. a. Examples
  188. -----------
  189. Here are some examples that are listed in the same syntax as used for
  190. storing the actions list. You can copy and past the definition in your
  191. ~/.sylpheed/actionsrc file (exit Sylpheed before). The syntax is very
  192. simple: one line per action, each action contains the menu name and the
  193. command line separated by a colon and a space ": "
  194. Purpose: rot13 cyphering
  195. Definition: Rot13: |tr a-zA-Z n-za-mN-ZA-M|
  196. Details: This will apply the rot13 cyphering algorithm to the
  197. (selected) text in the message/compose view.
  198. Purpose: Decoding uuencoded messages
  199. Definition: UUdeview: xdeview %F&
  200. Details: xdeview comes with uudeview. If an encoded file is split in
  201. multiple messages, just select them all and run the command.
  202. Purpose: Display uuencoded image
  203. Definition: Display uuencoded: uudec %f&
  204. Details: Displays uuencoded files. The uudec[1] script can be found in
  205. the 'tools' directory of the distribution package.
  206. Purpose: Alter messages
  207. Definition: Edit message: gvim -f %F
  208. Details: Allows editing of any received message. Can be used to remove
  209. unneeded message parts, etc.
  210. Purpose: Pretty format
  211. Definition: Par: |par 72Tbgjqw74bEe B=._A_a 72bg|
  212. Details: par is a utility that can pretty format any text. It does a
  213. very good job in indenting quoted messages, and justifying
  214. text. Used when composing a message
  215. Purpose: Browse
  216. Definition: Part/Dillo: dillo %p&
  217. Details: Browse the selected message part in Dillo.
  218. Purpose: Clear Sign
  219. Definition: GnuPG/Clear Sign: |gpg-sign-syl|
  220. Details: Clear sign a message. The gpg-sign-syl[2] script is responsible
  221. for asking the passphrase and for running gnupg.
  222. Purpose: Verify Clear Signed
  223. Definition: GnuPG/Verify: |gpg --no-tty --verify
  224. Details: Verify clear signed messages. The result is displayed in the
  225. actions output dialog.
  226. Purpose: Decrypt ASCII Armored
  227. Definition: GnuPG/Decrypt: *gpg --no-tty --command-fd 0 --passphrase-fd 0 --decrypt %f|
  228. Details: Decrypt ASCII armored messages. The passphrase is entered
  229. into the opened action's input dialog.
  230. [1] The uudec script can be found in the 'tools' directory of the
  231. distribution package. It needs uudecode and ImageMagick's display. The
  232. latter can be replaced by any image viewer that can get input from
  233. standard input. The script could also be modified to use temporary files
  234. instead of standard input.
  235. [2] The gpg-sign-syl script can be found in the 'tools' directory of the
  236. distribution package.
  237. 5. Icon Themes
  238. --------------
  239. Claws has support for different icon sets. Several icon sets can be
  240. downloaded from http://sylpheed-claws.sourceforge.net/themes.php
  241. You will need to create a directory called 'themes' in your config
  242. directory, unpack them into this directory, and then use the interface
  243. to select them, /Configuration/Preferences/Display/Themes
  244. This interface can also be used to install new themes.
  245. 6. Spell Checking
  246. -----------------
  247. a. Requirements
  248. b. Configuration and installation
  249. c. Usage
  250. d. Known problems
  251. a. Requirements
  252. ---------------
  253. Note:
  254. As for version 0.8.3 (and cvs version 0.8.2claws3), Sylpheed-Claws uses
  255. the new GNU/aspell 0.50 for spell checking instead of the obsolete pspell
  256. and old aspell 0.33.x. You will need to upgrade your system. See
  257. http://www.gnu.org/software/aspell for instructions on how to do this.
  258. The spell checker in Sylpheed requires the new GNU/aspell library
  259. (http://www.gnu.org/software/aspell), version 0.50 or newer.
  260. You also need the dictionaries. Check GNU/aspell home page for how
  261. to download and install them.
  262. NB: The old dictionaries used by the old aspell will not work.
  263. b. Configuring Sylpheed
  264. -----------------------
  265. Spell checking is enabled if you configure Sylpheed appropriately. Add
  266. the option '--enable-aspell' when configuring. E.g.:
  267. ./configure --enable-aspell
  268. The configure script needs the 'aspell' executable to be in your path.
  269. If it is in unusual places, use '--with-aspell-prefix' to tell the path of
  270. the aspell executable. E.g., if aspell's full path is
  271. /foo/bar/bin/aspell, then use:
  272. ./configure --enable-aspell --with-aspell-prefix=/foo/bar
  273. The '--with-aspell-prefix=PREFIX' option will let the configure
  274. script search for includes and libraries in PREFIX/include and PREFIX/lib.
  275. You can also specify manually the includes and libraries path by using
  276. either following options:
  277. --with-aspell-includes=/foo/bar/include
  278. and/or
  279. --with-aspell-libs=/rab/oof/lib
  280. as appropriate.
  281. The configure script summarizes the options compiled in. Check that
  282. it lists 'GNU/aspell = yes'.
  283. Then proceed as usual, with 'make' and 'make install'.
  284. c. Usage
  285. --------
  286. NOTE: if you upgraded from Sylpheed-Claws 0.8.2 (or cvs version 0.8.2claws2)
  287. or earlier, please check if the dictionary path was updated in the
  288. Configuration -> Common Preferences -> Spell Checker menu. If not, update
  289. it accordingly as explained below.
  290. After successful compiling, you need to tell Sylpheed where your
  291. dictionaries reside. The configure script should have found it,
  292. but in case it did not, run 'aspell config dict-dir' on the
  293. shell to get the path to the dictionaries.
  294. Then run Sylpheed and go to Configuration -> Common preferences ->
  295. Spell Checker. Check the box 'Enable spell checker' and
  296. use the file selector ('...' button) to select the path where the
  297. dictionaries reside. Within the file selector, go to that directory
  298. and select *any* file in the file lists. Click OK. Then, you should
  299. be able to select your default dictionary.
  300. When composing, misspelled words are highlighted. Click on any
  301. highlighted word with the right mouse button to get a list of
  302. suggestions. The first entry of the menu just displays the unknown
  303. word. Selecting 'Accept in this session' (or hitting MOD1-Space,
  304. where MOD1 is usually the ALT key) will ignore this word and accept
  305. it in this message. Selecting the next entry, "Add to dictionary", which
  306. is bound to MOD1-Enter combination, will add the unknown word to your
  307. personal dictionary to learn it. The next entries are the suggested words.
  308. The first 15 suggestions can be accessed by typing one of the first letters
  309. of Latin alphabet (if this does not suit your language, please send
  310. a mail to melvin.hadasht@free.fr). Aspell has a 'learn from mistake'
  311. function that can be used by pressing the MOD1 key and selecting the
  312. suggestion (with the keyboard or with the mouse). See GNU/aspell manual
  313. §6.3 for an explanation of this feature (also called 'replacement storing').
  314. If you click with the right mouse button everywhere else, or if you
  315. shift-right-click even on a misspelled word, you get the
  316. configuration menu. 'Check all' highlights all misspelled words.
  317. With this menu, you can also change the dictionary while editing.
  318. Finally, you can change the suggestion mode, and the learn from
  319. misktakes feature.
  320. Spell checking can also be done using keyboard shortcuts. In the
  321. 'Edit' menu of the compose window, there are two menus 'Check backwards
  322. misspelled word' and 'Forward to next misspelled word'. Add to them
  323. appropriate keyboard shortcuts. 'Check backwards misspelled word'
  324. checks backwards from cursor position for the first misspelled word.
  325. If it finds one, it displays the suggestions lists which can be handled
  326. with the keyboard as described before. When the suggestion menu is
  327. closed, the cursor returns to its original position to be able to
  328. continue editing. The 'Forward to next misspelled word' do the same
  329. thing in the other direction but moves the cursor at the end of the
  330. misspelled word. This way, you can spell check easily a whole message
  331. starting from its beginning and using the 'Forward to next misspelled
  332. word' keyboard short cut.
  333. d. Known problems
  334. -----------------
  335. No known problems as the time of this writing (0.8.2claws3).
  336. 7. Quick Search with extended search
  337. ------------------------------------
  338. Quick Search, with its powerful Extended search function,
  339. enables searching through folder's messages.
  340. Extended Search allows one to define criteria that messages must
  341. have in order to match and be displayed in the summary view pane.
  342. Search types titled From, Subject and To are self explanatory.
  343. Search type extended allows one to use Sylpheed's powerful
  344. filtering engine to select messages. Examples:
  345. from regexpcase "foo"
  346. subject regexp "Bug" & to regexp "sylpheed-claws"
  347. Additionally, it is possible to use simpler yet equally
  348. powerfull patterns for message selections. Mutt users will
  349. immediately recognise most of the available patterns:
  350. Pattern Parameter Selects
  351. ----------------------------------------------------
  352. a all messages
  353. ag # messages whose age is greater than #
  354. al # messages whose age is lower than #
  355. b S messages which contain S in the message body
  356. B S messages which contain S in the whole message
  357. c S messages carbon-copied to S
  358. C S message is either to: or cc: to S
  359. D deleted messages
  360. e S messages which contain S in the Sender field
  361. E S true if execute "S" succeeds
  362. f S messages originating from user S
  363. F forwarded messages
  364. h S messages which contain header S
  365. i S messages which contain S in Message-Id header
  366. I S messages which contain S in inreplyto header
  367. L locked messages
  368. n S messages which are in newsgroup S
  369. N new messages
  370. O old messages
  371. r messages which have been replied to
  372. R read messages
  373. s S messages which contain S in subject
  374. se # messages whose score is equal to #
  375. sg # messages whose score is greater than #
  376. sl # messages whose score is lower than #
  377. Se # messages whose size is equal to #
  378. Sg # messages whose size is greater than #
  379. Ss # messages whose size is smaller than #
  380. t S messages which have been sent to S
  381. T marked messages
  382. U unread messages
  383. x S messages which contain S in References header
  384. y S messages which contain S in X-Label header
  385. # means number
  386. S means regexp string
  387. It is possible to use logical operators AND (&), OR (|) and
  388. NOT (! or ~). Case sensitive search is achieved with %.
  389. Examples:
  390. T marked messages
  391. U unread messages
  392. f "john beavis" messages from john beavis
  393. %f "John Beavis" messages from John Beavis (case sensitive)
  394. ~s foo messages which do not have foo in the subject
  395. f foo & ~s bar messages from foo that do not have bar in thesubject
  396. 8. Custom toolbar
  397. -----------------
  398. /Configuration/Preferences/Customize Toolbars lets you define the
  399. toolbar you want. The configuration dialog enables you to set an icon,
  400. an appropriate text, and map an action to it. Actions to choose
  401. from are predefined. You can also have your "Sylpheed Actions" (refer
  402. to "Actions" above) on your toolbar.
  403. Example:
  404. * Configuration->Actions
  405. - add an entry "Dillo: dillo %p&"
  406. * Configuration->Custom toolbar
  407. - select Sylpheed Actions Feature
  408. - select "Dillo: dillo %p&" from drop down list
  409. - choose an icon and click ok
  410. 9. Partial downloading of POP3 mails
  411. ------------------------------------
  412. Messages over the configured size limit, (/[Account preferences]/
  413. Receive/Message size limit), will be partially retrieved. These
  414. messages will have a Notice View displayed (above the Message View),
  415. informing of the partially retrieved state and the total size of the
  416. message. The Notice View will also contain two buttons, 'Mark for
  417. download' and 'Mark for deletion'. If the user clicks 'Mark for
  418. download', the message will be downloaded in full at the next message
  419. retrieval, (and the partial one deleted); if the user checks 'Mark for
  420. deletion' it will be removed from the server after the normal delay
  421. as specified in the POP3 account's 'Receive' preferences.
  422. If a user moves a partially retrieved message to the Trash folder
  423. it will be deleted on the server at the next retrieval after the
  424. Trash folder has been emptied.
  425. 10. Other things that Claws does differently
  426. --------------------------------------------
  427. Claws does a lot of things differently. Here is a quick run-down of
  428. just a few of them:
  429. * auto address replacement in summary view
  430. This matches a plain email address with a person in the address book.
  431. This feature is enabled in /Configuration/Preferences/Common/Display
  432. 'Display sender using addressbook'
  433. * manual selection of MIME types for attachments
  434. You can change the MIME type of an attachment by right-clicking in the
  435. attachment list, selecting Property in the menu. The MIME type list
  436. is a combo box with the known MIME types.
  437. * sharing mail folders
  438. You can also share or use shared mail folders. Right-click a folder and
  439. select Properties. Change the Folder chmod setting.
  440. * simplify subject string
  441. It is possible to remove parts of subject string from the displayed
  442. subject line.
  443. Example:
  444. True Subject: [Sylpheed-claws-users] This is a test
  445. Displayed Subject: This is a test
  446. Regexp: \[Sylpheed-claws-(devel|users)\]
  447. This is a per folder property. Right click on a folder and select
  448. Properties, enable Simplify Subject RegExp check box.
  449. * new cache
  450. New cache is a new data cache structure for sylpheed, that will
  451. solve many of the problems sylpheed currently has with updates to
  452. flags. But you will also notice a large speed gain when you open
  453. these folders.
  454. New cache uses two new configuration parameters that can be
  455. adjusted in ~/[RCDIR]/sylpheedrc (no gui for them available yet).
  456. cache_max_mem_usage (default: 4096)
  457. the maximum kB of memory sylpheed should use.
  458. It will try to keep the memory usage below this
  459. value, but it will always use the assigned
  460. amount of memory for speed gain.
  461. cache_min_keep_time (default: 15)
  462. the minimum time in minutes sylpheed will keep
  463. the folder cache in memory. If a cache is more
  464. recent than this time it will not be freed even
  465. if the memory usage is above the maximum. You
  466. should probably set this value higher than your
  467. mail check interval. Otherwise the cache will
  468. always be freed between checks even if the folder
  469. is accessed on every check, which will cause much
  470. disk IO.
  471. The check if memory can be freed is currently done after the
  472. active folder has been changed or whenever a new cache is read,
  473. i.e. triggered by mail incorporation.
  474. New mails in MH folders are not detected automatically like before,
  475. when you enter the folder. You have to update the folder manually,
  476. or activate the auto update setting in the options.
  477. * SMTP Message Size Declaration
  478. If the server supports it, oversize messages will not be sent and
  479. the maximum allowed message size will be displayed in the log,
  480. (/Tools/Log window/).
  481. * Reply-finder
  482. Clicking on the replied icon in the Status (S) column of the summary
  483. view will attempt to find and display your reply that is stored in
  484. your Outbox.
  485. * pop before smtp authentication
  486. * Automatic saving of message when composing
  487. * signature in the message view can be coloured
  488. * built-in gdb crash handler
  489. * extra Font configuration
  490. * message scoring
  491. * 'hide read messages' feature
  492. * Request Return-Receipt
  493. * ability to change folder order
  494. * 'ignore thread' marking
  495. * message priority setting
  496. * Automatic message drafting and cache saving on kill
  497. * SSL certificate management and checking
  498. * Indication of unread answers to marked mails:
  499. '(!)' is appended to the folder name when a marked message
  500. has a response
  501. * address auto-completion includes a dynamic LDAP search
  502. * address auro-completion works on nicknames and aliases
  503. * Password encryption in config files is implemented using
  504. unix encrypt and setkey functions.
  505. This is not an exhaustive list.
  506. 11. Tools
  507. ---------
  508. You will find all of these tools in the 'tools' directory:
  509. calypso_convert.pl
  510. import mbox files exported by calypso
  511. convert_mbox.pl
  512. convert mbox format to MH format
  513. eud2gc.py
  514. convert a Eudora (v.3?) addressbook to vCard
  515. (GnomeCard) format
  516. filter_conv.pl
  517. convert sylpheed main's filter rules, (< 0.9.99),
  518. into Claws' filtering format
  519. freshmeat_search.pl
  520. Actions script to lookup the selected text on
  521. Freshmeat www.freshmeat.net using the configured
  522. browser
  523. gif2xface.pl
  524. convert a gif file to an xface
  525. google_msgid.pl
  526. Actions script to lookup selected message-id on
  527. google using mozilla.
  528. google_search.pl
  529. Actions script to lookup up the selected text on
  530. google using the configured browser
  531. gpg-sign-syl
  532. GnuPG cleartext-signing script for use with
  533. Actions
  534. kmail2sylpheed.pl
  535. convert a Kmail addressbook to a Sylpheed
  536. addressbook
  537. kmail2sylpheed_v2.pl
  538. new version of the address book conversion script
  539. for newer versions of Kmail/Kaddressbook
  540. maildir2sylpheed.pl
  541. convert a maildir format mailbox into MH format
  542. multiwebsearch.pl
  543. search any searchable website for the selected text
  544. nautilus2sylpheed.sh
  545. enables sending files from the Nautilus file manager
  546. to Sylpheed
  547. OOo2sylpheed.pl
  548. enable OpenOffice to send documents through
  549. sylpheed
  550. outlook2sylpheed.pl
  551. convert an Outlook contacts list to a Sylpheed
  552. addressbook
  553. sylpheed-switcher
  554. enable quick-switching between claws and main
  555. in a non-destructive way
  556. sylprint.pl
  557. process a Sylpheed mail and print it using enscript
  558. if available or lpr if not
  559. tb2sylpheed
  560. convert an addressbook exported from The Bat! into
  561. a Sylpheed addressbook
  562. textviewer.sh
  563. attempt to view an attachment as plain text
  564. update-po
  565. translators' tool that eases the creation of
  566. *.po files
  567. uudec
  568. decode UUencoded mails, for use with Actions
  569. kdeservicemenu/*
  570. Service Menus for Konqueror to allow attaching files and
  571. compressing/attaching files/directories to a new Compose
  572. window
  573. 12. How to contribute
  574. ---------------------
  575. You are encourged to send patches via the Sylpheed-Claws sourceforge
  576. project's Patch Tracker.
  577. http://sourceforge.net/tracker/?atid=384600&group_id=25528&func=browse
  578. If that's too troublesome, either contact Paul Mangan or consider
  579. posting to the Sylpheed-Claws-users mailing list.
  580. http://lists.sourceforge.net/lists/listinfo/sylpheed-claws-users
  581. Bugs can be reported with Claws' bugzilla at:
  582. http://www.thewildbeast.co.uk/sylpheed-claws/bugzilla/index.cgi
  583. Of course, you can also post to the Sylpheed-Claws-users mailing list.
  584. Also, we really try to incorporate good contributions, but sometimes we
  585. don't have enough time. If the contribution is really big, or requires
  586. a long time to stabilize, send a mail to Paul Mangan. We can probably
  587. arrange access to the Sylpheed-Claws CVS tree.
  588. 13. How to request features
  589. ---------------------------
  590. Ask around in Sylpheed-Claws-users ML. Note that some developers may
  591. have already thought about your feature, may,perhaps, be implementing it,
  592. or the feature was already discussed and rejected for whatever reason.
  593. You might want to go ahead and hack a patch for it. (That would be very
  594. cool!) Another possibility is to use the Feature Request Tracker at the
  595. sourceforge project.
  596. http://sourceforge.net/tracker/?group_id=25528&atid=384601
  597. 14. Installing Claws from CVS
  598. -----------------------------
  599. a. Downloading
  600. --------------
  601. To download the latest cvs cd to the directory where you wish to download
  602. to and type the following information:
  603. cvs -d:pserver:anonymous@cvs.sourceforge.net:/cvsroot/sylpheed-claws login
  604. When prompted for a password press the RETURN key.
  605. After anonymously logging in:
  606. cvs -z3 -d:pserver:anonymous@cvs.sourceforge.net:/cvsroot/sylpheed-claws co sylpheed-claws
  607. b. Installing
  608. -------------
  609. To compile and install use the following commands:
  610. ./autogen.sh [add configure options as required]
  611. make
  612. make install [as root]
  613. You will need a full set of development tools installed to be able to run
  614. autogen.sh. See also ac/README.
  615. 15. Release History
  616. -------------------
  617. 2004-12-06 0.9.13
  618. 2004-09-27 0.9.12b
  619. 2004-08-23 0.9.12a
  620. 2004-06-28 0.9.12
  621. 2004-05-31 0.9.11claws
  622. 2004-03-08 0.9.10claws
  623. 2004-02-06 0.9.9claws
  624. 2003-12-19 0.9.8claws
  625. 2003-11-26 0.9.7claws
  626. 2003-10-02 0.9.6claws
  627. 2003-09-10 0.9.5claws
  628. 2003-08-04 0.9.4claws
  629. 2003-07-12 0.9.3claws
  630. 2003-05-24 0.9.0claws
  631. 2003-03-12 0.8.11claws
  632. 2003-02-12 0.8.10claws
  633. 2003-01-24 0.8.9claws
  634. 2002-12-26 0.8.8claws
  635. 2002-12-23 0.8.7claws
  636. 2002-11-25 0.8.6claws
  637. 2002-10-07 0.8.5claws
  638. 2002-09-22 0.8.3claws
  639. 2002-08-28 0.8.2claws
  640. 2002-07-30 0.8.1claws
  641. 2002-07-23 0.8.0claws
  642. 2002-06-15 0.7.8claws
  643. 2002-05-18 0.7.6claws
  644. 2002-04-28 0.7.5claws
  645. 2002-03-11 0.7.4claws
  646. 2002-02-19 0.7.2claws
  647. 2002-02-14 0.7.1claws
  648. 2002-01-14 0.7.0claws
  649. 2001-12-16 0.6.6claws
  650. 2001-10-16 0.6.5claws8
  651. 2001-09-30 0.6.2claws
  652. 2001-08-14 0.6.1claws
  653. 2001-07-13 0.5.1claws
  654. 2001-07-01 0.5.0claws3
  655. 2001-06-16 0.4.99claws
  656. 2001-05-29 0.4.99claws3
  657. 2001-05-11 0.4.67claws1
  658. 16. Useful links
  659. ----------------
  660. Homepage
  661. http://sylpheed-claws.sourceforge.net/
  662. Sylpheed-Claws for Windows homepage
  663. http://sylpheed-claws.sourceforge.net/win32/
  664. FAQ
  665. http://sylpheed-claws.sourceforge.net/phpwiki/
  666. Project page
  667. http://sourceforge.net/projects/sylpheed-claws/
  668. Downloads
  669. http://sourceforge.net/project/showfiles.php?group_id=25528
  670. External Plugins
  671. http://sylpheed-claws.sourceforge.net/plugins.php
  672. Icon Themes
  673. http://sylpheed-claws.sourceforge.net/themes.php
  674. CVS webview
  675. http://cvs.sourceforge.net/cgi-bin/viewcvs.cgi/sylpheed-claws/sylpheed-claws/
  676. Users Mailing List subscription page
  677. http://lists.sourceforge.net/lists/listinfo/sylpheed-claws-users/
  678. Users Mailing List archive
  679. http://sourceforge.net/mailarchive/forum.php?forum=sylpheed-claws-users/
  680. Commits Announcement List subscription page
  681. http://lists.sourceforge.net/lists/listinfo/sylpheed-claws-commits/
  682. Commits Announcement List archive
  683. http://sourceforge.net/mailarchive/forum.php?forum=sylpheed-claws-commits/
  684. Bug Tracker
  685. http://www.thewildbeast.co.uk/sylpheed-claws/bugzilla/index.cgi
  686. Feature Request Tracker
  687. http://sourceforge.net/tracker/?group_id=25528&atid=384601
  688. Patch Tracker
  689. http://sourceforge.net/tracker/?group_id=25528&atid=384600
  690. Internationalisation Status
  691. http://sylpheed-claws.sourceforge.net/i18n.php