Changeset 88d594a in rtems for c/UPDATE_HELP


Ignore:
Timestamp:
May 24, 1995, 9:39:42 PM (25 years ago)
Author:
Joel Sherrill <joel.sherrill@…>
Branches:
4.10, 4.11, 4.8, 4.9, 5, master
Children:
5b9d6ddf
Parents:
bf61e45c
Message:

Fully tested on all in-house targets

File:
1 edited

Legend:

Unmodified
Added
Removed
  • c/UPDATE_HELP

    rbf61e45c r88d594a  
    33#
    44
    5 In the directory "update_tools", there are a set of tools to aid in
    6 making the application source changes necessary to address some
    7 of the changes in the RTEMS API between release 3.1.0 and 3.2.0.
     5Between RTEMS 3.1.0 and 3.2.0, every RTEMS defined symbol made visible
     6was renamed.  This document describes the change and the tools provided
     7to assist you in updating your RTEMS 3.1.0 application. 
    88
    9 The primary change addressed by these tools is the addition of
    10 "rtems_" or "RTEMS_" as a prefix on EVERY user visible RTEMS
    11 provided constant and routine.  The primary factor in the decision
    12 to make such a sweeping change was conflicts between the
    13 the RTEMS and POSIX API's.
     9[NOTE:  This change was not included in snapshots prior to 3.1.15.]
     10
     11DESCRIPTION OF NAME CHANGES:
     12============================
     13
     14The primary change was the addition of the prefix "rtems_" or "RTEMS_" to
     15EVERY user visible RTEMS provided constant and routine.  The primary
     16factor in the decision to make such a sweeping change was conflicts
     17between the the RTEMS and POSIX API's. 
     18
     19
     20TO UPDATE YOUR APPLICATION:
     21===========================
     22
     23The update script requires that Perl be installed on your computer.
     24It has only been tested with Perl 5.x.
     25
     26After RTEMS has been built, in the directory "$r/<BSP>/update_tools", will
     27be a set of tools to aid in making the application source changes necessary
     28to address (hopefully) all of the name changes in the RTEMS API between
     29releases 3.1.0 and 3.2.0.
     30
     31The update shell script is the only executable which is invoked by the
     32user directly.  The word-replace Perl script is invoked by the update
     33shell script.
    1434
    1535WARNING: These tools modify the files IN PLACE!!! Backup your
    16   source before using these tools.
     36         source before using these tools.
    1737
     38To udpate your application, change directories to the top of your application
     39source tree and execute the update script.  It should be something similar
     40to the following:
     41
     42cd MY_APP
     43$r/<BSP>/update-tools/update
     44
     45The update script will ask if you have backed up your source code before
     46beginning the update process.  While operating on files, it will print
     47the name of each file and a dot for each change made to the source file. 
     48
     49NOTE: These scripts do not attempt to address changes in calling
     50      sequences.  After the script has run, you will need to update
     51      calls to rtems_clock_get(), rtems_timer_fire_after(), and
     52      rtems_timer_fire_when() by hand.
Note: See TracChangeset for help on using the changeset viewer.