[PATCH: bigreqproto] Add olinks to functions decribed in libX11 documentation.
Matt Dew
marcoz at osource.org
Sun May 22 18:46:32 PDT 2011
This patch is used with the libX11 patch.
It turns the functions listed in this doc into hyperlinks to the
declarations that are in libX11 documentation.
Signed-off-by: Matt Dew <marcoz at osource.org>
---
specs/bigreq.xml | 24 +++++++++++++++++++++---
1 files changed, 21 insertions(+), 3 deletions(-)
diff --git a/specs/bigreq.xml b/specs/bigreq.xml
index c5b08b2..427efee 100644
--- a/specs/bigreq.xml
+++ b/specs/bigreq.xml
@@ -287,9 +287,27 @@
<chapter id='c_language_binding'>
<title>C language binding</title>
-<para>It is desirable for core Xlib, and other extensions, to use this
extension internally when necessary. It is also desirable to make the
use of this extension as transparent as possible to the X client. For
example, if enabling of the extension were delayed until the first time
it was needed, an application that used
<function>XNextRequest</function> to determine the sequence number of a
request would no longer get the correct sequence number. As such,
<function>XOpenDisplay</function> will determine if the extension is
supported by the server and, if it is, enable extended-length
encodings.</para>
-
-<para>The core Xlib functions <function>XDrawLines</function>,
<function>XDrawArcs</function>, <function>XFillPolygon</function>,
<function>XChangeProperty</function>,
<function>XSetClipRectangles</function>, and
<function>XSetRegion</function> are required to use extended-length
encodings when necessary, if supported by the server. Use of
extended-length encodings in other core Xlib functions
(<function>XDrawPoints</function>, <function>XDrawRectangles</function>,
<function>XDrawSegments</function>. <function>XFillArcs</function>,
<function>XFillRectangles</function>, <function>XPutImage</function> is
permitted but not required; an Xlib implementation may choose to split
the data across multiple smaller requests instead.</para>
+<para>It is desirable for core Xlib, and other extensions, to use this
extension internally when necessary. It is also desirable to make the
use of this extension as transparent as possible to the X client. For
example, if enabling of the extension were delayed until the first time
it was needed, an application that used
+<olink targetdoc='libX11'
targetptr='xnextrequest'><function>XNextRequest</function></olink>
+to determine the sequence number of a request would no longer get the
correct sequence number. As such,
+<olink targetdoc='libX11'
targetptr='xopendisplay'><function>XOpenDisplay</function></olink>
+will determine if the extension is supported by the server and, if it
is, enable extended-length encodings.</para>
+
+<para>The core Xlib functions
+<olink targetdoc='libX11'
targetptr='xdrawlines'><function>XDrawLines</function></olink>,
+<olink targetdoc='libX11'
targetptr='xdrawarcs'><function>XDrawArcs</function></olink>,
+<olink targetdoc='libX11'
targetptr='xfillpolygon'><function>XFillPolygon</function></olink>,
+<olink targetdoc='libX11'
targetptr='xchangeproperty'><function>XChangeProperty</function></olink>,
+<olink targetdoc='libX11'
targetptr='xsetcliprectangles'><function>XSetClipRectangles</function></olink>,
and
+<olink targetdoc='libX11'
targetptr='xsetregion'><function>XSetRegion</function></olink>.
+are required to use extended-length encodings when necessary, if
supported by the server. Use of extended-length encodings in other core
Xlib functions
+(<olink targetdoc='libX11'
targetptr='xdrawpoints'><function>XDrawPoints</function></olink>,
+<olink targetdoc='libX11'
targetptr='xdrawrectangles'><function>XDrawRectangles</function></olink>,
+<olink targetdoc='libX11'
targetptr='xdrawsegments'><function>XDrawSegments</function></olink>.
+<olink targetdoc='libX11'
targetptr='xfillarcs'><function>XFillArcs</function></olink>,
+<olink targetdoc='libX11'
targetptr='xfillrectangles'><function>XFillRectangles</function></olink>,
+<olink targetdoc='libX11'
targetptr='xputimage'><function>XPutImage</function></olink>
+is permitted but not required; an Xlib implementation may choose to
split the data across multiple smaller requests instead.</para>
<para>To permit clients to know what the maximum-request-length for
extended-length encodings is, the following function is added to Xlib:
--
1.7.1
More information about the xorg-devel
mailing list