From 7f4afbf42e3f00abb43b33c127133317688fbb41 Mon Sep 17 00:00:00 2001
From: "fergus%netscape.com" <fergus%netscape.com>
Date: Thu, 16 Sep 1999 21:20:57 +0000
Subject: [PATCH] Adding localization comments

---
 suite/debugQA/locales/en-US/pref-debug.dtd                  | 1 +
 suite/locales/en-US/chrome/common/pref/pref-advanced.dtd    | 4 ++++
 suite/locales/en-US/chrome/common/pref/pref-appearance.dtd  | 5 +++++
 .../locales/en-US/chrome/common/pref/pref-applications.dtd  | 2 ++
 suite/locales/en-US/chrome/common/pref/pref-cache.dtd       | 1 +
 suite/locales/en-US/chrome/common/pref/pref-colors.dtd      | 2 ++
 suite/locales/en-US/chrome/common/pref/pref-debug.dtd       | 1 +
 suite/locales/en-US/chrome/common/pref/pref-download.dtd    | 1 +
 suite/locales/en-US/chrome/common/pref/pref-fonts.dtd       | 6 +++++-
 suite/locales/en-US/chrome/common/pref/pref-languages.dtd   | 2 ++
 suite/locales/en-US/chrome/common/pref/pref-navigator.dtd   | 3 +++
 suite/locales/en-US/chrome/common/pref/pref-offline.dtd     | 2 ++
 suite/locales/en-US/chrome/common/pref/pref-proxies.dtd     | 1 +
 suite/locales/en-US/chrome/common/pref/pref-smartupdate.dtd | 3 +++
 suite/locales/en-US/chrome/common/pref/preftree.dtd         | 4 ++++
 .../prefwindow/resources/locale/en-US/PrefsWindow.dtd       | 1 +
 .../prefwindow/resources/locale/en-US/pref-advanced.dtd     | 4 ++++
 .../prefwindow/resources/locale/en-US/pref-appearance.dtd   | 5 +++++
 .../prefwindow/resources/locale/en-US/pref-applications.dtd | 2 ++
 .../prefwindow/resources/locale/en-US/pref-cache.dtd        | 1 +
 .../prefwindow/resources/locale/en-US/pref-colors.dtd       | 2 ++
 .../prefwindow/resources/locale/en-US/pref-composer.dtd     | 6 ++++++
 .../prefwindow/resources/locale/en-US/pref-debug.dtd        | 1 +
 .../prefwindow/resources/locale/en-US/pref-download.dtd     | 1 +
 .../prefwindow/resources/locale/en-US/pref-fonts.dtd        | 6 +++++-
 .../prefwindow/resources/locale/en-US/pref-languages.dtd    | 2 ++
 .../prefwindow/resources/locale/en-US/pref-navigator.dtd    | 3 +++
 .../prefwindow/resources/locale/en-US/pref-offline.dtd      | 2 ++
 .../prefwindow/resources/locale/en-US/pref-proxies.dtd      | 1 +
 .../prefwindow/resources/locale/en-US/pref-publish.dtd      | 5 +++++
 .../prefwindow/resources/locale/en-US/pref-smartupdate.dtd  | 3 +++
 .../prefwindow/resources/locale/en-US/preftree.dtd          | 4 ++++
 32 files changed, 85 insertions(+), 2 deletions(-)

diff --git a/suite/debugQA/locales/en-US/pref-debug.dtd b/suite/debugQA/locales/en-US/pref-debug.dtd
index 99c26ae5995..4328d0b5851 100644
--- a/suite/debugQA/locales/en-US/pref-debug.dtd
+++ b/suite/debugQA/locales/en-US/pref-debug.dtd
@@ -1,5 +1,6 @@
 <!-- extracted from content/pref-debug.xul -->
 
+<!--LOCALIZATION NOTE pref-debug.dtd TRANSLATE NOTHING IN THIS FILE -->
 <!ENTITY window.title "Debug">
 
 <!ENTITY lHeader "Debug">
diff --git a/suite/locales/en-US/chrome/common/pref/pref-advanced.dtd b/suite/locales/en-US/chrome/common/pref/pref-advanced.dtd
index 8b08dd2fd0e..afff3a5d567 100644
--- a/suite/locales/en-US/chrome/common/pref/pref-advanced.dtd
+++ b/suite/locales/en-US/chrome/common/pref/pref-advanced.dtd
@@ -1,9 +1,12 @@
 <!-- extracted from content/pref-advanced.xul -->
 
+<!--LOCALIZATION NOTE pref-advanced.dtd 'Advanced' prefs settings -->
 <!ENTITY window.title "Advanced">
 <!ENTITY lHeader "Advanced">
 <!ENTITY autoLoadImgCheck.label "Automatically load images"> 
+<!--LOCALIZATION NOTE enbJavaCheck.label 'Java' should never be translated -->
 <!ENTITY enbJavaCheck.label "Enable Java">
+<!--LOCALIZATION NOTE enbJsCheck.label 'JavaScript' should never be translated -->
 <!ENTITY enbJsCheck.label "Enable JavaScript">
 <!ENTITY enbJsCheck.labelforMailNNews "Enable JavaScript for Mail and News">
 <!ENTITY enbCssCheck.label "Enable style sheets">
