home *** CD-ROM | disk | FTP | other *** search
/ Compu-Fix / Compu-Fix.iso / misc / program2 / dircopy.doc < prev    next >
Encoding:
Text File  |  1993-03-01  |  16.3 KB  |  370 lines
  1.  
  2.  
  3.  
  4.  
  5.                                       DIRCOPY                           1
  6.                                copyright 1989-1990 by
  7.                            MARK ELLIS and MAREL SOFTWARE
  8.  
  9.  
  10.  
  11.                                       PURPOSE:
  12.  
  13.          DIRCOPY is  a program used to transfer dialing directories between
  14.          different communication  programs.   DIRCOPY is  primarily for the
  15.          user which  is ready  to try  out new  communication software, but
  16.          wants to  avoid re-keying  his entire  dialing directory.   It may
  17.          also be used to pass dialing directories between friends who chose
  18.          to use different communication software from one another.
  19.  
  20.          Additionally, DIRCOPY  exports and  imports to  and from  a simple
  21.          ASCII file format.  This feature provides two benefits.  First, by
  22.          exporting a  dialing directory  to an  ASCII file you may use your
  23.          favorite editor  or  word  processor  to  edit/sort  your  dialing
  24.          directory or  sort your  dialing  directory  using  any  DOS  sort
  25.          utility.   Then import  your newly edited and/or sorted ASCII file
  26.          back into a dialing directory.  Secondly, it offers an easy method
  27.          of importing  many of  the BBS  lists found throughout the country
  28.          into  any   of  the   supported  communication   software  dialing
  29.          directories (after  doing some editing of these lists).  The ASCII
  30.          file format is described below.
  31.  
  32.          DIRCOPY is  NOT  free  software,  but  is  distributed  under  the
  33.          Shareware concept  whereby the  user can  try the  software before
  34.          purchasing it.    If  this  software  meets  your  needs  you  are
  35.          requested (i.e. required) to send your payment of $5.00  (or $8.00
  36.          if you  would like  the latest  copy of  DIRCOPY mailed  to you on
  37.          disk) to:
  38.  
  39.                                      Mark Ellis
  40.                                 465 Mitchell Avenue
  41.                                 Elmhurst, IL  60126
  42.  
  43.          A registration  form may  be found after the end of this document.
  44.          The latest  copy of  DIRCOPY may  be downloaded  from the  RBBS of
  45.          Chicago, home of over 1 Gigabyte of software.  Their public access
  46.          number is  (312)352-1035.   Messages regarding DIRCOPY may be left
  47.          at RBBS  of Chicago  to the  attention of  Mark Ellis.  The latest
  48.          version may also be downloaded from Compuserve.  Messages also may
  49.          be addressed to Compuserve ID: 72320,1655.
  50.  
  51.  
  52.  
  53.                      CURRENT COMMUNICATION SOFTWARE SUPPORTED:
  54.  
  55.                                 Bitcom Version 3.55
  56.                                  Telix Version 3.11
  57.                                  Qmodem Version 4.0
  58.                               Procomm Plus Version 1.1
  59.                                Procomm Version 2.4.2
  60.  
  61.          Please note  that DIRCOPY may be compatible with other versions of
  62.          these programs  as  well,  provided  the  format  of  the  dialing
  63.          directory has  not changed  between versions  of the communication
  64.          software.
  65.  
  66.  
  67.  
  68.                                       DIRCOPY                           2
  69.                                copyright 1989-1990 by
  70.                            MARK ELLIS and MAREL SOFTWARE
  71.  
  72.  
  73.  
  74.  
  75.                                    INSTALLATION:
  76.  
  77.          DIRCOPY may  be installed  in any  directory and  run from hard or
  78.          floppy disk.   It  is recommended  that you  place  DIRCOPY  in  a
  79.          directory which  is found  in your  DOS PATH so that you may start
  80.          DIRCOPY from  any directory.  Included with DIRCOPY is a help file
  81.          (DIRCOPY.HLP) which  must be  in the  current directory  or  in  a
  82.          directory found  in the  DOS PATH in order to be found by DIRCOPY.
  83.          On line help is available while running DIRCOPY by pressing the F1
  84.          key.
  85.  
  86.  
  87.                                      OPERATION:
  88.  
  89.          Begin DIRCOPY  by typing  DIRCOPY on the DOS command line.  If you
  90.          are using  a monochrome  screen, such as on a laptop computer, you
  91.          may add  the following  command line parameter to make the display
  92.          more readable.   To  turn on  this monochrome  feature, begin  the
  93.          program by typing any of the following:
  94.  
  95.                                      DIRCOPY -b
  96.                                      DIRCOPY -m
  97.                                      DIRCOPY /b
  98.                                      DIRCOPY /m
  99.  
  100.          DIRCOPY may  also be started with the -c option if you are running
  101.          on a  CGA display to help reduce snow.  To begin DIRCOPY with this
  102.          option type the following line at the DOS prompt and hit return:
  103.  
  104.                                      DIRCOPY -c
  105.  
  106.          The command  line flag of 'b' is for black and white.  The command
  107.          line flag  'm' is  for monochrome.   They both perform the exactly
  108.          the same,  but both  are supported  and may be used as you prefer.
  109.          If you are using a color monitor, simply type:
  110.  
  111.                                       DIRCOPY
  112.  
  113.          on the DOS command line and return.
  114.  
  115.          The operation  of the  software is  fairly simple,  as it  is menu
  116.          driven.   Select your  menu choice with the highlighted bar in the
  117.          opening  menu.     All  of  the  software  communication  packages
  118.          supported provide  bi-directional transfers  to and from the ASCII
  119.          file format.   In  order to  transfer a dialing directory from one
  120.          communication software  package to  another, you must first export
  121.          to an  ASCII file, then import from the ASCII file just created to
  122.          the other  dialing directory.   For  example, to convert a Procomm
  123.          dialing directory  to a  Telix dialing  directory, select the menu
  124.          item:
  125.                              PROCOMM.DIR --> ASCII DIR
  126.  
  127.  
  128.  
  129.                                       DIRCOPY                           3
  130.                                copyright 1989-1990 by
  131.                            MARK ELLIS and MAREL SOFTWARE
  132.  
  133.  
  134.          by moving  the highlight  bar using  the up or down arrow keys and
  135.          depressing the  Enter key.   A  window opens and prompts for input
  136.          and output  file names.   Default  file names  are provided at the
  137.          prompts.   The default  file names  may be edited as desired.  The
  138.          insert key  toggles overtype  mode (small  cursor) and insert mode
  139.          (large cursor).  To delete from the cursor to the end of the line,
  140.          type Ctrl+T.   Complete  path names are supported.  After creating
  141.          the ASCII file, next select the menu item:
  142.  
  143.                               TELIX.FON <-- ASCII DIR
  144.  
  145.          to create the Telix dialing directory.  You are again prompted for
  146.          input and  output file  names.   The input file is the name of the
  147.          file you  just created  in the  step above.  Additionally, you are
  148.          prompted for  the default  baud rate you wish you use.  Select the
  149.          baud rate  using the  highlight  bar.    Note  that  some  of  the
  150.          communications programs  do not  support 38400  baud.    In  these
  151.          cases, if  38400 baud  is selected,  19200 baud  is  used  as  the
  152.          default by DIRCOPY.
  153.  
  154.          The menu item, "Add prefix to ASCII DIR", is used to add a dialing
  155.          prefix to all phone numbers in the ASCII file.  This is useful for
  156.          converting a  dialing directory  from home  use to  work use where
  157.          calling from the work place may require dialing a digit (usually a
  158.          9) in  order to place an external call.  This prefix may contain a
  159.          pause character  (determined by  your communication  software)  to
  160.          pause for  dial tone  after dialing  the digit  to get  an outside
  161.          line.   An example  of a  prefix may be "9," for Telix to dial the
  162.          digit '9', then pause, then dial the rest of the phone number.
  163.  
  164.  
  165.                                THE ASCII FILE FORMAT:
  166.  
  167.          The ASCII files created by DIRCOPY have the following format.  The
  168.          phone number  begins in  column 1.   The  phone  number  does  not
  169.          contain any  white space  (i.e. blanks, tabs, etc.).  Eight spaces
  170.          separate the  phone number and name fields.  The name field may be
  171.          as long  as you  like, but  may be  truncated when imported to the
  172.          various dialing  directory formats.   If you are creating an ASCII
  173.          file using an editor, follow the above rules.  Note that the white
  174.          space between  the phone  number and  name fields  that you create
  175.          using an  editor may  contain any number of spaces, tabs, etc.  In
  176.          other words,  you may  separate the  phone number and name with as
  177.          little as  one space  and/or tab  character or  use several spaces
  178.          and/or tabs between the phone number and name.
  179.  
  180.  
  181.                                KEYS USED FOR EDITING
  182.  
  183.          Here is  just a  few notes  on how  to most  efficiently use  your
  184.          keyboard to  efficiently within  DIRCOPY.  From the main menu, use
  185.          the up  and down  arrow keys  for moving the highlighted bar.  The
  186.          home key  will move  to the top of the menu, the end key will move
  187.          to the  last menu  entry.   By depressing the escape key at a file
  188.  
  189.  
  190.  
  191.                                       DIRCOPY                           4
  192.                                copyright 1989-1990 by
  193.                            MARK ELLIS and MAREL SOFTWARE
  194.  
  195.  
  196.          name prompt  you will return to the main menu.  Depress the escape
  197.          key at the main menu to return to DOS.
  198.  
  199.          While entering  file names  at the  prompts, you  may move between
  200.          fields (i.e.  jump between  input and  output file names) by using
  201.          the arrow  keys.   The delete  key will delete the character under
  202.          the cursor.   The  insert key  toggles  between  insert  mode  and
  203.          overtype mode.   A large block cursor indicates insert mode is ON.
  204.          To delete  from the cursor to the end of the line use Ctrl+T (i.e.
  205.          depress the 'T' key while holding down the control key.)
  206.  
  207.  
  208.                                  REVISION HISTORY:
  209.          REVISION 3.5:
  210.  
  211.          Added CGA snow elimination by the -c command line option.
  212.  
  213.          Some operations previously resulted in the last record of the file
  214.          duplicated.   Although this  did not cause any major difficulties,
  215.          it was  not appreciated.  I believe I have all of these cleaned up
  216.          now.
  217.  
  218.          Creating Telix  and Procomm  Plus dialing  directories from  ASCII
  219.          files previously  required that you ran DIRCOPY from the directory
  220.          containing an  existing TELIX.FON  or PCPLUS.DIR file (in order to
  221.          duplicate the  header information in those files.)  DIRCOPY is now
  222.          smart enough  to do  this on  its own  and therefore  can  be  run
  223.          without requiring existing TELIX.FON or PCPLUS.DIR files.
  224.  
  225.          New on-line  help is  available  for  editing  commands.    It  is
  226.          available  by   pressing  the   F1  key.    Place  the  help  file
  227.          (DIRCOPY.HLP) in  any directory  in the  DOS PATH when you install
  228.          DIRCOPY.
  229.  
  230.          A new  feature is  added to  complement the  "Add a Prefix" to all
  231.          telephone numbers  feature.  The new feature does the opposite; it
  232.          removes a  prefix from  all the  telephone numbers which have that
  233.          prefix.   Note that  the prefix may be any set of characters, such
  234.          as an area code (i.e. if you live in the 312 area code you want to
  235.          remove 312  from preceding any telephone number because you do not
  236.          need to dial the area code!)  Thanks to Nick Anis for this idea!
  237.  
  238.          One user  wrote to  me and indicated that the PROCOMM PLUS default
  239.          dialing directory is called PCPLUS.FON rather than PCPLUS.DIR.  If
  240.          anyone has  confirming information, please drop me a line with the
  241.          revision number of PCPLUS which you are running!
  242.  
  243.          REVISION 3.4:
  244.  
  245.          Added support  for monochrome  monitors.   This option  is invoked
  246.          from the  command line by providing either -m, -b, /m, or /b after
  247.          typing DIRCOPY  on the  DOS command  line.   This  will  make  the
  248.          display much more readable especially on laptop displays.
  249.  
  250.  
  251.  
  252.                                       DIRCOPY                           5
  253.                                copyright 1989-1990 by
  254.                            MARK ELLIS and MAREL SOFTWARE
  255.  
  256.  
  257.          REVISION 3.3:
  258.  
  259.          Added checking  for existence  of output file.  If the output file
  260.          already exists,  the user  is prompted  if it is O.K. to overwrite
  261.          the file.
  262.  
  263.          Added time and date display.  Changed windows for aesthetics.
  264.  
  265.          REVISION 3.2:
  266.  
  267.          Added support for Bitcom communications software.
  268.  
  269.          Added default file names with memory.  This is particularly handy,
  270.          for most  users will  not need  to enter the name of their dialing
  271.          directory.   A default  ASCII file name is provided.  This default
  272.          is ASCII.FIL.   The  default file  names  are  "memorized"  for  a
  273.          session.   So should  a user  change a  default file name, DIRCOPY
  274.          will remember the new default name until terminating.
  275.  
  276.          Added "WORKING"  prompt at top of display during disk access while
  277.          processing, i.e. creating files.
  278.  
  279.          Revision 3.1  did not  provide PROCOMM  PLUS --> ASCII translation
  280.          properly.  This was corrected.
  281.  
  282.          REVISION 3.1:
  283.  
  284.          Cleaned up  the operation of some menus and prompts when Escape is
  285.          depressed to jump back to the main menu.
  286.  
  287.          Added scrolling advertisement/copyright to bottom of screen.
  288.  
  289.          Optimized code to save approximately 6K in the executable file.
  290.  
  291.          REVISION 3.0:
  292.  
  293.          Added Telix and Qmodem support.
  294.  
  295.          Removed  support   of  PC-Talk  and  a  background  dialer  called
  296.          DIALER.COM.
  297.  
  298.          Complete re-write to re-vamp display routines.
  299.  
  300.          REVISION 2.1
  301.  
  302.          Changed white  space between  phone number  and name  to  8  space
  303.          characters for  ASCII files  created using  DIRCOPY.   This was to
  304.          provide some  compatibility with  GT-POWER communications software
  305.          which could import such ASCII files at the time.
  306.  
  307.          REVISION 2.0
  308.  
  309.          Initial release  of DIRCOPY.  Supported Procomm, Procomm Plus, PC-
  310.          Talk, and a background dialer program called DIALER.COM.  Prior to
  311.  
  312.  
  313.  
  314.                                       DIRCOPY                           6
  315.                                copyright 1989-1990 by
  316.                            MARK ELLIS and MAREL SOFTWARE
  317.  
  318.  
  319.          Revision 2.0  DIRCOPY actually  was a  set of stand alone programs
  320.          under different names.
  321.  
  322.                               --- END OF DOCUMENT ---
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.                                       Mail to:
  333.  
  334.                                      MARK ELLIS
  335.  
  336.                                    MAREL SOFTWARE
  337.  
  338.                                  465 MITCHELL AVE.
  339.  
  340.                                 ELMHURST, IL  60126
  341.  
  342.  
  343.  
  344.                      Enclose registration fee (no disk):  $5.00
  345.  
  346.                       Enclose registration fee (1 disk): $8.00
  347.                    (Be sure to indicate 5 1/4" or 3 1/2" format!)
  348.  
  349.                          Make checks payable to Mark Ellis.
  350.  
  351.  
  352.                Comments or suggestions: ________________________________
  353.  
  354.                _________________________________________________________
  355.  
  356.                _________________________________________________________
  357.  
  358.                _________________________________________________________
  359.  
  360.                _________________________________________________________
  361.  
  362.                _________________________________________________________
  363.  
  364.                _________________________________________________________
  365.  
  366.                _________________________________________________________
  367.  
  368.                _________________________________________________________
  369.  
  370.                _________________________________________________________