Usenet 1994 January

home *** CD-ROM | disk | FTP | other *** search

/ Usenet 1994 January / usenetsourcesnewsgroupsinfomagicjanuary1994.iso / sources / unix / volume19 / nn / part08 < prev next >

Wrap

Internet Message Format | 1989-06-22 | 48.8 KB

Subject: v19i069: NN, a Usenet news reader, Part08/15 Newsgroups: comp.sources.unix Sender: sources Approved: rsalz@uunet.UU.NET Submitted-by: storm@texas.dk (Kim F. Storm) Posting-number: Volume 19, Issue 69 Archive-name: nn/part08 #!/bin/sh # this is part 8 of a multipart archive # do not concatenate these parts, unpack them in order with /bin/sh # file more.c continued # CurArch=8 if test ! -r s2_seq_.tmp then echo "Please unpack part 1 first!" exit 1; fi ( read Scheck if test "$Scheck" != $CurArch then echo "Please unpack part $Scheck next!" exit 1; else exit 0; fi ) < s2_seq_.tmp || exit 1 echo "x - Continuing file more.c" sed 's/^X//' << 'NO_NEWS_IS_GOOD_NEWS' >> more.c X match_lines = 1; X if (linenum > match_botline) { X match_redraw = 0; X linenum -= 5; X goto next_page; X } X match_redraw = (stop_line < 0); X stop_line = -1; X lno = lno1 + linenum - topline - 1; X print_lines = window_lines - lno + lno1; X } X X /* now print the line */ X X if (match_lines && underline_line != linenum && X regexec(regular_expr, linebuf)) { X match_start = regular_expr->startp[0]; X match_end = regular_expr->endp[0]; X } else { X if (match_redraw) goto no_print; X match_start = NULL; X } X X gotoxy(0, lno); X X if (mark_overlap && underline_line == linenum) X if (!underline(1)) X fake_underline = 1; X skip_spaces = has_space = 0; X X for (lp = linebuf; c = *lp; lp++) { X X if (match_start) { X if (lp == match_start) highlight(1); X if (lp == match_end) { X highlight(0); X match_start = NULL; X if (match_redraw) goto no_print; X } X } X X if (c == SP) { X if (skip_spaces) { X if (has_space) continue; X has_space++; X } X if (fake_underline) c = '_'; X } else { X if (compress_space && c != ' ') { X skip_spaces = 1; X has_space = 0; X } X if (rot13) c = rot13tab[c]; X } X X putchar(c); X } X X if (match_start) highlight(0); X X if (mark_overlap && underline_line == linenum) { X while (lp - linebuf < 10) { X putchar(fake_underline ? '_' : ' '); X lp++; X } X underline(0); X underline_line = -1; X fake_underline = 0; X } X Xno_print: X X ++lno; X if (--print_lines > 0 && s_keyboard == 0 && form_feed == 0) goto next_line; X X if (!eof && linenum >= maxline) { X if (ignore_nl) { X c = getc(art); X if (c == EOF) X eof++; X else if (c != NL) X ungetc(c, art); X else X ignore_nl = 0; X } X X if (!eof && ftell(art) >= ah->lpos) eof++; X } X X match_redraw = 0; X X Prompt: X X raw(); X X prompt_line = lno; X X dflt_prompt: X X prompt(pr_fmt, X pct((long)(ah->fpos), (long)(ah->lpos), X (long)(linepos[topline]), (long)ftell(art))); X X if (delayed_msg != NULL) { X msg(delayed_msg); X delayed_msg = NULL; X } X X same_prompt: X X if ((c = get_c()) & GETC_COMMAND) X c &= ~GETC_COMMAND; X else X c = more_key_map[c]; X X if (s_hangup) c = K_QUIT; X X if (any_message) clrmsg(0); X X if (c & K_MACRO) { X m_invoke(c & ~K_MACRO); X goto same_prompt; X } X X alt_key: X X switch (c) { X case K_UNBOUND: X ding(); X goto same_prompt; X X case K_REDRAW: X#ifdef RESIZING X if (Columns != entry_col) { X entry_col = Columns; X maxline = topline = 1; X } X#endif X goto redraw; X X case K_CONTINUE: X if (eof) break; X if (screen_offset == 0 && form_feed == 0 && stop_line) { X if (linenum > overlap) { X underline_line = linenum; X linenum -= overlap; X } X } X goto next_page; X X case K_LAST_MESSAGE: X msg((char *)NULL); X goto dflt_prompt; X X case K_HELP: X display_help("more"); X goto redraw; X X case K_SHELL: X putchar(CR); X if (shell_escape()) goto redraw; X goto dflt_prompt; X X case K_EXTENDED_CMD: X switch (alt_command()) { X X case AC_QUIT: X more_return( MC_QUIT ); X X case AC_PROMPT: X case AC_HEADER: X goto dflt_prompt; X X case AC_REORDER: X more_return( MC_MENU ); X X case AC_REDRAW: X goto redraw; X X case AC_KEYCMD: X c = alt_cmd_key; X goto alt_key; X } X X case K_QUIT: X more_return( MC_QUIT ); X X case K_SAVE_NO_HEADER: X case K_SAVE_SHORT_HEADER: X case K_SAVE_FULL_HEADER: X case K_PRINT: X case K_UNSHAR: X case K_PATCH: X X putchar(CR); X if (init_save(c, (char **)NULL) != NULL) { X if (c == K_UNSHAR) X prompt_line = Lines - 2; X X save(ah); X end_save(); X } X X goto Prompt; X X case K_REPLY: X case K_FOLLOW_UP: X case K_MAIL_OR_FORWARD: X if (answer(ah, c, -1)) clrdisp(); X goto Prompt; X X case K_POST: X if (post_menu()) clrdisp(); X goto Prompt; X X case K_CANCEL: X if (current_group->group_flag & G_FOLDER) { X prompt("%s this folder entry", X (ah->flag & A_CANCEL) ? "UNcancel" : "Cancel"); X if (yes(0)) fcancel(ah); X goto Prompt; X } X X if (cancel(ah) == 0) goto Prompt; X more_return(MC_NEXT); X X case K_UNSUBSCRIBE: X if (!unsubscribe(current_group)) goto Prompt; X if (current_group->group_flag & G_SUBSCRIPTION) goto Prompt; X more_return(MC_NEXTGROUP); X X case K_GROUP_OVERVIEW: X group_overview(0); X goto redraw; X X case K_KILL_HANDLING: X kill_menu(ah); X goto Prompt; X X case K_READ_GROUP_UPDATE: X if (mode & MM_PREVIEW) more_return(MC_MENU); X prompt("Mark rest of current group as read?"); X if (yes(1) <= 0) goto Prompt; X more_return(MC_READGROUP); X X case K_NEXT_GROUP_NO_UPDATE: X if (mode & MM_PREVIEW) more_return(MC_MENU); X prompt("Skip to next group (current group is not updated) ?"); X if (yes(0) <= 0) goto Prompt; X more_return(MC_NEXTGROUP); X X case K_BACK_TO_MENU: X more_return(MC_MENU); X X case K_PREVIOUS: X if ((mode & MM_PREVIOUS) == 0) { X msg("No previous article"); X goto dflt_prompt; X } X more_return(MC_PREV); X X case K_ADVANCE_GROUP: X case K_BACK_GROUP: X case K_GOTO_GROUP: X switch (goto_group(c, ah)) { X case ME_NO_REDRAW: X goto Prompt; X X case ME_QUIT: X more_return( ME_QUIT ); X X default: X goto redraw; X } X X case K_NEXT_LINE: X if (eof) break; X if (screen_offset) goto same_prompt; X X print_lines = 1; X goto scroll; X X case K_NEXT_HALF_PAGE: X if (eof) break; X if (screen_offset) goto same_prompt; X X print_lines = window_lines/2; X X scroll: X gotoxy(0, prompt_line); X clrpage(prompt_line); X no_raw(); X X if (print_lines + lno < Lines) X goto next_page; X X gotoxy(0, Lines-1); X c = print_lines + lno - Lines + 1; X while (--c >= 0) { X putchar(NL); X if (--lno1 < 0) topline++; X prompt_line--; X } X if (lno1 < 0) lno1 = 0; X if (prompt_line < 0) prompt_line = 0; X lno = prompt_line; X goto next_line; X X case K_PREV_HALF_PAGE: X if (topline <= 1) goto Prompt; X linenum = topline - window_lines/2; X if (linenum < 1) linenum = 1; X goto next_page; X X case K_PREV_PAGE: X if (topline <= 1) goto Prompt; X linenum = topline - window_lines + overlap; /* not perfect after FF */ X underline_line = topline; X if (linenum < 1) linenum = 1; X goto next_page; X X case K_GOTO_LINE: X prompt("\1Go to line:\1 "); X if ((fname = get_s(NONE, NONE, "$^", NO_COMPLETION)) == NULL) X goto Prompt; X X if (*fname == NUL) { X if (prev_goto < 0) goto Prompt; X goto_line = prev_goto; X X } else X if (*fname == '$') X goto_line = 30000; X else X if (*fname == '^') X goto_line = 1; X else { X goto_line = atoi(fname); X if (goto_line <= 0) { X goto_line = -1; X goto Prompt; X } X } X X goto_page: X prev_goto = topline; X X if (goto_line <= maxline) X linenum = goto_line; X X goto next_page; X X case K_SELECT_SUBJECT: X more_return(MC_ALLSUBJ); X X case K_HEADER_PAGE: X fseek(art, linepos[0], 0); X goto_line = 0; X goto goto_page; X X case K_FIRST_PAGE: X goto_line = 1; X goto goto_page; X X case K_LAST_PAGE: X goto_line = 30000; X goto goto_page; X X case K_GOTO_MATCH: X prompt("\1/\1"); X if ((fname = get_s(NONE, NONE, "/", NO_COMPLETION)) == NULL) X goto Prompt; X X if (*fname && *fname != '/') { X if (regular_expr) free(regular_expr); X regular_expr = regcomp(fname); X } X X case K_NEXT_MATCH: X if (regular_expr == NULL) { X msg("No previous expression"); X goto Prompt; X } X X match_expr = 1; X if (match_topline != topline) prev_goto = topline; X match_topline = topline; X match_botline = linenum; X if (match_lines == 0 && topline <= 1) linenum = topline; X match_lines = 0; X goto next_line; /* don't clear the screen if no match */ X X case K_FULL_DIGEST: X if (mode & MM_DIGEST) X more_return( MC_NO_REDRAW ); X X if (!in_digest) X goto same_prompt; X X /* could do something more clever here later */ X digestah = *ah; X digestah.flag &= ~A_DIGEST; X digestah.hpos = digestah.fpos = 0; X fseek(art, 0L, 2); X digestah.lpos = ftell(art); X X switch (more(&digestah, mode | MM_DIGEST, screen_offset)) { X X case MC_REDRAW: X goto redraw; X X case MC_NO_REDRAW: X goto safe_redraw; X X case MC_QUIT: X more_return( MC_QUIT ); X X default: X goto safe_redraw; X } X X case K_LEAVE_ARTICLE: X ah->flag |= A_SELECT; X /* fall thru */ X X case K_NEXT_ARTICLE: X if ((mode & MM_PREVIEW) == 0) break; X more_return(MC_PREVIEW_NEXT); X X case K_NEXT_SUBJECT: X more_return(MC_NEXTSUBJ); X X case K_ROT13: X if (norot13) { X register i; X for (i=0; i<=127; i++) { X c = i; X if (c >= 'a' && c <= 'm') c += 13; X else if (c >= 'n' && c <= 'z') c -= 13; X else if (c >= 'A' && c <= 'M') c += 13; X else if (c >= 'N' && c <= 'Z') c -= 13; X rot13tab[i] = c; X } X norot13 = 0; X } X X rot13 = !rot13; X goto safe_redraw; X X case K_COMPRESS: X compress_space = !compress_space; X goto safe_redraw; X X case K_PREVIEW: X if (mode & MM_PREVIEW) X more_return(MC_PREVIEW_OTHER); X X /* fall thru to "default" */ X X default: X msg("Command %d not supported", c); X goto dflt_prompt; X } X X more_return(MC_NEXT); X X more_exit: X in_menu_mode = o_mode; X X no_raw(); X fclose(art); X X if ((mode & MM_PREVIEW) && more_cmd != MC_QUIT) { X gotoxy(0, screen_offset); X clrpage(screen_offset); X if (more_cmd == MC_PREVIEW_NEXT) { X if (screen_offset == 0) prompt_line = -1; X } else { X if (screen_offset == 0) return MC_REDRAW; X if (more_cmd != MC_PREVIEW_OTHER) return MC_NO_REDRAW; X } X } X X return more_cmd; X} X NO_NEWS_IS_GOOD_NEWS echo "File more.c is complete" chmod 0644 more.c || echo "restore of more.c fails" set `wc -c more.c`;Sum=$1 if test "$Sum" != "19863" then echo original size 19863, current size $Sum;fi echo "x - extracting news.c (Text)" sed 's/^X//' << 'NO_NEWS_IS_GOOD_NEWS' > news.c && X#include "config.h" X#include "news.h" X Xexport retry_on_error = 0; X X XFILE *open_news_article(art, modes, buffer1, buffer2) Xarticle_header *art; Xint modes; Xnews_header_buffer buffer1, buffer2; X{ X char *body; X char *digest_buffer; X char *parse_header(), **art_hdr_field(); X struct stat statb; X int retry; X FILE *f; X#ifdef NNTP X FILE *nntp_get_article(); X#endif /* NNTP */ X X if (art->flag & A_FOLDER) { X f = open_file(group_path_name, OPEN_READ); X if (f == NULL) return NULL; X fseek(f, art->hpos, 0); X#ifdef NNTP X } else X if (use_nntp) { X f = nntp_get_article(art->a_number); X if (f == NULL) return NULL; X#endif /* NNTP */ X } else { X sprintf(group_file_name, "%d", art->a_number); X X retry = retry_on_error; X while ((f = open_file(group_path_name, OPEN_READ)) == NULL) X if (--retry < 0) return NULL; X X /* necessary because empty files wreak havoc */ X if (fstat(fileno(f), &statb) < 0 || X statb.st_size < art->lpos || statb.st_size <= (off_t)0) { X fclose(f); X return NULL; X } X } X X digest_buffer = buffer1; X X if (modes & FILL_NEWS_HEADER) { X X news.ng_from = NULL; X news.ng_reply = NULL; X news.ng_name = NULL; X news.ng_subj = NULL; X news.ng_groups = NULL; X news.ng_ref = NULL; X X news.ng_xlines = NULL; X X if (modes & GET_ALL_FIELDS) { X news.ng_path = NULL; X news.ng_reply = NULL; X news.ng_ident = NULL; X news.ng_follow = NULL; X news.ng_keyw = NULL; X news.ng_dist = NULL; X news.ng_org = NULL; X news.ng_appr = NULL; X news.ng_date = NULL; X } X X if (modes & GET_DATE_ONLY) X news.ng_date = NULL; X X body = parse_header(f, art_hdr_field, modes, buffer1); X X news.ng_lines = news.ng_xlines ? atoi(news.ng_xlines) : -1; X X if (modes & FILL_OFFSETS) { X art->fpos = news.ng_fpos = ftell(f); X X fseek(f, (off_t)0, 2); X news.ng_lpos = ftell(f); X } X X news.ng_flag = 0; X X if (news.ng_appr) news.ng_flag |= N_MODERATED; X X if (modes & DIGEST_CHECK && is_digest(body)) X news.ng_flag |= N_DIGEST; X X digest_buffer = buffer2; X } X X if (modes & FILL_DIGEST_HEADER) { X fseek(f, art->hpos, 0); X parse_digest_header(f, modes & GET_ALL_FIELDS, digest_buffer); X } X X fseek(f, (modes & SKIP_HEADER) ? art->fpos : art->hpos, 0); X X return f; X} X X X Xchar *parse_header(f, hdr_field, modes, hdrbuf) XFILE *f; Xchar **(*hdr_field)(); Xint modes; Xnews_header_buffer hdrbuf; X{ X register char *bp, **fptr; X int siz, all, date_only; X off_t pos; X X pos = ftell(f); X X/* read first NEWS_HEADER_BUFFER bytes (should be more than enough) */ X X all = modes & GET_ALL_FIELDS; X date_only = modes & GET_DATE_ONLY; X X siz = fread(hdrbuf, sizeof(char), NEWS_HEADER_BUFFER, f); X X bp = hdrbuf; X bp[siz-1] = NUL; X X /* decode subarticle header */ X while (*bp) { X X if (*bp == NL) { /* empty line following header */ X ++bp; X fseek(f, pos + (bp - hdrbuf), 0); X return bp; X } X X if (*bp == SP) { /* for comp.ai.neural-nets digests */ X bp++; /* which have <NL><space><NL> after header */ X continue; X } X X if (date_only && *bp != 'D') X fptr = NULL; X else X if (fptr = (*hdr_field)(bp, all)) { X while (*bp && *bp != ':' && isascii(*bp) && !isspace(*bp)) X bp++; X bp++; X while (*bp && isascii(*bp) && isspace(*bp)) bp++; X *fptr = bp; X } X while (*bp && *bp != NL) bp++; X if (fptr && bp == *fptr) *fptr = NULL; X if (*bp) *bp++ = NUL; X } X X return bp; X} X X Xstatic char **art_hdr_field(lp, all) Xregister char *lp; Xint all; X{ X X#define check(name, lgt, field) \ X if (strncmp(name, lp, lgt) == 0) return &news.field X X switch (*lp++) { X X case 'A': X if (!all) break; X check("pproved: ", 9, ng_appr); X break; X X case 'D': X check("ate: ", 5, ng_date); X if (!all) break; X check("istribution: ", 13, ng_dist); X break; X X case 'F': X check("rom: ", 5, ng_from); X if (!all) break; X check("ollowup-To: ", 12, ng_follow); X break; X X case 'K': X if (!all) break; X check("eywords: ", 9, ng_keyw); X break; X X case 'L': X check("ines: ", 6, ng_xlines); X break; X X case 'M': X if (!all) break; X check("essage-ID: ", 11, ng_ident); X break; X X case 'N': X check("ewsgroups: ", 11, ng_groups); X break; X X case 'O': X if (!all) break; X check("rganization: ", 13, ng_org); X check("rganisation: ", 13, ng_org); X break; X X case 'P': X if (!all) break; X check("ath: ", 5, ng_path); X break; X X case 'R': X check("eply-To: ", 9, ng_reply); X check("eferences: ", 11, ng_ref); X break; X X case 'S': X check("ubject: ", 8, ng_subj); X if (news.ng_from == NULL) X check("ender: ", 7, ng_from); X break; X X case 'T': X check("itle: ", 6, ng_subj); X break; X } X X return NULL; X X#undef check X} X X Xis_header_line(line) Xchar *line; X{ X return art_hdr_field(line, 0) != (char **)NULL; X} NO_NEWS_IS_GOOD_NEWS chmod 0644 news.c || echo "restore of news.c fails" set `wc -c news.c`;Sum=$1 if test "$Sum" != "4805" then echo original size 4805, current size $Sum;fi echo "x - extracting news.h (Text)" sed 's/^X//' << 'NO_NEWS_IS_GOOD_NEWS' > news.h && X X Xstruct news_header { X X int ng_flag; /* flags: */ X# define N_DIGEST 1 /* article is part of a digest*/ X# define N_MODERATED 2 /* group is moderated */ X X off_t ng_fpos; /* position of article text */ X off_t ng_lpos; /* last text offset X /* header lines: */ X char *ng_from; /* from */ X char *ng_name; /* senders name */ X char *ng_subj; /* subject */ X char *ng_groups; /* newsgroups */ X char *ng_path; /* path */ X char *ng_reply; /* reply-to */ X char *ng_ident; /* message id */ X char *ng_follow; /* followup to */ X char *ng_ref; /* references */ X char *ng_keyw; /* keywords */ X char *ng_dist; /* distibution */ X char *ng_org; /* organization */ X char *ng_appr; /* approved */ X X char *ng_date; /* date */ X X char *ng_xlines; /* lines (from header) */ X int ng_lines; /* lines (decoded) */ X} news; X X X/* X * digest article subheader X */ X Xstruct digest_header { X off_t dg_hpos; /* position of article header */ X off_t dg_fpos; /* position of article text */ X off_t dg_lpos; /* last text position */ X /* header lines: */ X char *dg_date; /* date */ X char *dg_from; /* from */ X char *dg_subj; /* subject */ X char *dg_to; /* to */ X X int dg_lines; /* lines (pseudo field) */ X} digest; X X X#define NEWS_HEADER_BUFFER 2048 X Xtypedef char news_header_buffer[NEWS_HEADER_BUFFER]; X X XFILE *open_news_article(/* header, modes [, buffer1 [, buffer2]] */); X X/* modes */ X X#define FILL_NEWS_HEADER 0x0001 /* parse first header -> buffer1 */ X#define FILL_DIGEST_HEADER 0x0002 /* parse second header -> buffer[12] */ X X X#define GET_ALL_FIELDS 0x0010 /* get all fields (otherwise only */ X /* name, subj, groups, lines */ X X#define GET_DATE_ONLY 0x0020 /* get Date field */ X X#define FILL_OFFSETS 0x0080 /* fill ng_[hfl]pos */ X X X#define DIGEST_CHECK 0x0100 /* set N_DIGEST if "digest" in subj */ X /* only valid with FILL_NEWS_HEADER */ X X X#define SKIP_HEADER 0x1000 /* position after (sub) header */ X X NO_NEWS_IS_GOOD_NEWS chmod 0644 news.h || echo "restore of news.h fails" set `wc -c news.h`;Sum=$1 if test "$Sum" != "1990" then echo original size 1990, current size $Sum;fi echo "x - extracting nn.1 (Text)" sed 's/^X//' << 'NO_NEWS_IS_GOOD_NEWS' > nn.1 && X.TH NN 1 "Release 6.3" X.\" (c) Copyright 1988, Kim F. Storm, Texas Instruments A/S, Denmark X.\" X.\" NOTICE: Some versions of the -man package may have problems with X.\" ======= the @ characters in this manual. Fix your man package by X.\" substituting ALL occurrences of the @ character in X.\" tmac.an (or perhaps tmac.an.new) by a BEL (^G) character. X.\" X.UC 4 X.SH NAME Xnn \- efficient net news interface (No News is good news) X.SH SYNOPSIS X.B nn X[ \fIoptions\fP ] [ -g ] [ \fInewsgroup\fP | +\fIfolder\fP | \fIfile\fP ]... X.SH DESCRIPTION X\fINn\fP is yet another net news reader. Like the other news readers, X\fInn\fP will let you read the new (unread) articles in one news group at a Xtime, but unlike other similar programs, \fInn\fP has a menu based article Xselection prior to reading the articles in the news group. X.PP XWhen a news group is entered, \fInn\fP will locate all the presently Xunread articles in the group, and extract their sender, subject, and Xother relevant information. This information is then rearranged, Xsorted, and marked in various ways to give it a pleasant format when Xit is presented to the user at the terminal. X.PP XThis will be done very quickly, because \fInn\fP uses its own database Xto maintain all the necessary information on a directly accessible Xform (this database is built and maintained by the X.IR nnmaster (1M) Xprogram). X.PP XWhen the article menu appears on the screen, \fInn\fP will be in Xa mode called \fBselection mode\fP, which will be described in full Xdetail later. In this mode, the articles which seems to be Xinteresting can be selected by single keystrokes (using the keys a-z Xand 0-9). When all the interesting articles among the ones presently Xdisplayed have been selected, the space bar is hit, which causes X\fInn\fP to enter \fBreading mode\fP. X.PP XIn the reading mode, each of the selected articles will be presented Xto the user, who simply use the space bar to go on to the next page of Xthe current article, or to the next article. (Of course, there are Xall sorts of commands to scroll text up and down, skip to the next Xarticle, responding to an article, decrypt an article, and so on). X.PP XWhen all the selected articles in the current group have been read, Xthe last hit on the space bar will cause \fInn\fP will continue to the Xnext group with unread articles, and enter selection mode on that group. X.SH COMMAND LINE OPTIONS X\fInn\fP accepts a lot of command line options, but only a few of Xthese are used regularly. Options can also be set permanently by Xincluding appropriate X.I variable Xsettings in the X.I init Xfile described later, so the less used options Xare therefore presented after the description of the Xcorresponding variables in the sections on Variables and Options towards Xthe end of this manual. X.LP XThe frequently used command line options are: X.TP X\-\fBa0\fP XMark X.I all Xunread articles as read. \fInn\fP will ask whether all groups should Xbe updated (unconditionally), or whether it should prompt for Xconfirmation for each group. In the latter case, terminating the Xinput or breaking the program will cause \fInn\fP to ask whether the Xrest of the groups should be updated unconditionally or whether they Xshould remain unread. (This options is a special case of the X\-\fBa\fP\fIN\fP option described later.) X.TP X\-\fBg\fP XPrompt for the name of a news group or folder to be entered (with Xcompletion). X.TP X\-\fBl\fP\fIN\fP XPrint only the first \fIN\fP lines of the first page of each article Xbefore prompting to continue. This is useful on slow terminals and Xmodem lines to be able to see the first few lines of longer articles. X.TP X\-\fBs\fP\fIWORD\fP XCollect only articles which contain the string X.I WORD Xin their subject (case is ignored). This is normally combined with Xthe -x and -m options to find all articles on a specific subject. X.TP X\-\fBs/\fP\fIregexp\fP XCollect only articles whose subject matches the regular expression X.IR regexp . XThis is normally combined with the -x and -m options to find all Xarticles on a specific subject. X.TP X\-\fBm\fP XMerge all articles into one `meta group' instead of showing Xthem one group at a time. This is normally used together with the -x Xand -s options to get all the articles on a specific subject presented Xon a single menu (when you don't care about which group they belong Xto). When -m is used, no articles will be marked as read. X.TP X\-\fBx\fP[\fIN\fP] XPresent (or scan) all (or the last \fIN\fP) unread as well as Xread articles. This will X.I never Xmark unread articles as read. X.TP X\fInews.group\fP or \fIfile\fP or \fI+folder\fP XIf none of these arguments are given, all subscribed news groups will Xbe used. Otherwise, only the specified news groups and/or files will Xbe collected and presented. In specifying a news groups, the Xfollowing `meta notation' can be used: If the news group ends with a X\&`.' (or `.all'), all subgroups of the news group will be collected, Xe.g. X.br X comp.sources. X.br XIf a news group starts with a `.' (or `all.'), all the matching Xsubgroups will be collected, e.g. X.br X \&.sources.unix X.br XThese notations cannot be mixed (yet)! X.SH COMMAND INPUT XIn general, \fInn\fP commands consist of one or two key-strokes, and \fInn\fP Xreacts instantly to the commands you give it; you don't have to enter X.B return Xafter each command (except where explicitly stated). X.LP XSome commands have more serious effects than others, and therefore X\fInn\fP Xrequests you to confirm the command. You confirm by hitting the Xthe X.B y Xkey, and reject by hitting the X.B n Xkey. Some `trivial' requests may also be confirmed simply by hitting X.B space. XFor example, to confirm the creation of a save file, just hit X.B space, Xbut to unsubscribe to a news group, you must enter X.B y. X.LP XMany commands will require that you enter a line of text, e.g. a file Xname or a shell command. If you enter X.B space Xas the first character on a line, the line will be Xfilled with a default value (if one is defined). For example, the Xdefault value for a file name is the last file name you have entered, Xand the default shell command is your previous shell command. You can Xedit this default value as well as a directly typed text, using the Xfollowing editing commands. The \fBerase\fP, X\fBkill\fP, and \fBinterrupt\fP keys are the keys Xdefined by the current tty settings. On systems without job control, Xthe X.B suspend Xkey will be X.B control-Z Xwhile it is the current suspend character on system with job control. X.TP X.B erase X.br XDelete the last character on the line. X.TP X\fBdelete-word\fP (normally ^W) X.br XDelete the last word or component of the input. X.TP X.B kill X.br XDelete all characters on the line. X.TP X\fBinterrupt\fP and \fBcontrol-G\fP X.br XCancel the command which needs the input. X.TP X\fBsuspend\fP XSuspend \fInn\fP if supported by the system. Otherwise, spawn an Xinteractive shell. X.TP X.B return X.br XTerminate the line, and continue with the command. X.SH BASIC COMMANDS XThe are numerous commands in \fInn\fP, and most of them can be invoked Xby a single keystroke. The descriptions in this manual are based on Xthe standard bindings of the commands to the keys, but it is possible Xto customize these using the X.B map Xcommand described later. For each of the keystroke commands described Xin this manual, the corresponding command name will also be shown in Xcurly braces, e.g. {\fBcommand\fP}. X.LP XThe following commands work in both selection Xmode and in reading mode. The notation ^X means `control X': X.TP X\&\fB?\fP {\fBhelp\fP} XHelp. Gives a one page overview of the commands available in the Xcurrent mode. X.TP X\&\fB^L\fP {\fBredraw\fP} XRedraw screen. X.TP X\&\fB^R\fP {\fBredraw\fP} XRedraw screen (Same as ^L). X.TP X\&\fB^P\fP {\fBmessage\fP} XRepeat the last message shown on the message line. X.TP X\&\fB!\fP {\fBshell\fP} XShell escape. The user is prompted for a command which is executed Xby your favorite shell (see the X.B shell Xvariable). Shell escapes are described in detail later on. X.TP X\&\fBQ\fP {\fBquit\fP} XQuit \fInn\fP without marking \fIcurrent\fP group as read. If you Xhave selected any articles in the current group, \fInn\fP will offer Xyou to use the same selections the next time you are about to read Xthat group. So, when you use the X.B Q Xcommand, you neither lose the current group nor the selections you Xmight have made (unless the articles are expired in the meantime of Xcourse). \fInn\fP will also remember which menu pages you have Xalready seen, and attempt to start at the last displayed menu page the Xnext time the group is entered (if you confirm to "use old selections" Xwhen asked). X.TP X\&\fBV\fP {\fBversion\fP} XPrint release and version information. X.TP X\fB:\fP\fIcommand\fP {\fBcommand\fP} XExecute the \fIcommand\fP by name. This form can be used to invoke Xany of \fInn\fP's commands, also those which cannot be bound to a key X(such as X.BR coredump ), Xor those which are not bound to a key by default (such as X.B post Xand X.BR unshar ). X.SH SELECTION MODE XIn selection mode, the screen is divided into four parts: the header Xline showing the name of the news group and the number of articles, Xthe menu lines which show the collected articles - one article Xper line, the prompt line where you enter commands, and the message Xline where \fInn\fP prints various messages to you. X.LP XEach menu line begins with an \fIarticle id\fP which is a unique Xletter (or digit if your screen has more than ~30 lines). To select Xan articles for reading, you simply enter the corresponding \fIid\fP, Xand the menu line will high-light to indicate that the article is Xselected. When you have selected all the interesting articles on the Xpresent menu, you simply hit X.B space. XIf there are more articles collected for the current group than could Xbe presented on one screenful of text, you will Xbe presented with the next portion of articles to select from. When Xyou have had the opportunity to select among all the articles in the Xgroup, hitting X.B space Xwill enter reading mode. X.LP XIf no articles have been selected in the current group, hitting X.B space Xwill enter selection mode on the next news group, or exit \fInn\fP Xif the current group was the last news group with unread articles. XIt is thus possible to go through ALL Xunread articles (without reading any of them) just by hitting X.B space Xa few times. X.LP XThe articles will be presented on the menu using one of the following Xlayouts: X.sp 0.5v X.TP X0: X\fIx Name......... Subject.............. +123\fP X.TP X1: X\fIx Name......... 123 Subject..............\fP X.TP X2: X\fIx 123 Subject...................................\fP X.TP X3: X\fIx Subject...........................................\fP X.LP XHere \fIx\fP is the letter or digit that must be entered to select the Xarticle, \fIName\fP is the real name of the sender (or the mail Xaddress if the real name cannot be found), \fISubject\fP is the Xcontents of the "Subject:" line in the article, and \fI123\fP is the number Xof lines in the article. X.LP XLayout 0 and 1 are just two ways to present the same information, Xwhile layout 2 and 3 are intended for groups whose articles have very Xlong subject lines, e.g. comp.sources. X.LP XLayout 1 is the default layout, and an alternative menu line layout is Xselected using the \-\fBL\fP option or by setting the X.B layout Xvariable. Once \fInn\fP is Xstarted the layout can be changed at any time using the X.B L Xkey {\fBlayout\fP}. X.LP XThe \fIName\fP is limited to 16 characters, and to make maximum use of Xthis space, \fInn\fP will perform a series of simplifications on the Xname, e.g. changing first names into initials, removing domain names Xfrom mail addresses (if the real name is not found) etc. It does a Xgood job, but some people on the net put weird things into the From: Xfield (or actually into their password file) which result in \fInn\fP Xproducing quite cryptic "names"; these people have themselves to blame X- not me! X.LP XThe \fISubject\fP is limited to ~60 characters (~75 in layout 3) and Xis thus only an approximation to the actual subject line which may be Xmuch longer. To get as much out of this space, \fIRe:\fP prefixes (in Xvarious forms) are recognized and replaced by an equivalent number of X\&`>' characters. X.PP XSince articles are sorted accoring to the subject, two or more Xadjacent articles may share the same subject (ignoring any `>'s). In Xthis case, only the first article will show the subject of the Xarticle; the rest will only show the `>' characters in the subject Xfield (or a `-' if there are no `>'s at the beginning of the line). A Xtypical menu will thus only show each subject once, saving a lot of Xtime in scanning the news articles. X.SH SELECTION MODE COMMANDS XThe primary purpose of the selection mode is of course to select the Xarticles to be read, but a number of other commands may also be Xperformed in this mode: saving of articles in files, replying and Xfollowing up on articles, mailing/forwarding articles, shell escapes Xetc. X.PP XThe selected articles are marked either by showing the corresponding Xmenu line in standout mode (reverse video), or if the terminal does Xnot have this capability by placing an asterisk (*) after the Xselection letter or digit. X.LP XThe basic article selection commands are: X.TP X\&\fBabc...z 01..9\fP {\fIcannot be reassigned\fP} XSelect the article with the given identification letter or digit, or Xif the article is already selected, deselect it. X.TP X\&\fBspace\fP {\fBcontinue\fP} XContinue to next menu page, or if on last menu page, read the selected Xarticles. If no articles have been selected, continue to the next news Xgroup. (The X.B newline Xand X.B return Xkeys have the same effect in selection Xmode, but not in reading mode). X.TP X\&\fB@\fP {\fBselect-invert\fP} X.br XReverse selections. All selected articles on the current page are Xdeselected, and vice-versa. This is the quickest way to select all Xarticles. X.TP X\&\fB~\fP {\fBunselect-all\fP} XDeselect all articles in the group (this works across all menu pages). X.TP X\&\fB+\fP {\fBselect-auto\fP} XPerform auto-selections in the group (see the section on "auto Xkill/select" below). X.LP XDuring selection, the cursor will normally be placed on the article Xfollowing the last selected article (initially the first article). XThe article pointed out by the cursor is called the "current article". XThe following commands work relative to the current cursor Xposition. X.TP X\&\fB.\fP {\fBselect\fP} XSelect or deselect the current article and move the cursor to the next Xarticle. X.TP X\&\fB,\fP {\fBline+1\fP} XMove the cursor to the next article. You can use the X.I down arrow Xas well. X.TP X\&\fB/\fP {\fBline-1\fP} XMove cursor to previous article. You can use the X.I up arrow Xas well. X.TP X\&\fB*\fP {\fBselect-subject\fP} XSelect (or deselect) all articles with same subject as current Xarticle. This will work across several menu pages if necessary. X.TP X\&\fB-\fP\fIx\fP {\fBselect-range\fP} XSelect (or deselect) all articles between current article and the Xarticle specified by X.IR x . XThis is normally used to select a range of articles, e.g. from X.I e Xto X.I k Xby simply typing X.BR e-k . X.LP XThe following commands move between the pages belonging to the same Xnews group when there are more articles than will fit on a single page. X.TP X\&\fB>\fP {\fBpage+1\fP} XGoto next menu page. X.TP X\&\fB<\fP {\fBpage-1\fP} XGoto previous menu page, or to last menu page if on first menu page. X.TP X\&\fB$\fP {\fBpage=$\fP} XGoto last menu page. X.TP X\&\fB^\fP {\fBpage=1\fP} XGoto first menu page. X.LP XThe following commands are used to enter reading mode for the selected Xarticles, and to move between news groups (in selection mode). X.TP X\&\fBspace\fP {\fBcontinue\fP} XEnter reading mode, or goto next menu page in current group or first Xmenu page of next group. X.TP X\&\fBZ\fP {\fBread-return\fP} XEnter reading mode X.I immediately Xwith the currently selected articles. When all Xarticles have been read, return to selection mode in the X.I current Xgroup. X.TP X\&\fBX\fP {\fBread-skip\fP} XEnter reading mode X.I immediately Xwith the currently selected articles. When all Xarticles have been read, enter selection mode in the X.I next Xnews group. \fBWhen no articles are selected, it goes directly to the next Xgroup\fP. XThis can be used to skip all the articles in a large news group Xwithout having to go through all the menu pages. X.LP XWhen the selected articles (if any) in a group have been read, X.I all Xarticles in that group will be marked as read! X.LP XIt is not possible to have single articles in a group marked `unread'. X(New articles received after \fInn\fP was invoked are not seen by X\fInn\fP, and of course they are not marked as read). X.LP XThe only alternative to marking all articles as read is to mark none Xof the current collection as read. This is done by the following Xcommands: X.TP X\&\fBN\fP {\fBnext-group\fP} XGoto next news group without marking the articles in the current group Xas read. This can be used in combination with X.B Z Xto read some articles in a group, because the X.B Z Xcommand does not mark the articles as read. X.TP X\&\fBP\fP {\fBprevious\fP} XGoto previous group. This command will enter selection mode on the Xprevious active group (two P commands in sequence will bring you to Xthe current group). X.SH READING MODE COMMANDS XIn reading mode, the articles are presented one page at a time. To Xget the next page of an article, simply hit X.BR space , Xand when you are on the last page of an article, hit X.B space Xto get to the next article. When you are on the last page of the Xlast article, hit X.B space Xto enter selection mode on the next group (or the current group if Xreading mode was entered using the X.B Z Xcommand). X.LP XThe following text scrolling commands are available: X.TP X\&\fBspace\fP {\fBcontinue\fP} XScroll X.I one\ page\ forward Xor continue with the next article or group as described above. X.TP X\&\fBbackspace / delete\fP {\fBpage-1\fP} XGo X.I one\ page\ backwards Xin article. X.TP X\&\fBd\fP {\fBpage+1/2\fP} XScroll one X.IR half\ page\ forward . X.TP X\&\fBu\fP {\fBpage-1/2\fP} XGo one X.IR half\ page\ backwards . X.TP X\&\fBreturn\fP {\fBline+1\fP} XScroll X.I one\ line\ forward Xin the article. X.TP X\&\fB^\fP {\fBpage=1\fP} XGoto the first page (excluding the header) of the article. X.TP X\&\fB$\fP {\fBpage=$\fP} XGoto the last page of the article. X.TP X\&\fBg\fP\fIN\fP {\fBline=@\fP} XGoto line X.I N Xin the article. X.TP X\&\fB/\fP\fIregexp\fP {\fBfind\fP} XSearch forward for text matching the regular expression X.I regexp Xin the article. If a matching text is found, it will be high-lighted. X.TP X\&\fB.\fP {\fBfind-next\fP} XRepeat search for last regular expression. X.TP X\&\fBh\fP {\fBpage=0\fP} XShow the X.I header Xof the article, and continue from the top of the Xarticle. X.TP X\&\fBH\fP {\fBfull-digest\fP} XIf the current article is extracted from Xa digest, show the entire digest article including its header. XAnother X.B H Xcommand will return to the current subarticle. X.TP X\&\fBD\fP {\fBrot13\fP} XTurn rot13 (caesar) decryption on and off for the current article, and Xredraw current page. X.TP X\&\fBc\fP {\fBcompress\fP} XTurn compression on and off for the current Xarticle. With compression turned on, multiple spaces and tabs are Xshown as a single space. This makes it much easier to read right Xjustified text which separate words with several spaces. Redraws Xcurrent page. X.LP XThe following commands are used to move among the selected articles. X.TP X\&\fBn\fP {\fBnext-article\fP} XGoto next article. This command skips the rest of the current article Xand jumps directly to the first page of the next article (or to the Xnext group if it is the last article). X.TP X\&\fBl\fP {\fBleave-article\fP} XLeave current article and goto next. XThis command behaves like the \fBnext-article\fP command, but the Xarticle will still be selected, and when all the selected articles Xin the group have been read as usual, these `left over' articles will Xbe presented once more. This is useful if you see an article which Xyou may want to respond to unless one the following articles is Xalready saying what you intended to say. X.TP X\&\fBp\fP {\fBprevious\fP} XGoto previous article. X.TP X\&\fBk\fP {\fBnext-subject\fP} XKill subject. Skips rest of current article, and all following Xarticles with the same subject. X.br XNote: this is not a permanent kill subject command (see the \fBK\fP command). X.TP X\&\fB*\fP {\fBselect-subject\fP} XShow next article with \fIsame\fP subject (even if it is not Xselected). This command will X.I select Xall following articles with the same subject as the current article X(similar to the `*' command in selection mode). This can be used to Xselect only the first article on a subject in selection mode, and then Xselect all follow-ups in reading mode if you find the article Xinteresting. X.LP XThe following commands perform an Ximmediate return from reading mode to selection mode in Xthe X.I current Xgroup or skip to the next group. X.TP X\&\fB=\fP {\fBgoto-menu\fP} XReturn to selection mode in the current group (think of = as the X\&"icon" of the selection menu). The articles already Xread will no longer be selected on the menu (excluding the current Xarticle). X.TP X\&\fBN\fP {\fBnext-group\fP} XSkip the rest of the selected articles in the current group and go Xdirectly to the next group. The unread articles in the current group are X.I not Xmarked as read. (You will be asked to confirm this command.) X.TP X\&\fBX\fP {\fBread-skip\fP} XMark current group as read and go directly to the next group. (You Xwill be asked to confirm this command.) X.SH PREVIEWING ARTICLES IN SELECTION MODE XIn selection mode, it is possible to read a specific article on the Xmenu without entering reading mode for all the selected articles on Xthe menu. Using the commands described below will enter reading mode Xfor one article only, and then return to the menu mode immediately Xafter. X.PP XIf there are more than 5 free lines at the bottom of the menu screen, X\fInn\fP will use that space to show the article (a minimal preview Xwindow can be permanently allocated with the X.B window Xvariable). Otherwise, Xthe screen will be cleared to show the article. X.PP XAfter previewing an article, the following article will become the Xcurrent article. X.TP X\&\fB%\fP\fIx\fP {\fBpreview\fP} XPreview article X.IR x . X.TP X\&\fB%%\fP {\fBpreview\fP} XPreview the current article. X.LP XWhen the article is being shown, the following reading mode commands Xare very useful: X.TP X\&\fB=\fP {\fBgoto-menu\fP} XSkip the rest of the current article, and return to menu mode. X.TP X\&\fBn\fP {\fBnext-article\fP} XSkip the rest of the current article, and \fIpreview the next article\fP. X.TP X\&\fBl\fP {\fBleave-article\fP} XSelect the article on the menu, then skip the rest of the current Xarticle, and preview the next article. X.TP X\&\fB%\fP\fIy\fP {\fBpreview\fP} XPreview article X.I y . X.SH SAVING ARTICLES X\fInn\fP allows you to save articles in a number of ways. X.LP XFirst, the save commands will prompt for a file name which is expanded Xaccording to the rules described in the section on file name expansion Xbelow. If the X.B quick-save Xvariable is set, \fInn\fP will only prompt for a save file name when Xthe current articles are inside a folder; otherwise, the default save Xfile defined in the init file will be used unconditionally (except if Xan alternative save file has been specified for the group in the group Xpresentation sequence described later on). X.LP XIf the file (and directories in the path) does not exist, X\fInn\fP Xwill ask whether the file (and the directories) should be created. X.LP XIf the file name ends in an asterisk, e.g. X.br X part.* X.br X\fInn\fP will save each of the articles in uniquely named files Xconstructed by replacing the asterisk by numbers from the sequence 1, X2, 3, etc. (The format of the string that replaces the * can be Xchanged with the X.B save-counter Xvariable.) X.LP XThe saved articles will be X.I appended Xto the specified file(s) followed by an empty line each. X.LP XWhen an article has been saved in a file, a message reporting the Xnumber of lines saved will be shown. This can be disabled by Xunsetting the X.B save-report Xvariable. X.LP XThe following commands are available in both selection mode and in Xreading mode, but their use differs between the two modes: X.LP XIn X.I reading Xmode, the commands will just save the X.I current Xarticle in the specified file. X.LP XIn X.I selection Xmode, they prompt you for the identifier of an article you want to Xsave. During the saving of the article the message X.br X Processing article x... X.br Xappears, and when the article has been saved, the displayed article Xidentifier changes from a lower case letter to an upper case letter X(digits are changed into the `&' character). You will then be prompted Xfor another article to be saved. Just hit X.B space Xwhen you don't want to save more articles. X.LP XIf you enter an asterisk `*' when you are prompted for an article Xidentifier, \fInn\fP will automatically save all the \fIselected\fP Xarticles on the \fIcurrent\fP menu page (and deselect the articles). X.LP XLikewise, if you enter a plus `+', \fInn\fP will save all the selected Xarticles on \fIall\fP menu pages (and deselect the articles). X.LP XThis is very useful in combination with the \fIsave selected articles\fP Xfeature to save a selection of articles in separate, successively Xnumbered files. Do not confuse these two concepts! The X.B S* Xand X.B S+ Xcommands can be used to save the selected articles in a single file as Xwell as in separate files, and the \fIsave in separate files\fP Xfeature can be used also when saving individual articles, either in Xthe selection mode, or in the article reading mode. X.LP XWhen articles are saved in a file with a full or partial header, any Xheader lines in the X.I body Xof the article will be escaped by a tilde (e.g. ~From: ...) to enable X\fInn\fP to split the folder into separate articles. Otherwise, X\fInn\fP might be fooled into splitting a folder into too many articles. X.LP XArticles can be saved in a mail compatible format by setting the X.B mail-format Xvariable. X.LP XThe save commands are: X.TP X\&\fBS\fP {\fBsave-full\fP} XSave articles including the full article header. X.TP X\&\fBO\fP {\fBsave-short\fP} XSave articles with a short header Xcontaining only the name of the sender, the subject, and the posting Xdate of the article. X.TP X\&\fBW\fP {\fBsave-body\fP} XWrite article X.I without Xa header. X.TP X\&\fB:print\fP {\fBprint\fP} XPrint article. Instead of a file name, Xthis command will prompt for the print command to which the current Xarticle will be piped. The default print command is specified at Xcompile time, but it can be changed by setting the X.B printer Xvariable. The output will be identical to that of the X.B O Xcommand. X.TP X\&\fB:patch\fP {\fBpatch\fP} XSend articles through \fBpatch\fP(1) (or the program defined in the X\fBpatch-cmd\fP variable). Instead of a file name, you will be Xprompted for the name of a directory in which you want the patch Xcommand to be executed. \fInn\fP will then pipe the body of the Xarticle through the patch command. X The output from the patch process will be piped through the pager Xdefined in the \fBpager\fP variable and appear on the screen. X.TP X\&\fB:unshar\fP {\fBunshar\fP} XUnshar articles. You will be prompted for the name of a directory in Xwhich you want \fInn\fP to unshar the articles. \fInn\fP will then Xpipe the proper parts of the article body into a Bourne Shell whose Xworking directory will be set to the specified directory. X During the unpacking, the normal output from the unshar process will Xappear on the screen, and the menu or article text will be redrawn when Xthe process is finished. X.LP XIn reading mode, the following keys can also be used to invoke the Xsave commands: X.TP X.B s XSame as X.BR S . X.TP X.B o XSame as X.BR O . X.TP X.B w XSame as X.BR W . X.TP X.B P XSame as X.BR :print . X.SH FILE NAME EXPANSION XWhen the save commands prompts for a file name, the following file Xname expansions are performed on the file name you enter: X.TP X\fB+\fP\fIfolder\fP XThe X.B + Xis replaced by the contents of the X.B folder Xvariable (default value "~/News/") resulting in the name of a file in the X.I folder X.IR directory . XExamples: X.br X +emacs, +nn, +sources/shar/nn X.TP X\fB+\fP XA single plus is replaced by the expansion of the file name contained in the X.B default-save-file Xvariable. X.TP X\fB~/\fP\fIfile\fP XThe X.B ~ Xis replaced by the contents of the environment variable HOME, i.e. the Xpath name of your home directory. XExamples: X.br X ~/News/emacs, ~/News/nn, ~/src/shar/nn X.TP X\fB|\fP\fIcommand-line\fP XInstead of writing to a file, the articles are piped to the given Xshell (/bin/sh) command-line. Each save or write command will create a Xseparate pipe, but all articles saved or written in one command (in Xselection mode) are given Xas input to the same shell command. Example: X.br X | pr | lp X.br XThis will print the articles on the printer after they have been piped Xthrough pr. X It is possible to create separate pipes for each saved article by Xusing a double pipe symbol in the beginning of the command, e.g. X.br X || cd ~/src/nn ; patch X.br X.LP XThe following symbols are expanded in a file name: X.TP X.B $F Xwill be expanded to the name of the current group with the periods Xreplaced by slashes, e.g. rec/music/synth. X.TP X.B $G Xwill be expanded to the name of the current group. X.TP X.B $L Xwill be expanded to the \fIlast component\fP of the name of the Xcurrent group. You may use this to create default save file names Xlike +src/$L in the comp.sources groups. X.TP X.B $N Xwill be expanded to the (local) article number, e.g. 1099. In Xselection mode it is only allowed at the end of the file name! X.LP XUsing these symbols, a simple naming scheme for `default folder name' is X.B +$G Xwhich will use the group name as folder name. Another possibility is X.BR +$F/$N . X.LP XAs mentioned above, you can also instruct \fInn\fP to save a series of Xfiles in separate, unique files. All that is required is that the Xfile name ends in an asterisk, e.g. X.br X +src/hype/part.* X.br XThis will cause each of the articles to be saved in separate, unique files Xnamed part.1, part.2, and so on, always choosing a suffix number that Xresults in a unique file name (i.e. if part.1 did already exist, the Xfirst article would be saved in part.2, the next in part.3, and so on). NO_NEWS_IS_GOOD_NEWS echo "End of part 8" echo "File nn.1 is continued in part 9" echo "9" > s2_seq_.tmp exit 0 --- Kim F. Storm storm@texas.dk Tel +45 429 174 00 Texas Instruments, Marielundvej 46E, DK-2730 Herlev, Denmark No news is good news, but nn is better!