back2roots/padua

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

/ back2roots/padua / padua.7z / padua / uucp / auucp+-1.02 / auucpplus1_02d2.lzh / man / arn < prev next >

Wrap

Text File | 1990-09-12 | 39.5 KB | 965 lines

__________________________________ | | | | | ** | | **** | | ** ** ** *** ***** | | ** ** *** ** ** ** | | ****** ** ** ** ** | | ** ** ** ** ** | | ** ** **** ** ** | | | | Amiga-USENET-NewsReader | | (C)opyright by Roland Bless | | ⌐/Written 1990 | | A Byteable Software Product | |__________________________________| Arn.doc for VERSION 0.60 ------------ Hint: Find out your current-version-number by typing "Arn -i" to a CLI. o (C)opyright and Distribution ---------------------------- This program and it's documentation can be freely distributed! Commercial usage and getting profit in any form through it is strictly prohibited any form! The redistribution of a changed source without permission is strictly prohibited! All (C)opyright-notes must be maintained! Redistribution of a changed program/documentation is not allowed! I do not take the responsibility for any loss of data! I do not guarantee that all functions work as described/expected! Please keep always in mind that I spent much (spare-)time in writing this software and feel free to support me with some money of any amount (suggested 15-20 DM or US $10). My address is: Roland Bless Moersenbroicher Weg 151 FRG - 4000 Duesseldorf 30 (Federal Republic of Germany) Please redistribute always the files together which come with this release. o Files ----- Arn - the executable/binary Arnhelp.txt - the help-text for arn. Arn.doc - this documentation preprnews - a little program for rnews to get single articles put into your own newsgroups (esp. for Amiga-UUCP). .arnrc - an example of "Arn"'s configuration file. UUConfig - an example of the UUCONFIG-file sendm - an example of a possible script-file for SENDMAIL null-handler - the null:-device mountlist - the mountlist entry for the null-handler. o Intro ----- This newsreader was written from scratch without looking into the real "rn"-source. Please understand that this version is not yet as powerful as its model. It was written in C and I tried my best to program it close to the "programming-rules" from Commodore-Amiga. Maybe it will run just as good under Amiga-OS 2.0 as under Kickstart 1.3/1.2. If you don't know what a "newsreader" is, this is maybe the wrong program for you! But if you want to use or learn "UUCP", you should read this manual. "Arn" was originally written for Amiga-UUCP, so it will be easy to install it for this UUCP-Version. However, "Arn" was designed to work together with other programs. "Arn"'s Configuration-file will allow you to cope with all other UUCP-Versions in an easy way. Please excuse my horrible English, it isn't my native language. o Installing Arn -------------- 1. System requirements Arn was written under Kickstart 33.180 and Workbench 34.28 on a European PAL-Amiga 2000B Rev 4.3 with 2 MB more Fastram (A-2058). "Arn" normally allocates storage dynamically, so that constant values of memory-usage cannot be given. It is quite possible that "Arn" requires 100kBytes or more if you're reading newsgroups with lots of articles. I DID NOT TEST IT EXPLICITLY ON OTHER AMIGAS! A stack-size of 4000 bytes should be sufficient. All memory-allocations are checked, so that no crash is caused by insufficient free memory (esp. at the "initialization- phase", please let me know any bugs!). The NULL:-Device must be installed. Just copy the null-handler to your L: directory and insert the mountlist-entry for the null-handler into your Mountlist and "mount NULL:". An Assign for T: and UULIB: should exist. T: is the directory for temporary files and UULIB: is required for some "Arn"-Configuration- Files. This is typically the UUCP-directory .../usr/lib/uucp (if you have AmigaUUCP this assign often already exists...if you followed the docs). The file ARNHELP.TXT SHOULD BE MOVED INTO UULIB:! Examples: Assign T: RAM: Assign UULIB: UUCP:usr/lib/uucp Last but not least, you must have installed a UUCP-Package such as Amiga-UUCP, CNews or JDCP and so on... 2. ".arnrc" - Arn requires a configuration file! A file called ".arnrc" must exist in your CURRENT directory or in the directory "UULIB:". This file is REQUIRED to configure "Arn". If you want to have more than one user using "Arn" just create for each user in its home-directory its individual ".arnrc" respectively "UUCONFIG". Before entering "Arn" just "cd" into the right home-directory. The format of ".arnrc" is as follows: # Arn Config-File for AmigaUUCP-Version 1.06D! NEWSDIR UUNEWS: SAVENEWS UUCP:usr/rob/News #ACTIVEFILE UULIB:active GROUPLIST UULIB:.newslib UUCONFIG UULIB:Config SEQFILE UULIB:seq SCREENSW YES QUOTECHAR "> " TIMEOFFSET +2 GMT SIGNATURE UULIB:.signature RELAYVER version 1.06D (AmigaUUCP) POSTINGVER version 1.06D (AmigaUUCP) SENDNEWS uux %s "%s!rnews" SENDMAIL sendmail <%s -f rob RNEWS preprnews %s "rnews " #Set NEWSDIRTYPE to Y or YES for CNews and JDCP #NEWSDIRTYPE Y #REPLY-TO rob%spirit@impch.imp.com #SENDMAIL sendm %s rob The format is: KEYWORD VALUE If "Arn" finds a valid keyword, it will look for the next characters on the same line which follow after one or more SPACEs or TABs! The keyword is NOT case-dependent but must start in column 0! To set up your own configuration-file, make a copy of the example that comes with "Arn" and edit it with your favorite ASCII-Editor. The example ".arnrc" should show you a typical setup for the Amiga-UUCP-Package. Each keyword and its function will now be described here: NEWSDIR ~~~~~~~ After this keyword the PATH to your "News-directory" should follow. The "News-Directory" is that one from where all the "newsgroup"- directories are branching. For Amiga-UUCP its typically the Assign "UUNEWS:". The last character should not be a "/" (slash), because "Arn" will append one for you! examples: NEWSDIR UUNEWS: NEWSdir UUCP:usr/spool/news SAVENEWS ~~~~~~~~ This is the directory/PATH where your "saved" articles should go. "Arn" will use this directory when saving an article with "s" or "w" if no other directory is specified (which then must contain a device or a colon). GROUPLIST ~~~~~~~~~ This is the FILENAME which saves informations about read an unread articles and newsgroups. Its format is described later in detail. It's similar to the ".newsrc" created by "rn". This file will be created for you, if it doesn't exist. ACTIVEFILE ~~~~~~~~~~ This is the FILENAME (with specified path) to your active-file IF YOUR UUCP-Version supports it (AmigaUUCP currently does not!)!! "Arn" will read all entries after reading the grouplist. If the group- list isn't existent, "Arn" will read your active-file and search for new groups to add to the grouplist. UUCONFIG ~~~~~~~~ This is a very important FILENAME for information about the UUCP environment. It looks like this (example): NodeName spirit UserName rob RealName Roland Bless NewsFeed krefcom * Organization Byteable Software Products, private, Duesseldorf (FRG) MailEditor Dme NewsEditor Dme DomainName .kref.sub.org DefaultNode krefcom Entries without an asterisk (that is *) are REQUIRED! I think these entries are self-explanatory. If you're running Amiga-UUCP it is normally called "UULIB:Config". Then you do not have to create it. SEQFILE ~~~~~~~ This is a FILENAME for a file which should contain a single number in ASCII-Format. It will be used for the Message-ID of postings or follow-ups and is increased by "Arn". This file exists also under Amiga-UUCP as UULIB:seq. SCREENSW ~~~~~~~~ Screenscwitch. Favourite editors (named in UUCONFIG) can have their own screens and therefore you can force "Arn" to switch or not to switch to the WorkBench-Screen and then back to its own screen. If something like "NO" follows (the first letter is important), then "Arn" will do nothing about screen-switching. If there is a "Yes" or anything other than "N", "Arn" will bring the WB-Screen to front, invoke the editor, and after the editor quits, it will bring the "ArnScreen" to front. If you still didn't know what I mean, just let it on "YES". QUOTECHAR ~~~~~~~~~ This entry contains your favourite character(s) that will be used for quoting, that means is inserted in the leftmost column in each line of the included text at replies or follow-ups. This entry is LIMITED in length! The whole entry should not contain more than 6 characters that means 4 characters maximum of QUOTECHAR, because: The first char and the last char are stripped of this string just to make it possible for including spaces. examples: QUOTECHAR "> " Quoted text looks like this: > this is a test for quotechar. this is a quoted line of text. > this is a test for quotechar. this is a quoted line of text. quotechar (## |) Quoted text then looks like this: ## |this is a test for quotechar. this is a quoted line of text. ## |this is a test for quotechar. this is a quoted line of text. TIMEOFFSET ~~~~~~~~~~ This entry contains two values: A timezone-name and the offset to your time concerning this timezone. Example: TIMEOFFSET +1 GMT means that "Arn" will subtract one hour from your local time and will use/append timezone GMT in Date:-lines. To get your local timezone just write an offset of 0 to the TIMEOFFSET then your local-timezone-name after it. TIMEoffset 0 MET (MET means Middle-European-Time) The value can be preceeded by a minus or a plus sign. If no sign is given a plus is assumed (which means to SUBTRACT that value from your local time!). It is recommended to use your offset to GMT (Greenwich-Mean-Time) and timeoffset -1 GMT means that your time is 1 hour BEHIND GMT. The length of the TIMEZONE-name is limited to 5 characters! If it is missing too long, "Arn" will display a WARNING: on stdout and say that it took GMT instead! SIGNATURE ~~~~~~~~~ The FILENAME of your signature file to append to your articles/mails written with "Arn". "Arn" will NOT put any characters (e.g. the "--") before your signature-text but two lines of space. But if you want this, just insert it in your SIGNATURE-file... RELAYVER and POSTINGVER ~~~~~~~~ ~~~~~~~~~~ These two lines are required by RFC 1036 (quoting): RFC1036| be passed through unchanged. The required headers are RFC1036| Relay-Version, Posting-Version, From, Date, Newsgroups, RFC1036| Subject, Message-ID, Path. The optional headers are RFC1036| Followup-To, Date-Received, Expires, Reply-To, Sender, RFC1036| References, Control, Distribution, Organization. RFC1036| RFC1036| 2.1 Required Headers RFC1036| RFC1036| 2.1.1 Relay-Version RFC1036| RFC1036| This header line shows the version RFC1036| of the program responsible for the transmission of this RFC1036| article over the immediate link, that is, the program that RFC1036| is relaying the article from the next site. For example, RFC1036| suppose site A sends an article to site B, and site B RFC1036| forwards the article to site C. The message being RFC1036| transmitted from A to B would have a Relay-Version header RFC1036| identifying the program running on A, and the message RFC1036| transmitted from B to C would identify the program running RFC1036| on B. This header can be used to interpret older headers RFC1036| in an upward compatible way. Relay-Version must always be RFC1036| the first in a message; thus, all articles meeting this RFC1036| standard will begin with an upper case ``R''. No other RFC1036| restrictions are placed on the order of header lines. RFC1036| RFC1036| The line contains two fields, separated by semicolons. RFC1036| The fields are the version and the full domain name of the RFC1036| site. The version should identify the system program used RFC1036| (e.g., ``B'') as well as a version number and version RFC1036| date. For example, the header line might contain RFC1036| RFC1036| Relay-Version: version B 2.10 2/13/83; site cbosgd.UUCP RFC1036| RFC1036| This header should not be passed on to additional sites. RFC1036| A relay program, when passing an article on, should RFC1036| include only its own Relay-Version, not the Relay-Version RFC1036| of some other site. (For upward compatibility with older RFC1036| software, if a Relay-Version is found in a header which is RFC1036| not the first line, it should be assumed to be moved by an RFC1036| older version of news and deleted.) RFC1036| RFC1036| 2.1.2 Posting-Version RFC1036| This header identifies the RFC1036| software responsible for entering this message into the RFC1036| network. It has the same format as Relay-Version. It RFC1036| will normally identify the same site as the Message-ID, RFC1036| unless the posting site is serving as a gateway for a RFC1036| message that already contains a message ID generated by RFC1036| mail. (While it is permissible for a gateway to use an RFC1036| externally generated message ID, the message ID should be RFC1036| checked to ensure it conforms to this standard and to RFC RFC1036| 822.) The "; site sitename.domainname" will be automatically added by "Arn". SENDNEWS ~~~~~~~~ This is the command "Arn" invokes, if you want to post an article to the net, that means to send it to your newsfeed(s)/other sites. In detail, the article should be spooled in your spool-directory (UUSPOOL: with AmigaUUCP) with the necessary control-file(s) for your "uucico". It is IMPORTANT THAT THIS LINE CONTAINS two placeholder %s!!! It MUST BE "%s" (but without the quotation marks)! The first placeholder stands for the internal temporary article-name, the second for the NewsFeed-Name. At AmigaUUCP the line then looks like this: SENDNEWS uux %s "%s!rnews" If you don't need the second placeholder, then you should create a shell- script (with the +s flag set) removing the second "%s" by ignoring it: dummy.script: .key artname/a,realname/a .bra { .ket } .dot ~ ; Now invoke the program for spooling-news with {artname} only! postit {artname} Your SENDNEWS is then: SENDNEWS dummy.script %s %s SENDMAIL ~~~~~~~~ This is the program which spools the mail for your mailfeed/sites. Normally it would be "mail <%s", with AmigaUUCP it is "sendmail <%s -f user". Only one %s is required for the filename of the article. If your mail doesn't generate the "From:" line or requires other information, which "Arn" doesn't give, do it with a script-file! (Note: The script bit should/must be set...) Like this to append outgoing mails to a mail.sent-file: sendm: .key mailfile/a,username/a .bra { .ket } .dot ~ IF exists "{mailfile}" type >>UUMAIL:mail.sent {mailfile} sendmail <{mailfile} -f "{username}" ELSE echo "{mailfile} not found!" ENDIF SENDMAIL sendm %s rob then would be the right entry in ".arnrc". Missing From:-line: .key mailfile/a .bra { .ket } .dot ~ IF exists "{mailfile}" echo >T:MYTMP "From: fred@foobar.UUCP" type >>T:MYTMP "{mailfile}" sendmail <T:MYTMP ELSE echo "{mailfile} not found!" ENDIF RNEWS ~~~~~ This is the program that sorts in the article(s) for YOUR system. If you write an article, AmigaUUCP e.g. sends it off, but this article is not sent in your newsgroups. Normally the SENDNEWS- program (inews?) should do this for you, but if it doesn't, take "preprnews" and "rnews". preprnews is a little program from me: usage: preprnews articlename progname example preprnews T:tmpfoobar "rnews <" description: preprnews reads the article named "articlename" and cuts off the "Relay-Version:"/"Posting-Version:" lines, adds the "#! rnews XXXX" line and passes this new file (T:TMPXXXXXX) to the program "progname". Then the new (tmp)file is deleted. Your entry should look like this RNEWS preprnews %s "rnews " if you have the buggy AmigaUUCP V1.03D-rnews take the patched rnews2. RNEWS preprnews %s "rnews2 <" (Sorry: I didn't include it, because it would be too much waste... Patch it yourself, it's easy!: copy rnews to rnews2 Patch in rnews2 byte $4344 from $0A to $00, e.g. with newzap) However: this entry is not required and if your SENDNEWS sorts/sends articles at your system in your newsgroups, just forget this entry. 3. Invoking Arn! "Arn" should be invoked from the CLI. It has a few commandline-switches yet: Arn [-inp] Switches can be set together after one '-' sign or each single: "Arn -n -i" is the same as "Arn -ni". This example doesn't make sense: switches: -i print the version number and usage info. -n look for new-newsgroups -p starts "Arn" directly into "post article"-mode. After the article is posted (or not), Arn will quit. o Running Arn ----------- "Arn" will open its own one Bitplane-Screen (that is MONOCHROM or black/white). The Cursor is now the block in the same colour as your text. It will automatically get the correct Screen/Window-Size, whether you have PAL or NTSC (Arn looks for the gfxbase->NormalDisplayRows). At the moment the vertical-size is 80 Chars or 640 Pixels. "Arn" takes the default ROM- font (which is normally topaz.8). If all system resources could be opened and both Config-files (.arnrc and UUCONFIG) are correct, "Arn" will report "Initialization phase...ok!". Otherwise "Arn" prints an Error-Message to Standard-Error or its own Screen (if opened). Possible Error-Messages are explained in the section "Error-Messages". - Checking for new-newsgroups If your GROUPLIST-File doesn't exist, "Arn" automatically will ask you for the newsgroups, you want to read. It will get all available newsgroups from a file called "newsgroups" in your current OR on the "UULIB:" directory. At the moment, a support of an "active"-file is missing, because Amiga-UUCP doesn't create it. If you installed Amiga-UUCP this file already exists as UULIB:newsgroups. If you have an "active"-file you can just copy your "active"-file to UULIB:newsgroups and it will work. The newsgroups-file has the format: news.group foo.bar fred.test So just for each newsgroup-name one line. All entries following the newsgroups-names are ignored (if separated by TAB or SPACE). This is why an "active"-file will/could be accepted. Then "Arn" will read this "newsgroups"-file an check for missing group in GROUPLIST (you can force "Arn" to do this when starting it with "Arn -n" or by pressing "^N" which means CTRL-N at the newsgroup-selector). The sequence of presenting/scanning/reading newsgroups is determined by the sequence of the GROUPLIST entries!!! This procedure looks like this: foo.bar not in .newsrc! Put it where? (Top,(B)ottom,List,Nil,Quit): Inputs are NOT case-sensitive! You can type now 'T' or 't' to insert it at the Top of all existing newsgroups in your GROUPLIST. If you type 'B' or ANY other KEY than T,L,N or Q, the group is appended to your list in GROUPLIST. Type 'L' to list all newsgroup that are already in GROUPLIST. "Arn" will prompt now: Input NUMBER, Q or RETURN: You can now input a number which specifies the exact position of the newsgroup in GROUPLIST. The new newsgroup will be inserted AT this number. If you type 'Q', you'll stop the list-function and return to the "Put it where" prompt. Type 'N' to skip this newsgroup, that means it will not be put in the GROUPLIST. The scanning for further new groups is continued. Type 'Q' to quit asking for new groups which are not found in the GROUPLIST. -Scanning articles After this "Arn" will scan for articles in the Newsgroup-directories and prompt if there are unread/new news. Remember: The sequence of presenting/scanning/reading newsgroups is determined by the sequence of the GROUPLIST entries!!! At this time you're at the "newsgroup-selector", which means that you can choose which newsgroup you want to read. If a group is empty or all articles read in it, "Arn" will display "no unread news in newsgroup." If you have no ACTIVEFILE the scanning process is indicated by the message "scanning articles...be patient...". "Arn" will only scan filenames which are (the article-) numbers (filenames consist only of '1'-'9')! o Newsgroup-Selection ------------------- This is the prompt: "XXX unread article(s) in XXXXX.XXXX.XXXX. Read now? [Ynq]:" or "What now? [pnq]:" The most common choices are in brackets, where the default action is in upper case, i.e. if you press the space-bar "Arn" will react as you just have pressed the "y". Type the key you want (no return/enter needed!). A ^ directly followed by a letter means to press simultanously the [CTRL]-Key and the letter. For example: ^X means [CTRL]-X, but a single ^ means only the character itself. Key - Description y - enter this group and read next unread article. This will put you in the PAGER. see section -> THE PAGER n - don't read this newsgroup, continues the search for next group with unread news. p - search for previous newsgroup with unread articles. N - go to the next newgroup (no matter if all articles are already read). P - go to previous newsgroup (same as N, but in the other direction). 1 - go to the first newsgroup (in grouplist). ^ - go to the first newsgroup with unread news. $ - go to the last newsgroup (in grouplist). - - go to recently/previous scanned newsgroup (toggles). = - List subjects of articles in this newsgroup. To stop the listing of articles, press 'q' at the "[Type any key to continue]". g name - go to the named newsgroup. Resubscribe unsubscribed newsgroups this way, too. E - enter a new article to the net. "Arn" will ask you for the desired newsgroup(s), the subject and distribution. Then it will invoke your favourite editor (see UUCONFIG) and display the correct header. Now you can enter your text. If you quit your editor, "Arn" will prompt some choices which are described in detail at the follow-up function (see->ARTICLE SELECTION - how to do a follow-up). ^U - Unsubscribe this group! If your press this combination, "Arn" will not show you the news from this group any longer. This group is excluded from reading articles if you confirm "Arn's" question: "Really UNSUBSCRIBE XXXXXX? [y,N]:" You can resubscribe this group with the "g" (goto newsgroup) command in the newsgroup-selector, because it is NOT REMOVED from your GROUPLIST (to do this, try ^D)! ^T - Shows or hides the ScreenTitle. This key-combination toggles. It is very useful if you've more than two screens open, because there's no other possibility to click them in front. ^D - Delete this newsgroup from GroupList. Unlike ^U this command really removes the actual Newsgroup from the GROUPLIST. (after confirming: "Really REMOVE XXX from GroupList? [y,N]:"). ^N - Check for new groups. This command will force "Arn" to look in your ACTIVEFILE (if enabled), "newsgroups" or "UULIB:newsgroups" for new groups which still are not in your GROUPLIST. The procedure is described in detail above (see RUNNING ARN - Checking for new-newsgroups). h,H,? - activates a short help-list (stop with "q"). The help file must be available. It is VERY IMPORTANT to remember this command... To stop displaying the help-file, just press 'q'. q - Quit arn. "Arn" will update it's GROUPLIST and wait for you to press any key. X - Quits "Arn" without updating the GROUPLIST (Emergency-exit). To get to an EMPTY NEWSGROUP (i.e. with no or no unread articles), use the "g" command and "goto" the desired group. "Arn" will not complain if this group is actually empty, but will continue scanning for the next group with unread articles if you try to enter this group (press 'y')! This way makes it possible to unsubscribe etc. "empty" newsgroups. o The pager --------- "Arn" will display an article beginning with the line: Article XXX (of XXX) in XXXXXXX. ^^^ ^^^ ^^^ actual newsgroup ||| Last article-number in this group. Current article-number Then follows the header (that is the first lines until a newline is detected). The following lines are automatically hidden by "Arn" and can be displayed by pressing 'v' (verbose header): - Path: + References: + X + Nf- - Reply-To: All header lines beginning with these characters will not be shown. A prefix - means that line-continuation is not checked, a + means that it is considered. The "Subject:" is underlined. The text follows after the header and each line is carefully registered in its length so that "Arn" stops after your Screen is filled up (this is not the whole truth: "Arn" will always the next display n-1 lines, if your screen has a maximum of n lines, to let you always see/remember the last line from the previous page...). Even TABS are counted, so no text will scroll off the screen until you pressed a key! If the next line is very long, "Arn" can stop before the "last" line has been reached. If "Arn" detects a ^L (ASCII-12=FormFeed) it just will behave as it has reached the n-1 lines: it will stop and prompt: --- MORE (XX %) <XXX> --- ^^ ^^^ Article-number percent of displayed text After the article-number there can be some letters in brackets {}. This shows the article status (R for read,D for marked as deleted). or if the article contains only one page: "End of article <XXX> in XXXXXX (XXX). What now?[npq]:" ^^ ^^^number of unread articles in this group. Newsgroup-name Now you can enter some pager-commands ('h' or 'H' for help exists here, too!): ^R - restarts the current article. v - restarts the current article with a verbose header (see above). ^B - Back up one page. Displays the previous page scrolled off. Currently, this function supports only ONE page to back up! ^L - Redisplay the last page. Helpful after pressing 'h','H' for help. SPACE - SPACE BAR displays next page, if at the end of an article ONLY this key will mark your article as READ and searches for the next unread article ('n'). g pat - searches in this article for given pattern (*? wildcards) starting at the top. G - continue search for pattern ('see g'). TAB - will also display the next page of text, but does nothing if at the end of the article. Arn will continue displaying this article if you type SPACE or TAB. If stopped at an ^L (FF), it will display "^L" instead of the real code. The line limit is 1024 Bytes (then the line is not longer considered as one line!) o Article Selection Commands -------------------------- n - read next unread article (leave the current article unread). If no further unread article is left, "Arn" will prompt: "Reached last article! Reenter this group? (y/N):" This gives you the possibility to take once more a closer look to the articles in this group or whatever. If you want to read the next group just type 'N' or SPACE. (You see that the SPACE BAR will take you through the groups...) N - read next article if article is read or unread. p - read previous unread article (if none do 'n'). P - read previous article (read or unread, if none do 'n'). ^ - goto first unread article. $ - goto last artice. number - goto article with this number. A number is the set of '0'..'9'. "Arn" will enter the Command-Mode if you enter a number. Just press RETURN/ENTER after you typed in the desired number. "Arn" now jumps directly to this article if available or does nothing. ^F - search for next article with reference to displayed article. "Arn" will scan all articles with increasing numbers for containing the Message-ID of the displayed article in the References: line of the scanned article. If "Arn" is at the last article, it will continue the search at the first article and stop if the displayed article is reached once again. ^E - like ^F but in the other direction (scans previous articles, decreasing numbers and starts over at the last article). ^P - search for the parent article (first Message-ID in References:). Direction is the same as with ^E. If the displayed article is no Follow-up or does not contain a References:-line, "Arn" will do no thing. > - search for the next article (increasing numbers) refering to the same parent article. If no References:-line exists this function is disabled. < - same like >, but searching for the previous article (decreasing order). Currently only the "Message-ID:"-line is scannes, so that articles with "Article-I.D.:" are not noticed. /pat/mod - searches for pat in articles (default header only). Modifiers: c -case dependent search, a- search for pat in the whole article/text, h- search in header only. no wildcards allowed yet! Still a little bit buggy?!? ?pat?mod - for other direction. f,F - Invokes your editor and produces a FOLLOW-UP. (see also SCREENSW in .arnrc) This function should only be used if your answer is informative enough for the whole readership, otherwise you should prefer the REPLY-function. 'F' will include the original-article text, but with the QUOTECHAR inserted before each line! Quote only the important passages for easier remembering the subject, not the whole article! Try to summarize if possible. "Arn" generates a temporary file in your T: directory. The header contains all the required lines (RFC 1036) as RELAY and POSTING-VERSION (see "Installing-Arn - 2.Configuration-file"). All entries taken from the original-article get here with respect to the "line-continuation" (a header line can be continued if it begins with one or more TABS or SPACES). The "Newsgroups:" line contains the same newsgroups as the "FollowUp-To:"-line of the original-article (if exists), otherwise the "Newsgroups:"-line from the original article is copied. The "Subject:"/"Title:"-line is generated by inserting a "Re: " before the original "Subject:"-line, but only if this line didn't begin with "Re:" or "Re^". The "Reply-To:"-address is either directly taken from your .arnrc (REPLYTO) or UserName@NodeNameDomainName. The "FollowUp-To:"-line is identical with the "Newsgroups:" line. It should only contain one newsgroup-name, to direct the follow-ups into one group. The "References:" is either created or copied from the original article. The "Message-ID:" of the original article is appended (NO automatic wrap around of too long lines...). The "Distribution:" is copied unchanged. The "Organization:" is appended if available from UUCONFIG After a blank line you can write your text or the included/quoted text follows after a line like this: "In article <1234@foosite.foo.bar> Freddy Foobar writes:" (If the realname is missing, the address is taken instead). "Arn" doesn't support multiple parentheses like: "(Freddy Foobar (the world's best))" The RFC 1036 says that this should be avoided!! After you've finished your editor, "Arn" will prompt: "p)ost, P)ost (no signature), e)dit, n)ewsfeed, a)bort:" If you type "p", your SIGNATURE (from .arnrc) will be added to your follow-up article after TWO BLANK LINES. Then the article is sent to your SENDNEWS-program that is typically to your spool-directory respectively newsfeed. After that, "Arn" executes the RNEWS-program if the entry in the .arnrc exists/is valid. With "e" you'll enter your editor once more. With "n" you can specify another newsfeed as the one from UUCONFIG. With "a" you will not send this article to the net! The article remains still in your T: directory (T:ARN.XXXXXXXX)! r,R - Reply. Invokes editor and produces a reply ('R' for quoting text), that is E-mail (private-Mail). Attention: No "From:"-line is generated. This is normally the job of your sendmail-program (AmigaUUCP: sendmail -f user)...if this is nevertheless not possible, please try it with a script file (see above SENDMAIL) and write me which program has this problems. The principle is the same as with FollowUps, but this article then is sent as E-MAIL through SENDMAIL. The "To:"-address is created from the following lines: "Reply-To:" if available, otherwise "Return-Path:" if available, otherwise "From:" Two empty "Cc:" and "Bcc:" lines are created. The "Subject:"-line follows the same rules as in followup-articles. A line "In-Reply-To:" is generated containing the articles Message-ID and the newsgroup it is from. If quoting ('R'), "Arn" creates a first line of text like this: "In sub.culture.foobars, article <1234@foosite.UUCP>, you wrote:" If not quoting this line looks like this: "This is a reply to your article <1234@foosite.UUCP>, in sub.culture.foobars" After finished writing the article, "Arn" will prompt: "s)end, S)end (no signature), e)dit, a)bort:" The message "Sending mail..." is NO PROOF that your mail really will be spooled/sent off! You must be shure that your entry in .arnrc is correct and that this mail is really sent (try it once!). s,w name - appends article(s) to a file. "Arn" appends it to the file name in the directory SAVENEWS: (see .arnrc), if given, else to SAVENEWS:groupname if no name is specified! You can save it/them to other directories/devices by specifying the FULL-PATH NAME containing a colon ":". This even works for prt:, so you can easily print articles with "s prt:"! These commands can be preceeded by a range! Examples: (assuming SAVENEWS is UUCP:usr/rob/News and the current newsgroup is comp.sys.amiga) "s" - appends article with header to UUCP:usr/rob/News/comp.sys.amiga "w help" - appends article without header to UUCP:usr/rob/News/help "1000,1010-1040 s" - appends full articles 1000,1010-1040 to UUCP:usr/rob/News/comp.sys.amiga "s UUCP:tmp/help" - appends full article to UUCP:tmp/help d,x - mark article as deleted ('d' skips to next unread, 'x' stays at the current article). Don't use this function if you have an "expire" and an active-file!!!! D - remove the delete mark from article. u - don't mark this article as read. E - enter a new message (post new article to the net). "Arn" will provide to post a new article to this newsgroup. j - junk this article (mark it as read) and do 'n'. = - List subjects of (unread) articles in this newsgroup. To stop the listing of articles, press 'q' at the "[Type any key to continue]". C - Catch up. Mark all articles as read! Goto next group. ^T - Show ScreenTitle. This key toggles (show/hide). ^G - Show current newsgroup status. h,H,? - HELP. Display the help-text. q - Quit reading this article (let it marked read or unread). Stay in this newsgroup if any unread articles left. X - Exit and don't update the grouplist-file (Emergency break) range cmd: A range consists of one or more subranges: range= subrange{","subrange} with subrange= number[":"flags] | number"-"number[":"flags] [] means not once or once {} means any number off occurences (even none). special numbers: ^ first article, $ last article valid flags: U,u,R - unread ; r - read; D - not deleted, d - deleted cmd is one of =,r|j,u|U,x|d,D,w,s j,r - mark it read; u,U - mark it unread; x,d - mark it deleted; D - mark it undeleted; w,s - see above (save,write) o Error-Messages -------------- I hope that you'll never see any of them, but here they are: FATAL ERROR: Can't find/open intuition.library! FATAL ERROR: Can't open my screen! FATAL ERROR: Can't open my window! FATAL ERROR: Can't open a MsgPort! FATAL ERROR: Can't open the Timer! FATAL ERROR: Cannot continue! STRANGE ERROR: Something strange happend...! ERROR: Can't get my config-file, please check it! ERROR: Trouble at reading the UUConfig ERROR: During startup! ERROR: No SEQFILE?! FATAL ERROR: Can't get enough memory! ERROR: Can't find the NEWSDIR! ERROR: Can't find a newsgroup! ERROR: GroupList entry too long! ERROR: GroupList cannot be opened! WARNING: No NULL:-device mounted! Machine can crash! ERROR: Can't open the ACTIVEFILE! -------------------------------------------------------------------------- SORRY--SORRY--SORRY--SORRY--SORRY--SORRY--SORRY--SORRY--SORRY-SORRY The docs aren't finished yet! I hadn't enough time to do it! Try to find it out yourself with the online-help-function (arnhelp.txt). IMPORTANT: To get help just press 'h' or 'H' or the [HELP]-Key. The "arnhelp.txt" must exist. This will also work at the pager/article-selector (if you're reading articles). SORRY--SORRY--SORRY--SORRY--SORRY--SORRY--SORRY--SORRY--SORRY-SORRY --------------------------------------------------------------------------- Enjoy, Roland +----------------------------------------------------------------------------+ |R o l a n d B l e s s |UUCP: rob%spirit@impch.imp.com | |Duesseldorf - FRG | or rob@spirit.kref.sub.org (still testing...)| |voice +49 211 623817 |FAX: +49211623818 BTX:0211623818-0001 | |private UUCP-site |"They built machines that they can't control" STING| +----------s-p-i-r-i-t-s---i-n---t-h-e---m-a-t-e-r-i-a-l---w-o-r-l-d---------+