@@ -16,5 +19,6 @@
 <!ENTITY remSignCheck.label "Automatically prefill usernames and passwords">
 <!ENTITY capFormsCheck.label "Enable prefilling of forms">
 <!ENTITY rHeader "Changing preferences that affect the entire product">
+<!--LOCALIZATION NOTE server.label 'Wallet' is a product name and should not be translated. -->
 <!ENTITY server.label "Server for wallet tables">
 
diff --git a/suite/locales/en-US/chrome/common/pref/pref-appearance.dtd b/suite/locales/en-US/chrome/common/pref/pref-appearance.dtd
index 509bf4dda49..4fd638dc154 100644
--- a/suite/locales/en-US/chrome/common/pref/pref-appearance.dtd
+++ b/suite/locales/en-US/chrome/common/pref/pref-appearance.dtd
@@ -1,13 +1,18 @@
 <!-- extracted from content/pref-appearance.xul -->
 
+<!--LOCALIZATION NOTE pref-appearance.dtd The Appearance prefs dialog.  -->
 <!ENTITY window.title "Appearance">
 <!ENTITY lHeader "Appearance">
 <!ENTITY rHeader "Change the appearance of the display">
 <!ENTITY onStartLegend.label "On startup, launch">
 <!ENTITY appear "Appearance">
+<!--LOCALIZATION NOTE navCheck.label Product name. Never translate. -->
 <!ENTITY navCheck.label "Navigator">
+<!--LOCALIZATION NOTE mesCheck.label Product name. Never translate. -->
 <!ENTITY mesCheck.label "Messenger">
+<!--LOCALIZATION NOTE compCheck.label Product name. Never translate. -->
 <!ENTITY compCheck.label "Composer">
+<!--LOCALIZATION NOTE calCheck.label Product name. Never translate. -->
 <!ENTITY calCheck.label "Calendar">
 <!ENTITY showToolsLegend.label "Show toolbars as">
 <!ENTITY picsNtextRadio.label "Pictures and Text">
diff --git a/suite/locales/en-US/chrome/common/pref/pref-applications.dtd b/suite/locales/en-US/chrome/common/pref/pref-applications.dtd
index 03e17a0c3fe..cfe142193ae 100644
--- a/suite/locales/en-US/chrome/common/pref/pref-applications.dtd
+++ b/suite/locales/en-US/chrome/common/pref/pref-applications.dtd
@@ -1,5 +1,6 @@
 <!-- extracted from content/pref-applications.xul -->
 
+<!--LOCALIZATION NOTE pref-applications.dtd The Applications prefs dialog -->
 <!ENTITY window.title "Advanced">
 <!ENTITY lHeader "Applications">
 <!ENTITY rHeader "Specify helper applications for different file types">
@@ -10,5 +11,6 @@
 <!ENTITY removeButton.label "Remove">
 <!ENTITY file "File type details">
 <!ENTITY exten "Extension:">
+<!--LOCALIZATION NOTE mimeType 'MIME' should not be translated -->
 <!ENTITY mimeType "MIME Type:">
 <!ENTITY handle "Handled By:">
diff --git a/suite/locales/en-US/chrome/common/pref/pref-cache.dtd b/suite/locales/en-US/chrome/common/pref/pref-cache.dtd
index f95d1f72c9c..a60857c57fa 100644
--- a/suite/locales/en-US/chrome/common/pref/pref-cache.dtd
+++ b/suite/locales/en-US/chrome/common/pref/pref-cache.dtd
@@ -1,5 +1,6 @@
 <!-- extracted from content/pref-cache.xul -->
 
+<!--LOCALIZATION NOTE pref-cache.dtd Cache prefs dialog -->
 <!ENTITY  title.label "Cache">
 <!ENTITY  lHeader "Cache">
 <!ENTITY  rHeader "Designate the size of the cache">
diff --git a/suite/locales/en-US/chrome/common/pref/pref-colors.dtd b/suite/locales/en-US/chrome/common/pref/pref-colors.dtd
index 2f8aff14d57..87c7f78532c 100644
--- a/suite/locales/en-US/chrome/common/pref/pref-colors.dtd
+++ b/suite/locales/en-US/chrome/common/pref/pref-colors.dtd
@@ -1,10 +1,12 @@
 <!-- extracted from content/pref-colors.xul -->
 
+<!--LOCALIZATION NOTE pref-colors.dtd Color management prefs -->
 <!ENTITY  window.title "Colors">
 <!ENTITY  lHeader "Colors">
 <!ENTITY  rHeader "Change the colors in your display">
 <!ENTITY  color "Colors">
 <!ENTITY  text "Text:">
+<!--LOCALIZATION NOTE colorPick Don't translate this term -->
 <!ENTITY  colorPick "Color Picker">
 <!ENTITY  background "Background:">
 <!ENTITY  useWinColorsCheck.label "Use Windows colors">
diff --git a/suite/locales/en-US/chrome/common/pref/pref-debug.dtd b/suite/locales/en-US/chrome/common/pref/pref-debug.dtd
index 99c26ae5995..4328d0b5851 100644
--- a/suite/locales/en-US/chrome/common/pref/pref-debug.dtd
+++ b/suite/locales/en-US/chrome/common/pref/pref-debug.dtd
@@ -1,5 +1,6 @@
 <!-- extracted from content/pref-debug.xul -->
 
