Adding Localization notes per Bugzilla #39775 beta2+

r=rchen@netscape.com

editor/ui/composer/locale/en-US/editor.dtd

@@ -21,7 +21,7 @@
   -->
 
 <!-- Window title -->
-<!-- LOCALIZATION NOTE  (mainWindow.title): DONT_TRANSLATE -->
+<!-- LOCALIZATION NOTE  (editorWindow.titlemodifier): DONT_TRANSLATE -->
 <!ENTITY editorWindow.titlemodifier "Composer"> 
 <!ENTITY editorWindow.titlemodifiermenuseparator " - ">
 <!ENTITY textEditorWindow.titlemodifier "Text Editor"> 

editor/ui/composer/locale/en-US/editor.properties

@@ -1,8 +1,8 @@
 #
 # moved from content/
 #
-# Note: embeded "\n" translate into breaks (<br>)
-# Don't tranalate!!!
+# LOCALIZATION NOTE FILE: embedded "\n" represent HTML breaks (<br>)
+# Don't translate embedded "\n".
 # Don't translate strings like this: %variable%
 #  as they will be replaced using JavaScript
 #
@@ -46,12 +46,12 @@ AllFiles=All Files
 BeforeClosing= before closing
 BeforeViewSource=in order to view source
 BeforePreview=in order to preview
-#Don't translate %title% and %reason% (this is the reason for asking user to close, such as "before closing")
+# LOCALIZATION NOTE (SaveFilePrompt): Don't translate %title% and %reason% (this is the reason for asking user to close, such as "before closing")
 SaveFilePrompt=Save changes to "%title%" %reason%? 
 SaveFileFailed=Saving file failed!
 RevertCaption=Revert To Last Saved
 Revert=Revert
-#Don't translate %title%
+## LOCALIZATION NOTE (AbandonChanges): Don't translate %title%
 AbandonChanges=Abandon unsaved changes to %title% and reload page?
 DocumentTitle=Document Title
 NeedDocTitle=Enter a title for the current page.
@@ -65,10 +65,10 @@ MixedSelection=[Mixed selection]
 Mixed=(mixed)
 EnterLinkText=Enter text to display for the link:
 EmptyLinkTextError=You must enter some text for this link.
-#Don't translate: %n% %min% %max%
+#LOCALIZATION NOTE (ValidateNumber):Don't translate: %n% %min% %max%
 ValidateNumber=The number you entered (%n%) is outside of the allowed range. Please enter a number between %min% and %max%
 MissingAnchorNameError=You must enter a name for this anchor.
-#Don't translate %name%
+#LOCALIZATION NOTE (DuplicateAnchorNameError): Don't translate %name%
 DuplicateAnchorNameError="%name%" already exists in this page. Please enter a different name.
 BulletStyle=Bullet Style:
 SolidCircle=Solid circle
@@ -89,10 +89,15 @@ PercentOfTable=% of table
 untitled=untitled
 NoNamedAnchors=(No named anchors in this page)
 NoHeadings=(No headings without anchors)
-#These next 3 must be compatable with "formatbkgdcolormenu.accesskey" in editorOverlay.dtd
-#Should use a letter in the word "background"
+# LOCALIZATION NOTE (PageBackColor): The access key
+# for this variable must be compatable with "formatbkgdcolormenu.accesskey" in 
+# editorOverlay.dtd
+# Since Background is the common word, a letter from this word should be used
+# as the access key.
 PageBackColor=Page Background Color
+# LOCALIZATION NOTE (CellBackColor): See note for PageBackColor
 CellBackColor=Cell Background Color
+# LOCALIZATION NOTE (TableBackColor): See note for PageBackColor
 TableBackColor=Table Background Color
 LastPickedColor=Last picked color
 ColorLable=Color:
@@ -103,16 +108,23 @@ Link=Link
 Image=Image
 NamedAnchor=Named Anchor
 Tag=Tag
-#Don't translate "%obj%" it will be replaced with one of above object nouns
+# LOCALIZATION NOTE (ObjectProperties):Don't translate "%obj%" it will be replaced with one of above object nouns
 ObjectProperties=%obj% Properties...
-#Next 2 must contain the "tablejoincells.accesskey" letter in editorOverlay.dtd
+# LOCALIZATION NOTE (JoinSelectedCells): This variable should contain the "tablejoincells.accesskey" 
+# letter as defined in editorOverlay.dtd
 JoinSelectedCells=Join Selected Cells
+# LOCALIZATION NOTE (JoinCellToRight): This variable should contain the "tablejoincells.accesskey" 
+# letter as defined in editorOverlay.dtd
 JoinCellToRight=Join with Cell to the Right
