home *** CD-ROM | disk | FTP | other *** search
/ TopWare Tools / TOOLS.iso / tools / top1281 / readme.doc < prev    next >
Encoding:
Text File  |  1993-03-08  |  21.6 KB  |  581 lines
  1.  
  2.                                   JP Software
  3.  
  4.                            4OS2 Shareware README.DOC
  5.  
  6.                          Version 1.11 -- March 8, 1993
  7.  
  8.  
  9.    [Copyright 1992 - 1993, 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.  
  17.    Greetings, and thanks for trying 4OS2!
  18.  
  19.    This file contains a variety of information you should read before using
  20.    4OS2, including:
  21.  
  22.       Release notes (page 2), includes:
  23.           * Files included with 4OS2
  24.           * Installation instructions
  25.           * Technical support
  26.           * BBS support
  27.  
  28.       Using 4OS2 with other software (page 7)
  29.  
  30.       Changes in 4OS2 since version 1.0 (page 8)
  31.  
  32.  
  33.    If you have tried a shareware copy of 4OS2 and want to place an order,
  34.    see the product and ordering information in the file ORDERINF.DOC, or
  35.    call us at (800) 368-8777 (USA only, orders only please!) or (617) 646-
  36.    3975.  The order form is included separately in the file ORDER.FRM.
  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.
  42.  
  43.    This file is formatted at 58 lines per page, and contains form feeds and
  44.    page footers.  It can be viewed with a file viewer such as the 4DOS or
  45.    4OS2 LIST command, or printed on most PC printers using the command:
  46.  
  47.             copy readme.doc prn
  48.  
  49.    Printing it with a program that formats the pages is not likely to work
  50.    due to the formatting included in the file.
  51.  
  52.  
  53.                                                                (3/93-1.11A)
  54.  
  55.  
  56.  
  57.    4OS2 1.11  [03-08-93]          README.DOC                         page 1
  58.  
  59.  
  60.    Release Notes
  61.    -------------
  62.  
  63.    4OS2 Version 1.11:
  64.  
  65.       This is the official release of 4OS2/32 and the first major update to
  66.       4OS2/16 version 1.0 (previously named simply "4OS2").
  67.  
  68.       If you have been using 4OS2 version 1.0, or 4OS2/32 version 1.1, see
  69.       page 8 for changes in version 1.11.
  70.  
  71.  
  72.    4DOS:
  73.  
  74.       This file and most other 4OS2 documentation refers frequently to
  75.       4DOS, JP Software's award-winning command processor for DOS.  If you
  76.       are not familiar with 4DOS we suggest that you obtain a copy
  77.       (available from the same place where you got 4OS2), and if
  78.       appropriate, install it on your system before or along with 4OS2. 
  79.       4DOS and 4OS2 are complementary and offer the same functions in your
  80.       DOS and OS/2 sessions.
  81.  
  82.  
  83.    Files Included with 4OS2 1.11:
  84.  
  85.       Shareware copies of 4OS2 come with two manuals:  the 4DOS manual
  86.       (4DOS.DOC, with ASCTAB.TXT) which also documents most 4OS2 commands
  87.       and features, and the 4OS2 manual (4OS2.DOC) which describes
  88.       differences between 4OS2 and 4DOS, and features unique to 4OS2.  We
  89.       divide the manuals this way because the great majority of 4OS2 users
  90.       also use 4DOS, and the substantial overlap of content would make it
  91.       cumbersome to have complete, separate manuals for each product.
  92.  
  93.       The way your copy of 4OS2 is "packaged" will vary depending on the
  94.       distribution method (5.25" disk, 3.5" disk, or on-line).  In general
  95.       there will be one 5.25", 1.2 MB disk, or one 3.5" 1.44 MB disk.  On-
  96.       line copies will be in two .ZIP files:  one -- usually 4DOS4D.ZIP,
  97.       4DOS401D.ZIP, or a similar name -- containing 4DOS.DOC and
  98.       ASCTAB.TXT, and one -- usually 4OS211.ZIP or a similar name --
  99.       containing all other files (including 4OS2.DOC).  When possible, the
  100.       file names change to reflect the current version number of each
  101.       product.  If you have an on-line copy and have only one .ZIP file,
  102.       check to be sure you are not missing the 4DOS manual or other files
  103.       before installing 4OS2.
  104.  
  105.       ZIP files distributed by JP Software will display the message:
  106.  
  107.           Authentic files Verified!   # VHJ325   JP Software Inc.
  108.  
  109.       when they are unzipped.  If you do not see this message, the ZIP file
  110.       you are using has been modified.  This does not necessarily indicate
  111.       a problem (for example, some BBS sysops "brand" 4OS2 with their BBS
  112.  
  113.  
  114.  
  115.    4OS2 1.11  [03-08-93]          README.DOC                         page 2
  116.  
  117.  
  118.       name using software from us; 4OS2 ZIP files on these BBSes will not
  119.       show the JP Software verification message).  However it does alert
  120.       you to the fact that the file has been changed since it was created
  121.       by JP Software.
  122.  
  123.       The following files are included with this version of 4OS2:
  124.  
  125.           4OS2.EXE*           4OS2 program file
  126.           4OS2.DOC            4OS2 ASCII manual
  127.           4OS2.INF            4OS2 help text for use with OS/2's VIEW.EXE
  128.           4OS2A.ICO*          A sample 4OS2 icon (see page 5 for more
  129.                               information)
  130.           4OS2B.ICO*          Another sample 4OS2 icon
  131.           4OS2H.MSG           4OS2 quick-help text (for "/?" help)
  132.           LICENSE.DOC         The 4OS2 shareware license agreement
  133.           ORDER.FRM           4OS2 shareware and upgrade order forms 
  134.           ORDERINF.DOC        Ordering and product information
  135.           README.DOC          This file
  136.           SHRALIAS.EXE*       Utility program for retention of global alias
  137.                               and history lists
  138.           SUPPORT.BBS         Information on Channel 1, the independent BBS
  139.                               used for 4OS2 support
  140.           SYSOP.DOC           4OS2 information for BBS sysops
  141.           VENDOR.DOC          4OS2 information for shareware disk vendors
  142.           4DOSA.ICO           A sample 4DOS icon for use under OS/2 (see
  143.                               page 5 for more information)
  144.           4DOSB.ICO           Another sample 4DOS icon
  145.  
  146.             * Files marked with an asterisk differ between the 16-bit and
  147.             32-bit versions of 4OS2.  If you have a diskette copy, for each
  148.             file marked above there are two files on the shareware disk,
  149.             and the appropriate file is extracted and renamed during the
  150.             installation process.  If you have a downloaded copy, your copy
  151.             will contain either the 16-bit or 32-bit files, but not both;
  152.             in this case no renaming is necessary.
  153.  
  154.  
  155.    Installing a Downloaded Copy of 4OS2:
  156.  
  157.       (These instructions do not cover diskette installation, because when
  158.       4OS2 is installed from diskette this file is not visible until after
  159.       installation is complete.)
  160.  
  161.       Whether or not you presently have 4OS2 or 4DOS installed, create a
  162.       new directory for this version of 4OS2 (do not install it in the same
  163.       directory as a previous version of 4OS2 or 4DOS).  Place all of the
  164.       downloaded files into the new directory.
  165.  
  166.       You can print the manual, or any 4OS2 documentation file (including
  167.       this one), by copying it to the printer with a command like this:
  168.  
  169.             copy 4os2.doc prn
  170.  
  171.  
  172.  
  173.    4OS2 1.11  [03-08-93]          README.DOC                         page 3
  174.  
  175.  
  176.       The documentation files are formatted at 58 lines or less per page,
  177.       and contain form feeds and page footers.  Printing them with a
  178.       program that formats the pages is not likely to work due to the
  179.       formatting already included in each file.
  180.  
  181.       Please note that the 4OS2 manual is about 64 pages long, and the 4DOS
  182.       manual is over 360 pages long.  If you don't want to print these
  183.       files, they can be viewed on-screen with a file viewer such as the
  184.       4OS2 LIST command.  Much of what's in the manuals is also available
  185.       in the 4OS2 HELP system.  However the HELP system is organized
  186.       primarily for quick reference, and may not be the best way to get an
  187.       overview of 4OS2's features or to learn about a topic in depth.
  188.  
  189.       If you do print the 4DOS ASCII manual, ASCTAB.TXT (which comes with
  190.       it) contains a complete ASCII table for Appendix B.  It is separate
  191.       from 4DOS.DOC because many printers can't handle the control codes it
  192.       contains.  If you wish you can print ASCTAB.TXT on your printer if
  193.       possible, and paste it into the manual.  However you should be aware
  194.       that the control codes in this file may make the printed output
  195.       completely unintelligible!  As an alternative, there is a complete
  196.       ASCII table in the 4OS2 HELP system.
  197.  
  198.       4OS2 comes with both 16-bit and 32-bit versions.  Before using your
  199.       downloaded copy of 4OS2, be sure you have the correct version for
  200.       your system.
  201.  
  202.       CAUTION ==>   If you are using OS/2 1.x, or the General Availability
  203.                     ("GA") release of OS/2 2.0 (files dated 3-30-92), you
  204.                     MUST use the 16-bit files.  You can NOT use the 32-bit
  205.                     files.
  206.  
  207.       If you are using any of the following versions of OS/2 you CAN use
  208.       the 32-bit files:
  209.  
  210.             * OS/2 2.0 GA with "Service Pack" (IBM CSD XR06055 or later in
  211.             the US, or XRx6055 elsewhere), files dated September 1992 or
  212.             later.
  213.  
  214.             * OS/2 version "2.01" or "2.0.1" beta, files dated October 1992
  215.             or later.
  216.  
  217.             * OS/2 version 2.1 or later, including beta and pre-release
  218.             versions of OS/2 2.1.
  219.  
  220.       If you are using the 16-bit version of 4OS2 and upgrade to the 32-bit
  221.       version, be sure to replace all the 16-bit files with their 32-bit
  222.       equivalents -- don't use some 16-bit files and other 32-bit files, or
  223.       4OS2 may not work properly.
  224.  
  225.       To test drive your copy of 4OS2 see the installation instructions in
  226.       Chapter 1 of the manual.  To install it completely, follow the manual
  227.  
  228.  
  229.  
  230.  
  231.    4OS2 1.11  [03-08-93]          README.DOC                         page 4
  232.  
  233.  
  234.       installation instructions in Chapter 1, disregarding the discussion
  235.       of extracting files from the diskettes.
  236.  
  237.       BE SURE YOU HAVE A BOOTABLE FLOPPY DISK or a copy of your OS/2
  238.       installation disks (as described at the beginning of Chapter 1)
  239.       before installing 4OS2 on your system.  This is not because 4OS2 is
  240.       likely to cause trouble.  It's because a mistake in the system
  241.       startup files or a power failure or other disturbance during
  242.       installation, could prevent your system from booting properly (though
  243.       this is less likely under OS/2 than under DOS).  While such problems
  244.       are rare, any time you modify CONFIG.SYS you should have a bootable
  245.       floppy disk handy so you can recover if necessary.
  246.  
  247.       Be sure to read the notes in chapter 1 of the manual about modifying
  248.       the BOOKSHELF environment variable to make 4OS2's full cross-
  249.       referenced help work properly, and about modifying the DPATH variable
  250.       to make the "/?" quick help work properly.
  251.  
  252.  
  253.    Installing 4OS2 Icons:
  254.  
  255.       We provide several sample icons with 4OS2.  The "A" icon files show
  256.       the 4OS2 / 4DOS logo and product name on a background that matches
  257.       the current folder or desktop color.  The "B" files are the same but
  258.       include a border (you may want to use these for windowed sessions, so
  259.       that the border reminds you the session runs in a window).  You can
  260.       edit any of these icons with the icon editor which comes with OS/2.
  261.  
  262.       To use any icon file for a particular object visible on your OS/2 2.0
  263.       desktop (in this case, for objects which start 4OS2 or 4DOS
  264.       sessions), open the Settings notebook for the object, click on the
  265.       General tab, and then click the Find button next to the current icon
  266.       display.  In the Find window click Locate; in the Locate notebook
  267.       click the Path tab.  Fill in the path to the directory where the
  268.       desired icon file is stored (fill in only the directory name, not the
  269.       full file name) and click OK.  Back in the Find window, click the
  270.       Find button.  When the window opens showing the item(s) found, click
  271.       once on the desired icon, then click the OK button.  Finally, close
  272.       the Settings notebook.
  273.  
  274.       To display a specific icon when a 4OS2 session is minimized, copy the
  275.       icon file to the directory where 4OS2.EXE is stored and name it
  276.       4OS2.ICO.  This step is separate from and independent of the
  277.       instructions above for attaching the icon to a desktop object.
  278.  
  279.  
  280.    Technical Support:
  281.  
  282.       We support 4OS2 in our own CompuServe area, section 10 of the PC
  283.       Vendor B forum (GO JPSOFT or GO PCVENB).  If you are not currently a
  284.       CompuServe subscriber, consider a special offer CompuServe has made
  285.       to JP Software customers:  call 1-800-848-8199 (outside the US and
  286.  
  287.  
  288.  
  289.    4OS2 1.11  [03-08-93]          README.DOC                         page 5
  290.  
  291.  
  292.       Canada call 614-457-0802) and ask for operator 178 to receive a free
  293.       CompuServe introductory membership, including user ID, password, and
  294.       a $15 connect time credit.
  295.  
  296.       Our CompuServe ID for direct access to our technical support
  297.       personnel is 75300,1215.  Use this ID for technical support issues
  298.       only.  If you have direct CompuServe access please use the PCVENB
  299.       forum (as opposed to Mail) whenever possible.  For technical support
  300.       on the Internet send mail to 75300.1215@compuserve.com.
  301.  
  302.       Support is also available by phone (617-646-3975), fax (617-646-
  303.       0904), and mail (JP Software, PO Box 1470, E. Arlington, MA 02174). 
  304.       Telephone support hours and availability may vary depending on our
  305.       current staffing pattern and workload; there may not always be a
  306.       support representative available when you call, in which case we will
  307.       take a message and call you back.  We return calls as soon as
  308.       possible, and our policy is to return all calls within at most 24
  309.       hours (weekends and holidays excepted).
  310.  
  311.  
  312.    Bulletin Board Support for 4OS2:
  313.  
  314.       4OS2 product support is always available on our support BBS, Channel
  315.       1 in Boston.  Channel 1 is an independent BBS (not operated by JP
  316.       Software) which has generously offered to provide a home for 4OS2 BBS
  317.       support.  Phone 617-354-8873 to access Channel 1 at 2400 baud; other
  318.       phone numbers are available once you sign up.  To download 4OS2 files
  319.       join conference 5 and then download the file you need.  The file name
  320.       for the latest version of 4OS2 is 4OS2xx.ZIP, where "xx" is the
  321.       version (e.g. 4OS210.ZIP for version 1.0).  On Channel 1 you will be
  322.       able to download 4OS2 files even if they appear to be too large for
  323.       your remaining time on the system.
  324.  
  325.       If you have access to a local bulletin board which is a member of any
  326.       of the major BBS networks (RIME / PC Relay, InterLink, SmartNet, or
  327.       FidoNet), you can obtain support for 4OS2 by leaving messages in the
  328.       network's 4DOS conference.
  329.  
  330.       4OS2 is distributed directly to some bulletin boards by JP Software,
  331.       and uploaded to many more.  It is impossible for us to list the
  332.       enormous number of boards worldwide that have the latest version of
  333.       4OS2, but we encourage you to check your favorite BBS, or use Channel
  334.       1.  If you are a BBS sysop, see SYSOP.DOC for information on
  335.       obtaining a copy of 4OS2 for your BBS.
  336.  
  337.  
  338.  
  339.  
  340.  
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.    4OS2 1.11  [03-08-93]          README.DOC                         page 6
  348.  
  349.  
  350.    Using 4OS2 with Other Software
  351.    ------------------------------
  352.  
  353.    4OS2 is compatible with virtually all OS/2 software, including OS/2
  354.    versions 1.2, 1,21. 1.3, 1.3.1, 2.0, 2.01, and 2.1.
  355.  
  356.    Some products which allow access to the 4OS2 command line from within
  357.    the product may require a KEYS OFF command to enable line input mode
  358.    before command line access will work properly.  The only product we are
  359.    currently aware of which requires this change is Epsilon from Lugaru
  360.    Software.
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405.    4OS2 1.11  [03-08-93]          README.DOC                         page 7
  406.  
  407.  
  408.    Changes in 4OS2 Version 1.11
  409.    ----------------------------
  410.  
  411.    This list shows all significant changes in 4OS2 since version 1.0.
  412.  
  413.    If you are a new 4OS2 user, you can ignore this list.
  414.  
  415.    If you are currently using 4OS2 1.0, all of the items listed below will
  416.    change when you switch to version 1.11.  If you are currently using
  417.    4OS2/32 version 1.1, only the items marked with asterisks will change;
  418.    the other items are already in your current copy of 4OS2.  If you are
  419.    unsure of what version of 4OS2 you are using, use the VER command to
  420.    display your version number.
  421.  
  422.    For more details on any change, see the corresponding command or feature
  423.    in the online help or in the manual.
  424.  
  425.  
  426.    General changes:
  427.  
  428.    *  The maximum command line length has been increased to 1023
  429.       characters.
  430.  
  431.       There is a new directive in 4OS2.INI:  AmPm = Yes | NO | Auto.  This
  432.       controls the time display format (e.g. in DIR and SELECT output).
  433.  
  434.  
  435.    Variables and Variable Functions:
  436.  
  437.    *  Variable functions that return long integer values (such as @FILESIZE
  438.       or @DISKFREE) can now return comma delimited values if you append a
  439.       'c' to the size field (b|B|k|K|m|M), e.g. "%@DISKFREE[d:,bc]".  Note
  440.       that values with commas will NOT be treated as numeric values when
  441.       doing IF comparisons.
  442.  
  443.    *  @EVAL:  Changed to recognize the non-US thousands separator and
  444.       decimal characters.
  445.  
  446.    *  @REMOVABLE[d]:  New internal function returns 1 if the media on that
  447.       drive is removable.
  448.  
  449.  
  450.    Command Changes:
  451.  
  452.    *  ATTRIB supports the "attrib file -r" syntax used in some IBM .CMD
  453.       files.
  454.  
  455.       DEL supports the /F option to avoid copying files to the DELDIR
  456.       directory (4OS2/32 only).
  457.  
  458.    *  DEL now displays space freed by deletions whenever possible.
  459.  
  460.  
  461.  
  462.  
  463.    4OS2 1.11  [03-08-93]          README.DOC                         page 8
  464.  
  465.  
  466.       DIR supports the new /T:[acw] switch to specify the use of last
  467.       access, creation, or last write time in directory displays and sorts
  468.       on HPFS drives.
  469.  
  470.    *  DIR display has been sped up from 15 - 35%.
  471.  
  472.       KEYS OFF has been changed to switch from character to line input mode
  473.       for better emulation of CMD.EXE and to improve compatibility with a
  474.       few application programs.  KEYS ON will switch back to character
  475.       input mode.  (This is equivalent to the SETDOS /L switch in 4DOS.)
  476.  
  477.       MEMORY displays several additional memory statistics.
  478.  
  479.       START allows specification of DOS settings when starting DOS
  480.       sessions.  This allows you to set specific DOS session settings
  481.       without creating an object on your desktop for the session.
  482.  
  483.       WINDOW is a new command which allows you to change the 4OS2 window
  484.       size / state from the prompt or from a batch file.
  485.  
  486.  
  487.    Bug Fixes and Compatibility Changes:
  488.  
  489.    *  REXX subcommand handler name changed to "CMD" for better
  490.       compatibility (allows ADDRESS CMD to work).
  491.  
  492.    *  The filename passed to an EXTPROC processor will always have a .CMD
  493.       extension (some EXTPROC processors expect this).  Previously the name
  494.       was passed as you typed it, with or without the extension.
  495.  
  496.    *  The command name passed to external programs will now reflect the
  497.       name as you typed it, without any path information added (some
  498.       programs could not handle the added path information).
  499.  
  500.    *  Fixed some minor reliability problems with multiple secondary 4OS2
  501.       shells.
  502.  
  503.    *  Fixed a problem with running external programs from HPFS drives when
  504.       the path or file name contained "=" or "+".
  505.  
  506.    *  Fixed interaction problems with IBM's INSTAID utility.
  507.  
  508.    *  Changed 4OS2's redirection operators to avoid reducing the number of
  509.       file handles initially available to external programs.
  510.  
  511.    *  BORDER colors are now disabled in all commands except CLS and COLOR
  512.       (they were never documented to work except in CLS and COLOR).
  513.  
  514.    *  COPY:  Fixed a bug which could cause /C and /U to compare file dates
  515.       and times incorrectly; changed to allow "+" characters inside quoted
  516.       filenames (COPY was treating these as a request to append files).
  517.  
  518.  
  519.  
  520.  
  521.    4OS2 1.11  [03-08-93]          README.DOC                         page 9
  522.  
  523.  
  524.    *  DETACH:  Changed (for compatibility with CMD.EXE) to pass everything
  525.       following "DETACH" to the detached process, including pipes, command
  526.       separators, conditional commands, redirection, etc.).
  527.  
  528.    *  DIR:  Worked around an OS/2 bug which resulted in doubling of
  529.       displayed EA sizes on HPFS volumes in 4OS2/32 1.1; fixed a problem
  530.       with extremely large HPFS directories (2000+ files).
  531.  
  532.    *  EXIT:  Will no longer cause an infinite loop when used inside 4EXIT.
  533.  
  534.    *  LIST:  Fixed a problem with /W truncating lines in binary files.
  535.  
  536.    *  MOVE:  Fixed a bug which could cause /C and /U to compare file dates
  537.       and times incorrectly.  Also, changed MOVE /S to give an error on
  538.       attempts to perform infinitely recursive moves (e.g. MOVE /S
  539.       \DIR1\*.* \DIR1\SUBDIR\).
  540.  
  541.    *  SELECT:  Worked around an OS/2 bug which resulted in doubling of
  542.       displayed EA sizes on HPFS volumes in 4OS2/32 1.1.
  543.  
  544.  
  545.  
  546.  
  547.  
  548.  
  549.  
  550.  
  551.  
  552.  
  553.  
  554.  
  555.  
  556.  
  557.  
  558.  
  559.  
  560.  
  561.  
  562.  
  563.  
  564.  
  565.  
  566.  
  567.  
  568.  
  569.  
  570.  
  571.  
  572.  
  573.  
  574.  
  575.  
  576.  
  577.  
  578.  
  579.    4OS2 1.11  [03-08-93]          README.DOC                        page 10
  580.  
  581.