TDE core libraries
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Timothy Pearson 2cd1515186 Bring most mimetypes in line with XDG specifications. The following are not fully verified in source as of this commit due to ubiquity: html, empty, info, make, man, misc, source, unknown 4 years ago
..
formats Revert commit 1d498994 5 years ago
plugins Fix ServiceTypes, ExcludeServiceTypes, and DocPath desktop file entries to match XDG specifications 4 years ago
scripts Add the following patch from Bug 1499 tdelibs: add postofficebox suppot in tdeabc 4 years ago
tests Additional k => tde renaming and fixes 5 years ago
vcard Fix tdecore directories of linked libraries 5 years ago
vcardparser Additional k => tde renaming and fixes 5 years ago
CMakeLists.txt Fix dependencies in CMake targets 4 years ago
HACKING Rename additional header files to avoid conflicts with KDE4 6 years ago
HOWTO Additional k => tde renaming and fixes 5 years ago
Makefile.am Additional k => tde renaming and fixes 5 years ago
README Additional k => tde renaming and fixes 5 years ago
README.AddressFormat Additional k => tde renaming and fixes 5 years ago
TODO Rename additional header files to avoid conflicts with KDE4 6 years ago
address.cpp Additional k => tde renaming and fixes 5 years ago
address.h Additional k => tde renaming and fixes 5 years ago
addressbook.cpp Additional k => tde renaming and fixes 5 years ago
addressbook.h Additional k => tde renaming and fixes 5 years ago
addresseedialog.cpp Additional k => tde renaming and fixes 5 years ago
addresseedialog.h Additional k => tde renaming and fixes 5 years ago
addresseehelper.cpp Additional k => tde renaming and fixes 5 years ago
addresseehelper.h Rename KABC namespace 6 years ago
addresseelist.cpp Additional k => tde renaming and fixes 5 years ago
addresseelist.h Additional k => tde renaming and fixes 5 years ago
addresslineedit.cpp Additional k => tde renaming and fixes 5 years ago
addresslineedit.h Additional k => tde renaming and fixes 5 years ago
agent.cpp Additional k => tde renaming and fixes 5 years ago
agent.h Additional k => tde renaming and fixes 5 years ago
countrytransl.map Rename additional header files to avoid conflicts with KDE4 6 years ago
distributionlist.cpp Additional k => tde renaming and fixes 5 years ago
distributionlist.h Additional k => tde renaming and fixes 5 years ago
distributionlistdialog.cpp Additional k => tde renaming and fixes 5 years ago
distributionlistdialog.h Additional k => tde renaming and fixes 5 years ago
distributionlisteditor.cpp Additional k => tde renaming and fixes 5 years ago
distributionlisteditor.h Additional k => tde renaming and fixes 5 years ago
errorhandler.cpp Additional k => tde renaming and fixes 5 years ago
errorhandler.h Additional k => tde renaming and fixes 5 years ago
field.h Additional k => tde renaming and fixes 5 years ago
format.h Additional k => tde renaming and fixes 5 years ago
formatfactory.cpp Additional k => tde renaming and fixes 5 years ago
formatfactory.h Additional k => tde renaming and fixes 5 years ago
formatplugin.h Additional k => tde renaming and fixes 5 years ago
geo.cpp Additional k => tde renaming and fixes 5 years ago
geo.h Additional k => tde renaming and fixes 5 years ago
key.cpp Additional k => tde renaming and fixes 5 years ago
key.h Additional k => tde renaming and fixes 5 years ago
ldapclient.cpp Rename KABC namespace 6 years ago
ldapclient.h Rename KABC namespace 6 years ago
ldapconfigwidget.cpp Additional k => tde renaming and fixes 5 years ago
ldapconfigwidget.h Additional k => tde renaming and fixes 5 years ago
ldapurl.cpp Additional k => tde renaming and fixes 5 years ago
ldapurl.h Additional k => tde renaming and fixes 5 years ago
ldif.cpp Additional k => tde renaming and fixes 5 years ago
ldif.h Additional k => tde renaming and fixes 5 years ago
ldifconverter.cpp Additional k => tde renaming and fixes 5 years ago
ldifconverter.h Additional k => tde renaming and fixes 5 years ago
lock.cpp Additional k => tde renaming and fixes 5 years ago
lock.h Additional k => tde renaming and fixes 5 years ago
locknull.cpp Additional k => tde renaming and fixes 5 years ago
locknull.h Additional k => tde renaming and fixes 5 years ago
phonenumber.cpp Additional k => tde renaming and fixes 5 years ago
phonenumber.h Additional k => tde renaming and fixes 5 years ago
picture.cpp Additional k => tde renaming and fixes 5 years ago
picture.h Additional k => tde renaming and fixes 5 years ago
plugin.cpp Additional k => tde renaming and fixes 5 years ago
plugin.h Additional k => tde renaming and fixes 5 years ago
resource.cpp Additional k => tde renaming and fixes 5 years ago
resource.h Additional k => tde renaming and fixes 5 years ago
resourceselectdialog.cpp Additional k => tde renaming and fixes 5 years ago
resourceselectdialog.h Additional k => tde renaming and fixes 5 years ago
secrecy.cpp Additional k => tde renaming and fixes 5 years ago
secrecy.h Additional k => tde renaming and fixes 5 years ago
sortmode.cpp Additional k => tde renaming and fixes 5 years ago
sortmode.h Additional k => tde renaming and fixes 5 years ago
sound.cpp Additional k => tde renaming and fixes 5 years ago
sound.h Additional k => tde renaming and fixes 5 years ago
stdaddressbook.cpp Additional k => tde renaming and fixes 5 years ago
stdaddressbook.h Additional k => tde renaming and fixes 5 years ago
tdeab2tdeabc.cpp Additional k => tde renaming and fixes 5 years ago
tdeab2tdeabc.desktop Bring most mimetypes in line with XDG specifications. The following are not fully verified in source as of this commit due to ubiquity: html, empty, info, make, man, misc, source, unknown 4 years ago
tdeabc_manager.desktop Fix ServiceTypes, ExcludeServiceTypes, and DocPath desktop file entries to match XDG specifications 4 years ago
timezone.cpp Additional k => tde renaming and fixes 5 years ago
timezone.h Additional k => tde renaming and fixes 5 years ago
vcard21parser.cpp Additional k => tde renaming and fixes 5 years ago
vcard21parser.h Additional k => tde renaming and fixes 5 years ago
vcardconverter.cpp Additional k => tde renaming and fixes 5 years ago
vcardconverter.h Additional k => tde renaming and fixes 5 years ago
vcardformat.cpp Additional k => tde renaming and fixes 5 years ago
vcardformat.h Additional k => tde renaming and fixes 5 years ago
vcardformatimpl.cpp Additional k => tde renaming and fixes 5 years ago
vcardformatimpl.h Additional k => tde renaming and fixes 5 years ago
vcardformatplugin.cpp Additional k => tde renaming and fixes 5 years ago
vcardformatplugin.h Additional k => tde renaming and fixes 5 years ago
vcardtool.cpp Additional k => tde renaming and fixes 5 years ago
vcardtool.h Additional k => tde renaming and fixes 5 years ago

