readme win32

-------------------------------------------------------------------------------[ Name ] Sylpheed 3.2-win32[ Developer ] Hiroyuki Yamamoto[ Location ] http://sylpheed.sraoss.jp/[ Contact ] [email protected][ Required ] Microsoft Windows 2000 Professional / XP / Vista / 7[ Recommnded ] Microsoft Windows XP or later[ Category ] E-Mail client (free software)[ Compression ] ZIP[ Redistribution ] GNU GPL (see COPYING), etc.[ Copyright ] (C) 1999-2012 Hiroyuki Yamamoto-------------------------------------------------------------------------------Description===========Sylpheed is an e-mail client (mailer, MUA).It is simple, lightweight but featureful, and easy-to-use.It supports various protocols such as POP3, IMAP4rev1, and NNTP.SSL is also supported.Sylpheed also supports internationalization (i18n) and multilingualization(m17n). It is currently translated to 29+ languages. The Japanese processingis highly supported. For example, code guessing (ISO-2022-JP/EUC-JP/Shift_JIS/UTF-8), and the support for the environment-dependent characters.Powerful filtering and search function, and learning-type junk mail controlfunction which utilizes external commands are also implemented.PGP features are available if GnuPG is installed. Notice======At the current version, some features implemented in the Unix version, such asActions, are not implemented yet.Please supply the information of "Tools/Log window", or the contents ofsylpheed.log, which is located under the configuration folder, whenreporting bugs.License=======Sylpheed conforms to GNU GPL. See COPYING for detail.GLib, GTK+, Pango, libiconv, GPGME, and LibSylph library conform to GNU LGPL.See COPYING.LIB for detail.Oniguruma library conform to the BSD license. See COPYING.onig for detail.Refer to LICENSE.SSL for the license of OpenSSL library.Refer to LICENSE.curl for Curl.Bsfilter is distributed under the GNU GPL. See COPYING for detail.Install=======(Installer version)Execute the exe file of the installer. When it launched, follow theinstructions.(Zip archive version)Extract the zip archive under the appropriate location.Then, execute sylpheed.exe.Update======(Installer version)Run the installer while Sylpheed is not running.After the previous version is automatically uninstalled, installationwill start.(Zip archive version)Overwrite the contents of zip archive to the folder of the previous versionwhile Sylpheed is not running.On major update, copying the new version after deleting the previous oneis recommended because redundant files may be left.By default, Sylpheed will query to server whether a new version is releasedand display dialog if exists.Usage=====Execute Sylpheed by the desktop icon, or "Start Menu - Sylpheed - Sylpheed".See "Start Menu - Sylpheed - Sylpheed Manual" or "Help - Manual" for detail.Configuration files===================The configuration files and the mailboxes are saved under the followinglocation (%APPDATA%\Sylpheed) by default.Windows 2000/XP:C:\Documents and Settings\(user name)\Application Data\SylpheedWindows Vista/7:C:\Users\(user name)\AppData\Roaming\SylpheedIf you want to change the location of the configuration files, you canspecify it by the command line option: --configdir "directory name".Create a shortcut of sylpheed.exe, and append the option to the link targetlike the following:"C:\Program Files\Sylpheed\sylpheed.exe" --configdir "D:\Sylpheed"If sylpheed.ini file exists at the same location of sylpheed.exe, it will beloaded at startup. Using this, you can make Sylpheed completely portableindependent of drive letters etc, and you can install it in removable mediasuch as USB memory.(Note: The installer version, and GnuPG and GPGME use registry)The sample INI file is included in the package as sample-sylpheed.ini.Please copy or rename it to use.'ipcport' specifies the port number of socket for IPC (default is 50215).'configdir' specifies the location of configuration files as a relativepath from the folder in which sylpheed.exe is located, or an absolute path.Junk mail control=================If you want to enable junk mail control, you have to installSylFilter ( http://sylpheed.sraoss.jp/sylfilter/ ) orbsfilter ( http://bsfilter.org/index-e.html ) additionally.As an easy way of installation, copy sylfilter.exe or bsfilterw.exe into thedirectory which contains sylpheed.exe.Sylpheed installer includes SylFilter or bsfilter, so you only need to enablethe settings to start using it. SylFilter is recommended from the point ofperformance and detection accuracy.SylFilter---------There is no important precaution for SylFilter.The configuration and the database are saved into the following location:(Vista/7) C:\Users\(user name)\AppData\Roaming\SylFilter(XP) C:\Documents and Settings\(user name)\Application Data\SylFilterbsfilter--------If you have installed bsfilter into another location, please note thatthe location of database files will be changed.The files confirmed to work with Sylpheed are also distributed at the followinglocation: http://sylpheed.sraoss.jp/sylpheed/others/bsfilter-1.0.17.rc4.tgz http://sylpheed.sraoss.jp/sylpheed/others/bsfilter-1.0.17.rc4/ bsfilter/bsfilterw.exeNote: bsfilterw.exe which is included in bsfilter-1.0.16.tgz has problem. Please use bsfilter-1.0.17.rc4 or later.If you want to enable PGP features, you have to install GnuPG( http://www.gnupg.org/(en)/download/index.html#auto-ref-1 ).If you want to register Sylpheed as a handler for mailto: protocol after youhave installed it from zip archive, add the entry to the registry bydouble-clicking the included file "sylpheed-mailto-protocol.reg" (you canchoose it while installing by the installer). If Sylpheed is installed intoa location other than C:\Program Files\Sylpheed\sylpheed.exe, modify the path.Uninstall=========(Installer version)Select Sylpheed from "Add or Remove Programs" in the Control Panel, andclick "Change or Remove".(Warning: if the installed version is equal or less than 2.2.3, all files inthe installed folder will be removed, so please be careful if you have createdmailboxes under the installed folder, or you are using bsfilter etc. Other thanthe files or folders created by the installer will not be removed since 2.2.4.)(Zip archive version)Delete the all files with the extracted folder.Delete the configuration files and the mailboxes too if they are notrequired anymore.Other notice============Sylpheed for Windows implements inter-process communication for remoteoperation using TCP socket. Because of this, port 50215 of the loopbackaddress (127.0.0.1) will be consumed.How to add SSL certificates===========================Sylpheed uses OpenSSL library for SSL communication. Because of it, Sylpheedcannot use the Windows certificate store for the verification of certificates.Use the following method to add certificates to Sylpheed:1. Open a CA certificate file, and export it as "Base 64 encoded X509 (.CER)" format.2. Open etc\ssl\certs\certs.crt file under the Sylpheed installed folder with a text editor which supports LF linebreak code.3. Open the exported file in 1., and add it at the head or tail of the certs.crt file.4. Overwrite certs.crt with the edited file. If you want to manage certificates per user, save it as: C:\Documents and Settings\(user name)\Application Data\Sylpheed\certs.crtAdditionally, if you select 'Always accept' when the verification ofcertificates fails, the certificates will be saved to the local settings andthey will be accepted automatically from the next session.