commit - 0ff4587f0a234a51c6e99607620f466629b9faff
commit + 36067e24da07e071cb6ca722029a484ac9d48fed
blob - e32d52d2b7d231897f74b7a5723e5617970ba78b (mode 644)
blob + /dev/null
--- ABOUT-NLS
+++ /dev/null
-1 Notes on the Free Translation Project
-***************************************
-
-Free software is going international! The Free Translation Project is
-a way to get maintainers of free software, translators, and users all
-together, so that free software will gradually become able to speak many
-languages. A few packages already provide translations for their
-messages.
-
- If you found this `ABOUT-NLS' file inside a distribution, you may
-assume that the distributed package does use GNU `gettext' internally,
-itself available at your nearest GNU archive site. But you do _not_
-need to install GNU `gettext' prior to configuring, installing or using
-this package with messages translated.
-
- Installers will find here some useful hints. These notes also
-explain how users should proceed for getting the programs to use the
-available translations. They tell how people wanting to contribute and
-work on translations can contact the appropriate team.
-
- When reporting bugs in the `intl/' directory or bugs which may be
-related to internationalization, you should tell about the version of
-`gettext' which is used. The information can be found in the
-`intl/VERSION' file, in internationalized packages.
-
-1.1 Quick configuration advice
-==============================
-
-If you want to exploit the full power of internationalization, you
-should configure it using
-
- ./configure --with-included-gettext
-
-to force usage of internationalizing routines provided within this
-package, despite the existence of internationalizing capabilities in the
-operating system where this package is being installed. So far, only
-the `gettext' implementation in the GNU C library version 2 provides as
-many features (such as locale alias, message inheritance, automatic
-charset conversion or plural form handling) as the implementation here.
-It is also not possible to offer this additional functionality on top
-of a `catgets' implementation. Future versions of GNU `gettext' will
-very likely convey even more functionality. So it might be a good idea
-to change to GNU `gettext' as soon as possible.
-
- So you need _not_ provide this option if you are using GNU libc 2 or
-you have installed a recent copy of the GNU gettext package with the
-included `libintl'.
-
-1.2 INSTALL Matters
-===================
-
-Some packages are "localizable" when properly installed; the programs
-they contain can be made to speak your own native language. Most such
-packages use GNU `gettext'. Other packages have their own ways to
-internationalization, predating GNU `gettext'.
-
- By default, this package will be installed to allow translation of
-messages. It will automatically detect whether the system already
-provides the GNU `gettext' functions. If not, the included GNU
-`gettext' library will be used. This library is wholly contained
-within this package, usually in the `intl/' subdirectory, so prior
-installation of the GNU `gettext' package is _not_ required.
-Installers may use special options at configuration time for changing
-the default behaviour. The commands:
-
- ./configure --with-included-gettext
- ./configure --disable-nls
-
-will, respectively, bypass any pre-existing `gettext' to use the
-internationalizing routines provided within this package, or else,
-_totally_ disable translation of messages.
-
- When you already have GNU `gettext' installed on your system and run
-configure without an option for your new package, `configure' will
-probably detect the previously built and installed `libintl.a' file and
-will decide to use this. This might not be desirable. You should use
-the more recent version of the GNU `gettext' library. I.e. if the file
-`intl/VERSION' shows that the library which comes with this package is
-more recent, you should use
-
- ./configure --with-included-gettext
-
-to prevent auto-detection.
-
- The configuration process will not test for the `catgets' function
-and therefore it will not be used. The reason is that even an
-emulation of `gettext' on top of `catgets' could not provide all the
-extensions of the GNU `gettext' library.
-
- Internationalized packages usually have many `po/LL.po' files, where
-LL gives an ISO 639 two-letter code identifying the language. Unless
-translations have been forbidden at `configure' time by using the
-`--disable-nls' switch, all available translations are installed
-together with the package. However, the environment variable `LINGUAS'
-may be set, prior to configuration, to limit the installed set.
-`LINGUAS' should then contain a space separated list of two-letter
-codes, stating which languages are allowed.
-
-1.3 Using This Package
-======================
-
-As a user, if your language has been installed for this package, you
-only have to set the `LANG' environment variable to the appropriate
-`LL_CC' combination. Here `LL' is an ISO 639 two-letter language code,
-and `CC' is an ISO 3166 two-letter country code. For example, let's
-suppose that you speak German and live in Germany. At the shell
-prompt, merely execute `setenv LANG de_DE' (in `csh'),
-`export LANG; LANG=de_DE' (in `sh') or `export LANG=de_DE' (in `bash').
-This can be done from your `.login' or `.profile' file, once and for
-all.
-
- You might think that the country code specification is redundant.
-But in fact, some languages have dialects in different countries. For
-example, `de_AT' is used for Austria, and `pt_BR' for Brazil. The
-country code serves to distinguish the dialects.
-
- The locale naming convention of `LL_CC', with `LL' denoting the
-language and `CC' denoting the country, is the one use on systems based
-on GNU libc. On other systems, some variations of this scheme are
-used, such as `LL' or `LL_CC.ENCODING'. You can get the list of
-locales supported by your system for your country by running the command
-`locale -a | grep '^LL''.
-
- Not all programs have translations for all languages. By default, an
-English message is shown in place of a nonexistent translation. If you
-understand other languages, you can set up a priority list of languages.
-This is done through a different environment variable, called
-`LANGUAGE'. GNU `gettext' gives preference to `LANGUAGE' over `LANG'
-for the purpose of message handling, but you still need to have `LANG'
-set to the primary language; this is required by other parts of the
-system libraries. For example, some Swedish users who would rather
-read translations in German than English for when Swedish is not
-available, set `LANGUAGE' to `sv:de' while leaving `LANG' to `sv_SE'.
-
- Special advice for Norwegian users: The language code for Norwegian
-bokma*l changed from `no' to `nb' recently (in 2003). During the
-transition period, while some message catalogs for this language are
-installed under `nb' and some older ones under `no', it's recommended
-for Norwegian users to set `LANGUAGE' to `nb:no' so that both newer and
-older translations are used.
-
- In the `LANGUAGE' environment variable, but not in the `LANG'
-environment variable, `LL_CC' combinations can be abbreviated as `LL'
-to denote the language's main dialect. For example, `de' is equivalent
-to `de_DE' (German as spoken in Germany), and `pt' to `pt_PT'
-(Portuguese as spoken in Portugal) in this context.
-
-1.4 Translating Teams
-=====================
-
-For the Free Translation Project to be a success, we need interested
-people who like their own language and write it well, and who are also
-able to synergize with other translators speaking the same language.
-Each translation team has its own mailing list. The up-to-date list of
-teams can be found at the Free Translation Project's homepage,
-`http://www.iro.umontreal.ca/contrib/po/HTML/', in the "National teams"
-area.
-
- If you'd like to volunteer to _work_ at translating messages, you
-should become a member of the translating team for your own language.
-The subscribing address is _not_ the same as the list itself, it has
-`-request' appended. For example, speakers of Swedish can send a
-message to `sv-request@li.org', having this message body:
-
- subscribe
-
- Keep in mind that team members are expected to participate
-_actively_ in translations, or at solving translational difficulties,
-rather than merely lurking around. If your team does not exist yet and
-you want to start one, or if you are unsure about what to do or how to
-get started, please write to `translation@iro.umontreal.ca' to reach the
-coordinator for all translator teams.
-
- The English team is special. It works at improving and uniformizing
-the terminology in use. Proven linguistic skill are praised more than
-programming skill, here.
-
-1.5 Available Packages
-======================
-
-Languages are not equally supported in all packages. The following
-matrix shows the current state of internationalization, as of May 2005.
-The matrix shows, in regard of each package, for which languages PO
-files have been submitted to translation coordination, with a
-translation percentage of at least 50%.
-
- Ready PO files af am ar az be bg bs ca cs cy da de el en en_GB
- +-------------------------------------------------+
- GNUnet | |
- a2ps | [] [] [] [] [] |
- aegis | () |
- ant-phone | () |
- anubis | [] |
- ap-utils | |
- aspell | [] [] [] [] |
- bash | [] [] |
- batchelor | [] |
- bfd | |
- bibshelf | [] |
- binutils | [] |
- bison | [] [] |
- bluez-pin | [] [] [] [] |
- clisp | [] [] |
- console-tools | [] [] |
- coreutils | [] [] [] [] |
- cpio | |
- cpplib | [] [] [] |
- darkstat | [] () [] |
- dialog | [] [] [] [] [] [] |
- diffutils | [] [] [] [] [] |
- doodle | [] |
- e2fsprogs | [] [] |
- enscript | [] [] [] [] |
- error | [] [] [] [] |
- fetchmail | [] [] () [] |
- fileutils | [] [] |
- findutils | [] [] [] |
- flex | [] [] [] |
- fslint | [] |
- gas | |
- gawk | [] [] [] |
- gbiff | [] |
- gcal | [] |
- gcc | [] |
- gettext-examples | [] [] [] [] |
- gettext-runtime | [] [] [] [] |
- gettext-tools | [] [] |
- gimp-print | [] [] [] [] |
- gip | |
- gliv | [] |
- glunarclock | |
- gmult | [] [] |
- gnubiff | () |
- gnucash | [] () () [] |
- gnucash-glossary | [] () |
- gpe-aerial | [] [] |
- gpe-beam | [] [] |
- gpe-calendar | [] [] |
- gpe-clock | [] [] |
- gpe-conf | [] [] |
- gpe-contacts | |
- gpe-edit | [] |
- gpe-go | [] |
- gpe-login | [] [] |
- gpe-ownerinfo | [] [] |
- gpe-sketchbook | [] [] |
- gpe-su | [] [] |
- gpe-taskmanager | [] [] |
- gpe-timesheet | [] |
- gpe-today | [] [] |
- gpe-todo | [] [] |
- gphoto2 | [] [] [] [] |
- gprof | [] [] |
- gpsdrive | () () |
- gramadoir | [] [] |
- grep | [] [] [] [] [] [] |
- gretl | |
- gsasl | [] |
- gss | |
- gst-plugins | [] [] [] [] [] [] |
- gstreamer | [] [] [] [] [] |
- gtick | [] () |
- gtkspell | [] [] [] |
- hello | [] [] [] [] |
- id-utils | [] [] |
- impost | |
- indent | [] [] |
- iso_3166 | |
- iso_3166_1 | [] [] [] [] [] |
- iso_3166_2 | |
- iso_3166_3 | [] |
- iso_4217 | |
- iso_639 | |
- jpilot | [] |
- jtag | |
- jwhois | |
- kbd | [] [] [] [] |
- latrine | () |
- ld | [] |
- libc | [] [] [] [] [] |
- libextractor | |
- libgpewidget | [] [] [] |
- libgphoto2 | [] |
- libgphoto2_port | [] |
- libgsasl | |
- libiconv | [] [] [] [] [] |
- libidn | |
- lifelines | [] () |
- lilypond | [] |
- lingoteach | |
- lynx | [] [] [] [] |
- m4 | [] [] [] [] |
- mailutils | [] |
- make | [] [] |
- man-db | [] () [] [] |
- minicom | [] [] |
- mysecretdiary | [] [] |
- nano | [] () [] |
- nano_1_0 | [] () [] [] |
- opcodes | [] |
- parted | [] [] [] [] |
- psmisc | |
- ptx | [] [] [] |
- pwdutils | |
- python | |
- radius | [] |
- recode | [] [] [] [] [] |
- rpm | [] [] |
- screem | |
- scrollkeeper | [] [] [] [] [] [] [] [] |
- sed | [] [] |
- sh-utils | [] [] |
- shared-mime-info | [] [] |
- sharutils | [] [] [] [] [] |
- silky | |
- skencil | [] () |
- sketch | [] () |
- solfege | [] |
- soundtracker | [] [] |
- sp | [] |
- stardict | [] |
- tar | |
- texinfo | [] [] |
- textutils | [] [] [] |
- tin | () () |
- tp-robot | [] |
- tuxpaint | [] [] [] [] [] [] [] |
- unicode-han-tra... | |
- unicode-transla... | |
- util-linux | [] [] [] [] |
- vorbis-tools | [] [] [] [] |
- wastesedge | () |
- wdiff | [] [] [] [] |
- wget | |
- xchat | [] [] [] [] [] |
- xkeyboard-config | |
- xpad | |
- +-------------------------------------------------+
- af am ar az be bg bs ca cs cy da de el en en_GB
- 10 0 0 2 7 5 0 40 43 2 51 91 19 1 14
-
- eo es et eu fa fi fr ga gl he hi hr hu id is
- +-----------------------------------------------+
- GNUnet | |
- a2ps | [] [] [] |
- aegis | |
- ant-phone | [] |
- anubis | [] |
- ap-utils | [] |
- aspell | [] [] |
- bash | [] [] [] [] |
- batchelor | [] [] |
- bfd | [] |
- bibshelf | [] [] |
- binutils | [] [] |
- bison | [] [] [] [] [] |
- bluez-pin | [] [] [] [] [] [] |
- clisp | [] [] |
- console-tools | |
- coreutils | [] [] [] [] [] |
- cpio | [] [] |
- cpplib | [] [] |
- darkstat | [] () [] [] [] |
- dialog | [] [] [] [] [] [] [] |
- diffutils | [] [] [] [] [] [] [] [] [] |
- doodle | [] |
- e2fsprogs | [] [] |
- enscript | [] [] |
- error | [] [] [] [] [] |
- fetchmail | [] |
- fileutils | [] [] [] [] [] |
- findutils | [] [] [] [] |
- flex | [] [] [] |
- fslint | [] |
- gas | [] [] |
- gawk | [] [] [] [] |
- gbiff | [] |
- gcal | [] [] |
- gcc | [] |
- gettext-examples | [] [] [] |
- gettext-runtime | [] [] [] [] [] |
- gettext-tools | [] [] |
- gimp-print | [] [] |
- gip | [] [] [] |
- gliv | () |
- glunarclock | [] [] [] |
- gmult | [] [] |
- gnubiff | () |
- gnucash | [] () |
- gnucash-glossary | [] |
- gpe-aerial | [] [] |
- gpe-beam | [] [] |
- gpe-calendar | [] [] [] [] |
- gpe-clock | [] [] [] |
- gpe-conf | [] |
- gpe-contacts | [] |
- gpe-edit | [] [] |
- gpe-go | [] [] |
- gpe-login | [] [] [] |
- gpe-ownerinfo | [] [] [] [] [] |
- gpe-sketchbook | [] [] |
- gpe-su | [] [] [] |
- gpe-taskmanager | [] [] [] |
- gpe-timesheet | [] [] [] [] |
- gpe-today | [] [] [] [] |
- gpe-todo | [] [] [] |
- gphoto2 | [] [] [] [] |
- gprof | [] [] [] |
- gpsdrive | () () [] |
- gramadoir | [] [] |
- grep | [] [] [] [] [] [] [] [] [] [] [] |
- gretl | [] [] |
- gsasl | [] [] [] |
- gss | [] |
- gst-plugins | [] [] |
- gstreamer | |
- gtick | [] [] [] [] |
- gtkspell | [] [] [] [] [] |
- hello | [] [] [] [] [] [] [] [] [] [] [] [] [] |
- id-utils | [] [] [] |
- impost | [] [] |
- indent | [] [] [] [] [] [] [] [] [] [] |
- iso_3166 | [] [] [] |
- iso_3166_1 | [] [] [] [] [] [] [] |
- iso_3166_2 | [] |
- iso_3166_3 | [] |
- iso_4217 | [] [] [] |
- iso_639 | [] [] [] [] |
- jpilot | [] [] |
- jtag | [] |
- jwhois | [] [] [] [] |
- kbd | [] [] |
- latrine | [] [] |
- ld | [] [] |
- libc | [] [] [] [] [] |
- libextractor | |
- libgpewidget | [] [] [] [] [] |
- libgphoto2 | [] [] [] |
- libgphoto2_port | [] |
- libgsasl | [] [] |
- libiconv | [] [] [] [] [] [] [] [] [] [] |
- libidn | [] [] |
- lifelines | () |
- lilypond | |
- lingoteach | [] [] |
- lynx | [] [] |
- m4 | [] [] [] [] |
- mailutils | [] [] |
- make | [] [] [] [] [] [] [] |
- man-db | () |
- minicom | [] [] [] [] |
- mysecretdiary | [] [] [] |
- nano | [] [] () [] |
- nano_1_0 | [] [] [] [] |
- opcodes | [] [] [] |
- parted | [] [] [] |
- psmisc | [] |
- ptx | [] [] [] [] [] [] [] [] [] |
- pwdutils | |
- python | |
- radius | [] [] |
- recode | [] [] [] [] [] [] [] |
- rpm | [] |
- screem | |
- scrollkeeper | [] [] [] |
- sed | [] [] [] [] [] [] |
- sh-utils | [] [] [] [] [] [] |
- shared-mime-info | [] [] [] [] [] [] |
- sharutils | [] [] [] [] [] [] |
- silky | [] |
- skencil | [] [] |
- sketch | [] [] |
- solfege | |
- soundtracker | [] [] |
- sp | [] |
- stardict | [] |
- tar | [] [] [] [] |
- texinfo | [] [] [] |
- textutils | [] [] [] [] [] |
- tin | [] () |
- tp-robot | [] [] |
- tuxpaint | [] [] [] [] [] [] [] [] |
- unicode-han-tra... | |
- unicode-transla... | [] [] |
- util-linux | [] [] [] [] [] |
- vorbis-tools | [] [] |
- wastesedge | () |
- wdiff | [] [] [] [] [] [] [] |
- wget | [] [] [] [] |
- xchat | [] [] [] [] [] |
- xkeyboard-config | |
- xpad | [] [] [] |
- +-----------------------------------------------+
- eo es et eu fa fi fr ga gl he hi hr hu id is
- 15 85 21 15 2 35 115 45 16 8 1 6 40 27 1
-
- it ja ko ku lg lt lv mk mn ms mt nb nl nn no nso
- +--------------------------------------------------+
- GNUnet | |
- a2ps | () () [] [] () |
- aegis | () |
- ant-phone | [] |
- anubis | [] [] [] |
- ap-utils | |
- aspell | [] [] |
- bash | [] |
- batchelor | [] |
- bfd | |
- bibshelf | [] |
- binutils | |
- bison | [] [] [] [] |
- bluez-pin | [] [] |
- clisp | [] |
- console-tools | |
- coreutils | [] [] |
- cpio | |
- cpplib | [] |
- darkstat | [] [] |
- dialog | [] [] |
- diffutils | [] [] [] [] |
- doodle | [] |
- e2fsprogs | [] |
- enscript | [] |
- error | [] |
- fetchmail | [] [] |
- fileutils | [] [] [] |
- findutils | [] [] |
- flex | [] [] |
- fslint | [] |
- gas | |
- gawk | [] [] |
- gbiff | [] |
- gcal | |
- gcc | |
- gettext-examples | [] [] [] |
- gettext-runtime | [] [] [] [] |
- gettext-tools | [] [] [] |
- gimp-print | [] [] |
- gip | [] |
- gliv | [] |
- glunarclock | [] [] |
- gmult | [] [] |
- gnubiff | () |
- gnucash | [] () () [] |
- gnucash-glossary | [] [] |
- gpe-aerial | [] |
- gpe-beam | [] |
- gpe-calendar | [] |
- gpe-clock | [] |
- gpe-conf | [] |
- gpe-contacts | |
- gpe-edit | [] |
- gpe-go | [] |
- gpe-login | [] |
- gpe-ownerinfo | [] |
- gpe-sketchbook | [] |
- gpe-su | [] |
- gpe-taskmanager | [] [] |
- gpe-timesheet | [] |
- gpe-today | [] |
- gpe-todo | [] |
- gphoto2 | [] [] [] |
- gprof | |
- gpsdrive | () () () () |
- gramadoir | () |
- grep | [] [] [] [] |
- gretl | [] |
- gsasl | [] |
- gss | |
- gst-plugins | [] [] |
- gstreamer | [] [] |
- gtick | [] [] |
- gtkspell | [] [] [] |
- hello | [] [] [] [] [] [] [] [] [] |
- id-utils | [] [] |
- impost | |
- indent | [] [] [] |
- iso_3166 | [] |
- iso_3166_1 | [] [] |
- iso_3166_2 | [] |
- iso_3166_3 | [] |
- iso_4217 | [] [] [] |
- iso_639 | [] [] [] |
- jpilot | () () () |
- jtag | |
- jwhois | [] [] |
- kbd | [] |
- latrine | [] [] |
- ld | |
- libc | [] [] [] [] [] |
- libextractor | |
- libgpewidget | [] |
- libgphoto2 | [] [] |
- libgphoto2_port | [] [] |
- libgsasl | [] |
- libiconv | [] [] |
- libidn | [] |
- lifelines | [] |
- lilypond | |
- lingoteach | [] [] |
- lynx | [] [] [] |
- m4 | [] [] |
- mailutils | |
- make | [] [] [] |
- man-db | () |
- minicom | [] |
- mysecretdiary | [] |
- nano | [] [] [] |
- nano_1_0 | [] [] [] [] |
- opcodes | [] |
- parted | [] [] [] [] |
- psmisc | [] [] [] |
- ptx | [] [] [] |
- pwdutils | |
- python | |
- radius | |
- recode | [] [] |
- rpm | [] [] |
- screem | [] |
- scrollkeeper | [] [] [] |
- sed | [] [] |
- sh-utils | [] [] [] |
- shared-mime-info | [] [] [] [] |
- sharutils | [] [] [] |
- silky | [] |
- skencil | |
- sketch | |
- solfege | [] [] [] |
- soundtracker | [] |
- sp | () |
- stardict | [] [] |
- tar | [] [] [] |
- texinfo | [] [] [] |
- textutils | [] [] [] |
- tin | |
- tp-robot | [] |
- tuxpaint | [] [] [] [] [] [] [] |
- unicode-han-tra... | |
- unicode-transla... | |
- util-linux | [] [] [] |
- vorbis-tools | [] |
- wastesedge | [] |
- wdiff | [] [] [] |
- wget | [] |
- xchat | [] [] [] [] [] |
- xkeyboard-config | [] |
- xpad | [] |
- +--------------------------------------------------+
- it ja ko ku lg lt lv mk mn ms mt nb nl nn no nso
- 46 35 11 2 1 1 2 2 3 11 0 15 96 7 5 0
-
- or pa pl pt pt_BR rm ro ru rw sk sl sq sr sv
- +----------------------------------------------+
- GNUnet | |
- a2ps | () [] [] [] [] [] [] |
- aegis | () () |
- ant-phone | [] |
- anubis | [] [] [] |
- ap-utils | () |
- aspell | [] [] |
- bash | [] [] [] |
- batchelor | [] |
- bfd | |
- bibshelf | |
- binutils | [] [] |
- bison | [] [] [] [] [] |
- bluez-pin | [] [] [] [] [] [] [] [] |
- clisp | [] |
- console-tools | [] |
- coreutils | [] [] [] [] |
- cpio | [] [] |
- cpplib | |
- darkstat | [] [] [] [] [] [] |
- dialog | [] [] [] [] [] [] [] |
- diffutils | [] [] [] [] [] [] |
- doodle | [] |
- e2fsprogs | [] [] |
- enscript | [] [] [] [] |
- error | [] [] [] |
- fetchmail | [] [] [] [] |
- fileutils | [] [] [] [] [] |
- findutils | [] [] [] [] [] [] |
- flex | [] [] [] [] [] |
- fslint | [] [] [] |
- gas | |
- gawk | [] [] [] [] |
- gbiff | [] |
- gcal | [] |
- gcc | |
- gettext-examples | [] [] [] [] [] [] |
- gettext-runtime | [] [] [] [] [] [] [] |
- gettext-tools | [] [] [] [] [] [] [] |
- gimp-print | [] [] |
- gip | [] [] [] |
- gliv | [] [] [] |
- glunarclock | [] [] [] [] [] [] |
- gmult | [] [] [] [] |
- gnubiff | () [] |
- gnucash | () [] [] [] [] |
- gnucash-glossary | [] [] [] |
- gpe-aerial | [] [] [] [] [] [] |
- gpe-beam | [] [] [] [] [] [] |
- gpe-calendar | [] [] [] [] [] [] [] |
- gpe-clock | [] [] [] [] [] [] [] |
- gpe-conf | [] [] [] [] [] [] |
- gpe-contacts | [] [] [] [] |
- gpe-edit | [] [] [] [] [] [] [] |
- gpe-go | [] [] [] [] [] |
- gpe-login | [] [] [] [] [] [] [] |
- gpe-ownerinfo | [] [] [] [] [] [] [] |
- gpe-sketchbook | [] [] [] [] [] [] [] |
- gpe-su | [] [] [] [] [] [] [] |
- gpe-taskmanager | [] [] [] [] [] [] [] |
- gpe-timesheet | [] [] [] [] [] [] [] |
- gpe-today | [] [] [] [] [] [] [] |
- gpe-todo | [] [] [] [] [] [] [] [] |
- gphoto2 | [] [] [] [] |
- gprof | [] [] [] |
- gpsdrive | [] [] |
- gramadoir | [] |
- grep | [] [] [] [] [] [] [] |
- gretl | [] |
- gsasl | [] [] [] [] [] |
- gss | [] [] [] |
- gst-plugins | [] [] [] [] |
- gstreamer | [] [] [] [] |
- gtick | [] [] [] |
- gtkspell | [] [] [] [] [] [] |
- hello | [] [] [] [] [] [] [] |
- id-utils | [] [] [] [] |
- impost | |
- indent | [] [] [] [] [] [] |
- iso_3166 | [] [] [] [] [] |
- iso_3166_1 | [] [] [] [] |
- iso_3166_2 | |
- iso_3166_3 | [] [] [] |
- iso_4217 | [] [] |
- iso_639 | [] [] [] |
- jpilot | |
- jtag | [] |
- jwhois | [] [] [] () () |
- kbd | [] [] [] |
- latrine | [] [] |
- ld | [] |
- libc | [] [] [] [] [] |
- libextractor | [] |
- libgpewidget | [] [] [] [] [] [] |
- libgphoto2 | [] [] |
- libgphoto2_port | [] |
- libgsasl | [] [] [] |
- libiconv | [] [] [] [] [] [] [] [] [] [] |
- libidn | [] () |
- lifelines | [] [] |
- lilypond | |
- lingoteach | [] |
- lynx | [] [] [] |
- m4 | [] [] [] [] [] |
- mailutils | [] [] [] |
- make | [] [] [] [] |
- man-db | [] [] |
- minicom | [] [] [] [] |
- mysecretdiary | [] [] [] [] |
- nano | [] [] [] |
- nano_1_0 | [] [] [] [] |
- opcodes | [] [] |
- parted | [] [] [] [] |
- psmisc | [] [] |
- ptx | [] [] [] [] [] [] |
- pwdutils | [] |
- python | |
- radius | [] [] |
- recode | [] [] [] [] [] [] |
- rpm | [] [] [] [] |
- screem | |
- scrollkeeper | [] [] [] [] [] [] [] |
- sed | [] [] [] [] [] [] [] [] |
- sh-utils | [] [] [] |
- shared-mime-info | [] [] [] [] [] [] |
- sharutils | [] [] [] |
- silky | [] |
- skencil | [] [] [] |
- sketch | [] [] [] |
- solfege | |
- soundtracker | [] [] |
- sp | |
- stardict | [] [] |
- tar | [] [] [] [] |
- texinfo | [] [] [] [] |
- textutils | [] [] [] |
- tin | |
- tp-robot | [] |
- tuxpaint | [] [] [] [] [] [] [] [] |
- unicode-han-tra... | |
- unicode-transla... | |
- util-linux | [] [] [] |
- vorbis-tools | [] [] |
- wastesedge | |
- wdiff | [] [] [] [] [] [] |
- wget | |
- xchat | [] [] [] [] [] [] [] |
- xkeyboard-config | |
- xpad | |
- +----------------------------------------------+
- or pa pl pt pt_BR rm ro ru rw sk sl sq sr sv
- 1 3 47 29 57 6 78 73 5 44 12 12 50 85
-
- ta tg th tk tr uk ven vi wa xh zh_CN zh_TW zu
- +-----------------------------------------------+
- GNUnet | | 0
- a2ps | [] [] [] | 19
- aegis | | 0
- ant-phone | [] [] | 5
- anubis | [] [] [] | 11
- ap-utils | () [] | 2
- aspell | [] [] [] | 13
- bash | [] | 11
- batchelor | [] [] | 7
- bfd | | 1
- bibshelf | [] | 5
- binutils | [] | 6
- bison | [] [] | 18
- bluez-pin | [] [] [] [] [] | 25
- clisp | | 7
- console-tools | [] [] | 5
- coreutils | [] [] | 17
- cpio | [] [] [] | 7
- cpplib | [] [] | 8
- darkstat | [] () () | 15
- dialog | [] [] [] | 25
- diffutils | [] [] [] [] | 28
- doodle | [] | 5
- e2fsprogs | [] | 8
- enscript | [] | 12
- error | [] [] [] | 16
- fetchmail | [] | 12
- fileutils | [] [] [] | 18
- findutils | [] [] | 17
- flex | [] [] | 15
- fslint | [] | 7
- gas | [] | 3
- gawk | [] | 14
- gbiff | [] | 5
- gcal | [] | 5
- gcc | [] [] | 4
- gettext-examples | [] [] [] [] [] | 21
- gettext-runtime | [] [] [] [] [] | 25
- gettext-tools | [] [] [] [] [] | 19
- gimp-print | [] | 11
- gip | [] | 8
- gliv | [] [] | 7
- glunarclock | [] [] | 13
- gmult | [] [] [] | 13
- gnubiff | [] | 3
- gnucash | () [] | 10
- gnucash-glossary | [] [] | 9
- gpe-aerial | [] [] | 13
- gpe-beam | [] [] | 13
- gpe-calendar | [] [] [] [] | 18
- gpe-clock | [] [] [] [] | 17
- gpe-conf | [] [] | 12
- gpe-contacts | [] [] | 7
- gpe-edit | [] [] [] [] | 15
- gpe-go | [] [] | 11
- gpe-login | [] [] [] [] [] | 18
- gpe-ownerinfo | [] [] [] [] | 19
- gpe-sketchbook | [] [] | 14
- gpe-su | [] [] [] | 16
- gpe-taskmanager | [] [] [] | 17
- gpe-timesheet | [] [] [] [] | 17
- gpe-today | [] [] [] [] [] | 19
- gpe-todo | [] [] [] | 17
- gphoto2 | [] [] [] | 18
- gprof | [] [] | 10
- gpsdrive | | 3
- gramadoir | [] | 6
- grep | [] [] [] [] | 32
- gretl | | 4
- gsasl | [] [] | 12
- gss | [] | 5
- gst-plugins | [] [] [] | 17
- gstreamer | [] [] [] [] | 15
- gtick | [] | 11
- gtkspell | [] [] [] [] | 21
- hello | [] [] [] [] | 37
- id-utils | [] [] | 13
- impost | [] | 3
- indent | [] [] [] [] | 25
- iso_3166 | [] [] [] | 12
- iso_3166_1 | [] [] | 20
- iso_3166_2 | | 2
- iso_3166_3 | [] [] | 8
- iso_4217 | [] [] | 10
- iso_639 | [] [] | 12
- jpilot | [] [] [] | 6
- jtag | | 2
- jwhois | [] [] [] | 12
- kbd | [] [] | 12
- latrine | [] [] | 8
- ld | [] | 5
- libc | [] [] | 22
- libextractor | | 1
- libgpewidget | [] [] | 17
- libgphoto2 | [] | 9
- libgphoto2_port | | 5
- libgsasl | [] | 7
- libiconv | [] [] [] [] [] | 32
- libidn | [] [] | 6
- lifelines | | 4
- lilypond | | 1
- lingoteach | [] | 6
- lynx | [] [] [] | 15
- m4 | [] [] | 17
- mailutils | [] | 7
- make | [] [] | 18
- man-db | | 5
- minicom | | 11
- mysecretdiary | [] [] | 12
- nano | [] [] | 13
- nano_1_0 | [] [] [] | 18
- opcodes | [] [] | 9
- parted | [] [] [] | 18
- psmisc | [] | 7
- ptx | [] [] | 23
- pwdutils | | 1
- python | | 0
- radius | [] | 6
- recode | [] [] | 22
- rpm | [] [] | 11
- screem | | 1
- scrollkeeper | [] [] [] | 24
- sed | [] [] [] | 21
- sh-utils | [] | 15
- shared-mime-info | [] [] [] | 21
- sharutils | [] [] [] | 20
- silky | | 3
- skencil | | 6
- sketch | | 6
- solfege | | 4
- soundtracker | [] | 8
- sp | [] | 3
- stardict | [] [] [] [] | 10
- tar | [] [] [] [] | 15
- texinfo | [] [] | 14
- textutils | [] [] [] | 17
- tin | | 1
- tp-robot | [] [] [] | 8
- tuxpaint | [] [] [] [] | 34
- unicode-han-tra... | | 0
- unicode-transla... | | 2
- util-linux | [] [] [] | 18
- vorbis-tools | [] | 10
- wastesedge | | 1
- wdiff | [] [] | 22
- wget | [] [] | 7
- xchat | [] [] [] [] | 26
- xkeyboard-config | [] | 2
- xpad | [] | 5
- +-----------------------------------------------+
- 73 teams ta tg th tk tr uk ven vi wa xh zh_CN zh_TW zu
- 149 domains 0 0 0 1 77 30 0 92 16 0 42 32 0 1746
-
- Some counters in the preceding matrix are higher than the number of
-visible blocks let us expect. This is because a few extra PO files are
-used for implementing regional variants of languages, or language
-dialects.
-
- For a PO file in the matrix above to be effective, the package to
-which it applies should also have been internationalized and
-distributed as such by its maintainer. There might be an observable
-lag between the mere existence a PO file and its wide availability in a
-distribution.
-
- If May 2005 seems to be old, you may fetch a more recent copy of
-this `ABOUT-NLS' file on most GNU archive sites. The most up-to-date
-matrix with full percentage details can be found at
-`http://www.iro.umontreal.ca/contrib/po/HTML/matrix.html'.
-
-1.6 Using `gettext' in new packages
-===================================
-
-If you are writing a freely available program and want to
-internationalize it you are welcome to use GNU `gettext' in your
-package. Of course you have to respect the GNU Library General Public
-License which covers the use of the GNU `gettext' library. This means
-in particular that even non-free programs can use `libintl' as a shared
-library, whereas only free software can use `libintl' as a static
-library or use modified versions of `libintl'.
-
- Once the sources are changed appropriately and the setup can handle
-the use of `gettext' the only thing missing are the translations. The
-Free Translation Project is also available for packages which are not
-developed inside the GNU project. Therefore the information given above
-applies also for every other Free Software Project. Contact
-`translation@iro.umontreal.ca' to make the `.pot' files available to
-the translation teams.
-
blob - c3066f4fa84c4c369fff6bbf9e640262ddafac10 (mode 644)
blob + /dev/null
--- INSTALL
+++ /dev/null
-Installation
-============
-
-This program requires GTK 3.20 or higher to be compiled.
-
-Build it
-========
-
-If you're using a package-based system, please make sure that gtk-devel
-and glib-devel (or similar) packages are installed before the compilation
-(you may also require flex (lex), and bison (yacc)).
-
-To compile and install, just type:
-
-% ./configure
-% make
-% su
-Password: [Enter password]
-# make install
-
-To run, just type:
-
-% claws-mail
-
-
-Additional libraries or programs
-================================
-only needed if you require the additional functionality
-
-Bogofilter
- for Bogofilter plugin support
- https://www.bogofilter.org/
-Bsfilter
- for Bsfilter plugin support
- https://osdn.net/projects/bsfilter/
-Canberra (>= 0.6)
- for some sound features of Notification plugin
- https://0pointer.de/lennart/projects/libcanberra/
-compface
- for X-Face support
- https://freshmeat.net/projects/compface/
-Clam AntiVirus daemon
- for Clamd plugin support
- https://www.clamav.net/
-D-Bus (>= 0.60)
- for interprocess communication support
- https://www.freedesktop.org/wiki/Software/dbus
-Enchant (and dictionaries) (>= 1.0.0)
- for spell-checker support
- https://abiword.github.io/enchant/
-GnuPG (>= 1.2.1) and GPGME (>= 0.4.5)
- for GnuPG and S/MIME plugin support
- https://www.gnupg.org/
- https://www.gnupg.org/software/gpgme/
-GnuTLS (>= 0.4.2)
- for SSL support
- https://gnutls.org/
-GTK WebKit (>= 2.0)
- for Fancy plugin support
- https://trac.webkit.org/wiki/WebKitGTK/
-Gs tool
- for PostScript feature of PDF Viewer plugin
- https://pages.cs.wisc.edu/~ghost/
-Indicate (>= 0.3.0)
- for indicator feature of Notification plugin
- https://launchpad.net/libindicator/
-J-Pilot
- for J-Pilot support
- https://www.jpilot.org/
-LCDproc daemon
- for lcdproc feature of Notification plugin
- https://www.lcdproc.org
-libEtPan! (>= 0.57)
- for IMAP4, NNTP and Mailmbox plugin support
- https://www.etpan.org
-Network Manager (>= 0.6.2)
- for support for detection of network connection changes
- https://www.gnome.org/projects/NetworkManager/
-OpenLDAP (>= 2.0.7)
- for LDAP support
- https://www.openldap.org/
-Perl (>= 5.8.0)
- for perl plugin support
- https://www.perl.org/
-Poppler (>= 0.4.2)
- for PDF Viewer plugin support
- https://poppler.freedesktop.org/
-PyGObject (>= 3.0.0)
- for Python plugin support
- https://pygobject.readthedocs.io/
-Python
- for Python plugin support
- https://python.org/
-SpamAssassin
- for SpamAssassin plugin support
- https://spamassassin.apache.org/
-
-
-Options for configure script
-============================
-For list of available options, refer to "./configure --help".
-
-Most options are automatically enabled if the dependencies
-are matched.
-
-
blob - /dev/null
blob + fef764efd2e28a97e0d71869a8065f397116552b (mode 644)
--- /dev/null
+++ README.md
+# Talons
+
+Talons is a GTK3 email client
+supporting managing mailboxes via IMAP and on a filesystem.
+
+Talons is a fork of [Claws Mail],
+which itself is a fork of [Sylpheed].
+It started out life as an experiment of using [Zig] to maintain an old C codebase.
+
+OpenBSD is supported; other OSs untested.
+
+## Getting started
+
+Talons has direct dependencies on the following libraries:
+
+- cairo
+- gdk-3
+- gdk_pixbuf-2.0
+- gio-2.0
+- glib-2.0
+- gmp
+- gnutls
+- gtk-3
+- hogweed
+- libidn2
+- nettle
+- p11-kit
+- pango-1.0
+- tasn1
+- unistring
+
+Install these using pkg_add(1).
+
+TODO symlink workarounds for https://github.com/ziglang/zig/pull/18475
+
+Install zig (`pkg_add zig`) then build the project:
+
+ cd src
+ zig build
+
+To run the app:
+
+ zig build run
+
+## Goals
+
+Many features of Claws Mail have been removed to make it easier to maintain by a single person.
+
+To be honest I can't even remember how many or which features have been removed.
+Off the top of my head:
+
+- no autotools
+- no Windows support
+- no plugins
+- no localisation (sorry)
+- no actions
+- no client-side mail filtering
+
+[Zig]: https://ziglang.org
+[Claws Mail]: https://claws-mail.org
+[Sylpheed]: https://sylpheed.sraoss.jp/en/
blob - ca8132d6fd69ab225e0a8b7f4349c56706071f4f (mode 644)
blob + /dev/null
--- README
+++ /dev/null
-Claws Mail - a GTK lightweight and fast e-mail client
-
----------------------------------------------------------------------
-
- Copyright (C) 1999-2025 The Claws Mail Team and Hiroyuki Yamamoto
-
- This program is free software: you can redistribute it and/or modify
- it under the terms of the GNU General Public License as published by
- the Free Software Foundation, either version 3 of the License, or
- (at your option) any later version.
-
- This program is distributed in the hope that it will be useful,
- but WITHOUT ANY WARRANTY; without even the implied warranty of
- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
- GNU General Public License for more details.
-
- You should have received a copy of the GNU General Public License
- along with this program. If not, see <http://www.gnu.org/licenses/>.
-
- For more details see the file COPYING.
-
----------------------------------------------------------------------
-
-Summary:
-
- 1. What is Claws Mail?
- 2. Plugins
- 3. Actions
- 4. Icon Themes
- 5. Quick Search
- 6. Custom toolbar
- 7. Partial downloading of POP3 mails
- 8. Hidden Options
- 9. Tools
-10. How to contribute
-11. How to request features
-12. Installing Claws from Git
-13. Release History
-14. Useful Links
-
-
-1. What is Claws Mail?
---------------------------
-
-Claws Mail is a lightweight and highly configurable email client
-and news reader based on the GTK GUI toolkit, it runs on the X
-Window System.
-
-Claws Mail is free software distributed under the GNU GPL.
-
-To run Claws Mail use 'claws-mail' on the command line.
-
-When claws-mail is executed for the first time a configuration
-'Wizard' will appear prompting you for the minimum information
-necessary to create a new account.
-
-
-2. Plugins
-----------
-
-Claws Mail' capabilities are extended by plugins. It comes with
-the following plugins included, all of which are built automatically
-if the required libraries are present.
-
-Plugins are installed in $PREFIX/lib/claws-mail/plugins/
-and have a suffix of '.so'
-To load a plugin go to '/Configuration/Plugins' and click
-the 'Load Plugin' button.
-Select the plugin that you want and click 'OK'
-
-All plugin preferences can be found under
-'/Configuration/Preferences/Plugins/'.
-
- o ACPI Notifier
- Notifies of new mail via the mail LED available on some laptops. The
- LED can be set to blinking or on states when new mail is received.
- Appropriate kernel modules have to be loaded first for this plugin to
- work. Laptops supported are from ACER (acerhk and acer_acpi modules),
- ASUS (asus_laptop and asus_acpi), IBM (ibm_acpi), Lenovo (tm_smapi)
- and Fujitsu (apanel) manufacturers.
-
- o Address Keeper
- Saves mail addresses typed in the 'To', 'Cc' or 'Bcc' fields of
- outgoing messages to a designated folder in the address book.
- Addresses are saved only if not already present in the address book.
-
- o Archiver
- Archives mail folders using libarchive library. Folders can be archived
- with or without compression (ZIP, GZIP or BZIP2) and also in several
- formats (TAR, SHAR, PAX or CPIO).
- Libarchive is available from https://www.libarchive.org/.
-
- o Attachment Remover
- Selectively removes attachments from messages. Messages are permanently
- modified by using this feature, so be careful!
-
- o Attachment Warning
- Warns the user of possibly forgotten attachments when some keywords
- are found in the outgoing messages. False positives (being warned when
- no attachment is realy needed) exist, but some configuration options
- can help to reduce their probability.
-
- o Bogofilter
- Enables the scanning of incoming mail received from a POP,
- IMAP, or LOCAL account using Bogofilter. It can optionally
- delete mail identified as spam or save it to a designated folder.
- Bogofilter is a pure Bayesian filter, therefore it has better
- speed performance than SpamAssassin but might catch less spam.
- Bogofilter is available from https://bogofilter.sourceforge.io/.
-
- o BSFilter
- Checks all messages received from IMAP, POP or local accounts using
- BSFilter, a bayesian spam filter program, which has to be installed
- locally. Messages identified as spam can be deleted or saved to a
- designated folder.
- Bsfilter is available from https://osdn.net/projects/bsfilter/.
-
- o Clamd
- Uses the Clam AntiVirus in daemon mode to scan received messages from
- IMAP, POP or local accounts. Scanning is done through a socket to the
- daemon, so it has to be previously configured to allow this.
- Clam AntiVirus is available from https://www.clamav.net/.
-
- o Dillo
- Uses the Dillo browser (https://www.dillo.org/) to render HTML mails
- and HTML parts of multipart messages. Dillo is started with
- special options to embed its window inside Claws Mail's message
- view and to render the HTML safely. If required, remote content
- can be also retrieved.
-
- o Fancy
- Renders HTML mails and HTML parts of multipart messages using the
- GTK port of the WebKit library. External content is blocked by
- default (including images) to avoid remote tracking, but can be
- enabled either globally or just on the displayed message. The GTK
- WebKit is available from https://trac.webkit.org/wiki/WebKitGTK.
-
- o Fetchinfo
- Modifies downloaded messages and inserts special headers containing
- some download information: UIDL, Claws Mail account name, POP server,
- user ID and retrieval time. These headers can be used later for more
- elaborate filtering or processing rules.
-
- o Keyword Warner
- Shows a warning when sending or queueing a message and a reference
- to one or more keywords is found in the message text.
-
- o Libravatar
- Displays sender avatars from https://www.libravatar.org/, from own
- sender's domain if enabled or even an automatically generated one.
-
- o LiteHTML Viewer
- Renders HTML mails and HTML parts of multipart messages using the
- using the litehtml library (http://www.litehtml.com/). External content
- is blocked by default (including images) to avoid remote tracking.
-
- o MailMbox
- Handles mailboxes in Mbox format using the libEtPan! library. Mbox
- files can be added to the folder tree and used like regular mailboxes.
- LibEtPan! is available from https://www.etpan.org/libetpan.html.
-
- o Managesieve
- Manage sieve filters on a server using the ManageSieve protocol.
-
- o Newmail
- Writes a header summary to a log file for each mail received after
- sorting. The file for the summary is ~/Mail/NewLog.
-
- o Notification
- Provides various ways of notifying the user of new and unread email.
- Current methods include: a banner, a popup window, a user command,
- a message to a LCD daemon, a system tray icon and an indicator icon.
- Sound notifications are also possible through libcanberra. Each method
- can be customized in detail through the plugin preferences.
- Indicator library is available from https://launchpad.net/libindicator/
- and libcanberra from https://0pointer.de/lennart/projects/libcanberra/.
-
- o Perl
- Extends the filtering possibilities of Claws Mail. Provides a Perl 5
- interface to Claws Mail's filtering mechanism, allowing the use of full
- Perl power in email filters. A conversion script is provided to
- translate user rules into perl rules suitable for this plugin.
- Perl is available from http://www.perl.org/.
-
- o PDF Viewer
- Displays Portable Document Format (PDF) and PostScript attachments
- within the message view using Poppler. PostScript attachments are
- converted to PDF on the fly by the 'gs' tool, which has to be installed
- first. The 'gs' tool is available from https://pages.cs.wisc.edu/~ghost/.
- The Poppler library is available from https://poppler.freedesktop.org/.
-
- o PGP/Core
- Handles core PGP functions and is required by the PGP/Inline
- and PGP/MIME plugins.
- Uses GnuPG/GPGME, https://www.gnupg.org/software/gpgme/index.html.
-
- o PGP/inline
- Handles inline PGP signed and/or encrypted mails. You can
- decrypt mails, verify signatures or sign and encrypt your
- own mails.
- Uses GnuPG/GPGME, https://www.gnupg.org/software/gpgme/index.html.
-
- o PGP/MIME
- Handles PGP/MIME signed and/or encrypted mails. You can
- decrypt mails, verify signatures or sign and encrypt your
- own mails.
- Uses GnuPG/GPGME, https://www.gnupg.org/software/gpgme/index.html.
-
- o Python
- Provides Python scripting access to Claws Mail functions. A testing
- console is also featured. Scripts can be saved to specific folders
- for automatic loading on startup or being available as new menu items
- under the '/Tools/Python scripts' menu.
- Python is available from https://python.org/.
-
- o RSSyl
- Creates mailboxes where newsfeeds in RSS 1.0, RSS 2.0 or Atom format
- can be added. Each newsfeed will create a folder with the appropriate
- entries, fetched from the web. You can read them, and delete or keep
- old entries.
-
- o S/MIME
- Handles S/MIME signed and/or encrypted mails. You can decrypt mails,
- verify signatures or sign and encrypt your own mails.
-
- o SpamAssassin
- Scans incoming mail received from a POP, IMAP or LOCAL account using
- SpamAssassin. It can optionally delete mail identified as spam or save
- it to a designated folder.
- SpamAssassin is available from https://spamassassin.apache.org/.
-
- o Spam Report
- Reports spam messages to online spam harvesting sites. Sites suported
- are https://www.signal-spam.fr/ and https://www.spamcop.net/. The Debian
- mailing list spam nomination system is also supported.
-
- o TNEF Parser
- Decodes attachments with 'application/ms-tnef' MIME type (also known
- as "winmail.dat" files) in Claws Mail, using the ytnef library.
- Decoded parts can be saved to files.
- The ytnef library is available from https://github.com/Yeraze/ytnef.
-
- o VCalendar
- Displays vCalendar messages. Only the meeting subset of the vCalendar
- format is currently supported, which includes planning, sending and
- receiving invitations and answering them. Public calendar (WebCal)
- subscriptions, free/busy information export/import and reminding of
- events is also supported.
-
-
-Additional plugins can be found here:
-https://www.claws-mail.org/plugins.php
-
-
-3. Actions
-----------
- The "actions" feature is a convenient way for the user to launch external
- commands to process a complete message file including headers and body or
- just one of its parts. It allows also the use of an external command to
- filter the whole text or just a selected part in the message window or in
- the compose window. This is a generic tool that allows to do any uncommon
- actions on the messages, and thus extends the possibilities of Claws Mail.
- For example, Claws Mail does not include the rot13 cyphering algorithm
- popular in some newsgroups. It does not support uuencoded messages. As
- all these features can be handled by external programs, the actions
- provide a convenient way to use them from the menu bar.
-
- a. Usage
- --------
-
- To create a new action, go to Configuration -> Actions.... The "Action
- Creation" dialog offers to enter the Menu name that will trigger the
- command. The created menu will be found in the Tools -> Actions submenu.
- By inserting a slash / in the menu name, you create a submenu.
-
- The command is entered in the Command line entry. Note that Claws Mail
- stores every single email in a separate file. This allows to use the
- following syntax for the command:
-
- * %f denotes the file name of the selected message. If you selected more
- than one, then the command will be launched for each message with
- the appropriate file name
- * %F denotes the list of the file names of the selected message. If only
- one message is selected, this amounts to %f, but if more messages
- are selected, then the command will be launched only once with the
- list of the file names. (You can use both %f and %F in one command:
- then the command will be launched for each selected message with
- the name of this message and with the list of all selected
- messages. I did not find a practical example for this.)
- * %p denotes the current selected message part of a multipart message.
- The part is decoded accordingly. If the message is not a multipart
- message, it denotes the message body.
- * Prepending >: this will allow you to send to the command's standard
- input a text that you will enter in a dialog window.
- * Prepending *: this will allow you to send to the command's standard
- input a text that you will enter in a dialog window. But in
- contrast to prepending >, the entered text is hidden (useful when
- entering passwords).
- * Appending an ampersand &: this will run the command asynchronously.
- That means "fire and forget". Claws Mail won't wait for the
- command to finish, nor will it catch its output or its error
- messages.
- * Prepending the vertical bar | (pipe-in): this will send the current
- displayed text or the current selected text from the message view
- or the compose window to the command standard input. The command
- will silently fail if more than one message is selected.
- * Appending the vertical bar | (pipe-out): this will replace the current
- displayed text or the current selected text from the message window
- or the compose window by the command standard output. The command
- will silently fail if more than one message is selected.
-
- Note: It is not possible to use actions containing %f, %F or %p from the
- compose window.
-
- When a command is run, and unless it is run asynchronously, Claws Mail
- will be insensitive to any interaction and it will wait for the command to
- finish. If the command takes too long (5 seconds), it will popup a dialog
- window allowing to stop it. This dialog will also be displayed as soon as
- the command has some output: error messages or even its standard output
- when the command is not a "pipe-out" command. When multiple commands are
- being run, they are run in parallel and each command output is separated
- from the outputs of the others.
-
- a. Examples
- -----------
-
- Here are some examples that are listed in the same syntax as used for
- storing the actions list. You can copy and past the definition in your
- ~/.claws-mail/actionsrc file (exit Claws Mail before). The syntax
- is very simple: one line per action, each action contains the menu name
- and the command line separated by a colon and a space ": "
-
- Purpose: rot13 cyphering
- Definition: Rot13: |tr a-zA-Z n-za-mN-ZA-M|
- Details: This will apply the rot13 cyphering algorithm to the
- (selected) text in the message/compose view.
-
- Purpose: Decoding uuencoded messages
- Definition: UUdeview: xdeview %F&
- Details: xdeview comes with uudeview. If an encoded file is split in
- multiple messages, just select them all and run the command.
-
- Purpose: Display uuencoded image
- Definition: Display uuencoded: uudec %f&
- Details: Displays uuencoded files. The uudec[1] script can be found in
- the 'tools' directory of the distribution package.
-
- Purpose: Alter messages
- Definition: Edit message: gvim -f %F
- Details: Allows editing of any received message. Can be used to remove
- unneeded message parts, etc.
-
- Purpose: Pretty format
- Definition: Par: |par 72Tbgjqw74bEe B=._A_a 72bg|
- Details: par is a utility that can pretty format any text. It does a
- very good job in indenting quoted messages, and justifying
- text. Used when composing a message
-
- Purpose: Browse
- Definition: Part/Dillo: dillo %p&
- Details: Browse the selected message part in Dillo.
-
-
- [1] The uudec script can be found in the 'tools' directory of the
- distribution package. It needs uudecode and ImageMagick's display. The
- latter can be replaced by any image viewer that can get input from
- standard input. The script could also be modified to use temporary files
- instead of standard input.
-
-
-4. Icon Themes
---------------
- Claws has support for different icon sets. Several icon sets can be
- downloaded from https://www.claws-mail.org/themes.php
- You will need to create a directory called 'themes' in your config
- directory, unpack them into this directory, and then use the interface
- to select them, /Configuration/Preferences/Display/Themes
-
- This interface can also be used to install new themes.
-
-
-5. Quick Search with extended search
-------------------------------------
- Quick Search, with its powerful Extended search function,
- enables searching through folder's messages.
-
- Extended Search allows one to define criteria that messages must
- have in order to match and be displayed in the summary view pane.
- Search types titled From, Subject and To are self explanatory.
- Search type extended allows one to use Claws Mail's powerful
- filtering engine to select messages. Examples:
- from regexpcase "foo"
- subject regexp "Bug" & to regexp "claws-mail"
-
- Additionally, it is possible to use simpler yet equally
- powerful patterns for message selections. Mutt users will
- immediately recognise most of the available patterns:
-
- Pattern Parameter Selects
- --------------------------------------------------------------------------
- a all messages
- ag # messages whose age is greater than # days
- al # messages whose age is lower than # days
- agh # messages whose age is greather than # hours
- alh # messages whose age is lower than # hours
- b S messages which contain S in the message body
- B S messages which contain S in the whole message
- c S messages carbon-copied to S
- C S message is either To: or Cc: to S
- D deleted messages
- da "YYYY-MM-dd HH:mm:ss" messages whose date is after requested date
- (time is optional)
- db "YYYY-MM-dd HH:mm:ss" messages whose date is before requested date
- (time is optional)
- e S messages which contain S in the Sender field
- E S true if execute "S" succeeds
- f S messages originating from user S
- F forwarded messages
- h S messages which contain S in any header name
- or value
- H S messages which contain S in the value of
- any header
- ha messages which have attachments
- i S messages which contain S in Message-Id header
- I S messages which contain S in In-Reply-To
- header
- k # messages which are marked with color #
- L locked messages
- n S messages which are in newsgroup S
- N new messages
- O old messages
- p incomplete messages (not entirely downloaded)
- r messages which have been replied to
- R read messages
- s S messages which contain S in subject
- se # messages whose score is equal to # points
- sg # messages whose score is greater than # points
- sl # messages whose score is lower than # points
- Se # messages whose size is equal to # bytes
- Sg # messages whose size is greater than # bytes
- Ss # messages whose size is smaller than # bytes
- t S messages which have been sent to S
- tg S messages with tags contain S
- tagged messages which have tag(s)
- T marked messages
- U unread messages
- v H V messages which contain V in header H
- x S messages which contain S in References header
- x "cmd args" messages returning 0 when passed to command
- - %F is message file
-
- & logical AND operator
- | logical OR operator
- ! or ~ logical NOT operator
- % case sensitive search
- # match using regular expressions instead of
- substring search
-
- all filtering expressions are allowed, but cannot be mixed
- through logical operators with the expressions above
-
- It is possible to use logical operators AND (&), OR (|) and
- NOT (! or ~). Case sensitive search is achieved with %.
- Examples:
- T marked messages
- U unread messages
- f "john beavis" messages from john beavis
- %f "John Beavis" messages from John Beavis (case sensitive)
- ~s foo messages which do not have foo in the subject
- f foo & ~s bar messages from foo that do not have bar in the subject
-
-
-6. Custom toolbar
------------------
-
- /Configuration/Preferences/Customize Toolbars lets you define the
- toolbar you want. The configuration dialog enables you to set an icon,
- an appropriate text, and map an action to it. Actions to choose
- from are predefined. You can also have your "Claws Mail Actions"
- (refer to "Actions" above) on your toolbar.
-
- Example:
- * Configuration->Actions
- - add an entry "Dillo: dillo %p&"
- * Configuration->Custom toolbar
- - select Claws Mail Actions Feature
- - select "Dillo: dillo %p&" from drop down list
- - choose an icon and click ok
-
-
-
-7. Partial downloading of POP3 mails
-------------------------------------
- Messages over the configured size limit, (/[Account preferences]/
- Receive/Message size limit), will be partially retrieved. These
- messages will have a Notice View displayed (above the Message View),
- informing of the partially retrieved state and the total size of the
- message. The Notice View will also contain two buttons, 'Mark for
- download' and 'Mark for deletion'. If the user clicks 'Mark for
- download', the message will be downloaded in full at the next message
- retrieval, (and the partial one deleted); if the user checks 'Mark for
- deletion' it will be removed from the server after the normal delay
- as specified in the POP3 account's 'Receive' preferences.
- If a user moves a partially retrieved message to the Trash folder
- it will be deleted on the server at the next retrieval after the
- Trash folder has been emptied.
-
-
-8. Hidden options
------------------
-
- There's several options which are not widely used and were not
- added to the configuration interface to avoid excessive bloat.
-
- The complete and up to date list of hidden options can be found
- on Hidden preferences section of Claws Mail Manual:
-
- https://www.claws-mail.org/manual/claws-mail-manual.html#adv_hidden
-
-9. Tools
---------
-
- Tools are small scripts which can help integrate Claws Mail with
- other programs; perform format conversions between different kinds
- of mailboxes, address books, etc.; be used in Claws Mail Actions for
- a variety of purposes; or used in other programs to ease their
- interoperability with Claws Mail.
-
- You will find all the tools in the 'tools' directory and a detailed
- description of the available scripts in 'tools/README.'
-
-10. How to contribute
----------------------
-
-You are encouraged to send patches via the Claws Mail bugzilla at
-https://www.thewildbeast.co.uk/claws-mail/bugzilla/index.cgi
-But please first read the patch guidelines here:
-https://www.claws-mail.org/devel.php
-
-If that's too troublesome, either contact Paul Mangan
-<paul@claws-mail.org> or consider posting to the
-Claws Mail-users mailing list.
-https://www.claws-mail.org/MLs.php
-
-Bugs can be reported with Claws' bugzilla at:
-https://www.thewildbeast.co.uk/claws-mail/bugzilla/index.cgi
-
-Of course, you can also post to the Claws Mail-users mailing list.
-
-Also, we really try to incorporate good contributions, but sometimes we
-don't have enough time. If the contribution is really big, or requires
-a long time to stabilise, send a mail to Paul Mangan
-<paul@claws-mail.org>. We can probably arrange access to the
-Claws Mail Git repository.
-
-
-
-11. How to request features
----------------------------
-
-Ask around in Claws Mail-users ML. Note that some developers may
-have already thought about your feature and may, perhaps, be implementing
-it, or the feature was already discussed and rejected for whatever reason.
-You might want to go ahead and hack a patch for it. (That would be very
-cool!) Another possibility is to add a request to our bugzilla, (severity:
-'enhancement'), at
-https://www.thewildbeast.co.uk/claws-mail/bugzilla/index.cgi
-
-
-12. Installing Claws Mail from Git
---------------------------------------
-
- a. Downloading
- --------------
-
- To download the latest Git, cd to the directory where you wish to download
- to and type the following information:
-
- git clone https://git.claws-mail.org/readonly/claws.git
-
- Later, when you want to update your local repository, you'll just have to
- go back to the 'claws' directory, and type:
-
- git pull --all
-
- b. Installing
- -------------
-
- To compile and install use the following commands:
-
- ./autogen.sh [add configure options as required]
- make
- make install [as root]
-
- You will need a full set of development tools installed to be able to run
- autogen.sh. See also ac/README.
-
-
-
-13. Release History
--------------------
-
-GTK 3 Version
--------------
-2025-02-24 4.3.1
-2024-06-10 4.3.0
-2023-11-20 4.2.0
-2022-10-20 4.1.1
-2022-04-03 4.1.0
-2021-07-10 4.0.0
-
-GTK 2 Version
--------------
-2024-06-10 3.21.0
-2023-11-20 3.20.0
-2022-10-20 3.19.1
-2022-04-03 3.19.0
-2021-07-10 3.18.0
-2020-10-19 3.17.8
-2020-09-28 3.17.7
-2020-07-13 3.17.6
-2020-02-23 3.17.5
-2019-07-26 3.17.4
-2018-12-22 3.17.3
-2018-12-14 3.17.2
-2018-08-26 3.17.1
-2018-08-15 3.17.0
-2017-12-17 3.16.0
-2017-08-29 3.15.1
-2017-03-26 3.15.0
-2016-11-06 3.14.1
-2016-08-07 3.14.0
-2016-01-19 3.13.2
-2015-12-20 3.13.1
-2015-10-11 3.13.0
-2015-07-19 3.12.0
-2014-10-27 3.11.1
-2014-10-20 3.11.0
-2014-06-09 3.10.1
-2014-05-26 3.10.0
-2013-12-14 3.9.3
-2013-06-08 3.9.2
-2013-05-06 3.9.1
-2012-11-14 3.9.0
-2012-06-27 3.8.1
-2011-12-16 3.8.0
-2011-08-27 3.7.10
-2011-04-09 3.7.9
-2010-12-04 3.7.8
-2010-11-19 3.7.7
-2010-05-01 3.7.6
-2010-01-31 3.7.5
-2010-01-08 3.7.4
-2009-10-09 3.7.3
-2009-07-03 3.7.2
-2009-03-06 3.7.1
-2008-12-19 3.7.0
-2008-10-10 3.6.1
-2008-10-03 3.6.0
-2008-06-27 3.5.0
-2008-04-18 3.4.0
-2008-02-23 3.3.1
-2008-02-08 3.3.0
-2007-12-17 3.2.0
-2007-11-19 3.1.0
-2007-10-02 3.0.2
-2007-09-17 3.0.1
-2007-09-03 3.0.0
-2007-07-02 2.10.0
-2007-05-08 2.9.2
-2007-04-19 2.9.1
-2007-04-16 2.9.0
-2007-03-06 2.8.1
-2007-02-26 2.8.0
-2007-01-26 2.7.2
-2007-01-15 2.7.1
-2007-01-08 2.7.0
-2006-12-04 2.6.1 [first release as Claws Mail]
-2006-11-06 2.6.0
-2006-10-19 2.5.6
-2006-10-12 2.5.5
-2006-10-11 2.5.4
-2006-10-04 2.5.3
-2006-09-26 2.5.2
-2006-09-26 2.5.1
-2006-09-25 2.5.0
-2006-07-31 2.4.0
-2006-06-20 2.3.1
-2006-06-12 2.3.0
-2006-06-08 2.2.3
-2006-06-06 2.2.2
-2006-06-05 2.2.1
-2006-05-08 2.2.0
-2006-04-17 2.1.1
-2006-04-05 2.1.0
-2006-01-30 2.0.0
-2005-11-08 1.9.100
-2005-10-31 1.9.99
-2005-10-03 1.9.15
-2005-09-05 1.9.14
-2005-07-22 1.9.13
-2005-06-27 1.9.12
-2005-05-19 1.9.11
-2005-05-09 1.9.9
-2005-03-18 1.9.6
-
-GTK 1 Version
--------------
-2005-06-27 1.0.5
-2005-05-09 1.0.4a
-2005-03-24 1.0.4
-2005-03-10 1.0.3
-2005-02-08 1.0.1
-2005-01-17 1.0.0
-2004-12-06 0.9.13
-2004-09-27 0.9.12b
-2004-08-23 0.9.12a
-2004-06-28 0.9.12
-2004-05-31 0.9.11claws
-2004-03-08 0.9.10claws
-2004-02-06 0.9.9claws
-2003-12-19 0.9.8claws
-2003-11-26 0.9.7claws
-2003-10-02 0.9.6claws
-2003-09-10 0.9.5claws
-2003-08-04 0.9.4claws
-2003-07-12 0.9.3claws
-2003-05-24 0.9.0claws
-2003-03-12 0.8.11claws
-2003-02-12 0.8.10claws
-2003-01-24 0.8.9claws
-2002-12-26 0.8.8claws
-2002-12-23 0.8.7claws
-2002-11-25 0.8.6claws
-2002-10-07 0.8.5claws
-2002-09-22 0.8.3claws
-2002-08-28 0.8.2claws
-2002-07-30 0.8.1claws
-2002-07-23 0.8.0claws
-2002-06-15 0.7.8claws
-2002-05-18 0.7.6claws
-2002-04-28 0.7.5claws
-2002-03-11 0.7.4claws
-2002-02-19 0.7.2claws
-2002-02-14 0.7.1claws
-2002-01-14 0.7.0claws
-2001-12-16 0.6.6claws
-2001-10-16 0.6.5claws8
-2001-09-30 0.6.2claws
-2001-08-14 0.6.1claws
-2001-07-13 0.5.1claws
-2001-07-01 0.5.0claws3
-2001-06-16 0.4.99claws
-2001-05-29 0.4.99claws3
-2001-05-11 0.4.67claws1
-
-
-
-14. Useful links
-----------------
-Homepage
- https://www.claws-mail.org/
-User Contributed FAQ
- https://www.claws-mail.org/faq/
-Downloads
- https://www.claws-mail.org/releases.php
-Release Announcement Feed
- https://www.claws-mail.org/releases.rss
-Latest Release Notes
- https://www.claws-mail.org/news.php
-Other Downloads
- https://www.claws-mail.org/downloads.php
-List of Plugins
- https://www.claws-mail.org/plugins.php
-Icon Themes
- https://www.claws-mail.org/themes.php
-Mailing Lists
- https://www.claws-mail.org/MLs.php
-Users Mailing List archive
- https://lists.claws-mail.org/pipermail/users/index.html
-Commits Announcement List archive
- https://lists.claws-mail.org/pipermail/commits/index.html
-Bug/Patch/Feature Request Tracker
- https://www.thewildbeast.co.uk/claws-mail/bugzilla/index.cgi
-Internationalisation Status
- https://www.claws-mail.org/i18n.php
-Donations
- https://www.claws-mail.org/sponsors.php
-Claws Mail for Windows homepage
- https://www.claws-mail.org/win32/
-
blob - 8f8239fde092a7a0197fe77e3e31b865fbd57e71 (mode 644)
blob + /dev/null
--- RELEASE_NOTES
+++ /dev/null
-24th February 2025 Claws Mail 4.3.1
-
- CLAWS MAIL RELEASE NOTES
- http://www.claws-mail.org
-
-Claws Mail is a GTK+ based, user-friendly, lightweight, and fast
-email client.
-
-New in this release:
-~~~~~~~~~~~~~~~~~~~~
-
-* The configuration option, "Don't popup error dialog on receive error"
- has been changed to "Show error dialog on receive error". Your previous
- choice will be automatically changed to the new format.
-
-* The option "Warn when pasting files as attachments" has been added to
- the Compose/Writing preferences page. This option was previously
- hidden.
-
-* chmod 0600 is now set on *history files in the configuration directory.
-
-* A new preference has been added to enable setting the chmod value of
- saved attachments: "Save attachments with chmod [ ]", found on the
- Other/Miscelleanous preferences page. The default value is 600.
-
-* The creation and updating of .mh_sequences files in MH mailbox folders
- is now optional and disabled by default. This is controlled by a new
- hidden preference, mh_compat_mode. If you were previously relying on
- this feature, set mh_compat_mode=1 in clawsrc before running this
- version.
-
-* A new hidden preference has been added, passphrase_dialog_msg_title_switch.
- This switches the placement of the dialogue message with the dialogue
- title in the passphrase dialogue. This can be useful for interacting with
- third-party programs such as KeePassXC.
-
-* The top-level 'Mark' menu item has been renamed to 'Marks'. If you have
- set custom hotkeys for any items in this menu you will need to re-set
- them.
-
-* New accounts now have all secure options activated by default,
- including TLS connections and SMTP AUTH.
-
-* The option to accept valid TLS certificates is now activated by default
- on new accounts.
-
-* Notification plugin: support for Ayatana indicator has been added.
-
-* PDF Viewer plugin: support for image/x-eps (encapsulated postscript)
- images has been added.
-
-* Libravatar plugin: the https URL, https://seccdn.libravatar.org/avatar,
- is now used by default.
-
-* vCalendar plugin: CREATED/LAST_MODIFIED are correctly handled, and the
- VTIMEZONE component is used when present
-
-* Various code cleanups.
-
-* The English, Spanish and French manuals have been updated.
-
-* Updated translations: Albanian, Brazilian Portuguese, British English,
- Catalan, Czech, Dutch, French, Polish, Portuguese, Romanian, Russian,
- Simplified Chinese, Slovak, Spanish, Swedish, Turkish.
-
-* bug fixes:
- * bug 3964, 'Attachment icon doesn't show in message list unless
- the message is clicked and then disappears later'
- * bug 4658, 'Headers unfolded incorrectly in message view'
- * bug 4817, 'Edit button in Messages view->Text settings not
- translatable'
- * bug 4818, 'Your Claws Mail configuration is from a newer...'
- dialog is shown more than once'
- * bug 4819, 'Text wrapping broken when text contains an URL'
- * bug 4821, 'If the Mail folder is on another partition, folder
- chmod settings are not applied to draft and queue'
- * bug 4824, 'No syntax highlighting after exiting external editor'
- * bug 4828, '"Mark" not translated anymore'
- * bug 4835, 'Disallow a forward slash in (IMAP) account names'
- * bug 4840, 'core dump unsubscribing from newsgroups'
- * CID 1491093: attrib leaked if attvalue is null
- * CID 1491370: unchecked return value.
- * archive plugin build in debug mode.
- * keep newsgroup subscription window on top when 'subscribe to
- newsgroup...' fails and newsgroup list can't be retrieved
- * don't silently fail to save a sent msg
- * IMAP: show the clip icon in the message list as soon as
- possible
- * stop needlessly checking which folders want sycnhronising every
- time we select a msg in an MH mailbox
-
-For further details of the numbered bugs and RFEs listed above
-see https://www.claws-mail.org/bug/[BUG NUMBER]
-
----------------------------------------------------------------------
-See ChangeLog for full information regarding changes in this release.
-
