Index: ossp-pkg/xds/README RCS File: /v/ossp/cvs/ossp-pkg/xds/README,v rcsdiff -q -kk '-r1.8' '-r1.9' -u '/v/ossp/cvs/ossp-pkg/xds/README,v' 2>/dev/null --- README 2003/02/17 12:36:02 1.8 +++ README 2003/02/17 12:51:58 1.9 @@ -10,7 +10,13 @@ ABSTRACT The OSSP xds library is generic and extensible encoding and decoding - framework for the serialization of arbitrary ISO-C data types. + framework for the serialization of arbitrary ISO C data types. OSSP + xds consists of three components: the generic encoding and decoding + framework, a set of shipped engines to encode and decode values in + certain existing formats (Sun RPC/XDR and XDS/XML are currently + provided), and a run-time context, which is used to manage buffers, + registered engines, etc. The library is designed to allow fully + recursive and efficient encoding/decoding of arbitrary nested data. COPYRIGHT AND LICENSE Index: ossp-pkg/xds/xds.pod RCS File: /v/ossp/cvs/ossp-pkg/xds/xds.pod,v rcsdiff -q -kk '-r1.17' '-r1.18' -u '/v/ossp/cvs/ossp-pkg/xds/xds.pod,v' 2>/dev/null --- xds.pod 2003/02/17 12:36:02 1.17 +++ xds.pod 2003/02/17 12:51:58 1.18 @@ -49,18 +49,16 @@ =head1 DESCRIPTION -The purpose of B is to encode data in a way that allows this -data to be exchanged between different computer systems. Assume you -would want to transfer the value 0x1234 from host A to host B. Then you -would encode it using B, transfer the encoded data over the -network, and decode the value again at the other end. Every program that -follows this process will read the correct value no matter what native -representation is uses internally. +The B library is generic and extensible encoding and decoding +framework for the serialization of arbitrary ISO C data types. B consists of three components: the generic encoding and decoding +framework, a set of shipped engines to encode and decode values in +certain existing formats (Sun RPC/XDR and XDS/XML are currently +provided), and a run-time context, which is used to manage buffers, +registered engines, etc. The library is designed to allow fully +recursive and efficient encoding/decoding of arbitrary nested data. -B consists of three components: The generic encoding and -decoding framework, a set of engines to encode and decode values in a -certain format, and a run-time context, which is used to manage buffers, -registered engines, etc. +=head2 INTRODUCTION In order to use B, the first thing the developer has to do is to create a valid context by calling xds_init(). The function