home *** CD-ROM | disk | FTP | other *** search
/ Share Gallery 1 / share_gal_1.zip / share_gal_1 / UT / UT140B.ZIP / GOX.EXE / GO.DOC < prev    next >
Text File  |  1991-11-06  |  36KB  |  1,433 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.                                      GO!
  8.  
  9.  
  10.                       The Install-From-Diskette Program
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.                                 User's Manual
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.                               Copyright (C) 1991
  27.  
  28.  
  29.                                      and
  30.  
  31.  
  32.                              All Rights Reserved
  33.  
  34.  
  35.                                       by
  36.  
  37.  
  38.                             - PINNACLE SOFTWARE -
  39.                             Box 714, Airport Road
  40.                             Swanton Vermont 05488
  41.  
  42.                                 -------------
  43.                                 Legal Notices
  44.                                 -------------
  45.  
  46.  
  47. The  GO program and  related files  are distributed  using freeware/shareware
  48. concepts.   You  are entitled  to use  these programs  for free,  but certain
  49. restrictions apply.  Refer to  the section of this manual  entitled "Versions
  50. and Registration" for details.
  51.  
  52.  
  53. The following products  are mentioned in  this manual and are  trademarked or
  54. otherwise protected:
  55.  
  56.  
  57.    PRODUCT  For Information Contact
  58.    -------  -----------------------
  59.    ARC      System Enhancement Associates (SEA)
  60.    ARCE     Vernon Buerg, or System Enhancement Associates
  61.    COPYQM   Sydex
  62.    DIET     Teddy Matsumoto
  63.    FORMATQM Sydex
  64.    LHARC    Yoshi
  65.    LIST     Vernon Buerg
  66.    PKLITE   PKWare
  67.    PKUNZIP  PKWare
  68.  
  69.  
  70. Several  text  editor  programs are  mentioned  in this  manual.    These are
  71. trademarked or otherwise protected by their respective companies or authors.
  72.  
  73.  
  74.  
  75.  
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.                                       ii
  99.  
  100.                               -----------------
  101.                               Table of Contents
  102.                               -----------------
  103.  
  104.  
  105.  
  106. Legal Notices . . . . . . . . . . . . . . . . . . . . . . . . . . . . .    ii
  107.  
  108. Table of Contents . . . . . . . . . . . . . . . . . . . . . . . . . . .   iii
  109.  
  110. A Quick Overview of the GO Package  . . . . . . . . . . . . . . . . . . .   1
  111.  
  112. Basic Concepts  . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   2
  113.    What is GO?
  114.    How GO Works
  115.    Using GO
  116.    Optional Menu Lines
  117.    The "Information" Selection
  118.       Colorization Rules
  119.    The "Install" Selection
  120.  
  121. Changing the Dearchiving Method . . . . . . . . . . . . . . . . . . . . .   6
  122.    Doing it the Easy Way
  123.    Doing It the Hard Way
  124.  
  125. Intermediate Techniques . . . . . . . . . . . . . . . . . . . . . . . . .   7
  126.    Start-Up Parameters
  127.    Generating an Introductory Screen
  128.    Letting the User Choose His Viewing Method
  129.    Information and Install Menus
  130.       Menu Order
  131.  
  132. Advanced Techniques . . . . . . . . . . . . . . . . . . . . . . . . . . .   9
  133.    Using the .GO Extension of Text Files
  134.    The ;INST Command
  135.  
  136. The GO-COPY Program . . . . . . . . . . . . . . . . . . . . . . . . . .    10
  137.    What is GO-COPY?
  138.    The GO-COPY.COP File
  139.  
  140. The GO-DISKS Program  . . . . . . . . . . . . . . . . . . . . . . . . .    11
  141.    What is GO-DISKS?
  142.    GO-COPY and GO-DISKS Samples
  143.  
  144. Using GO in Batch Files . . . . . . . . . . . . . . . . . . . . . . . .    12
  145.    What is GO-MENU?
  146.    Using GO -D With GO-Menu
  147.    The GO.HDG File
  148.  
  149. Hints and Tips  . . . . . . . . . . . . . . . . . . . . . . . . . . . .    14
  150.    Specifying GO-COPY File Names
  151.    Renaming Copy Files
  152.  
  153.  
  154.  
  155.  
  156.                                      iii
  157.  
  158. Other Programs Included with GO . . . . . . . . . . . . . . . . . . . .    15
  159.    SEE
  160.    GO_SMALL
  161.    READING
  162.    SETERR
  163.    WAITBLK
  164.  
  165. Versions and Registration . . . . . . . . . . . . . . . . . . . . . . .    17
  166.    Changes Between Versions
  167.    Free Usage of GO Programs
  168.    Ordering Upgrades to GO
  169.       Standard Discount
  170.    Thank-You
  171.  
  172. Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .    19
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.  
  206.  
  207.  
  208.  
  209.  
  210.  
  211.  
  212.  
  213.  
  214.                                       iv
  215.  
  216.                       ----------------------------------
  217.                       A Quick Overview of the GO Package
  218.                       ----------------------------------
  219.  
  220.  
  221. The GO package includes the following programs:
  222.  
  223.  
  224. GO
  225.  
  226.    Place this program on any diskette you send  out which contains compressed
  227.    archive files  (e.g. .ZIP or .LZH).  The GO program will make installation
  228.    easy.  This is especially important if you send disks to computer novices.
  229.    GO can also display information, or print out a reply form.
  230.  
  231.  
  232. GO-COPY
  233.  
  234.    This program makes it possible for computer novices to copy selected files
  235.    from  your disk  onto  another  diskette.   This  is handy  if  you are  a
  236.    shareware  author, since  you  want to  make your  software  easy to  pass
  237.    around.
  238.  
  239.  
  240. GO-DISKS
  241.  
  242.    This program reads in a  list of file names,  then copies those files to  
  243.    diskettes.  Since the files are kept in RAM during the copy, you can mass-
  244.    produce disks much more quickly than if you were using the COPY command.
  245.  
  246.  
  247. GO-MENU
  248.  
  249.    This program is used in a batch file  to present a menu of up to 10 items.
  250.    This  is ideal  for  organizing a  diskette  containing several  unrelated
  251.    programs.
  252.  
  253.  
  254. The package also includes these small utility programs:
  255.  
  256.    SEE         File viewer/printer
  257.    GO_SMALL    A compressed but fully functional version of GO.EXE
  258.    READING     Places the message "Reading disk..." on the screen
  259.    SETERR      Sets the DOS Errorlevel
  260.    WAITBLK     Waits for a blank diskette in the indicated drive
  261.  
  262.  
  263. Each of these programs are described in more detail later.
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.  
  272.                                       1
  273.  
  274.                                 --------------
  275.                                 Basic Concepts
  276.                                 --------------
  277.  
  278.  
  279.  
  280. What is GO?
  281. -----------
  282.  
  283.  
  284. "GO"  is a simple  "shell" for "dearchiving programs"  such as PKUNZIP, ARCE,
  285. LHARC and so on.  GO is a very specialized shell.  You use it for ONE purpose
  286. only:  distribution of software via diskette.
  287.  
  288. If you've ever given a  computer novice a diskette with an archived file, you
  289. know the routine:
  290.  
  291.    "Okay, you put the diskette in the drive, then type PKUNZIP followed by
  292.    the root name of the  zip and then the name of the directory it's going
  293.    to, unless you're there  already ... and don't  forget to separate  the
  294.    parameters with spaces!"
  295.  
  296. The usual comment after such an explanation is:
  297.  
  298.                   "Can't you make it any easier that that?"
  299.  
  300. Thanks to GO ... you can!
  301.  
  302.  
  303.  
  304. How GO Works
  305. ------------
  306.  
  307.  
  308. NOTE: In  this manual, we refer to archive files as ZIP files.  The shareware
  309.       version  of GO is initially  configured to dearchive  files produced by
  310.       PKWare's  PKZIP program,  but it can  also work  with ARC,  PAK, ZOO or
  311.       other  archive  formats.   We  ourselves  use  the  LZH  format on  our
  312.       distribution diskettes.
  313.  
  314. When you're preparing a diskette for somebody, copy one or more ZIP files (up
  315. to a maximum of 9) onto the diskette, plus the  dearchiving program, plus the
  316. file GO.EXE.  Then write a short explanation on the diskette label:
  317.  
  318.                   Put this diskette in the A: drive
  319.                   At the DOS prompt enter the command A:GO
  320.  
  321. If you know that  the user uses a DOS shell menu, you  may have to alter your
  322. explanation slightly.
  323.  
  324. If the user follows those simple instructions, he will be able to install the
  325. ZIP files that are located on the diskette.
  326.  
  327. The user does require a  certain bare minimum level of knowledge, though.  He
  328. must be familiar with terms like Drive A:, File, and Directory.
  329.  
  330.                                       2
  331.  
  332.  
  333.  
  334. Using GO
  335. --------
  336.  
  337.  
  338. When the user types A:GO (or B:GO if appropriate) he is presented with a very
  339. simple menu that offers him the following three choices:
  340.  
  341.                                Information
  342.                                Install
  343.                                Quit
  344.  
  345. He can select an option either with function keys or by using the  arrow keys
  346. and Enter.
  347.  
  348. <Information> displays a text file  on the diskette.  If there are  more than
  349. one text file, he is presented with a menu.
  350.  
  351. <Install>  suggests  a  directory name  (which  the  user  can change),  then
  352. dearchives  the program  into that  directory.   If there  are more  than one
  353. archive file, he is first presented with a menu.
  354.  
  355.  
  356.  
  357. Optional Menu Lines
  358. -------------------
  359.  
  360.  
  361. The  GO menu  sometimes  shows  more than  the  three items  mentioned  (i.e.
  362. Information, Install and Quit).  The following two items may also appear:
  363.  
  364.                              About "GO"
  365.                              Print reply form
  366.  
  367. <About  "GO"> appears  on all  unregistered copies  of GO.   If  you order  a
  368. personalized copy  of GO ($16 +  $3 S&H), this advertisement  will disappear.
  369. (Personalized copies also replace our copyright notice  on the main menu with
  370. the text of your choice.)
  371.  
  372. <Print reply  form> appears  only  if the  file  GO-FORM.DAT appears  on  the
  373. diskette.   GO-FORM.DAT is a text  file that can be  prepared on any standard
  374. DOS text editor.
  375.  
  376.  
  377.  
  378. The "Information" Selection
  379. ---------------------------
  380.  
  381.  
  382. GO's Information section is  designed exclusively for  small text files.   If
  383. you   want  to  provide  the  user  with  extensive  documentation  prior  to
  384. installation,  we  recommend that  you  purchase  Pinnacle Software's  HELPME
  385. program ($15) or (as a  quick alternative) use the SEE program  provided with
  386. GO.
  387.  
  388.                                       3
  389.  
  390. A "text file" is any file with an extension of TXT, LST, or S-D.
  391.  
  392. The  Information section  is appropriate  for displaying  one or  two screens
  393. containing important information such as:
  394.  
  395.               A brief description of what's on the disk
  396.               How the user can obtain help if he gets stuck
  397.  
  398. If  the user  is  viewing the  text  on a  color monitor,  the  text will  be
  399. displayed in various colors, according to some simple rules.
  400.  
  401.  
  402.  
  403. Colorization Rules
  404.  
  405.  
  406. If the viewer is using monochrome or MODE BW80, all text is the same color.
  407. Otherwise...
  408.  
  409.  
  410.        IF THE LINE CONTAINS         THE COLOR IS
  411.        --------------------         ------------
  412.        Regular text                 LightGreen       unless...
  413.        Four spaces in a row         Yellow           unless...
  414.        All uppercase                LightMagenta     unless...
  415.        Characters over ASCII 128    LightCyan        unless...
  416.        ;NEW or ASCII 12 in col. 1   White on Blue
  417.  
  418.  
  419. NOTE:  ASCII 12 (CTRL-L i.e. Form Feed) causes a new screen to be displayed. 
  420. All  text   editors  have   a  method   for  inserting  control   characters.
  421. WordStar-style editors (QEdit,  Turbo Pascal Editor, etc.)  can insert Ctrl-L
  422. with the keystroke sequence Ctrl-P Ctrl-L.  If you can not type a CTRL-L, you
  423. can type ;NEW instead.  The advantage of using CTRL-L is that it will cause a
  424. page-eject if the document is printed out.
  425.  
  426. Of  course, this  colorization technique  is not  as powerful  as using  ANSI
  427. displays,  but it allows the  more advanced user  to view or  print the files
  428. using whatever method he prefers.  Also, these colorization rules let you use
  429. a regular  text file,  are easily memorized,  and generally  create a  fairly
  430. attractive display.
  431.  
  432.  
  433.  
  434.  
  435.  
  436.  
  437.  
  438.  
  439.  
  440.  
  441.  
  442.  
  443.  
  444.  
  445.  
  446.                                       4
  447.  
  448. The "Install" Selection
  449. -----------------------
  450.  
  451.  
  452. NOTE: The "Install" selection appears on the main  GO menu only if GO sees an
  453.       archive file that uses the format it is configured for (e.g. a ZIP file
  454.       if GO is configured to use PKUNZIP, ARC for ARCE, etc.)
  455.  
  456. When  the user selects "Install"  from the main GO menu,  the archive file on
  457. the diskette is installed in a directory with the same name.  (The user has a
  458. chance to change the name of the directory, however.)
  459.  
  460. If there is more than  one archive file, the  user is first presented with  a
  461. menu.
  462.  
  463. Remember to  put a copy  of the dearchiving  program on the diskette,  or the
  464. installation step will display an error message.  (In such case, GO will scan
  465. the  user's  PATH for  a  copy  of  the  dearchiving  program,  but  it  will
  466. nevertheless caution  him that it expected  to find a  dearchiving program on
  467. the  diskette.   This  forewarns the  user  that problems  may  occur if  his
  468. dearchiver is obsolete.)
  469.  
  470. After the  installation is  complete, GO  looks in the  directory for  a file
  471. named READ.ME.  If  it finds it, it displays it.  If  it can't find a READ.ME
  472. file, it displays the first  DOC file in the directory.  GO  then returns the
  473. user to DOS (or the DOS shell).
  474.  
  475. Thus,  your READ.ME should tell  the user what  to do next (how  to start the
  476. program, usually).
  477.  
  478. If your installation  is fancy  (i.e. requires dearchiving  the archive  file
  479. into  several different  directories),  you could  place  the directories  in
  480. separate archive files.  A  better solution is to order a  customized version
  481. of GO, or to modify the dearchiving parameters.  The method for doing this is
  482. explained in the next section.
  483.  
  484. See also "The ;INST Command" in "Advanced Techniques".
  485.  
  486.  
  487.  
  488.  
  489.  
  490.  
  491.  
  492.  
  493.  
  494.  
  495.  
  496.  
  497.  
  498.  
  499.  
  500.  
  501.  
  502.  
  503.  
  504.                                       5
  505.  
  506.                        -------------------------------
  507.                        Changing the Dearchiving Method
  508.                        -------------------------------
  509.  
  510.  
  511.  
  512. Doing it the Easy Way
  513. ---------------------
  514.  
  515.  
  516. When you order a registered copy of GO from Pinnacle Software, you may ask us
  517. to change the dearchiving method.   Please remember to cite the  precise name
  518. of the program that does the dearchiving, the extension of  the archive files
  519. that it handles,  and the command-line parameters it requires.  (If possible,
  520. send us a copy of the program so we can test it.)
  521.  
  522. There is no extra charge for this service.
  523.  
  524.  
  525.  
  526. Doing It the Hard Way
  527. ---------------------
  528.  
  529.  
  530. If you're an experienced programmer, you  can use a program such as DEBUG  to
  531. "zap" in  the name of the dearchiving program.   You can find the text string
  532. near the end of  the GO.EXE file.  The byte just prior to the string dictates
  533. the length of the string.
  534.  
  535. The string  following the  file name  contains the extension  of the  archive
  536. files (e.g. ZIP).  This should be changed if appropriate -- be sure to change
  537. the length byte if different.
  538.  
  539. The  next  string (ten  characters)  contains the  parameter  to pass  to the
  540. dearchiver.  (Some dearchivers, such as PKUNZIP, don't need a parameter)
  541.  
  542. EXAMPLE:  CHANGING FROM PKUNZIP TO LHA
  543.  
  544. Original   0B 50 4B 55 4E 5A 49 50 2E 45 58 45 00 00 03 5A .PKUNZIP.EXE...Z
  545. Hex/ASCII  49 50 00 00 00 00 00 00 00 00 00 00 00 00 0B 00 IP..............
  546.  
  547. Modified   07 4C 48 41 52 43 2E 45 58 45 00 00 00 00 03 4C .LHA.EXE.......L
  548. Hex/ASCII  5A 48 01 65 00 00 00 00 00 00 00 00 00 00 00 00 ZH.e............
  549.  
  550.  
  551.  
  552.  
  553.  
  554.  
  555.  
  556.  
  557.  
  558.  
  559.  
  560.  
  561.  
  562.                                       6
  563.  
  564.                            -----------------------
  565.                            Intermediate Techniques
  566.                            -----------------------
  567.  
  568.  
  569.  
  570. Start-Up Parameters
  571. -------------------
  572.  
  573.  
  574. If  you know that the user has a monochrome monitor but a color display card,
  575. advise him that he can improve legibility by starting up GO as follows:
  576.  
  577.                                     GO M
  578.  
  579.  
  580. For more information about start-up parameters, start GO as follows:
  581.  
  582.                                     GO ?
  583.  
  584.  
  585. An  additional  start-up parameter  (the -D  parameter)  is described  in the
  586. section of this manual entitled "GO-MENU".
  587.  
  588.  
  589.  
  590. Generating an Introductory Screen
  591. ---------------------------------
  592.  
  593.  
  594. If you want your  user to see some text  even before the main menu  shows up,
  595. place the text in a file named 'GO-STRT.DAT'.
  596.  
  597.  
  598. This is good  place to put personal notes or  special instructions that apply
  599. only to the  recipient of the diskette.  The personal note in particular is a
  600. "nice  touch" that your users may appreciate;  most people don't expect to be
  601. greeted by name when they run the installation program!
  602.  
  603.  
  604.  
  605. Letting the User Choose His Viewing Method
  606. ------------------------------------------
  607.  
  608.  
  609. When designing GO-viewable screens, bear in mind that the user  may decide to
  610. view the  file with another viewer, such as LIST,  SEE or HELPME.  Thus, even
  611. though you may be tempted to do this:
  612.  
  613.  
  614.                         End of screen 1
  615.                         <CTRL-L>Heading of Screen 2
  616.                         Text of screen 2
  617.  
  618.  
  619.  
  620.                                       7
  621.  
  622. ... you should leave at least one empty line in front of the heading:
  623.  
  624.  
  625.                         End of screen 1
  626.  
  627.                         <CTRL-L>Heading of Screen 2
  628.                         Text of screen 2
  629.  
  630.  
  631. Similarly, if  you know that  the file is likely  to be printed,  avoid using
  632. line-drawing and other special characters.
  633.  
  634.  
  635.  
  636. Information and Install Menus
  637. -----------------------------
  638.  
  639.  
  640. Information and  install menus pop up only when there  are more than one file
  641. of the appropriate type.
  642.  
  643. For example, if you  had one ZIP file, it would be  picked automatically when
  644. the user selects <Install>  from the Main Menu.  However,  if there were more
  645. than one ZIP file, the user would be presented with a menu.
  646.  
  647.  
  648.  
  649. Menu Order
  650.  
  651.  
  652. The text menu is sorted by extension according to the following order:
  653.  
  654.                                TXT   LST   S-D
  655.  
  656. If you have several  files with one extension, they appear in  the same order
  657. that is shown in the listing obtained with the DOS DIR command.
  658.  
  659. If you want to modify the  list of extensions, provide us with your  required
  660. list  when  you  register  GO  and we'll  modify  your  copy  of  the program
  661. accordingly.  There is no extra charge for this service.
  662.  
  663. If you want to  modify the list yourself, you  will find it located  near the
  664. end  of the  EXE file.   The string is  20 characters long.   For information
  665. about  such alterations, refer  to the  section entitled  "Doing It  the Hard
  666. Way".
  667.  
  668. The  install menu lists  the files  in the order  they appear in  the listing
  669. obtained with the DOS DIR command.
  670.  
  671.  
  672.  
  673.  
  674.  
  675.  
  676.  
  677.  
  678.                                       8
  679.  
  680.                              -------------------
  681.                              Advanced Techniques
  682.                              -------------------
  683.  
  684.  
  685.  
  686. Using the .GO Extension of Text Files
  687. -------------------------------------
  688.  
  689.  
  690. As mentioned earlier, the "Information" option  of the main GO menu scans for
  691. these extensions:
  692.  
  693.                                TXT   LST   S-D
  694.  
  695. GO also looks to see if you have any files with the .GO extension.  These are
  696. treated like  other text files,  except that  the first line  of the  file is
  697. displayed on the Information menu, instead of the file name.
  698.  
  699. When  the user selects the file from  the Information menu, the first line of
  700. the file (the one that appeared on the Information menu) is NOT displayed.
  701.  
  702.  
  703.  
  704. The ;INST Command
  705. -----------------
  706.  
  707.  
  708. If the last line of a .GO file is:
  709.  
  710.    ;INST
  711.  
  712. the user will be asked (after viewing the final screen of information):
  713.  
  714.    Do you want to install this now?  (Y n)
  715.  
  716. If  they press Y, the product is installed  immediately.  This saves them the
  717. trouble of going back to the main menu and then selecting "Install".
  718.  
  719.  
  720.  
  721.  
  722.  
  723.  
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730.  
  731.  
  732.  
  733.  
  734.  
  735.  
  736.                                       9
  737.  
  738.                              -------------------
  739.                              The GO-COPY Program
  740.                              -------------------
  741.  
  742.  
  743.  
  744. What is GO-COPY?
  745. ----------------
  746.  
  747.  
  748. GO-COPY processing lets the user copy selected files to another diskette.
  749.  
  750. If GO sees  the files GO-COPY.EXE  and GO-COPY.COP on  the diskette, it  will
  751. read the first  line of  GO-COPY.COP and display  that on  the main GO  menu.
  752. When the user selects this item, the program GO-COPY.EXE is called.
  753.  
  754. GO-COPY copies  files from the diskette to another diskette.  The files to be
  755. copied are specified in the file GO-COPY.COP (described later).
  756.  
  757. All  files to  be copied  are first  read into  RAM, in  order to  make rapid
  758. duplication possible.  This  places a limit on the size of the copy task.  GO
  759. and GO-COPY take  up around 120K, so you  need around 500K of free  memory to
  760. copy a full 360K disk.
  761.  
  762. If there is not enough RAM, the user is advised to remove TSRs, or to run GO-
  763. COPY directly (since GO is not loaded, this saves about 70K).
  764.  
  765.  
  766.  
  767. The GO-COPY.COP File
  768. --------------------
  769.  
  770.  
  771. GO-COPY.COP is a text file.  It has the following format:
  772.  
  773.  
  774.                  ┌─────────────────────────────────────────┐
  775.                  │ Text to appear on the main GO menu      │
  776.                  │ File name                               │
  777.                  │ File name                               │
  778.                  │ :                                       │
  779.                  │ :                                       │
  780.                  │ END                                     │
  781.                  │ Text to be displayed prior to copy task │
  782.                  │ :                                       │
  783.                  │ :                                       │
  784.                  └─────────────────────────────────────────┘
  785.  
  786.  
  787. Up to  50 files can be  copied by GO-COPY.  The  end of the list  of files is
  788. indicated by the word END.  Wildcards are permitted (e.g. *.EXE).
  789.  
  790. The display text is  shown according to the standard display and colorization
  791. rules described in "Basic GO Techniques".
  792.  
  793.  
  794.                                       10
  795.  
  796.                              --------------------
  797.                              The GO-DISKS Program
  798.                              --------------------
  799.  
  800.  
  801.  
  802. What is GO-DISKS?
  803. -----------------
  804.  
  805.  
  806. GO-DISKS processing is just like GO-COPY processing, but  is designed for the
  807. software developer rather  than the end user.  Instead of asking you to press
  808. a key to continue, GO-DISKS monitors the status of the diskette drive.
  809.  
  810. GO-DISKS is useful when you need to create dozens of copies of the same disk.
  811. Since the copies are performed from RAM, you can create the disks faster than
  812. usual.
  813.  
  814. The  data for GO-DISKS is  kept in the text file  GO-DISKS.DSK.  You may also
  815. pass the name of the file on the command line.  The format of GO-DISKS.DSK is
  816. the same as for the GO-COPY.COP file.
  817.  
  818.  
  819.    IMPORTANT NOTE:   GO-DISKS  requires   an  AT-class  (or
  820.                      higher) computer.  It will not work on
  821.                      most XT- or PC-class machines.
  822.  
  823.    NOTE:             If you find GO-DISKS  useful, you might also
  824.                      consider  trying  out  the   COPYQM  program
  825.                      created by Sydex Inc.   We ourselves use the
  826.                      FORMATQM program, also by Sydex.
  827.  
  828.  
  829.  
  830. GO-COPY and GO-DISKS Samples
  831. ----------------------------
  832.  
  833.  
  834. The original GO  package includes sample GO-DISKS.DSK and  GO-COPY.COP files.
  835. In order to try these out, enter
  836.  
  837.    GO-COPY
  838.  
  839. or
  840.  
  841.    GO-DISKS
  842.  
  843. at the DOS prompt.
  844.  
  845.  
  846.  
  847.  
  848.  
  849.  
  850.  
  851.  
  852.                                       11
  853.  
  854.                            -----------------------
  855.                            Using GO in Batch Files
  856.                            -----------------------
  857.  
  858.  
  859.  
  860. NOTE: For  an example  of using  GO-MENU with  GO, order  our Maxi-Collection
  861.       Diskette for only $3.  A  1.44 Meg diskette drive is required  for this
  862.       special offer,  which brings you 3 megabytes of archived shareware.
  863.  
  864.  
  865.  
  866. What is GO-MENU?
  867. ----------------
  868.  
  869.  
  870. The GO-MENU  program is used in  a batch file to  present a menu of  up to 10
  871. items.  This is ideal for organizing a diskette containing several  unrelated
  872. programs, but can be used in any batch file application.
  873.  
  874. GO-MENU reads  the contents of the menu from an ordinary text file containing
  875. ten lines, corresponding to the F1, F2 ... F10 lines on the menu.
  876.  
  877. The command line format for GO-MENU is:
  878.  
  879.    GO-MENU <menu file>
  880.  
  881. For example:
  882.  
  883.    GO-MENU MYMENU.MNU
  884.  
  885. For a sample menu definition, refer  to the file GO-MENU.MNU, included in the
  886. GO  package.  It  shows also how  lines beginning  with a semi-colon  (;) are
  887. ignored as comments.
  888.  
  889.  
  890.  
  891. Using GO -D With GO-Menu
  892. ------------------------
  893.  
  894.  
  895. The GO program has a special command line parameter designed to work with GO-
  896. MENU.  Normally, when you call GO, it will  look in its home directory for an
  897. archive file.  Thus,  if the user is on the C: drive  when they type A:GO, it
  898. will look on the A: drive.
  899.  
  900. The -D parameter, however, tells GO  to look in the current directory.   This
  901. lets you use a single copy  of GO to support many directories.   For example,
  902. your batch file might look like this:
  903.  
  904.  
  905.  
  906.  
  907.  
  908.  
  909.  
  910.                                       12
  911.  
  912.    ECHO OFF
  913.    REM Batch file placed in the root directory of the diskette
  914.    A:
  915.    :AGAIN
  916.    CLS
  917.    CD \
  918.    GO-MENU MAXI.MNU
  919.    IF ERRORLEVEL 4 CD \GAMES
  920.    IF ERRORLEVEL 5 CD \MISC
  921.    CLS
  922.    \GO.EXE -D
  923.    IF ERRORLEVEL 10 GOTO END
  924.    GOTO AGAIN
  925.    :END
  926.  
  927.  
  928. The line:
  929.  
  930.    \GO.EXE -D
  931.  
  932. Executes  the GO program  in the root  directory.  The  -D parameter, though,
  933. tells it to look for archives in the current directory.
  934.  
  935. Note also the line:
  936.  
  937.    IF ERRORLEVEL 10 GOTO END
  938.  
  939. If  GO  ends because  a  program  was just  installed,  it will  set  the DOS
  940. Errorlevel to 10.  This lets you break out of the batch file.
  941.  
  942. The batch file above  is simplified for clarity.  A  more complete batch file
  943. is presented on our Maxi-Collection diskette.
  944.  
  945.  
  946.  
  947. The GO.HDG File
  948. ---------------
  949.  
  950.  
  951. NOTE: In order  to protect our copyright,  we restrict the use  of the GO.HDG
  952.       file to registered copies of GO.
  953.  
  954.  
  955. In the  sample batch file shown  previously, the user good  "navigate" to the
  956. \GAMES  and \MISC directories.  It would be  nice if, when the GO program was
  957. called,  it would replace the title line  (which is normally just a copyright
  958. message) with a title like:  GAMES SECTION, or MISCELLANEOUS PROGRAMS.
  959.  
  960. If GO sees a  standard text file named GO.HDG  in the directory, it  will use
  961. first line from the file as the title of the main menu screen.
  962.  
  963. By using a combination of GO-MENU, GO -D and GO.HDG, you can create a "guided
  964. tour" of all your software products!
  965.  
  966.  
  967.  
  968.                                       13
  969.  
  970.                                 --------------
  971.                                 Hints and Tips
  972.                                 --------------
  973.  
  974.  
  975.  
  976. Specifying GO-COPY File Names
  977. -----------------------------
  978.  
  979.  
  980. When you specify  files in GO-COPY.COP, don't include the  drive letter.  For
  981. example, if you list a file like this:
  982.  
  983.    A:\DATA\INVOICE.DAT
  984.  
  985. GO-COPY  will  always look  at  the A:  drive  for that  directory  and file.
  986. However, if you specify it this way:
  987.  
  988.    \DATA\INVOICE.DAT
  989.  
  990. GO-COPY will look on whatever  drive GO-COPY itself is  on.  This is  usually
  991. the A: drive, but this will let the user run GO-COPY from any drive.
  992.  
  993.  
  994.  
  995. Renaming Copy Files
  996. -------------------
  997.  
  998.  
  999. The files  listed in GO-COPY.COP or GO-DISKS.DSK can be copied to a file with
  1000. a  different name.  Simply specify the new  name after the name of the source
  1001. file.  For example:
  1002.  
  1003.    \MYPROG\TEST.EXE PROGRAM.EXE
  1004.  
  1005. This feature  can not be  used with  wildcards.  For  example, the  following
  1006. lines would NOT be valid:
  1007.  
  1008.    \BAD\*.EXE NAUGHTY.EXE
  1009.  
  1010.    \BAD\*.DOG *.CAT
  1011.  
  1012.  
  1013.  
  1014.  
  1015.  
  1016.  
  1017.  
  1018.  
  1019.  
  1020.  
  1021.  
  1022.  
  1023.  
  1024.  
  1025.  
  1026.                                       14
  1027.  
  1028.                        -------------------------------
  1029.                        Other Programs Included with GO
  1030.                        -------------------------------
  1031.  
  1032.  
  1033.  
  1034. The following  programs are also included  with GO.   We've found them  to be
  1035. quite  useful in  packaging  software.    Please  see  the  section  entitled
  1036. "Versions and Registration"  for information about the  distribution of these
  1037. programs.
  1038.  
  1039.  
  1040.  
  1041. SEE
  1042. ---
  1043.  
  1044.  
  1045. The  SEE  program displays  (and optionally  prints) a  text  file.   We have
  1046. included it as a document viewer for this manual.  You may find it useful for
  1047. your own applications.
  1048.  
  1049. The format for SEE is:
  1050.  
  1051.    SEE <file name>
  1052.  
  1053. For example:
  1054.  
  1055.    SEE MYFILE.TXT
  1056.  
  1057. For complete instructions, enter this command:
  1058.  
  1059.    SEE /?
  1060.  
  1061. SEE is a freeware program.  A more sophisticated shareware file viewer is the
  1062. LIST program created by Vernon Buerg, which we recommend highly.  Contact Mr.
  1063. Buerg for licensing details.
  1064.  
  1065.  
  1066.  
  1067. GO_SMALL
  1068. --------
  1069.  
  1070.  
  1071. This is a compressed  copy of the GO.EXE program.  We  recommend that you use
  1072. an EXE file compressor before you put your copy of GO onto the diskette; this
  1073. leaves more  room  for  software.    If you  don't  have  access  to  an  EXE
  1074. compressor, you can copy GO_SMALL.EXE to your diskette as GO.EXE.
  1075.  
  1076. GO_SMALL  is a  copy of  GO.EXE that  was compressed  with the  DIET program.
  1077. Since it is  compressed, you can  not modify it  as described in the  section
  1078. "Doing it  the Hard Way".   If you want  to apply modifications, you  must do
  1079. them to an uncompressed copy of GO.EXE.
  1080.  
  1081. Another popular EXE compressor is PKLITE from PKWare.
  1082.  
  1083.  
  1084.                                       15
  1085.  
  1086.  
  1087. READING
  1088. -------
  1089.  
  1090.  
  1091. The READING.EXE program displays  the message "Reading Disk...".   This gives
  1092. the  user something to  look at while  jumping from  place to place  in batch
  1093. files, which are notoriously slow when run from diskettes.
  1094.  
  1095.  
  1096.  
  1097. SETERR
  1098. ------
  1099.  
  1100.  
  1101. SETERR sets the DOS Errorlevel to the specified number.   The format for this
  1102. command is:
  1103.  
  1104.    SETERR <number>
  1105.  
  1106. For example:
  1107.  
  1108.    SETERR 25
  1109.  
  1110. SETERR is used in batch files.
  1111.  
  1112.  
  1113.  
  1114. WAITBLK
  1115. -------
  1116.  
  1117.  
  1118. The  WAITBLK  program  is  a batch-file  utility  which  lets  you  create an
  1119. alternative to GO-DISKS  processing (described earlier).   WAITBLK will  wait
  1120. for a blank diskette to be inserted into the specified drive.
  1121.  
  1122. For details, enter the DOS command:  WAITBLK ?
  1123.  
  1124. WAITBLK is not compatible with XT and PC machines.
  1125.  
  1126.  
  1127.  
  1128.  
  1129.  
  1130.  
  1131.  
  1132.  
  1133.  
  1134.  
  1135.  
  1136.  
  1137.  
  1138.  
  1139.  
  1140.  
  1141.  
  1142.                                       16
  1143.  
  1144.                           -------------------------
  1145.                           Versions and Registration
  1146.                           -------------------------
  1147.  
  1148.  
  1149.  
  1150. Changes Between Versions
  1151. ------------------------
  1152.  
  1153.  
  1154. If  you're curious about what has changed between  versions, or if you have a
  1155. problem and  think it might be caused by an upgrade incompatibility, refer to
  1156. the version history file by entering the following command at the DOS prompt:
  1157.  
  1158.    SEE CHANGE.LOG
  1159.  
  1160.  
  1161.  
  1162. Free Usage of GO Programs
  1163. -------------------------
  1164.  
  1165.  
  1166. You are  entitled to  use the GO  program to distribute  your software.   You
  1167. don't have to pay  a penny for the privilege!   For full details, run  the GO
  1168. program  that  comes  with  this  package  and  review  the  article  in  the
  1169. Information section entitled "How to Register Your Copy of GO".
  1170.  
  1171. Why do we allow people to use our program without paying for it?  Because all
  1172. unregistered copies of GO contain our advertising screen (i.e. the "About GO"
  1173. selection on  the main menu).  Thus, by passing around unregistered copies of
  1174. GO, you are helping us advertise.  Everybody wins!
  1175.  
  1176. As for the programs GO-DISKS,  GO-COPY, GO-MENU, you are welcome to  use them
  1177. without registering, but only in conjunction with our GO program.  That is to
  1178. say, you  may not  distribute a  diskette  containing one  of these  programs
  1179. unless:
  1180.  
  1181.    (A) You are a registered owner of GO, or ...
  1182.    (B) An unregistered GO program also appears on diskette.
  1183.  
  1184. The programs  SEE, READING, SETERR and  WAITBLK may be sold,  traded or given
  1185. away, but may not be modified in any way.
  1186.  
  1187.  
  1188.  
  1189. Ordering Upgrades to GO
  1190. -----------------------
  1191.  
  1192.  
  1193. If  you have  already registered a  copy of GO  and would like  to register a
  1194. newer version, all further GO  orders are available from Pinnacle at  25% off
  1195. the prices indicated on the order form.  
  1196.  
  1197.  
  1198.  
  1199.  
  1200.                                       17
  1201.  
  1202. Standard Discount
  1203.  
  1204.  
  1205. If you have registered more than $40 worth of software from Pinnacle, you are
  1206. entitled to $10  off any  future single-product registration  priced at  over
  1207. $40.
  1208.  
  1209.  
  1210.  
  1211. Thank-You!
  1212. ----------
  1213.  
  1214.  
  1215. If  you're trying  GO for  the first time,  we'd like  to thank  you for your
  1216. interest in our product, and for taking the time to evaluate it.
  1217.  
  1218. If you're  a registered owner,  or you're planning  on ordering  a registered
  1219. copy, we thank you  for supporting the  shareware concept; it's your  support
  1220. that  makes  it  possible   for  shareware  authors  to   continue  producing
  1221. affordable, quality software!
  1222.  
  1223.  
  1224.  
  1225.  
  1226.  
  1227.  
  1228.  
  1229.  
  1230.  
  1231.  
  1232.  
  1233.  
  1234.  
  1235.  
  1236.  
  1237.  
  1238.  
  1239.  
  1240.  
  1241.  
  1242.  
  1243.  
  1244.  
  1245.  
  1246.  
  1247.  
  1248.  
  1249.  
  1250.  
  1251.  
  1252.  
  1253.  
  1254.  
  1255.  
  1256.  
  1257.  
  1258.                                       18
  1259.  
  1260.                                     -----
  1261.                                     Index
  1262.                                     -----
  1263.  
  1264.                Can't find it here?  Try the Table of Contents.
  1265.  
  1266.  
  1267. .GO  9
  1268. ;INST  5, 9
  1269. ;NEW  4
  1270. A:  2, 3, 12, 14
  1271. About "GO"  3
  1272. Advertising  17
  1273. ANSI  4
  1274. ARC  ii, 5
  1275. ARCE  ii, 2, 5
  1276. Archive  2, 5, 12
  1277. Arrow keys  3
  1278. ASCII  4
  1279.    12  4
  1280. AT  11
  1281. Author  1
  1282. B:  3
  1283. Batch  1, 12, 13, 16
  1284. Blank  1
  1285. Buerg  ii, 15
  1286. BW80  4
  1287. C:  12
  1288. CHANGE.LOG  17
  1289. Color  4, 7
  1290. Command-line  6
  1291. Comment  12
  1292. Compress  1, 15
  1293. Compressor  15
  1294. COP  10
  1295. Copy  1, 10
  1296. COPYQM  ii, 11
  1297. Copyright  1, 3, 13
  1298. Ctrl-L  4
  1299. Ctrl-P  4
  1300. Curious  17
  1301. Dearchive  3
  1302. Dearchiving  2
  1303. Dearchiving Method  6
  1304. Dearchiving program  5
  1305. DEBUG  6
  1306. DIET  ii, 15
  1307. DIR  8
  1308. Directory  2, 3, 5, 12
  1309. Discount  18
  1310. Diskette  1, 2, 11
  1311. Distribution  2
  1312. DOC  5
  1313. Documentation  3
  1314. DOS
  1315.  
  1316.                                       19
  1317.  
  1318.    Errorlevel  1, 13, 16
  1319.    Shell  2, 5
  1320. Drive  2, 11, 12, 14
  1321. Easier  2
  1322. END  10
  1323. Enter  3
  1324. Errorlevel  1, 13, 16
  1325. EXE  8, 15
  1326. File  2
  1327. File name  9
  1328. Form Feed  4
  1329. FORMATQM  ii, 11
  1330. Free  17
  1331. Freeware  ii
  1332. Function keys  3
  1333. GO  1, 2, 12
  1334. GO.EXE  6, 15
  1335. GO.HDG  13
  1336. GO-COPY  1, 10, 11, 17
  1337. GO-COPY.COP  10, 14
  1338. GO-DISKS  1, 11, 16, 17
  1339. GO-DISKS.DSK  11, 14
  1340. GO-FORM.DAT  3
  1341. GO-MENU  1, 12
  1342. GO-MENU.MNU  12
  1343. GO-STRT.DAT  7
  1344. GO_SMALL  1, 15, 17
  1345. Guided tour  13
  1346. Help  4
  1347. HELPME  3, 7
  1348. Incompatibility,  17
  1349. Information  3, 8, 9
  1350. INST  5, 9
  1351. Install  2, 3, 5, 8, 9
  1352. LHARC  ii, 2
  1353. Line-drawing  8
  1354. LIST  ii, 7, 15
  1355. LST  4, 8, 9
  1356. LZH  1, 2
  1357. Main menu  3, 5, 7, 9, 10, 13, 17
  1358. Matsumoto  ii
  1359. Maxi-Collection  12, 13
  1360. Menu  1, 3, 5, 8, 12
  1361. MODE  4
  1362. Modifications,  15
  1363. Modify  8
  1364. Monitor  4, 7
  1365. Monochrome  4, 7
  1366. NEW  4
  1367. Novice  2
  1368. Obsolete
  1369.    Dearchiver  5
  1370. Packaging  15
  1371. PAK  2
  1372. Parameter  6, 7, 12
  1373.  
  1374.                                       20
  1375.  
  1376. PATH  5
  1377. PC  11, 16
  1378. Personalized  3
  1379. PKLITE  ii, 15
  1380. PKUNZIP  ii, 2, 5
  1381. PKWare  ii
  1382. PKWare.  15
  1383. PKZIP  2
  1384. Print  1, 8, 15
  1385. Print reply form  3
  1386. Problem  17
  1387. QEdit  4
  1388. Quit  3
  1389. READ.ME  5
  1390. READING  1, 16, 17
  1391. Register  6, 17
  1392. Registered  17
  1393. Renaming  14
  1394. Reply  1, 3
  1395. Root  13
  1396. S-D  4, 8, 9
  1397. Sample  11, 12
  1398. SEA  ii
  1399. SEE  1, 3, 7, 15, 17
  1400. Semi-colon  12
  1401. SETERR  1, 16, 17
  1402. Shareware  ii, 2, 12
  1403. Shell  2, 5
  1404. Special characters  8
  1405. Sydex  ii, 11
  1406. Text editor  3
  1407. Text file  3, 9, 10, 13, 15
  1408. Title  13
  1409. Trademark  ii
  1410. TSRs  10
  1411. TXT  4, 8, 9
  1412. Unregistered  3, 17
  1413. Upgrade  17
  1414. Upgrades  17
  1415. Versions  17
  1416. View  1, 15
  1417. WAITBLK  1, 16, 17
  1418. Wildcards  10, 14
  1419. WordStar  4
  1420. XT  11, 16
  1421. Yoshi  ii
  1422. Zap  6
  1423. ZIP  1, 2, 5
  1424. ZOO  2
  1425.  
  1426.  
  1427.  
  1428.  
  1429.  
  1430.  
  1431.  
  1432.                                       21
  1433.