Boldly Go Collection

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

/ Boldly Go Collection / version40.iso / TS / 25D / STR22.ZIP / STR.DOC next >

Wrap

Text File | 1992-05-24 | 17.0 KB | 309 lines

STR 2.2 Memory-resident String pasting program by Bob Eyer May 24, 1992 Means of contact - CIS: [73230,2620] CRS, IBM Conference 416-629-7020 ROSE, Main Conference 416-733-2285 * LOCAL RELEASE * Syntax ------ STR [color -lines filename] [/U] Edit: Ctrl-Backspace - ENTER selects and pastes string - Ctrl-Home clears all strings Color A positive integer determining the colour scheme of the edit window. See Color Section below for details. -Lines A negative integer setting the number of strings to allocate in memory. If this parameter is not mentioned, STR defaults Lines to 10 elements, corresponding to memory use of about 14K. The maximum is determined by all available memory, less 100K. The user will hardly ever need to set this parameter, unless he wishes to read into STR all strings from a file at runtime. Filename The name of the file containing a list of strings to read by STR. Lines must be set higher than filename's linecount. Linelength in this file is limited to the size of the edit buffer - 55 characters. Lines longer than 55 will be truncated to 55 in this version. Examples -------- STR sets colour to black on white, allocates 10 strings, and loads no input file. STR 27 -20 sets colour to bright cyan on blue background, allocating space for 20 strings, loading no file list. STR -1000 sample sets colour to black on white, allocates 1000 lines, and loads them from the file called 'sample'. Discussion ---------- This program has been largely rewritten from the version posted in SUTL22.ZIP (Compuserve, IBMHW forum). Version 2.2 has a much larger capacity, and makes much fuller use of the cursor pad. In edit mode, Ctrl-Home clears all strings, if desired. Since this Ctrl-Home is INTERNAL to the edit window, it does not interfere with Ctrl-Home which is used in some communications programs. Typing each string followed by the Up or Down cursors enters what was typed into a STR array. The number of the entry appears in the far right margin, so the user can see where he is in the array without obscuring underlying text excessively. The backspace key operates as normal, as does the DEL key and the Home, End, PgUp, and PgDn keys (except that the Pg keys skip 10 lines instead of 24 or 23). ENTER pastes the string in the window to the underlying application, but does not delete it from memory. This procedure avoids excessive use of hotkeys, which may short-circuit some special function keys in editing or communications applications. The value of this program is that it provides an auxiliary source of strings accessible by hotkey. Most communications programs provide special keys for injecting text into a communications session; however, many users would prefer to reserve these keys for data which is more or less permanent. STR's strings are obviously temporary, and are easily changed at any time without punching through a maze of submenus. Color ----- The numbers to use for Color are determined by the following chart: Back Fore Bright Fore ---- ---- ----------- Black 0 0 8 Blue 16 1 9 Green 32 2 10 Cyan 48 3 11 Red 64 4 12 Magenta 80 5 13 Brown 96 6 14 White 112 7 15 Use of 0 (black on black) is always converted to 112 (black on white) by STR. The correct COLOR number is found merely by adding the Foreground number to the Background number desired. For example, Bright Green on Blue background is 10 + 16 = 26. Avoid setting COLOR above 127. Values above that limit will produce blinking displays. In my estimation the COLORs best for the eye are 10, 11, 14, 15, 26, 27, 30, 31, 74, 75, 78, 79 and 112. But you may have other ideas. Example, COLOR 75 sets the window to Bright Cyan on a Red background. ┌──────────────────── SHAREWARE NOTICE and TERMS ──────────────────────────┐ │ │ │ The content of this archive is shareware: if you intend to │ │ use it more or less regularly, you must register with the author. │ │ │ │ In return for your registration you will receive the most recent │ │ updates of the items mentioned in the list below. This benefit │ │ far exceeds the value of the specific program you are │ │ registering. Unlike other shareware agreements, this agreement │ │ entitles you to receive everything in the list below, if you │ │ register just one item!! │ │ │ │ Simply purchase a money order from your bank in the amount of $20 │ │ US made out to Bob Eyer and send with your return address to: │ │ │ │ Bob Eyer │ │ 1100 Bloor Street West │ │ Suite 16 │ │ Toronto, Canada M6H 1M8 │ │ │ │ Please mention in your accompanying note whether you wish 5.25" or │ │ 3.5" diskette format, and state the name in which you wish │ │ registration-only utilities to be registered. │ │ │ │ Do not send checks. Checks cause problems across international │ │ borders which make them unsuitable for small purchases by mail │ │ order. Checks will be returned to you with your order unfilled. │ │ │ │ Enquiries may be placed by writing directly to the author via │ │ Easyplex at Compuserve [73230,2620], or by mail to the address │ │ above. Registered users are always assured of a response, and of │ │ tech support related to these programs, if needed. │ │ │ │ The author is amenable to requests for custom versions of any of │ │ these works; terms subject to negotiation. │ │ │ │ The price of registration is very inexpensive: in return for your │ │ basic registration, you receive some 700K in programs and │ │ documentation. │ │ │ │ │ │ Warranty and Disclaimer: │ │ ----------------------- │ │ The author, Bob Eyer, of this and all items below guarantees the │ │ physical integrity of the diskette covering the points above, and │ │ will replace free of charge, if it is received defective. │ │ However, in no case will the author be responsible for any damages │ │ due to loss of data or any other reason. In no event does the │ │ author's liability for any damages exceed the price paid for the │ │ buyer's order of this software, regardless of the form of the │ │ claim. The person using the software bears all risk as to the │ │ quality and performance of the software. │ │ │ │ │ │ DESCRIPTION OF PROGRAMS YOU WILL RECEIVE FOR YOUR CONTRIBUTION │ │ -------------------------------------------------------------- │ │ │ │ The items listed below, except the ones with asterisk in the left │ │ margin, are registered to you personally. As personally │ │ registered to you, these particular copies may not be distributed │ │ without the author's consent. Names of programs falling into this │ │ category are all versions of MG, versions of SPC after SPC 5.4, │ │ all versions of HOST, CA, KNT, and FCA. These programs may be │ │ freely circulated only in their 'shareware' form. Versions of │ │ these programs which are personally registered to the user must │ │ not be so circulated. When you place an order by making your │ │ shareware contribution under these terms, you are agreeing to │ │ abide by this principle. │ │ │ │ MG 3.0 │ │ ------ │ │ Moving average ASCII graphing program. Especially designed for │ │ obtaining graphic updates on stock-market activity in practical │ │ trading environments, in which it is essential that the user get a │ │ quick graph immediately, with points of the graph directly │ │ associated with the numerical and other text information which │ │ these points represent (a feat impractical in Lotus graphics). │ │ Designed to be used with SETV in the SUTL package. │ │ │ │ SPC 5.5 │ │ ------- │ │ Multidrive columnar drive report, with fairly complete description │ │ of your machine including communications, important chips, │ │ printer, BIOS, memory, processor and coprocessor speed, │ │ multitasking, networking, and so on, all in one single snapshot. │ │ New version doubles the amount of information on each │ │ communications port and displays the information in columnar mode │ │ above the drive report, adds an environment usage readout as well │ │ as a new P parameter to pause the PRINT multiplexer, when it is │ │ used to feed data to your printer. (DOS PRINT lacks a pause │ │ command). │ │ │ │ HOST 2.4 │ │ -------- │ │ Provides a simple BBS host for occasional use. Fully │ │ configurable, but capable of being run 'right out of the box', │ │ HOST provides ringback, file transfer, mail, chat, userlog, shell, │ │ and much more - in an executable only 30K in size. Version 2.4 │ │ adds option to turn off noise filtering, and facilities for │ │ reading in the user's own list of file protocols. │ │ │ │ CA 2.4 │ │ ------ │ │ 4-function fixed point TSR calculator with formatted displays and │ │ scientific notation for direct paste to text. Also has │ │ accumulator. Four mode groups. About 13K of memory. │ │ │ │ FCA 2.4 │ │ ------- │ │ Memory resident calculator with formatted displays and direct │ │ paste to text, minimum screen overlay. 29 functions, including │ │ trig, factorials & combinations, mean & standard deviation, │ │ regression analysis, binomial, Poisson, normal, and Student │ │ distributions. Six mode groups. FCA is the most sophisticated │ │ calculator in the business for its size. 39K of memory. │ │ │ │ KNT 2.0 │ │ ------- │ │ Memory resident Netbios-compatible keystroke counter with options │ │ for screen display and disk file logging. Great productivity │ │ tool. Uses about 10K of memory. │ │ │ │ │ │ * FUTL 2.0 │ │ -------- │ │ A collection of file processing utilities including - │ │ CHG 2.8 - File/directory attribute/date/time reader/changer │ │ ELIM 2.6 - Replacement for DOS DEL │ │ FVER 2.1 - BBS file list verifier - automatic, redirectable │ │ MV 2.8 - File mover, large improvement over MV 2.6. │ │ MVA 2.1 - BBS file mover, reads from list, uses download path │ │ OTL 3.0 - Operation to List, generalisation of MVA, for BBSes │ │ RNF 2.2 - Puts special flags on filenames │ │ SWP 2.0 - Single level sweep program, faster than SWEEP.COM │ │ TYME 2.3 - Program execution timer │ │ WD 2.6 - Applies wildcard to any program │ │ Each is the best and smallest in the business for what it does. │ │ │ │ * SUTL 2.3 │ │ -------- │ │ A collection of small utilities covering batch file, diagnostic, │ │ communications analysis, file, video, and other areas, including │ │ AL, CFIX, DOSV, DTR, EL, EMS, KALL, LF, STR, PAUZ, PF, PORT, RING, │ │ RTS, SETV, SS, and TSTF. Includes a number of very useful memory │ │ resident programs, such as AL(alarm) and PORT(analyser). Much │ │ better version of STR. │ │ │ │ * TUTL 2.1 │ │ -------- │ │ A collection of text-processing utilities, including ADD, CBRO, │ │ CITM, COMB, DIV, ESRT, LCNT, REV, and SPLT. Except for LCNT (a │ │ very fast wildcarded text linecounter), these programs cover │ │ important ground in text processing for which there exists no │ │ other alternative in the shareware market. Users who do much │ │ work with ASCII text should not be without these utilities. │ │ │ └──────────────────────────────────────────────────────────────────────────┘ -------------------------------------- End of documentation