home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 3 / CDASC03.ISO / sorties / 1959 / 4os2v100.exe / README.DOC < prev    next >
Text File  |  1992-06-08  |  21KB  |  581 lines
  1.  
  2.                                   JP Software
  3.  
  4.                            4OS2 Shareware README.DOC
  5.  
  6.                           Version 1.0 -- June 8, 1992
  7.  
  8.  
  9.    [Copyright 1992, JP Software Inc., All Rights Reserved.  Published by JP
  10.    Software Inc., P.O. Box 1470, E. Arlington, MA 02174 USA, (617)
  11.    646-3975.  4OS2 is a trademark and 4DOS is a registered trademark of JP
  12.    Software Inc.  OS/2 is a trademark of IBM Corporation.  Other product
  13.    and company names are trademarks of their respective owners.]
  14.  
  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.       Release notes (page 2), includes:
  22.           * Files included with 4OS2
  23.           * Installation instructions
  24.           * Technical support
  25.           * BBS support
  26.  
  27.       Using 4OS2 with other software (page 7)
  28.  
  29.       Changes in 4OS2 since the version 0.95 pre-release (page 8)
  30.  
  31.  
  32.    If you have tried a shareware copy of 4OS2 and want to place an order,
  33.    see the product and ordering information in the file ORDERINF.DOC, or
  34.    call us at (800) 368-8777 (USA only, orders only please!) or (617) 646-
  35.    3975.  The order form is included separately in the file ORDER.FRM.
  36.  
  37.    The license agreement which governs your use of 4OS2 is included
  38.    separately in the file LICENSE.DOC.  Please read it before ordering. 
  39.    The text is written in plain English, and clearly explains your rights
  40.    and responsibilities as a user of 4OS2.
  41.  
  42.    This file is formatted at 58 lines per page, and contains form feeds and
  43.    page footers.  It can be viewed with a file viewer such as the 4DOS or
  44.    4OS2 LIST command, or printed on most PC printers using the command:
  45.  
  46.             copy readme.doc prn
  47.  
  48.    Printing it with a program that formats the pages is not likely to work
  49.    due to the formatting included in the file.
  50.  
  51.  
  52.  
  53.                                                                 (6/92-1.0A)
  54.  
  55.  
  56.  
  57.    4OS2 1.0  [6-8-92]             README.DOC                         page 1
  58.  
  59.  
  60.    Release Notes
  61.    -------------
  62.  
  63.    4OS2 Version 1.0:
  64.  
  65.       This is the official shareware release of 4OS2 and supersedes the
  66.       previous "pre-release" version (version 0.95) of 4OS2.
  67.  
  68.       If you have been using 4OS2 version 0.95, see page 8 for changes in
  69.       version 1.0.
  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.0:
  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 or
  97.       4DOS40D.ZIP -- containing 4DOS.DOC and ASCTAB.TXT, and one -- usually
  98.       4OS210.ZIP -- containing all other files (including 4OS2.DOC).  If
  99.       you have an on-line copy and have only one .ZIP file, check to be
  100.       sure you are not missing the 4DOS manual or other files before
  101.       installing 4OS2.
  102.  
  103.       ZIP files distributed by JP Software will display the message:
  104.  
  105.           Authentic files Verified!   # VHJ325   JP Software Inc.
  106.  
  107.       when they are unzipped.  If you do not see this message, the ZIP file
  108.       you are using has been modified.  This does not necessarily indicate
  109.       a problem (for example, some BBS sysops "brand" 4OS2 with their BBS
  110.       name using software from us; 4OS2 ZIP files on these BBSes will not
  111.       show the JP Software verification message).  However it does alert
  112.  
  113.  
  114.  
  115.    4OS2 1.0  [6-8-92]             README.DOC                         page 2
  116.  
  117.  
  118.       you to the fact that the file has been changed since it was created
  119.       by JP Software.
  120.  
  121.       The following files are included with this version of 4OS2:
  122.  
  123.           4OS2.EXE            4OS2 program file
  124.           4OS2.DOC            4OS2 ASCII manual
  125.           4OS2.INF            4OS2 help text for use with OS/2's VIEW.EXE
  126.           4OS2A.ICO           A sample 4OS2 icon (see page 4 for more
  127.                               information)
  128.           4OS2B.ICO           Another sample 4OS2 icon
  129.           4OS2H.MSG           4OS2 quick-help text (for "/?" help)
  130.           LICENSE.DOC         The 4OS2 shareware license agreement
  131.           ORDER.FRM           4OS2 shareware and upgrade order forms 
  132.           ORDERINF.DOC        Ordering and product information
  133.           README.DOC          This file
  134.           SHRALIAS.EXE        Utility program for retention of global alias
  135.                               and history lists
  136.           SUPPORT.BBS         Information on Channel 1, the independent BBS
  137.                               used for 4OS2 support
  138.           SYSOP.DOC           4OS2 information for BBS sysops
  139.           VENDOR.DOC          4OS2 information for shareware disk vendors
  140.           4DOSA.ICO           A sample 4DOS icon for use under OS/2 (see
  141.                               page 4 for more information)
  142.           4DOSB.ICO           Another sample 4DOS icon
  143.  
  144.  
  145.    Installing a Downloaded Copy of 4OS2:
  146.  
  147.       (These instructions do not cover diskette installation, because when
  148.       4OS2 is installed from diskette this file is not visible until after
  149.       installation is complete.)
  150.  
  151.       Whether or not you presently have 4OS2 or 4DOS installed, create a
  152.       new directory for this version of 4OS2 (do not install it in the same
  153.       directory as a previous version of 4OS2 or 4DOS).  Place all of the
  154.       downloaded files into the new directory.
  155.  
  156.       You can print the manual, or any 4OS2 documentation file (including
  157.       this one), by copying it to the printer with a command like this:
  158.  
  159.             copy 4os2.doc prn
  160.  
  161.       The documentation files are formatted at 58 lines or less per page,
  162.       and contain form feeds and page footers.  Printing them with a
  163.       program that formats the pages is not likely to work due to the
  164.       formatting already included in each file.
  165.  
  166.       Please note that the 4OS2 manual is about 64 pages long, and the 4DOS
  167.       manual is over 360 pages long.  If you don't want to print these
  168.       files, they can be viewed on-screen with a file viewer such as the
  169.       4OS2 LIST command.  Much of what's in the manuals is also available
  170.  
  171.  
  172.  
  173.    4OS2 1.0  [6-8-92]             README.DOC                         page 3
  174.  
  175.  
  176.       in the 4OS2 HELP system.  However the HELP system is organized
  177.       primarily for quick reference, and may not be the best way to get an
  178.       overview of 4OS2's features or to learn about a topic in depth.
  179.  
  180.       If you do print the 4DOS ASCII manual, ASCTAB.TXT (which comes with
  181.       it) contains a complete ASCII table for pages 336 and 337.  It is
  182.       separate from 4DOS.DOC because many printers can't handle the control
  183.       codes it contains.  If you wish you can print ASCTAB.TXT on your
  184.       printer if possible, and paste it into the manual.  However you
  185.       should be aware that the control codes in this file may make the
  186.       printed output completely unintelligible!  As an alternative, there
  187.       is a complete ASCII table in the 4OS2 HELP system.
  188.  
  189.       To test drive your copy of 4OS2 see the installation instructions in
  190.       Chapter 1 of the manual.  To install it completely, follow the manual
  191.       installation instructions in Chapter 1, disregarding the discussion
  192.       of extracting files from the diskettes.
  193.  
  194.       BE SURE YOU HAVE A BOOTABLE FLOPPY DISK or a copy of your OS/2
  195.       installation disks (as described at the beginning of Chapter 1)
  196.       before installing 4OS2 on your system.  This is not because 4OS2 is
  197.       likely to cause trouble.  It's because a mistake in the system
  198.       startup files or a power failure or other disturbance during
  199.       installation, could prevent your system from booting properly (though
  200.       this is less likely under OS/2 than under DOS).  While such problems
  201.       are rare, any time you modify CONFIG.SYS you should have a bootable
  202.       floppy disk handy so you can recover if necessary.
  203.  
  204.       Be sure to read the notes in chapter 1 of the manual about modifying
  205.       the BOOKSHELF environment variable to make 4OS2's full cross-
  206.       referenced help work properly, and about modifying the DPATH variable
  207.       to make the "/?" quick help work properly.
  208.  
  209.  
  210.    Installing 4OS2 Icons:
  211.  
  212.       We provide several sample icons with 4OS2.  The "A" icon files show
  213.       the 4OS2 / 4DOS logo and product name on a background that matches
  214.       the current folder or desktop color.  The "B" files are the same but
  215.       include a border (you may want to use these for windowed sessions, so
  216.       that the border reminds you the session runs in a window).  You can
  217.       edit any of these icons with the icon editor which comes with OS/2.
  218.  
  219.       To use any icon file for a particular object visible on your OS/2 2.0
  220.       desktop (in this case, for objects which start 4OS2 or 4DOS
  221.       sessions), open the Settings notebook for the object, click on the
  222.       General tab, and then click the Find button next to the current icon
  223.       display.  In the Find window click Locate; in the Locate notebook
  224.       click the Path tab.  Fill in the path to the directory where the
  225.       desired icon file is stored (fill in only the directory name, not the
  226.       full file name) and click OK.  Back in the Find window, click the
  227.       Find button.  When the window opens showing the item(s) found, click
  228.  
  229.  
  230.  
  231.    4OS2 1.0  [6-8-92]             README.DOC                         page 4
  232.  
  233.  
  234.       once on the desired icon, then click the OK button.  Finally, close
  235.       the Settings notebook.
  236.  
  237.       To display a specific icon when a 4OS2 session is minimized, copy the
  238.       icon file to the directory where 4OS2.EXE is stored and name it
  239.       4OS2.ICO.  This step is separate from and independent of the
  240.       instructions above for attaching the icon to a desktop object.
  241.  
  242.  
  243.    Technical Support:
  244.  
  245.       We support 4OS2 in our own CompuServe area, section 10 of the PC
  246.       Vendor B forum (GO JPSOFT or GO PCVENB), and in the ibm.vendors/4dos
  247.       conference on Bix.  If you are not currently a CompuServe subscriber,
  248.       consider a special offer CompuServe has made to JP Software
  249.       customers:  call 1-800-848-8199 (outside the US and Canada call 614-
  250.       457-0802) and ask for operator 178 to receive a free CompuServe
  251.       introductory membership, including user ID, password, and a $15
  252.       connect time credit.
  253.  
  254.       Our CompuServe ID for direct access to our technical support
  255.       personnel is 75300,1215.  Use this ID for technical support issues
  256.       only.  If you have direct CompuServe access please use the PCVENB
  257.       forum (as opposed to Mail) whenever possible.  For technical support
  258.       via BixMail send your mail to "jpsoft"; on the Internet send mail to
  259.       75300.1215@compuserve.com.
  260.  
  261.       Support is also available by phone (617-646-3975), fax (617-646-
  262.       0904), and mail (JP Software, PO Box 1470, E. Arlington, MA 02174). 
  263.       Telephone support hours and availability may vary depending on our
  264.       current staffing pattern and workload; there may not always be a
  265.       support representative available when you call, in which case we will
  266.       take a message and call you back.  We return calls as soon as
  267.       possible, and our policy is to return all calls within at most 24
  268.       hours (weekends and holidays excepted).
  269.  
  270.  
  271.    Bulletin Board Support for 4OS2:
  272.  
  273.       4OS2 product support is always available on our support BBS, Channel
  274.       1 in Boston.  Channel 1 is an independent BBS (not operated by JP
  275.       Software) which has generously offered to provide a home for 4OS2 BBS
  276.       support.  Phone 617-354-8873 to access Channel 1 at 2400 baud; other
  277.       phone numbers are available once you sign up.  To download 4OS2 files
  278.       join conference 5 and then download the file you need.  The file name
  279.       for the latest version of 4OS2 is 4OS2xx.ZIP, where "xx" is the
  280.       version (e.g. 4OS210.ZIP for version 1.0).  On Channel 1 you will be
  281.       able to download 4OS2 files even if they appear to be too large for
  282.       your remaining time on the system.
  283.  
  284.       If you have access to a local bulletin board which is a member of any
  285.       of the major BBS networks (RIME / PC Relay, InterLink, SmartNet, or
  286.  
  287.  
  288.  
  289.    4OS2 1.0  [6-8-92]             README.DOC                         page 5
  290.  
  291.  
  292.       FidoNet), you can obtain support for 4OS2 by leaving messages in the
  293.       network's 4DOS conference.
  294.  
  295.       4OS2 is distributed directly to over 150 bulletin boards worldwide by
  296.       JP Software, and uploaded to many more.  It is impossible for us to
  297.       list the enormous number of boards that have the latest version of
  298.       4OS2, but we encourage you to check your favorite BBS, or use Channel
  299.       1.  If you are a BBS sysop, see SYSOP.DOC for information on
  300.       obtaining a copy of 4OS2 for your BBS.
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.  
  338.  
  339.  
  340.  
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.    4OS2 1.0  [6-8-92]             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, and 2.0.
  355.  
  356.    The only compatibility problem we are aware of as of the release of 4OS2
  357.    is that IBM's Installation Aid program (INSTAID.EXE) does not work
  358.    properly with 4OS2 as the command processor.  INSTAID is most often used
  359.    when installing the OS/2 LAN Services or Extended Services products.  To
  360.    install these products when 4OS2 is your default command processor, set
  361.    up an icon which runs the program x:\OS2\CMD.EXE (where "x" is your OS/2
  362.    boot drive).  Start a session for that icon, and from inside the session
  363.    enter the command:
  364.  
  365.             SET COMSPEC=x:\OS2\CMD.EXE
  366.  
  367.    Then run the installation program from that session.  When the
  368.    installation is done type EXIT to return to the OS/2 desktop.
  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.0  [6-8-92]             README.DOC                         page 7
  406.  
  407.  
  408.    Changes in 4OS2 Version 1.0
  409.    ---------------------------
  410.  
  411.    This section explains the significant changes in 4OS2 between the
  412.    shareware pre-release version 0.95 and the final release of version 1.0. 
  413.    If you are not using version 0.95, you can skip this section.
  414.  
  415.    The change descriptions given here are brief.  For more information on
  416.    features mentioned here see the 4OS2 or 4DOS manual.
  417.  
  418.  
  419.    Initialization
  420.    --------------
  421.  
  422.       There are several enhancements to 4OS2.INI:
  423.  
  424.           * [Primary] and [Secondary] sections are now fully implemented as
  425.             in 4DOS.
  426.  
  427.           * 4OS2.INI settings are now inherited in secondary shells, just
  428.             as in 4DOS.  This includes SETDOS settings (except SETDOS /I).
  429.  
  430.           * 4OS2 now looks for 4OS2.INI in the 4OS2 directory, then in the
  431.             root directory of the boot drive.  It no longer looks in the
  432.             root directory of the drive where 4OS2 is stored.
  433.  
  434.           * The new WindowState directive controls whether 4OS2 maximizes
  435.             or minimizes its own window when started in a windowed session.
  436.  
  437.           * The new ParameterChar directive sets the character used to
  438.             specify all or all remaining command line arguments.
  439.  
  440.           * The new LocalAliases and LocalHistory directives control
  441.             whether 4OS2 starts with local (as opposed to global) alias and
  442.             history lists, respectively.  The old LocalLists directive
  443.             which controlled both lists together has been removed.
  444.  
  445.  
  446.    General Features
  447.    ----------------
  448.  
  449.       The command line length at the keyboard has been increased to 511
  450.       characters.
  451.  
  452.       Include lists can be up to 255 characters long (the previous limit
  453.       was 79 characters).
  454.  
  455.       The "Cancel batch file?" prompt is now sent to STDERR rather than
  456.       STDOUT, in case batch output is redirected.
  457.  
  458.       Drive changes will now save the old drive and directory so it can be
  459.       retrieved with a "CDD -".
  460.  
  461.  
  462.  
  463.    4OS2 1.0  [6-8-92]             README.DOC                         page 8
  464.  
  465.  
  466.       Variable expansion will now work when the variable is within an alias
  467.       and is embedded in the first item on the line.  For example:
  468.  
  469.             c:\> alias mycopy=copy /r
  470.             c:\> set xx=py
  471.             c:\> myco%xx file1 a:
  472.  
  473.       will copy file1 to drive A:, and prompt if the destination file
  474.       already exists.
  475.  
  476.       For compatibility with CMD.EXE, 4OS2 now allows you to run executable
  477.       files without executable extensions (e.g. some LAN Services programs
  478.       run files with .PGM extensions which are really .EXEs).
  479.  
  480.       4OS2 now minimizes its own window when an application starts, and
  481.       restores the old window state when the application exits.
  482.  
  483.       If possible, 4OS2 now displays a 2-line title when its own window is
  484.       minimized while an application is running.
  485.  
  486.       4OS2 now waits for all applications to exit before continuing with
  487.       the next command (unless you use START).  Previously some
  488.       applications were allowed to run and 4OS2 would return to the prompt
  489.       immediately.
  490.  
  491.  
  492.    Commands
  493.    --------
  494.  
  495.       ATTRIB:  Now has a /P(ause) switch to make it easier to display
  496.       attributes for groups of files.
  497.  
  498.       DESCRIBE:  Now supports HPFS long names in the description file.
  499.  
  500.       IF:  Integer tests (i.e., "if 5 lt 12") have been modified to allow
  501.       for - and +, so you can now test things like "if -1 lt 1".
  502.  
  503.       INKEY:  Now translates the ENTER key to its scan code (@28) to
  504.       simplify detection of this keystroke.
  505.  
  506.       PROMPT:  Has a new symbol:  $r displays the return code of the last
  507.       command.
  508.  
  509.       SETDOS:  Has a new /P switch to set the character used to specify all
  510.       or all remaining command line arguments.
  511.  
  512.       START:  Added three new switches.  /LA and /LH make the alias and
  513.       history lists local to the session when a 4OS2 session is started
  514.       (the /L switch still works, and is equivalent to /LA /LH).  /WAIT
  515.       will wait for the new session to finish before continuing.  Also, /BG
  516.       and /FG can now be abbreviated as /B and /F respectively.
  517.  
  518.  
  519.  
  520.  
  521.    4OS2 1.0  [6-8-92]             README.DOC                         page 9
  522.  
  523.  
  524.       UNALIAS and UNSET:  Have a new /Q(uiet) option to disable error
  525.       messages if the alias or variable does not exist.
  526.  
  527.  
  528.    Bugs Fixed
  529.    ----------
  530.  
  531.       Local alias and history lists did not work properly in windowed
  532.       sessions.
  533.  
  534.       SHRALIAS was losing the shared alias and history lists if the session
  535.       from which it was run exited immediately after SHRALIAS was loaded.
  536.  
  537.       %_CPU:  Was causing a trap on 286 systems.
  538.  
  539.       %@DATE:  Did not work correctly with non-US date entries (i.e.,
  540.       yy-mm-dd or dd-mm-yy).
  541.  
  542.       CANCEL:  Was failing to terminate succeeding commands on the same
  543.       line in a parent batch file.
  544.  
  545.       FOR:  (@filename) did not work correctly with long lines (>=80
  546.       characters).  The maximum line length now is 255 characters.
  547.  
  548.       LIST:  LIST would get lost during a Find command if input came from a
  549.       pipe with LIST /S.
  550.  
  551.       SETLOCAL:  Could fail if the environment size was increased between
  552.       SETLOCAL and the corresponding ENDLOCAL.
  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.0  [6-8-92]             README.DOC                        page 10
  580.  
  581.