diff options
Diffstat (limited to 'doc/man/nano.1.html')
| -rw-r--r-- | doc/man/nano.1.html | 146 |
1 files changed, 76 insertions, 70 deletions
diff --git a/doc/man/nano.1.html b/doc/man/nano.1.html index 4c385fd0..283c1e02 100644 --- a/doc/man/nano.1.html +++ b/doc/man/nano.1.html @@ -1,5 +1,5 @@ -<!-- Creator : groff version 1.20.1 --> -<!-- CreationDate: Fri Mar 22 10:06:07 2013 --> +<!-- Creator : groff version 1.22.2 --> +<!-- CreationDate: Sat May 10 22:54:14 2014 --> <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> <html> @@ -48,22 +48,20 @@ Nano’s ANOther editor, an enhanced free Pico clone</p> <p style="margin-left:11%; margin-top: 1em"><b>nano</b> -<i>[OPTIONS] [[+LINE,COLUMN] FILE]...</i></p> +[<i>options</i>] +[[+<i>line</i>,<i>column</i>] <i>file</i>]...</p> <h2>DESCRIPTION <a name="DESCRIPTION"></a> </h2> -<p style="margin-left:11%; margin-top: 1em">This manual -page briefly documents the <b>nano</b> command.</p> - <p style="margin-left:11%; margin-top: 1em"><b>nano</b> is a small, free and friendly editor which aims to replace Pico, the default editor included in the non-free Pine -package. Rather than just copying Pico’s look and -feel, <b>nano</b> also implements some missing (or disabled -by default) features in Pico, such as "search and +package. On top of copying Pico’s look and feel, +<b>nano</b> also implements some missing (or disabled by +default) features in Pico, such as "search and replace" and "go to line and column number".</p> @@ -73,29 +71,12 @@ number".</p> -<p style="margin-left:11%; margin-top: 1em"><b>+</b><i>LINE</i><b>,</b><i>COLUMN</i></p> - -<p style="margin-left:22%;">Places cursor at line number -<i>LINE</i> and column number <i>COLUMN</i> (at least one of -which must be specified) on startup, instead of the default -of line 1, column 1.</p> - -<table width="100%" border="0" rules="none" frame="void" - cellspacing="0" cellpadding="0"> -<tr valign="top" align="left"> -<td width="11%"></td> -<td width="3%"> - - -<p><b>−?</b></p></td> -<td width="8%"></td> -<td width="30%"> +<p style="margin-left:11%; margin-top: 1em"><b>+</b><i>line</i><b>,</b><i>column</i></p> - -<p>Same as <b>-h (−−help)</b>.</p></td> -<td width="48%"> -</td></tr> -</table> +<p style="margin-left:22%;">Places the cursor on line +number <i>line</i> and at column number <i>column</i> (at +least one of which must be specified) on startup, instead of +the default line 1, column 1.</p> <p style="margin-left:11%;"><b>−A (−−smarthome)</b></p> @@ -112,13 +93,13 @@ beginning of the line.</p> <p style="margin-left:22%;">When saving a file, back up the previous version of it to the current filename suffixed with -a ~.</p> +a tilde (<b>~</b>).</p> <p style="margin-left:11%;"><b>−C</b> <i>dir</i> <b>(−−backupdir=</b><i>dir</i><b>)</b></p> <p style="margin-left:22%;">Set the directory where -<b>nano</b> puts unique backup files if file backups are +<b>nano</b> puts unique backup files, if file backups are enabled.</p> <p style="margin-left:11%;"><b>−D @@ -185,6 +166,12 @@ files from DOS/Mac format.</p> <p style="margin-left:22%;">Use the blank line below the titlebar as extra editing space.</p> +<p style="margin-left:11%;"><b>−P +(−−poslog)</b></p> + +<p style="margin-left:22%;">Log and later read back the +location of the cursor and place it there again.</p> + <p style="margin-left:11%;"><b>−Q</b> <i>str</i> <b>(−−quotestr=</b><i>str</i><b>)</b></p> @@ -200,12 +187,13 @@ stands for a Tab.</p> <p style="margin-left:22%;">Restricted mode: don’t read or write to any file not specified on the command line; -read any <i>nanorc</i> files; allow suspending; allow a file -to be appended to, prepended to, or saved under a different -name if it already has one; or use backup files or spell -checking. Also accessible by invoking <b>nano</b> with any -name beginning with ’r’ (e.g. -"rnano").</p> +don’t read any <i>nanorc</i> files; don’t allow +suspending; don’t allow a file to be appended to, +prepended to, or saved under a different name if it already +has one; don’t use backup files nor spell checking. +This restricted mode is also accessible by invoking +<b>nano</b> with any name beginning with ’r’ +(e.g. "rnano").</p> <p style="margin-left:11%;"><b>−S (−−smooth)</b></p> @@ -214,11 +202,11 @@ name beginning with ’r’ (e.g. will scroll line-by-line, instead of the usual chunk-by-chunk behavior.</p> -<p style="margin-left:11%;"><b>−T</b> <i>cols</i> -<b>(−−tabsize=</b><i>cols</i><b>)</b></p> +<p style="margin-left:11%;"><b>−T</b> <i>number</i> +<b>(−−tabsize=</b><i>number</i><b>)</b></p> <p style="margin-left:22%;">Set the size (width) of a tab -to <i>cols</i> columns. The value of <i>cols</i> must be +to <i>number</i> columns. The value of <i>number</i> must be greater than 0. The default value is 8.</p> <p style="margin-left:11%;"><b>−U @@ -226,7 +214,7 @@ greater than 0. The default value is 8.</p> <p style="margin-left:22%;">Do quick statusbar blanking. Statusbar messages will disappear after 1 keystroke instead -of 25. Note that <b>-c</b> overrides this.</p> +of 25. Note that <b>−c</b> overrides this.</p> <p style="margin-left:11%;"><b>−V (−−version)</b></p> @@ -252,7 +240,7 @@ available.</p> (−−const)</b></p> <p style="margin-left:22%;">Constantly show the cursor -position. Note that this overrides <b>-U</b>.</p> +position. Note that this overrides <b>−U</b>.</p> <p style="margin-left:11%;"><b>−d (−−rebinddelete)</b></p> @@ -265,8 +253,8 @@ like Delete on your system.</p> <p style="margin-left:11%;"><b>−h (−−help)</b></p> -<p style="margin-left:22%;">Show a summary of command line -options and exit.</p> +<p style="margin-left:22%;">Show a summary of the available +command-line options and exit.</p> <p style="margin-left:11%;"><b>−i (−−autoindent)</b></p> @@ -278,8 +266,10 @@ source code.</p> <p style="margin-left:11%;"><b>−k (−−cut)</b></p> -<p style="margin-left:22%;">Enable cut from cursor to end -of line.</p> +<p style="margin-left:22%;">Make the ’Cut Text’ +command (normally ^K) cut from the current cursor position +to the end of the line, instead of cutting the entire +line.</p> <p style="margin-left:11%;"><b>−l (−−nofollow)</b></p> @@ -296,7 +286,20 @@ perhaps?</p> 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.</p> +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>−n +(−−noread)</b></p> + +<p style="margin-left:22%;">Treat any name given on the +command line as a new file. This allows <b>nano</b> to write +to named pipes: it will start with a blank buffer, and will +write to the pipe when the user saves the "file". +This way <b>nano</b> can be used as an editor in combination +with for instance <b>gpg</b> without having to write +sensitive data to disk first.</p> <p style="margin-left:11%;"><b>−o</b> <i>dir</i> <b>(−−operatingdir=</b><i>dir</i><b>)</b></p> @@ -315,21 +318,22 @@ terminal.</p> (−−quiet)</b></p> <p style="margin-left:22%;">Do not report errors in the -<i>nanorc</i> file and ask them to be acknowledged by +<i>nanorc</i> file nor ask them to be acknowledged by pressing Enter at startup.</p> -<p style="margin-left:11%;"><b>−r</b> <i>cols</i> -<b>(−−fill=</b><i>cols</i><b>)</b></p> +<p style="margin-left:11%;"><b>−r</b> <i>number</i> +<b>(−−fill=</b><i>number</i><b>)</b></p> -<p style="margin-left:22%;">Wrap lines at column -<i>cols</i>. If this value is 0 or less, wrapping will occur -at the width of the screen less <i>cols</i> columns, +<p style="margin-left:22%;">Hard-wrap lines at column +<i>number</i>. If this value is 0 or less, wrapping will +occur at the width of the screen less <i>number</i> columns, allowing the wrap point to vary along with the width of the screen if the screen is resized. The default value is -−8.</p> +−8. This option conflicts with <b>−w</b> -- the +last one given takes effect.</p> -<p style="margin-left:11%;"><b>−s</b> <i>prog</i> -<b>(−−speller=</b><i>prog</i><b>)</b></p> +<p style="margin-left:11%;"><b>−s</b> <i>program</i> +<b>(−−speller=</b><i>program</i><b>)</b></p> <p style="margin-left:22%;">Enable alternative spell checker command.</p> @@ -338,45 +342,47 @@ checker command.</p> (−−tempfile)</b></p> <p style="margin-left:22%;">Always save changed buffer -without prompting. Same as Pico’s <b>-t</b> +without prompting. Same as Pico’s <b>−t</b> option.</p> <p style="margin-left:11%;"><b>−u (−−undo)</b></p> -<p style="margin-left:22%;">Enable experimental -generic-purpose undo code. By default, the undo and redo +<p style="margin-left:22%;">Enable the experimental +generic-purpose undo/redo code. The default undo and redo shortcuts are Meta-U and Meta-E, respectively.</p> <p style="margin-left:11%;"><b>−v (−−view)</b></p> -<p style="margin-left:22%;">View file (read only) mode.</p> +<p style="margin-left:22%;">View-file (read-only) mode.</p> <p style="margin-left:11%;"><b>−w (−−nowrap)</b></p> -<p style="margin-left:22%;">Disable wrapping of long -lines.</p> +<p style="margin-left:22%;">Disable the hard-wrapping of +long lines. This option conflicts with <b>−r</b> -- +the last one given takes effect.</p> <p style="margin-left:11%;"><b>−x (−−nohelp)</b></p> -<p style="margin-left:22%;">Disable help screen at bottom -of editor.</p> +<p style="margin-left:22%;">Don’t show the two help +lines at the bottom of the screen.</p> <p style="margin-left:11%;"><b>−z (−−suspend)</b></p> -<p style="margin-left:22%;">Enable suspend ability.</p> +<p style="margin-left:22%;">Enable the suspend ability.</p> <p style="margin-left:11%;"><b>−$ (−−softwrap)</b></p> <p style="margin-left:22%;">Enable ’soft -wrapping’. <b>nano</b> will attempt to display the -entire contents of a line, even if it is longer than the -screen width. Since ’$’ normally refers to a +wrapping’. This will make <b>nano</b> attempt to +display the entire contents of any line, even if it is +longer than the screen width, by continuing it over multiple +screen lines. Since ’$’ normally refers to a variable in the Unix shell, you should specify this option last when using other options (e.g. ’nano −wS$’) or pass it separately (e.g. ’nano |