Add more information about using XDR on various platforms

17 files changed, 204 insertions, 34 deletions

diff --git a/dist/config/config.make b/dist/config/config.make
index 0602490..822e7d2 100644
--- a/dist/config/config.make
+++ b/dist/config/config.make
@@ -105,8 +105,18 @@ XSDE_CDR := n
 # Set to 'y' if you want support for serialization of the C++/Hybrid
 # object model to the XDR (eXternal Data Representation) binary format.
 # This functionality requires the XDR API which is available out of the
-# box on most POSIX systems as part of Sun RPC. On other platforms you
-# may need to install a third-party library which provides the XDR API.
+# box on most POSIX systems as part of Sun RPC. On some systems (e.g.,
+# (Linux, Mac OS X, iPhone OS) this API is part of libc in which case
+# you don't need to link anything extra. On other platforms, the XDR
+# API may require linking to another library (which you can add to the
+# LIBS variable above), such as -lrpc (QNX, LynxOS) or -lnsl. On non-
+# POSIX platforms you may need to install a third-party library which
+# provides the XDR API. Also note that some older versions of the API
+# (e.g., those found on LynxOS) may not support serialization of the
+# long long type. In this case you will get a compilation error saying
+# that xdr_longlong_t and xdr_u_longlong_t are not declared. One way to
+# resolve this is to disable the use of the long long type in XSD/e (see
+# XSDE_LONGLONG above).
 #
 XSDE_XDR := n
 
diff --git a/dist/config/config.nmake b/dist/config/config.nmake
index 8acecbb..8027117 100644
--- a/dist/config/config.nmake
+++ b/dist/config/config.nmake
@@ -104,8 +104,18 @@ XSDE_CDR = n
 # Set to 'y' if you want support for serialization of the C++/Hybrid
 # object model to the XDR (eXternal Data Representation) binary format.
 # This functionality requires the XDR API which is available out of the
-# box on most POSIX systems as part of Sun RPC. On other platforms you
-# may need to install a third-party library which provides the XDR API.
+# box on most POSIX systems as part of Sun RPC. On some systems (e.g.,
+# (Linux, Mac OS X, iPhone OS) this API is part of libc in which case
+# you don't need to link anything extra. On other platforms, the XDR
+# API may require linking to another library (which you can add to the
+# LIBS variable above), such as -lrpc (QNX, LynxOS) or -lnsl. On non-
+# POSIX platforms you may need to install a third-party library which
+# provides the XDR API. Also note that some older versions of the API
+# (e.g., those found on LynxOS) may not support serialization of the
+# long long type. In this case you will get a compilation error saying
+# that xdr_longlong_t and xdr_u_longlong_t are not declared. One way to
+# resolve this is to disable the use of the long long type in XSD/e (see
+# XSDE_LONGLONG above).
 #
 XSDE_XDR = n
 
diff --git a/dist/etc/evc-4.0/config.nmake b/dist/etc/evc-4.0/config.nmake
index b42a80b..078fd69 100644
--- a/dist/etc/evc-4.0/config.nmake
+++ b/dist/etc/evc-4.0/config.nmake
@@ -107,8 +107,18 @@ XSDE_CDR = n
 # Set to 'y' if you want support for serialization of the C++/Hybrid
 # object model to the XDR (eXternal Data Representation) binary format.
 # This functionality requires the XDR API which is available out of the
-# box on most POSIX systems as part of Sun RPC. On other platforms you
-# may need to install a third-party library which provides the XDR API.
+# box on most POSIX systems as part of Sun RPC. On some systems (e.g.,
+# (Linux, Mac OS X, iPhone OS) this API is part of libc in which case
+# you don't need to link anything extra. On other platforms, the XDR
+# API may require linking to another library (which you can add to the
+# LIBS variable above), such as -lrpc (QNX, LynxOS) or -lnsl. On non-
+# POSIX platforms you may need to install a third-party library which
+# provides the XDR API. Also note that some older versions of the API
+# (e.g., those found on LynxOS) may not support serialization of the
+# long long type. In this case you will get a compilation error saying
+# that xdr_longlong_t and xdr_u_longlong_t are not declared. One way to
+# resolve this is to disable the use of the long long type in XSD/e (see
+# XSDE_LONGLONG above).
 #
 XSDE_XDR = n
 