+<!--LOCALIZATION NOTE pref-debug.dtd TRANSLATE NOTHING IN THIS FILE -->
 <!ENTITY window.title "Debug">
 
 <!ENTITY lHeader "Debug">
diff --git a/suite/locales/en-US/chrome/common/pref/pref-download.dtd b/suite/locales/en-US/chrome/common/pref/pref-download.dtd
index 0e7ee2fe3f4..2e796a082e7 100644
--- a/suite/locales/en-US/chrome/common/pref/pref-download.dtd
+++ b/suite/locales/en-US/chrome/common/pref/pref-download.dtd
@@ -1,5 +1,6 @@
 <!-- extracted from content/pref-download.xul -->
 
+<!--LOCALIZATION NOTE pref-download.dtd 'Download' prefs dialog. Handles optins for reading mail/news offline -->
 <!ENTITY  title.label "Download">
 <!ENTITY  lHeader "Download">
 <!ENTITY  rHeader "Choose settings for sending messages offline">
diff --git a/suite/locales/en-US/chrome/common/pref/pref-fonts.dtd b/suite/locales/en-US/chrome/common/pref/pref-fonts.dtd
index 5ff28a10ae4..a40682484a9 100644
--- a/suite/locales/en-US/chrome/common/pref/pref-fonts.dtd
+++ b/suite/locales/en-US/chrome/common/pref/pref-fonts.dtd
@@ -1,18 +1,22 @@
 <!-- extracted from content/pref-fonts.xul -->
 
-
+<!--LOCALIZATION NOTE pref-fonts.dtd 'Fonts' prefs dialog -->
 <!ENTITY  window.title "Fonts">
 <!ENTITY  lHeader "Fonts">
 <!ENTITY  rHeader "Change the fonts in your display">
 <!ENTITY  encod.select "For the Encoding:">
 <!ENTITY  encod1.option "Western">
 <!ENTITY  size.select "Size">
+<!--LOCALIZATION NOTE size1.option Don't change this string -->
 <!ENTITY  size1.option "10">
 <!ENTITY  varFont.select "Variable Width Font:">
+<!--LOCALIZATION NOTE varFont.option Don't change this string -->
 <!ENTITY  varFont.option "10">
 <!ENTITY  fixedFont.Select "Fixed Width Font">
+<!--LOCALIZATION NOTE fixedFont.option Don't translate this term. -->
 <!ENTITY  fixedFont.option "Filler">
 <!ENTITY  header2 "Sometimes a document will provide its own fonts.">
 <!ENTITY  useDefaultFontRadio "Use my default fonts, overriding document-specified fonts">
+<!--LOCALIZATION NOTE useDocFontRadio Translate 'Dynamic Fonts' according to Netscape Glossary -->
 <!ENTITY  useDocFontRadio "Use document-specified fonts, but disable Dynamic Fonts">
 <!ENTITY  useDocFontsRadio "Use document-specified fonts, including Dynamic Fonts">
diff --git a/suite/locales/en-US/chrome/common/pref/pref-languages.dtd b/suite/locales/en-US/chrome/common/pref/pref-languages.dtd
index 19c6a21ae6c..9d0aa5ef352 100644
--- a/suite/locales/en-US/chrome/common/pref/pref-languages.dtd
+++ b/suite/locales/en-US/chrome/common/pref/pref-languages.dtd
@@ -1,11 +1,13 @@
 <!-- extracted from content/pref-languages.xul -->
 
+<!--LOCALIZATION NOTE pref-languages.dtd 'Languages' preferences dialog -->
 <!ENTITY  window.title "Languages">
 <!ENTITY  LangHeader "Languages">
 <!ENTITY  prefLangDecript "Choose in order of preference the language(s) 
 			in which you prefer to view web pages. Web pages are sometimes 
 			available in several languages.  Naveigator presents pages in 
 			the available language you most prefer.">
+<!--LOCALIZATION NOTE engOption.label Do not translate this term.  It'll be replaced at runtime -->
 <!ENTITY engOption.label  "English">
 <!ENTITY addButton.label  "Add...">
 <!ENTITY deleteButton.label  "Delete...">
diff --git a/suite/locales/en-US/chrome/common/pref/pref-navigator.dtd b/suite/locales/en-US/chrome/common/pref/pref-navigator.dtd
index bf23a36dd3b..b786806d391 100644
--- a/suite/locales/en-US/chrome/common/pref/pref-navigator.dtd
+++ b/suite/locales/en-US/chrome/common/pref/pref-navigator.dtd
@@ -1,5 +1,7 @@
 <!-- extracted from content/pref-navigator.xul -->
 
+<!--LOCALIZATION NOTE pref-navigator.dtd Navigator prefs screen -->
+<!--LOCALIZATION NOTE title.label Never translate the term "Navigator" -->
 <!ENTITY  title.label "Navigator">
 <!ENTITY  lHeader "Navigator">
 <!ENTITY  rHeader "Specify the home page location">
@@ -14,6 +16,7 @@
 <!ENTITY  browseFile "Select File...">
 <!ENTITY  header3.label "History">
 <!ENTITY  historyPages "List of the pages you have previously visited.">
+<!--LOCALIZATION NOTE histDay Do not change this numeric value. -->
 <!ENTITY  histDay "9">
 <!ENTITY  daysRadio "days">
 <!ENTITY  homepageRadio "Homepage">
