Added context to localization messages for easier translation.

1 files changed, 148 insertions, 79 deletions

diff --git a/core/locale.conf b/core/locale.conf
index eb168f81..8b77d7e8 100644
--- a/core/locale.conf
+++ b/core/locale.conf
@@ -1,72 +1,94 @@
 # Copyright 2007-2016 Mitchell mitchell.att.foicica.com. See LICENSE.
+# American English localization file for Textadept.
 #
-# Localization file.
-# The localized strings may contain UTF-8 characters, but not UTF-16 or UTF-32.
-# The latter must be converted manually from the \U+xxxx format. Note that if
-# you use the \ddd representation of characters, it must be in DECIMAL format,
-# not Octal.
+# When translating this file into your native language, all translated text must
+# be encoded in UTF-8. For each "key = value" line, please replace the "value"
+# part with the translation of "key". Any whitespace around '=' is ignored.
 #
-# Each line contains a "message = localized string" pair. The message should not
-# be localized. Extra spaces around '=' are ignored.
-#
-# Notes:
-#   - Buttons and menu items have a "_" character as a mnemonic (for
-#     Alt+character) access. You can put the "_" anywhere applicable in your
-#     localized version or eliminate it altogether.
+# Note: for languages that support it, buttons and menu items may have a "_"
+# before any single letter, which means that pressing the "Alt" modifier key
+# along with that letter will activate (click) the button or menu item. You are
+# free to use or omit these "_" mnemonics from your translations as you see fit.
 
-# core/events.lua
+# [core/events.lua]
+# This error message is displayed if the user accidentally emits an event with
+# no name (e.g. mistypes the name of an existing event).
 Undefined event name = Undefined event name
 
-# core/file_io.lua
+# [core/file_io.lua]
+# The title of dialogs prompting the user to open a file.
 Open = Open
+# The error message displayed when a file's text encoding could not be detected
+# and when that text cannot be converted into UTF-8 for display.
 Encoding conversion failed. = Encoding conversion failed.
+# The title of dialogs prompting the user to save a file.
 Save = Save
+# The text displayed for untitled and unsaved buffers.
 Untitled = Untitled
+# The text displayed in a dialog when the user attempts to close a file with
+# unsaved changes.
 Close without saving? = Close without saving?
 There are unsaved changes in = There are unsaved changes in
+_Cancel = _Cancel
 Close _without saving = Close _without saving
+# The text displayed in a dialog when a file has been externally modified.
 Reload? = Reload?
 Reload modified file? = Reload modified file?
 has been modified. Reload it? = has been modified. Reload it?
 _Yes = _Yes
 _No = _No
+# The column label for lists of filenames in dialogs.
 File = File
+# The text displayed in a dialog when more than X files were found in the quick
+# open dialog.
+files or more were found. Showing the first = files or more were found. Showing the first
+File Limit Exceeded = File Limit Exceeded
+_OK = _OK
+
+# [core/keys.lua]
+# The statusbar text shown when the user has pressed a key that is part of a key
+# chain (e.g. "Ctrl+Alt+V" followed by "S"). Textadept is waiting for another
+# keypress.
+Keychain: = Keychain:
+# The statusbar text shown when the user started a key chain, but the next
+# keypress was unrecognized. Thus the key sequence is invalid.
+Invalid sequence = Invalid sequence
 
-# core/gui.lua
+# [core/ui.lua]
+# The name of the buffer Textadept prints messages and error messages to.
 [Message Buffer] = [Message Buffer]
-_OK = _OK
-_Cancel = _Cancel
+# The column label for lists of buffer names in dialogs.
 Name = Name
-#File = File
-#Untitled = Untitled
+# The title of the dialog for switching between open buffers.
 Switch Buffers = Switch Buffers
-theme not found. = theme not found.
+# The line-ending, indentation, and positional buffer information shown in the
+# statusbar.
 CRLF = CRLF
 LF = LF
 Tabs: = Tabs:
 Spaces: = Spaces:
 Line: = Line:
 Col: = Col:
+# The statusbar text shown when the user resets Textadept's internal Lua state.
+Lua reset = Lua reset
+# The text displayed in a dialog when the user attempts to quit Textadept with
+# unsaved changes in open buffers.
 Quit without saving? = Quit without saving?
 The following buffers are unsaved: = The following buffers are unsaved:
 Quit _without saving = Quit _without saving
