+ upd: Readme.md and Changes.txt

This commit is contained in:
Pairi Daiza 2020-08-21 15:02:04 +02:00
parent 2bf7368af9
commit 44813cef86
2 changed files with 50 additions and 65 deletions

View File

@ -59,6 +59,7 @@ NEW:
CHANGES:
-----------------------------------------------------
[.###.#]-
[.821.1]- Bookmark context menu on alpha-blend FocusedView marker line.
[.821.1]- Convenient message box text for normalizing EOLs.
[.817.2]- grepWinNP3 and minipath: special dialog box UI fonts for Asian languages.
[.816.1]- Use optimized Asian UI fonts for Notepad3 dialog boxes.

114
Readme.md
View File

@ -92,7 +92,7 @@ Press Ctrl+F7 to open the Notepad3 ini-file. Most changes only take effect upon
#### `PreferredLanguageLocaleName=en-US`
The default value for the already supported languages is defined by the: “OS language setting”.
The fallback is: “en-US”.
- The fallback is: “en-US”.
##### Available languages:
@ -186,14 +186,11 @@ This items are managed by Notepad3. (`Menu->View->Position->Save as Default Posi
#### `filebrowser.exe=minipath.exe`
Specify the path of an external program that is launched when pressing the Browse toolbar
button. Defaults to `minipath.exe`, which is the file browser plugin. You can specify
additional command line switches, and the file currently opened in Notepad3 will be
appended as the last command line parameter.
Specify the path of an external program that is launched when pressing the Browse toolbar button.
Defaults to `minipath.exe`, which is the file browser plugin.
You can specify additional command line switches, and the file currently opened in Notepad3 will be appended as the last command line parameter.
Note: Due to special treatment of quotes by the Win32 ini-file APIs, pathnames with spaces
need to be quadruple-quoted (""path to/file.exe""), but only double-quoted if there's
additional command line arguments ("path to/file.exe" /arg).
Note: Due to special treatment of quotes by the Win32 ini-file APIs, pathnames with spaces need to be quadruple-quoted (""path to/file.exe""), but only double-quoted if there's additional command line arguments ("path to/file.exe" /arg).
On the other hand, our preferred file browser is MiniPath.exe (Menu->File->Browse... Ctrl+M) + Toolbar-Button.
If you don't like it, you can configure e.g.
@ -204,41 +201,38 @@ If you don't like it, you can configure e.g.
#### `grepWin.exe=grepWinNP3.exe`
We have integred of a Powerful External Tool called "grepWinNP3"
"grepWinNP3" is a simple search and replace tool which can use regular expressions to do its job.
We have integrated of a Powerful External Tool called **grepWinNP3**.
**grepWinNP3** is a simple search and replace tool which can use regular expressions to do its job.
This allows to do much more powerful searches and replaces in Files.
grepWinNP3 can be launched from "File --> Launch --> Search in Files"
or from "Edit --> Search --> Search in Files"
or simply with "Ctrl+Shift+F"
**grepWinNP3** can be launched:
- from "File --> Launch --> Search in Files"
- or from "Edit --> Search --> Search in Files"
- or simply with "`Ctrl+Shift+F`"
#### `FileCheckInverval=2000`
The interval (in milliseconds) to check for external modification of the currently
opened file. Defaults to 2000 ms.
The interval (in milliseconds) to check for external modification of the currently opened file.
- Defaults is 2000 ms.
#### `FileDlgFilters=`
Specify filters for the open and save dialogs
(Example: `Text Files|*.txt;*.wtx;*.log;*.asc;*.doc;*.diz;*.nfo|All Files|*.*`).
- (Example: `Text Files|*.txt;*.wtx;*.log;*.asc;*.doc;*.diz;*.nfo|All Files|*.*`).
#### `FileLoadWarningMB=64`
The size limit, in megabytes, to display a warning message for large files.
A value of 0 disables the warning.
- A value of 0 disables the warning.
#### `MarkOccurrencesMaxCount=2000`
This parameter limits the number of occurrences compted and displayed in Status Bar in
“Section 5 = Occ : Number of Marked Occurrences” (to display more than 2000 occurrences
changes this parameter in the ini file.
This parameter limits the number of occurrences counted and displayed in Status Bar in “Section 5 = Occ : Number of Marked Occurrences” (to display more than 2000 occurrences changes this parameter in the ini file.
#### `MultiFileArg=0`
Control if Notepad2 should allow multiple files on the command line (set to 1).
The default behavior is to accept only a single file, without quoted spaces,
like Windows Notepad (set to 0).
The command line switches + and - can be used to override this setting on the fly,
and the /z command-line switch has the same effect as the - switch.
The default behavior is to accept only a single file, without quoted spaces, like Windows Notepad (set to 0).
The command line switches + and - can be used to override this setting on the fly, and the /z command-line switch has the same effect as the - switch.
#### `NoCGIGuess=0`
@ -262,9 +256,7 @@ Set to 1 to disable fading of hidden objects in file lists (such as Favorites, e
Encoding tag parsing can be disabled in the Menu ? File ? Encoding ? Default dialog box.
Notepad3 can parse a few of the Emacs variables that can be used in source code files.
The first 512 bytes of a file (and, if nothing is found, also the last 512 bytes) are
checked for the following constructs (can be manually disabled in the ini-file, or
the File, Encoding, Default dialog box, respectively):
The first 512 bytes of a file (and, if nothing is found, also the last 512 bytes) are checked for the following constructs (can be manually disabled in the ini-file, or the File, Encoding, Default dialog box, respectively):
```
coding: utf-8;
mode: python;
@ -301,12 +293,10 @@ Set to 1 to disable simple HTML/XML detection for files without extensions.
#### `PortableMyDocs=1`
If set to 1, recent files and other path settings referring to the `My Documents` directory
tree are stored relative to `My Documents`. This enhances USB stick portability between
different versions of Windows, which are using different locations for `My Documents`.
This setting has no effect if Notepad3.exe itself is located inside `My Documents`
(or a sub-directory thereof).
The default is 1 (enabled) if `RelativeFileMRU` is enabled, and 0 (disabled) otherwise.
If set to 1, recent files and other path settings referring to the `My Documents` directory tree are stored relative to `My Documents`.
This enhances USB stick portability between different versions of Windows, which are using different locations for `My Documents`.
This setting has no effect if Notepad3.exe itself is located inside `My Documents` (or a sub-directory thereof).
- The default is 1 (enabled) if `RelativeFileMRU` is enabled, and 0 (disabled) otherwise.
#### `OpacityLevel=75`
@ -318,8 +308,8 @@ Opacity level (in %) of the Find/Replace window in transparent mode.
#### `RelativeFileMRU=1`
Set to 0 to disable recent files on the same drive or network share as Notepad3.exe being
saved with relative path-names. The default is 1 (enabled).
Set to 0 to disable recent files on the same drive or network share as Notepad3.exe being saved with relative path-names.
- The default is 1 (enabled).
#### `ReuseWindow=0`
@ -340,23 +330,18 @@ This items are managed by Notepad3.
#### `ShellUseSystemMRU=1`
Application User Model IDs (AppUserModelIDs) are used extensively by the taskbar in Windows 7
and later systems to associate processes, files, and windows with a particular application.
In some cases, it is sufficient to rely on the internal AppUserModelID assigned to a process
by the system. However, an application that owns multiple processes or an application that is
running in a host process might need to explicitly identify itself so that it can group its
otherwise disparate windows under a single taskbar button and control the contents of that
application's Jump List.
Most recently used (MRU) source lists are resident on the user's computer and contain
information about source paths used in previous installations.
This information can be used when prompting the user for a source path.
Application User Model IDs (AppUserModelIDs) are used extensively by the taskbar in Windows 7 and later systems to associate processes, files, and windows with a particular application.
In some cases, it is sufficient to rely on the internal AppUserModelID assigned to a process by the system.
However, an application that owns multiple processes or an application that is running in a host process might need to explicitly identify itself so that it can group its otherwise disparate windows under a single taskbar button and control the contents of that application's Jump List.
Most recently used (MRU) source lists are resident on the user's computer and contain information about source paths used in previous installations.
This information can be used when prompting the user for a source path.
Control system MRU, task-bar and jump list behavior.
See Replacing Windows Notepad for detailed explanations.
#### `StickyWindowPosition=0`
This items are managed by Notepad3. (`Menu->View->Position->Sticky Window Position`)
(Will remember current window position on restart, instead of last closed position (save on exit))
This items are managed by Notepad3.
- `Menu->View->Position->Sticky Window Position` (Will remember current window position on restart, instead of last closed position (save on exit))
#### `UseOldStyleBraceMatching=0`
@ -373,21 +358,20 @@ Put in here all ASCII chars which should be word delimiter in case of "Accelerat
#### `AutoCompleteWordCharSet=`
Is set automatically for CJK input languages (GetACP()).
If you define your own character-set in AutoCompleteWordCharSet,
Auto-Completion word list is limited to words composed of these chars only (case insensitive).)
If you define your own character-set in AutoCompleteWordCharSet, Auto-Completion word list is limited to words composed of these chars only (case insensitive).)
#### `AutoCompleteFillUpChars=`
New configuration .ini-file: [Settings2] AutoCompleteFillUpChars=
To get the "Enter" completion behavior back, define: [Settings2] AutoCompleteFillUpChars=\r\n
I you like to allow more "fill-up" characters (accept completion item), just add them:
e.g. [Settings2] AutoCompleteFillUpChars=\r\n[(. (will accept completion item & adds the char).
- e.g. [Settings2] AutoCompleteFillUpChars=\r\n[(. (will accept completion item & adds the char).
#### `LineCommentPostfixStrg=`
It will be appended/removed to the comment tag on line comment block toggle.
If the string contains spaces, you have to double-quote it,
e.g. [Settings2] LineCommentPostfixStrg=" " to add a space after the comment tag (origin and title of this feature request).
- e.g. [Settings2] LineCommentPostfixStrg=" " to add a space after the comment tag (origin and title of this feature request).
#### `UpdateDelayMarkAllOccurrences=50`
@ -420,15 +404,15 @@ The # (hash) is the start of a line comment in MySQL dialect.
But if this is confusing, it can be switched off by providing an option to Scintilla's SQL-Lexer
(set option: lexer.sql.numbersign.comment to 0 (zero)).
Unfortunately, in Notepad3, this can not be done by configuration, it can only be done hard coded.
Ed.: The default is "OFF", it is set to "ON" explicitly in Notepad3 (hard coded) to preserve old behavior,
- Ed.: The default is "OFF", it is set to "ON" explicitly in Notepad3 (hard coded) to preserve old behavior,
#### `ExitOnESCSkipLevel=2`
The leveling of ESC behavior (msg-boxes -> selection -> exit) leads to following implementation:
New parameter "[Settings2] ExitOnESCSkipLevel = 2"
Level 2 : ESC cancels every single state separately (the default).
Level 1 : ESC cancels message-box and ignores Selection.
Level 0 : ESC cancels all states and proceeds to Exit (if configured).
- Level 2 : ESC cancels every single state separately (the default).
- Level 1 : ESC cancels message-box and ignores Selection.
- Level 0 : ESC cancels all states and proceeds to Exit (if configured).
#### `ZoomTooltipTimeout=3200`
@ -440,9 +424,9 @@ A value of zero (0) (or less than 100 ms) will disable the Tooltip display.
#### `FocusViewMarkerMode=1`
0 = OFF
1 = STD (the default), (if Bookmark-Margin is shown, use marker symbol - if hidden, use alpha-blend color line background)
2 = NO_MARGIN (use alpha-blend color line background regardless if BM-Margin is shown or hidden)
- 0 = OFF
- 1 = STD (the default), (if Bookmark-Margin is shown, use marker symbol - if hidden, use alpha-blend color line background)
- 2 = NO_MARGIN (use alpha-blend color line background regardless if BM-Margin is shown or hidden)
## **`[Statusbar Settings]`**
@ -476,22 +460,22 @@ If used, this setting also defines the field ordering.
#### `SectionPrefixes=Ln ,Col ,Sel ,Sb ,SLn ,Occ ,,,,,,,Ch ,Repl ,Eval ,` (internal default)
This parameter is used to redefines the displayed Prefixes in the sections of the Status Bar
A “,” (comma) is used as separator. Spaces are NOT ignored.
- A “,” (comma) is used as separator. Spaces are **NOT** ignored.
#### `SectionPostfixes=,,,,,,,,,,,,,,,` (internal default)
This parameter is used to redefines the displayed Postfixes in the sections of the Status Bar
A “,” (comma) is used as separator. Spaces are **NOT** ignored.
- A “,” (comma) is used as separator. Spaces are **NOT** ignored.
#### `SectionWidthSpecs=30 20 20 20 20 20 0 0 0 0 0 0 20 20 20` (internal default)
This parameter is used to define the relative width of each field of the Status Bar
0 = space optimized fit to text (dynamically adapted to width changes)
-n (neg. val) = fixed width of section [pix] , longer text is truncated
- 0 = space optimized fit to text (dynamically adapted to width changes)
- -n (neg. val) = fixed width of section [pix] , longer text is truncated
Fine tuning: increase, decrease or modify the value of numbers, e.g.:
`;;;;;;;;;;;;;;;;; 0 1 2 3 4 5 6 7 8 9 10 11 12 13 14`
`SectionWidthSpecs=50 40 42 40 36 40 0 0 0 0 0 -10 40 40 -40`
Fine tuning: increase, decrease or modify the value of numbers,
- e.g.: `;;;;;;;;;;;;;;;;; 0 1 2 3 4 5 6 7 8 9 10 11 12 13 14`
- `SectionWidthSpecs=50 40 42 40 36 40 0 0 0 0 0 -10 40 40 -40`
#### `ZeroBasedColumnIndex=0`