diff --git a/src/language_en.h b/src/language_en.h
index 9747a58..f56f1ec 100644
--- a/src/language_en.h
+++ b/src/language_en.h
@@ -197,29 +197,26 @@ static languageDefinition language_en = { whichPluralForm_en, {
       - The strings "Tidy" and "HTML Tidy" are the program name and must not
       be translated. */
         TidyCharEncoding,             0,
-        "This option specifies the character encoding Tidy uses for both the input "
-        "and output. "
+        "This option specifies the character encoding Tidy uses for input, and "
+        "when set, automatically chooses an appropriate character encoding to "
+        "be used for output. The output encoding Tidy chooses may be different "
+        "from the input encoding. "
         "<br/>"
-        "For <var>ascii</var> Tidy will accept Latin-1 (ISO-8859-1) character "
-        "values, but will use entities for all characters whose value &gt;127. "
+        "For <var>ascii</var>, <var>latin0</var>, <var>ibm858</var>, "
+        "<var>mac</var>, and <var>win1252</var> input encodings, the "
+        "<code>output-encoding</code> option will automatically be set to "
+        "<var>ascii</var>. You can set <code>output-encoding</code> manually "
+        "to override this. "
         "<br/>"
-        "For <var>raw</var>, Tidy will output values above 127 without "
-        "translating them into entities. "
+        "For other input encodings, the <code>output-encoding</code> option "
+        "will automatically be set to the the same value. "
         "<br/>"
-        "For <var>latin1</var>, characters above 255 will be written as entities. "
+        "Regardless of the preset value, you can set "
+        "<code>output-encoding</code> manually to override this. "
         "<br/>"
-        "For <var>utf8</var>, Tidy assumes that both input and output are encoded "
-        "as UTF-8. "
-        "<br/>"
-        "You can use <var>iso2022</var> for files encoded using the ISO-2022 "
-        "family of encodings e.g. ISO-2022-JP. "
-        "<br/>"
-        "For <var>mac</var> and <var>win1252</var>, Tidy will accept vendor "
-        "specific character values, but will use entities for all characters whose "
-        "value &gt;127. "
-        "<br/>"
-        "For unsupported encodings, use an external utility to convert to and from "
-        "UTF-8. "
+        "Tidy is not an encoding converter. Although the Latin and UTF "
+        "encodings can be mixed freely, it is not possible to convert Asian "
+        "encodings to Latin encodings with Tidy. "
     },
     {/* Important notes for translators:
       - Use only <code></code>, <var></var>, <em></em>, <strong></strong>, and
@@ -559,8 +556,25 @@ static languageDefinition language_en = { whichPluralForm_en, {
       - The strings "Tidy" and "HTML Tidy" are the program name and must not
       be translated. */
         TidyInCharEncoding,           0,
-        "This option specifies the character encoding Tidy uses for the input. See "
-        "<code>char-encoding</code> for more info. "
+        "This option specifies the character encoding Tidy uses for input. "
+        "Tidy makes certain assumptions about some of the input encodings. "
+        "<br/>"
+        "For <var>ascii</var>, Tidy will accept Latin-1 (ISO-8859-1) character "
+        "values and convert them to entities as necessary. "
+        "<br/>"
+        "For <var>raw</var>, Tidy will make no assumptions about the character "
+        "values and will pass them unchanged to output. "
+        "<br/>"
+        "For <var>mac</var> and <var>win1252</var>, vendor specific characters "
+        "values will be accepted and converted to entities as necessary. "
+        "<br/>"
+        "Asian encodings such as <var>iso2022</var> will be handled "
+        "appropriately assuming the corresponding <code>output-encoding</code> "
+        "is also specified. "
+        "<br/>"
+        "Tidy is not an encoding converter. Although the Latin and UTF "
+        "encodings can be mixed freely, it is not possible to convert Asian "
+        "encodings to Latin encodings with Tidy. "
     },
     {/* Important notes for translators:
       - Use only <code></code>, <var></var>, <em></em>, <strong></strong>, and
@@ -759,9 +773,9 @@ static languageDefinition language_en = { whichPluralForm_en, {
         TidyMakeClean,                0,
         "This option specifies if Tidy should perform cleaning of some legacy "
         "presentational tags (currently <code>&lt;i&gt;</code>, "
-        "<code>&lt;b&gt;</code>, <code>&lt;center&gt;</code> when enclosed within "
-        "appropriate inline tags, and <code>&lt;font&gt;</code>). If set to "
-        "<var>yes</var> then legacy tags will be replaced with CSS "
+        "<code>&lt;b&gt;</code>, <code>&lt;center&gt;</code> when enclosed "
+        "within appropriate inline tags, and <code>&lt;font&gt;</code>). If "
+        "set to <var>yes</var>, then the legacy tags will be replaced with CSS "
         "<code>&lt;style&gt;</code> tags and structural markup as appropriate. "
     },
     {/* Important notes for translators:
@@ -857,8 +871,9 @@ static languageDefinition language_en = { whichPluralForm_en, {
         TidyNewline,                  0,
         "The default is appropriate to the current platform. "
         "<br/>"
-        "Genrally CRLF on PC-DOS, Windows and OS/2; CR on Classic Mac OS; and LF "
-        "everywhere else (Linux, Mac OS X, and Unix). "
+        "Genrally <var>CRLF</var> on PC-DOS, Windows and OS/2; <var>CR</var> "
+        "on Classic Mac OS; and <var>LF</var> everywhere else (Linux, macOS, "
+        "and Unix). "
     },
     {/* Important notes for translators:
       - Use only <code></code>, <var></var>, <em></em>, <strong></strong>, and
@@ -910,14 +925,32 @@ static languageDefinition language_en = { whichPluralForm_en, {
       - The strings "Tidy" and "HTML Tidy" are the program name and must not
       be translated. */
         TidyOutCharEncoding,          0,
-        "This option specifies the character encoding Tidy uses for the output. "
+        "This option specifies the character encoding Tidy uses for "
+        "output. Some of the output encodings affect whether or not "
+        "some characters are translated to entities, although in all "
+        "cases, some entities will be written according to other Tidy "
+        "configuration options. "
         "<br/>"
-        "Note that this may only be different from <code>input-encoding</code> for "
-        "Latin encodings (<var>ascii</var>, <var>latin0</var>, "
-        "<var>latin1</var>, <var>mac</var>, <var>win1252</var>, "
-        "<var>ibm858</var>)."
+        "For <var>ascii</var>, <var>mac</var>, and <var>win1252</var> "
+        "output encodings, entities will be used for all characters "
+        "with values over 127. "
         "<br/>"
-        "See <code>char-encoding</code> for more information"
+        "For <var>raw</var> output, Tidy will write values above 127 "
+        "without translating them to entities. "
+        "<br/>"
+        "Output using <var>latin1</var> will cause Tidy to write "
+        "character values higher than 255 as entities. "
+        "<br/>"
+        "The UTF family such as <var>utf8</var> will write output "
+        "in the respective UTF encoding. "
+        "<br/>"
+        "Asian output encodings such as <var>iso2022</var> will write "
+        "output in the specified encoding, assuming a corresponding "
+        "<code>input-encoding</code> was specified. "
+        "<br/>"
+        "Tidy is not an encoding converter. Although the Latin and UTF "
+        "encodings can be mixed freely, it is not possible to convert Asian "
+        "encodings to Latin encodings with Tidy. "
     },
     {/* Important notes for translators:
       - Use only <code></code>, <var></var>, <em></em>, <strong></strong>, and
@@ -1017,8 +1050,8 @@ static languageDefinition language_en = { whichPluralForm_en, {
         TidyPriorityAttributes,       0,
         "This option allows prioritizing the writing of attributes in tidied "
         "documents, allowing them to written before the other attributes of an "
-        "element. For example, you might specify that <var>id</var> and "
-        "<var>name</var> are written before every other attribute. "
+        "element. For example, you might specify that <strong>id</strong> and "
+        "<strong>name</strong> are written before every other attribute. "
         "<br/>"
         "This option takes a space or comma separated list of attribute names. "
     },
@@ -1186,7 +1219,7 @@ static languageDefinition language_en = { whichPluralForm_en, {
       be translated. */
         TidyMuteReports,           0,
         "Use this option to prevent Tidy from displaying certain types of "
-        "report output,for example, for conditions that you wish to ignore."
+        "report output, for example, for conditions that you wish to ignore. "
         "<br/>"
         "This option takes a list of one or more keys indicating the message "
         "type to mute. You can discover these message keys by using the "
@@ -1283,10 +1316,11 @@ static languageDefinition language_en = { whichPluralForm_en, {
       be translated. */
         TidyUseCustomTags,          0,
         "This option enables the use of tags for autonomous custom elements, "
-        "e.g. &lt;flag-icon&gt; with Tidy. Custom tags are disabled if this "
-        "value is <var>no</var>. Other settings - <var>blocklevel</var>, "
-        "<var>empty</var>, <var>inline</var>, and <var>pre</var> will treat "
-        "<em>all</em> detected custom tags accordingly. "
+        "e.g. <code>&lt;flag-icon&gt;</code> with Tidy. Custom tags are "
+        "disabled if this value is <var>no</var>. Other settings - "
+        "<var>blocklevel</var>, <var>empty</var>, <var>inline</var>, and "
+        "<var>pre</var> will treat <em>all</em> detected custom tags "
+        "accordingly. "
         "<br/>"
         "The use of <code>new-blocklevel-tags</code>, "
         "<code>new-empty-tags</code>, <code>new-inline-tags</code>, or "
@@ -1335,11 +1369,12 @@ static languageDefinition language_en = { whichPluralForm_en, {
       - The strings "Tidy" and "HTML Tidy" are the program name and must not
       be translated. */
         TidyWord2000,                 0,
-        "This option specifies if Tidy should go to great pains to strip out all "
-        "the surplus stuff Microsoft Word 2000 inserts when you save Word "
+        "This option specifies if Tidy should go to great pains to strip out "
+        "all the surplus stuff Microsoft Word 2000 inserts when you save Word "
         "documents as \"Web pages\". It doesn't handle embedded images or VML. "
         "<br/>"
-        "You should consider using Word's \"Save As: Web Page, Filtered\". "
+        "You should consider saving using Word's <strong>Save As...</strong>, "
+        "and choosing <strong>Web Page, Filtered</strong>. "
     },
     {/* Important notes for translators:
       - Use only <code></code>, <var></var>, <em></em>, <strong></strong>, and
@@ -1402,8 +1437,8 @@ static languageDefinition language_en = { whichPluralForm_en, {
         "<br/>"
         "Tidy tries to wrap lines so that they do not exceed this length. "
         "<br/>"
-        "Set <code>wrap</code> to <var>0</var>(zero) if you want to disable line "
-        "wrapping. "
+        "Set <code>wrap</code> to <var>0</var> (zero) if you want to disable "
+        "line wrapping. "
     },
     {/* Important notes for translators:
       - Use only <code></code>, <var></var>, <em></em>, <strong></strong>, and