Skip to content

Commit 6a3c16e

Browse files
committed
add docs for the -settingsDir option [NO PR YET!]
* add docs for the -settingsDir option, both in command-prompt.md and config-files.md * add command-prompt.md doc for the -L option, which was missed in previous versions of the docs
1 parent 3ec8982 commit 6a3c16e

File tree

2 files changed

+12
-8
lines changed

2 files changed

+12
-8
lines changed

content/docs/command-prompt.md

Lines changed: 9 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -10,15 +10,16 @@ to control its startup and affect its behavior.
1010
## Help usage
1111

1212
```
13-
notepad++ [--help] [-multiInst] [-noPlugin] [-l<lang>] [-n<line>] [-c<column>]
14-
[-p<pos>] [-x<left-pos>] [-y<TopPos>] [-nosession] [-notabbar] [-ro]
15-
[-systemtray] [-loadingTime] [-alwaysOnTop] [-openSession] [-openFoldersAsWorkspace] [-r]
13+
notepad++ [--help] [-multiInst] [-noPlugin] [-l<Language>] [-L<langCode]
14+
[-n<line>] [-c<column>] [-p<pos>] [-x<left-pos>] [-y<TopPos>]
15+
[-nosession] [-notabbar] [-ro] [-systemtray] [-loadingTime]
16+
[-alwaysOnTop] [-openSession] [-r]
1617
[-qn<EasterEggName> | -qt<Text> | -qf<ContentFileName>]
1718
[-qSpeed(1|2|3)] [-quickPrint]
19+
[-settingsDir="d:\your settings dir\"] [-openFoldersAsWorkspace]
1820
[filepath]
1921
```
2022

21-
2223
* `--help`: The help message for command line arguments. It will be shown before
2324
Notepad++'s launch.
2425
* `-multiInst`: Launch another Notepad++ instance, so user can have several
@@ -32,6 +33,7 @@ notepad++ [--help] [-multiInst] [-noPlugin] [-l<lang>] [-n<line>] [-c<column>]
3233
`actionscript`, `nsis`, `tcl`, `lisp`, `scheme`, `asm`, `diff`, `props`,
3334
`postscript`, `ruby`, `smalltalk`, `vhdl`, `kix`, `autoit`, `Gui4Cli`,
3435
`powershell`, `caml`, `ada`, `verilog`, `matlab`, `haskell`, `inno`, `cmake`, `yaml`, `r` and `jsp`.
36+
* `-L`: Apply indicated localization, *langCode* is browser language code
3537
* `-n`: Scroll to indicated line (*LineNumber*) on `filepath`.
3638
* `-c`: Scroll to indicated column (*ColumnNumber*) on `filepath`.
3739
* `-p`: Scroll to indicated 0 base position (*Position*) on `filepath`.
@@ -44,14 +46,14 @@ notepad++ [--help] [-multiInst] [-noPlugin] [-l<lang>] [-n<line>] [-c<column>]
4446
* `-loadingTime`: Display Notepad++ loading time.
4547
* `-alwaysOnTop`: Make Notepad++ always on top.
4648
* `-openSession`: Open a session. `filepath` must be a session file.
47-
* `-openFoldersAsWorkspace`: Any folders listed as arguments will be opened as a workspace, rather than opening all the contained files individually (new to v7.8)
48-
* `-r`: Open files recursively. This argument will be ignored if
49-
`filepath` contain no wildcard character.
49+
* `-r`: Open files recursively. This argument will be ignored if `filepath` contain no wildcard character.
5050
* `-qn`: Launch ghost typing to display easter egg via its *EasterEggName*.
5151
* `-qt`: Launch ghost typing to display a text via the given *Text*
5252
* `-qf`: Launch ghost typing to display a file content via the file path *ContentFileName*
5353
* `-qSpeed`: Ghost typing speed. Value from 1 to 3 for slow, fast and fastest
5454
* `-quickPrint`: Print the file given as argument `filepath` then quit Notepad++
55+
* `settingsDir="d:\your settings dir\"`: Override the default settings dir
56+
* `-openFoldersAsWorkspace`: Any folders listed as arguments will be opened as a workspace, rather than opening all the contained files individually (new to v7.8)
5557
* `filepath`: file or folder name to open (absolute or relative path name)
5658

5759

content/docs/config-files.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -21,7 +21,9 @@ In a portable installation, the configuration files go in the same directory as
2121
If you enable the [Cloud settings](../preferences/#cloud), some configuration files will go in the defined directory (including `session.xml`, `contextMenu.xml`, `shortcuts.xml`, `userDefineLang.xml`, `langs.xml`, `stylers.xml`, and `config.xml`;
2222
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).
2323

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++\`.
24+
There is a [command-line option](../command-prompt/) `-settingsDir` which will set a new directory for the configuration file location (added in v7.9.x _**!!TDB!!!**_)
25+
26+
If the `--settingsDir` option is set, that configuration file directory will take priority over any other configuration file directory. If the Cloud directory setting is defined and enabled, that will take priority over the portable or standard configuration file directory. If `doLocalConf.xml` is present, the portable configuration file location will take priority over the `%AppData%\Notepad++\` directory. If none of the other configuration file directories are active, then the standard configuration file directory is `%AppData%\Notepad++\`.
2527

2628
## Editing Configuration Files
2729

0 commit comments

Comments
 (0)