home *** CD-ROM | disk | FTP | other *** search
/ Black Box 4 / BlackBox.cdr / fileutil / a2c200.arj / ASC2CDOC.COM (.txt) < prev    next >
Encoding:
Asc2Com (MorganSoft)  |  1992-05-15  |  30.5 KB  |  753 lines

  1.  
  2.    
  3.   Asc2Com  Ver.   2.00    
  4.   Shareware  by MorganSoft
  5.   All Rights Reserved     
  6.   Copyright 1989-1992     
  7.                           
  8.    
  9.   Liscening:    
  10.   ΓAsc2Com   and   the  Ascc2Com  package may not be  distributed   forΓ  
  11.   Γprofit  without express,   prior written approval  from  MorganSoft;Γ   
  12.   Γthe  maximum   copying   charge   that  may be  charged for  copyingΓ 
  13.   ΓAsc2Com   iS   $7.50.   BBS'S and shareware libraries (such  as  theΓ  
  14.   ΓPublic  (software)    Library)   are encouraged to  distribute   theΓ  
  15.   ΓAsc2Com  package  (with  thanks from  MorganSoft).                  Γ
  16.                                                                                
  17.   ΓIf you have an unregistered,   evaluation copy,  please feel free toΓ 
  18.   Γtry   it   out  as you see fit.    You  are  not,    however,     toΓ  
  19.   Γdistribute   the   resulting   files   in  any  fashion  whatsoever.Γ     
  20.   ΓYou   are   allowed  a  reasonable  period  of   time   to  evaluateΓ 
  21.   ΓAsc2Com before   registration  becomes  obligatory (For the purposesΓ 
  22.   Γof  this agreement,   a   reasonable  evaluation period is to be notΓ 
  23.   Γmore than 6 weeks).                                                 Γ
  24.                    
  25.   A private registration costs π$25.00π  and licenses you to produce but 
  26.   not  distribute   programs.     Commercial  registrations  begin  at 
  27.   π$35.00π   and licenses you  to produce  and distribute  any  programs  
  28.   produced,  in  a commercial  endeavor,   ΣEXCEPT FOR ELECTRONIC BOOKSΣ 
  29.   ΣAND MAGAZINES.   A  Royalty fee of 5%  of the cost of the ElectronicΣ 
  30.   Σbook  or  Magazine distributed will be required.   THIS IS A  CHANGEΣ 
  31.   ΣFROM PREVIOUS POLICYΣ.   I  repeat,  for clarity:   royalties will be 
  32.   charged  for  Electronic  Books and Magazines,  but  not  for  other 
  33.   programs.   Disk Vendors for the purpose of this agreement will  NOT 
  34.   be required to pay a royalty.  (Too many have been too supportive in 
  35.   the past.  It wouldn't seem right.)  All registrations  entitle  you 
  36.   to use  Asc2Com  on any computer that    you  have   access  to & to 
  37.   one update  free (plus  a  $3.00     shipping  & handling charge for 
  38.   domestic orders, $6.00  for  international.  Canadian orders will be 
  39.   handled as domestic rather  than  international)  whenever you elect 
  40.   to (and a newer version  exists).   
  41.  
  42.   ΓTHE   ONLY   DIFFERENCES  BETWEEN  AN UNREGISTERED  SHAREWARE   COPYΓ  
  43.   ΓAND  A REGISTERED  ONE ARE AS FOLLOWS:   Registered copies have yourΓ 
  44.   ΓRegistration  ID Number in them.   Unregistered version  also alwaysΓ 
  45.   Γbegin with a dialog box identifying the program.                    Γ
  46.  
  47.   ΓIF   YOU   DO ELECT TO UPLOAD ASC2COM TO A BBS,   PLEASE  KEEP   THEΓ
  48.   ΓENTIRE PACKAGE TOGETHER.                                            Γ
  49.  
  50.  
  51.   Purpose:
  52.   Asc2Com   is   a  general  purpose  documentation  utility/help file
  53.   generator that·makes documentation  for  programs  and files easy to
  54.   access  for  the  user. Specifically,    Asc2Com  generates  a self-
  55.   listing  Com  program  from  an ASCII text  file.    You  have  your
  56.   choice  of six   differing  types  of programs to generate:
  57.  
  58.   FileList:
  59.   The entire package consists of the following files:
  60.  
  61.   Main Programs:
  62.      πAsc2Com.Exe       π     Main Program.
  63.      πA2C.Exe           π     Command line version.
  64.      πSed.Com           π     Editor supplied with Asc2Com.
  65.      πLzw.Exe           π     Compression Program.
  66.      πA2C.Exe           π     Command Line version of Asc2Com.
  67.  
  68.   Aux. Files:
  69.      πAsc2Com.Brs       π     Resource file containing menus.
  70.      πA2CHlp.Hlp        π     On-Line Help File.
  71.      πLzw.Exe           π     Compression program.
  72.      πAsc2Com.Ico       π     Windows 3.x Icon.
  73.  
  74.   Lister Image Files:
  75.      πComprss.Bin       π
  76.      πFL.Bin            π
  77.      πPage.Bin          π
  78.      πLite.Bim          π
  79.      πWide.Bin          π
  80.      πPrintr.Bin        π
  81.  
  82.   Documentation Files:
  83.     πAsc2CDoc.Com       π     Main Doc File.  This one.
  84.     πSEDDoc.Com         π     Doc file for editor.
  85.     πSEDEDIns.Exe       π     Command Installation program for SED.
  86.     πWhatsNew.Com       π     What's new with Version 2.0
  87.  
  88.   Configuration Files:
  89.     πA2C.Cfg            π     Current Defaults for program.
  90.     πA2CTran.Stm        π     Configuration of Transfer programs.
  91.     πA2CClr.Cfg         π     Colors   to  be  used   with   Asc2Com.
  92.  
  93.   Installation Files:
  94.     πRunMe.Exe          π     Installation program
  95.     πInst.Def           π     Configuration program for install.
  96.  
  97.   Setup: 
  98.           
  99.   If you have an unarced copy of Asc2Com package,  copy all the  files 
  100.   to whatever directory that you decide will be the home directory for 
  101.   Asc2Com.  (if you have the arced version, copy that to the directory 
  102.   and unarc.).  
  103.  
  104.   Next, you will need to set one environmental variable.   To do this, 
  105.   using whatever editor you, edit your AUTOEXEC.BAT file by adding the 
  106.   following line: 
  107.  
  108.      Γ set a2c=PATH Γ 
  109.  
  110.   where  PATH  is the full path name for the directory  where  Asc2Com 
  111.   will   be.   Γ ASC2COM  WILL  NOT  RUN  WITHOUT  THIS  LINEΓ  in  your 
  112.   autoexec.bat.   The program needs to be able to locate several files 
  113.   at  all time and will not be able to,  should the environment not be 
  114.   set correctly.   Once you have done this,  reboot your computer  and 
  115.   you're ready to run. 
  116.  
  117.   Menu Options:  
  118.  
  119.   The menu bar for the program consists of 3 options:  
  120.  
  121.       Files    Lister    Options 
  122.  
  123.   which have the following functions:   
  124.   
  125.   Files:
  126.   relates to opening and manipulating of files that you wish to view. 
  127.   
  128.   Lister: 
  129.   allows you to change the Lister Type, the Colors used, the Hot Keys, 
  130.   and other parameters of the various listers.  
  131.   
  132.   Options:
  133.   provides a means of changing the default colors of  Asc2Com  itself, 
  134.   actually chose and process a file, or to run external programs. 
  135.  
  136.  
  137.   Individual Menu Options:  
  138.  
  139.   Files:            
  140.       Open             Open a file to browse 
  141.       Close            Close the most current file window 
  142.                  
  143.       Tile             Make all windows non-overlapping 
  144.       Cascade          Overlap  windows,  leaving top visible 
  145.  
  146.       Prev             Make the previous window current. 
  147.       Next             Make the next window the top window 
  148.       Zoom             Either make the top window full screen, or shrink 
  149.       Resize           Change the size of the current window 
  150.  
  151.       Chg Drive        Change the current drive or directory 
  152.       Shell            Shell to DOS 
  153.       Register         Fill out the form to Register Asc2Com. 
  154.       Exit             Leave Asc2Com (return to DOS) 
  155.  
  156.   Lister 
  157.       Type             Chose the type of lister to produce 
  158.       Color            Pick the colors that the lister will use 
  159.       Hot Keys         Pick the Hot Keys that will be used by the 
  160.                          Printer lister 
  161.       Help Screen      Configure the Help Screen 
  162.       Special Chars    Pick which characters will mark colors or taglnes 
  163.       Filters          Set various filter options 
  164.  
  165.   Options 
  166.       Colors           Pick the colors that Asc2Com uses 
  167.       Process          Chose a file and then process it 
  168.       Transfer         Transfer control to an external program. 
  169.  
  170.                          
  171.   Options of Lister Type  
  172.    
  173.  Γ Compressed: Γ 
  174.   The compressed lister is new to the 2.00  version and is a  complete 
  175.   rewrite of  the original full lister.   All of the options available 
  176.   under  the  full  lister  are  available--except  for  the  complete 
  177.   omission of BIOS screen  writes and command line switches.  CGA Snow 
  178.   Checking is available through a toggle while in the program.    Also 
  179.   numeric paging is not supported. The new options are as follows: 
  180.  
  181.  π Ten End User Bookmarks.  π 
  182.   More  mouse  support.   The Status Line now allows clicking  on  the 
  183.   various  options,   allowing  the user to page,  scroll up or  down, 
  184.   invoke Find/Repeat Find, and Help.  
  185.                 
  186.  π Automatic Resume:π   
  187.   if  the  user  leaves the program,  and then returns,   he  will  be 
  188.   immediately placed on the same page. 
  189.  
  190.  π DOS Shell:π
  191.             
  192.  π Keys Reconfigurable:π
  193.   Most of the Keys are Primary User Reconfigurable.  (Through the Main 
  194.   Program, Asc2Com). 
  195.  
  196.  π Pagination:π
  197.   Write to Printer now includes end user configurable pagination.  
  198.  
  199.  π Print Marked Blocks:π
  200.   Blocks may be marked and written to the printer. 
  201.  
  202.  π Help Screen Reconfigurable:π
  203.   The help screen is primary user configurable. (Again, through the Main 
  204.   Program, Asc2Com, rather than the 1.76 Version, HelpInst.Exe). 
  205.  
  206.  π Limits Expanded:π
  207.   In addition, the limits of Asc2Com have been expanded  considerably, 
  208.   through the use of LZW data compression.  
  209.  
  210.   Full Lister: 
  211.   Listing can be  accomplished by single lines up and  down,  page, or 
  212.   by numerical choice.   The output file  can take  a  /h (Hard Copy),   
  213.   /c   (CheckSnow),     /p  (Standard  Output,     Pause),    and   /s  
  214.   (Standard  Output)  switch.      A   Find option is  available,    2   
  215.   "TagLnes",  user  chosen,     Write  to File  (Alt-F),    Write   to 
  216.   Printer  (Alt-H),   and a Help Screen (F1).     A   mouse  is  fully 
  217.   supported,   as well as five colors:    Main  Screen Color,   Bottom 
  218.   Line Color,  HelpScreen Color,  Accent  1 Color, and Accent 2 Color. 
  219.    
  220.   Page Lister: 
  221.   This  lister is functionally the same as the  full lister except  it  
  222.   will NOT scroll line by line.   The size  is slightly smaller. 
  223.    
  224.   Prnter: 
  225.   The  smallest  and   simplest of the  Com  file  produced by Asc2Com 
  226.   (about 400  bytes of overhead)  and lists the file to LPT1 only.  No 
  227.   switches are allowed (or needed). 
  228.         
  229.   Lite: 
  230.   The   smallest of the 5 video listing Com files and   it has many of 
  231.   the   same  listing abilities  as  the   Full Lister.      The  only 
  232.   differences   are  that  3  switches  are  allowed    by    programs  
  233.   generated  with   this   option: /c (CheckSnow),  /f (Produce File), 
  234.   and  /h (Print File). The  mouse  if  fully supported,   as are  all  
  235.   5  colors available under the  Full  and Page lister--the help color 
  236.   will  be  used as a third Accent color in lieu  of  being used  with  
  237.   a   help  screen.   No find  option  has  been incorporated at  this 
  238.   time. 
  239.    
  240.   Wide: 
  241.   This    lister is based on the Lite,    and has   all   of the  same 
  242.   command lines options.  However,    as the name suggests,     you're   
  243.   not  limited  to   files   of  80  columns  or  less. Strings  of up 
  244.   to 255   characters are allowed.      The  mouse is fully supported,  
  245.   as  are  all colors. 
  246.   
  247.   Preparing the Text File: 
  248.           
  249.   How you prepare your text file will depend on the type of lister you 
  250.   chose to use.    Several of the listers have aspects  in common  and 
  251.   will require pretty  much the same preparation.   For the Full, Page 
  252.   and  Comprssed Listers,  you will need to decide if you wish to  use 
  253.   TagLnes and if so, where.  You might wish to scroll through the file 
  254.   and see what natural breaks there  are,   or  places where important 
  255.   topics are located.   (For example,  each topic of this help file is 
  256.   part  of  TagLne1.    The second TagLne takes  the  user  to  either 
  257.   contacting MorganSoft, or Registration Information).   
  258.  
  259.   With  the  Page  Lister you need to set up the paging for  the  file 
  260.   carefully, so that each page is complete. 
  261.  
  262.   Next,  decide if you wish to highlight certain portions of the  text 
  263.   with different colors.  You have 4 colors available for this and you 
  264.   might need to process the file several times before you achieve  the 
  265.   effect desired. 
  266.  
  267.   If  you  are  using the Lite or the Printer Lister,  you  have  very 
  268.   little  in  the way of preparation to do--both of  these  produce  a 
  269.   clean,  tight stream of data with little embellishment.   I  suggest 
  270.   the   use   of  these  two  listers  for  ordinary   but   important 
  271.   documentation. 
  272.  
  273.   The preparation for the Wide Lister is the only lister that does NOT 
  274.   require  that you truncate all lines at column 80.   Lines can be as 
  275.   long as 255 characters. 
  276.  
  277.   The  Comprssed  Lister,  since this lister has the  most  number  of 
  278.   options,   requires the most preparation,  particularly so since how 
  279.   the  file is prepared will directly affect how much  compression  is 
  280.   achieved.  See the section on compression. 
  281.  
  282.  
  283.   Colors: 
  284.           
  285.   The   1.75     version  of  Asc2Com  added quite  a   bit   to   the 
  286.   available  colors in the output lister.   You will have a choice  of 
  287.   five  foreground and background combinations to use in  your  files.   
  288.   The five colors are used in the following manner: 
  289.    
  290.   Screen Fore & Background: 
  291.   This  is the foreground (FG)  and background (BG)  colors that  will  
  292.   be  used  for the screen and general  text  the lister will display.  
  293.   Default is white FG and blue BG. 
  294.    
  295.   Bottom Line FG & BG: 
  296.   This  is the color that the prompt line at the bottom  of the screen 
  297.   will have. 
  298.    
  299.   Accent 1 & 2 FG & BG: 
  300.   The   accent  colors  and their placement are determined  by placing 
  301.   the corresponding accent character.   
  302.    
  303.   To   mark  any  section  of text that you wish  to  high   light  or  
  304.   "accent",    place the corresponding  accent  character before   the  
  305.   first   position  you wish  to  highlight  and  immediately   behind  
  306.   the   last portion--σALL ON  THE  SAME LINE.σ   Very  strange  results 
  307.   will  occur  when you scroll if you do not pair characters  on  each 
  308.   line. 
  309.    
  310.   When  placed,    the characters will πNOTπ be shown  on   the  screen.  
  311.   Note,   however,  that they will print out when the lister prints to 
  312.   file. 
  313.  
  314.   Help FG & BG: 
  315.   This is the color that will be used for the help screen when it pops 
  316.   up.  Also used as a third Accent color. 
  317.    
  318.   Filters: 
  319.           
  320.   Filters   are  operations (with one  exception)     that   will   be 
  321.   performed   on   each  line  of the source text file  before   being 
  322.   written   out to the COM file.    You  may  perform  the   following 
  323.   operations:     Make Upper Case,   Make Lower Case,   Pad  the  left 
  324.   margin with spaces,  Strip the left margin of characters,   or Strip  
  325.   ASCII  control codes between 0 and 31    inclusive.      In previous  
  326.   versions  the  option of  expanding  tabs  was  also available,  but 
  327.   is no longer supported.   All of the active filters  are   shown  in 
  328.   the dialog box.  If you  elect  to change  one of them,  simply mark 
  329.   the appropriate box and then fill in any other information  required 
  330.   (suggest column increment for the Pad or the Strip Left options). 
  331.    
  332.   Keys:  
  333.  
  334.   This  menu option is only for the Compressed Lister,  The  following 
  335.   keys can be changed by the Primary User : 
  336.  
  337.         ΓFind               Γ  
  338.         ΓFind Again         Γ
  339.         ΓBegin Marking      Γ
  340.         ΓEnd Marking        Γ  
  341.         ΓJmp TagLne 1 & 2   Γ     
  342.         ΓWrite File         Γ
  343.         ΓPrint File         Γ  
  344.         ΓShell              Γ
  345.         ΓToggleSnow         Γ
  346.         ΓEnter Mark Mode    Γ  
  347.         ΓJmpToBK 1-0        Γ
  348.         ΓSetBK 1-0          Γ
  349.         ΓHelp               Γ
  350.  
  351.  
  352.   Disabling Hot Keys:  
  353.  
  354.   All hot keys except help can be disabled if you so wish.   To do so, 
  355.   simply set the hot key to the same as a proceeding hot key.  (That's 
  356.   why you can't disable Help--it's the first hot key). 
  357.  
  358.   Only certain characters or keystrokes are allowed to be hot keys: 
  359.  
  360.         ΓA-Z  (= a-z)   Γ
  361.         ΓShiftF1 - F10  Γ
  362.         ΓAltF1 - F10    Γ
  363.         ΓCntlF1 - F10   Γ
  364.         ΓAltA - Z       Γ
  365.         ΓF1 - F10       Γ
  366.                                                
  367.   HelpScreen: 
  368.  
  369.   As mentioned above,  the Help Screen in its entirety is configurable 
  370.   from  this option.   Simply type in the help screen you wish,  using 
  371.   the up and down arrow keys to move between each line.  π Note:   when π
  372.   πyou  first  move to a line,  it should change color;  if you wish to π
  373.   πkeep any of the line intact--PRESS AN ARROW KEY first.π  If you enter 
  374.   any  character,  the entire line will be wiped.   Also note,  if the 
  375.   cursor is a single line rather than a block cursor, you will need to 
  376.   present  the  INS Lock key (changing the mode to  overwrite).    The 
  377.   default  help screen completely fills up the space allowed  for  the 
  378.   help screen and if in insert mode, no characters can be be inserted.  
  379.   The box drawing characters are available using the keys outlined  to 
  380.   the right of the help input lines. 
  381.  
  382.   Process: 
  383.           
  384.   A  Dialog  Box will appear showing the current directory  and  those 
  385.   files available.   The default extent is .TXT.  Simply pick the file 
  386.   you  wish and move the highlight to "Open"   with the Tab Key or use 
  387.   the mouse to select that button.   That file will then be  processed 
  388.   with the current set of options. 
  389.    
  390.   Transfers: 
  391.  
  392.   This dialog box allows you to Run,  Delete,  Edit,  Add (New),   and 
  393.   Cancel  program transfers.   These transfers are  actually  programs 
  394.   that you can run from within Asc2Com.  
  395.  
  396.   Each  entry is will consist of three lines of input:   the first  is 
  397.   the Title that will appear in the List Box (on the Left side of  the 
  398.   dialog  box).   The πsecondπ is the πfull path name of the  programπ  to 
  399.   run.   It MUST include the drive,  the directory, the name,  and the 
  400.   extent  if the program is to run correctly.   The third line will be 
  401.   used to provide the program with command line parameters.  
  402.  
  403.   Please note, Γ some programs will "hang"  when run from the  TransferΓ
  404.   Γbox--they need their own copy of COMSPEC invoked.   If you encounterΓ 
  405.   Γa program that "hangs", try the following:Γ 
  406.  
  407.   Fill in the Title as you would normally. 
  408.   
  409.   Instead  of  placing the full path name of the program you  wish  to 
  410.   run,   place  instead the full path of whatever  COMSPEC  (generally 
  411.   command.com)  your system uses.   For example,  if your system boots 
  412.   from drive C normally,  uses DOS version 3.00+,  and keeps it's copy 
  413.   of  command.com  in  the root directory,  then  you  would  use  the 
  414.   following line: 
  415.  
  416.      C:\COMMAND.COM 
  417.  
  418.   In the line for Cmd Line Parameters,  you need to place the name  of 
  419.   the program you wish to run, PRECEEDED by a "/C ".  For example: 
  420.  
  421.      /C C:\UTILITY\MYPROG.EXE file1 file2 
  422.  
  423.   would run a program called Myprog.exe,  found on the C drive, in the 
  424.   subdirectory Utility,  with two command line parameters:  file1  and 
  425.   file2. 
  426.  
  427.   Shell: 
  428.           
  429.   This  a typical DOS shell which allow you to do  anything you  could  
  430.   normally  do from  DOS,   subject  to  memory constraints of course.   
  431.   To return to Asc2Com simply type "exit" at the DOS prompt. 
  432.    
  433.   Exit: 
  434.          
  435.   Does exactly what it says.  Exits from Asc2Com. 
  436.    
  437.    
  438.   SED Editor:  
  439.  
  440.   Run the program SEDDoc.Com for information about using this program. 
  441.  
  442.    
  443.   ComFile Operation:  
  444.  
  445.   Four   of  the  Com Files produced accept command   line   switches,   
  446.   as follows: 
  447.    
  448.   /c:   Wait for retrace,  used for CGA systems with snow. /p:   Pause 
  449.   mode.   Use the Standard BIOS Output and pause  until  key  pressed, 
  450.   before  going  to  the  next page.  /s:   Use Standard BIOS  Output, 
  451.   instead of direct screen writes. /h:  Send output to printer. 
  452.    
  453.   Lite Lister & Wide Lister:  
  454.   Switches:  /h, /c, /f. /h:   Sent output 
  455.   to printer.  /c:   Wait for retrace, used for CGA systems with snow. 
  456.   /f:  Generate text file from Com file. 
  457.    
  458.   Compressed Lister: 
  459.   No Command Line switches supported. 
  460.  
  461.   In  this section,  Compressed Lister Default Commands will be framed 
  462.   in brackets {}. 
  463.   
  464.   F1 {F1}:  Help.  
  465.   This  pops up a screen listing all available keys and what they  do.  
  466.   See HelpInst for details of customizing. 
  467.    
  468.    
  469.   F2 & F3 {F2 & F3}  : TagLne1 and TagLne2.   
  470.   Special    "Find"commands,      that  only  locate  1  of  2    non-
  471.   display  characters.      Place the special TagLne characters  where 
  472.   ever  you   wish the user to be able to jump to when  they  hit  the 
  473.   appropriate  key.    You could,   for example,   place  all  TagLne1  
  474.   characters  at  topic headings--thereby  allowing  the user to  jump 
  475.   from topic to topic with  a  single keystroke.     These  characters 
  476.   will  be invisible due to the  fact  that during processing they are 
  477.   converted to Hex 00  or Hex FF which  appear as spaces. 
  478.    
  479.   Alt-H {Alt-W}: Write  to Printer. 
  480.   This   option  clears the screen and queries if you want to send the 
  481.   file to the printer.   When the printing is  completed,   the screen 
  482.   will be cleared again, on the same page. 
  483.    
  484.   Alt-F {Alt-P}: Write to File. 
  485.   This  also  clears the screen,    but only the words "Writing  File"   
  486.   will  appear  in the center of the screen.    An ASCII copy of   the  
  487.   original  file,     with the same file name will be created IN   THE 
  488.   CURRENT  ACTIVE DIRECTORY  AND  DRIVE.    As with the Alt-H  option,  
  489.   you  will   then   be returned  to  the  same  position  in the file  
  490.   when  the   action   is completed. 
  491.    
  492.   F/F7  {F}:  Find. 
  493.   When pressed,   a   prompt will appear on the bottom   line  "Find:"    
  494.   and  the   user   can  then enter  a  maximum  of  11     characters  
  495.   for   the search.       When  the  search string  is  found,     the  
  496.   string   will  be highlighted  in  its  entirely  in reverse  video.    
  497.   The search   will be  "Global"   in that it will begin on the   line 
  498.   directly below the top line on the screen, and "wrap around" back to 
  499.   that  position.    That is,  if you have line 40  at the top of  the 
  500.   screen,   the search will commence with line 41,  through the end of 
  501.   the file,  and then re-start at line 1,  and then ending at line 40.  
  502.   If not found,  a bell will sound.   Searches are  CASE  INSENSITIVE.   
  503.   If  you   make a  mistake entering  the  "Find"   string,   use  the 
  504.   backspace correct it. 
  505.    
  506.   R/F8 {A}:   Repeat  Find/TagLne. 
  507.   This    repeat    begins   the  search  from immediately  below  the  
  508.   last find.     If another occurrence of the  target string exists on 
  509.   the same 
  510.    
  511.   Compression Pointers: 
  512.  
  513.   The  compression  algorithm   used in Asc2Com is  the  standard  LZW 
  514.   (Lempel-Ziv-Welch) one originally used in the Arc programs.   If you 
  515.   understand  a  bit  of HOW the algorithm works,  you can  make  some 
  516.   changes to the structure of your text file,  that will increase your 
  517.   compression, often by as much as 10 %.  So here goes. 
  518.  
  519.   The  LZW  algorithm  is a dictionary approach that  assumes  NOTHING 
  520.   about the incoming data stream, and works on one single pass through 
  521.   the data.  A  set  of tables are set up to hold codes and individual 
  522.   characters  which are generated on the fly--making LZW  one  of  the 
  523.   faster  methods  available.   At the beginning,  two bytes are taken 
  524.   from  the  incoming data,  a  number computed (peculiar to  the  two 
  525.   characters)   and    the first available char is written to the code 
  526.   table.  This represents the combination of these two characters (say 
  527.   a  "T"  and an "h"  from the word "The").   The second character  is 
  528.   written  to  character table.   Now the  program  places  the  first 
  529.   character into the output,  moves the second character into the slot 
  530.   of the first, and grabs the third char.  At this point, the programs 
  531.   tries  to  begin using the tables to compress the data--it  computes 
  532.   the a number (as above--it's called a Hash Value) and looks it up in 
  533.   the table.  If it finds it, it places the corresponding code in slot 
  534.   one,  discards the second character,  and grabs another,  to  repeat 
  535.   until done.  
  536.  
  537.   The reason LZW works is that it uses numbers larger than can be held 
  538.   in  a  single  byte for the code  representations--in  the  case  of 
  539.   Asc2Com,   I  use 9-Bit and 10-Bit values--thus saving some space by 
  540.   often coding three or four characters into, say,  9  bits.   (Saving 
  541.   for 3 characters is 27  -  9  or 18  bits,  or 2 bytes.   (For heavy 
  542.   weight  programmers   out  there--I know,   a   gross  and  slightly 
  543.   inaccurate representation of LZW.   Forgive me).  The main points to 
  544.   remember are that 1:   There are only so many code values  available 
  545.   using 9 and 10  bit values.  2:  Letter combinations that are common 
  546.   throughout the file are a "plus". 
  547.  
  548.   Now for suggestions.   ΣIf you can avoid using graphics characters atΣ
  549.   Σthe  beginning of your file,  do so.   The combinations you get willΣ 
  550.   Σ"clog"  the tableΣ and not give you much by way of compression.    If 
  551.   you  have  a  left margin,  try to keep it close as  possible  to  a 
  552.   multiple  of  8--the  size of a tab.    Asc2Com  will  automatically 
  553.   substitute  a tab for you,  and you'll find that you'll get a better 
  554.   mix of codes in your table. 
  555.  
  556.   A slight digression here:   the basic logic of my implementation  of 
  557.   LZW came from an article by Mark Nelson in Dr. Dobb's Journal, which 
  558.   was  written  in C--I never was able to get the original to work.  I 
  559.   suspect a misprint in the source code,  but in any event,  I  had  a 
  560.   dickens of time translating it into  Assembly  Language.  Due to the 
  561.   time  it  did  take,  I  elected to freeze the Asam  source  when  I 
  562.   finished the 9 and 10  bit implementation,  rather than going on  to 
  563.   adding  11  and 12  bit tables.   Quite frankly,  I  was sick of it.  
  564.   Expect  the next version of Asc2Com to implement that,   plus  table 
  565.   flushing  and  a couple of other tricks.   I  suspect the amount  of 
  566.   compression will go up significantly. 
  567.  
  568.  
  569.  
  570.   Limitations: 
  571.            
  572.   For  all of the Listers Except the Compressed  Lister:   Max    file  
  573.   size  that can be processed is variable--I wish I could give  you  a 
  574.   firmer answer that that.    It depends entirely on how much  of  the 
  575.   file   gets converted to tabs it to a tab,   gaining 7  bytes  back.    
  576.   The Full  Lister and the Page Lister take up a bit more than 4 K now  
  577.   while  the Wide Lister takes up a little over 2k.    The Lite Lister 
  578.   takes less than 1.8 K. 
  579.    
  580.   All   in  all,   with normal margins,   you  should  break  even  at  
  581.   something around 40 K in text file size. 
  582.  
  583.   Comprssed Lister:  
  584.   80   columns maximum width with maximum files size  (depending  upon 
  585.   compression results) between π70 and 130 K.π I  would normally expect 
  586.   that you would get compression of about 50%,  giving you 65K-10K=55K 
  587.   data space, 55 * 1.5 or about 82.5 K.  I've had some files  do  much 
  588.   better (one came in with 150  K+  of text)  but I certainly wouldn't 
  589.   count on it.   ΣNOTE:   do NOT use LZEXE or PKLite on these files.  I Σ
  590.   Σwould expect problems should you do so.Σ
  591.       
  592.   Misc. Credits, Reports, What-Not of Historical Nature. 
  593.           
  594.   Version  2.00  
  595.   Present  version.   This version was a long time  in  the  making--I 
  596.   think  I  learned more Assembly  Language  than  I'd  ever thought I 
  597.   would,  plus quite a bit of C, To give credit, I'd like to thank the 
  598.   following  people  who gave me  advice  either  directly  or  though 
  599.   Compuserve,  or  through  demo programs  and  code they've released.  
  600.   Rosemary West for beta  testing and encouragement (including finally 
  601.   talking me into joining ASP).   Gary Elfring for originally  finding 
  602.   the color/mono bug and beta testing.   Bob Dodson for testing,   and 
  603.   before  that,   listening to endless progress reports--gripes,   and 
  604.   frustrations.   Bud Rasumussen for assembly tips.   Mark Nelson  for 
  605.   writing the article on compression (and the  book  Data Compression.  
  606.   Excellent book,  I recommend it.)   Vern and Julie Buerg for  advice 
  607.   and together with some  others  during  a rather  weird  experience, 
  608.   reality checking.  
  609.  
  610.   Bug reports came from in less frequently on the 1.76  release; to be 
  611.   specific,  only one that I know of which dealt with Tandy  Computers 
  612.   running a version DOS 2.2  (I believe it was the Tandy HX?   HD?  In 
  613.   any event,  discontinued.)   Ken Finto was  the unfortunate who  ran 
  614.   into  the problem with his business--and by the time  it came to  my 
  615.   attention I was already deep into the rewrite.   Gary Elfring's  bug 
  616.   was   as  follows:    on  monochrome  systems,   if  the  file  used 
  617.   highlighting at all,  you ended up with a "mottled" screen.  It took 
  618.   me  a  couple of hours to trace the bug down  (I  confess  to stupid 
  619.   coding here) and it's been fixed in this version.  
  620.       
  621.   Ver. 1.76:
  622.   One   of the caveats that applied to earlier versions of the program  
  623.   is no longer strictly true.    IF the listers are used in the direct  
  624.   video mode,    then  the presence of ANSI.SYS  (or equivalent)  will 
  625.   not  cause problems with "mottling" of the screen.   The help screen 
  626.   will be in the ANSI/DOS colors,   but that should be the only effect 
  627.   that  you see.   For those  of  you who use a  rather  nice  product 
  628.   called  FlickerFree  [  (C)  by Steve Gibson] FlickerFree had to  be 
  629.   off when using Asc2Com generated programs.   (By the way, I heartily 
  630.   recommend FlickerFree.     Gibson  is  one Dynamite programmer and I 
  631.   salute him.  I just wish I was half as good). 
  632.    
  633.   Ver. 1.75:
  634.   Ken  Finto  of  Finto Software,  Rosebud,   TX,     or  finding  the 
  635.   Find/First  Key  Escape bug.   Bob Dodson for keeping me up to  date  
  636.   on developments upon Compuserve.    Bud Rasumussen,   for as  always 
  637.   being one heck of a source of information on the PC. 
  638.    
  639.   Ver. 1.65:   
  640.   Bob Dodson,   when he gets off the idea of me writing a mouse  based 
  641.   COMM program  is  always  a   good person  to bounce ideas  off  of.     
  642.   Bud  Rasmussen  has  been  very  patient with  a fumbling   assembly  
  643.   language programmer,  lending access to his  huge library  of source 
  644.   code,    his own code included,   and  his  large reference library.  
  645.   Peter Tiffany alerted me to a problem with DOS 4.01   of which I was 
  646.   unaware.   Briefly,  the following  explanation:   If a user has the 
  647.   Config.Sys  file containing the  command  "BUFFERS  = NN /X"   where 
  648.   the nn is   any   number  (and unimportant),     programs  generated 
  649.   by Asc2Com  will lock  up.    I've reproduced  the  problem  but can 
  650.   NOT get it   to   happen  under  Turbo Debugger.  Version 3.3 of DOS 
  651.   works fine. 
  652.    
  653.   The  good news is that other changes I've made in the program  (with 
  654.   the  1.75    version)    that  were designed to help  Hercules  card  
  655.   cursors,  apparently fixes the conflict  with  buffers  loaded  into 
  656.   extended   memory.  I've  no idea why.    Anybody out there who  has 
  657.   information  about  this please contact me.   I'm curious as hell as 
  658.   to what is going on. 
  659.    
  660.   Ver. 1.50:   
  661.   Three people deserve special thanks for this release.    All  three,  
  662.   Bob  Dodson,    Bob Hunter of CCC BBS,   and Tony Bonillo  of  Modem 
  663.   XChange BBS have done yeoman duty in beta testing,  suggesting,  and 
  664.   prodding me to produce a better product.    Let's face it, I'm lazy; 
  665.   they're not. 
  666.    
  667.   Two  users  are mainly responsible for this edition of Asc2Com  (and  
  668.   the changes).   One is a gentleman who shall remain nameless (mainly 
  669.   because  I  can't  find where I wrote his name down)     who  had  a 
  670.   large need  for the Wide  lister--specifically,   for use with large 
  671.   reports   generated  by  DataBase  applications  (like  Paradox--(C) 
  672.   Borland Inter.) 
  673.    
  674.   The   Find  Option  was rather feverishly added at the  request   of  
  675.   Greg Hastings of Pinpoint Publishing.  I am pleased to announce that 
  676.   Asc2Com  is   being  used  by  these  rather nice people   for   the  
  677.   Help  File  & Documentation for two of their products:   Bon Appétit 
  678.   &  Micro Cookbook. (C)  by Pinpoint Publishing.    While much more a 
  679.   hacker than a user,   I  can recommend these programs as being  both 
  680.   useful (if you eat) and fun. 
  681.    
  682.   I take credit for the help screen,  but I only decided to add it due 
  683.   to  two  suggestions (from Nelson Ford)   that  I  incorporated--the 
  684.   Alt-H and Alt-F suggestions.   The Status Bar was getting cryptic to 
  685.   the  point  of  a  James  Joyce passage--I  wasn't  even  sure  what 
  686.   everything meant. 
  687.    
  688.   Ver. 1.25:   To my  beta  testers en masse,   with particular thanks 
  689.   to   Mike  Heggen again.     Mike  made  several suggests that  were 
  690.   incorporated   into  the  interface (filter section).    Bob  Dodson 
  691.   pointed out some rather idiotic mistakes  and some relatively subtle 
  692.   ones  too.    Chris Lafournaise  was good enough to test out several 
  693.   different things as well. 
  694.    
  695.   Ver.  1.10b:
  696.   Thanks go to David Roper for suggestions as well as to Nelson Ford--
  697.   both  had  excellent  suggestions  and  they've   been incorporated:  
  698.   Reverse video for the command line and  a  printer option.    I  can 
  699.   truthfully   say that I'd thought of them,   but I'd elected not  to 
  700.   implement  them  for reasons that escape me now.   Hack  fatigue  no 
  701.   doubt. 
  702.    
  703.   Ver. 1.10:  
  704.   Thanks  go to  Jim  Radcliffe  of ON AIR Software  for  suggestions.   
  705.   The  addition  of numeric paging came from a talk with  him  on  the 
  706.   phone  about the  needs  of his  company.    Thanks also go  to  Bob 
  707.   Dodson  for  file searches on CompuServe and putting  the program up 
  708.   on  same.    As always,  Bob's programming ideas,   comments,    and 
  709.   tongue lashings have been a big help. 
  710.    
  711.   Ver. 1.00:     
  712.   Thanks   go   to two people who've helped  by   beta  testing   this 
  713.   program  for   me:      Mike Heggen of Uff  Dah  Systems   and   Bud 
  714.   Rasmussen.     Mike informs  me  that  his monitor  (a  Herc  clone)  
  715.   DOES   NOT  WORK   on  the default   option.      Weirdness   reigns 
  716.   because he also informs me  that using the "/c"  option  gives him a 
  717.   display.   I'm at a complete loss to explain that.   So,   if you've 
  718.   got  a  Herc or Herc clone,   be warned that you may be  stuck  with 
  719.   using either one of the command line switches. 
  720.    
  721.    
  722.    
  723.    
  724.   ΓContacting MorganSoft: Γ
  725.    
  726.   If you have any questions,   please contact me at the address below,  
  727.   or phone  the number (no collect calls accepted)   or leave me EMAIL 
  728.   on any  of  the   three  BBS's listed below.    Since I live  on the  
  729.   West  Coast,  adjust  your phone call accordingly.    I'm  generally 
  730.   available  between 5:00PM  and  10:00PM  Monday - Friday.   You take 
  731.   your chances  on  the weekends cause I'm in and out all  the time on 
  732.   those days. 
  733.    
  734.           σMorganSoft          σ                
  735.           σ2170 Raynor St. SE  σ                
  736.           σSalem, OR  97302    σ
  737.           σPH: 503-364-2002    σ
  738.           
  739.           Compuserve 
  740.           σ71167,2664σ 
  741.    
  742.           Salem Public Library 
  743.           (Co-Sysop, Pascal Base) 
  744.           503-588-6086 
  745.           503-588-6130 
  746.           503-588-6081 
  747.  
  748.   If  you  wish to call,  please call between 4:00  PM and 10:00   PM, 
  749.   Monday -Friday.  On the weekends, 10:00AM to 10:00 PM. 
  750.  
  751.   END-OF-FILE>>>
  752.  
  753.