# HG changeset patch
# User Christian Ebert <blacktrash@gmx.net>
# Date 1224169726 -7200
# Node ID ceb8aef03aa7934f6cacd95d7e1b86ef3cd9e1da
# Parent  e981725da3fe1052a8872a15a1bda03ebde67468
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

diff -r e981725da3fe -r ceb8aef03aa7 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::