mirror of
https://gitlab.freedesktop.org/xorg/proto/xorgproto.git
synced 2026-05-07 11:58:13 +02:00
spec: Convert .DS/.DE nroff sections to <literallayout> tags
Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>
This commit is contained in:
Alan Coopersmith
parent
f1309dd259
commit
78806c9fc4
1 changed files with 83 additions and 83 deletions
|
|
@ -3913,14 +3913,14 @@ is specified or the specified type matches the actual type of the property,
|
|||
then the return type is the actual type of the property,
|
||||
the format is the actual format of the property (never zero),
|
||||
and the bytes-after and value are as follows, given:
|
||||
<!-- .DS -->
|
||||
N = actual length of the stored property in bytes
|
||||
\ \ \ \ (even if the format is 16 or 32)
|
||||
I = 4 * long-offset
|
||||
T = N - I
|
||||
L = MINIMUM(T, 4 * long-length)
|
||||
A = N - (I + L)
|
||||
<!-- .DE -->
|
||||
<literallayout class="monospaced">
|
||||
N = actual length of the stored property in bytes
|
||||
(even if the format is 16 or 32)
|
||||
I = 4 * long-offset
|
||||
T = N - I
|
||||
L = MINIMUM(T, 4 * long-length)
|
||||
A = N - (I + L)
|
||||
</literallayout>
|
||||
</para>
|
||||
<para>
|
||||
The returned value starts at byte index I in the property (indexing from 0),
|
||||
|
|
@ -6161,26 +6161,26 @@ If either min-byte1 or max-byte1 are nonzero,
|
|||
then both min-char-or-byte2 and max-char-or-byte2 will be less than 256,
|
||||
and the 2-byte character index values corresponding to char-infos element N
|
||||
(counting from 0) are:
|
||||
<!-- .DS -->
|
||||
byte1 = N/D + min-byte1
|
||||
byte2 = N\\\\D + min-char-or-byte2
|
||||
<!-- .DE -->
|
||||
<literallayout class="monospaced">
|
||||
byte1 = N/D + min-byte1
|
||||
byte2 = N\\D + min-char-or-byte2
|
||||
</literallayout>
|
||||
</para>
|
||||
<para>
|
||||
where:
|
||||
<!-- .DS -->
|
||||
D = max-char-or-byte2 - min-char-or-byte2 + 1
|
||||
/ = integer division
|
||||
\\\\ = integer modulus
|
||||
<!-- .DE -->
|
||||
<literallayout class="monospaced">
|
||||
D = max-char-or-byte2 - min-char-or-byte2 + 1
|
||||
/ = integer division
|
||||
\\ = integer modulus
|
||||
</literallayout>
|
||||
</para>
|
||||
<para>
|
||||
If char-infos has length zero,
|
||||
then min-bounds and max-bounds will be identical,
|
||||
and the effective char-infos is one filled with this char-info, of length:
|
||||
<!-- .DS -->
|
||||
L = D * (max-byte1 - min-byte1 + 1)
|
||||
<!-- .DE -->
|
||||
<literallayout class="monospaced">
|
||||
L = D * (max-byte1 - min-byte1 + 1)
|
||||
</literallayout>
|
||||
</para>
|
||||
<para>
|
||||
That is,
|
||||
|
|
@ -6207,19 +6207,19 @@ nonexistent characters).
|
|||
The bounding box of the font (that is, the
|
||||
smallest rectangle enclosing the shape obtained by superimposing all
|
||||
characters at the same origin [x,y]) has its upper-left coordinate at:
|
||||
<!-- .DS -->
|
||||
[x + min-bounds.left-side-bearing, y - max-bounds.ascent]
|
||||
<!-- .DE -->
|
||||
<literallayout class="monospaced">
|
||||
[x + min-bounds.left-side-bearing, y - max-bounds.ascent]
|
||||
</literallayout>
|
||||
with a width of:
|
||||
<!-- .DS -->
|
||||
max-bounds.right-side-bearing - min-bounds.left-side-bearing
|
||||
<!-- .DE -->
|
||||
<literallayout class="monospaced">
|
||||
max-bounds.right-side-bearing - min-bounds.left-side-bearing
|
||||
</literallayout>
|
||||
</para>
|
||||
<para>
|
||||
and a height of:
|
||||
<!-- .DS -->
|
||||
max-bounds.ascent + max-bounds.descent
|
||||
<!-- .DE -->
|
||||
<literallayout class="monospaced">
|
||||
max-bounds.ascent + max-bounds.descent
|
||||
</literallayout>
|
||||
</para>
|
||||
<para>
|
||||
The font-ascent is the logical extent of the font above the baseline
|
||||
|
|
@ -6244,27 +6244,27 @@ For a character origin at [x,y],
|
|||
the bounding box of a character (that is,
|
||||
the smallest rectangle enclosing the character's shape), described in
|
||||
terms of CHARINFO components, is a rectangle with its upper-left corner at:
|
||||
<!-- .DS -->
|
||||
[x + left-side-bearing, y - ascent]
|
||||
<!-- .DE -->
|
||||
<literallayout class="monospaced">
|
||||
[x + left-side-bearing, y - ascent]
|
||||
</literallayout>
|
||||
</para>
|
||||
<para>
|
||||
with a width of:
|
||||
<!-- .DS -->
|
||||
right-side-bearing - left-side-bearing
|
||||
<!-- .DE -->
|
||||
<literallayout class="monospaced">
|
||||
right-side-bearing - left-side-bearing
|
||||
</literallayout>
|
||||
</para>
|
||||
<para>
|
||||
and a height of:
|
||||
<!-- .DS -->
|
||||
ascent + descent
|
||||
<!-- .DE -->
|
||||
<literallayout class="monospaced">
|
||||
ascent + descent
|
||||
</literallayout>
|
||||
</para>
|
||||
<para>
|
||||
and the origin for the next character is defined to be:
|
||||
<!-- .DS -->
|
||||
[x + character-width, y]
|
||||
<!-- .DE -->
|
||||
<literallayout class="monospaced">
|
||||
[x + character-width, y]
|
||||
</literallayout>
|
||||
</para>
|
||||
<para>
|
||||
Note that the baseline is logically viewed as being just below
|
||||
|
|
@ -6933,7 +6933,7 @@ so the result is:
|
|||
</para>
|
||||
|
||||
<literallayout class="monospaced">
|
||||
((src FUNC dst) AND plane-mask) OR (dst AND (NOT plane-mask))
|
||||
((src FUNC dst) AND plane-mask) OR (dst AND (NOT plane-mask))
|
||||
</literallayout>
|
||||
|
||||
<para>
|
||||
|
|
@ -7070,8 +7070,8 @@ width w is a rectangle with vertices at the following real coordinates:
|
|||
</para>
|
||||
|
||||
<literallayout class="monospaced">
|
||||
[x1-(w*sn/2), y1+(w*cs/2)], [x1+(w*sn/2), y1-(w*cs/2)],
|
||||
[x2-(w*sn/2), y2+(w*cs/2)], [x2+(w*sn/2), y2-(w*cs/2)]
|
||||
[x1-(w*sn/2), y1+(w*cs/2)], [x1+(w*sn/2), y1-(w*cs/2)],
|
||||
[x2-(w*sn/2), y2+(w*cs/2)], [x2+(w*sn/2), y2-(w*cs/2)]
|
||||
</literallayout>
|
||||
|
||||
<para>
|
||||
|
|
@ -8598,9 +8598,9 @@ This request draws the outlines of the specified rectangles, as if a five-point
|
|||
were specified for each rectangle:
|
||||
</para>
|
||||
<para>
|
||||
<!-- .DS -->
|
||||
[x,y] [x+width,y] [x+width,y+height] [x,y+height] [x,y]
|
||||
<!-- .DE -->
|
||||
<literallayout class="monospaced">
|
||||
[x,y] [x+width,y] [x+width,y+height] [x,y+height] [x,y]
|
||||
</literallayout>
|
||||
</para>
|
||||
<para>
|
||||
The x and y coordinates of each rectangle are relative to the drawable's origin
|
||||
|
|
@ -8730,9 +8730,9 @@ the ellipse (for a circle, the angles and coordinate systems are identical).
|
|||
The relationship between these angles and angles expressed in the normal
|
||||
coordinate system of the screen (as measured with a protractor) is as
|
||||
follows:
|
||||
<!-- .DS -->
|
||||
skewed-angle = atan(tan(normal-angle) * w/h) + adjust
|
||||
<!-- .DE -->
|
||||
<literallayout class="monospaced">
|
||||
skewed-angle = atan(tan(normal-angle) * w/h) + adjust
|
||||
</literallayout>
|
||||
</para>
|
||||
<para>
|
||||
The skewed-angle and normal-angle are expressed in radians (rather
|
||||
|
|
@ -8952,9 +8952,9 @@ Errors:
|
|||
This request fills the specified rectangles, as if a four-point
|
||||
<link linkend="requests:FillPoly"><emphasis role='bold'>FillPoly</emphasis></link>
|
||||
were specified for each rectangle:
|
||||
<!-- .DS -->
|
||||
[x,y] [x+width,y] [x+width,y+height] [x,y+height]
|
||||
<!-- .DE -->
|
||||
<literallayout class="monospaced">
|
||||
[x,y] [x+width,y] [x+width,y+height] [x,y+height]
|
||||
</literallayout>
|
||||
</para>
|
||||
<para>
|
||||
The x and y coordinates of each rectangle are relative to the drawable's origin
|
||||
|
|
@ -9574,21 +9574,21 @@ and specify the baseline starting position (the initial character origin).
|
|||
The effect is first to fill a destination rectangle with the background
|
||||
pixel defined in gc and then to paint the text with the foreground pixel.
|
||||
The upper-left corner of the filled rectangle is at:
|
||||
<!-- .DS -->
|
||||
[x, y - font-ascent]
|
||||
<!-- .DE -->
|
||||
<literallayout class="monospaced">
|
||||
[x, y - font-ascent]
|
||||
</literallayout>
|
||||
</para>
|
||||
<para>
|
||||
the width is:
|
||||
<!-- .DS -->
|
||||
overall-width
|
||||
<!-- .DE -->
|
||||
<literallayout class="monospaced">
|
||||
overall-width
|
||||
</literallayout>
|
||||
</para>
|
||||
<para>
|
||||
and the height is:
|
||||
<!-- .DS -->
|
||||
font-ascent + font-descent
|
||||
<!-- .DE -->
|
||||
<literallayout class="monospaced">
|
||||
font-ascent + font-descent
|
||||
</literallayout>
|
||||
</para>
|
||||
<para>
|
||||
The overall-width, font-ascent, and font-descent are as
|
||||
|
|
@ -11374,9 +11374,9 @@ The first-keycode must be greater than or equal to min-keycode as returned
|
|||
in the connection setup (or a
|
||||
<emphasis role='bold'>Value</emphasis>
|
||||
error results) and:
|
||||
<!-- .DS -->
|
||||
first-keycode + (keysyms-length / keysyms-per-keycode) - 1
|
||||
<!-- .DE -->
|
||||
<literallayout class="monospaced">
|
||||
first-keycode + (keysyms-length / keysyms-per-keycode) - 1
|
||||
</literallayout>
|
||||
</para>
|
||||
<para>
|
||||
must be less than or equal to max-keycode as returned in the connection
|
||||
|
|
@ -11385,9 +11385,9 @@ setup (or a
|
|||
error results).
|
||||
KEYSYM number N (counting from zero) for keycode K has an index
|
||||
(counting from zero) of:
|
||||
<!-- .DS -->
|
||||
(K - first-keycode) * keysyms-per-keycode + N
|
||||
<!-- .DE -->
|
||||
<literallayout class="monospaced">
|
||||
(K - first-keycode) * keysyms-per-keycode + N
|
||||
</literallayout>
|
||||
</para>
|
||||
<para>
|
||||
in keysyms.
|
||||
|
|
@ -11468,9 +11468,9 @@ The first-keycode must be greater than or equal to
|
|||
min-keycode as returned in the connection setup (or a
|
||||
<emphasis role='bold'>Value</emphasis>
|
||||
error results), and:
|
||||
<!-- .DS -->
|
||||
first-keycode + count - 1
|
||||
<!-- .DE -->
|
||||
<literallayout class="monospaced">
|
||||
first-keycode + count - 1
|
||||
</literallayout>
|
||||
</para>
|
||||
<para>
|
||||
must be less than or equal to max-keycode as returned in the connection setup
|
||||
|
|
@ -11478,16 +11478,16 @@ must be less than or equal to max-keycode as returned in the connection setup
|
|||
<emphasis role='bold'>Value</emphasis>
|
||||
error results).
|
||||
The number of elements in the keysyms list is:
|
||||
<!-- .DS -->
|
||||
count * keysyms-per-keycode
|
||||
<!-- .DE -->
|
||||
<literallayout class="monospaced">
|
||||
count * keysyms-per-keycode
|
||||
</literallayout>
|
||||
</para>
|
||||
<para>
|
||||
and KEYSYM number N (counting from zero) for keycode K has an index
|
||||
(counting from zero) of:
|
||||
<!-- .DS -->
|
||||
(K - first-keycode) * keysyms-per-keycode + N
|
||||
<!-- .DE -->
|
||||
<literallayout class="monospaced">
|
||||
(K - first-keycode) * keysyms-per-keycode + N
|
||||
</literallayout>
|
||||
</para>
|
||||
<para>
|
||||
in keysyms.
|
||||
|
|
@ -11773,15 +11773,15 @@ Percent can range from -100 to 100 inclusive (or a
|
|||
<emphasis role='bold'>Value</emphasis>
|
||||
error results).
|
||||
The volume at which the bell is rung when percent is nonnegative is:
|
||||
<!-- .DS -->
|
||||
base - [(base * percent) / 100] + percent
|
||||
<!-- .DE -->
|
||||
<literallayout class="monospaced">
|
||||
base - [(base * percent) / 100] + percent
|
||||
</literallayout>
|
||||
</para>
|
||||
<para>
|
||||
When percent is negative, it is:
|
||||
<!-- .DS -->
|
||||
base + [(base * percent) / 100]
|
||||
<!-- .DE -->
|
||||
<literallayout class="monospaced">
|
||||
base + [(base * percent) / 100]
|
||||
</literallayout>
|
||||
<!-- .sp -->
|
||||
</para>
|
||||
</section>
|
||||
|
|
|
|||
Loading…
Add table
Reference in a new issue