From f3e02cc46a301cd428adf8015405bc3ba3e634ae Mon Sep 17 00:00:00 2001 From: Alan Coopersmith Date: Sat, 11 Jan 2014 15:02:24 -0800 Subject: spec: fix boundaries of tags Conversion from nroff .BR "function" "otherstuff" style markup got confused in a few places. Signed-off-by: Alan Coopersmith --- specs/fsproto.xml | 156 +++++++++++++++++++++++++++--------------------------- 1 file changed, 78 insertions(+), 78 deletions(-) (limited to 'specs') diff --git a/specs/fsproto.xml b/specs/fsproto.xml index b96d2bf..aa23d3a 100644 --- a/specs/fsproto.xml +++ b/specs/fsproto.xml @@ -414,11 +414,11 @@ users over time (for example, print spoolers). -AccessContexts +AccessContexts must be created (with -CreateAC ) +CreateAC) and switched among (with -SetAuthorization ) +SetAuthorization) to represent all of these "font users" properly. @@ -488,9 +488,9 @@ BITMAPFORMAT: This structure specifies how glyph images are transmitted in response to -QueryXBitmaps8 +QueryXBitmaps8 and -QueryXBitmaps16 +QueryXBitmaps16 requests. @@ -522,7 +522,7 @@ For a glyph with extents XCHARINFO in a font with header information XFONTINFO, the IMAGE-RECT values have the following meanings: -ImageRectMin - +ImageRectMin - This refers to the minimal bounding rectangle surrounding the inked pixels in the glyph. This is the most compact representation. The edges of the rectangle @@ -536,7 +536,7 @@ are: -ImageRectMaxWidth - +ImageRectMaxWidth - This refers to the scanlines between the glyph's ascent and descent, padded on the left to the minimum left-bearing (or 0, whichever is less) and on the right to @@ -700,9 +700,9 @@ bit indicates one or more events, and a bit value of one indicates interest in a corresponding set of events. The following bits are defined for event masks specified for the core protocol (i.e. an EXTENSION-OPCODE of zero in -SetEventMask +SetEventMask and -GetEventMask +GetEventMask requests): @@ -713,15 +713,15 @@ requests): If -CatalogueListChangeMask +CatalogueListChangeMask is set, client is interested in receiving -CatalogueListNotify +CatalogueListNotify events. If -FontListChangeMask +FontListChangeMask is set, the client is interested in receiving -FontListNotify +FontListNotify events. @@ -731,14 +731,14 @@ event masks. These event masks have their own scope and may use the same bit values as the core or other extensions. All unused bits must be set to zero. In -SetEventMask +SetEventMask requests, if any bits are set that are not defined for the extension (or core) for which this EVENTMASK is intended (according to the EXTENSION- OPCODE given in the -SetEventMask +SetEventMask request), an -EventMask +EventMask error is generated. This value is swapped as a CARD32. @@ -752,7 +752,7 @@ FONTID: ID
This is specified by the client in the request -OpenBitmapFont +OpenBitmapFont as the identifier to be used when referring to a particular open font. @@ -1157,12 +1157,12 @@ memory) while processing a request, it returns an Alloc error. If a server is deficient (and therefore non-compliant) and is unable to process a request, it may return an Implementation error. If a client uses an extension request without previously having issued a -QueryExtension +QueryExtension request for that extension, the server responds with a -Request +Request error. If the server encounters a request with an unknown MAJOR-OPCODE or MINOR-OPCODE, it responds with a -Request +Request error. At most one error is generated per request. If more than one error condition is encountered in processing a requests, the choice of which error is returned @@ -1400,7 +1400,7 @@ Errors: Alloc This request does nothing. It is typically used in response to a -KeepAlive +KeepAlive event.
@@ -1499,9 +1499,9 @@ The server is free to return different values to different clients. Therefore, clients must use this request before issuing any of the requests in the named extension package or using the -SetEventMask request to express interest in any of +SetEventMask request to express interest in any of this extension's events. Otherwise, a -Request +Request error is returned. @@ -1582,7 +1582,7 @@ is set to zero. Errors: -Alloc , +Alloc, Name @@ -1590,10 +1590,10 @@ This request sets the list of catalogues whose fonts should be visible to the client. The union of the fonts provided by each of the named catalogues forms the set of fonts whose names match patterns in -ListFonts , -ListFontsWithXInfo , +ListFonts, +ListFontsWithXInfo, and -OpenBitmapFont +OpenBitmapFont requests. The catalogue names are case-insensitive and are encoded in ISO 8859-1. A zero-length list resets the client's catalogue list to the @@ -1602,7 +1602,7 @@ server-dependent default. If any of the catalogue names are invalid, a -Name +Name error is returned and the request is ignored. @@ -1655,7 +1655,7 @@ returned in mixed case. Errors: -EventMask , +EventMask, Request @@ -1669,7 +1669,7 @@ requires multiple uses of this request. The default event mask if -SetEventMask +SetEventMask has not been called is zero, indicating no interest in any maskable events. Some events are not maskable and cannot be blocked. @@ -1678,9 +1678,9 @@ Some events are not maskable and cannot be blocked. If EXTENSION-OPCODE is not a valid extension opcode previously returned by -QueryExtension +QueryExtension or zero, a -Request +Request error is returned. If EVENT-MASK contains any bits that do not correspond to valid events for the specified extension (or @@ -1722,7 +1722,7 @@ always sent to the client. If EXTENSION-OPCODE is not a valid extension opcode previously returned by -QueryExtension +QueryExtension or zero, a Request error is returned. @@ -1763,13 +1763,13 @@ Errors: This request creates a new -AccessContext +AccessContext object within the server containing the specified authorization data. When this AccessContext is selected by the client using the -SetAuthorization +SetAuthorization request, the data may be used by the server to determine whether or not the client should be granted access to particular font information. @@ -1779,7 +1779,7 @@ access to particular font information. If STATUS is Denied, the server rejects the client's authorization information and does not associate AC with any valid -AccessContext . +AccessContext. In this case, AUTHORIZATION-INDEX is set to zero, and zero bytes of AUTHORIZATION-DATA is returned. @@ -1829,7 +1829,7 @@ with an access context, an IDChoice error is returned. Errors: -AccessContext , +AccessContext, Alloc @@ -1848,14 +1848,14 @@ established for the initial connection setup. Operations on fonts that were opened under AC are not affected. The client may reuse the value of AC in a subsequent -CreateAC +CreateAC request. If AC isn't associated with any valid authorization previously created by -CreateAC , an -AccessContext +CreateAC, an +AccessContext error is returned. @@ -1876,7 +1876,7 @@ Errors: This request sets the -AccessContext +AccessContext to be used for subsequent requests (except for QueryXInfo, @@ -1885,9 +1885,9 @@ requests (except for QueryXBitmaps8, QueryXBitmaps16 and -CloseFont +CloseFont which are done under the -AccessContext +AccessContext of the corresponding OpenBitmapFont @@ -2018,7 +2018,7 @@ This may be used to synchronize the client with the server. Servers are free to add or remove fonts to the set returned by -ListFonts +ListFonts between any two requests. This request is not cumulative; repeated uses are processed in isolation and do result in an iteration through the list. @@ -2077,7 +2077,7 @@ Errors: This request is similar to -ListFonts +ListFonts except that a separate reply containing the name, header, and property data is generated for each matching font name. Following these @@ -2146,9 +2146,9 @@ Errors: This request looks for a server-dependent choice of the font names that match the specified PATTERN according to the rules described for -ListFonts . +ListFonts. If no matches are found, a -Name +Name error is returned. Otherwise, the server attempts to open the font associated with the chosen name. @@ -2159,7 +2159,7 @@ may use the client's current AccessContext (as set by the most recent -SetAuthorization +SetAuthorization request or the original connection setup) to determine any client-specific sets of permissions. After the font has been opened, the client is allowed to @@ -2209,7 +2209,7 @@ The FORMAT-MASK indicates which fields in FORMAT-HINT the client is likely to use in subsequent GetXBitmaps8 and -GetXBitmaps16 +GetXBitmaps16 requests. Servers may wish to use this information to precompute certain values. @@ -2218,43 +2218,43 @@ this information to precompute certain values. If CACHABLE is set to True, the client may cache the font (so that redundant opens of the same font may be avoided) and use it with all -AccessContexts +AccessContexts during the life of the client without violating the font's licensing policy. This flag is typically set whenever a font is unlicensed or is licensed on a per-display basis. If CACHABLE is False, the client should reopen the font for each -AccessContext . +AccessContext. The server is permitted to add to or remove from the set of fonts returned by -ListFonts +ListFonts between any two requests, though mechanisms outside the protocol. Therefore, it is possible for this request (which is atomic) to return a different font than would result from separate a - ListFonts +ListFonts followed by an -OpenBitmapFont +OpenBitmapFont with a non-wildcarded font name. If FONTID is not in the range [1..2^29-1] or if it is already associated with an open font, an -IDChoice +IDChoice error is returned. If no font is available that matches the specified PATTERN, a -Name +Name error is returned. If the font is present but the client is not permitted access, an -AccessContext +AccessContext error is returned. If FORMAT-MASK has any unspecified bits set or if any of the fields in FORMAT-HINT indicated by FORMAT-MASK are invalid, a -Format +Format error is returned. @@ -2289,7 +2289,7 @@ for the open font associated with FONTID. If FONTID is not associated with any open fonts, a - Font +Font error is returned. @@ -2328,7 +2328,7 @@ Errors: This request is equivalent to -QueryXExtents16 +QueryXExtents16 except that it uses 1-byte character codes. @@ -2457,7 +2457,7 @@ Errors: This request is equivalent to -QueryXBitmaps16 +QueryXBitmaps16 except that it uses 1-byte character codes. @@ -2631,13 +2631,13 @@ longer be associated with an open font. The server is free to release any client-specific storage or licenses allocated for the font. The client may reuse the value of FONTID in a subsequent -OpenBitmapFont +OpenBitmapFont request. If FONTID is not associated with any open fonts, a - Font +Font error is returned. @@ -2651,7 +2651,7 @@ error is returned.
When a connection is closed, a -CloseFont +CloseFont is done on all fonts that are open on the connection. In addition, the server is free to release any storage or licenses allocated on behalf of @@ -2733,7 +2733,7 @@ The following errors are defined for the core protocol: This error is generated by any request that has an unknown combination of major and minor request numbers, or by any extension request that is issued before a -QueryExtension +QueryExtension of that extension.
@@ -2782,7 +2782,7 @@ This error is generated by an invalid FONTID in the QueryXBitmaps8, QueryXBitmaps16 and -CloseFont +CloseFont requests. The value that caused the error is included as extra data. @@ -2803,11 +2803,11 @@ the error is included as extra data. This error is generated by an invalid RANGE in the - QueryXExtents8, +QueryXExtents8, QueryXExtents16, QueryXBitmaps8 and -QueryXBitmaps16 +QueryXBitmaps16 requests. The value that caused the error is included as extra data. @@ -2828,7 +2828,7 @@ value that caused the error is included as extra data. This error is generated by an invalid EVENTMASK in the -SetEventMask +SetEventMask request. The value that caused the error is included as extra data. @@ -2849,9 +2849,9 @@ included as extra data. This error is generated by an invalid ACCESSCONTEXT in the -FreeAC +FreeAC or -SetAuthorization +SetAuthorization request or by an OpenBitmapFont request performed without sufficient authorization. In the @@ -2876,10 +2876,10 @@ ACCESSCONTEXT is returned as extra data. This error is generated by an invalid or already associated ACCESSCONTEXT identifier in a -CreateAC +CreateAC request or FONTID identifier in an -OpenBitmapFont +OpenBitmapFont request. The value that caused the error is included as extra data. @@ -2897,9 +2897,9 @@ is included as extra data. This error is generated by a font name pattern that matches no fonts in an -OpenBitmapFont +OpenBitmapFont request or no catalogue names in a -SetCatalogues +SetCatalogues request. @@ -2925,7 +2925,7 @@ request. This error is generated in response to an invalid RESOLUTION structure in a -SetResolution +SetResolution request. The value that caused the error is included in the DATA-OR-UNUSED field and as extra data. @@ -3084,7 +3084,7 @@ by sending any request (such as This event is sent to clients that have included -CatalogueListChangeMask +CatalogueListChangeMask in their core event mask whenever the list of catalogues that are available has changed. The ADDED field is True if new catalogues have @@ -3108,7 +3108,7 @@ been removed from the server, otherwise it is False. This event is sent to clients that have included -FontListChangeMask +FontListChangeMask in their event mask whenever the list of fonts that are provided by the currently selected catalogues has changed. The ADDED field is True if new -- cgit v1.2.3