diff --git a/suite/locales/en-US/chrome/common/pref/pref-offline.dtd b/suite/locales/en-US/chrome/common/pref/pref-offline.dtd
index 48136900e01..2171d7e47f2 100644
--- a/suite/locales/en-US/chrome/common/pref/pref-offline.dtd
+++ b/suite/locales/en-US/chrome/common/pref/pref-offline.dtd
@@ -1,8 +1,10 @@
 <!-- extracted from content/pref-offline.xul -->
 
+<!--LOCALIZATION NOTE pref-offline.dtd The 'Offline' preferences dialog -->
 <!ENTITY title.label "Offline">
 <!ENTITY header "Offline">
 <!ENTITY header1 "Startup State">
+<!--LOCALIZATION NOTE descipt1 Never translate the term 'Communicator' -->
 <!ENTITY descipt1 "Commucator can start in either online or offline modes. When online you have full 
 access to your network.  When offline you can only read messages that you have previously downloaded.">
 <!ENTITY prevRadio.label "Remember Previous State">
diff --git a/suite/locales/en-US/chrome/common/pref/pref-proxies.dtd b/suite/locales/en-US/chrome/common/pref/pref-proxies.dtd
index 7d0bda9d4a3..d3e4c1f5ee0 100644
--- a/suite/locales/en-US/chrome/common/pref/pref-proxies.dtd
+++ b/suite/locales/en-US/chrome/common/pref/pref-proxies.dtd
@@ -1,5 +1,6 @@
 <!-- extracted from content/pref-proxies.xul -->
 
+<!--LOCALIZATION NOTE pref-proxies.dtd The Proxies preferences dialog -->
 <!ENTITY  title.label "Sample Prefs Panel">
 <!ENTITY  lHeader  "Proxies">
 <!ENTITY  rHeader  "Configure proxies to access the Internet">
diff --git a/suite/locales/en-US/chrome/common/pref/pref-smartupdate.dtd b/suite/locales/en-US/chrome/common/pref/pref-smartupdate.dtd
index df046d69b4d..9a307d18d75 100644
--- a/suite/locales/en-US/chrome/common/pref/pref-smartupdate.dtd
+++ b/suite/locales/en-US/chrome/common/pref/pref-smartupdate.dtd
@@ -1,6 +1,9 @@
+<!--LOCALIZATION NOTE pref-smartupdate.dtd UI for SmartUpdate prefs -->
+<!--LOCALIZATION NOTE pref-smartupdate.dtd Don't translate the term 'SmartUpdate' -->
 <!ENTITY title.label "SmartUpdate">
 <!ENTITY header "SmartUpdate">
 <!ENTITY enableSU.label "Enable SmartUpdate">
 <!ENTITY requireConfirmation.label "Require manual confirmation of each install">
+<!--LOCALIZATION NOTE selectUninstall.label A large list box appears below this label -->
 <!ENTITY selectUninstall.label "To uninstall, select from the following list and click the uninstall button">
 <!ENTITY uninstallButton.label "Uninstall">
diff --git a/suite/locales/en-US/chrome/common/pref/preftree.dtd b/suite/locales/en-US/chrome/common/pref/preftree.dtd
index 31643e3ac98..12ed3cd25e5 100644
--- a/suite/locales/en-US/chrome/common/pref/preftree.dtd
+++ b/suite/locales/en-US/chrome/common/pref/preftree.dtd
@@ -1,11 +1,14 @@
 <!-- extracted from content/preftree.xul -->
 
+<!--LOCALIZATION NOTE preftree.dtd Lists preferences categories that appear on the left of the preferences dialog -->
 <!ENTITY appear.label "Appearance">
 <!ENTITY fonts.label "Fonts">
 <!ENTITY colors.label "Colors">
+<!--LOCALIZATION NOTE navigator.label Don't translate the term 'Navigator' -->
 <!ENTITY navigator.label "Navigator">
 <!ENTITY languages.label "Languages">
 <!ENTITY applications.label "Applications">
+<!--LOCALIZATION NOTE smartBrowse.label Don't translate the term 'Smart Browsing' -->
 <!ENTITY smartBrowse.label "Smart Browsing">
 <!ENTITY mail.label "Mail and Newsgroups">
 <!ENTITY address.label "Addressing">
@@ -21,5 +24,6 @@
 <!ENTITY down.label "Download">
 <!ENTITY cache.label "Cache">
 <!ENTITY proxies.label "Proxies">
+<!--LOCALIZATION NOTE smart.label Don't translate the term 'Smart Update' -->
 <!ENTITY smart.label "Smart Update">
 <!ENTITY debug.label "Debug">
diff --git a/xpfe/components/prefwindow/resources/locale/en-US/PrefsWindow.dtd b/xpfe/components/prefwindow/resources/locale/en-US/PrefsWindow.dtd
index 1c9622499d1..f060deacc1b 100644
--- a/xpfe/components/prefwindow/resources/locale/en-US/PrefsWindow.dtd
+++ b/xpfe/components/prefwindow/resources/locale/en-US/PrefsWindow.dtd
@@ -1,5 +1,6 @@
 <!-- extracted from content/PrefsWindow.xul -->
 
