← Back to branch summary

~ubuntu-branches/ubuntu/quantal/openmotif/quantal

« back to all changes in this revision

Viewing changes to config/util/makestrs.man

  • Committer: Bazaar Package Importer
  • Author(s): Stefan Bauer
  • Date: 2010-06-23 12:12:31 UTC
  • mfrom: (1.1.2 upstream)
  • Revision ID: james.westby@ubuntu.com-20100623121231-u89gxdp51sg9wjj2
Tags: 2.3.0-1
http://bugs.debian.org/379258
http://bugs.debian.org/494375
http://bugs.debian.org/288537
* New Maintainer (Closes: #379258) 
* Acknowledge NMU changes
* New upstream release (Closes: #494375)
* Get rid of security patches as they are already part of new upstream
  release (00-xpmvuln.openmotif.patch, 342092-CVE-2005-3964.patch)
* Bump Standards to 3.8.4
* Added {misc:Depends} to make the package lintian cleaner
* Fix weak-library-dev-dependency by adding ${binary:Version}) for the
  -dev Package of openmotif
* Let package depend on autotools-dev to use newer autotools-helper-files
* Work around an autoconf-bug (Gentoo-Bug #1475)
* Added Client-side anti-aliased fonts support via XFT
* Added UTF-8 and UTF8_STRING atom support
* Ability to show text and pixmaps in Label, LabelGadget and all
  derived widgets
* Support of PNG/JPEG image formats in the same way as XPM is supported
* Increase FILE_OFFSET_BITS to 64 to show files >2GB in file-selector
  Idea taken from Magne Oestlyngen (Closes: #288537)

Show diffs side-by-side

added added

removed removed

Lines of Context:
config/util/makestrs.man
 
1
.\" $TOG: makestrs.man /main/4 1998/02/06 11:24:22 kaleb $
 
2
.\" 
 
3
.\" @OPENGROUP_COPYRIGHT@
 
4
.\" COPYRIGHT NOTICE
 
5
.\" Copyright (c) 1990, 1991, 1992, 1993 Open Software Foundation, Inc.
 
6
.\" Copyright (c) 1996, 1997, 1998, 1999, 2000 The Open Group
 
7
.\" ALL RIGHTS RESERVED (MOTIF). See the file named COPYRIGHT.MOTIF for
 
8
.\" the full copyright text.
 
9
.\"  
 
10
.\" The above copyright notice and this permission notice shall be included in
 
11
.\" all copies or substantial portions of the Software.
 
12
.\" 
 
13
.\" This software is subject to an open license. It may only be
 
14
.\" used on, with or for operating systems which are themselves open
 
15
.\" source systems. You must contact The Open Group for a license
 
16
.\" allowing distribution and sublicensing of this software on, with,
 
17
.\" or for operating systems which are not Open Source programs.
 
18
.\" 
 
19
.\" See http://www.opengroup.org/openmotif/license for full
 
20
.\" details of the license agreement. Any use, reproduction, or
 
21
.\" distribution of the program constitutes recipient's acceptance of
 
22
.\" this agreement.
 
23
.\" 
 
24
.\" EXCEPT AS EXPRESSLY SET FORTH IN THIS AGREEMENT, THE PROGRAM IS
 
25
.\" PROVIDED ON AN "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
 
26
.\" KIND, EITHER EXPRESS OR IMPLIED INCLUDING, WITHOUT LIMITATION, ANY
 
27
.\" WARRANTIES OR CONDITIONS OF TITLE, NON-INFRINGEMENT, MERCHANTABILITY
 
28
.\" OR FITNESS FOR A PARTICULAR PURPOSE
 
29
.\" 
 
30
.\" EXCEPT AS EXPRESSLY SET FORTH IN THIS AGREEMENT, NEITHER RECIPIENT
 
31
.\" NOR ANY CONTRIBUTORS SHALL HAVE ANY LIABILITY FOR ANY DIRECT,
 
32
.\" INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
 
33
.\" DAMAGES (INCLUDING WITHOUT LIMITATION LOST PROFITS), HOWEVER CAUSED
 
34
.\" AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
 
35
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
 
36
.\" ANY WAY OUT OF THE USE OR DISTRIBUTION OF THE PROGRAM OR THE
 
37
.\" EXERCISE OF ANY RIGHTS GRANTED HEREUNDER, EVEN IF ADVISED OF THE
 
38
.\" POSSIBILITY OF SUCH DAMAGES.
 
39
.TH MAKESTRS 1 "Release 6.4" "X Version 11"
 
40
.SH NAME
 
41
makestrs \- makes string table C source and header(s)
 
42
.SH SYNOPSIS
 
43
.B makestrs [-f source] [-abioptions ...]
 
44
.SH DESCRIPTION
 
45
The
 
46
.I makestrs
 
47
command creates string table C source files and headers.
 
48
If
 
49
.I -f
 
50
.I source
 
51
is not specified
 
52
.I makestrs
 
53
will read from
 
54
.I stdin.
 
55
The C source file is always written to
 
56
.I stdout.
 
57
.I makestrs
 
58
creates one or more C header files as specified in the source file.
 
59
The following options may be specified:
 
60
.I -sparcabi,
 
61
.I -intelabi,
 
62
.I -functionabi,
 
63
.I -arrayperabi,
 
64
and
 
65
.I -defaultabi.
 
66
.LP
 
67
.I -sparcabi 
 
68
is used on SPARC platforms conforming to the SPARC 
 
69
Compliance Definition, i.e. SVR4/Solaris.
 
70
.LP
 
71
.I -intelabi 
 
72
is used on Intel platforms conforming to the System 
 
73
V Application Binary Interface, i.e. SVR4.
 
74
.LP
 
75
.I -earlyR6abi 
 
76
may be used in addition to 
 
77
.I -intelabi 
 
78
for situations 
 
79
where the vendor wishes to maintain binary compatiblity between 
 
80
X11R6 public-patch 11 (and earlier) and X11R6 public-patch 12 (and later).
 
81
.LP
 
82
.I -functionabi 
 
83
generates a functional abi to the string table. This 
 
84
mechanism imposes a severe performance penalty and it's recommended 
 
85
that you not use it.
 
86
.LP
 
87
.I -arrayperabi 
 
88
results in a separate array for each string. This is 
 
89
the default behavior if makestrs was compiled with -DARRAYPERSTR 
 
90
(it almost never is).
 
91
.LP
 
92
.I -defaultabi 
 
93
forces the generation of the "normal" string table even 
 
94
if makestrs was compiled with -DARRAYPERSTR. Since makestrs is almost 
 
95
never compiled with -DARRAYPERSTR this is the default behavior if 
 
96
no abioptions are specified.
 
97
.SH SYNTAX
 
98
The syntax for string-list file is (items in square brackets are optional):
 
99
.RS 4
 
100
#prefix <text>
 
101
.RE
 
102
.RS 4
 
103
#feature <text>
 
104
.RE
 
105
.RS 4
 
106
#externref <text>
 
107
.RE
 
108
.RS 4
 
109
#externdef [<text>]
 
110
.RE
 
111
.RS 4
 
112
[#ctempl <text>]
 
113
.RE
 
114
.LP
 
115
.RS 4
 
116
#file <filename>
 
117
.RE
 
118
.RS 4
 
119
#table <tablename>
 
120
.RE
 
121
.RS 4
 
122
[#htempl]
 
123
.RE
 
124
.RS 4
 
125
<text>
 
126
.RE
 
127
.RS 4
 
128
...
 
129
.RE
 
130
.RS 4
 
131
<text>
 
132
.RE
 
133
.RS 4
 
134
[#table <tablename>
 
135
.RE
 
136
.RS 4
 
137
<text>
 
138
.RE
 
139
.RS 4
 
140
...
 
141
.RE
 
142
.RS 4
 
143
<text>
 
144
.RE
 
145
.RS 4
 
146
...
 
147
.RE
 
148
.RS 4
 
149
#table <tablename>
 
150
.RE
 
151
.RS 4
 
152
...]
 
153
.RE
 
154
.RS 4
 
155
[#file <filename>
 
156
.RE
 
157
.RS 4
 
158
...]
 
159
.RE
 
160
.LP
 
161
In words you may have one or more #file directives. Each #file may have
 
162
one or more #table directives.
 
163
.LP
 
164
The #prefix directive determines the string that makestr will prefix
 
165
to each definition.
 
166
.LP
 
167
The #feature directive determines the string that makestr will use
 
168
for the feature-test macro, e.g. X[TM]STRINGDEFINES.
 
169
.LP
 
170
The #externref directive determines the string that makestr will use
 
171
for the extern clause, typically this will be "extern" but Motif wants
 
172
it to be "externalref"
 
173
.LP
 
174
The #externdef directive determines the string that makestr will use
 
175
for the declaration, typically this will be the null string (note that
 
176
makestrs requires a trailing space in this case, i.e. "#externdef "),
 
177
and Motif will use "externaldef(_xmstrings).
 
178
.LP
 
179
The #ctmpl directive determines the name of the file used as a template
 
180
for the C source file that is generated
 
181
.LP
 
182
Each #file <filename> directive will result in a corresponding header 
 
183
file by that name containing the appropriate definitions as specified
 
184
by command line options. A single C source file containing the
 
185
declarations for the definitions in all the headers will be printed
 
186
to stdout.
 
187
.LP
 
188
The #htmpl directive determines the name of the file used as a template
 
189
for the C header file that is generated.
 
190
.LP
 
191
Each #table <tablename> directive will be processed in accordance with
 
192
the ABI. On most platforms all tables will be catenated into a single
 
193
table with the name of the first table for that file. To conform to
 
194
the Intel ABI separate tables will be generated with the names indicated.
 
195
.LP
 
196
The template files specified by the #ctmpl and #htmpl directives
 
197
are processed by copying line for line from the template file to
 
198
the appropriate output file. The line containing the string
 
199
.I <<<STRING_TABLE_GOES_HERE>>>
 
200
is not copied to the output file. The appropriate data is then
 
201
copied to the output file and then the remainder of the template
 
202
file is copied to the output file.
 
203
.SH BUGS
 
204
makestrs is not very forgiving of syntax errors. Sometimes you need
 
205
a trailing space after # directives, other times they will mess you
 
206
up. No warning messages are emitted.
 
207
.SH SEE ALSO
 
208
SPARC Compliance Definition 2.2., SPARC International Inc.,
 
209
535 Middlefield Road, Suite 210, Menlo Park, CA  94025
 
210
.LP
 
211
System V Application Binary Interface, Third Edition, 
 
212
ISBN 0-13-100439-5
 
213
UNIX Press, PTR Prentice Hall, 113 Sylvan Avenue, Englewood Cliffs, 
 
214
NJ  07632
 
215
.LP
 
216
System V Application Binary Interface, Third Edition, Intel386
 
217
Architecture Processor Supplement
 
218
ISBN 0-13-104670-5
 
219
UNIX Press, PTR Prentice Hall, 113 Sylvan Avenue, Englewood Cliffs, 
 
220
NJ  07632
 
221
.LP
 
222
System V Application Binary Interface, Third Edition, SPARC
 
223
Architecture Processor Supplement
 
224
ISBN 0-13-104696-9
 
225
UNIX Press, PTR Prentice Hall, 113 Sylvan Avenue, Englewood Cliffs, 
 
226
NJ  07632