home *** CD-ROM | disk | FTP | other *** search
/ Otherware / Otherware_1_SB_Development.iso / amiga / utility / misc / pubchang.lzh / PubChange / PubChange.doc < prev    next >
Encoding:
Text File  |  1992-11-08  |  5.7 KB  |  160 lines
  1.  
  2. NAME
  3.  
  4.    PubChange   (>= OS 2.0 commodity to change the default public screen)
  5.  
  6.  
  7. AUTHOR, VERSION & COPYRIGHT
  8.  
  9.    Steve Koren
  10.    Version 1.0, November 1992
  11.  
  12.    Requires AmigaDos 2.04 or later
  13.  
  14.    PubChange is copyrighted freeware.  It may be distributed on PD disk
  15.    collections costing no more per disk than the price of a current Fish
  16.    disk.  PubChange may be uploaded to BBS systems.  It may not be sold
  17.    for a profit or modified without permission of the author.  However,
  18.    you are free to give it away to friends, etc.
  19.  
  20.  
  21. SYNOPSIS
  22.  
  23.    PubChange [ CX_PRIORITY=n ] [ NEXTSCREEN=string ] [ PREVSCREEN=string ]
  24.              [ WBSCREEN=string ]
  25.  
  26.    Where:
  27.       NEXTSCREEN = The AmigaDOS commodity key specification to bring the
  28.                    next screen to the front.
  29.  
  30.       PREVSCREEN = The AmigaDOS commodity key specification to bring the
  31.                    previous screen to the front.
  32.  
  33.       WBSCREEN   = The AmigaDOS commodity key specification to bring the
  34.                    workbench screen to the front.
  35.  
  36.    See your AmigaDos manual for a description of acceptable commodity
  37.    strings.
  38.  
  39.  
  40. FUNCTION
  41.  
  42.    Brings the next (or previous) screen to the front, and if this new
  43.    screen is a public screen, it is made into the default.  "Shanghai"
  44.    mode is not affected.  It is especially useful with "POP CLI"
  45.    Commodities or other commodities which launch applications on the
  46.    default public screen.  For best rests, it should be used in
  47.    conjunction with a public screen manager utility.
  48.  
  49.  
  50. DESCRIPTION
  51.  
  52.    Public screens in AmigaDos 2.04 and higher are useful to increase the
  53.    size of your working environment or to open windows on application
  54.    screens.  There are many public screen managers available to perform
  55.    the task of opening and closing these public screens in various
  56.    configurations.  However, the use model is not quite intuitive; you
  57.    must always take an explicit and often cumbersome step to make the
  58.    new public screen into the default.  If you fail to do this, all your
  59.    windows will open on the old default public screen instead of the one
  60.    in front.  There are several utilities to pop the current public screen
  61.    to the front whenever a new window opens on it, but I found that
  62.    exactly backwards.  Instead, I preferred that whichever screen happens
  63.    to be in front is made into the default public screen.
  64.  
  65.    PubChange is designed to provide a more intuitive use model.  The
  66.    concept is that whichever screen you bring to the front becomes the
  67.    default screen at the same time as it is brought to the front.  Any
  68.    windows which ask to open on the default public screen will open on
  69.    this screen.
  70.    
  71.    PubChange is a commodity and can be disabled or killed with the
  72.    Commodity Exchange.  It does not have a graphical user interface.
  73.    Instead, it is controlled via workbench icon tooltypes or command line
  74.    arguments.  It should be installed in the WBStartup directory.  The
  75.    supported tooltypes are:
  76.  
  77.       CX_PRIORITY=<n>
  78.       NEXTSCREEN=<string>
  79.       PREVSCREEN=<string>
  80.       WBSCREEN=<string>
  81.  
  82.    NEXTSCREEN brings the next screen to the front, and if this screen is a
  83.    public screen, it is made into the default.  PREVSCREEN brings the
  84.    previous screen to the front, and if it is a public screen it is made
  85.    into the default.  WBSCREEN always brings the workbench screen to the
  86.    front, and this is made into the default public screen.
  87.  
  88.    NOTE: PubChange will *not* set "Shanghai" mode in the public screens it
  89.    brings to the front.  Use your public screen manager to do this for
  90.    alternate public screens, or use the application which has opened the
  91.    public screen to do it for application public screens.
  92.  
  93.    NOTE: If the most recent screen brought to the front with PubChange is
  94.    not a public screen, the default public screen will remain the same as
  95.    it was before this screen was brought to the front.
  96.  
  97.    PubChange can be stopped with the Commodity Exchange, or by double
  98.    clicking again on its workbench icon.  If it detects an error when run
  99.    from workbench, it exits with no error message.  If launched from the
  100.    CLI, it uses its command line parameters as tooltypes, and will set a
  101.    return code as listed below.
  102.  
  103.    The default values for the tooltypes are:
  104.  
  105.       CX_PRIORITY=0
  106.       NEXTSCREEN=lcommand m
  107.       PREVSCREEN=lcommand p
  108.       WBSCREEN=lcommand w
  109.  
  110.    Thus, the left amiga-M combination cycles through screens just as it
  111.    did without PubChange installed, but new screens brought to the front
  112.    will be made into the default public screen.
  113.  
  114.    NOTE:  PubChange was written under AmigaDos 3.0.  However, it only asks
  115.    for 2.04 libraries (V37), so it should also work fine under 2.04.
  116.    However, I haven't been able to test this.
  117.  
  118.    A good public screen manager to use with PubChange is "ScreenManager",
  119.    (sm_1_13c.lzh), a freeware utility by Bernhard M Llemann.  This utility
  120.    lets you set up public screens non-interactively from a startup script,
  121.    in any screen mode in the display database.
  122.  
  123.  
  124. RETURN VALUES
  125.  
  126.    17    - Unable to allocate Cx broker.
  127.  
  128.    18    - Unable to allocate Cx object;
  129.  
  130.    19    - Can't create a message port.  Out of memory?
  131.  
  132.    20    - Can't open an AmigaDos library.  PubChange needs V37 libraries,
  133.            as used by AmigaDos 2.04 or later.  It won't run under 1.3.
  134.  
  135.  
  136. KNOWN BUGS
  137.  
  138.    B1. PubChange does not print out a usage message if called from the
  139.        CLI.  It is best to install it into your WBStartup drawer
  140.  
  141.    B2. There is no GUI.
  142.  
  143.    B3. PubChange doesn't look at the screen "back" gadget - only the
  144.        keyboard equivalents.  Perhaps in the next version.
  145.  
  146.  
  147. BUG REPORTS
  148.  
  149.    Send bug reports to me at:
  150.  
  151.    Steve Koren
  152.    405 Pulsar St.
  153.    Fort Collins, CO 80525 USA
  154.  
  155.    303-226-4985 (USA)
  156.  
  157.    koren@fc.hp.com (email)
  158.  
  159.    I may or may not fix them.  Can't hurt to try though.
  160.