Bommels05/Mozilla
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

fixes for help search, sorting, index, ui, plus content updates, author=pwilson@gorge.net, r=oeschger, sr=hewitt, a=asa, bug=124273

Browse Source 
git-svn-id: svn://10.0.0.236/trunk@117760 18797224-902f-48f8-a5cc-f745e15eee43
This commit is contained in:
oeschger%netscape.com
2002-03-31 02:44:11 +00:00
parent 50fd8f2545
commit e7af2d91f0
11 changed files with 541 additions and 64 deletions
Download Patch File Download Diff File Expand all files Collapse all files

95
mozilla/extensions/help/resources/content/help.js
View File

@@ -32,6 +32,7 @@ var helpGlossaryPanel;
const NC = "http://home.netscape.com/NC-rdf#";
const SN = "rdf:http://www.w3.org/1999/02/22-rdf-syntax-ns#";
const XML = "http://www.w3.org/XML/1998/namespace#"
const MAX_LEVEL = 40; // maximum depth of recursion in search datasources.
// Resources
var RDF = Components.classes["@mozilla.org/rdf/rdf-service;1"].getService(Components.interfaces.nsIRDFService);
@@ -63,11 +64,13 @@ var helpBaseURI;
const defaultHelpFile = "chrome://help/locale/mozillahelp.rdf";
// Set from nc:defaulttopic. It is used when the requested uri has no topic specified.
var defaultTopic = "welcome";
var searchDatasources = "rdf:null";
var searchDS = null;
const NSRESULT_RDF_SYNTAX_ERROR = 0x804e03f7;
// This function is called by dialogs/windows that want to display context-sensitive help
// These dialogs/windows should include scrip chrome://help/content/contectHelp.js
// These dialogs/windows should include the script chrome://help/content/contextHelp.js
function displayTopic(topic) {
if (!topic)
topic = defaultTopic;
@@ -167,6 +170,12 @@ function loadHelpRDF() {
var datasources = getAttribute(helpFileDS, panelDef, NC_DATASOURCES, "rdf:none");
datasources = normalizeLinks(helpBaseURI, datasources);
// cache additional datsources to augment search datasources.
if (panelID == "search") {
searchDatasources = datasources;
datasources = "rdf:null"; // but don't try to display them yet!
}
// cache toc datasources for use by ID lookup.
var tree = document.getElementById("help-" + panelID + "-tree");
tree.setAttribute("datasources", datasources);
@@ -185,7 +194,7 @@ function loadHelpRDF() {
}
function loadDatabases(compositeDatabase, datasources) {
var ds = datasources.split(/\s+/);
for (var i=0; i < ds.length; i++) {
for (var i=0; i < ds.length; ++i) {
if (ds[i] == "rdf:null" || ds[i] == "")
continue;
try {
@@ -207,7 +216,7 @@ function normalizeLinks(helpBaseURI, links) {
var ls = links.split(/\s+/);
if (ls.length == 0)
return links;
for (var i=0; i < ls.length; i++) {
for (var i=0; i < ls.length; ++i) {
if (ls[i] == "")
continue;
if (ls[i].substr(0,7) != "chrome:" && ls[i].substr(0,4) != "rdf:")
@@ -228,7 +237,7 @@ function getLink(ID) {
return null;
var tocDatasources = tocTree.getAttribute("datasources");
var ds = tocDatasources.split(/\s+/);
for (var i=0; i < ds.length; i++) {
for (var i=0; i < ds.length; ++i) {
if (ds[i] == "rdf:null" || ds[i] == "")
continue;
try {
@@ -255,37 +264,6 @@ function getHelpFileURI() {
return helpFileURI;
}
// select the item in the tree called "Dialog Help" if the window was loaded from a dialog
function setContext() {
var items = document.getElementsByAttribute("helplink", "chrome://help/locale/context_help.html");
if (items.length) {
var tree = document.getElementById("help-toc-tree");
try { tree.selectItem(items[0].parentNode.parentNode); } catch(ex) { dump("can't select in toc: " + ex + "\n"); }
}
}
function selectTOC(link_attr) {
var items = document.getElementsByAttribute("helplink", link_attr);
if (items.length) {
openTwistyTo(items[0]);
var tree = document.getElementById("help-toc-tree");
try { tree.selectItem(items[0].parentNode.parentNode); } catch(ex) { dump("can't select in toc: " + ex + "\n"); }
}
}
// open parent nodes for the selected node
// until you get to the top of the tree
function openTwistyTo(selectedURINode)
{
var parent = selectedURINode.parentNode;
var tree = document.getElementById("help-toc-tree");
if (parent == tree)
return;
parent.setAttribute("open", "true");
openTwistyTo(parent);
}
function getWebNavigation()
{
@@ -513,7 +491,7 @@ function onselect_loadURI(tree, columnName) {
/** Search properties nsISupportsArray for an nsIAtom which starts with the given property name. **/
function getPropertyValue(properties, propName) {
for (var i=0; i< properties.Count(); i++) {
for (var i=0; i< properties.Count(); ++i) {
var atom = properties.GetElementAt(i).QueryInterface(Components.interfaces.nsIAtom);
var atomValue = atom.GetUnicode();
if (atomValue.substr(0, propName.length) == propName)
@@ -531,23 +509,24 @@ function doFind() {
// split search string into separate terms and compile into regexp's
RE = findText.value.split(/\s+/);
for (var i=0; i < RE.length; i++) {
for (var i=0; i < RE.length; ++i) {
if (RE[i] == "")
continue;
RE[i] = new RegExp(RE[i], "i");
RE[i] = new RegExp(RE[i].substring(0, RE[i].length-1) +"\w?", "i");
}
// search TOC
var resultsDS = Components.classes["@mozilla.org/rdf/datasource;1?name=in-memory-datasource"].createInstance(Components.interfaces.nsIRDFDataSource);
var tree = document.getElementById("help-toc-tree");
var sourceDS = tree.database;
doFindOnDatasource(resultsDS, sourceDS, RDF_ROOT, 0);
// search index.
tree = document.getElementById("help-index-tree");
sourceDS = tree.database;
if (!sourceDS) // If the index has never been displayed this will be null (sigh!).
sourceDS = loadCompositeDS(tree.datasources);
doFindOnDatasource(resultsDS, sourceDS, RDF_ROOT, 0);
// search additional search datasources
if (searchDatasources != "rdf:null") {
if (!searchDS)
searchDS = loadCompositeDS(searchDatasources);
doFindOnDatasource(resultsDS, searchDS, RDF_ROOT, 0);
}
// search glossary.
tree = document.getElementById("help-glossary-tree");
@@ -570,6 +549,15 @@ function clearDatabases(compositeDataSource) {
}
function doFindOnDatasource(resultsDS, sourceDS, resource, level) {
if (level > MAX_LEVEL) {
try {
log("Recursive reference to resource: " + resource.Value + ".");
}
catch (e) {
log("Recursive reference to unknown resource.");
}
return;
}
// find all SUBHEADING children of current resource.
var targets = sourceDS.GetTargets(resource, NC_SUBHEADINGS, true);
while (targets.hasMoreElements()) {
@@ -618,7 +606,7 @@ function doFindOnSeq(resultsDS, sourceDS, resource, level) {
}
function isMatch(text) {
for (var i=0; i < RE.length; i++ ) {
for (var i=0; i < RE.length; ++i ) {
if (!RE[i].test(text))
return false;
}
@@ -631,7 +619,7 @@ function loadCompositeDS(datasources) {
.createInstance(Components.interfaces.nsIRDFCompositeDataSource);
var ds = datasources.split(/\s+/);
for (var i=0; i < ds.length; i++) {
for (var i=0; i < ds.length; ++i) {
if (ds[i] == "rdf:null" || ds[i] == "")
continue;
try {
@@ -667,3 +655,18 @@ function getLiteralValue(literal, defaultValue) {
function log(aText) {
CONSOLE_SERVICE.logStringMessage(aText);
}
//INDEX OPENING FUNCTION -- called in oncommand for index pane
// iterate over all the items in the outliner;
// open the ones at the top-level (i.e., expose the headings underneath
// the letters in the list.
function displayIndex() {
var outliner = document.getElementById("help-index-outliner");
var oview = outliner.outlinerBoxObject.view;
for ( i = 0; i < 500; ++i ) {
if ( !oview.isContainerOpen(i) && oview.getLevel(i) == 0 ) {
oview.toggleOpenState(i);
}
}
}

21
mozilla/extensions/help/resources/content/help.xul
View File

@@ -20,7 +20,6 @@
<window id="help"
windowtype="mozilla:help"
xmlns:html="http://www.w3.org/TR/REC-html40"
xmlns="http://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul"
width="640"
height="650"
@@ -87,7 +86,7 @@
<!-- button bar -->
<toolbox id="help-toolbox" class="toolbox-top" deferattached="true">
<toolbar id="helpToolbar" class="toolbar-primary"
tooltiptext="The Help Toolbar"
tooltiptext="&toolbar.tooltip;"
tbalign="stretch" persist="collapsed">
<toolbarbutton id="helpBackButton" type="menu-button" class="toolbarbutton-1"
@@ -123,8 +122,10 @@
label="&searchtab.label;" oncommand="showPanel('help-search-panel')"/>
<vbox id="help-search-panel" hidden="true" flex="1">
<hbox>
<label value="&searchbtn.label;" align="end" flex="0"/>
<textbox id="findText" flex="1"/>
<textbox id="findText"
flex="1"
onkeydown="if (event.keyCode == KeyEvent.DOM_VK_ENTER || event.keyCode == KeyEvent.DOM_VK_RETURN) doFind();"/>
<button id="findButton" label="&gobtn.label;" oncommand="doFind()" flex="0"/>
</hbox>
<tree id="help-search-tree"
@@ -165,7 +166,10 @@
<treecols>
<treecol id="ResultsColumn" flex="1"
hideheader="true" primary="true"/>
hideheader="true" primary="true"
sortActive="true"
sortDirection="ascending"
sort="?name"/>
</treecols>
</tree>
</vbox>
@@ -216,7 +220,7 @@
</tree>
<button id="help-index-btn" class="box-texttab texttab-sidebar"
label="&indextab.label;" oncommand="showPanel('help-index-tree')"/>
label="&indextab.label;" oncommand="showPanel('help-index-tree');displayIndex();"/>
<tree id="help-index-tree" flex="1"
datasources="rdf:null" hidecolumnpicker="true" hidden="true"
@@ -307,10 +311,7 @@
<treecols>
<treecol id="GlossaryNameColumn" flex="1"
hideheader="true"
primary="true"
sortActive="true"
sortDirection="ascending"
sort="?name"/>
primary="true"/>
</treecols>
</tree>

12
mozilla/extensions/help/resources/content/helpMenuOverlay.xul
View File

@@ -6,12 +6,14 @@
]>
<overlay id="helpMenuID"
xmlns="http://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul">
xmlns="http://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul">
<script type="application/x-javascript" src="chrome://help/content/contextHelp.js"/>
<menupopup id="helpPopup">
<menuitem label="&helpContents.label;" accesskey="&helpContents.accesskey;" position="1" id="help"
oncommand="toOpenWindowByType('mozilla:help', 'chrome://help/content/help.xul');" />
<menuitem label="&helpContents.label;"
accesskey="&helpContents.accesskey;"
position="1" id="help"
oncommand="openHelp();" />
</menupopup>
</overlay>

10
mozilla/extensions/help/resources/jar.mn
View File

@@ -4,10 +4,11 @@ help.jar:
content/help/help.js (content/help.js)
content/help/contents.rdf (content/contents.rdf)
content/help/helpMenuOverlay.xul (content/helpMenuOverlay.xul)
content/help/test.xul (content/test.xul)
content/help/test.xul (content/test.xul)
en-US.jar:
locale/en-US/help/mozillahelp.rdf (locale/en-US/mozillahelp.rdf)
locale/en-US/help/search-db.rdf (locale/en-US/search-db.rdf)
locale/en-US/help/testhelp.rdf (locale/en-US/testhelp.rdf)
locale/en-US/help/help-glossary.rdf (locale/en-US/help-glossary.rdf)
locale/en-US/help/contents.rdf (locale/en-US/contents.rdf)
@@ -18,6 +19,7 @@ en-US.jar:
locale/en-US/help/help-indexAZ.rdf (locale/en-US/help-indexAZ.rdf)
locale/en-US/help/nav_help.html (locale/en-US/nav_help.html)
locale/en-US/help/mail_help.html (locale/en-US/mail_help.html)
locale/en-US/help/mail_sec_help.html (locale/en-US/mail_sec_help.html)
locale/en-US/help/composer_help.html (locale/en-US/composer_help.html)
locale/en-US/help/customize_help.html (locale/en-US/customize_help.html)
locale/en-US/help/certs_help.html (locale/en-US/certs_help.html)
@@ -48,6 +50,9 @@ en-US.jar:
locale/en-US/help/images/biActive.gif (locale/en-US/images/biActive.gif)
locale/en-US/help/images/bkmkmenu.gif (locale/en-US/images/bkmkmenu.gif)
locale/en-US/help/images/bullets.gif (locale/en-US/images/bullets.gif)
locale/en-US/help/images/columns.gif (locale/en-US/images/columns.gif)
locale/en-US/help/images/flag.gif (locale/en-US/images/flag.gif)
locale/en-US/help/images/flag_column.gif (locale/en-US/images/flag_column.gif)
locale/en-US/help/images/frown.gif (locale/en-US/images/frown.gif)
locale/en-US/help/images/hrule.gif (locale/en-US/images/hrule.gif)
locale/en-US/help/images/image.gif (locale/en-US/images/image.gif)
@@ -66,6 +71,8 @@ en-US.jar:
locale/en-US/help/images/numbers.gif (locale/en-US/images/numbers.gif)
locale/en-US/help/images/paperclip.gif (locale/en-US/images/paperclip.gif)
locale/en-US/help/images/personalbar.gif (locale/en-US/images/personalbar.gif)
locale/en-US/help/images/read.gif (locale/en-US/images/read.gif)
locale/en-US/help/images/read_column.gif (locale/en-US/images/read_column.gif)
locale/en-US/help/images/reload.gif (locale/en-US/images/reload.gif)
locale/en-US/help/images/search.gif (locale/en-US/images/search.gif)
locale/en-US/help/images/searchmusic.gif (locale/en-US/images/searchmusic.gif)
@@ -82,6 +89,7 @@ en-US.jar:
locale/en-US/help/images/taskbar_menus.gif (locale/en-US/images/taskbar_menus.gif)
locale/en-US/help/images/thread.gif (locale/en-US/images/thread.gif)
locale/en-US/help/images/threadbutton.gif (locale/en-US/images/threadbutton.gif)
locale/en-US/help/images/unread.gif (locale/en-US/images/unread.gif)
locale/en-US/help/images/wink.gif (locale/en-US/images/wink.gif)
modern.jar:

3
mozilla/extensions/help/resources/locale/en-US/cs_nav_prefs_advanced.html
View File

@@ -123,8 +123,11 @@
<li><b> Disk Cache</b>: Type in the amount of disk cache, and disk cache you
want to allocate for Mozilla. Disk cache is saved to your hard disk (drive)
and can be used again even if you have turned your computer off.</li>
<li><b> Disk Cache Folder</b>: The folder where you want Mozilla to store your
disk cache (empty if you do not change the default).</li>
<li><b>Clear Memory Cache: </b>Click this to clear the memory cache.</li>
<li><b>Clear Disk Cache</b>: Click this to clear the memory cache.</li>
<li><b>Choose Folder</b>: Click this to choose the disk cache folder.</li>
<li><b>Compare the page in the cache to the page on the network:</b>
<ul>

3
mozilla/extensions/help/resources/locale/en-US/cs_nav_prefs_advanced.xhtml
View File

@@ -123,8 +123,11 @@
<li><b> Disk Cache</b>: Type in the amount of disk cache, and disk cache you
want to allocate for Mozilla. Disk cache is saved to your hard disk (drive)
and can be used again even if you have turned your computer off.</li>
<li><b> Disk Cache Folder</b>: The folder where you want Mozilla to store your
disk cache (empty if you do not change the default).</li>
<li><b>Clear Memory Cache: </b>Click this to clear the memory cache.</li>
<li><b>Clear Disk Cache</b>: Click this to clear the memory cache.</li>
<li><b>Choose Folder</b>: Click this to choose the disk cache folder.</li>
<li><b>Compare the page in the cache to the page on the network:</b>
<ul>

2
mozilla/extensions/help/resources/locale/en-US/help.dtd
View File

@@ -20,6 +20,6 @@
<!ENTITY glossarytab.label "Glossary">
<!ENTITY glossname.label "Name">
<!-- added IO 2/7/01 -->
<!ENTITY gobtn.label "Go">
<!ENTITY gobtn.label "Search">
<!ENTITY name.label "Item">

221
mozilla/extensions/help/resources/locale/en-US/mail_sec_help.html Normal file
View File

@@ -0,0 +1,221 @@
<html>
<head>
<title></title>
<link rel="stylesheet" href="chrome://help/locale/content_style.css" type="text/css">
</head>
<body bgcolor="white">
<a NAME="secure_mail_first"></a>
<a NAME="mail:signing_&_encryptingIDX"></a>
<a NAME="settings:signed & encrypted mailIDX"></a>
<hr><h1>Signing &amp; Encrypting Messages</h1>
<p>&nbsp;
<table cellpadding=4 cellspacing=2 bgcolor="#cccccc" Width=324>
<tr>
<td class="inthissections">
<p>In this section:</p>
<p><a href="#about_sigs_encrypt">About Digital Signatures &amp; Encryption</a></p>
<p><a href="#get_mail_certs">Getting Other People's Certificates</a></p>
<p><a href="#config_account">Configuring Security Settings</a></p>
<p><a href="#signing">Signing Messages</a></p>
<p><a href="#encrypting">Encrypting Email Messages</a></p>
<p><a href="#compose_security">Message Security - Compose Window</a></p>
<p><a href="#received_security">Message Security - Received Window</a></p></td>
</tr>
</table>
<p>&nbsp;
<h2><a NAME="about_sigs_encrypt"></a>
About Digital Signatures &amp; Encryption </h2>
<p>When you compose a mail or newsgroup message, you can choose to attach your digital signature to the message. A <a href="glossary.html#digital_signature">digital signature</a> allows recipients of the message to verify that the message really comes from you and hasn't been tampered with since you sent it.
<p>When you compose a mail message, you can also choose to encrypt the message. <a href="glossary.html#encryption">Encryption</a> makes it nearly impossible for anyone other than the intended recipient to read the message while it is in transit over the Internet.
<p>Encryption is not available for newsgroup messages.
<p>Before you can sign or encrypt a message, you must take these preliminary steps:
<ol>
<li>Obtain one or more <a href="glossary.html#certificate">certificates</a> (the digital eqivalents of ID cards). For details, see <a href="using_certs_help.html#using_certs_get">Getting Your Own Certificate</a>.
<li>Configure the security settings for your email or newsgroup account. For details, see <a href="#config_account">Configuring Your Security Settings</a>.
</ol>
<p>Once you have completed these steps, follow the directions in these sections to sign and encrypt messages:
<ul>
<li><a href="#signing">Signing Email &amp; Newsgroup Messages</a>
<li><a href="#encrypting">Encrypting Email Messages</a></td>
</ul>
<p>The following sections provide a brief overview of how digital signatures and encryption work. For more technical details on this subject, see the online document <a href="http://developer.netscape.com/docs/manuals/security/pkin/index.htm" TARGET="_blank">Introduction to Public-Key Cryptography</a>.
<p>&nbsp;
<h3><a NAME="how_sigs_work"></a>
How Digital Signatures Work</h3>
<p>A digital signature is a special code, unique to each message, created by means of <a href="glossary.html#public-key_cryptography">public-key cryptography</a>.
<p>A digital signature is completely different from a handwritten signature, although it can sometimes be used for similar legal purposes, such as signing a contract.
<p>To create a digital signature for an email or newsgroup message that you are sending, you need two things:
<ul>
<li>A <b>signing certificate</b> that identifies you for this purpose. Every time you sign a message, your signing certificate is included with the message. The certificate includes a <a href="glossary.html#public_key">public key</a>. The presence of the certificate in the message permits the recipient to verify your digital signature.
<p>Your certificate is a bit like your name and phone number in the phonebook&#151;it is public information that helps other people communicate with you.
<li>A <a href="glossary.html#private_key">private key</a>, which is created and stored on your computer when you first obtain a certificate.
<p>Your private key is protected by your <a href="glossary.html#master_password">master password</a> and is not normally disclosed to anyone else. The Mail & Newsgroup software uses your private key to create a unique, verifiable digital signature for every message you choose to sign.
</ul>
<p>&nbsp;
<h3><a NAME="how_encrypt_works"></a>
How Encryption Works</h3>
<p>To encrypt an email message, you must have an encryption certificate for each of the message's recipients. The public key in each certificate is used to encrypt the message for that recipient.
<p>If you dont have a certificate for even a single recipient, the message cannot be encrypted.
<p>The recipient's software uses the recipient's private key, which remains on that person's computer, to decrypt the message.
<p>&nbsp;
<h2><a NAME="get_mail_certs"></a>Getting Other People's Certificates</h2>
<p>Every time you send a digitally signed message, your encryption certificate is automatically included with the message. Therefore, one of the easiest ways to obtain someone else's certificate is for that person to send you a digitally signed message.
<p>When you receive such a message, the person's certificate is automatically stored by the <a href="certs_help.html">Certificate Manager</a>, which is the part of the browser that keeps track of certificates.
<p>You can also obtain certificates by looking them up in a public directory, such as the &quot;phonebook&quot;directories maintained by many companies.
<p>&nbsp;
<h2><a NAME="config_account"></a>Configuring Security Settings</h2>
<p>Text for these sections to come.
<p>&nbsp;
<h2><a NAME="signing"></a>Signing Messages</h2>
<p>&nbsp;
<h2><a NAME="encrypting"></a>Encrypting Email Messages</h2>
<p>&nbsp;
<hr><a NAME="compose_security"></a>
<h2>Message Security - Compose</h2>
<p>This section describes the Message Security window that you can open for any message you are composing. If you're not already viewing Message Security, click the Security icon in the toolbar of the Compose window.
<p>The Message Security window describes how your message will be sent:
<ul>
<li><b>Digitally Signed:</b> This line describes whether your message will be signed. There are three possibilities:</li>
<ul>
<li><b>Yes.</b> Digital signing has been enabled for this message, you have a valid certificate identifying you, and the message can be be signed.
<li><b>No.</b> Digital signing has been disabled for this message.
<li><b>Not possible.</b> Digital signing has been enabled for this message. However, a valid <a href="glossary.html#certificate">certificate</a> identifying you for this purpose is not available, or there is some other problem that makes signing impossible.
</ul>
<li><b>Encrypted:</b> This line describes whether your message will be encrypted. There are three possibilities:</li>
<ul>
<li><b>Yes.</b> Encryption has been enabled for this message, valid certificates for all listed recipients are available, and the message can be encryted.
<li><b>No.</b> Encryption has been disabled for this message.
<li><b>Not possible.</b> Encryption has been enabled for this message. However, a valid certificate for at least one of the listed recipients is not available, or no recipients are listed, or there is some other problem that makes encryption impossible.
</ul>
</ul>
<p>The Message Security window also lists the certifiates available for the recipients of your message:
<ul>
<li><b>View.</b> To view the details for any certificate in the list, select its name, then click View.
</ul>
<p>For information more information about obtaining certificates and configuring message security settings, see <a href="#secure_mail_first">Signing &amp; Encrypting Messages</a>
<p>To indicate your signing or encryption choices for an individual message, click the arrow beside the Security button in the Compose window, then select the options you want.
<pTo indicate your default signing and encryption preferences for all messages, see <a href="mail_help.html#security_settings">Mail &amp; Newsgroups Account Settings - Security</a>
<p>&nbsp;
<hr><a NAME="received_security"></a><h2>Message Security - Received Message</h2>
<p>This section describes the Message Security window that you can open for any message you have received. If you're not already viewing Message Security for a received message, follow these steps:
<ol>
<li>In the Mail window, select the message for which you want to view security information.
<li>Open the View menu and choose Message Security Information.
</ol>
<p>The Message Security window displays the following information:
<ul>
<li><b>Digital Signature.</b> The top section describes whether the message is digitally signed and if so, whether the signature is valid.
<p>If validation failed while OCSP was enabled, check the OCSP settings in <a href="validation_help.html#validation_first">Privacy &amp; Security Preferences - Validation</a>. If you are not familiar with OCSP, confirm the settings with your system administrator. If your settings are correct, there may be a problem with the OCSP service or the certificate used to create the signature is no longer valid. </li>
<p>If the signature is invalid because of a problem with a certificate's trust settings, you can use the <a href="certs_help.html">Certificate Manager</a> to view or edit those settings.
<li><b>View Signature Certificate.</b> If the message is signed, click this button to view the certificate that was used to sign it.
<li><b>Encryption.</b> The bottom section reports whether the message is encrypted and any decrypting problems.</li>
<ul>
<li>If the message's contents have been altered during transit, you should ask the sender to resend it. The changes may have been caused by network problems.
<li>If a copy of your own certificate (used by the sender to encrypt the message) is not available on your computer, the private key required to decrypt the message cannot be retrieved. The only solution is to import a backup copy of your certificate and its private key (see <a href="certs_help.html#My_Certificates">Your Certificates</a> for details.)If you don't have access to a backup certificate, you will not be able to decrypt the message.
</ul>
</ul>
<p>For information more information about obtaining certificates and configuring message security settings, see <a href="#secure_mail_first">Signing &amp; Encrypting Messages</a>.
<p>To indicate your signing or encryption choices for an individual message, click the arrow beside the Security button in the Compose window, then select the options you want.
<pTo indicate your default signing and encryption preferences for all messages, see <a href="mail_help.html#security_settings">Mail &amp; Newsgroups Account Settings - Security</a>
<p>&nbsp;
<hr>
<p><i>19 March 2002</i></p>
<p>Copyright &copy; 1994-2002 Netscape Communications Corporation.</p>
</body>
</html>

221
mozilla/extensions/help/resources/locale/en-US/mail_sec_help.xhtml Normal file
View File

@@ -0,0 +1,221 @@
<html>
<head>
<title></title>
<link rel="stylesheet" href="chrome://help/locale/content_style.css" type="text/css">
</head>
<body bgcolor="white">
<a NAME="secure_mail_first"></a>
<a NAME="mail:signing_&_encryptingIDX"></a>
<a NAME="settings:signed & encrypted mailIDX"></a>
<hr><h1>Signing &amp; Encrypting Messages</h1>
<p>&nbsp;
<table cellpadding=4 cellspacing=2 bgcolor="#cccccc" Width=324>
<tr>
<td class="inthissections">
<p>In this section:</p>
<p><a href="#about_sigs_encrypt">About Digital Signatures &amp; Encryption</a></p>
<p><a href="#get_mail_certs">Getting Other People's Certificates</a></p>
<p><a href="#config_account">Configuring Security Settings</a></p>
<p><a href="#signing">Signing Messages</a></p>
<p><a href="#encrypting">Encrypting Email Messages</a></p>
<p><a href="#compose_security">Message Security - Compose Window</a></p>
<p><a href="#received_security">Message Security - Received Window</a></p></td>
</tr>
</table>
<p>&nbsp;
<h2><a NAME="about_sigs_encrypt"></a>
About Digital Signatures &amp; Encryption </h2>
<p>When you compose a mail or newsgroup message, you can choose to attach your digital signature to the message. A <a href="glossary.html#digital_signature">digital signature</a> allows recipients of the message to verify that the message really comes from you and hasn't been tampered with since you sent it.
<p>When you compose a mail message, you can also choose to encrypt the message. <a href="glossary.html#encryption">Encryption</a> makes it nearly impossible for anyone other than the intended recipient to read the message while it is in transit over the Internet.
<p>Encryption is not available for newsgroup messages.
<p>Before you can sign or encrypt a message, you must take these preliminary steps:
<ol>
<li>Obtain one or more <a href="glossary.html#certificate">certificates</a> (the digital eqivalents of ID cards). For details, see <a href="using_certs_help.html#using_certs_get">Getting Your Own Certificate</a>.
<li>Configure the security settings for your email or newsgroup account. For details, see <a href="#config_account">Configuring Your Security Settings</a>.
</ol>
<p>Once you have completed these steps, follow the directions in these sections to sign and encrypt messages:
<ul>
<li><a href="#signing">Signing Email &amp; Newsgroup Messages</a>
<li><a href="#encrypting">Encrypting Email Messages</a></td>
</ul>
<p>The following sections provide a brief overview of how digital signatures and encryption work. For more technical details on this subject, see the online document <a href="http://developer.netscape.com/docs/manuals/security/pkin/index.htm" TARGET="_blank">Introduction to Public-Key Cryptography</a>.
<p>&nbsp;
<h3><a NAME="how_sigs_work"></a>
How Digital Signatures Work</h3>
<p>A digital signature is a special code, unique to each message, created by means of <a href="glossary.html#public-key_cryptography">public-key cryptography</a>.
<p>A digital signature is completely different from a handwritten signature, although it can sometimes be used for similar legal purposes, such as signing a contract.
<p>To create a digital signature for an email or newsgroup message that you are sending, you need two things:
<ul>
<li>A <b>signing certificate</b> that identifies you for this purpose. Every time you sign a message, your signing certificate is included with the message. The certificate includes a <a href="glossary.html#public_key">public key</a>. The presence of the certificate in the message permits the recipient to verify your digital signature.
<p>Your certificate is a bit like your name and phone number in the phonebook&#151;it is public information that helps other people communicate with you.
<li>A <a href="glossary.html#private_key">private key</a>, which is created and stored on your computer when you first obtain a certificate.
<p>Your private key is protected by your <a href="glossary.html#master_password">master password</a> and is not normally disclosed to anyone else. The Mail & Newsgroup software uses your private key to create a unique, verifiable digital signature for every message you choose to sign.
</ul>
<p>&nbsp;
<h3><a NAME="how_encrypt_works"></a>
How Encryption Works</h3>
<p>To encrypt an email message, you must have an encryption certificate for each of the message's recipients. The public key in each certificate is used to encrypt the message for that recipient.
<p>If you dont have a certificate for even a single recipient, the message cannot be encrypted.
<p>The recipient's software uses the recipient's private key, which remains on that person's computer, to decrypt the message.
<p>&nbsp;
<h2><a NAME="get_mail_certs"></a>Getting Other People's Certificates</h2>
<p>Every time you send a digitally signed message, your encryption certificate is automatically included with the message. Therefore, one of the easiest ways to obtain someone else's certificate is for that person to send you a digitally signed message.
<p>When you receive such a message, the person's certificate is automatically stored by the <a href="certs_help.html">Certificate Manager</a>, which is the part of the browser that keeps track of certificates.
<p>You can also obtain certificates by looking them up in a public directory, such as the &quot;phonebook&quot;directories maintained by many companies.
<p>&nbsp;
<h2><a NAME="config_account"></a>Configuring Security Settings</h2>
<p>Text for these sections to come.
<p>&nbsp;
<h2><a NAME="signing"></a>Signing Messages</h2>
<p>&nbsp;
<h2><a NAME="encrypting"></a>Encrypting Email Messages</h2>
<p>&nbsp;
<hr><a NAME="compose_security"></a>
<h2>Message Security - Compose</h2>
<p>This section describes the Message Security window that you can open for any message you are composing. If you're not already viewing Message Security, click the Security icon in the toolbar of the Compose window.
<p>The Message Security window describes how your message will be sent:
<ul>
<li><b>Digitally Signed:</b> This line describes whether your message will be signed. There are three possibilities:</li>
<ul>
<li><b>Yes.</b> Digital signing has been enabled for this message, you have a valid certificate identifying you, and the message can be be signed.
<li><b>No.</b> Digital signing has been disabled for this message.
<li><b>Not possible.</b> Digital signing has been enabled for this message. However, a valid <a href="glossary.html#certificate">certificate</a> identifying you for this purpose is not available, or there is some other problem that makes signing impossible.
</ul>
<li><b>Encrypted:</b> This line describes whether your message will be encrypted. There are three possibilities:</li>
<ul>
<li><b>Yes.</b> Encryption has been enabled for this message, valid certificates for all listed recipients are available, and the message can be encryted.
<li><b>No.</b> Encryption has been disabled for this message.
<li><b>Not possible.</b> Encryption has been enabled for this message. However, a valid certificate for at least one of the listed recipients is not available, or no recipients are listed, or there is some other problem that makes encryption impossible.
</ul>
</ul>
<p>The Message Security window also lists the certifiates available for the recipients of your message:
<ul>
<li><b>View.</b> To view the details for any certificate in the list, select its name, then click View.
</ul>
<p>For information more information about obtaining certificates and configuring message security settings, see <a href="#secure_mail_first">Signing &amp; Encrypting Messages</a>
<p>To indicate your signing or encryption choices for an individual message, click the arrow beside the Security button in the Compose window, then select the options you want.
<pTo indicate your default signing and encryption preferences for all messages, see <a href="mail_help.html#security_settings">Mail &amp; Newsgroups Account Settings - Security</a>
<p>&nbsp;
<hr><a NAME="received_security"></a><h2>Message Security - Received Message</h2>
<p>This section describes the Message Security window that you can open for any message you have received. If you're not already viewing Message Security for a received message, follow these steps:
<ol>
<li>In the Mail window, select the message for which you want to view security information.
<li>Open the View menu and choose Message Security Information.
</ol>
<p>The Message Security window displays the following information:
<ul>
<li><b>Digital Signature.</b> The top section describes whether the message is digitally signed and if so, whether the signature is valid.
<p>If validation failed while OCSP was enabled, check the OCSP settings in <a href="validation_help.html#validation_first">Privacy &amp; Security Preferences - Validation</a>. If you are not familiar with OCSP, confirm the settings with your system administrator. If your settings are correct, there may be a problem with the OCSP service or the certificate used to create the signature is no longer valid. </li>
<p>If the signature is invalid because of a problem with a certificate's trust settings, you can use the <a href="certs_help.html">Certificate Manager</a> to view or edit those settings.
<li><b>View Signature Certificate.</b> If the message is signed, click this button to view the certificate that was used to sign it.
<li><b>Encryption.</b> The bottom section reports whether the message is encrypted and any decrypting problems.</li>
<ul>
<li>If the message's contents have been altered during transit, you should ask the sender to resend it. The changes may have been caused by network problems.
<li>If a copy of your own certificate (used by the sender to encrypt the message) is not available on your computer, the private key required to decrypt the message cannot be retrieved. The only solution is to import a backup copy of your certificate and its private key (see <a href="certs_help.html#My_Certificates">Your Certificates</a> for details.)If you don't have access to a backup certificate, you will not be able to decrypt the message.
</ul>
</ul>
<p>For information more information about obtaining certificates and configuring message security settings, see <a href="#secure_mail_first">Signing &amp; Encrypting Messages</a>.
<p>To indicate your signing or encryption choices for an individual message, click the arrow beside the Security button in the Compose window, then select the options you want.
<pTo indicate your default signing and encryption preferences for all messages, see <a href="mail_help.html#security_settings">Mail &amp; Newsgroups Account Settings - Security</a>
<p>&nbsp;
<hr>
<p><i>19 March 2002</i></p>
<p>Copyright &copy; 1994-2002 Netscape Communications Corporation.</p>
</body>
</html>

2
mozilla/extensions/help/resources/locale/en-US/mozillahelp.rdf
View File

@@ -9,7 +9,7 @@
nc:base="chrome://help/locale/">
<nc:panellist>
<rdf:Seq>
<rdf:li> <rdf:Description nc:panelid="search" nc:datasources="rdf:null"/> </rdf:li>
<rdf:li> <rdf:Description nc:panelid="search" nc:datasources="search-db.rdf"/> </rdf:li>
<rdf:li> <rdf:Description nc:panelid="toc" nc:datasources="help-toc.rdf"/> </rdf:li>
<rdf:li> <rdf:Description nc:panelid="index" nc:datasources="help-indexAZ.rdf help-index1.rdf"/> </rdf:li>
<rdf:li> <rdf:Description nc:panelid="glossary" nc:datasources="help-glossary.rdf"/> </rdf:li>

15
mozilla/extensions/help/resources/locale/en-US/search-db.rdf Normal file
View File

@@ -0,0 +1,15 @@
<?xml version="1.0"?>
<rdf:RDF xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
xmlns:nc="http://home.netscape.com/NC-rdf#">
<rdf:Description about="urn:root">
<nc:subheadings>
<rdf:Seq><rdf:li>
<rdf:Description ID="Setting Preferences"
nc:name="Setting Preferences"
nc:link="chrome://help/locale/nav_help.html#Setting PreferencesSDX"/>
</rdf:li></rdf:Seq>
</nc:subheadings>
</rdf:Description>
</rdf:RDF>