diff --git a/src/localize.c b/src/localize.c
index 2decdd6..5469c50 100755
--- a/src/localize.c
+++ b/src/localize.c
@@ -379,29 +379,37 @@ static const TidyOptionDoc option_docs[] =
 {
   {TidyXmlDecl,
    "This option specifies if Tidy should add the XML declaration when "
-   "outputting XML or XHTML. Note that if the input already includes an "
-   "<?xml ... ?> declaration then this option will be ignored. "
-   "If the encoding for the output is different from \"ascii\", one of the "
-   "utf encodings or \"raw\", the declaration is always added as required by "
-   "the XML standard. "
+   "outputting XML or XHTML. "
+   "<br/>"
+   "Note that if the input already includes an <code>&lt;?xml ... ?&gt;</code> "
+   "declaration then this option will be ignored. "
+   "<br/>"
+   "If the encoding for the output is different from <code>ascii</code>, one "
+   "of the utf encodings or <code>raw</code>, the declaration is always added "
+   "as required by the XML standard. "
    , TidyXmlDeclLinks
   },
   {TidyXmlSpace,
-   "This option specifies if Tidy should add xml:space=\"preserve\" to "
-   "elements such as &lt;PRE&gt;, &lt;STYLE&gt; and &lt;SCRIPT&gt; when "
-   "generating XML. This is needed if the whitespace in such elements is to "
+   "This option specifies if Tidy should add "
+   "<code>xml:space=\"preserve\"</code> to elements such as "
+   "<code>&lt;PRE&gt;</code>, <code>&lt;STYLE&gt;</code> and "
+   "<code>&lt;SCRIPT&gt;</code> when generating XML. "
+   "<br/>"
+   "This is needed if the whitespace in such elements is to "
    "be parsed appropriately without having access to the DTD. "
   },
   {TidyAltText,
-   "This option specifies the default \"alt=\" text Tidy uses for "
-   "&lt;IMG&gt; attributes. This feature is dangerous as it suppresses "
-   "further accessibility warnings. You are responsible for making your "
-   "documents accessible to people who can not see the images! "
+   "This option specifies the default <code>alt=</code> text Tidy uses for "
+   "<code>&lt;IMG&gt;</code> attributes. "
+   "<br/>"
+   "Use with care, as this feature suppresses further accessibility warnings. "
   },
   {TidyXmlPIs,
    "This option specifies if Tidy should change the parsing of processing "
-   "instructions to require ?&gt; as the terminator rather than &gt;. This "
-   "option is automatically set if the input is in XML. "
+   "instructions to require <code>?&gt;</code> as the terminator rather than "
+   "<code>&gt;</code>. "
+   "<br/>"
+   "This option is automatically set if the input is in XML. "
   },
   {TidyMakeBare,
    "This option specifies if Tidy should strip Microsoft specific HTML "
@@ -409,39 +417,47 @@ static const TidyOptionDoc option_docs[] =
    "spaces where they exist in the input. "
   },
   {TidyCSSPrefix,
-   "This option specifies the prefix that Tidy uses for styles rules. By "
-   "default, \"c\" will be used. "
+   "This option specifies the prefix that Tidy uses for styles rules. "
+   "<br/>"
+   "By default, <code>c</code> will be used. "
   },
   {TidyMakeClean,
-   "This option specifies if Tidy "
-   "should perform cleaning of some legacy presentational tags (currently "
-   "&lt;i&gt;, &lt;b&gt;, &lt;center&gt; when enclosed within appropriate "
-   "inline tags, and &lt;font&gt;). If set then legacy tags will be replaced "
-   "with CSS &lt;style&gt; tags and structural markup as appropriate. " 
+   "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 "
+   "<code>YES</code> then legacy tags will be replaced with CSS "
+   "<code>&lt;style&gt;</code> tags and structural markup as appropriate. " 
    ,
   },
   {TidyGDocClean,
-   "This option specifies if Tidy "
-   "should enable specific behavior for cleaning up HTML exported from "
-   "Google Docs. "
+   "This option specifies if Tidy should enable specific behavior for "
+   "cleaning up HTML exported from Google Docs. "
    ,
   },
   {TidyDoctype,
-   "This option specifies the DOCTYPE declaration generated by Tidy.<br />"
-   "If set to \"omit\" the output won't contain a DOCTYPE declaration.<br />"
-   "If set to \"html5\" the DOCTYPE is set to \"&lt;!DOCTYPE html>\".<br />"
-   "If set to \"auto\" (the default) Tidy will use an educated guess based "
-   "upon the contents of the document.<br />"
-   "If set to \"strict\", Tidy will set the DOCTYPE to the HTML4 or XHTML1 "
-   "strict DTD.<br />"
-   "If set to \"loose\", the DOCTYPE is set to the HTML4 or XHTML1 loose "
-   "(transitional) DTD. <br />"
+   "This option specifies the DOCTYPE declaration generated by Tidy. "
+   "<br/>"
+   "If set to <code>omit</code> the output won't contain a DOCTYPE declaration. "
+   "<br/>"
+   "If set to <code>html5</code> the DOCTYPE is set to <code>&lt;!DOCTYPE html&gt;</code>."
+   "<br/>"
+   "If set to <code>auto</code> (the default) Tidy will use an educated guess "
+   "based upon the contents of the document."
+   "<br/>"
+   "If set to <code>strict</code>, Tidy will set the DOCTYPE to the HTML4 or "
+   "XHTML1 strict DTD."
+   "<br/>"
+   "If set to <code>loose</code>, the DOCTYPE is set to the HTML4 or XHTML1 "
+   "loose (transitional) DTD."
+   "<br/>"
    "Alternatively, you can supply a string for the formal public identifier "
-   "(FPI).<br />"
-   "<br />"
-   "For example: <br />"
-   "doctype: \"-//ACME//DTD HTML 3.14159//EN\"<br />"
+   "(FPI)."
    "<br />"
+   "For example: "
+   "<br/>"
+   "<code>doctype: \"-//ACME//DTD HTML 3.14159//EN\"</code>"
+   "<br/>"
    "If you specify the FPI for an XHTML document, Tidy will set the "
    "system identifier to an empty string. For an HTML document, Tidy adds a "
    "system identifier only if one was already present in order to preserve "