Changeset 20421

Show
Ignore:
Timestamp:
07/02/07 08:39:48 (1 year ago)
Author:
patrick
Message:

Document 2.2-2.3.xsl and key_sym_2_0.xsl.

Files:

Legend:

Unmodified
Added
Removed
Modified
Copied
Moved

  • juggler/trunk/modules/vrjuggler/data/xslt/README.txt

    r16274 r20421  
    7777   Alpha 4 and beyond. 
    7878 
    79 Patrick Hartling <patrick@vrjuggler.org> 
     792.2-2.3.xsl 
     80----------- 
     81 
     82   An XSLT stylesheet that provides the upgrade path for configuration files 
     83   created for VR Juggler 2.1/2.2 to VR Juggler 2.3/3.0. This addresses 
     84   configuration updates that cannot be performed by VRJConfig, although 
     85   none of the updates performed by this transform are critical. VRJConfig 
     86   will take care of the important changes; this transform just cleans things 
     87   up by removing config elements that are now defunct. 
     88 
     89   To use this stylesheet with the xsltproc command, run xsltproc as 
     90   follows: 
     91 
     92      xsltproc -o <output>.jconf 2.2-2.3.xsl <input>.jconf 
     93 
     94   To use it with Xalan, run the xalan wrapper (shell script or batch 
     95   file) as follows: 
     96 
     97      xalan -in <input>.jconf -out <output>.jconf -xsl 2.2-2.3.xsl 
     98 
     99   Fill in your input filename and output filename appropriately. 
     100 
     101key_sym_2_0.xsl 
     102--------------- 
     103 
     104   An XSLT stylesheet that provides assistance in migrating from VR Juggler 
     105   2.0 to 2.1 and beyond. VRJConfig has a bug where it will not automatically 
     106   replace numeric values with symbolic values when the config definition 
     107   uses value enumeration. For new configurations, it uses the symbolic 
     108   value, but if a configuration has been migrated forward repeatedly, it may 
     109   contain numeric values. In the case of keyboard keys, mouse buttons, and 
     110   mouse motions, the numeric values changed during VR Juggler 2.1 
     111   development, and as a result, VR Juggler 2.0 configurations using 
     112   keyboard/mouse input may not behave as expected with VR Juggler 2.1 and 
     113   newer. To help work around this, this transform can be applied to VR 
     114   Juggler 2.0 configurations to replace the numeric key/mouse values with 
     115   the symbolic values so that they will migrate forward seamlessly. 
     116 
     117   To use this stylesheet with the xsltproc command, run xsltproc as 
     118   follows: 
     119 
     120      xsltproc -o <output>.jconf key_sym_2_0.xsl <input>.jconf 
     121 
     122   To use it with Xalan, run the xalan wrapper (shell script or batch 
     123   file) as follows: 
     124 
     125      xalan -in <input>.jconf -out <output>.jconf -xsl key_sym_2_0.xsl 
     126 
     127   Fill in your input filename and output filename appropriately. 
     128    
     129   In general, this transform should be applied to all VR Juggler 2.0 
     130   configuration files that contain key_modifier_pair, input_window, and 
     131   display_window config elements. After applying the transform, the 2.0 
     132   configuration files will continue to work with VR Juggler 2.0, and they 
     133   will be ready for migration to VR Juggler 2.2 using VRJConfig. 
     134 
     135Patrick Hartling <patrick@infiscape.com> 
    80136$Id$