[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[elpa] externals/ebdb 110ece1 295/350: Mention internationalization libr
From: |
Eric Abrahamsen |
Subject: |
[elpa] externals/ebdb 110ece1 295/350: Mention internationalization library in the manual |
Date: |
Mon, 14 Aug 2017 11:46:58 -0400 (EDT) |
branch: externals/ebdb
commit 110ece1481dc3a73bff615024725ae5ebfb9fc1b
Author: Eric Abrahamsen <address@hidden>
Commit: Eric Abrahamsen <address@hidden>
Mention internationalization library in the manual
* ebdb.org (Internationalization): New section.
---
ebdb.org | 26 ++++++++++++++++++++++++++
1 file changed, 26 insertions(+)
diff --git a/ebdb.org b/ebdb.org
index b2dabb7..5ff3e56 100644
--- a/ebdb.org
+++ b/ebdb.org
@@ -695,6 +695,32 @@ article headers.
Snarf the body of the current article. This will also snarf the
headers of forwarded emails.
+* Internationalization
+#+CINDEX: Internationalization
+EBDB comes with an internationalization framework that can provide
+country- and region-specific behavior for certain fields. This
+functionality is initialized by loading the
+@@texinfo:@file{@@ebdb-i18n@@texinfo:}@@ library. This library does
+nothing by itself, it simply provides hooks for other country-specific
+libraries, which must be loaded separately.
+
+At present, EBDB comes with only one country-specific library,
+@@texinfo:@file{@@ebdb-chn@@texinfo:}@@, for Chinese-related fields.
+It parses and displays phone numbers and names correctly, and also
+allows users to search on Chinese names using pinyin. It requires the
+~pyim~ package, available on MELPA.
+
+The present dearth of libraries is a result of the author scratching
+his own itch. Contributions of new libraries are very welcome. Also
+welcome, though less enthusiastically, are requests for new libraries.
+
+Internationalization libraries do not modify the database in any way,
+and can be safely unloaded. They simply alter the way EBDB reads,
+parses and displays field values, and can also store extra information
+(eg.@@texinfo:@:@@g for searching purposes) in a record's cache.
+Loading this library can (depending on country libraries' behavior)
+increase database load times, though it should not significantly
+affect search or display performance.
* Diary Integration
Some EBDB fields hold dates or anniversaries (most notably the
~ebdb-field-anniversary~ field). It's possible to integrate this
- [elpa] externals/ebdb f62f15f 282/350: Pop up empty *EBDB* buffer for users with no records, (continued)
- [elpa] externals/ebdb f62f15f 282/350: Pop up empty *EBDB* buffer for users with no records, Eric Abrahamsen, 2017/08/14
- [elpa] externals/ebdb f3f9f37 292/350: Move, rename and bind ebdb-mail-yank, Eric Abrahamsen, 2017/08/14
- [elpa] externals/ebdb 89467fc 258/350: Don't wrap cl-print-object in eval-when-compile, Eric Abrahamsen, 2017/08/14
- [elpa] externals/ebdb 5e7a0d6 266/350: Change arg order of record-insert|delete-field, refactor, Eric Abrahamsen, 2017/08/14
- [elpa] externals/ebdb 75de073 314/350: Let ebdb-complete can grab string which similar "guix-devel" (#46), Eric Abrahamsen, 2017/08/14
- [elpa] externals/ebdb dbf980e 288/350: Create specific keymap for using EBDB in MUAs, Eric Abrahamsen, 2017/08/14
- [elpa] externals/ebdb 4a35635 297/350: Mention vCard export support in manual, Eric Abrahamsen, 2017/08/14
- [elpa] externals/ebdb 13f32ef 304/350: Fix propertize call when formatting field values, Eric Abrahamsen, 2017/08/14
- [elpa] externals/ebdb 9169c1e 309/350: When inserting fields, read the field but insert a clone, Eric Abrahamsen, 2017/08/14
- [elpa] externals/ebdb 6c89a57 302/350: Mention record citing in the manual, Eric Abrahamsen, 2017/08/14
- [elpa] externals/ebdb 110ece1 295/350: Mention internationalization library in the manual,
Eric Abrahamsen <=
- [elpa] externals/ebdb 3d4a236 299/350: Mention all supported MUAs in manual, Eric Abrahamsen, 2017/08/14
- [elpa] externals/ebdb aea28d9 313/350: Add test for with-record-edits macro, Eric Abrahamsen, 2017/08/14
- [elpa] externals/ebdb 6687da1 244/350: Remove redundant customization group ebdb-utilities-snarf, Eric Abrahamsen, 2017/08/14
- [elpa] externals/ebdb 0904c14 281/350: Split ebdb-org-open into two functions, Eric Abrahamsen, 2017/08/14
- [elpa] externals/ebdb 88fc231 280/350: ebdb-complete: Add mail-mode support (#44), Eric Abrahamsen, 2017/08/14
- [elpa] externals/ebdb 63d2588 285/350: Combine with previous commit, Eric Abrahamsen, 2017/08/14
- [elpa] externals/ebdb 5fd19ea 287/350: Simplify MUA record editing, Eric Abrahamsen, 2017/08/14
- [elpa] externals/ebdb 8cdb1d1 307/350: Fix bug in ebdb-char-fold-search logic, Eric Abrahamsen, 2017/08/14
- [elpa] externals/ebdb 5329d89 306/350: Mark arg as used in call to ebdb-with-record-edits, Eric Abrahamsen, 2017/08/14
- [elpa] externals/ebdb 56f8f5f 301/350: Mention Org integration in the manual, Eric Abrahamsen, 2017/08/14