1NANORC(5)                     File Formats Manual                    NANORC(5)
2
3
4

NAME

6       nanorc - GNU nano's configuration file
7
8

DESCRIPTION

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

NOTICE

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

OPTIONS

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

SYNTAX HIGHLIGHTING

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

REBINDING KEYS

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

FILES

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

SEE ALSO

907       nano(1)
908
909
910
911April 2020                       version 4.9.2                       NANORC(5)
Impressum