home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: OtherApp / OtherApp.zip / 4os225b.zip / README.DOC < prev    next >
Text File  |  1994-10-12  |  20KB  |  465 lines
  1.  
  2.                                   JP Software
  3.  
  4.                            4OS2 Shareware README.DOC
  5.  
  6.                         Version 2.5 -- October 12, 1994
  7.  
  8.  
  9.    [Copyright 1992 - 1994, JP Software Inc., All Rights Reserved. 
  10.    Published by JP Software Inc., P.O. Box 1470, E. Arlington, MA 02174
  11.    USA, (617) 646-3975.  4OS2, 4OS2/16, and 4OS2/32 are trademarks and 4DOS
  12.    is a registered trademark of JP Software Inc.  OS/2 is a trademark of
  13.    IBM Corporation.  Other product and company names are trademarks of
  14.    their respective owners.]
  15.  
  16.    Greetings, and thanks for trying 4OS2!
  17.  
  18.    This file contains a variety of information you should read before using
  19.    4OS2, including:
  20.  
  21.       * Changes in version 2.5          * Technical support
  22.       * Files included with 4OS2        * Bulletin board support
  23.       * Installation instructions       * Shareware and ASP policies
  24.       * Upgrading from 4OS2 2.0
  25.  
  26.    If you have tried a shareware copy of 4OS2 and want to place an order,
  27.    see the product and ordering information in the file ORDERINF.DOC, or
  28.    call us at (800) 368-8777 (USA only, orders only please!) or (617) 646-
  29.    3975.  An order form is included separately in the file ORDER.FRM.  JP
  30.    Software also offers Take Command, an exciting new command processor for
  31.    Windows and Windows NT; and other products which complement 4OS2, like
  32.    the 4OS2 Utility Disk.
  33.  
  34.    For complete installation instructions, see page 4.  These instructions
  35.    cover installation procedures for both new users and those upgrading
  36.    from a previous version of 4OS2.  
  37.  
  38.    The license agreement which governs your use of 4OS2 is included
  39.    separately in the file LICENSE.DOC.  Please read it before ordering. 
  40.    The text is written in plain English, and clearly explains your rights
  41.    and responsibilities as a user of 4OS2.  For more information on the
  42.    shareware system under which you obtained this copy of 4OS2, see page 7.
  43.  
  44.    This file, like all 4OS2 ASCII documentation files, is formatted at 58
  45.    lines per page, and contains form feeds and page footers.  It can be
  46.    viewed with a file viewer such as the 4OS2 LIST command, or printed on
  47.    most PC printers using the command:
  48.  
  49.             copy readme.doc prn
  50.  
  51.    Printing it with a program that formats the pages is not likely to work
  52.    due to the formatting included in the file.
  53.                                                                (10/94-2.5A)
  54.  
  55.  
  56.  
  57.    4OS2 2.5  [10-12-94]           README.DOC                         page 1
  58.  
  59.  
  60.    Changes in Version 2.5
  61.  
  62.       Be sure to read the installation instructions in this file before
  63.       installing 4OS2!
  64.  
  65.       Version 2.5 is a major new release of 4OS2.  It coincides with
  66.       similar major releases of our other command processors:  4DOS version
  67.       5.5 and 4DOS for Windows NT version 2.5.
  68.  
  69.       If you are a current 4OS2 user, be sure to check over the list of
  70.       changes in this version, in the file UPDAT25.DOC, BEFORE you begin
  71.       using version 2.5!  The list below gives only a very small sample of
  72.       what's new in this version.  If you're a new 4OS2 user, you can skip
  73.       UPDAT25.DOC.
  74.  
  75.       Here is a partial list of the new features in this version:
  76.  
  77.           * The new FFIND command can quickly locate a file by name,
  78.           or find text within a file, anywhere on your system. You
  79.           can even use extended wildcards for both filenames and
  80.           text, allowing fast, flexible searches.
  81.  
  82.           * The maximum file description length has been increased
  83.           to 511 characters.
  84.  
  85.           * Colors can now be specified as either digits or the
  86.           color name to help those who are running out of room for
  87.           ColorDir specifications.
  88.  
  89.           * LIST now supports wildcards in searches, so you can look
  90.           for text using all the extended wildcard features you
  91.           already use to search for files.  
  92.  
  93.           * KEYSTACK automatically calculates scan codes for you,
  94.           making it easier to enter keystrokes for troublesome
  95.           programs that require them.
  96.  
  97.           * New variables and functions for batch programmers
  98.           include keystroke detection, binary file reads and writes,
  99.           string formatting, and conditional calcualations.  
  100.  
  101.           * Errors in batch files display the batch file name and
  102.           the line number where the error occured.
  103.  
  104.           * All file processing commands now support file selection
  105.           by attribute (e.g. you can easily delete all hidden files
  106.           or copy all read-only files)
  107.  
  108.           * Directory histories are inherited and can be global like
  109.           aliases and command history.
  110.  
  111.           * @FINDFIRST/@FINDNEXT now support include lists.
  112.  
  113.  
  114.  
  115.    4OS2 2.5  [10-12-94]           README.DOC                         page 2
  116.  
  117.  
  118.    Files Included with 4OS2 2.5
  119.  
  120.       Please note that the way your copy of 4OS2 is "packaged" will vary
  121.       depending on the distribution method (5.25" disk, 3.5" disk, or on-
  122.       line).  In general there will be one 5.25" 1.2MB disk, or one 3.5"
  123.       720K disk.
  124.  
  125.       On-line copies will be in three .ZIP files.  Part "A" consists of
  126.       files specific to the 16-bit or 32-bit version, and will be in
  127.       4OS216.ZIP or 4OS216A.ZIP (16-bit), and 4OS232.ZIP or 4OS232A.ZIP
  128.       (32-bit).  You only need to download the file for the version you use
  129.       (see below, or see the 4OS2.DOC file for more details on 16-bit and
  130.       32-bit versions of 4OS2).  Part "B", the files which are the same for
  131.       both the 16-bit and 32-bit versions, will be in 4OS2B.ZIP or
  132.       4OS225B.ZIP.
  133.  
  134.       In addition, you may choose to download the 4DOS, 4OS2, and 4DOS/NT
  135.       Reference Manual (the file is named REFMAN.DOC, and is typically
  136.       stored in the file JP4REF.ZIP).  This is a large file and much of the
  137.       same information is available in the online help system, but we do
  138.       make the ASCII version of the manual available for those who wish to
  139.       download it.
  140.  
  141.       Similarly, if you have a printed version of the previous 4OS2 2.0
  142.       Reference Manual and want to download the addendum to update it to
  143.       version 2.5, look for the file JP4ADD.ZIP, which contains
  144.       ADDENDUM.DOC.  The addendum is shipped to you automatically if you
  145.       order an upgrade to version 2.5 from JP Software.
  146.  
  147.       ZIP files distributed by JP Software will display the message
  148.       "Authentic files Verified!   # VHJ325   JP Software Inc." when they
  149.       are unzipped.  If you do not see this message, the ZIP file you are
  150.       using has been modified.  This does not necessarily indicate a
  151.       problem, but it does alert you to the fact that the file has been
  152.       changed since it was created by JP Software.
  153.  
  154.       The following files are included with this version of 4OS2:
  155.  
  156.           4OS2.EXE*           4OS2 program file
  157.           4OS2.DOC            ASCII copy of the 4OS2 Introduction and
  158.                               Installation Guide
  159.           4OS2.INF            4OS2 help text for use with OS/2's VIEW.EXE
  160.           4OS2A.ICO*          A sample 4OS2 icon
  161.           4OS2B.ICO*          Another sample 4OS2 icon
  162.           4OS2H.MSG           4OS2 quick-help text (for "/?" help)
  163.           ALIASES             Sample aliases
  164.           BATCOMP.EXE         Batch file compression utility
  165.           LICENSE.DOC         The 4OS2 shareware license agreement
  166.           ORDER.FRM           4OS2 shareware and upgrade order forms 
  167.           ORDERINF.DOC        Ordering and product information
  168.           README.DOC          This file
  169.  
  170.  
  171.  
  172.  
  173.    4OS2 2.5  [10-12-94]           README.DOC                         page 3
  174.  
  175.  
  176.           REFMAN.DOC          4DOS, 4OS2, and 4DOS/NT combined reference
  177.                               manual (must be downloaded separately, see
  178.                               above)
  179.           SAMPLES.BTM         Sample 4OS2 batch files (all samples are
  180.                               included in one file)
  181.           SHRALIAS.EXE*       Utility program for retention of global alias
  182.                               and history lists
  183.           SUPPORT.BBS         Information on Channel 1, the independent BBS
  184.                               used for 4OS2 support
  185.           SYSOP.DOC           4OS2 information for BBS sysops
  186.           TOUR.DOC            The 4OS2 Guided Tour documentation
  187.           TOUR1.BTM           Batch file used for the 4OS2 "tour" (see
  188.             and TOUR2.BTM       TOUR.DOC)
  189.           UPDAT25.DOC         Information on changes in 4OS2 2.5
  190.           VENDOR.DOC          4OS2 information for shareware disk vendors
  191.  
  192.             * Files marked with an asterisk differ between the 16-bit and
  193.             32-bit versions of 4OS2.  If you have a diskette copy, for each
  194.             file marked above there are two files on the shareware disk,
  195.             and the appropriate file is extracted and renamed during the
  196.             installation process.  If you have a downloaded copy, your copy
  197.             will contain either the 16-bit or 32-bit files, but not both;
  198.             in this case no renaming is necessary.
  199.  
  200.  
  201.    Installation Instructions
  202.  
  203.       (These instructions do not cover diskette installation, because when
  204.       4OS2 is installed from diskette this file is not visible until after
  205.       installation is complete.)
  206.  
  207.       Whether or not you presently have 4OS2 installed, create a new
  208.       directory for 4OS2 2.5 (do not install it in the same directory as a
  209.       previous version of 4OS2).  Decompress your downloaded 4OS2 2.5 files
  210.       into this directory.  You can print the 4OS2 Introduction and
  211.       Installation Guide, or any 4OS2 documentation file (including this
  212.       one), by copying it to the printer with the COPY command.
  213.  
  214.       Please note that the 4OS2 Introduction and Installation Guide is
  215.       about 30 pages long, and the Reference Manual is over 380 pages long! 
  216.       If you don't want to print these files they can be viewed on-screen
  217.       with a file viewer such as the 4OS2 LIST command.  Most of what's in
  218.       the Reference Manual is also available in the 4OS2 help system.
  219.  
  220.       For a guided tour of 4OS2 features see the instructions in TOUR.DOC. 
  221.       To install 4OS2 completely, follow the manual installation
  222.       instructions in Chapter 1 of 4OS2.DOC, disregarding the discussion of
  223.       extracting files from the diskettes.
  224.  
  225.       If you install 4OS2 manually, be sure to read the notes in Chapter 1
  226.       of the Introduction and Installation Guide about modifying the
  227.       BOOKSHELF environment variable to make 4OS2's full cross-referenced
  228.  
  229.  
  230.  
  231.    4OS2 2.5  [10-12-94]           README.DOC                         page 4
  232.  
  233.  
  234.       help work properly, and about modifying the DPATH variable to make
  235.       the "/?" quick help work properly.
  236.  
  237.       4OS2 comes with both 16-bit and 32-bit versions.  If you have a
  238.       diskette copy of 4OS2 with our automated installation program, the
  239.       correct version is installed automatically.  If you have a downloaded
  240.       copy of 4OS2, be sure you have the correct version for your system
  241.       before beginning the installation process, as the 16-bit and 32-bit
  242.       versions are uploaded separately.  In general you should use the 16-
  243.       bit version for OS/2 1.x and 2.0, and the 32-bit version for OS/2 2.1
  244.       and above.  See the 4OS2 Introduction and Installation Guide for
  245.       further details.
  246.  
  247.       If you are using the 16-bit version of 4OS2 and upgrade to the 32-bit
  248.       version, be sure to replace all the 16-bit files with their 32-bit
  249.       equivalents -- don't use some 16-bit files and other 32-bit files, or
  250.       4OS2 will not work properly.
  251.  
  252.  
  253.    Upgrading from 4OS2 Version 2.0 to Version 2.5
  254.  
  255.       Be sure to go over the changes in version 2.5, in the file
  256.       UPDAT25.DOC, before you start using it.  4OS2 2.5 can be run in "test
  257.       drive" mode over previous versions of 4OS2, so you can test the new
  258.       version before fully installing it.  4OS2 2.5 should always be
  259.       installed in a different directory than any earlier version of 4OS2.
  260.  
  261.       To upgrade from 4OS2 2.0 to version 2.5, make the following changes
  262.       in your system configuration:
  263.  
  264.           * Modify the SET OS2_SHELL line in your OS/2 2.x CONFIG.SYS file
  265.             (or the PROTSHELL line in your OS/2 1.x CONFIG.SYS file) to
  266.             reflect the new directory where 4OS2.EXE is stored.  Make a
  267.             similar modification to the SET COMSPEC statement in
  268.             CONFIG.SYS.
  269.  
  270.           * If you keep any 4OS2 startup or exit files (4OS2.INI, 4START,
  271.             or 4EXIT) in your 4OS2 directory, be sure to move or copy the
  272.             old files into the directory where 4OS2 2.5 is stored.  (If the
  273.             files are in the root directory of the boot drive they do not
  274.             need to be moved.)
  275.  
  276.           * Be sure that any OS/2 objects which explicitly name 4OS2.EXE
  277.             (rather than using the "*" to start the default command
  278.             processor) are modified to reflect the new directory where
  279.             4OS2.EXE is stored.  See the 4OS2 Introduction and Installation
  280.             Guide for complete details on using settings for OS/2 and 4OS2
  281.             objects.
  282.  
  283.           * Obtain a copy of the BRAND program which came with your
  284.             registered copy of 4OS2 version 2.0, put it in the same
  285.             directory as the 4OS2 version 2.5 files.  Run it and follow the
  286.  
  287.  
  288.  
  289.    4OS2 2.5  [10-12-94]           README.DOC                         page 5
  290.  
  291.  
  292.             on-screen instructions to install your name and serial number
  293.             into 4OS2.  The information needed to BRAND your copy is on the
  294.             small blue or yellow "Brand ID Card" which came with your copy
  295.             of 4OS2.  If you cannot find this card with your branding
  296.             codes, you can order a replacement from JP Software for $5.
  297.  
  298.       Once you've made these changes, you can reboot your system and you'll
  299.       be running 4OS2 2.5.
  300.  
  301.  
  302.    Technical Support
  303.  
  304.       We support 4OS2 in our own CompuServe area, section 10 of the PC
  305.       Vendor B forum (GO PCVENB).  If you are not currently a CompuServe
  306.       subscriber, consider a special offer CompuServe has made to 4OS2
  307.       users:  call 1-800-848-8199 (outside the US and Canada call 614-457-
  308.       0802) and ask for operator 178 to receive a free CompuServe
  309.       introductory membership, including user ID, password, and a $15
  310.       connect time credit.
  311.  
  312.       For technical support on the Internet send mail to
  313.       75300.1215@compuserve.com.
  314.  
  315.       Support is also available by phone (617-646-3975), fax (617-646-
  316.       0904), and mail (JP Software, PO Box 1470, E. Arlington, MA 02174). 
  317.       Telephone support hours and availability may vary depending on our
  318.       current staffing pattern and workload; there may not always be a
  319.       support representative available when you call, in which case we will
  320.       take a message and call you back.  We return calls as soon as
  321.       possible, and our normal policy is to return all calls within at most
  322.       24 hours (weekends and holidays excluded).
  323.  
  324.  
  325.    Bulletin Board Support for 4OS2
  326.  
  327.       4OS2 product support is always available on our support BBS, Channel
  328.       1 in Boston.  Channel 1 is an independent BBS (not operated by JP
  329.       Software) which has generously offered to provide a home for 4OS2 BBS
  330.       support.  Phone 617-354-3230 to access Channel 1 at 2400 - 14,400
  331.       baud (no parity, 8 data bits, 1 stop bit).
  332.  
  333.       If you have access to a local bulletin board which is a member of any
  334.       of the major BBS networks (RIME / PC Relay, ILink, SmartNet, or
  335.       FidoNet), you can discuss 4OS2 with other users, and obtain limited
  336.       support from JP Software, by leaving messages in the network's "4DOS"
  337.       conference.
  338.  
  339.  
  340.    Downloading 4OS2 Files
  341.  
  342.       You can download 4OS2 upgrades and other files from CompuServe or the
  343.       Channel 1 BBS (see above), or from our Internet ftp site.  To
  344.  
  345.  
  346.  
  347.    4OS2 2.5  [10-12-94]           README.DOC                         page 6
  348.  
  349.  
  350.       download 4OS2 updates from CompuServe, go to the PC Vendor B forum
  351.       (GO JPSOFT or GO PCVENB) and look for the files you want in Library
  352.       10.  On Channel 1, join conference 5 and then download the files you
  353.       need (as long as you join conference 5 before downloading you will be
  354.       able to download 4OS2 files even if they appear to be too large for
  355.       your remaining time on the system).  On the internet, download the
  356.       files you need via ftp from ftp.std.com, directory /vendors/jpsoft
  357.       (for general JP Software files) or directory /vendors/jpsoft/4os2
  358.       (for 4OS2-specific files).
  359.  
  360.  
  361.    Shareware Copies of 4OS2
  362.  
  363.       If you obtained 4OS2 from a shareware disk vendor, an on-line
  364.       computer service or bulletin board, a friend or colleague, or another
  365.       similar source, you have an unregistered (trial) copy.  As the
  366.       copyright holder for this software, JP Software allows and encourages
  367.       you to use this trial copy without charge for a limited period of
  368.       time, under the terms of our license agreement (see LICENSE.DOC). 
  369.       After this time is up, you must purchase (register and pay for) the
  370.       product to continue using it.
  371.  
  372.       This method of distribution is known as shareware.  It allows you to
  373.       determine whether the product meets your needs before you pay for it.
  374.  
  375.       Payment of the shareware registration fee for 4OS2 entitles you to a
  376.       complete copy of the product with typeset-quality printed and bound
  377.       manuals; the ability to download an upgrade to the next major release
  378.       of the product; continued technical support via electronic mail or
  379.       telephone; and a subscription to "The Prompt Solution", JP Software's
  380.       customer newsletter.
  381.  
  382.  
  383.    Association of Shareware Professionals
  384.  
  385.       The authors and publisher of 4OS2 are members of the Association of
  386.       Shareware Professionals (ASP), an organization formed to strengthen
  387.       the future of shareware.  Its members, all of whom are programmers
  388.       who subscribe to a code of ethics, are committed to the concept of
  389.       shareware as a method of marketing.
  390.  
  391.       The ASP sets standards for its members and their shareware products
  392.       which provide that programs produced by ASP members must be fully
  393.       documented, non-crippled, and offered with at least a minimum level
  394.       of support.  It also sets standards for shareware disk vendors and
  395.       provides information to the public about shareware.
  396.  
  397.  
  398.    ASP Ombudsman Statement
  399.  
  400.       JP Software is a member of the Association of Shareware Professionals
  401.       (ASP).  ASP wants to make sure that the shareware principle works for
  402.  
  403.  
  404.  
  405.    4OS2 2.5  [10-12-94]           README.DOC                         page 7
  406.  
  407.  
  408.       you. If you are unable to resolve a shareware-related problem with an
  409.       ASP member by contacting the member directly, ASP may be able to
  410.       help. The ASP Ombudsman can help you resolve a dispute or problem
  411.       with an ASP member, but does not provide technical support for
  412.       members' products.  Please write to the ASP Ombudsman at 545 Grover
  413.       Road, Muskegon, MI 49442 or send a CompuServe message via CompuServe
  414.       Mail to ASP Ombudsman 70007,3536.
  415.  
  416.  
  417.  
  418.  
  419.  
  420.  
  421.  
  422.  
  423.  
  424.  
  425.  
  426.  
  427.  
  428.  
  429.  
  430.  
  431.  
  432.  
  433.  
  434.  
  435.  
  436.  
  437.  
  438.  
  439.  
  440.  
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.    4OS2 2.5  [10-12-94]           README.DOC                         page 8
  464.  
  465.