+<!-- LOCALIZATION NOTE PrefsWindow.dtd UI for the outer parts of the Prefs dialog -->
 <!ENTITY categoryHeader "Category">
 <!ENTITY window.title "Preferences">
 <!ENTITY helpButton.label "Help">
diff --git a/xpfe/components/prefwindow/resources/locale/en-US/pref-advanced.dtd b/xpfe/components/prefwindow/resources/locale/en-US/pref-advanced.dtd
index 8b08dd2fd0e..afff3a5d567 100644
--- a/xpfe/components/prefwindow/resources/locale/en-US/pref-advanced.dtd
+++ b/xpfe/components/prefwindow/resources/locale/en-US/pref-advanced.dtd
@@ -1,9 +1,12 @@
 <!-- extracted from content/pref-advanced.xul -->
 
+<!--LOCALIZATION NOTE pref-advanced.dtd 'Advanced' prefs settings -->
 <!ENTITY window.title "Advanced">
 <!ENTITY lHeader "Advanced">
 <!ENTITY autoLoadImgCheck.label "Automatically load images"> 
+<!--LOCALIZATION NOTE enbJavaCheck.label 'Java' should never be translated -->
 <!ENTITY enbJavaCheck.label "Enable Java">
+<!--LOCALIZATION NOTE enbJsCheck.label 'JavaScript' should never be translated -->
 <!ENTITY enbJsCheck.label "Enable JavaScript">
 <!ENTITY enbJsCheck.labelforMailNNews "Enable JavaScript for Mail and News">
 <!ENTITY enbCssCheck.label "Enable style sheets">
@@ -16,5 +19,6 @@
 <!ENTITY remSignCheck.label "Automatically prefill usernames and passwords">
 <!ENTITY capFormsCheck.label "Enable prefilling of forms">
 <!ENTITY rHeader "Changing preferences that affect the entire product">
+<!--LOCALIZATION NOTE server.label 'Wallet' is a product name and should not be translated. -->
 <!ENTITY server.label "Server for wallet tables">
 
diff --git a/xpfe/components/prefwindow/resources/locale/en-US/pref-appearance.dtd b/xpfe/components/prefwindow/resources/locale/en-US/pref-appearance.dtd
index 509bf4dda49..4fd638dc154 100644
--- a/xpfe/components/prefwindow/resources/locale/en-US/pref-appearance.dtd
+++ b/xpfe/components/prefwindow/resources/locale/en-US/pref-appearance.dtd
@@ -1,13 +1,18 @@
 <!-- extracted from content/pref-appearance.xul -->
 
+<!--LOCALIZATION NOTE pref-appearance.dtd The Appearance prefs dialog.  -->
 <!ENTITY window.title "Appearance">
 <!ENTITY lHeader "Appearance">
 <!ENTITY rHeader "Change the appearance of the display">
 <!ENTITY onStartLegend.label "On startup, launch">
 <!ENTITY appear "Appearance">
+<!--LOCALIZATION NOTE navCheck.label Product name. Never translate. -->
 <!ENTITY navCheck.label "Navigator">
+<!--LOCALIZATION NOTE mesCheck.label Product name. Never translate. -->
 <!ENTITY mesCheck.label "Messenger">
+<!--LOCALIZATION NOTE compCheck.label Product name. Never translate. -->
 <!ENTITY compCheck.label "Composer">
+<!--LOCALIZATION NOTE calCheck.label Product name. Never translate. -->
 <!ENTITY calCheck.label "Calendar">
 <!ENTITY showToolsLegend.label "Show toolbars as">
 <!ENTITY picsNtextRadio.label "Pictures and Text">
diff --git a/xpfe/components/prefwindow/resources/locale/en-US/pref-applications.dtd b/xpfe/components/prefwindow/resources/locale/en-US/pref-applications.dtd
index 03e17a0c3fe..cfe142193ae 100644
--- a/xpfe/components/prefwindow/resources/locale/en-US/pref-applications.dtd
+++ b/xpfe/components/prefwindow/resources/locale/en-US/pref-applications.dtd
@@ -1,5 +1,6 @@
 <!-- extracted from content/pref-applications.xul -->
 
+<!--LOCALIZATION NOTE pref-applications.dtd The Applications prefs dialog -->
 <!ENTITY window.title "Advanced">
 <!ENTITY lHeader "Applications">
 <!ENTITY rHeader "Specify helper applications for different file types">
@@ -10,5 +11,6 @@
 <!ENTITY removeButton.label "Remove">
 <!ENTITY file "File type details">
 <!ENTITY exten "Extension:">
+<!--LOCALIZATION NOTE mimeType 'MIME' should not be translated -->
 <!ENTITY mimeType "MIME Type:">
 <!ENTITY handle "Handled By:">
diff --git a/xpfe/components/prefwindow/resources/locale/en-US/pref-cache.dtd b/xpfe/components/prefwindow/resources/locale/en-US/pref-cache.dtd
index f95d1f72c9c..a60857c57fa 100644
--- a/xpfe/components/prefwindow/resources/locale/en-US/pref-cache.dtd
+++ b/xpfe/components/prefwindow/resources/locale/en-US/pref-cache.dtd
@@ -1,5 +1,6 @@
 <!-- extracted from content/pref-cache.xul -->
 
