BDESYM Build Instructions

Initial Setup

The following are instructions to build the Block Diagram Editor (BDE) from scratch with the SYMTXT functions turned on.

Ensure that the BDE_LIB_PATH environment variable in configure.h is set to the correct /lib directory.

Ensure that the /lib directory being used contains the proper view and .dat files.

Ensure that the text directory is part of the SUBDIRS variable with in the toplevel Imakefile

Ensure that the BDESYM flag is set in configure.h

cd pr_util

edit Imakefile

Make sure that the CHGEN variable within the makefiles is the current and valid version

cd ../schema

Ensure that the 94sbde_schema.sch is the current 1996 BDESYM schema. This is the schema that has the TT, TA, and SV tables enclosed.

cd ..

make clean

xmkmf -a

BDESYM Cut and Paste Instructions.

The changes outlined below must be made to the CHGEN generated files following CHGEN execution to integrate the 96S523 BDESYM changes.

Note that CHGEN should be run with the -metafile option so that a ~.msdat file suitable for loading the TT/TA environment is available at execute time.

Replacement Routines

After the xmkmf -a is executed there should be some C files generated within the pr_util directory. The following functions in pr_load.c should be modified. Future CHGEN projects should have these macros generated in this way.

Macro replacement routines can be found in : /usr/proj3/case/96s523/bdesym/macro_changes

1. Replace the macro row_decode() [pr_load.c] with bdesym.replacement.row_decode.c
2. Replace the macro row_encode() [pr_load.c] with bdesym.replacement.row_encode.c
3. Replace the macro pr_gen_create() [pr_load.c] with bdesym.replacement.pr_gen_create.c

Remove the following macros from the schema header file generated by CHGEN.

• pr_create()
• pr_set_str()
• pr_get_str()

Add the file bdesym.schema.macro.changes.h to the schema header file generated by CHGEN.

New Routines

1. Add routine bdesym.new.chk_if_string.c to pr_load.c
   

The function pr_gen_create() has been altered to require a second argument by the 96Spring BDESYM project. The prototype for pr_gen_create() in the schema header file should be altered to extern hcg_ptr pr_gen_create(int,char*);

Due to a dependency problem not fixed with the 1996 S BDESYM project the updated schema header file should be located in both the /pr_util directory and the /include directory. Complete this by :

cp 94sbde_schema.h ../include

The bdesym.* replacement files noted in the above document are currently located in $CASE/96s523/bdesym/rcostell/temp.

Return to the main directory:

cd ..

make

On-line Source Locations

The following are locations where the latest source code, documentation, and other data is being kept for the 1996 Spring BDESYM project is kept.

The 1996 Spring BDESYM team source code changes included fixes to CHGEN as well as modifications to the BDE source code located in the /src directory.

CHGEN10 Modifications

/usr/proj3/case/96s523/bdesym/rcostell/chgen10/chgen10/src

BDE Source Code Changes

/usr/proj3/case/96s523/bdesym/rconnell/94sint/src

BDE Schema Code Change

/usr/proj3/case/96s523/bdesym/rconnell/94sint/schema

BDESYM Source Code Changes

/usr/proj3/case/96s523/bdesym/rconnell/94sint/text

Macros Changes

/usr/proj3/case/96s523/bdesym/base/macro_changes

Documentation Location

The following documentation has been completed for the 1996 S BDESYM project.

Microsoft Word (version 6.0)

/usr/proj3/case/96s523/bdesym/base/doc/

Text only

/usr/proj3/case/96s523/bdesym/base/doc/text_only

Diagrams

/usr/proj3/case/96s523/bdesym/base/doc/idraw

HTML Pages

/usr/proj3/case/96s523/bdesym/lechner

Other Data

Test Data

/usr/proj3/case/96s523/bdesym/base/test