From lechner@cs.uml.edu Sat Feb 11 02:59:39 2006 From: Bob Lechner Message-Id: <200602110759.k1B7xcTa200095@saturn.cs.uml.edu> Subject: Re: chgen docs FYInfo (I attached genDocsList.txt this time)) To: ralmonte@cs.uml.edu (Almonte) Date: Sat, 11 Feb 2006 02:59:38 -0500 (EST) Cc: sfrye@cs.uml.edu (Scot Frye), lechner@cs.uml.edu (Bob Lechner) This replaces my last msg. Please explain 'local CVS on mercury.' - $CASE is NFS-mounted and accessible from mercury saturn venus. You are welcome to begin another CVS repository under $CASE. I recommend putting it inside $CASE/BDEFOX, I made this diry and you (group 05f523) have rwx privileges there: saturn.cs.uml.edu(753)> lg $CASE/BDEFOX total 20 drwxrwxr-x 2 lechner 05f523 4096 Feb 11 02:52 . You can become temp'y owner if necessary. The bde repository area $BDEROOT has howtomake notes for a CVS repository if you need them. loginfo updates can inform me and sfrye of checkins. Please note that pr_util has far too much baggage: pr_init() should be removed (for all chgen apps) and replaced by CVS repository version control. This should not affect bde2fox. R Lechner Forwarded message: > From lechner@cs.uml.edu Sat Feb 11 02:37:39 2006 > Subject: Re: chgen docs FYInfo > To: ralmonte@cs.uml.edu (Robert Almonte) > Cc: lechner@cs.uml.edu (Bob Lechner), sfrye@cs.uml.edu (Scot Frye) > > iSorry this was delayed - by my making yet another search > thru $CASE/gen/ver_*/..doc.. > > This led to the note $CASE/genDocsList.txt, attached below. > > I also produced another note: > $CASE/SWEngProjectList1996to2005.txt > which identifies post-1995 projects by semester and participants. > (except for chgen projects which are chronological in $CASE/gen/ver_#, > with a main thread in the $GENROOT repository. > > I think you need to be aware that pr_util is from chgen > then manual edits. Chgen and pr_util have no idea about bde. > Chgen produces a customized pr_util (schema.h and pr_*.c) > from any application's schema.sch data model (including > its own metaschema data model to boot-strap chgen). > > Most bde bugs are from its X11 graphics, not pr_util. > However, many are caused by incorrect understanding > of pr_util macros,function signatures, and behavior > hidden behind its often unnecessary use of globals. > > Best doc sources for understanding chgen is > the User Manual in $CASE/gen/{ver_8,ver_10log}/doc > and the final reports in $CASE/gen/ver_12/doc and > in $CASE/05s523/05s523Projects -> $CASE/04f522 > > $CASE/gen/{ver_12,ver_13} are refactorings > that make no changes to chgen functionality, > so previous User Manuals are still valid. > Exception: chgen13 adds pr_accessors.c with new > set and get macros that support field encapsulation > and support refactoring of bde and chgen towards gencpp's > class-based coide partitioning. > ------------------------------------- Attachment: $CASE/genDocsList.txt: $CASE/genDocsLst.txt - RJL060210 (Not all gen docs are identified. User Manuals are more tutorial, Final Reports are more aboit implementation problems and solutions. ------------------------------------------------------------ $CASE/gen/ver_8: Best starting place - merged 6.2 and pGen versions (compressed hcg_key fields, filed get and set macros). Contains rev. notes backward thru earlier versions. Preserves and updates earlier tutorial chgen user_manuals. $CASE/gen/ver_9: (can be skipped) see $CASE/95s523/chgenv9.hlp: Allows an alternate (gendb format) schema file input. Generates metadata outout (tables TT and TA) to schema.msdat. ver_9.1 generates code from schema.msdat instead of schema.sch. $CASE/gen/ver_10/doc/*: (can be skipped) Refactorings to add a btree index for pfkeys, add dump_row method. Also porting to 64-bit alpha platform (Mark Aldred). $CASE/gen/ver_10_extensions.hlp: explains gen_v10 extensions (bdesym extensions NOT merged into later versions). $CASE/gen/ver_10log/doc/genv10log_manual.* is the last complete chgen User Manual - it is in LaTex format (.tex/.dvi/.ps) and not compatible with MSWord docs. gen/ver_10.2: Adds bdesym tables XB, TK and SY for symbol table extraction. XB superclass not retained in later versions. Schema update TBD. gen/ver_10log/aareadme: gen/ver_10log was merged with genv11 in the $CASE/99s523/genmerge project by Karner and Spinney. The result was $CASE/gen/ver_11_link. It can log and replay field changes as well as object add/delete. gen/ver_11: gen/ver_10log was merged with genv11 in the $CASE/99s523/genmerge project by Karner and Spinney. The result was $CASE/gen/ver_11_link. It can log and replay field changes as well as object add/delete. Includes an extensive tech report on logging. Provides a bootstrap capability: Phase 1 is generation of schema.msdat using pr_util for metadaata tables TT and TA. Phase 2 is code generation from schema.msdat. gen/ver_12: Sathya Jaganathan upgraded gen/ver_11 to generates pr_log.c which is compatible with bdeReplay.cc Updates pr_util to remove bugs found in bde log/replay and manually added to bde/pr_util. See $CASE/02s522/ There is no user manual for ver_11_link or ver_12 - just a report with updates to the prior version. gen/ver_13: [05s523] upgrades to genv12 to generate bde as well as alpha-compatible code in pr_util. genv13 is still generic, independent of schema.sch. gen/ver_13 is the latest version in the chgen repository at CVSROOT = $CASE/gen/base/Master -----------------------------------------------------------:w > > > From ralmonte@cs.uml.edu Fri Feb 10 09:28:25 2006 > > From: "Robert Almonte" > > To: "Bob Lechner" > > Subject: Re: Current bde executables FYInfo > > > > Hi Prof. Lechner, > > I am trying to continuing the BDE migration to FOX library. I did a local > > CVS on mercury. I know that you once said that two bde projects are > > counterproductive, but bde2fox is not ready for merging it with yours. I > > just want to take it to the same level that BDE is now. > > I need to review the gen manual to get better inside with the bugs, which > > one should I use? > > > > Thanks, > > > > ----- Original Message ----- > > From: "Bob Lechner" > > To: "Bob Lechner" ; "Scot Frye" ; > > "Almonte" > > Sent: Friday, February 10, 2006 12:52 AM > > Subject: Current bde executables FYInfo > > > > > > > [mercury.cs.uml.edu1](151)> echo $RBGB ; cd $RBGB; lg pr*log/*/bin/bde.exe > > > echo $RBGB ; cd $RBGB ; lg pr*log/*/bin/bde.exe > > > /usr/cs/fac1/lechner/bde2alpha_rl/sandbox/bdeNT050526/bdegen13/bde > > > > > > -rwxr-xr-x 1 lechner 05f523 7024608 Feb 9 23:38 > > > pr_util_log/alpha/bin/bde.exe > > > -rwxr-xr-x 1 lechner fac 2113943 Feb 9 23:38 > > > pr_util_log/i386-linux/bin/bde.exe > > > -rwxr-xr-x 1 lechner 05f523 6788688 Feb 9 23:59 > > > pr_util_nolog/alpha/bin/bde.exe > > > -rwxr-xr-x 1 lechner fac 1976882 Feb 10 00:02 > > > pr_util_nolog/i386-linux/bin/bde.exe > > > > > > > > > All information contained in this email is confidential and may be used by the intended recipient only. > > > > ------------=_1139579382-28532-324-- > > >