Blame doc/man/man3/XmStringPutRendition.3

Packit b099d7
'\" t
Packit b099d7
...\" StrPut.sgm /main/8 1996/09/08 21:06:53 rws $
Packit b099d7
.de P!
Packit b099d7
.fl
Packit b099d7
\!!1 setgray
Packit b099d7
.fl
Packit b099d7
\\&.\"
Packit b099d7
.fl
Packit b099d7
\!!0 setgray
Packit b099d7
.fl			\" force out current output buffer
Packit b099d7
\!!save /psv exch def currentpoint translate 0 0 moveto
Packit b099d7
\!!/showpage{}def
Packit b099d7
.fl			\" prolog
Packit b099d7
.sy sed -e 's/^/!/' \\$1\" bring in postscript file
Packit b099d7
\!!psv restore
Packit b099d7
.
Packit b099d7
.de pF
Packit b099d7
.ie     ?\\*(f1?? .ds f1 \\n(.f
Packit b099d7
.el .ie ?\\*(f2?? .ds f2 \\n(.f
Packit b099d7
.el .ie ?\\*(f3?? .ds f3 \\n(.f
Packit b099d7
.el .ie ?\\*(f4?? .ds f4 \\n(.f
Packit b099d7
.el .tm ? font overflow
Packit b099d7
.ft \\$1
Packit b099d7
..
Packit b099d7
.de fP
Packit b099d7
.ie     !?\\*(f4?? \{\
Packit b099d7
.	ft \\*(f4
Packit b099d7
.	ds f4\"
Packit b099d7
'	br \}
Packit b099d7
.el .ie !?\\*(f3?? \{\
Packit b099d7
.	ft \\*(f3
Packit b099d7
.	ds f3\"
Packit b099d7
'	br \}
Packit b099d7
.el .ie !?\\*(f2?? \{\
Packit b099d7
.	ft \\*(f2
Packit b099d7
.	ds f2\"
Packit b099d7
'	br \}
Packit b099d7
.el .ie !?\\*(f1?? \{\
Packit b099d7
.	ft \\*(f1
Packit b099d7
.	ds f1\"
Packit b099d7
'	br \}
Packit b099d7
.el .tm ? font underflow
Packit b099d7
..
Packit b099d7
.ds f1\"
Packit b099d7
.ds f2\"
Packit b099d7
.ds f3\"
Packit b099d7
.ds f4\"
Packit b099d7
.ta 8n 16n 24n 32n 40n 48n 56n 64n 72n 
Packit b099d7
.TH "XmStringPutRendition" "library call"
Packit b099d7
.SH "NAME"
Packit b099d7
\fBXmStringPutRendition\fP \(em A convenience function that places renditions around strings
Packit b099d7
.iX "XmStringPutRendition"
Packit b099d7
.SH "SYNOPSIS"
Packit b099d7
.PP
Packit b099d7
.nf
Packit b099d7
#include <Xm/Xm\&.h>
Packit b099d7
\fBXmString \fBXmStringPutRendition\fP\fR(
Packit b099d7
\fBXmString \fBstring\fR\fR,
Packit b099d7
\fBXmStringTag \fBrendition\fR\fR);
Packit b099d7
.fi
Packit b099d7
.SH "DESCRIPTION"
Packit b099d7
.PP
Packit b099d7
\fBXmStringPutRendition\fP places matching
Packit b099d7
\fBXm_STRING_COMPONENT_RENDITION_BEGIN\fP and
Packit b099d7
\fBXmSTRING_COMPONENT_RENDITION_END\fP components containing
Packit b099d7
\fIrendition\fP around
Packit b099d7
\fIstring\fP\&. The original string is preserved\&.
Packit b099d7
.IP "\fIstring\fP" 10
Packit b099d7
Specifies the compound string to which begin and end rendition
Packit b099d7
components should be added\&.
Packit b099d7
.IP "\fIrendition\fP" 10
Packit b099d7
Specifies the rendition tag to be used in an
Packit b099d7
\fBXmSTRING_COMPONENT_RENDITION_BEGIN\fP component which will begin
Packit b099d7
the returned string and in an \fBXmSTRING_COMPONENT_RENDITION_END\fP
Packit b099d7
component which will end it\&.
Packit b099d7
.SH "RETURN"
Packit b099d7
.PP
Packit b099d7
Returns a new compound string\&.
Packit b099d7
The function allocates space to hold this returned compound string\&.
Packit b099d7
When the application no longer needs the returned compound string,
Packit b099d7
the application should call \fBXmStringFree\fP\&.
Packit b099d7
.SH "RELATED"
Packit b099d7
.PP
Packit b099d7
\fBXmString\fP(3)\&.
Packit b099d7
...\" created by instant / docbook-to-man, Sun 22 Dec 1996, 20:31