summaryrefslogtreecommitdiffstats
path: root/c/UPDATE_HELP
diff options
context:
space:
mode:
authorJoel Sherrill <joel.sherrill@OARcorp.com>1995-05-24 21:39:42 +0000
committerJoel Sherrill <joel.sherrill@OARcorp.com>1995-05-24 21:39:42 +0000
commit88d594a3d52cb5938521619bca0def8e5b040cf0 (patch)
treec687a29a2a3d62c87e496c4c4700183f17210a5c /c/UPDATE_HELP
parentbf61e45c29d1cfda3d9a6632d2e9dbd811647f35 (diff)
downloadrtems-88d594a3d52cb5938521619bca0def8e5b040cf0.tar.bz2
Fully tested on all in-house targets
Diffstat (limited to 'c/UPDATE_HELP')
-rw-r--r--c/UPDATE_HELP53
1 files changed, 44 insertions, 9 deletions
diff --git a/c/UPDATE_HELP b/c/UPDATE_HELP
index cf6feffff0..520d99aafc 100644
--- a/c/UPDATE_HELP
+++ b/c/UPDATE_HELP
@@ -2,16 +2,51 @@
# $Id$
#
-In the directory "update_tools", there are a set of tools to aid in
-making the application source changes necessary to address some
-of the changes in the RTEMS API between release 3.1.0 and 3.2.0.
+Between RTEMS 3.1.0 and 3.2.0, every RTEMS defined symbol made visible
+was renamed. This document describes the change and the tools provided
+to assist you in updating your RTEMS 3.1.0 application.
-The primary change addressed by these tools is the addition of
-"rtems_" or "RTEMS_" as a prefix on EVERY user visible RTEMS
-provided constant and routine. The primary factor in the decision
-to make such a sweeping change was conflicts between the
-the RTEMS and POSIX API's.
+[NOTE: This change was not included in snapshots prior to 3.1.15.]
+
+DESCRIPTION OF NAME CHANGES:
+============================
+
+The primary change was the addition of the prefix "rtems_" or "RTEMS_" to
+EVERY user visible RTEMS provided constant and routine. The primary
+factor in the decision to make such a sweeping change was conflicts
+between the the RTEMS and POSIX API's.
+
+
+TO UPDATE YOUR APPLICATION:
+===========================
+
+The update script requires that Perl be installed on your computer.
+It has only been tested with Perl 5.x.
+
+After RTEMS has been built, in the directory "$r/<BSP>/update_tools", will
+be a set of tools to aid in making the application source changes necessary
+to address (hopefully) all of the name changes in the RTEMS API between
+releases 3.1.0 and 3.2.0.
+
+The update shell script is the only executable which is invoked by the
+user directly. The word-replace Perl script is invoked by the update
+shell script.
WARNING: These tools modify the files IN PLACE!!! Backup your
- source before using these tools.
+ source before using these tools.
+
+To udpate your application, change directories to the top of your application
+source tree and execute the update script. It should be something similar
+to the following:
+
+cd MY_APP
+$r/<BSP>/update-tools/update
+
+The update script will ask if you have backed up your source code before
+beginning the update process. While operating on files, it will print
+the name of each file and a dot for each change made to the source file.
+NOTE: These scripts do not attempt to address changes in calling
+ sequences. After the script has run, you will need to update
+ calls to rtems_clock_get(), rtems_timer_fire_after(), and
+ rtems_timer_fire_when() by hand.