Skip to content

Commit 7d290bc

Browse files
yitzhaqclaude
andcommitted
Modernize and repair bundled HTML help documentation
Address the trivially-mechanical, safe subset of the SonarCloud HTML5 findings on the bundled help pages (macOS Help Book + Linux help): - Add <!DOCTYPE html> to 60 pages (Web:DoctypePresenceCheck). - Add lang="en" to the <html> element (Web:S5254). - Replace deprecated <tt> with <code> (Web:UnsupportedTagsInHtml5Check, the <tt> subset: 15 in abook.html, 28 in faq.html). Two Linux help files (faq.html, toc.html) were stored as C string-literal arrays ("...\n" per line, terminating with ";") rather than HTML, so they rendered as literal quoted text. Decode them back to HTML (round-trip verified byte-exact apart from the source file's trailing newline), then modernize them like the rest. The transform is byte-aware and preserves each file's existing line endings (classic-Mac CR for the macOS Help Book, LF for Linux help). Deferred to a separate pass (not mechanical): the <font>/<center> deprecated-element findings (need faithful conversion to inline CSS to avoid changing appearance), and the <table> header / frameset findings (semantic, require per-document judgement). Found by SonarCloud. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
1 parent 121054b commit 7d290bc

60 files changed

Lines changed: 275 additions & 270 deletions

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

Linux/Help/faq.html

Lines changed: 198 additions & 197 deletions
Large diffs are not rendered by default.

Linux/Help/toc.html

Lines changed: 16 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -1,15 +1,16 @@
1-
"<html>\n"
2-
"<head>\n"
3-
"<title>Mulberry Help</title>\n"
4-
"</head>\n"
5-
"\n"
6-
"<h3> Mulberry Help </h3>\n"
7-
"\n"
8-
"<ul>\n"
9-
"<li> <a href=http://www.mulberrymail.com>Mulberry on the Web</a>\n"
10-
"<p>\n"
11-
"<li> <a href=mailto:mulberry-support@mulberrymail.com>Technical support</a>\n"
12-
"<p>\n"
13-
"</ul>\n"
14-
"\n"
15-
"</html>";
1+
<!DOCTYPE html>
2+
<html lang="en">
3+
<head>
4+
<title>Mulberry Help</title>
5+
</head>
6+
7+
<h3> Mulberry Help </h3>
8+
9+
<ul>
10+
<li> <a href=http://www.mulberrymail.com>Mulberry on the Web</a>
11+
<p>
12+
<li> <a href=mailto:mulberry-support@mulberrymail.com>Technical support</a>
13+
<p>
14+
</ul>
15+
16+
</html>

MacOS/Packaging/English.lproj/Mulberry Help/Mulberry Help.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1 @@
1-
<html> <head> <meta http-equiv="content-type" content="text/html;charset=iso-8859-1"> <title>Mulberry Help</title> <meta name="AppleTitle" content="Mulberry Help"> <meta name="AppleIcon" content="Mulberry%20Help/gfx/icon16.gif"> </head> <frameset cols="160,75%" border="0" frameborder="0"> <noframes> <body bgcolor="#FFFFFF"> <p>This entire page will be displayed in browsers that do not support frames. Edit in this mode to customize this page for non-frame-supporting browsers. For browsers that do support frames, design your page in the Edit Frames mode.</p> </body> </noframes> <frame src="pgs/main_index.htm" frameborder="0" marginwidth="10" marginheight="10" noresize> <frame name="main_details" src="pgs/main_about.htm" frameborder="0" marginwidth="10" marginheight="10"> </frameset></html>
1+
<!DOCTYPE html><html lang="en"> <head> <meta http-equiv="content-type" content="text/html;charset=iso-8859-1"> <title>Mulberry Help</title> <meta name="AppleTitle" content="Mulberry Help"> <meta name="AppleIcon" content="Mulberry%20Help/gfx/icon16.gif"> </head> <frameset cols="160,75%" border="0" frameborder="0"> <noframes> <body bgcolor="#FFFFFF"> <p>This entire page will be displayed in browsers that do not support frames. Edit in this mode to customize this page for non-frame-supporting browsers. For browsers that do support frames, design your page in the Edit Frames mode.</p> </body> </noframes> <frame src="pgs/main_index.htm" frameborder="0" marginwidth="10" marginheight="10" noresize> <frame name="main_details" src="pgs/main_about.htm" frameborder="0" marginwidth="10" marginheight="10"> </frameset></html>

MacOS/Packaging/English.lproj/Mulberry Help/pgs/faq/cmn/abook.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1 @@
1-
<html> <head> <meta http-equiv="content-type" content="text/html;charset=iso-8859-1"> <meta name="generator" content="Adobe GoLive 4"> <title>Addressbook Format</title> </head> <body bgcolor="#fffffe"> <table border="1" cellspacing="0" cellpadding="0" width="75%" bgcolor="#cccccc"> <tr height="24"> <td height="24" bgcolor="#f4f4f4"> <center> <font size="4" face="verdana,arial,sans-serif"><b>The Mulberry FAQ</b></font></center> </td> </tr> </table> <h2><font face="Helvetica,Arial">What is the format of the Mulberry address book?</font></h2> <p><font face="Helvetica,Arial"> <hr> <p><font face="Helvetica,Arial">Mulberry uses a tab-delimited text format for storage of local address books. On network address books, the format is stored slightly differently depending on which protocol (IMSP or ACAP) is used. For the practical purposes of importing external address books, however, the field order for importing to a network address book is the same as a local Mulberry address book.</font></p> <p><font face="Helvetica,Arial">Mulberry currently can import the following address book formats:</font></p> <ul> <li><font face="Helvetica,Arial">Pine</font> <li><font face="Helvetica,Arial">Eudora</font> <li><font face="Helvetica,Arial">Netscape/Communicator and Netscape-compatible</font> <li><font face="Helvetica,Arial">LDIF (use the Communicator plugin)</font> <li><font face="Helvetica,Arial">Outlook/Outlook Express</font> <li><font face="Helvetica,Arial">Quickmail</font> <li><font face="Helvetica,Arial">vCard</font> <li><font face="Helvetica,Arial">Any tab-delimited text file with the proper order.</font> </ul> <p><font face="Helvetica,Arial">Mulberry can also export to any of these formats.</font></p> <p><font face="Helvetica,Arial"><b>Hint:</b> more than one Mulberry user has observed that Mulberry can be a very easy to use tool if you need to translate from one of the above formats to another, as at this writing these other programs don't understand one another's formats. Cute!</font></p> <p><font face="Helvetica,Arial">The field order for a Mulberry address book is as follows. <tt>&lt;tab&gt;</tt> represents a 'tab' character, and <tt>&lt;LINEEND&gt; represents</tt> a line end character sequence for the OS on which the address book is used, and marks the end of a single entry.</font></p> <ul> <p><font face="Helvetica,Arial">Nick-name <tt>&lt;tab&gt;</tt> (aka the alias)<br> Full Name <tt>&lt;tab&gt;</tt> (Note: full name is stored lastname, firstname)<br> Email <tt>&lt;tab&gt;</tt><br> Company <tt>&lt;tab&gt;</tt><br> <b>Address </b><tt>&lt;tab&gt;</tt><br> Phone Work <tt>&lt;tab&gt;</tt><br> Phone Home <tt>&lt;tab&gt;</tt><br> Fax <tt>&lt;tab&gt;</tt><br> <b>URL </b><tt>&lt;tab&gt;</tt><br> <b>Notes</b> <tt>&lt;LINEEND&gt;</tt><br> </font></p> </ul> <p><font face="Helvetica,Arial">Fields listed in <b>boldface</b> above can contain more than one line of data, and can contain tab characters. To indicate this in a source document for translation, use &quot;C&quot; programming language style 'escape' characters:</font></p> <ul> <p><font face="Helvetica,Arial">To show a tab character, type <tt>\t</tt><br> To show a carriage return, type <tt>\r</tt><br> To show a linefeed return, type <tt>\n</tt><br> </font> </ul> </body></html>
1+
<!DOCTYPE html><html lang="en"> <head> <meta http-equiv="content-type" content="text/html;charset=iso-8859-1"> <meta name="generator" content="Adobe GoLive 4"> <title>Addressbook Format</title> </head> <body bgcolor="#fffffe"> <table border="1" cellspacing="0" cellpadding="0" width="75%" bgcolor="#cccccc"> <tr height="24"> <td height="24" bgcolor="#f4f4f4"> <center> <font size="4" face="verdana,arial,sans-serif"><b>The Mulberry FAQ</b></font></center> </td> </tr> </table> <h2><font face="Helvetica,Arial">What is the format of the Mulberry address book?</font></h2> <p><font face="Helvetica,Arial"> <hr> <p><font face="Helvetica,Arial">Mulberry uses a tab-delimited text format for storage of local address books. On network address books, the format is stored slightly differently depending on which protocol (IMSP or ACAP) is used. For the practical purposes of importing external address books, however, the field order for importing to a network address book is the same as a local Mulberry address book.</font></p> <p><font face="Helvetica,Arial">Mulberry currently can import the following address book formats:</font></p> <ul> <li><font face="Helvetica,Arial">Pine</font> <li><font face="Helvetica,Arial">Eudora</font> <li><font face="Helvetica,Arial">Netscape/Communicator and Netscape-compatible</font> <li><font face="Helvetica,Arial">LDIF (use the Communicator plugin)</font> <li><font face="Helvetica,Arial">Outlook/Outlook Express</font> <li><font face="Helvetica,Arial">Quickmail</font> <li><font face="Helvetica,Arial">vCard</font> <li><font face="Helvetica,Arial">Any tab-delimited text file with the proper order.</font> </ul> <p><font face="Helvetica,Arial">Mulberry can also export to any of these formats.</font></p> <p><font face="Helvetica,Arial"><b>Hint:</b> more than one Mulberry user has observed that Mulberry can be a very easy to use tool if you need to translate from one of the above formats to another, as at this writing these other programs don't understand one another's formats. Cute!</font></p> <p><font face="Helvetica,Arial">The field order for a Mulberry address book is as follows. <code>&lt;tab&gt;</code> represents a 'tab' character, and <code>&lt;LINEEND&gt; represents</code> a line end character sequence for the OS on which the address book is used, and marks the end of a single entry.</font></p> <ul> <p><font face="Helvetica,Arial">Nick-name <code>&lt;tab&gt;</code> (aka the alias)<br> Full Name <code>&lt;tab&gt;</code> (Note: full name is stored lastname, firstname)<br> Email <code>&lt;tab&gt;</code><br> Company <code>&lt;tab&gt;</code><br> <b>Address </b><code>&lt;tab&gt;</code><br> Phone Work <code>&lt;tab&gt;</code><br> Phone Home <code>&lt;tab&gt;</code><br> Fax <code>&lt;tab&gt;</code><br> <b>URL </b><code>&lt;tab&gt;</code><br> <b>Notes</b> <code>&lt;LINEEND&gt;</code><br> </font></p> </ul> <p><font face="Helvetica,Arial">Fields listed in <b>boldface</b> above can contain more than one line of data, and can contain tab characters. To indicate this in a source document for translation, use &quot;C&quot; programming language style 'escape' characters:</font></p> <ul> <p><font face="Helvetica,Arial">To show a tab character, type <code>\t</code><br> To show a carriage return, type <code>\r</code><br> To show a linefeed return, type <code>\n</code><br> </font> </ul> </body></html>

MacOS/Packaging/English.lproj/Mulberry Help/pgs/faq/cmn/alertstyles.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1 @@
1-
<html> <head> <meta http-equiv="content-type" content="text/html;charset=iso-8859-1"> <meta name="generator" content="Adobe GoLive 4"> <title>Alert Styles</title> </head> <body bgcolor="#fffffe"> <table border="1" cellspacing="0" cellpadding="0" width="75%" bgcolor="#cccccc"> <tr height="24"> <td height="24" bgcolor="#f4f4f4"> <center> <font size="4" face="verdana,arial,sans-serif"><b>The Mulberry FAQ</b></font></center> </td> </tr> </table> <h2><font face="Helvetica,Arial">What is the purpose of multiple alert styles and how do I use them?</font></h2> <p><font face="Helvetica,Arial"> <hr> <p><font face="Helvetica,Arial">Most people have new mail messages delivered to a single mailbox - usually their INBOX. On a POP3 server it can only be INBOX because there is only one remote mailbox. However, with IMAP, it is possible to have new messages delivered into other mailboxes - either personal mailboxes, or shared or public mailboxes. This may be the result of the user setting up some form of server-side filtering, or simply through public mailing lists being delivered into public or shared mailboxes.</font></p> <p><font face="Helvetica,Arial">When new mail is being delivered into more than INBOX, you will likely want to be notified of new mail arrival. One option to do that in Mulberry is to simply add these mailboxes to the 'Check Favourite' cabinet or to select them, click Details, and then turn on 'Check for New Mail with Style' in the mailbox properties dialog. This will cause those mailboxes, as well as INBOX, to be checked at the interval you have specified in the preferences.</font></p> <p><font face="Helvetica,Arial">Sometimes, the other mailboxes being checked are less important than say your INBOX, and you may prefer to have those checked at a longer interval than INBOX, or have them generate a different kind of notification. Mulberry lets you do this by providing the ability to setup multiple alert styles. An alert style lets you define what interval new mail checking is done at, how you are notified of the new mail, and lets you choose which set of mailboxes it applies to. The set of mailboxes is controlled through the use of the Cabinet feature in Mulberry.</font></p> <p><font face="Helvetica,Arial">To setup multiple alert styles do the following:</font></p> <p><font face="Helvetica,Arial">1) Create a new Cabinet via the Cabinet popup in the server window. This cabinet will be used to contain the set of mailboxes to which the new alert style will apply. You can add mailboxes to the alert style by simply dragging them into this cabinet. Alternatively, turn on the 'Check for New Mail with Style' option in the mailbox properties dialog will add them too.</font></p> <p><font face="Helvetica,Arial">2) Go to the Preferences and make sure its set to Advanced mode.</font></p> <p><font face="Helvetica,Arial">3) Go to the Alerts preference panel.</font></p> <p><font face="Helvetica,Arial">4) Click on the Style popup and select New.</font></p> <p><font face="Helvetica,Arial">5) Enter a unique name for the new alert style and click OK (a good idea is to use the same name for the cabinet and alert style - though this is not required).</font></p> <p><font face="Helvetica,Arial">6) Configure the check interval and notification options for the new alert style (e.g. use 30 minutes for less important mailboxes).</font></p> <p><font face="Helvetica,Arial">7) Select the new cabinet created in step 1 via the 'Apply to Cabinet' popup.</font></p> <p><font face="Helvetica,Arial">8) Click OK to exit the Preferences dialog.</font></p> <p><font face="Helvetica,Arial">Now those mailboxes that appear in the new cabinet will be used by the new alert style to notify you of new mail using the alert style's check interval and notification options.</font></p> <p><font face="Helvetica,Arial">Also note that the New Messages cabinet that is built-in to Mulberry, will always contain the list of mailboxes known to have new mail in them. Thus its a good idea when you have more than one mailbox being checked for new mail, to have that cabinet open at the top of your server window. That provides a quick way to see which mailboxes have new mail.</font></p> <p><font face="Helvetica,Arial">NB Site Administrator's can pre-configure multiple alert styles for end users using the Admin Tool.</font> </body></html>
1+
<!DOCTYPE html><html lang="en"> <head> <meta http-equiv="content-type" content="text/html;charset=iso-8859-1"> <meta name="generator" content="Adobe GoLive 4"> <title>Alert Styles</title> </head> <body bgcolor="#fffffe"> <table border="1" cellspacing="0" cellpadding="0" width="75%" bgcolor="#cccccc"> <tr height="24"> <td height="24" bgcolor="#f4f4f4"> <center> <font size="4" face="verdana,arial,sans-serif"><b>The Mulberry FAQ</b></font></center> </td> </tr> </table> <h2><font face="Helvetica,Arial">What is the purpose of multiple alert styles and how do I use them?</font></h2> <p><font face="Helvetica,Arial"> <hr> <p><font face="Helvetica,Arial">Most people have new mail messages delivered to a single mailbox - usually their INBOX. On a POP3 server it can only be INBOX because there is only one remote mailbox. However, with IMAP, it is possible to have new messages delivered into other mailboxes - either personal mailboxes, or shared or public mailboxes. This may be the result of the user setting up some form of server-side filtering, or simply through public mailing lists being delivered into public or shared mailboxes.</font></p> <p><font face="Helvetica,Arial">When new mail is being delivered into more than INBOX, you will likely want to be notified of new mail arrival. One option to do that in Mulberry is to simply add these mailboxes to the 'Check Favourite' cabinet or to select them, click Details, and then turn on 'Check for New Mail with Style' in the mailbox properties dialog. This will cause those mailboxes, as well as INBOX, to be checked at the interval you have specified in the preferences.</font></p> <p><font face="Helvetica,Arial">Sometimes, the other mailboxes being checked are less important than say your INBOX, and you may prefer to have those checked at a longer interval than INBOX, or have them generate a different kind of notification. Mulberry lets you do this by providing the ability to setup multiple alert styles. An alert style lets you define what interval new mail checking is done at, how you are notified of the new mail, and lets you choose which set of mailboxes it applies to. The set of mailboxes is controlled through the use of the Cabinet feature in Mulberry.</font></p> <p><font face="Helvetica,Arial">To setup multiple alert styles do the following:</font></p> <p><font face="Helvetica,Arial">1) Create a new Cabinet via the Cabinet popup in the server window. This cabinet will be used to contain the set of mailboxes to which the new alert style will apply. You can add mailboxes to the alert style by simply dragging them into this cabinet. Alternatively, turn on the 'Check for New Mail with Style' option in the mailbox properties dialog will add them too.</font></p> <p><font face="Helvetica,Arial">2) Go to the Preferences and make sure its set to Advanced mode.</font></p> <p><font face="Helvetica,Arial">3) Go to the Alerts preference panel.</font></p> <p><font face="Helvetica,Arial">4) Click on the Style popup and select New.</font></p> <p><font face="Helvetica,Arial">5) Enter a unique name for the new alert style and click OK (a good idea is to use the same name for the cabinet and alert style - though this is not required).</font></p> <p><font face="Helvetica,Arial">6) Configure the check interval and notification options for the new alert style (e.g. use 30 minutes for less important mailboxes).</font></p> <p><font face="Helvetica,Arial">7) Select the new cabinet created in step 1 via the 'Apply to Cabinet' popup.</font></p> <p><font face="Helvetica,Arial">8) Click OK to exit the Preferences dialog.</font></p> <p><font face="Helvetica,Arial">Now those mailboxes that appear in the new cabinet will be used by the new alert style to notify you of new mail using the alert style's check interval and notification options.</font></p> <p><font face="Helvetica,Arial">Also note that the New Messages cabinet that is built-in to Mulberry, will always contain the list of mailboxes known to have new mail in them. Thus its a good idea when you have more than one mailbox being checked for new mail, to have that cabinet open at the top of your server window. That provides a quick way to see which mailboxes have new mail.</font></p> <p><font face="Helvetica,Arial">NB Site Administrator's can pre-configure multiple alert styles for end users using the Admin Tool.</font> </body></html>

0 commit comments

Comments
 (0)