   
                           Photon 1.14 for QNX 4.25
                                       
  Release Notes
  
   This file is divided into these sections:
   
    1. Known problems - problems/bugs in this release.
    2. Important information - helpful hints for installation and
       configuration.
    3. Upgrading - notes for users upgrading their version of Photon.
    4. Errata - corrections to documentation.
       
                              A word about QUICS
                                       
   QNX Software System's Interactive Conferencing System (QUICS) is
   available to all QNX users. QUICS allows users to download QNX product
   software updates and QNX freeware; it also provides a conferencing
   system and technical support forum. (In order to access software
   updates of QNX products, you'll need the serial number found on the
   back of your original disks.)
   
   To connect to QUICS, use the qtalk utility and dial 1-613-591-0934.
   QUICS is also accessible from the Internet for telnet and ftp access
   at quics.qnx.com and ftp.qnx.com.
   
   Note that the shipped version of the file /etc/config/qtalk contains
   an entry for QUICS. Simply type:
   
     qtalk quics

                           Section 1: Known problems
                                       
PtText

     * In PtText widget, double-clicking on a word doesn't select it.
       
ped

     * The ped File Selector dialog always shows the .* files, even when
       the filename pattern is * or *.*
     * The ped text-widget expects the supplied text to be UTF-8. The
       text provided will be truncated at the first invalid character
       encountered.
       
  Photon libs
  
     * When adjusting a widget's visibility within a signal handler,
       objects beneath the widget may not be exposed properly.
       
                       Section 2: Important information
                                       
Backdrops

   You'll find a comprehensive set of backdrops in:
   
     /etc/backdrops
   
Input/inputrap

   If you're not running Dev.ser and you have a PnP Mouse connected to
   your system, then you must create a /etc/config/trap/input.node config
   file. This file should contain the arguments inputtrap will pass to
   Input.
   
   When an input.node file exists, inputtrap doesn't probe for input
   devices - it simply invokes Input with the arguments you specify in
   the file. If you don't include this file, your system may hang when
   inputtrap starts Input.
   
  Creating an input.node file
  
   To reduce the likelihood of typing errors, you can query inputtrap and
   redirect the output to an initial input.node file, which you may then
   edit:
   
     touch /etc/config/trap/input.node
     inputtrap query > /etc/config/trap/input.node

   where node is the logical node number assigned to the computer.
   Although the input.node file doesn't have a line-oriented structure,
   you may find it convenient to list each protocol module (along with
   its options and arguments) on a separate line. Since the result
   resembles a simple script, you may think of each hardware module as an
   "executable." After you remove the protocol modules you won't need,
   the contents of your input.node file might look like this:
   
     kbd
     fd -d/dev/kbd
     msoft
     fd -d/dev/ser1

   To determine which protocol modules to select for your hardware, type
   use Input for a description of the modules, options, and arguments.
   
Photon Application Builder (PhAB)

   If you're including printing support or using the PtDBConatiner widget
   in your application, you'll need to modify your default Makefile to
   link in the render library. (PhAB-generated Makefiles include it by
   default.)
   
   To include the render library, add -l phrender_s to the FLAGS in your
   Makefile as shown below:
   

  LDFLAGS = -v$(PLATFORM) -3 -mf $(DEBUG) -l Aplib -l phrtlib -l phexlib
            -l phcontrib -l photon   -l phrender_s
  SDFLAGS = -v$(PLATFORM) -3 -mf $(DEBUG) -l Aplib -l phrtlib -l phexlib
            -l phcontrib -l photon_s -l phrender_s


                             Section 3: Upgrading
                                       
What's changed with this release?

   See the file /etc/readme/photon1.13to1.14.changes for information
   about changes since the last release of Photon.
   
