summaryrefslogtreecommitdiff
path: root/specs/libX11
diff options
context:
space:
mode:
authorAlan Coopersmith <alan.coopersmith@oracle.com>2018-11-10 13:30:47 -0800
committerAlan Coopersmith <alan.coopersmith@oracle.com>2018-11-10 13:30:47 -0800
commitd7e22252d68258a63ca537827c99d0ac0bc4b9d8 (patch)
treeb755fbfcd855b52a3dd68e97463b2300ed27b613 /specs/libX11
parentf3c978476e0be6813268af494efb7ac507451116 (diff)
downloadxorg-lib-libX11-d7e22252d68258a63ca537827c99d0ac0bc4b9d8.tar.gz
Remove documentation of obsolete B16 & B32 tags in specs/libX11
Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>
Diffstat (limited to 'specs/libX11')
-rw-r--r--specs/libX11/AppC.xml23
1 files changed, 6 insertions, 17 deletions
diff --git a/specs/libX11/AppC.xml b/specs/libX11/AppC.xml
index 8eb1e004..b48aa083 100644
--- a/specs/libX11/AppC.xml
+++ b/specs/libX11/AppC.xml
@@ -2020,7 +2020,7 @@ because it may modify this field.
<para>
<!-- .LP -->
All X requests always contain the length of the request,
-expressed as a 16-bit quantity of 32 bits.
+expressed as a 16-bit quantity of 32 bit words.
This means that a single request can be no more than 256K bytes in
length.
Some servers may not support single requests of such a length.
@@ -2111,17 +2111,6 @@ used in replies, errors, and events.
</para>
<para>
<!-- .LP -->
-To help but not cure portability problems to certain machines, the
-<symbol>B16</symbol>
-and
-<symbol>B32</symbol>
-macros have been defined so that they can become bitfield specifications
-on some machines.
-For example, on a Cray,
-these should be used for all 16-bit and 32-bit quantities, as discussed below.
-</para>
-<para>
-<!-- .LP -->
Most protocol requests have a corresponding structure typedef in
<filename class="headerfile">&lt;X11/Xproto.h&gt;</filename>,
which looks like:
@@ -2136,7 +2125,7 @@ which looks like:
typedef struct _DoSomethingReq {
CARD8 reqType; /* X_DoSomething */
CARD8 someDatum; /* used differently in different requests */
- CARD16 length B16; /* total # of bytes in request, divided by 4 */
+ CARD16 length; /* total # of bytes in request, divided by 4 */
...
/* request-specific data */
...
@@ -2174,8 +2163,8 @@ or
typedef struct _ResourceReq {
CARD8 reqType; /* the request type, e.g. X_DoSomething */
BYTE pad; /* not used */
- CARD16 length B16; /* 2 (= total # of bytes in request, divided by 4) */
- CARD32 id B32; /* the Window, Drawable, Font, GContext, etc. */
+ CARD16 length; /* 2 (= total # of bytes in request, divided by 4) */
+ CARD32 id; /* the Window, Drawable, Font, GContext, etc. */
} xResourceReq;
</synopsis>
</para>
@@ -2224,8 +2213,8 @@ also contains a reply structure typedef:
typedef struct _DoSomethingReply {
BYTE type; /* always X_Reply */
BYTE someDatum; /* used differently in different requests */
- CARD16 sequenceNumber B16; /* # of requests sent so far */
- CARD32 length B32; /* # of additional bytes, divided by 4 */
+ CARD16 sequenceNumber; /* # of requests sent so far */
+ CARD32 length; /* # of additional bytes, divided by 4 */
...
/* request-specific data */
...