컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴 Oct'04 v4.9+ (c) Heimo Claasen REVOBILD 35 Rue du Marteau B-1000 BRUXELLES 컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴 =========== =============================================================== RE-READ.exe is a DOS text mode reader for mail and usenet files, Html pages =========== and just any text files: to browse items or files series, copy or edit copied text, reply to mail or to save (parts of) files. It offers directory listing to change between files and to do housekeeping with downloaded mail/news items and files easily, and to decode parts of, or attached, files directly (external decoding utilities are needed for decoding, though, as well as always an external editor). This file lists the available DOS command line switches, the sets of commands (or "hot" keys) in using the program, and some short hints for the use of core features like copy-pasting of mail/text, indexing, naming conventions etc. HOW IT WORKS The program has three basic working modes: DIRECTORY LISTING, ============ FILE DISPLAY, and INDEXing, with their own - and, where meaningfull, same - functions to be invoked with hotkeys. These command keys in each mode are either unshifted [Fnn] function keys or [CONTROL]-shifted such ([CTRL] + [Fnn] used together.) Only F-Keys 1 to 10 are used and their [CTRL]-shifted mode, and certainly the arrow keys, PageUp/Down etc. Letter keys [a] to [z] (not case sensitive) are used for drivenames, and inside some submenues. No [SHIFT]- or [ALT]-shifted keys are used, and there is no "pointer" (mouse, trackball, o.o.) support. The description how the switches and keys work is the subject of this file. For an overview of how the whole program and its the various features and work please see the joined RER-HOW.TO text file, especially for the naming conventions for external utilities to hook-in, and for the configuration file RER-CONF.RER and other external/auxiliary data files, like RER-KEYS.RER for changes of key bindings, and the template RER-CHAR.RER list for character remapping. ================================================= DOS COMMAND LINE SWITCHES to call ReRead from the DOS prompt or in a batch: ================================================= Normally the program would not need any parameters when called from DOS, and almost all settings can be changed from within. Preferred settings can be made permanent in the configuration RE-READ.USR file. There may be several RE-READ.USR config-files: the one in the directory from where ReRead is called is read first; if there is none, then any first one to be found on the DOS PATH is used. Command line switches will override defaults and the settings from the config-file(s); settings in Re-READ.USR will override internal default values. The following command line switches are applicable, e.g. in batch programs (write them separated by a space): -- to give a target path and/or filename: ----------------------------------------- [d:\path\]FileName.Ext = Source filename to read, or directory to be listed ! No command line switch char ("/") needed nor allowed with it. Path names should contain the trailing backslash ("\"); if this is followed by a single asterix (like in " d:\this\dir\* ") there is no additional prompt before listing that directory. -- for different file/folder formats to read/display: ----------------------------------------------------- /n = News/Mail: reads standard formatted eMail/Newsgroups message files, and defaults to plain "text" reading of the file otherwise. As this is the DEFAULT mode for ReRead to start up with, it's always never needed. /m = fuzzy formatted eMail-files (e.g., "digests"): force item separation /h = Html-Page, or Text if no mark-up found (no Header information is read) /sX- File-Series with either "FileName.*" or "*.Ext" given with the DOS call: /se-[d:\path\]*.EXT will use the same ".EXTension" to read all these files in the directory specified (or the current as default), /sr-[d:\path\]Filename.* will use the root FILENAME for all it finds there with different extensions. ! Do not give a separate target path\filename with this /sX-switch ! *!* ATTN: The functions for handling file series are not further developed any more, and some part of those are not longer working or outright broken (incompatible with newer functionalities.) Use the utility NM2BAG.exe ("Netmail-to-mailbag" from Revobild) to assemble all sorts of single, one-item mailfiles from downloads with Netmail or similar MTAs, to folder-type mailbags ! /L-nn = to set length of lines for quotes to be re-formatted and copied into a Reply file /q = sets (or leaves) the sharp around reply-eMail addresses /x = accesses the index listing directly (does not show the first item first) if it's a mailbag with more than one item /z = cleans a mailfile/folder of undue ^Z (or ASC 27, end-of-file markers) !!! Use with care, and NEVER on a binary, non-text file !!! It will replace ^Z (ASC 26) with space (ASC 32) in the FIRST file read ONLY. No internal setting possible, must be used with calling RE-READ from the DOS prompt, and will be inactivated after any first file read. (The "/t"-switch had been suppresses as from ReRead v4.1+) -- for different screen types: ------------------------------ /i = re-/invert screen video /v-nn = to set screen height (vertical) to nn lines; default is 25 lines /w-nn = to set width (length of lines) of text displayed on screen. Default is 80 characters per line. -- to change printer port: -------------------------- /p-N with N = 2, 3, or 4 (in DOS numbering); "LPT1" or "PRN" is the default. A number N to be used for any other "LPTn". -- *!* New (v5+): Write the auxiliary file(e) for mail/news fetch/delete: ----------------------------------------------------------------------- /f[=[d:\path\]filename] writes a file with the order numbers of mail items to delete to the disk, when leaving ReRead. If no specific filename is given, the default name FLUSHIT.RER is used, and it is written to the directory where the mail/news folder was is accessed. To create this file manually, use hotkey [F2] in INDEXING mode. All settings (and the licensing key) are read from the configuration file RE-READ.USR somewhere in the DOS Path, thus switches are seldom needed. But switches set at the command line will then override stored settings. The configuration file, RER-CONF.RER -!- new name, slightly changed format -!- will be looked for first in that DOS (sub)directory *from* which ReRead was called; then in a directory given with the commandline as a target; then from elsewhere in the DOS PATH. Thus there may be specific configurations files (e.g., with diffenrent lists for character remapping) in various (sub)directories, and a general one in the DOS PATH which is used if ReRead is called from any other directory.- The same scheme is followed with the other auxiliary files, RER-KEYS.RER for (changed) keybindings, RER-CHAR.RER and own others for lists of character remappings. ======================= DIRECTORY LISTING mode: ======================= [ESC] from this screen will exit to DOS. The CURSOR is on the filename highlighted, [ENTER] selects a file to read. If in a (sub)directory, moving the cursor to one of the lines with a dot only, and pressing [ENTER] will change the dispay to the next higher (sub-) directory. Moving the cursor to the upmost left position brings up a prompt in the bottom (status) line to input any drive:\path\[filename] to got to. [PgUp] in 1st column brings the cursor there, [HOME] to the dot-line(s). Command keys in directory listing: ---------------------------------- [a] to [z] - i.e. just any letter-key, changes listing to the drive designed by that letter and to the root directory there (no colon needed). [.] - the dot/period key changes to the next upper directory's listing, if there is one or, in the last instance, to the directory from which ReRead was called. (This is just to shorten use of arrow keys.) [SPace] lists other hotkeys and commands available with Directory Listing. [ENTER] reads in the file named under the cursor. [F1] - TOGGLEs header line filtering - see bottom/status line of the screen: changes reading with filtering ON/OFF for HEADer lines of the selected file (or mail folder) to be read-in. [^F1]- i.e. [CTRL] hold and [F1] pressed, will go out from RE-READ to the DOS prompt ("shell" to DOS); the program *stays* in memory. Type "exit" from a DOS prompt there to get back into RE-READ ! Mind that by changing to another drive:\path in DOS, you will change the "base" reference directory of the running ReRead too. [F2] - changes the TYPE OF SOURCE FILE to be read, and toggles through the four of them defined: - MAIL/NEWS for regularly formatted mailbags/mail folders (like MAIL.DLU) - FUZZY MAIL for "digest" type files of mail items, or for badly formatted mail items (parts of the standard eMail header missing, no single-dot single line as las one of mail items.) - FILE SERIES for reading all files with a same file rootname, or a same file extension, or even all files in a subdirectory, as a series of separate mail items. (NetMail stores incoming mail like that as numbered files with a same extension, MAILnnnn.IN.) - HTML/ASCII for just reading any text file. [^F2]- to activate and toggle character replacement for text to be displayed. Replacement character-lists can be defined in RER-CONF.RER the config. file (see below). A submenu on the status line allows to: -- (de)activate character replacement; the item on diplay has to be read-in anew then; -- change and reload pertinent char-mapping lists. Char.-remapping affects the _displayed_ text only, not the original. To save changed text, mark all or parts of an iem on display in FILE display mode and save via [F4] Copy-Append there. [^F3]- Hook-in to run another program named "HOOK2" with the filename under the cursor (and its path) as first argument, *and* two more optional arguments to input. ReRead 'shells' to DOS with "HOOK2 [filename]" as a first "%1" argument and additional arguments input as "%2" and "%2". The batch may run whatever program you write into it; searching for the batch name "HOOK2.BAT" follows DOS rules, i.e. first in the DIR listed, then in the one from which ReRead was run, then in DOS PATH. [F8] - a small setup submenu on the bottom (status) line to change settings. Adjustable are: -- Text display width (number of character positions used on screen) -- Text display height (number of rows used on screen) -- Word wrap (on/off) with text display -- Number of columns for directory listing display (1, 2, or 3) -- Printer port -- Mailer format (Nettamer or Netmail, and comparable header formats) -- Bracket setting/stripping with reply addresses for the mailer -- Reply line length for copied lines to be quoted in replies -- * Colour settings for text screen and status lines -- * Size and placement of the window to list buffer files(*) (*) The registering number sent with the RE-READ.USR configuration file (to be stored somewhere in the DOS PATH) will unlock some of the less important but pleasant display setting features, like full colour setting instead of being restricted to black-on-white or inverted in the free distribution, resizing and moving of the text windows used to display the index and the buffer file lists (marked with * above). Do *NOT* use the setting entries for colour and window size/position without the configuration file, and without the license number in it, and stored in the directory where ReRead is called, or at a place in the DOS PATH available for RE-READ: else input to these sub-submenues will drop straight out from the program to DOS. [^F8] *!* function suppressed in ReREad v4.91+ - use editing of config.file ! SAVE actual SETTINGS to a RE-READ.USR configuration file in the presently accessed directory. This function is only accessible through this hot key in Directory listing mode. There are some of the most current DOS-functions for FILE HANDLING available in the Directory Listing mode: --------------------------------------------------------------------------- SORT:[F3], COPY:[F4], EDIT:[F5], KILL/DELETE:[DEL], RENAME:[F7], PRINT:[F9] --------------------------------------------------------------------------- [F3] - Sorts the directory listing according to file root name, extension, or date. Defauts to ASCII-alphanumeric order of filenames; a given order scheme is kept until an new one is selected; subDIRectories will always be liste before filenames. [F4] - COPY is the DOS-like function of copying the entire file elsewhere. RE-READ does check against inadvertent overwriting of an existing file with the target name. (Use FILE DISPLAY mode to _append_ a file, or parts of it, elsewher.) [F4] prompts for a target PATH to copy the file to: it puts the last used path for filecopies there and adds the name under the cursor from the displayed directory listing. The first time in a run, it takes a pathname from the bufferlist PATHLIST.RER in the presently displayed directory; if there is no such it uses a default dir-name. The filename under the cursor is added to this path. A last used target path will stay in the buffer if not changed via [F4] again. ============================== There is a command key SUBMENU here, indicated on the 2nd. status line: ============================== -- [TAB] brings up a first target path from a buffer file PATHLIST.RER: this is an ASCII file kept (or eventually created) in the directory which RE-READ accesses at that instant. Cycle through the entries there with any key, select any path\(filename) with [ENTER]; or: -- [F4] pressed *again* brings up a point-&-select window to chose for target pathnames from this PATHLIST.RER. Move the cursor there with the Up/Down arrow keys, scroll pages in this window with the PgUp/ PgDown keys. If this PATHLIST.RER list is not established in the presently read directory, *another* keypress of [F4] will bring up the present or an earlier (for copies of files) accessed directory listing in this window. Command keys inside the selection window: -- [ESC] to exit the window of target lists; if a PATH-name had been under the cursor in the window, this one will be put as target path into the input-line in the bottom, plus the filename of the file where the cursor is in the presently accessed directory. -- Any letter key - [a] to [z] - brings up the root directory of listing of that in the target window; -- [ENTER] on any of the PATH-names to navigate. When the cursor is over a FILE-name, this one will be placed (with its path) into the bottom line as copy-target: thus it could be overwritten - so either edit this or navigate again in the directory tree. -- With pressing the [*] key you can select any *filename* under the cursor in this window for replacing the default PATHLIST.RER buffer filename. With the cursor back on the input line down: -- [ENTER] accepts the target path (and perhaps a different filename) quoted/input into the bottom line; -- [BACKSPACE], as key indicated by "[<--]", allows to EDIT this string of a shown; -- [SPACEBAR], indicated as "[SP]" key, will prompt for an input of a new, eventually fully specified target path\filename - DOS rules do apply with that, you need not type a drive name if the presently displayed directory is the same (but well the preceding "\"), and you can use ".\subdir\" if the target path goes to a subdirectory of the one from where ReRead has benn started. You can rename the copied file in the targeted path by typing a (new) filename after the target path. -- [+] will add the new (or edited) target name to the buffer file. -- [ESC] exits the cursor from the input line back to the dir-listing, aborts copy. Target names input or selected from the buffer lists are meant to be PATH definitions - and must have a trailing backslash therefore ! -; a full path\filename[.ext] specification can be given too, to copy the file to the selected path under another filename there. However, if you give a full file specification, mind that the copy *overwrites* any existing file with that same name (there is a safety prompt). The buffer file, PATHLIST.RER, may contain any DOS path (and even file) specification. If there is no PATHLIST.RER existing yet in the presently displayed directory, a new such buffer file there can be created with pressing the [+] (plus) key with any target path in the input line at the bottom. See the corresponding description of APPENDING file CONTENTS (linewise marked or as a whole) below, under the FILE DISPLAY section. Some more notes on the buffer files and their use are still further down. [F5] - EDIT: invoke the editor with the filename under the cursor as the file to edit. This is a "hook-in" which will run any batch program nearest in the DOS Path named as "edit". Write this simply as a one line batch, "[editor-prog.name] %1 [additional arguents if needed]". [F6] - a hook-in to run a program named "HLIST" (no extension) with just the filename under the cursor as an argument. "HLIST" can be an executable like HLIST.EXE (this is the original purpose: a quick HTML-viewer) or any HLIST(.BAT) which may call any other program to run. [DEL]- to DELETE the file under the cursor. There is a "security prompt" to confirm by pressing [y]; any other key will avoid deleting. [F7] - RENAME the file under the cursor. Prompts for input of (and just that; may NOT be used to copy/move to another directory). [F9] - Selects the file under the cursor for printing and sends the ENTIRE(!) file - as it is ! - to the printer. Use the print function in FILE DISPLAY mode to print only selected/marked parts of a file. ================== FILE DISPLAY mode: ================== SCROLL DISPLAY: -- Arrow [Up] or [Down] will scroll the SCREEN display 1 line up or down. -- [Page Up] or [PgDn] scroll the screen display 1 page each time. -- [CTRL]-[PgUp] and [CTRL]-[PgDn] will move to the start or end of the item currently displayed (or to start and end of a file if it's one item only). MOVE CURSOR: -- [Home] and [End] move the CURSOR up/down 1 line on the screen. -- [CTRL]+[Home] and [CTRL]+[End] move the CURSOR to the first or to the last screenline respectively. CHANGE / GOTO ITEM (No.): -- [Left] and [Right] will bring up the PREVIOUS or the FOLLOWING message, if the File Type is NEWS/MAIL (with several items), or the previous and next file of a FILE SERIES with the appropriate root or extension of selected series of filenames given. -- Normal NUMBERs - typed with keys [0] to [9] and concluded by [ENTER] - will bring up the corresponding news/mail items if there are several. Thus [1] or [0] goes to the start of the file containing several messages, a number given of the total number of messages (or any higher) will bring up the last item, some number in-between, the item numbered and contained in a bulk file. The number of the message presently displayed and entered again will read the item text in anew (e.g. with header switched on/off, or char-replacement switched). In File Display mode, the status or command line (the last line on the screen) displays the file currently loaded, the message number, and the total number of messages of a Mail/Newsgroup file (or the total number of files if the File-Type handled is a group or File Series with a same root filename or same extension). Command keys in File Display Mode: ---------------------------------- [SPACE] - HELP submenu for the [Fx] keys: list functions available via F-keys, and accesses (via [F8] again) to change settings. Exit from the menu with [ESC] or [ENTER], toggle helplines/key lists with [SPACEbar]. [^F1] - shells out to DOS; type "exit" at the DOS promt to re-enter RE-READ. [F1],[F2] - MARK start/end line of any displayed text to copy/edit/print/ decode: [F1] sets START or top mark at the line of the cursor, [F2] set END mark after, and including, the preceeding line. [F3] - UNMARK. [^F2] - TOGGLEs/SWAPs character remapping ON/OFF (both from File Display and from Directory Listing) as defined in the char.remapping list to use. A prompt on the status line ask to set ON/OFF remapping, or to swap its sense from left to right or inversely with reading the char-list. A further submenu allows to change/replace such lists; which have to be named in the config.-file as "CharSet = " entries. Type the current mail "Msg.#" to read-in the the item anew to display changes. This remapping works only with files/mail items which are read-in completely into memory; thus it is not applicable with "long" files. * This function works with a registered copy only * [^F3] - toggels WRAPPING of text according to set line length on/off. [F4] - COPY MARKED text - or *ALL* of the item, if nothing is marked !! - to the target or copy file (see below). The status line will ask for confirmation of a filename presently used as target, or allows input of any new such. (A more extensive section on buffers for these file- names, KEEPLIST.RER and its use is below and in the general docfile.) =================== There is a SUB-MENU available (as with Directory Listing): =================== NAVIGATING through directories (new functionality since v3.3+): -- [F4] pressed *again* pops up a text window which lists target path and file names from the buffer file to select from - if there is any such KEEPLIST.RER file in the presently accessed directory; a signal beep that there's none (yet). -- [F4] pressed *once AGAIN*, the presently accessed directory is listed in the target names window. Practical if current threads are kept there - no need to put them into the buffer. -- [a] to [z] LETTER keys pressed will put the root directory list of the corresponding drive into the selection window. -- [ENTER] with the cursor on any entry line in the buffer window: -- if this is a FILENAME.EXT: grabs this as the target filename and puts it (with its path) into the status line, thus defining the 'path\file.ext' where to append any text to; -- if this is a (SUB-)DIRECTORY name: brings up a file listing of *this* (sub-/higher) directory into the buffer window to select the target filename from, or to continue navigating. -- [*] instead of [ENTER] selects any FILEname under the cursor as a new filename buffer list (thus replacing or reloading the default KEEPLIST.RER for instance; each new listing erases the former content of the buffer window). -- [TAB] enters the names from that list to the input line too, and allows to toggle through the list (with any key but ENTER); this is an alternative access mode instead of using the pop-up window. -- [SPACEbar] empties the input line and a new target can be written in there directly; be sure to write the full drive:\path\filname specification if this file resides not in the directory from which ReRead hs been run (the "base" directory,in difference from the currently acdessed diectory.) -- [+] adds that target name from the status line to the list in the buffer file; if there is no such KEEPLIST.RER yet in the presently accessed directory, it will be created. -- [<--] BACKSPACE starts editing for \path\filenames in the status line. Remember that this copy function works as a text- and linewise APPEND to a target file. Marked text blocks - or ALL of the displayed file/ item if nothing is marked ! - will be ADDED to the named target file or a new file with this name (if the target file does not exist yet). Since ReRead v3.1 there is a point-&-select window to chose target filenames from KEEPLIST.RER, with another keying of [F4], though the alternative to bring up the buffer list with [TAB] into the selection line, and to toggle though the list there, is maintained. For some non-screen output gear this is preferable. !OBS! If you append a mail item to an already indexed folder, the old index will not longer correspond to the length and number of items previously indexed and registered in the joined index file. It has to be indexed anew; it may be updated (on a prompt in the indexing service) if added items are compatible to the mail folder format. Joining mail items, or pasting *parts* of them to a folder type of file (e.g. a thread) which you want to read then as a proper item of this sort, must be done with a minimum of the folder-type mail "format", including the "essential" header lines (Date:, To: or From:, Subjet: lines), *and* the item separator, usually the single one-dot line (or the "digest" item separator, the case being). Please see the specific documentation on indexing, RR-INDEX.vXX. [F5] - EDIT (marked parts/whole item copied before to) the "target" file: the key invokes an *external* editor program, with as an argument the filename present in the immediate buffer of the Copy/APPEND function; or if you just have created a reply-mail, that filename will appear as target in the status line. Press SPACEbar to empty that target name and to input another. (You can as well use [F4] first to pick any target name from the buffer file, or from the directory - go back with [ESC] to the file display, and then select [F5] to edit.) The NAME of an EDITOR Prog. you want to use is conditioned ("hard- wired") to "EDIT" - without any extenstion; so this can be any editor program found first in the current directory or on the DOS-Path, or a batch file to call the editor to be used, with a placeholder ("%1") for the file to be edited: RE-READ passes the full DOS specification - drive:\path\filename.ext - to it. When you leave the editor you get back directly to where you were before within RE-READ, thus switching back and forth is just one keystroke. The "target" file for the editor - the same name as the one for any copy to append to - will stay the same as long as you do not change it expressedly. Thus you can move around in a mailbag or thread of mails or between just any text files to assemble bits and quotes for some work in progress, and go back and forth between editing. [^F4] - TOGGLE reply formatting, see below after [F5]/[^F5]: [^F5] - [CTRL]+[F5], from the display mode for mail files, will create a new mail REPLY file: it takes the address from the presently displayed mail item, and the "subject" from there. If the mail header contains a line with a "Reply-To:" address, then his one is taken in the first hand. If the "From:" address is different from the "Reply-To:", e.g. in mailinglists, then mark the "From:" line with [F1] and press [^F5] then to select the list address instead of "Reply-To:" address of a list contributor for the reply. You can override any automatic selection of the "Reply-To:" / "From:" addresses by marking any line which contains a useable eMail address with [F1] *only* (i.e. the "top line" marker for copies; do NOT use any end-mark by [F2]). If such a line is marked/highlighted, [^F5] takes any first valid eMail address from there, instead of from the "From:" or "Reply-To:" lines. TO WRITE A NEW MAIL, use this feature with any address (list) - bring the address file up as displayed file, mark the relevant line with [F1], and press [^F5]. In fact you can take just any line in just any (text) file containing a valid eMail address for this purpose, thus it's not even necessary to edit a specific file in a specific way: if there is a "word" - i.e., an unbroken sequence of characters - which contains the characteristic "@" in it, this will be parsed out as an eMail address (but! - only a first such "word" in a line is taken. If you need more addresses, use [F4] copy function or an editor to paste them in, once the reply file has been created.) A status line prompt asks to confirm - just [ENTER] - or to swap (by pressing [SPACE]) the name of the reply mail file. Up to 10 different name templates can be defined in the RE-READ.USR config (see there!). ReRead completes the template with a running number and checks for already existing send-mail files (in the default or in the defined mail-out directory) and up-numbers correspondingly. The name of the Reply/new mail item is taken into the buffer for a current copy/edit filename: -- if you want to write/edit immediately, just press [F5] to invoke the editor with it; -- mark lines to copy from the presently displayed file to this new mail file, using [F4]. If it is a mail reply, a prompt proposes to use reply-formatting; press [SPACEbar] to switch reply-formatting off. You can switch this off/on at any moment with [^F4] too (see next). In reply to a Usenet/Newsgroups item a "post"ing mail head is created with the name(s) from the "Newsgroups:" line of the displayed item. !!! The header format and file template name presently (ReRead v4.1+) can be used only for Nettamer's posting function to newsgroups ! The "Subject:" line is from the original and a prefix "Re: " is added to the header line created; but you can edit this surely in changing to the editor directly with [F5]. If the file type is set (HTML/ASCII) for a file to read - and thus no header information from the displayed one is available - you can mark with [F1] any text line containing an eMail address (i.e., any "word" with the characteristic "@" in it) which is then extracted from that line and placed into the reply file as address to use. This way you can start to write any new eMail directly from an address list, or from reading just any text. You can order an additional RE-READ.DOC and an extensive MAIL-HOW.TO, for descriptions of the mail format, (reply-)mail headers and the various ways to address multiple copies and /CCs of mail. Using [^F5] changes the "target" file name in the buffer (used last for to append-to, or to edit) and places the appropriate mail file name there as target - you can immediately mark-and-copy lines from the original message to the Reply file, or go directly into editing this reply, calling your editor with [F5]. Note that reply files are created in, and reside in, the "base" DIR from which RE-READ was called and the name, placed in the buffer of targets to append to, will have the whole path to that DIR too; or the specific path for reply-files defined in the RE-READ.USR config. This allows to move through different (sub)directories and files to mark/paste lines to this reply file; any immediate/subsequent use of [F4] will bring up this target path\filename in the first hand. This is different from using the copy-append routine without having first created a reply file: [F4] (and input of a filename then) will chose, or create, a new file in that directory which is currently read, not in the directory where RE-READ was started from. Thus check the path given in the prompt with a file to append to, when this one is to be in another directory. Switch off the "reply formatting" in this case (there is a prompt). Marked lines for copy-append from the original are LINE FORMATTED as "replies" (if this is switched on), that is, with "> " as first signs on a line and a line length of max 76 chars (as default; this can be changed in Settings through the [F8] command key, or in RE-READ.USR). [^F4] - [CTRL]+[F4] TOGGLEs this reply formatting OFF/ON. Also any change to another message item will toggle off the reply-formatting (but will not change automatically the name, in the buffer, of the target file for copies, until another use of [^F5] or an own input via [F4] of a target-file name). [F6] - displays the INDEX LISTING of mail/news items in the folder or of the separate mail items read as files series. ==> With the switch set in the "RE-READ.USR" configuration file you can go directly into Index Listing mode from the outset of opening a mail folder. Otherwise and as default, ReRead immediately displays the first item of a mail folder. There is a sub-menu at the status line for different functions to use in INDEX LISTING MODE: =========SUB_MENU INDEX-LISTING============================================= KEYS USED IN THE SUB-MENU OF INDEX LISTING: =========================================== !! Many F-keys are used differently in this submenu !! == Keybindings here have been changed from v4.5+ on == - - - - - - - - - - - - - - - - - - - - - - - - - - - [SPACEbar] toggles through the menu/key-listing lines. [Up]/[Down] Arrow keys move the pointer/cursor (line in invers video) [PageUp]/[PageDown] Scroll index page-wise with 20 lines each time. The first/last lines will change with different start/end lines of the index listing; the chunk range (20 or less each) will change with smaller general setting for display lines.- [ESC] Exits from Index Listing back to the MAIL ITEM last read; when switching from mail reading to the index listing, the mail item read is at the top row of the index list-page shown. [ENTER] selects the mail/news in the cursor line to read (or go to). * [nnn] input any NUMBER (and hit [ENTER]) to move the index display to the entry for that mail item. - "0" or "1" goes to the beginning of the index, highest or any higher number of mails in the folder moves to the end of the index listing. * [^PgUp/^PgDn] goes to start/end of index listing as well. [F1] Toggles to show either "To:" or "From:" fields on the index line. ---------- * [CTRL] + [ENTER] Exits from Index Listing directly to the DIRECTORY Listing, and updates the index file. * [CTRL]+[BACKspace] Drops out directly to DOS, *without* any updating! ---------- Each index line shows either the number of lines, or a MARKER at the right end of the displayed line: [DEL] Toggles the DELete mark, " =d= ", for the msg under the cursor, * or sets any other marker OFF. [INS] Toggles the BOOKmark, " *** ", ON/OFF. * - Use this function too to extract/copy one item, and recompose the rest of the folder: see below for [^F6] ! - [+] Toggles the REPLYmark, "*r*" OFF/ON. *** and *r* serve as "keeper" too (unmarked is kept anyway). ---------- *! [F4] Copy(-append) the SINGLE ITEM under the cursor to a file/folder: This works as the append-copy task under FILE display mode, and allows a signle mail/news item from the folder to be appended elsewhere. (Target selection as described under FILE mode.) * [F7] SEARCH the index for a string (to input). This searches ONLY the Index file; mind that the index file stores From:- and To:- addresses and the Subject: line not completely but concatenated. (though somewhat longer than the short 1-line display per item.) * [^F7] searches THROUGH THE WHOLE folder for a string to input, and moves the coursor to the index line for a mail item found. The search string stays in memory and can be used to search through this item (just press [ENTER] and [F7] there again.) This search function includes header lines of mails too ! * [F10] GRAB a line from the index listing and edit it; result is used for searching. (Handling see below for [F10] in File Display.) [F2] updates the present index list (rewrites the index file) *AND* * writes a "bulk"-file for use with GETMAIL (a NETBAS script) that numbers all mail item (order) numbers to delete. This file, default name FLUSHIT.RER, will not be produced with the automatic index update when exiting a mail-bag file. With the command line switch "/f[=filename]" however, the file is created/updated with exiting from ReRead. (See GETMAIL doc) * [^F2] - as in file display mode - TOGGLEs/SWAPs char-remapping. * [^F3] likewise, toggles WRAPping in mail item displaying. ---------- =====Changing/Rebuilding the Mail Folder:============================ =====A confirmation prompt must be answered with the [Y]es key======= [F5] DELETES all =d=elete-marked items, rewrites the mail folder and exits to DIR listing, [^F5] rewrites the folder without delete-marked items and reloads it. ---------- [F6] APPENDS all not delete-marked items to another file (to select), and DELETES the old, original folder file and its index file. [^F6] extracts and appends ***bookmarked items to a file (to select), DELETES all =d=marked items and rewrites and loads the (cleaned- out) original folder. MAKE SURE THAT TARGET FOLDERS ARED INDEXED CORRECTLY BEFORE APPENDING NEW ITEMS ! ================================================================ ! Attention ! Whis joining to another mail folder: If the target folder is not indexed yet, an index is created there which will contain only the newly added items - and reading in this newly assembled folder-file will show only those new items. Delete the newly created index file (name.?_X) and re-index the folder ! If there had been an earlier but incorrect Index File there will be an error message - re-index the target folder before joining new items ! ===================================================================== ==== ! See seperate text RR-INDEX.txt on indexing routines ! ======== ==== ! Be careful with, and aware of, their use as these ============ ==== ! functions can discard mail items *definitely* ! ============== ===================================================================== With functions to join/append items to a folder, the selection window can be used as with the File Listing mode by pressing [F4], if needed repeatedly, for target names to store/append to. The same navigation rules apply. When switching from File Display into Index Listing, the presently shown mail item is always the one at the top of the index page shown, with the cursor placed on it there. =========end of submenu INDEX LISTING / continued FILE display mode:========== [DEL] - from File display directly: SET a DELETE mark in the index: This sets the delete mark unconditionally. (Change it in INDEXing mode.) [INS] - from File display directly: SET a bookmark/KEEPer mark in the index These keys only SET the respective marks, when text is displayed; to change these marks, go into Index Listing (with [F6]), where the same keys TOGGLE the markings. [F7] - FIND the line with a searched string of characters in displayed text. This is a rather crude search function, looking only for EXCACT matches; length of search string may not excede 80 chars. There's a beep if nothing is found else the display moves the line with a match found to the current cursor position. Repeat a following search for the same searchword with [F7] and [ENTER]; or input another. This routine cycles through all lines of the item/file displayed, and will eventually get to the line from where it was started if no match is found (with the "higher" beep in this case). [^F7] - search for the string IN THE WHOLE MAIL FOLDER. The next found item containing the search string is displayed. You have to press [F7] again, and [ENTER] to go directly to the line with the searched string. * Use [F10] to grab a line from the file displayed, or the index, to edit it and use it as the input for the string search - see below ! [F8] - SETTINGS submenue: Toggles, with [F1] for HEADer, [F2] for FILE TYPE, [F3] for word wrapping ON/OFF, and once more with [F8] goes to change a number of other settings - the number of screen lines to display, screen width (line length), the printer port to use, line length for Reply-formatted lines, toggle use (or not) of sharp with eMail addresses, buffer file window measures/placement, etc. (See the general doc RR-HOW.TO and the remarks in the configuration file, RE-CONF.RER (in earlier versions named "re-read.user".) [^F8] - presents a prompt to decode (UU/XX-, Base64-, HTML-encoded parts of) files displayed: Mark first, with [F1] the line from where-on, in the original, this file should be decoded. The auxiliary EXTERNAL UTILITIES needed for decoding various formats must be available in the directory from where RE-READ was called, or in the DOS PATH - * SEE THE RR-HOW.TO ! * The submenu offers a selection among 4 hook-ins, the (root-)filenames of which are "hardwired": [b] - B64DCODE -- e.g. for Base64 (MIME) decoding [h] - HTMSTRIP -- e.g. for decoding of HTML marked-up text [q] - QUOTPRNT -- e.g for reformatting MIME "Quoted Printable" text. [u] - UXDECODE -- e.g. for UU/XXdecoding [F9] - PRINT marked part - or ALL if nothing is marked ! - of a displayed item. To print just one line, marking with [F1] is enough, you need not use to mark the end with key [F2]. * This is valid too for the copy-APPEND routine using [F4] * [F10] - GRABS THE LINE AT THE CURSOR from the display, cuts leading or tailing whitespace, and puts it into the bottom/status line do edit it. The result - on pressing [ENTER] - will be kept in a buffer; this can be used: (a) as the search string with the FIND functions [F7]/[^F7], or (b) as the argument to write into an external file for use with a hook-in, in the directory from where ReRead was called, and under the filename "URL-NAME.RER". You can then - either by "shelling to DOS", or from DOS and outside of ReRead - access this saved sequence by any means, and specificly for launching of, or as input to, another program with the (text) contents of this file as an argument. This is what ReRead does when using [^F10], see next section. There is immediately an EDITING mode invoked for the text taken into the bottom line: It works in insert mode, any letters keyed are added at the cursor position; delete with the [DEL]ete or [BACK]space keys. *!* The Editing functionality here is specific for the purpose: Characters are always inserted, and the [INS]ert key has a special function: in file display mode, it JOINS A NEXT LINE after the marked text to the one already in the editing line (up to two additional lines) - this in order to join line-broken URL names. Use [DEL] or [BackSpace] in the usual way to erase characters. - [Home] and [End] will set the cursor to the beginning or end of the string, respectively, and move the string in the one-line editing "window" at the bottom line accordingly. - [^Home] will erase the part of the string BEFORE the cursor, - [^End] will erase the part of the string from and AFTER the cursor. - [ENTER] ends editing and accepts the string, and returns the cursor to the display, - [ESC] empties the string and goes back to the display. [^F10] - immediately to run after [F10] and the editing of the buffer line: This will launch another hook-in for any (batch) program with the name "GETHOOK2.bat" and the CONTENTS of "URL-NAME.RER" as argument: Thus if you put a batch file with the name of a program and the "%1" placeholder in the DOS PATH, it will be run by ReRead (by dropping to or shelling to DOS) as the batch file with the placeholder argument, as "GETHOOK2 %1". The edited buffer line is stored in URL-NAME.RER, which is just a temporary, one-line file in the current directory and can be used in any similar fashion. Mind that [^F10] "shells out" to DOS, and ReRead stays in memory; as ReRead will take as much memory space as its own footprint and that of the file/mail read there may not be enough free memory left to run a larger program, like LYNX (but HTGET would do fine, a packet driver has to be present then). In this case, modify the GETHOOK2.bat file so that it just *writes* another batch to run after exiting to DOS - press [^F10] to execute the batch, thereafter [CTRL]+[BackSpace] to drop out to DOS directly, and to run the newly written batch file to launch the Lynx with the appropriate URL. But see RR-HOW.TO for some tricky (trapping) aspects in this. ============================================================================== If you try out this version of RE-READ I would be interested to get critical feedback - and I would be glad if you decided to order a user license and find it useful to work with. ------------------------------------------------------------------------------ Please look for the newest versions at http://www.revobild.net ! 컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴 Oct'04 (c) Heimo Claasen REVOBILD 35 Rue du Marteau B-1000 BRUXELLES 컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴 =========== RE-READ.exe is (c) COPYRIGHTED and may only be used under licence to =========== the conditions specified therewith. No warranty is given. The programme develops continuously and the author would be only too glad to receive suggestions or to adapt it to special requests: write to the address or eMail to Heimo Claasen at ==> revobild [typographic-at] revobild.net This SHAREWARE distribution of RE-READ.exe is fully functional, except for some specific additional functions (colour setting, character remapping): THE LICENSED version can use these newest/added features ! To order: FROM: REVOBILD SEND: 15:00 EUR (or equivalent), Heimo Claasen by giro/transfer (net!) or cheque (if in 35, Rue du Marteau GB� or US$ add equiv. of EUR 11:0 for B - 1000 BRUSSELS bank fees and thank the Thatcherites): GIRO ACCOUNTs: Belgium: 000-1136823-80 (Postcheque) Germany: 0240744506 / BLZ 370 100 50 *** Payment through VISA/MASTER card: Please SNAIL the form below ! *** PROCEDURE: ADD EUR 2:50 (or equivalent) for SHIPPING AS DISKETTE (and *do* mention format: "360", "720", "1.2", or "1.44", as well as READABLE address!). Normal procedure: A licensed "ini-file" will be sent by eMail, which unlocks the free available version. A full package can be sent encoded by eMail too. That file - after eMailed convention about its name - could as well be set up and downloaded from the REVOBILD web place. 컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴 Oct'04 (c) Heimo Claasen REVOBILD 35 Rue du Marteau B-1000 BRUXELLES 컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴 < Print from here and send by ordinary mail - DO NOT eMAIL CARD DETAILS ! > ------------------------------------------------------------------------------ ORDER FORM To: REVOBILD / Heimo Claasen 35 Rue du Marteau B - 1000 BRUXELLES I herewith subscribe for a license for unlimited, individual use of the the offline reader program REREAD, by REVOBILD/Heimo Claasen, Brussels, accepting the program's condition as is, without any further warranties. Name: ................................................... Full Address: ................................................... ................................................... ................................................... eMail Address:................................................... I accept my VISA/MASTER card account to be charged with the sum of EUR 15:00 (or equivalent) VISA/MASTER card No: ......./......./......./....... Exprg:...... Date:........... Signature:.................................... 컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