[PATCH 4 of 6] Document email.charsets in hgrc.5

[Christian Ebert]

# HG changeset patch
# User Christian Ebert <blacktrash at gmx.net>
# Date 1215891079 -3600
# Node ID 22d79713a3e99299da562a244c6afacaaa29a771
# Parent  df58ec4cd9f390796caec0fb7f4b1fb43aad26ae
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 --git a/doc/hgrc.5.txt b/doc/hgrc.5.txt
--- a/doc/hgrc.5.txt
+++ b/doc/hgrc.5.txt
@@ -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 at example.com>
     method = /usr/sbin/sendmail
+    # charsets for western europeans
+    # us-ascii can be omitted, as it is always tried first
+    charsets = iso-8859-1, iso-8859-15, windows-1252, utf-8
 
 [[extensions]]
 extensions::