X-Git-Url: https://git.wh0rd.org/?a=blobdiff_plain;f=doc%2Ffcvalue.fncs;h=d0c669b1f17bed27d3e94fb3b9d37d7e718f465f;hb=dffcb2a083bc5f959ed96dbdf0f365ebc0e710cc;hp=6d97de388bea7789d477f4544e012e93dca808d8;hpb=22671e25510e77af1a8f2b569314ba2de1c93353;p=fontconfig.git diff --git a/doc/fcvalue.fncs b/doc/fcvalue.fncs index 6d97de3..d0c669b 100644 --- a/doc/fcvalue.fncs +++ b/doc/fcvalue.fncs @@ -1,17 +1,61 @@ +/* + * fontconfig/doc/fcvalue.fncs + * + * Copyright © 2003 Keith Packard + * + * Permission to use, copy, modify, distribute, and sell this software and its + * documentation for any purpose is hereby granted without fee, provided that + * the above copyright notice appear in all copies and that both that + * copyright notice and this permission notice appear in supporting + * documentation, and that the name of Keith Packard not be used in + * advertising or publicity pertaining to distribution of the software without + * specific, written prior permission. Keith Packard makes no + * representations about the suitability of this software for any purpose. It + * is provided "as is" without express or implied warranty. + * + * THE AUTHOR(S) DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, + * INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO + * EVENT SHALL THE AUTHOR(S) BE LIABLE FOR ANY SPECIAL, INDIRECT OR + * CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, + * DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER + * TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR + * PERFORMANCE OF THIS SOFTWARE. + */ @RET@ void @FUNC@ FcValueDestroy -@TYPE1@ FcValue @ARG1@ v +@TYPE1@ FcValue% @ARG1@ v @PURPOSE@ Free a value @DESC@ -Frees any memory referenced by `v'. Values of type FcTypeString, +Frees any memory referenced by v. Values of type FcTypeString, FcTypeMatrix and FcTypeCharSet reference memory, the other types do not. @@ @RET@ FcValue @FUNC@ FcValueSave -@TYPE1@ FcValue @ARG1@ v +@TYPE1@ FcValue% @ARG1@ v @PURPOSE@ Copy a value @DESC@ -Returns a copy of `v' duplicating any object referenced by it so that `v' +Returns a copy of v duplicating any object referenced by it so that v may be safely destroyed without harming the new value. @@ + +@RET@ void +@FUNC@ FcValuePrint +@TYPE1@ FcValue% @ARG1@ v +@PURPOSE@ Print a value to stdout +@DESC@ +Prints a human-readable representation of v to +stdout. The format should not be considered part of the library +specification as it may change in the future. +@@ + +@RET@ FcBool +@FUNC@ FcValueEqual +@TYPE1@ FcValue% @ARG1@ v_a +@TYPE2@ FcValue% @ARG2@ v_b +@PURPOSE@ Test two values for equality +@DESC@ +Compares two values. Integers and Doubles are compared as numbers; otherwise +the two values have to be the same type to be considered equal. Strings are +compared ignoring case. +@@