[Modeling-cvs] ProjectModeling/Modeling/doc/UserGuide DefiningaModel.tex,1.39,1.40

[Sebastien B. <sbi...@us...>]

Update of /cvsroot/modeling/ProjectModeling/Modeling/doc/UserGuide
In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv4171/Modeling/doc/UserGuide

Modified Files:
	DefiningaModel.tex 
Log Message:
Fixed ticket #813586: Attribute's field 'usedForLocking' is not documented + portions of the introduction has been rewritten

Index: DefiningaModel.tex
===================================================================
RCS file: /cvsroot/modeling/ProjectModeling/Modeling/doc/UserGuide/DefiningaModel.tex,v
retrieving revision 1.39
retrieving revision 1.40
diff -C2 -d -r1.39 -r1.40
*** DefiningaModel.tex	31 Aug 2003 17:47:28 -0000	1.39
--- DefiningaModel.tex	21 Sep 2004 17:12:09 -0000	1.40
***************
*** 13,21 ****
  XML.
  Both ways are detailed in this chapter. 
! The next section reviews the main concepts of Entity-Relationship Modelling, 
! then each element in a model are examined in details.
  
! The rest of the chapter is dedicated to how such models map onto
! the python description, or PyModel, and the XML description. 
  
  Some included tools may help you with the design and management of your
--- 13,30 ----
  XML.
  Both ways are detailed in this chapter. 
! The next section presents the sample models used in this manual.
! Section~\ref{model-concepts} then reviews the main concepts of
! Entity-Relationship Modelling, then each element in a model are examined in
! details.
  
! The two sections coming after describe how such models map onto, respectively,
! the python description, or PyModel (sect.~\ref{pymodel}), and the XML
! description (sect.~\ref{model-xml-format}).
! 
! Section~\ref{guidelines-gotchas} gives some answers to common design-related
! questions.
! 
! Last, section~\ref{model-design-tools} presents the tools that help you design
! and verify the models, and derive from them db-schema and python code.
  
  Some included tools may help you with the design and management of your
***************
*** 448,451 ****
--- 457,470 ----
  \item[\code{comment}:] a comment, for maintainers of the model. 
  
+ \item[\code{usedForLocking}:] Unused yet, reserved field.
+ 
+   This flag will be used when optimistic locking is implemented. It will
+   indicate which attributes optimistic locking should check when it is about
+   to save changes: if value for attribute \code{lastname} has changed and
+   \code{usedForLocking} is set for that attribute, then under the optimistic
+   locking policy saveChanges() will raise; if the flag is unset, the attribute
+   will be silently overriden (for example, you probably won't mark an object's
+   timestamp as used for locking).
+ 
  \subsubsection{Primary keys\label{attributes-PKs-props}}