explaiun config.model.xml

Author: pryrt

content/docs/config-files.md

@@ -34,7 +34,7 @@ Reading the above section, one may go looking for the user `functionList\` or `t
 
 If you want to reset your Notepad++ back to "factory condition", and are using the normal installation, you can exit all instances of Notepad++ then delete (or rename) the `%AppData%\Notepad++` folder (or your Cloud folder, or wherever `-settingsDir` option points).  The next time you run Notepad++, it will create `%AppData%\Notepad++` (or Cloud or `-settingsDir` location) and populate it with a minimal set of config files.
 
-If you just want to start fresh on a particular config file: Notepad++ knows how to recreate the necessary files if it doesn't find them.  For the ones that have an `<XXX>.model.xml` file in the Notepad++ application directory, all you have to do is delete your per-user `<XXX>.xml` (from `%AppData%\Notepad++\` or the Cloud or `-settingsDir` location) and restart Notepad++, and Notepad++ will copy the `<XXX>.model.xml` version into the right place for you.  If the `config.xml` or your session or shortcuts or contextMenu config files are intentionally deleted (or otherwise missing) from the config-file folder, Notepad++ can recreate those as necessary as well on its next start (it is programmed on how to create them from scratch, rather than using a `.model.` file).
+If you just want to start fresh on a particular config file: Notepad++ knows how to recreate the necessary files if it doesn't find them.  For the ones that have an `<XXX>.model.xml` file in the Notepad++ application directory, all you have to do is delete your per-user `<XXX>.xml` (from `%AppData%\Notepad++\` or the Cloud or `-settingsDir` location) and restart Notepad++, and Notepad++ will copy the `<XXX>.model.xml` version into the right place for you.  If the `config.xml` or your session or shortcuts or contextMenu config files are intentionally deleted (or otherwise missing) from the config-file folder, Notepad++ can recreate those as necessary as well on its next start (it is programmed on how to create them from scratch, rather than using a `.model.` file -- though Notepad++ _will_ use `config.model.xml` instead of its internal defaults, if it exists).
 
 ### Undoing Portable
 
@@ -473,6 +473,8 @@ You can have multiple icon set directories; to switch between icon sets, you jus
 
 - `cloud\choice` file: If this folder and file are present, the file contains the path to the [Cloud folder](../preferences/#cloud-link). This config file is created when you define the Cloud preferences. If you are in a normal installation, this config file will be `%AppData%\Notepad++\cloud\choice`; if it is deleted from there, Notepad++ will _not_ look for `<installdir>\cloud\choice`.  If you are in a portable / local configuration (`doLocalConf.xml` exists), it will be in `<portable>\cloud\choice`.
 
+- `config.model.xml`: If it exists, Notepad++ will use the `config.model.xml` from the installation directory as the default configuration when creating a new per-user `config.xml` ; if the `config.model.xml` does not exist in the installation directory, Notepad++ has a set of default internal values that it will use to populate the per-user `config.xml`.  This is useful if you have multiple users on the same PC, and want them all to start with the same configuration choices when they first use Notepad++; it can also be used if you want to bundle your own customized Notepad++ installation directory to distribute to multiple PCs, then when each user first uses Notepad++ on the new computer, they will start with those values in their user `config.xml`.  
+
 - `disableLineCopyCutDelete.xml`: This is a zero-byte file that is used as an indicator to Notepad++ to not enable the [context-aware "line copy / cut / delete"](../editing/#context-awareness) feature in v8.6.1.  This file needs to be in `%AppData%\Notepad++\` for a normal installation, and in the portable directory for a local configuration.  The only version of Notepad++ to pay attention to this file is v8.6.1; in earlier or later versions, this file is ignored and meaningless.  (It was added because v8.6 had some strange behavior with the context-aware Cut/Copy/Paste, so v8.6.1 added a workaround for that difficulty by allowing users who had problems with it to disable the context-aware actions.  However, v8.6.2 fixed the underlying bug, so this workaround was no longer necessary and hence removed.)
 
 - `doLocalConf.xml`: This is a zero-byte file that is used as an indicator to `notepad++.exe` to not go looking for `%AppData%`. This will only exist on local installations of Notepad++ (when you tell the installer to not use `%AppData%`, or when you install from the zipfile, or when you manually create the zero-byte file). This config file _must_ go in the Notepad++ installation folder; it will not be recognized in the `%AppData%\Notepad++` hierarchy or in the cloud settings folder.  (If this file is deleted, the instance will go back to using the normal `%AppData%` location the next time Notepad++ is run.)
@@ -514,3 +516,4 @@ If you are developing a config file by editing the raw XML file and would like t
 
 
 
+