-Lua reset = Lua reset
-
-# core/keys.lua
-Keychain: = Keychain:
-Invalid sequence = Invalid sequence
 
-# modules/textadept/bookmarks.lua
+# [modules/textadept/bookmarks.lua]
+# The text displayed in the dialog for selecting a bookmark to jump to.
 Select Bookmark = Select Bookmark
 Bookmark = Bookmark
 
-# modules/textadept/editing.lua
+# [modules/textadept/editing.lua]
+# The text displayed in the dialog for jumping to a particular line.
 Go To = Go To
 Line Number: = Line Number:
-#_OK = _OK
-#_Cancel = _Cancel
 
-# modules/textadept/find.lua
+# [modules/textadept/find.lua]
+# The text displayed in the GUI find & replace pane.
 _Find: = _Find:
 R_eplace: = R_eplace:
 Find _Next = Find _Next
@@ -77,22 +99,8 @@ _Match case = _Match case
 _Whole word = _Whole word
 Rege_x = Rege_x
 _In files = _In files
-Find in Files = Find in Files
+# The text displayed in the terminal version's find & replace pane.
 Find: = Find:
-No results found = No results found
-[Files Found Buffer] = [Files Found Buffer]
-Binary file matches. = Binary file matches.
-Search wrapped = Search wrapped
-Continue? = Continue?
-Still searching in files... Continue waiting? = Still searching in files... Continue waiting?
-Find in Files aborted = Find in Files aborted
-Error = Error
-An error occurred: = An error occurred:
-#_OK = _OK
-#_Cancel = _Cancel
-replacement(s) made = replacement(s) made
-# For curses:
-#Find: = Find:
 Replace: = Replace:
 [Next] = [Next]
 [Prev] = [Prev]
@@ -102,13 +110,30 @@ Case(F1) = Case(F1)
 Word(F2) = Word(F2)
 Regex(F3) = Regex(F3)
 Files(F4) = Files(F4)
+# The statusbar text shown when a search has wrapped back to the beginning of
+# the buffer.
+Search wrapped = Search wrapped
+# The statusbar text shown when the text to search for was not found.
+No results found = No results found
+# The title of the dialog for selecting files to search in.
+Find in Files = Find in Files
+# The name of the buffer Textadept prints "Find in Files" results to.
+[Files Found Buffer] = [Files Found Buffer]
+# The "Find in Files" result for text found in a binary file. This result is
+# shown in place of binary buffer text.
+Binary file matches. = Binary file matches.
+# The text displayed in a dialog when the user is prompted to continue a "Find
+# in Files" search that has taken longer than X seconds to complete.
+Continue? = Continue?
+Still searching in files... Continue waiting? = Still searching in files... Continue waiting?
+# The message displayed when a "Find in Files" search is aborted by the user.
+Find in Files aborted = Find in Files aborted
+# The statusbar text shown after performing a "Replace All".
+replacement(s) made = replacement(s) made
 
-# modules/textadept/keys.lua
-Lexer = Lexer
-Style = Style
-Error loading webpage: = Error loading webpage:
-
-# modules/textadept/menu.lua
+# [modules/textadept/menu.lua]
+# Typical "File" menu items for creating new files, opening, saving, and closing
+# existing files, opening and saving sessions, and quitting Textadept.
 _File = _File
 _New = _New
 _Open = _Open
@@ -122,6 +147,7 @@ Close All = Close All
 Loa_d Session... = Loa_d Session...
 Sav_e Session... = Sav_e Session...
 _Quit = _Quit
+# Typical "Edit" menu items for manipulating buffer text and source code.
 _Edit = _Edit
 _Undo = _Undo
 _Redo = _Redo
@@ -138,7 +164,10 @@ _Highlight Word = _Highlight Word
 Toggle _Block Comment = Toggle _Block Comment
 T_ranspose Characters = T_ranspose Characters
 _Join Lines = _Join Lines
+# The menu item for filtering text through a shell command and replacing input
+# text with that command's output text.
 _Filter Through = _Filter Through
+# Menu items for selecting text and entities.
 _Select = _Select
 Select to _Matching Brace = Select to _Matching Brace
 Select between _XML Tags = Select between _XML Tags
@@ -151,6 +180,7 @@ Select in B_races = Select in B_races
 Select _Word = Select _Word
 Select _Line = Select _Line
 Select Para_graph = Select Para_graph
