README.claws 31 KB

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