Touch up option descriptions, particularly the encoding options in order to better describe their interaction.

This commit is contained in:
Jim Derry 2017-10-26 14:25:02 -04:00
parent aec686b1a9
commit 056bd85d3d
1 changed files with 79 additions and 44 deletions

View File

@ -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