+# Menu items for transforming selected text.
 Selectio_n = Selectio_n
 _Upper Case Selection = _Upper Case Selection
 _Lower Case Selection = _Lower Case Selection
@@ -163,53 +193,79 @@ Enclose in _Brackets = Enclose in _Brackets
 Enclose in B_races = Enclose in B_races
 _Move Selected Lines Up = _Move Selected Lines Up
 Move Selected Lines Do_wn = Move Selected Lines Do_wn
+# Menu items for searching and replacing text within buffers and files.
 _Search = _Search
 _Find = _Find
-#Find _Next = Find _Next
 Find _Previous = Find _Previous
-#_Replace = _Replace
-#Replace _All = Replace _All
 Find _Incremental = Find _Incremental
 Find in Fi_les = Find in Fi_les
 Goto Nex_t File Found = Goto Nex_t File Found
 Goto Previou_s File Found = Goto Previou_s File Found
+# Menu item for jumping to a specific line in a buffer.
 _Jump to = _Jump to
+# Menu items for various tools and utilities for editing and working with source
+# code.
 _Tools = _Tools
+# Menu item for opening Textadept's Lua command entry.
 Command _Entry = Command _Entry
+# Menu item for selecting a menu command to run.
 Select Co_mmand = Select Co_mmand
+# Menu items for running or compiling the current source file.
 _Run = _Run
 _Compile = _Compile
+# Menu item for setting command line arguments for run and compile commands.
 Set _Arguments... = Set _Arguments...
+# The text displayed in the dialog for specifying command line arguments for run
+# and compile commands.
 Command line arguments = Command line arguments
 For Run: = For Run:
 For Compile: = For Compile:
+# Menu item for building the current project.
 Buil_d = Buil_d
+# Menu item for stopping a run, compile, or build shell command.
 S_top = S_top
+# Menu items for navigating through recognized shell command errors.
 _Next Error = _Next Error
 _Previous Error = _Previous Error
-_Complete Symbol = _Complete Symbol
-Show _Documentation = Show _Documentation
+# Menu items for working with bookmarked lines in buffers.
 _Bookmark = _Bookmark
 _Toggle Bookmark = _Toggle Bookmark
 _Clear Bookmarks = _Clear Bookmarks
 _Next Bookmark = _Next Bookmark
 _Previous Bookmark = _Previous Bookmark
 _Goto Bookmark... = _Goto Bookmark...
+# Menu items for launching a quick open dialog in order to open files in certain
+# directories. A quick open dialog lists all files in a directory and its
+# subdirectories and filters the list down as the user types.
 Quick _Open = Quick _Open
 Quickly Open _User Home = Quickly Open _User Home
 Quickly Open _Textadept Home = Quickly Open _Textadept Home
 Quickly Open _Current Directory = Quickly Open _Current Directory
 Quickly Open Current _Project = Quickly Open Current _Project
+# Menu items for working with snippets, insert-able pieces of code that act like
+# templates with placeholders for user input.
 _Snippets = _Snippets
 _Insert Snippet... = _Insert Snippet...
 _Expand Snippet/Next Placeholder = _Expand Snippet/Next Placeholder
 _Previous Snippet Placeholder = _Previous Snippet Placeholder
 _Cancel Snippet = _Cancel Snippet
+# Menu items for auto-completing programming language symbols and showing
+# documentation for them (e.g. typing `textadept.editing.` followed by a
+# "Complete Symbol" would show all possible completions for that symbol).
+_Complete Symbol = _Complete Symbol
+Show _Documentation = Show _Documentation
+# Menu item for inspecting the character under the caret. The character's byte
+# information, the lexer used to syntax-highlight that character, and the
+# character's lexical style (e.g. string, comment, number, etc.) are shown.
 Show St_yle = Show St_yle
+Lexer = Lexer
+Style = Style
+# Menu items for navigating between open buffers.
 _Buffer = _Buffer
 _Next Buffer = _Next Buffer
 _Previous Buffer = _Previous Buffer
 _Switch to Buffer... = _Switch to Buffer...
+# Menu items for changing the indentation settings for the current buffer.
 _Indentation = _Indentation
 Tab width: _2 = Tab width: _2
 Tab width: _3 = Tab width: _3