diff --git a/dist/etc/iphone/config-device.make b/dist/etc/iphone/config-device.make
index 8fde555..0713303 100644
--- a/dist/etc/iphone/config-device.make
+++ b/dist/etc/iphone/config-device.make
@@ -112,8 +112,18 @@ XSDE_CDR := n
 # Set to 'y' if you want support for serialization of the C++/Hybrid
 # object model to the XDR (eXternal Data Representation) binary format.
 # This functionality requires the XDR API which is available out of the
-# box on most POSIX systems as part of Sun RPC. On other platforms you
-# may need to install a third-party library which provides the XDR API.
+# box on most POSIX systems as part of Sun RPC. On some systems (e.g.,
+# (Linux, Mac OS X, iPhone OS) this API is part of libc in which case
+# you don't need to link anything extra. On other platforms, the XDR
+# API may require linking to another library (which you can add to the
+# LIBS variable above), such as -lrpc (QNX, LynxOS) or -lnsl. On non-
+# POSIX platforms you may need to install a third-party library which
+# provides the XDR API. Also note that some older versions of the API
+# (e.g., those found on LynxOS) may not support serialization of the
+# long long type. In this case you will get a compilation error saying
+# that xdr_longlong_t and xdr_u_longlong_t are not declared. One way to
+# resolve this is to disable the use of the long long type in XSD/e (see
+# XSDE_LONGLONG above).
 #
 XSDE_XDR := n
 
diff --git a/dist/etc/iphone/config-simulator.make b/dist/etc/iphone/config-simulator.make
index 0f2853d..c4e91d4 100644
--- a/dist/etc/iphone/config-simulator.make
+++ b/dist/etc/iphone/config-simulator.make
@@ -112,8 +112,18 @@ XSDE_CDR := n
 # Set to 'y' if you want support for serialization of the C++/Hybrid
 # object model to the XDR (eXternal Data Representation) binary format.
 # This functionality requires the XDR API which is available out of the
-# box on most POSIX systems as part of Sun RPC. On other platforms you
-# may need to install a third-party library which provides the XDR API.
+# box on most POSIX systems as part of Sun RPC. On some systems (e.g.,
+# (Linux, Mac OS X, iPhone OS) this API is part of libc in which case
+# you don't need to link anything extra. On other platforms, the XDR
+# API may require linking to another library (which you can add to the
+# LIBS variable above), such as -lrpc (QNX, LynxOS) or -lnsl. On non-
+# POSIX platforms you may need to install a third-party library which
+# provides the XDR API. Also note that some older versions of the API
+# (e.g., those found on LynxOS) may not support serialization of the
+# long long type. In this case you will get a compilation error saying
+# that xdr_longlong_t and xdr_u_longlong_t are not declared. One way to
+# resolve this is to disable the use of the long long type in XSD/e (see
+# XSDE_LONGLONG above).
 #
 XSDE_XDR := n
 
diff --git a/dist/etc/lynxos/config-4.2.make b/dist/etc/lynxos/config-4.2.make
index 183566d..9d9d20f 100644
--- a/dist/etc/lynxos/config-4.2.make
+++ b/dist/etc/lynxos/config-4.2.make
@@ -111,8 +111,18 @@ XSDE_CDR := n
 # Set to 'y' if you want support for serialization of the C++/Hybrid
 # object model to the XDR (eXternal Data Representation) binary format.
 # This functionality requires the XDR API which is available out of the
-# box on most POSIX systems as part of Sun RPC. On other platforms you
-# may need to install a third-party library which provides the XDR API.
+# box on most POSIX systems as part of Sun RPC. On some systems (e.g.,
+# (Linux, Mac OS X, iPhone OS) this API is part of libc in which case
+# you don't need to link anything extra. On other platforms, the XDR
+# API may require linking to another library (which you can add to the
+# LIBS variable above), such as -lrpc (QNX, LynxOS) or -lnsl. On non-
+# POSIX platforms you may need to install a third-party library which
+# provides the XDR API. Also note that some older versions of the API
+# (e.g., those found on LynxOS) may not support serialization of the
+# long long type. In this case you will get a compilation error saying
+# that xdr_longlong_t and xdr_u_longlong_t are not declared. One way to
+# resolve this is to disable the use of the long long type in XSD/e (see
+# XSDE_LONGLONG above).
 #
 XSDE_XDR := n
 