README.AddressFormat

Address formats can be a tricky thing. libtdeabc tries very hard to perfectly fit
the needs of ~95% of users and to be at least sufficient for the other 5%.

The formatting of an address depends on the destination country as well as on
the origin country of a letter. Basically, the part indicating the destination
country follows the rules of the country of origin, all the rest follows the
rules of the destination country. So we need to store for every country a) the
country positioning and b) the address formatting.

Address formats should usually be stored in a country's entry.desktop. There we
store the country position in field "AddressCountryPosition" and the address
format in a field "AddressFormat". Note that for most countries one field
"AddressFormat" is sufficient for personal as well as company addresses
(because personal addresses look just like business addresses without company);
however, in some countries (eg. Hungary) business addresses differ in their
structure. In this case you have the possibility of adding another field
"BusinessAddressFormat" which will be preferred for formatting of business
addresses; if libtdeabc can't find such a field, it will fall back to
"AddressFormat". (Please use BusinessAddressFormat ONLY if you really need to)

The format consists mainly of tags that will be replaced by address fields.
The list of tags may grow in the future, the format *might* change in the near
future, but I hope not.

Any comments very very welcome to kde-pim@kde.org or to jost@schenck.de.

-Jost.

Fields AddressFormat and BusinessAddressFormat
------------------------------------------------
%n = real name
%N = REAL NAME
%cm = company
%CM = COMPANY
%s = street
%S = STREET
%z = zip code
%l = location
%L = LOCATION
%r = region
%R = REGION
%p = post office box
%, = conditional comma+whitespace,
will be left out if the value left or right of it is purged
%w = conditional whitespace,
will be left out if the value left or right of it is purged
%0(...) = the text inside the brackets will be completely purged if not
at least one tag inside it evaluates to something. Example: when the
address doesn't have a postbox, the string %0(PO Box %p) will not
evaluate to "PO Box " but to an empty string.
\n = newline

Field AddressCountryPosition
------------------------------------------------
below = country name below rest of address
BELOW = country name below in capital letters
above = country name above rest of address
ABOVE = country name above in capital letters

Some Tips
------------------------------------------------
- You sometimes have three fields in a line which can all be empty. If you eg.
separate them all with conditional whitespace (same goes for cond. comma) like
in "%z%w%r%w%l" and only the middle value (here: region) is empty, there will
be no whitespace at all between the outer values (here: zipcode and location).
To avoid this, combine two of these values with purge brackets: %0(%z%w%r)%w%l.