commit 36067e24da07e071cb6ca722029a484ac9d48fed from: Oliver Lowe date: Fri Nov 28 23:23:04 2025 UTC introduce talons name goals bla bla commit - 0ff4587f0a234a51c6e99607620f466629b9faff commit + 36067e24da07e071cb6ca722029a484ac9d48fed blob - e32d52d2b7d231897f74b7a5723e5617970ba78b (mode 644) blob + /dev/null --- ABOUT-NLS +++ /dev/null @@ -1,996 +0,0 @@ -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 @@ -1,106 +0,0 @@ -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 @@ -0,0 +1,61 @@ +# 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 @@ -1,791 +0,0 @@ -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 . - - 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 - 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 -. 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 @@ -1,97 +0,0 @@ -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. -