home *** CD-ROM | disk | FTP | other *** search
/ TopWare Tools / TOOLS.iso / tools / top1026 / turbotxt.man < prev    next >
Encoding:
Text File  |  1993-11-12  |  18.6 KB  |  583 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9. ExtraDOS Toolbox (tm)
  10. _______________________________________
  11.  
  12. TurboTXT Users Manual
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33. Copyright (c) 1985-93 Foley Hi-Tech Systems (ASP)  All Rights Reserved
  34.  
  35.  
  36. Introduction
  37. _____________________________________________________________________
  38.  
  39.  
  40. ExtraDOS Toolbox is a compilation of tools useful to Microsoft DOS
  41. users.  I originally wrote the first version of ExtraDOS under MS-DOS
  42. because I found a need for them and there were no commercially
  43. available products that provided these functions.  Some ExtraDOS tools
  44. were designed to enhance programs already found in MS-DOS.  Other
  45. tools were familiar to the Unix world, but were not available in
  46. MS-DOS.  Over the years this collection has grown into large group of
  47. very useful tools.  Some of these utilities are duplicates of those
  48. found elsewhere, but often provide much better features or reduced
  49. memory overhead than similar utilities found elsewhere.  In addition,
  50. ExtraDOS complements PC-Tools and Norton Utilities with added tools
  51. these programs do not provide.
  52.  
  53. Over thirty of the ExtraDOS Toolbox utilities have been selected by
  54. Paul Somerson, former Executive Editor of PC Magazine, for Bantam
  55. Books', DOS Power Tools, 2nd Edition, Revised and Expanded for DOS
  56. 5.0.  Many of the ExtraDOS Toolbox utilities are now appearing in many
  57. popular DOS books that feature shareware enhancements for DOS.
  58.  
  59. I hope you find these tools useful and convienent.  Any suggestions
  60. for enhancements, improvements or additions are welcome.  Please
  61. contact use with your comments.
  62.  
  63.  
  64. David R. Foley
  65.  
  66.  
  67. License Agreement
  68. _____________________________________________________________________
  69.  
  70.  
  71.   This software is protected by both United States' copyright law and
  72.   international treaty provisions. Therefore, you must treat this
  73.   software "just like a book," with the following single exception.
  74.   Foley Hi-Tech Systems authorizes you to make archival copies of the
  75.   software for the sole purpose of backing up our software and
  76.   protecting your investment from loss. By saying, "just like a book,"
  77.   Foley Hi-Tech Systems means that this software may be used by any
  78.   number of people and may be freely moved from one computer location
  79.   to another, provided there is absolutely no possibility of it being
  80.   used at one location while it is being used at another. Just as a
  81.   book cannot be read by two different people in two different places
  82.   simultaneously, the software may not be used by two different people
  83.   in two different places simultaneously.
  84.  
  85.   You may not make copies of the software documentation or disk,
  86.   except as described above. You may not distribute, rent, sublicense,
  87.   or lease the software or the documentation. You may not alter,
  88.   modify, or adapt the software or documentation, including but not
  89.   limited to translating, decompiling, reverse assembling, or creating
  90.   derivative works. You may not use the software in a network,
  91.   timeshareing, multiple CPU, or multi- user environment unless each
  92.   user is licensed by Foley Hi-Tech Systems.
  93.  
  94.  
  95. EXTRADOS TOOLBOX
  96. _____________________________________________________________________
  97.  
  98.  
  99. LIMITED WARRANTY
  100.  
  101.   Upon notification of defects in material or workmanship,
  102.   within the warranty period of 45 days from the date of purchase,
  103.   Foley Hi-Tech Systems will, at its option, replace the defective
  104.   diskette or refund the license fee. If you need to return a product,
  105.   call the Foley Hi-Tech Systems Technical Support Service Department
  106.   to obtain a return authorization number. The remedy for breach of
  107.   this warranty shall be limited to replacement or refund and shall
  108.   not encompass any other damages, including but not limited to loss
  109.   of profit, and special, incidental, consequential, or other similar
  110.   claims.
  111.  
  112.   Foley Hi-Tech Systems specifically disclaims all other warranties,
  113.   expressed or implied, including but not limited to implied
  114.   warranties of merchantability and fitness for a particular purpose
  115.   with respect to defects in the diskette and documentation, and the
  116.   program license granted herein in particular, and without limiting
  117.   operation of the program license with respect to any particular
  118.   application, use, or purpose. In no event shall Foley Hi-Tech
  119.   Systems be liable for any loss of profit or any other commercial
  120.   damage, including but not limited to special, incidental,
  121.   consequential, or other damages. This statement shall be construed,
  122.   interpreted, and governed by the laws of the State of California.
  123.  
  124.  
  125. TRADEMARK INFORMATION
  126.  
  127.   ExtraDOS Toolbox, TurboBAT, SpeedRAM, Screen Manager, Profiler,
  128.   WizLabel, CDBS, Press Gate Manager, ExtraWindows Toolbox and Safety
  129.   Disk are trademarks of Foley Hi-Tech Systems.
  130.  
  131.   MS-DOS and Windows are trademarks of Microsoft Corporation.
  132.  
  133.   Norton Utilities are a trademark of Symantec.
  134.  
  135.   PC-Tools is a trademark of Central Point Software.
  136.  
  137. TurboTXT - Text File Compiler
  138. _____________________________________________________________________
  139.  
  140.  
  141. DESCRIPTION
  142.  
  143.   TurboTXT will convert a standard text file into a self displaying
  144.   EXE program, containing both text and the necessary code to display
  145.   the text.  The compiled file will have built in search and printing
  146.   capabilities.
  147.  
  148.  
  149.  
  150. COMMAND FORMAT
  151.  
  152.   TURBOTXT [/Axx] [/Fxx] source [destination]
  153.  
  154.  
  155.   /Axx          Sets the video attributes for the text being displayed.
  156.                 xx is the attribute value. Use the chart below to
  157.                 calculate the attribute value you wish to use.
  158.  
  159.   /Fxx          Sets the video attributes for the help line at the
  160.                 bottom of the screen being displayed. xx is the
  161.                 attribute value. Use the chart below to calculate the
  162.                 attribute value you wish to use.
  163.  
  164.   source        the source text file to be compiled.  Can be any
  165.                 standard DOS text file up to 63k bytes.
  166.  
  167.  
  168.   destination   can be any valid dos filename.  If no destination is
  169.                 entered the file created will be called README.EXE.
  170.  
  171.  
  172.  
  173. TurboTXT - Text file Compiler
  174. _____________________________________________________________________
  175.  
  176. COLORS
  177.  
  178.   TurboTXT allows you to choose the video attributes that will be used
  179.   to display the text in the compiled README.EXE program. The number
  180.   used to set the attribute is calculated by choosing the background
  181.   color and then the near ground color. The formula to use to get this
  182.   number is:
  183.  
  184.   A  = BACKGROUND COLOR x 16
  185.   B  = NEARGROUND COLOR
  186.  
  187.   xx = A + B;
  188.  
  189.  
  190.   BACKGROUND COLORS                   NEARGROUND COLORS
  191.  
  192.     BLACK      0                       BLACK          0
  193.     BLUE       1                       BLUE           1
  194.     GREEN      2                       GREEN          2
  195.     CYAN       3                       CYAN           3
  196.     RED        4                       RED            4
  197.     MAGENTA    5                       MAGENTA        5
  198.     BROWN      6                       BROWN          6
  199.     LIGHTGRAY  7                       LIGHTGRAY      7
  200.                                        DARKGRAY       8
  201.                                        LIGHTBLUE      9
  202.                                        LIGHTGREEN    10
  203.                                        LIGHTCYAN     11
  204.                                        LIGHTRED      12
  205.                                        LIGHTMAGENTA  13
  206.                                        YELLOW        14
  207.                                        WHITE         15
  208.  
  209.  
  210.   so to display LIGHTRED text on a BLUE background you would use
  211.   the following calclation:
  212.  
  213.   A  = 1 x 16  = 16
  214.  
  215.   B  = 12
  216.  
  217.   xx = 16 + 12 = 28
  218.  
  219.   TurboTXT /A28 README.TXT
  220.  
  221.  
  222.  
  223. NOTES
  224.  
  225.   The code overhead is slightly more than 1k bytes. When this program
  226.   is executed, the displayed text can be scrolled with the cursor
  227.   keys. Direct screen writing is used so the display is extremely
  228.   fast. Snow supression will occur if a CGA monitor is detected.
  229.  
  230.   The text file must be less than 63k in size and any lines exceeding
  231.   the width of the screen will be truncated. It is possible for the
  232.   resultant EXE program to be smaller than the original text file.
  233.   Most text files use a two byte sequence of a carriage return and
  234.   line feed (0Ch and 0Ah) to terminate each line. When the text is
  235.   converted the two bytes are replaced by a single null byte (00h).
  236.   Needless to say, the larger the text file the better the chance of a
  237.   size savings.
  238.  
  239.   If the output file is not specified README.EXE will be used. If the
  240.   extension is omitted from the output filename, EXE will be used.
  241.  
  242.   The following keys are available when the created program is
  243.   executed:
  244.  
  245.         Up Arrow        Scroll up one line
  246.         Down Arrow      Scroll down one line
  247.         Page Up         Scroll up one page
  248.         Page Down       Scroll down one page
  249.         Left Arrow      Scroll Left one character
  250.         Right Arrow     Scroll Right one character
  251.         Home            Go to start of text
  252.         End             Go to end of text
  253.         F               Find a string in the text file
  254.         A               Search for the next occurance of find string
  255.         P               Print the text file
  256.         ESC             Exit program
  257.         Alt-X           Exit program
  258.  
  259.  
  260.   The .EXE program produced automatically supports screen sizes other
  261.   than 80x25. As long as the proper screen values are in the BIOS data
  262.   area and the screen width is at least 80 columns and no greater than
  263.   255 columns it will work with the detected mode automatically.
  264.  
  265.  
  266. EXAMPLES
  267.  
  268.   TURBOTXT help.txt help
  269.  
  270.   The text in HELP.TXT is used to create HELP.EXE.
  271.  
  272.  
  273.  
  274. TECHNICAL SUPPORT
  275. _____________________________________________________________________
  276.  
  277.  
  278.   Often we get calls from people asking questions that can be
  279.   solved easily by checking through the manual before calling tech
  280.   support. We ask that you browse the manual and look for information
  281.   pertaining to your particular problem before calling. This can often
  282.   save you time, as we take a collection of our most common questions
  283.   and try to address them in this manual.
  284.  
  285.   We offer alternative methods besides the conventional phone
  286.   support, such as a multi-line 24-hour BBS system. We also monitor
  287.   most technical conferences in the BBS Interlink and RelayNet
  288.   networks as well as many conferences on the CompuServe
  289.   Information System. You may send messages and questions via any of
  290.   these services.
  291.  
  292.   Currently our Tech Support office is staffed Monday through Friday
  293.   from 9:00 a.m. to 5:00 p.m. Pacific Time. There is a chance,
  294.   however, that someone is in the office outside this time frame.
  295.   If so, we will gladly answer your questions outside the normal
  296.   business hours.  Registered users are given unlimited technical
  297.   support.
  298.  
  299.   Foley Hi-Tech Systems
  300.   Technical Support Department
  301.   185 Berry Street
  302.   San Francisco, CA  94107
  303.   (415) 882-1730
  304.   (415) 882-1733 FAX
  305.   (415) 882-1735 BBS
  306.   PCVENB CONF. 13 CompuServe
  307.  
  308.  
  309.  
  310. CREDITS
  311. _____________________________________________________________________
  312.  
  313.  
  314.   This collection of utilities started out as a small set of home
  315.   grown tools that I just could not stand to live without.  Many times
  316.   someone would see me using them and ask for a copy.  This was a big
  317.   mistake.  All of the sudden I had to debug my code.  Someone would
  318.   call me up and remind me of some problem with a utility that I had
  319.   written or asked me to just add this one little feature.  Six years
  320.   later the package has evolved to its current state.  Along the way I
  321.   have had the help of many people in testing and ideas for products.
  322.   I would like to thank all of those people who have of course
  323.   registered these utilities as this is now a new incentive for
  324.   continuing to expand them.  More specifically I'd like to thank the
  325.   following:
  326.  
  327.   Kathy Smith
  328.   Jay Wessel
  329.   Roger Cross
  330.   Brian & Tess for Channel 1
  331.   Paul Somerson & Bantam Books
  332.   PC Tech Journal (A Great Loss)
  333.   PC Magazine
  334.   Byte Magazine
  335.   Jerry Pournelle
  336.   Association of Shareware Professionals
  337.  
  338.  
  339.  
  340.  
  341. PROGRAMMING
  342.  
  343.   The ExtraDOS Toolbox utilties use a wide variety of programming
  344.   tools including:
  345.  
  346.   Borland Turbo Pascal 7.0
  347.   Borland Turbo Assembler 3.0
  348.   Borland Turbo C++ 1.0
  349.   Borland Turbo Debugger 2.0
  350.   Turbo Power Software Object Professional 1.0
  351.   Phil Katz' PKLite Professional 1.13
  352.   Unity Programmers Editor 3.33
  353.   Ralph Browns' Interrupt List
  354.  
  355.  
  356.   Programming by:
  357.  
  358.   Mike Blaszczak
  359.   David Foley
  360.   Joe Halpin
  361.   Bill McKee
  362.   Mike Molloy
  363.   Mike Viens
  364.   Ross Wentworth
  365.   Randall Woodman
  366.  
  367.  
  368. CREDITS
  369. _____________________________________________________________________
  370.  
  371.  
  372.  
  373. ART
  374.  
  375.   Artwork for the ExtraDOS Toolbox was created using:
  376.  
  377.   Ian Davis' TheDraw 4.01
  378.   Aldus Freehand 2.0
  379.   Electronic Arts Studio/8 2.0
  380.  
  381.  
  382.   Art by:
  383.  
  384.   David Foley
  385.   Noel Gamboa
  386.   Moses Gates
  387.   Shahasp Herardian
  388.   Pat McSween
  389.   Ross Wentworth
  390.  
  391.  
  392. DOCUMENTATION
  393.  
  394.   Documentation for the ExtraDOS Toolbox was written using:
  395.  
  396.   FHTS SuperEdit 3.04
  397.   Word Perfect 5.1
  398.   MS Word for Windows 2.0
  399.   Grammatik for Windows 1.0
  400.   Aldus Pagemaker 4.0
  401.   Unity Programmers Editor 3.33
  402.  
  403.  
  404.   Documentation by:
  405.  
  406.   Mike Blaszczak
  407.   David Foley
  408.   Mike Viens
  409.   Ross Wentworth
  410.  
  411.  
  412.   Printed Manuals by:
  413.  
  414.   BindCo, Brisbane, CA.
  415.  
  416.  
  417. LICENSE INFORMATION
  418.  
  419.   CHIMES, EVAL and RAMDRIVE are derivatives of the Nifty James
  420.   utilties by Mike Blaszczak.
  421.  
  422.   FILEATTR, NAMEDIR and SWAPFILE are derivatives of the Fantastic
  423.   Utilities by Mike Viens.
  424.  
  425.  
  426.  
  427. FHTS Products
  428. _____________________________________________________________________
  429.  
  430.  
  431. Safety Disk (tm)
  432.  
  433.   Safety Disk saves all of your systems vital information and will
  434.   solve most problems due to:  Loss of battery power, Loss of CMOS
  435.   information, accidental deletion of boot files, virus damage to boot
  436.   disk.
  437.  
  438.  
  439.   "Use Safety Disk and your PC is Safe.", Computer Shopper, March 1992
  440.  
  441.   "Used in Conjuntion with a conventional backup utility, Safety Disk,
  442.    for $59.95 will provide as bulletproof a backup as you're likely to
  443.    find in the PC marketplace.", InfoWorld, February 10, 1992
  444.  
  445.   "Safety Disk is so deceptively easy to use that it makes hard-drive
  446.    and computer maintenance seem impossibly easy.", PCM Magazine, May
  447.    1992
  448.  
  449.   "I have discovered the most unique and useful system maintenance
  450.    utility since Spinrite came along.", MBUG PC Newsletter, December,
  451.    1991
  452.  
  453.  
  454. ExtraDOS Toolbox (tm)
  455.  
  456.   A large collection of over 50 utilities that DOS forgot. Includes
  457.   many helpful utilities that enhance MS-DOS machines. Featured in the
  458.   DOS Power Tools, 2nd Edition, Revised for DOS 5.0 book by Bantam
  459.   Books.
  460.  
  461.  
  462. WizLabel (tm)
  463.  
  464.   Print Sharp Wizard phone listings directly to your SLP Printer
  465.   without having to convert your data.
  466.  
  467.  
  468. Coach Database System■.
  469.  
  470.   CDBS provides a method for tracking and evaluating NBA teams, NBA
  471.   players, and college players. It supplies a comprehensive report
  472.   generator for building decision support reports on scouted players.
  473.  
  474.  
  475. FHTS Products
  476. _____________________________________________________________________
  477.  
  478.  
  479.  
  480. Press Gate Manager■.
  481.  
  482.   Software for event organizers. Creates and maintains a database of
  483.   events and guests with the ability to track seating by type,
  484.   location, and person. Produces seating charts and labels for press
  485.   passes.
  486.  
  487.  
  488. FINDB■.
  489.  
  490.   Financial Database System for tracking shareholders in a company.
  491.   Allows the instant retrieval of information based on any part of a
  492.   persons account id, ss#, zip code etc.  Has support for completely
  493.   customized HP Laserjet tax forms.  Ideal for generating K1 tax
  494.   reports for limited partnerships.
  495.  
  496.  
  497.  
  498. EXTRADOS TOOLBOX UPCOMING ADDITIONS
  499. _____________________________________________________________________
  500.  
  501.  
  502. We are constantly adding new utilities to the ExtraDOS Toolbox
  503. collection.  Some are developments of ideas from our customers.  If
  504. you know of a utility that you would find handy or updates to
  505. existing utilities please let us know about them.
  506.  
  507.  
  508. BATPLUS     Collection of enhancements for DOS Batch files.  BATPLUS
  509.             enhancements will also be supported by TurboBAT.
  510.  
  511. BOOTMGR     Boot Manager will allow you to choose from many different
  512.             boot up configurations by displaying a menu of choices
  513.             at boot time.  Each configuration can have a seperate
  514.             AUTOEXEC.BAT and CONFIG.SYS associated with it.
  515.  
  516. DIALIT      Small TSR that allows you to pop up over any text screen
  517.             and capture a phone number and then dialing with your
  518.             modem.
  519.  
  520. DIFF        Full screen file comparison utility.  Will display the
  521.             differences between two different files.
  522.  
  523. DIRSORT     Sort directories by Name, Extension, Date, Time or Size.
  524.  
  525. DISKTEST    Command line utility to perform testing functions on disk
  526.             drives looking for bad sectors or clusters.
  527.  
  528. EMSX86      EMS 4.0 Memory Manager that converts Extended Memory into
  529.             LIM EMS 4.0 Expanded memory.
  530.  
  531. FKEYSET     Allows you to assign customized values for all the function
  532.             keys.
  533.  
  534. LQPRINT     Allows 9 pin dot matrix printers to print near letter
  535.             quality output by converting text into high resolution
  536.             graphics.
  537.  
  538. NBSTIME     Will set your PC clock to National Atomic Clock time by
  539.             calling NBS with your modem.
  540.  
  541. PRMPTMGR    Prompt Manager gives you access to a library of DOS prompts
  542.             and allows you to create your own DOS prompts.
  543.  
  544. PRINTCTL    Print Controller is a multiple printer spool and configuration
  545.             utility.  Supports EMS or DISK spooling and up to three
  546.             printer ports.
  547.  
  548.  
  549. EXTRADOS TOOLBOX UPCOMING ADDITIONS
  550. _____________________________________________________________________
  551.  
  552.  
  553. SORT        Advanced SORT utilty for DOS.  Features many enhancements o
  554.             over the DOS version.
  555.  
  556. SPEEDFL     Increase access to some floppy disk drives.
  557.  
  558. SPLITFL     Split files into multiples for modem or diskette transfers.
  559.  
  560. STOPWTCH    Stop Watch allows you to time programs at the DOS prompt.
  561.  
  562. SWAPFILE    Swap to file names with the associated files.
  563.  
  564. XCD         Smart CHDIR command.  Will accept partial names.
  565.  
  566. XDEL        Advanced delete command.  Allows many options and exclusions.
  567.  
  568. XDIR        Updated DIR command with sort options.
  569.  
  570. ZIPCODE     TSR to allow the searching of US Postal Zip Code Database.
  571.  
  572.  
  573.  
  574.  
  575.   The latest versions of the ExtraDOS Toolbox utilities can be found on:
  576.  
  577.   FHTS PC GURU III BBS, San Francisco, CA  (415) 882-1735
  578.  
  579.   CHANNEL 1 BBS, Cambridge, MA             (617) 354-8873
  580.  
  581.   COMPUSERVE INFORMATION SERVICE           PCVENB CONF. 13
  582.  
  583.