Skip to content

Commit d7ef587

Browse files
committed
update config-files for file location
explain that cloud beats portable and portable beats appdata (also, per #139, since editing config-files.md, link to the FindReplaceDlg_rc.h constants for a reference for type=3 macro messages.) Closes #139.
1 parent 009e0e8 commit d7ef587

File tree

1 file changed

+11
-2
lines changed

1 file changed

+11
-2
lines changed

content/docs/config-files.md

Lines changed: 11 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,16 @@ Notepad++ offers a comprehensive user interface to review or change most of its
1212
* Editing previously-recorded macros, or crafting new macros manually
1313
* Adding keywords to a language, because the new language version isn't matched yet
1414

15-
The underlying XML files are all found in `%AppData%\notepad++\` (or, for zip-based local installations, in the notepad++ executable directory) unless otherwise noted.
15+
## Configuration Files Location
16+
17+
In a standard installation, the configuration files go in `%AppData%\Notepad++\`. (For a refresher course on `%AppData%`, see the [Community Forum FAQ's `%AppData%` entry](https://community.notepad-plus-plus.org/topic/15740/faq-desk-what-is-appdata).)
18+
19+
In a portable installation, the configuration files go in the same directory as the `notepad++.exe` executable. (An installation is treated as "portable" if the zero-byte `doLocalConf.xml` file is present alongside the `notepad++.exe` executable. The **?** menu's **Debug Info** will show `Local mode: ON` for a portable version.)
20+
21+
If you enable the [Cloud settings](../preferences/#cloud), some configuration files will go in the defined directory (including `contextMenu.xml`, `shortcuts.xml`, `userDefineLang.xml`, `langs.xml`, `stylers.xml`, and `config.xml`;
22+
the `userDefineLang\` subfolder can be placed there as well, though it won't be created by default when the Cloud settings folder is first populated).
23+
24+
If the Cloud directory is enabled, that will take priority over the portable or standard config file location; if `doLocalConf.xml` is present, it will take priority over the `%AppData%\Notepad++\` folder; if neither are active, then the standard config file location is `%AppData%\Notepad++\`.
1625

1726
## Editing Configuration Files
1827

@@ -101,7 +110,7 @@ The full list of Scintilla messages for `type=0` and `type=1` Scintilla messages
101110

102111
The `wParam` command IDs for `type=2` Notepad++ messages can be found as the `IDM` constants in the source file [menuCmdID.h](https://github.com/notepad-plus-plus/notepad-plus-plus/blob/master/PowerEditor/src/menuCmdID.h), or you can look at the `localization\English.xml` (or your language of choice), which lists the `<Item id="...">` next to the text of the command; the value of the `id` attribute is the "command ID".
103112

104-
For `type=3` search-and-replace macros, see the detailed description in ["Searching > Searching actions when recorded as macros"](../searching/#searching-actions-when-recorded-as-macros).
113+
For `type=3` search-and-replace macros, see the detailed description in ["Searching > Searching actions when recorded as macros"](../searching/#searching-actions-when-recorded-as-macros). The message numbers for `type=3` come from [FindReplaceDlg_rc.h](https://github.com/notepad-plus-plus/notepad-plus-plus/blob/master/PowerEditor/src/ScitillaComponent/FindReplaceDlg_rc.h).
105114

106115
You can use any Scintilla or Windows message that does not return a value, that passes an integer in `wParam`, and either an integer or string in `lParam`. There are some messages that require strings in the `wParam`, or various data structures: those will not work in a macro.
107116

0 commit comments

Comments
 (0)