You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: content/docs/auto-completion.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -75,7 +75,7 @@ The keyboard shortcuts for manual completion can be adjusted in [**Settings > Sh
75
75
76
76
## Create auto-completion definition files
77
77
78
-
Notepad++ uses XML configuration files to define the per-language function and parameter auto-completion. Those AutoComplete files are located in the `autoCompletion` subdirectory of the Notepad++ install folder. (In older versions, Notepad++ v7.6.1 and earlier, they were found in the `plugins\APIs` subdirectory of the intstall folder.)
78
+
Notepad++ uses XML configuration files to define the per-language function and parameter auto-completion. Those AutoComplete files are located in the `autoCompletion` subdirectory of the Notepad++ install folder.
79
79
80
80
The syntax of AutoComplete files is simple, but does have a few rules, most importantly correct syntax and proper sorting. If the syntax is incorrect, the XML file will fail to load and AutoComplete will be not be available for that file type.
Copy file name to clipboardExpand all lines: content/docs/command-prompt.md
+2-2Lines changed: 2 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -157,8 +157,8 @@ code | file
157
157
*`-qf="D:\path to\file"`: Launch [ghost typing](../ghost-typing/) to display a file content via the file path *D:\path to\file*
158
158
*`-qSpeed(1|2|3)`: [Ghost typing](../ghost-typing/) speed. Value from 1 to 3 for slow, fast, and fastest
159
159
*`-quickPrint`: Print the file given as argument `filepath` then quit Notepad++
160
-
*`-settingsDir="d:\your settings dir\"`: Override the default settings dir (new to v7.9.2)
161
-
*`-openFoldersAsWorkspace`: Any folders listed as arguments will be opened as a workspace, rather than opening all the contained files individually (new to v7.8)
160
+
*`-settingsDir="d:\your settings dir\"`: Override the default settings dir
161
+
*`-openFoldersAsWorkspace`: Any folders listed as arguments will be opened as a workspace, rather than opening all the contained files individually
162
162
*`-titleAdd="additional title bar text"`: Add a dash and a space and the supplied text to the right side of the application title bar (new to v8.0.0)
163
163
*`-pluginMessage="text for plugin(s)"`: if plugin developers need extra command line arguments, then users can add this option, and the plugin will be [notified](../plugin-communication/#NPPN_CMDLINEPLUGINMSG"NPPN_CMDLINEPLUGINMSG") that it can parse that string for extra information (new to v8.4.2)
164
164
*`filepath`: file or folder name to open (absolute or relative path name)
Copy file name to clipboardExpand all lines: content/docs/config-files.md
+7-42Lines changed: 7 additions & 42 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -22,7 +22,7 @@ In a portable installation, the configuration files all go in the same directory
22
22
23
23
If you enable the [Cloud settings](../preferences/#cloud), some per-user configuration files will go in the defined directory (including `contextMenu.xml`, `shortcuts.xml`, `userDefineLang.xml`, `langs.xml`, `stylers.xml`, and `config.xml`; 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).
24
24
25
-
There is a [command-line option](../command-prompt/)`-settingsDir` which will set a new directory for the per-user configuration file location (added in v7.9.2).
25
+
There is a [command-line option](../command-prompt/)`-settingsDir` which will set a new directory for the per-user configuration file location.
26
26
27
27
**Search order**: 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++\`. If it cannot find a configuration file in any of the per-user locations, it will use the version from the same directory as the executable.
28
28
@@ -261,7 +261,7 @@ Position | Name | Value format | Meaning
261
261
262
262
Inside each of the languages, you _could_ add keywords. However, it's better to use [**Settings > Style Configurator**](../preferences/#style-configurator) and make use of the user-defined keywords box for a given category (when available). These user-defined keywords are stored in [`stylers.xml`](#highlighting-schemes-stylers-xml) (described below).
263
263
264
-
The order of the `ext` list here determines the order of extensions in the file-type pulldowns of the Windows-common-dialogs like **Open**, **Save**, and **Save As** dialogs. When using the [old-style dialogs](../preferences/#default-directory), the automatically-added extension will be the first extension from this `ext` list. As of v7.8.7, the new-style dialogs will also automatically add the first extension.
264
+
The order of the `ext` list here determines the order of extensions in the file-type pulldowns of the Windows-common-dialogs like **Open**, **Save**, and **Save As** dialogs. The automatically-added extension will be the first extension from this `ext` list.
265
265
266
266
The `commentLine`, `commentStart`, and `commentEnd` attributes are used by the [Edit Menu](../editing/#edit-menu)'s **Comment/Uncomment** actions for adding or removing the comment syntax to the selected lines of text. These are independent of the selected [programming **Language**](../programing-languages/)'s syntax lexer, so changing these attributes will _not_ affect what code sections will get highlighted as comments by the active syntax highlighter. (Because of the way the Scintilla library that Notepad++ uses for the lexers, in order to change what gets highlighted as a comment, one would need to edit and re-compile the lexer for the chosen and then rebuild the Notepad++ project; in other words, it would have to be changed by the developers for a new release, not changed by the user in the `langs.xml` configuration file.) These attributes can only define one type of line and block comments; if your language has multiple types of either, you will have to choose the _one_ type that you'd like Comment/Uncomment to work with.
267
267
@@ -286,9 +286,8 @@ The `<WordsStyle>` `colorStyle` attribute decides whether to use the defined col
286
286
## `Function List`
287
287
288
288
Defines what counts as a "function" for **View > Function List**. There are some comments in the file(s), and lots of examples of the builtin languages, which you can customize.
289
-
From v7.9.1 the file structure of function list parsers have been changed, so please follow one of sections below according your Notepad++ version.
290
289
291
-
### v7.9.1 and later versions
290
+
### Function List Definitions
292
291
293
292
The `functionList` folder contains a separate XML file (function list parse rule) for each language's function list capability.
294
293
Each function list parse rule links to a language with the language default name. For example the file name of php language parse rule is `php.xml`, the file name of Java language parse rule is `java.xml`, Check [overrideMap.xml](https://github.com/notepad-plus-plus/notepad-plus-plus/blob/master/PowerEditor/installer/functionList/overrideMap.xml) for the naming list of all supported programming languages.
@@ -315,51 +314,17 @@ For plain text files (ones with **Language > None (Normal Text)** selected), you
The `functionList.xml` config file contains XML entries for each language's function list definition, as well as a map that tells Notepad++ which section of the XML is applied to each file type.
321
-
322
-
If you want to add **Function List** capability for your User Defined Language (UDL), you can. You need to add two groups of information:
323
-
324
-
1. In the `<associationMap>` section, you need to add lines like the following
where `fn_udl_example` is a name unique to this UDL. It is best to define it both
331
-
based on `userDefinedLangName=...` (which must match the name you saved for your UDL) and on extension `ext=...` (which must match the extension(s) of your UDL type, with one extension per entry).
332
-
333
-
2. In the `<parsers>` section, add a parser, with a similar format to all the builtin parsers shown. An example would be
where the `fn_udl_example` must match the `<association id>`. The `displayName` sets what shows in the **Function List** window header. The `...Expr` values are all defined in [regular expression syntax](../searching/#regular-expressions).
351
-
352
317
### Upgrading old Function List entries
353
318
354
-
If you previously had a v7.9-or-earlier style function list entry in `functionList.xml`, and you want to use it in a v7.9.1-or-later Notepad++, you can extract the pieces to the right locations in the new multi-file format:
319
+
If you previously had a v7.9-or-earlier style function list entry in `functionList.xml`, and you want to use it in a modern v8.x version of Notepad++, you can extract the pieces to the right locations in the new multi-file format:
355
320
356
321
1. Open the old `functionList.xml`
357
322
2. Open the `functionList\overrideMap.xml`
358
-
3. Copy the `<association...>` tag from the old `functionList.xml` to the `functionList\overrideMap.xml`, and place near the end of the `<associationMap>` section. Make sure it follows the rules for v7.9.1-or-later`<association>` tag syntax
323
+
3. Copy the `<association...>` tag from the old `functionList.xml` to the `functionList\overrideMap.xml`, and place near the end of the `<associationMap>` section. Make sure it follows the rules for modern`<association>` tag syntax
359
324
4. Open the `functionList\blah.xml` for your particular language
360
-
- If you don't have `blah.xml` yet, copy one of the v7.9.1-or-newer language's XML files to `blah.xml`, and remove the whole `<parser...> ... </parser>` section
325
+
- If you don't have `blah.xml` yet, copy another language's XML file from the most-recent Notepad++ version to `blah.xml`, and remove the whole `<parser...> ... </parser>` section
361
326
5. Copy the `<parer...>...</parser>` section from the old `functionList.xml` to the `functionList\blah.xml`
362
-
- Please note that the `blah.xml` should _not_ contain a `<parsers>` section, _just_ the `<parser>` section. It will cause problems with the Function List if you wrap it in the `<parsers>...</parsers>` block. Make sure it ends up with the v7.9.1-or-newer structure described above.
327
+
- Please note that the `blah.xml` should _not_ contain a `<parsers>` section, _just_ the `<parser>` section. It will cause problems with the Function List if you wrap it in the `<parsers>...</parsers>` block. Make sure it ends up with the structure described above.
Copy file name to clipboardExpand all lines: content/docs/editing.md
+2-2Lines changed: 2 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -152,7 +152,7 @@ Below the `Begin/End Select` entries, there are a number of sub-menus to the **E
152
152
*`Remove Consecutive Duplicate Lines`: will only remove duplicates that are on the lines immediately following the first instance (still keeping the first instance); acts upon the line set spanned by the current selection, or the entire file if no active selection
153
153
* NOTE: Duplicates removal 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.
154
154
* There are methods for splitting lines and joining lines together:
155
-
*`Split Lines`: will insert a line-ending into a long line(s): if there is one or more [Vertical Edge](../preferences/#margins-border-edge) value specified (requires v7.9.3 or later), it will split at the right-most Vertical Edge; otherwise, it will split at the current size of the editor window. It operates on the lines spanned by the current stream selection or the single line of the caret if no stream selection is currently active.
155
+
*`Split Lines`: will insert a line-ending into a long line(s): if there is one or more [Vertical Edge](../preferences/#margins-border-edge) value specified, it will split at the right-most Vertical Edge; otherwise, it will split at the current size of the editor window. It operates on the lines spanned by the current stream selection or the single line of the caret if no stream selection is currently active.
156
156
*`Join Lines`: will combine the lines touched by the active stream selection by replacing line-endings with a single space character. It requires an active stream selection that spans two or more lines.
157
157
* There are commands for removing lines
158
158
*`Remove empty lines`: will remove all lines containing no characters from the entire document
@@ -161,7 +161,7 @@ Below the `Begin/End Select` entries, there are a number of sub-menus to the **E
161
161
*`Move Up Current Line`: will swap the current line with the line above it, effectively moving the line of the caret up one row in the document; if a selection spanning lines is active upon invocation, it will move those lines touched by the selection up as a group
162
162
*`Move Down Current Line`: will swap the current line with the line below it, effectively moving the line of the caret down one row in the document; if a selection spanning lines is active upon invocation, it will move those lines touched by the selection down as a group
163
163
*`Reverse Line Order`: will take the selected lines (or all of the lines of the current document if no active selection) and will order them reversely (i.e. flipped) from their existing order (added in v8.0.0)
164
-
*`Randomize Line Order`: will take the selected lines (or all of the lines of the current document if no active selection) and place them in an unpredictable order (added in v7.9 as "Sort Lines Randomly"; renamed in v8.0.0)
164
+
*`Randomize Line Order`: will take the selected lines (or all of the lines of the current document if no active selection) and place them in an unpredictable order
Copy file name to clipboardExpand all lines: content/docs/ghost-typing.md
+1-12Lines changed: 1 addition & 12 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -60,15 +60,4 @@ These options apply to any of the ghost typing modes, unless otherwise mentioned
60
60
61
61
## Historical Syntax
62
62
63
-
The syntax listed above is valid for Notepad++ v7.9.2 and newer.
64
-
65
-
In Notepad++ v7.9.1 and earlier, there were differnces in the syntax:
66
-
67
-
* the command-line options for the ghost typing modes did not use the `=`,
68
-
so it would be interpreted as literal text (part of the value)
69
-
* quotes were interpreted as literal text (part of the value)
70
-
* the sequence `%20` was used to represent a space, since you could not
71
-
use quotes to make spaces significant.
72
-
73
-
Keep these differences in mind if using older versions of Notepad++.
74
-
63
+
The syntax listed above is valid for Notepad++ v8 and newer. If you have a v7.x version of Notepad++, please download the [last offline User Manual that contains Notepad++ v7.x details](https://github.com/notepad-plus-plus/npp-usermanual/releases/download/3.6/nppUserManual.zip)
0 commit comments