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.  It further  uses  smooth  scrolling  by  default,  and  by
12       default includes the line below the title bar into the editing area.
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       Quotes  inside  the characters  parameters below should not be escaped.
43       The last double quote on the line will be seen as the closing quote.
44
45       The supported commands and arguments are:
46
47
48       set afterends
49          Make Ctrl+Right stop at word ends instead of beginnings.
50
51       set allow_insecure_backup
52          When backing up files, allow the backup to succeed even if its  per‐
53          missions  can't  be  (re)set  due to special OS considerations.  You
54          should NOT enable this option unless you are sure you need it.
55
56       set atblanks
57          When soft line wrapping is enabled, make  it  wrap  lines  at  blank
58          characters  (tabs  and  spaces) instead of always at the edge of the
59          screen.
60
61       set autoindent
62          Automatically indent a newly created line to the same number of tabs
63          and/or  spaces as the previous line (or as the next line if the pre‐
64          vious line is the beginning of a paragraph).
65
66       set backup
67          When saving a file, create a backup file by adding a  tilde  (~)  to
68          the file's name.
69
70       set backupdir directory
71          Make and keep not just one backup file, but make and keep a uniquely
72          numbered one every time a file is saved -- when backups are  enabled
73          with  set backup or --backup or -B.  The uniquely numbered files are
74          stored in the specified directory.
75
76       set boldtext
77          Use bold instead of reverse video for the title bar, status bar, key
78          combos, function tags, line numbers, and selected text.  This can be
79          overridden by setting the options titlecolor, statuscolor, keycolor,
80          functioncolor, numbercolor, and selectedcolor.
81
82       set brackets "characters"
83          Set the characters treated as closing brackets when justifying para‐
84          graphs.  This may not include blank characters.  Only closing  punc‐
85          tuation  (see set punct), optionally followed by the specified clos‐
86          ing brackets, can end sentences.  The default value is ""')>]}".
87
88       set breaklonglines
89          Automatically hard-wrap the current line when it becomes overlong.
90
91       set casesensitive
92          Do case-sensitive searches by default.
93
94       set constantshow
95          Constantly display the cursor position  in  the  status  bar.   This
96          overrides the option quickblank.
97
98       set cutfromcursor
99          Use  cut-from-cursor-to-end-of-line  by  default, instead of cutting
100          the whole line.
101
102       set emptyline
103          Do not use the line below the title bar, leaving it entirely blank.
104
105       set errorcolor fgcolor,bgcolor
106          Use this color combination for the status bar when an error  message
107          is displayed.  The default value is brightwhite,red.  See set title‐
108          color for valid color names.
109
110       set fill number
111          Set the target width for justifying and automatic  hard-wrapping  at
112          this  number  of  columns.  If the value is 0 or less, wrapping will
113          occur at the width of the screen minus number columns, allowing  the
114          wrap  point to vary along with the width of the screen if the screen
115          is resized.  The default value is -8.
116
117       set functioncolor fgcolor,bgcolor
118          Specify the color combination to use for the  function  descriptions
119          in  the  two help lines at the bottom of the screen.  See set title‐
120          color for more details.
121
122       set guidestripe number
123          Draw a vertical stripe at the given column, to help judge the  width
124          of  the  text.   (The  color  of  the stripe can be changed with set
125          stripecolor.)
126
127       set historylog
128          Save the last hundred search strings  and  replacement  strings  and
129          executed commands, so they can be easily reused in later sessions.
130
131       set jumpyscrolling
132          Scroll the buffer contents per half-screen instead of per line.
133
134       set keycolor fgcolor,bgcolor
135          Specify  the color combination to use for the shortcut key combos in
136          the two help lines at the bottom of the screen.  See set  titlecolor
137          for more details.
138
139       set linenumbers
140          Display line numbers to the left of the text area.
141
142       set locking
143          Enable vim-style lock-files for when editing files.
144
145       set matchbrackets "characters"
146          Set  the  opening  and closing brackets that can be found by bracket
147          searches.  This may not include blank characters.  The  opening  set
148          must  come  before  the closing set, and the two sets must be in the
149          same order.  The default value is "(<[{)>]}".
150
151       set morespace
152          Deprecated option since it has become  the  default  setting.   When
153          needed, use unset emptyline instead.
154
155       set mouse
156          Enable  mouse  support, if available for your system.  When enabled,
157          mouse clicks can be used to place the cursor, set the mark  (with  a
158          double  click), and execute shortcuts.  The mouse will work in the X
159          Window System, and on the console when gpm  is  running.   Text  can
160          still be selected through dragging by holding down the Shift key.
161
162       set multibuffer
163          When  reading  in  a  file  with  ^R, insert it into a new buffer by
164          default.
165
166       set noconvert
167          Don't convert files from DOS/Mac format.
168
169       set nohelp
170          Don't display the two help lines at the bottom of the screen.
171
172       set nonewlines
173          Don't automatically add a newline when a text does not end with one.
174          (This can cause you to save non-POSIX text files.)
175
176       set nopauses
177          Don't  pause  between warnings at startup.  This means that only the
178          last one will be visible (when there are multiple ones).
179
180       set nowrap
181          Deprecated option since it has become  the  default  setting.   When
182          needed, use unset breaklonglines instead.
183
184       set numbercolor fgcolor,bgcolor
185          Specify  the  color  combination  to  use for line numbers.  See set
186          titlecolor for more details.
187
188       set operatingdir directory
189          nano will only read and write files inside directory and its  subdi‐
190          rectories.  Also, the current directory is changed to here, so files
191          are inserted from this directory.  By default, the operating  direc‐
192          tory feature is turned off.
193
194       set positionlog
195          Save  the  cursor  position  of files between editing sessions.  The
196          cursor position is  remembered  for  the  200  most-recently  edited
197          files.
198
199       set preserve
200          Preserve the XON and XOFF keys (^Q and ^S).
201
202       set punct "characters"
203          Set  the  characters  treated as closing punctuation when justifying
204          paragraphs.  This may not include blank characters.  Only the  spec‐
205          fified  closing punctuation, optionally followed by closing brackets
206          (see brackets), can end sentences.  The default value is "!.?".
207
208       set quickblank
209          Do quick status-bar blanking:  status-bar  messages  will  disappear
210          after  1 keystroke instead of 25.  The option constantshow overrides
211          this.
212
213       set quotestr "regex"
214          Set the regular expression for matching the quoting part of a  line.
215          The  default  value  is  "^([ \t]*([!#%:;>|}]|//))+".  (Note that \t
216          stands for an actual Tab character.)   This  makes  it  possible  to
217          rejustify  blocks of quoted text when composing email, and to rewrap
218          blocks of line comments when writing source code.
219
220       set rawsequences
221          Interpret escape sequences directly (instead of  asking  ncurses  to
222          translate  them).   If  you need this option to get your keyboard to
223          work properly, please report a  bug.   Using  this  option  disables
224          nano's mouse support.
225
226       set rebinddelete
227          Interpret  the  Delete  and  Backspace keys differently so that both
228          Backspace and Delete work properly.  You should only use this option
229          when on your system either Backspace acts like Delete or Delete acts
230          like Backspace.
231
232       set regexp
233          Do regular-expression searches by default.  Regular  expressions  in
234          nano are of the extended type (ERE).
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 "characters"
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 "characters"
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       All regular expressions in nano are extended regular expressions (ERE).
333       This means that ., ?, *, +, ^, $, and several other characters are spe‐
334       cial.  The period . matches any single character, ? means the preceding
335       item is optional, * means the preceding item may  be  matched  zero  or
336       more  times,  +  means  the  preceding item must be matched one or more
337       times, ^ matches the beginning of a line, and $ the end, \< matches the
338       start of a word, and \> the end, and \s matches a blank.  It also means
339       that lookahead and lookbehind are not possible.  A complete explanation
340       can be found in the manual page of GNU grep: man grep.
341
342       For  each kind of file a separate syntax can be defined via the follow‐
343       ing commands:
344
345       syntax name ["fileregex" ...]
346              Start the definition of a syntax with this name.  All subsequent
347              color  and  other  such  commands  will be added to this syntax,
348              until a new syntax command is encountered.
349
350              When nano is run, this syntax will be automatically activated if
351              the  current  filename  matches  the extended regular expression
352              fileregex.  Or the syntax can be explicitly activated  by  using
353              the -Y or --syntax command-line option followed by the name.
354
355              The  syntax  default  is  special:  it  takes  no fileregex, and
356              applies to files that don't match  any  syntax's  regexes.   The
357              syntax  none  is  reserved; specifying it on the command line is
358              the same as not having a syntax at all.
359
360       header "regex" ...
361              If from all defined syntaxes no fileregex matched, then  compare
362              this  regex  (or  regexes) against the first line of the current
363              file, to determine whether this syntax should be used for it.
364
365       magic "regex" ...
366              If no fileregex matched and no header regex matched either, then
367              compare  this  regex (or regexes) against the result of querying
368              the magic database about the current file, to determine  whether
369              this  syntax  should  be  used for it.  (This functionality only
370              works when libmagic is installed  on  the  system  and  will  be
371              silently ignored otherwise.)
372
373       linter program [arg ...]
374              Use  the given program to run a syntax check on the current buf‐
375              fer.
376
377       comment "string"
378              Use the given string for commenting and uncommenting lines.   If
379              the  string  contains a vertical bar or pipe character (|), this
380              designates bracket-style comments; for example, "/*|*/" for  CSS
381              files.  The characters before the pipe are prepended to the line
382              and the characters after the pipe are appended at the end of the
383              line.   If  no  pipe  character  is  present, the full string is
384              prepended; for example, "#" for Python files.  If  empty  double
385              quotes  are  specified,  the  comment/uncomment function is dis‐
386              abled; for example, "" for JSON.  The default value is "#".
387
388       color fgcolor,bgcolor "regex" ...
389              Display all pieces of  text  that  match  the  extended  regular
390              expression  regex  with  foreground color fgcolor and background
391              color bgcolor, at least one of which must be  specified.   Valid
392              names  for  foreground  and background colors are: white, black,
393              blue, green, red, cyan, yellow, magenta,  and  normal  --  where
394              normal  means  the  default foreground or background color.  You
395              may use the prefix bright to get a stronger color highlight  for
396              the  foreground.   If  your  terminal supports transparency, not
397              specifying a bgcolor tells nano to attempt to use a  transparent
398              background.
399
400       icolor fgcolor,bgcolor "regex" ...
401              Same as above, except that the matching is case insensitive.
402
403       color fgcolor,bgcolor start="fromrx" end="torx"
404              Display  all pieces of text whose start matches extended regular
405              expression fromrx and whose end matches extended regular expres‐
406              sion  torx  with  foreground  color fgcolor and background color
407              bgcolor, at least one of which must be  specified.   This  means
408              that,  after  an  initial instance of fromrx, all text until the
409              first instance of torx will  be  colored.   This  allows  syntax
410              highlighting to span multiple lines.
411
412       icolor fgcolor,bgcolor start="fromrx" end="torx"
413              Same as above, except that the matching is case insensitive.
414
415       include "syntaxfile"
416              Read  in  self-contained  color  syntaxes from syntaxfile.  Note
417              that syntaxfile may contain only the above commands, from syntax
418              to icolor.
419
420       extendsyntax name command [arg ...]
421              Extend  the  syntax previously defined as name with another com‐
422              mand.  This allows adding a new color,  icolor,  header,  magic,
423              comment,  or linter command to an already defined syntax -- use‐
424              ful when you want to slightly improve a syntax defined in one of
425              the system-installed files (which normally are not writable).
426
427
428       Note:  the  formatter command has been removed.  It was superseded by a
429       more general mechanism: the filtering of buffer or marked text  through
430       an  external  command.   Such filtering is done by typing ^R^X and then
431       preceding your formatter command with the pipe symbol (|).  It has  the
432       added advantage that the operation can be undone.
433
434       If  you  use  such a formatting command regularly, you could assign the
435       relevant series of keystrokes to a single key in your nanorc:
436
437              bind  M-F  "^R^X|yourformatcommand^M"  main
438
439       (Note that the ^R, ^X, and ^M are each a single, literal control  char‐
440       acter.  You can enter them by preceding each with M-V.)
441
442

REBINDING KEYS

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

FILES

877       /etc/nanorc
878              System-wide configuration file.
879
880       ~/.nanorc or $XDG_CONFIG_HOME/nano/nanorc or ~/.config/nano/nanorc
881              Per-user configuration file.
882
883

SEE ALSO

885       nano(1)
886
887
888
889June 2019                         version 4.3                        NANORC(5)
Impressum