Update Manual for changes made in v8.8.9-v8.9

Author: pryrt

content/_index.md

@@ -6,7 +6,7 @@ type: docs
 Notepad++ User Manual
 =======
 
-This **Notepad++ User Manual** describes the Notepad++ application v8.x (currently up to v8.8.8).
+This **Notepad++ User Manual** describes the Notepad++ application v8.x (currently up to v8.9).
 
 The documentation is built collaboratively, and [your contribution is very welcome](https://github.com/notepad-plus-plus/npp-usermanual), following our [contribution guidelines](https://github.com/notepad-plus-plus/npp-usermanual/blob/master/CONTRIBUTION.md).
 

content/docs/command-prompt.md

@@ -241,3 +241,4 @@ It also implements additional Notepad++\-specific options:
 
 Starting with v8.8.8, there is an MSI version of the installer as well.  It is intended for IT departments to deploy Notepad++ across an organization.  Microsoft documents command-line options that can be used to influence MSI installation using [short-name options](https://learn.microsoft.com/en-us/windows/win32/msi/command-line-options) and [long-name options](https://learn.microsoft.com/en-us/windows/win32/msi/standard-installer-command-line-options).
 
+Notepad++'s MSI installer allows the `NOUPDATER` and `REBOOT` variables that can be passed in to the `msiexec` execution of the MSI, such as `msiexec /i Notepad++.msi NOUPDATER=1` ([*](https://community.notepad-plus-plus.org/post/103948 "see reference")).

content/docs/config-files.md

@@ -509,6 +509,13 @@ You can have multiple icon set directories; to switch between icon sets, you jus
     - After this file is created, Notepad++ won't check any more whether `shortcuts.xml` has been updated
     - See [v8.5.3 `shortcuts.xml` updates](#v8-5-3-shortcuts-xml-updates) (above) and this Notepad++ Community [FAQ entry](https://community.notepad-plus-plus.org/topic/24464/faq-desk-v8-5-3-and-newer-macros-and-run-menu-commands) for more details
 
+### Logfiles
+
+Notepad++ doesn't normally create logfiles.  However, there are some circumstances when it does:
+- As described above, if `nppLogNulContentCorruptionIssue.xml` exists, then the logfile `%AppData%\Notepad++\nppLogNulContentCorruptionIssue.log` will be created during crash events. (New to v8.1.9.3.)
+- As described above, if `nppLogNetworkDriveIssue.xml` exists, then `c:\temp\nppLogNetworkDriveIssue.log` will be created during certain network drive issues. (New to v8.1.9.3.)
+- Starting in v8.9, security errors will be automatically logged to `%LOCALAPPDATA%\Notepad++\log\securityError.log`.
+
 ## Validating Config-File XML
 
 If you are developing a config file by editing the raw XML file and would like to be able to validate that you have correct XML syntax while you are doing so, you can see the instructions in the [Notepad++ Community "Validating Config-File XML" FAQ](https://community.notepad-plus-plus.org/topic/24136/faq-desk-validating-config-file-xml "Community Forum FAQ: Validating Config-File XML").

content/docs/editing.md

@@ -351,6 +351,7 @@ Below the **Begin/End Select** entries, there are a number of sub-menus to the *
                 because integers prefixed by spaces come before integers without spaces (because spaces are lexicographically earlier than digits; in this example, that means `1000` is last, because it had no space prefix), but integers prefixed with one space will be sorted before integers prefixed with two spaces.
         * **As Decimals (Comma)** means it will recognize `10,234` and `9,876` as decimal numbers and sort them numerically
         * **As Decimals (Dot)** means it will recognize `10.234` and `9.876` as decimal numbers and sort them numerically
+        * **By Length** means it will sort by line length (number of characters in the line) (new to v8.8.9)
         * NOTE: Except for **Locale** sorts, which do not impose this restriction, sorting is performed with the assumption that all line-endings in the file are uniform and match the current selection for the file being edited -- the quickest way to check that selection is to glance at the status bar, where the current line-ending type is shown either as `Windows (CR LF)`, `Unix (LF)` or `Macintosh (CR)`.  It might be desirable to check the line-ending types in your file before executing a sorting operation, and use the **Edit > EOL Conversion >** choices or right-click on the Status Bar's EOL indicator to fix the line endings if necessary.
         * NOTE: If a [Column Mode](./#selection-modes-column-editor) selection is active, the sort will re-order all the lines included in the selection, but the sort key (the text that decides the sort order) will be limited to what is inside the column selection. If the column selection is zero-width (that is, it contains no text, consisting only of a caret extending through multiple lines), the sort key for each line begins with the character to the right of the caret in that line and extends to the end of the line. This column-selection-based sort will be a "stable sort": if the keys are identical on two lines, then the order of those two lines will not change, even if text outside of the selected key columns is different. Except for **Locale** sorts, which do not impose this restriction, column selections will not always work as expected if the text within or to the left of the selection contains tab characters, characters comprised of varying numbers of bytes (such as non-ASCII characters in Unicode documents), or characters of varying widths (such as when a proportional font is in use).
         * NOTE: **Locale** sorts are based on the current user locale (and preferred sort order, for locales which support more than one), which can be set in the **Region** applet in Windows **Control Panel**. Most users will never need to change those settings, but some multi-lingual users might find that different settings are required when working in different languages. There is no need to close Notepad++ after changing the user locale: the new locale takes effect immediately upon being saved in the Windows dialog. **Locale** sorts are stable sorts which use the user locale and the NORM_LINGUISTIC_CASING, LINGUISTIC_IGNORECASE and SORT_DIGITSASNUMBERS flags described for [LCMapStringEx](https://learn.microsoft.com/en-us/windows/win32/api/winnls/nf-winnls-lcmapstringex) to generate sort keys.

content/docs/getting-started.md

@@ -61,9 +61,11 @@ When Notepad++ is placed in "Program Files" (whether through the installer or th
 
 ## Notepad++ Self-Signed Certificate Authority for Binaries
 
-Notepad++ has always had difficulty getting a Certificate Authority to issue a code-signing certificate to "Notepad++" instead of to an individual, since Notepad++ was not a registered business.  In the lead-up to [v8.8.2 release](https://notepad-plus-plus.org/news/8.8.2-available-in-1-week-without-certificate/), Don was unable to get a signing certificate for "Notepad++", so v8.8.2 was released unsigned.  However, having the installer and executables and DLLs unsigned causes issues with installing Notepad++, and many virus scanners will give a "false positive" virus warning because of the missing signature.  As of v8.8.7, the Notepad++ association has been registered with the appropriate government body, and GlobalSign has issued a certificate for Notepad++; from v8.8.7 onward,  Notepad++ is signed with both the GlobalSign-issued signing certificate as well as the self-signed certificate.
+Notepad++ has always had difficulty getting a Certificate Authority to issue a code-signing certificate to "Notepad++" instead of to an individual, since Notepad++ was not a registered business.  In the lead-up to [v8.8.2 release](https://notepad-plus-plus.org/news/8.8.2-available-in-1-week-without-certificate/), Don was unable to get a signing certificate for "Notepad++", so v8.8.2 was released unsigned.  However, having the installer and executables and DLLs unsigned causes issues with installing Notepad++, and many virus scanners will give a "false positive" virus warning because of the missing signature.  As of v8.8.7, the Notepad++ association has been registered with the appropriate government body, and GlobalSign has issued a certificate for Notepad++; from v8.8.7 through 8.8.9, Notepad++ is signed with both the GlobalSign-issued signing certificate as well as the self-signed certificate; from v8.9 onward, Notepad++ is only signed with the GlobalSign-issued certificate.
 
-As a result of the period of not being able to have an externally-signed certificate, Notepad++ has a self-signed Root Certificate Authority (CA) certificate.  Starting with v8.8.3, this Root CA certificate is used to create a signing certificate for Notepad++'s installer and other binaries (and starting with v8.8.7, such binaries are double-signed, with both the GlobalSign and self-signed signatures). Since the self-signed certificate is not one of the "traditional" Certificate Authority entities, the Notepad++ Root CA certificate is not already included in your Windows installation, unlike the "big name" authorities.
+As a result of the period of not being able to have an externally-signed certificate, Notepad++ has a self-signed Root Certificate Authority (CA) certificate.  From v8.8.3 - v8.8.9, this Root CA certificate is used to create a signing certificate for Notepad++'s installer and other binaries (and starting with v8.8.7, such binaries are double-signed, with both the GlobalSign and self-signed signatures). Since the self-signed certificate is not one of the "traditional" Certificate Authority entities, the Notepad++ Root CA certificate is not already included in your Windows installation, unlike the "big name" authorities.
+
+Security experts recommend _not_ adding the root certificate described below.  However, if you are dealing with binaries from v8.8.3 - v8.8.9, you may evaluate whether verifying the signature or not changing your root certificates is the "more secure" choice.
 
 Assuming you trust the download connection, and trust Notepad++ to correctly issue signing certificates to itself for signing Notepad++ binaries, the following instructions can be followed so that your computer is made aware that signatures coming from the Notepad++ Root CA are valid:
 1. Download the x509 CA root certificate from https://notepad-plus-plus.org/nppRoot.crt

content/docs/themes.md

@@ -33,8 +33,12 @@ Aside from the Themes that ship with Notepad++ when you install it, there is als
 
 ## Keeping Stylers/Themes Up-To-Date
 
+Starting in v8.8.9, Notepad++ will propagate new Languages and new styles inside existing languages from the model file into your active Theme file.  In v8.8.9, it will always use the color from the model file (so the default light-mode theme color) for added styles; in v8.9 and beyond, it will use the light-mode color from the model file if your active theme is stylers.xml, otherwise it will use the default foreground and background colors from your active theme.  (If v8.8.9 updated your dark theme already, and you find the results too jarring, the Community Forum has a [FAQ](https://community.notepad-plus-plus.org/topic/27306/faq-themes-in-v8-8-9) explaining how to fix it.  That FAQ is not needed if you never ran v8.8.9, or if you were just using stylers.xml and not one of the Themes.)
+
+### Before Notepad++ v8.8.9
+
 When you install/update Notepad++, the installer will populate `<installation_dir>\Themes\*.xml` with the most recent copies of the standard Themes, and will overwrite the `<installation_dir>\stylers.model.xml` to make sure that the source of the default theme contains all the appropriate [syntax-highlighting languages](../programming-languages/) and all the most-recent general interface styles in Style Configurator's [**Global Styles**](../preferences/#global-styles).  
 
 However, except for a new installation (where you don't already have `%AppData%\Notepad++\stylers.xml`), your copy of the the default theme and any themes you have in the `%AppData%\Notepad++\Themes` will _not_ be updated or overwritten (because the Developer doesn't want you to lose any customizations).  If you use the default theme, and have not customized any styles in the Style Configurator, then the easiest way to update the default theme is to exit Notepad++, delete `%AppData%\Notepad++\stylers.xml`, and restart Notepad++, which will recreate your `stylers.xml` from the most-recent `stylers.model.xml`; however, if you had any Style Configurator customizations (including colors, fonts, or per-language user-defined extensions or user-defined keywords), they _will_ be lost if you delete `stylers.xml`.
 
-When a new version of Notepad++ is released, the Developer ensures `stylers.model.xml` and `Themes\DarkModeDefault.xml` are up-to-date, but the Developer relies on volunteers to submit PR to update the other themes, so many of them can be missing languages or specific styles.  So if you want to update a Theme that's missing languages or specific styles, or if you want to edit `stylers.xml` without losing any of your customizations, then you will want to open up your `stylers.xml` or other theme's XML simultaneously with `stylers.model.xml`; you can then go section-by-section and line-by-line (the ComparePlug plugin could be helpful for this), and copy over any of the `<LexerType...>` sections that don't exist in yours (note they may be in a different order), or any `<WordsStyle...>` missing from a `<LexerType...>` or any `<WidgetStyle...>` that is missing from your `<GlobalStyles>` section.  This can be a tedious process, so if you're willing to install the PythonScript plugin, you can find a script in the Notepad++ Community Forum's "[Config Files Need Updating, Too](https://community.notepad-plus-plus.org/topic/26049/config-files-need-updating-too)" post, which will automate the process of keeping your themes (and default language keywords) up-to-date.
+When a new version of Notepad++ is released, the Developer ensures `stylers.model.xml` and `Themes\DarkModeDefault.xml` are up-to-date, but the Developer relies on volunteers to submit PR to update the other themes, so many of them can be missing languages or specific styles.  So if you want to update a Theme that's missing languages or specific styles, or if you want to edit `stylers.xml` without losing any of your customizations, then you will want to open up your `stylers.xml` or other theme's XML simultaneously with `stylers.model.xml`; you can then go section-by-section and line-by-line (the ComparePlus plugin could be helpful for this), and copy over any of the `<LexerType...>` sections that don't exist in yours (note they may be in a different order), or any `<WordsStyle...>` missing from a `<LexerType...>` or any `<WidgetStyle...>` that is missing from your `<GlobalStyles>` section.  This can be a tedious process, so if you're willing to install the PythonScript plugin, you can find a script in the Notepad++ Community Forum's "[Config Files Need Updating, Too](https://community.notepad-plus-plus.org/topic/26049/config-files-need-updating-too)" post (or, alternatively, a standalone plugin that does it), which will automate the process of keeping your themes (and default language keywords) up-to-date.  But this script or ConfigUpdater plugin are _not_ needed once you upgrade to Notepad++ v8.9.