|
Check-in Number:
|
3275 | |
| Date: |
2003-Feb-17 13:51:58 (local)
2003-Feb-17 12:51:58 (UTC) |
| User: | rse |
| Branch: | |
| Comment: |
provide a better abstract |
| Tickets: |
|
| Inspections: |
|
| Files: |
|
ossp-pkg/xds/README 1.8 -> 1.9
--- 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
|
|
ossp-pkg/xds/xds.pod 1.17 -> 1.18
--- 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<OSSP xds> 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<OSSP xds>, 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<OSSP xds> library is generic and extensible encoding and decoding
+framework for the serialization of arbitrary ISO C data types. B<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.
-B<OSSP xds> 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<OSSP xds>, the first thing the developer has to
do is to create a valid context by calling xds_init(). The function
|
|