diff --git a/dist/etc/lynxos/config-5.0.make b/dist/etc/lynxos/config-5.0.make
index fa0ade0..e4a0634 100644
--- a/dist/etc/lynxos/config-5.0.make
+++ b/dist/etc/lynxos/config-5.0.make
@@ -111,8 +111,18 @@ XSDE_CDR := n
 # Set to 'y' if you want support for serialization of the C++/Hybrid
 # object model to the XDR (eXternal Data Representation) binary format.
 # This functionality requires the XDR API which is available out of the
-# box on most POSIX systems as part of Sun RPC. On other platforms you
-# may need to install a third-party library which provides the XDR API.
+# box on most POSIX systems as part of Sun RPC. On some systems (e.g.,
+# (Linux, Mac OS X, iPhone OS) this API is part of libc in which case
+# you don't need to link anything extra. On other platforms, the XDR
+# API may require linking to another library (which you can add to the
+# LIBS variable above), such as -lrpc (QNX, LynxOS) or -lnsl. On non-
+# POSIX platforms you may need to install a third-party library which
+# provides the XDR API. Also note that some older versions of the API
+# (e.g., those found on LynxOS) may not support serialization of the
+# long long type. In this case you will get a compilation error saying
+# that xdr_longlong_t and xdr_u_longlong_t are not declared. One way to
+# resolve this is to disable the use of the long long type in XSD/e (see
+# XSDE_LONGLONG above).
 #
 XSDE_XDR := n
 
diff --git a/dist/etc/qnx/config-6.3-gcc-2.95.make b/dist/etc/qnx/config-6.3-gcc-2.95.make
index fe97e86..8c8959b 100644
--- a/dist/etc/qnx/config-6.3-gcc-2.95.make
+++ b/dist/etc/qnx/config-6.3-gcc-2.95.make
@@ -110,8 +110,18 @@ XSDE_CDR := n
 # Set to 'y' if you want support for serialization of the C++/Hybrid
 # object model to the XDR (eXternal Data Representation) binary format.
 # This functionality requires the XDR API which is available out of the
-# box on most POSIX systems as part of Sun RPC. On other platforms you
-# may need to install a third-party library which provides the XDR API.
+# box on most POSIX systems as part of Sun RPC. On some systems (e.g.,
+# (Linux, Mac OS X, iPhone OS) this API is part of libc in which case
+# you don't need to link anything extra. On other platforms, the XDR
+# API may require linking to another library (which you can add to the
+# LIBS variable above), such as -lrpc (QNX, LynxOS) or -lnsl. On non-
+# POSIX platforms you may need to install a third-party library which
+# provides the XDR API. Also note that some older versions of the API
+# (e.g., those found on LynxOS) may not support serialization of the
+# long long type. In this case you will get a compilation error saying
+# that xdr_longlong_t and xdr_u_longlong_t are not declared. One way to
+# resolve this is to disable the use of the long long type in XSD/e (see
+# XSDE_LONGLONG above).
 #
 XSDE_XDR := n
 
diff --git a/dist/etc/qnx/config-6.3-gcc-3.3.make b/dist/etc/qnx/config-6.3-gcc-3.3.make
index 59786e5..233e2b5 100644
--- a/dist/etc/qnx/config-6.3-gcc-3.3.make
+++ b/dist/etc/qnx/config-6.3-gcc-3.3.make
@@ -110,8 +110,18 @@ XSDE_CDR := n
 # Set to 'y' if you want support for serialization of the C++/Hybrid
 # object model to the XDR (eXternal Data Representation) binary format.
 # This functionality requires the XDR API which is available out of the
