"Fossies" - the Fresh Open Source Software Archive

Member "ne-3.2.1/src/help.c" (2 Oct 2019, 85958 Bytes) of package /linux/misc/ne-3.2.1.tar.gz:


As a special service "Fossies" has tried to format the requested source page into HTML format using (guessed) C and C++ source code syntax highlighting (style: standard) with prefixed line numbers and code folding option. Alternatively you can here view or download the uninterpreted source code file. For more information about "help.c" see the Fossies "Dox" file reference documentation and the last Fossies "Diffs" side-by-side code changes report: 3.1.2_vs_3.2.0.

    1 /* Help strings.
    2 
    3     Copyright (C) 1993-1998 Sebastiano Vigna
    4     Copyright (C) 1999-2019 Todd M. Lewis and Sebastiano Vigna
    5 
    6     This file is part of ne, the nice editor.
    7 
    8     This library is free software; you can redistribute it and/or modify it
    9     under the terms of the GNU General Public License as published by
   10     the Free Software Foundation; either version 3 of the License, or (at your
   11     option) any later version.
   12 
   13     This library is distributed in the hope that it will be useful, but
   14     WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
   15     or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
   16     for more details.
   17 
   18     You should have received a copy of the GNU General Public License
   19     along with this program; if not, see <http://www.gnu.org/licenses/>.  */
   20 
   21 const char * const ABOUT_HELP[7] = {
   22   "Syntax: About",
   23   "Abbreviation: About",
   24   "",
   25   "displays the copyright splash screen and places a simple information",
   26   "line containing the version and build date of 'ne' on the status bar.",
   27   "Press any key to dismiss this screen.",
   28 };
   29 
   30 const char * const ADJUSTVIEW_HELP[26] = {
   31   "Syntax: AdjustView [T|M|B|L|C|R] [N]",
   32   "Abbreviation: AV",
   33   "",
   34   "shifts the view (text visible in the terminal window) horizontally or",
   35   "vertically without changing the cursor's position in the document.  View",
   36   "adjustments are constrained by the current TAB size and the length and",
   37   "width of the current document.  If called with no arguments 'T' is",
   38   "assumed.",
   39   "",
   40   "   'T', 'M', and 'B' cause vertical shifts so that the current line",
   41   "becomes the top, middle, or bottom-most visible line respectively.",
   42   "",
   43   "   'L', 'C', and 'R' cause horizontal shifts, making the current column",
   44   "the left-most, center, or right-most visible positions.",
   45   "",
   46   "   A optional number N immediately after 'T', 'B', 'L', or 'R' indicate",
   47   "the number or rows or columns to shift the view toward the top, bottom,",
   48   "left, or right of the window.",
   49   "",
   50   "   Horizontal and vertical adjustment specifications may be combined, so",
   51   "that for example 'AdjustView TL' shifts the view so that the current",
   52   "position becomes the top left-most character on screen (within the",
   53   "limits of the current TAB size).  Likewise, 'AdjustView B3R5' shifts the",
   54   "view three lines toward the bottom and five columns (excepting TAB size)",
   55   "toward the right.",
   56 };
   57 
   58 const char * const ALERT_HELP[5] = {
   59   "Syntax: Alert",
   60   "Abbreviation: AL",
   61   "",
   62   "beeps or flashes, depending on the value of the visual bell flag.",
   63 };
   64 
   65 const char * const ATOMICUNDO_HELP[22] = {
   66   "Syntax: AtomicUndo [0|+|-]",
   67   "Abbreviation: AU",
   68   "",
   69   "increases, decreases, sets or clears the 'AtomicUndo' level.  The normal",
   70   "level is zero.  All current document changes made while the 'AtomicUndo'",
   71   "level is above zero are treated as a single change by the 'Undo' and",
   72   "'Redo' commands.  If no parameter is given, a level of 0 is set to 1;",
   73   "otherwise the current non-zero level is decremented.  If 0 is given, the",
   74   "level is reset to zero.  Parameters of '+' and '-' respectively",
   75   "increment and decrement the level, which in no case can be negative.  If",
   76   "the level is above zero, the 'DoUndo' flag in the status bar, which is",
   77   "normally a lower-case 'u', becomes upper case 'U'.",
   78   "",
   79   "   Two other actions will reset the 'AtomicUndo' level to zero: invoking",
   80   "the 'Undo' command, and disabling the undo system with the 'DoUndo'",
   81   "command.  You cannot set a non-zero 'AtomicUndo' level unless the undo",
   82   "system is enabled.",
   83   "",
   84   "   Note: macros that you wish to undo and redo atomically--i.e., as if",
   85   "they were single commands--should begin with 'AtomicUndo +' and end with",
   86   "'AtomicUndo -' so that they can call and/or be called by other macros.",
   87 };
   88 
   89 const char * const AUTOCOMPLETE_HELP[20] = {
   90   "Syntax: AutoComplete [PREFIX]",
   91   "Abbreviation: AC",
   92   "",
   93   "attempts to extend the PREFIX using matching words from your open",
   94   "documents, and inserts the extended text into your document.  If the",
   95   "PREFIX can be extended unambiguously, the matching text is immediately",
   96   "inserted into your document.  Otherwise, 'ne' displays a selection of",
   97   "all words in open documents that match PREFIX, and inserts the word you",
   98   "select into the current document.  Matching words from the current",
   99   "document display normally; those which only exist in other open",
  100   "documents are bold and with a trailing asterisk.  If no PREFIX is given",
  101   "on the command line, or if 'AutoComplete' is selected from the 'Extras'",
  102   "menu or using a keyboard shortcut, the word characters to the immediate",
  103   "left of the cursor in the current document are used as the PREFIX.  Note",
  104   "that if no word characters are to the left of the cursor, or the PREFIX",
  105   "given on the command line is an empty string ('\"\"'), then all words in",
  106   "all your open documents are displayed.  Prefix matches may be case",
  107   "sensitive or not depending on the current document's 'CaseSearch' flag",
  108   "state.  See `CaseSearch'.",
  109 };
  110 
  111 const char * const AUTOINDENT_HELP[22] = {
  112   "Syntax: AutoIndent [0|1]",
  113   "Abbreviation: AI",
  114   "",
  115   "sets the auto indent flag.  When this flag is true, 'ne' will",
  116   "automatically insert TABs and spaces on a new line (created by an",
  117   "'InsertLine' command, or by automatic word wrapping) in such a way to",
  118   "replicate the initial spaces of the previous line.  Most useful for",
  119   "indenting programs.",
  120   "",
  121   "   If you invoke 'AutoIndent' with no arguments, it will toggle the",
  122   "flag.  If you specify 0 or 1, the flag will be set to false or true,",
  123   "respectively.  A lower case 'a' will appear on the status bar if the",
  124   "flag is true.",
  125   "",
  126   "   'AutoIndent' features a nice interaction with 'Undo'.  Whenever a new",
  127   "line is created, the insertion of spaces is recorded as a separate",
  128   "action in the undo buffer (with respect to the line creation).  If you",
  129   "are not satisfied with the indentation, just give the 'Undo' command and",
  130   "the indentation will disappear (but the new line will remain in place,",
  131   "since its creation has been recorded as a separate action).  See ",
  132   "`Undo'.",
  133 };
  134 
  135 const char * const AUTOMATCHBRACKET_HELP[11] = {
  136   "Syntax: AutoMatchBracket [0..15]",
  137   "Abbreviation: AMB",
  138   "",
  139   "sets the auto match bracket mode.  When the cursor is on a recognized",
  140   "bracket ('{}', '()', '[]', '<>', or '`'') and the associated matching",
  141   "bracket is on the screen, that matching bracket will be indicated",
  142   "according to the mode.  The mode is either zero for no bracket matching,",
  143   "or the sum of 1 (altered foreground and background brightness), 2",
  144   "(inverse), 4 (bold), and 8 (underline).  If no mode is specified, 'ne'",
  145   "prompts you for one.  The default mode is 1.  See `MatchBracket'.",
  146 };
  147 
  148 const char * const AUTOPREFS_HELP[14] = {
  149   "Syntax: AutoPrefs [0|1]",
  150   "Abbreviation: AP",
  151   "",
  152   "sets the automatic preferences flag.  If this flag is true, each time an",
  153   "'Open' command is executed and a file is loaded, 'ne' will look for an",
  154   "automatic preferences file in your '~/.ne' directory.  The preferences",
  155   "file name is given by the extension of the file loaded, postfixed with",
  156   "'#ap'.  Thus, for instance, C sources have an associated 'c#ap' file.",
  157   "",
  158   "   If you invoke 'AutoPrefs' with no arguments, it will toggle the flag.",
  159   "If you specify 0 or 1, the flag will be set to false or true,",
  160   "respectively.  A lower case 'p' will appear on the status bar if the",
  161   "flag is true.",
  162 };
  163 
  164 const char * const BACKSPACE_HELP[6] = {
  165   "Syntax: Backspace [N]",
  166   "Abbreviation: BS",
  167   "",
  168   "acts like 'DeleteChar', but moves the cursor to the left before deleting",
  169   "each character.",
  170 };
  171 
  172 const char * const BEEP_HELP[6] = {
  173   "Syntax: Beep",
  174   "Abbreviation: BE",
  175   "",
  176   "beeps.  If your terminal cannot beep, it flashes.  If it cannot flash,",
  177   "nothing happens (but you have a very bad terminal).",
  178 };
  179 
  180 const char * const BINARY_HELP[25] = {
  181   "Syntax: Binary [0|1]",
  182   "Abbreviation: B",
  183   "",
  184   "sets the binary flag.  When this flag is true, loading and saving a",
  185   "document is performed in a different way.  On loading, only nulls are",
  186   "considered newlines; on saving, nulls are saved instead of newlines.",
  187   "This allows you to edit a binary file, fix some text in it, and save it",
  188   "without modifying anything else.  Normally, line feeds, carriage returns",
  189   "and nulls are considered newlines, so that what you load will have all",
  190   "nulls and carriage returns substituted by newlines when saved.",
  191   "",
  192   "   Note that since usually binary files contain a great number of nulls,",
  193   "and every null will be considered a line terminator, the memory",
  194   "necessary for loading a binary file can be several times bigger than the",
  195   "length of the file itself.  Thus, binary editing within 'ne' should be",
  196   "considered not a normal activity, but rather an exceptional one.",
  197   "",
  198   "   If you invoke 'Binary' with no arguments, it will toggle the flag.",
  199   "If you specify 0 or 1, the flag will be set to false or true,",
  200   "respectively.  An upper case 'B' will appear on the status bar if the",
  201   "flag is true.  If false, a '-' or '!' will indicate whether the last",
  202   "line of the document is empty, which will determine whether the",
  203   "resulting file will have a normal line termination when the document is",
  204   "saved.",
  205 };
  206 
  207 const char * const CAPITALIZE_HELP[6] = {
  208   "Syntax: Capitalize [N]",
  209   "Abbreviation: CA",
  210   "",
  211   "acts exactly like 'ToUpper', but capitalizes, that is, makes the first",
  212   "letter upper case and the other ones lower case.  See `ToUpper'.",
  213 };
  214 
  215 const char * const CASESEARCH_HELP[12] = {
  216   "Syntax: CaseSearch [0|1]",
  217   "Abbreviation: CS",
  218   "",
  219   "sets the case sensitivity flag.  When this flag is true, the search",
  220   "commands distinguish between the upper and lower case letters.  By",
  221   "default the flag is false.",
  222   "",
  223   "   If you invoke 'CaseSearch' with no arguments, it will toggle the",
  224   "flag.  If you specify 0 or 1, the flag will be set to false or true,",
  225   "respectively.  A lower case 'c' will appear on the status bar if the",
  226   "flag is true.",
  227 };
  228 
  229 const char * const CENTER_HELP[8] = {
  230   "Syntax: Center [N]",
  231   "Abbreviation: CE",
  232   "",
  233   "centers N lines from the cursor position onwards.  If N is not",
  234   "specified, it is assumed to be one.  The lines are centered with spaces,",
  235   "relatively to the value of the right margin as set by the 'RightMargin'",
  236   "command.  See `RightMargin'.",
  237 };
  238 
  239 const char * const CLEAR_HELP[7] = {
  240   "Syntax: Clear",
  241   "Abbreviation: CL",
  242   "",
  243   "destroys the contents of the current document and of its undo buffer.",
  244   "Moreover, the document becomes unnamed.  If your current document is",
  245   "marked as modified, you have to confirm the action.",
  246 };
  247 
  248 const char * const CLIPNUMBER_HELP[11] = {
  249   "Syntax: ClipNumber [N]",
  250   "Abbreviation: CN",
  251   "",
  252   "sets the current clip number.  This number is used by 'OpenClip' and",
  253   "'SaveClip', and by 'Copy', 'Cut' and 'Paste' if they are called without",
  254   "any argument.  Its default value is zero.  N is limited only by the",
  255   "integer size of the machine 'ne' is running on.",
  256   "",
  257   "   If the optional argument N is not specified, you can enter it on the",
  258   "input line, the default being the current clip number.",
  259 };
  260 
  261 const char * const CLOSEDOC_HELP[7] = {
  262   "Syntax: CloseDoc",
  263   "Abbreviation: CD",
  264   "",
  265   "closes the current document.  The document is removed from 'ne''s list",
  266   "and, if it is the only existing document, 'ne' exits.  If the document",
  267   "was modified since it was last saved, you have to confirm the action.",
  268 };
  269 
  270 const char * const COPY_HELP[10] = {
  271   "Syntax: Copy [N]",
  272   "Abbreviation: C",
  273   "",
  274   "copies the contents of the characters lying between the cursor and the",
  275   "mark into the clip specified by the optional numeric argument, the",
  276   "default clip being the current clip, which can be set with the",
  277   "'ClipNumber' command; see `ClipNumber'.  If the current mark was",
  278   "vertical, the rectangle of characters defined by the cursor and the mark",
  279   "is copied instead.",
  280 };
  281 
  282 const char * const CRLF_HELP[15] = {
  283   "Syntax: CRLF [0|1]",
  284   "Abbreviation: CRLF",
  285   "",
  286   "sets the CR/LF flag.  When a file is saved from a document for which",
  287   "this flag is true, both a CR (carriage return) and a NL (new line)",
  288   "character are output as line terminators.  This flag has no effect",
  289   "except when saving a file.",
  290   "",
  291   "   This flag is automatically set if you load a file that has at least",
  292   "one CR/LF sequence in it.",
  293   "",
  294   "   If you invoke 'CRLF' with no arguments, it will toggle the flag.  If",
  295   "you specify 0 or 1, the flag will be set to false or true, respectively.",
  296   "An upper case 'C' will appear on the status bar if the flag is true.",
  297 };
  298 
  299 const char * const CUT_HELP[5] = {
  300   "Syntax: Cut [N]",
  301   "Abbreviation: CU",
  302   "",
  303   "acts just like 'Copy', but also deletes the block being copied.",
  304 };
  305 
  306 const char * const DELETECHAR_HELP[10] = {
  307   "Syntax: DeleteChar [N]",
  308   "Abbreviation: DC",
  309   "",
  310   "deletes N characters from the text.  If the optional N argument is not",
  311   "specified, it is assumed to be one.  Deleting a character when the",
  312   "cursor is just after the last char on a line will join a line with the",
  313   "following one; in other words, the carriage return between the two lines",
  314   "will be deleted.  Note that if the cursor is past the end of the current",
  315   "line, no action will be performed.",
  316 };
  317 
  318 const char * const DELETEEOL_HELP[10] = {
  319   "Syntax: DeleteEOL",
  320   "Abbreviation: DE",
  321   "",
  322   "deletes all characters from the current cursor position to the end of",
  323   "the line.",
  324   "",
  325   "   'DeleteEOL' could be easily implemented with a macro, but it is such",
  326   "a common, basic editing feature that it seemed worth a separate",
  327   "implementation.",
  328 };
  329 
  330 const char * const DELETELINE_HELP[9] = {
  331   "Syntax: DeleteLine [N]",
  332   "Abbreviation: DL",
  333   "",
  334   "deletes N lines starting from the current cursor position, putting the",
  335   "last one in the temporary buffer, from which it can be undeleted.  See",
  336   "`UndelLine'.  If the optional N argument is not specified, it is",
  337   "assumed to be one.  Note that this action is in no way inverse with",
  338   "respect to 'InsertLine'.",
  339 };
  340 
  341 const char * const DELETENEXTWORD_HELP[8] = {
  342   "Syntax: DeleteNextWord [N]",
  343   "Abbreviation: DNW",
  344   "",
  345   "deletes text from the current position to the N'th next end-of-word If",
  346   "the optional N argument is not specified, it is assumed to be one (in",
  347   "which case, if the cursor is in the middle of a word the effect is just",
  348   "to delete to the end of that word).",
  349 };
  350 
  351 const char * const DELETEPREVWORD_HELP[9] = {
  352   "Syntax: DeletePrevWord [N]",
  353   "Abbreviation: DPW",
  354   "",
  355   "deletes text from the current position through the first character of",
  356   "the N'th previous start-of-word.  If the optional N argument is not",
  357   "specified, it is assumed to be one (in which case, if the cursor is in",
  358   "the middle of a word the effect is just to delete to the start of that",
  359   "word).",
  360 };
  361 
  362 const char * const DELTABS_HELP[9] = {
  363   "Syntax: DelTabs [0|1]",
  364   "Abbreviation: DT",
  365   "",
  366   "sets the 'DelTabs' flag.  When this flag is set, a 'd' will appear on",
  367   "the status bar, and the <BackSpace> and <Del> keys will remove a tab's",
  368   "worth of SPACE characters if a TAB character could have occupied the",
  369   "same whitespace in the current line as the removed spaces.  This is the",
  370   "deletion counterpart to the 'Tabs' flag.  See `Tabs'.",
  371 };
  372 
  373 const char * const DOUNDO_HELP[21] = {
  374   "Syntax: DoUndo [0|1]",
  375   "Abbreviation: DU",
  376   "",
  377   "sets the flag that enables or disables the undo system.  When you turn",
  378   "the undo system off, all the recorded actions are discarded, and the",
  379   "undo buffers are reset.",
  380   "",
  381   "   If you invoke 'DoUndo' with no arguments, it will toggle the flag.",
  382   "If you specify 0 or 1, the flag will be set to false or true,",
  383   "respectively.  A lower case 'u' will appear on the status bar if the",
  384   "flag is true.  (The 'U' will be upper case if the flag is true and the",
  385   "'AtomicUndo' level is non-zero.)",
  386   "",
  387   "   The usefulness of this option relies in the fact that the undo system",
  388   "is a major memory eater.  If you plan to do massive editing (say,",
  389   "cutting and pasting megabytes of text) it is a good idea to disable the",
  390   "undo system, both for improving (doubling) performance and for using",
  391   "less (half) memory.  Except for this, on a virtual memory system we see",
  392   "no reason to not keep the undo flag always true, and this is indeed the",
  393   "default.",
  394 };
  395 
  396 const char * const ERASE_HELP[6] = {
  397   "Syntax: Erase",
  398   "Abbreviation: E",
  399   "",
  400   "acts like 'Cut', but the block is just deleted and not copied into any",
  401   "clip.",
  402 };
  403 
  404 const char * const ESCAPE_HELP[7] = {
  405   "Syntax: Escape",
  406   "Abbreviation: ESC",
  407   "",
  408   "toggles the menus on and off, or escapes from the input line.  This",
  409   "command is mainly useful for reprogramming the menu activator, and it is",
  410   "never registered while recording a macro.  See `Record'.",
  411 };
  412 
  413 const char * const ESCAPETIME_HELP[16] = {
  414   "Syntax: EscapeTime [N]",
  415   "Abbreviation: ET",
  416   "",
  417   "sets the escape time.  The <Escape> key is recognized as such after N",
  418   "tenths of second.  Along slow connections, it can happen that the",
  419   "default value of 10 is too low: in this case, escape sequences (e.g.,",
  420   "those of the arrow keys) could be erroneously broken into an escape and",
  421   "some spurious characters.  Rising the escape time usually solves this",
  422   "problem.  Allowed values range from 0 to 255.  Note that you can",
  423   "accelerate the recognition of the <Escape> key by hitting it twice in a",
  424   "row.",
  425   "",
  426   "   Note that the escape time is global to 'ne', and it is not saved.",
  427   "However, you can add an 'EscapeTime' command manually to a preferences",
  428   "file.",
  429 };
  430 
  431 const char * const EXEC_HELP[14] = {
  432   "Syntax: Exec",
  433   "Abbreviation: EX",
  434   "",
  435   "prompts the user on the input line, asking for a command, and executes",
  436   "it.  It is never registered while recording a macro (though the command",
  437   "you type is).",
  438   "",
  439   "   'Exec' is mainly useful for key bindings, menu configurations, and in",
  440   "manually programmed macros.",
  441   "",
  442   "   Note that if the command you specify does not appear in 'ne''s",
  443   "internal tables, it is considered to be a macro name.  See ",
  444   "`Macro'.",
  445 };
  446 
  447 const char * const EXIT_HELP[12] = {
  448   "Syntax: Exit",
  449   "Abbreviation: X",
  450   "",
  451   "saves all modified documents, closes them and exits.  If any documents",
  452   "cannot be saved, the action is suspended and an error message is issued",
  453   "and no documents are closed.  Note that only named documents can be",
  454   "saved, so 'Exit' will report an error if you have any modified unnamed",
  455   "documents.  Like 'SaveAll', 'Exit' will not save a document if its",
  456   "corresponding file has been modified since the document was loaded or",
  457   "last saved, or if its read only flag is set, in which case an error is",
  458   "reported and no documents are closed.",
  459 };
  460 
  461 const char * const FASTGUI_HELP[19] = {
  462   "Syntax: FastGUI [0|1]",
  463   "Abbreviation: FG",
  464   "",
  465   "sets the fast graphical user interface flag.  When this flag is true,",
  466   "'ne' tries to print as little as possible while displaying menus and the",
  467   "status bar.  In particular, menu items are highlighted by the cursor",
  468   "only, the status bar is not highlighted (which allows printing it with",
  469   "fewer characters) and the hexadecimal code is not displayed.  This",
  470   "option is only (but very) useful if you are using 'ne' through a slow",
  471   "connection.",
  472   "",
  473   "   If you invoke 'FastGUI' with no arguments, it will toggle the flag.",
  474   "If you specify 0 or 1, the flag will be set to false or true,",
  475   "respectively.",
  476   "",
  477   "   The 'FastGUI' setting is saved in your '~/.ne/.default#ap' file when",
  478   "you use the 'SaveDefPrefs' command or the 'Save Def Prefs' menu.  It is",
  479   "not saved by the 'SaveAutoPrefs' command.",
  480 };
  481 
  482 const char * const FIND_HELP[12] = {
  483   "Syntax: Find [PATTERN]",
  484   "Abbreviation: F",
  485   "",
  486   "searches for the given pattern.  The cursor is positioned on the first",
  487   "occurrence of the pattern, or an error message is given.  The direction",
  488   "and the case sensitivity of the search are established by the value of",
  489   "the back search and case sensitive search flags.  See ",
  490   "`SearchBack', and `CaseSearch'.",
  491   "",
  492   "   If the optional argument PATTERN is not specified, you can enter it",
  493   "on the input line, the default being the last pattern used.",
  494 };
  495 
  496 const char * const FINDREGEXP_HELP[12] = {
  497   "Syntax: FindRegExp [PATTERN]",
  498   "Abbreviation: FX",
  499   "",
  500   "searches the current document for the given extended regular expression",
  501   ".  The cursor is positioned on the first string matching the expression.",
  502   "The direction and the kind of search are established by the value of the",
  503   "back search and case sensitive search flags.  See `SearchBack',",
  504   "and `CaseSearch'.",
  505   "",
  506   "   If the optional argument PATTERN is not specified, you can enter it",
  507   "on the input line, the default being the last pattern used.",
  508 };
  509 
  510 const char * const FLAGS_HELP[35] = {
  511   "Syntax: Flags",
  512   "Abbreviation: FLAG",
  513   "",
  514   "displays a list of all the status flags for ne and their associated",
  515   "commands.  It is not recorded when recording a macro.",
  516   "",
  517   "     FLAG COMMAND      ABBR  DESCRIPTION",
  518   "       i   Insert        I    inserts new characters (vs. replacing)",
  519   "       a   AutoIndent    AI   aligns cursor under previous line after <Return>",
  520   "       b   SearchBack    SB   searches search backward rather than forward",
  521   "       c   CaseSearch    CS   searches are case sensitive",
  522   "       w   WordWrap      WW   breaks long lines as you type",
  523   "       f   FreeForm      FF   allows cursor to move beyond the end of lines",
  524   "       p   AutoPrefs     AP   use automatic preferences based on file extension",
  525   "       v   VerboseMacros VM   record macros using use long command names",
  526   "       u   DoUndo        DU   record edits for later undoing",
  527   "       r   ReadOnly      RO   changes are not allowed/saves are prompted",
  528   "       t/T Tabs          TAB  TAB key inserts TABs instead of spaces",
  529   "       T   ShiftTabs     SHT  Shift may insert TABs (only if 't' is also set)",
  530   "       d   DelTabs       DT   BS and DEL may remove tabs worth of space",
  531   "       B/! Binary        B    affects file loading/saving",
  532   "       M   Mark          M    mark set for line-oriented block operations",
  533   "       V   MarkVert      MV   like mark, but block is rectangle",
  534   "       R   Record        REC  actions are being recorded in a macro",
  535   "       P   PreserveCR    PCR  affects how <CR> chars are loaded from files",
  536   "       C   CRLF          CRLF use CR/LF as line terminator",
  537   "       *   Modified      MOD  document has been modified since last saved",
  538   "       @   UTF8IO        U8IO I/O (keyboard and terminal) are UTF-8 encoded",
  539   "     A/8/U UTF8          U8   the document encoding (ASCII, 8-bit or UTF-8)",
  540   "",
  541   "   The 'RequestOrder' and 'AutoMatchBracket' flags' states are not",
  542   "indicated on the status bar.  See `RequestOrder' and ",
  543   "`AutoMatchBracket' respectively.  A '!' indicates the last line is not",
  544   "terminated.",
  545 };
  546 
  547 const char * const FLASH_HELP[6] = {
  548   "Syntax: Flash",
  549   "Abbreviation: FL",
  550   "",
  551   "acts as 'Beep', but interchanging the words \"beep\" and \"flash\".  Same",
  552   "comments apply.  See `Beep'.",
  553 };
  554 
  555 const char * const FREEFORM_HELP[18] = {
  556   "Syntax: FreeForm [0|1]",
  557   "Abbreviation: FF",
  558   "",
  559   "sets the free form flag.  When this flag is true, you can move with the",
  560   "cursor anywhere on the screen, even where there is no text present",
  561   "(however, you cannot move inside the space expansion of a TAB",
  562   "character).",
  563   "",
  564   "   If you invoke 'FreeForm' with no arguments, it will toggle the flag.",
  565   "If you specify 0 or 1, the flag will be set to false or true,",
  566   "respectively.  A lower case 'f' will appear on the status bar if the",
  567   "flag is true.",
  568   "",
  569   "   The issue free-form-versus-non-free-form is a major religious war",
  570   "that has engaged users from day one.  The due of the implementor is to",
  571   "allow both choices, and to set as default the correct one (in his humble",
  572   "opinion).  In this case, non-free-form.",
  573 };
  574 
  575 const char * const GOTOBOOKMARK_HELP[20] = {
  576   "Syntax: GotoBookmark [N|+1|-1|-]",
  577   "Abbreviation: GBM",
  578   "",
  579   "moves the cursor to the designated bookmark if that bookmark is set; see",
  580   "`SetBookmark'.  Each document has 10 available bookmarks",
  581   "designated '0' to '9', plus the automatic bookmark designated by '-'.",
  582   "If no option is given, '0' is assumed.  The optons '+1' and '-1'",
  583   "indicate respectively the next and previous set bookmarks, so that",
  584   "repeated 'GotoBookmark +1' commands will cycle through all currently set",
  585   "bookmarks.  When successful, the '-' automatic bookmark is set to the",
  586   "position in the document from which the command was issued, so that",
  587   "'GotoBookmark -' returns you to the location from which you last issued",
  588   "a successful 'GotoBookmark' command.  Subsequent repeated 'GotoBookmark",
  589   "-' commands will toggle you between the two locations.",
  590   "",
  591   "   The '?' option will cause 'GotoBookmark' to prompt you for a bookmark",
  592   "designation.  The promp will include an indication of which bookmarks",
  593   "are currently set.  You may find this useful in macros, or to bind a key",
  594   "to 'GotoBookmark ?'.",
  595 };
  596 
  597 const char * const GOTOCOLUMN_HELP[8] = {
  598   "Syntax: GotoColumn [COLUMN]",
  599   "Abbreviation: GC",
  600   "",
  601   "moves the cursor to the COLUMNth column of the file.",
  602   "",
  603   "   If the optional argument LINE is not specified, you can enter it on",
  604   "the input line; the default input response is the current column number.",
  605 };
  606 
  607 const char * const GOTOLINE_HELP[10] = {
  608   "Syntax: GotoLine [LINE]",
  609   "Abbreviation: GL",
  610   "",
  611   "moves the cursor to the LINEth line of the file.  If LINE is zero or",
  612   "greater than the number of lines in the file, the cursor is moved to the",
  613   "last line.",
  614   "",
  615   "   If the optional argument LINE is not specified, you can enter it on",
  616   "the input line; the default input response is the current line number.",
  617 };
  618 
  619 const char * const GOTOMARK_HELP[9] = {
  620   "Syntax: GotoMark",
  621   "Abbreviation: GM",
  622   "",
  623   "moves the cursor to the current mark, if it exists.  See `Mark'.",
  624   "",
  625   "   'GotoMark' is mainly useful if you forgot where you started marking.",
  626   "If you want to record positions in a file and jump to them later, you",
  627   "may want to use bookmarks instead.  See `SetBookmark'.",
  628 };
  629 
  630 const char * const HELP_HELP[14] = {
  631   "Syntax: Help [NAME]",
  632   "Abbreviation: H",
  633   "",
  634   "displays some help about the command NAME (both the short and the long",
  635   "versions of the command names are accepted).  If no argument is given, a",
  636   "list of all existing commands in long form is displayed, allowing you to",
  637   "choose one.  You can browse the help text with the standard navigation",
  638   "keys.  If you press <Return>, the command list will be displayed again.",
  639   "If you press <f1> or <Escape>, you will return to normal editing.",
  640   "",
  641   "   Invocations of the 'Help' command are never registered while",
  642   "recording macros so that you can safely access the help system while",
  643   "recording.  See `Record'.",
  644 };
  645 
  646 const char * const HEXCODE_HELP[6] = {
  647   "Syntax: HexCode [0|1]",
  648   "Abbreviation: HC",
  649   "",
  650   "sets the hex code flag.  When this flag is true, the hexadecimal code of",
  651   "the character currently under the cursor is displayed on the status bar.",
  652 };
  653 
  654 const char * const INSERT_HELP[12] = {
  655   "Syntax: Insert [0|1]",
  656   "Abbreviation: I",
  657   "",
  658   "sets the insert flag.  If this flag is true, the text you type is",
  659   "inserted, otherwise it overwrites the existing characters.  This also",
  660   "governs the behaviour of the 'InsertChar' and 'InsertString' commands.",
  661   "",
  662   "   If you invoke 'Insert' with no arguments, it will toggle the flag.",
  663   "If you specify 0 or 1, the flag will be set to false or true,",
  664   "respectively.  A lower case 'i' will appear on the status bar if the",
  665   "flag is true.",
  666 };
  667 
  668 const char * const INSERTCHAR_HELP[21] = {
  669   "Syntax: InsertChar [CODE]",
  670   "Abbreviation: IC",
  671   "",
  672   "inserts a character whose ASCII code is CODE at the current cursor",
  673   "position.  CODE can be either decimal, hexadecimal if preceded by '0x',",
  674   "or octal if preceded by '0'.  In any case, CODE must be different from",
  675   "0.  All the currently active preferences options (insert, word wrapping,",
  676   "auto indent, et cetera) are applied.",
  677   "",
  678   "   If the optional argument CODE is not specified, you can enter it on",
  679   "the input line, the default being the last inserted character.",
  680   "",
  681   "   Note that inserting a line feed (10) is completely different from",
  682   "inserting a line with 'InsertLine'.  'InsertChar 10' puts the control",
  683   "char '<Control>-J' in the text at the current cursor position.  See",
  684   "`InsertLine'.",
  685   "",
  686   "   Note also that 'SaveMacro' converts 'InsertChar' commands into a",
  687   "possibly smaller number of 'InsertString' commands.  This makes macros",
  688   "easier to read and edit.  See `SaveMacro'.",
  689 };
  690 
  691 const char * const INSERTLINE_HELP[7] = {
  692   "Syntax: InsertLine [N]",
  693   "Abbreviation: IL",
  694   "",
  695   "inserts N lines at the current cursor position, breaking the current",
  696   "line.  If the optional N argument is not specified, it is assumed to be",
  697   "one.",
  698 };
  699 
  700 const char * const INSERTSTRING_HELP[12] = {
  701   "Syntax: InsertString [TEXT]",
  702   "Abbreviation: IS",
  703   "",
  704   "inserts TEXT at the current cursor position.  If the optional argument",
  705   "TEXT is omitted, you will be prompted for it on the command line.  All",
  706   "the currently active preferences options (insert, word wrapping, auto",
  707   "indent, et cetera) are applied.",
  708   "",
  709   "   Note that 'SaveMacro' converts 'InsertChar' commands into a possibly",
  710   "smaller number of 'InsertString' commands.  This makes macros easier to",
  711   "read and edit.  See `SaveMacro'.",
  712 };
  713 
  714 const char * const INSERTTAB_HELP[7] = {
  715   "Syntax: InsertTab [N]",
  716   "Abbreviation: IT",
  717   "",
  718   "inserts either N literal TAB characters or one or more spaces sufficient",
  719   "to advance the current cursor position N tab stops depending on the",
  720   "'Tabs' flag.  See `Tabs', `TabSize'.",
  721 };
  722 
  723 const char * const KEYCODE_HELP[12] = {
  724   "Syntax: KeyCode [K]",
  725   "Abbreviation: KC",
  726   "",
  727   "prompts you to press a key, and reports on the status bar the key code",
  728   "'ne' associates with that key, the command currently associated with",
  729   "that key code, as well as the input class for that key code.  Input",
  730   "class codes are: ALPHA, COMMAND, RETURN, TAB, IGNORE, and INVALID. This",
  731   "can be useful while configuring your '~/.ne/.keys' file.",
  732   "",
  733   "   If the optional integer K (between 0 and 511) is given, 'KeyCode'",
  734   "uses K as the key code and displays the information described above.",
  735 };
  736 
  737 const char * const LINEDOWN_HELP[6] = {
  738   "Syntax: LineDown [N]",
  739   "Abbreviation: LD",
  740   "",
  741   "moves the cursor down by one line N times.  If the optional N argument",
  742   "is not specified, it is assumed to be one.",
  743 };
  744 
  745 const char * const LINEUP_HELP[6] = {
  746   "Syntax: LineUp [N]",
  747   "Abbreviation: LU",
  748   "",
  749   "moves the cursor up by one line N times.  If the optional N argument is",
  750   "not specified, it is assumed to be one.",
  751 };
  752 
  753 const char * const LOADAUTOPREFS_HELP[7] = {
  754   "Syntax: LoadAutoPrefs",
  755   "Abbreviation: LAP",
  756   "",
  757   "loads the preferences file in '~/.ne' associated with the current",
  758   "document's file name extension.  If the current file name has no",
  759   "extension, the default preferences are loaded.  See `AutoPrefs'.",
  760 };
  761 
  762 const char * const LOADPREFS_HELP[16] = {
  763   "Syntax: LoadPrefs [FILENAME]",
  764   "Abbreviation: LP",
  765   "",
  766   "loads the given preference file, and sets the current preferences",
  767   "accordingly.",
  768   "",
  769   "   If the optional FILENAME argument is not specified, the file",
  770   "requester is opened, and you are prompted to select a file.  (You can",
  771   "inhibit the file requester opening by using the 'NoFileReq' command; see",
  772   "`NoFileReq'.)  If you escape from the file requester, you can",
  773   "input the file name on the command line.",
  774   "",
  775   "   Note that a preferences file is just a macro containing only option",
  776   "modifiers.  You can manually edit a preferences file for special",
  777   "purposes, such as filtering out specific settings.",
  778 };
  779 
  780 const char * const MACRO_HELP[33] = {
  781   "Syntax: Macro [FILENAME]",
  782   "Abbreviation: MA",
  783   "",
  784   "executes the given file name as a macro.",
  785   "",
  786   "   If the optional FILENAME argument is not specified, the file",
  787   "requester is opened, and you are prompted to select a file.  (You can",
  788   "inhibit the file requester opening by using the 'NoFileReq' command; see",
  789   "`NoFileReq'.)",
  790   "",
  791   "   If you escape from the file requester, you can input the file name on",
  792   "the command line.",
  793   "",
  794   "   Note that macros whose names do not conflict with a command can be",
  795   "called without using 'Macro'.  Whenever 'ne' is required to perform a",
  796   "command it cannot find in its internal tables, it will look for a macro",
  797   "by that name in the current directory.  If this search also fails, 'ne'",
  798   "looks in '~/.ne' and finally in the 'macros' subdirectory of 'ne''s",
  799   "global directory (defined when 'ne' was built, or in a place specified",
  800   "by your 'NE_GLOBAL_DIR' environment variable) for a macro file by that",
  801   "name.",
  802   "",
  803   "*Warning:* the first time a macro is executed it is cached into a hash",
  804   "table and is kept _forever_ in memory unless the 'UnloadMacros' command",
  805   "is issued; see `UnloadMacros'.  The next time a macro with the",
  806   "same file name is invoked, the cached list is searched for it before",
  807   "accessing the file using a case insensitive string comparison.  That is,",
  808   "if you call '~/foobar/macro', a subsequent call for '/usr/MACRO' or even",
  809   "just 'MaCrO' will use the cached version of '~/foobar/macro'.  Note that",
  810   "the cache table is global to 'ne' and not specific to any single",
  811   "document.  This greatly improves efficiency when macros are used",
  812   "repeatedly.",
  813 };
  814 
  815 const char * const MARK_HELP[12] = {
  816   "Syntax: Mark [0|1]",
  817   "Abbreviation: M",
  818   "",
  819   "sets the mark at the current position or cancels the previous mark.  The",
  820   "mark and cursor together define the range of text over which clips",
  821   "('Cut', 'Copy', 'Erase') and left and right shifts operate.",
  822   "",
  823   "   If you invoke 'Mark' with no arguments, it will set the mark.  If you",
  824   "specify 0 or 1, the mark will be cancelled or set to the current",
  825   "position, respectively.  A capital 'M' appears on the status bar, if the",
  826   "mark is active.",
  827 };
  828 
  829 const char * const MARKVERT_HELP[21] = {
  830   "Syntax: MarkVert [0|1]",
  831   "Abbreviation: MV",
  832   "",
  833   "is the same as 'Mark', but the region manipulated by the cut/paste",
  834   "commands is the rectangle having as vertices the cursor and the mark.",
  835   "If you invoke 'MarkVert' with no arguments, it will set the mark.  If",
  836   "you specify 0 or 1, the mark will be cancelled or set to the current",
  837   "position, respectively.  Moreover, a capital 'V', rather than a capital",
  838   "'M', will appear on the status bar.",
  839   "",
  840   "   For example, if you have the following text:",
  841   "        aaaBbbccc",
  842   "        aaabbbccc",
  843   "        aaabbbCcc",
  844   "and you set a vertical mark at 'B' then move the cursor to 'C', you can",
  845   "cut or copy all of the 'B's.",
  846   "",
  847   "   If you have made a vertical cut or copy, it's very likely you will",
  848   "want to use 'PasteVert' rather than the usual 'Paste' to reinsert the",
  849   "text in a rectangle.  See `PasteVert'.",
  850 };
  851 
  852 const char * const MATCHBRACKET_HELP[9] = {
  853   "Syntax: MatchBracket",
  854   "Abbreviation: MB",
  855   "",
  856   "moves the cursor to the bracket associated with the bracket the cursor",
  857   "is on.  If the cursor is not on a bracket, or there is no bracket",
  858   "associated with the current one, an error message is issued.  Recognized",
  859   "brackets are '{}', '()', '[]' '<>', and '`''.  See ",
  860   "`AutoMatchBracket'.",
  861 };
  862 
  863 const char * const MODIFIED_HELP[15] = {
  864   "Syntax: Modified [0|1]",
  865   "Abbreviation: MOD",
  866   "",
  867   "sets the modified flag.  This flag is set automatically whenever a",
  868   "document is modified, and is used to determine which documents need to",
  869   "be saved when 'ne' exits.  Normally you would not alter this flag, but",
  870   "when a document is inadvertently modified and you don't want the changes",
  871   "saved, 'Modified' provides a way to make 'ne' consider the document",
  872   "unchanged.",
  873   "",
  874   "   If you invoke 'Modified' with no arguments, it will toggle the flag.",
  875   "If you specify 0 or 1, the flag will be set to false or true,",
  876   "respectively.  An asterisk ('*') will appear on the status bar if the",
  877   "flag is true.",
  878 };
  879 
  880 const char * const MOVEBOS_HELP[6] = {
  881   "Syntax: MoveBOS",
  882   "Abbreviation: BOS",
  883   "",
  884   "moves the cursor to the lowest line currently visible ('BOS' = bottom of",
  885   "screen).",
  886 };
  887 
  888 const char * const MOVEEOF_HELP[5] = {
  889   "Syntax: MoveEOF",
  890   "Abbreviation: EOF",
  891   "",
  892   "moves the cursor to the end of the document ('EOF' = end of file).",
  893 };
  894 
  895 const char * const MOVEEOL_HELP[5] = {
  896   "Syntax: MoveEOL",
  897   "Abbreviation: EOL",
  898   "",
  899   "moves the cursor to the end of the current line ('EOL' = end of line).",
  900 };
  901 
  902 const char * const MOVEEOW_HELP[11] = {
  903   "Syntax: MoveEOW [<|>]",
  904   "Abbreviation: EOW",
  905   "",
  906   "moves the cursor to the end of the current word, that end being the",
  907   "right end unless you include the optional parameter '<'.  If the cursor",
  908   "is not currently in a word, or if it's already at the indicated end, it",
  909   "retains its current location.",
  910   "",
  911   "   'MoveEOW' is extremely useful in macros, because it allows you to",
  912   "copy precisely the word the cursor is on.",
  913 };
  914 
  915 const char * const MOVEINCDOWN_HELP[9] = {
  916   "Syntax: MoveIncDown",
  917   "Abbreviation: MID",
  918   "",
  919   "moves the cursor incrementally towards the end of the document.  More",
  920   "precisely, if the cursor is not on the end of the line it lies on, then",
  921   "it is moved to the end of that line.  Otherwise, if it is on the last",
  922   "line of the screen, then it is moved to the end of the document;",
  923   "otherwise, it is moved to the last line of the screen.",
  924 };
  925 
  926 const char * const MOVEINCUP_HELP[9] = {
  927   "Syntax: MoveIncUp",
  928   "Abbreviation: MIU",
  929   "",
  930   "moves the cursor incrementally towards the beginning of the document.",
  931   "More precisely, if the cursor is not on the start of the line it lies",
  932   "on, then it is moved to the start of that line.  Otherwise, if it is on",
  933   "the first line of the screen, then it is moved to the start of the",
  934   "document; otherwise, it is moved to the first line of the screen.",
  935 };
  936 
  937 const char * const MOVELEFT_HELP[6] = {
  938   "Syntax: MoveLeft [N]",
  939   "Abbreviation: ML",
  940   "",
  941   "moves the cursor to the left by one character N times.  If the optional",
  942   "N argument is not specified, it is assumed to be one.",
  943 };
  944 
  945 const char * const MOVERIGHT_HELP[6] = {
  946   "Syntax: MoveRight [N]",
  947   "Abbreviation: MR",
  948   "",
  949   "moves the cursor to the right by one character N times.  If the optional",
  950   "N argument is not specified, it is assumed to be one.",
  951 };
  952 
  953 const char * const MOVESOF_HELP[5] = {
  954   "Syntax: MoveSOF",
  955   "Abbreviation: SOF",
  956   "",
  957   "moves the cursor to the start of the document ('SOF' = start of file).",
  958 };
  959 
  960 const char * const MOVESOL_HELP[6] = {
  961   "Syntax: MoveSOL",
  962   "Abbreviation: SOL",
  963   "",
  964   "moves the cursor to the start of the current line ('SOL' = start of",
  965   "line).",
  966 };
  967 
  968 const char * const MOVETOS_HELP[5] = {
  969   "Syntax: MoveTOS",
  970   "Abbreviation: TOS",
  971   "",
  972   "moves the cursor to the top line of the screen ('TOS' = top of screen).",
  973 };
  974 
  975 const char * const NAMECONVERT_HELP[10] = {
  976   "Syntax: NameConvert [0|1]",
  977   "Abbreviation: NC",
  978   "",
  979   "converts the current document's name between relative and absolute path",
  980   "names.  With no parameter it switches the current name from relative to",
  981   "absolute, or absolute to relative.  With '1' it converts the relative",
  982   "path to absolute or leaves the absolute path unchanged.  With '0' it",
  983   "converts the absolute path to relative or leaves the relative path",
  984   "unchanged.",
  985 };
  986 
  987 const char * const NEWDOC_HELP[8] = {
  988   "Syntax: NewDoc",
  989   "Abbreviation: N",
  990   "",
  991   "creates a new, empty, unnamed document that becomes the current",
  992   "document.  The position of the document in the document list is just",
  993   "after the current document.  The preferences of the new document are a",
  994   "copy of the preferences of the current document.",
  995 };
  996 
  997 const char * const NEXTDOC_HELP[5] = {
  998   "Syntax: NextDoc",
  999   "Abbreviation: ND",
 1000   "",
 1001   "sets as current document the next document in the document list.",
 1002 };
 1003 
 1004 const char * const NEXTPAGE_HELP[8] = {
 1005   "Syntax: NextPage [N]",
 1006   "Abbreviation: NP",
 1007   "",
 1008   "moves the cursor N pages forward, if the cursor is on the last line of",
 1009   "the screen; otherwise moves the cursor to the last line of the screen,",
 1010   "and moves by N-1 pages.  If the optional N argument is not specified, it",
 1011   "is assumed to be one.",
 1012 };
 1013 
 1014 const char * const NEXTWORD_HELP[8] = {
 1015   "Syntax: NextWord [N][<|>]",
 1016   "Abbreviation: NW",
 1017   "",
 1018   "moves the cursor to the right to the Nth word beginning or ending.  If",
 1019   "the optional N argument is not specified, one is used.  The optional '<'",
 1020   "or '>' determines whether to move to the word beginning or ending,",
 1021   "respectively.  If unspecified, the left end ('<') is used.",
 1022 };
 1023 
 1024 const char * const NOFILEREQ_HELP[10] = {
 1025   "Syntax: NoFileReq [0|1]",
 1026   "Abbreviation: NFR",
 1027   "",
 1028   "sets the file requester flag.  When this flag is true, the file",
 1029   "requester is never opened, under any circumstances.",
 1030   "",
 1031   "   If you invoke 'NoFileReq' with no arguments, it will toggle the flag.",
 1032   "If you specify 0 or 1, the flag will be set to false or true,",
 1033   "respectively.",
 1034 };
 1035 
 1036 const char * const NOP_HELP[5] = {
 1037   "Syntax: NOP",
 1038   "Abbreviation: NOP",
 1039   "",
 1040   "does nothing.  Mainly useful for inhibiting standard key bindings.",
 1041 };
 1042 
 1043 const char * const OPEN_HELP[21] = {
 1044   "Syntax: Open [FILENAME]",
 1045   "Abbreviation: O",
 1046   "",
 1047   "replaces the contents of the current document with that of the file",
 1048   "specified by the FILENAME string.  (To load FILENAME's content into a",
 1049   "new document without changing the current document, see ",
 1050   "`OpenNew'.)  The current document's macro, search, and replace strings",
 1051   "are preserved.",
 1052   "",
 1053   "   If the optional FILENAME argument is not specified, the file",
 1054   "requester is opened, and you are prompted to select a file.  (You can",
 1055   "inhibit the file requester opening by using the 'NoFileReq' command; see",
 1056   "`NoFileReq'.)",
 1057   "",
 1058   "   If you escape from the file requester, you can input the file name on",
 1059   "the command line, the default being the current document name, if",
 1060   "available.",
 1061   "",
 1062   "   If the current document is marked as modified at the time the command",
 1063   "is issued, you have to confirm the action.",
 1064 };
 1065 
 1066 const char * const OPENCLIP_HELP[14] = {
 1067   "Syntax: OpenClip [FILENAME]",
 1068   "Abbreviation: OC",
 1069   "",
 1070   "loads the given file name as the current clip, just as if you cut or",
 1071   "copied it from the current document; see `Copy'.",
 1072   "",
 1073   "   If the optional FILENAME argument is not specified, the file",
 1074   "requester will open and you will be prompted to select a file.  (You can",
 1075   "inhibit the file requester opening by using the 'NoFileReq' command; see",
 1076   "`NoFileReq'.)",
 1077   "",
 1078   "   If you escape from the file requester, you can enter the file name on",
 1079   "the input line.",
 1080 };
 1081 
 1082 const char * const OPENMACRO_HELP[14] = {
 1083   "Syntax: OpenMacro [FILENAME]",
 1084   "Abbreviation: OM",
 1085   "",
 1086   "loads the given file name as the current document's macro just as if you",
 1087   "'Record'ed it; see `Record'.",
 1088   "",
 1089   "   If the optional FILENAME argument is not specified, the file",
 1090   "requester is opened, and you are prompted to select a file.  (You can",
 1091   "inhibit the file requester opening by using the 'NoFileReq' command; see",
 1092   "`NoFileReq'.)",
 1093   "",
 1094   "   If you escape from the file requester, you can input the file name on",
 1095   "the command line.",
 1096 };
 1097 
 1098 const char * const OPENNEW_HELP[11] = {
 1099   "Syntax: OpenNew [FILENAME]",
 1100   "Abbreviation: ON",
 1101   "",
 1102   "creates a new document and loads into it the contents of the file",
 1103   "specified by the optional FILENAME string.  This new document will",
 1104   "inherit the macro, search, and replace strings from the current",
 1105   "document.",
 1106   "",
 1107   "   If FILENAME is unspecified, the file requester behaves the same as",
 1108   "for the 'Open' command; see `Open'.",
 1109 };
 1110 
 1111 const char * const PAGEDOWN_HELP[6] = {
 1112   "Syntax: PageDown [N]",
 1113   "Abbreviation: PDN",
 1114   "",
 1115   "pages the screen forward by N screens.  If N is not specified, it is",
 1116   "assumed to be one.",
 1117 };
 1118 
 1119 const char * const PAGEUP_HELP[6] = {
 1120   "Syntax: PageUp [N]",
 1121   "Abbreviation: PUP",
 1122   "",
 1123   "pages the screen backward by N screens.  If N is not specified, it is",
 1124   "assumed to be one.",
 1125 };
 1126 
 1127 const char * const PARAGRAPH_HELP[27] = {
 1128   "Syntax: Paragraph [N]",
 1129   "Abbreviation: PA",
 1130   "",
 1131   "reformats N paragraphs from the cursor position onwards.  If N is not",
 1132   "specified, it is assumed to be one.  The paragraphs are formatted",
 1133   "relatively to the value of the right margin as set by the 'RightMargin'",
 1134   "command.  See `RightMargin'.",
 1135   "",
 1136   "   'ne''s notion of a paragraph includes the current non-blank line",
 1137   "(regardless of its leading white space) and all subsequent non-blank",
 1138   "lines that have identical (to each other's--not to the first line's)",
 1139   "leading white space.  Therefore your paragraphs can have various first",
 1140   "line indentations and left margins.  'Paragraph' also takes into account",
 1141   "characters commonly used at the left edge of block comments ('/', '*',",
 1142   "'#', spaces, and tabs) or quoted email ('>'), and attempts to preserve",
 1143   "those on the left edge when possible.",
 1144   "",
 1145   "   After the 'Paragraph' command completes, your cursor will be",
 1146   "positioned on the first non-blank character after the last reformatted",
 1147   "paragraph (or, if there is no such character, at the end of the",
 1148   "document).",
 1149   "",
 1150   "   'Paragraph' does not insert \"smart\" spaces after full stops and",
 1151   "colons, nor does it do other \"smart\" things such as justification.  If",
 1152   "you need such facilities, you should consider using a text formatter.",
 1153   "TeX for example is usually an excellent choice.",
 1154 };
 1155 
 1156 const char * const PASTE_HELP[7] = {
 1157   "Syntax: Paste [N]",
 1158   "Abbreviation: P",
 1159   "",
 1160   "pastes the contents of specified clip into the current document at the",
 1161   "cursor position.  If you don't specify the clip number, the current clip",
 1162   "is used; Specify which clip is current with `ClipNumber'.",
 1163 };
 1164 
 1165 const char * const PASTEVERT_HELP[7] = {
 1166   "Syntax: PasteVert [N]",
 1167   "Abbreviation: PV",
 1168   "",
 1169   "vertically pastes the contents of the specified clip, the default being",
 1170   "the current clip.  Each line of the clip is inserted on consecutive",
 1171   "lines at the horizontal cursor position.",
 1172 };
 1173 
 1174 const char * const PLAY_HELP[16] = {
 1175   "Syntax: Play [TIMES]",
 1176   "Abbreviation: PL",
 1177   "",
 1178   "plays the current document's macro the given number of times.  If the",
 1179   "optional argument TIMES is not specified, you can enter it on the input",
 1180   "line.",
 1181   "",
 1182   "   A (possibly iterated) macro execution terminates as soon as its",
 1183   "stream of instructions is exhausted, or one of its commands returns an",
 1184   "error.  This means that, for instance, you can perform some complex",
 1185   "operation on all the lines containing a certain pattern by recording a",
 1186   "macro that searches for the pattern and performs the operation, and then",
 1187   "playing it a preposterously huge number of times.",
 1188   "",
 1189   "   Execution of a macro can be interrupted by '<Control>-\\'.",
 1190 };
 1191 
 1192 const char * const POPPREFS_HELP[25] = {
 1193   "Syntax: PopPrefs [N]",
 1194   "Abbreviation: POPP",
 1195   "",
 1196   "pops N sets of preferences from the preferences stack (where they were",
 1197   "placed previously by 'PushPrefs') and applies those preferences to the",
 1198   "current document.  See `PushPrefs'.  If not specified, N defaults",
 1199   "to one.  Note that the preferences stack is global, not document",
 1200   "specific.  Therefore you could 'PushPrefs' one document's preferences,",
 1201   "switch documents, then 'PopPrefs' those settings altering the",
 1202   "preferences for the second document.  The maximum preferences stack",
 1203   "depth is 32.",
 1204   "",
 1205   "   'PushPrefs' and 'PopPrefs' are useful in macros that require certain",
 1206   "preferences to work properly.  A macro can 'PushPrefs', change any",
 1207   "preferences necessary, do its work, then 'PopPrefs' to restore the users",
 1208   "previous preferences settings.",
 1209   "",
 1210   "PopPrefs restores the following values from the preferences stack:",
 1211   "",
 1212   "       AutoIndent  DelTabs   NoFileReq    StatusBar  VisualBell",
 1213   "       AutoPrefs   DoUndo    PreserveCR   ShiftTabs  WordWrap",
 1214   "       Binary      FreeForm  ReadOnly     Tabs",
 1215   "       CaseSearch  HexCode   RightMargin  TabSize",
 1216   "       ClipNumber  Insert    SearchBack   UTF8Auto",
 1217 };
 1218 
 1219 const char * const PRESERVECR_HELP[15] = {
 1220   "Syntax: PreserveCR [0|1]",
 1221   "Abbreviation: PCR",
 1222   "",
 1223   "sets the preserve carriage returns flag.  When a file is loaded into a",
 1224   "document for which this flag is false, both CR (carriage return) and NL",
 1225   "(new line) characters are treated as line terminators.  If the flag is",
 1226   "true, CR characters do not act as line terminators but are instead",
 1227   "preserved in the document.  This flag has no effect except when loading",
 1228   "a file into a document.",
 1229   "",
 1230   "   If you invoke 'PreserveCR' with no arguments, it will toggle the",
 1231   "flag.  If you specify 0 or 1, the flag will be set to false or true,",
 1232   "respectively.  An upper case 'P' will appear on the status bar if the",
 1233   "flag is true.",
 1234 };
 1235 
 1236 const char * const PREVDOC_HELP[5] = {
 1237   "Syntax: PrevDoc",
 1238   "Abbreviation: PD",
 1239   "",
 1240   "sets as current document the previous document in the document list.",
 1241 };
 1242 
 1243 const char * const PREVPAGE_HELP[8] = {
 1244   "Syntax: PrevPage [N]",
 1245   "Abbreviation: PP",
 1246   "",
 1247   "moves the cursor N pages backward, if the cursor is on the first line of",
 1248   "the screen; otherwise moves the cursor to the first line of the screen,",
 1249   "and moves by N-1 pages.  If the optional N argument is not specified, it",
 1250   "is assumed to be one.",
 1251 };
 1252 
 1253 const char * const PREVWORD_HELP[8] = {
 1254   "Syntax: PrevWord [N][<|>]",
 1255   "Abbreviation: PW",
 1256   "",
 1257   "moves the cursor to the left to the Nth word beginning or ending.  If",
 1258   "the optional N argument is not specified, one is used.  The optional '<'",
 1259   "or '>' determines whether to move to the word beginning or ending,",
 1260   "respectively.  If unspecified, the left end ('<') is used.",
 1261 };
 1262 
 1263 const char * const PUSHPREFS_HELP[24] = {
 1264   "Syntax: PushPrefs [N]",
 1265   "Abbreviation: PUSHP",
 1266   "",
 1267   "pushes N copies of the user preferences onto a stack.  If not specified,",
 1268   "N defaults to one.  Use the 'PopPrefs' command to pop preferences off",
 1269   "the stack and restore the values.  See `PopPrefs'.  Note that the",
 1270   "preferences stack is global, not document-specific, so you could",
 1271   "'PushPrefs' one document's preferences, switch documents, then",
 1272   "'PopPrefs' those preferences, thereby altering the preferences for the",
 1273   "second document.  The maximum preferences stack depth is 32.",
 1274   "",
 1275   "   'PushPrefs' and 'PopPrefs' are useful in macros that require certain",
 1276   "preferences to work properly.  A macro can 'PushPrefs', change any",
 1277   "preferences necessary, do its work, then 'PopPrefs' to restore the users",
 1278   "previous preferences settings.",
 1279   "",
 1280   "'PushPrefs' saves the following values on the preferences stack:",
 1281   "",
 1282   "       AutoIndent  DelTabs   NoFileReq    StatusBar  VisualBell",
 1283   "       AutoPrefs   DoUndo    PreserveCR   ShiftTabs  WordWrap",
 1284   "       Binary      FreeForm  ReadOnly     Tabs",
 1285   "       CaseSearch  HexCode   RightMargin  TabSize",
 1286   "       ClipNumber  Insert    SearchBack   UTF8Auto",
 1287 };
 1288 
 1289 const char * const QUIT_HELP[6] = {
 1290   "Syntax: Quit",
 1291   "Abbreviation: Q",
 1292   "",
 1293   "closes all documents and exits.  If any documents are modified, you have",
 1294   "to confirm the action.",
 1295 };
 1296 
 1297 const char * const READONLY_HELP[15] = {
 1298   "Syntax: ReadOnly [0|1]",
 1299   "Abbreviation: RO",
 1300   "",
 1301   "sets the read only flag.  When this flag is true, no editing can be",
 1302   "performed on the document (any such attempt produces an error message).",
 1303   "Saving read only documents is inhibited as well; you must affirmatively",
 1304   "answer a prompt to save a document with the read only flag set.  This",
 1305   "flag is automatically set whenever you open a file that you cannot write",
 1306   "to.  See `Open'.",
 1307   "",
 1308   "   If you invoke 'ReadOnly' with no arguments, it will toggle the flag.",
 1309   "If you specify 0 or 1, the flag will be set to false or true,",
 1310   "respectively.  A lower case 'r' will appear on the status bar if the",
 1311   "flag is true.",
 1312 };
 1313 
 1314 const char * const RECORD_HELP[22] = {
 1315   "Syntax: Record [0|1]",
 1316   "Abbreviation: REC",
 1317   "",
 1318   "starts, stops, cancels, or resumes macro recording.  With no arguments,",
 1319   "'Record' starts recording your commands as a new macro unless recording",
 1320   "is already underway.  In that case, macro recording is stopped, and the",
 1321   "newly recorded macro replaces the current document's unnamed macro.  The",
 1322   "new macro can be played or saved via `Play', or `SaveMacro'.",
 1323   "The default key binding for '<Control>-T' is 'Record' with no arguments,",
 1324   "and is by far the most common way to use the 'Record' command.",
 1325   "",
 1326   "   If you've started recording a macro and wish to cancel rather than",
 1327   "wipe out your existing macro, you can cancel the recording by using",
 1328   "'Record 0'.  An error will be displayed if you aren't recording already,",
 1329   "but it's harmless.",
 1330   "",
 1331   "   Sometimes you've got a macro either recorded or loaded from a file",
 1332   "(see `OpenMacro'), but you'd like to record additional commands",
 1333   "onto the end of it.  'Record 1' will do that.  It will start recording",
 1334   "onto the end of a copy of your current document's macro.  An error will",
 1335   "be displayed if you are already recording, but it's otherwise harmless.",
 1336 };
 1337 
 1338 const char * const REDO_HELP[8] = {
 1339   "Syntax: Redo [N]",
 1340   "Abbreviation: RE",
 1341   "",
 1342   "redoes the last N actions undone by 'Undo' (as long as you don't take",
 1343   "any actions that change the text between the 'Undo' and 'Redo'",
 1344   "commands).  If N is not specified, it is assumed to be one.  You can",
 1345   "only 'Redo' actions that have been 'Undo'ne.  See `Undo'.",
 1346 };
 1347 
 1348 const char * const REFRESH_HELP[11] = {
 1349   "Syntax: Refresh",
 1350   "Abbreviation: REF",
 1351   "",
 1352   "refreshes the display.  'Refresh' is very important, and should",
 1353   "preferably be bound to the '<Control>-L' sequence, for historical",
 1354   "reasons.  It can always happen that a noisy phone line or a quirk in the",
 1355   "terminal corrupts the display.  This command restores it from scratch.",
 1356   "",
 1357   "   'Refresh' has the side effect of checking to see if your window size",
 1358   "has changed, and will modify the display to take that into account.",
 1359 };
 1360 
 1361 const char * const REPEATLAST_HELP[31] = {
 1362   "Syntax: RepeatLast [TIMES] [F|Find|R|Replace]",
 1363   "Abbreviation: RL",
 1364   "",
 1365   "repeats for the given number of times the last find or replace operation",
 1366   "(with replace we mean here a single replace, even if the last 'Replace'",
 1367   "operation ended with a global substitution).  If you don't specify",
 1368   "either FIND or REPLACE, it will repeat whichever one was last performed.",
 1369   "",
 1370   "   If any find or replace operation runs into the end of the document",
 1371   "(in the direction indicated by the 'SearchBack' flag) and stops, then",
 1372   "and only then will a 'RepeatLast' command \"wrap around\" to the other end",
 1373   "of the document to continue the find or replace operation.",
 1374   "",
 1375   "   'RepeatLast' is especially useful for researching a given number of",
 1376   "times, or replacing something a given number of times.  The standard",
 1377   "technique for accomplishing this is:",
 1378   "",
 1379   "  1. 'Find' (or 'FindRegExp') the string you are interested in;",
 1380   "",
 1381   "  2. if you want to repeat a replace operation, 'ReplaceOnce' with the",
 1382   "     replacement string you are interested in;",
 1383   "",
 1384   "  3. now issue a 'RepeatLast N-1' command, where N is the number of",
 1385   "     occurrences you wanted to skip over, or replace.",
 1386   "",
 1387   "   The important thing about this sequence of actions is that it will",
 1388   "work this way even in a macro.  The 'Replace' command cannot be used in",
 1389   "a macro unless you really want to interact with 'ne' during the macro",
 1390   "execution.  Avoiding interaction during macros is the primary reason the",
 1391   "commands 'ReplaceAll' and 'ReplaceOnce' are provided.",
 1392 };
 1393 
 1394 const char * const REPLACE_HELP[45] = {
 1395   "Syntax: Replace [STRING]",
 1396   "Abbreviation: R",
 1397   "",
 1398   "moves to the first match of the most recent find string or regular",
 1399   "expression and prompts you for which action to perform.  You can choose",
 1400   "among:",
 1401   "",
 1402   "   * replacing the string found with the given string and moving to the",
 1403   "     next match ('Yes');",
 1404   "",
 1405   "   * moving to the next match ('No');",
 1406   "",
 1407   "   * replacing the string found with the given string, and stopping the",
 1408   "     search ('Last');",
 1409   "",
 1410   "   * stopping the search immediately ('Quit');",
 1411   "",
 1412   "   * replacing _all_ occurrences of the find string with the given",
 1413   "     string ('All');",
 1414   "",
 1415   "   * reversing the search direction ('Backward' or 'Forward'); this",
 1416   "     choice will also modify the value of the back search flag.  See",
 1417   "     `SearchBack'.",
 1418   "",
 1419   "   'Replace' is mainly useful for interactive editing.  'ReplaceOnce',",
 1420   "'ReplaceAll' and 'RepeatLast' are more suited to macros.",
 1421   "",
 1422   "   If no find string was ever specified, you can enter it on the input",
 1423   "line.  If the optional argument STRING is not specified, you can enter",
 1424   "it on the input line, the default being the last string used.  When the",
 1425   "last search was a regular expression search, there are some special",
 1426   "features you can use in the replace string .  See `FindRegExp'.",
 1427   "",
 1428   "   Note that normally a search starts just one character after the",
 1429   "cursor.  However, when 'Replace' is invoked, the search starts at the",
 1430   "character just _under_ the cursor, so that you can safely 'Find' a",
 1431   "pattern and 'Replace' it without having to move back.",
 1432   "",
 1433   "*Warning:* when recording a macro with `Record', there is no trace",
 1434   "in the macro of your interaction with 'ne' during the replacement",
 1435   "process.  When the macro is played, you will again have to choose which",
 1436   "actions to perform.  If you want to apply automatic replacement of",
 1437   "strings for a certain number of times, you should look at ",
 1438   "`ReplaceOnce', `ReplaceAll', and `RepeatLast'.",
 1439 };
 1440 
 1441 const char * const REPLACEALL_HELP[14] = {
 1442   "Syntax: ReplaceAll [STRING]",
 1443   "Abbreviation: RA",
 1444   "",
 1445   "is similar to 'ReplaceOnce', but replaces _all_ occurrences of the last",
 1446   "search pattern between the cursor position and the end of the document",
 1447   "(in the direction indicated by the 'SearchBack' flag) with the given",
 1448   "replacement string.",
 1449   "",
 1450   "   If the optional argument STRING is not specified, you can enter it on",
 1451   "the input line, the default being the last string used.",
 1452   "",
 1453   "   Note that a single 'Undo' will restore _all_ the occurrences of the",
 1454   "search pattern replaced by 'ReplaceAll'.  See `Undo'.",
 1455 };
 1456 
 1457 const char * const REPLACEONCE_HELP[10] = {
 1458   "Syntax: ReplaceOnce [STRING]",
 1459   "Abbreviation: R1",
 1460   "",
 1461   "acts just like 'Replace', but without any interaction with you (unless",
 1462   "there is no find string).  The first string matched by the last search",
 1463   "pattern, if it exists, is replaced by the given replacement string.",
 1464   "",
 1465   "   If the optional argument STRING is not specified, you can enter it on",
 1466   "the input line, the default being the last string used.",
 1467 };
 1468 
 1469 const char * const REQUESTORDER_HELP[15] = {
 1470   "Syntax: RequestOrder [0|1]",
 1471   "Abbreviation: RQO",
 1472   "",
 1473   "sets the request order flag.  When this flag is true, the requester",
 1474   "displays entries in column order.  Otherwise entries are displayed by",
 1475   "rows.",
 1476   "",
 1477   "   If you invoke 'RequestOrder' with no arguments, it will toggle the",
 1478   "flag.  If you specify 0 or 1, the flag will be set to false or true,",
 1479   "respectively.",
 1480   "",
 1481   "   The 'RequestOrder' setting is saved in your '~/.ne/.default#ap' file",
 1482   "when you use the 'SaveDefPrefs' command or the 'Save Def Prefs' menu.",
 1483   "It is not saved by the 'SaveAutoPrefs' command.",
 1484 };
 1485 
 1486 const char * const RIGHTMARGIN_HELP[12] = {
 1487   "Syntax: RightMargin [N]",
 1488   "Abbreviation: RM",
 1489   "",
 1490   "sets the right margin for all formatting operations, and for 'WordWrap'.",
 1491   "See `WordWrap'.",
 1492   "",
 1493   "   If the optional argument N is not specified, you can enter it on the",
 1494   "input line, the default being the current value of the right margin.",
 1495   "",
 1496   "   A value of zero for N will force 'ne' to use (what it thinks it is)",
 1497   "the current screen width as right margin.",
 1498 };
 1499 
 1500 const char * const SAVE_HELP[18] = {
 1501   "Syntax: Save",
 1502   "Abbreviation: S",
 1503   "",
 1504   "saves the current document using its default file name.",
 1505   "",
 1506   "   If the current document is unnamed, the file requester will open and",
 1507   "you will be prompted to select a file.  (You can inhibit the file",
 1508   "requester opening by using the 'NoFileReq' command; see ",
 1509   "`NoFileReq'.)",
 1510   "",
 1511   "   If you escape from the file requester, you can input the file name on",
 1512   "the command line.",
 1513   "",
 1514   "   If the file has been modified since the current document was loaded",
 1515   "or last saved (perhaps by another user), 'ne' will warn you before",
 1516   "overwriting the updated file.  If the current document's read only flag",
 1517   "is set, 'ne' will prompt you before attempting to save it.",
 1518 };
 1519 
 1520 const char * const SAVEALL_HELP[11] = {
 1521   "Syntax: SaveAll",
 1522   "Abbreviation: SL",
 1523   "",
 1524   "saves all modified documents.  If any modified documents cannot be",
 1525   "saved, the action is suspended and an error message is issued.  Note",
 1526   "that only named documents can be saved, so 'SaveAll' will report an",
 1527   "error if you have any modified unnamed documents.  Other reasons",
 1528   "'SaveAll' may fail include: if any of the modified documents'",
 1529   "corresponding files have been updated since they were loaded or last",
 1530   "saved, or if any modified documents' read only flags are set.",
 1531 };
 1532 
 1533 const char * const SAVEAS_HELP[19] = {
 1534   "Syntax: SaveAs [FILENAME]",
 1535   "Abbreviation: SA",
 1536   "",
 1537   "saves the current document using the specified string as the file name.",
 1538   "",
 1539   "   If the optional FILENAME argument is not specified, the file",
 1540   "requester will open and you will be prompted to select a file.  (You can",
 1541   "inhibit the file requester opening by using the 'NoFileReq' command; see",
 1542   "`NoFileReq'.)",
 1543   "",
 1544   "   If you escape from the file requester, you can enter the file name on",
 1545   "the input line, the default being the current document name, if",
 1546   "available.",
 1547   "",
 1548   "   If the file has been modified since the current document was loaded",
 1549   "or last saved (perhaps by another user), 'ne' will warn you before",
 1550   "overwriting the updated file.  If the current document's read only flag",
 1551   "is set, 'ne' will prompt you before attempting to save it.",
 1552 };
 1553 
 1554 const char * const SAVEAUTOPREFS_HELP[7] = {
 1555   "Syntax: SaveAutoPrefs",
 1556   "Abbreviation: SAP",
 1557   "",
 1558   "saves the current preferences to the file in '~/.ne' associated with the",
 1559   "current document's file name extension.  If the current file name has no",
 1560   "extension, an error message is issued.  See `AutoPrefs'.",
 1561 };
 1562 
 1563 const char * const SAVECLIP_HELP[13] = {
 1564   "Syntax: SaveClip [FILENAME]",
 1565   "Abbreviation: SC",
 1566   "",
 1567   "saves the current clip to the given file name.",
 1568   "",
 1569   "   If the optional FILENAME argument is not specified, the file",
 1570   "requester will open and you will be prompted to select a file.  (You can",
 1571   "inhibit the file requester opening by using the 'NoFileReq' command; see",
 1572   "`NoFileReq'.)",
 1573   "",
 1574   "   If you escape from the file requester, you can enter the file name on",
 1575   "the input line.",
 1576 };
 1577 
 1578 const char * const SAVEDEFPREFS_HELP[6] = {
 1579   "Syntax: SaveDefPrefs",
 1580   "Abbreviation: SDP",
 1581   "",
 1582   "saves the current preferences to the '~/.ne/.default#ap' file.  This",
 1583   "file is always loaded by 'ne' at startup.",
 1584 };
 1585 
 1586 const char * const SAVEMACRO_HELP[20] = {
 1587   "Syntax: SaveMacro [FILENAME]",
 1588   "Abbreviation: SM",
 1589   "",
 1590   "saves the current document's macro in a file with the given name.",
 1591   "",
 1592   "   If the optional FILENAME argument is not specified, the file",
 1593   "requester is opened, and you are prompted to select a file.  (You can",
 1594   "inhibit the file requester opening by using the 'NoFileReq' command; see",
 1595   "`NoFileReq'.)",
 1596   "",
 1597   "   If you escape from the file requester, you can input the file name on",
 1598   "the command line.",
 1599   "",
 1600   "   'SaveMacro' is of course most useful for saving macros you just",
 1601   "recorded.  The macros can then be loaded as normal text files for",
 1602   "further editing, if necessary.  Note that 'SaveMacro' converts",
 1603   "'InsertChar' commands into a possibly smaller number of 'InsertString'",
 1604   "commands.  This makes macros easier to read and edit.  See ",
 1605   "`InsertChar', and `InsertString'.",
 1606 };
 1607 
 1608 const char * const SAVEPREFS_HELP[11] = {
 1609   "Syntax: SavePrefs [FILENAME]",
 1610   "Abbreviation: SP",
 1611   "",
 1612   "saves the current preferences to the given file.",
 1613   "",
 1614   "   If the optional FILENAME argument is not specified, the file",
 1615   "requester is opened, and you are prompted to select a file.  (You can",
 1616   "inhibit the file requester opening by using the 'NoFileReq' command; see",
 1617   "`NoFileReq'.)  If you escape from the file requester, you can",
 1618   "input the file name on the command line.",
 1619 };
 1620 
 1621 const char * const SEARCHBACK_HELP[14] = {
 1622   "Syntax: SearchBack [0|1]",
 1623   "Abbreviation: SB",
 1624   "",
 1625   "sets the back search flag.  When this flag is true, every search or",
 1626   "replacement command is performed backwards.",
 1627   "",
 1628   "   If you invoke 'SearchBack' with no arguments, it will toggle the",
 1629   "flag.  If you specify 0 or 1, the flag will be set to false or true,",
 1630   "respectively.  A lower case 'b' will appear on the status bar if the",
 1631   "flag is true.",
 1632   "",
 1633   "   Note that this flag also can be set through interactions with the",
 1634   "'Replace' command.  See `Replace'.",
 1635 };
 1636 
 1637 const char * const SELECTDOC_HELP[24] = {
 1638   "Syntax: SelectDoc",
 1639   "Abbreviation: SD",
 1640   "",
 1641   "displays a requester containing the names of all the documents in",
 1642   "memory.  Your cursor will be on your current document's name, and",
 1643   "documents with unsaved changes will be indicated with asterisks (and",
 1644   "bold if your terminal supports that).  You select whichever document you",
 1645   "want to become the current document by moving your cursor to its name",
 1646   "and hitting <Return>..",
 1647   "",
 1648   "   While the list of documents is displayed, you can close unmodified",
 1649   "documents with your 'CloseDoc' key ('<Control>-Q'), and you can alter",
 1650   "their relative order using your 'NextDoc' and 'PrevDoc' keys (<f2> and",
 1651   "<f3>), which have the effect of swapping your currently selected",
 1652   "document with the next or previous document in the list, respectively.",
 1653   "",
 1654   "   If you escape from the requester, the requester goes away, you are",
 1655   "returned to your original current document (unless you closed it!), and",
 1656   "no reordering of documents takes place.",
 1657   "",
 1658   "   'SelectDoc' is especially useful if you have a large number of",
 1659   "documents open or if you want to quickly see which documents contain",
 1660   "unsaved changes.  See `NextDoc', and `PrevDoc'.",
 1661 };
 1662 
 1663 const char * const SETBOOKMARK_HELP[17] = {
 1664   "Syntax: SetBookmark [N|+1|-1|-|?]",
 1665   "Abbreviation: SBM",
 1666   "",
 1667   "sets a document bookmark to the current cursor position.  Each document",
 1668   "has 10 available bookmarks designated '0' to '9', plus the automatic",
 1669   "bookmark designated by '-'.  If no option is given, '0' is assumed.",
 1670   "Values of N from '0' to '9' set the Nth bookmark, while '+1' and '-1'",
 1671   "indicate respectively the next and previous available unset bookmarks.",
 1672   "You can also set the '-' automatic bookmark, but it will be reset",
 1673   "automatically to the current position whenever a 'GotoBookmark' command",
 1674   "is issued.",
 1675   "",
 1676   "   The '?' option will cause 'SetBookmark' to prompt you for a bookmark",
 1677   "designation.  The promp will include an indication of which bookmarks",
 1678   "are currently set.  You may find this useful in macros, or to bind a key",
 1679   "to 'SetBookmark ?'.",
 1680 };
 1681 
 1682 const char * const SHIFT_HELP[21] = {
 1683   "Syntax: Shift [<|>][n][t|s]]",
 1684   "Abbreviation: SH",
 1685   "",
 1686   "shifts the text on lines between the mark and the cursor either right",
 1687   "('>', the default) or left ('<') by adding or removing white space on",
 1688   "each line.  The adjustment size, specified as an unsigned integer 'n',",
 1689   "is in units of the current tab size ('t') or spaces ('s').  The default",
 1690   "is 1.  Adjustments start at the left edge of a vertical mark, or column",
 1691   "1 otherwise.  If the mark is not currently set, only the current line is",
 1692   "affected.",
 1693   "",
 1694   "   'Shift' will insert tab characters only if the document's 'Tabs' flag",
 1695   "and the 'ShiftTabs' flag are both set--in which case an upper case 'T'",
 1696   "will appear in the status bar.  If either of the 'Tabs' or 'ShiftTabs'",
 1697   "flags is unset (i.e there is no upper case 'T' in the status bar)",
 1698   "'Shift' will only insert spaces.",
 1699   "",
 1700   "   In the case of left shifts, if any indicated line has insufficient",
 1701   "leading white space for the requested adjustment to be made, then",
 1702   "'Shift' reports an error and makes no changes.",
 1703 };
 1704 
 1705 const char * const SHIFTTABS_HELP[9] = {
 1706   "Syntax: ShiftTabs [0|1]",
 1707   "Abbreviation: SHT",
 1708   "",
 1709   "sets the 'ShiftTabs' flag.  'ShiftTabs' has an effect only when the",
 1710   "'Tabs' flag is set, in which case an upper case 'T' appears in the",
 1711   "status bar.  When this flag and the 'Tabs' flag are both set, left and",
 1712   "right 'Shift' commands may use tab characters to adjust leading white",
 1713   "space.  Otherwise only spaces are used.  See `Shift'.",
 1714 };
 1715 
 1716 const char * const STATUSBAR_HELP[22] = {
 1717   "Syntax: StatusBar [0|1]",
 1718   "Abbreviation: ST",
 1719   "",
 1720   "sets the status bar flag.  When this flag is true, the status bar is",
 1721   "displayed at the bottom of the screen.  There are only two reasons to",
 1722   "turn off the status bar we are aware of:",
 1723   "",
 1724   "   * if you are using 'ne' through a slow connection, updating the",
 1725   "     line/column indicator can really slow down editing;",
 1726   "",
 1727   "   * scrolling caused by cursor movement on terminals that do not allow",
 1728   "     to set a scrolling region can produce annoying flashes at the",
 1729   "     bottom of the screen.",
 1730   "",
 1731   "   If you invoke 'StatusBar' with no arguments, it will toggle the flag.",
 1732   "If you specify 0 or 1, the flag will be set to false or true,",
 1733   "respectively.",
 1734   "",
 1735   "   The 'StatusBar' setting is saved in your '~/.ne/.default#ap' file",
 1736   "when you use the 'SaveDefPrefs' command or the 'Save Def Prefs' menu.",
 1737   "It is not saved by the 'SaveAutoPrefs' command.",
 1738 };
 1739 
 1740 const char * const SUSPEND_HELP[6] = {
 1741   "Syntax: Suspend",
 1742   "Abbreviation: SU",
 1743   "",
 1744   "suspends 'ne' and returns you to a shell prompt; usually, the shell",
 1745   "command 'fg' is used to resume 'ne'.",
 1746 };
 1747 
 1748 const char * const SYNTAX_HELP[46] = {
 1749   "Syntax: Syntax [NAME|*]",
 1750   "Abbreviation: SY",
 1751   "",
 1752   "loads the syntax with the given name, and colors the current document",
 1753   "accordingly.",
 1754   "",
 1755   "   If the optional NAME argument is not specified, you are prompted for",
 1756   "one.  The current one, if set, is suggested as the default.  Use the",
 1757   "<Tab> key for a requester of the extant syntax recognizers.  The special",
 1758   "NAME * turns off syntax highlighting for the current document.",
 1759   "Otherwise, NAME must match a syntax definition either in your",
 1760   "'~/.ne/syntax' directory or in a directory named 'syntax' inside 'ne''s",
 1761   "global directory.  Additionally, 'ne' has a table mapping common",
 1762   "suffixes to syntax names.  If there is no syntax with a given name, 'ne'",
 1763   "will try to remap the name using the following table (the string before",
 1764   "the colon is the name of the syntax file):",
 1765   "",
 1766   "        ada: adb, ads",
 1767   "        asm: s",
 1768   "        c: c++, cc, cpp, cxx, h, h++, hpp, l, lex, y, yacc",
 1769   "        cobol: cbl, cob",
 1770   "        csh: tcsh",
 1771   "        diff: patch",
 1772   "        fortran: f, F, for, f90, F90",
 1773   "        html: htm",
 1774   "        java: js",
 1775   "        lisp: el, lsp",
 1776   "        mason: mas",
 1777   "        ocaml: ml, mli",
 1778   "        pascal: p, pas",
 1779   "        perl: pl, pm",
 1780   "        ps: eps",
 1781   "        puppet: pp",
 1782   "        python: py, sage",
 1783   "        rexx: rex",
 1784   "        ruby: rb",
 1785   "        sh: bash, bash_login, bash_logout, bash_profile, bashrc, ksh,",
 1786   "            profile, rc",
 1787   "        skill: il",
 1788   "        tex: latex, dtx, sty",
 1789   "        texinfo: texi, txi",
 1790   "        troff: 1",
 1791   "        verilog: v, vh, vhd",
 1792   "        xml: xsd",
 1793   "        yaml: yml",
 1794 };
 1795 
 1796 const char * const SYSTEM_HELP[10] = {
 1797   "Syntax: System [COMMAND]",
 1798   "Abbreviation: SYS",
 1799   "",
 1800   "asks the shell to execute COMMAND.  The terminal is temporarily reset to",
 1801   "the state it was in before 'ne''s activation, and COMMAND is started.",
 1802   "When the execution is finished, control returns to 'ne'.",
 1803   "",
 1804   "   If the optional argument COMMAND is not specified, you can enter it",
 1805   "on the input line.",
 1806 };
 1807 
 1808 const char * const TABS_HELP[17] = {
 1809   "Syntax: Tabs [0|1]",
 1810   "Abbreviation: TAB",
 1811   "",
 1812   "sets the 'Tabs' flag.  When this flag is set, <Tab> key and the",
 1813   "'InsertTab' command will insert literal TAB characters.  Otherwise it",
 1814   "will insert enough spaces to have the same visual effect.",
 1815   "",
 1816   "   In normal editing, the <Tab> key invokes the command \"'InsertTab' 1\".",
 1817   "Unlike most others, the <Tab> key cannot be mapped to other commands.",
 1818   "Thus the 'Tabs' flag provides the only customization 'ne' offers for the",
 1819   "<Tab> key.",
 1820   "",
 1821   "   If set, either a lower case 't' or upper case 'T' will appear in the",
 1822   "status bar depending on the state of the 'ShiftTabs' flag.  (The",
 1823   "'ShiftTabs' flag is irrelevant if the 'Tabs' flag is off.)  See ",
 1824   "`ShiftTabs'.",
 1825 };
 1826 
 1827 const char * const TABSIZE_HELP[9] = {
 1828   "Syntax: TabSize [SIZE]",
 1829   "Abbreviation: TS",
 1830   "",
 1831   "sets the number of spaces 'ne' will use when expanding a TAB character.",
 1832   "",
 1833   "   If the optional argument SIZE is not specified, you can enter it on",
 1834   "the input line, the default being the current TAB size.  Allowed values",
 1835   "are strictly between 0 and half the width of the screen.",
 1836 };
 1837 
 1838 const char * const THROUGH_HELP[15] = {
 1839   "Syntax: Through [COMMAND]",
 1840   "Abbreviation: T",
 1841   "",
 1842   "asks the shell to execute COMMAND, piping the current block in the",
 1843   "standard input, and replacing it with the output of the command.  This",
 1844   "command is most useful with filters, such as 'sort'.  Its practical",
 1845   "effect is to pass the block through the specified filter.",
 1846   "",
 1847   "   Note that by selecting an empty block (or equivalently by having the",
 1848   "mark unset) you can use 'Through' to insert the output of any UN*X",
 1849   "command in your file.",
 1850   "",
 1851   "   If the optional argument COMMAND is not specified, you can enter it",
 1852   "on the input line.",
 1853 };
 1854 
 1855 const char * const TOGGLESEOF_HELP[10] = {
 1856   "Syntax: ToggleSEOF",
 1857   "Abbreviation: TSEOF",
 1858   "",
 1859   "moves the cursor to the start of document, if it is not already there;",
 1860   "otherwise, moves it to the end of the document.",
 1861   "",
 1862   "   This kind of toggling command is very useful in order to gain some",
 1863   "keystrokes on systems with very few keys.  See also `ToggleSEOL',",
 1864   "`MoveSOF', and `MoveEOF'.",
 1865 };
 1866 
 1867 const char * const TOGGLESEOL_HELP[10] = {
 1868   "Syntax: ToggleSEOL",
 1869   "Abbreviation: TSEOL",
 1870   "",
 1871   "moves the cursor to the start of the current line, if it is not already",
 1872   "there; otherwise, moves it to the end of the current line.",
 1873   "",
 1874   "   This kind of toggling command is very useful in order to gain some",
 1875   "keystrokes on systems with very few keys.  See also `ToggleSEOF',",
 1876   "`MoveSOL', and `MoveEOL'.",
 1877 };
 1878 
 1879 const char * const TOLOWER_HELP[5] = {
 1880   "Syntax: ToLower [N]",
 1881   "Abbreviation: TL",
 1882   "",
 1883   "acts exactly like 'ToUpper', but lowers the case.  See `ToUpper'.",
 1884 };
 1885 
 1886 const char * const TOUPPER_HELP[15] = {
 1887   "Syntax: ToUpper [N]",
 1888   "Abbreviation: TU",
 1889   "",
 1890   "shifts to upper case the letters from the cursor position up to the end",
 1891   "of a word, and moves to the first letter of next word for N times.",
 1892   "",
 1893   "   The description of the command may seem a little bit cryptic.  What",
 1894   "is really happening is that there are situations where you only want to",
 1895   "upper case the last part of a word.  In this case, you just have to",
 1896   "position the cursor in the first character you want to upper case, and",
 1897   "use 'ToUpper' with no argument.",
 1898   "",
 1899   "   If you apply 'ToUpper' on the first character of a word, it will just",
 1900   "upper case N words.",
 1901 };
 1902 
 1903 const char * const TURBO_HELP[29] = {
 1904   "Syntax: Turbo [STEPS]",
 1905   "Abbreviation: TUR",
 1906   "",
 1907   "sets the turbo parameter.  Iterated actions and global replaces will",
 1908   "update at most STEPS lines of the screen (or at most twice the number of",
 1909   "visible rows if STEPS is zero); then, update will be delayed to the end",
 1910   "of the action.",
 1911   "",
 1912   "   This feature is most useful when massive operations (such as",
 1913   "replacing thousands of occurrences of a pattern) have to be performed.",
 1914   "After having updated STEPS lines, 'ne' can proceed at maximum speed,",
 1915   "because no visual update has to be performed.",
 1916   "",
 1917   "   The value of the turbo parameter has to be adapted to the kind of",
 1918   "terminal you are using.  Very high values can be good on high-speed",
 1919   "terminals, since the time required for the visual updates is very small,",
 1920   "and it is always safer to look at what the editor is really doing.  On",
 1921   "slow terminals, however, small values ensure that operations such as",
 1922   "paragraph formatting will not take too long.",
 1923   "",
 1924   "   You have to be careful about setting the turbo parameter too low.",
 1925   "'ne' keeps track internally of the part of the screen that needs refresh",
 1926   "in a very rough way.  This means that a value of less than, say, 8 will",
 1927   "force it to do a lot of unnecessary refresh.",
 1928   "",
 1929   "   The default value of this parameter is zero, which means twice the",
 1930   "number of lines of the screen; for several reasons this does seem to be",
 1931   "a good value.",
 1932 };
 1933 
 1934 const char * const UNDELLINE_HELP[15] = {
 1935   "Syntax: UndelLine [N]",
 1936   "Abbreviation: UL",
 1937   "",
 1938   "inserts at the cursor position for N times the last non-empty line that",
 1939   "was deleted with the 'DeleteLine' command.  If N is not specified, it is",
 1940   "assumed to be one.",
 1941   "",
 1942   "   'UndelLine' is most useful in that it allows a very fast way of",
 1943   "moving one line around.  Just delete it, and undelete it somewhere else.",
 1944   "It is also an easy way to replicate a line without getting involved with",
 1945   "clips.",
 1946   "",
 1947   "   Note that 'UndelLine' works independently of the status of the undo",
 1948   "flag.  See `DoUndo'.",
 1949 };
 1950 
 1951 const char * const UNDO_HELP[9] = {
 1952   "Syntax: Undo [N]",
 1953   "Abbreviation: U",
 1954   "",
 1955   "undoes the last N actions.  If N is not specified, it is assumed to be",
 1956   "one.  After you undo a number of actions, you can 'Redo' all or some of",
 1957   "them; see `Redo'.  However, if you take any new actions after",
 1958   "having 'Undo'ne some, you can no longer 'Redo' those 'Undo'ne actions.",
 1959   "See `Redo'.",
 1960 };
 1961 
 1962 const char * const UNLOADMACROS_HELP[12] = {
 1963   "Syntax: UnloadMacros",
 1964   "Abbreviation: UM",
 1965   "",
 1966   "frees the macro cache list.  After this command, the 'Macro' command",
 1967   "will be forced to search for the file containing the macros it has to",
 1968   "play.",
 1969   "",
 1970   "   'UnloadMacros' is especially useful if you are experimenting with a",
 1971   "macro bound to some keystroke, and you are interactively modifying it",
 1972   "and playing it.  'UnloadMacros' forces 'ne' to look for the newer",
 1973   "version available.",
 1974 };
 1975 
 1976 const char * const UNSETBOOKMARK_HELP[11] = {
 1977   "Syntax: UnsetBookmark [N|+1|-1|-|*]",
 1978   "Abbreviation: UBM",
 1979   "",
 1980   "unsets either the Nth bookmark, the next (+1) or previous (-1) set",
 1981   "bookmarks, the automatic (-) bookmark, or all (*) bookmarks, making it",
 1982   "as if they had never been set; see `SetBookmark'.  If no option is",
 1983   "specified, N is assumed to be zero.  While you can unset the automatic",
 1984   "bookmark '-', it will be reset automatically to the current position",
 1985   "whenever a 'GotoBookmark' command is issued.  Each document's valid",
 1986   "bookmark designations are 0 to 9, and the '-' automatic bookmark.",
 1987 };
 1988 
 1989 const char * const UTF8_HELP[20] = {
 1990   "Syntax: UTF8 [0|1]",
 1991   "Abbreviation: U8",
 1992   "",
 1993   "sets the UTF-8 flag.  When this flag is true, 'ne' considers the current",
 1994   "document as UTF-8 coded.  Note that this flag is set automatically upon",
 1995   "file loading (if possible) if you required automatic detection.  See",
 1996   "`UTF8Auto'.",
 1997   "",
 1998   "   If you invoke 'UTF8' with no arguments, it will toggle the flag.  If",
 1999   "you specify 0 or 1, the flag will be set to false or true, respectively.",
 2000   "When you try to set this flag, the document will be checked for UTF-8",
 2001   "compliance, and you will get an error message in case of failure.  When",
 2002   "you try to reset it, the document is set to ASCII or 8-bit, depending on",
 2003   "its content.  A 'U' will appear on the status bar if the flag is true.",
 2004   "Alternatively, an 'A' or an '8' will be displayed to denote whether the",
 2005   "document is composed exclusively by US-ASCII characters, or also by",
 2006   "other 8-bit characters (whose encoding is likely to be part of the",
 2007   "ISO-8859 family).  Note that each time this command modifies the",
 2008   "document encoding, it also resets the undo buffer.",
 2009 };
 2010 
 2011 const char * const UTF8AUTO_HELP[14] = {
 2012   "Syntax: UTF8Auto [0|1]",
 2013   "Abbreviation: U8A",
 2014   "",
 2015   "sets the UTF-8 automatic-detection flag.  When this flag is true, 'ne'",
 2016   "will try to guess whether a file just loaded is UTF-8 encoded.",
 2017   "Moreover, when a non US-ASCII character is inserted in a pure US-ASCII",
 2018   "document, ne will automatically switch to UTF-8.  See `UTF8'.  The",
 2019   "flag is true by default if 'ne' detects UTF-8 I/O at startup.  See ",
 2020   "`UTF8IO'.",
 2021   "",
 2022   "   If you invoke 'UTF8Auto' with no arguments, it will toggle the flag.",
 2023   "If you specify 0 or 1, the flag will be set to false or true,",
 2024   "respectively.",
 2025 };
 2026 
 2027 const char * const UTF8IO_HELP[13] = {
 2028   "Syntax: UTF8IO [0|1]",
 2029   "Abbreviation: U8IO",
 2030   "",
 2031   "sets the UTF-8 input/output flag.  This flag is set automatically",
 2032   "depending on your locale setting, and is used to determine whether",
 2033   "communication with the user (keyboard and terminal) should be UTF-8",
 2034   "encoded.  Normally you would not alter this flag, but sometimes 'ne' may",
 2035   "make the wrong guess (e.g., when you are remotely connected).",
 2036   "",
 2037   "   If you invoke 'UTF8IO' with no arguments, it will toggle the flag.",
 2038   "If you specify 0 or 1, the flag will be set to false or true,",
 2039   "respectively.  An '@' will appear on the status bar if the flag is true.",
 2040 };
 2041 
 2042 const char * const VERBOSEMACROS_HELP[21] = {
 2043   "Syntax: VerboseMacros [0|1]",
 2044   "Abbreviation: VM",
 2045   "",
 2046   "sets the verbose macros flag.  When this flag is true, all macros",
 2047   "generated by recording or by automatic preferences saving will contain",
 2048   "full names, instead of short names.  This is highly desirable if you are",
 2049   "going to edit the macro manually, but it can slow down command parsing.",
 2050   "",
 2051   "   If you invoke 'VerboseMacros' with no arguments, it will toggle the",
 2052   "flag.  If you specify 0 or 1, the flag will be set to false or true,",
 2053   "respectively.  A lower case 'v' will appear on the status bar if the",
 2054   "flag is true.",
 2055   "",
 2056   "   The only reason to use this flag is when recording a macro that will",
 2057   "be played a great number of times.  Automatic preferences files are too",
 2058   "short to be an issue with respect to execution timing.",
 2059   "",
 2060   "   The 'VerboseMacros' setting is saved in your '~/.ne/.default#ap' file",
 2061   "when you use the 'SaveDefPrefs' command or the 'Save Def Prefs' menu.",
 2062   "It is not saved by the 'SaveAutoPrefs' command.",
 2063 };
 2064 
 2065 const char * const VISUALBELL_HELP[10] = {
 2066   "Syntax: VisualBell [0|1]",
 2067   "Abbreviation: VB",
 2068   "",
 2069   "sets the visual bell flag.  When this flag is true, the terminal will",
 2070   "flash (if possible) instead of beeping.",
 2071   "",
 2072   "   If you invoke 'VisualBell' with no arguments, it will toggle the",
 2073   "flag.  If you specify 0 or 1, the flag will be set to false or true,",
 2074   "respectively.",
 2075 };
 2076 
 2077 const char * const WORDWRAP_HELP[15] = {
 2078   "Syntax: WordWrap [0|1]",
 2079   "Abbreviation: WW",
 2080   "",
 2081   "sets the word wrap flag.  When this flag is true, 'ne' will",
 2082   "automatically break lines of text when you attempt to insert characters",
 2083   "beyond the right margin.  See `RightMargin'.  'ne' will attempt to",
 2084   "preserve certain invariant characters at the left edge of paragraphs",
 2085   "typically used to indicate comments in source code or quoted passages in",
 2086   "email text.  See `Paragraph'.",
 2087   "",
 2088   "   If you invoke 'WordWrap' with no arguments, it will toggle the flag.",
 2089   "If you specify 0 or 1, the flag will be set to false or true,",
 2090   "respectively.  A lower case 'w' will appear on the status bar if the",
 2091   "flag is true.",
 2092 };
 2093 
 2094 /* This file was automatically generated by info2src.pl. */