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

NAME

6       nanorc - GNU nano's configuration file
7
8

NOTICE

10       Starting  with  version 4.0, nano no longer hard-wraps an overlong line
11       by default, uses smooth scrolling by default, and by default makes  use
12       of the line below the title bar.
13
14       If  you  want  the  old, Pico behavior back, you can use set breaklong‐
15       lines, set jumpyscrolling, and set emptyline.
16
17

DESCRIPTION

19       The nanorc file contains the default settings for  nano,  a  small  and
20       friendly  editor.  The file should be in Unix format, not in DOS or Mac
21       format.  During startup, nano will first read the system-wide settings,
22       from  /etc/nanorc  (the  exact path might be different on your system),
23       and then the user-specific settings,  either  from  ~/.nanorc  or  from
24       $XDG_CONFIG_HOME/nano/nanorc  or  from ~/.config/nano/nanorc, whichever
25       is encountered first.
26
27

OPTIONS

29       The configuration file accepts a series  of  set  and  unset  commands,
30       which  can  be used to configure nano on startup without using command-
31       line options.  Additionally, there are some commands to  define  syntax
32       highlighting  and  to  rebind  keys -- see the two separate sections on
33       those.  nano reads one command per line.
34
35       Options in nanorc files take precedence over nano's defaults, and  com‐
36       mand-line  options override nanorc settings.  Also, options that do not
37       take an argument are unset by default.  So using the unset  command  is
38       only  needed  when wanting to override a setting of the system's nanorc
39       file in your own nanorc.  Options  that  take  an  argument  cannot  be
40       unset.
41
42       Below,  the  string  parameters  need  to be enclosed in double quotes.
43       Quotes inside these string parameters don't have  to  be  escaped  with
44       backslashes.   The  last  double quote in the string will be treated as
45       its end.  For example, for the brackets option, ""')>]}" will match  ",
46       ', ), >, ], and }.
47
48       The supported commands and arguments are:
49
50
51       set afterends
52          Make Ctrl+Right stop at word ends instead of beginnings.
53
54       set allow_insecure_backup
55          When  backing up files, allow the backup to succeed even if its per‐
56          missions can't be (re)set due to  special  OS  considerations.   You
57          should NOT enable this option unless you are sure you need it.
58
59       set atblanks
60          When  soft  line  wrapping  is  enabled, make it wrap lines at blank
61          characters (tabs and spaces) instead of always at the  edge  of  the
62          screen.
63
64       set autoindent
65          Automatically indent a newly created line to the same number of tabs
66          and/or spaces as the previous line (or as the next line if the  pre‐
67          vious line is the beginning of a paragraph).
68
69       set backup
70          When  saving  a  file, create a backup file by adding a tilde (~) to
71          the file's name.
72
73       set backupdir directory
74          Make and keep not just one backup file, but make and keep a uniquely
75          numbered  one every time a file is saved -- when backups are enabled
76          with set backup or --backup or -B.  The uniquely numbered files  are
77          stored in the specified directory.
78
79       set boldtext
80          Use bold instead of reverse video for the title bar, status bar, key
81          combos, function tags, line numbers, and selected text.  This can be
82          overridden by setting the options titlecolor, statuscolor, keycolor,
83          functioncolor, numbercolor, and selectedcolor.
84
85       set brackets string
86          Set the characters treated as closing brackets when justifying para‐
87          graphs.   This may not include blank characters.  Only closing punc‐
88          tuation (see set punct), optionally followed by the specified  clos‐
89          ing brackets, can end sentences.  The default value is ""')>]}".
90
91       set breaklonglines
92          Automatically hard-wrap the current line when it becomes overlong.
93
94       set casesensitive
95          Do case-sensitive searches by default.
96
97       set constantshow
98          Constantly  display  the  cursor  position  in the status bar.  This
99          overrides the option quickblank.
100
101       set cutfromcursor
102          Use cut-from-cursor-to-end-of-line by default,  instead  of  cutting
103          the whole line.
104
105       set emptyline
106          Do not use the line below the title bar, leaving it entirely blank.
107
108       set errorcolor fgcolor,bgcolor
109          Use  this color combination for the status bar when an error message
110          is displayed.  See set titlecolor for valid color names.
111
112       set fill number
113          Set the target width for justifying and automatic  hard-wrapping  at
114          this  number  of  columns.  If the value is 0 or less, wrapping will
115          occur at the width of the screen minus number columns, allowing  the
116          wrap  point to vary along with the width of the screen if the screen
117          is resized.  The default value is -8.
118
119       set functioncolor fgcolor,bgcolor
120          Specify the color combination to use for the  function  descriptions
121          in  the  two help lines at the bottom of the screen.  See set title‐
122          color for more details.
123
124       set guidestripe number
125          Draw a vertical stripe at the given column, to help judge the  width
126          of  the  text.   (The  color  of  the stripe can be changed with set
127          stripecolor.)
128
129       set historylog
130          Save the last hundred search strings  and  replacement  strings  and
131          executed commands, so they can be easily reused in later sessions.
132
133       set jumpyscrolling
134          Scroll the buffer contents per half-screen instead of per line.
135
136       set keycolor fgcolor,bgcolor
137          Specify  the color combination to use for the shortcut key combos in
138          the two help lines at the bottom of the screen.  See set  titlecolor
139          for more details.
140
141       set linenumbers
142          Display line numbers to the left of the text area.
143
144       set locking
145          Enable vim-style lock-files for when editing files.
146
147       set matchbrackets string
148          Set  the  opening  and closing brackets that can be found by bracket
149          searches.  This may not include blank characters.  The  opening  set
150          must  come  before  the closing set, and the two sets must be in the
151          same order.  The default value is "(<[{)>]}".
152
153       set morespace
154          Deprecated option since it has become  the  default  setting.   When
155          needed, use unset emptyline instead.
156
157       set mouse
158          Enable  mouse  support, if available for your system.  When enabled,
159          mouse clicks can be used to place the cursor, set the mark  (with  a
160          double  click), and execute shortcuts.  The mouse will work in the X
161          Window System, and on the console when gpm  is  running.   Text  can
162          still be selected through dragging by holding down the Shift key.
163
164       set multibuffer
165          When  reading  in  a  file  with  ^R, insert it into a new buffer by
166          default.
167
168       set noconvert
169          Don't convert files from DOS/Mac format.
170
171       set nohelp
172          Don't display the two help lines at the bottom of the screen.
173
174       set nonewlines
175          Don't automatically add a newline when a file does not end with one.
176
177       set nopauses
178          Don't pause between warnings at startup.  This means that  only  the
179          last one will be visible (when there are multiple ones).
180
181       set nowrap
182          Deprecated  option  since  it  has become the default setting.  When
183          needed, use unset breaklonglines instead.
184
185       set numbercolor fgcolor,bgcolor
186          Specify the color combination to use  for  line  numbers.   See  set
187          titlecolor for more details.
188
189       set operatingdir directory
190          nano  will only read and write files inside directory and its subdi‐
191          rectories.  Also, the current directory is changed to here, so files
192          are  inserted from this directory.  By default, the operating direc‐
193          tory feature is turned off.
194
195       set positionlog
196          Save the cursor position of files  between  editing  sessions.   The
197          cursor  position  is  remembered  for  the  200 most-recently edited
198          files.
199
200       set preserve
201          Preserve the XON and XOFF keys (^Q and ^S).
202
203       set punct string
204          Set the characters treated as closing  punctuation  when  justifying
205          paragraphs.   This may not include blank characters.  Only the spec‐
206          fified closing punctuation, optionally followed by closing  brackets
207          (see brackets), can end sentences.  The default value is "!.?".
208
209       set quickblank
210          Do  quick  status-bar  blanking:  status-bar messages will disappear
211          after 1 keystroke instead of 25.  The option constantshow  overrides
212          this.
213
214       set quotestr regex
215          Set  the regular expression for matching the quoting part of a line.
216          The default value is "^([ \t]*([!#%:;>|}]|//|--))+".  (Note that  \t
217          stands  for  an  actual  Tab  character.)  This makes it possible to
218          rejustify blocks of quoted text when composing email, and to  rewrap
219          blocks of line comments when writing source code.
220
221       set rawsequences
222          Interpret  escape  sequences  directly (instead of asking ncurses to
223          translate them).  If you need this option to get  your  keyboard  to
224          work  properly,  please  report  a  bug.  Using this option disables
225          nano's mouse support.
226
227       set rebinddelete
228          Interpret the Delete and Backspace keys  differently  so  that  both
229          Backspace and Delete work properly.  You should only use this option
230          when on your system either Backspace acts like Delete or Delete acts
231          like Backspace.
232
233       set regexp
234          Do extended regular expression searches by default.
235
236       set selectedcolor fgcolor,bgcolor
237          Specify  the  color  combination  to use for selected text.  See set
238          titlecolor for more details.
239
240       set showcursor
241          Put the cursor on the highlighted item in the file browser,  to  aid
242          braille users.
243
244       set smarthome
245          Make the Home key smarter.  When Home is pressed anywhere but at the
246          very beginning of non-whitespace characters on a  line,  the  cursor
247          will  jump to that beginning (either forwards or backwards).  If the
248          cursor is already at that position, it will jump to the true  begin‐
249          ning of the line.
250
251       set smooth
252          Deprecated  option  since  it  has become the default setting.  When
253          needed, use unset jumpyscrolling instead.
254
255       set softwrap
256          Enable soft line wrapping for easier viewing of very long lines.
257
258       set speller program
259          Use the given program to do spell checking and  correcting,  instead
260          of the built-in corrector that calls spell.
261
262       set statuscolor fgcolor,bgcolor
263          Specify  the  color  combination to use for the status bar.  See set
264          titlecolor for more details.
265
266       set stripecolor fgcolor,bgcolor
267          Specify the color  combination  to  use  for  the  vertical  guiding
268          stripe.  See set titlecolor for more details.
269
270       set suspend
271          Allow nano to be suspended.
272
273       set tabsize number
274          Use  a  tab  size  of  number  columns.  The value of number must be
275          greater than 0.  The default value is 8.
276
277       set tabstospaces
278          Convert typed tabs to spaces.
279
280       set tempfile
281          Save automatically on exit, don't prompt.
282
283       set titlecolor fgcolor,bgcolor
284          Specify the color combination to use for the title bar.  Valid names
285          for  the  foreground  and background colors are: white, black, blue,
286          green, red, cyan, yellow, magenta, and normal -- where normal  means
287          the  default  foreground or background color.  The name of the fore‐
288          ground color may be prefixed with bright.  And either  "fgcolor"  or
289          ",bgcolor" may be left out.
290
291       set trimblanks
292          Remove  trailing  whitespace from wrapped lines when automatic hard-
293          wrapping occurs or when text is justified.
294
295       set unix
296          Save a file by  default  in  Unix  format.   This  overrides  nano's
297          default  behavior of saving a file in the format that it had.  (This
298          option has no effect when you also use set noconvert.)
299
300       set view
301          Disallow file modification: read-only mode.  This  mode  allows  the
302          user  to  open  also other files for viewing, unless --restricted is
303          given on the command line.
304
305       set whitespace string
306          Set the two characters used to indicate the  presence  of  tabs  and
307          spaces.   They  must  be single-column characters.  The default pair
308          for a UTF-8 locale is "»⋅", and for other locales ">.".
309
310       set wordbounds
311          Detect word boundaries differently by treating  punctuation  charac‐
312          ters as parts of words.
313
314       set wordchars string
315          Specify  which  other  characters  (besides  the normal alphanumeric
316          ones) should be considered as parts of words.   This  overrides  the
317          option wordbounds.
318
319       set zap
320          Let  an  unmodified  Backspace  or  Delete  erase  the marked region
321          (instead of a single  character,  and  without  affecting  the  cut‐
322          buffer).
323
324