@@ -217,17 +273,25 @@ Tab width: _4 = Tab width: _4
 Tab width: _8 = Tab width: _8
 _Toggle Use Tabs = _Toggle Use Tabs
 _Convert Indentation = _Convert Indentation
+# Menu item for changing the end-of-line mode for the current buffer.
 _EOL Mode = _EOL Mode
-#CRLF = CRLF
-#LF = LF
+# Menu items for changing the encoding of the current buffer's text.
 E_ncoding = E_ncoding
 _UTF-8 Encoding = _UTF-8 Encoding
 _ASCII Encoding = _ASCII Encoding
 _ISO-8859-1 Encoding = _ISO-8859-1 Encoding
 _MacRoman Encoding = _MacRoman Encoding
 UTF-1_6 Encoding = UTF-1_6 Encoding
+# Menu items for changing the way the current buffer is displayed.
+Toggle View _EOL = Toggle View _EOL
+Toggle _Wrap Mode = Toggle _Wrap Mode
+Toggle View White_space = Toggle View White_space
+# Menu items for changing and refreshing the syntax-highlighting language for
+# the current buffer.
 Select _Lexer... = Select _Lexer...
 _Refresh Syntax Highlighting = _Refresh Syntax Highlighting
+# Menu items for navigating between views, splitting them, closing them, and
+# resizing them.
 _View = _View
 _Next View = _Next View
 _Previous View = _Previous View
@@ -237,46 +301,51 @@ _Unsplit View = _Unsplit View
 Unsplit _All Views = Unsplit _All Views
 _Grow View = _Grow View
 Shrin_k View = Shrin_k View
+# Menu item for folding (showing/hiding) the block of code the starts on the
+# current line. Fold-able blocks of code are typically classes, functions, and
+# control structures.
 Toggle Current _Fold = Toggle Current _Fold
-Toggle View _EOL = Toggle View _EOL
-Toggle _Wrap Mode = Toggle _Wrap Mode
+# Menu item for showing line indentation markers.
 Toggle Show In_dent Guides = Toggle Show In_dent Guides
-Toggle View White_space = Toggle View White_space
+# Menu item for allowing the caret to move beyond line ends and into "virtual
+# space".
 Toggle _Virtual Space = Toggle _Virtual Space
+# Menu items for changing the zoom factor of displayed buffer text.
 Zoom _In = Zoom _In
 Zoom _Out = Zoom _Out
 _Reset Zoom = _Reset Zoom
+# Menu items for getting help on Textadept and its Lua API documentation.
 _Help = _Help
 Show _Manual = Show _Manual
 Show _LuaDoc = Show _LuaDoc
 _About = _About
+# The error message displayed when activating a menu item associated with an
+# unknown command.
+Unknown command: = Unknown command:
+# The text displayed in the dialog for running an arbitrary menu command. Any
+# key binding associated with commands are also shown.
+Run Command = Run Command
 Command = Command
 Key Command = Key Command
-Run Command = Run Command
-Unknown command: = Unknown command:
 
-# modules/textadept/mime_types.lua
+# [modules/textadept/file_types.lua]
+# The title of the dialog for selecting a lexer for the current buffer. Lexers
+# perform syntax highlighting of source code.
 Select Lexer = Select Lexer
-#Name = Name
-
-# modules/textadept/run.lua
-does not exist = does not exist
 
-# modules/textadept/session.lua
+# [modules/textadept/session.lua]
+# The title of the dialog for selecting a session file to load.
+Load Session = Load Session
+# The text displayed in a dialog when files in a loaded session were not found.
 Session Files Not Found = Session Files Not Found
 The following session files were not found = The following session files were not found
-#_OK = _OK
-Load Session = Load Session
+# The title of the dialog for selecting a session file to save.
 Save Session = Save Session
 
-# modules/textadept/snapopen.lua
-File Limit Exceeded = File Limit Exceeded
-files or more were found. Showing the first = files or more were found. Showing the first
-#_OK = _OK
-#Open = Open
-#File = File
-
-# modules/textadept/snippets.lua
+# [modules/textadept/snippets.lua]
+# The text displayed in the dialog for selecting a snippet to insert. Snippets
+# have a trigger word (pressing the "Tab" key after that word inserts the
+# snippet) and snippet text.
 Select Snippet = Select Snippet
 Trigger = Trigger
 Snippet Text = Snippet Text