Note to Beta sites

   If you're a Beta site for:
   
   qwphi
          QNX Windows/Photon Interface
          
   phjp
          Photon Japanese Supplement
          
   The above Beta packages all create links from /usr/photon/... into
   /qnx4/*/.... When you upgrade to the Photon 1.14 release, these links
   will need to be recreated for each of the products. The setup script
   for Photon Runtime will do this for you, provided you have the latest
   updates for all of the above Betas you're enrolled in.
   
   To check if you have the latest updates for your Betas, see if the
   following files are on your system:
   
     /qnx4/qwphi/.restore_phrt
     /qnx4/phjp/.restore_phrt

   These files are actually shell scripts that will do the necessary
   setup for each of the Beta packages. The Photon install program will
   check for these scripts, tell you about them, and execute them. Each
   of the scripts will recreate the necessary links for that package.
   
Upgrading from Photon 1.12

   After installing the upgrade, you'll need to remove the
   /usr/photon/appbuilder path for the Photon Application Builder in the
   Command field in the PDM Configuration dialog. The command should
   simply be appbuilder (i.e. no path).
   
Upgrading from Photon 1.10 or Photon 1.11

   Most of the files shipped with Photon 1.14 are shipped under the
   directory /qnx4/photon/. None of the files under /usr/photon1.1x/ will
   be overwritten or removed. Once you're satisfied with your new
   install, you can remove /usr/photon1.1x.
   
  .photon configuration files
  
   All of your current users' configuration files are compatible with
   this release.
   
   You can add icons to your desktop for two new Photon applications:
   
     * prsetup
     * fontcfg
       
   Icons for these applications will be included in the Utilities group
   folder for all new users.
   
   You can add the new icons by using the PDM configuration tool. (See
   the docs on pdm in the Installation & Configuration manual for details
   on adding quick-launch applications and their icons to PDM.)
   
  /etc/config/trap/crt.node graphics driver trap files
  
   Whenever a new version of crttrap is installed on your system, you
   should issue the command crttrap clear to remove your old trap file.
   Old trap files may be incompatible with the new crttrap.
   
Upgrading from Photon 1.00

   Most of the files shipped with Photon 1.14 are shipped under the
   directory /qnx4/photon/. All of the files shipped with Photon 1.00
   will be moved to /usr/photon1.00/.. when the setup script runs.
   
   For example, /usr/photon/bin will be moved to /usr/photon1.00/bin.
   
   Once you're satisfied with your new install, you can remove
   /usr/photon1.00.
   
  Ghosting
  
   To dim a widget in Photon 1.0, you had to either change the color
   and/or image. In Photon 1.14, you can get a "disabled" look on any
   widget by setting the Pt_GHOST flag. At the time of release, the
   following widgets support the ghosting flag:
   
     PtButton
     PtComboBox
     PtFileSel
     PtLabel
     PtMenuButton
     PtNumericFloat
     PtNumericInteger
     PtOnOffButton
     PtText
     PtToggleButton
     PtTree
       
  Changes to PgColor_t structure
  
   Since Photon 1.1x, the PgColor_t structure has been modified to
   reverse the Red and Blue components. This makes the structure in sync
   with most graphic card manufacturers and ensures that there won't be
   any performance penalty in the future when high-color and true-color
   drivers are more commonly used.
   
   As a result of this change, all applications built before Photon 1.1x
   will need to be re-compiled. If your application was built with PhAB,
   you'll need to re-load, generate, and re-make it. If you manually
   manipulate color palettes or have hard-coded RGB values, you'll need
   to reverse the Red and Blue components.
   
  int10
  
   The graphics drivers in Photon 1.00 required the int10 server to be
   running. The drivers since Photon 1.1x no longer require int10.
   
  Pointer
  
   Input has replaced Pointer, which will be removed from /bin during the
   install.
   
  videotrap
  
   In Photon 1.0, videotrap was used to determine the appropriate video
   driver. Since Photon 1.1x, crttrap now handles this.
   
  refresh utilities
  
   In Photon 1.00, refresh_m64 and refresh_s3 were used to set the
   refresh rate on Mach 64 and S3 video cards. These utilities are no
   longer needed, because Photon 1.1x ships with a new graphics mode
   utility called phgrafx. These utilities will be left on your system
   (because they may still be useful, e.g. to set up your video card for
   QNX Windows.)
   
  New shared library for backward compatibility
  
   To maintain backward compatibility, Photon 1.1x ships with the Photon
   1.0 shared library. This allows applications written for Photon 1.0 to
   work with Photon 1.14. If you'd like your application to use the new
   shared library, you must re-compile all the modules and re-link the
   application. If you're using PhAB, this is done automatically when you
   re-build the application.
   
   Before the Photon 1.0 shared library is removed, all the shared
   library applications must be re-built.
   
  .photon configuration files
  
   After installing Photon 1.14, you should move all users' config files
   to $HOME/.photon.old. Each user will then need to re-configure Photon
   with their personal preferences. When you're satisfied with the Photon
   1.14 install, you can remove all of the .photon.old configuration
   directories.
   
                               Section 4: Errata
                                       
   On the Photon 1.14 desktop you'll now find an icon for the QNX Product
   Suite CD installer. If you didn't install from CD originally, but you
   want to install a product from the CD now:
   
    1. Insert the QNX Product Suite CD in the CD-ROM drive.

    2. Start the CD-ROM filesystem manager:

       Iso9660fsys &

    3. Enter the following command:

       prefix -A /cd=/cdX

       where X is the name that Iso9660fsys assigned to the drive (e.g.
       "0").

    4. Click on the icon to launch the QNX Product Suite CD installer.
