Per Alan's discussion in the forum, the manual seems to not include any documentation on the "Project" feature.

Add new Margin/Border/Edge sub-page in Preferences. (Implement notepad-plus-plus/notepad-plus-plus#8896)

Needs to be added to preferences docs

It looks like at least one of the web servers has an expired certificate:
npp-user-manual.org
12/1/2019, 6:42:08 AM (Pacific Daylight Time)
2/29/2020, 6:42:08 AM (Pacific Daylight Time)
03:F5:03:BF:E4:67:51:18:33:6D:C5:8D:31:76:58:18:D3:A7

I was able to see it a few times just by reloading the page but it seems to be occuring less than 1 in 5 times.

Regarding the paragraph has two issues:

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.

1. The first should probably just mention Scintilla messages; most standard Windows messages don't apply, or otherwise aren't reasonable from the macro environment.
2. It should moved and appended to the Scintilla-message paragraph, because it only applies to types 0 and 1, not to 3 (or all) as might be inferred from the placement.

As I've been working on my contributions, I've wondered about a few questions regarding consistent formatting of the help documentation, which need discussion from the team, so we can come to a consensus:

1. For menu entries, how do we want to format / highlight that it's a menu name / entry?

   1. How to format the text
      • Bold? File > Save
      • Italic? File > Save
      • Code-text? File > Save
      • Quoted? "File > Save"
      • Raw? File > Save
   2. if there's a hyperlink, do we still add extra styling, or leave the hyperlink as the only styling:
      • both: Settings > Preferences > MISC.
      • just link: Settings > Preferences > MISC.
   3. What separator to use for sub-menus?
      • Just the greater-than? File > Save
      • Just the two-character "arrow"? File -> Save
      • ASCII vertical bar? File | Save
      • Unicode arrow? File → Save
      • Unicode triangle? File ▶ Save
   4. For settings entries, or particular attributes of a particular style, should it be formatted like everything else before it, or use a different style
      • For example, in Settings > Preferences > MISC. documentation, I have all the options with tick-boxes formatted in `backticks`. But I don't do similar for the sections I added in #24

2. For text where we want the reader to understand it as text to type or enter (such as regular expressions), should we use quotes, or use code-formatting (ie, `backticks`)

   • Regex: [a-z]+?
   • Regex: "[a-z]+?"

3. For file names / paths, should we use quotes, backticks, or something else?

   • talk about stylers.xml config file (for example, here)
   • talk about "stylers.xml" config file

4. How long should a page be before we break it into multiple pages?

   • For example, the Preferences page is getting really long, with the Preferences, Style Configurator, and Shortcut Mapper

Feel free to edit the issue (or just include it in your comments) if you have more style questions to add...

Once we come to a consensus, we can probably update CONTRIBUTION.md to indicate these style rules.

The searching.md specifically says "For those readers familiar with Perl, \G is not supported". But as Guy just proved, it is supported (and documented in Boost 1.70 docs).

Need to fix that sentence.

@guy038 found a bunch of technical errors and clarifications, along with some typos and inconsistent spelling. He emailed those suggestions to @pryrt, who will be working on incorporating those into searching.md.

They were made to match one of the release candidates of v7.8.6, but that feature was changed by the official version and I forgot to update the docs to go with it.

As brought up in #96 discussion: Should we choose a documentation license? If so, which should we choose?

• GNU Free Documentation License (GFDL) (official text)
• One of the Creative Commons licenses
• Your Favorite Goes here

Please add some documentation on how to understand the contents of the userDefineLang.xml fle.
Unfortunately the links to UDL pages are not helping here....

E.g. What is the meaning of:

        <Styles>
            <WordsStyle name="DEFAULT" 			fgColor="3D3D7A" bgColor="FFFFFF" fontName="GUIConfig" fontStyle="1" nesting="0" />
            <WordsStyle name="COMMENTS" 		fgColor="009100" bgColor="FFFFFF" fontName="" fontStyle="0" nesting="0" />
            <WordsStyle name="LINE COMMENTS" 	fgColor="009B00" bgColor="FFFFFF" fontName="" fontStyle="0" nesting="0" />
            <WordsStyle name="NUMBERS" 			fgColor="0000FF" bgColor="FFFFFF" fontName="" fontStyle="1" nesting="0" />
            <WordsStyle name="KEYWORDS1" 		fgColor="804040" bgColor="FFFFFF" fontName="" fontStyle="1" nesting="0" />
            <WordsStyle name="KEYWORDS2" 		fgColor="0080FF" bgColor="FFFFFF" fontName="" fontStyle="0" nesting="0" />
            <WordsStyle name="KEYWORDS3" 		fgColor="FF00FF" bgColor="FFFFFF" fontName="" fontStyle="1" nesting="0" />
            <WordsStyle name="KEYWORDS4" 		fgColor="FF00FF" bgColor="FFFFFF" fontName="" fontStyle="1" nesting="0" />
            <WordsStyle name="KEYWORDS5" 		fgColor="0080FF" bgColor="FFFFFF" fontName="" fontStyle="0" nesting="0" />
            <WordsStyle name="KEYWORDS6" 		fgColor="000000" bgColor="FFFFFF" fontName="" fontStyle="1" nesting="0" />
            <WordsStyle name="KEYWORDS7" 		fgColor="E40303" bgColor="FFFFFF" fontName="" fontStyle="0" nesting="0" />
            <WordsStyle name="KEYWORDS8" 		fgColor="000000" bgColor="FFFFFF" fontName="" fontStyle="0" nesting="0" />
            <WordsStyle name="OPERATORS" 		fgColor="000000" bgColor="FFFFFF" fontName="" fontStyle="0" nesting="0" />
            <WordsStyle name="FOLDER IN CODE1" 	fgColor="000000" bgColor="FFFFFF" fontName="" fontStyle="0" nesting="0" />
            <WordsStyle name="FOLDER IN CODE2" 	fgColor="000000" bgColor="FFFFFF" fontName="" fontStyle="0" nesting="0" />
            <WordsStyle name="FOLDER IN COMMENT" fgColor="00FF00" bgColor="FFFFFF" fontName="" fontStyle="0" nesting="0" />
            <WordsStyle name="DELIMITERS1" 		fgColor="000000" bgColor="FFFFFF" fontName="" fontStyle="0" nesting="0" />
            <WordsStyle name="DELIMITERS2" 		fgColor="000000" bgColor="FFFFFF" fontName="" fontStyle="0" nesting="0" />
            <WordsStyle name="DELIMITERS3" 		fgColor="FF0000" bgColor="FFFFFF" fontName="" fontStyle="1" nesting="0" />
            <WordsStyle name="DELIMITERS4" 		fgColor="FF8000" bgColor="FFFFFF" fontName="" fontStyle="0" nesting="0" />
            <WordsStyle name="DELIMITERS5" 		fgColor="000000" bgColor="FFFFFF" fontName="" fontStyle="0" nesting="0" />
            <WordsStyle name="DELIMITERS6" 		fgColor="000000" bgColor="FFFFFF" fontName="" fontStyle="0" nesting="0" />
            <WordsStyle name="DELIMITERS7" 		fgColor="000000" bgColor="FFFFFF" fontName="" fontStyle="0" nesting="0" />
            <WordsStyle name="DELIMITERS8" 		fgColor="000000" bgColor="FFFFFF" fontName="" fontStyle="0" nesting="0" />
        </Styles>

In particular fontStyle and nesting??

Just transfer an email I've got:

Hi Don
Just a heads up found a typo in the help doco, should say ‘backslash’ but is written as ‘backalash’
Source: npp-user-manual.org/docs/searching/#extended-search-mode:

https://github.com/notepad-plus-plus/npp-usermanual/blob/master/content/docs/searching.md#capture-groups-and-backreferences

States that \gℕ, \g{ℕ}, \g<ℕ>, \g'ℕ' should be the correct way to reference capture groups > 10 however it did not work for me.

Referencing notepad-plus-plus/notepad-plus-plus#2514 shows $N does in fact work. It is also documented in https://github.com/notepad-plus-plus/npp-usermanual/blob/master/content/docs/searching.md#substitution-escape-sequences that $ℕ, ${ℕ}, \ℕ ⇒ Returns what matched the ℕth subexpression

At the end of CONTRIBUTION.md (end of section Cross-Links) the last sentence should end with a closing backtick and a full stop.

the syntax `[**Preferences > Style Configurator**](../preferences/#style-configurator)`.

Per https://community.notepad-plus-plus.org/topic/20516/notepad-7-9-2-rc

10. Add new API NPPM_GETSETTINGSONCLOUDPATH for plugins. (Implement notepad-plus-plus/notepad-plus-plus#9168 )

Need to document that one

when right click of open files,the "Full File Path to Calipboard" is mapping to Chinese "將資料夾路徑複製到剪貼簿" which is not correct, it's confused of "Current Dir.Path to Calipboard"
https://imgur.com/AppJI1G
version : v7.8.4 (32 bit)

per this Community Forum post, it appears there is room for improvement in the description of the configuration-file location.

Rather than a single sentence, I need to add a small section which basically cleans up what I posted in that thread, along with Alan's notes about doLocalConf.xml.

@donho ,

last night, I couldn't access npp-user-manual.org from home. This morning, I tried from the office, and it's still not responding. When I plug the URL into some of the online "is it down for everyone sites", it shows as down, too.

• https://downforeveryoneorjustme.com/npp-user-manual.org?proto=https
• https://www.isitdownrightnow.com/npp-user-manual.org.html

List of messages and notifications which aren't documented yet
NPPM_ADDTOOLBARICON
NPPM_DECODESCI
NPPM_DISABLEAUTOUPDATE
NPPM_DMMVIEWOTHERTAB
NPPM_DOCSWITCHERDISABLECOLUMN
NPPM_ENCODESCI
NPPM_GETCURRENTVIEW
NPPM_GETEDITORDEFAULTBACKGROUNDCOLOR
NPPM_GETEDITORDEFAULTFOREGROUNDCOLOR
NPPM_GETENABLETHEMETEXTUREFUNC
NPPM_GETFILENAMEATCURSOR
NPPM_GETNBUSERLANG
NPPM_GETNPPFULLFILEPATH
NPPM_GETPLUGINHOMEPATH
NPPM_MAKECURRENTBUFFERDIRTY
NPPM_REMOVESHORTCUTBYCMDID
NPPM_SAVEFILE
NPPM_SAVESESSION
NPPM_SETEDITORBORDEREDGE
NPPM_SETSMOOTHFONT
NPPM_SETSTATUSBAR

NPPN_BEFORESHUTDOWN
NPPN_CANCELSHUTDOWN
NPPN_FILEBEFOREDELETE
NPPN_FILEBEFORERENAME
NPPN_FILEDELETED
NPPN_FILEDELETEFAILED
NPPN_FILERENAMECANCEL
NPPN_FILERENAMED
NPPN_READONLYCHANGED
NPPN_SNAPSHOTDIRTYFILELOADED

Typographical error in Search, Extended Search - see screenshot
https://npp-user-manual.org/docs/searching/#extended-search-mode

it's that something i can contact you? like email. because i want to ask more
`

pls

Please add list with all hidden options that are not available directly in the UI. I'm sure I've seen other options somewhere else, but I can't locate them. A separate list with such hiding settings would be very helpful.

From DonHo:

<FindHistory nbMaxFindHistoryPath="10" nbMaxFindHistoryFilter="10" nbMaxFindHistoryFind="10" nbMaxFindHistoryReplace="10" matchWord="no" matchCase="no" wrap="yes" directionDown="yes" fifRecuisive="yes" fifInHiddenFolder="no" dlgAlwaysVisible="no" fifFilterFollowsDoc="no" fifFolderFollowsDoc="no" searchMode="0" transparencyMode="1" transparency="150" dotMatchesNewline="no" isSearch2ButtonsMode="yes" "regexBackward4PowerUser"="yes">
Add an non-UI option to allow regEx backward search
Set regexBackward4PowerUser to yes in config.xml to eanable this option.

From Michael Vincent:

<GUIConfig name="commandLineInterpreter">powershell</GUIConfig>
Which makes the menu File => Open Containing Folder => cmd actually open PowerShell instead of cmd.exe.

See here:
Control flow

4-th bullet line now listed as:

• (&name) or (?P>name) ⇒ Backtrack to subexpression named name.

Typo is there in first Code, must be:

• (?&name) or (?P>name) ⇒ Backtrack to subexpression named name.

In chapter Project Panels the Notepad++ manual states the following:

For any entry in the Project Panel tree view, right clicking will give you the available actions on that specific entry.
...

• On a Project entry:
  ...
  • Add Files from Directory = add all the files from that Windows directory into the Project.
    • Please note: this is not a recursive action: this just puts all the files in the list.

The statement above highlighted in bold is not correct. Indeed, selecting Add Files from Directory works recursive and adds all files and folders including their subfolders to the project.

From what I see, documentation on how to build a lexer plugin is missing.
Is there something in the pipeline or should I start writing one?

The command line parameter -openFolderAsWorkspace appears to be missing in command-prompt.md.

Hello!

Here we have false declaration:
Look here: Assertions

1. Assertions stated as:

These special groups consume no characters. Their successful matching counts, but when they are done, matching starts over where it left.

2. (?>pattern) declared inside Assertions but CONSUME characters and so can't be placed in Assertions chapter.

In the PERL documentation it is listed without grouping like this:

Independent sub-expressions
(?>pattern) pattern is matched independently of the surrounding patterns, the expression will never backtrack into pattern. Independent sub-expressions are typically used to improve performance; only the best possible match for pattern will be considered, if this doesn't allow the expression as a whole to match then no match is found at all.

Considering what it do (?>pattern) can be placed in Search modifiers or Control flow chapters.

My suggestion is to place it inside of Control flow chapter before (?(assertion)YesPattern|NoPattern) and add an optional guidelines to it like this:

• (?>pattern) => Independent sub-expression
  Match pattern independently of surrounding patterns. Search will never backtrack into independent sub-expression.
  Independent sub-expressions are typically used to improve performance, only the best possible match for pattern will be considered, if this doesn't allow the expression as a whole to match then no match is found at all.
  On other side you may be forced to use it, for example if later in expression will be back-reference or (?(assertion)YesPattern|NoPattern):
  • the regex (?:(100)|\d{3}) apples (?(1)YesPattern|NoPattern) in plenty cases will find '100 apples NoPattern' because if YesPattern faled, search will backtrack to the beginning and try next alternative and yes, '100' also 3-digits number.
  • the regex (?>(100)|\d{3}) apples (?(1)YesPattern|NoPattern) will only search '100 apples YesPattern' even if YesPattern faled, and 'xxx apples NoPattern' only if xxx<>100.

While I find the statement "macro documentation is non-existent" in Community Forum post "Adding Vertical Lines" rather harsh, I do see a need to better link the overview macro documentation to the config-file docs.

The user manual of Notepad++ has been deployed here (generated by Hugo, by using Hugo book theme), it looks and feels much better, and easier for the navigation:
http://u725080053.hostingerapp.com/

It needs a good domain name (blablabla.org). Any idea for the new domain name ?

ps. The navigation on smartphone is awesome too!

You don't understand Xinjiang at all, please shut up when you don't understand.
Pride is the original sin.

This SET/GET is another pair of messages added in v7.9.2, and needs documentation. (#142 documented the other new messsage already).

I'll try to get it documented this weekend

Need to add -z and -notepadStyleCmdline to the content/docs/command-prompt.md.

Both are used in "Other Resources: Notepad Replacement" section of these docs.

Also, more info can be found and since @Ekopalypse showed a way to use it to pass arguments to the PythonScript plugin in this forum post.

code references:

• https://github.com/notepad-plus-plus/notepad-plus-plus/blob/3de506bf48c53c424ef1e52d623f1d949465102b/PowerEditor/src/winmain.cpp#L325
• https://github.com/notepad-plus-plus/notepad-plus-plus/blob/3de506bf48c53c424ef1e52d623f1d949465102b/PowerEditor/src/winmain.cpp#L374-L378

After upgrading NPP the per user localization file nativeLang.xml is not automatically updated. New users are often not aware of this. Perhaps, there could be a Note in "Preferences : General : Localization" (or "Getting started : Install Notepad++")? For example,

After upgrading you may need to refresh the Localization in Settings > Preferences > General.
Change the Localization to another language, then change it back immediately to your preferred
language.

As English is not my mother tongue, this needs to be rephrased into proper English, but I hope the intention is clear. ;)

notepad-plus-plus/notepad-plus-plus#9387

Currently the NPPM_* messages are hard to locate as they are unsorted.

I would have sworn that when v1.3 released for the doc website, the new Configuration Files Details page (config-files.md) was there. But when I went to check something today, it shows up as file-not-found. Moreover, the Plugin Communication page (plugin-communication.md) is also not showing up, when I know it was there, too (both in v1.2 and v1.3).

I've tried multiple browsers, and connecting via my cell network rather than wifi, and it's the same results: those links aren't in the menu bar, and if i try to manually browse to https://npp-user-manual.org/docs/plugin-communication/ or https://npp-user-manual.org/docs/config-files/ , I get a 404 file-not-found error.

However, If I go to https://github.com/notepad-plus-plus/npp-usermanual/releases/latest and download the zip file for v1.3, both those files are definitely there.

If I use the hugo client to make a local server from the docs, the links to the Plugin Communication and Configuration Files Details links are both there, and both work just fine.

Further investigation: the website seems to be back at v1.1. I looked for the changes between v1.1 and v1.3 (1.1...master), and none of those changes are there -- the themes.md is still just "coming soon", Don's fix to the downloads vs download in getting-started.md isn't there.

(Yes, in my experiments above, I cleared my browser cache; that's also why I tried an alternate browser, which I had never used for the docs website before -- just in case the cache wasn't clearing properly.)

Can someone else confirm they see it, too? Or, despite checking on cell vs wifi, is it just a problem on my end?

Is there something going wrong with the webserver? Did it somehow revert to an older version of the docs, or is it serving from a backup/cache rather than the latest upload? I'm almost wondering whether the host has a round-robin server for npp-user-manual.org, and right now it's serving up from a machine that still has v1.1, instead of a machine that has v1.3.

per this post, there is a new library for D-language programming of NPP plugins. it should be linked from plugins/#in-other-languages

the heading Fuction completion is misspelled on the second section on the Auto-completion page.
https://npp-user-manual.org/docs/auto-completion/

This would be hugely helpful for deployments through Intune and/or scripting. I know /S configures silent install, but having documentation for all the other configuration settings would be useful.

It's been talked about multiple times in the forums, but this recent post was enough for me to create an issue about it.

Multiple users (myself included) would like there to be a central "official" list of example UDL definition files, like used to be at NppWiki++ > User Defined Language Files (as archived at web.archive.org).

If we want it to be central/official, the two best ideas that I've seen are

1. The idea expressed in that post, which is creating a new repo like "https://github.com/notepad-plus-plus/nppUDLList". To expand on the idea, it could be run by the notepad-user-manual-admin group, but just not be published anywhere (other than the main branch of the github). Users would be able to submit pull requests to add files, and the admins (primarily me, presumably) would be responsible for verifying it's not spam, and making sure it fits into the repo correctly.

2. It could just be a page in the existing npp-usermanual repo (or page section). Part of me likes that idea, because it uses the existing repo, and would also be published to the npp-user-manual.org site... but since it makes more sense for each language to be its own file, I'm not sure we want to clutter the npp-user-manual website with that many files.

To implement idea 1, I believe @donho would have to create that empty repo. After that, I'd be willing to scrape the old web.archive to grab the old UDL files, and start uploading those files as the initial basis for the new repo.

If idea 2 (or some other idea), I'd like comments for how it might be implemented

notepad-plus-plus/notepad-plus-plus#9396

per Community forum, there is some ambiguity in the phrasing of the "In Selection".

• On the Find tab, it technically only applies to the Count, not the Find Next button (it shows this by being in a group-box in the dialog)
• On the Replace tab, it only applies to the Replace All, not the Find Next or Replace buttons (it shows this by being in a group-box in the dialog)
• On the Mark tab, it's not in a group-box; however, while Mark All obeys the checkbox, and Clear All Marks both clears marks in the whole document, not just in the selection.

I'd probably phrase it something like

(The **In selection** checkbox applies only to the **Count** in **Find**, only to the **Replace All** in **Replace**, and only to the **Mark All** in **Mark**)

[:name:] should've been [[:name:]] under this description:

Found here: https://npp-user-manual.org/docs/searching/

Never explained that that whole thing alone had to be in brackets.

Per codebase PR#9287 , the new -settingsDir argument (which takes priority over the other four) will be available in the next version.

This builds on the work in issue #139 & PR #140 for config-files.md
This also requires updating command-prompt.md for the new option

In searching.md the links to www.boost.org use protocol http:// and version 1_55_0. The SciLexer.dll build instructions reference Boost version 1.70.0. Hence, it would seem logical to use version 1_70_0 in the www.boost.org links, and also use protocol https://.

I suggest replacing

http://www.boost.org/doc/libs/1_55_0/libs/regex/doc/html/boost_regex/syntax/perl_syntax.html

with

https://www.boost.org/doc/libs/1_70_0/libs/regex/doc/html/boost_regex/syntax/perl_syntax.html

and replacing

http://www.boost.org/doc/libs/1_55_0/libs/regex/doc/html/boost_regex/format/boost_format_syntax.html

with

https://www.boost.org/doc/libs/1_70_0/libs/regex/doc/html/boost_regex/format/boost_format_syntax.html

See here: Control flow

Inside of assertion syntax part of

• (?(assertion)YesPattern|NoPattern) there are multiple typos.
  Here are how it is (bold - typos):

  • (ℕ) ⇒ true if ℕth unnamed group was previously defined

  • (?<name>) or (?'name') ⇒ true if group called name was previously defined

  • (?=lookahead) ⇒ true if the lookahead expression matches

  • (?!lookahead) ⇒ true if the lookahead expression does not match

  • (?<=lookbehind) ⇒ true if the lookbehind expression matches

  • (?<!lookbehind) ⇒ true if the lookbehind expression does not match

  • (?(R)) ⇒ true if inside a recursion

  • (?(Rℕ) ⇒ true if in a recursion to subexpression numbered ℕ

  • (?(R&name)) ⇒ true if in a recursion to named subexpression name

• and how it must be:
  boost_regex.syntax.perl_syntax.conditional_expressions

  • (ℕ) ⇒ true if ℕth unnamed group was previously defined

  • (<name>) or ('name') ⇒ true if group called name was previously defined

  • (?=lookahead) ⇒ true if the lookahead expression matches

  • (?!lookahead) ⇒ true if the lookahead expression does not match

  • (?<=lookbehind) ⇒ true if the lookbehind expression matches

  • (?<!lookbehind) ⇒ true if the lookbehind expression does not match

  • (R) ⇒ true if inside a recursion

  • (Rℕ) ⇒ true if in a recursion to subexpression numbered ℕ

  • (R&name) ⇒ true if in a recursion to named subexpression name

P.S:
All this typos were found when I painfully did example for #112 so all corrections tested before.
P.P.S.:
In the boost_regex.syntax.perl_syntax.conditional_expressions lookbehind assertions not defined, but I tested them and all working.

Tried to test updated version of NppRexExtractorPlugin as described here: https://npp-user-manual.org/docs/plugins/#test-your-plugins-locally

But links to the tools located at https://notepad-plus-plus.org/pluginListTestTools are dead. Where I can download the tools?

See notepad-plus-plus/nppPluginList#142

should link to https://github.com/notepad-plus-plus/notepad-plus-plus/blob/master/PowerEditor/src/menuCmdID.h

https://npp-user-manual.org/docs/searching/#example-3

There stated:

Search ^(?=.)$
Replace with file:///
Click Replace all
This adds file:/// to the beginning of all non-empty lines

This pattern not working, proper pattern wold be ^(?=.+$)

Typo in Plugins Communications, see
https://github.com/notepad-plus-plus/notepad-plus-plus/blob/master/PowerEditor/src/MISC/PluginsManager/Notepad_plus_msgs.h#L392

NPP issue