From 55b72128e444b7a6d4f44dddcd2e1575197962a5 Mon Sep 17 00:00:00 2001 From: Andrew Johnson Date: Fri, 18 Jul 2003 16:11:24 +0000 Subject: [PATCH] Added dbd variable keyword. Reorganized the later parts of the file, which were not well-structured HTML and which were causing problems with different versions of Amaya. --- documentation/RELEASE_NOTES.html | 357 +++++++++++++++++-------------- 1 file changed, 196 insertions(+), 161 deletions(-) diff --git a/documentation/RELEASE_NOTES.html b/documentation/RELEASE_NOTES.html index c647e300c..a0f4fe8f2 100644 --- a/documentation/RELEASE_NOTES.html +++ b/documentation/RELEASE_NOTES.html @@ -18,18 +18,35 @@

Changes since 3.14.2

+

New keyword variable() supported in dbd files

+ +

Database definition (.dbd) files can now contain declarations of simple +static variables, a facility intended for driver debugging purposes. These +variable(name) declarations are preserved by dbExpand, and will +be converted by registerRecordDeviceDriver.pl into code that registers them +with iocsh. The variables themselves must be defined in some existing C or +C++ code and marked using the macro epicsExportAddress(type, +name). The initial implementation only supports integers, but other +types will be added soon.

+

macEnvExpand

-

Macro expansion using environment variables as macro definitions

+ +

Macro expansion using environment variables as macro definitions.

iocsh var command

+

For simple applications such as controlling the value of debugging flags. Devlopers with more complex expression handling requirements should consider -use of the cexp package. +use of the cexp package. The available variables are defined +by the new variable dbd file keyword.

iocshArgPersistentString

-

Tell iocsh to make a copy of the argument string before passing it to the handler function.

+ +

Tell iocsh to make a copy of the argument string before passing it to the +handler function.

epicsStrDup

+

Operating-system independent replacement for strdup().

epicsMessageQueue

@@ -44,6 +61,8 @@ buffer. See the Application Developer's Guide (libCom OSI) for details.

epicsMessageQueue must be modified before they can be compiled and used with R3.14.3

+

Error Message Logging

+

A bug occurring only in Microsoft Windows port of the error message logging client was fixed. The symptoms were problems getting a Microsoft Windows based IOC to make entries in the log file.

@@ -150,12 +169,12 @@ macParseDefns was not correct.

dbStaticLib and related programs now accept a new keyword in DBD files:

function(name)
-

Where 'name' is the name of a -function with "C" linkage that is included in the IOC binary. This function -will be automatically registered with the registry at the same time as the -record/device/driver tables, and is intended to make using subroutine records -much easier on non-vxWorks systems.. Prior R3.14 releases required there to -be a static registration routine for such subroutines.

+

Where name is the name of a function with "C" linkage that is +included in the IOC binary. This function will be automatically registered +with the registry at the same time as the record/device/driver tables, and is +intended to make using subroutine records much easier on non-vxWorks +systems.. Prior R3.14 releases required there to be a static registration +routine for such subroutines.

dbStaticLib has two additional routines to support this, dbDumpFunction() and dbWriteFunctionFP(). dbDumpFunction has been added to the iocsh command @@ -169,8 +188,8 @@ errors are being reported.

Solaris build requirement

-

uname must be defined for builds -on solaris hosts because it is used to determine the solaris version.

+

uname must be defined for builds on solaris hosts because it +is used to determine the solaris version.

Linux build note

@@ -182,13 +201,9 @@ such absolute paths to the new make variable SHRLIB_SEARCH_DIRS

RULES.Db

-

A *[nn].db file will be created from an *.template and a *[nn].substitutions file ,where nn has a value between 0 and 99.

+

A *[nn].db file will be created from an +*.template and a *[nn].substitutions file ,where +nn has a value between 0 and 99.

Support for 64 bit long

@@ -426,9 +441,9 @@ value recGblSetSevr(psel,SOFT_ALARM,MAJOR_ALARM) is called.

cdCommands file

Fixed a bug and revised the use of the IOCS_APPL_TOP setting in an -application's /configure/CONFIG file (which specifies the path to -as seen by the IOC) to apply the same modifications to all paths output -in the cdCommands file.

+application's <top>/configure/CONFIG file (which specifies the path to +<top> as seen by the IOC) to apply the same modifications to all paths +output in the cdCommands file.

dbStaticLib

@@ -488,130 +503,140 @@ release.

Build modifications in alpha2 require the following changes to existing R3.14 applications. - - -

EPICS_HOST_ARCH changes

-GNU compiler builds are now determined by the value of EPICS_HOST_ARCH and -are no longer specified in CONFIG_SITE.  All references to the ANSI -(ACC/GCC) and CPLUSPLUS (CCC/G++) macros have been removed.
-  + +

GNU compiler builds are now determined by the value of EPICS_HOST_ARCH and +are no longer specified in CONFIG_SITE.  All references to the ANSI (ACC/GCC) +and CPLUSPLUS (CCC/G++) macros have been removed.

libCom

-Most of the library routines and files starting with the prefix osi have been -changed to start with epics. Several also had major changes to their user -interface. See the latest version of the Application Developer's Guide for -details.
-  + +

Most of the library routines and files starting with the prefix osi have +been changed to start with epics. Several also had major changes to their +user interface. See the latest version of the Application Developer's Guide +for details.

EPICS Release base 3.14.0alpha1 Notes

@@ -625,35 +650,44 @@ iocCore on platforms besides vxWorks.

iocCore is now supported on the following platforms:

-A new version of the Application Developers Guide is available. The following -gives links to the new Application Developer's Guide and to RTEMS information. +
  • vxWorks -

    http://www.aps.anl.gov/epics/modules/base/R3-14.php

    +
    + Tornado II is required.
    +
    • +
  • RTEMS + +
    + An open source real time operating system. It has been tested on + MVME167 and MC68360 processors. RTEMS also supports + powerPC.
    +
    • +
  • solaris + +
    + Has been tested on solaris 2.6 and solaris 8 with Sun workshop 6.0 (C++ + 5.2). Sun workshop 5.0 (C++ 5.0) will not compile this version of + EPICS.
    +
    • +
  • Linux + +
    + Has been tested on Redhat x86 platforms.
    +
    • +
  • winNT + +
    + Testing has been done with visual C++ 6.0.
    +
    • + + +

    A new version of the Application Developers Guide is available. The +following gives links to the new Application Developer's Guide and to RTEMS +information.

    + +
    + http://www.aps.anl.gov/epics/modules/base/R3-14.php

    Most of the Application Developer's Guide has only minor changes. The following are new.

    @@ -674,7 +708,8 @@ It must be emphasized that this is an alpha release.

  • HPUX - No support currently because we could not find good support for multithreading.
    • -Building Applications + +

    Building Applications