Document email.charsets in hgrc.5
authorChristian Ebert <blacktrash@gmx.net>
Thu, 16 Oct 2008 17:08:46 +0200
changeset 7117 ceb8aef03aa7
parent 7116 e981725da3fe
child 7118 619ebf82cef2
Document email.charsets in hgrc.5 hgrc.5.ja.txt probably should include an example like: [email] charsets = iso-8859-1, iso-8859-15, windows-1252, iso-8859-2, windows-1250, iso-2022-jp, iso-2022-jp-ms
doc/hgrc.5.txt
--- a/doc/hgrc.5.txt	Sat Jul 12 19:12:18 2008 +0100
+++ b/doc/hgrc.5.txt	Thu Oct 16 17:08:46 2008 +0200
@@ -214,12 +214,23 @@
     recipients on command line, message on stdin). Normally, setting
     this to "sendmail" or "/usr/sbin/sendmail" is enough to use
     sendmail to send messages.
+  charsets;;
+    Optional. Comma-separated list of charsets considered
+    convenient for recipients. Addresses, headers, and parts not
+    containing patches of outgoing messages will be encoded in
+    the first charset to which conversion from local encoding
+    (ui.encoding, ui.fallbackencoding) succeeds. If correct
+    conversion, including to ui.encoding, fails, the text in
+    question is sent as is in fake ascii. Defaults to empty list.
 
   Email example:
 
     [email]
     from = Joseph User <joe.user@example.com>
     method = /usr/sbin/sendmail
+    # charsets for western europeans
+    # us-ascii, utf-8 omitted, as they are tried first and last
+    charsets = iso-8859-1, iso-8859-15, windows-1252
 
 [[extensions]]
 extensions::