+<!--LOCALIZATION NOTE pref-cache.dtd Cache prefs dialog -->
 <!ENTITY  title.label "Cache">
 <!ENTITY  lHeader "Cache">
 <!ENTITY  rHeader "Designate the size of the cache">
diff --git a/xpfe/components/prefwindow/resources/locale/en-US/pref-colors.dtd b/xpfe/components/prefwindow/resources/locale/en-US/pref-colors.dtd
index 2f8aff14d57..87c7f78532c 100644
--- a/xpfe/components/prefwindow/resources/locale/en-US/pref-colors.dtd
+++ b/xpfe/components/prefwindow/resources/locale/en-US/pref-colors.dtd
@@ -1,10 +1,12 @@
 <!-- extracted from content/pref-colors.xul -->
 
+<!--LOCALIZATION NOTE pref-colors.dtd Color management prefs -->
 <!ENTITY  window.title "Colors">
 <!ENTITY  lHeader "Colors">
 <!ENTITY  rHeader "Change the colors in your display">
 <!ENTITY  color "Colors">
 <!ENTITY  text "Text:">
+<!--LOCALIZATION NOTE colorPick Don't translate this term -->
 <!ENTITY  colorPick "Color Picker">
 <!ENTITY  background "Background:">
 <!ENTITY  useWinColorsCheck.label "Use Windows colors">
diff --git a/xpfe/components/prefwindow/resources/locale/en-US/pref-composer.dtd b/xpfe/components/prefwindow/resources/locale/en-US/pref-composer.dtd
index 4052b671df8..b80b23a9ded 100644
--- a/xpfe/components/prefwindow/resources/locale/en-US/pref-composer.dtd
+++ b/xpfe/components/prefwindow/resources/locale/en-US/pref-composer.dtd
@@ -1,10 +1,15 @@
 <!-- extracted from content/pref-composer.xul -->
 
+<!--LOCALIZATION NOTE pref-composer.dtd 'Composer' prefs dialog. Similar to Communcator 4.x Document Properties/Colors and Background -->
+
+<!--LOCALIZATION NOTE title.label Never translate the term 'Composer' -->
 <!ENTITY  title.label "Composer">
 <!ENTITY  lHeader "Composer">
 <!ENTITY  rHeader "Set general preferences for authoring of Web pages">
 <!ENTITY  authorName "Author Name">
+<!--LOCALIZATION NOTE AutoSaveCheck.label Edit box appears between these two strings. Translators may need to alter the word order over the two strings according to locale. -->
 <!ENTITY  AutoSaveCheck.label "Automatically save page every">
+<!--LOCALIZATION NOTE minText Edit box appears between these two strings. Translators may need to alter the word order over the two strings according to locale. -->
 <!ENTITY  minText "minutes">
 <!ENTITY  exterLegend.label "External Editors">
 <!ENTITY  htmlSource "HTML Source:">
@@ -18,4 +23,5 @@
 <!ENTITY  ActiveLinkText.label "Active Link Text">
 <!ENTITY  FollowedLinkText.label "Followed Link Text">
 <!ENTITY  BackgroundColor.label "Background">
+<!--LOCALIZATION NOTE colorPick Don't translate this term -->
 <!ENTITY  colorPick "ColorPicker">
diff --git a/xpfe/components/prefwindow/resources/locale/en-US/pref-debug.dtd b/xpfe/components/prefwindow/resources/locale/en-US/pref-debug.dtd
index 99c26ae5995..4328d0b5851 100644
--- a/xpfe/components/prefwindow/resources/locale/en-US/pref-debug.dtd
+++ b/xpfe/components/prefwindow/resources/locale/en-US/pref-debug.dtd
@@ -1,5 +1,6 @@
 <!-- extracted from content/pref-debug.xul -->
 
+<!--LOCALIZATION NOTE pref-debug.dtd TRANSLATE NOTHING IN THIS FILE -->
 <!ENTITY window.title "Debug">
 
 <!ENTITY lHeader "Debug">
diff --git a/xpfe/components/prefwindow/resources/locale/en-US/pref-download.dtd b/xpfe/components/prefwindow/resources/locale/en-US/pref-download.dtd
index 0e7ee2fe3f4..2e796a082e7 100644
--- a/xpfe/components/prefwindow/resources/locale/en-US/pref-download.dtd
+++ b/xpfe/components/prefwindow/resources/locale/en-US/pref-download.dtd
@@ -1,5 +1,6 @@
 <!-- extracted from content/pref-download.xul -->
 
+<!--LOCALIZATION NOTE pref-download.dtd 'Download' prefs dialog. Handles optins for reading mail/news offline -->
 <!ENTITY  title.label "Download">
 <!ENTITY  lHeader "Download">
 <!ENTITY  rHeader "Choose settings for sending messages offline">
diff --git a/xpfe/components/prefwindow/resources/locale/en-US/pref-fonts.dtd b/xpfe/components/prefwindow/resources/locale/en-US/pref-fonts.dtd
index 5ff28a10ae4..a40682484a9 100644
--- a/xpfe/components/prefwindow/resources/locale/en-US/pref-fonts.dtd
+++ b/xpfe/components/prefwindow/resources/locale/en-US/pref-fonts.dtd
@@ -1,18 +1,22 @@
 <!-- extracted from content/pref-fonts.xul -->
 
