
  
     V9t9:  TI Emulator! v6.0 Documentation      (c) 1995 Edward Swartz
  
   ORDERING.TXT 
  

       This file tells how to place orders with me for ROMs and module
  dumps, and how to use them.


  Ŀ
                    ORDERING A MINIMAL SET OF ROMS 
  

       If the procedure outlined in TRANSFER.TXT for moving 99/4A ROMs
  over to your PC is too arduous or impossible, you can purchase a minimal
  set of ROMs from me through my software license with TI.  These ROMs
  will let you run the emulator, without the vocabulary of the speech
  synthesizer, the RS232/PIO, or 99/4A Disk DSR ROMs (these ROMs are not
  covered by my license).

       The fake disk ROM provided with the emulator allows you use to FIAD
  file access (see DISKS.TXT), perfectly useful for most applications.
  The fake RS232/PIO ROM is also very useful, except for the lack of the
  SAVE and LOAD commands.  The fake speech ROM is what allows most
  programs which have their own speech to operate.

       The archive you receive will contain:

         99/4A ROM and GROM images
         Three modules (see BINARIES.TXT)

       This is only $15, and the money goes mostly for royalty fees.  You
  don't have to pay the fairware base fee for this order.  This offer is
  intended for those of you who feel uneasy sending $25+ for something you
  haven't seen in action (though you needn't worry if the demos satisfy
  you).

       Please use the ORDERMIN.TXT order form for this order.  I'd prefer
  to send these orders through e-mail.  However, if it's impossible to use
  e-mail, PLEASE "pool" with your friends and bulk order the ROMs.  (I'll
  send them all on one disk, if possible.)  It'll make my shipping and
  handling fees lower.  (Go to the "ordering guidelines" section.)


  Ŀ
                   ORDERING BEYOND THE "MINIMAL PACKAGE" 
  

       When not ordering the "minimal package", use the general order form
  ORDERGEN.TXT.  With it, you can get other modules and source code.

       With the general order, a fairware "base fee" is required.  The
  base fee for first-time customers is $25.  Users who have previously
  sent me money for TI Emulator! v4.0 or v5.0x pay a base fee of $15.

       Before you make a general order, I prefer that you already have
  copies of your 99/4A ROMs to use with V9t9 or have ordered the "minimal
  package" of ROMs from me.  This is so that you won't have to pay a base
  fee, in essence just to use V9t9, which goes against my beliefs about
  fairware.  Also, it shields you from any surprises you may not have
  anticipated just by watching the demos.  :)

       If you do go ahead and order the "minimal package" and "general
  package" together, be sure to fill out both order forms (ORDERMIN.TXT
  and ORDERGEN.TXT) completely.  Only send one check, though.  I'll keep
  track of it.


                              

       HOWEVER:  Do not, under any condition, advise someone to send me an
  order for a "general package" if they have not used or seen the
  emulator.  V9t9 is NOT a commercial product that must be purchased
  before use.  (Or that must be purchased at all.)  I do NOT want someone
  to pay me and then possibly be dissatisfied with the product -- because
  all purchases are final.


  Ŀ
                         ORDERING GUIDELINES 
  

      First of all, this program is NOT SHAREWARE.  You do NOT have to
       pay for using it.  Of course, however, like any struggling
       programmer, I am perfectly willing to accept money for my work.  :)

       Also, there is no "registered" version of this program.  That would
       imply that I'm leaving important features out of -- or "crippling"
       -- the fairware version, a practice I consider evil.  Now, the
       emulation may be incomplete, but that is simply because I'm not
       finished with the program.


      I will not make any guarantees about the usefulness or suitability
       to your purposes for anything you buy.  All purchases are final.
       There is no warranty for the programs I have written.


      I will release a new version of V9t9 every FOUR MONTHS.  Any
       earlier archives are considered to have expired at such time.  The
       NEWEST version's ordering guidelines apply to all orders I receive.

       This means that the newest guidelines apply even if you do not know
       about them.  To avoid such a situation, be aware of new versions of
       V9t9 before ordering.

       I will probably NOT change all the guidelines in every version, of
       course.  So if you send an order, and the relevant ordering
       guidelines haven't changed, I will still accept it.  However, I
       highly recommend that you look for the latest version first.  Or
       you can e-mail me, and I'll send you the latest version for free.
       (See DISTRIB.TXT.)

       If this guideline seems harsh, consider this:  I released TI
       Emulator v4.0 around March 1994.  That version was obselete TWO
       MONTHS later, when I released v5.01.  I figured that people would
       switch to v5.01.  But of course, people still ordered v4.0 -- AND
       THEY'RE STILL TRYING, seventeen months later!  V4.0 (and v5.01) had
       no expiration date, you see.  Now, of course, they are absolutely
       and completely obselete.  Hopefully a more aggressive distribution
       strategy for V9t9, along with this expiration date policy, will
       lessen my headaches.


      I will no longer accept orders for TI Emulator v4.0 or v5.01, and
       will reject any order which doesn't appear to be for this program.
       (Meaning, if you don't use the provided (and recommended) order
       forms, please use "V9t9 v6.0" somewhere in your letter to let me
       know that you're not referring to an older version.)


      If you send an order for an old version, and the newest guidelines
       are similar enough not to void the order, the latest version of
       V9t9 will also be sent to you, minus the demonstrations (to save
       space).  If you ordered any utilities, they will be compatible with
       that latest version.  The new version, if any, will be the fairware
       archive.  It will not be a "registered version" or a privileged
       upgrade.


      Users who send me money are NOT considered to be "registered for
       life" (this applies to v4.0 and v5.01 customers too).  If, in the
       future, I provide some new things to order, or make some special
       offers, it doesn't mean a customer of this version is entitled to
       free copies.  The same goes for archives of V9t9.  I will not send
       the new archive to all the customers of the previous version.

       This is a matter of manpower and money.  I'm the only person doing
       all this mailing and programming and college-studenting, and it is
       simply impossible for me to maintain such a service.  If I charged
       a lot more for the program, or had a company, I could do this, but
       I don't right now.  Sorry.


                         


      If you want to buy any module dumps, please consult the list in
       BINARIES.TXT in making your order and use the three-letter codes on
       the order form.  This will allow me to quickly archive and record
       your order.  Although some modules come with disks (such as TI
       Writer and Editor/Assembler), my license doesn't allow me to
       distribute them.  In any case, each module costs one dollar.


      You can purchase the source code for V9t9.EXE from me for $100.
       It's written entirely in assembly.  I recommend that you know 80x86
       and 9900 assembly before you purchase it; it's not intended to
       teach assembly.  It was written under Turbo Assembler v3.1 using
       Turbo Link v5.1, but has compiled under v2.0.  I'm unsure about
       Microsoft Assembler compatibility.  It's probably not compatible
       since I use TASM's ideal mode.

       You are restricted from distributing the source code or making
       hybrid versions of V9t9.  Some day, when I stop V9t9, I'll release
       the source code to the public domain, but not yet.

       The source code will be for the VERSION YOU ORDERED.  Take note of
       this!  All orders will come with the archive of the latest version
       of V9t9 (if one is available), but the source code is not for the
       new version.


      Currently, I am offering nothing else for you to order.  Utilities
       to transfer modules and files from the 99/4A to your PC, which were
       paid fare for older versions, now come free with the V9t9 archive
       to help more people make use of the program.

       If you have any suggestions for V9t9 utilities I could develop and
       sell, I'm happy to listen.


                         



      Please send all orders by check or money order.  Do not send cash
       in an envelope, because it is likely that someone on the path
       between you and me will divert your money.


      Please don't send your order via registered mail.  As far as I can
       tell, I have received all the orders sent to me.  (The no-money-in-
       an-envelope request comes from opening a few cash orders and
       wondering how they DIDN'T get lost or stolen.)  Sending your order
       via registered mail is only an unnecessary hassle, for you and for
       me.


      If you send money from outside the United States, be sure it is a
       check that is CASHABLE IN A U.S. BANK.  For example, it should read
       in small print somewhere, "Cashable at the First National Bank in
       New York."  (A $25 collection fee is otherwise required to cash
       foreign checks, rendering them mere pieces of paper.)  Better yet,
       send a U.S. Postal Money Order.

       Please add $5 for shipping and handling, and expect a few weeks
       delay for the post office to do their dirty work.


  Ŀ
                RECEIVING YOUR ORDER THROUGH SNAIL-MAIL 
  

       There is a disk/postage charge of $2 for snail-mail orders (except
  for minimal orders).


       Since postal guidelines state that snail-mail orders must be sent
  within a month unless the buyer agrees to a delay, your payment to me
  is an agreement to a maximum wait of 60 days to receive your order from
  the time I get it.


       While I do not PLAN to make anyone wait this long, I am a college
  student and have a sufficient workload already without sending off every
  order the afternoon I get it.  In the summer of 1994, delays were an
  average of two/three weeks.  Hopefully they will now shrink to a mere
  week, now that I've eliminated the vague wording from the ordering
  guidelines which caused v4.0 and v5.01 orders to anguish me so.  Note
  that it takes the post office about a week to send disk mailers, even
  with first class postage.


       If necessary, I will cash your check before sending your order, so
  please don't panic and assume your order got lost in the mail, unless 60
  days have passed since I received your money.


       If I am unable to send your package within the maximal time limit,
  I'll return your money and send the latest version of V9t9 and profuse
  apologies.  This should only happen if I lose your order on my desk.


       If, when you receive your order, the disk has bad sectors or
  obviously missing files, I'll remedy the situation.  Send back the
  original disks, and I'll send you fixed copies for free.  (This only
  applies to errors found upon receiving the disks -- it's your
  responsibility to back up the disks to prevent data loss from extended
  use.)


       When you receive your order, always unzip it in the directory where
  you have installed V9t9, with the "-d" option:

  C:\V9t9> pkunzip -d a:v9t9mods.zip

       The "-d" option will put the files into the correct subdirectories.

       In each archive is a short README telling you how to use the new
  files with V9t9.


  Ŀ
          DO I HAVE TO WAIT FOR YOU TO SNAIL-MAIL ME THE ORDER? 
  

       Absolutely not!  I will be happy -- overly joyously happy -- to
  send your order through e-mail over the Internet.  Please don't send
  YOUR order to MY e-mail address; I will to receive your check before
  sending an order, anyway.  If your e-mail server doesn't allow "big"
  messages to be sent to it (for example, a limit of 200k), provisions
  will be made to stick your order on an FTP site for you to retrieve.

       Please specify if you want the files sent UUENCODED or sent with
  MIME encoding (aka message "attachments", like Pine uses).

       If you elect to use this method for receiving your software, I will
  send the files encoded with a keyword you supply with your order.  This
  is in order to prevent e-mail pirates from obtaining access to TI's
  copyrighted ROMs.

       The keyword must have no spaces in it and be at least 8 characters
  long.  You can use any ASCII characters except control characters,
  spaces, tabs, and the quote mark (").  Capitalization counts!!

       If your system does not accept long e-mail, and we don't find out
  until I've tried to send your order, we'll make provisions to retrieve
  it from an FTP site (this is really where the archive encoding comes in
  handy!).  If all else fails, it's snail-mail (and the archive won't be
  encoded).  So be sure to include your address on the order form.

       I am assuming that you know how to transfer files from your UNIX
  system to your PC.  If you're unfamiliar with the process, please
  consider learning, or receive the order via snail-mail to eliminate the
  hassle.


  Ŀ
                    HOW TO RECEIVE E-MAIL ORDERS FROM ME 
  

       When you receive your order, please notify me by e-mail.  This
  tells me that you properly received it.  (If you received a new V9t9
  archive, check the CONTACT.TXT therein to be sure of my current e-mail
  address!)  If I don't receive a reply within a week, I will resend the
  package up to two more times (again waiting a week for a reply).  If you
  didn't appear to receive the order, I'll snail-mail the order instead.

       The archive will be encoded with a keyword you specified (but not
  if it's send via snail-mail).  You'll need to decode the archive before
  being able to use it.

       If you receive your order via e-mail, you'll need to transfer the
  file to your PC over the modem (or with FTP in a computer lab).  I can't
  teach the details of transferring files -- please contact your UNIX
  system administrator.  I can only tell you how to assemble the binary
  from the ASCII e-mail message I send you.

       If you already know how to do all this kind of stuff, skip down a
  few sections.


                         

                             UUENCODED ARCHIVES


       If you specified to receive the file in UUENCODEd format, you need
  to uudecode the mail message into your account.

       First thing is to look at the text of the message to verify that it
  is indeed UUENCODEd.  Look for the first line in the file which says
  "begin xxxxxxxx".  This is the line which tells what the filename of the
  archive will be, after you uudecode it.  After that will be long lines
  of nonsense characters.  Return to the screen showing the list of
  messages, and make sure the highlight is on the big message from me.


         ELM users.

       1)  One thing to do (quick-and-easy) is to press "|" (for pipe),
  and type in "uudecode" (lower-case).  Most likely it will look like
  nothing at all happened, but it probably did.  Press "!" to execute a
  UNIX command (such as "ls -lA xxxxx" where xxxxx is the filename in the
  "begin" line), and verify that the file from me is there.

       2)  The other option is to press "s" to save the uuencoded message.
  Save it to a file like "v9t9.uue" or somesuch.  Then, exit ELM, and run
  "uudecode v9t9.uue".  Do "ls -lA xxxxxxx" (where xxxxxx is the filename
  in the "begin" line) to make sure the file was created properly.


         PINE users.

       The best thing to do under Pine is this: from the message list,
  press "o" for other options.  You should see an option "Export", which
  is activated with the "e" key.  (This is opposed to "Save", which is a
  little more complex.)  Press "e", and enter "v9t9.uue" as the filename.
  Then, exit Pine, and run "uudecode v9t9.uue".  Do "ls -lA xxxxxx" (where
  xxxxxx is the filename in the "begin" line) to make sure the file was
  created properly.

       
         Now go to the "TRANSFER" section.


                         

                MIME-encoded ARCHIVES (aka Pine Attachments)


       If you specified to receive the file in Pine's "attachment" format,
  it will be very easy.  Simply open your INBOX, locate my message, and
  press "v" to view it.  It will tell you that part of the message is
  text, and the other part is an attachment.  Read the text part for
  important information I may have added at the last minute.  Then move
  the bar over the attachment part, and press "s" to save the file to your
  account.


                         

                                  TRANSFER


       This is the tricky part, especially if you're new to Unix.  I
  suggest you get detailed information on file transfers from your
  system's administrator, since it is different from machine to machine.

       Some tips for transferring, though, to lessen common errors.

       With KERMIT, use this command line:

  unixcomputer:~> kermit -i -s xxxxxxx

       or, if using the command mode, enter "set file type binary" before
  transferring the file.


       If using ZMODEM and "sz", try the "-eb" options if your find the
  transfer is racking up a lot of errors.  If you have an old ZMODEM
  program in DOS, always use the "-b" option from UNIX, to assure that
  "sz" doesn't try to use ASCII mode.


       If using "ftp" to transfer files to a local machine in a computer
  lab, always enter "bin" to set the file type to binary.  PC-based FTP
  programs usually make ASCII the default mode.


       Please store the incoming archive right in your V9t9 directory.


  Ŀ
                  DECODING AND UNPACKING E-MAIL ORDERS 
  

       This only applies to e-mail orders.  Snail-mail orders are not
  encoded.

       Once the archive is on your PC, you need to decode it.  I encode e-
  mail archives with the keyword you specified to ensure that pirates
  don't steal it.  (This encoding is separate from the binary-to-ASCII
  encoding used to send  archives via e-mail.)

       Say you ordered 30 module dumps, and your keyword is "V9t9".
  (Don't use this keyword yourself, pleez.)  The archive I send you may be
  named V9t9MODS.PKG.  This is an encoded PKZIP-compatible archive.  You
  need to run UTILS\DECODE on the file to decode it:

  C:\V9t9> UTILS\DECODE V9t9MODS.PKG     V9t9MODS.ZIP     V9t9
                        ^^ encoded file  ^^ decoded file  ^^ your keyword
                           (source file)    (destination)

       DECODE won't be able to tell you if you entered the right keyword,
  so you'll need to remember it.  If you forget, contact me via e-mail.
  (See CONTACT.TXT.)

       To unpack the archive, run PKUNZIP on the file, and use the "-d"
  option.  This will put the files in the proper subdirectories:

  C:\V9t9> pkunzip -d V9t9MODS.ZIP

       If anything goes wrong, check this list:

         Be sure DECODE didn't die with an error.
         Be sure your keyword was correct (capitalization counts!!)
         Be sure you transferred the file from the UNIX system in BINARY
          mode.
         If you run PKZIPFIX on the file and you get *some* files, there
          was a transfer error.  Try transferring the archive again before
          contacting me to resend it.

       In each archive is a short README telling you how to use the new
  files with V9t9.


  
