----------------------------
r01 - PROGRAM INFORMATION
----------------------------
R01 is a text editing program for DOS & Windows. It has room
for 8,000 file records and/or around 325,000 file bytes,
depending on how much DOS memory is available. R01 never
turns down a file - it will read in only a section of the
file, if there is not enough room. Its record file lines are
159 characters.
If the records are longer than 159 characters, r01 chops them
up into segments. These are numbered, and flagged in the
edit mode. When the file is output, the segments are put
together and the bunches of segments are written as
individual records. This chop and glue technology may be
different and sound strange, but works.
R01 is used to make and upkeep web pages. Originally, it was
made to re-format records in files from an OCR program, from
output from a scanner. Its original function was to change
line lengths of text and condense some of the blanks. It has
a mass merge function to help put together the strange output
from the OCR software. Other functions have been added.
There is a unique file hunt technique; this is the directory
report option, is for checking directories for files.
For processing, r01 uses three different screens: edit,
browse, and graphics. The graphics need a VGA monitor, and
put a compact picture of r01's file area on the screen.
-------------------------------------------------------------
DOS Based
-----------
r01 is a DOS based program that runs under Windows 95/98 and
can run in a MS-DOS only environment. Under Windows, it runs in
a DOS window, defined by a PIF (program information file).
------------------------------------------------------------------
..........Operating r01 ............
The Option Table
-----------------
This is the options table that springs up on the lower part
of r01's main screen. It appears whenever the Enter key is
pressed; its purpose is to make r01 easier to use:
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
| Input Edit Position Truncate Blanks Lines move |
| Output Swap Even Page Re-format Max len move |
| 1st Record Delete Search Sort Recs String move |
| Last Record Move Right Dir Report Interval Merge Min len move |
| Exit Move Left Lines/Screen Graphics Info De-seg lines |
| Clip Portal Line Nmbrs Info Bar Graph Recs Seg lines |
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Main Screen Standard Options
------------------------------
Key Functions
======== =============================================================
arrows move screen thru data by paging or scrolling
b defines 1st record of output file
c defines last record of output file
space turns on/off record numbers on right edge of screen
m moves intervals of lines to region, starting at target line
w moves only lines of given length, or shorter
W moves only lines of given length, or longer
S moves only lines having a given character string
a forces lines to be non-segmented
A forms a segment bunch (segs: 1->n), from an interval of lines
d truncates/deletes records
i inputs files, changes current directory
0 outputs files, changes current directory
2 toggles between Macintosh & Windows text file input
x exits program, gives one warning
e edits into a line
l defines how many records will be displayed on main screen
r searches file area for requested strings
s swaps character strings in intervals of lines
p positions screen onto page with selected line number
\ squares up screen on an even page boundary
/ enters edit on last line edited
F12 enters edit on last line edited
) moves all data on selected lines to right
( moves all data on selected lines to left
t for pasting from windows clipboard, in DOS window
-------- -------------------------------------------------------------
Editing Screen
---------------
Key Functions
======== =============================================================
arrows moves pseudo cursor up, down, left, right on file lines
Home moves pseudo cursor to front of line
End moves pseudo cursor to end of line
Delete starts delete mode
Insert starts insert mode
Esc exits edit, saves changes made to line
F12 exits edit, saves changes made to line
Enter puts Edit into Option mode:
m merges another line onto edit file line
e jumps edit to requested line; doesn't save current chgs
c chops off line at point of pseudo cursor
y chops off line & copies chopped off part onto next line
r inserts, into line, last deleted line section
Enter saves changes that have been made to line
x exits Edit, does not save changes
z copies contents of line to other lines
l inserts an empty line after edited line
j adds/deletes/changes line segment number - `0' deletes
Space moves line and its contents to never-never land
s swaps character strings in line
t translates uppercase to lower case - works on intervals
-------- --------------------------------------------------------------
The File Input Routine
----------------------
On file input, several things happen. First, a number of r01
file lines, to be chopped off the front of the file, is requested.
The program will skip these many r01 file lines of the input file,
where a r01 file line is up to 159 characters of a file record,
but is often simply a file record.
Then the file is checked for having binary characters; if so,
it is flagged as being a binary file. Always, text formated
input is treated as text data & text records.
Finally, the file is checked to have been all read in. If
not, including any data skipped by request, a lost data report
box appears on the main screen. Also, a binary file warning box
can appear on the screen, and a low memory warning can appear.
For binary input, some special characters are converted to
blanks; these are the char(7), char(8), char(10), char(13).
Binary zero's are converted to char(249)'s, the 'ù'.
The 'w' or 'm', on the top line of the input option box tells
whether the routine is prepared for Windows or Macintosh text.
------------------------------------------------------------------
Special Functions From Main Screen
----------------------------------
Key Functions
======== ========================================================
- eliminates trailing blanks from lines
R re-format option
re-defines line lengths of data; condenses blanks and
changes lengths of lines. Accepts an interval to
reformat, target for reformat, and a new record length.
Needs blank lines between paragraphs, to keep the
original paragraphing.
u sorts an interval of lines; sorts on a selected
character positions and string lengths; sorts on up
to 4 sort fields.
y merges intervals of lines onto other intervals of lines.
Can be used to duplicate an interval of lines.
v starts the directory report.
-------- --------------------------------------------------------
The Directory Report
---------------------
The report appears in a 45X25 character box in the left part
of the screen. The fields covered are name, file attributes,
file size, and when last updated. Also, directories and disk
labels are flagged. The entries are chronologically sorted,
from earliest to latest. The last entry is the `disks' line,
where the computer's disk letters are listed. The first line
is always the directory of the report.
The directory disk can be changed by positioning the white
print over the disk letter and pressing the enter key.
Key Functions
p changes directory via key input
up/down moves selected entry (in white) up/down report
paging pages report 17 entries up or down
pge+Cntrl sends selected entry to top or bottom of report
Enter changes directory or reads file
x exits directory report - is rather a dummy function
others exit directory report and use key for browse screen option
----------------------------------------------------------------------
Rough Sample View of r01's Directory Report Sub-Screen
------------------------------------------------------
+=name attribute size updated===+ APTIVA 24 files 25 dirs
|WINDOWS Dir 9-20/00 11:02a| c:\
|UBASIC Dir 3-22/01 14:35p|-----------------------------------
|READER Dir 3-31/01 10:48a|
|CONFIG.SYS 338 5-07/01 14:23p|
|PHOTOMPK Dir 8-09/01 7:56a|
|NTSCPE Dir 8-15/01 11:26a|
|BOOKS Dir 3-05/02 8:35a|
|WINZIP.LOG a 115 4-11/02 13:57p|
|ZIPS Dir 5-27/02 10:23a|
|REF Dir 6-08/02 13:47p|
|GRAB Dir 6-08/02 13:51p|
|SCPH Dir 8-14/02 13:15p|
|PCDR.LOG 3,884 8-29/02 0:49a|
|CMPL Dir 9-17/02 6:25a|
|WINDOW~1.BMK a 63 9-26/02 0:58a|
|BOOTLOG.PRV ah 32,655 10-30/02 10:35a|
|BOOTLOG.TXT ah 32,655 10-31/02 1:07a|
|INFO Dir 12-09/02 7:33a|
|AUTOEXEC.BAT 736 2-06/03 6:00a|
|PACIFIC Dir 2-08/03 11:01a|
|SCANDISK.LOG a 11,895 2-20/03 8:38a|
|ATIMPP.LOG a 101,760 3-04/03 7:33a|
| disks: a b c d e f g h p z |
+============================100% ==========+
Graphics Screen Options
-------------------------
Key Functions
======== =======================================================
left moves graph pointer 24 records to left
right moves graph pointer 24 records to right
comma compresses graph, in steps
dot expands graph, in steps
space brings graph to zero position, max compression
1-9 moves graph pointer to digit hundred: 100, 200, etc.
F1-F9 moves graph pointer to digit thousand: 1000, 2000, etc.
x exits graph - is rather a dummy function
others exit graph, enters browse screen, uses key as browse option
-------- ------------------------------------------------------------
Key Memory
-----------
Several of the keyboard input functions use a memory of previously
keyed in strings. The memory uses the regular cursor movement keys:
Left, Right, Home, End, Backspace. It uses other keys, as well:
Key Function
------- -----------------------------------------
Up scrolls backward thru key memory
Down scrolls forward thru key memory
F5 deletes memory entry & scrolls backward
Enter enters the key input entry
F4 moves scroll to the blank entry
Tab same as Down key
Esc same as Up key
F1 same as Enter key
F2 same as Left key
F3 same as Right key
--------------------------------------------------------------------
Key Memory holds 17 entries, does not work for input of line numbers.
Browse Screen Information Bar
---------------------------------
Clock is on first line.
Second line:
Left to right, field contents:
File name
File size
First line number in file --> Last line number in file
[ max nmbr of lines X max nmbr of chars/line ]
Program name
Line number of top line on present screen
Number of lines on screen pages
----------------------------------------------------------
Other Notes
------------
* An odd message occurs during an i/o use, when the first record of
the file is not 1. This is to lessen operator error.
* You can use the full path name for the file name to over-ride the
current directory.
* The len parm of the delete option is for how much is left of the
original line, after the function has operated.
* Generally, to get out of a function, press the Enter or 'x' keys.
* The edit wrap around may take some getting use to. It is there
so the whole line can be seen on one screen.
* r01.exe accepts a file name as an input parameter - it will attempt
to open and read the file.
* Be carefull with move, it can be tricky.
* You can bring in info from the Windows clipboard by using the
clipboard portal; then use the Windows DOS screen toolbar for
pasting. You can also 'copy' from the DOS screen. See info
in Windows Help, under DOS.
* The program is for all files - but r01 should NOT be used to
update binary files, as some binary info is altered on input.
* The lines per screen may change - the program does this when
calculating the optimal number.
* The line segments, if any, are re-numbered automatically,
starting at one for the first segment.
* On the graphics screen, the text color can change; each disk
is given a color, for added uniqueness.
----------------------------------------------------------------------
