diff options
author | Matt Dew <marcoz@osource.org> | 2011-10-22 20:41:51 -0600 |
---|---|---|
committer | Matt Dew <marcoz@osource.org> | 2011-10-22 20:41:51 -0600 |
commit | dd0bf17720aa762d603df4157b158a16646d5894 (patch) | |
tree | b8aab56df2338a2f5ec709f6b5699eaaf04a7504 | |
parent | 20b1fedb8b2ea30c29c5208904a8544209656abb (diff) |
Updated appA.xml
-rw-r--r-- | specs/appA.xml | 131 |
1 files changed, 52 insertions, 79 deletions
diff --git a/specs/appA.xml b/specs/appA.xml index 8076002..8c56c48 100644 --- a/specs/appA.xml +++ b/specs/appA.xml @@ -1,138 +1,111 @@ -<!-- .\" $Xorg: appA,v 1.3 2000/08/17 19:42:48 cpqbld Exp $ --> -<!-- .\" Copyright \(co 1985, 1986, 1987, 1988, 1991, 1994 --> -<!-- .\" X Consortium --> -<!-- .\" --> -<!-- .\" Permission is hereby granted, free of charge, to any person obtaining --> -<!-- .\" a copy of this software and associated documentation files (the --> -<!-- .\" "Software"), to deal in the Software without restriction, including --> -<!-- .\" without limitation the rights to use, copy, modify, merge, publish, --> -<!-- .\" distribute, sublicense, and/or sell copies of the Software, and to --> -<!-- .\" permit persons to whom the Software is furnished to do so, subject to --> -<!-- .\" the following conditions: --> -<!-- .\" --> -<!-- .\" The above copyright notice and this permission notice shall be included --> -<!-- .\" in all copies or substantial portions of the Software. --> -<!-- .\" --> -<!-- .\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS --> -<!-- .\" OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF --> -<!-- .\" MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. --> -<!-- .\" IN NO EVENT SHALL THE X CONSORTIUM BE LIABLE FOR ANY CLAIM, DAMAGES OR --> -<!-- .\" OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, --> -<!-- .\" ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR --> -<!-- .\" OTHER DEALINGS IN THE SOFTWARE. --> -<!-- .\" --> -<!-- .\" Except as contained in this notice, the name of the X Consortium shall --> -<!-- .\" not be used in advertising or otherwise to promote the sale, use or --> -<!-- .\" other dealings in this Software without prior written authorization --> -<!-- .\" from the X Consortium. --> -<!-- .\" --> -<!-- .\" Copyright \(co 1985, 1986, 1987, 1988, 1991, 1994 --> -<!-- .\" Digital Equipment Corporation, Maynard, Massachusetts. --> -<!-- .\" --> -<!-- .\" Permission to use, copy, modify and distribute this documentation for any --> -<!-- .\" purpose and without fee is hereby granted, provided that the above copyright --> -<!-- .\" notice appears in all copies and that both that copyright notice and this --> -<!-- .\" permission notice appear in supporting documentation, and that the name of --> -<!-- .\" Digital not be used in in advertising or publicity pertaining --> -<!-- .\" to distribution of the software without specific, written prior permission. --> -<!-- .\" Digital makes no representations about the suitability of the --> -<!-- .\" software described herein for any purpose. --> -<!-- .\" It is provided ``as is'' without express or implied warranty. --> -<!-- .\" --> -<!-- .bp --> -\& -<!-- .sp 1 --> -<!-- .ce 3 --> -\s+1<function>Appendix A</function>\s-1 - -\s+1<function>Resource File Format</function>\s-1 -<!-- .sp 2 --> +<appendix id='Resource_File_Format'> +<title>Resource File Format</title> <para> -<!-- .LP --> -<!-- .XS --> -<!-- <function>Appendix A \(em Resource File Format</function> --> -<!-- .XE --> A resource file contains text representing the default resource values for an application or set of applications. </para> + <para> -<!-- .LP --> -The format of resource files is defined by <emphasis remap='I'>(xL</emphasis> and is reproduced here +The format of resource files is defined by +<emphasis remap='I'>Xlib — C Language X Interface.</emphasis> and is reproduced here for convenience only. </para> -<para> -<!-- .LP --> -The format of a resource specification is + +<para>The format of a resource specification is</para> <informaltable> - <tgroup cols='' align='center'> + <tgroup cols='2' align='left'> + <colspec colname='c1'/> + <colspec colname='c2'/> <tbody> <row> + <entry>ResourceLine</entry> + <entry>= Comment | IncludeFile | ResourceSpec | <empty line></entry> </row> <row> + <entry>Comment</entry> + <entry>="!" {<any character except null or newline>}</entry> </row> <row> + <entry>IncludeFile</entry> + <entry>= "#" WhiteSpace "include" WhiteSpace FileName WhiteSpace</entry> </row> <row> + <entry>FileName</entry> + <entry>= <valid filename for operating system></entry> </row> <row> + <entry>ResourceSpec</entry> + <entry>= WhiteSpace ResourceName WhiteSpace ":" WhiteSpace Value</entry> </row> <row> + <entry>ResourceName</entry> + <entry>= [Binding] {Component Binding} ComponentName</entry> </row> <row> + <entry>Binding</entry> + <entry>="." | "*"</entry> </row> <row> + <entry>WhiteSpace</entry> + <entry>= {<space> | <horizontal tab>}</entry> </row> <row> + <entry>Component</entry> + <entry>= "?" | ComponentName</entry> </row> <row> + <entry>ComponentName</entry> + <entry>= NameChar {NameChar}</entry> </row> <row> + <entry>NameChar</entry> + <entry>= "a"-"z" | "A"-"Z" | "0"-"9" | "_" | "-"</entry> </row> <row> - </row> - <row> + <entry>Value</entry> + <entry>={<any character except null or unescaped newline>}</entry> </row> </tbody> </tgroup> </informaltable> -</para> + <para> -<!-- .LP --> Elements separated by vertical bar (|) are alternatives. -Curly braces ({\&.\&.\&.}) indicate zero or more repetitions +Curly braces ({...}) indicate zero or more repetitions of the enclosed elements. -Square brackets ([\&.\&.\&.]) indicate that the enclosed element is optional. -Quotes (``\&.\&.\&.'') are used around literal characters. +Square brackets ([...]) indicate that the enclosed element is optional. +Quotes ("...") are used around literal characters. </para> + <para> -<!-- .LP --> -If the last character on a line is a backslash (\\), +If the last character on a line is a backslash (\), that line is assumed to continue on the next line. </para> + <para> -<!-- .LP --> To allow a Value to begin with whitespace, -the two-character sequence ``\\\^<emphasis remap='I'>space</emphasis>'' (backslash followed by space) +the two-character sequence "\<emphasis remap='I'>space</emphasis>" (backslash followed by space) is recognized and replaced by a space character, -and the two-character sequence ``\\\^<emphasis remap='I'>tab</emphasis>'' +and the two-character sequence "\<emphasis remap='I'>tab</emphasis>" (backslash followed by horizontal tab) is recognized and replaced by a horizontal tab character. - +</para> +<para> To allow a Value to contain embedded newline characters, -the two-character sequence ``\\\^n'' is recognized and replaced by a +the two-character sequence "\n" is recognized and replaced by a newline character. To allow a Value to be broken across multiple lines in a text file, -the two-character sequence ``\\\^<emphasis remap='I'>newline</emphasis>'' +the two-character sequence "\<emphasis remap='I'>newline</emphasis>" (backslash followed by newline) is recognized and removed from the value. - +</para> +<para> To allow a Value to contain arbitrary character codes, -the four-character sequence ``\\\^<emphasis remap='I'>nnn</emphasis>'', +the four-character sequence "\<emphasis remap='I'>nnn</emphasis>", where each <emphasis remap='I'>n</emphasis> is a digit character in the range of ``0''\-``7'', is recognized and replaced with a single byte that contains the octal value specified by the sequence. -Finally, the two-character sequence ``\\\\'' is recognized +Finally, the two-character sequence "\\" is recognized and replaced with a single backslash. </para> -</chapter> -</book> +</appendix> |