-# box on most POSIX systems as part of Sun RPC. On other platforms you
-# may need to install a third-party library which provides the XDR API.
+# box on most POSIX systems as part of Sun RPC. On some systems (e.g.,
+# (Linux, Mac OS X, iPhone OS) this API is part of libc in which case
+# you don't need to link anything extra. On other platforms, the XDR
+# API may require linking to another library (which you can add to the
+# LIBS variable above), such as -lrpc (QNX, LynxOS) or -lnsl. On non-
+# POSIX platforms you may need to install a third-party library which
+# provides the XDR API. Also note that some older versions of the API
+# (e.g., those found on LynxOS) may not support serialization of the
+# long long type. In this case you will get a compilation error saying
+# that xdr_longlong_t and xdr_u_longlong_t are not declared. One way to
+# resolve this is to disable the use of the long long type in XSD/e (see
+# XSDE_LONGLONG above).
 #
 XSDE_XDR := n
 
diff --git a/dist/etc/qnx/config-6.4.make b/dist/etc/qnx/config-6.4.make
index 3d4f3b6..1435b91 100644
--- a/dist/etc/qnx/config-6.4.make
+++ b/dist/etc/qnx/config-6.4.make
@@ -110,8 +110,18 @@ XSDE_CDR := n
 # Set to 'y' if you want support for serialization of the C++/Hybrid
 # object model to the XDR (eXternal Data Representation) binary format.
 # This functionality requires the XDR API which is available out of the
-# box on most POSIX systems as part of Sun RPC. On other platforms you
-# may need to install a third-party library which provides the XDR API.
+# box on most POSIX systems as part of Sun RPC. On some systems (e.g.,
+# (Linux, Mac OS X, iPhone OS) this API is part of libc in which case
+# you don't need to link anything extra. On other platforms, the XDR
+# API may require linking to another library (which you can add to the
+# LIBS variable above), such as -lrpc (QNX, LynxOS) or -lnsl. On non-
+# POSIX platforms you may need to install a third-party library which
+# provides the XDR API. Also note that some older versions of the API
+# (e.g., those found on LynxOS) may not support serialization of the
+# long long type. In this case you will get a compilation error saying
+# that xdr_longlong_t and xdr_u_longlong_t are not declared. One way to
+# resolve this is to disable the use of the long long type in XSD/e (see
+# XSDE_LONGLONG above).
 #
 XSDE_XDR := n
 
diff --git a/dist/etc/vc-8.0/config-max.nmake b/dist/etc/vc-8.0/config-max.nmake
index 1fb78e5..dba7bcb 100644
--- a/dist/etc/vc-8.0/config-max.nmake
+++ b/dist/etc/vc-8.0/config-max.nmake
@@ -108,8 +108,18 @@ XSDE_CDR = n
 # Set to 'y' if you want support for serialization of the C++/Hybrid
 # object model to the XDR (eXternal Data Representation) binary format.
 # This functionality requires the XDR API which is available out of the
-# box on most POSIX systems as part of Sun RPC. On other platforms you
-# may need to install a third-party library which provides the XDR API.
+# box on most POSIX systems as part of Sun RPC. On some systems (e.g.,
+# (Linux, Mac OS X, iPhone OS) this API is part of libc in which case
+# you don't need to link anything extra. On other platforms, the XDR
+# API may require linking to another library (which you can add to the
+# LIBS variable above), such as -lrpc (QNX, LynxOS) or -lnsl. On non-
+# POSIX platforms you may need to install a third-party library which
+# provides the XDR API. Also note that some older versions of the API
+# (e.g., those found on LynxOS) may not support serialization of the
+# long long type. In this case you will get a compilation error saying
+# that xdr_longlong_t and xdr_u_longlong_t are not declared. One way to
+# resolve this is to disable the use of the long long type in XSD/e (see
+# XSDE_LONGLONG above).
 #
 XSDE_XDR = n
 
diff --git a/dist/etc/vc-8.0/config-min.nmake b/dist/etc/vc-8.0/config-min.nmake
index 2d4f742..04bc794 100644
--- a/dist/etc/vc-8.0/config-min.nmake
+++ b/dist/etc/vc-8.0/config-min.nmake
@@ -108,8 +108,18 @@ XSDE_CDR = n
 # Set to 'y' if you want support for serialization of the C++/Hybrid
 # object model to the XDR (eXternal Data Representation) binary format.
 # This functionality requires the XDR API which is available out of the
