From: stephan b. <sg...@us...> - 2004-12-26 09:36:30
|
Update of /cvsroot/pclasses/pclasses2/src/s11n In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv21162/src/s11n Modified Files: SIO.h Log Message: API corrections/additions. Index: SIO.h =================================================================== RCS file: /cvsroot/pclasses/pclasses2/src/s11n/SIO.h,v retrieving revision 1.2 retrieving revision 1.3 diff -u -d -r1.2 -r1.3 --- SIO.h 26 Dec 2004 09:15:27 -0000 1.2 +++ SIO.h 26 Dec 2004 09:36:19 -0000 1.3 @@ -29,14 +29,14 @@ /** The concrete "data node" type used by serialization operations. - Node that it is considered poor form to use an S11nNode's + Note that it is considered poor form to use an S11nNode's API directly, as it's type and interface may change. The - only guaranty the S11nNode's API guarantees is that + only guaranty the S11nNode's API gives is that NodeTraits::funcs(S11nNode &...) operations will work as - expected. More clearly: use NodeTraits to manipulate and - query nodes, not the node API directly. In fact s11n_node's - useful API is all private, so you CAN'T touch it without - going through NodeTraits. :) Gotcha! + expected/documented. More clearly: use NodeTraits to + manipulate and query nodes, not the node API directly. In + fact S11nNode's useful API is all private, so you CAN'T + touch it without going through NodeTraits. :) Gotcha! */ typedef ::P::s11n::s11n_node S11nNode; |