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