-# box on most POSIX systems as part of Sun RPC. On other platforms you
-# may need to install a third-party library which provides the XDR API.
+# box on most POSIX systems as part of Sun RPC. On some systems (e.g.,
+# (Linux, Mac OS X, iPhone OS) this API is part of libc in which case
+# you don't need to link anything extra. On other platforms, the XDR
+# API may require linking to another library (which you can add to the
+# LIBS variable above), such as -lrpc (QNX, LynxOS) or -lnsl. On non-
+# POSIX platforms you may need to install a third-party library which
+# provides the XDR API. Also note that some older versions of the API
+# (e.g., those found on LynxOS) may not support serialization of the
+# long long type. In this case you will get a compilation error saying
+# that xdr_longlong_t and xdr_u_longlong_t are not declared. One way to
+# resolve this is to disable the use of the long long type in XSD/e (see
+# XSDE_LONGLONG above).
 #
 XSDE_XDR = n
 
diff --git a/dist/etc/vc-9.0/config-max.nmake b/dist/etc/vc-9.0/config-max.nmake
index 585ff0e..46d7f28 100644
--- a/dist/etc/vc-9.0/config-max.nmake
+++ b/dist/etc/vc-9.0/config-max.nmake
@@ -108,8 +108,18 @@ XSDE_CDR = n
 # Set to 'y' if you want support for serialization of the C++/Hybrid
 # object model to the XDR (eXternal Data Representation) binary format.
 # This functionality requires the XDR API which is available out of the
-# box on most POSIX systems as part of Sun RPC. On other platforms you
-# may need to install a third-party library which provides the XDR API.
+# box on most POSIX systems as part of Sun RPC. On some systems (e.g.,
+# (Linux, Mac OS X, iPhone OS) this API is part of libc in which case
+# you don't need to link anything extra. On other platforms, the XDR
+# API may require linking to another library (which you can add to the
+# LIBS variable above), such as -lrpc (QNX, LynxOS) or -lnsl. On non-
+# POSIX platforms you may need to install a third-party library which
+# provides the XDR API. Also note that some older versions of the API
+# (e.g., those found on LynxOS) may not support serialization of the
+# long long type. In this case you will get a compilation error saying
+# that xdr_longlong_t and xdr_u_longlong_t are not declared. One way to
+# resolve this is to disable the use of the long long type in XSD/e (see
+# XSDE_LONGLONG above).
 #
 XSDE_XDR = n
 
diff --git a/dist/etc/vc-9.0/config-min.nmake b/dist/etc/vc-9.0/config-min.nmake
index 1b141df..50d7272 100644
--- a/dist/etc/vc-9.0/config-min.nmake
+++ b/dist/etc/vc-9.0/config-min.nmake
@@ -108,8 +108,18 @@ XSDE_CDR = n
 # Set to 'y' if you want support for serialization of the C++/Hybrid
 # object model to the XDR (eXternal Data Representation) binary format.
 # This functionality requires the XDR API which is available out of the
-# box on most POSIX systems as part of Sun RPC. On other platforms you
-# may need to install a third-party library which provides the XDR API.
+# box on most POSIX systems as part of Sun RPC. On some systems (e.g.,
+# (Linux, Mac OS X, iPhone OS) this API is part of libc in which case
+# you don't need to link anything extra. On other platforms, the XDR
+# API may require linking to another library (which you can add to the
+# LIBS variable above), such as -lrpc (QNX, LynxOS) or -lnsl. On non-
+# POSIX platforms you may need to install a third-party library which
+# provides the XDR API. Also note that some older versions of the API
+# (e.g., those found on LynxOS) may not support serialization of the
+# long long type. In this case you will get a compilation error saying
+# that xdr_longlong_t and xdr_u_longlong_t are not declared. One way to
+# resolve this is to disable the use of the long long type in XSD/e (see
+# XSDE_LONGLONG above).
 #
 XSDE_XDR = n
 
diff --git a/dist/etc/vxworks/config-5.5.1.make b/dist/etc/vxworks/config-5.5.1.make
index 65d96ad..f3d3521 100644
--- a/dist/etc/vxworks/config-5.5.1.make
+++ b/dist/etc/vxworks/config-5.5.1.make
@@ -111,8 +111,18 @@ XSDE_CDR := n
 # Set to 'y' if you want support for serialization of the C++/Hybrid
 # object model to the XDR (eXternal Data Representation) binary format.
 # This functionality requires the XDR API which is available out of the