SYNTAX HIGHLIGHTING

326       Coloring the different syntactic elements of a file is done via regular
327       expressions (see the color command below).  This is  inherently  imper‐
328       fect,  because  regular  expressions  are  not powerful enough to fully
329       parse a file.  Nevertheless, regular expressions can do a lot  and  are
330       easy to make, so they are a good fit for a small editor like nano.
331
332       For  each kind of file a separate syntax can be defined via the follow‐
333       ing commands:
334
335       syntax name ["fileregex" ...]
336              Start the definition of a syntax with this name.  All subsequent
337              color  and  other  such  commands  will be added to this syntax,
338              until a new syntax command is encountered.
339
340              When nano is run, this syntax will be automatically activated if
341              the  current  filename  matches  the extended regular expression
342              fileregex.  Or the syntax can be explicitly activated  by  using
343              the -Y or --syntax command-line option followed by the name.
344
345              The  syntax  default  is  special:  it  takes  no fileregex, and
346              applies to files that don't match  any  syntax's  regexes.   The
347              syntax  none  is  reserved; specifying it on the command line is
348              the same as not having a syntax at all.
349
350       header "regex" ...
351              If from all defined syntaxes no fileregex matched, then  compare
352              this  regex  (or  regexes) against the first line of the current
353              file, to determine whether this syntax should be used for it.
354
355       magic "regex" ...
356              If no fileregex matched and no header regex matched either, then
357              compare  this  regex (or regexes) against the result of querying
358              the magic database about the current file, to determine  whether
359              this  syntax  should  be  used for it.  (This functionality only
360              works when libmagic is installed  on  the  system  and  will  be
361              silently ignored otherwise.)
362
363       linter program [arg ...]
364              Use  the given program to run a syntax check on the current buf‐
365              fer.
366
367       comment "string"
368              Use the given string for commenting and uncommenting lines.   If
369              the  string  contains a vertical bar or pipe character (|), this
370              designates bracket-style comments; for example, "/*|*/" for  CSS
371              files.  The characters before the pipe are prepended to the line
372              and the characters after the pipe are appended at the end of the
373              line.   If  no  pipe  character  is  present, the full string is
374              prepended; for example, "#" for Python files.  If  empty  double
375              quotes  are  specified,  the  comment/uncomment function is dis‐
376              abled; for example, "" for JSON.  The default value is "#".
377
378       color fgcolor,bgcolor "regex" ...
379              Display all pieces of  text  that  match  the  extended  regular
380              expression  regex  with  foreground color fgcolor and background
381              color bgcolor, at least one of which must be  specified.   Valid
382              names  for  foreground  and background colors are: white, black,
383              blue, green, red, cyan, yellow, magenta,  and  normal  --  where
384              normal  means  the  default foreground or background color.  You
385              may use the prefix bright to get a stronger color highlight  for
386              the  foreground.   If  your  terminal supports transparency, not
387              specifying a bgcolor tells nano to attempt to use a  transparent
388              background.
389
390       icolor fgcolor,bgcolor "regex" ...
391              Same as above, except that the matching is case insensitive.
392
393       color fgcolor,bgcolor start="fromrx" end="torx"
394              Display  all pieces of text whose start matches extended regular
395              expression fromrx and whose end matches extended regular expres‐
396              sion  torx  with  foreground  color fgcolor and background color
397              bgcolor, at least one of which must be  specified.   This  means
398              that,  after  an  initial instance of fromrx, all text until the
399              first instance of torx will  be  colored.   This  allows  syntax
400              highlighting to span multiple lines.
401
402       icolor fgcolor,bgcolor start="fromrx" end="torx"
403              Same as above, except that the matching is case insensitive.
404
405       include "syntaxfile"
406              Read  in  self-contained  color  syntaxes from syntaxfile.  Note
407              that syntaxfile may contain only the above commands, from syntax
408              to icolor.
409
410       extendsyntax name command [arg ...]
411              Extend  the  syntax previously defined as name with another com‐
412              mand.  This allows adding a new color,  icolor,  header,  magic,
413              comment,  or linter command to an already defined syntax -- use‐
414              ful when you want to slightly improve a syntax defined in one of
415              the system-installed files (which normally are not writable).
416
417
418       Note:  the  formatter command has been removed.  It was superseded by a
419       more general mechanism: the filtering of buffer or marked text  through
420       an  external  command.   Such filtering is done by typing ^R^X and then
421       preceding your formatter command with the pipe symbol (|).  It has  the
422       added advantage that the operation can be undone.
423
424       If  you  use  such a formatting command regularly, you could assign the
425       relevant series of keystrokes to a single key in your nanorc:
426
427              bind  M-F  "^R^X|yourformatcommand^M"  main
428
429       (Note that the ^R, ^X, and ^M are each a single, literal control  char‐
430       acter.  You can enter them by preceding each with M-V.)
431
432

