NNNNNNNN((((1111)))) NNNNNNNN((((1111)))) RRRReeeelllleeeeaaaasssseeee 6666....4444....11118888 NNNNAAAAMMMMEEEE nn - efficient net news interface (No News is good news) SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS nnnnnnnn [ _o_p_t_i_o_n_s ] [ _n_e_w_s_g_r_o_u_p | +_f_o_l_d_e_r | _f_i_l_e ]... nnnnnnnn -g [ -r ] nnnnnnnn -a0 [ _n_e_w_s_g_r_o_u_p ]... DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN Net news is a world-wide information exchange service covering numerous topics in science and every day life. Topics are organized in _n_e_w_s _g_r_o_u_p_s, and these groups are open for everybody to post _a_r_t_i_c_l_e_s on a subject related to the topic of the group. _N_n is a `point-and-shoot' net news interface program, or a _n_e_w_s _r_e_a_d_e_r for short (not to be confused with the _h_u_m_a_n news reader). When you use _n_n, you can decide which of the many news groups you are interested in, and you can unsubscribe to those which don't interest you. _n_n will let you read the new (and old) articles in each of the groups you subscribe to using a menu based article selection prior to reading the articles in the news group. When a news group is entered, _n_n will locate all the presently unread articles in the group, and extract their sender, subject, and other relevant information. This information is then rearranged, sorted, and marked in various ways to give it a pleasant format when it is presented on the screen. This will be done very quickly, because _n_n uses its own database to maintain all the necessary information on a directly accessible form (this database is built and maintained by the _n_n_m_a_s_t_e_r(8) program). When the article menu appears on the screen, _n_n will be in a mode called sssseeeelllleeeeccccttttiiiioooonnnn mmmmooooddddeeee. In this mode, the articles which seems to be interesting can be selected by single keystrokes (using the keys a-z and 0-9). When all the interesting articles among the ones presently displayed have been selected, the space bar is hit, which causes _n_n to enter reading mode. In rrrreeeeaaaaddddiiiinnnngggg mmmmooooddddeeee, each of the selected articles will be presented. You use the ssssppppaaaacccceeee bbbbaaaarrrr to go on to the next page of the current article, or to the next article. Of course, there are all sorts of commands to scroll text up and down, skip to the next article, responding to an article, decrypt an article, and so on. When all the selected articles in the current group have been read, the last hit on the space bar will cause _n_n will continue to the next group with unread articles, and enter selection mode on that group. FFFFRRRREEEEQQQQUUUUEEEENNNNTTTTLLLLYYYY UUUUSSSSEEEEDDDD OOOOPPPPTTTTIIIIOOOONNNNSSSS _n_n accepts a lot of command line options, but here only the frequently used options are described. Options can also be set permanently by - 1 - Formatted: March 7, 1995 NNNNNNNN((((1111)))) NNNNNNNN((((1111)))) RRRReeeelllleeeeaaaasssseeee 6666....4444....11118888 including appropriate _v_a_r_i_a_b_l_e settings in the _i_n_i_t file described later. All options are described in the section on Command Line Options towards the end of this manual. The frequently used command line options are: -aaaa0000 Catch up on unread articles and groups. See the section "Catch up" below. -gggg Prompt for the name of a news group or folder to be entered (with completion). -rrrr Used with -gggg to repeatedly prompt for groups to enter. -llll_N Print only the first _N lines of the first page of each article before prompting to continue. This is useful on slow terminals and modem lines to be able to see the first few lines of longer articles. -ssss_W_O_R_D Collect only articles which contain the string _W_O_R_D in their subject (case is ignored). This is normally combined with the -x and -m options to find all articles on a specific subject. -ssss////_r_e_g_e_x_p Collect only articles whose subject matches the regular expression _r_e_g_e_x_p. This is normally combined with the -x and -m options to find all articles on a specific subject. -nnnn_W_O_R_D or -nnnn////_r_e_g_e_x_p Same as -ssss except that it matches on the sender's name instead of the article's subject. This is normally combined with the -x and -m options to find all articles from a specific author. It cannot be mixed with the -ssss option! -iiii Normally searches with -nnnn and -ssss are case independent. Using this option, the case becomes significant. -mmmm Merge all articles into one `meta group' instead of showing them one group at a time. This is normally used together with the -x and -s options to get all the articles on a specific subject presented on a single menu (when you don't care about which group they belong to). When -m is used, no articles will be marked as read. -xxxx[_N] Present (or scan) all (or the last _N) unread as well as read articles. When this option is used, _n_n will _n_e_v_e_r mark unread articles as read (i.e. .newsrc is not updated). -XXXX Read/scan unsubscribed groups also. Most useful when looking for a specific subject in aaaallllllll groups, e.g. - 2 - Formatted: March 7, 1995 NNNNNNNN((((1111)))) NNNNNNNN((((1111)))) RRRReeeelllleeeeaaaasssseeee 6666....4444....11118888 nn -mxX -sSubject all _n_e_w_s._g_r_o_u_p or _f_i_l_e or +_f_o_l_d_e_r If none of these arguments are given, all subscribed news groups will be used. Otherwise, only the specified news groups and/or files will be collected and presented. In specifying a news groups, the following `meta notation' can be used: If the news group ends with a `.' (or `.all'), all subgroups of the news group will be collected, e.g. comp.sources. If a news group starts with a `.' (or `all.'), all the matching subgroups will be collected, e.g. .sources.unix The argument `all' identifies all (subscribed) news groups. CCCCOOOOMMMMMMMMAAAANNNNDDDD IIIINNNNPPPPUUUUTTTT In general, _n_n commands consist of one or two key-strokes, and _n_n reacts instantly to the commands you give it; you don't have to enter rrrreeeettttuuuurrrrnnnn after each command (except where explicitly stated). Some commands have more serious effects than others, and therefore _n_n requests you to confirm the command. You confirm by hitting the the yyyy key, and reject by hitting the nnnn key. Some `trivial' requests may also be confirmed simply by hitting ssssppppaaaacccceeee.... For example, to confirm the creation of a save file, just hit ssssppppaaaacccceeee,,,, but if one or more directories also have to be created, you must enter yyyy.... Many commands will require that you enter a line of text, e.g. a file name or a shell command. If you enter ssssppppaaaacccceeee as the first character on a line, the line will be filled with a default value (if one is defined). For example, the default value for a file name is the last file name you have entered, and the default shell command is your previous shell command. You can edit this default value as well as a directly typed text, using the following editing commands. The eeeerrrraaaasssseeee, kkkkiiiillllllll, and iiiinnnntttteeeerrrrrrrruuuupppptttt keys are the keys defined by the current tty settings. On systems without job control, the ssssuuuussssppppeeeennnndddd key will be ccccoooonnnnttttrrrroooollll----ZZZZ while it is the current suspend character on system with job control. eeeerrrraaaasssseeee Delete the last character on the line. ddddeeeelllleeeetttteeee----wwwwoooorrrrdddd (normally ^W) Delete the last word or component of the input. kkkkiiiillllllll Delete all characters on the line. iiiinnnntttteeeerrrrrrrruuuupppptttt and ccccoooonnnnttttrrrroooollll----GGGG Cancel the command which needs the input. ssssuuuussssppppeeeennnndddd Suspend _n_n if supported by the system. Otherwise, spawn an interactive shell. - 3 - Formatted: March 7, 1995 NNNNNNNN((((1111)))) NNNNNNNN((((1111)))) RRRReeeelllleeeeaaaasssseeee 6666....4444....11118888 rrrreeeettttuuuurrrrnnnn Terminate the line, and continue with the command. RRRReeeellllaaaatttteeeedddd vvvvaaaarrrriiiiaaaabbbblllleeeessss: erase-key, flow-control, flush-typeahead, help-key, kill-key, word-key. BBBBAAAASSSSIIIICCCC CCCCOOOOMMMMMMMMAAAANNNNDDDDSSSS There are numerous commands in _n_n, and most of them can be invoked by a single keystroke. The descriptions in this manual are based on the standard bindings of the commands to the keys, but it is possible to customize these using the mmmmaaaapppp command described later. For each of the keystroke commands described in this manual, the corresponding command name will also be shown in curly braces, e.g. {ccccoooommmmmmmmaaaannnndddd}. The following commands work in both selection mode and in reading mode. The notation ^X means `control X': ???? {hhhheeeellllpppp} Help. Gives a one page overview of the commands available in the current mode. ^^^^LLLL {rrrreeeeddddrrrraaaawwww} Redraw screen. ^^^^RRRR {rrrreeeeddddrrrraaaawwww} Redraw screen (Same as ^L). ^^^^PPPP {mmmmeeeessssssssaaaaggggeeee} Repeat the last message shown on the message line. The command can be repeated to successively show previous messages (the maximum number of saved messages is controlled via the mmmmeeeessssssssaaaaggggeeee---- hhhhiiiissssttttoooorrrryyyy variable.) !!!! {sssshhhheeeellllllll} Shell escape. The user is prompted for a command which is executed by your favorite shell (see the sssshhhheeeellllllll variable). Shell escapes are described in detail later on. QQQQ {qqqquuuuiiiitttt} Quit _n_n. When you use this command, you neither lose unread articles in the current group nor the selections you might have made (unless the articles are expired in the meantime of course). VVVV {vvvveeeerrrrssssiiiioooonnnn} Print release and version information. ::::_c_o_m_m_a_n_d {ccccoooommmmmmmmaaaannnndddd} Execute the _c_o_m_m_a_n_d by name. This form can be used to invoke any of _n_n's commands, also those which cannot be bound to a key (such as ::::ccccoooorrrreeeedddduuuummmmpppp), or those which are not bound to a key by default (such as ppppoooosssstttt and uuuunnnnsssshhhhaaaarrrr). RRRReeeellllaaaatttteeeedddd aaaannnndddd bbbbaaaassssiiiicccc vvvvaaaarrrriiiiaaaabbbblllleeeessss: backup, backup-suffix, confirm-auto-quit, expert, mail, message-history, new-group-action, newsrc, quick-count. - 4 - Formatted: March 7, 1995 NNNNNNNN((((1111)))) NNNNNNNN((((1111)))) RRRReeeelllleeeeaaaasssseeee 6666....4444....11118888 SSSSEEEELLLLEEEECCCCTTTTIIIIOOOONNNN MMMMOOOODDDDEEEE In selection mode, the screen is divided into four parts: the header line showing the name of the news group and the number of articles, the menu lines which show the collected articles - one article per line, the prompt line where you enter commands, and the message line where _n_n prints various messages to you. Each menu line begins with an _a_r_t_i_c_l_e _i_d which is a unique letter (or digit if your screen can show more than 26 menu lines). To select an articles for reading, you simply enter the corresponding _i_d, and the menu line will be high- lighted to indicate that the article is selected. When you have selected all the interesting articles on the present menu, you simply hit ssssppppaaaacccceeee. If there are more articles collected for the current group than could be presented on one screenful of text, you will be presented with the next portion of articles to select from. When you have had the opportunity to select among all the articles in the group, hitting ssssppppaaaacccceeee will enter reading mode. If no articles have been selected in the current group, hitting ssssppppaaaacccceeee will enter selection mode on the next news group, or exit _n_n if the current group was the last news group with unread articles. It is thus possible to go through ALL unread articles (without reading any of them) just by hitting ssssppppaaaacccceeee a few times. The articles will be presented on the menu using one of the following layouts: 0: _x _N_a_m_e......... _S_u_b_j_e_c_t.............. +_1_2_3 1: _x _N_a_m_e......... _1_2_3 _S_u_b_j_e_c_t.............. 2: _x _1_2_3 _S_u_b_j_e_c_t................................... 3: _x _S_u_b_j_e_c_t........................................... 4: _x _S_u_b_j_e_c_t........................................ Here _x is the letter or digit that must be entered to select the article, _N_a_m_e is the real name of the sender (or the mail address if the real name cannot be found), _S_u_b_j_e_c_t is the contents of the "Subject:" line in the article, and _1_2_3 is the number of lines in the article. Layout 0 and 1 are just two ways to present the same information, while layout 2 and 3 are intended for groups whose articles have very long subject lines, e.g. comp.sources. Layout 4 is a hybrid between layout 1 and 3. It will normally use layout 1, but it will use layout 3 (with a little indentation) for menu lines where the subject is longer than the space available with layout 1. Layout 1 is the default layout, and an alternative menu line layout is selected using the -LLLL option or by setting the llllaaaayyyyoooouuuutttt variable. Once _n_n is started the layout can be changed at any time using the """" key {llllaaaayyyyoooouuuutttt}. The _N_a_m_e is limited to 16 characters, and to make maximum use of this space, _n_n will perform a series of simplifications on the name, e.g. changing first names into initials, removing domain names from mail addresses (if the real name is not - 5 - Formatted: March 7, 1995 NNNNNNNN((((1111)))) NNNNNNNN((((1111)))) RRRReeeelllleeeeaaaasssseeee 6666....4444....11118888 found) etc. It does a good job, but some people on the net put weird things into the From: field (or actually into their password file) which result in _n_n producing quite cryptic, and sometimes funny "names". One a usual 80 column terminal, the _S_u_b_j_e_c_t is limited to about 60 characters (75 in layout 3) and is thus only an approximation to the actual subject line which may be much longer. To get as much out of this space, _R_e: prefixes (in various forms) are recognized and replaced by a single `>' character (see the rrrreeee----llllaaaayyyyoooouuuutttt variable). Since articles are sorted according to the subject, two or more adjacent articles may share the same subject (ignoring any `>'s). In this case, only the first article will show the subject of the article; the rest will only show the `>' character in the subject field (or a `-' if there is no `>' at the beginning of the line). A typical menu will thus only show each subject once, saving a lot of time in scanning the news articles. If _c_o_n_s_o_l_i_d_a_t_e_d _m_e_n_u_s (see section below) are enabled, adjacent articles sharing the same subject will be shown with a _s_i_n_g_l_e line on the menu corresponding to the _f_i_r_s_t of the articles. The number of articles with the same subject will be shown as a braketed number in front of the subject, e.g. with layout 1: _x _N_a_m_e......... _1_2_3 [_4] _S_u_b_j_e_c_t.............. For further information see the section on consolidated menus below. RRRReeeellllaaaatttteeeedddd vvvvaaaarrrriiiiaaaabbbblllleeeessss: collapse-subject, columns, confirm-entry, confirm- entry-limit, entry-report-limit, fsort, kill, layout, limit, lines, long-menu, re-layout, repeat, slow-mode, sort, sort-mode, split, subject-match-limit, subject-match-offset, subject-match-parts. AAAARRRRTTTTIIIICCCCLLLLEEEE AAAATTTTTTTTRRRRIIIIBBBBUUUUTTTTEEEESSSS While _n_n is running and between invocations, _n_n associates an _a_t_t_r_i_b_u_t_e with each article on your system. These attributes are used to differentiate between read and unread articles, selected articles, articles marked for later treatment, etc. Depending on how _n_n is configured, these attributes can be saved between invocations of _n_n, or some of them may only be used while _n_n is running. The attribute is shown on the menu using either a single character following the _a_r_t_i_c_l_e _i_d or by high-lighting the menu line, depending on the attribute and the capabilities of the terminal. You can also change the attributes to your own taste (see the aaaattttttttrrrriiiibbbbuuuutttteeeessss variable). The attribute of an article can be changed explicitly using the selection mode commands described below, or it will change automatically for example when you have read or saved a selected article. If a command may change any article attributes, it will be noted in the description of the command. The following descriptions of the attributes will only mention the most important commands that may set (or preserve) the attribute. The following attributes may be associated with an article: rrrreeeeaaaadddd Menu attribute "." - indicates that the article has been read or saved. When you leave the group, these articles will be marked permanently read, and are not presented the next time you enter - 6 - Formatted: March 7, 1995 NNNNNNNN((((1111)))) NNNNNNNN((((1111)))) RRRReeeelllleeeeaaaasssseeee 6666....4444....11118888 the group. sssseeeeeeeennnn Menu attribute "," - indicates that the article is unread, but that it has been _p_r_e_s_e_n_t_e_d on a menu. Depending on how _n_n is configured, these articles will automatically be marked _r_e_a_d when you leave the group, they may remain _s_e_e_n, or they may just be _u_n_r_e_a_d the next time you enter the group (see the aaaauuuuttttoooo----jjjjuuuunnnnkkkk----sssseeeeeeeennnn, ccccoooonnnnffffiiiirrrrmmmm----jjjjuuuunnnnkkkk----sssseeeeeeeennnn, and rrrreeeettttaaaaiiiinnnn----sssseeeeeeeennnn----ssssttttaaaattttuuuussss variables). Only the commands ccccoooonnnnttttiiiinnnnuuuueeee (ssssppppaaaacccceeee) and rrrreeeeaaaadddd----sssskkkkiiiipppp (XXXX) will mark _u_n_r_e_a_d articles on the current (or all) menu pages as _s_e_e_n when they are used. Other commands that scroll through the menu pages or enter reading mode will let unread articles remain unread. uuuunnnnrrrreeeeaaaadddd Menu attribute " " - indicates an unread article. These articles were unread when you entered the group, and they may remain unread when you leave the group, unless they have been marked _s_e_e_n by the command that you used to leave the group or enter reading mode. sssseeeelllleeeecccctttteeeedddd Menu line high-lighted (or menu attribute "*") - indicates that you have selected the article. If you leave the group, the selected articles will remain selected the next time you enter the group. When you have read a selected article, the attribute will automatically change to _r_e_a_d. aaaauuuuttttoooo----sssseeeelllleeeecccctttteeeedddd These articles have the same appearance as _s_e_l_e_c_t_e_d articles on the menu, and the only difference is that these articles have been selected automatically via the auto-selection facility rather than manually by you. Very few commands differentiate between these attributes and if they do, it is explicitly stated in this manual. The main difference is that these articles are only marked as _u_n_r_e_a_d when you leave the group (supposing they will also be auto-selected the next the group is entered). This simplifies the house-keeping between invocations of _n_n. lllleeeeaaaavvvveeee Menu attribute "+" - indicates that the article is marked for later treatment by the lllleeeeaaaavvvveeee----aaaarrrrttttiiiicccclllleeee (llll) command. These articles may be selected (on demand) when you have read all selected articles in a group. However, if you do not select them then immediately, they are stored as the lllleeeeaaaavvvveeee----nnnneeeexxxxtttt attribute described below. lllleeeeaaaavvvveeee----nnnneeeexxxxtttt Menu attribute "=" - indicates that the article is marked for later treatment by the lllleeeeaaaavvvveeee----nnnneeeexxxxtttt (LLLL) command. This is a permanent attribute, which will remain on the article until you - 7 - Formatted: March 7, 1995 NNNNNNNN((((1111)))) NNNNNNNN((((1111)))) RRRReeeelllleeeeaaaasssseeee 6666....4444....11118888 either read the article, change the attribute, or it is expired. So assinging this attribute to an article will effectively keep it unread until _y_o_u do something. If the variable sssseeeelllleeeecccctttt----lllleeeeaaaavvvveeee---- nnnneeeexxxxtttt is set, _n_n will ask whether these articles should be sssseeeelllleeeecccctttteeeedddd on entry to a group (but naturally, doing so will change the lllleeeeaaaavvvveeee----nnnneeeexxxxtttt attribute to sssseeeelllleeeecccctttt). ccccaaaannnncccceeeelllllllleeeedddd Menu attribute "#" - indicates that the article has been cancelled. This is mainly useful when tidying a folder; it is set by the ccccaaaannnncccceeeellll (CCCC) command, and can be cleared by any command that change attributes, e.g. you can select and deselect the article. kkkkiiiilllllllleeeedddd Menu attribute "!" - indicates that the article has been killed (e.g. by the KKKK {kkkkiiiillllllll----sssseeeelllleeeecccctttt} command). Killed articles are immediately removed from the menu, so you should not normally see articles with this attribute. If you do, report it as a bug! The attributes are saved in two files: .newsrc (_r_e_a_d articles) and .nn/select (other attributes). Plain _u_n_r_e_a_d articles are saved by not occurring in either of these files. Both files are described in more detail later on. RRRReeeellllaaaatttteeeedddd vvvvaaaarrrriiiiaaaabbbblllleeeessss: attributes, auto-junk-seen, confirm-junk-seen, retain-seen- status, select-leave-next. SSSSEEEELLLLEEEECCCCTTTTIIIIOOOONNNN MMMMOOOODDDDEEEE CCCCOOOOMMMMMMMMAAAANNNNDDDDSSSS The primary purpose of the selection mode is of course to select the articles to be read, but numerous other commands may also be performed in this mode: saving of articles in files, replying and following up on articles, mailing/forwarding articles, shell escapes etc. As described above, the _s_e_l_e_c_t_e_d articles are marked either by showing the corresponding menu line in standout mode (reverse video), or if the terminal does not have this capability by placing an asterisk (*) after the selection letter or digit. Most commands which are used to select articles will work as toggle commands. If the article is not already selected, the _s_e_l_e_c_t_e_dattribute on the article(s), independent on the previous attribute. Otherwise, the article(s) will be _d_e_s_e_l_e_c_t_e_d and marked _u_n_r_e_a_d. Consequently, any article can be marked _u_n_r_e_a_d simply be selecting and deselecting it. During selection, the cursor will normally be placed on the article following the last article whose attribute was changed (initially the first article). The article pointed out by the cursor is called the _c_u_r_r_e_n_t _a_r_t_i_c_l_e, and the following commands work relative to the current article and cursor position. aaaabbbbcccc............zzzz 00001111........9999 {_a_r_t_i_c_l_e _N} The article with the given identification letter or digit is selected or deselected. The following article becomes the current article. If the variable aaaauuuuttttoooo----sssseeeelllleeeecccctttt----ssssuuuubbbbjjjjeeeecccctttt is set, all - 8 - Formatted: March 7, 1995 NNNNNNNN((((1111)))) NNNNNNNN((((1111)))) RRRReeeelllleeeeaaaasssseeee 6666....4444....11118888 articles with the same subject as the given article are selected. .... {sssseeeelllleeeecccctttt} Select or deselect the current article and move the cursor to the next article. ,,,, {lllliiiinnnneeee++++1111} Move the cursor to the next article. You can use the _d_o_w_n _a_r_r_o_w as well. //// {lllliiiinnnneeee----1111} Move cursor to previous article. You can use the _u_p _a_r_r_o_w as well. **** {sssseeeelllleeeecccctttt----ssssuuuubbbbjjjjeeeecccctttt} Select or deselect all articles with same subject as current article. This will work across several menu pages if necessary. ----_x {sssseeeelllleeeecccctttt----rrrraaaannnnggggeeee} Select or deselect the range of articles between the current article and the article specified by _x. For example you can select all articles from _e to _k by simply typing eeee----kkkk. The following commands may change the attributes on all articles on the current menu page, or on all articles on all menu pages. @@@@ {sssseeeelllleeeecccctttt----iiiinnnnvvvveeeerrrrtttt} Reverse selections. All selected articles on the current page are deselected, and vice-versa. (Use the ffffiiiinnnndddd command to select all articles.) ~~~~ {uuuunnnnsssseeeelllleeeecccctttt----aaaallllllll} Deselect all _a_u_t_o-_s_e_l_e_c_t_e_d articles in the group (this works across all menu pages). If the command is executed twice, the _s_e_l_e_c_t_e_d articles will also be deselected. ++++ {sssseeeelllleeeecccctttt----aaaauuuuttttoooo} Perform auto-selections in the group (see the section on "auto kill/select" below). ==== {ffffiiiinnnndddd} Prompts for a regular expression, and selects all articles on the menu (all pages) which matches the regular expression. Depending on the variable sssseeeelllleeeecccctttt----oooonnnn----sssseeeennnnddddeeeerrrr matching is performed against the subject (default) or the sender of the articles. An empty answer (==== rrrreeeettttuuuurrrrnnnn) will reuse the previous expression. Example: The command ==== .... rrrreeeettttuuuurrrrnnnn will select _a_l_l articles in the group. JJJJ {jjjjuuuunnnnkkkk----aaaarrrrttttiiiicccclllleeeessss} This is a very versatile command which can be used to perform all sorts of attribute changes, either on individual articles, all articles on the current menu page, all articles with a specific - 9 - Formatted: March 7, 1995 NNNNNNNN((((1111)))) NNNNNNNN((((1111)))) RRRReeeelllleeeeaaaasssseeee 6666....4444....11118888 attribute, or all available articles. To access all the functions of this command, the JJJJ key may have to be hit up to four times, to loop through different one-line menus. The full functionality of the jjjjuuuunnnnkkkk----aaaarrrrttttiiiicccclllleeeessss command is described in a separate section below. LLLL {lllleeeeaaaavvvveeee----nnnneeeexxxxtttt} This is a specialized version of the generic JJJJ {jjjjuuuunnnnkkkk----aaaarrrrttttiiiicccclllleeeessss} command to set the _l_e_a_v_e-_n_e_x_t attribute on a subset of the articles on the menu. It is also described further below. The following commands move between the pages belonging to the same news group when there are more articles than will fit on a single page. These commands will not change any article attributes. >>>> {ppppaaaaggggeeee++++1111} Goto next menu page. <<<< {ppppaaaaggggeeee----1111} Goto previous menu page, or to last menu page if on first menu page. $$$$ {ppppaaaaggggeeee====$$$$} Goto last menu page. ^^^^ {ppppaaaaggggeeee====1111} Goto first menu page. The following commands are used to enter reading mode for the selected articles, and to move between news groups (in selection mode). They may change article attributes if noted below. ssssppppaaaacccceeee {ccccoooonnnnttttiiiinnnnuuuueeee} Continue to next menu page, or if on last menu page, read the selected articles. If no articles have been selected, continue to the next news group. The _u_n_r_e_a_d articles on the current menu page will automatically be marked _s_e_e_n. rrrreeeettttuuuurrrrnnnn {ccccoooonnnnttttiiiinnnnuuuueeee----nnnnoooo----mmmmaaaarrrrkkkk} Identical to the ccccoooonnnnttttiiiinnnnuuuueeee command, except that the _u_n_r_e_a_d articles on the current menu page will remain _u_n_r_e_a_d. (The nnnneeeewwwwlllliiiinnnneeee key has the same effect). ZZZZ {rrrreeeeaaaadddd----rrrreeeettttuuuurrrrnnnn} Enter reading mode _i_m_m_e_d_i_a_t_e_l_y with the currently selected articles. When all articles have been read, return to selection mode in the _c_u_r_r_e_n_t group. It will mark _s_e_l_e_c_t_e_d articles _r_e_a_d as they are read, but _u_n_r_e_a_d articles are not normally changed (can be controlled with the variable mmmmaaaarrrrkkkkeeeedddd----bbbbyyyy----rrrreeeeaaaadddd----rrrreeeettttuuuurrrrnnnn.) XXXX {rrrreeeeaaaadddd----sssskkkkiiiipppp} Mark all _u_n_m_a_r_k_e_d articles _s_e_e_n on all menu pages (or the pages defined by the mmmmaaaarrrrkkkkeeeedddd----bbbbyyyy----rrrreeeeaaaadddd----sssskkkkiiiipppp variable), and enter reading - 10 - Formatted: March 7, 1995 NNNNNNNN((((1111)))) NNNNNNNN((((1111)))) RRRReeeelllleeeeaaaasssseeee 6666....4444....11118888 mode _i_m_m_e_d_i_a_t_e_l_y with the currently selected articles. As the selected articles are read, they are marked _r_e_a_d. When all selected articles have been read, _n_n will enter selection mode in the _n_e_x_t news group. WWWWhhhheeeennnn nnnnoooo aaaarrrrttttiiiicccclllleeeessss aaaarrrreeee sssseeeelllleeeecccctttteeeedddd,,,, iiiitttt ggggooooeeeessss ddddiiiirrrreeeeccccttttllllyyyy ttttoooo tttthhhheeee nnnneeeexxxxtttt ggggrrrroooouuuupppp. This can be used to skip all the articles in a large news group without having to go through all the menu pages. If you don't want to read the current group now, but want to keep it for later, you can use the following commands which will only mark _s_e_e_n and _r_e_a_d articles as read. Currently selected articles will still be selected the next time you enter the group. None of these commands will change any attributes themselves (by default). NNNN {nnnneeeexxxxtttt----ggggrrrroooouuuupppp} Go forward to the next group in the presentation sequence. If the variable mmmmaaaarrrrkkkkeeeedddd----bbbbyyyy----nnnneeeexxxxtttt----ggggrrrroooouuuupppp is set articles on the menu can optionally be marked _s_e_e_n PPPP {pppprrrreeeevvvviiiioooouuuussss} Go back to the previous group. This command will enter selection mode on the last active group (two P commands in sequence will bring you to the current group). If there are still some _u_n_r_e_a_d articles in the group, only those articles will be shown. Otherwise, all the articles which were unread when _n_n was invoked will be shown marked with the _r_e_a_d attribute (which can be changed as usual). As described in the "Article Attributes" section, the _r_e_a_d and _s_e_e_n articles will normally be marked read when you leave the group, and these articles are not shown the next time you enter the group. In all releases prior to release 6.4, it was impossible to have individual articles in a group marked _u_n_r_e_a_d when you left a group, and the default behaviour of release 6.4 will closely match the traditional behaviour. This means that the _s_e_e_n and _r_e_a_d articles are treated alike for most practical purposes with the default variable settings. If you don't like _n_n to silently mark the _s_e_e_n articles read, you can _s_e_t the variable ccccoooonnnnffffiiiirrrrmmmm----jjjjuuuunnnnkkkk----sssseeeeeeeennnn to get _n_n to prompt you for confirmation before doing this, or you can _u_n_s_e_t the variable aaaauuuuttttoooo----jjjjuuuunnnnkkkk----sssseeeeeeeennnn to simply keep the seen articles for the next time you enter the group. You then have to use the JJJJ {jjjjuuuunnnnkkkk----aaaarrrrttttiiiicccclllleeeessss} to mark articles read. Using rrrreeeettttuuuurrrrnnnn {ccccoooonnnnttttiiiinnnnuuuueeee----nnnnoooo----mmmmaaaarrrrkkkk} will also allow you to keep articles _u_n_r_e_a_d rather than marking them _s_e_e_n when scrolling through the menu pages and entering reading mode. If this is your preferred reading style, you can remap ssssppppaaaacccceeee to this command. RRRReeeellllaaaatttteeeedddd vvvvaaaarrrriiiiaaaabbbblllleeeessss: auto-junk-seen, auto-preview- mode, auto-select-subject, case-fold-search, confirm-auto-quit, confirm-entry, confirm-junk-seen, marked-by-next-group, marked- by-read-return, marked-by-read-skip, retain-seen-status, select- on-sender. CCCCOOOONNNNSSSSOOOOLLLLIIIIDDDDAAAATTTTEEEEDDDD MMMMEEEENNNNUUUUSSSS Normally, _n_n will use one menu line for each article, so if there are - 11 - Formatted: March 7, 1995 NNNNNNNN((((1111)))) NNNNNNNN((((1111)))) RRRReeeelllleeeeaaaasssseeee 6666....4444....11118888 many articles with identical subjects, each menu page will only contain a few different subjects. To have each subject occur only once on the menu, _n_n can operate with consolidated menus by setting the variable ccccoooonnnnssssoooolllliiiiddddaaaatttteeeedddd----mmmmeeeennnnuuuu. When consolidated menus are used, _n_n operates with two kinds of subjects: open and closed. An _o_p_e_n _s_u_b_j_e_c_t is a subject which is shown in the traditional way with one menu line for each article with the given subject. In other words, when consolidated menus are not used, all subjects are open (by default). A _c_l_o_s_e_d _s_u_b_j_e_c_t is a multi-article subject which is presented by a single menu line. This line will be the normal menu line for the first (oldest) article with the subject, but with the subject field annotated with a bracketed number showing the number of articles with that subject, e.g. a Kim F. Storm 12 [4] Future plans for nn b.Kim F. Storm 43 [3] More plans for nn In this example, there are four unread articles with subject `a' of which the first is posted by me and has 12 lines. The rest of the articles are hidden, and will only be shown on request. The `.' marker on subject `b' shows that all three articles within that subject have been read (or seen). To select (or deselect) ALL the articles within a closed subject, simply select the article shown on the menu; this will automatically select (or deselect) the rest (see auto-select-closed). When all the unread articles within a closed subject are selected, the menu line will be high-lighted. If you want to view the individual articles in a subject (maybe to select individual articles), you can open the subject with the commands: ((((xxxx Open subject _x on menu. (((((((( Open current subject. When you have completed viewing the opened subject, you can close it again using the commands: ))))xxxx Close subject _x on menu (_x is any article with the subject). )))))))) Close current subject. In the basic layout of the menu line for a closed subject as shown above, ALL articles in the closed subject are supposed to be either: _u_n_r_e_a_d The menu line is _n_o_t high-lighted. _s_e_l_e_c_t_e_d Menu line is fully high-lighted (if all UNREAD are selected). rrrreeeeaaaadddd////sssseeeeeeeennnn There is a `.' (read attribute) following the article id. If neither of these cases apply, i.e. there is a mixture of unread, selected, and seen/read articles, the bracketed number will have one of the following formats: - 12 - Formatted: March 7, 1995 NNNNNNNN((((1111)))) NNNNNNNN((((1111)))) RRRReeeelllleeeeaaaasssseeee 6666....4444....11118888 [U:T] There are U unread articles of T total (U0), the information between the brackets will be high-lighted (to show that something is selected, but not all the unread articles). NNNNoooottttiiiicccceeee: Consolidated menus only work with the `subject' and `lexical' sorting methods. Variables related to consolidated menus are: auto-select-closed, consolidated-menu, counter-delim-left, counter-delim-right, counter-padding, save-closed-mode. TTTTHHHHEEEE JJJJUUUUNNNNKKKK----AAAARRRRTTTTIIIICCCCLLLLEEEESSSS AAAANNNNDDDD LLLLEEEEAAAAVVVVEEEE----NNNNEEEEXXXXTTTT CCCCOOOOMMMMMMMMAAAANNNNDDDDSSSS The JJJJ {jjjjuuuunnnnkkkk----aaaarrrrttttiiiicccclllleeeessss} command is a very flexible command which can perform all sorts of attribute changes, either on individual articles, all articles on the current menu page, all articles with a specific attribute, or all available articles. To access all the functions of this command, the JJJJ key may have to be hit up to four times, to loop through different one-line menus: MMMMaaaarrrrkkkk RRRReeeeaaaadddd This submenu allows you to mark articles _r_e_a_d. UUUUnnnnmmmmaaaarrrrkkkk This submenu allows you to mark articles _u_n_r_e_a_d. SSSSeeeelllleeeecccctttt This submenu allows you to select articles based on their attribute. KKKKiiiillllllll This submenu allows you to mark articles _r_e_a_d and remove them from the menu based on their attribute. The LLLL {lllleeeeaaaavvvveeee----nnnneeeexxxxtttt} command is an extension of the JJJJ command with a fifth menu: LLLLeeeeaaaavvvveeee This menu allows you to mark articles for later handling with the _l_e_a_v_e-_n_e_x_t attribute which will keep the article unread until you explicitly change the attribute (e.g. by reading it) or it is expired. For each of these submenus, _n_n will list the most plausible choices you may use, but all of the following answers can be used at all submenus. When you have entered a choice, _n_n will afterward ask whether the change should be made to all menu pages or only the current page. JJJJ Show next submenu. - 13 - Formatted: March 7, 1995 NNNNNNNN((((1111)))) NNNNNNNN((((1111)))) RRRReeeelllleeeeaaaasssseeee 6666....4444....11118888 LLLL Change attribute on all _l_e_a_v_e articles. NNNN Change attribute on all _l_e_a_v_e-_n_e_x_t articles. RRRR Change attribute on all _r_e_a_d articles. SSSS Change attribute on all _s_e_e_n articles. UUUU Change attribute on all unmarked (i.e. _u_n_r_e_a_d) articles. AAAA Change attribute on _a_l_l articles no matter their current attribute. **** Change attribute on all _s_e_l_e_c_t_e_d articles on _t_h_e _c_u_r_r_e_n_t page. ++++ Change attribute on all _s_e_l_e_c_t_e_d articles on _a_l_l pages. aaaa----zzzz0000----9999 Change attribute on one or more specific articles on the current page. You end the list of articles by a ssssppppaaaacccceeee or by using one of the other choices described above. CCCChhhhaaaannnnggggeeee aaaattttttttrrrriiiibbbbuuuutttteeee oooonnnn _c_u_r_r_e_n_t aaaarrrrttttiiiicccclllleeee.... ,,,, //// Move the current article down or up the menu without changing any attributes. RRRREEEEAAAADDDDIIIINNNNGGGG MMMMOOOODDDDEEEE CCCCOOOOMMMMMMMMAAAANNNNDDDDSSSS In reading mode, the _s_e_l_e_c_t_e_d articles are presented one page at a time. To get the next page of an article, simply hit ssssppppaaaacccceeee, and when you are on the last page of an article, hit ssssppppaaaacccceeee to get to the next selected article. Articles are normally marked read when you go to the next article, while going back to the menu, quitting _n_n, etc. will retain the attribute on the current article. When you are on the last page of the last article, hit ssssppppaaaacccceeee to enter selection mode on the next group (or the current group if reading mode was entered using the ZZZZ command). To read an article, the following text scrolling commands are available: ssssppppaaaacccceeee {ccccoooonnnnttttiiiinnnnuuuueeee} Scroll _o_n_e _p_a_g_e _f_o_r_w_a_r_d or continue with the next article or group as described above. bbbbaaaacccckkkkssssppppaaaacccceeee //// ddddeeeelllleeeetttteeee {ppppaaaaggggeeee----1111} Go _o_n_e _p_a_g_e _b_a_c_k_w_a_r_d_s in article. dddd {ppppaaaaggggeeee++++1111////2222} Scroll one _h_a_l_f _p_a_g_e _f_o_r_w_a_r_d. uuuu {ppppaaaaggggeeee----1111////2222} Go one _h_a_l_f _p_a_g_e _b_a_c_k_w_a_r_d_s. - 14 - Formatted: March 7, 1995 NNNNNNNN((((1111)))) NNNNNNNN((((1111)))) RRRReeeelllleeeeaaaasssseeee 6666....4444....11118888 rrrreeeettttuuuurrrrnnnn {lllliiiinnnneeee++++1111} Scroll _o_n_e _l_i_n_e _f_o_r_w_a_r_d in the article. ttttaaaabbbb {sssskkkkiiiipppp----lllliiiinnnneeeessss} Skip over lines starting with the same character as the last line on the current page. This is useful to skip over included text or to the next file in a shell archive. ^^^^ {ppppaaaaggggeeee====1111} Move to the _f_i_r_s_t _p_a_g_e (excluding the header) of the article. $$$$ {ppppaaaaggggeeee====$$$$} Move to the _l_a_s_t _p_a_g_e of the article. gggg_N {lllliiiinnnneeee====@@@@} Move to line _N in the article. ////_r_e_g_e_x_p {ffffiiiinnnndddd} Search forward for text matching the regular expression _r_e_g_e_x_p in the article. If a matching text is found, it will be high- lighted. .... {ffffiiiinnnndddd----nnnneeeexxxxtttt} Repeat search for last regular expression. hhhh {ppppaaaaggggeeee====0000} Show the _h_e_a_d_e_r of the article, and continue from the top of the article. HHHH {ffffuuuullllllll----ddddiiiiggggeeeesssstttt} If the current article is extracted from a digest, show the entire digest article including its header. Another HHHH command will return to the current subarticle. DDDD {rrrrooootttt11113333} Turn _r_o_t_1_3 (caesar) decryption on and off for the current article, and redraw current page. If the article is saved while it is decrypted on the screen, it will be saved in decrypted form as well! cccc {ccccoooommmmpppprrrreeeessssssss} Turn compression on and off for the current article and redraw current page. With compression turned on, multiple spaces and tabs are shown as a single space. This makes it much easier to read right justified text which separate words with several spaces. (See also the ccccoooommmmpppprrrreeeessssssss variable) The following commands are used to move among the selected articles. nnnn {nnnneeeexxxxtttt----aaaarrrrttttiiiicccclllleeee} Move to next selected article. This command skips the rest of the current article, marks it _r_e_a_d, and jumps directly to the - 15 - Formatted: March 7, 1995 NNNNNNNN((((1111)))) NNNNNNNN((((1111)))) RRRReeeelllleeeeaaaasssseeee 6666....4444....11118888 first page of the next selected article (or to the next group if it was the last selected article). llll {lllleeeeaaaavvvveeee----aaaarrrrttttiiiicccclllleeee} Mark the current article with the _l_e_a_v_e attribute and continue with the next selected article. When all the selected articles in the current group have been read, these _l_e_f_t _o_v_e_r articles can be automatically selected and shown once more, or the treatment can be postponed to the next time you enter the group. This is particularly useful if you see an article which you may want to respond to unless one the following articles is already saying what you intended to say. LLLL {lllleeeeaaaavvvveeee----nnnneeeexxxxtttt} Mark the current article with the _l_e_a_v_e-_n_e_x_t attribute and continue with the next selected article. pppp {pppprrrreeeevvvviiiioooouuuussss} Goto previous article. kkkk {nnnneeeexxxxtttt----ssssuuuubbbbjjjjeeeecccctttt} Kill subject. Skips rest of current article, and all following articles with the same subject. The skipped articles are marked _r_e_a_d. To kill a subject permanently use the KKKK command. **** {sssseeeelllleeeecccctttt----ssssuuuubbbbjjjjeeeecccctttt} Show next article with _s_a_m_e subject (even if it is not selected). This command will _s_e_l_e_c_t all following articles with the same subject as the current article (similar to the `*' command in selection mode). This can be used to select only the first article on a subject in selection mode, and then select all follow-ups in reading mode if you find the article interesting. aaaa {aaaaddddvvvvaaaannnncccceeee----aaaarrrrttttiiiicccclllleeee} Goto the following article on the menu even if it is not selected. This command skips the rest of the current article and jumps directly to the first page of the next article (it will not skip to the next group if it is the last article). The attribute on the current article will be restored, except for the _u_n_r_e_a_d attribute which will be changed to _s_e_e_n. bbbb {bbbbaaaacccckkkk----aaaarrrrttttiiiicccclllleeee} Goto the article before current article on the menu even if it is not selected. This is similar to the aaaa command, except for the direction. The following commands perform an immediate return from reading mode to selection mode in the _c_u_r_r_e_n_t group or skip to the next group. ==== {ggggoooottttoooo----mmmmeeeennnnuuuu} Return to selection mode in the current group (think of = as the "icon" of the selection menu). The articles read so far will be - 16 - Formatted: March 7, 1995 NNNNNNNN((((1111)))) NNNNNNNN((((1111)))) RRRReeeelllleeeeaaaasssseeee 6666....4444....11118888 marked _r_e_a_d. NNNN {nnnneeeexxxxtttt----ggggrrrroooouuuupppp} Skip the rest of the _s_e_l_e_c_t_e_d and _u_n_r_e_a_d articles in the current group and go directly to the next group. Only the _r_e_a_d (and _s_e_e_n) articles in the current group are marked as read. XXXX {rrrreeeeaaaadddd----sssskkkkiiiipppp} Mark _a_l_l articles in the current group as read and go directly to the next group. (You will be asked to confirm this command.) RRRReeeellllaaaatttteeeedddd vvvvaaaarrrriiiiaaaabbbblllleeeessss: case-fold-search, compress, data-bits, date, header-lines, mark-overlap, monitor, overlap, scroll-clear-page, stop, trusted-escape-codes, wrap-header-margin. PPPPRRRREEEEVVVVIIIIEEEEWWWWIIIINNNNGGGG AAAARRRRTTTTIIIICCCCLLLLEEEESSSS IIIINNNN SSSSEEEELLLLEEEECCCCTTTTIIIIOOOONNNN MMMMOOOODDDDEEEE In selection mode, it is possible to read a specific article on the menu without entering reading mode for all the selected articles on the menu. Using the commands described below will enter reading mode for one article only, and then return to the menu mode immediately after (depending on the setting of the pppprrrreeeevvvviiiieeeewwww----ccccoooonnnnttttiiiinnnnuuuuaaaattttiiiioooonnnn variable). If there are more than 5 free lines at the bottom of the menu screen, _n_n will use that space to show the article (a minimal preview window can be permanently allocated with the wwwwiiiinnnnddddoooowwww variable). Otherwise, the screen will be cleared to show the article. After previewing an article, it will be marked read (if the pppprrrreeeevvvviiiieeeewwww---- mmmmaaaarrrrkkkk----rrrreeeeaaaadddd variable is set), and the following article will become the current article. %%%%_x {pppprrrreeeevvvviiiieeeewwww} Preview article _x. %%%%%%%% {pppprrrreeeevvvviiiieeeewwww} Preview the current article. When the article is being shown, the following reading mode commands are very useful: ==== {ggggoooottttoooo----mmmmeeeennnnuuuu} Skip the rest of the current article, and return to menu mode. nnnn {nnnneeeexxxxtttt----aaaarrrrttttiiiicccclllleeee} Skip the rest of the current article, and _p_r_e_v_i_e_w _t_h_e _n_e_x_t _a_r_t_i_c_l_e. llll {lllleeeeaaaavvvveeee----aaaarrrrttttiiiicccclllleeee} Mark the article as _s_e_l_e_c_t_e_d (!) on the menu for handling later on. Then skip the rest of the current article, and preview the next article. %%%%_y {pppprrrreeeevvvviiiieeeewwww} Preview article _y . If the variable aaaauuuuttttoooo----pppprrrreeeevvvviiiieeeewwww----mmmmooooddddeeee is set, - 17 - Formatted: March 7, 1995 NNNNNNNN((((1111)))) NNNNNNNN((((1111)))) RRRReeeelllleeeeaaaasssseeee 6666....4444....11118888 just hitting the article id in menu mode will enter preview mode on the specified article. RRRReeeellllaaaatttteeeedddd vvvvaaaarrrriiiiaaaabbbblllleeeessss: auto-preview-mode, min-window, preview-continuation, preview-mark-read, window. SSSSAAAAVVVVIIIINNNNGGGG AAAARRRRTTTTIIIICCCCLLLLEEEESSSS The following commands are used to save articles in files, unpack archives, decode binaries, etc. It is possible to use the commands in both reading mode to save the current article and in selection mode to save one or more articles on the menu. The saved articles will be _a_p_p_e_n_d_e_d to the specified file(s) followed by an empty line each. Both files and directories will be created as needed. When an article has been saved in a file, a message reporting the number of lines saved will be shown if the ssssaaaavvvveeee----rrrreeeeppppoooorrrrtttt variable is set (default on). SSSS {ssssaaaavvvveeee----ffffuuuullllllll} Save articles including the full article header. OOOO {ssssaaaavvvveeee----sssshhhhoooorrrrtttt} Save articles with a short header containing only the name of the sender, the subject, and the posting date of the article. WWWW {ssssaaaavvvveeee----bbbbooooddddyyyy} Write article _w_i_t_h_o_u_t a header. ::::pppprrrriiiinnnntttt {pppprrrriiiinnnntttt} Print article. Instead of a file name, this command will prompt for the print command to which the current article will be piped. The default print command is specified at compile time, but it can be changed by setting the pppprrrriiiinnnntttteeeerrrr variable. The output will be identical to that of the OOOO command. ::::ppppaaaattttcccchhhh {ppppaaaattttcccchhhh} Send articles through ppppaaaattttcccchhhh(1) (or the program defined in the ppppaaaattttcccchhhh----ccccoooommmmmmmmaaaannnndddd variable). Instead of a file name, you will be prompted for the name of a directory in which you want the patch command to be executed. _n_n will then pipe the body of the article through the patch command. The output from the patch process will be shown on the screen and also appended to a file named _P_a_t_c_h._R_e_s_u_l_t in the patch directory. ::::uuuunnnnsssshhhhaaaarrrr {uuuunnnnsssshhhhaaaarrrr} Unshar articles. You will be prompted for the name of a directory in which you want _n_n to unshar the articles. _n_n will then pipe the proper parts of the article body into a Bourne Shell whose working directory will be set to the specified directory. During the unpacking, the normal output from the unshar process will appear on the screen, and the menu or article text will be redrawn when the process is finished. The output is also appended to a file named _U_n_s_h_a_r._R_e_s_u_l_t in - 18 - Formatted: March 7, 1995 NNNNNNNN((((1111)))) NNNNNNNN((((1111)))) RRRReeeelllleeeeaaaasssseeee 6666....4444....11118888 the unshar directory. The file specified in uuuunnnnsssshhhhaaaarrrr----hhhheeeeaaaaddddeeeerrrr----ffffiiiilllleeee (default "Unshar.Headers") in the unshar directory will contain the header and initial text (before the shar data) from the article. You can use the `G' {ggggoooottttoooo----ggggrrrroooouuuupppp} command to look at the Unshar.Headers file. ::::ddddeeeeccccooooddddeeee {ddddeeeeccccooooddddeeee} Decode _u_u_e_n_c_o_d_e_d articles into binary files. You will be prompted for the name of a directory in which you want _n_n to place the decoded binary files (the file names are taken from the uuencoded data). _n_n will combine several articles into single files as needed, and you can even decode unrelated packages (into the same directory) with one ddddeeeeccccooooddddeeee command. To be able to decode a binary file which spans several articles, _n_n may have to _i_g_n_o_r_e lines which fail the normal sanity checks on uuencoded data instead of treating them as _t_r_a_n_s_m_i_s_s_i_o_n _e_r_r_o_r_s. Consequently, it is strongly recommended to check the resulting decoded file using the checksum which is normally contained in the original article. (Actually, you are also supposed to do this after decoding with a stand-alone uudecode program). The header and initial information in the decoded articles are saved in the file specified in ddddeeeeccccooooddddeeee----hhhheeeeaaaaddddeeeerrrr----ffffiiiilllleeee (default "Decode.Headers") in the same directory as the decoded files. If ddddeeeeccccooooddddeeee----sssskkkkiiiipppp----pppprrrreeeeffffiiiixxxx is non-null, ::::ddddeeeeccccooooddddeeee will attempt to ignore up to that many characters on each line to find the encoded data. This is particularly useful in some binaries groups where files are both uuencoded and packed with shar; _n_n will ignore the prefix added to each line by shar, and thus be able to unshar, concatenate, and decode multi-part postings automatically. In reading mode, the following keys can also be used to invoke the save commands: ssss Same as SSSS. oooo Same as OOOO. wwww Same as WWWW. PPPP Same as ::::pppprrrriiiinnnntttt. The save commands will prompt for a file name which is expanded according to the rules described in the section on file name expansion below. For each group, it is possible to specify a default save file in the init file, either in connection with the group presentation sequence or in a separate ssssaaaavvvveeee----ffffiiiilllleeeessss section (see below). If a default save file is specified for the group, _n_n will show this on the prompt line when it prompts for the file name. You can edit this name as usual, but if you kill the entire name immediately, _n_n will replace the default name with the last file name you entered. If - 19 - Formatted: March 7, 1995 NNNNNNNN((((1111)))) NNNNNNNN((((1111)))) RRRReeeelllleeeeaaaasssseeee 6666....4444....11118888 you kill this as well, _n_n will leave you with a blank line. If the qqqquuuuiiiicccckkkk----ssssaaaavvvveeee variable is set, _n_n will only prompt for a save file name when the current article is inside a folder; otherwise, the default save file defined in the init file will be used unconditionally. If the file (and directories in the path) does not exist, _n_n will ask whether the file (and the directories) should be created. If the file name contains an asterisk, e.g. part*.shar _n_n will save each of the articles in uniquely named files constructed by replacing the asterisk by numbers from the sequence 1, 2, 3, etc. The format of the string that replaces the * can be changed with the ssssaaaavvvveeee----ccccoooouuuunnnntttteeeerrrr variable, and the first number to use can be changed via ssssaaaavvvveeee----ccccoooouuuunnnntttteeeerrrr----ooooffffffffsssseeeetttt. In _s_e_l_e_c_t_i_o_n mode, _n_n will prompt you for the identifier of one or more articles you want to save. When you don't want to save more articles, just hit ssssppppaaaacccceeee. The saved articles will be marked _r_e_a_d. If you enter an asterisk `*' when you are prompted for an article to save, _n_n will automatically save all the _s_e_l_e_c_t_e_d articles on the _c_u_r_r_e_n_t menu page and mark them _r_e_a_d. Likewise, if you enter a plus `+', _n_n will save all the selected articles on _a_l_l menu pages and mark them _r_e_a_d. This is very useful to unpack an entire package using the ::::uuuunnnnsssshhhhaaaarrrr and ::::ddddeeeeccccooooddddeeee commands. It can also be used in combination with the _s_a_v_e _s_e_l_e_c_t_e_d _a_r_t_i_c_l_e_s feature to save a selection of articles in separate, successively numbered files. But do not confuse these two concepts! The SSSS**** and SSSS++++ commands can be used to save the selected articles in a single file as well as in separate files, and the _s_a_v_e _i_n _s_e_p_a_r_a_t_e _f_i_l_e_s feature can be used also when saving individual articles, either in the selection mode, or in the article reading mode. When articles are saved in a file with a full or partial header, any header lines in the _b_o_d_y of the article will be escaped by a tilde (e.g. ~From: ...) to enable _n_n to split the folder into separate articles. The escape string can be redefined via the eeeemmmmbbbbeeeeddddddddeeeedddd----hhhheeeeaaaaddddeeeerrrr----eeeessssccccaaaappppeeee variable. Articles can optionally be saved in MAIL or MMDF compatible format by setting the mmmmaaaaiiiillll----ffffoooorrrrmmmmaaaatttt and mmmmmmmmddddffff---- ffffoooorrrrmmmmaaaatttt variables. These variables only specify the format used when creating a new folder, while appending to an existing folder will be done in the format of the folder (unless ffffoooollllddddeeeerrrr----ffffoooorrrrmmmmaaaatttt----cccchhhheeeecccckkkk is false). RRRReeeellllaaaatttteeeedddd vvvvaaaarrrriiiiaaaabbbblllleeeessss: confirm-append, confirm-create, decode- header-file, decode-skip-prefix, default-save-file, folder-save-file, edit-patch-command, edit-print-command, edit-unshar-command, folder, folder-format-check, mail-format, mmdf-format, patch-command, printer, quick-save, save-counter, save-counter-offset, save-report, suggest- default-save, unshar-command, unshar-header-file. FFFFOOOOLLLLDDDDEEEERRRR MMMMAAAAIIIINNNNTTTTEEEENNNNAAAANNNNCCCCEEEE When more than one article is saved in a folder, _n_n is able to split the folder, and each article in the folder can be treated like a separate article. This means that you can save, decode, reply, follow-up, etc. just as with the original article. You can also _c_a_n_c_e_l (delete) individual articles in a folder using the normal CCCC - 20 - Formatted: March 7, 1995 NNNNNNNN((((1111)))) NNNNNNNN((((1111)))) RRRReeeelllleeeeaaaasssseeee 6666....4444....11118888 {ccccaaaannnncccceeeellll} command described later. When you quit from the folder, you will then be given the option to remove the cancelled articles from the folder. The original folder is saved in a file named `BackupFolder~' in the .nn directory (see the bbbbaaaacccckkkkuuuupppp----ffffoooollllddddeeeerrrr----ppppaaaatttthhhh variable) by renaming or copying the old folder as appropriate. When the folder has been compressed, the backup folder will be removed unless the variable kkkkeeeeeeeepppp----bbbbaaaacccckkkkuuuupppp----ffffoooollllddddeeeerrrr is set. If all articles in a folder are cancelled, the folder will be removed or truncated to zero length (whatever is allowed by directory and file permissions). In this case no backup folder is retained even when kkkkeeeeeeeepppp----bbbbaaaacccckkkkuuuupppp----ffffoooollllddddeeeerrrr is set! If the variable ttttrrrraaaacccceeee----ffffoooollllddddeeeerrrr----ppppaaaacccckkkkiiiinnnngggg is set, _n_n will show which articles are kept and which are removed as the folder is rewritten. Folders are rewritten in the format of the original folder, i.e. the mmmmaaaaiiiillll----ffffoooorrrrmmmmaaaatttt and mmmmmmmmddddffff----ffffoooorrrrmmmmaaaatttt variables are ignored. RRRReeeellllaaaatttteeeedddd vvvvaaaarrrriiiiaaaabbbblllleeeessss: backup-folder-path, keep-backup-folder, trace-folder-packing. FFFFIIIILLLLEEEE NNNNAAAAMMMMEEEE EEEEXXXXPPPPAAAANNNNSSSSIIIIOOOONNNN When the save commands prompts for a file name, the following file name expansions are performed on the file name you enter: ++++_f_o_l_d_e_r The ++++ is replaced by the contents of the ffffoooollllddddeeeerrrr variable (default value "~/News/") resulting in the name of a file in the _f_o_l_d_e_r _d_i_r_e_c_t_o_r_y. Examples: +emacs, +nn, +sources/shar/nn ++++ A single plus is replaced by the expansion of the file name contained in the ddddeeeeffffaaaauuuulllltttt----ssssaaaavvvveeee----ffffiiiilllleeee variable (or by ffffoooollllddddeeeerrrr----ssssaaaavvvveeee---- ffffiiiilllleeee when saving from a folder). ~~~~////_f_i_l_e The ~~~~ is replaced by the contents of the environment variable HOME, i.e. the path name of your home directory. Examples: ~/News/emacs, ~/News/nn, ~/src/shar/nn ~~~~_u_s_e_r////_f_i_l_e The ~~~~_u_s_e_r part is replaced by the _u_s_e_r's home directory as defined in the /etc/passwd file. ||||_c_o_m_m_a_n_d-_l_i_n_e Instead of writing to a file, the articles are piped to the given shell (/bin/sh) command-line. Each save or write command will create a separate pipe, but all articles saved or written in one command (in selection mode) are given as input to the same shell command. Example: | pr | lp This will print the articles on the printer after they have been piped through pr. It is possible to create separate pipes for each saved article by using a double pipe symbol in the beginning of the command, e.g. - 21 - Formatted: March 7, 1995 NNNNNNNN((((1111)))) NNNNNNNN((((1111)))) RRRReeeelllleeeeaaaasssseeee 6666....4444....11118888 || cd ~/src/nn ; patch The following symbols are expanded in a file name or command: $$$$FFFF will be expanded to the name of the current group with the periods replaced by slashes, e.g. rec/music/synth. $$$$GGGG will be expanded to the name of the current group. $$$$LLLL will be expanded to the _l_a_s_t _c_o_m_p_o_n_e_n_t of the name of the current group. You may use this to create default save file names like +src/$L in the comp.sources groups. $$$$NNNN will be expanded to the (local) article number, e.g. 1099. In selection mode it is only allowed at the end of the file name! $$$$((((VVVVAAAARRRR)))) is replaced by the string value of the environment variable _V_A_R. Using these symbols, a simple naming scheme for `default folder name' is ++++$$$$GGGG which will use the group name as folder name. Another possibility is ++++$$$$FFFF////$$$$NNNN. As mentioned above, you can also instruct _n_n to save a series of files in separate, unique files. All that is required is that the file name contains an asterisk, e.g. +src/hype/part*.shar This will cause each of the articles to be saved in separate, unique files named part1.shar, part2.shar, and so on, always choosing a part number that results in a unique file name (i.e. if part1.shar did already exist, the first article would be saved in part2.shar, the next in part3.shar, and so on). RRRReeeellllaaaatttteeeedddd vvvvaaaarrrriiiiaaaabbbblllleeeessss: default-save-file, folder, folder-save-file, save- counter, save-counter-offset. FFFFIIIILLLLEEEE AAAANNNNDDDD GGGGRRRROOOOUUUUPPPP NNNNAAAAMMMMEEEE CCCCOOOOMMMMPPPPLLLLEEEETTTTIIIIOOOONNNN When entering a file name or a news group name, a simple ccccoooommmmpppplllleeeettttiiiioooonnnn feature is available using the ssssppppaaaacccceeee, ttttaaaabbbb, and ???? keys. Hitting ssssppppaaaacccceeee anywhere during input will complete the _c_u_r_r_e_n_t _c_o_m_p_o_n_e_n_t of the file name or group name with the _f_i_r_s_t available possibility. If this possibility is not the one you want, keep on hitting ssssppppaaaacccceeee until it appears. When the right completion has appeared, you can just continue typing the file or group name, or you can hit ttttaaaabbbb to fix the current component, and get the _f_i_r_s_t possibility for the next component, and then use ssssppppaaaacccceeee to go through the other possible completions. The ???? key will produce a list of the possible _c_o_m_p_l_e_t_i_o_n_s of the current component. If the list is too long for the available space on screen, the key can be repeated to get the next part of the list. The current completion can be deleted with the eeeerrrraaaasssseeee key. The default value for a file name is the last file name you have entered, so if you enter a ssssppppaaaacccceeee as the first character after the prompt, the last file name will be repeated (and you can edit it if you like). In some cases, a string will already be written for you in the prompt line, and to get the default value in these cases, use - 22 - Formatted: March 7, 1995 NNNNNNNN((((1111)))) NNNNNNNN((((1111)))) RRRReeeelllleeeeaaaasssseeee 6666....4444....11118888 the kkkkiiiillllllll key. This also means that if you neither want the initial value, nor the default value, you will have to hit the kkkkiiiillllllll twice to get a clean prompt line. RRRReeeellllaaaatttteeeedddd vvvvaaaarrrriiiiaaaabbbblllleeeessss: comp1-key, comp2-key, help-key, suggest-default-save. PPPPOOOOSSSSTTTTIIIINNNNGGGG AAAANNNNDDDD RRRREEEESSSSPPPPOOOONNNNDDDDIIIINNNNGGGG TTTTOOOO AAAARRRRTTTTIIIICCCCLLLLEEEESSSS In both selection mode and reading mode you can post new articles, post follow-ups to articles, send replies to the author of an article, and you can send mail to another user with the option of including an article in the letter. In reading mode, a response is made to the current article, while in selection mode you will be prompted for an article to respond to. The following commands are available (the lower-case equivalents are also available in reading mode): RRRR {rrrreeeeppppllllyyyy} Reply through mail to the author of the article. This is the preferred way to respond to an article unless you think your reply is of general interest. FFFF {ffffoooolllllllloooowwww} Follow-up with an article in the same newsgroup (unless an alternative group is specified in the article header). The distribution of the follow-up is normally the same as the original article, but this can be modified via the ffffoooolllllllloooowwww---- ddddiiiissssttttrrrriiiibbbbuuuuttttiiiioooonnnn variable. MMMM {mmmmaaaaiiiillll} Mail a letter or _f_o_r_w_a_r_d an article to a single recipient. In selection mode, you will be prompted for an article to include in your letter, and in reading mode you will be asked if the current article should be included in the letter. You will then be prompted for the recipient of the letter (default recipient is yourself) and the subject of the letter (if an article is included, you may hit ssssppppaaaacccceeee to get the default subject which is the subject of the included article). The header of the article is only included in the posted letter if it is forwarded (i.e. not edited), or if the variable iiiinnnncccclllluuuuddddeeee----ffffuuuullllllll----hhhheeeeaaaaddddeeeerrrr is set. ::::ppppoooosssstttt {ppppoooosssstttt} Post a new article to any newsgroup. This command will prompt you for a _c_o_m_m_a-_s_e_p_a_r_a_t_e_d list of newsgroups to post to (you cannot enter a space because ssssppppaaaacccceeee is used for group name completion as described below). If you enter ???? {hhhheeeellllpppp----kkkkeeeeyyyy} as the first key, _n_n will show you a list of all available news groups and their purpose. While paging through this list, you can enter qqqq to quit looking at the list. You can also enter //// followed by a regular expression (typically a single word) which will cause _n_n to show a (much shorter) list containing only the lines matching the regular expression. - 23 - Formatted: March 7, 1995 NNNNNNNN((((1111)))) NNNNNNNN((((1111)))) RRRReeeelllleeeeaaaasssseeee 6666....4444....11118888 Normally, you will be prompted for the distribution of the article with the default take from ddddeeeeffffaaaauuuulllltttt----ddddiiiissssttttrrrriiiibbbbuuuuttttiiiioooonnnn, but this can be changed via the ppppoooosssstttt----ddddiiiissssttttrrrriiiibbbbuuuuttttiiiioooonnnn variable. Generally, _n_n will construct a file with a suitable header, optionally include a copy of the article in the file with each non-empty line prefixed by a `>' character (except in mail mode), and invoke an editor of your choice (using the EDITOR environment variable) on this file, positioning you on the first line of the body of the article (if it knows the editor). When you have completed editing the message, it will compare it to the unedited file, and if they are identical (i.e. you did not make any changes to the file), or it is empty, the operation is cancelled. Otherwise you will be prompted for an action to take on the constructed article (enter first letter followed by rrrreeeettttuuuurrrrnnnn, or just rrrreeeettttuuuurrrrnnnn to take the default action): a)bort c)c e)dit h)old i)spell m)ail r)eedit s)end v)iew w)rite Action: (post article) You now have the opportunity to perform one of the following actions: aaaa throw the response away (will ask for confirmation), cccc mail a copy of a _f_o_l_l_o_w-_u_p to the poster of the article, eeee edit the file again, hhhh hold response for later completion, iiii run an (interactive) ssssppppeeeellllllll----cccchhhheeeecccckkkkeeeerrrr on the text, mmmm mail a (blind) copy to a specified recipient, nnnn same as aaaabort (_n_o don't post) pppp post article (same as ssssend) rrrr throw away the edited text and edit the original text, ssss send the article or letter, vvvv view the article (through the ppppaaaaggggeeeerrrr), or wwww append it to a file (before you send it). yyyy confirm _d_e_f_a_u_l_t _a_n_s_w_e_r (e.g. _y_e_s post it) To complete an unfinished response saved by the h)old command, simply enter any response action, e.g. RRRR {rrrreeeeppppllllyyyy}. This will notice the unfinished response and ask you whether you want to complete it now. Only one unfinished response can exist at a time. Notice that the $A environment variable may no longer be valid as a path to the original article when the response is completed. RRRReeeellllaaaatttteeeedddd vvvvaaaarrrriiiiaaaabbbblllleeeessss: append- signature-mail, append-signature-post, default-distribution, follow- distribution, post-distribution, edit-response-check, editor, include-art-id, include-full-header, included-mark, mail-header, mail-record, mail-script, mailer, mailer-pipe-input, news-header, news-record, news-script, orig-to-include-mask, pager, query- signature, record, response-check-pause, response-default-answer, save-counter, save-counter-offset, save-report, spell-checker. JJJJUUUUMMMMPPPPIIIINNNNGGGG TTTTOOOO OOOOTTTTHHHHEEEERRRR GGGGRRRROOOOUUUUPPPPSSSS By default _n_n will present the news groups in a predefined sequence (see the section on Presentation Sequence later on). To override this sequence and have a look at any other group the GGGG {ggggoooottttoooo----ggggrrrroooouuuupppp} command - 24 - Formatted: March 7, 1995 NNNNNNNN((((1111)))) NNNNNNNN((((1111)))) RRRReeeelllleeeeaaaasssseeee 6666....4444....11118888 available in both selection and reading mode enables you to move freely between all the newsgroups. Furthermore, the GGGG command enables you to open folders and other files, to read old articles you have read before, and to grep for a specific subject in a group. It is important to notice that normally the goto command is recursive, i.e. a new _m_e_n_u _l_e_v_e_l is created when the specified group or folder is presented, and when it has been read, _n_n will continue the activity in the group that was presented before the goto command was executed. However, if there are unread articles in the target group you can avoid entering a new menu level by using the jjjj reply described below. The current menu level (i.e. number of nested goto commands) will be shown in the prompt line as "" (in reverse video). The goto command is very powerful, but unfortunately also a little bit tricky at first sight, because the facilities it provides depend on the context in which the command is used. When executed, the goto command will prompt you for the name of the newsgroup, folder, or file to open. It will use the first letter you enter to distinguish these three possibilities: rrrreeeettttuuuurrrrnnnn An empty answer is equivalent to the current newsgroup. _l_e_t_t_e_r The answer is taken to be the name of a newsgroup. If a news group with the given name does not exist, _n_n will treat the answer as a regular expression and locate the first group in the presentation sequence (or among all groups) whose name matches the expression. + The answer is taken to be the name of a folder. If only `+' is entered, it is equivalent to the default save file for the current group. / _o_r ./ _o_r ~/ The answer is taken to be the name of a file, either relative to the current directory, relative to your home directory, or an absolute path name for the file. %%%% In reading mode, this reply corresponds to reading the current article (and splitting it as a digest). In selection mode, it will prompt for an article on the menu to read. @@@@ This choice is equivalent to the archive file for the current group. _n_n_m_a_s_t_e_r maintains archive files with all old and current articles for the groups which have the auto-archive option set in the GROUPS file (see _n_n_m_a_s_t_e_r(8)). - 25 - Formatted: March 7, 1995 NNNNNNNN((((1111)))) NNNNNNNN((((1111)))) RRRReeeelllleeeeaaaasssseeee 6666....4444....11118888 ==== and _n_u_m_b_e_r These answers are equivalent to the same answers described below applied to the current group (e.g. GGGG rrrreeeettttuuuurrrrnnnn ==== and GGGG ==== are equivalent). Specifying a folder, a file, or an article (with %%%%) will cause _n_n to treat the file like a digest and split it into separate articles (not physically!) which are then presented on a menu in the usual way, allowing you to read or save individual subarticles from the folder. When you enter a group name, _n_n will ask you how many articles in the group you want to see on the menu. You can give the following answers: _a _n_u_m_b_e_r _N In this case you will get the newest N articles in the group, or if you specified the current group (by hitting rrrreeeettttuuuurrrrnnnn to the group name prompt or entering the number directly), you will get that many _e_x_t_r_a articles included on the same menu (without creating a new menu level). jjjj This answer can only be given if there are unread articles in the group. It will instruct nn to jump directly to the specified group in the presentation sequence _w_i_t_h_o_u_t creating a new menu level. uuuu This instructs _n_n to present the _u_n_r_e_a_d articles in the group (if there are any). If you have already read the group (in the current invocation of _n_n), the uuuu answer will instruct _n_n to present the articles that were unread when you entered _n_n. aaaa This instruct _n_n to present aaaallllllll articles in the group. ssss_w_o_r_d or ====_w_o_r_d This instructs _n_n to search _a_l_l articles in the groups, but only present the articles containing the word _w_o_r_d in the subject. Notice that case is ignored when searching for the word in the subject lines. nnnn_w_o_r_d Same as the ssss form except that it searched for articles where the sender _n_a_m_e matches _w_o_r_d. eeee_w_o_r_d Same as the ssss form except that it Psearched for articles where _e_i_t_h_e_r the subject or the sender name matches _w_o_r_d. _w_o_r_d = ////_r_e_g_e_x_p When the first character of the _w_o_r_d specified with the ssss, nnnn, and eeee forms is a slash `/', the rest of the input is interpreted as a regular expression to search for. Notice that regular expression matching is case insensitive when ccccaaaasssseeee----ffffoooolllldddd----sssseeeeaaaarrrrcccchhhh is set (default). - 26 - Formatted: March 7, 1995 NNNNNNNN((((1111)))) NNNNNNNN((((1111)))) RRRReeeelllleeeeaaaasssseeee 6666....4444....11118888 rrrreeeettttuuuurrrrnnnn The meaning of an empty answer depends on the context: if there are unread articles in the specified group the unread articles will be presented, otherwise _a_l_l articles in the group will be included in the menu. If you specified the current group, and the menu already contains all the available articles, _n_n will directly prompt for a word to search for in the subject of all articles (the prompt will be an equal sign.) When the goto command creates a new menu level, _n_n will not perform auto kill or selection in the group. You can use the ++++ command in menu mode to perform the auto-selections. There are three commands in the goto family: GGGG {ggggoooottttoooo----ggggrrrroooouuuupppp} This is the general goto command described above. BBBB {bbbbaaaacccckkkk----ggggrrrroooouuuupppp} Backup one or more groups. You can hit this key one or more times to go back in the groups already presented (including those without new articles); when you have found the group you are looking for, hit ssssppppaaaacccceeee to enter it. AAAA {aaaaddddvvvvaaaannnncccceeee----ggggrrrroooouuuupppp} Advance one or more groups. This command is similar to the BBBB command, but operates in the opposite direction. NNNN {nnnneeeexxxxtttt----ggggrrrroooouuuupppp} When used within an AAAA or BBBB command, it skips forward to the next group in the sequence with unread articles or which has previously been visited. PPPP {pppprrrreeeevvvviiiioooouuuussss} When used within an AAAA or BBBB command, it skips backwards to the preceding group in the sequence with unread articles or which has previously been visited. Once you have entered an AAAA or BBBBcommand, you can freely mix the AAAA, BBBB, PPPP, and NNNN commands to find the group you want, and you can also use the GGGG command to be prompted for a group name. To show the use of the goto command some typical examples on its use are given below: _P_r_e_s_e_n_t _t_h_e _u_n_r_e_a_d _a_r_t_i_c_l_e_s _i_n _t_h_e _d_k._g_e_n_e_r_a_l _g_r_o_u_p GGGG dk.general rrrreeeettttuuuurrrrnnnn uuuu _J_u_m_p _d_i_r_e_c_t_l_y _t_o _t_h_e _g_n_u._e_m_a_c_s _g_r_o_u_p _a_n_d _c_o_n_t_i_n_u_e _f_r_o_m _t_h_e_r_e GGGG gnu.emacs rrrreeeettttuuuurrrrnnnn jjjj _I_n_c_l_u_d_e _t_h_e _l_a_s_t _1_0 _R_E_A_D _a_r_t_i_c_l_e_s _i_n _t_h_e _c_u_r_r_e_n_t _g_r_o_u_p _m_e_n_u GGGG 10 rrrreeeettttuuuurrrrnnnn - 27 - Formatted: March 7, 1995 NNNNNNNN((((1111)))) NNNNNNNN((((1111)))) RRRReeeelllleeeeaaaasssseeee 6666....4444....11118888 _F_i_n_d _a_l_l _a_r_t_i_c_l_e_s _i_n _r_e_c._m_u_s_i_c._m_i_s_c _o_n _t_h_e _s_u_b_j_e_c_t _F_l_o_y_d GGGG rec.music.misc rrrreeeettttuuuurrrrnnnn ==== floyd rrrreeeettttuuuurrrrnnnn _O_p_e_n _t_h_e _f_o_l_d_e_r +_n_n GGGG +nn rrrreeeettttuuuurrrrnnnn _S_p_l_i_t _c_u_r_r_e_n_t _a_r_t_i_c_l_e _a_s _a _d_i_g_e_s_t (_i_n _r_e_a_d_i_n_g _m_o_d_e) GGGG %%%% RRRReeeellllaaaatttteeeedddd vvvvaaaarrrriiiiaaaabbbblllleeeessss: case-fold-search, default-save-file, folder- save-file AAAAUUUUTTTTOOOOMMMMAAAATTTTIIIICCCC KKKKIIIILLLLLLLL AAAANNNNDDDD SSSSEEEELLLLEEEECCCCTTTTIIIIOOOONNNN When there is a subject or an author which you are either very interested in, or find completely uninteresting, you can easily instruct _n_n to _a_u_t_o-_s_e_l_e_c_t or _a_u_t_o-_k_i_l_l articles with specific subjects or from specific authors. These instructions are stored in a _k_i_l_l _f_i_l_e, and the most common types of entries can be created using the following command: KKKK {kkkkiiiillllllll----sssseeeelllleeeecccctttt} Create an entry in your personal kill file. The contents of the entry is specified during a short dialog that is described in details below. This command is available in both selection and reading mode. Entries in the kill file may apply to a single newsgroup or to all newsgroups. Furthermore, entries may be permanent or they may be expired a given number of days after their entry. To increase performance, _n_n uses a compiled version of the kill file which is read in when _n_n is invoked. The compiled kill file will automatically be updated if the normal kill file has been modified. The following dialog is used to build the kill file entry: _A_U_T_O (_k)_i_l_l _o_r (_s)_e_l_e_c_t (_C_R => _K_i_l_l _s_u_b_j_e_c_t _3_0 _d_a_y_s) If you simply want _n_n to kill all articles with the subject of the current article (in reading mode) or a specific article (which _n_n will prompt for in selection mode), just hit rrrreeeettttuuuurrrrnnnn. This will cause _n_n to create an entry in the kill file to kill the current (or specified) subject in the current group for a period of 30 days (which should be enough for the discussion to die out). You can control the default kill period, or change it into a "select" period via the ddddeeeeffffaaaauuuulllltttt----kkkkiiiillllllll----sssseeeelllleeeecccctttt variable. If this "default behaviour" is not what you want, just answer either _k or _s to kill or select articles, respectively, which will bring you on to the rest of the questions. - 28 - Formatted: March 7, 1995 NNNNNNNN((((1111)))) NNNNNNNN((((1111)))) RRRReeeelllleeeeaaaasssseeee 6666....4444....11118888 _A_U_T_O _S_E_L_E_C_T _o_n (_s)_u_b_j_e_c_t _o_r (_n)_a_m_e (_s) (The _S_E_L_E_C_T will be substituted with _K_I_L_L depending on the previous answer). Here you specify whether you want the kill or select to depend on the subject of the article (ssss or ssssppppaaaacccceeee), or on the name of the author (nnnn). _S_E_L_E_C_T _N_A_M_E: (Again _S_E_L_E_C_T may be substituted with _K_I_L_L and _S_U_B_J_E_C_T may replace _N_A_M_E). You must now enter a name (or subject) to select (or kill). In reading mode, you may just hit rrrreeeettttuuuurrrrnnnn (or %%%%) to use the name (or subject) of the current article. In selection mode, you can use the name (or subject) from an article on the menu by answering with %%%% followed by the corresponding article identifier. When the name or subject is taken from an article (the current or one from the menu), _n_n will only select or kill articles where the name or subject matches the original name or subject exactly including case. If the first character typed at the prompt is a slash `/', the rest of the line is used as a _r_e_g_u_l_a_r _e_x_p_r_e_s_s_i_o_n which is used to match the name or subject (case _i_nsensitive). Otherwise, _n_n will select or kill articles which _c_o_n_t_a_i_n the specified string anywhere in the name or subject (ignoring case). _S_E_L_E_C_T _i_n (_g)_r_o_u_p `_d_k._g_e_n_e_r_a_l' _o_r _i_n (_a)_l_l _g_r_o_u_p_s (_g) You must now specify whether the selection or kill should apply to the current group only (gggg or ssssppppaaaacccceeee) or to all groups (aaaa). _L_i_f_e_t_i_m_e _o_f _e_n_t_r_y _i_n _d_a_y_s (_p)_e_r_m_a_n_e_n_t (_3_0) You can now specify the lifetime of the entry, either by entering a number specifying the number of days the entry should be active, or pppp to specify the entry as a permanent entry. An empty reply is equivalent to 30 days. _C_O_N_F_I_R_M _S_E_L_E_C_T .... Finally, you will be asked to confirm the entry, and you should especially note the presence or absence of the word eeeexxxxaaaacccctttt which specify whether an exact match applies for the entry. RRRReeeellllaaaatttteeeedddd vvvvaaaarrrriiiiaaaabbbblllleeeessss: default-kill-select, kill. TTTTHHHHEEEE FFFFOOOORRRRMMMMAAAATTTT OOOOFFFF TTTTHHHHEEEE KKKKIIIILLLLLLLL FFFFIIIILLLLEEEE The kill file consists of one line for each entry. Empty lines and lines starting with a # character are ignored. _n_n automatically places a # character in the first position of expired entries when it compiles the kill file. You can then edit the kill file manually from time to time to clean out these entries. Each line has the following format [_e_x_p_i_r_e _t_i_m_e :] [_g_r_o_u_p _n_a_m_e] : _f_l_a_g_s : _s_t_r_i_n_g [: _s_t_r_i_n_g]... Permanent entries have no _e_x_p_i_r_e _t_i_m_e (in which case the colon is - 29 - Formatted: March 7, 1995 NNNNNNNN((((1111)))) NNNNNNNN((((1111)))) RRRReeeelllleeeeaaaasssseeee 6666....4444....11118888 omitted as well!). Otherwise, the _e_x_p_i_r_e _t_i_m_e defines the time (as a time_t value) when the entry should be expired. The _g_r_o_u_p _n_a_m_e field can have three forms: _n_e_w_s._g_r_o_u_p._n_a_m_e If it is the name of a single news group (e.g. comp.unix), the entry applies to that group only. ////_r_e_g_u_l_a_r _e_x_p_r_e_s_s_i_o_n If it starts with a slash `/' followed by a _r_e_g_u_l_a_r _e_x_p_r_e_s_s_i_o_n (e.g. /^news\..*), the entry applies to all groups whose name are matched by the regular expression. _e_m_p_t_y An empty group field will apply the entry to _a_l_l groups. The _f_l_a_g_s field consists of a list of characters which identifies the type of entry, and the interpretation of each _s_t_r_i_n_g field. When used, the flag characters must be used in the order in which they are described below: ~~~~ (optional) When this flag is present on any of the entries for a specific group, it causes all entires which _a_r_e _n_o_t _a_u_t_o-_s_e_l_e_c_t_e_d to be killed. This is a simple way to say: I'm interested in this and that, but nothing else. ++++ or !!!! (optional) Specify an auto-select ++++ or an auto-kill !!!! entry, respectively. If neither are used, the article is neither selected nor killed which is useful in combination with the `~~~~' flag. >>>> (optional) When used with a subject (flag ssss), the kill entry only matches follow-ups to that subject (i.e. where the Subject: line starts with Re:). For example, to kill all "Re:"'s in rec.humor use the following kill entry: rec.humor:!>s/:. <<<< (optional) When used with a subject (flag ssss), the kill entry only matches base articles with that subject (i.e. where the Subject: line does not start with Re:). For example, to kill all articles asking for help (but not follow-ups) in the tex group, add this to your kill file: comp.text.tex:!s", the following commands can be placed in the setup file: sssseeeetttt included-mark > lllloooocccckkkk included-mark The current variable settings can be shown with the ::::sssseeeetttt command: ::::sssseeeetttt (without arguments) This will give a listing of the variables which have been set in either the init file or interactively. ::::sssseeeetttt aaaallllllll This will give a listing of all variables. Modified variables will be marked with a `*' and _l_o_c_a_l variables will be marked with a `>'. A locked variable is marked with a `!'. ::::sssseeeetttt ////_r_e_g_e_x_p This will give a listing of all variables whose name matches the given regular expression. ::::sssseeeetttt _p_a_r_t_i_a_l-_n_a_m_e ssssppppaaaacccceeee The ssssppppaaaacccceeee (ccccoooommmmpppp1111----kkkkeeeeyyyy) key will complete the variable name as usual, but as a side effect it will display the variable's current value in the message line. Variables are global by default, but a local instantiation of the variable can be created using the ::::llllooooccccaaaallll command. The local variable will overlay the global variable as long as the current group is active, i.e. the global variable will be used again when you exit the current group. The initial value of the local variable will be the same as the global variable, unless a new value is specified in the ::::llllooooccccaaaallll command: ::::llllooooccccaaaallll _v_a_r_i_a_b_l_e [ _v_a_l_u_e ] The following variables are available: aaaallllssssoooo----ffffuuuullllllll----ddddiiiiggggeeeesssstttt (boolean, default false) When a digest is split, the digest itself is not normally included on the menu, and as such the initial adminstrative information is not available. Setting aaaallllssssoooo----ffffuuuullllllll----ddddiiiiggggeeeesssstttt will cause the (unsplit) digest to be included on the menu. These articles are marked with a @ at the beginning of the subject. - 38 - Formatted: March 7, 1995 NNNNNNNN((((1111)))) NNNNNNNN((((1111)))) RRRReeeelllleeeeaaaasssseeee 6666....4444....11118888 aaaallllssssoooo----ssssuuuubbbbggggrrrroooouuuuppppssss (boolean, default true) When set, a group name in the presentation sequence will also cause all the subgroups of the group to be included, for example, comp.unix will also include comp.unix.questions, etc. When aaaallllssssoooo----ssssuuuubbbbggggrrrroooouuuuppppssss is not set, subgroups are only included if the group name is followed by a `.' in which case the main group is _n_o_t included, i.e. `comp.unix' is not included when `comp.unix.' is specified in the presentation sequence, and vice-versa. Following a group name by an asterisk `*', e.g. comp.unix*, will include the group as well as all subgroups independently of the setting of aaaallllssssoooo----ssssuuuubbbbggggrrrroooouuuuppppssss. aaaappppppppeeeennnndddd----ssssiiiiggggnnnnaaaattttuuuurrrreeee----mmmmaaaaiiiillll (boolean, default false) When false, it is assumed that the .signature file is automatically appended to responses sent via E-mail. If true, .signature will be appended to the letter (see query-signature). aaaappppppppeeeennnndddd----ssssiiiiggggnnnnaaaattttuuuurrrreeee----ppppoooosssstttt (boolean, default false) When false, it is assumed that the .signature file is automatically appended to posted articles. If true, .signature will explicitly be appended to posted articles (see query- signature). aaaattttttttrrrriiiibbbbuuuutttteeeessss _s_y_m_b_o_l_s (string, default ....) Each element in this string represents a symbol used to represent an article attribute when displayed on the screen. See the section on Marking Articles and Attributes. aaaauuuuttttoooo----jjjjuuuunnnnkkkk----sssseeeeeeeennnn (_b_o_o_l_e_a_n, _d_e_f_a_u_l_t _t_r_u_e) When set, articles which have the _s_e_e_n _a_t_t_r_i_b_u_t_e (,) will be marked read when the current group is left. If not set, these articles will still be either unread or marked seen the next time the group is entered (see also ccccoooonnnnffffiiiirrrrmmmm----jjjjuuuunnnnkkkk----sssseeeeeeeennnn and rrrreeeettttaaaaiiiinnnn---- sssseeeeeeeennnn----ssssttttaaaattttuuuussss). aaaauuuuttttoooo----pppprrrreeeevvvviiiieeeewwww----mmmmooooddddeeee (_b_o_o_l_e_a_n, _d_e_f_a_u_l_t _f_a_l_s_e) Enables _A_u_t_o _P_r_e_v_i_e_w _M_o_d_e. In this mode, selecting an article on the menu using its article id (letter a-z) will enter preview mode on that article immediately. Furthermore, the `n' {nnnneeeexxxxtttt---- aaaarrrrttttiiiicccclllleeee} command will preview the next article on the menu only if it has the same subject as the current article; otherwise, it will return to the menu with the cursor placed on the next article. The ccccoooonnnnttttiiiinnnnuuuueeee command at the end of the article and the `=' {ggggoooottttoooo----mmmmeeeennnnuuuu} returns to the menu immediately as usual. aaaauuuuttttoooo----rrrreeeeaaaadddd----mmmmooooddddeeee----lllliiiimmmmiiiitttt _N (integer, default 0) When operating in _a_u_t_o _r_e_a_d_i_n_g _m_o_d_e, _n_n will _a_u_t_o-_s_e_l_e_c_t all unread articles in the group, skip the article selection phase, and enter reading mode directly after entry to the group. Auto reading mode is disabled when aaaauuuuttttoooo----rrrreeeeaaaadddd----mmmmooooddddeeee----lllliiiimmmmiiiitttt is zero; it is activated unconditionally if the value is negative, - 39 - Formatted: March 7, 1995 NNNNNNNN((((1111)))) NNNNNNNN((((1111)))) RRRReeeelllleeeeaaaasssseeee 6666....4444....11118888 and conditionally if the value is greater than zero and the number of unread articles in the current group does not exceed the given value. aaaauuuuttttoooo----sssseeeelllleeeecccctttt----cccclllloooosssseeeedddd _m_o_d_e (integer, default 1) Normally, selecting a _c_l_o_s_e_d _s_u_b_j_e_c_t (usually in consolidated menu mode) will select (or deselect) all _u_n_r_e_a_d articles with the given subject (or all articles if they are all read). This behaviour can be changed via the value of this variable as follows: 0: select only the first article with the subject (shown on menu). 1: select only the unread articles with the subject. 2: select all available articles with the subject. aaaauuuuttttoooo----sssseeeelllleeeecccctttt----ssssuuuubbbbjjjjeeeecccctttt (boolean, default false) When set, selecting an article from the menu using the article id (a-z), all articles on the menu with the same subject will automatically be selected as well. bbbbaaaacccckkkkuuuupppp (boolean, default true) When set, a copy of the initial .newsrc and select files will save be the first time they are changed. _n_n remembers the initial contents of these files internally, so the backup variable can be set any time if not set on start-up. bbbbaaaacccckkkkuuuupppp----ffffoooollllddddeeeerrrr----ppppaaaatttthhhh _f_i_l_e (string, default "BackupFolder~") When removing deleted articles from a folder, this variable defines the name of the file where a (temporary) copy of the original folder is saved. If the _f_i_l_e name doesn't contain a `/', the file will be located in the .nn directory. Otherwise the file name is used directly as the relative or full path name of the backup file. If possible, the old folder will be renamed to the backup folder name; otherwise the old folder is copied to the backup folder. bbbbaaaacccckkkkuuuupppp----ssssuuuuffffffffiiiixxxx _s_u_f_f_i_x (string, default ".bak") The suffix appended to file names to make the corresponding backup file name (see bbbbaaaacccckkkkuuuupppp). bbbbuuuugggg----rrrreeeeppppoooorrrrtttt----aaaaddddddddrrrreeeessssssss _a_d_d_r_e_s_s (string, default nn-bugs@dkuug.dk) The mail address to which bug reports created with the ::::bbbbuuuugggg command are sent. ccccaaaasssseeee----ffffoooolllldddd----sssseeeeaaaarrrrcccchhhh (boolean, default true) When set, string and regular expression matching will be case independent. This is related to all commands matching on names or subjects, except in connection with auto-kill and auto-select where the individual kill file entries specifies this property. cccchhhheeeecccckkkk----ddddbbbb----uuuuppppddddaaaatttteeee----ttttiiiimmmmeeee _H (integer, default 12) When non-zero, _n_n will issue a warning if the database has not - 40 - Formatted: March 7, 1995 NNNNNNNN((((1111)))) NNNNNNNN((((1111)))) RRRReeeelllleeeeaaaasssseeee 6666....4444....11118888 been updated in the last _H hours. The warning will tell you whether no news has arrived (feed broken?), or whether it is just _n_n_m_a_s_t_e_r which has not updated the database (dead?). cccchhhheeeecccckkkk----ggggrrrroooouuuupppp----aaaacccccccceeeessssssss (boolean, default false) When set, _n_n will perform a check on the readability of a group's readability before showing the menu for that group. Normally, this is not necessary since all users traditionally have access to all news groups. Setting (and locking) this variable may be used to limit access to a news group via the permissions and ownership of the group's spool directory (this will only work for non-NNTP sites). ccccoooollllllllaaaappppsssseeee----ssssuuuubbbbjjjjeeeecccctttt _o_f_f_s_e_t (integer, default 25) When set (non-negative), subject lines which are too long to be presented in full on the menus will be "collapsed" by removing a sufficient number of characters from the subject starting at the given _o_f_f_s_e_t in the subject. This is useful in source groups where the "Part (01/10)" string sometimes disappears from the menu. When not set (or negative), the subjects are truncated. ccccoooolllluuuummmmnnnnssss _c_o_l (integer, default screen width) This variable contains the screen width i.e. character positions per line. ccccoooommmmpppp1111----kkkkeeeeyyyy _k_e_y (key, default ssssppppaaaacccceeee) The key which gives the first/next completion, and the default value when _n_n is prompting for a string, e.g. a file name. ccccoooommmmpppp2222----kkkkeeeeyyyy _k_e_y (key, default ttttaaaabbbb) The key which ends the current completion and gives the first completion for the next component when _n_n is prompting for a string, e.g. a file name. ccccoooommmmpppprrrreeeessssssss (boolean, default false) This variable controls whether text compression (see the ccccoooommmmpppprrrreeeessssssss command) is turned on or off when an article is shown. The compression is still toggled for the current article with the ccccoooommmmpppprrrreeeessssssss command key. ccccoooonnnnffffiiiirrrrmmmm----aaaappppppppeeeennnndddd (boolean, default false) When set, _n_n will ask for confirmation before appending an article to an existing file (see also ccccoooonnnnffffiiiirrrrmmmm----ccccrrrreeeeaaaatttteeee). ccccoooonnnnffffiiiirrrrmmmm----aaaauuuuttttoooo----qqqquuuuiiiitttt (boolean, default false) When set, _n_n will ask for confirmation before quitting after having read the last group. If not confirmed, _n_n will recycle the presentation sequence looking for groups that were skipped with the `N' {nnnneeeexxxxtttt----ggggrrrroooouuuupppp} command. But it will not look for new articles arrived since the invocation of _n_n. - 41 - Formatted: March 7, 1995 NNNNNNNN((((1111)))) NNNNNNNN((((1111)))) RRRReeeelllleeeeaaaasssseeee 6666....4444....11118888 ccccoooonnnnffffiiiirrrrmmmm----ccccrrrreeeeaaaatttteeee (boolean, default true) When set, _n_n will ask for confirmation before creating a new file or directory when saving or unpacking an article (see also ccccoooonnnnffffiiiirrrrmmmm----aaaappppppppeeeennnndddd). ccccoooonnnnffffiiiirrrrmmmm----eeeennnnttttrrrryyyy (boolean, default false) When set, _n_n will ask for confirmation before entering a group with more than ccccoooonnnnffffiiiirrrrmmmm----eeeennnnttttrrrryyyy----lllliiiimmmmiiiitttt unread articles (on the first menu level). It is useful on slow terminals if you don't want to wait until _n_n has drawn the first menu to be able to skip the group. Answering no to the "Enter?" prompt will cause _n_n to skip to the next group without marking the current group as read. If you answer by hitting iiiinnnntttteeeerrrrrrrruuuupppptttt, _n_n will ask the question "Mark as read?" which allows you to mark the current group as read before going to the next group. If this second question is also answered by hitting iiiinnnntttteeeerrrrrrrruuuupppptttt, _n_n will quit immediately. ccccoooonnnnffffiiiirrrrmmmm----eeeennnnttttrrrryyyy----lllliiiimmmmiiiitttt _a_r_t_i_c_l_e_s (integer, default 0) Specifies the minimum number of unread articles in a group for which the ccccoooonnnnffffiiiirrrrmmmm----eeeennnnttttrrrryyyy functionality is activated. ccccoooonnnnffffiiiirrrrmmmm----jjjjuuuunnnnkkkk----sssseeeeeeeennnn (boolean, default false) When set, _n_n will require confirmation before marking seen articles as read when aaaauuuuttttoooo----jjjjuuuunnnnkkkk----sssseeeeeeeennnn is set. ccccoooonnnnffffiiiirrrrmmmm----mmmmeeeessssssssaaaaggggeeeessss (boolean, default false) In some cases, _n_n will sleep one second (or more) when it has shown a message to the user, e.g. in connection with macro debugging. Setting ccccoooonnnnffffiiiirrrrmmmm----mmmmeeeessssssssaaaaggggeeeessss will cause _n_n to _w_a_i_t for you to confirm all messages by hitting any key. (It will show the symbol <> to indicate that it is awaiting confirmation.) ccccoooonnnnssssoooolllliiiiddddaaaatttteeeedddd----mmmmaaaannnnuuuuaaaallll (boolean, default false) When set, the _o_n_l_i_n_e _m_a_n_u_a_l will be presented with one menu line for each _p_r_o_g_r_a_m in the _n_n package. ccccoooonnnnssssoooolllliiiiddddaaaatttteeeedddd----mmmmeeeennnnuuuu (boolean, default false) When set, _n_n will automatically _c_l_o_s_e all multi-article subjects on entry to a group, so that each subject only occur once on the menu page. ccccoooouuuunnnntttteeeerrrr----ddddeeeelllliiiimmmm----lllleeeefffftttt (string, default "[") The delimiter string output to the left of the article counter in a closed subject's menu line. ccccoooouuuunnnntttteeeerrrr----ddddeeeelllliiiimmmm----rrrriiiigggghhhhtttt (string, default "] ") The delimiter string output to the right of the article counter in a closed subject's menu line. - 42 - Formatted: March 7, 1995 NNNNNNNN((((1111)))) NNNNNNNN((((1111)))) RRRReeeelllleeeeaaaasssseeee 6666....4444....11118888 ccccoooouuuunnnntttteeeerrrr----ppppaaaaddddddddiiiinnnngggg _p_a_d (integer, default 5) On a consolidated menu, the subjects may not be very well aligned because the added [...] counters have varying length. To (partially) remedy this, all counters (and subjects without counters) are prefixed by up to _p_a_d spaces to get better alignment. Increasing it further may yield practially perfect alignment at the cost of less space for the subject itself. ccccrrrroooossssssss----ffffiiiilllltttteeeerrrr----sssseeeeqqqq (boolean, default true) When set, cross posted articles will be presented in the first possible group, i.e. according to the current presentation sequence (_c_r_o_s_s-post _f_i_l_t_e_ring on _s_e_quence). The article is automatically marked read in the other cross posted groups unless you unsubscribe to the first group in which it was shown before reading the other groups. Likewise, it is sufficient to leave the article unread in the first group to keep it for later handling. If not set, cross-postings are shown in the first group occurring on the Newsgroups: line which the user subscribes to (i.e. you let the poster decide which group is most appropriate to read his posting). ccccrrrroooossssssss----ppppoooosssstttt (boolean, default false) Normally, _n_n will only show cross-posted articles in the first subscribed group on the Newsgroups: line. When ccccrrrroooossssssss----ppppoooosssstttt is set, _n_n will show cross-posted articles in all subscribed groups to which they are posted. ddddaaaattttaaaa----bbbbiiiittttssss _b_i_t_s (integer, default 7) When set to 7, _n_n will display characters with the 8th bit set using a meta-notation MMMM----_7_b_i_t-_c_h_a_r. If set to 8, these characters are sent directly to the screen (unless mmmmoooonnnniiiittttoooorrrr is set). It also controls whether keyboard input is 7 or 8 bits, and thus whether key maps contain 127 or 255 entries. See the key mapping section for more details. ddddaaaatttteeee (boolean, default true) If set _n_n will show the article posting date when articles are read. ddddeeeebbbbuuuugggg _m_a_s_k (integer, default 0) Look in the source if you are going to use this. ddddeeeeccccooooddddeeee----hhhheeeeaaaaddddeeeerrrr----ffffiiiilllleeee _f_i_l_e (string, default "Decode.Headers") The name of the file in which the header and initial text of articles decoded with the ::::ddddeeeeccccooooddddeeee command is saved. Unless the file name starts with a `/', the file will be created in the same directory as the decoded files. The information is not saved if this variable is not set. - 43 - Formatted: March 7, 1995 NNNNNNNN((((1111)))) NNNNNNNN((((1111)))) RRRReeeelllleeeeaaaasssseeee 6666....4444....11118888 ddddeeeeccccooooddddeeee----sssskkkkiiiipppp----pppprrrreeeeffffiiiixxxx _N (integer, default 2) When non-null, the ::::ddddeeeeccccooooddddeeee command will automatically skip _u_p_t_o _N characters at the beginning of each line to find valid uuencoded data. This allows _n_n to automatically decode (multi-part) postings which are both uuencoded and packed with shar. ddddeeeeffffaaaauuuulllltttt----ddddiiiissssttttrrrriiiibbbbuuuuttttiiiioooonnnn _d_i_s_t_r (string, default "world") The distribution to use as the default suggestion when posting articles using the ffffoooolllllllloooowwww and ppppoooosssstttt commands if the corresponding ffffoooolllllllloooowwww----ddddiiiissssttttrrrriiiibbbbuuuuttttiiiioooonnnn or ppppoooosssstttt----ddddiiiissssttttrrrriiiibbbbuuuuttttiiiioooonnnn variable contains the ddddeeeeffffaaaauuuulllltttt option. ddddeeeeffffaaaauuuulllltttt----kkkkiiiillllllll----sssseeeelllleeeecccctttt [_1]_d_a_y_s (number, default 30) Specifies the default action for the KKKK {kkkkiiiillllllll----sssseeeelllleeeecccctttt} command if the first prompt is answered by rrrreeeettttuuuurrrrnnnn. It contains the number of days to keep the kill or select entry in the kill file (1-99 days). If it has the value _d_a_y_s+100 (e.g. 130), it denotes that the default action is to _s_e_l_e_c_t rather than kill on the subject for the specified period. ddddeeeeffffaaaauuuulllltttt----ssssaaaavvvveeee----ffffiiiilllleeee _f_i_l_e (string, default +$F) The default save file used when saving articles in news groups where no save file has been specified in the init file (either in a ssssaaaavvvveeee----ffffiiiilllleeeessss section or in the presentation sequence). It can also be specified using the abbreviation "+" as the file name when prompted for a file name even in groups with their own save file. ddddeeeellllaaaayyyy----rrrreeeeddddrrrraaaawwww (boolean, default false) Normally, _n_n will redraw the screen after extended commands (:cmd) that clear the screen. When ddddeeeellllaaaayyyy----rrrreeeeddddrrrraaaawwww is set _n_n will prompt for another extended command instead of redrawing the screen (hit rrrreeeettttuuuurrrrnnnn to redraw). eeeecccchhhhoooo----pppprrrreeeeffffiiiixxxx----kkkkeeeeyyyy (boolean, default true) When true, hitting a prefix key (see the section on key mapping below) will cause the prefix key to be echoed in the message line to indicate that another key is expected. eeeeddddiiiitttt----ppppaaaattttcccchhhh----ccccoooommmmmmmmaaaannnndddd (boolean, default true) When true, the ::::ppppaaaattttcccchhhh command will show the current ppppaaaattttcccchhhh----ccccoooommmmmmmmaaaannnndddd and give you a chance to edit it before applying it to the articles. eeeeddddiiiitttt----pppprrrriiiinnnntttt----ccccoooommmmmmmmaaaannnndddd (boolean, default true) When true, the pppprrrriiiinnnntttt command will show the current pppprrrriiiinnnntttteeeerrrr command and give you a chance to edit it before printing the articles. Otherwise the articles are just printed using the current pppprrrriiiinnnntttteeeerrrr command. - 44 - Formatted: March 7, 1995 NNNNNNNN((((1111)))) NNNNNNNN((((1111)))) RRRReeeelllleeeeaaaasssseeee 6666....4444....11118888 eeeeddddiiiitttt----rrrreeeessssppppoooonnnnsssseeee----cccchhhheeeecccckkkk (boolean, default true) When editing a response to an article, it normally does not have any meaning to send the initial file prepared by _n_n unaltered, since it is either empty or only contains included material. When this variable is set, exiting the editor without having changed the file will automatically abort the response action without confirmation. eeeeddddiiiitttt----uuuunnnnsssshhhhaaaarrrr----ccccoooommmmmmmmaaaannnndddd (boolean, default false) When true, the ::::uuuunnnnsssshhhhaaaarrrr command will show the current uuuunnnnsssshhhhaaaarrrr---- ccccoooommmmmmmmaaaannnndddd and give you a chance to edit it before applying it to the articles. eeeeddddiiiittttoooorrrr _c_o_m_m_a_n_d (string, default not set) When set, it will override the current EDITOR environment variable when editing responses and new articles. eeeemmmmbbbbeeeeddddddddeeeedddd----hhhheeeeaaaaddddeeeerrrr----eeeessssccccaaaappppeeee _s_t_r_i_n_g (string, default '~') When saving an article to a file, header lines embedded in the body of the article are escaped using this string to make it possible for _n_n to split the folder correctly afterwards. Header lines are not escaped if this variable is not set. eeeennnntttteeeerrrr----llllaaaasssstttt----rrrreeeeaaaadddd----mmmmooooddddeeee _m_o_d_e (integer, default 1) Normally, _n_n will remember which group is active when you quit, and offer to jump directly to this group when you start _n_n the next time. This variable is used to control this behaviour. The following _m_o_d_e values are recognized: 0: Ignore the remembered group (r.g.). 1: Enter r.g. if the group is unread (with user confirmation) 2: Enter r.g. or first unread group after it in the sequence (w/conf). 3: Enter r.g. if the group is unread (no confirmation) 4: Enter r.g. or first unread group after it in the sequence (no conf). eeeennnnttttrrrryyyy----rrrreeeeppppoooorrrrtttt----lllliiiimmmmiiiitttt _a_r_t_i_c_l_e_s (integer, default 300) Normally, _n_n will just move the cursor to the upper left corner of the screen while it is reading articles from the database on entry to a group. For large groups this may take more than a fraction of a second, and _n_n can then report what it is doing. If it must read more articles than the number specified by this variable, _n_n will report which group and how many articles it is reading. eeeerrrraaaasssseeee----kkkkeeeeyyyy _k_e_y (key, default tty erase key) The key which erases the last input character when _n_n is prompting for a string, e.g. a file name. eeeexxxxppppeeeerrrrtttt (boolean, default false) If set _n_n will use slightly shorter prompts (e.g. not tell you that ? will give you help), and be a bit less verbose in a few other cases (e.g. not remind you that posted articles are not - 45 - Formatted: March 7, 1995 NNNNNNNN((((1111)))) NNNNNNNN((((1111)))) RRRReeeelllleeeeaaaasssseeee 6666....4444....11118888 available instantly). eeeexxxxppppiiiirrrreeeedddd----mmmmeeeessssssssaaaaggggeeee----ddddeeeellllaaaayyyy _p_a_u_s_e (integer, default 1) If a selected article is found to have been expired, _n_n will normally give a message about this and sleep for a number of seconds specified by this variable. Setting this variable to zero will still make _n_n give the message without sleeping afterwards. Setting it to -1 will cause the message not to be shown at all. fffflllloooowwww----ccccoooonnnnttttrrrroooollll (boolean, default true) When set, _n_n will turn on xon/xoff flow-control before writing large amounts of text to the screen. This should guard against lossage of output, but in some network configurations it has had the opposite effect, losing several lines of the output. This variable is always true on systems with CBREAK capabilities which can do single character reads without disabling flow control. fffflllluuuusssshhhh----ttttyyyyppppeeeeaaaahhhheeeeaaaadddd (boolean, default false) When true, _n_n will flush typeahead prior to reading commands from the keyboard. It will not flush typeahead while reading parameters for a command, e.g. file names etc. ffffoooollllddddeeeerrrr _d_i_r_e_c_t_o_r_y (string, default ~/News) The full pathname of the _f_o_l_d_e_r _d_i_r_e_c_t_o_r_y which will replace the + in folder names. It will be initialized from the FOLDER environment variable if it is not set in the _i_n_i_t file. ffffoooollllddddeeeerrrr----ffffoooorrrrmmmmaaaatttt----cccchhhheeeecccckkkk (boolean, default true) When saving an article with a full or partial header in an existing folder, _n_n will check the format of the folder to be able to append the article in the proper format. If this variable is not set, folders are assumed to be in the format specified via the mmmmmmmmddddffff----ffffoooorrrrmmmmaaaatttt and mmmmaaaaiiiillll----ffffoooorrrrmmmmaaaatttt variables, and articles are saved in that format without checking. Otherwise, the ****----ffffoooorrrrmmmmaaaatttt variables are only used to determine the format for _n_e_w folders. ffffoooollllddddeeeerrrr----ssssaaaavvvveeee----ffffiiiilllleeee _f_i_l_e (string, default not set) The default save file used when saving articles _f_r_o_m a folder. ffffoooolllllllloooowwww----ddddiiiissssttttrrrriiiibbbbuuuuttttiiiioooonnnn _w_o_r_d_s (string, default see below) This variable controls how the Distribution: header is constructed for a follow-up to an original article. Its value is a list of _w_o_r_d_s selected from the following list: [ [ aaaallllwwwwaaaayyyyssss ] ssssaaaammmmeeee ] [ aaaasssskkkk ] [ ddddeeeeffffaaaauuuulllltttt | _d_i_s_t_r_i_b_u_t_i_o_n ] This is interpreted in two steps: - First the default distribution is determined. If ssssaaaammmmeeee is specified and the original article has a Distribution: header, that header is used. Else if ddddeeeeffffaaaauuuulllltttt is specified (or - 46 - Formatted: March 7, 1995 NNNNNNNN((((1111)))) NNNNNNNN((((1111)))) RRRReeeelllleeeeaaaasssseeee 6666....4444....11118888 _d_i_s_t_r_i_b_u_t_i_o_n is omitted), the value of ddddeeeeffffaaaauuuulllltttt----ddddiiiissssttttrrrriiiibbbbuuuuttttiiiioooonnnn is used. And finally, if only a _d_i_s_t_r_i_b_u_t_i_o_n (any word) is specified that is used as the default. - Then if aaaasssskkkk is specified, the user will be asked to confirm the default distribution or provide another distribution. However, if aaaallllwwwwaaaayyyyssss (and ssssaaaammmmeeee) is specified, and the default was taken from the original article's distribution, the original distribution is used _w_i_t_h_o_u_t confirmation. The default value of ffffoooolllllllloooowwww----ddddiiiissssttttrrrriiiibbbbuuuuttttiiiioooonnnn is aaaallllwwwwaaaayyyyssss ssssaaaammmmeeee ddddeeeeffffaaaauuuulllltttt, i.e. use either the original distribution or the ddddeeeeffffaaaauuuulllltttt---- ddddiiiissssttttrrrriiiibbbbuuuuttttiiiioooonnnn without confirmation in either case. ffffrrrroooommmm----lllliiiinnnneeee----ppppaaaarrrrssssiiiinnnngggg _s_t_r_i_c_t_n_e_s_s (integer, default 2) Specifies how strict _n_n must parse a "From " line in a folder to recognize it as a mail format message separator line. The following strictness values determine whether a line starting with "From " will be recognized as a separator line: 0: Always. 1: Line must have at least 8 fields. 2: Line must contain a valid date and time (ctime style). ffffssssoooorrrrtttt (boolean, default true) When set, folders are sorted alphabetically according to the subject (and age). Otherwise, the articles in a folder will be presented in the sequence in which they were saved. gggguuuuaaaarrrrdddd----ddddoooouuuubbbblllleeee----ssssllllaaaasssshhhh (boolean, default false) Normally, when entering a file name, entering two slashes `//' in a row (or following a slash by a plus `/+') will cause _n_n to erase the entire line and replace it with the `/' (or `+'). On some systems, two slashes are used in network file names, and on those systems gggguuuuaaaarrrrdddd----ddddoooouuuubbbblllleeee----ssssllllaaaasssshhhh can be set; that will cause _n_n to require _t_h_r_e_e slashes in a row to clear the input. hhhheeeeaaaaddddeeeerrrr----lllliiiinnnneeeessss _l_i_s_t (string, no default) When set, it determines the list of header fields that are shown when an article is read instead of the normal one line header showing the author and subject. See the full description in the section on Customized Article Headers below. hhhheeeellllpppp----kkkkeeeeyyyy _k_e_y (key, default ????) The key which ends the current completion and gives a list of possible completions for the next component when _n_n is prompting for a string, e.g. a file name. iiiiggggnnnnoooorrrreeee----xxxxoooonnnn----xxxxooooffffffff (boolean, default false) Normally, _n_n will ignore ^S and ^Q in the input from the terminal (if they are not handled in the tty driver). Setting this variable will treat these characters as normal input. - 47 - Formatted: March 7, 1995 NNNNNNNN((((1111)))) NNNNNNNN((((1111)))) RRRReeeelllleeeeaaaasssseeee 6666....4444....11118888 iiiinnnncccclllluuuuddddeeee----aaaarrrrtttt----iiiidddd (boolean, default false) The first line in a response with included material normally reads "...somebody... writes:" without a reference to the specific article from which the quotation was taken (this is found in the References: line). When this variable is set, the line will also include the article id of the referenced article: "In ...article... ... writes:". iiiinnnncccclllluuuuddddeeee----ffffuuuullllllll----hhhheeeeaaaaddddeeeerrrr (boolean, default false) When set, the mmmmaaaaiiiillll (M) command will always include the full header of the original article. If it is not set, it only includes the header when the article is forwarded without being edited. iiiinnnncccclllluuuuddddeeee----mmmmaaaarrrrkkkk----bbbbllllaaaannnnkkkk----lllliiiinnnneeeessss (boolean, default false) When set, the iiiinnnncccclllluuuuddddeeeedddd----mmmmaaaarrrrkkkk is placed on blank lines in included articles. Otherwise, blank lines are left blank (to make it easy to delete whole paragraphs with `d}' in vi and `C-@ M-] C-W' in emacs). iiiinnnncccclllluuuuddddeeeedddd----mmmmaaaarrrrkkkk _s_t_r_i_n_g (string, default ">") This string is prefixed to all lines in the original article that are included in a reply or a follow-up. (Now you have the possibility to change it, but please don't. Lines with a mixture of prefixes like : orig-> <> } ] #- etc. are very difficult to comprehend. Let's all use the standard folks! (And hack inews if it is the 50% rule that bothers you.) iiiinnnneeeewwwwssss _s_h_e_l_l-_c_o_m_m_a_n_d (string, default "INEWS_PATH -h") The program which is invoked by _n_n to deliver an article to the news transport. The program will be given a complete article including a header containing the newsgroups to which the article is to be posted. See also iiiinnnneeeewwwwssss----ppppiiiippppeeee----iiiinnnnppppuuuutttt. It is _n_o_t used when cancelling an article! iiiinnnneeeewwwwssss----ppppiiiippppeeee----iiiinnnnppppuuuutttt (boolean, default true) When set, the article to be posted will be piped into the iiiinnnneeeewwwwssss program. Otherwise, the file containing the article will be given as the first (and only) argument to the iiiinnnneeeewwwwssss command. iiiinnnniiiittttiiiiaaaallll----nnnneeeewwwwssssrrrrcccc----ffffiiiilllleeee _f_i_l_e (string, default '.defaultnewsrc') Defines the name of a file which is used as the initial .newsrc file for new users. The name may be a full path name, or as the default a file name which will be looked for in a number of places: in the standard news lib directory (where it can be shared with other news readers), in nn's lib directory, and in the database directory. Groups which are not present in the initial .newsrc file will be automatically unsubscribed provided nnnneeeewwww----ggggrrrroooouuuupppp----aaaaccccttttiiiioooonnnn is set to a value allowing unsubscribed groups to be omitted from .newsrc. - 48 - Formatted: March 7, 1995 NNNNNNNN((((1111)))) NNNNNNNN((((1111)))) RRRReeeelllleeeeaaaasssseeee 6666....4444....11118888 kkkkeeeeeeeepppp----bbbbaaaacccckkkkuuuupppp----ffffoooollllddddeeeerrrr (boolean, default false) When set, the backup folder (see bbbbaaaacccckkkkuuuupppp----ffffoooollllddddeeeerrrr----ppppaaaatttthhhh) created when removing deleted articles from a folder is not removed. Notice that a backup folder is not created if all articles are removed from a folder! kkkkeeeeeeeepppp----uuuunnnnssssuuuubbbbssssccccrrrriiiibbbbeeeedddd (boolean, default true) When set, unsubscribed groups are kept in .newsrc. If not set, _n_n will automatically remove all unsubscribed from .newsrc if ttttiiiiddddyyyy----nnnneeeewwwwssssrrrrcccc is set. See also uuuunnnnssssuuuubbbbssssccccrrrriiiibbbbeeee----mmmmaaaarrrrkkkk----rrrreeeeaaaadddd. kkkkiiiillllllll (boolean, default true) If set, _n_n performs automatic kill and selection based on the _k_i_l_l file. kkkkiiiillllllll----ddddeeeebbbbuuuugggg (boolean, default false) When set, _n_n will display a trace of the auto-kill/select process on entry to a group. It is automatically turned off if `q' is entered as the answer to a "hit any key" prompt during the debug output. kkkkiiiillllllll----kkkkeeeeyyyy _k_e_y (key, default tty kill key) The key which deletes the current line when _n_n is prompting for a string, e.g. a file name. kkkkiiiillllllll----rrrreeeeffffeeeerrrreeeennnncccceeee----ccccoooouuuunnnntttt _N (integer, default 0) When this variable is non-zero, all articles which have _N or more references on the References: line (corresponding to the number of >>'s on the menu line) will be auto-killed if they are not auto-selected (or preserved) via an entry in the kill file. It should probably not be used globally for all groups, but can be set on a per-group via the entry macros. llllaaaayyyyoooouuuutttt _n_u_m_b_e_r (integer, default 1) Set the menu layout. The argument must be a number between 0 and 4. lllliiiimmmmiiiitttt _m_a_x-_a_r_t_i_c_l_e_s (integer, default infinite) _L_i_m_i_t the maximum number of articles presented in each group to _m_a_x-_a_r_t_i_c_l_e_s. The default is to present _a_l_l unread articles no matter how many there are. Setting this variable, only the most recent _m_a_x-_a_r_t_i_c_l_e_s articles will be presented, but all the articles will still be marked as read. This is useful to get up-to-date quickly if you have not read news for a longer period. lllliiiinnnneeeessss _l_i_n (integer, default screen height) This variable contains the screen height i.e. number of lines. lllloooonnnngggg----mmmmeeeennnnuuuu (boolean, default false) If set _n_n will not put an empty line after the header line and an empty line before the prompt line; this gives you two extra menu - 49 - Formatted: March 7, 1995 NNNNNNNN((((1111)))) NNNNNNNN((((1111)))) RRRReeeelllleeeeaaaasssseeee 6666....4444....11118888 lines. mmmmaaaaccccrrrroooo----ddddeeeebbbbuuuugggg (boolean, default false) If set _n_n will trace the execution of all macros. Prior to the execution of each command or operation in a macro, it will show the name of the command or the input string or key stroke at the bottom of the screen. mmmmaaaaiiiillll _f_i_l_e (string, default not set) _f_i_l_e must be a full path name of a file. If defined, _n_n will check for arrival of new mail every minute or so by looking at the specified file. mmmmaaaaiiiillll----aaaalllliiiiaaaassss----eeeexxxxppppaaaannnnddddeeeerrrr _p_r_o_g_r_a_m (string, default not set) When set, aliases used in mail responses may be expanded by the specified _p_r_o_g_r_a_m. The program will be given the completed response in a file as its only argument, and the aliases should be expanded directly in this file (of course the _p_r_o_g_r_a_m may use temporary files and other means to expand the aliases as long the the result is stored in the provided file). Notice: currently there are no alias expanders delivered with _n_n. Warning: Errors in the expansion process may lead to the response not being sent. mmmmaaaaiiiillll----ffffoooorrrrmmmmaaaatttt (boolean, default false) When set, _n_n will save articles in a format that is compatible with normal mail folders. Unless ffffoooollllddddeeeerrrr----ffffoooorrrrmmmmaaaatttt----cccchhhheeeecccckkkk is false, it is only used to specify the format used when new folders are created. This variable is ignored if mmmmmmmmddddffff----ffffoooorrrrmmmmaaaatttt is set. mmmmaaaaiiiillll----hhhheeeeaaaaddddeeeerrrr _h_e_a_d_e_r_s (string, default not set) The _h_e_a_d_e_r_s string specifies one or more extra header lines (separated by semi-colons `;') which are added to the header of mail sent from _n_n using the rrrreeeeppppllllyyyy and mmmmaaaaiiiillll commands. For example: set mail-header Reply-To: storm@texas.dk;Organization: TI - DK mmmmaaaaiiiillll----rrrreeeeccccoooorrrrdddd _f_i_l_e (string, default not set) _f_i_l_e must be a full path name of a file. If defined, all replies and mail will be saved in this file in standard _m_a_i_l_b_o_x format, i.e. you can use you favourite mailer (and _n_n) to look at the file. mmmmaaaaiiiillll----ssssccccrrrriiiipppptttt _f_i_l_e (string, default not set) When set, _n_n will use the specified file instead of the standard _a_u_x script when executing the rrrreeeeppppllllyyyy and mmmmaaaaiiiillll commands. mmmmaaaaiiiilllleeeerrrr _s_h_e_l_l-_c_o_m_m_a_n_d (string, default REC_MAIL) The program which is invoked by _n_n to deliver a message to the mail transport. The program will be given a complete mail message including a header containing the recipient's address. - 50 - Formatted: March 7, 1995 NNNNNNNN((((1111)))) NNNNNNNN((((1111)))) RRRReeeelllleeeeaaaasssseeee 6666....4444....11118888 See also mmmmaaaaiiiilllleeeerrrr----ppppiiiippppeeee----iiiinnnnppppuuuutttt. mmmmaaaaiiiilllleeeerrrr----ppppiiiippppeeee----iiiinnnnppppuuuutttt (boolean, default true) When set, the message to be sent will be piped into the mmmmaaaaiiiilllleeeerrrr program. Otherwise, the file containing the message will be given as the first (and only) argument to the mmmmaaaaiiiilllleeeerrrr command. mmmmaaaarrrrkkkkeeeedddd----bbbbyyyy----nnnneeeexxxxtttt----ggggrrrroooouuuupppp _N (integer, default 0) Specifies the amount of (unmarked) articles on the menu marked _s_e_e_n by the NNNN {nnnneeeexxxxtttt----ggggrrrroooouuuupppp} command in selection mode. See mmmmaaaarrrrkkkkeeeedddd----bbbbyyyy----rrrreeeeaaaadddd----sssskkkkiiiipppp for possible values of _N. mmmmaaaarrrrkkkkeeeedddd----bbbbyyyy----rrrreeeeaaaadddd----rrrreeeettttuuuurrrrnnnn _N (integer, default 0) Specifies the amount of (unmarked) articles on the menu marked _s_e_e_n by the ZZZZ {rrrreeeeaaaadddd----rrrreeeettttuuuurrrrnnnn} command in selection mode. See mmmmaaaarrrrkkkkeeeedddd----bbbbyyyy----rrrreeeeaaaadddd----sssskkkkiiiipppp for possible values of _N. mmmmaaaarrrrkkkkeeeedddd----bbbbyyyy----rrrreeeeaaaadddd----sssskkkkiiiipppp _N (integer, default 4) Specifies the amount of (unmarked) articles on the menu marked _s_e_e_n by the XXXX {rrrreeeeaaaadddd----sssskkkkiiiipppp} command in selection mode. The following values of _N are recognized: 0: No articles are marked seen 1: Current page is marked seen 2: Previous pages are marked seen 3: Previous and current pages are marked seen 4: All pages are marked seen mmmmaaaarrrrkkkk----oooovvvveeeerrrrllllaaaapppp (boolean, default false) When set, _n_n will draw a line (using the underline capabilities of the terminal if possible) to indicate the end of the overlap (see the oooovvvveeeerrrrllllaaaapppp variable). mmmmaaaarrrrkkkk----oooovvvveeeerrrrllllaaaapppp----sssshhhhaaaaddddiiiinnnngggg (boolean, default false) When set, _n_n will _s_h_a_d_e overlapping lines (see the oooovvvveeeerrrrllllaaaapppp variable) using the attributes defined by the sssshhhhaaaaddddiiiinnnngggg----oooonnnn and sssshhhhaaaaddddiiiinnnngggg----ooooffffffff variables (of if not set, with the underline attribute). This is typically used to give overlapping lines a different colour on terminals which have this capability. mmmmeeeennnnuuuu----ssssppppaaaacccciiiinnnngggg _m_o_d_e (integer, default 0) When _m_o_d_e is a non-zero number as described below, _n_n will add blank lines between the lines on the menu to increase readability at the cost of presenting fewer articles on each page. The following values of _m_o_d_e are recognized: 0: Don't add blank lines between menu lines. 1: Add a blank line between articles with _d_i_f_f_e_r_e_n_t subjects. 2: Add a blank line between _a_l_l articles. mmmmeeeerrrrggggeeee----rrrreeeeppppoooorrrrtttt----rrrraaaatttteeee _r_a_t_e (integer, default 1) When _n_n is invoked with the -m option (directly or via _n_n_g_r_a_p), a status report of the merging process is displayed and updated on - 51 - Formatted: March 7, 1995 NNNNNNNN((((1111)))) NNNNNNNN((((1111)))) RRRReeeelllleeeeaaaasssseeee 6666....4444....11118888 the screen every _r_a_t_e seconds. The report contains the time used so far and an estimate of the time needed to complete the merge. mmmmeeeessssssssaaaaggggeeee----hhhhiiiissssttttoooorrrryyyy _N (integer, default 15) Specifies the maximum number, _N, of older messages which can be recalled with the ^^^^PPPP {mmmmeeeessssssssaaaaggggeeee} command. mmmmiiiinnnn----wwwwiiiinnnnddddoooowwww _s_i_z_e (integer, default 7) When the wwwwiiiinnnnddddoooowwww variable is not set, _n_n will clear the screen to preview an article if there are less than _s_i_z_e unused lines at the bottom of the menu screen. mmmmmmmmddddffff----ffffoooorrrrmmmmaaaatttt (boolean, default false) When set, _n_n will save articles in MMDF format. Unless ffffoooollllddddeeeerrrr---- ffffoooorrrrmmmmaaaatttt----cccchhhheeeecccckkkk is false, it is only used to specify the format used when new folders are created. mmmmoooonnnniiiittttoooorrrr (boolean, default false) When set, _n_n will show _a_l_l characters in the received messages using a "cat -v" like format. Otherwise, only the printable characters are shown (default). mmmmoooottttdddd (boolean, default true) When set, _n_n will display the _m_e_s_s_a_g_e _o_f _t_h_e _d_a_y on start-up if it has changed since it was last shown. The message is taken from the file "motd" in the lib directory. It can also be shown (again) using the ::::mmmmoooottttdddd command. mmmmuuuullllttttiiii----kkkkeeeeyyyy----gggguuuuaaaarrrrdddd----ttttiiiimmmmeeee _t_i_m_e_o_u_t (integer, default 2) When reading a multi-key sequence from the keyboard, _n_n will expect the characters constituting the multi-key to arrive "quickly" after each other. When a partial multi-key sequence is read, _n_n will wait (at least) _t_i_m_e_o_u_t tenths of a second for each of the following characters to arrive to complete the multi-key sequence. If the multi-key sequence is _n_o_t completed within this period, _n_n will read the partial multi-key sequence as individual characters instead. This way it is still possible to use for example the ESC key on a terminal with vt100 like arrow keys. When _n_n is used via an rlogin connection, you may have to increase the timeout to get reliable recognition of multi-keys. nnnneeeewwww----ggggrrrroooouuuupppp----aaaaccccttttiiiioooonnnn _a_c_t_i_o_n (integer, default 3) This variable controls how new groups are treated by _n_n. It is an integer variable, and the following values can be used. Some of these actions (marked with an *) will only work when kkkkeeeeeeeepppp---- uuuunnnnssssuuuubbbbssssccccrrrriiiibbbbeeeedddd is set, since the presence of a group in .newsrc is the only way to recognize it as an old group: 0000) Ignore groups which are not in .newsrc. This will obviously include new groups. 1111*) Groups not in .newsrc are considered to be new, and are - 52 - Formatted: March 7, 1995 NNNNNNNN((((1111)))) NNNNNNNN((((1111)))) RRRReeeelllleeeeaaaasssseeee 6666....4444....11118888 inserted at the beginning of the .newsrc file. 2222*) Groups not in .newsrc are considered to be new, and are appended to the end of the .newsrc file. 3333) New groups are recognized via a time-stamp saved in the file .nn/LAST and in the database, i.e. it is not dependent on the groups currently in .newsrc. The new groups are automatically appended to .newsrc with subscription. Old groups not present in .newsrc will be considered to be unsubscribed. 4444) As 3333, but the user is asked to confirm that the new group should be appended to .newsrc. If rejected, the group will not be appended to .newsrc, and thus be regarded as unsubscribed. 5555) As 4444, except that the information is stored in a format compatible with the _r_n news reader (.rnlast). This needs to be tested! nnnneeeewwww----ssssttttyyyylllleeee----rrrreeeeaaaadddd----pppprrrroooommmmpppptttt (boolean, default true) When set, the reading mode prompt line includes the group name and the number of selected articles in the group. nnnneeeewwwwssss----hhhheeeeaaaaddddeeeerrrr _h_e_a_d_e_r_s (string, default not set) The _h_e_a_d_e_r_s string specifies one or more extra header lines (separated by semi-colons `;') which are added to the header of articles posted from _n_n using the ffffoooolllllllloooowwww and ppppoooosssstttt commands. See mmmmaaaaiiiillll----hhhheeeeaaaaddddeeeerrrr for an example. nnnneeeewwwwssss----rrrreeeeccccoooorrrrdddd _f_i_l_e (string, default not set) Save file for follow-ups and postings. Same rules and format as the mmmmaaaaiiiillll----rrrreeeeccccoooorrrrdddd variable. nnnneeeewwwwssss----ssssccccrrrriiiipppptttt _f_i_l_e (string, default not set) When set, _n_n will use the specified file instead of the standard _a_u_x script when executing the ffffoooolllllllloooowwww and ppppoooosssstttt commands. nnnneeeewwwwssssrrrrcccc _f_i_l_e (string, default "~/.newsrc") Specifies the file used by _n_n to register which groups and articles have been read. The default setting corresponds to the .newsrc file used by other news readers. Notice that _n_n release 6.4 _d_o_e_s _a_l_l_o_w individual articles to be marked unread, and some articles marked unread, and thus no longer messes up .newsrc for other news readers! nnnnnnnnttttpppp----ccccaaaacccchhhheeee----ddddiiiirrrr _d_i_r_e_c_t_o_r_y (string, default "~/.nn") When NNTP is used, _n_n needs to store articles temporarily on disk. This variable specifies which directory _n_n will use to hold these files. The default value may be changed during configuration. This variable can only be set in the init file. nnnnnnnnttttpppp----ccccaaaacccchhhheeee----ssssiiiizzzzeeee _s_i_z_e (integer, default 10, maximum 10) Specifies the number of temporary files in the nntp cache. The - 53 - Formatted: March 7, 1995 NNNNNNNN((((1111)))) NNNNNNNN((((1111)))) RRRReeeelllleeeeaaaasssseeee 6666....4444....11118888 default and maximum values may be changed during configuration. nnnnnnnnttttpppp----ddddeeeebbbbuuuugggg (boolean, default false) When set, a trace of the nntp related traffic is displayed in the message line on the screen. oooolllldddd [_m_a_x-_a_r_t_i_c_l_e_s] (integer, default not set) When oooolllldddd is set, _n_n will present (or scan) all (or the last _m_a_x- _a_r_t_i_c_l_e_s) unread as well as read articles. While oooolllldddd is set, _n_n will _n_e_v_e_r mark any unread articles as read. oooorrrriiiigggg----ttttoooo----iiiinnnncccclllluuuuddddeeee----mmmmaaaasssskkkk _N (integer, default 3) When replying to an article, _n_n will include some of the header lines which may be used to construct a proper mail address for the poster of the original article. These addresses are placed on _O_r_i_g-_T_o: lines in the reply header and will automatically be removed before the letter is sent. This variable specifies which headers from the article are included; its value _N is the sum of the following values: 1: _R_e_p_l_y-_T_o: 2: _F_r_o_m: 4: _P_a_t_h: oooovvvveeeerrrrllllaaaapppp _l_i_n_e_s (integer, default 2) Specifies the number of overlapping lines from one page to the next when paging through an article in reading mode. The last line from the previous page will be underlined if the terminal has that capability. ppppaaaaggggeeeerrrr _s_h_e_l_l-_c_o_m_m_a_n_d (string, default $PAGER) This is the pager used by the ::::aaaaddddmmmmiiiinnnn command (and _n_n_a_d_m_i_n) when it executes certain commands, e.g. grepping in the Log file. ppppaaaattttcccchhhh----ccccoooommmmmmmmaaaannnndddd _s_h_e_l_l-_c_o_m_m_a_n_d (string, default "patch -p0") This is the command which is invoked by the ::::ppppaaaattttcccchhhh command. ppppoooosssstttt----ddddiiiissssttttrrrriiiibbbbuuuuttttiiiioooonnnn _w_o_r_d_s (string, default see below) This variable controls how the Distribution: header is constructed when posting an original article. Its value is a list of _w_o_r_d_s selected from the following list: [ aaaasssskkkk ] [ ddddeeeeffffaaaauuuulllltttt | _d_i_s_t_r_i_b_u_t_i_o_n ] This is interpreted in two steps: - First the default distribution is determined. If ddddeeeeffffaaaauuuulllltttt is specified (or _d_i_s_t_r_i_b_u_t_i_o_n is omitted), the value of ddddeeeeffffaaaauuuulllltttt---- ddddiiiissssttttrrrriiiibbbbuuuuttttiiiioooonnnn is used. Otherwise, the specified _d_i_s_t_r_i_b_u_t_i_o_n (any word) is used as the default. - Then if aaaasssskkkk is specified, the user will be asked to confirm the default distribution or provide another distribution. The default value of ppppoooosssstttt----ddddiiiissssttttrrrriiiibbbbuuuuttttiiiioooonnnn is aaaasssskkkk ddddeeeeffffaaaauuuulllltttt, i.e. use the ddddeeeeffffaaaauuuulllltttt----ddddiiiissssttttrrrriiiibbbbuuuuttttiiiioooonnnn with confirmation from the user. - 54 - Formatted: March 7, 1995 NNNNNNNN((((1111)))) NNNNNNNN((((1111)))) RRRReeeelllleeeeaaaasssseeee 6666....4444....11118888 pppprrrreeeevvvviiiieeeewwww----ccccoooonnnnttttiiiinnnnuuuuaaaattttiiiioooonnnn _c_o_n_d (integer, default 12) This variable determines on what terms the following article should be automatically shown when previewing an article, and the nnnneeeexxxxtttt----aaaarrrrttttiiiicccclllleeee command is used, or ccccoooonnnnttttiiiinnnnuuuueeee is used at the end of the article. The following values can be used: 0000 - never show the next article (return to the menu). 1111 - always show the next article (use 'q' to return to the menu). 2222 - show the next article if it has the same subject as the current article, else return to the menu. The value should be the _s_u_m of two values: one for the action after using ccccoooonnnnttttiiiinnnnuuuueeee on the last page of the article, and one for the action performed when the nnnneeeexxxxtttt----aaaarrrrttttiiiicccclllleeee command is used _m_u_l_t_i_p_l_i_e_d _b_y _1_0. pppprrrreeeevvvviiiieeeewwww----mmmmaaaarrrrkkkk----rrrreeeeaaaadddd (boolean, default true) When set, previewing an article will mark the article as read. pppprrrreeeevvvviiiioooouuuussss----aaaallllssssoooo----rrrreeeeaaaadddd (boolean, default true) When set, going back to the previously read group with PPPP {pppprrrreeeevvvviiiioooouuuussss} will include articles read in the current invocation of _n_n even if there are still unread articles in the group. pppprrrriiiinnnntttt----hhhheeeeaaaaddddeeeerrrr----lllliiiinnnneeeessss _f_i_e_l_d_s (string, default "FDGS") Specifies the list of header fields that are output when an article is printed via the ::::pppprrrriiiinnnntttt command and pppprrrriiiinnnntttt----hhhheeeeaaaaddddeeeerrrr----ttttyyyyppppeeee is 1 (short header). The _f_i_e_l_d_s specification is desctribed in the section on Customized Article Headers below. pppprrrriiiinnnntttt----hhhheeeeaaaaddddeeeerrrr----ttttyyyyppppeeee _N (integer, default 1) Specifies what kind of header is printed by the ::::pppprrrriiiinnnntttt command, corresponding to the three ssssaaaavvvveeee----**** commands: _0 prints only the article body (no header), _1 prints a short header, and _2 prints the full article header. pppprrrriiiinnnntttteeeerrrr _s_h_e_l_l-_c_o_m_m_a_n_d (string, default is system dep.) This is the default value for the pppprrrriiiinnnntttt command. It should include an option which prevents the spooler from echoing a job- id or similar to the terminal to avoid problems with screen handling (e.g. lp -s on System V). qqqquuuueeeerrrryyyy----ssssiiiiggggnnnnaaaattttuuuurrrreeee (boolean, default ...) Will cause _n_n to require confirmation before appending the .signature file to out-going mail or news if the corresponding aaaappppppppeeeennnndddd----ssssiiiigggg----... variable is set. qqqquuuuiiiicccckkkk----ccccoooouuuunnnntttt (boolean, default true) When set, calculating the total number of unread articles at start-up is done by simple subtracting the first unread article number from the total number of articles in each group. This is very fast, and fairly accurate but it may be a bit too large. If not set, each line in .newsrc will be interpreted to count every - 55 - Formatted: March 7, 1995 NNNNNNNN((((1111)))) NNNNNNNN((((1111)))) RRRReeeelllleeeeaaaasssseeee 6666....4444....11118888 unread article, thus giving a very accurate number. This variable is also used by _n_n_c_h_e_c_k. qqqquuuuiiiicccckkkk----ssssaaaavvvveeee (boolean, default false) When set, _n_n will not prompt for a file name when an article is saved (unless it belongs to a folder). Instead it uses the save file specified for the current group in the init file or the default save file. rrrreeee----llllaaaayyyyoooouuuutttt _N (integer, default 0) Normally on the menu, _n_n will prefix the subject a number of `>'s corresponding to the number of references on the References: line. The rrrreeee----llllaaaayyyyoooouuuutttt variable may be set to use a different prefix on the subjects: 0: One `>' per reference is shown (default). 1: A single `>' is shown if the Subject contains Re:. 2: The number of references is shown as `n>' 3: A single Re: is shown. 4: If any references use layout 0, else layout 1. rrrreeee----llllaaaayyyyoooouuuutttt----rrrreeeeaaaadddd _N (integer, default -1) When the hhhheeeeaaaaddddeeeerrrr----lllliiiinnnneeeessss variable is not set, or contains the "*" field specifier, a line similar to the menu line will be used as the header of the article in reading mode, including the sender's name and the article's subject. When this variable is negative, the subject on this header line will be prefixed according to the rrrreeee----llllaaaayyyyoooouuuutttt variable. Otherwise, it will define the format of the "Re:" prefix to be used instead of the rrrreeee----llllaaaayyyyoooouuuutttt used on the menu. rrrreeeeaaaadddd----rrrreeeettttuuuurrrrnnnn----nnnneeeexxxxtttt----ppppaaaaggggeeee (boolean, default false) When set, the ZZZZ {rrrreeeeaaaadddd----rrrreeeettttuuuurrrrnnnn} command will return to the _n_e_x_t menu page rather than the current menu page. rrrreeeeccccoooorrrrdddd _f_i_l_e (string, no default) Setting this _p_s_e_u_d_o variable will set both the mmmmaaaaiiiillll----rrrreeeeccccoooorrrrdddd and the nnnneeeewwwwssss----rrrreeeeccccoooorrrrdddd variables to the specified pathname. rrrreeeeppppeeeeaaaatttt (boolean, default false) When set, _n_n will not eliminate duplicated subject lines on menus (I cannot imagine why anyone should want that, but....) rrrreeeeppppeeeeaaaatttt----ggggrrrroooouuuupppp----qqqquuuueeeerrrryyyy (boolean, default false) When set, invoking _n_n with the ----gggg option will always repeat the query for a group to enter until you quit explicitly. (Same as setting the ----rrrr option permanently). rrrreeeeppppoooorrrrtttt----ccccoooosssstttt (boolean, default true) This variable is ignored unless _n_n is running with accounting enabled (see _n_n_a_c_c_t). When set, _n_n will report the cost of the current session and the total on exit. - 56 - Formatted: March 7, 1995 NNNNNNNN((((1111)))) NNNNNNNN((((1111)))) RRRReeeelllleeeeaaaasssseeee 6666....4444....11118888 rrrreeeessssppppoooonnnnsssseeee----cccchhhheeeecccckkkk----ppppaaaauuuusssseeee _p_a_u_s_e (integer, default 2) Specifies the number of seconds to wait after posting an article to see whether the action *might* have failed. Some commands run in the background and may thus not have completed during this period, so even when _n_n says "Article posted", it may still fail (in which case you are informed via mail). rrrreeeessssppppoooonnnnsssseeee----ddddeeeeffffaaaauuuulllltttt----aaaannnnsssswwwweeeerrrr _a_c_t_i_o_n (string, default "send") The default action to be taken when hitting rrrreeeettttuuuurrrrnnnn to the "response action" prompt (abort, edit, send, view, write). If it is unset, no default action is defined. rrrreeeettttaaaaiiiinnnn----sssseeeeeeeennnn----ssssttttaaaattttuuuussss (boolean, default false) Normally, seen articles will just be unread the next time the group is entered (unless they were marked read by aaaauuuuttttoooo----jjjjuuuunnnnkkkk---- sssseeeeeeeennnn). If rrrreeeettttaaaaiiiinnnn----sssseeeeeeeennnn----ssssttttaaaattttuuuussss is set, the seen attribute on the articles will survive to the next time the group is entered. (This is not recommended because it may result in very large select files). rrrreeeettttrrrryyyy----oooonnnn----eeeerrrrrrrroooorrrr _t_i_m_e_s (integer, default 0) When set, _n_n will try the specified number of _t_i_m_e_s to open an article before reporting that the article does not exist any more. This may be necessary in some network environments. ssssaaaavvvveeee----cccclllloooosssseeeedddd----mmmmooooddddeeee _m_o_d_e (integer, default 13) When saving an article in selection mode (i.e. by selecting it from the menu), _n_n will simply save the specified article if the article's subject is _o_p_e_n. When the selected menu entry is a closed subject, the ssssaaaavvvveeee----cccclllloooosssseeeedddd----mmmmooooddddeeee variable determines how many articles among the closed articles should be saved: 0: save root article (the one on the menu) only 1: save selected articles within subject 2: save unread (excl selected) articles within subject 3: save selected+unread articles within subject 4: save all articles within subject If `10' is added to the above values, _n_n will not save the selected subject immediately; instead it will ask which articles to save using the above value as the default answer. ssssaaaavvvveeee----ccccoooouuuunnnntttteeeerrrr _f_o_r_m_a_t (string, default "%d") This is the printf-format which _n_n uses to create substitution string for the trailing * in save file names. You can set this to more complex formats if you like, but be sure that it will produce different strings for different numbers. An alternative format which seems to be popular is ".%02d" . ssssaaaavvvveeee----ccccoooouuuunnnntttteeeerrrr----ooooffffffffsssseeeetttt _N (integer, default 0) Normally, file names created with the _p_a_r_t.* form will substitute the * with successive numbers starting from one. Setting this variable will cause these numbers to start from _N+1. - 57 - Formatted: March 7, 1995 NNNNNNNN((((1111)))) NNNNNNNN((((1111)))) RRRReeeelllleeeeaaaasssseeee 6666....4444....11118888 ssssaaaavvvveeee----hhhheeeeaaaaddddeeeerrrr----lllliiiinnnneeeessss _f_i_e_l_d_s (string, default "FDNS") Specifies the list of header fields that are saved when an article is saved via the OOOO {ssssaaaavvvveeee----sssshhhhoooorrrrtttt} command. The _f_i_e_l_d_s specification is desctribed in the section on Customized Article Headers below. ssssaaaavvvveeee----rrrreeeeppppoooorrrrtttt (boolean, default true) When set, a message reporting the number of lines written is shown after saving an article. Since messages are shown for a few seconds, this may slow down the saving of many articles (e.g. using the SSSS**** command). ssssccccrrrroooollllllll----cccclllleeeeaaaarrrr----ppppaaaaggggeeee (boolean, default true) Determines whether _n_n clears the screen before showing each new page of an article. ssssccccrrrroooollllllll----llllaaaasssstttt----lllliiiinnnneeeessss _N (integer, default 0) Normally, _n_n will show each new page of an article from the top of the screen (with proper marking of the overlap). When this variable is set to a negative value, _n_n will scroll the text of the new pages from the bottom of the screen instead. If it is set to a positive value, _n_n will show pages from the top as usual, but switch to scrolling when there are _l_e_s_s _t_h_a_n the specified number of lines left in the article. sssseeeelllleeeecccctttt----lllleeeeaaaavvvveeee----nnnneeeexxxxtttt (boolean, default false) When set, you will be asked whether to select articles with the lllleeeeaaaavvvveeee----nnnneeeexxxxtttt attribute on entry to a group with left over articles. sssseeeelllleeeecccctttt----oooonnnn----sssseeeennnnddddeeeerrrr (boolean, default false) Specifies whether the ffffiiiinnnndddd (=) command in article selection mode will match on the subject or the sender. sssshhhhaaaaddddiiiinnnngggg----oooonnnn _c_o_d_e... (control string, default not set) Specifies the escape code to be sent to the terminal to cause "shading" of the following output to the screen. This is used if the mmmmaaaarrrrkkkk----oooovvvveeeerrrrllllaaaapppp----sssshhhhaaaaddddiiiinnnngggg is set, and by the `+' attribute in the hhhheeeeaaaaddddeeeerrrr----lllliiiinnnneeeessss variable. sssshhhhaaaaddddiiiinnnngggg----ooooffffffff _c_o_d_e... (control string, default not set) Specifies the escape code to be sent to the terminal to turn off the shading defined by sssshhhhaaaaddddiiiinnnngggg----oooonnnn. Shading will typically be done by changing the foreground colour to change, e.g. on term ti924-colour set shading-on ^[ [ 3 2 m set shading-off ^[ [ 3 7 m set mark-overlap-shading unset mark-overlap end - 58 - Formatted: March 7, 1995 NNNNNNNN((((1111)))) NNNNNNNN((((1111)))) RRRReeeelllleeeeaaaasssseeee 6666....4444....11118888 sssshhhheeeellllllll _p_r_o_g_r_a_m (string, default $SHELL) The shell program used to execute shell escapes. sssshhhheeeellllllll----rrrreeeessssttttrrrriiiiccccttttiiiioooonnnnssss (boolean, default false) When set (in the init file), _n_n will not allow the user to invoke the shell in any way, including saving on pipes. It also prevents the user from changing certain variables containing commands. sssshhhhoooowwww----ppppuuuurrrrppppoooosssseeee----mmmmooooddddeeee _N (integer, default 1) Normally, _n_n will show the purpose of a group the first time it is read, provided a purpose is known. Setting this variable, this behaviour can be changed as follows: 0: Never show the purpose. 1: Show the purpose for new groups only. 2: Show the purpose for all groups. ssssiiiilllleeeennnntttt (boolean, default false) When set, _n_n wont print the logo or "No News" if there are no unread articles. Only useful to set in the init file or with the ----QQQQ option. sssslllloooowwww----mmmmooooddddeeee (boolean, default false) When set, _n_n will cut down on the screen output to give better response time at low speed. Normally, _n_n will use standout mode (if possible) to mark selected articles on the menu, but when sssslllloooowwww----mmmmooooddddeeee is set, _n_n will just put an asterisk `*' next to the article identifier on selected articles. Also when sssslllloooowwww----mmmmooooddddeeee is set _n_n will avoid redrawing the screen in the following cases: After a ggggoooottttoooo----ggggrrrroooouuuupppp command an empty menu is shown (hit ssssppppaaaacccceeee to make it appear), and after responding to an article, only the prompt line is shown (use ^L to redraw the screen). To avoid redrawing the screen after an extended command, set the ddddeeeellllaaaayyyy---- rrrreeeeddddrrrraaaawwww variable as well. sssslllloooowwww----ssssppppeeeeeeeedddd _s_p_e_e_d (integer, default 1200) If the terminal is running at this baud rate or lower, the oooonnnn sssslllloooowwww (see the section on init files) condition will be true, and the oooonnnn ffffaaaasssstttt will be false (and vice-versa). ssssoooorrrrtttt (boolean, default true) When set, _n_n will sort articles according to the current ssssoooorrrrtttt---- mmmmooooddddeeee on entry to a group. Otherwise, articles will be presented in order of arrival. If not set on entry to a menu for merged groups, the articles from each group will be kept together on the menu. If ssssoooorrrrtttt is unset while merged groups are presented on the menu, the articles will be reordered by local article number (which may not keep articles from the same group together). ssssoooorrrrtttt----mmmmooooddddeeee _m_o_d_e (integer, default 1) The default sort algorithm used to sort the articles on entry to - 59 - Formatted: March 7, 1995 NNNNNNNN((((1111)))) NNNNNNNN((((1111)))) RRRReeeelllleeeeaaaasssseeee 6666....4444....11118888 a news group. It is a numeric value corresponding to one of the sorting methods described in connection with the :sort command: 0 - arrival (ordered by article number) 1 - subject (subjects ordered after age of first article) 2 - lexical (subjects in lexicographical order) 3 - age (articles ordered after posting date only) 4 - sender (articles ordered after sender's name) ssssppppeeeellllllll----cccchhhheeeecccckkkkeeeerrrr _s_h_e_l_l-_c_o_m_m_a_n_d (string, default not set) When set, responses can be checked for spelling mistakes via the (i)spell action. The command to perform the spelling is given the file containing the full article including header as its only argument. If the spell checker can fix spelling mistakes, it must apply the changes directly to this file. sssspppplllliiiitttt (boolean, default true) When set, digests will automatically and silently be split into sub-articles which are then handled transparently as normal articles. Otherwise, digests are presented as one article (which you can split on demand with the GGGG command). ssssttttoooopppp _l_i_n_e_s (integer, default not set) When ssssttttoooopppp is set, _n_n will only show the first _l_i_n_e_s lines of the of each article before prompting you to continue. This is useful on slow terminals and modem lines to be able to see the first few lines of longer articles (and skipping the rest with the nnnn command). ssssuuuubbbbjjjjeeeecccctttt----mmmmaaaattttcccchhhh----lllliiiimmmmiiiitttt _l_e_n_g_t_h (integer, default 256) Subjects will be considered identical if their first _l_e_n_g_t_h characters match. Setting this uncritically to a low value may cause unexpected results! ssssuuuubbbbjjjjeeeecccctttt----mmmmaaaattttcccchhhh----ooooffffffffsssseeeetttt _o_f_f_s_e_t (integer, default 0) When set to a positive number, that many characters at the beginning of the subject will be ignored when comparing subjects for ordering and equality purposes. ssssuuuubbbbjjjjeeeecccctttt----mmmmaaaattttcccchhhh----ppppaaaarrrrttttssss (boolean, default false) When set, two subjects will be considered equal if they are identical up to the first (differing) digit. Together with the ssssuuuubbbbjjjjeeeecccctttt----mmmmaaaattttcccchhhh----ooooffffffffsssseeeetttt variable, this can be used in source groups where the subject often has a format like: vXXXXXX: Name of the package (Part 01/04) Setting ssssuuuubbbbjjjjeeeecccctttt----mmmmaaaattttcccchhhh----ooooffffffffsssseeeetttt to 8 and ssssuuuubbbbjjjjeeeecccctttt----mmmmaaaattttcccchhhh----ppppaaaarrrrttttssss to true will make _n_n consider all four parts of the package having the same subject (and thus be selectable with `*'). Notice that changing the ssssuuuubbbbjjjjeeeecccctttt----mmmmaaaattttcccchhhh----... variables manually will not have an immediate effect. To reorder the menu, an - 60 - Formatted: March 7, 1995 NNNNNNNN((((1111)))) NNNNNNNN((((1111)))) RRRReeeelllleeeeaaaasssseeee 6666....4444....11118888 explicit ::::ssssoooorrrrtttt command must be performed. These variables are mainly intended to be set using the ::::llllooooccccaaaallll command in oooonnnn eeeennnnttttrrrryyyy macros for source and binary groups (entry macros are evaluated before the menu is collected and sorted). ssssuuuuggggggggeeeesssstttt----ddddeeeeffffaaaauuuulllltttt----ssssaaaavvvveeee (boolean, default true) When set, _n_n will present the ddddeeeeffffaaaauuuulllltttt----ssssaaaavvvveeee----ffffiiiilllleeee when prompting for a save file name in a group without a specific save file, or ffffoooollllddddeeeerrrr----ssssaaaavvvveeee----ffffiiiilllleeee when saving from a folder. When not set, no file name is presented, and to use the default save file, a single + must be specified. ttttiiiiddddyyyy----nnnneeeewwwwssssrrrrcccc (boolean, default false) When set, _n_n will automatically remove lines from .newsrc which represent groups not found in the active file or unsubscribed groups if kkkkeeeeeeeepppp----uuuunnnnssssuuuubbbbssssccccrrrriiiibbbbeeeedddd is not set. ttttiiiimmmmeeee (boolean, default true) When set, _n_n will show the current time in the prompt line. This is useful on systems without a _s_y_s_l_i_n_e (_1) utility. ttttrrrraaaacccceeee----ffffoooollllddddeeeerrrr----ppppaaaacccckkkkiiiinnnngggg (boolean, default true) When set, a trace of the retained and deleted messages is printed when a folder is rewritten. ttttrrrruuuusssstttteeeedddd----eeeessssccccaaaappppeeee----ccccooooddddeeeessss _c_o_d_e_s (string, default none) When set to a list of one or more characters, _n_n will trust and output _e_s_c_a_p_e characters in an article if it is followed by one of the characters in the list. For example, to switch to or from kanji mode, control codes like "_e_s_c $" and "_e_s_c ( J" may be present in the text. To allow these codes, use the following command: set trusted-escape-codes ($ You can also set it to aaaallllllll to pass all espace codes through to the screen. Notice that _n_n thinks all characters (including _e_s_c) output to the screen as occupy one column. uuuunnnnsssshhhhaaaarrrr----ccccoooommmmmmmmaaaannnndddd _s_h_e_l_l-_c_o_m_m_a_n_d (string, default "/bin/sh") This is the command which is invoked by the uuuunnnnsssshhhhaaaarrrr command. uuuunnnnsssshhhhaaaarrrr----hhhheeeeaaaaddddeeeerrrr----ffffiiiilllleeee _f_i_l_e (string, default "Unshar.Headers") The name of the file in which the header and initial text of articles unpacked with the ::::uuuunnnnsssshhhhaaaarrrr command is saved. Unless the file name starts with a `/', the file will be created in the same directory as the unpacked files. The information is not saved if this variable is not set. Setting it to "Unshar.Result" will cause the headers and the results from the unpacking process to be merged in a meaningful way (unless mmmmmmmmddddffff----ffffoooorrrrmmmmaaaatttt is set). - 61 - Formatted: March 7, 1995 NNNNNNNN((((1111)))) NNNNNNNN((((1111)))) RRRReeeelllleeeeaaaasssseeee 6666....4444....11118888 uuuunnnnssssuuuubbbbssssccccrrrriiiibbbbeeee----mmmmaaaarrrrkkkk----rrrreeeeaaaadddd (boolean, default true) When set, unsubscribing to a group will automatically mark all current articles read; this is recommended to keep the size of .newsrc down. Otherwise, unread articles in the unsubscribe groups are kept in .newsrc. If kkkkeeeeeeeepppp----uuuunnnnssssuuuubbbbssssccccrrrriiiibbbbeeeedddd is false, this variable has no effect. uuuuppppddddaaaatttteeee----ffffrrrreeeeqqqquuuueeeennnnccccyyyy (integer, default 1) Specifies how many changes need to be done to the .newsrc or select files before they are written back to disk. The default setting causes .newsrc to be updated every time a group has been read. uuuusssseeee----ppppaaaatttthhhh----iiiinnnn----ffffrrrroooommmm (boolean, default false) When mmmmaaaaiiiillll----ffffoooorrrrmmmmaaaatttt is set, saved articles will be preceded by a specially formatted "From " line: From origin date Normally, the origin will be the name of the news group where the article appeared, but if uuuusssseeee----ppppaaaatttthhhh----iiiinnnn----ffffrrrroooommmm is set, the contents of the "Path:" header will be used as the origin. uuuusssseeee----sssseeeelllleeeeccccttttiiiioooonnnnssss (boolean, default true) When set, _n_n uses the selections and other article attributes saved last time _n_n was used. If not set, _n_n ignores the select file. vvvviiiissssiiiibbbblllleeee----bbbbeeeellllllll (boolean, default true) When set, _n_n will flash the screen instead of "ringing the bell" if the visible bell (flash) capability is defined in the termcap/terminfo database. wwwwiiiinnnnddddoooowwww _s_i_z_e (integer, default not set) When set, _n_n will reserve the last _s_i_z_e lines of the menu screen for a preview window. If not set, _n_n will clear the screen to preview an article if there are less than mmmmiiiinnnn----wwwwiiiinnnnddddoooowwww lines at the bottom of the screen. As a side effect, it can also be used to reduce the size of the menus, which may be useful on slow terminals. wwwwoooorrrrdddd----kkkkeeeeyyyy _k_e_y (key, default ^W) The key which erases the last input component or word when _n_n is prompting for a string, e.g. the last name in a path name. wwwwrrrraaaapppp----hhhheeeeaaaaddddeeeerrrr----mmmmaaaarrrrggggiiiinnnn _s_i_z_e (integer, default 6) When set (non-negative), the customized header fields specified in hhhheeeeaaaaddddeeeerrrr----lllliiiinnnneeeessss will be split across several lines if they don't fit on one line. When _s_i_z_e is greater than zero, lines will be split at the first space occurring in the last _s_i_z_e columns of the line. If not set (or negative), long header lines will be truncated if they don't fit on a single line. - 62 - Formatted: March 7, 1995 NNNNNNNN((((1111)))) NNNNNNNN((((1111)))) RRRReeeelllleeeeaaaasssseeee 6666....4444....11118888 CCCCUUUUSSSSTTTTOOOOMMMMIIIIZZZZEEEEDDDD AAAARRRRTTTTIIIICCCCLLLLEEEE HHHHEEEEAAAADDDDEEEERRRR PPPPRRRREEEESSSSEEEENNNNTTTTAAAATTTTIIIIOOOONNNN Normally, _n_n will just print a (high-lighted) single line header containing the author, subject, and date (optional) of the article when it is read. By setting the hhhheeeeaaaaddddeeeerrrr----lllliiiinnnneeeessss variable as described below, it is possible to get a more informative multi line header with optional high-lighting and underlining. The hhhheeeeaaaaddddeeeerrrr----lllliiiinnnneeeessss variable is set to a list of header line identifiers, and the customized headers will then contain exactly these header lines _i_n _t_h_e _s_p_e_c_i_f_i_e_d _o_r_d_e_r. The same specifications are also used by the ::::pppprrrriiiinnnntttt and ssssaaaavvvveeee----sssshhhhoooorrrrtttt commands via the pppprrrriiiinnnntttt----hhhheeeeaaaaddddeeeerrrr----lllliiiinnnneeeessss and ssssaaaavvvveeee----hhhheeeeaaaaddddeeeerrrr----lllliiiinnnneeeessss variables. The following header line identifiers are recognized in the hhhheeeeaaaaddddeeeerrrr---- lllliiiinnnneeeessss, pppprrrriiiinnnntttt----hhhheeeeaaaaddddeeeerrrr----lllliiiinnnneeeessss, and ssssaaaavvvveeee----hhhheeeeaaaaddddeeeerrrr----lllliiiinnnneeeessss variables: AAAA Approved: aaaa Spool-File:(path of spool file containing the article) BBBB Distribution: CCCC Control: DDDD Date: dddd Date-Received: FFFF From: ffff Sender: GGGG Newsgroup:(current group) gggg Newsgroup:(current group if cross-posted or merged) IIII Message-Id: KKKK Keywords: LLLL Lines: NNNN Newsgroups: nnnn Newsgroups: (but only if cross posted) OOOO Organization: PPPP Path: RRRR Reply-To: SSSS Subject: vvvv Save-File:(the default save file for this article) WWWW Followup-To: XXXX References: xxxx Back-References: YYYY Summary: The 'G' and 'g' fields will include the local article number if it is known, e.g. Newsgroup: news.software.nn/754 The following special symbols are recognized in the hhhheeeeaaaaddddeeeerrrr----lllliiiinnnneeeessss variable (and ignored otherwise): Preceding the identifier with an equal sign "=" or an underscore "_" will cause the header field contents to be high-lighted or underlined. A plus sign "+" will use the shading attribute defined by sssshhhhaaaaddddiiiinnnngggg----oooonnnn and sssshhhhaaaaddddiiiinnnngggg----ooooffffffff to high-light the field contents. If no shading attribute is defined it will underline the field instead. Including an asterisk "*" in the list will produce the standard one line header at that point. Example: The following setting of the hhhheeeeaaaaddddeeeerrrr----lllliiiinnnneeeessss variable will show the author (underlined), organization, posting date, and subject (high-lighted) when articles are read: set header-lines _FOD=S - 63 - Formatted: March 7, 1995 NNNNNNNN((((1111)))) NNNNNNNN((((1111)))) RRRReeeelllleeeeaaaasssseeee 6666....4444....11118888 CCCCOOOOMMMMMMMMAAAANNNNDDDD LLLLIIIINNNNEEEE OOOOPPPPTTTTIIIIOOOONNNNSSSS Some of the command line options have already been described, but below we provide a complete list of the effect of each option by showing the equivalent sssseeeetttt, uuuunnnnsssseeeetttt, or ttttoooogggggggglllleeee command. Besides the options described below, you can set _a_n_y of _n_n's variables directly on the command line via an argument of the following format: variable=value To set or unset a boolean variable, the value can be specified as _o_n or _o_f_f (_t and _f will also work). Notice that the init files are read _b_e_f_o_r_e the options are parsed (unless you use the -IIII option). Therefore, the options which are related to boolean variables set in the init file will toggle the value set there, rather than the default value. Consequently, the meaning of the options are also user- defined. The explanations below describe the effect related to the default setting of the variables, with the `reverse' effect in square brackets. -aaaa_N {sssseeeetttt lllliiiimmmmiiiitttt _N} _L_i_m_i_t the maximum number of articles presented in each group to _N. This is useful to get up-to-date quickly if you have not read news for a longer period. -aaaa0000 Mark _a_l_l unread articles as read. See the full explanation at the beginning of this manual. -BBBB {ttttoooogggggggglllleeee bbbbaaaacccckkkkuuuupppp} Do not [do] backup the rc file. -dddd {ttttoooogggggggglllleeee sssspppplllliiiitttt} Do not [do] split digests into separate articles. -ffff {ttttoooogggggggglllleeee ffffssssoooorrrrtttt} Do not [do] sort folders according to the subject (present the articles in a folder in the sequence in which they were saved). -gggg Prompt for the name of a news group or folder to be entered -iiii {ttttoooogggggggglllleeee ccccaaaasssseeee----ffffoooolllldddd----sssseeeeaaaarrrrcccchhhh} Normally searches with -nnnn and -ssss are case independent. Using this option, the case becomes significant. -IIII Do not read the init file. This must be the first option!! The global _s_e_t_u_p file is still read. -IIII_f_i_l_e-_l_i_s_t Specifies an alternate list of init files to be loaded instead of the standard global and private init files. The list is a comma-separated list of file names. Names which does not contain a `/' are looked for in the ~/.nn directory. An empty element in the list is interpreted as the global init file. The list of - 64 - Formatted: March 7, 1995 NNNNNNNN((((1111)))) NNNNNNNN((((1111)))) RRRReeeelllleeeeaaaasssseeee 6666....4444....11118888 init files must _n_o_t be separated from the ----IIII option by blanks, and it must be the first option. Example: The default behaviour corresponds to using -I,init (first the global file, then the file ~/.nn/init). The global _s_e_t_u_p file is still read as the first init file independently of the -I option used. -kkkk {ttttoooogggggggglllleeee kkkkiiiillllllll} Do not [do] perform automatic kill and selection of articles. -llll_N {sssseeeetttt ssssttttoooopppp _N} Stop after printing the first _N lines of each article. This is useful on slow terminals. -LLLL[_f] {sssseeeetttt llllaaaayyyyoooouuuutttt _f} Select alternative menu layout _f (0 to 4). If _f is omitted, menu layout 3 is selected. -mmmm {_n_o _c_o_r_r_e_s_p_o_n_d_i_n_g _v_a_r_i_a_b_l_e} Merge all articles into one `meta group' instead of showing them one group at a time. When -m is used, no articles will be marked as read. -nnnn_W_O_R_D Collect only articles which contain the string _W_O_R_D in the sender's name (case is ignored). If _W_O_R_D starts with a slash `/', the rest of the argument is used as a _r_e_g_u_l_a_r _e_x_p_r_e_s_s_i_o_n instead of a fixed string. -NNNN {_n_o _c_o_r_r_e_s_p_o_n_d_i_n_g _v_a_r_i_a_b_l_e} Disable updating of the rc file. This includes not recording that groups have been read or unsubscribed to (although _n_n will think so until you quit). -qqqq {ttttoooogggggggglllleeee ssssoooorrrrtttt} Do not [do] sort the articles (q means quick, but it isn't any quicker in practice!) -QQQQ {ttttoooogggggggglllleeee ssssiiiilllleeeennnntttt} Quiet mode - don't [do] print the logo or "No News" messages. -rrrr {ttttoooogggggggglllleeee rrrreeeeppppeeeeaaaatttt----ggggrrrroooouuuupppp----qqqquuuueeeerrrryyyy} Make -gggg repeat query for a group to enter. -ssss_W_O_R_D Collect only articles which contain the string _W_O_R_D in their subject (case is ignored). If _W_O_R_D starts with a slash `/', the rest of the argument is used as a _r_e_g_u_l_a_r _e_x_p_r_e_s_s_i_o_n instead of a fixed string. -SSSS {ttttoooogggggggglllleeee rrrreeeeppppeeeeaaaatttt} Do not [do] eliminate duplicated subject lines on menus. - 65 - Formatted: March 7, 1995 NNNNNNNN((((1111)))) NNNNNNNN((((1111)))) RRRReeeelllleeeeaaaasssseeee 6666....4444....11118888 -TTTT {ttttoooogggggggglllleeee ttttiiiimmmmeeee} Do not [do] show the current time in the prompt line. -wwww[_N] {sssseeeetttt wwwwiiiinnnnddddoooowwww _N} Reserve _N lines of the menu screen for a preview window. If _N is omitted, the preview window is set to 5 lines. -WWWW {ttttoooogggggggglllleeee ccccoooonnnnffffiiiirrrrmmmm----mmmmeeeessssssssaaaaggggeeeessss} [Don't] Wait for confirmation on all messages. -xxxx[_N] {sssseeeetttt oooolllldddd NNNN} Present (or scan) all (or the last _N) unread as well as read articles. This will _n_e_v_e_r mark unread articles as read. -XXXX {_n_o _c_o_r_r_e_s_p_o_n_d_i_n_g _v_a_r_i_a_b_l_e} Read/scan unsubscribed groups also. Most useful when looking for a specific subject in all groups, e.g. nn -mxX -sSubject all MMMMAAAACCCCRRRROOOO DDDDEEEEFFFFIIIINNNNIIIITTTTIIIIOOOONNNNSSSS Practically any combination of commands and key strokes can be defined as a macro which can be bound to a single key in menu and/or reading mode. The macro definition must specify a sequence of commands and key strokes as if they were typed directly from the keyboard. For example, a string specifying a file name must follow a save command. This manual does not give a complete specification of all the input required by the various commands; it is recommended to execute the desired command sequence from the keyboard prior to defining the macro to get the exact requirements of each command. Although it is possible to define temporary macros interactively using the ::::ddddeeeeffffiiiinnnneeee command, macro definitions are normally placed in the _i_n_i_t file. Macros are numbered from 0 to 100, i.e. it is possible to define a total of 101 different macros (implicit macros defined with the mmmmaaaapppp command uses internal numbers from 101 to 200). To define macro number _M, the following construction is used (the line breaks are mandatory): ddddeeeeffffiiiinnnneeee _M _b_o_d_y eeeennnndddd The _b_o_d_y consists of a sequence of _t_o_k_e_n_s separated by white space (blanks or newlines). However, certain _t_o_k_e_n_s continue to the end of the current line. The following _t_o_k_e_n_s may occur in the macro _b_o_d_y: _C_o_m_m_e_n_t_s Empty lines and text following a # character (preceded by white space) is ignored. _C_o_m_m_a_n_d _N_a_m_e_s Any command name listed in the key mapping section can be included in a macro causing that command to be invoked when the macro is executed. - 66 - Formatted: March 7, 1995 NNNNNNNN((((1111)))) NNNNNNNN((((1111)))) RRRReeeelllleeeeaaaasssseeee 6666....4444....11118888 _E_x_t_e_n_d_e_d _C_o_m_m_a_n_d_s All the extended commands which can be executed through the ccccoooommmmmmmmaaaannnndddd command (normally bound to the : key) can also be executed in a macro. An extended command starts with a colon (:) and continues to the end of the current line. Example: :show groups total _K_e_y _S_t_r_o_k_e_s A key stroke (which is normally mapped into a command depending on the current mode) is specified as a key name enclosed in single quotes. Examples (A-key, left arrow key, RETURN key): 'A' 'left' '^M' _S_h_e_l_l _C_o_m_m_a_n_d_s External commands can be invoked as part of a macro execution. There are two forms of shell command invocations available depending on whether a command _m_a_y produce output or require user input, or it is _g_u_a_r_a_n_t_e_e_d to complete without input or output to the terminal. The difference is that in the latter case, _n_n does not prepare the terminal to be used by another program. When the command completes, the screen is _n_o_t redrawn automatically; you should use the rrrreeeeddddrrrraaaawwww command to do that. The tho forms are: :!echo this command uses the terminal :!!echo this command does not > /tmp/file _S_t_r_i_n_g_s Input to commands prompting for a string, e.g. a file name, can be specified in a macro as a double quoted string. Example (save without prompting for a file name): ssssaaaavvvveeee----sssshhhhoooorrrrtttt "+$G" _C_o_n_d_i_t_i_o_n_a_l_s Conditionals may occur anywhere in a macro; a conditional is evaluated when the macro is executed, and if the condition is false _t_h_e _r_e_s_t _o_f _t_h_e _c_u_r_r_e_n_t _l_i_n_e _i_s _i_g_n_o_r_e_d. The following conditionals are available: ????mmmmeeeennnnuuuu True in menu mode ????sssshhhhoooowwww True in reading mode ????ffffoooollllddddeeeerrrr True when looking at a folder ????ggggrrrroooouuuupppp True when looking at a news group ????yyyyeeeessss Query user, true if answer is yes ????nnnnoooo Query user, true if answer is no Example (stop macro execution if user rejects to continue): pppprrrroooommmmpppptttt "continue? " ????nnnnoooo bbbbrrrreeeeaaaakkkk In addition to these conditionals, it is possible to test the current value of boolean and integer variables using the following form: ????_v_a_r_i_a_b_l_e====_v_a_l_u_e This conditional will be true (1) if the variable is an integer variable whose current value is the one specified, or (2) if the - 67 - Formatted: March 7, 1995 NNNNNNNN((((1111)))) NNNNNNNN((((1111)))) RRRReeeelllleeeeaaaasssseeee 6666....4444....11118888 variable is a boolean variable which is either oooonnnn or ooooffffffff. Examples: ?layout=3 :set layout 1 ?monitor=on break ?sort=off :sort age bbbbrrrreeeeaaaakkkk Terminate macro execution completely. This includes nested macros. Example (stop if looking at a folder): ????ffffoooollllddddeeeerrrr bbbbrrrreeeeaaaakkkk rrrreeeettttuuuurrrrnnnn Terminate execution of current macro. If the current macro is called from another macro, execution of that macro continues immediately. iiiinnnnppppuuuutttt Query the user for a key stroke or a string, for example a file name. Example (prompt the user for a file name in the usual way): ssssaaaavvvveeee----sssshhhhoooorrrrtttt iiiinnnnppppuuuutttt yyyyeeeessss Confirm unconditionally _i_f a command requires confirmation. It is ignored if the command does not require confirmation. Example (confirm creation of new files): ssssaaaavvvveeee----sssshhhhoooorrrrtttt "+$G" yyyyeeeessss nnnnoooo Terminate execution of current macro _i_f a command requires confirmation; otherwise ignore it. If neither yyyyeeeessss nor nnnnoooo is specified when a command requires confirmation, the user must answer the question as usual - if the user confirms the action execution continues normally; otherwise the execution of the current macro is terminated. Example (do not create new files): ssssaaaavvvveeee----sssshhhhoooorrrrtttt "+$L/misc" nnnnoooo pppprrrroooommmmpppptttt _s_t_r_i_n_g Print the _s_t_r_i_n_g in the prompt line (highlighted). The string must be enclosed in double quotes. Example: pppprrrroooommmmpppptttt "Enter recipient name" When the macro terminates, the original prompt shown on entry to the macro will automatically be redrawn. If this is not desirable (e.g. if the macro goes from selection to reading mode), the redrawing of the prompt can be disabled by using a pppprrrroooommmmpppptttt command with an empty _s_t_r_i_n_g (""). Example: pppprrrroooommmmpppptttt "Enter reading mode?" # old prompt is saved ?no return # and old prompt is restored read-skip # changes the prompt pppprrrroooommmmpppptttt "" # so forget old prompt eeeecccchhhhoooo _s_t_r_i_n_g Display the _s_t_r_i_n_g in the prompt line for a short period. - 68 - Formatted: March 7, 1995 NNNNNNNN((((1111)))) NNNNNNNN((((1111)))) RRRReeeelllleeeeaaaasssseeee 6666....4444....11118888 Example: ?show eeeecccchhhhoooo "Cannot be used in reading mode" break ppppuuuuttttssss _s_t_r_i_n_g-_t_o-_e_n_d-_o_f-_l_i_n_e The rest of the line is output directly to the terminal without interpretation. mmmmaaaaccccrrrroooo _M Invoke macro number _M. The maximum macro nesting level is five (also catches macro loops). I use the following macro to quickly save all the selected files in a file whose name is entered as usual. It also works in reading mode (saving just the current article). ddddeeeeffffiiiinnnneeee 1 :unset save-report save-short input yes ?menu '+' :set save-report eeeennnndddd KKKKEEEEYYYY MMMMAAAAPPPPPPPPIIIINNNNGGGGSSSS The descriptions of the keys and commands provided in this manual reflects the default key mappings in _n_n. However, you can easily change these mappings to match your personal demands, and it is also possible to remap keys depending on the terminal in use. Permanent remapping of keys must be done through the _i_n_i_t file, while temporary changes (for the duration of the current invocation of _n_n) can be made with the ::::mmmmaaaapppp command. The binding and mapping of keys are controlled by four tables: TTTThhhheeee mmmmuuuullllttttiiiikkkkeeeeyyyy ddddeeeeffffiiiinnnniiiittttiiiioooonnnn ttttaaaabbbblllleeee This table is used for mapping multicharacter key sequences into single characters. By default the table contains the mappings for the four cursor keys, and there is room for 10 user-defined multikeys. The fourteen multikeys are named: uuuupppp, ddddoooowwwwnnnn, rrrriiiigggghhhhtttt, lllleeeefffftttt (the four arrow keys), and ####0000 through ####9999 for the user- defined keys. Multikey #_i (where _i is a digit or an arrow key name) is defined using the following command: mmmmaaaapppp ####_i _k_e_y-_s_e_q_u_e_n_c_e where the _s_e_q_u_e_n_c_e is a list of 7-bit character names (see below) separated by spaces. For example, if the HOME key sends the sequence ESC [ H, you can define multikey #0 to be the home key using the command: map #0 ^[ [ H TTTThhhheeee iiiinnnnppppuuuutttt kkkkeeeeyyyy mmmmaaaappppppppiiiinnnngggg ttttaaaabbbblllleeee All characters that are read from the keyboard will be mapped through the input mapping table. Consequently, you can globally - 69 - Formatted: March 7, 1995 NNNNNNNN((((1111)))) NNNNNNNN((((1111)))) RRRReeeelllleeeeaaaasssseeee 6666....4444....11118888 remap one key to produce any other key value. By default all keys are mapped into themselves. An entry in the input key mapping table to map _i_n_p_u_t-_k_e_y into _n_e_w-_k_e_y is made with the command mmmmaaaapppp kkkkeeeeyyyy _i_n_p_u_t-_k_e_y _n_e_w-_k_e_y For example, to make your ESC key function as iiiinnnntttteeeerrrrrrrruuuupppptttt you can use the command map key ^[ ^G TTTThhhheeee sssseeeelllleeeeccccttttiiiioooonnnn mmmmooooddddeeee kkkkeeeeyyyy bbbbiiiinnnnddddiiiinnnngggg ttttaaaabbbblllleeee This table defines for each key which command should be invoked when that key is pressed in selection mode, i.e. when the article menu is shown. The command to bind a _k_e_y to a _c_o_m_m_a_n_d in selection mode is: mmmmaaaapppp mmmmeeeennnnuuuu _k_e_y _c_o_m_m_a_n_d For example, to have the HOME key defined as multikey #0 above bound to the sssseeeelllleeeecccctttt command, the following command is used: map menu #0 select To remap a key to select a specific article on the menu (which the `a' through `z' keys do by default), the _c_o_m_m_a_n_d must be specified as `aaaarrrrttttiiiicccclllleeee _N' where _N is the entry number on the menu counted from zero (i.e. a=0, b=1, ..., z=25, 0=26, ..., 9=35). For example, to map `J' to select article `j', the following command is used: map menu J article 9 TTTThhhheeee rrrreeeeaaaaddddiiiinnnngggg mmmmooooddddeeee kkkkeeeeyyyy bbbbiiiinnnnddddiiiinnnngggg ttttaaaabbbblllleeee This table defines for each key which command should be invoked when that key is pressed in reading mode, i.e. when the article text is shown. The command to bind a _k_e_y to a _c_o_m_m_a_n_d in reading mode is: mmmmaaaapppp sssshhhhoooowwww _k_e_y _c_o_m_m_a_n_d In addition to the direct mappings described above, the following variations of the mmmmaaaapppp command are available: UUUUsssseeeerrrr ddddeeeeffffiiiinnnneeeedddd kkkkeeeeyyyymmmmaaaappppssss Additional keymaps can be defined using the command mmmmaaaakkkkeeee mmmmaaaapppp _n_e_w_m_a_p This will create a new keymap which can initialized using normal mmmmaaaapppp commands, e.g. mmmmaaaapppp _n_e_w_m_a_p _k_e_y _c_o_m_m_a_n_d To activate a user-defined keymap, it must be bound to a _p_r_e_f_i_x _k_e_y: - 70 - Formatted: March 7, 1995 NNNNNNNN((((1111)))) NNNNNNNN((((1111)))) RRRReeeelllleeeeaaaasssseeee 6666....4444....11118888 mmmmaaaapppp _b_a_s_e-_m_a_p _p_r_e_f_i_x-_k_e_y pppprrrreeeeffffiiiixxxx _n_e_w_m_a_p When used, the prefix key itself does not activate a command, but instead it require another key to be entered and then execute the command bound to that key in the keymap which is bound to the prefix key. For example, to let the key sequence "^X i" execute macro number 10 in both modes, the following commands can be used: make map ctl-x map ctl-x i macro 10 map both ^X prefix ctl-x MMMMaaaappppppppiiiinnnngggg kkkkeeeeyyyyssss iiiinnnn bbbbooootttthhhh mmmmooooddddeeeessss Using the pseudo-keymap `both', it is possible to map a key to a command in both selection and reading mode at once. For example, to map the home key to macro number 5 in both modes, the following command can be used: map both #0 macro 5 AAAAlllliiiiaaaassssiiiinnnngggg A key can also be mapped directly to the command currently bound to another key. Later remapping of the other key will not change the mapping of the `aliased' key. This is done using the following command: map _k_e_y_m_a_p _n_e_w-_k_e_y aaaassss _o_l_d-_k_e_y BBBBiiiinnnnddddiiiinnnngggg mmmmaaaaccccrrrroooossss ttttoooo kkkkeeeeyyyyssss A previously defined macro can be bound to a key using the command: map _k_e_y_m_a_p _k_e_y mmmmaaaaccccrrrroooo _m_a_c_r_o-_n_u_m_b_e_r IIIImmmmpppplllliiiicccciiiitttt mmmmaaaaccccrrrroooo ddddeeeeffffiiiinnnniiiittttiiiioooonnnnssss An implicit macro can also be defined directly in connection with the mmmmaaaapppp command: map _k_e_y_m_a_p _k_e_y (((( _b_o_d_y... )))) Keys and character names are specified using the following notation: _C A single printable character represents the key or character itself. ^^^^_C This notation represents a control key or character. DEL is written as ^^^^???? _1_2_5, _0_1_7_5, _0_x_7_D Characters and keys can be specified by their ordinal value in decimal, octal, and hexadecimal notation. - 71 - Formatted: March 7, 1995 NNNNNNNN((((1111)))) NNNNNNNN((((1111)))) RRRReeeelllleeeeaaaasssseeee 6666....4444....11118888 uuuupppp, ddddoooowwwwnnnn, rrrriiiigggghhhhtttt, lllleeeefffftttt These names represent the cursor keys. ####0000 through ####9999 These symbols represent the ten user-defined multikeys. If the variable ddddaaaattttaaaa----bbbbiiiittttssss is 7, key maps can specify binding of all keys in the range 0x00 to 0x7F, and the 8th bit will be stripped in all keyboard input. If the variable ddddaaaattttaaaa----bbbbiiiittttssss is 8, the 8th bit is not cleared, and key maps are extended to allow binding of keys in the range 0xA0 to 0xFE (corresponding to the national characters defined by the ISO 8859 character sets). Binding commands to these keys can be done either by using their numeric value, or directly specifying the 8 bit character in the map command, e.g. map menu 0xC8 macro 72 map key 'e % To show the current contents of the four tables, the following versions of the ::::mmmmaaaapppp command are available: ::::mmmmaaaapppp Show the current mode's key bindings. ::::mmmmaaaapppp mmmmeeeennnnuuuu Show the selection mode key bindings. ::::mmmmaaaapppp sssshhhhoooowwww Show the reading mode key bindings. ::::mmmmaaaapppp #### Show the multikey definition table. ::::mmmmaaaapppp kkkkeeeeyyyy Show the input key mapping table. SSSSTTTTAAAANNNNDDDDAAAARRRRDDDD KKKKEEEEYYYY BBBBIIIINNNNDDDDIIIINNNNGGGGSSSS Below is a list of all the commands that can be bound to keys, either in selection mode, in reading mode, or both. For each command the default command key bindings in both modes are shown. If the key is not bound in one of the modes, but it can be bound, the corresponding part will just be empty. If the command cannot be bound in one of the modes, that mode will contain the word nnnniiiixxxx. _F_u_n_c_t_i_o_n _S_e_l_e_c_t_i_o_n _m_o_d_e _R_e_a_d_i_n_g _m_o_d_e aaaaddddvvvvaaaannnncccceeee----aaaarrrrttttiiiicccclllleeee nnnniiiixxxx a aaaaddddvvvvaaaannnncccceeee----ggggrrrroooouuuupppp A A aaaarrrrttttiiiicccclllleeee _N a-z0-9 nnnniiiixxxx bbbbaaaacccckkkk----aaaarrrrttttiiiicccclllleeee nnnniiiixxxx b bbbbaaaacccckkkk----ggggrrrroooouuuupppp B B ccccaaaannnncccceeeellll C C ccccoooommmmmmmmaaaannnndddd : : ccccoooommmmpppprrrreeeessssssss nnnniiiixxxx c ccccoooonnnnttttiiiinnnnuuuueeee ssssppppaaaacccceeee ssssppppaaaacccceeee ccccoooonnnnttttiiiinnnnuuuueeee----nnnnoooo----mmmmaaaarrrrkkkk rrrreeeettttuuuurrrrnnnn nnnniiiixxxx - 72 - Formatted: March 7, 1995 NNNNNNNN((((1111)))) NNNNNNNN((((1111)))) RRRReeeelllleeeeaaaasssseeee 6666....4444....11118888 ddddeeeeccccooooddddeeee ffffiiiinnnndddd = / ffffiiiinnnndddd----nnnneeeexxxxtttt nnnniiiixxxx . ffffoooolllllllloooowwww F fF ffffuuuullllllll----ddddiiiiggggeeeesssstttt nnnniiiixxxx H ggggoooottttoooo----ggggrrrroooouuuupppp G G ggggoooottttoooo----mmmmeeeennnnuuuu nnnniiiixxxx = Z hhhheeeellllpppp ? ? jjjjuuuunnnnkkkk----aaaarrrrttttiiiicccclllleeeessss J nnnniiiixxxx kkkkiiiillllllll----sssseeeelllleeeecccctttt K K llllaaaayyyyoooouuuutttt " nnnniiiixxxx lllleeeeaaaavvvveeee----aaaarrrrttttiiiicccclllleeee nnnniiiixxxx l lllleeeeaaaavvvveeee----nnnneeeexxxxtttt L L lllliiiinnnneeee++++1111 , ddddoooowwwwnnnn rrrreeeettttuuuurrrrnnnn lllliiiinnnneeee----1111 / nnnniiiixxxx lllliiiinnnneeee====@@@@ nnnniiiixxxx g mmmmaaaaccccrrrroooo _M mmmmaaaaiiiillll M m M mmmmeeeessssssssaaaaggggeeee ^P ^P nnnneeeexxxxtttt----aaaarrrrttttiiiicccclllleeee nnnniiiixxxx n nnnneeeexxxxtttt----ggggrrrroooouuuupppp N N nnnneeeexxxxtttt----ssssuuuubbbbjjjjeeeecccctttt nnnniiiixxxx k nnnniiiillll oooovvvveeeerrrrvvvviiiieeeewwww Y Y ppppaaaaggggeeee++++1111 > nnnniiiixxxx ppppaaaaggggeeee++++1111////2222 nnnniiiixxxx d ppppaaaaggggeeee----1111 < ddddeeeelllleeeetttteeee bbbbaaaacccckkkkssssppppaaaacccceeee ppppaaaaggggeeee----1111////2222 nnnniiiixxxx u ppppaaaaggggeeee====0000 nnnniiiixxxx h ppppaaaaggggeeee====1111 ^ ^ ppppaaaaggggeeee====$$$$ $ $ ppppaaaattttcccchhhh ppppoooosssstttt pppprrrreeeevvvviiiieeeewwww % % pppprrrreeeevvvviiiioooouuuussss P p pppprrrriiiinnnntttt P qqqquuuuiiiitttt Q Q rrrreeeeaaaadddd----rrrreeeettttuuuurrrrnnnn Z nnnniiiixxxx rrrreeeeaaaadddd----sssskkkkiiiipppp X X rrrreeeeddddrrrraaaawwww ^L ^R ^L ^R rrrreeeeppppllllyyyy R r R rrrrooootttt11113333 nnnniiiixxxx D ssssaaaavvvveeee----bbbbooooddddyyyy W w W ssssaaaavvvveeee----ffffuuuullllllll S s S ssssaaaavvvveeee----sssshhhhoooorrrrtttt O o O sssseeeelllleeeecccctttt . nnnniiiixxxx sssseeeelllleeeecccctttt----aaaauuuuttttoooo + nnnniiiixxxx sssseeeelllleeeecccctttt----iiiinnnnvvvveeeerrrrtttt @ nnnniiiixxxx sssseeeelllleeeecccctttt----rrrraaaannnnggggeeee - nnnniiiixxxx sssseeeelllleeeecccctttt----ssssuuuubbbbjjjjeeeecccctttt * * sssshhhheeeellllllll ! ! - 73 - Formatted: March 7, 1995 NNNNNNNN((((1111)))) NNNNNNNN((((1111)))) RRRReeeelllleeeeaaaasssseeee 6666....4444....11118888 sssskkkkiiiipppp----lllliiiinnnneeeessss nnnniiiixxxx ttttaaaabbbb uuuunnnnsssseeeelllleeeecccctttt----aaaallllllll ~ nnnniiiixxxx uuuunnnnsssshhhhaaaarrrr uuuunnnnssssuuuubbbb U U vvvveeeerrrrssssiiiioooonnnn V V See the descriptions of the default bindings for a description of the commands. The pseudo command nnnniiiillll is used to _u_n_b_i_n_d a key. TTTTHHHHEEEE IIIINNNNIIIITTTT FFFFIIIILLLLEEEESSSS The _i_n_i_t files are used to customize _n_n's behaviour to local conventions and restrictions and to satisfy each user's personal taste. Normally, _n_n reads upto three init files on start-up if they exist (all init files are optional): $LIB/sssseeeettttuuuupppp A system-wide file located in the library directory. This file is _a_l_w_a_y_s loaded before any other init file (even when the -IIII option is specified). It cannot contain a group presentation sequence. $LIB/iiiinnnniiiitttt Another system-wide (global) init file located in the library directory. This file may be ignored via the -IIII option. ~/.nn/iiiinnnniiiitttt The private init file located in the user's ._n_n directory. It is read after the global init file to allow the user to change the default setup. The init file is parsed one line at a time. If a line ends with a backslash `\', the backslash is ignored, and the following line is appended to the current line. The init file may contain the following types of commands (and data): CCCCoooommmmmmmmeeeennnnttttssss Empty lines and lines with a # character as the first non-blank character are ignored. Except where # has another meaning defined by the command syntax (e.g. multi-keys are named #_n), trailing comments on input lines are ignored. VVVVaaaarrrriiiiaaaabbbblllleeee sssseeeettttttttiiiinnnnggggssss You can sssseeeetttt (or uuuunnnnsssseeeetttt) all the variables described earlier to change nn's behaviour permanently. The sssseeeetttt and uuuunnnnsssseeeetttt commands you can use in the init file have exactly the same format as the ::::sssseeeetttt and ::::uuuunnnnsssseeeetttt commands described earlier (except that the : prefix is omitted.) Variables can also be locked via the lllloooocccckkkk command; this is typically done in the _s_e_t_u_p file to enforce local policies. KKKKeeeeyyyy mmmmaaaappppppppiiiinnnnggggssss You can use all the versions of the mmmmaaaapppp command in the init file. - 74 - Formatted: March 7, 1995 NNNNNNNN((((1111)))) NNNNNNNN((((1111)))) RRRReeeelllleeeeaaaasssseeee 6666....4444....11118888 MMMMaaaaccccrrrroooo DDDDeeeeffffiiiinnnniiiittttiiiioooonnnnssss You can define sequences of commands and key strokes using the ddddeeeeffffiiiinnnneeee...eeeennnndddd construction, which can then be bound to single keys with the mmmmaaaapppp command. LLLLooooaaaadddd tttteeeerrrrmmmmiiiinnnnaaaallll ssssppppeeeecccciiiiffffiiiicccc ffffiiiilllleeeessss You can load a terminal specific file using the llllooooaaaadddd _f_i_l_e The character @@@@ in the _f_i_l_e will be replaced by the terminal type defined in the TERM environment variable. _n_n silently ignores the llllooooaaaadddd command if the file does not exist (so you don't have to have a specific init file for terminals which does not require remapping). If the file is not specified by an absolute pathname, it must reside in your ~/.nn directory. Examples: # load local customizations load /usr/lib/nninit # load personal terminal specific customizations load init.@ SSSSwwwwiiiittttcccchhhh ttttoooo llllooooaaaaddddiiiinnnngggg aaaa ddddiiiiffffffffeeeerrrreeeennnntttt iiiinnnniiiitttt You can skip the rest of the current init file and start loading a different init file with the following command: cccchhhhaaaaiiiinnnn _f_i_l_e If this occur in the private or global init file, the chained init file may contain a sequence part which will replace the private or global presentation sequence respectively. SSSSttttoooopppp llllooooaaaaddddiiiinnnngggg ccccuuuurrrrrrrreeeennnntttt iiiinnnniiiitttt ffffiiiilllleeee You can skip the rest of the current init file with the following command: ssssttttoooopppp GGGGiiiivvvveeee eeeerrrrrrrroooorrrr mmmmeeeessssssssaaaaggggeeeessss aaaannnndddd////oooorrrr tttteeeerrrrmmmmiiiinnnnaaaatttteeee If an error is detected in the init file, the following commands can be used to print an error message and/or terminate execution: eeeerrrrrrrroooorrrr _f_a_t_a_l _e_r_r_o_r _m_e_s_s_a_g_e... Print the message and terminate execution. eeeecccchhhhoooo _w_a_r_n_i_n_g _m_e_s_s_a_g_e... Print the message and continue. eeeexxxxiiiitttt [ _s_t_a_t_u_s ] Terminate _n_n with the specified exit status or 0 if omitted. CCCChhhhaaaannnnggggeeee wwwwoooorrrrkkkkiiiinnnngggg ddddiiiirrrreeeeccccttttoooorrrryyyy ooooffff nnnnnnnn You can use the ccccdddd command to change the working directory whenever you enter _n_n. Example: # Use folder directory as working directory inside _n_n cd ~/News - 75 - Formatted: March 7, 1995 NNNNNNNN((((1111)))) NNNNNNNN((((1111)))) RRRReeeelllleeeeaaaasssseeee 6666....4444....11118888 CCCCoooommmmmmmmaaaannnndddd ggggrrrroooouuuuppppssss The init file can contain groups of commands which are executed under special conditions. The command groups are described in the section on command groups below. OOOOnnnneeee oooorrrr mmmmoooorrrreeee ssssaaaavvvveeee----ffffiiiilllleeeessss sssseeeeccccttttiiiioooonnnnssss A ssssaaaavvvveeee----ffffiiiilllleeeessss section is used to assign default save files to specific groups: ssssaaaavvvveeee----ffffiiiilllleeeessss _g_r_o_u_p-_n_a_m_e (_p_a_t_t_e_r_n) _f_i_l_e-_n_a_m_e ... eeeennnndddd The group name (patterns) and save file names are specified in the same way as in the presentation sequence (see below). Example: ssssaaaavvvveeee----ffffiiiilllleeeessss news* +news/$L comp.sources* /u/src/$L/ eeeennnndddd TTTThhhheeee nnnneeeewwwwssss ggggrrrroooouuuupppp pppprrrreeeesssseeeennnnttttaaaattttiiiioooonnnn sssseeeeqqqquuuueeeennnncccceeee The _l_a_s_t part of the init file may specify the sequence in which you want the news groups to be presented. This part starts with the command sssseeeeqqqquuuueeeennnncccceeee and continues to the end of the init file. Both init files may contain a presentation sequence. In this case, the global sequence is _a_p_p_e_n_d_e_d to the private sequence. CCCCOOOOMMMMMMMMAAAANNNNDDDD GGGGRRRROOOOUUUUPPPPSSSS Command groups may only occur in the init file, and they provide a way to have series of commands executed at certain points during news reading. In release 6.4, these possibilities are still rather rudimentary, and a mixture of normal init file syntax and macro syntax is used depending on whether the command group is only executed on start-up or several times during the _n_n session. A command group begins with the word oooonnnn and ends with the word eeeennnndddd. The following command groups are conditionally executed during the parsing of the init file if the specified _c_o_n_d_i_t_i_o_n is true. They may also have an optional eeeellllsssseeee part which is executed if the _c_o_n_d_i_t_i_o_n is false: oooonnnn _c_o_n_d_i_t_i_o_n commands [ eeeellllsssseeee commands ] eeeennnndddd The following conditional command groups may be used in the init file to be executed at start-up: oooonnnn [[[[ _t_e_s_t ]]]] The commands (init file syntax) in the group are executed only if the specified _t_e_s_t is true. A shell is spawned to execute the - 76 - Formatted: March 7, 1995 NNNNNNNN((((1111)))) NNNNNNNN((((1111)))) RRRReeeelllleeeeaaaasssseeee 6666....4444....11118888 command "[ _t_e_s_t ]", so all the options of the tttteeeesssstttt(1) command is available. For example, to unset the flow-control variable if the tty is a pseudo-tty, the following conditional can be used: on [ -n "`tty | grep ttyp`" ] unset flow-control end oooonnnn !!!!_s_h_e_l_l _c_o_m_m_a_n_d The command group is executed if the given _s_h_e_l_l _c_o_m_m_a_n_d exits with 0 status (success). Care should be taken that the command does not produce any output, e.g. by redirecting its output to /dev/null. For example, to prevent people from reading news if load is above a specific level, the following conditional might be placed in the global setup file. on !load-above 5 error load is too high, try again later. end oooonnnn ````_s_h_e_l_l _c_o_m_m_a_n_d```` _s_t_r_i_n_g... The command group is executed if the _f_i_r_s_t _o_u_t_p_u_t _l_i_n_e from executing the specified _s_h_e_l_l _c_o_m_m_a_n_d is listed among the specified _s_t_r_i_n_g values. The _s_h_e_l_l _c_o_m_m_a_n_d can be omitted on subsequent occurrences of this conditional, in which case the output from the last sssshhhheeeellllllll ccccoooommmmmmmmaaaannnndddd is used. For example, the following conditional can be used to switch to an init file which has a limited sequence for news reading during working hours, evenings, and nights: on `date +%H` 9 10 11 12 13 14 15 16 chain init.work end on `` 17 18 19 20 21 chain init.evening else chain init.night end oooonnnn ```````` _s_t_r_i_n_g... This is equivalent to the previous form except that instead of executing a shell command, the output from the previous oooonnnn $$$$_v_a_r_i_a_b_l_e [ _v_a_l_u_e ] If no _v_a_l_u_e strings are specified, the command group is executed if the given _v_a_r_i_a_b_l_e is defined in the environment. Otherwise, the command group is executed only if the value of the _v_a_r_i_a_b_l_e occur in the _v_a_l_u_e list. For example, if you want _n_n to look for mail in whatever $MAIL is set to - if it is set - you can use the following code: on $MAIL set mail $(MAIL) end - 77 - Formatted: March 7, 1995 NNNNNNNN((((1111)))) NNNNNNNN((((1111)))) RRRReeeelllleeeeaaaasssseeee 6666....4444....11118888 oooonnnn sssslllloooowwww The commands (init file syntax) in the group are executed only if the current terminal output speed is less than or equal to the baud rate set in the sssslllloooowwww----ssssppppeeeeeeeedddd variable. This can be used to optimize the user-interface for slow terminals by setting suitable variables: oooonnnn sssslllloooowwww set confirm-entry set slow-mode set delay-redraw unset visible-bell set compress unset header-lines set stop 5 set window 10 eeeennnndddd oooonnnn ffffaaaasssstttt Same as oooonnnn sssslllloooowwww except that the commands are only executed when the terminal is running at a speed above the sssslllloooowwww----ssssppppeeeeeeeedddd value. oooonnnn tttteeeerrrrmmmm _t_e_r_m-_t_y_p_e... The commands are executed if one of the _t_e_r_m-_t_y_p_e names is identical to value of the TERM environment variable. oooonnnn hhhhoooosssstttt _h_o_s_t-_n_a_m_e... The commands are executed if the local host's name occur in the _h_o_s_t-_n_a_m_e list. oooonnnn pppprrrrooooggggrrrraaaammmm _p_r_o_g_r_a_m-_n_a_m_e... The commands are executed if the current program (_n_n, _n_n_c_h_e_c_k, etc) in the _p_r_o_g_r_a_m-_n_a_m_e list. The following oooonnnn command groups are really macros which may be executed during _n_n's normal processing, and as such they cannot have an eeeellllsssseeee part. oooonnnn eeeennnnttttrrrryyyy [ _g_r_o_u_p _l_i_s_t ] These commands (macro format!) are executed every time _n_n enters a news group. If a group list is not specified, the commands are associated with all groups which don't have its own entry macro specified in the group sequence. Otherwise, the entry macro will be associated with the groups in the list. The group list is specified using the meta-notations described in the presentation sequence section. _A_l_l `:' commands at the beginning of the command group are executed _b_e_f_o_r_e _n_n collects the articles in the group, so it is possible to set or unset variables like ccccrrrroooossssssss----ppppoooosssstttt and aaaauuuuttttoooo---- rrrreeeeaaaadddd----mmmmooooddddeeee before any articles are collected and the menu is (not) shown. The non-`:' commands, and `:' commands that follows a command of another type will be executed immediately _a_f_t_e_r the first menu - 78 - Formatted: March 7, 1995 NNNNNNNN((((1111)))) NNNNNNNN((((1111)))) RRRReeeelllleeeeaaaasssseeee 6666....4444....11118888 page is presented. The execution of a `:' command can be postponed by using a double `::' as the command prefix. oooonnnn eeeennnnttttrrrryyyy comp.sources* alt.sources :set cross-post on # set before collection :local auto-read-mode on # set before showing menu ::unset cross-post # set after collection eeeennnndddd oooonnnn ssssttttaaaarrrrtttt----uuuupppp These `:' commands (macro format!) are executed on start-up just before _n_n enters the first news group. However, postponed commands (i.e. non-`:' commands) will not be executed until the first group is shown (it works like an entry macro). GGGGRRRROOOOUUUUPPPP PPPPRRRREEEESSSSEEEENNNNTTTTAAAATTTTIIIIOOOONNNN SSSSEEEEQQQQUUUUEEEENNNNCCCCEEEE News groups are normally presented in the sequence defined in the system-wide iiiinnnniiiitttt file in _n_n's library directory. You can personalize the presentation sequence by specifying an alternative sequence in the private _i_n_i_t file. The sequence in the private init file is used _b_e_f_o_r_e the global presentation sequence, and need only describe the deviations from the default presentation sequence. The presentation sequence must start with the word sssseeeeqqqquuuueeeennnncccceeee followed by a list of the news group names in the order you want them to be presented. The group names must be separated by white space. The sequence list must be the _l_a_s_t part of the init file (the parsing of commands from the init file stops when the word sssseeeeqqqquuuueeeennnncccceeee is encountered). You may use a full group name like "comp.unix.questions", or just the name of a main group or subgroup, e.g. "comp" or "comp.unix". However, if "comp" precedes "comp.unix.questions" in the list, this subgroup will be placed in the normal alphabetic sequence during the collection of all the "comp" groups. Groups which are not explicitly mentioned in any of the sequence files will be placed after the mentioned groups, unless `!!' is used and it has not been disabled (as described below). Each group name may be followed by a file or folder name (must start with either of `/' `~' or `+') which will specify the default save file for that group (and its subgroups). A single `+' following the group name is an abbreviation for the last save file name used. For example, the following two sequences are equivalent: group1 +file group2 +file group3 +file group1 +file group2 + group3 + When an article is saved, the default save name will be used as the initial contents of the file name prompt for further editing. It therefore does not need to be be a complete file name (unless you use the quick save mode). Each group name may also be associated with a so-called eeeennnnttttrrrryyyy aaaaccccttttiiiioooonnnn. This is basically an (unnamed) macro which is invoked on entry to the group (following the same rules as the `on entry' command group related to :set and :unset commands). The entry action begins with a left parenthesis `((((' and ends with a right parenthesis `))))' on an otherwise - 79 - Formatted: March 7, 1995 NNNNNNNN((((1111)))) NNNNNNNN((((1111)))) RRRReeeelllleeeeaaaasssseeee 6666....4444....11118888 empty line: comp.sources. +src/$L/ ( :set cross-post ) The last entry action can be repeated by specifying an empty set of parenthesis, e.g. comp.unix. +unix () The entry action of a preceding group in the sequence can be associated with the current group(s) by specifying the name of the group in the parentheses instead of the commands, e.g. comp.unix. +unix (comp.sources.unix) A macro can also be associated with the entry action by specifying its number in the same way as the group name above, e.g. rec.music. +music (30) Notice that it is the _c_u_r_r_e_n_t definition of the macro which is associated with the group, so if the macro is later redefined with the `:define' command, it will not have any effect on the entry action. Group names can be specified using the following notations: group.name Append the group (if it exists) to the presentation sequence list. If aaaallllssssoooo----ssssuuuubbbbggggrrrroooouuuuppppssss is set (default), all subscribed subgroups of the group will be included as well (if there are any). Examples: "comp", "comp.unix", "comp.unix.questions". If the group does not exits (e.g. "comp"), the subgroups will be included even when aaaallllssssoooo----ssssuuuubbbbggggrrrroooouuuuppppssss is not set, i.e. "comp" is equivalent to "comp.". group.name. Append the subgroups of the specified group to the presentation sequence. The group itself (if it exists) is not included. Examples: "comp.", "comp.unix.". Append the groups whose name ends with the specified name to the sequence. Example: ".test". group.name* Append the group and its subgroups to the presentation sequence list (even when aaaallllssssoooo----ssssuuuubbbbggggrrrroooouuuuppppssss is not set). Example: "comp.unix*". The following meta notation can be used in a sequence file. The group.name can be specified using any of the forms described above: ! groups Completely ignore the group or groups specified unless they are already in the presentation sequence (i.e. has been explicitly mentioned earlier in the sequence). - 80 - Formatted: March 7, 1995 NNNNNNNN((((1111)))) NNNNNNNN((((1111)))) RRRReeeelllleeeeaaaasssseeee 6666....4444....11118888 !:_c_o_d_e groups Ignore a selection of groups based on the given _c_o_d_e letter (see below), unless they are already included in the sequence. Notice that these forms _o_n_l_y excludes groups from the presentation sequence, i.e. they _d_o _n_o_t include the remaining groups at this point; that must be done explicitly elsewhere. !:U groups Ignore unsubscribed groups, i.e. if they are neither new, nor present and subscribed in .newsrc. This is useful to ignore a whole hierarchy except for a few groups which are explicitly mentioned in .newsrc and still see new groups as they are created. !:X groups Ignore unsubscribed _a_n_d new groups, i.e. if they are not currently present and subscribed in .newsrc. This is useful to ignore a whole hierarchy except for a few groups which are explicitly mentioned in .newsrc. New groups in the hierarchy are ignored unless `NEW' occurs earlier in the sequence. !:O groups Ignore old groups, i.e. _u_n_l_e_s_s they are new. This is useful to ignore a whole hierarchy but still see new groups which are created in the hierarchy (it might become interesting some day). Individual groups can still be included in the sequence if they are specified before the `!:O' entry. !:N groups Ignore new groups in the hierarchy. !! Stop building the presentation sequence. This eliminates all groups that are not already in the presentation sequence. NNNNEEEEWWWW This is a pseudo group name which matches all _n_e_w groups; you could place this symbol early in your presentation sequence to see new groups `out of sequence' (to attract your attention to them). RRRRCCCC This is a pseudo group name which matches all groups occurring in the .newsrc file. It will cause the groups in .newsrc to be appended to the presentation sequence in the sequence in which they are listed in .newsrc. RRRRCCCC::::_n_u_m_b_e_r Similar to the RRRRCCCC entry, but limited to the first _n_u_m_b_e_r lines of the .newsrc file. Example: RC:10 (use 10 lines of .newsrc). RRRRCCCC::::_s_t_r_i_n_g Similar to the RRRRCCCC entry, but limited to the lines up to (and including) the first line (i.e. group) starting with the given - 81 - Formatted: March 7, 1995 NNNNNNNN((((1111)))) NNNNNNNN((((1111)))) RRRReeeelllleeeeaaaasssseeee 6666....4444....11118888 _s_t_r_i_n_g. For example: RC:alt.sources < group.name Place the group (and its subgroups) at the beginning of the presentation sequence. Notice that each `<' entry will place the group(s) at the beginning of the current sequence, i.e. < A < B < C will generate the sequence C B A. > group.name Place the group (and its subgroups) after all other groups that are and will be entered into the presentation sequence. @ Disable the `!!' command. This can be included in the personal presentation sequence if the global sssseeeeqqqquuuueeeennnncccceeee file contains a !! entry (see example 1 below). % .... % Starts and ends a region of the sequence where it is possible to include groups which has been eliminated earlier. This may be useful to alter the sequence of some groups, e.g. to place comp.sources.bugs after all other source groups, the following sequence can be used: ! comp.sources.bugs comp.sources* % comp.sources.bugs % EEEExxxxaaaammmmpppplllleeee 1111:::: In a company where ordinary users only should read the local news groups, and ignore the rest (including new news groups which are otherwise always subscribed to initially), can use the following global presentation sequence: general follow ! local.test local !! The "expert" users in the company must put the @@@@ command somewhere in their private sequence to avoid losing news groups which they have not explicitly mentioned in their init file. EEEExxxxaaaammmmpppplllleeee 2222:::: This is the global sequence for systems with heavy news addicts who setup their own sequences anyway. # all must read the general news first < general # test is test, and junk is junk, # so it is placed at the very end > test > .test > junk # this is the standard sequence which everybody may # change to their own liking - 82 - Formatted: March 7, 1995 NNNNNNNN((((1111)))) NNNNNNNN((((1111)))) RRRReeeelllleeeeaaaasssseeee 6666....4444....11118888 local # our local groups dk # the Danish groups eunet.general # to present it before eunet.followup eunet # the other European groups comp # the serious groups news # news on news sci # other serious groups rec # not really that important (don't quote me) misc # well, it must be somewhere # the groups that are not listed above goes here Notice the use of comments in the sequence where they are allowed at the end of non-empty lines as well. EEEExxxxaaaammmmpppplllleeee 3333:::: My own presentation sequence (in the init file) simply lists my favourite groups and the corresponding default save files: sssseeeeqqqquuuueeeennnncccceeee !:U alt* # ignore unsubscribed alt groups news.software.nn +nn comp.sys.ti* +ti/$L NEW # show new groups here news* rec.music.synth +synth/ comp.emacs*,gnu.emacs +emacs/misc comp.risks +risks eunet.sources +src/unix/ comp.sources* +src/$L/ The presentation sequence is not used when _n_n is called with one or more news group names on the command line; it is thus possible to read ignored groups (on explicit request) wihtout changing the init file. (Of course, you can also use the GGGG command to read ignored groups). MMMMEEEERRRRGGGGIIIINNNNGGGG NNNNEEEEWWWWSSSS GGGGRRRROOOOUUUUPPPPSSSS The third example above contains the following line: comp.emacs*,gnu.emacs +emacs/misc This is the syntax used to _m_e_r_g_e groups. When two or more groups are merged, all new articles in these groups are presented together as if they were one group. To merge groups, their names must be listed together in the sequence, and only separated by a single comma. To merge the groups resulting from a single group pattern (e.g. comp.emacs*), the group pattern must be followed by a comma and a blank (e.g. comp.emacs*, ...). Merged groups are presented as the first group in the "list", and the word "MERGED" will be shown after the group name. The YYYY {oooovvvveeeerrrrvvvviiiieeeewwww} command will still show merged groups as individual groups, but they will be annotated with the symbol `&' on the first of the groups, and a `+' on the rest of the groups. In the current version, the concept of the _c_u_r_r_e_n_t _g_r_o_u_p in - 83 - Formatted: March 7, 1995 NNNNNNNN((((1111)))) NNNNNNNN((((1111)))) RRRReeeelllleeeeaaaasssseeee 6666....4444....11118888 connection with merged groups is a bit fuzzy. This should only be noticeable with the GGGG command, which will take the most recently used group among the merged groups as the current group. So things like GGGG ==== ............ may not always work as expected. EEEENNNNVVVVIIIIRRRROOOONNNNMMMMEEEENNNNTTTT The following environment variables are used by _n_n: EEEEDDDDIIIITTTTOOOORRRR. The editor invoked when editing replies, follow-ups, and composing mail. _n_n knows about the following editors: _v_i, _d_e_d, _G_N_U _e_m_a_c_s, and _m_i_c_r_o- _e_m_a_c_s, and will try to position the cursor on the first line following the header, i.e. after the blank line which must not be deleted! If an article has been included, the cursor is placed on the first line of the included text (to allow you to delete sections easily). LLLLOOOOGGGGNNNNAAAAMMMMEEEE. This is taken as the login name of the current user. It is used by _n_n to return failed mail. If it is not defined, _n_n will use the value of USER, or if that is not defined either, _n_n will use the call `who am i' to get this information. If all attempts fail, the failed mail is dropped in the bit bucket. PPPPAAAAGGGGEEEERRRR. This is used as the initial value of the ppppaaaaggggeeeerrrr variable. SSSSHHHHEEEELLLLLLLL. This is the shell which is spawned if the system cannot suspend _n_n, and it will be used to execute the shell escapes. TTTTEEEERRRRMMMM. The terminal type. FFFFIIIILLLLEEEESSSS ~/.newsrc The record of read articles. ~/.nn/select The record of selected and seen articles. ~/.nn/init Personal configuration and presentation sequence. ~/.nn/kill The automatic kills and selections. ~/.nn/KILL.COMP The compiled kill file. ~/.nn/LAST The time stamp of the last news group we have seen. ~/.nn/NEXTG Active group last time _n_n was quit. ~/.nn/.param Parameter file for the aux script $lib/setup System-wide setup - always read first. $lib/init System-wide setup and presentation sequence. $lib/aux The response edit and send script. $lib/routes Mapping rules for mail addresses (on non-domain systems). $db/* The news data base. /etc/termcap Terminal data base [BSD]. /usr/lib/terminfo/*Terminal data base [SysV]. /usr/lib/nntp-serverName of remote nntp server. The name $lib and $db are the directories used for the auxiliary files and the news data base respectively. Their name and location is defined at compile time. Common choices are /usr/local/lib/nn or /usr/lib/news/nn for $lib and /usr/spool/nn or /usr/spool/news/.nn for $db. SSSSEEEEEEEE AAAALLLLSSSSOOOO Other netnews documentation. nncheck(1), nngoback(1), nngrab(1), nngrep(1), nnpost(1), nntidy(1) nnadmin(1M), nnusage(1M), nnmaster(8), nnspew(8) - 84 - Formatted: March 7, 1995 NNNNNNNN((((1111)))) NNNNNNNN((((1111)))) RRRReeeelllleeeeaaaasssseeee 6666....4444....11118888 AAAAUUUUTTTTHHHHOOOORRRR Kim F. Storm, Texas Instruments A/S, Denmark E-mail: storm@texas.dk (but see the addresses below) The NNTP support was designed and implemented by Ren'e Seindal, Institute of Datalogy, University of Copenhagen, Denmark. Bugs and fixes, suggestions, ideas, critique, etc. can be sent to the following address: nn-bugs@dkuug.dk The news.software.nn group is used for discussion on all subjects related to the nn news reader. This includes, but is not limited to, questions, answers, ideas, hints, information from the development group, patches, etc. - 85 - Formatted: March 7, 1995