-
+<!--LOCALIZATION NOTE pref-fonts.dtd 'Fonts' prefs dialog -->
 <!ENTITY  window.title "Fonts">
 <!ENTITY  lHeader "Fonts">
 <!ENTITY  rHeader "Change the fonts in your display">
 <!ENTITY  encod.select "For the Encoding:">
 <!ENTITY  encod1.option "Western">
 <!ENTITY  size.select "Size">
+<!--LOCALIZATION NOTE size1.option Don't change this string -->
 <!ENTITY  size1.option "10">
 <!ENTITY  varFont.select "Variable Width Font:">
+<!--LOCALIZATION NOTE varFont.option Don't change this string -->
 <!ENTITY  varFont.option "10">
 <!ENTITY  fixedFont.Select "Fixed Width Font">
+<!--LOCALIZATION NOTE fixedFont.option Don't translate this term. -->
 <!ENTITY  fixedFont.option "Filler">
 <!ENTITY  header2 "Sometimes a document will provide its own fonts.">
 <!ENTITY  useDefaultFontRadio "Use my default fonts, overriding document-specified fonts">
+<!--LOCALIZATION NOTE useDocFontRadio Translate 'Dynamic Fonts' according to Netscape Glossary -->
 <!ENTITY  useDocFontRadio "Use document-specified fonts, but disable Dynamic Fonts">
 <!ENTITY  useDocFontsRadio "Use document-specified fonts, including Dynamic Fonts">
diff --git a/xpfe/components/prefwindow/resources/locale/en-US/pref-languages.dtd b/xpfe/components/prefwindow/resources/locale/en-US/pref-languages.dtd
index 19c6a21ae6c..9d0aa5ef352 100644
--- a/xpfe/components/prefwindow/resources/locale/en-US/pref-languages.dtd
+++ b/xpfe/components/prefwindow/resources/locale/en-US/pref-languages.dtd
@@ -1,11 +1,13 @@
 <!-- extracted from content/pref-languages.xul -->
 
+<!--LOCALIZATION NOTE pref-languages.dtd 'Languages' preferences dialog -->
 <!ENTITY  window.title "Languages">
 <!ENTITY  LangHeader "Languages">
 <!ENTITY  prefLangDecript "Choose in order of preference the language(s) 
 			in which you prefer to view web pages. Web pages are sometimes 
 			available in several languages.  Naveigator presents pages in 
 			the available language you most prefer.">
+<!--LOCALIZATION NOTE engOption.label Do not translate this term.  It'll be replaced at runtime -->
 <!ENTITY engOption.label  "English">
 <!ENTITY addButton.label  "Add...">
 <!ENTITY deleteButton.label  "Delete...">
diff --git a/xpfe/components/prefwindow/resources/locale/en-US/pref-navigator.dtd b/xpfe/components/prefwindow/resources/locale/en-US/pref-navigator.dtd
index bf23a36dd3b..b786806d391 100644
--- a/xpfe/components/prefwindow/resources/locale/en-US/pref-navigator.dtd
+++ b/xpfe/components/prefwindow/resources/locale/en-US/pref-navigator.dtd
@@ -1,5 +1,7 @@
 <!-- extracted from content/pref-navigator.xul -->
 
+<!--LOCALIZATION NOTE pref-navigator.dtd Navigator prefs screen -->
+<!--LOCALIZATION NOTE title.label Never translate the term "Navigator" -->
 <!ENTITY  title.label "Navigator">
 <!ENTITY  lHeader "Navigator">
 <!ENTITY  rHeader "Specify the home page location">
@@ -14,6 +16,7 @@
 <!ENTITY  browseFile "Select File...">
 <!ENTITY  header3.label "History">
 <!ENTITY  historyPages "List of the pages you have previously visited.">
+<!--LOCALIZATION NOTE histDay Do not change this numeric value. -->
 <!ENTITY  histDay "9">
 <!ENTITY  daysRadio "days">
 <!ENTITY  homepageRadio "Homepage">
diff --git a/xpfe/components/prefwindow/resources/locale/en-US/pref-offline.dtd b/xpfe/components/prefwindow/resources/locale/en-US/pref-offline.dtd
index 48136900e01..2171d7e47f2 100644
--- a/xpfe/components/prefwindow/resources/locale/en-US/pref-offline.dtd
+++ b/xpfe/components/prefwindow/resources/locale/en-US/pref-offline.dtd
@@ -1,8 +1,10 @@
 <!-- extracted from content/pref-offline.xul -->
 
+<!--LOCALIZATION NOTE pref-offline.dtd The 'Offline' preferences dialog -->
 <!ENTITY title.label "Offline">
 <!ENTITY header "Offline">
 <!ENTITY header1 "Startup State">
+<!--LOCALIZATION NOTE descipt1 Never translate the term 'Communicator' -->
 <!ENTITY descipt1 "Commucator can start in either online or offline modes. When online you have full 
 access to your network.  When offline you can only read messages that you have previously downloaded.">
 <!ENTITY prevRadio.label "Remember Previous State">
diff --git a/xpfe/components/prefwindow/resources/locale/en-US/pref-proxies.dtd b/xpfe/components/prefwindow/resources/locale/en-US/pref-proxies.dtd
index 7d0bda9d4a3..d3e4c1f5ee0 100644
--- a/xpfe/components/prefwindow/resources/locale/en-US/pref-proxies.dtd
+++ b/xpfe/components/prefwindow/resources/locale/en-US/pref-proxies.dtd
@@ -1,5 +1,6 @@
 <!-- extracted from content/pref-proxies.xul -->
 