-# box on most POSIX systems as part of Sun RPC. On other platforms you
-# may need to install a third-party library which provides the XDR API.
+# box on most POSIX systems as part of Sun RPC. On some systems (e.g.,
+# (Linux, Mac OS X, iPhone OS) this API is part of libc in which case
+# you don't need to link anything extra. On other platforms, the XDR
+# API may require linking to another library (which you can add to the
+# LIBS variable above), such as -lrpc (QNX, LynxOS) or -lnsl. On non-
+# POSIX platforms you may need to install a third-party library which
+# provides the XDR API. Also note that some older versions of the API
+# (e.g., those found on LynxOS) may not support serialization of the
+# long long type. In this case you will get a compilation error saying
+# that xdr_longlong_t and xdr_u_longlong_t are not declared. One way to
+# resolve this is to disable the use of the long long type in XSD/e (see
+# XSDE_LONGLONG above).
 #
 XSDE_XDR := n
 
diff --git a/dist/etc/vxworks/config-6.4-max.make b/dist/etc/vxworks/config-6.4-max.make
index ac063e4..39ec8ae 100644
--- a/dist/etc/vxworks/config-6.4-max.make
+++ b/dist/etc/vxworks/config-6.4-max.make
@@ -122,8 +122,18 @@ XSDE_CDR := n
 # Set to 'y' if you want support for serialization of the C++/Hybrid
 # object model to the XDR (eXternal Data Representation) binary format.
 # This functionality requires the XDR API which is available out of the
-# box on most POSIX systems as part of Sun RPC. On other platforms you
-# may need to install a third-party library which provides the XDR API.
+# box on most POSIX systems as part of Sun RPC. On some systems (e.g.,
+# (Linux, Mac OS X, iPhone OS) this API is part of libc in which case
+# you don't need to link anything extra. On other platforms, the XDR
+# API may require linking to another library (which you can add to the
+# LIBS variable above), such as -lrpc (QNX, LynxOS) or -lnsl. On non-
+# POSIX platforms you may need to install a third-party library which
+# provides the XDR API. Also note that some older versions of the API
+# (e.g., those found on LynxOS) may not support serialization of the
+# long long type. In this case you will get a compilation error saying
+# that xdr_longlong_t and xdr_u_longlong_t are not declared. One way to
+# resolve this is to disable the use of the long long type in XSD/e (see
+# XSDE_LONGLONG above).
 #
 XSDE_XDR := n
 
diff --git a/dist/etc/vxworks/config-6.4-min.make b/dist/etc/vxworks/config-6.4-min.make
index a9f9ba5..70efda2 100644
--- a/dist/etc/vxworks/config-6.4-min.make
+++ b/dist/etc/vxworks/config-6.4-min.make
@@ -110,8 +110,18 @@ XSDE_CDR := n
 # Set to 'y' if you want support for serialization of the C++/Hybrid
 # object model to the XDR (eXternal Data Representation) binary format.
 # This functionality requires the XDR API which is available out of the
-# box on most POSIX systems as part of Sun RPC. On other platforms you
-# may need to install a third-party library which provides the XDR API.
+# box on most POSIX systems as part of Sun RPC. On some systems (e.g.,
+# (Linux, Mac OS X, iPhone OS) this API is part of libc in which case
+# you don't need to link anything extra. On other platforms, the XDR
+# API may require linking to another library (which you can add to the
+# LIBS variable above), such as -lrpc (QNX, LynxOS) or -lnsl. On non-
+# POSIX platforms you may need to install a third-party library which
+# provides the XDR API. Also note that some older versions of the API
+# (e.g., those found on LynxOS) may not support serialization of the
+# long long type. In this case you will get a compilation error saying
+# that xdr_longlong_t and xdr_u_longlong_t are not declared. One way to
+# resolve this is to disable the use of the long long type in XSD/e (see
+# XSDE_LONGLONG above).
 #
 XSDE_XDR := n