home *** CD-ROM | disk | FTP | other *** search
/ RBBS in a Box Volume 1 #2 / RBBS_vol1_no2.iso / add2 / cc310.zip / COPYCON.DOC next >
Text File  |  1989-05-15  |  20KB  |  535 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.                                      CopyCon
  29.  
  30.  
  31.                                   Version 3.10
  32.                                     May 1989
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.                                        by
  49.                                John E. Bean, P.E.
  50.                               Data Acquisition Inc.
  51.                                1701 Broadway #156
  52.                               Vancouver, Wa. 98663
  53.  
  54.  
  55.  
  56.  
  57.                                   INTRODUCTION
  58.  
  59.  
  60.      CopyCon is a program to be used in lieu of the DOS command COPY CON.  I
  61.      have  used COPY CON numerous times in creating batch files and  miscel-
  62.      laneous small text files. 
  63.  
  64.      I have experienced many frustrating moments using COPY CON.  I have ac-
  65.      cidently overwritten existing files.  I have mistyped commands only  to
  66.      notice  them while entering the next line.  I have also wanted to  have
  67.      graphic boxes in my batch files.
  68.  
  69.      CopyCon alleviates all of the above problems.  It checks to see if  the
  70.      specified file exists,  and if it does CopyCon provides either  loading
  71.      the  existing  file  or allows the existing  file  to  be  overwritten.
  72.      CopyCon  also  has full screen editing capability and built  in  Macros
  73.      which aids in creating files.
  74.  
  75.      CopyCon  was written in Turbo Pascal 5.0 using routines from Turbo  5.0
  76.      Professional.  The help screens were designed using a screen  generator
  77.      "SayWhat!".
  78.  
  79.      CopyCon  is  so easy to use that this manual is not necessary  but  the
  80.      following sections will briefly discuss how to use CopyCon.
  81.  
  82.  
  83.  
  84.                                    LIMITATIONS
  85.  
  86.      I  have designed CopyCon for typical batch files and small text  files.
  87.      It  is not designed to be a text editor!  If you need a text  editor  I
  88.      have written a text editor "LIMA". 
  89.  
  90.      There are two main limitations that I designed into this program.  They
  91.      are:
  92.  
  93.                * The  maximum length of a text line is 80  charac-
  94.                  ters.
  95.                * There are no block functions.  You can only  copy
  96.                  the current line to next line.
  97.  
  98.      These  limitations  were  done to distinguish  the  difference  between
  99.      CopyCon and a text editor.   
  100.  
  101.  
  102.  
  103.                                  GETTING STARTED
  104.  
  105.      CopyCon is comprised of two (2) files. They are:
  106.           * Copycon.exe - The executable program.
  107.           * Copycon.doc - This documentation. 
  108.  
  109.      Start  CopyCon  by  issuing the following command at  the  DOS  prompt: 
  110.                               A:>CopyCon (filename).
  111.  
  112.      As you can see this is identical to using the DOS command COPY CON  ex-
  113.      cept there is not a space between Copy and Con. The user is responsible
  114.      for providing a valid filename.
  115.  
  116.      Once the program is loaded into memory,  the program will check to  see
  117.      if your computer has a color graphics card. If it does the program will
  118.      be displayed in color.  You can force CopyCon to be displayed in  black
  119.      and  white by typing in "/bw"  AFTER the filename on the command  line.
  120.      For  example;  if you wish to create a batch file named  "CPY.BAT"  and
  121.      have CopyCon be in black and white the following is the correct syntax.
  122.  
  123.                               A:>CopyCon  CPY.BAT /bw
  124.  
  125.      Next the screen will be cleared,  ">CopyCon  (filename)"  will be  dis-
  126.      played in the upper left hand corner.  Several other items will be dis-
  127.      played to the right of the file name. They are:
  128.           * F1 - Help:   A  help  menu is available simply  by  de   
  129.                          pressing  the F1 function key.  The  help    
  130.                          menu  provides  information  on   editing    
  131.                          keys and several batch file command.
  132.           * F2 - Macros: Depressing  the  F2  function  key   will    
  133.                          display the predefined Macros.
  134.           * 1,1:         The  y,x  position of the cursor.  The  y    
  135.                          position is the FILE LINE position.
  136.           * INS:         If  the insert mode is ON then  INS  will    
  137.                          be displayed. 
  138.           * [max line]:  The number displayed inside the "[ ]"  is     
  139.                          the  maximum  number of lines  your  file     
  140.                          can  have.  For  a  640K  machine,   this     
  141.                          should be around 5000.
  142.  
  143.      If the file entered on the command line exists,  a pop up menu will ap-
  144.      pear offering the following choices:
  145.           * LOAD:        This  option will load the existing  file    
  146.                          and  CopyCon  can be used to  modify  the    
  147.                          file.
  148.           * OVERWRITE:   This  option will overwrite the  existing    
  149.                          file. 
  150.           * EXIT:        This option will abort CopyCon.
  151.  
  152.      The cursor will be located at the left hand column  of your screen. You
  153.      are now ready to create/edit your file.
  154.  
  155.  
  156.  
  157.                                 EDITING COMMANDS
  158.  
  159.      CopyCon  provides simple editing commands. These commands can  be  dis-
  160.      played  while  editing through the Help Menu which is accessed  by  de-
  161.      pressing the F1 function key.  The editing commands can be broken  into
  162.      the following sections.
  163.  
  164.      CURSOR PAD KEYS:
  165.        Up Arrow Key:
  166.           Depressing the Up arrow key will move the cursor to  the
  167.           previous line. Depressing the Up arrow key while on line
  168.           one will result in the display of an error message.
  169.  
  170.        Down Arrow Key:
  171.           Depressing  the Down arrow key will move the  cursor  to
  172.           the  next line.  Depressing the Down arrow key while  on
  173.           the  last line entered will result in the display of  an
  174.           error message.
  175.  
  176.        Left Arrow Key:
  177.           Depressing  the Left arrow key will move the cursor  one
  178.           position left on the current line.  Depressing the  Left
  179.           arrow  key  while at the leftmost column on  the  screen
  180.           will result in the display of an error message.
  181.  
  182.        Right Arrow Key:
  183.           Depressing the Right arrow key will move the cursor  one
  184.           position right on the current line. Depressing the Right
  185.           arrow  key while at the rightmost column on  the  screen
  186.           will result in the display of an error message.
  187.  
  188.        Home Key:
  189.           Depressing  the  HOME key will move the  cursor  to  the
  190.           leftmost position on the current line.
  191.  
  192.        End Key:
  193.           Depressing  the  END  key will move the  cursor  to  the
  194.           rightmost position on the current line.
  195.  
  196.        Tab Key:
  197.           Depressing the TAB key will move the cursor right  eight
  198.           (8) spaces.
  199.  
  200.        Shift Tab Key:
  201.           Simultaneously depressing the Shift key and the Tab  key
  202.           will move the cursor left eight (8) spaces.
  203.  
  204.        Ctrl Home Key:
  205.           Simultaneously depressing the Ctrl key and the HOME  key
  206.           will move the cursor to the top of the screen.
  207.  
  208.        Ctrl End Key:
  209.           Simultaneously  depressing the Ctrl key and the END  key
  210.           will move the cursor to the bottom of the screen.
  211.  
  212.        Ctrl PgDn Key:
  213.           Simultaneously depressing the Ctrl key and the PgDn  key
  214.           will move the cursor to the end of the file. If the cur-
  215.           sor  is already at the end of the file an error  message
  216.           will be displayed.
  217.  
  218.        Ctrl PgUp Key:
  219.           Simultaneously depressing the Ctrl key and the PgUp  key
  220.           will move the cursor to the top of the file. If the cur-
  221.           sor  is already at the top of the file an error  message
  222.           will be displayed.
  223.  
  224.        Ins Key:
  225.           Depressing  the INS key will toggle the Insert  Mode  on
  226.           and off.  If the Insert Mode is on,  "INS"  will be dis-
  227.           played on the top line in inverse video.
  228.  
  229.        Del Key:
  230.           Depressing  the DEL key will delete the character  under
  231.           the  current  cursor position.  All  characters  to  the
  232.           right  will move one space to the  left.
  233.  
  234.  
  235.      FUNCTION KEYS:
  236.  
  237.        F1:
  238.           Depressing  the  F1 function key will display  the  Help
  239.           Menu.  The  Help Menu will display screens for  all  the
  240.           keys  discussed in this section and the following  Batch
  241.           File commands:
  242.                               * Echo
  243.                               * Set
  244.                               * Rem
  245.                               * Pause
  246.                               * Shift
  247.                               * Goto
  248.                               * If
  249.                               * For
  250.  
  251.        F2:
  252.           Depressing the F2 function key will display a listing of
  253.           all the built in Macros available in this program.
  254.  
  255.        F3:
  256.           Depressing  the F3 function key will copy  the  previous
  257.           line. (The tutorial will show how useful this can be)
  258.  
  259.        F4:
  260.           Depressing  the F4 function key will center the  current
  261.           line on the screen. This feature is multifunctioned.  If
  262.           the line starts with "REM" or "ECHO"  the centering will
  263.           be offset to accommodate for those words.  (The tutorial
  264.           will show how this works)
  265.  
  266.        F6:
  267.           Depressing  the F6 function key will save the  file  and
  268.           exit the program.
  269.  
  270.        F7:
  271.           Depressing the F7 function key will insert a new line at
  272.           the current cursor position.
  273.  
  274.        F8:
  275.           Depressing  the F8 function key will delete the  current
  276.           line.
  277.  
  278.      OTHER KEYS:
  279.  
  280.        TAB:
  281.           Depress the TAB key will move the cursor eight (8) posi-
  282.           tions to the right. 
  283.  
  284.        SHIFT TAB:
  285.           Simultaneously depressing the SHIFT key and the TAB  key
  286.           will move the cursor eight (8) positions to the left.
  287.  
  288.        ESC:
  289.           Depressing the ESC key will abort CopyCon.  Once the ESC
  290.           key has been depressed, CopyCon will ask if you are sure
  291.           you wish to leave CopyCon.  If you do,  depress the  "Y"
  292.           key and if you do not simply depress any other key.
  293.  
  294.  
  295.  
  296.                                      MACROS
  297.  
  298.      CopyCon has built in Macros.  What are Macros?  Macros are a  character
  299.      or a series of characters displayed on the screen when a designated key
  300.      or two designated keys are simultaneously depressed.  A list of  Macros
  301.      can be displayed during editing by depressing the F2 function key.  The
  302.      Macros in CopyCon can be divided into two categories. They are:
  303.  
  304.      BATCH FILE COMMANDS:
  305.  
  306.      CopyCon has assigned several of the most commonly used batch file  com-
  307.      mands to key combinations. They are:
  308.  
  309.        Alt C:
  310.           Simultaneously depressing the Alt   key and the "C"  key
  311.           will display "copy " on the screen.
  312.  
  313.        Alt E:
  314.           Simultaneously depressing the Alt   key and the "E"  key
  315.           will display   "echo " on the screen.
  316.  
  317.        Alt F:
  318.           Simultaneously  depressing the Alt key and the  "F"  key
  319.           will display "for %% in ( ) do " on the screen.
  320.  
  321.        Alt G:
  322.           Simultaneously  depressing the Alt key and the  "G"  key
  323.           will display "goto " on the screen.
  324.  
  325.        Alt I:
  326.           Simultaneously  depressing the Alt key and the  "I"  key
  327.           will display "shift  " on the screen.
  328.  
  329.        Alt L:
  330.           Simultaneously depressing the Alt   key and the "L"  key
  331.           will display   "cls " on the screen.
  332.  
  333.        Alt P:
  334.           Simultaneously  depressing the Alt key and the  "P"  key
  335.           will display "path " on the screen.
  336.  
  337.        Alt R:
  338.           Simultaneously depressing the Alt   key and the "R"  key
  339.           will display   "rem" on the screen.
  340.  
  341.        Alt S:
  342.           Simultaneously depressing the Alt   key and the "S"  key
  343.           will display   "erase" on the screen.
  344.  
  345.  
  346.                                  GRAPHIC BOXES: 
  347.  
  348.      Many times boxes look good in batch files. CopyCon has established Mac-
  349.      ros for both single and double sided boxes. The following will describe
  350.      the keys used to print the box characters on the screen.
  351.  
  352.      SINGLE LINED BOX:
  353.  
  354.        Alt F1 - Upper Left Hand Corner
  355.        Alt F2 - Upper Right Hand Corner
  356.        Alt F3 - Lower Left Hand Corner
  357.        Alt F4 - Lower Right Hand Corner
  358.        Alt F5 - Horizontal Line
  359.        Alt F6 - Vertical Line
  360.        Alt F7 - Upper Horizontal Cross
  361.        Alt F8 - Lower Horizontal Cross
  362.        Alt F9 - Left Vertical Cross
  363.        Alt F10- Right Vertical Cross
  364.        Alt 6  - Center Cross
  365.  
  366.  
  367.      DOUBLE LINED BOX:
  368.  
  369.        Ctrl F1 - Upper Left Hand Corner
  370.        Ctrl F2 - Upper Right Hand Corner
  371.        Ctrl F3 - Lower Left Hand Corner
  372.        Ctrl F4 - Lower Right Hand Corner
  373.        Ctrl F5 - Horizontal Line
  374.        Ctrl F6 - Vertical Line
  375.        Ctrl F7 - Upper Horizontal Cross
  376.        Ctrl F8 - Lower Horizontal Cross
  377.        Ctrl F9 - Left Vertical Cross
  378.        Ctrl F10- Right Vertical Cross
  379.        Alt 5   - Center Cross
  380.  
  381.  
  382.      SHADING: 
  383.  
  384.      There  are  several  characters that are commonly  used  for  "shading"
  385.      boxes.  CopyCon provides Macros for four (4) of these  characters.  De-
  386.      pressing Alt 1, Alt2, Alt 3 or Alt 4 will insert a "shading"  character
  387.      on the screen.
  388.  
  389.  
  390.  
  391.  
  392.      VERSION CHANGES
  393.  
  394.      Version 3.10 has changed the following:
  395.           * Fixed a bug in scolling up multiple screen files.
  396.           * Added color to the program. 
  397.           * Change the X,Y on the status line to be Y,X.
  398.  
  399.      Version 3.0 has changed the following:
  400.           * Converted to Turbo Pascal 5.0.
  401.           * The maximum length of the file is limited only to  the
  402.             size of RAM.
  403.           * Many of the bugs in 2.0 have been corrected.
  404.  
  405.      Version 2.0 has changed the following:
  406.           * The program was rewritten in Turbo Pascal 4.0.
  407.           * A  Help Menu has been include providing help  on  some
  408.             most commonly used batch file commands.
  409.  
  410.      Version 1.30 has changed the following:
  411.           * When copying (F3) the line above,  the cursor now goes  
  412.             next line.
  413.           * Corrected  an error when attempting to center  (F4)  a  
  414.             blank line. 
  415.           * Added cursor X and cursor Y (file line) to the  status  
  416.             line.
  417.           * Added Insert Line (Ctrl N).
  418.           * Added Delete Current Line (Ctrl Y)
  419.  
  420.      Version 1.20 has changed the following:
  421.           * Better memory allocation. 
  422.           * Limit file size to 500 lines maximum
  423.           * CopyCon will now load existing files.
  424.  
  425.  
  426.  
  427.                                  OTHER PROGRAMS
  428.  
  429.      I  have  used many Public Domain,   Shareware  and  Commercial software
  430.      over the years. In appreciation to all those authors     of  Public Do-
  431.      main Programs I have written several Public  Domain Programs. They are:
  432.  
  433.      EzDoss:
  434.        EzDoss   is  a  Dos Shell.  I have  used  many  Dos shells  over
  435.        the past years.  Each program has several features that I really
  436.        enjoy.   I decided  to write a Dos Shell that put most of  those
  437.        features  into  EzDoss.   EzDoss is both Menu  Driven  and   has
  438.        "Quick  Keys".  Some of the features that  EzDoss has are:
  439.           * Tag files either singularly,  all at once,  or by pat-
  440.             tern.
  441.           * Copy,   delete,   move, rename,  print or  view tagged
  442.             or highlighted files.
  443.           * Include  or  Exclude file from being  displayed  by  a
  444.             user defined mask.
  445.           * Edit an existing Ascii file.
  446.           * Invoke an Ascii text SideKick type editor.
  447.           * Locate  all files using a user  defined  mask for on a
  448.             given drive.
  449.           * Print a tree of the specified disk drive.
  450.           * Format a disk without leaving EzDoss.
  451.  
  452.        I  am sure that once you try EzDoss and discover all  the  power
  453.        and ease it has this will  become an indispensable program.
  454.  
  455.      Lima:
  456.        Another  type  of program I used  regularly  are text   editors. 
  457.        The  ones  I used are either  too simple or too complex.   I  am
  458.        used to using  the text  editor  that comes with Turbo   Pascal. 
  459.        I  also  bought Turbo Professional 5.0 which is  a set  of  over
  460.        400 Turbo Pascal routines that  do just  about  everything   you
  461.        can  think  of.   I wanted  to  write a program that uses   many 
  462.        of  Turbo   Professional   routines and  I   had   Turbo  Editor
  463.        ToolBox so I wrote Lima (a bad pun on my last name). Some of the
  464.        features of Lima are:
  465.           * Dual  Windows.   Two files can be opened at  the  same
  466.             time.  Windows can be zoomed,  rotated or switched be-
  467.             tween files.
  468.           * Buffering.   Blocks of text can be  copied   or  moved
  469.             from one window to another.
  470.           * Macros.   Macros can be defined,   and  written  to  a
  471.             disk file.
  472.           * Keys   can   be redefined to key  sequences   of  your
  473.             choice.
  474.  
  475.      Find Duplicates:
  476.        Most  users of hard disks have duplicates files on their  disks.
  477.        The  file  COMMAND.COM will appear in  numerous  subdirectories.
  478.        Significant hard disk space is being wasted by these files.
  479.  
  480.        Find  Duplicates  is an utility which scans the  specified  hard
  481.        disk drive and displays a list of duplicate files.  You can move
  482.        through the list by using the arrow keys,  page down,  page  up,
  483.        home or end keys.  The contents of the files can be viewed using
  484.        LIST.COM.  Files which you want to be deleted,  are "tagged"  by
  485.        depress the "T"  key.  Once all the desired files are  "tagged",
  486.        depressing  the  F10 function key will delete all  the  "tagged"
  487.        files.
  488.  
  489.        Find  Duplicates will become an utility that will be used  on  a
  490.        regular basis.
  491.  
  492.  
  493.      To  get the most current version and printed manuals of the above  pro-
  494.      grams  send $10.00 for each program to me at the following address:
  495.  
  496.                          John E. Bean
  497.                          data acquisition inc.
  498.                          1701 Broadway #156
  499.                          Vancouver, Wa. 98663
  500.  
  501.      I hope you enjoyed CopyCon and please do not hesitate to send  comments
  502.      and praise to me.
  503.  
  504.  
  505.  
  506.  
  507.                            ABOUT DATA ACQUISITION INC.
  508.  
  509.      Data Acquisition Inc.  is a company that manufactures a  microprocessor
  510.      based CMOS unit which can store information based on events and time.
  511.  
  512.      One  of  the  products designed around the unit is  a  traffic  counter
  513.      called MicroCounts.  The MicroCounts unit can count vehicle actuations,
  514.      classify vehicles, or determine speeds.
  515.  
  516.      This microcomputer unit can be adapted for various uses, such as count-
  517.      ing objects passing a given point (people though a gate). 
  518.  
  519.      Data Acquisition Inc.  will also write custom software.  The Public Do-
  520.      main  Programs  listed above is an example of the quality  and  thought
  521.      that goes into programs we develop. 
  522.  
  523.      If you think you have an application for our microprocessor based  unit
  524.      or need custom software developed,  please contact me at (206) 687-7246
  525.      or write to me at:
  526.  
  527.                     John E. Bean
  528.                     Software and Applications Engineer
  529.                     Data Acquisition Inc.
  530.                     1701 Broadway #156
  531.                     Vancouver, Wa. 98663
  532.  
  533.  
  534.  
  535.