+<!--LOCALIZATION NOTE pref-proxies.dtd The Proxies preferences dialog -->
 <!ENTITY  title.label "Sample Prefs Panel">
 <!ENTITY  lHeader  "Proxies">
 <!ENTITY  rHeader  "Configure proxies to access the Internet">
diff --git a/xpfe/components/prefwindow/resources/locale/en-US/pref-publish.dtd b/xpfe/components/prefwindow/resources/locale/en-US/pref-publish.dtd
index 456d758d91b..2a1a4f98d8e 100644
--- a/xpfe/components/prefwindow/resources/locale/en-US/pref-publish.dtd
+++ b/xpfe/components/prefwindow/resources/locale/en-US/pref-publish.dtd
@@ -1,16 +1,21 @@
 <!-- extracted from content/pref-publish.xul -->
 
+<!--LOCALIZATION NOTE pref-publish.dtd The Publish preferences screen -->
 <!ENTITY  window.title "Publish">
 <!ENTITY  composerHeader.label "Publish">
 <!ENTITY  maintainCheckbox.label "Maintain links">
 <!ENTITY  keepCheck.label "Keep images with page">
 
+<!--LOCALIZATION NOTE adjustDesc.label Attempt to maitain approximate line length, linefeeds and white space -->
 <!ENTITY  adjustDesc.label "Adjust links to work from the page's location. (Links to local pages will work when
 			      local versions exist.)           ">
+<!--LOCALIZATION NOTE saveDesc.label Attempt to maitain approximate line length, linefeeds and white space -->
 <!ENTITY  saveDesc.label "Save copies of images to the page's location.  Images will always
 				appear in local versions of the page and when the page is published.">
 <!ENTITY  tip.label "Tip: Check both options if you will be using remote publishing.">
 <!ENTITY defaultHeader.label  "Default publishing location">
+<!--LOCALIZATION NOTE publishFtp.label Edit box appears beside this label -->
 <!ENTITY  publishFtp.label "If publishing to a FTP site, enter the HTTP address to browse to:">
+<!--LOCALIZATION NOTE publishhtp.label Edit box appears beside this label -->
 <!ENTITY  publishhtp.label "If publishing to a FTP site, enter the HTTP address to browse to:">
 
diff --git a/xpfe/components/prefwindow/resources/locale/en-US/pref-smartupdate.dtd b/xpfe/components/prefwindow/resources/locale/en-US/pref-smartupdate.dtd
index df046d69b4d..9a307d18d75 100644
--- a/xpfe/components/prefwindow/resources/locale/en-US/pref-smartupdate.dtd
+++ b/xpfe/components/prefwindow/resources/locale/en-US/pref-smartupdate.dtd
@@ -1,6 +1,9 @@
+<!--LOCALIZATION NOTE pref-smartupdate.dtd UI for SmartUpdate prefs -->
+<!--LOCALIZATION NOTE pref-smartupdate.dtd Don't translate the term 'SmartUpdate' -->
 <!ENTITY title.label "SmartUpdate">
 <!ENTITY header "SmartUpdate">
 <!ENTITY enableSU.label "Enable SmartUpdate">
 <!ENTITY requireConfirmation.label "Require manual confirmation of each install">
+<!--LOCALIZATION NOTE selectUninstall.label A large list box appears below this label -->
 <!ENTITY selectUninstall.label "To uninstall, select from the following list and click the uninstall button">
 <!ENTITY uninstallButton.label "Uninstall">
diff --git a/xpfe/components/prefwindow/resources/locale/en-US/preftree.dtd b/xpfe/components/prefwindow/resources/locale/en-US/preftree.dtd
index 31643e3ac98..12ed3cd25e5 100644
--- a/xpfe/components/prefwindow/resources/locale/en-US/preftree.dtd
+++ b/xpfe/components/prefwindow/resources/locale/en-US/preftree.dtd
@@ -1,11 +1,14 @@
 <!-- extracted from content/preftree.xul -->
 
+<!--LOCALIZATION NOTE preftree.dtd Lists preferences categories that appear on the left of the preferences dialog -->
 <!ENTITY appear.label "Appearance">
 <!ENTITY fonts.label "Fonts">
 <!ENTITY colors.label "Colors">
+<!--LOCALIZATION NOTE navigator.label Don't translate the term 'Navigator' -->
 <!ENTITY navigator.label "Navigator">
 <!ENTITY languages.label "Languages">
 <!ENTITY applications.label "Applications">
+<!--LOCALIZATION NOTE smartBrowse.label Don't translate the term 'Smart Browsing' -->
 <!ENTITY smartBrowse.label "Smart Browsing">
 <!ENTITY mail.label "Mail and Newsgroups">
 <!ENTITY address.label "Addressing">
@@ -21,5 +24,6 @@
 <!ENTITY down.label "Download">
 <!ENTITY cache.label "Cache">
 <!ENTITY proxies.label "Proxies">
+<!--LOCALIZATION NOTE smart.label Don't translate the term 'Smart Update' -->
 <!ENTITY smart.label "Smart Update">
 <!ENTITY debug.label "Debug">