1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
1001
1002
1003
1004
1005
1006
1007
1008
1009
1010
1011
1012
1013
1014
1015
1016
1017
1018
1019
1020
1021
1022
1023
1024
1025
1026
1027
1028
1029
1030
1031
1032
1033
1034
1035
1036
1037
1038
1039
1040
1041
1042
1043
1044
1045
1046
1047
1048
1049
1050
1051
1052
1053
1054
1055
1056
1057
1058
1059
1060
1061
1062
1063
1064
1065
1066
1067
1068
1069
1070
1071
1072
1073
1074
1075
1076
1077
1078
1079
1080
1081
1082
1083
1084
1085
1086
1087
1088
1089
1090
1091
1092
1093
1094
1095
1096
1097
1098
1099
1100
1101
1102
1103
1104
1105
1106
1107
1108
1109
1110
1111
1112
1113
1114
1115
1116
1117
1118
1119
1120
1121
1122
1123
1124
1125
1126
1127
1128
1129
1130
1131
1132
1133
1134
1135
1136
1137
1138
1139
1140
1141
1142
1143
1144
1145
1146
1147
1148
|
<!-- Creator : groff version 1.22.2 -->
<!-- CreationDate: Sun Mar 22 23:46:10 2015 -->
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta name="generator" content="groff -Thtml, see www.gnu.org">
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
<meta name="Content-Style" content="text/css">
<style type="text/css">
p { margin-top: 0; margin-bottom: 0; vertical-align: top }
pre { margin-top: 0; margin-bottom: 0; vertical-align: top }
table { margin-top: 0; margin-bottom: 0; vertical-align: top }
h1 { text-align: center }
</style>
<title>NANORC</title>
</head>
<body>
<h1 align="center">NANORC</h1>
<a href="#NAME">NAME</a><br>
<a href="#DESCRIPTION">DESCRIPTION</a><br>
<a href="#OPTIONS">OPTIONS</a><br>
<a href="#SYNTAX HIGHLIGHTING">SYNTAX HIGHLIGHTING</a><br>
<a href="#REBINDING KEYS">REBINDING KEYS</a><br>
<a href="#FILES">FILES</a><br>
<a href="#SEE ALSO">SEE ALSO</a><br>
<a href="#AUTHOR">AUTHOR</a><br>
<hr>
<h2>NAME
<a name="NAME"></a>
</h2>
<p style="margin-left:11%; margin-top: 1em">nanorc −
GNU nano’s rcfile</p>
<h2>DESCRIPTION
<a name="DESCRIPTION"></a>
</h2>
<p style="margin-left:11%; margin-top: 1em">The
<i>nanorc</i> file contains the default settings for
<b>nano</b>, a small and friendly editor. The file should be
in Unix format, not in DOS or Mac format. During startup,
<b>nano</b> will first read the system-wide settings, from
<b>/etc/nanorc</b> (the exact path might be different), and
then the user-specific settings, from <b>~/.nanorc</b>.</p>
<h2>OPTIONS
<a name="OPTIONS"></a>
</h2>
<p style="margin-left:11%; margin-top: 1em">The
configuration file accepts a series of <b>set</b> and
<b>unset</b> commands, which can be used to configure nano
on startup without using command-line options. Additionally,
there are some commands to define syntax highlighting and to
rebind keys -- see the two separate sections on those.
<b>nano</b> reads one command per line.</p>
<p style="margin-left:11%; margin-top: 1em">Options in
<i>nanorc</i> files take precedence over nano’s
defaults, and command-line options override <i>nanorc</i>
settings. Also, options that do not take an argument are
unset by default. So using the <b>unset</b> command is only
needed when wanting to override a setting of the
system’s <i>nanorc</i> file in your own
<b>~/.nanorc</b>. Options that take an argument cannot be
unset.</p>
<p style="margin-left:11%; margin-top: 1em">Below, the
<i>string</i> parameters need to be enclosed in double
quotes. Quotes inside these string parameters don’t
have to be escaped with backslashes. The last double quote
in the string will be treated as its end. For example, for
the <b>brackets</b> option,
"<b>"’)>]}</b>" will match
<b>"</b>, <b>’</b>, <b>)</b>, <b>></b>,
<b>]</b>, and <b>}</b>.</p>
<p style="margin-left:11%; margin-top: 1em">The supported
commands and arguments are: <b><br>
set allow_insecure_backup</b></p>
<p style="margin-left:15%;">When backing up files, allow
the backup to succeed even if its permissions can’t be
(re)set due to special OS considerations. You should NOT
enable this option unless you are sure you need it.</p>
<p style="margin-left:11%;"><b>set autoindent</b></p>
<p style="margin-left:15%;">Use auto-indentation.</p>
<p style="margin-left:11%;"><b>set backup</b></p>
<p style="margin-left:15%;">Create backup files by adding a
tilde (<b>~</b>) to each file’s name.</p>
<p style="margin-left:11%;"><b>set backupdir</b>
<i>directory</i></p>
<p style="margin-left:15%;">Set the directory where
<b>nano</b> puts unique backup files, if file backups are
enabled.</p>
<p style="margin-left:11%;"><b>set backwards</b></p>
<p style="margin-left:15%;">Do backwards searches by
default.</p>
<p style="margin-left:11%;"><b>set boldtext</b></p>
<p style="margin-left:15%;">Use bold instead of reverse
video for the titlebar, statusbar, key combos, and selected
text. This can be overridden for the first three by setting
the options <b>titlecolor</b>, <b>statuscolor</b>, and
<b>keycolor</b>.</p>
<p style="margin-left:11%;"><b>set brackets</b>
<i>string</i></p>
<p style="margin-left:15%;">Set the characters treated as
closing brackets when justifying paragraphs. This may not
include blank characters. Only closing punctuation (see
<b>punct</b>), optionally followed by the specified closing
brackets, can end sentences. The default value is
"<b>"’)>]}</b>".</p>
<p style="margin-left:11%;"><b>set casesensitive</b></p>
<p style="margin-left:15%;">Do case-sensitive searches by
default.</p>
<p style="margin-left:11%;"><b>set const</b></p>
<p style="margin-left:15%;">Constantly display the cursor
position in the status bar.</p>
<p style="margin-left:11%;"><b>set cut</b></p>
<p style="margin-left:15%;">Use cut-to-end-of-line by
default, instead of cutting the whole line.</p>
<p style="margin-left:11%;"><b>set fill</b>
<i>number</i></p>
<p style="margin-left:15%;">Hard-wrap lines at column
number <i>number</i>. If <i>number</i> is 0 or less, the
maximum line length will be the screen width less
<i>number</i> columns. The default value is
<b>−8</b>.</p>
<p style="margin-left:11%;"><b>set functioncolor</b>
<i>fgcolor</i>,<i>bgcolor</i></p>
<p style="margin-left:15%;">Specify the color combination
to use for the function descriptions in the two help lines
at the bottom of the screen. See <b>set titlecolor</b> for
more details.</p>
<p style="margin-left:11%;"><b>set historylog</b></p>
<p style="margin-left:15%;">Enable the use of
<b>~/.nano/search_history</b> for saving and reading
search/replace strings.</p>
<p style="margin-left:11%;"><b>set keycolor</b>
<i>fgcolor</i>,<i>bgcolor</i></p>
<p style="margin-left:15%;">Specify the color combination
to use for the shortcut key combos in the two help lines at
the bottom of the screen. See <b>set titlecolor</b> for more
details.</p>
<p style="margin-left:11%;"><b>set locking</b></p>
<p style="margin-left:15%;">Enable vim-style lock-files for
when editing files.</p>
<p style="margin-left:11%;"><b>set matchbrackets</b>
<i>string</i></p>
<p style="margin-left:15%;">Set the opening and closing
brackets that can be found by bracket searches. This may not
include blank characters. The opening set must come before
the closing set, and the two sets must be in the same order.
The default value is "<b>(<[{)>]}</b>".</p>
<p style="margin-left:11%;"><b>set morespace</b></p>
<p style="margin-left:15%;">Use the blank line below the
titlebar as extra editing space.</p>
<p style="margin-left:11%;"><b>set mouse</b></p>
<p style="margin-left:15%;">Enable mouse support, if
available for your system. When enabled, mouse clicks can be
used to place the cursor, set the mark (with a double
click), and execute shortcuts. The mouse will work in the X
Window System, and on the console when gpm is running. Text
can still be selected through dragging by holding down the
Shift key.</p>
<p style="margin-left:11%;"><b>set multibuffer</b></p>
<p style="margin-left:15%;">Allow inserting files into
their own buffers.</p>
<p style="margin-left:11%;"><b>set noconvert</b></p>
<p style="margin-left:15%;">Don’t convert files from
DOS/Mac format.</p>
<p style="margin-left:11%;"><b>set nofollow</b></p>
<p style="margin-left:15%;">Don’t follow symlinks
when writing files.</p>
<p style="margin-left:11%;"><b>set nohelp</b></p>
<p style="margin-left:15%;">Don’t display the two
help lines at the bottom of the screen.</p>
<p style="margin-left:11%;"><b>set nonewlines</b></p>
<p style="margin-left:15%;">Don’t automatically add a
newline to the ends of files.</p>
<p style="margin-left:11%;"><b>set nowrap</b></p>
<p style="margin-left:15%;">Don’t hard-wrap text at
all.</p>
<p style="margin-left:11%;"><b>set operatingdir</b>
<i>directory</i></p>
<p style="margin-left:15%;"><b>nano</b> will only read and
write files inside <i>directory</i> and its subdirectories.
Also, the current directory is changed to here, so files are
inserted from this directory. By default, the operating
directory feature is turned off.</p>
<p style="margin-left:11%;"><b>set poslog</b></p>
<p style="margin-left:15%;">Save the cursor position of
files between editing sessions.</p>
<p style="margin-left:11%;"><b>set preserve</b></p>
<p style="margin-left:15%;">Preserve the XON and XOFF keys
(^Q and ^S).</p>
<p style="margin-left:11%;"><b>set punct</b>
<i>string</i></p>
<p style="margin-left:15%;">Set the characters treated as
closing punctuation when justifying paragraphs. This may not
include blank characters. Only the specfified closing
punctuation, optionally followed by closing brackets (see
<b>brackets</b>), can end sentences. The default value is
"<b>!.?</b>".</p>
<p style="margin-left:11%;"><b>set quickblank</b></p>
<p style="margin-left:15%;">Do quick statusbar blanking.
Statusbar messages will disappear after 1 keystroke instead
of 25.</p>
<p style="margin-left:11%;"><b>set quiet</b></p>
<p style="margin-left:15%;"><b>nano</b> will not report
errors in the <i>nanorc</i> file nor ask them to be
acknowledged by pressing Enter at startup. If this is used,
it should be placed at the top of the file to be fully
effective.</p>
<p style="margin-left:11%;"><b>set quotestr</b>
<i>string</i></p>
<p style="margin-left:15%;">The email-quote string, used to
justify email-quoted paragraphs. This is an extended regular
expression if your system supports them, otherwise a literal
string. The default value is
"<b>^([ \t]*[#:>\|}])+</b>" if you have
extended regular expression support, and
"<b>> </b>" otherwise. Note that
’\t’ stands for a literal Tab character.</p>
<p style="margin-left:11%;"><b>set rebinddelete</b></p>
<p style="margin-left:15%;">Interpret the Delete key
differently so that both Backspace and Delete work properly.
You should only need to use this option if Backspace acts
like Delete on your system.</p>
<p style="margin-left:11%;"><b>set rebindkeypad</b></p>
<p style="margin-left:15%;">Interpret the numeric keypad
keys so that they all work properly. You should only need to
use this option if they don’t, as mouse support
won’t work properly with this option enabled.</p>
<p style="margin-left:11%;"><b>set regexp</b></p>
<p style="margin-left:15%;">Do extended regular expression
searches by default.</p>
<p style="margin-left:11%;"><b>set smarthome</b></p>
<p style="margin-left:15%;">Make the Home key smarter. When
Home is pressed anywhere but at the very beginning of
non-whitespace characters on a line, the cursor will jump to
that beginning (either forwards or backwards). If the cursor
is already at that position, it will jump to the true
beginning of the line.</p>
<p style="margin-left:11%;"><b>set smooth</b></p>
<p style="margin-left:15%;">Use smooth scrolling by
default.</p>
<p style="margin-left:11%;"><b>set softwrap</b></p>
<p style="margin-left:15%;">Enable soft line wrapping for
easier viewing of very long lines.</p>
<p style="margin-left:11%;"><b>set speller</b>
<i>spellprog</i></p>
<p style="margin-left:15%;">Use spelling checker
<i>spellprog</i> instead of the built-in one, which calls
<i>spell</i>.</p>
<p style="margin-left:11%;"><b>set statuscolor</b>
<i>fgcolor</i>,<i>bgcolor</i></p>
<p style="margin-left:15%;">Specify the color combination
to use for the statusbar. See <b>set titlecolor</b> for more
details.</p>
<p style="margin-left:11%;"><b>set suspend</b></p>
<p style="margin-left:15%;">Allow <b>nano</b> to be
suspended.</p>
<p style="margin-left:11%;"><b>set tabsize</b>
<i>number</i></p>
<p style="margin-left:15%;">Use a tab size of <i>number</i>
columns. The value of <i>number</i> must be greater than 0.
The default value is <b>8</b>.</p>
<p style="margin-left:11%;"><b>set tabstospaces</b></p>
<p style="margin-left:15%;">Convert typed tabs to
spaces.</p>
<p style="margin-left:11%;"><b>set tempfile</b></p>
<p style="margin-left:15%;">Save automatically on exit,
don’t prompt.</p>
<p style="margin-left:11%;"><b>set titlecolor</b>
<i>fgcolor</i>,<i>bgcolor</i></p>
<p style="margin-left:15%;">Specify the color combination
to use for the titlebar. Valid color names for foreground
and background are:
<b>white</b>, <b>black</b>, <b>red</b>, <b>blue</b>, <b>green</b>, <b>yellow</b>, <b>magenta</b>,
and <b>cyan</b>. And either "<i>fgcolor</i>" or
",<i>bgcolor</i>" may be left out.</p>
<p style="margin-left:11%;"><b>set view</b></p>
<p style="margin-left:15%;">Disallow file modification.</p>
<p style="margin-left:11%;"><b>set whitespace</b>
<i>string</i></p>
<p style="margin-left:15%;">Set the two characters used to
indicate the presence of tabs and spaces. They must be
single-column characters.</p>
<p style="margin-left:11%;"><b>set wordbounds</b></p>
<p style="margin-left:15%;">Detect word boundaries more
accurately by treating punctuation characters as parts of
words.</p>
<h2>SYNTAX HIGHLIGHTING
<a name="SYNTAX HIGHLIGHTING"></a>
</h2>
<p style="margin-left:11%; margin-top: 1em">Coloring the
different syntactic elements of a file is done via regular
expressions (see the <b>color</b> command below). This is
inherently imperfect, because regular expressions are not
powerful enough to fully parse a file. Nevertheless, regular
expressions can do a lot and are easy to make, so they are a
good fit for a small editor like <b>nano</b>.</p>
<p style="margin-left:11%; margin-top: 1em">A separate
syntax can be defined for each kind of file via the
following commands: <b><br>
syntax</b> "<i>str</i>"
["<i>fileregex</i>" ...]</p>
<p style="margin-left:22%;">Defines a syntax named
<i>str</i> which can be activated via the
<b>−Y</b>/<b>−−syntax</b> command-line
option, or will be automatically activated if the current
filename matches the extended regular expression
<i>fileregex</i>. All following <b>color</b> and
<b>icolor</b> statements will apply to this <i>str</i>
syntax until a new syntax is defined.</p>
<p style="margin-left:22%; margin-top: 1em">The <b>none</b>
syntax is reserved; specifying it on the command line is the
same as not having a syntax at all. The <b>default</b>
syntax is special: it takes no <i>fileregex</i>, and applies
to files that don’t match any other syntax’s
<i>fileregex</i>.</p>
<p style="margin-left:11%;"><b>linter</b> <i>program</i>
[<i>arg</i> ...]</p>
<p style="margin-left:22%;">For the currently defined
syntax, use the given <i>program</i> to invoke the linter
(this overrides the speller function when defined).</p>
<p style="margin-left:11%;"><b>formatter</b> <i>program</i>
[<i>arg</i> ...]</p>
<p style="margin-left:22%;">For the currently defined
syntax, use the given <i>program</i> to automatically
reformat text. Useful in certain programming languages (e.g.
go).</p>
<p style="margin-left:11%;"><b>header</b> <i>regex</i>
<b>...</b></p>
<p style="margin-left:22%;">For the currently defined
syntax, add one or more regexes which will be compared
against the very first line of the file to be edited, to
determine whether this syntax should be used for that
file.</p>
<p style="margin-left:11%;"><b>magic</b> <i>regex</i>
<b>...</b></p>
<p style="margin-left:22%;">For the currently defined
syntax, add one or more regexes which will be compared
against the result of querying the <b>magic</b> database
about the file to be edited, to determine whether this
syntax should be used for that file. This functionality only
works when <b>libmagic</b> is installed on the system and
will be silently ignored otherwise.</p>
<p style="margin-left:11%;"><b>color</b>
<i>fgcolor</i>,<i>bgcolor</i> "<i>regex</i>"
...</p>
<p style="margin-left:22%;">For the currently defined
syntax, display all expressions matching the extended
regular expression <i>regex</i> with foreground color
<i>fgcolor</i> and background color <i>bgcolor</i>, at least
one of which must be specified. Valid colors for foreground
and background are: white, black, red, blue, green, yellow,
magenta, and cyan. You may use the prefix "bright"
to get a stronger color highlight for the foreground. If
your terminal supports transparency, not specifying a
<i>bgcolor</i> tells <b>nano</b> to attempt to use a
transparent background.</p>
<p style="margin-left:11%;"><b>icolor</b>
<i>fgcolor</i>,<i>bgcolor</i> "<i>regex</i>"
...</p>
<p style="margin-left:22%;">Same as above, except that the
expression matching is case insensitive.</p>
<p style="margin-left:11%;"><b>color</b>
<i>fgcolor</i>,<i>bgcolor</i>
<b>start=</b>"<i>sr</i>"
<b>end=</b>"<i>er</i>"</p>
<p style="margin-left:22%;">Display expressions which start
with the extended regular expression <i>sr</i> and end with
the extended regular expression <i>er</i> with foreground
color <i>fgcolor</i> and background color <i>bgcolor</i>, at
least one of which must be specified. This allows syntax
highlighting to span multiple lines. Note that all
subsequent instances of <i>sr</i> after an initial <i>sr</i>
is found will be highlighted until the first instance of
<i>er</i>.</p>
<p style="margin-left:11%;"><b>icolor</b>
<i>fgcolor</i>,<i>bgcolor</i>
<b>start=</b>"<i>sr</i>"
<b>end=</b>"<i>er</i>"</p>
<p style="margin-left:22%;">Same as above, except that the
expression matching is case insensitive.</p>
<p style="margin-left:11%;"><b>include</b>
"<i>syntaxfile</i>"</p>
<p style="margin-left:22%;">Read in self-contained color
syntaxes from <i>syntaxfile</i>. Note that <i>syntaxfile</i>
can only contain the above commands, from <b>syntax</b> to
<b>icolor</b>.</p>
<p style="margin-left:11%;"><b>extendsyntax</b> <i>str
directive</i> [<i>arg</i> ...]</p>
<p style="margin-left:22%;">Extend the syntax previously
defined as <i>str</i> to include new information. This
allows you to add a new <i>color</i>, <i>icolor</i>,
<i>magic</i>, <i>header</i>, or <i>linter</i> directive to
an already defined syntax -- useful when you want to add to
definitions from the system-installed syntax definitions
(which are normally not writable).</p>
<h2>REBINDING KEYS
<a name="REBINDING KEYS"></a>
</h2>
<p style="margin-left:11%; margin-top: 1em">Key bindings
may be reassigned via the following commands: <b><br>
bind</b> <i>key function menu</i></p>
<p style="margin-left:22%;">Rebinds the key <i>key</i> to a
new function named <i>function</i> in the context of menu
<i>menu</i> (or in all menus where the function exists by
using <b>all</b>).</p>
<p style="margin-left:11%;"><b>unbind</b> <i>key
menu</i></p>
<p style="margin-left:22%;">Unbinds the key <i>key</i> from
the menu named <i>menu</i> (or from all menus where it
exists by using <b>all</b>).</p>
<p style="margin-left:11%;">The format of <i>key</i> should
be one of:</p>
<table width="100%" border="0" rules="none" frame="void"
cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
<td width="15%"></td>
<td width="3%">
<p><b>^</b></p></td>
<td width="2%"></td>
<td width="80%">
<p>followed by an alpha character or the word
"Space". Example: ^C</p></td></tr>
<tr valign="top" align="left">
<td width="15%"></td>
<td width="3%">
<p><b>M-</b></p></td>
<td width="2%"></td>
<td width="80%">
<p>followed by a printable character or the word
"Space". Example: M-C</p></td></tr>
<tr valign="top" align="left">
<td width="15%"></td>
<td width="3%">
<p><b>F</b></p></td>
<td width="2%"></td>
<td width="80%">
<p>followed by a numeric value from 1 to 16. Example:
F10</p> </td></tr>
</table>
<p style="margin-left:11%;">Valid <i>function</i> names to
be bound include:</p>
<p style="margin-left:15%;"><b>help</b></p>
<p style="margin-left:18%;">Invokes the help viewer.</p>
<p style="margin-left:15%;"><b>cancel</b></p>
<p style="margin-left:18%;">Cancels the current
command.</p>
<p style="margin-left:15%;"><b>exit</b></p>
<p style="margin-left:18%;">Exits from the program (or from
the help viewer or the file browser).</p>
<p style="margin-left:15%;"><b>writeout</b></p>
<p style="margin-left:18%;">Writes the current buffer to
disk.</p>
<p style="margin-left:15%;"><b>insert</b></p>
<p style="margin-left:18%;">Inserts a file into the current
buffer (or into a new buffer when multibuffer is
enabled).</p>
<p style="margin-left:15%;"><b>whereis</b></p>
<p style="margin-left:18%;">Searches for text in the
current buffer -- or for filenames matching a string in the
current list in the file browser.</p>
<p style="margin-left:15%;"><b>searchagain</b></p>
<p style="margin-left:18%;">Repeats the last search
command.</p>
<p style="margin-left:15%;"><b>replace</b></p>
<p style="margin-left:18%;">Interactively replaces text
within the current buffer.</p>
<p style="margin-left:15%;"><b>cut</b></p>
<p style="margin-left:18%;">Cuts and stores the current
line (or the marked region).</p>
<p style="margin-left:15%;"><b>copytext</b></p>
<p style="margin-left:18%;">Copies the current line (or the
marked region) without deleting it.</p>
<p style="margin-left:15%;"><b>uncut</b></p>
<p style="margin-left:18%;">Copies the currently stored
text into the current buffer at the current cursor
position.</p>
<p style="margin-left:15%;"><b>mark</b></p>
<p style="margin-left:18%;">Sets the mark at the current
position, to start selecting text.</p>
<p style="margin-left:15%;"><b>cutrestoffile</b></p>
<p style="margin-left:18%;">Cuts all text from the cursor
position till the end of the buffer.</p>
<p style="margin-left:15%;"><b>curpos</b></p>
<p style="margin-left:18%;">Shows the current cursor
position: the line, column, and character positions.</p>
<p style="margin-left:15%;"><b>wordcount</b></p>
<p style="margin-left:18%;">Counts the number of words,
lines and characters in the current buffer.</p>
<p style="margin-left:15%;"><b>speller</b></p>
<p style="margin-left:18%;">Invokes a spell-checking
program (or a linting program, if the current syntax
highlighting defines one).</p>
<p style="margin-left:15%;"><b>justify</b></p>
<p style="margin-left:18%;">Justifies the current
paragraph.</p>
<p style="margin-left:15%;"><b>fulljustify</b></p>
<p style="margin-left:18%;">Justifies the entire current
buffer.</p>
<p style="margin-left:15%;"><b>indent</b></p>
<p style="margin-left:18%;">Indents (shifts to the right)
the currently marked text.</p>
<p style="margin-left:15%;"><b>unindent</b></p>
<p style="margin-left:18%;">Unindents (shifts to the left)
the currently marked text.</p>
<p style="margin-left:15%;"><b>left</b></p>
<p style="margin-left:18%;">Goes left one position (in the
editor or browser).</p>
<p style="margin-left:15%;"><b>right</b></p>
<p style="margin-left:18%;">Goes right one position (in the
editor or browser).</p>
<p style="margin-left:15%;"><b>up</b></p>
<p style="margin-left:18%;">Goes one line up (in the editor
or browser).</p>
<p style="margin-left:15%;"><b>down</b></p>
<p style="margin-left:18%;">Goes one line down (in the
editor or browser).</p>
<p style="margin-left:15%;"><b>scrollup</b></p>
<p style="margin-left:18%;">Scrolls up one line of text
from the current position.</p>
<p style="margin-left:15%;"><b>scrolldown</b></p>
<p style="margin-left:18%;">Scrolls down one line of text
from the current position.</p>
<p style="margin-left:15%;"><b>nextword</b></p>
<p style="margin-left:18%;">Moves the cursor to the
beginning of the next word.</p>
<p style="margin-left:15%;"><b>prevword</b></p>
<p style="margin-left:18%;">Moves the cursor to the
beginning of the previous word.</p>
<p style="margin-left:15%;"><b>home</b></p>
<p style="margin-left:18%;">Moves the cursor to the
beginning of the current line.</p>
<p style="margin-left:15%;"><b>end</b></p>
<p style="margin-left:18%;">Moves the cursor to the end of
the current line.</p>
<p style="margin-left:15%;"><b>beginpara</b></p>
<p style="margin-left:18%;">Moves the cursor to the
beginning of the current paragraph.</p>
<p style="margin-left:15%;"><b>endpara</b></p>
<p style="margin-left:18%;">Moves the cursor to the end of
the current paragraph.</p>
<p style="margin-left:15%;"><b>prevpage</b></p>
<p style="margin-left:18%;">Goes up one screenful.</p>
<p style="margin-left:15%;"><b>nextpage</b></p>
<p style="margin-left:18%;">Goes down one screenful.</p>
<p style="margin-left:15%;"><b>firstline</b></p>
<p style="margin-left:18%;">Goes to the first line of the
file.</p>
<p style="margin-left:15%;"><b>lastline</b></p>
<p style="margin-left:18%;">Goes to the last line of the
file.</p>
<p style="margin-left:15%;"><b>gotoline</b></p>
<p style="margin-left:18%;">Goes to a specific line (and
column if specified).</p>
<p style="margin-left:15%;"><b>gototext</b></p>
<p style="margin-left:18%;">Switches from targeting a line
number to searching for text.</p>
<p style="margin-left:15%;"><b>findbracket</b></p>
<p style="margin-left:18%;">Moves the cursor to the bracket
(brace, parenthesis, etc.) that matches (pairs) with the one
under the cursor.</p>
<p style="margin-left:15%;"><b>prevbuf</b></p>
<p style="margin-left:18%;">Switches to editing/viewing the
previous buffer when using multibuffer mode.</p>
<p style="margin-left:15%;"><b>nextbuf</b></p>
<p style="margin-left:18%;">Switches to editing/viewing the
next buffer when using multibuffer mode.</p>
<p style="margin-left:15%;"><b>verbatim</b></p>
<p style="margin-left:18%;">Inserts the next character
verbatim into the file.</p>
<p style="margin-left:15%;"><b>tab</b></p>
<p style="margin-left:18%;">Inserts a tab at the current
cursor location.</p>
<p style="margin-left:15%;"><b>enter</b></p>
<p style="margin-left:18%;">Inserts a new line below the
current one.</p>
<p style="margin-left:15%;"><b>delete</b></p>
<p style="margin-left:18%;">Deletes the character under the
cursor.</p>
<p style="margin-left:15%;"><b>backspace</b></p>
<p style="margin-left:18%;">Deletes the character before
the cursor.</p>
<p style="margin-left:15%;"><b>undo</b></p>
<p style="margin-left:18%;">Undoes the last performed text
action (add text, delete text, etc).</p>
<p style="margin-left:15%;"><b>redo</b></p>
<p style="margin-left:18%;">Redoes the last undone action
(i.e., it undoes an undo).</p>
<p style="margin-left:15%;"><b>refresh</b></p>
<p style="margin-left:18%;">Refreshes the screen.</p>
<p style="margin-left:15%;"><b>suspend</b></p>
<p style="margin-left:18%;">Suspends the editor (if the
suspending function is enabled, see the
"suspendenable" entry below).</p>
<p style="margin-left:15%;"><b>casesens</b></p>
<p style="margin-left:18%;">Toggles case sensitivity in
searching (search/replace menus only).</p>
<p style="margin-left:15%;"><b>regexp</b></p>
<p style="margin-left:18%;">Toggles whether
searching/replacing is based on literal strings or regular
expressions.</p>
<p style="margin-left:15%;"><b>backwards</b></p>
<p style="margin-left:18%;">Toggles whether
searching/replacing goes forward or backward.</p>
<p style="margin-left:15%;"><b>prevhistory</b></p>
<p style="margin-left:18%;">Shows the previous history
entry in the prompt menus (e.g. search).</p>
<p style="margin-left:15%;"><b>nexthistory</b></p>
<p style="margin-left:18%;">Shows the next history entry in
the prompt menus (e.g. search).</p>
<p style="margin-left:15%;"><b>flipreplace</b></p>
<p style="margin-left:18%;">Toggles between searching for
something and replacing something.</p>
<p style="margin-left:15%;"><b>flipexecute</b></p>
<p style="margin-left:18%;">Toggles between inserting a
file and executing a command.</p>
<p style="margin-left:15%;"><b>flipnewbuffer</b></p>
<p style="margin-left:18%;">Toggles between inserting into
the current buffer and into a new empty buffer.</p>
<p style="margin-left:15%;"><b>tofiles</b></p>
<p style="margin-left:18%;">Starts the file browser,
allowing to select a file from a list.</p>
<p style="margin-left:15%;"><b>gotodir</b></p>
<p style="margin-left:18%;">Goes to a directory to be
specified, allowing to browse anywhere in the
filesystem.</p>
<p style="margin-left:15%;"><b>dosformat</b></p>
<p style="margin-left:18%;">When writing a file, switches
to writing a DOS format (CR/LF).</p>
<p style="margin-left:15%;"><b>macformat</b></p>
<p style="margin-left:18%;">When writing a file, switches
to writing a Mac format.</p>
<p style="margin-left:15%;"><b>append</b></p>
<p style="margin-left:18%;">When writing a file, appends to
the end instead of overwriting.</p>
<p style="margin-left:15%;"><b>prepend</b></p>
<p style="margin-left:18%;">When writing a file,
’prepends’ (writes at the beginning) instead of
overwriting.</p>
<p style="margin-left:15%;"><b>backup</b></p>
<p style="margin-left:18%;">When writing a file, creates a
backup of the current file.</p>
<p style="margin-left:15%;"><b>firstfile</b></p>
<p style="margin-left:18%;">Goes to the first file when
using the file browser (reading or writing files).</p>
<p style="margin-left:15%;"><b>lastfile</b></p>
<p style="margin-left:18%;">Goes to the last file when
using the file browser (reading or writing files).</p>
<p style="margin-left:15%;"><b>nohelp</b></p>
<p style="margin-left:18%;">Toggles the presence of the
two-line list of key bindings at the bottom of the
screen.</p>
<p style="margin-left:15%;"><b>constupdate</b></p>
<p style="margin-left:18%;">Toggles the constant display of
the current line, column, and character positions.</p>
<p style="margin-left:15%;"><b>morespace</b></p>
<p style="margin-left:18%;">Toggles the presence of the
blank line which ’separates’ the titlebar from
the file text.</p>
<p style="margin-left:15%;"><b>smoothscroll</b></p>
<p style="margin-left:18%;">Toggles smooth scrolling (when
moving around with the arrow keys).</p>
<p style="margin-left:15%;"><b>softwrap</b></p>
<p style="margin-left:18%;">Toggles the displaying of
overlong lines on multiple screen lines.</p>
<p style="margin-left:15%;"><b>whitespacedisplay</b></p>
<p style="margin-left:18%;">Toggles the showing of
whitespace.</p>
<p style="margin-left:15%;"><b>nosyntax</b></p>
<p style="margin-left:18%;">Toggles syntax
highlighting.</p>
<p style="margin-left:15%;"><b>smarthome</b></p>
<p style="margin-left:18%;">Toggles the smartness of the
Home key.</p>
<p style="margin-left:15%;"><b>autoindent</b></p>
<p style="margin-left:18%;">Toggles whether new lines will
contain the same amount of whitespace as the preceding
line.</p>
<p style="margin-left:15%;"><b>cuttoend</b></p>
<p style="margin-left:18%;">Toggles whether cutting text
will cut the whole line or just from the current cursor
position to the end of the line.</p>
<p style="margin-left:15%;"><b>nowrap</b></p>
<p style="margin-left:18%;">Toggles whether long lines will
be hard-wrapped to the next line.</p>
<p style="margin-left:15%;"><b>tabstospaces</b></p>
<p style="margin-left:18%;">Toggles whether typed tabs will
be converted to spaces.</p>
<p style="margin-left:15%;"><b>backupfile</b></p>
<p style="margin-left:18%;">Toggles whether a backup will
be made of the file to be edited.</p>
<p style="margin-left:15%;"><b>multibuffer</b></p>
<p style="margin-left:18%;">Toggles the use of multiple
file buffers (if support for them has been compiled in).</p>
<p style="margin-left:15%;"><b>mouse</b></p>
<p style="margin-left:18%;">Toggles mouse support.</p>
<p style="margin-left:15%;"><b>noconvert</b></p>
<p style="margin-left:18%;">Toggles automatic conversion of
files from DOS/Mac format.</p>
<p style="margin-left:15%;"><b>suspendenable</b></p>
<p style="margin-left:18%;">Toggles whether the suspend
sequence (normally ^Z) will suspend the editor window.</p>
<p style="margin-left:11%;">Valid <i>menu</i> sections
are:</p>
<p style="margin-left:15%;"><b>main</b></p>
<p style="margin-left:18%;">The main editor window where
text is entered and edited.</p>
<p style="margin-left:15%;"><b>search</b></p>
<p style="margin-left:18%;">The search menu (AKA
whereis).</p>
<p style="margin-left:15%;"><b>replace</b></p>
<p style="margin-left:18%;">The ’search to
replace’ menu.</p>
<p style="margin-left:15%;"><b>replacewith</b></p>
<p style="margin-left:18%;">The ’replace with’
menu, which comes up after ’search to
replace’.</p>
<p style="margin-left:15%;"><b>gotoline</b></p>
<p style="margin-left:18%;">The ’goto line (and
column)’ menu.</p>
<p style="margin-left:15%;"><b>writeout</b></p>
<p style="margin-left:18%;">The ’write file’
menu.</p>
<p style="margin-left:15%;"><b>insert</b></p>
<p style="margin-left:18%;">The ’insert file’
menu.</p>
<p style="margin-left:15%;"><b>extcmd</b></p>
<p style="margin-left:18%;">The menu for inserting output
from an external command, reached from the insert menu.</p>
<p style="margin-left:15%;"><b>help</b></p>
<p style="margin-left:18%;">The help-viewer menu.</p>
<p style="margin-left:15%;"><b>spell</b></p>
<p style="margin-left:18%;">The interactive spell checker
Yes/no menu.</p>
<p style="margin-left:15%;"><b>linter</b></p>
<p style="margin-left:18%;">The linter menu.</p>
<p style="margin-left:15%;"><b>browser</b></p>
<p style="margin-left:18%;">The file browser for inserting
or writing a file.</p>
<p style="margin-left:15%;"><b>whereisfile</b></p>
<p style="margin-left:18%;">The ’search for a
file’ menu in the file browser.</p>
<p style="margin-left:15%;"><b>gotodir</b></p>
<p style="margin-left:18%;">The ’go to
directory’ menu in the file browser.</p>
<p style="margin-left:15%;"><b>all</b></p>
<p style="margin-left:18%;">A special name that encompasses
all menus. For <b>bind</b> it means all menus where the
specified <i>function</i> exists; for <b>unbind</b> it means
all menus where the specified <i>key</i> exists.</p>
<h2>FILES
<a name="FILES"></a>
</h2>
<p style="margin-left:11%; margin-top: 1em"><b>/etc/nanorc</b></p>
<p style="margin-left:22%;">System-wide configuration
file.</p>
<p style="margin-left:11%;"><b>~/.nanorc</b></p>
<p style="margin-left:22%;">Per-user configuration
file.</p>
<h2>SEE ALSO
<a name="SEE ALSO"></a>
</h2>
<p style="margin-left:11%; margin-top: 1em"><b>nano</b>(1)</p>
<p style="margin-left:11%; margin-top: 1em"><i>/usr/share/doc/nano/examples/nanorc.sample</i>
(or equivalent on your system)</p>
<h2>AUTHOR
<a name="AUTHOR"></a>
</h2>
<p style="margin-left:11%; margin-top: 1em">Chris
Allegretta <chrisa@asty.org>, et al (see
<i>AUTHORS</i> and <i>THANKS</i> for details). This manual
page was originally written by Jordi Mallach
<jordi@gnu.org>, for the Debian system (but may be
used by others).</p>
<hr>
</body>
</html>
|
