Skip to content

Commit df0cd6a

Browse files
committed
Add notes about ErrorList lexer
(and better crosslink between that, Views>Show Symbol, and Toolbar)
1 parent 8a69bcf commit df0cd6a

File tree

2 files changed

+40
-21
lines changed

2 files changed

+40
-21
lines changed

content/docs/programing-languages.md

Lines changed: 39 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -13,21 +13,21 @@ Around 90 Programming Languages are supported by Notepad++:
1313
| AutoIt | AviSynth | BaanC | Batch | BlitzBasic |
1414
| C | C# | C++ | CAML | CMake |
1515
| COBOL | CoffeeScript | Csound | CSS | D |
16-
| Diff | Erlang | ESCRIPT | Forth | Fortran fixed form |
17-
| Fortran free form | FreeBasic | GDScript | Go | Gui4Cli |
18-
| Haskell | Hollywood | HTML | ini | Inno Setup |
19-
| Intel HEX | Internal Search | Java | JavaScript | json |
20-
| json5 | JSP | KiXtart | LaTeX | Lisp |
21-
| Lua | Makefile | MATLAB | MMIXAL | mssql |
22-
| NFO | Nim | Nncrontab | NSIS | Objective-C |
23-
| OScript | Pascal | Perl | PHP | PostScript |
24-
| PowerShell | Properties file | PureBasic | Python | R |
25-
| Raku | RC | REBOL | registry | Ruby |
26-
| Rust | SAS | S-Record | Scheme | Shell |
27-
| Smalltalk | Spice | SQL | Swift | TCL |
28-
| Tektronix extended HEX | TeX | TOML | txt2tags | TypeScript |
29-
| Verilog | VHDL | Visual Basic | Visual Prolog | XML |
30-
| YAML | | | | |
16+
| Diff | Erlang | ErrorList | ESCRIPT | Forth |
17+
| Fortran fixed form | Fortran free form | FreeBasic | GDScript | Go |
18+
| Gui4Cli | Haskell | Hollywood | HTML | ini |
19+
| Inno Setup | Intel HEX | Internal Search | Java | JavaScript |
20+
| json | json5 | JSP | KiXtart | LaTeX |
21+
| Lisp | Lua | Makefile | MATLAB | MMIXAL |
22+
| mssql | NFO | Nim | Nncrontab | NSIS |
23+
| Objective-C | OScript | Pascal | Perl | PHP |
24+
| PostScript | PowerShell | Properties file | PureBasic | Python |
25+
| R | Raku | RC | REBOL | registry |
26+
| Ruby | Rust | SAS | S-Record | Scheme |
27+
| Shell | Smalltalk | Spice | SQL | Swift |
28+
| TCL | Tektronix extended HEX | TeX | TOML | txt2tags |
29+
| TypeScript | Verilog | VHDL | Visual Basic | Visual Prolog |
30+
| XML | YAML | | | |
3131

3232
For these languages, Notepad++ supports [syntax highlighting](../preferences/#style-configurator) (customizable),
3333
syntax folding, [auto-completion](../auto-completion/) (customizable),
@@ -42,16 +42,35 @@ on files that are over 200MB -- this prevents extreme performance slowdown cause
4242
syntax highlight extremely large files. This threshold is configurable in
4343
[Settings > Preferences > Performance](../preferences/#performance) (starting in v8.4.7).
4444

45-
### JavaScript
45+
### Notes on Specific Languages
46+
47+
#### JavaScript
4648

4749
Internally, there are actually two entries for JavaScript: in the [Style Configurator](../preferences/#style-configurator),
48-
these show up as "JavaScript" and "JavaScript (embedded)". The first is for standalone JavaScript files (usually with `.js`
49-
extension); the second is for when JavaScript is embedded in an HTML file -- so you can actually have different color rules
50-
for when the JavaScript is inside HTML and when it's a separate file. (In the [`langs.xml`](../config-files/#keyword-lists-langsxml)
51-
and [`stylers.xml`](../config-files/#highlighting-schemes-stylersxml) config files, the standalone uses `name="javascript.js"`.)
50+
these show up as "JavaScript" and "JavaScript (embedded)". The first is for
51+
standalone JavaScript files (usually with `.js` extension); the second is for when JavaScript is embedded in an HTML
52+
file -- so you can actually have different color rules for when the JavaScript is inside HTML and when it's a separate
53+
file. (In the [`langs.xml`](../config-files/#keyword-lists-langsxml) and [`stylers.xml`](../config-files/#highlighting-schemes-stylersxml)
54+
config files, the standalone uses `name="javascript.js"`.)
5255

5356
If you manually pick **Language > J > JavaScript**, the active file will use the standalone JavaScript settings.
5457

58+
#### ErrorList
59+
60+
The ErrorList language, available starting in v8.8.1, is useful for looking at logfiles, error output from compilers,
61+
and colorful terminal outputs (like from the Windows PowerShell window or a Linux shell window), or anything else which
62+
uses [ANSI escape codes](https://en.wikipedia.org/wiki/ANSI_escape_code). The syntax highlighting for this language will
63+
include coloring the various error outputs, as well as applying the _foreground_ color specified from ANSI escape codes
64+
(it will _not_ change the background color, even if the ANSI escape sequence does).
65+
66+
While this Language is active, if you toggle **[View > Show Symbol](../views/#show-symbol) > Show Control Characters &
67+
Unicode EOL** (or **Show All Characters**, or use the [Toolbar](../user-interface/#toolbar) equivalents):
68+
when control characters or all characters are
69+
shown, then ANSI escape sequences will look like <kbd>ESC</kbd>`[31m`, and will take up space in the view; when control
70+
character are not shown (or when **Show All Characters** is toggled off), then the entire escape sequence will be
71+
hidden. (This is different than in other lexers, where turning off the control character visibility would just hide the
72+
`ESC` character, but not the rest of the ANSI escape sequence.)
73+
5574
### Themes and Language Support
5675

5776
There are times when a particular Theme will not have been updated to include syntax highlighting for a given Language.

content/docs/views.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -85,7 +85,7 @@ U+FEFF | zero-width no-break space | ZWNBSP
8585

8686
- **Show All Characters**: If this option is not currently checkmarked, choosing this action will checkmark this menu entry _and_ all of the previous **Show Symbol** options at the same time, thus enabling viewing of all the special characters. If this option is currently checkmarked, choosing this action will remove the checkmark from itself and all of the previous options at the same time, thus disabling viewing of all the special characters. If you manually checkmark all the previous settings in this sub-menu, this one will automatically be checkmarked. If you manually uncheckmark one or more of the previous settings in this sub-menu, this one will be uncheckmarked.
8787

88-
- The **** toolbar button is equivalent to activing this menu action, so it will toggle whether or not all special characters are shown. It has two display modes, "active" and "inactive", which correspond to the checkmark state for the menu item.
88+
- The **** [toolbar button](../user-interface/#toolbar) is equivalent to activating this menu action, so it will toggle whether or not all special characters are shown. It has two display modes, "active" and "inactive", which correspond to the checkmark state for the menu item.
8989

9090
The remaining two entries in this sub-menu aren't affecting the glyphs of characters in the file; instead, they are showing information about Notepad++'s indentation and word-wrap:
9191

0 commit comments

Comments
 (0)