REBINDING KEYS

434       Key bindings can be changed via the following three commands:
435
436          bind key function menu
437                 Rebinds  the  key key to a new function named function in the
438                 context of menu menu (or in  all  menus  where  the  function
439                 exists by using all).
440
441          bind key "string" menu
442                 Makes  the  given  key  produce the given string in the given
443                 menu (or in all menus where the key exists when all is used).
444                 The  string can consist of text or commands or a mix of them.
445                 (To enter a command into the string,  precede  its  keystroke
446                 with M-V.)
447
448
449          unbind key menu
450                 Unbinds  the  key  key  from the menu named menu (or from all
451                 menus where it exists by using all).
452
453
454       The format of key should be one of:
455
456          ^  followed by a Latin letter, by one of  several  ASCII  characters
457             (@, ], \, ^, or _), or by the word "Space".  Example: ^C.
458
459          M- followed by any ASCII character except [, or by the word "Space".
460             Example: M-C.
461
462          F  followed by a numeric value from 1 to 16.  Example: F10.
463
464          the word "Ins" or the word "Del".
465
466
467       Valid function names to be bound are:
468
469          help
470            Invokes the help viewer.
471
472          cancel
473            Cancels the current command.
474
475          exit
476            Exits from the program (or  from  the  help  viewer  or  the  file
477            browser).
478
479          writeout
480            Writes the current buffer to disk, asking for a name.
481
482          savefile
483            Writes the current file to disk without prompting.
484
485          insert
486            Inserts  a  file  into  the  current buffer (at the current cursor
487            position), or into a new buffer when option multibuffer is set.
488
489          whereis
490            Starts a forward search for text in the current buffer --  or  for
491            filenames  matching  a  string  in  the  current  list in the file
492            browser.
493
494          wherewas
495            Starts a backward search for text in the current buffer -- or  for
496            filenames  matching  a  string  in  the  current  list in the file
497            browser.
498
499          findprevious
500            Searches the next occurrence in the backward direction.
501
502          findnext
503            Searches the next occurrence in the forward direction.
504
505          replace
506            Interactively replaces text within the current buffer.
507
508          cut
509            Cuts and stores the current line (or the marked region).
510
511          copy
512            Copies the current line (or the marked  region)  without  deleting
513            it.
514
515          paste
516            Pastes  the  currently  stored text into the current buffer at the
517            current cursor position.
518
519          zap
520            Throws away the current line (or the marked region).  (This  func‐
521            tion is bound by default to <Meta+Delete>.)
522
523          chopwordleft
524            Deletes from the cursor position to the beginning of the preceding
525            word.  (This function is bound by default to  <Shift+Ctrl+Delete>.
526            If  your  terminal  produces ^H for <Ctrl+Backspace>, you can make
527            <Ctrl+Backspace> delete the word to the  left  of  the  cursor  by
528            rebinding ^H to this function.)
529
530          chopwordright
531            Deletes  from  the  cursor  position  to the beginning of the next
532            word.  (This function is bound by default to <Ctrl+Delete>.)
533
534          cutrestoffile
535            Cuts all text from the cursor position till the end of the buffer.
536
537          mark
538            Sets the mark at the current position, to  start  selecting  text.
539            Or, when it is set, unsets the mark.
540
541          curpos
542            Shows the current cursor position: the line, column, and character
543            positions.
544
545          wordcount
546            Counts the number of words, lines and characters  in  the  current
547            buffer.
548
549          speller
550            Invokes  a  spell-checking program, either the default one, or the
551            one defined by --speller or set speller.
552
553          linter
554            Invokes a syntax-checking program (if the  active  syntax  defines
555            one).
556
557          justify
558            Justifies  the  current paragraph.  A paragraph is a group of con‐
559            tiguous lines that, apart from possibly the first line,  all  have
560            the same indentation.  The beginning of a paragraph is detected by
561            either this lone line with a differing indentation or by a preced‐
562            ing blank line.
563
564          fulljustify
565            Justifies the entire current buffer.
566
567          indent
568            Indents (shifts to the right) the currently marked text.
569
570          unindent
571            Unindents (shifts to the left) the currently marked text.
572
573          comment
574            Comments or uncomments the current line or marked lines, using the
575            comment style specified in the active syntax.
576
577          complete
578            Completes the fragment before the cursor  to  a  full  word  found
579            elsewhere in the current buffer.
580
581          left
582            Goes left one position (in the editor or browser).
583
584          right
585            Goes right one position (in the editor or browser).
586
587          up
588            Goes one line up (in the editor or browser).
589
590          down
591            Goes one line down (in the editor or browser).
592
593          scrollup
594            Scrolls  the  viewport  up  one  row (meaning that the text slides
595            down) while keeping the cursor in the same text position, if  pos‐
596            sible.
597
598          scrolldown
599            Scrolls  the  viewport  down one row (meaning that the text slides
600            up) while keeping the cursor in the same text position, if  possi‐
601            ble.
602
603          prevword
604            Moves the cursor to the beginning of the previous word.
605
606          nextword
607            Moves the cursor to the beginning of the next word.
608
609          home
610            Moves the cursor to the beginning of the current line.
611
612          end
613            Moves the cursor to the end of the current line.
614
615          beginpara
616            Moves the cursor to the beginning of the current paragraph.
617
618          endpara
619            Moves the cursor to the end of the current paragraph.
620
621          prevblock
622            Moves  the  cursor  to  the  beginning of the current or preceding
623            block of text.  (Blocks are separated by one or more blank lines.)
624
625          nextblock
626            Moves the cursor to the beginning of the next block of text.
627
628          pageup
629            Goes up one screenful.
630
631          pagedown
632            Goes down one screenful.
633
634          firstline
635            Goes to the first line of the file.
636
637          lastline
638            Goes to the last line of the file.
639
640          gotoline
641            Goes to a specific line (and column if specified).  Negative  num‐
642            bers count from the end of the file (and end of the line).
643
644          findbracket
645            Moves  the  cursor  to the bracket (brace, parenthesis, etc.) that
646            matches (pairs) with the one under the cursor.
647
648          prevbuf
649            Switches to editing/viewing the previous buffer when multiple buf‐
650            fers are open.
651
652          nextbuf
653            Switches  to editing/viewing the next buffer when multiple buffers
654            are open.
655
656          verbatim
657            Inserts the next keystroke verbatim into the file.
658
659          tab
660            Inserts a tab at the current cursor location.
661
662          enter
663            Inserts a new line below the current one.
664
665          delete
666            Deletes the character under the cursor.
667
668          backspace
669            Deletes the character before the cursor.
670
671          recordmacro
672            Starts the recording of keystrokes -- the keystrokes are stored as
673            a macro.  When already recording, the recording is stopped.
674
675          runmacro
676            Replays the keystrokes of the last recorded macro.
677
678          undo
679            Undoes  the  last  performed  text  action (add text, delete text,
680            etc).
681
682          redo
683            Redoes the last undone action (i.e., it undoes an undo).
684
685          refresh
686            Refreshes the screen.
687
688          suspend
689            Suspends the editor (if the suspending function  is  enabled,  see
690            the "suspendenable" entry below).
691
692          casesens
693            Toggles  whether  searching/replacing ignores or respects the case
694            of the given characters.
695
696          regexp
697            Toggles whether searching/replacing uses literal strings or  regu‐
698            lar expressions.
699
700          backwards
701            Toggles whether searching/replacing goes forward or backward.
702
703          older
704            Retrieves the previous (earlier) entry at a prompt.
705
706          newer
707            Retrieves the next (later) entry at a prompt.
708
709          flipreplace
710            Toggles between searching for something and replacing something.
711
712          flipgoto
713            Toggles between searching for text and targeting a line number.
714
715          flipexecute
716            Toggles between inserting a file and executing a command.
717
718          flippipe
719            When  executing  a command, toggles whether the current buffer (or
720            marked region) is piped to the command.
721
722          flipnewbuffer
723            Toggles between inserting into the current buffer and into  a  new
724            empty buffer.
725
726          flipconvert
727            When  reading  in  a file, toggles between converting and not con‐
728            verting it from DOS/Mac format.  Converting is the default.
729
730          dosformat
731            When writing a file, switches to writing a DOS format (CR/LF).
732
733          macformat
734            When writing a file, switches to writing a Mac format.
735
736          append
737            When writing a file, appends to the end instead of overwriting.
738
739          prepend
740            When writing a file, 'prepends' (writes at the beginning)  instead
741            of overwriting.
742
743          backup
744            When writing a file, creates a backup of the current file.
745
746          discardbuffer
747            When  about  to  write  a file, discard the current buffer without
748            saving.  (This function is  bound  by  default  only  when  option
749            --tempfile is in effect.)
750
751          browser
752            Starts the file browser, allowing to select a file from a list.
753
754          gotodir
755            Goes  to  a directory to be specified, allowing to browse anywhere
756            in the filesystem.
757
758          firstfile
759            Goes to the first file when using the  file  browser  (reading  or
760            writing files).
761
762          lastfile
763            Goes  to  the  last  file  when using the file browser (reading or
764            writing files).
765
766          nohelp
767            Toggles the presence of the two-line list of key bindings  at  the
768            bottom of the screen.
769
770          constantshow
771            Toggles  the  constant  display  of  the current line, column, and
772            character positions.
773
774          softwrap
775            Toggles the displaying of overlong lines on multiple screen lines.
776
777          linenumbers
778            Toggles the display of line numbers in front of the text.
779
780          whitespacedisplay
781            Toggles the showing of whitespace.
782
783          nosyntax
784            Toggles syntax highlighting.
785
786          smarthome
787            Toggles the smartness of the Home key.
788
789          autoindent
790            Toggles whether a newly created line will contain the same  amount
791            of leading whitespace as the preceding line -- or as the next line
792            if the preceding line is the beginning of a paragraph.
793
794          cutfromcursor
795            Toggles whether cutting text will cut the whole line or just  from
796            the current cursor position to the end of the line.
797
798          nowrap
799            Toggles whether long lines will be hard-wrapped to the next line.
800
801          tabstospaces
802            Toggles whether typed tabs will be converted to spaces.
803
804          mouse
805            Toggles mouse support.
806
807          suspendenable
808            Toggles  whether  the  suspend sequence (normally ^Z) will suspend
809            the editor window.
810
811
812       Valid menu sections are:
813
814          main
815            The main editor window where text is entered and edited.
816
817          search
818            The search menu (AKA whereis).
819
820          replace
821            The 'search to replace' menu.
822
823          replacewith
824            The 'replace with' menu, which comes up after 'search to replace'.
825
826          yesno
827            The 'yesno' menu, where the Yes/No/All/Cancel question is asked.
828
829          gotoline
830            The 'goto line (and column)' menu.
831
832          writeout
833            The 'write file' menu.
834
835          insert
836            The 'insert file' menu.
837
838          extcmd
839            The menu for inserting output from an  external  command,  reached
840            from the insert menu.
841
842          help
843            The help-viewer menu.
844
845          spell
846            The interactive spell checker Yes/no menu.
847
848          linter
849            The linter menu.
850
851          browser
852            The file browser for inserting or writing a file.
853
854          whereisfile
855            The 'search for a file' menu in the file browser.
856
857          gotodir
858            The 'go to directory' menu in the file browser.
859
860          all
861            A  special name that encompasses all menus.  For bind it means all
862            menus where the specified function exists; for unbind it means all
863            menus where the specified key exists.
864
865

FILES

867       /etc/nanorc
868              System-wide configuration file.
869
870       ~/.nanorc or $XDG_CONFIG_HOME/nano/nanorc or ~/.config/nano/nanorc
871              Per-user configuration file.
872
873

SEE ALSO

875       nano(1)
876
877
878
879April 2019                        version 4.2                        NANORC(5)
Impressum