1NANORC(5) File Formats Manual NANORC(5)
2
3
4
6 nanorc - GNU nano's configuration file
7
8
10 The nanorc files contain the default settings for nano, a small and
11 friendly editor. During startup, if --rcfile is not given, nano will
12 read two files: first the system-wide settings, from /etc/nanorc (the
13 exact path might be different on your system), and then the user-spe‐
14 cific settings, either from ~/.nanorc or from $XDG_CON‐
15 FIG_HOME/nano/nanorc or from ~/.config/nano/nanorc, whichever is
16 encountered first. If --rcfile is given, nano will read just the spec‐
17 ified settings file.
18
19
21 Since version 4.0, nano by default:
22
23 · does not automatically hard-wrap lines that become overlong,
24 · includes the line below the title bar in the editing area,
25 · does linewise (smooth) scrolling.
26
27 To get the old, Pico behavior back, you can use set breaklonglines, set
28 emptyline, and set jumpyscrolling.
29
30
32 The configuration file accepts a series of set and unset commands,
33 which can be used to configure nano on startup without using command-
34 line options. Additionally, there are some commands to define syntax
35 highlighting and to rebind keys -- see the two separate sections on
36 those. nano reads one command per line. All commands and keywords
37 should be written in lowercase.
38
39 Options in nanorc files take precedence over nano's defaults, and com‐
40 mand-line options override nanorc settings. Also, options that do not
41 take an argument are unset by default. So using the unset command is
42 only needed when wanting to override a setting of the system's nanorc
43 file in your own nanorc. Options that take an argument cannot be
44 unset.
45
46 Quotes inside the characters parameters below should not be escaped.
47 The last double quote on the line will be seen as the closing quote.
48
49 The supported commands and arguments are:
50
51
52 set afterends
53 Make Ctrl+Right stop at word ends instead of beginnings.
54
55 set allow_insecure_backup
56 When backing up files, allow the backup to succeed even if its per‐
57 missions can't be (re)set due to special OS considerations. You
58 should NOT enable this option unless you are sure you need it.
59
60 set atblanks
61 When soft line wrapping is enabled, make it wrap lines at blank
62 characters (tabs and spaces) instead of always at the edge of the
63 screen.
64
65 set autoindent
66 Automatically indent a newly created line to the same number of tabs
67 and/or spaces as the previous line (or as the next line if the pre‐
68 vious line is the beginning of a paragraph).
69
70 set backup
71 When saving a file, create a backup file by adding a tilde (~) to
72 the file's name.
73
74 set backupdir directory
75 Make and keep not just one backup file, but make and keep a uniquely
76 numbered one every time a file is saved -- when backups are enabled
77 with set backup or --backup or -B. The uniquely numbered files are
78 stored in the specified directory.
79
80 set boldtext
81 Use bold instead of reverse video for the title bar, status bar, key
82 combos, function tags, line numbers, and selected text. This can be
83 overridden by setting the options titlecolor, statuscolor, keycolor,
84 functioncolor, numbercolor, and selectedcolor.
85
86 set brackets "characters"
87 Set the characters treated as closing brackets when justifying para‐
88 graphs. This may not include blank characters. Only closing punc‐
89 tuation (see set punct), optionally followed by the specified clos‐
90 ing brackets, can end sentences. The default value is ""')>]}".
91
92 set breaklonglines
93 Automatically hard-wrap the current line when it becomes overlong.
94
95 set casesensitive
96 Do case-sensitive searches by default.
97
98 set constantshow
99 Constantly display the cursor position in the status bar. This
100 overrides the option quickblank.
101
102 set cutfromcursor
103 Use cut-from-cursor-to-end-of-line by default, instead of cutting
104 the whole line.
105
106 set emptyline
107 Do not use the line below the title bar, leaving it entirely blank.
108
109 set errorcolor fgcolor,bgcolor
110 Use this color combination for the status bar when an error message
111 is displayed. The default value is brightwhite,red. See set title‐
112 color for valid color names.
113
114 set fill number
115 Set the target width for justifying and automatic hard-wrapping at
116 this number of columns. If the value is 0 or less, wrapping will
117 occur at the width of the screen minus number columns, allowing the
118 wrap point to vary along with the width of the screen if the screen
119 is resized. The default value is -8.
120
121 set functioncolor fgcolor,bgcolor
122 Specify the color combination to use for the function descriptions
123 in the two help lines at the bottom of the screen. See set title‐
124 color for more details.
125
126 set guidestripe number
127 Draw a vertical stripe at the given column, to help judge the width
128 of the text. (The color of the stripe can be changed with set
129 stripecolor.)
130
131 set historylog
132 Save the last hundred search strings and replacement strings and
133 executed commands, so they can be easily reused in later sessions.
134
135 set jumpyscrolling
136 Scroll the buffer contents per half-screen instead of per line.
137
138 set keycolor fgcolor,bgcolor
139 Specify the color combination to use for the shortcut key combos in
140 the two help lines at the bottom of the screen. See set titlecolor
141 for more details.
142
143 set linenumbers
144 Display line numbers to the left of the text area.
145
146 set locking
147 Enable vim-style lock-files for when editing files.
148
149 set matchbrackets "characters"
150 Set the opening and closing brackets that can be found by bracket
151 searches. This may not include blank characters. The opening set
152 must come before the closing set, and the two sets must be in the
153 same order. The default value is "(<[{)>]}".
154
155 set morespace
156 Deprecated option since it has become the default setting. When
157 needed, use unset emptyline instead.
158
159 set mouse
160 Enable mouse support, if available for your system. When enabled,
161 mouse clicks can be used to place the cursor, set the mark (with a
162 double click), and execute shortcuts. The mouse will work in the X
163 Window System, and on the console when gpm is running. Text can
164 still be selected through dragging by holding down the Shift key.
165
166 set multibuffer
167 When reading in a file with ^R, insert it into a new buffer by
168 default.
169
170 set noconvert
171 Don't convert files from DOS/Mac format.
172
173 set nohelp
174 Don't display the two help lines at the bottom of the screen.
175
176 set nonewlines
177 Don't automatically add a newline when a text does not end with one.
178 (This can cause you to save non-POSIX text files.)
179
180 set nopauses
181 Obsolete option. Ignored.
182
183 set nowrap
184 Deprecated option since it has become the default setting. When
185 needed, use unset breaklonglines instead.
186
187 set numbercolor fgcolor,bgcolor
188 Specify the color combination to use for line numbers. See set
189 titlecolor for more details.
190
191 set operatingdir directory
192 nano will only read and write files inside directory and its subdi‐
193 rectories. Also, the current directory is changed to here, so files
194 are inserted from this directory. By default, the operating direc‐
195 tory feature is turned off.
196
197 set positionlog
198 Save the cursor position of files between editing sessions. The
199 cursor position is remembered for the 200 most-recently edited
200 files.
201
202 set preserve
203 Preserve the XON and XOFF keys (^Q and ^S).
204
205 set punct "characters"
206 Set the characters treated as closing punctuation when justifying
207 paragraphs. This may not include blank characters. Only the spec‐
208 fified closing punctuation, optionally followed by closing brackets
209 (see brackets), can end sentences. The default value is "!.?".
210
211 set quickblank
212 Do quick status-bar blanking: status-bar messages will disappear
213 after 1 keystroke instead of 25. The option constantshow overrides
214 this.
215
216 set quotestr "regex"
217 Set the regular expression for matching the quoting part of a line.
218 The default value is "^([ \t]*([!#%:;>|}]|//))+". (Note that \t
219 stands for an actual Tab character.) This makes it possible to
220 rejustify blocks of quoted text when composing email, and to rewrap
221 blocks of line comments when writing source code.
222
223 set rawsequences
224 Interpret escape sequences directly (instead of asking ncurses to
225 translate them). If you need this option to get your keyboard to
226 work properly, please report a bug. Using this option disables
227 nano's mouse support.
228
229 set rebinddelete
230 Interpret the Delete and Backspace keys differently so that both
231 Backspace and Delete work properly. You should only use this option
232 when on your system either Backspace acts like Delete or Delete acts
233 like Backspace.
234
235 set regexp
236 Do regular-expression searches by default. Regular expressions in
237 nano are of the extended type (ERE).
238
239 set selectedcolor fgcolor,bgcolor
240 Specify the color combination to use for selected text. See set
241 titlecolor for more details.
242
243 set showcursor
244 Put the cursor on the highlighted item in the file browser, to aid
245 braille users.
246
247 set smarthome
248 Make the Home key smarter. When Home is pressed anywhere but at the
249 very beginning of non-whitespace characters on a line, the cursor
250 will jump to that beginning (either forwards or backwards). If the
251 cursor is already at that position, it will jump to the true begin‐
252 ning of the line.
253
254 set smooth
255 Deprecated option since it has become the default setting. When
256 needed, use unset jumpyscrolling instead.
257
258 set softwrap
259 Display lines that exceed the screen's width over multiple screen
260 lines. (You can make this soft-wrapping occur at whitespace instead
261 of rudely at the screen's edge, by using also set atblanks.)
262
263 set speller "program [argument ...]"
264 Use the given program to do spell checking and correcting, instead
265 of using the built-in corrector that calls hunspell or GNU spell.
266
267 set statuscolor fgcolor,bgcolor
268 Specify the color combination to use for the status bar. See set
269 titlecolor for more details.
270
271 set stripecolor fgcolor,bgcolor
272 Specify the color combination to use for the vertical guiding
273 stripe. See set titlecolor for more details.
274
275 set suspendable
276 Allow nano to be suspended (with ^Z by default).
277
278 set tabsize number
279 Use a tab size of number columns. The value of number must be
280 greater than 0. The default value is 8.
281
282 set tabstospaces
283 Convert typed tabs to spaces.
284
285 set tempfile
286 Save automatically on exit, don't prompt.
287
288 set titlecolor fgcolor,bgcolor
289 Specify the color combination to use for the title bar. Valid names
290 for the foreground and background colors are: white, black, blue,
291 green, red, cyan, yellow, magenta, and normal -- where normal means
292 the default foreground or background color. The name of the fore‐
293 ground color may be prefixed with bright. And either "fgcolor" or
294 ",bgcolor" may be left out.
295
296 set trimblanks
297 Remove trailing whitespace from wrapped lines when automatic hard-
298 wrapping occurs or when text is justified.
299
300 set unix
301 Save a file by default in Unix format. This overrides nano's
302 default behavior of saving a file in the format that it had. (This
303 option has no effect when you also use set noconvert.)
304
305 set view
306 Disallow file modification: read-only mode. This mode allows the
307 user to open also other files for viewing, unless --restricted is
308 given on the command line.
309
310 set whitespace "characters"
311 Set the two characters used to indicate the presence of tabs and
312 spaces. They must be single-column characters. The default pair
313 for a UTF-8 locale is "»⋅", and for other locales ">.".
314
315 set wordbounds
316 Detect word boundaries differently by treating punctuation charac‐
317 ters as parts of words.
318
319 set wordchars "characters"
320 Specify which other characters (besides the normal alphanumeric
321 ones) should be considered as parts of words. This overrides the
322 option wordbounds.
323
324 set zap
325 Let an unmodified Backspace or Delete erase the marked region
326 (instead of a single character, and without affecting the cut‐
327 buffer).
328
329
331 Coloring the different syntactic elements of a file is done via regular
332 expressions (see the color command below). This is inherently imper‐
333 fect, because regular expressions are not powerful enough to fully
334 parse a file. Nevertheless, regular expressions can do a lot and are
335 easy to make, so they are a good fit for a small editor like nano.
336
337 All regular expressions in nano are POSIX extended regular expressions.
338 This means that ., ?, *, +, ^, $, and several other characters are spe‐
339 cial. The period . matches any single character, ? means the preceding
340 item is optional, * means the preceding item may be matched zero or
341 more times, + means the preceding item must be matched one or more
342 times, ^ matches the beginning of a line, and $ the end, \< matches the
343 start of a word, and \> the end, and \s matches a blank. It also means
344 that lookahead and lookbehind are not possible. A complete explanation
345 can be found in the manual page of GNU grep: man grep.
346
347 For each kind of file a separate syntax can be defined via the follow‐
348 ing commands:
349
350 syntax name ["fileregex" ...]
351 Start the definition of a syntax with this name. All subsequent
352 color and other such commands will be added to this syntax,
353 until a new syntax command is encountered.
354
355 When nano is run, this syntax will be automatically activated if
356 the current filename matches the extended regular expression
357 fileregex. Or the syntax can be explicitly activated by using
358 the -Y or --syntax command-line option followed by the name.
359
360 The syntax default is special: it takes no fileregex, and
361 applies to files that don't match any syntax's regexes. The
362 syntax none is reserved; specifying it on the command line is
363 the same as not having a syntax at all.
364
365 header "regex" ...
366 If from all defined syntaxes no fileregex matched, then compare
367 this regex (or regexes) against the first line of the current
368 file, to determine whether this syntax should be used for it.
369
370 magic "regex" ...
371 If no fileregex matched and no header regex matched either, then
372 compare this regex (or regexes) against the result of querying
373 the magic database about the current file, to determine whether
374 this syntax should be used for it. (This functionality only
375 works when libmagic is installed on the system and will be
376 silently ignored otherwise.)
377
378 formatter program [argument ...]
379 Run the given program on the full contents of the current buf‐
380 fer. (The current buffer is written out to a temporary file,
381 the program is run on it, and then the temporary file is read
382 back in, replacing the contents of the buffer.)
383
384 linter program [argument ...]
385 Use the given program to run a syntax check on the current buf‐
386 fer.
387
388 comment "string"
389 Use the given string for commenting and uncommenting lines. If
390 the string contains a vertical bar or pipe character (|), this
391 designates bracket-style comments; for example, "/*|*/" for CSS
392 files. The characters before the pipe are prepended to the line
393 and the characters after the pipe are appended at the end of the
394 line. If no pipe character is present, the full string is
395 prepended; for example, "#" for Python files. If empty double
396 quotes are specified, the comment/uncomment function is dis‐
397 abled; for example, "" for JSON. The default value is "#".
398
399 tabgives "string"
400 Make the <Tab> key produce the given string. Useful for lan‐
401 guages like Python that want to see only spaces for indentation.
402 This overrides the setting of the tabstospaces option.
403
404 color fgcolor,bgcolor "regex" ...
405 Paint all pieces of text that match the extended regular expres‐
406 sion regex with the given foreground and background colors, at
407 least one of which must be specified. Valid color names are:
408 white, black, blue, green, red, cyan, yellow, magenta, and nor‐
409 mal -- where normal means the default foreground or background
410 color. You may use the prefix bright for the foreground color
411 to get a stronger highlight. If your terminal supports trans‐
412 parency, not specifying a bgcolor tells nano to attempt to use a
413 transparent background.
414
415 All coloring commands are applied in the order in which they are
416 specified, which means that later commands can recolor stuff
417 that was colored earlier.
418
419 icolor fgcolor,bgcolor "regex" ...
420 Same as above, except that the matching is case insensitive.
421
422 color fgcolor,bgcolor start="fromrx" end="torx"
423 Paint all pieces of text whose start matches extended regular
424 expression fromrx and whose end matches extended regular expres‐
425 sion torx with the given foreground and background colors, at
426 least one of which must be specified. This means that, after an
427 initial instance of fromrx, all text until the first instance of
428 torx will be colored. This allows syntax highlighting to span
429 multiple lines.
430
431 icolor fgcolor,bgcolor start="fromrx" end="torx"
432 Same as above, except that the matching is case insensitive.
433
434 include "syntaxfile"
435 Read in self-contained color syntaxes from syntaxfile. Note
436 that syntaxfile may contain only the above commands, from syntax
437 to icolor.
438
439 extendsyntax name command argument ...
440 Extend the syntax previously defined as name with another com‐
441 mand. This allows adding a new color, icolor, header, magic,
442 formatter, linter, comment, or tabgives command to an already
443 defined syntax -- useful when you want to slightly improve a
444 syntax defined in one of the system-installed files (which nor‐
445 mally are not writable).
446
447
449 Key bindings can be changed via the following three commands:
450
451 bind key function menu
452 Rebinds the given key to the given function in the given menu
453 (or in all menus where the function exists when all is used).
454
455 bind key "string" menu
456 Makes the given key produce the given string in the given
457 menu (or in all menus where the key exists when all is used).
458 The string can consist of text or commands or a mix of them.
459 (To enter a command into the string, precede its keystroke
460 with M-V.)
461
462 unbind key menu
463 Unbinds the given key from the given menu (or from all menus
464 where the key exists when all is used).
465
466
467 The format of key should be one of:
468
469 ^X where X is a Latin letter, or one of several ASCII characters
470 (@, ], \, ^, _), or the word "Space". Example: ^C.
471
472 M-X where X is any ASCII character except [, or the word "Space".
473 Example: M-8.
474
475 Sh-M-X where X is a Latin letter. Example: Sh-M-U. By default,
476 each Meta+letter keystroke does the same as the corresponding
477 Shift+Meta+letter. But when any Shift+Meta bind is made,
478 that will no longer be the case, for all letters.
479
480 FN where N is a numeric value from 1 to 24. Example: F10.
481 (Often, F13 to F24 can be typed as F1 to F12 with Shift.)
482
483
484 Ins or Del.
485
486 Rebinding ^M (Enter) or ^I (Tab) is probably not a good idea. Rebind‐
487 ing ^[ (Esc) is not possible, because its keycode is the starter byte
488 of escape sequences and Meta keystrokes. On some terminals it's not
489 possible to rebind ^H (unless --raw is used) because its keycode is
490 identical to that of the Backspace key.
491
492
493 Valid function names to be bound are:
494
495 help
496 Invokes the help viewer.
497
498 cancel
499 Cancels the current command.
500
501 exit
502 Exits from the program (or from the help viewer or the file
503 browser).
504
505 writeout
506 Writes the current buffer to disk, asking for a name.
507
508 savefile
509 Writes the current file to disk without prompting.
510
511 insert
512 Inserts a file into the current buffer (at the current cursor
513 position), or into a new buffer when option multibuffer is set.
514
515 whereis
516 Starts a forward search for text in the current buffer -- or for
517 filenames matching a string in the current list in the file
518 browser.
519
520 wherewas
521 Starts a backward search for text in the current buffer -- or for
522 filenames matching a string in the current list in the file
523 browser.
524
525 findprevious
526 Searches the next occurrence in the backward direction.
527
528 findnext
529 Searches the next occurrence in the forward direction.
530
531 replace
532 Interactively replaces text within the current buffer.
533
534 cut
535 Cuts and stores the current line (or the marked region).
536
537 copy
538 Copies the current line (or the marked region) without deleting
539 it.
540
541 paste
542 Pastes the currently stored text into the current buffer at the
543 current cursor position.
544
545 zap
546 Throws away the current line (or the marked region). (This func‐
547 tion is bound by default to <Meta+Delete>.)
548
549 chopwordleft
550 Deletes from the cursor position to the beginning of the preceding
551 word. (This function is bound by default to <Shift+Ctrl+Delete>.
552 If your terminal produces ^H for <Ctrl+Backspace>, you can make
553 <Ctrl+Backspace> delete the word to the left of the cursor by
554 rebinding ^H to this function.)
555
556 chopwordright
557 Deletes from the cursor position to the beginning of the next
558 word. (This function is bound by default to <Ctrl+Delete>.)
559
560 cutrestoffile
561 Cuts all text from the cursor position till the end of the buffer.
562
563 mark
564 Sets the mark at the current position, to start selecting text.
565 Or, when it is set, unsets the mark.
566
567 curpos
568 Shows the current cursor position: the line, column, and character
569 positions.
570
571 wordcount
572 Counts the number of words, lines and characters in the current
573 buffer.
574
575 speller
576 Invokes a spell-checking program, either the default hunspell or
577 GNU spell, or the one defined by --speller or set speller.
578
579 formatter
580 Invokes a full-buffer-processing program (if the active syntax
581 defines one).
582
583 linter
584 Invokes a syntax-checking program (if the active syntax defines
585 one).
586
587 justify
588 Justifies the current paragraph. A paragraph is a group of con‐
589 tiguous lines that, apart from possibly the first line, all have
590 the same indentation. The beginning of a paragraph is detected by
591 either this lone line with a differing indentation or by a preced‐
592 ing blank line.
593
594 fulljustify
595 Justifies the entire current buffer.
596
597 indent
598 Indents (shifts to the right) the currently marked text.
599
600 unindent
601 Unindents (shifts to the left) the currently marked text.
602
603 comment
604 Comments or uncomments the current line or marked lines, using the
605 comment style specified in the active syntax.
606
607 complete
608 Completes the fragment before the cursor to a full word found
609 elsewhere in the current buffer.
610
611 left
612 Goes left one position (in the editor or browser).
613
614 right
615 Goes right one position (in the editor or browser).
616
617 up
618 Goes one line up (in the editor or browser).
619
620 down
621 Goes one line down (in the editor or browser).
622
623 scrollup
624 Scrolls the viewport up one row (meaning that the text slides
625 down) while keeping the cursor in the same text position, if pos‐
626 sible.
627
628 scrolldown
629 Scrolls the viewport down one row (meaning that the text slides
630 up) while keeping the cursor in the same text position, if possi‐
631 ble.
632
633 prevword
634 Moves the cursor to the beginning of the previous word.
635
636 nextword
637 Moves the cursor to the beginning of the next word.
638
639 home
640 Moves the cursor to the beginning of the current line.
641
642 end
643 Moves the cursor to the end of the current line.
644
645 beginpara
646 Moves the cursor to the beginning of the current paragraph.
647
648 endpara
649 Moves the cursor to the end of the current paragraph.
650
651 prevblock
652 Moves the cursor to the beginning of the current or preceding
653 block of text. (Blocks are separated by one or more blank lines.)
654
655 nextblock
656 Moves the cursor to the beginning of the next block of text.
657
658 pageup
659 Goes up one screenful.
660
661 pagedown
662 Goes down one screenful.
663
664 firstline
665 Goes to the first line of the file.
666
667 lastline
668 Goes to the last line of the file.
669
670 gotoline
671 Goes to a specific line (and column if specified). Negative num‐
672 bers count from the end of the file (and end of the line).
673
674 findbracket
675 Moves the cursor to the bracket (brace, parenthesis, etc.) that
676 matches (pairs) with the one under the cursor.
677
678 prevbuf
679 Switches to editing/viewing the previous buffer when multiple buf‐
680 fers are open.
681
682 nextbuf
683 Switches to editing/viewing the next buffer when multiple buffers
684 are open.
685
686 verbatim
687 Inserts the next keystroke verbatim into the file.
688
689 tab
690 Inserts a tab at the current cursor location.
691
692 enter
693 Inserts a new line below the current one.
694
695 delete
696 Deletes the character under the cursor.
697
698 backspace
699 Deletes the character before the cursor.
700
701 recordmacro
702 Starts the recording of keystrokes -- the keystrokes are stored as
703 a macro. When already recording, the recording is stopped.
704
705 runmacro
706 Replays the keystrokes of the last recorded macro.
707
708 undo
709 Undoes the last performed text action (add text, delete text,
710 etc).
711
712 redo
713 Redoes the last undone action (i.e., it undoes an undo).
714
715 refresh
716 Refreshes the screen.
717
718 suspend
719 Suspends the editor (if the suspending function is enabled, see
720 the suspendable toggle item below).
721
722 casesens
723 Toggles whether searching/replacing ignores or respects the case
724 of the given characters.
725
726 regexp
727 Toggles whether searching/replacing uses literal strings or regu‐
728 lar expressions.
729
730 backwards
731 Toggles whether searching/replacing goes forward or backward.
732
733 older
734 Retrieves the previous (earlier) entry at a prompt.
735
736 newer
737 Retrieves the next (later) entry at a prompt.
738
739 flipreplace
740 Toggles between searching for something and replacing something.
741
742 flipgoto
743 Toggles between searching for text and targeting a line number.
744
745 flipexecute
746 Toggles between inserting a file and executing a command.
747
748 flippipe
749 When executing a command, toggles whether the current buffer (or
750 marked region) is piped to the command.
751
752 flipnewbuffer
753 Toggles between inserting into the current buffer and into a new
754 empty buffer.
755
756 flipconvert
757 When reading in a file, toggles between converting and not con‐
758 verting it from DOS/Mac format. Converting is the default.
759
760 dosformat
761 When writing a file, switches to writing a DOS format (CR/LF).
762
763 macformat
764 When writing a file, switches to writing a Mac format.
765
766 append
767 When writing a file, appends to the end instead of overwriting.
768
769 prepend
770 When writing a file, 'prepends' (writes at the beginning) instead
771 of overwriting.
772
773 backup
774 When writing a file, creates a backup of the current file.
775
776 discardbuffer
777 When about to write a file, discard the current buffer without
778 saving. (This function is bound by default only when option
779 --tempfile is in effect.)
780
781 browser
782 Starts the file browser, allowing to select a file from a list.
783
784 gotodir
785 Goes to a directory to be specified, allowing to browse anywhere
786 in the filesystem.
787
788 firstfile
789 Goes to the first file when using the file browser (reading or
790 writing files).
791
792 lastfile
793 Goes to the last file when using the file browser (reading or
794 writing files).
795
796 nohelp
797 Toggles the presence of the two-line list of key bindings at the
798 bottom of the screen.
799
800 constantshow
801 Toggles the constant display of the current line, column, and
802 character positions.
803
804 softwrap
805 Toggles the displaying of overlong lines on multiple screen lines.
806
807 linenumbers
808 Toggles the display of line numbers in front of the text.
809
810 whitespacedisplay
811 Toggles the showing of whitespace.
812
813 nosyntax
814 Toggles syntax highlighting.
815
816 smarthome
817 Toggles the smartness of the Home key.
818
819 autoindent
820 Toggles whether a newly created line will contain the same amount
821 of leading whitespace as the preceding line -- or as the next line
822 if the preceding line is the beginning of a paragraph.
823
824 cutfromcursor
825 Toggles whether cutting text will cut the whole line or just from
826 the current cursor position to the end of the line.
827
828 nowrap
829 Toggles whether long lines will be hard-wrapped to the next line.
830
831 tabstospaces
832 Toggles whether typed tabs will be converted to spaces.
833
834 mouse
835 Toggles mouse support.
836
837 suspendable
838 Toggles whether the suspend keystroke (^Z by default) will actu‐
839 ally suspend the editor. (The old name of this function, 'sus‐
840 pendenable', is deprecated.)
841
842
843 Valid menu sections are:
844
845 main
846 The main editor window where text is entered and edited.
847
848 search
849 The search menu (AKA whereis).
850
851 replace
852 The 'search to replace' menu.
853
854 replacewith
855 The 'replace with' menu, which comes up after 'search to replace'.
856
857 yesno
858 The 'yesno' menu, where the Yes/No/All/Cancel question is asked.
859
860 gotoline
861 The 'goto line (and column)' menu.
862
863 writeout
864 The 'write file' menu.
865
866 insert
867 The 'insert file' menu.
868
869 extcmd
870 The menu for inserting output from an external command, reached
871 from the insert menu.
872
873 help
874 The help-viewer menu.
875
876 spell
877 The menu of the integrated spell checker where the user can edit a
878 misspelled word.
879
880 linter
881 The linter menu.
882
883 browser
884 The file browser for inserting or writing a file.
885
886 whereisfile
887 The 'search for a file' menu in the file browser.
888
889 gotodir
890 The 'go to directory' menu in the file browser.
891
892 all
893 A special name that encompasses all menus. For bind it means all
894 menus where the specified function exists; for unbind it means all
895 menus where the specified key exists.
896
897
899 /etc/nanorc
900 System-wide configuration file.
901
902 ~/.nanorc or $XDG_CONFIG_HOME/nano/nanorc or ~/.config/nano/nanorc
903 Per-user configuration file.
904
905
907 nano(1)
908
909
910
911April 2020 version 4.9.2 NANORC(5)