home *** CD-ROM | disk | FTP | other *** search
-
-
-
- ▄▓▓▓▓ █▀▀▄ ▄▄ ▄▄▄ ▄▄▄ ▄ ▄ ▄▄▄ █ █ ▄▄ ▄▄▄ ▄▄▄ tm
- █▓▓▓▓ █ █ █ █ █ █ █▄ █▀▄█ █ █ █ █ █ █ █ █ █▄
- █▓▓▓▓ █▀▀▄ ▀▄▄▀ █▄▄▀ █▄▄ █ █ █ █ █ █▀▀█ █▀▀▄ █▄▄ presents
- ▀▀▀▀
-
- ▄▒▒▒▒ ▀▀█▀▀ ▄▄▄▄ ▄ ▄ ▄▄▄▄▄ █ █ ▄ ▄▄▄▄ ▄ ▄ tm
- █▒▒▒▒ █ █▄▄ ▀▄▀ █ █ █ █ █▄▄ ▀▄ ▄ ▄▀
- █▒▒▒▒ █ █▄▄▄ ▄▀ ▀▄ █ █ █ █▄▄▄ ▀▄▀▄▀ Version 1.0
- ▀▀▀▀
-
- ▄░░░░ DOCUMENTATION
- ▀▀▀▀
-
-
- Online scrollable textfile viewer for
- RemoteAccess, QuickBBS, SuperBBS, and others.
-
-
- Written by Michael Reece.
-
-
- TextView Program is Copyright (c) 1991-1992 by RodentWare.
-
- TextView Documentation is Copyright (c) 1991-1992 by RodentWare.
-
- All rights reserved.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- TextView Version 1.0 Documentation Page i
-
-
-
- · T · E · X · T · V · I · E · W · 1 . 0 ·
-
- · b y ·
-
- · R · o · d · e · n · t · W · a · r · e ·
-
-
-
- TABLE OF CONTENTS Page
- ──────────────────────────────────────────────────────────────────────
-
- Purpose . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
-
- Shareware Notice . . . . . . . . . . . . . . . . . . . . . . . . . . 1
-
- Registration . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
-
- Disclaimer & Legal Matters . . . . . . . . . . . . . . . . . . . . . 2
-
- System Requirements . . . . . . . . . . . . . . . . . . . . . . . . 2
-
- Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
-
- Loading TextView. . . . . . . . . . . . . . . . . . . . . . . . . . 3
-
- The Viewer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
-
- The File List . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
-
- Suggested Uses . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
-
- Product Support . . . . . . . . . . . . . . . . . . . . . . . . . . 6
-
- Special Notice . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
-
- RodentWare Support Sites . . . . . . . . . . . . . . . . . . . . . 6
-
- Copyright Notices . . . . . . . . . . . . . . . . . . . . . . . . . 7
-
- Acknowlegements & Credits . . . . . . . . . . . . . . . . . . . . . 8
-
- ──────────────────────────────────────────────────────────────────────
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- TextView Version 1.0 Documentation Page ii
-
-
-
-
-
- PURPOSE
- ──────────────────────────────────────────────────────────────────────
-
- TextView is designed to view plain text files online. What makes
- TextView unique is the ability to scroll up or down by line or page.
- The use of TextView as a door requires ANSI graphics capabilities.
- TextView makes use of the JPDOOR door-writing units by Motor City
- Software.
-
- TextView allows scrolling up or down single lines, single pages, and
- jumps to the beginning or end of the document. TextView has more
- impressive "jumping" and searching routines, and it supports text
- files up to 20,000 lines long.
-
-
-
- SHAREWARE NOTICE
- ──────────────────────────────────────────────────────────────────────
-
- While this product is distributed freely, it is not free. It has been
- released under a software concept known as ShareWare. ShareWare
- allows you to evaluate a program to determine if it suits your needs,
- and register it with the author if you plan to continue using it. This
- means that you have the right to test this product for a period of no
- more than thirty (30) days. At the end of the 30 day evaluation
- period, you must register your copy with the author, or stop using it.
-
- By registering the ShareWare programs you use, you encourage support
- of that product, as well as the creation of other ShareWare products.
- The more people who register, the more programmers turn to the
- ShareWare concept. Your support of shareware allows programmers to
- keep the cost of quality software at an affordable price, thereby
- benefitting all users. It's that simple.
-
-
-
- REGISTRATION
- ──────────────────────────────────────────────────────────────────────
-
- There are currently two ways to register a RodentWare product. The
- least expensive one-shot method is to register an individual program,
- such as this one. The second method is less expensive in the long run,
- and registeres you as a "supporter" which entitles you to use any
- RodentWare products for your single registration.
-
- After registering your RodentWare products, you will recieve a special
- "key file." At startup, all RodentWare programs first check for the
- existance of such a key to determine if the program is registered.
-
- Method 1:
-
- For a registration fee of $10.00 (US) you will receive a TEXTVIEW.KEY
- registration KEY, valid for TextView only. All versions of TextView
- will use the same keyfile, so you will never have to re-register the
- same program.
-
-
-
-
- TextView Version 1.0 Documentation Page 1
-
-
-
- Method 2:
-
- For a registration fee of $50.00 (US) you will receive a RODENT.KEY
- registration KEY, valid for ALL RodentWare programs. All versions of
- all RodentWare programs will check for this keyfile. By choosing to
- register as a RodentWare "supporter," you will automatically be
- registered for ALL RodentWare releases; past, present, and future.
-
- Please see the text file RODENT.REG included in the TextView archive
- for detailed registration information.
-
-
-
- DISCLAIMER & LEGAL MATTERS
- ──────────────────────────────────────────────────────────────────────
-
- The software and accompanying materials (including instructions for
- use) are provided "as is" without warranty of any kind. Further, the
- author disclaims all warranties, expressed or implied, including
- without limitation, the warranties of merchantability and of fitness
- for any purpose. The author does not warrant, guarantee, or make any
- representations regarding the use, or the results of the use, of the
- software or written materials in terms of correctness, accuracy,
- reliability, currentness or otherwise.
-
- The author shall not be liable for any direct, indirect, consequential
- or incidental damages (including damages for loss of business profits,
- business interruption, loss of business information, and the like)
- which may result from the use or inability to use the software even if
- the author has been advised of the possibility of such damages.
-
- You may copy this package for backup purposes. You may also copy and
- share unmodified copies of the whole package, providing that the
- Copyright Notices are reproduced and included on all copies.
-
- You may not sell the product for a fee and/or distribute the product
- along with other products without written permission, nor may you
- modify or remove the Copyright Notices from the programs or the
- documentation files, or in any way modify, adapt, translate, reverse
- engineer, decompile and/or disassemble any of the software in this
- package. User clubs, if they are NOT commercial, are allowed to ask a
- small amount of money for distribution and storage when they want to
- share this package amongst their members.
-
-
-
- SYSTEM REQUIREMENTS
- ──────────────────────────────────────────────────────────────────────
-
- The following equipment, software, and files are necessary to run this
- program:
-
- An operational bulletin board system running RemoteAccess,
- QuickBBS, SuperBBS, or any other BBS software that creates the
- DORINFO1.DEF exit file.
-
- TEXTVIEW.EXE file included in the TextView archive.
-
-
-
-
- TextView Version 1.0 Documentation Page 2
-
-
-
-
-
- INSTALLATION
- ──────────────────────────────────────────────────────────────────────
-
- To install TextView for use on your BBS, simply copy the TEXTVIEW.EXE
- file to your BBS system directory. More detailed instructions for
- configuring TextView for use are given below.
-
-
-
- LOADING TEXTVIEW
- ──────────────────────────────────────────────────────────────────────
-
- TextView can be loaded one of two ways: DIRECT mode, and LIST mode.
-
- The first method is to pass a filename on the command line to be
- viewed directly. Here, TextView loads this file and displays it to the
- screen immediately. Upon exiting the viewer, TextView returns to DOS
- (or the BBS). This mode would be ideal for viewing a single file from
- a BBS menu option, such as a SysOp option to browse the caller log, or
- a user option to browse a help file or door instruction file.
-
- To load TextView in this manner, use the following command line:
-
- TEXTVIEW.EXE DIRECT <filename> [filepath]
-
- where <filename> is the file you wish to view, and [filepath] is
- optionally the path to <filename>. Note that <filename> may be a
- complete path, in which case [filepath] is not needed. Thus,
-
- TEXTVIEW.EXE DIRECT C:\RA\RA1.LOG
-
- and
-
- TEXTVIEW.EXE DIRECT RA1.LOG C:\RA\
-
- are functionally the same. However, only the portion given as the
- <filename> parameter is displayed to the screen in the header line.
- Thus, in the first example above, "C:\RA\RA1.LOG" would be displayed
- on the first header line in the viewer, while in the second example,
- only "RA1.LOG" would be displayed.
-
- The second method is to pass a FILES.BBS type listing on the command
- line. TextView will then allow the user to select a file from this
- listing to be loaded into the viewer. Each time the viewer is exitted,
- the user is returned to the listing. Exitting the listing returns to
- DOS (or the BBS) in this mode. This method might be useful as an
- option on a File Menu, to allow users to view files in the current
- file area. Or, you might create a seperate FILES.BBS style listing of
- files that can be viewed.
-
- To load TextView in this manner, use the following command line:
-
- TEXTVIEW.EXE LIST <filename> [filepath]
-
- where <filename> is the complete path and name of a FILES.BBS type
- listing, and [filepath] is the path to the actual files listed in
-
-
-
- TextView Version 1.0 Documentation Page 3
-
-
-
- <filename>. For example, if the command line
-
- TEXTVIEW.EXE LIST C:\RA\LISTS\FILES.3 C:\RA\UPLOADS\
-
- is used, "C:\RA\LISTS\FILES.3" is expected to be a FILES.BBS type
- listing, and the files listed in "C:\RA\LISTS\FILES.3" are actually
- in the directory "C:\RA\UPLOADS\". If both the listing and the files
- to be viewed reside in the same directory, the filepath is not
- necessary:
-
- TEXTVIEW.EXE LIST C:\RA\UPLOADS\FILES.BBS
-
- Taking advantage of RemoteAccess's file template structure, the
- following command line could be used on a type 7 exit:
-
- TEXTVIEW.EXE LIST *0FILES.BBS
-
- assuming that the path passed by RA has a trailing backslash.
-
- Because TextView uses a good deal of memory (240k in some cases) it is
- recommended that you enable the memory swapping functions for your BBS
- software. For example, with RA this is done by placing a "*M" on the
- command line as well, such as:
-
- TEXTVIEW.EXE *M LIST C:\TXTDESCS\LIST1.TXT C:\TXTFILES\
-
- TextView should be called from a type 7 (DOS shell) menu option. A
- type 15 (DOS exit) option would work as well, but is not really
- needed, especially when the memory swapping feature is used. For more
- information on creating menu options, please refer to your BBS manual
- or documentation.
-
-
-
- THE VIEWER
- ──────────────────────────────────────────────────────────────────────
-
- The viewer consists of a header line, a footer line, and 21 lines of
- scrolling text. The header line displays the name of the file being
- viewed. In DIRECT mode, this will be the name passed as the <filename>
- command line parameter. In LIST mode, this will be the 12 character
- name of the file selected from the list. In LIST mode, the file's
- description is also displayed on the header line. The footer line
- shows the string "Use NUMLOCK keys, ESC-Exit, ?-Help." and the lines
- currently being displayed in the scroll window in the form "Lines x_1
- to x_2 of x_N."
-
- The 21 line scroll window is updated as the user scrolls through the
- text file. The following keys can be used to move through the text:
-
- Movement NUM WordStar
- -----------------------------------------------
- End of text (End) 1 ^Z
- Down one line (Down) 2 ^X
- Down one page (PgDn) 3 ^C
- Top of text (Home) 7 ^Q
- Up one line (Up) 8 ^W
- Up one page (PgUp) 9 ^E
-
-
-
- TextView Version 1.0 Documentation Page 4
-
-
-
-
- Other Commands Key
- -------------------------------
- Jump to line J
- Search for text S
-
- Note that the 1,2,3,7,8,9 keys correspond to normal cursor movement
- keys when in NUMLOCK mode. The WordStar control characters are also
- provided because these are well known.
-
- Pressing 'J' in the viewer will prompt the user for a line number.
- TextView will quickly "jump" to this line.
-
- Pressing 'S' in the viewer will prompt the user for a search string.
- Entering '/' as the search string will search for the next occurance
- of the previous search string. Pressing [Enter] at the search prompt
- disables the current search string. TextView will highlight all
- occurances of the search string on the screen.
-
- Pressing '?' in the viewer will bring up a small window displaying
- the keys that are available to the user.
-
- Pressing [Esc] or 'Q' will exit the viewer. In DIRECT mode, this exits
- the program. In LIST mode, this returns the user to the filename list
- to select a new file.
-
-
-
- THE FILE LIST
- ──────────────────────────────────────────────────────────────────────
-
- The file list consists of a header line, a footer line, a listing of
- 19 filenames and their descriptions, and a key entry prompt.
-
- TextView supports up to 500 filenames, and displays them to the screen
- 19 at a time. The following keys are options in the file list:
-
- (N)ext
- The Next option displays the next screen of filenames.
-
- (P)rev
- The Prev option displays the previous screen of filenames.
-
- (R)edraw
- The Redraw option redraws the current screen of filenames. This
- command is useful in case of line noise. Pressing '?' works here
- as well.
-
- (V)iew
- The View option asks for a file number to display, and loads the
- selected file into the file viewer.
-
- (Q)uit
- The Quit option exits the program and returns to the BBS or DOS
- prompt. [Esc] also works for this option.
-
-
-
-
-
-
- TextView Version 1.0 Documentation Page 5
-
-
-
- SUGGESTED USES
- ──────────────────────────────────────────────────────────────────────
-
- TextView has many uses that may not immediately come to mind. The
- following suggestions may help you come up with new uses for this
- program.
-
- As shown in the examples above, TextView can be used as a "(V)iew Text
- File" option on your file transfer menu.
-
- TextView could be used to scroll various online game documents or
- high score listings.
-
- A group of local SysOps could exchange master file listings. Users
- could then view and search file listings for other area BBSs on your
- BBS in case they cannot find a file they need online.
-
- TextView could be used in the DIRECT mode for remotely viewing your
- BBS or mailer log files, user questionnaire files, or any other
- variety of textfiles.
-
- And lots of other stuff, too, I'm sure. :-)
-
-
-
- PRODUCT SUPPORT
- ──────────────────────────────────────────────────────────────────────
-
- There is a RodentWare support echo titled 'RODENT' on the Fidonet
- Backbone. The RODENT echo is to aid support to all RodentWare users
- without adding more wear and tear on the other echoes. Ask your *EC
- about receiving this echo -- it is on the Fidonet Zone 1 BACKBONE!
-
-
-
- SPECIAL NOTICE
- ──────────────────────────────────────────────────────────────────────
-
- A special thank you goes out to all of the RodentWare supporters, beta
- testers, and support echo participants. There has never been a better
- bunch of supportive people. Thanks, guys (and gal), for sticking in
- there through the long, long winter!
-
- Additionally if you would like to become a member of the beta team or
- support network, please contact Michael Reece.
-
-
-
- RODENTWARE SUPPORT SITES
- ──────────────────────────────────────────────────────────────────────
-
- Below is a listing of RodentWare Support Sites. These bulletin boards
- should have all of the latest RodentWare programs available for File
- REQuest and/or Download.
-
- The RodentWare BBS (SysOp, Michael Reece)
- RodentWare Headquarters
- Buffalo NY
- 1-716-837-6879, 1:260/150, 9600 [HST]
-
-
- TextView Version 1.0 Documentation Page 6
-
-
-
-
- Odyssey BBS (SysOp, Stan Hirschman)
- RodentWare Distribution
- Edina MN
- 1-612-832-5127, 1:282/40, 9600 [HST,V32b,V42b]
-
- The Dart Board (SysOp, Karen Maynor)
- RodentWare Distribution
- St Mary's GA
- 1-912-882-0755, 1:3640/5, 9600 [HST,V32b]
-
- MCS * USA * (SysOp, Peter Kling)
- Albany NY
- 1-518-437-1267, 1:267/169, 9600 [HST,V42b]
- 1-518-437-1268, 1:267/269, 2400
-
- Dave's Hangar (SysOp, Dave Hartzell)
- Dallas TX
- 1-214-363-1973, 1:124/2114, 9600 [HST,V32b,V42b]
-
- Happy Hour BBS (SysOp, Tom Stoltz)
- Raymore MO
- 1-816-322-1133, 1:280/301, 9600 [HST]
-
- The Dog Bone BBS (SysOp, Daniel Svanstrom)
- Atlanta Ga
- 1-404-458-4924, 1:133/412, 9600 [CSP,V32b,MNP]
-
- The Dog House (SysOp, Dave Lockard)
- Charlotte Hall MD
- 1-301-884-3686, 1:109/605, 2400
-
- The Comedy Club (SysOp, Richard Williams)
- W. Frankfort IL
- 1-618-937-1831, 1:2290/20, 2400
-
- The End of the World (SysOp, Lou Ludwig)
- Ewa Beach HI
- 1-808-499-1501, 1:345/20, 9600 [HST,V42b]
-
- The Low Country (SysOp, Tom Echols)
- Tillman SC
- 1-803-726-5191, 1:3626/8, 9600 [HST,V32b,V42b]
-
- The Master's BBS (SysOp, Mike Levonius)
- Garden Grove CA
- 1-714-539-9087, 1:103/101, 2400
- 1-714-539-2477, 1:103/102, 9600 [HST]
-
- The Midrange System (SysOp, David Gibbs)
- Mount Prospect IL
- 1-708-439-9679, 1:115/439, 9600 [HST,V32b,V42b]
- 1-708-439-1458, 2400 [V42b]
-
- The Other Side Of The Hill (SysOp, Robby Barra)
- Tyler TX
- 1-903-597-1239, 1:3801/3, 9600 [HST,V42b]
-
-
-
-
- TextView Version 1.0 Documentation Page 7
-
-
-
-
-
-
- COPYRIGHT NOTICES
- ──────────────────────────────────────────────────────────────────────
-
- TextView Version 1.0 Copyright (c) 1991 by RodentWare.
- Written by Michael Reece, The RodentWare BBS, 716-837-6879, 1:260/150.
-
- RodentWare, 24 Hawthorne Ave, Buffalo NY 14223-3014, USA.
- Voice: 716-837-4741, 3 pm to 10 pm.
-
-
-
- ACKNOWLEGEMENTS & CREDITS
- ──────────────────────────────────────────────────────────────────────
-
- Michael Reece and RodentWare would like to thank the following:
-
- Borland International, Inc. for Turbo Pascal 6.0
- Andrew Milner & Continental Software for RemoteAccess.
- Motor City Software for JPDoor 3.2.
- John Parlin for his similar JPList program.
- The Fidonet PASCAL echo for coding help and suggestions.
-
- Turbo Pascal is a trademark of Borland International, Inc.
- RodentWare is a trademark of Michael Reece & RodentWare.
- RemoteAccess is a trademark of Andrew Milner & Continental Software.
-
-
-
- **********************************************************************
- * SysOps: We thank you for making our programs available on your BBS *
- * for downloading. Please do not add files to the original archive. *
- * BBS ads are welcome in the archive COMMENT only! Do not place new *
- * files, or modify existing files, INSIDE the archive. Changing *
- * archive format (ie, from ARJ to ZIP or LZH) is fine as long as you *
- * are positive that ALL of the original files (and no EXTRA files) *
- * are placed inside the new archive. - RodentWare *
- **********************************************************************
-
-
-
- Enjoy.
-
- Michael Reece, RodentWare Programmer
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- TextView Version 1.0 Documentation Page 8