-#The next 5 are keys on keyboard -- I don't know if they are normally translated!
+# LOCALIZATION NOTE (TableSelectKey): DONT_TRANSLATE
 TableSelectKey=Ctrl+
+# LOCALIZATION NOTE (XulKeyDefault): DONT_TRANSLATE
 XulKeyDefault=Ctrl+
+# LOCALIZATION NOTE (XulKeyMac): DONT_TRANSLATE
 XulKeyMac=Cmd+
+# LOCALIZATION NOTE (XulKeyUnix): DONT_TRANSLATE
 XulKeyUnix=Alt+
+# LOCALIZATION NOTE (Del): DONT_TRANSLATE
 Del=Del
 Delete=Delete
 Clear=Clear

editor/ui/composer/locale/en-US/editorOverlay.dtd

@@ -140,6 +140,7 @@
 <!ENTITY viewcharsetmenu4.accesskey "">
 <!ENTITY dcharMenu5.label "Character Set  Windows">
 <!ENTITY viewcharsetmenu5.accesskey "">
+<!-- LOCALIZATION NOTE (dcharIso1Cmd.label): Don't translate the ISO code -->
 <!ENTITY dcharIso1Cmd.label "Western (ISO-8859-1)">
 <!ENTITY charsetLatin1.accesskey "">
 <!ENTITY dcharIso2Cmd.label "Central European (ISO-8859-2)">
@@ -368,9 +369,9 @@
 <!ENTITY coloryellow.accesskey "y">
 <!ENTITY colorMagentaCmd.label "Magenta">
 <!ENTITY colormagenta.accesskey "m">
-<!-- 
-Menu item text for "[Page|Table|Cell] Background color" is filled from 
- editor.properties strings, so accesskey should be compatable with those
+<!-- LOCALIZATION NOTE ( formatbkgdcolormenu ):
+ Menu item text for "[Page|Table|Cell] Background color" is filled from 
+ editor.properties strings, so accesskey should be compatible with those
 -->
 <!ENTITY formatbkgdcolormenu.accesskey "b">
 <!ENTITY removeAllStylesCmd.label "Remove All Text Styles">
@@ -612,3 +613,4 @@ Menu item text for "[Page|Table|Cell] Background color" is filled from
 <!ENTITY sourceMode.label "HTML Source">
 <!ENTITY sourceMode.tooltip "Edit HTML source">
 <!ENTITY ToggleEditModeType.tooltip "Toggle between tab icons and text labels ">
+

editor/ui/composer/locale/en-US/viewSource.dtd

@@ -52,6 +52,7 @@
 <!ENTITY copyCmd.label "Copy">
 <!ENTITY pasteCmd.label "Paste">
 <!ENTITY deleteCmd.label "Delete">
+<!-- LOCALIZATION NOTE (walletMenu.label): DONT_TRANSLATE -->
 <!ENTITY walletMenu.label "Wallet">
 <!ENTITY walletSafeFillCmd.label "Safe Form Fill">
 <!ENTITY walletQuickFillCmd.label "Quick Form Fill">
@@ -79,6 +80,7 @@
 <!ENTITY pageInfoCmd.label "Page Info">
 <!ENTITY charSetMenu.label "Character Set"> 
 <!ENTITY charWesternCmd.label "Latin1">  
+<!-- LOCALIZATION NOTE (charJapaneseCmd.label): Don't translate the ISO code -->
 <!ENTITY charJapaneseCmd.label "Japanese (ISO-2022-JP)">  
 <!ENTITY charShiftJisCmd.label "Shift_JIS">
 <!ENTITY charEupCmd.label "EUC-JP">
@@ -98,6 +100,7 @@
 <!ENTITY goForwardCmd.label "Go Forward">
 <!ENTITY goHomeCmd.label "Home">
 <!ENTITY tasksMenu.label "Tasks">
+<!-- LOCALIZATION NOTE (navigatorCmd.label): DONT_TRANSLATE -->
 <!ENTITY navigatorCmd.label "Navigator">
 <!ENTITY messengerCmd.label "Messenger">
 <!ENTITY editorCmd.label "Editor">
@@ -120,6 +123,7 @@
 <!ENTITY softwareUpdatesCmd.label "Software Updates">
 <!ENTITY technicalSupportCmd.label "Technical Support">
 <!ENTITY releaseNotesCmd.label "Release Notes">
+<!-- LOCALIZATION NOTE (aboutCommunicatorCmd.label): DONT_TRANSLATE -->
 <!ENTITY aboutCommunicatorCmd.label "About Communicator Prototype">