컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴 Aug'08 v4.94 (c) Heimo Claasen REVOBILD 35 Rue du Marteau B-1000 BRUXELLES 컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴 *** ==> NEW FUNCTONALITIES ! ATTN: Use of the COMMAND LINE SWITCHES (/sX-...) for the "FILE SERIES" type of file reading/indexing is not recommended with this version; the functionality will be scrapped alltogether - this version still reads in item/mail-file series if steered "manually" but it is better to build mail folders (e.g., with NM2BAG.exe from Revobild) and use the resulting mailbags (or Nettamer's *.DLU files or the Net$crape mailfolders) as the source files. =========== 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 is an overview of the program functions and lists the available DOS command line switches, the sets of commands (or "hot" keys) in using the program, and some basic explanations of the core features like copy-pasting of mail/text, indexing, naming conventions etc. ReRead will be further developed and maintained - so please look for a most recent version at http://www.revobild.net ! ============= WHAT IT DOES: - first of all "reading", listing mail and text (or HTML)files, ============= including "digests" from mail/newsgroups (separating mail items which are stuffed together without the standard header/end-of- mail markings), or digesting numbers of files downloaded from mailboxes and stored separately (e.g., with Netmail or -Pro). It tries to leave a maximum of screen space for the contents of text to read, and does not occupy more than an utmost minumum of just a line for its own behalf. Scrolling and moving around on the displayed text is as intuitive and functional as you would expect it - rather similar to V.Buerg's famous LIST. It does "housekeeping" -- stuffing mail items, text, files into their right places comfortably, with highly flexible copy/paste routines; reply to, or create mail to send (with Nettamer, Netmail Pro, and other mailer clients); to apply utilities for decoding received mail or downloads; do some tidying up (even purging unwanted ^Z from mailbags, for instance); and indexing mail items from the mailbags/folders. The indexing services have been completely reworked and largely inproved with ReRead's v3.2+ onward: index information is not taken into (DOS-)memory any more, thus huge mailbags can be handled. Once indexed - the time for this depends entirely on the speed of the disk which holds the file - it allows nearly immediate access to items even in very large files. Index files are rather small (two lines of 80 characters/item contained in the mail folder) and are readable and searchable with any text file lister. Please see the doc-file RR-INDEX.txt for details (which are not contained here), especially on the logical choices available, and on file naming conventions. There have been important changes and improvemets compared to earlier versions: *!* NEW from v4.1+ on: *** v4.5+ Feb'02 has (hopefully) most bugs fixed which made ReRead freak out to DOS with badly formatted text files like overlong unbroken lines of the type M$-Woid pseudo-"Text", or Unix/Linux files without CR for the DOS- (and Net-)regular CR-LF linebreak. Thus it now reads/lists *nix text files "naturally"; note that ReRead does treat them as "long" text files, and cannot filter headers or construct an index from them if they are folders. *** There's a SEARCH task now in the Index too; and searches can be done - both from mail display and from index mode - through the WHOLE mailbag/folder as well ==> see entries in indexing and file display mode for [F7] and [^F7] ! Searching is yet limited to one "literal", i.e. case sensitive string; which can be long though and may contain spaces. *** Grabbing a line from displayed file or index with [F10] - and editing this - can be used to input for search strings. *** CHANGED reply mail file naming: use up to ten different out- filename templates for the automatic REPLY mail creation. Names can be toggled on the fly (no cmd line switch "/t" any more !) ==> see FILE DISPLAY mode ==> [^F5], and Config-file comments ! *** Character remapping works both ways, thus can be even used for encoding to alien character sets. (HOT KEY works different !) ==> see FILE DISPLAY mode ==> [^F2], and Config-file comments ! *** Handling of "Change Drive" has been changed and improved, both in directory listing and in pop-up windows to select targets for drives/pathes for copies: simple keypress of a drive letter is sufficient now to change displayed listing thoughout, the period key [.] pressed changes to list the next-upper dir. ==> see GENERAL HANDLING and FILE/DIRECTORY mode ==> [F4] ! *** Remapping does comprise now (v4.6+) QUOTED-PRINTABLE mail text if switched on (see new switch in the configuration file, RER-CONF.RER, and additional information there.) REMark: This config.-file has been renamed from the earlier "RE-READ.USR" but the format of this text there has remained the same. However, there is only a short "stub" of some pairs of remapping signs left as a default fall-back, and more voluminous lists of signs can be used in the newly added facility to read in from the RER-CHAR.RER file, or from other files to be named in the configuration for this purpose: thus switching between remapping lists can be done on the fly. *** New entry in configuration file can reduce runtime footprint: ==> see remarks on entry "ManyFiles = nnn" in RER-CONF.RER ! *** v4.70 - Index listing now shows BYTES length of mails items (instead of number of lines, the normal mail-RFC compliant manner): Firstly, this serves better as a warning for really large files with those typically M$-produced mail formats which lack linebreaks, and with (ditto, M$-misfigured) HTML- texts/attachments. Secondly, ReRead recognises a first line (in a mail/news item of a folder file) like "+top nnnn" - it indicates in this case the total length "nnnn" of a mail item of which the header only, and some first files are downloaded and stored in the mail folderfile. (The AUTOPOP.nbs script for NETBASic writes this line as the first one with downloading "headers only" from a POP3 mailbox.) * (NEW from v3+:) ReRead will "expand" a digest file found inside a mailbag automatically now, provided it has been given the specific start-mark of items in this digest; mails/news then are presented singularly like any other mail in the folder. But there sure is a prompt to maintain the digest as one file to be copied and treated separately. (See the doc-file RR-INDEX) Overall you can use ReRead as well as a "shell" program for all mail and Net related tasks: call a mailer, do up- and downloads with FTP and WWW/web, then easily digest things, read, edit and keep order with all the files offline. * (NEW from v3.3+): Directory-branch navigation for look-up of pathes/filenames for the copy/append tasks. * (New v3.3+, improved v4.0:) A "grabber" for URLs, and a new hook-in to start immediately a program to get this file from the I-Net - very fast to work with, using HTGET or the LYNXes ! ==> see FILE DISPLAY mode ==> [F10] and [^F10] ! * NEW with ReRead v4.01 is an improved editing in this one-line "window" for the string to edit. See below, for [F10] and the verbose description in the RR-WEBIT.v4+ doc file ! * NEW from v4.02 on: Produces files FLUSHIT.RER and GETTIT.RER to use with the NETBAS script GETMAIL to automatically delete or fetch mails at a POP3 server. (See section on INDEXING.) ============ HOW IT WORKS The program has two basic working modes, DIRECTORY LISTING and ============ FILE DISPLAY, with their own - and, where meaningfull, same - functions to be invoked with hotkeys: these command keys are either unshifted [Fnn] function keys or [CONTROL]-shifted such, ie. [CTRL] + [Fnn] used together. Only F-Keys 1 to 10 are used, and certainly the arrow keys, PageUp/Down etc. The description how they work is the subject of this file. (There is no mouse/trackball support; yet.) There is an additional working mode for MAIL INDEXING available from/through the FILE DISPLAY mode and if this one is set to read mail/news folders. RE-READ adapts to FOUR different TYPES of SOURCE FILES to read: 1. Regularly formatted eMail or Newsgroups downloaded into folders or "mailbags", like Nettamer's "MAIL.DLU" (or Netscape mail "folders"). This is the default mode and that will mostly read/display just any (text) file, though then without recognizing if it is HTML or otherwise (or badly) formatted; 2. Irregular, non-standard formatted mailbags (with "fuzzy" header formats) containing a number of mail items, especially the DIGEST FILES from mailing lists and newsgroups. Chose this File-Type for forcing expansion of mail digests contained in one mail item; 3. "Series" of (mail) files with either same ROOTname or same file EXTension (like the numbered "MAILnnnn.IN" files from dowloads with Marc Ressl's Netmail); 4. All text files without any specific (mail) formatting; it checks with such files if they are HTML formatted and can invoke any appropriate, EXTERNAL utility to strip HTML mark-up and to display plain text. Please select the appropriate source type at the opening - with some badly formatted HTML files downloaded, RE-READ may choke if set to read mail or undecoded plain text. Use [F2] from any screen with a directory listing before selecting to open a file to read, or toggle the FILE TYPE at the prompt before opening a file, using the [SPACE]bar. ============= HOW TO RUN IT Call the program from the DOS commandline simply with its name, ============= D:\DIR> re-read -- or any other/shorter you rename it to -- from any DIRectory you are currently in; RE-READ should either be stored in that DIR or in another one on the DOS "PATH", so DOS can find it automatically. In principle it would not need any other parameters nor the "ini-file" RER-CONF.RER with any of the specific settings that can be stored in this configuration file. The opening screen will ask if you want to list the files of this or another drive:\directory. You then get a listing of the files in the chosen DIR. The status/bottom lines indicate available functions, among them selection, by using [F2], of the FILE TYPE to read. Move the cursor to the file to read, and press ENTER to have it diplayed. If the cursor is on an upper - [.] or [..] - or on a lower [DIR] entry, these will be listed. Change to next upper directory too by just pressing [.], the dot key. CHANGE DRIVE to navigate through the system be simply pressing one corresponding letter key, e.g., [g] to change to the listing of files at that root directory of drive G:\. Almost all settings - file type, screen colours, width/height, mail header filtering, etc. - can be set or changed inside the program. All can be defined permanently trough entries in the configuration file RER-CONF.RER; you can override some settings there with command line switches, or arguments, given together with the program name on the DOS command line. (NOTE for use from Windoze: the Win$-"DOS box" has a tweaked and crippled PATH searching capability. Put the RER-CONF.RER configuration file, or even an empty file of this name, in the directory Win$ shows when the "DOS-box" is opened; mostly this will be C:\WINDOWS>. Otherwise you might get just a blank opening screen when invoking ReRead.) This text here gives a summary of the functions the program provides and describes how the corresponding command keys work. Several aspects cannot be treated here, e.g. the intricacies of eMail(ing)/(formats) or the logic of housekeeping with memory and files - please look at the joined "RER-HOW.TO" and "INDEX" text files of the larger release package. There is a rather verbose, earlier doc file too, with the former, which tries to address some of the questions raised at the Nettamer and other mailing lists and newsgroups. ================================================= 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 RER-CONF.RER file. There may be several RER-CONF.RER 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 RER-CONF.RER 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 a file otherwise (DEFAULT; note that reading-in non-mail files with this file type chosen is a bit slower than using the HTML/TEXT setting as ReRead tries to find eventual mail item start/end markers and does some line formatting then.) /m = fuzzy formatted eMail-files (e.g., "digests"): force item separation. The separation string must be written into the RER-CONF.RER configuration. /h = Html-Page, or any Text if no mark-up found; the Header information is read and not filtered. /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; the default is to black-on-white. /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". All settings (and the licensing key) are read from the configuration file RER-CONF.RER 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, 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. =================== HANDLING IN GENERAL =================== Throughout the program, the [ENTER] key is used to confirm some command - for some critical ones there is an additioal confirmation or likewise -; and [ESC], the [ESCAPE] key will exit menues or a specific task, or the program. [CTRL]-[ENTER], written as [^ENTER], drops directly to directory listing from both File Display and Index Display modes. Use [CTRL]+[BackSpace] to drop directly to DOS (!tasks may not get finished!) Pressing the [SPACEbar] key will bring up and toggle listings of the available command keys or submenues. The status line, the lowest line on the screen (or the one set to it with re- sized display measures) is used for all inputs and messages from the program, or shows command keys available, with submenues that toggle then back to the status line. Use [SPACEbar] to eccess the "help" listings. Directory listing defaults to three colums onscreen, fully scrollable, with indications of current path, free disk place and space used in the presently displayed directory. The number of columns displayed (1, 2, or 3) can be set under the Settings menu or in the configuration file. Both in Directory Listing and File Listing mode, DOS can be accessed directly by using [^F1]: this "shells out" to DOS. A number of other program tasks offer "hook-in" possibilities for many types of external programs - the most important of which would be an editor - and for various decoding utilities: see the naming convention below. These "hook-ons" invoke external programs with the defined name (which could be a batch filename too) and with the selected filename under the cursor (from Directory Listing) - or a temporary file (from File Display mode) to which marked parts or the whole of an item displayed is copied to - as argument (like "edit %1", for DOS batch commands). These hook-in facilities can as well be used for other tasks, and RE-READ can serve well as a general shell program. It tries to occupy as little memory it needs - with not too large files loaded about 185 KB - thus you can easily run Nettamer, and certainly Netmail and other small mailer clients, from inside RE-READ directly. ======================= 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 ! [F2] - changes the TYPE OF TARGET 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 last 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]- TOGGLEs and swaps the character replacement for text to be displayed. The replacement list must be defined in RER-CONF.RER or in one of the RER-CHAR.RER remapping lists (see below). If changed when already displayed, an item/mail must be read in anew: just type the mail [msg.no] - shown at the status line - and [ENTER]. (***The remapping function is unlocked only with the registration key.) [^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 <[path\]filename> [arg1 [arg2]]". [F8] - a small setup submenu on the bottom (status) line to change settings. Adjustable here 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 RER-CONF.RER configuration (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 and invers in the free distribution, and sizing and moving of the text windows uses to display the index and the buffer file lists (marked * 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: input to these sub-submenues will drop straight out from the program to DOS otherwise. [^F8] SAVE actual SETTINGS to a RER-CONF.RER configuration file in the presently accessed directory. This function is only accessible through this hot key in Directory listing mode. (There is no indication for this yet on the help lines !) 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 are always listed first on top then followed by the names of files contained in the (sub)dir accessed. [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. [F4] _again_ prompts for a target PATH to copy the file to: it puts the last used path to a directory 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 as long as it is 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 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 drive 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 (and eventually the filename too) -- [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 on the same (but well the preceding "\"), and you can use ".\subdir\" if the target path goes to a subdirectory of the presently displayed one. 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 drive:\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 (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 copy-APPENDING content from files 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 with 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. !!!!!!!!!!!!!!!!!corrected up to here!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! ================== 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-in the item text anew (e.g. with header switched on/off, or character-remapping 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: [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.-list in RER-CONF.RER. A prompt in 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. Note that the character replacement list (at the anchor "Liststart" in RER-CONF.RER) must not be commented out ! 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 applicalble 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 bottom 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 presently accessed directory. -- [+] 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 mode for the bottom line. Remember that this copy function works as a text-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], but 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 RER-CONF.RER 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 RER-CONF.RER 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 RER-CONF.RER). [^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 "RER-CONF.RER" 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. * [^F10] sets all items in this folder to be DELeted: This changes the MARK only, the actual deletion is done only with the operations to effectively cleanu and rewrite the folder ([F5], [F6], etc.) * [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). ---------- * [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 for the string to input THROUGH THE WHOLE folder, 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 "bulk"-files for use with GETMAIL (a NETBAS script). These files (GETTIT.RER and FLUSHIT.RER) will not be produced with the automatic index update when exiting a mail-bag file. (See GETMAIL doc; delete these files if you don't use GETNAIL.) * [^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! Whith 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====================================== [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. The 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, RER-CONF.RER) [^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: not necessary the presently addressed directory thus. (*See* below !) [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 to 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. EDITING: 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 - see the template GETHOOK2.BAT joined in the "RR-WEBIT" docfile - then 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; you could do all that even automatically using an own batch file which first calls ReRead and then launches, for instance, such a "dolynx.bat" (if this is the name of the batch written by a GETHOOK2.bat batch file). ====================================================== BUFFER/STORAGE FILES "KEEPLIST.RER" AND "PATHLIST.RER" ====================================================== With its COPY/APPEND functions RE-READ can make use of stored target names for pathes to COPY whole files to - from DIRECTORY LISTING -, and for filenames (plus their pathes) for to APPEND marked parts, or whole mails, to a file from FILE DISPLAY mode. You can store in, and call up from, buffer files any number of target path or path\file names. From DIRECTORY LISTING, you can use (or create) a buffer file with path names to copy files to, with [F4]: enter a drive:\path\ specification - include the trailing "\" ! - and then add this target to the list pressing the [+] key, to the file PATHLIST.RER (this will be created if it does not exist). Any time you use [F4] to copy a file from the listed directory to somewhere else you can access the stored path-list by using the [TAB] key at the sub-menu given - this will bring up the first path name stored in PATHLIST.RER, and any further keypress will toggle through all the pathnames listed there - or [F4] again to pop up a window listing the target path-names: [ENTER] to select one. The file highlighted under the cursor in the directory listing will be copied to this location. Note that this is the DOS-like COPY routine which MAY OVERWRITE an existing file with the same name in the target path ! There is a security check and ensuing prompt, to avoid this. From FILE DISPLAY mode a similar routine applies to copy-APPEND to targets, which are FILES: the names are stored in a buffer file, KEEPLIST.RER, which can be accessed with the same sequence - first [F4], then [TAB] (and then any key to toggle through) or [F4] AGAIN to show a window with the target names to scroll through and select from. Remember that the copy routine from reading a FILE or mail/news in RE-READ will append to, not overwrite, a target file. Target filenames in that buffer file should be complete "filespec", i.e. the drive:\path\filename.ext; input accordingly if it's a new target. Both buffer files, PATHLIST.RER and KEEPLIST.RER, are specific for the (sub-) directory handled at the moment, and reside there: you can maintain different buffer files of target names in various directories, depending on the tasks to do - housekeeping for instance with directory maintenance, or ordering mail and usenet items from mailbags downloaded to different directories with using different ISP accounts. PATHLIST.RER and KEEPLIST.RER are plain-text files and can be edited with any clean editor. Format is simply one path or [path\]filename per line, resp. If the target to copy/append to is not contained in the list of the buffer file but somewhere else on the disk(kette), then press [F4] *again* while the buffer list is displayed in its window: This will bring up a listing of the presently accessed directory into the list window - move the cursor to the possible target and press [ENTER] to grab this target filename to the status line. You can edit the target filename there, or go back and discard this target name. If you [ENTER] with the cursor on a higher/lower directory, the display will be updated correspondingly. Access other drives directly by typing one of the letter keys [A] to [Z] when the selection window is desplayed. [ESC] will exit the cursor from the buffer file window (and can copy a taerget name from the window to the editing line too). You can invoke another target list - instead of KEEPLIST.RER and PATHLIST.RER respectively - in either state with the [*] key: This replaces the list by the one selected and shows it contents in the filename selection window. The idea is to keep those filename lists to pop up in the window manageably short - any very detailed, but less often accessed cluster of files to copy/append to, can then have its own list, residing (and accessible) in the current or any other directory. ============================== CHARACTER REPLACEMENT (TABLES) ============================== With reading-in single mail items you can switch on/off (with [^F2]) remapping of characters and strings for display. This does NOT change the original mail or file content but only the display on screen (and the way ReRead keeps the read-in item in memory) - correspondingly, if you copy-paste the whole item (without marking lines) elsewhere, the original char.set is copied; if you copy/paste *marked* lines, then the *displayed* character set is copied. The translation list must be included in RER-CONF.RER, the configuration file. Define any number of characters or of signs (max length 8 positions) between the "Liststart" and "Listend" lines there (max number of exchanges is 255). There may be several substitution lists but only the first one where the key word "Liststart" is not commented out (by a semicolon like: ";Liststart") is used in the actual run. The char-list must be the last valid entry in the config.-file, RE-READ ends reading it in after the "Listends" tag. [Further versions may offer means to change between char.-lists on the fly.] The replacement logic is simply to replace what is left on each line, before the equals sign "=", by what is right of it. Thus it's one list-line per character, or per string: the "entities" may indeed be up to 8 char.s long. (Leading and trailing spaces are cut but there may be spaces surrounded by other char.s). *!* NEW since ReRead v4.1 *** is the possibiity to SWAP the direction of this replacement, from the left to right entries of the list or inversely. Which allows thus to ENCODE or remap own text to other char-sets. Single char.s can be written "as is", or in round brackets using their ASC no. (i.e. the position from 000 to 255 in the usual 8-bit char. set). For instance the following lines give the same result of exchanging a backslash in a text file to a forward slash displayed in RE-READ: \ = / (092) = / \ = (047) Other examples: & = & (for the HTML-"entity" of "&") ä = � (the HTML entity for minor a-Umlaut) =E4 = � (the Quoted-Printable entity for minor a-Umlaut) Character translation is done with *reading-in* of items; replaced char.s are only contained in the DISPLAYED lines, thus not changed in the original. Accordingly, the changed char.s are only preserved in a copy if this *display* (i.e., the lines taken into memory), and thus from copies of "marked lines". To use the feature to reformat a whole text, first mark from the top to the last lines displayed, and then copy(-append) to a file (with a new name), with character remapping activated *before* reading-in the original. (The copy procedures themselves are not influenced by the remapping function.) *!* NEW since v4.6+ is the possibility to enter QP (quoted-printable) entities - like "=E4" for "a-Umlaut" - into this list; a selection of 30 most occurring char remappings for French accented letters and German/Scandinavian Umlaute is included in the template RER-CONF.RER configuration file. The basic adaption of QP-induced line breaks is done conveniently (you should NOT place a remapping entity for "=20" into the char list !) but MS-produced pseudo-"quotded-printable" is an abominable mess in that respect; probably resulting from the miserable file format of the used "composer" there - line breaks appear (or lack !) almost completely arbitrary, and certainly not at meaningful places... So do not expect ReRead to correct the absolutely crappy layout from the M$ Outhouse Exploder. ========================= PROMPTS AND SOUND SIGNALS ========================= Where reasonable there are visual confirmations of sorts, for any action from selected routines: the status line (last line at the bottom of the screen) goes back to its former state, or shows some symbol for actions that takes time (with copying for instance) - some dots, or a "...please wait..." or so. There are some - few - sound signals where this seems not feasable or where special attention is requested: a lower key "A" (400 Hz) as a confirmation of a task done (with creating a Reply mail with header, for instance), or in order to make attent for a waiting input (e.g., to confirm deleting a file). A high pitched "A" (800 Hz) is used as a warning sound: with invalid filenames for copies, pathes to change to, or other error conditions. ======================== AUXILIARY PROGRAMS USED: ======================== As for editing and HTML decoding, RE-READ needs external utilities to decode transfer-encoded files, like UU/XX-, Base64-encoded attachments, or parts of files, when using [^F8] to decode "on the fly". The names for these programs are fixed inside RE-READ to their root filename: HTMSTRIP -- for decoding of HTML marked-up text UXDECODE -- for UU/XXdecoding B64DCODE -- for Base64 (MIME) decoding QUOTPRNT -- for reformatting MIME "Quoted Printable" text. You can use any appropriate utility program for these respective tasks, which may be even batch files with commands to call these utilities with their proper name and specific arguments. RE-READ calls the utility with the fixed name mentioned, and creates a copy, a temporary input-file "RER-TEMP.$$$", as well as the name of an output file; both names are given as arguments to the utility to be called: the temporary input file is where the marked part of the original is copied to - or the whole message (with mail reading, or the whole file with one text read) -, and thus the original mail-file remains unchanged. The decoding utiliy will use this RER-TEMP.$$$ as its input file to work with. MIME/Base_64 decoders mostly take the name for their output file from the "name=..." line of the MIME header, and would give an error message to any other (given) output filename; best thus to use that name (which is in plain text in the header) as output file to read then - don't bother about any error messages from the decoder regarding output filenames: you can always adjust the target filename for decoded items, to be read with the editor, in a following step. In fact you can "hook in" just any utility (or batch to run such) with one of these fixed root-names; it is called with the temporary copy file as name in an argument, regardless if that is needed or not (and the temporary file will be deleted afterwards in any case). =================== Further Development =================== Bugs -- there are and must be some -- and inconveniencies of handling have to be dealt with ... the author will be grateful for any critical feedback especially about ergonomical aspects; many key bindings for instance can be changed. The licensed edition comprises an "ini" file, to be put once and for all somewhere into the DOS PATH, which defines all settings and function/command keys bindings, and unlocks a few, lately added features which are not yet functional in the free distribution (other colour setting than the black/white inversion, placing of the buffer files window, and the use of character remapping). A major revision of the complete lay-out (which will not be finished very soon though) will dissolve the hitherto fixed status lines, and make the whole display adaptive to any number of columns/rows, leaving the whole display for either text or directory listings. (Which implies moving the indications of available function/hot keys into pop-up windows; at the same time, these key assignments will be completly re-mappable.) If there is any demand for it, at least the doc/explanation could be written in another language too (German, French). It would demand *very* much work to change all English indications inside the programm; however, you can order your licenced edition with pop-up HELP screens containing short definitions of command words and terms in a specific language - German, French, Dutch, Swedish, perhaps even Portuguese or Spanish - if needed; please write ! ============================================================================== 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. ------------------------------------------------------------------------------ * To remember: A Program is Just a (Big) Bug that Happened to Work.* ------------------------------------------------------------------------------ Please look for the newest versions at http://www.inti.be/hammer ! 컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴 Dec'03 (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 ==> hammer@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: 12:80 EUR (or equivalent), Heimo Claasen by giro/transfer (net!)or cheque (if in 35, Rue du Marteau GB� add 5 � for bank fees and thank all B - 1000 BRUSSELS the Thatcherites) to: 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. 컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴 Dec'03 (c) Heimo Claasen REVOBILD 35 Rue du Marteau B-1000 BRUXELLES 컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴 ------------------------------------------------------------------------------ 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 12:80 (or equivalent) VISA/MASTER card No: ......./......./......./....... Exprg:...... Date:........... Signature:.................................... 컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