Tools en Utilities

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

/ Tools en Utilities / CDASS_5.ISO / shell / file / texe10.arj / TEXE-DOC.EXE (.txt) next >

Wrap

TEXE | 1991-06-20 | 38.3 KB | 622 lines

╔═══════════════════════════════════════════════════════════╗ ║ ║ ║ ║ ║ ║ ║ T E X E ║ ║ ║ ║ V 1.0 ║ ║ ║ ║ ║ ║ THE PROGRAM THAT CONVERTS A TEXT FILE ║ ║ INTO A READING PROGRAM ║ ║ ║ ║ ║ ║ ║ ║ (C) 1991 Raymond Payette ║ ║ ║ ║ DISTRIBUTED BY: ║ ║ ║ ║ PANDA STUDIO INC. ║ ║ ║ ║ ║ ║ ║ ║ ║ ╚═══════════════════════════════════════════════════════════╝ i REQUIREMENTS TEXE requires an MS DOS operating system on an IBM compatible computer with a 64K memory; code for multitasking is not supported. Monochrome and color screens are supported. ACKNOWLEDGMENTS This documentation refers to trademarks: MS DOS is a trademark of Microsoft Corporation. IBM is a trademark for International Business Machine. LHA is the compression program copyrighted by Haruyasu Yoshizaki COPYRIGHTS TEXE, FOR THE PURPOSE OF THE FOLLOWING TEXT, INCLUDES ALL SOFTWARE FILES PACKAGED WITH THE TEXE.EXE PROGRAM WHICH ARE ALL COPYRIGHTED. ANY COPYRIGHT INFRINGEMENT MAY ALSO INFRINGE UPON OTHER EMBEDDED COPYRIGHTS SUCH AS THE LHA ARCHIVE PROGRAM. USING A TEXED FILE ACKNOWLEDGES THE EMBEDDED COPYRIGHTS. ii DISCLAIMER - AGREEMENT Users of TEXE must accept this disclaimer of warranty: TEXE is supplied as is. The author disclaims all warranties, expressed or implied, including, without limitation, the warranties of merchantability and of fitness for any purpose. The author assumes no liability for damages, direct or conse- quential, which may result from the use of TEXE. TEXE is a "shareware program" and is provided at no charge to the user for evaluation. Feel free to share it with your friends, but please do not give it away altered or as part of another system. The essence of "user-supported" software is to provide personal computer users with quality software without high prices, and yet to provide incentive for programmers to continue to develop new products. If you find this program useful and find that you are using TEXE and continue to use TEXE after a reasonable trial period (usually of one month) you must make a registration payment as per license agreement. iii You must treat this software just like a book. An example is that this software may be used by any number of people and may be freely moved from one computer location to another, so long as there is no possibility of it being used at one location while it's being used at another. Just as a book cannot be read by two different persons at the same time. Commercial users of TEXE must register and pay for their copies of TEXE within 30 days of first use or their license is withdrawn. Site-License arrangements may be made by completing the license agreement and sending it to Panda Studio Inc. Anyone distributing TEXE for any kind of remuneration must first contact Panda Studio Inc. for authorization. This authorization will be automatically granted to distributors recognized by the (ASP) as adhering to its guidelines for shareware distributors, and such distributors may begin offering TEXE immediately. You are encouraged to pass a copy of TEXE along to your friends for evaluation. Please encourage them to register their copy if they find that they can use it. All registered users will receive a copy of the latest version of the TEXE system. iv PRODUCT SUPPORT Right now our product support is done by mail. Please send all enquiries to: Panda Studio Inc., P.O. Box 642, Sillery, QC, Canada, G1T 2W3 You can also send an E-mail message to: CIS: 72361,1574 GENIE: XTY76342 Please specify how you want to be contacted. C O N T E N T S REQUIREMENTS . . . . . . . . . . . . . . . . . . . . . . . . . . i ACKNOWLEDGMENTS . . . . . . . . . . . . . . . . . . . . . . . . i COPYRIGHTS . . . . . . . . . . . . . . . . . . . . . . . . . . . i DISCLAIMER-AGREEMENT . . . . . . . . . . . . . . . . . . . . . . ii PRODUCT SUPPORT . . . . . . . . . . . . . . . . . . . . . . . . iv 1. I N T R O D U C T I O N What is TEXE . . . . . . . . . . . . . . . . . . . . . . 1 Text files . . . . . . . . . . . . . . . . . . . . . . 2 Hypertext tool . . . . . . . . . . . . . . . . . . . . . . 2 2. G E T T I N G S T A R T E D Install . . . . . . . . . . . . . . . . . . . . . . . . . 3 File List . . . . . . . . . . . . . . . . . . . . . . . . 3 3. C O N V E R T I N G T E X T F I L E S W I T H T E X E Usage . . . . . . . . . . . . . . . . . . . . . . . . . 5 Help . . . . . . . . . . . . . . . . . . . . . . . . . 6 Source files . . . . . . . . . . . . . . . . . . . . . . . 6 Target files . . . . . . . . . . . . . . . . . . . . . . . 7 4. R E A D I N G T E X T Usage . . . . . . . . . . . . . . . . . . . . . . . . . 7 Cursor movement . . . . . . . . . . . . . . . . . . . . . . 8 Functions . . . . . . . . . . . . . . . . . . . . . . . . . 8 Mouse . . . . . . . . . . . . . . . . . . . . . . . . . 9 5. P R I N T I N G Markers and Printing . . . . . . . . . . . . . . . . . . . . 9 6. B A T C H F I L E TEXE.BAT . . . . . . . . . . . . . . . . . . . . . . . . . 10 7. H Y P E R T E X T Indexing . . . . . . . . . . . . . . . . . . . . . . . . 11 Hypertext help . . . . . . . . . . . . . . . . . . . . . . . 11 8. F I L E E X T R A C T I O N TEXTRACT.EXE . . . . . . . . . . . . . . . . . . . . . . . . 12 9. P O P - U P R E A D E R TEXPOP.COM . . . . . . . . . . . . . . . . . . . . . . . . 13 10. W I N D O W S TEXEd files in windows . . . . . . . . . . . . . . . . . . . 13 TEXE with Windows . . . . . . . . . . . . . . . . . . . 14 11. S H A R E W A R E ASP . . . . . . . . . . . . . . . . . . . . . . . . . 14 Meaning of shareware . . . . . . . . . . . . . . . . . . . . 15 License agreement . . . . . . . . . . . . . . . . . . . . 17 1 INTRODUCTION What is TEXE ──────────── TEXE is a program which copies a text file and attaches a 15K program to it in order to be able to read it. Currently text files larger than 64K such as many MANUAL.TXT or README.DOC files have to be read with a text editor (which is tedious to set up); even then the documentation is limited to a text file of 360K or less to allow text editors to load all the text in memory. TEXE can read text of almost any size, up to 2000 pages long! In order to be as compact as possible, TEXE reads only 24 lines of text at a time, albeit of 256 characters per line! TEXE uses only 15K of memory for the program and 8K for the data; thus you can even exit from a large program and read a 500K text file without flinching. The 15K added to the text is well worth it! TEXEd files are self-contained with their HELP and messages. Text Files ────────── Text files are standard ASCII files; they can be read with the command: TYPE Filename and they can be printed with PRINT Filename. The TEXE program will work on any file, but non ASCII files will be unreadable. 2 Every line must end with a Carriage Return and a Line Feed as it is usually done with most text editors; any omission will cause errors. It's supposed that every page has 24 lines, because every computer screen has 25 line mode, (some also have a 43 or 50 line mode). It's nicer to have a text whose top of page matches the screen's top of page as this text does; thus you have to prepare your text accordingly. Hypertext tool ────────────── Hypertext is a text which is accessed directly without having to search through it. The programmer must identify the exact place to go and embed it in his program. Then by specifying the exact byte of the TEXEd file it will bring you right there. You can use TEXINDEX to identify these exact bytes. TEXE.EXE uses hypertext with its /H option. 3 GETTING STARTED Install ─────── The original shareware program comes in the form of one file named TEXEZIP.EXE At the prompt typing TEXEZIP and pressing ENTER will decompress files in the current directory including the present file. It is best to keep TEXE.EXE in the root directory of your hard disk; to do this, simply type COPY TEXE.EXE C:\ and press ENTER. When you are in another directory and you want to use TEXE, simply copy it in the current directory with COPY C:\TEXE.EXE File List ───────── TEXEARC.EXE is the self-extracting archive file containing the following files: TEXE-DOC.EXE is the present documentation file which has been TEXEd with TEXE.EXE. It contains the license agreement which can be directly printed. It can be extracted with TEXTRACT.EXE 4 TEXE.EXE is the main program which converts text files into an executable format. TEXTRACT.EXE is a program used to restore the text file which is TEXEd. TEXED.ICO is a generic icon image that can be used in WINDOWS to identify TEXEd files. TEXED.PIF Is a generic PIF files to set up TEXEd files in WINDOWS. Replace the TEXED.EXE file name with your own file name. TEXE.ICO is an icon image to use with TEXE in WINDOWS TEXE.PIF is a Windows file used to set up TEXE.EXE TEXINDEX.EXE is a program used to index a TEXEd file TEXEPOP.COM is a TSR version of the TEXE.EXE program 5 CONVERTING TEXT FILES WITH TEXE Usage ───── TEXE [d:][\path\]source filename [d:][\path\][target filename] [/H] d: refers to the directory such as C: \path means the directories where the source file is. source filename refers to the file to be converted target filename refers to the executable file to be created /H accesses the help screen. With hypertext, the present help screen is contained in the file TEXTDOC.EXE 6 Help ──── To get immediate help when using TEXE simply add /H for example: TEXE /H will type a summary of the required parameters and their explanation. Source files ──────────── The source file is the text file you want to convert. It has to be an exact and complete file name and that file must be present in the current directory. For example the present file was created by this command: TEXE TEXE-DOC.TXT which created the file TEXE-DOC.EXE 7 Target files ──────────── The target file is optional. This is the file name you want the text to be converted to. It must be a valid file name. If you don't specify a target file name, the program will change the three letters of the current file name to EXE In the previous example we didn't use any target name, though we could with: TEXE TEXE-DOC.TXT README.EXE which would create the file README.EXE The target file can only be specified as above. If you only type TEXE, the program will not prompt you for a target file name, it will suppose that it's the source file name with an .EXE extension. READING TEXT Usage ───── FILENAME If you use the FILENAME as a hypertext file, the usage is FILENAME [byte] 8 Cursor movement ─────────────── To read the text use only PgUp and PgDn. The other cursor movements: Up, Down are used simply to position the beginning and ending position to start and end printing. Functions ───────── Left and Right shifts the text left or right one space, for text lines as large as 256 characters. ESC to quit the program and go back to the DOS prompt. F1 to bring up the Help screen. Pressing any key will close the help screen and bring you back to the text. F2 is used to print the text bounded by the beginning and ending markers F3 is used to mark the beginning position of the text to be printed. F4 is used to mark the ending position of the text to be printed. F5 is used to go to a particular page. 9 Mouse ───── If you have a mouse you can click it on the commands of the first row, such as PGDN. Clicking on the text puts a marker. Clicking with the right mouse button will start the printing. PRINTING Markers and Printing ──────────────────── In order to print part of the text, first check that the printer on LPT1 is open and on line. Then with the cursor commands PgUp and PgDn go to the page where you want to start printing. Then with the commands Up, Down, Left and Right, place the cursor to the exact row and column where you want to start printing. Press F3 and you will see your first marker. Repeat the operation to place your ending marker, but this time press F4. Once this is completed, press F2. You can use the left mouse buttons to place the markers and the right mouse buttons to start printing. 10 BATCH FILE READ.BAT ──────── A secretary can prepare electronic mail with batch files because many files can quickly be read using a batch file; simply create a text file with the .BAT extension,such as READ.BAT, and replace FILE1.EXE, etc. with your own file names, such as AGENDA.EXE: FILE1.EXE FILE2.EXE FILE3.EXE etc. When the boss types READ and enter, he can read his electronic mail! It can also be used to go directly to a page by using TEXINDEX: AGENDA.EXE 12 AGENDA.EXE 15 AGENDA.EXE BILLS.EXE Save as READ.BAT This will lookup pages 12 and 15 of AGENDA.EXE, then read the whole text of AGENDA.EXE, then the BILLS.EXE text. 11 H Y P E R T E X T INDEXING ──────── The TEXINDEX.EXE program is meant to be used by programmers. Usage: TEXINDEX FILENAME.EXE [byte] byte is the start location of the text to be searched. HYPERTEXT HELP ────────────── A TEXEd file is well adapted to read a portion of a text from another program. For example in a C program you could use: spawnv (P_WAIT,"FILENAME.EXE",argv); or execv ("FILENAME.EXE",argv); In a QuickBasic Program you could use: SHELL FILENAME$ + " 12345" or COMMON SHARED BY& BY& = 12345 RUN FILENAME$ which would access byte 12345 of the TEXEd file in FILENAME. 12 The present program is used as a hyperfile text for the Help screen of the TEXE.EXE program in the manner shown above. F I L E E X T R A C T I O N TEXTRACT.EXE ──────────── Keeping a TEXEd file plus the original file as a backup might be a good idea; however for some it is better only to have one TEXEd file. If you want to get the original text file back, all you have to do is to use TEXTRACT.EXE to extract it. For example you can extract TEXE-DOC.TXT by the following command: TEXTRACT TEXE-DOC.EXE You can also extract files in another directory, for example let's say TEXTRACT is in drive B: , you could issue the following command: TEXTRACT A:TEXE-DOC.EXE 13 P O P - U P R E A D E R TEXEPOP ─────── TSR (Terminate and Stay Resident) programs such as TEXEPOP won't work with certain other programs such as Windows which clears all interrupts. It might also come into conflict with other programs. Thus we discourage the use of this Pop-up. This program is an independent text reader. Its hot key is Alt-R. It will ask you for the file to be read and it will read it for you as a TEXEd file. No parameter can be added to it for use as a hypertext help program. There isn't any option to go directly to a page. Lines have 128 characters. W I N D O W S TEXEd files in windows ────────────────────── TEXEd files can be added as any regular program. A generic icon, TEXED.ICO and TEXED.PIF are used to set up these files. 14 TEXE with Windows ───────────────── The TEXE program can be used within windows. The TEXE.ICO file and TEXE.PIF are used to set up TEXE. S H A R E W A R E ASP ─── The Association of Shareware Professionals defines itself as: The ASP is an association for shareware authors with the general goals of educating shareware authors and distributors and the public, setting standards, sharing resources and information among members. 15 The Meaning of Shareware ──────────────────────── According to the Association of Shareware Professionals: Shareware distribution gives users a chance to try software before buying it. If you try a Shareware program and continue using it, you are expected to register. Individual programs differ on details -- some request registration while others require it, some specify a maximum trial period. With registration, you get anything from the simple right to continue using the software to an updated program with printed manual. Copyright laws apply to both Shareware and commercial software, and the copyright holder retains all rights, with a few specific exceptions as stated below. Shareware authors are accomplished programmers, just like commercial authors, and the programs are of comparable quality. (In both cases, there are good programs and bad ones!) The main difference is in the method of distribution. The author specifically grants the right to copy and distribute the software, either to all and sundry or to a specific group. For example, some authors require written permission before a commercial disk vendor may copy their Shareware. 16 Shareware is a distribution method, not a type of software. You should find software that suits your needs and pocketbook, whether it's commercial or Shareware. The Shareware system makes fitting your needs easier, because you can try before you buy. And because the overhead is low, prices are low also. Shareware has the ultimate money-back guarantee -- if you don't use the product, you don't pay for it. L I C E N S E A G R E E M E N T TEXE.EXE(TM) SITE LICENSE Panda Studio Inc. P.O. Box 642, Sillery, QC Canada G1T 2W3 Name: __________________________________ Date:__________ (Company): __________________________________ (Title): __________________________________ Address: __________________________________ City,State:__________________________________ Zip Code: __________________________________ Country: __________________________________ License Approval: PANDA STUDIO INC. authorized officer____________________ QUEBEC, CANADA Date ____________ This agreement is only valid after it's been completed by both parties. TEXE.EXE for MS-DOS Diskette with programs and license for 1 computer.... @$47 ______ License for one set of programs for 1 computer ...... @$25 ______ Diskette format (choose one) 5.25" disk ____ 3.5" disk ____ Shipping & Handling 5.00 Canadian residents add 7% GST and 8% P.S.T. in Quebec ────── Total enclosed ══════ Terms: Check or Money Order drawn in U.S. funds. Corporate Purchase orders (net 30 days) accepted for software from large corporations within the USA & Canada. All licenses are prepaid only. All purchase orders outside of the United States & Canada must be prepaid.