home *** CD-ROM | disk | FTP | other *** search
/ Media Share 9 / MEDIASHARE_09.ISO / business / vend11gb.zip / VENDOR.DOC < prev    next >
Text File  |  1993-08-09  |  33KB  |  691 lines

  1.     PROGRAM TITLE:
  2.  
  3.     The Disk Vendor
  4.  
  5.  
  6.     DESCRIPTION:
  7.  
  8.     The Disk  Vendor is  a tool  for creating  "on-disk" product
  9.     catalogs.  For businesses  who would like an  alternative to
  10.     a printed catalog, The Disk Vendor will make the process  of
  11.     creating an on-disk catalog a simple one.
  12.  
  13.     The Disk Vendor run-time  module is completely menu  driven,
  14.     with a clean simple user interface, which makes it easy  for
  15.     your customers to navigate through and order from.
  16.  
  17.     The product catalogs that  you create can be  distributed on
  18.     a diskette, or printed to hardcopy format.
  19.  
  20.  
  21.     AUTHOR:
  22.  
  23.     Philip P. Kapusta
  24.     P.O. Box 5423
  25.     Falmouth, VA 22403
  26.  
  27.  
  28.     REQUIREMENTS:
  29.  
  30.     Hard disk drive, printer, and an editor/word processor.
  31.  
  32.  
  33.     TERMS AND DEFINITIONS:
  34.  
  35.     There are several  terms that will  be used throughout  this
  36.     documentation and that  need to be  fully understood by  the
  37.     user before  you create  your own  on-disk catalog.   Please
  38.     review these definitions carefully:
  39.  
  40.     ASCII FILE: This  is a term  used to describe  any file that
  41.     you create  and save  with an  editor such  as DOS'  EDIT or
  42.     Window's  Notepad.   The Disk Vendor  does NOT come  with an
  43.     editor because most users already have a favorite editor  or
  44.     word processor that they feel  comfortable with.  We saw  no
  45.     reason to  force the  user to  use another  editor and  have
  46.     consequently not included  one.  An  ASCII file contains  NO
  47.     control  characters  such  as              nor graphic
  48.     characters such as ║  ▒ █ ╚ ½ å
  49.  
  50.     CATALOG  FILE:  A  catalog  file  is  an  ASCII  file   that
  51.     contains product  numbers, product  names and  descriptions.
  52.     These files are identified by the file extension ".CAT"  and
  53.     can  be  edited  or  created  with  a program like DOS' EDIT
  54.     editor,  or  Window's  Notepad,  or any programmer's editor.
  55.     You can even  use your favorite  word processor to  edit and
  56.     generate catalog files, but  you must remember to  save them
  57.     as  ASCII  files.    You  use   The  Disk  Vendor   compiler
  58.  
  59.     (COMPILE.EXE)  to  merge  and  compress  all your individual
  60.     .CAT catalog files into one single data file (CATALOG.DAT).
  61.  
  62.     COMPILER: The compiler  is the program  that gathers all  of
  63.     your   ASCII   catalog   files   (*.CAT)   and   all   other
  64.     miscellaneous ASCII text files (*.TXT), and then merges  and
  65.     compresses  this  information  into   a  single  data   file
  66.     (CATALOG.DAT).   The Disk  Vendor compiler  also prompts the
  67.     user for information such  as quantity discount rates,  your
  68.     mailing  address,  sales  tax,  and  currency  format before
  69.     actual compilation begins.
  70.  
  71.     DATA  FILE:  The  data  file  is  a  specially formatted and
  72.     compressed  file  that  contains  ALL  your  product  names,
  73.     prices,  mailing  address,   shipping  costs,  opening   and
  74.     closing screens, etc.   This data file  is created by  using
  75.     The Disk Vendor compiler (COMPILE.EXE) and once it has  been
  76.     created it can be identified by the filename  "CATALOG.DAT".
  77.     This data file is one  of the two necessary files  that must
  78.     be placed on your distribution disk for your customers.
  79.  
  80.     HELLO AND GOODBYE FILES:  These are silly sounding  terms, I
  81.     admit, but their  names imply what  you would think.   These
  82.     are two OPTIONAL files  that are displayed at  the beginning
  83.     and end of  your on-disk catalog.   The opening screen  file
  84.     is identified with the filename "HELLO.TXT" and the  closing
  85.     screen  as  "GOODBYE.TXT".   You  can  have  a  hello   file
  86.     without  a  goodbye  file,  or  vice  versa.   One  does not
  87.     require the other.  Or you may wish to eliminate both.   The
  88.     choice is up to you.  These files are extended ASCII  files,
  89.     which means  you can  use any  of the  high ASCII characters
  90.     (graphics) such as ║  ▒ █ ╚ ½ å
  91.  
  92.     RUN-TIME  MODULE:  Refers  to  the file "CATALOG.EXE".  This
  93.     is  the  program  that  reads  the  information in your data
  94.     file and displays it to your customers.  Remember, in  order
  95.     to create a catalog on a disk for your customers, two  files
  96.     must exist on that disk:  1) CATALOG.EXE and 2) CATALOG.DAT.
  97.  
  98.     SHIPPING  FILE:  This  is  a  small ASCII file that contains
  99.     information  on  the  various  modes  of  shipping and costs
  100.     available  to  your  customer.   It  is  identified  by  the
  101.     filename "SHIPPING.TXT".
  102.  
  103.     TEXT  FILE:   Text  files  are  ASCII  files  that   contain
  104.     miscellaneous  messages  and  notes   that  you  want   your
  105.     customers to have access to.   Text files are identified  by
  106.     the  file  extension  ".TXT"  and  must NOT be confused with
  107.     catalog  files.   Text  files  should  NOT  contain products
  108.     that you  want your  customers to  order, unless  you expect
  109.     them to  hand write  those items  at the  end of their order
  110.     form.  The contents of text files can only be viewed on  the
  111.     screen, and  no order  prompts, prices  or discount  windows
  112.     appear in conjunction with  "*.TXT" text files.   An example
  113.  
  114.     of a useful  text file would  be a file  that gives a  brief
  115.     sketch about  your company  or about  how your  products are
  116.     better than your competitor's.
  117.  
  118.     WAIT FILE: This  is a special  ASCII file that  is displayed
  119.     to your  customers by  the run  time module  as it  reads in
  120.     information from the data file.   It can be considered as  a
  121.     commercial message if you wish.  It is called a "wait  file"
  122.     because its  contents are  displayed on  the screen  as your
  123.     customer waits  for the  program to  finish a  task.   It is
  124.     appropriately identified by the filename "WAIT.TXT".
  125.  
  126.     With these terms  now under your  belt you will  be ready to
  127.     begin creating your own on-disk shareware catalog.
  128.  
  129.  
  130.     LET'S GET STARTED:
  131.  
  132.     The  first  thing  that  we  recommend  a  brand new user to
  133.     do  is  to  run  the  compiler  (COMPILE.EXE) and generate a
  134.     personalized  data  file  (CATALOG.DAT).   Then  after  this
  135.     execute  the  run  time  module  (CATALOG.EXE)  so  that you
  136.     can see  how quick  and easy  it is  to generate  a catalog.
  137.     Do this right  now!  At  the DOS prompt,  just enter COMPILE
  138.     and fill in the blanks  as you are prompted by  the program.
  139.     Once you  have done  this, enter  CATALOG at  the DOS prompt
  140.     and look at your results.
  141.  
  142.     Before you  generate your  own catalog  files (*.CAT)  spend
  143.     some  time  getting  familiar  with  the  run-time    module
  144.     (CATALOG.EXE).   Explore its  features and  interface.   Try
  145.     placing a few orders as if  you were a customer.  Print  out
  146.     your order forms, print the catalog, search for words,  save
  147.     and retrieve  your orders,  etc.   By playing  with the run-
  148.     time module you will  get a feel for  the power and ease  of
  149.     use that The Disk Vendor provides you.
  150.  
  151.     Once  you  have  spent  some  time  with the run-time module
  152.     (CATALOG.EXE)  and  the  compiler  (COMPILE.EXE)  then   you
  153.     should begin creating your very own catalog files (*.CAT).
  154.  
  155.     To begin, use  your favorite text  editor or word  processor
  156.     and open a new file.  We will call the name of the new  file
  157.     "VIRUS.CAT"  and  we  will  generate  a  catalog  file  that
  158.     contains virus  checking software  programs.   Note: You can
  159.     give the file any name you wish as long as it  contains  the
  160.     file  extension  ".CAT".   "SOFTWARE.CAT",   "DISNFECT.CAT",
  161.     "_VIRUS_.CAT" are  all valid  catalog file  names.  Whatever
  162.     is  easiest  for  you  to  remember,  give it an appropriate
  163.     filename.
  164.  
  165.     THE STRUCTURE OF A CATALOG FILE:
  166.  
  167.     Once you  begin a  new catalog  file, there  is a   specific
  168.     format that you must follow:
  169.  
  170.     1) The  very first  line of  the catalog  file (*.CAT)  must
  171.     contain  a  34  character  or  less  description.  The first
  172.     line  of  a  catalog  file  will  be  used  in the Main Menu
  173.     catalog index listing.
  174.  
  175.     2) A pound symbol "#" separates one product and  description
  176.     from  another.   The  "#"  can  be  followed by your catalog
  177.     number identifying  the product  that follows  it.   Catalog
  178.     order numbers must not be longer than 20 characters.
  179.  
  180.     3) The name of the product  follows on  the next line  after
  181.     the line that contains the "#" symbol.
  182.  
  183.     4) Any  lines after  the product  name are  used for  you to
  184.     describe that product.
  185.  
  186.     5)  Product  description  line  length  must  not  exceed 72
  187.     characters in width.
  188.  
  189.     All right, got it?  Clear as  mud?  Probably.  So here   are
  190.     some examples  that will  help you.   Again, we  are in  our
  191.     editor and have the file "VIRUS.CAT" open.  With the  cursor
  192.     at  the  very  top  of  the  document  (line  1),  enter   a
  193.     description used  to identify  the contents  of the  catalog
  194.     file:
  195.  
  196.     ┌─────────────────────────────────────────────────────────┐
  197.     │Virus protection software                                │
  198.     │                                                         │
  199.     │                                                         │
  200.     │                                                         │
  201.  
  202.     It is  simple so  far, isn't  it?   Just keep  the number of
  203.     characters in this description line less than 34.
  204.  
  205.     Now, on to line 2!
  206.  
  207.     As we stated above, a "#" symbol separates one product  from
  208.     another.   Since we  are about  to enter  a new product name
  209.     and description, we need to place a "#" on line 2, column 1:
  210.  
  211.     ┌─────────────────────────────────────────────────────────┐
  212.     │Virus protection software                                │
  213.     │#                                                        │
  214.     │                                                         │
  215.     │                                                         │
  216.  
  217.     If  you  wish  to  identify  your  products  using a catalog
  218.     number, now  is the  time to  do so.   Immediately following
  219.     the "#" symbol, enter your catalog number.  The number  does
  220.     not need to  be a number,  but can be  characters if you  so
  221.     choose, or a combination of both.  For example:
  222.  
  223.     ┌─────────────────────────────────────────────────────────┐
  224.     │Virus protection software                                │
  225.     │#VI040                                                   │
  226.     │                                                         │
  227.     │                                                         │
  228.  
  229.     Again, you  are not  required to  enter a  catalog number if
  230.     you choose not  to.  What  is mandatory, however,  is that a
  231.     "#" symbol exists in column 1 and must precede the line that
  232.     contains the product name.
  233.  
  234.     When you are  ready to enter  a product name,  move down one
  235.     line below the "#" and enter it:
  236.  
  237.     ┌─────────────────────────────────────────────────────────┐
  238.     │Virus protection software                                │
  239.     │#VI040                                                   │
  240.     │Expel                                                    │
  241.     │                                                         │
  242.  
  243.     In the example above  the software program "Expel"  has been
  244.     placed immediately below the line containing the "#" symbol.
  245.  
  246.     To show you some of  the features unique to The  Disk Vendor
  247.     we will let you  know here that you  can add a comment  note
  248.     on the same line  as the product name.  A "comment note" may
  249.     consist of anything you wish,  as long as it is  enclosed in
  250.     squiggly brackets  {}.   For example,  let's say  that Expel
  251.     is  obtained   wholesale  through   your  distributor   Acme
  252.     Software.  Your sales  representative with Acme Software  is
  253.     Jim Smith.  If you wanted  to make a note of that  fact, you
  254.     can add a comment note recording this.  For example:
  255.  
  256.     ┌─────────────────────────────────────────────────────────┐
  257.     │Virus protection software                                │
  258.     │#VI040                                                   │
  259.     │Expel {Acme: Jim Smith}                                  │
  260.     │                                                         │
  261.  
  262.     Above  we  see  that  the  software title Expel is purchased
  263.     through  Acme  Software,  whose  sales  rep.  is  Jim Smith.
  264.     This comment note is enclosed in {} brackets.  The  brackets
  265.     are very  important!   When this  catalog file  is compiled,
  266.     your  comment  notes  are  ignored.   Comment  notes  in  {}
  267.     brackets do not appear  to your customer because  they never
  268.     find their way  into the data  file (CATALOG.DAT).   Comment
  269.     notes are  for your  use and  are optional.   You can  enter
  270.     anything  you  wish  between  {}  brackets  -  the name of a
  271.     company, a stock bin number, an inventory count, the  weight
  272.     of  the  product,  whatever.   Again,  this  comment note is
  273.     optional.
  274.  
  275.     The next  bit of  information that  you need  to add  is the
  276.     selling  price  for  the  product.   At  the end of the line
  277.     that contains the product  name, enter its price.   Although
  278.     you can add a currency symbol before the price, this is  not
  279.     necessary, and in  fact it is  not recommended.   The reason
  280.     we do not recommend that  you enter a currency symbol  (e.g.
  281.     "$")  is  because  it  takes  up  file  space.  The run-time
  282.     module does not need  the currency symbol repeated  hundreds
  283.     of times in your *.CAT files.   One little "$" sign may  not
  284.     seem like much,  but if you  repeat this symbol  hundreds of
  285.     times  it  slowly  eats  up  disk  space.   But if you can't
  286.     break  the  habit,  that's  fine  too.   The  compiler   and
  287.     run-time module do not care.
  288.  
  289.     ┌─────────────────────────────────────────────────────────┐
  290.     │Virus protection software                                │
  291.     │#VI040                                                   │
  292.     │Expel {Acme: Jim Smith} 23.95                            │
  293.     │                                                         │
  294.  
  295.     Above we  see a  price of  $23.95 for  one unit  of "Expel".
  296.     This  $23.95  is  the  undiscounted  selling  price for this
  297.     product to  your customers.   If you  wish to  give multiple
  298.     quantity discounts, see  the compiler (COMPILE.EXE)  and set
  299.     up  the  discount  rates  at  compile  time.   Here  in your
  300.     catalog file (*.CAT) simply  enter the price of  the product
  301.     item as shown above.
  302.  
  303.     Now that we  have entered a  product number, a  product name
  304.     and  price,  all  that  we  have  left  is  to  give Expel a
  305.     description.    The   product   description   lines   follow
  306.     immediately  below  the  line  that  contains  the product's
  307.     name and price.  For example, let's describe Expel:
  308.  
  309.  
  310.     ┌─────────────────────────────────────────────────────────┐
  311.     │Virus protection software                                │
  312.     │#VI040                                                   │
  313.     │Expel {Acme: Jim Smith} 23.95                            │
  314.     │Anti-virus program that helps preserve the integrity of  │
  315.     │your files.                                              │
  316.     │                                                         │
  317.  
  318.     You can definitely get more descriptive if you wish.  We  do
  319.     not  recommend  that  you  enter  more  than  13 lines for a
  320.     program description because it will be truncated when it  is
  321.     compiled.  13 lines should  be more than enough to  describe
  322.     most programs.  Also,  keep all description lines  less than
  323.     72  characters  wide.   You  can  insert  blank lines if you
  324.     wish, and they will be preserved when compiled.
  325.  
  326.     Believe it or  not, that is  all there is  to it!   Not very
  327.     hard is it?
  328.  
  329.     To add additional programs to our "VIRUS.CAT" catalog  file,
  330.     simply repeat  steps 2-4  above.   Here is  our catalog file
  331.     after adding two more virus checking programs:
  332.  
  333.     ┌─────────────────────────────────────────────────────────┐
  334.     │Virus protection software                                │
  335.     │#VI040                                                   │
  336.     │Expel {Acme: Jim Smith} 23.95                            │
  337.     │Anti-virus program that helps preserve the integrity of  │
  338.     │your files.                                              │
  339.         │#VI107                                                   │                                             │
  340.     │Flu Shot+ 17.95                                          │
  341.     │Protects you system against virus and Trojan horse       │
  342.     │programs. Read/write protection for programs. Checks for │
  343.     │contamination and prevents virus activities.             │
  344.     │#VI100                                                   │
  345.     │Virex {Version 2.1} 34.95                                │
  346.     │Virex checks an entire disk for over 800 different virus │
  347.     │strains.  If it detects a virus, Virex will remove the   │
  348.     │virus from the program or disk.  Quarterly update        │
  349.     │virus signature lists are available from the publisher   │
  350.     │to protect your computer against new virus strains.      │
  351.  
  352.     Notice  that  you   do  NOT  repeat   the  "Virus protection
  353.     software" category  description line.    This  occurs   only
  354.     ONCE, and must  be on the   first  line   of  your   catalog
  355.     file (VIRUS.CAT).
  356.  
  357.     We  strongly  recommend  that  you enter/insert new products
  358.     in alphabetical order.   This will make your  catalog easier
  359.     to navigate through  when viewed by  your customers.   There
  360.     exists  a  function  in  The  Disk  Vendor  run-time  module
  361.     (CATALOG.EXE)  that  lists  all  the  product  items  in the
  362.     currently selected  category.   This "quick  browse" listing
  363.     displays the products' names in the same order in which  you
  364.     entered them into the catalog file.  Therefore, if you  want
  365.     this list to appear in alphabetical order, you should  enter
  366.     the products in  alphabetical order.   The Disk Vendor  will
  367.     not sort  this list  because it  wants you  to practice good
  368.     catalog file creation and maintenance.   It is also to  your
  369.     benefit  to  enter  and  maintain  products  in alphabetical
  370.     order.  It  not only makes  it easier for  your customers to
  371.     locate products, but  it makes it  easier for YOU  to locate
  372.     products when it comes time to update or purge your  catalog
  373.     files.
  374.  
  375.     If these  3 titles  are all  you have  in the  way of  virus
  376.     checking  software programs, then  close  the    "VIRUS.CAT"
  377.     catalog file and save it to disk.
  378.  
  379.     One last  feature that  you may  be interested  in adding to
  380.     your catalog file is a  "customer note".  A "customer  note"
  381.     contains  text  information  that  helps better describe the
  382.     items that follow.  A  "customer note" does NOT have  prices
  383.     or part  numbers attached  to them.   You begin  a  customer
  384.     note with  a "#"  symbol, immediately  followed by  "NOTE#".
  385.     Move down one line and  enter a header line, then  move down
  386.     one line and enter the  ASCII text that makes up  your note.
  387.     Using the VIRUS.CAT file as an example:
  388.  
  389.     ┌─────────────────────────────────────────────────────────┐
  390.     │Virus protection software                                │
  391.     │#VI040                                                   │
  392.     │Expel {Acme: Jim Smith} 23.95                            │
  393.     │Anti-virus program that helps preserve the integrity of  │
  394.     │your files.                                              │
  395.     │#NOTE#                                                   │
  396.     │WHAT IS A COMPUTER VIRUS?                                │
  397.     │A computer virus is a program designed to replicate and  │
  398.     │spread on its own, preferable without you knowing it     │
  399.     │exists.  Like a human body, computers are vulnerable to  │
  400.  
  401.     It is best to experience a customer note in a compiled  data
  402.     file first hand in order  to appreciate its usefulness.   We
  403.     have included several customer  notes in the sample  catalog
  404.     files (*.CAT) that accompanied  this program.   Take a  good
  405.     look at these files to understand how they work.
  406.  
  407.     Customer notes  can occur  anywhere in  your catalog  files,
  408.     and they can  be unlimited in  length (1 to  1000 lines) but
  409.     are restricted to 72 columns in width.
  410.  
  411.     A few  other guidelines  that you  should be  aware of  when
  412.     working with catalog files (*.CAT):
  413.  
  414.         Use lower  case letters  as much  as possible. Upper
  415.         case  letters  do  not  compress well during compile
  416.         time.  On average you  will achieve a 40% file  size
  417.         reduction if the majority of your catalog files  are
  418.         in lower  case (before:  100,000K, after:  60,000K).
  419.         Don't  overdo  this,  of  course.   Just  type  your
  420.         catalog files as  if you were  typing a letter  to a
  421.         friend.  Keep the CAPS LOCK off, and avoid  entering
  422.         product names  in uppercase  and you will be  OK (or
  423.         is it "ok"?).
  424.  
  425.         Do not  use high  ASCII characters  in your  catalog
  426.         files (*.CAT).   Characters such as  ║  ▒  █ ╚ ½  å
  427.         will  not  be  compiled  properly.  Absolutely avoid
  428.         them!
  429.  
  430.  
  431.     OTHER NECESSARY FILES BEFORE COMPILING:
  432.  
  433.     Although your catalog files  (*.CAT) are the most  important
  434.     files  that  you  need  to  have prior to compilation, there
  435.     are additional files that you can and should create.
  436.  
  437.     The  first  mandatory  file  required  for  compilation is a
  438.     "wait file".  This file is an ASCII text file that  contains
  439.     a message for your customer while the run-time module  works
  440.     on a task.   This file can  be created with  an editor,  and
  441.     must be saved  with the filename  "WAIT.TXT".  If  this file
  442.     does not  exist when  you go  to compile  your catalog using
  443.     COMPILE.EXE the compilation process will abort.   "WAIT.TXT"
  444.     is  absolutely  mandatory.   With  The  Disk  Vendor package
  445.     that  you  have  received  a  sample  "WAIT.TXT" file can be
  446.     found  that  you  may  use  as  a guide.  The most important
  447.     things  that  you  must  remember  when  working  with   the
  448.     "WAIT.TXT" file is that it  can NOT be longer 72  characters
  449.     wide  by  17  rows  high.   Also,  this  wait  file must not
  450.     contain any high ASCII characters.
  451.  
  452.     The second (and last)  mandatory file that must  exist prior
  453.     to compilation  is a  shipping text  file.   Identified with
  454.     the filename "SHIPPING.TXT", this file contains  information
  455.     on  the  shipping/mailing  methods  that  you  provide  your
  456.     customers with,  and their  costs.   A sample "SHIPPING.TXT"
  457.     file has been included with The Disk Vendor system that  you
  458.     received and  can be  used as  a guide.   Its format  is  as
  459.     follows:
  460.  
  461.     [Type of shipping]=[Cost]
  462.  
  463.     Where  [Type of shipping]  is  replaced   with   the   words
  464.     identifying the type  of shipping/mailing method  available,
  465.     and where  [Cost]  is replaced with  the actual cost.  These
  466.     two parameters are linked together with a "=" equals symbol.
  467.     Here is  a real  life example  of a  "SHIPPING.TXT" file, so
  468.     that you can see better the format you must follow:
  469.  
  470.     USPS (US)=2.95
  471.     USPS (Canada)=5.00
  472.     USPS (Elsewhere)=7.00
  473.     UPS Ground (US)=4.00
  474.     UPS Blue (48 Sts)=7.00
  475.     UPS Blue (AL HI PR)=8.00
  476.     UPS Red (US)=16.00
  477.     UPS Red (AL HI PR)=19.00
  478.     Federal Express overnight=20.00
  479.  
  480.     You can have  one line in  your shipping file,  or 10 lines.
  481.     You have the choice  to add or delete  any lines.  The  only
  482.     requirement  is  that  at  least  one  line  exists  in  the
  483.     "SHIPPING.TXT"  file,  and  that   you  follow  the   format
  484.     outlined above.
  485.  
  486.     Having your  catalog files  (*.CAT) and  the "WAIT.TXT"  and
  487.     "SHIPPING.TXT"  files,  you  can  now  begin the compilation
  488.     process  if  you  wish.   These  files  are mandatory before
  489.     running COMPILE.EXE.   You may wish  to add some  additional
  490.     files, but this is optional (see next section).
  491.  
  492.  
  493.     OPTIONAL TEXT FILES TO INCLUDE IN YOUR CATALOG:
  494.  
  495.     Many businesses and  companies who use  The Disk Vendor  may
  496.     wish to add additional ASCII text files for their  customers
  497.     to view.   This can  be done  with an  editor, and  the only
  498.     requirements that The Disk Vendor impose are:
  499.  
  500.     1) The text  file must NOT  contain  control  characters nor
  501.     high ASCII characters > 126 (decimal).
  502.  
  503.     2) The  text file  must be  saved with  a filename extension
  504.     ".TXT"  (short  for  "text").   "BONUS.TXT",   "README.TXT",
  505.     "COUPON.TXT", "SPECIALS.TXT" are all valid text filenames.
  506.  
  507.     3) The  text file  can be  any length  (within reason),  and
  508.     should be less than 81 characters in width.
  509.  
  510.     4) The first line of your  .TXT file must be reserved for  a
  511.     description  line.   This  reserved  description  line works
  512.     exactly  as  the  description  line  in  your  catalog files
  513.     (*.CAT).   This  description  line  will  appear in the Main
  514.     Menu  catalog  index  box  and  must  contain  less  than 35
  515.     characters.   Again, this  description line  MUST reside  on
  516.     line 1 of your text file!
  517.  
  518.     What would you use .TXT files for?  Some possibilities are:
  519.  
  520.         To describe your company and its products.
  521.  
  522.         To display a discount coupon that the customer can
  523.         print using the PRINT SCREEN key and then redeem.
  524.  
  525.         To explain your return policies.
  526.  
  527.  
  528.     HELLO AND GOODBYE:
  529.  
  530.     Should  you  wish  to  create  a special opening screen that
  531.     your customer  views before  the Main  Menu screen  appears,
  532.     then  create  a  "hello"  file.   This  file is also created
  533.     using  an  editor,  and  must  be  saved  with  the filename
  534.     "HELLO.TXT".    Unlike   other   ASCII   text   files,   the
  535.     "HELLO.TXT" file can contain high ASCII graphic  characters.
  536.     This  will  enable  you  to  create  some attractive opening
  537.     screens with boxes  and shadows and  text.  The  "HELLO.TXT"
  538.     file  can  contain  up  to  25  lines  of  characters  by 80
  539.     characters  in  width  (the  size  of  a  normal  text  mode
  540.     screen).  Here is an example of what you could do:
  541.  
  542.       ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓
  543.       ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓
  544.       ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓
  545.       ▓▓▓▓▓┌───────────────────────────────────────┐▓▓▓▓▓▓▓▓▓
  546.       ▓▓▓▓▓│                                       │░░▓▓▓▓▓▓▓
  547.       ▓▓▓▓▓│    XYZ COMPUTERS PROUDLY PRESENTS     │░░▓▓▓▓▓▓▓
  548.       ▓▓▓▓▓│        ITS WINTER 1995 SOFTWARE       │░░▓▓▓▓▓▓▓
  549.       ▓▓▓▓▓│          CATALOG ON A DISK            │░░▓▓▓▓▓▓▓
  550.       ▓▓▓▓▓│                                       │░░▓▓▓▓▓▓▓
  551.       ▓▓▓▓▓│       Press any key to begin...       │░░▓▓▓▓▓▓▓
  552.       ▓▓▓▓▓│                                       │░░▓▓▓▓▓▓▓
  553.       ▓▓▓▓▓└───────────────────────────────────────┘░░▓▓▓▓▓▓▓
  554.       ▓▓▓▓▓▓▓░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░▓▓▓▓▓▓▓
  555.       ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓
  556.       ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓
  557.       ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓
  558.  
  559.  
  560.     Just remember  to include  an instruction  for your customer
  561.     to "PRESS ANY KEY TO CONTINUE..." or else you may find  your
  562.     customer  scratching  his  head  wondering  what to do next.
  563.     You may  never receive  an order  from him  because he could
  564.     not get past your opening screen!
  565.  
  566.     Likewise, if you  wish to have  a special message  appear at
  567.     the close of  the program, create  a "goodbye" file  with an
  568.     editor.   Follow exactly  the same  guidelines as  described
  569.     above  for  the  "hello"  file,   but  save  this  file   as
  570.     "GOODBYE.TXT".   Again,  remind the customer with  a message
  571.     to press any key to exit the program!
  572.  
  573.     Both the "HELLO.TXT"  and "GOODBYE.TXT" files  are optional.
  574.     You may wish not to have opening or closing screens, or  you
  575.     may wish  to have  one but  not the  other.   This is  fine.
  576.     Just delete the files you  don't need, or don't create  them
  577.     in the first place.
  578.  
  579.  
  580.     THAT'S ALL FOLKS!:
  581.  
  582.     Speaking of "goodbyes", the  instructions above are all  you
  583.     need to get  you up and  running creating your  own personal
  584.     shareware catalog on disk.   We hope that you find  The Disk
  585.     Vendor a useful tool in marketing your products.
  586.  
  587.  
  588.     SHAREWARE:
  589.  
  590.     The Disk Vendor is  shareware software and continued  use of
  591.     the program requires  you to support  the author.   Once you
  592.     have registered, you will receive the latest version of  The
  593.     Disk Vendor that will permit you to begin distributing  your
  594.     compiled  data  file  (CATALOG.DAT)  and the run-time module
  595.     (CATALOG.EXE) freely without royalties.
  596.  
  597.  
  598.     ALL IN THE FAMILY:
  599.  
  600.     Attention shareware distributors!!!!   If you would like  to
  601.     use  The  Disk  Vendor  to  distribute  public  domain   and
  602.     shareware software disks, we  have a special version  of The
  603.     Disk Vendor JUST  FOR YOU!   Custom tuned for  the shareware
  604.     industry,  The  Disk  Vendor  "shareware vendor" version has
  605.     features  unique  to  your  industry,  such  as   multi-disk
  606.     prices,  separate  pricing  structures  for 360K, 720K, 1.2M
  607.     and 1.4M disk  sizes.  We  highly recommend this  "shareware
  608.     vendor" version  if you  need a  catalog on  disk system  to
  609.     distribute  your  shareware  library.   Contact  the program
  610.     author with a SASE or by phone to learn more details.
  611.  
  612.  
  613.     CAN I CONVINCE YOU TO CONVERT?:
  614.  
  615.     Question:  "I  currently  use  EmmaSoft's  Catalog-On-A-Disk
  616.     program to distribute  the  products we sell and would  like
  617.     to switch  to The  Disk Vendor.   What are  the  differences
  618.     between these two products, and can I salvage my COAD  *.TXT
  619.     files for use with The Disk Vendor?"
  620.  
  621.     Answer:
  622.  
  623.     1)  A  very  clean,  uncluttered,  attractive user interface
  624.     distinguishes   our   product   from   EmmaSoft's   product.
  625.     Your customers will find   it easier to  use,  and hopefully
  626.     order more products from you   if they can navigate   easily
  627.     through the on-disk catalog that you have provided them.
  628.  
  629.     2)  The  Disk  Vendor  run-time  distribution  .EXE   module
  630.     (CATALOG.EXE) is only 54000 bytes in size.  Our competitor's
  631.     product is approximately  81000 bytes.   So what?   The more
  632.     products you  offer your  customers, the  more products  you
  633.     are likely to sell.   The more disk space available  on your
  634.     distribution disk  means more  products you  can list.   The
  635.     smaller the  run-time .EXE  program, the  more products  you
  636.     can offer  your customer.   You know  how many  products you
  637.     can get into  27000 bytes of  disk space (the  difference in
  638.     size between our product  and theirs)?  Literally  hundreds!
  639.     The more  product selections  you offer  your customers,  or
  640.     the better you  describe your products,  the more disks  you
  641.     will  be  able  to  sell.   Free  disk  space  equals   more
  642.     potential sales.
  643.  
  644.     3)  On  your  distribution  disk  to your customer, only two
  645.     files need to  exist for your  on-disk catalog to  run using
  646.     The  Disk  Vendor  -  (CATALOG.EXE  and  CATALOG.DAT).   Our
  647.     competitor creates dozens of ".CM" files if you have  dozens
  648.     of  product  categories.   So  what,  you  may  ask?  Again,
  649.     getting back  to the  story of  available disk  space.   The
  650.     more available  space on  your distribution  disk, the  more
  651.     products  or   better  descriptions   you  can   offer  your
  652.     customers.  It is a hardware fact in DOS that if you have  a
  653.     file  on  a  360K  disk  that  is  only  11  bytes  long, it
  654.     actually will  take up  1024 bytes  of disk  space!  This is
  655.     due  to  the  way  files  are  allocated  on  a  disk.   For
  656.     instance,  if  you  have  a  file  called  "HELLO.CM" and in
  657.     it contains  the letters  "HELLO WORLD",  although the  file
  658.     listed in  a DIR  command shows  the file  size as  11 bytes
  659.     long, it actually  displaces 1024 bytes  on disk.   Multiply
  660.     "HELLO.CM" two dozen times, and 264 bytes (24 x 11) now  has
  661.     displaced 24576 bytes!  Alright,  so what's the point?   The
  662.     point is that the more  files you have on your  distribution
  663.     disk, the more  disk space you  are most likely  wasting due
  664.     to partially  filled clusters.   The Disk  Vendor eliminates
  665.  
  666.     wasted disk  space by  needing only  two files  to exist  on
  667.     your  distribution  disk  -  CATALOG.EXE  and   CATALOG.DAT.
  668.     Also,  needing  only  two  files  on  your distribution disk
  669.     makes file housekeeping chores much easier.
  670.  
  671.     4) The  compilation of  your catalog  ASCII text  files to a
  672.     single catalog  data file  (CATALOG.DAT) is  a one-step wham
  673.     bam, "run it once and  I'm done process".  Our  competitor's
  674.     product requires you  to compile two  dozen ".CM" files  one
  675.     at a  time if  you have  two dozen  product categories.  The
  676.     Disk  Vendor  saves  you  time,  compiling  ALL your catalog
  677.     ASCII files  automatically in  one swoop,  insuring that the
  678.     resulting  CATALOG.DAT  file  is  the  latest  and  contains
  679.     complete, up to date information.
  680.  
  681.     5) The  Disk Vendor  provides you  with a  utility that will
  682.     convert all  your Catalog-On-A-Disk  .TXT files  to The Disk
  683.     Vendor ASCII .CAT format.  Converting from our  competitor's
  684.     product to  The Disk  Vendor couldn't  be easier!   You lose
  685.     none of  your hard  work.   Copy the  file "COAD_CVT.EXE" to
  686.     the directory where you store your EmmaSoft COAD .TXT files,
  687.     then  run "COAD_CVT.EXE" from DOS.  This conversion  utility
  688.     will create new  catalog files (*.CAT)  that can be   placed
  689.     in  the  directory  where  The  Disk  Vendor  resides.
  690.  
  691.