]> git.wh0rd.org - fontconfig.git/blobdiff - doc/fcobjectset.fncs
More doc typo fixes
[fontconfig.git] / doc / fcobjectset.fncs
index a9c0c0110c50aa41bc49e1cc9d7b7604aabb9042..57e1750d1c15253f292c800745650597901f12ef 100644 (file)
@@ -1,21 +1,21 @@
 /*
- * $Id$
+ * fontconfig/doc/fcobjectset.fncs
  *
- * Copyright © 2003 Keith Packard
+ * 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
+ * documentation, and that the name of the author(s) not be used in
  * advertising or publicity pertaining to distribution of the software without
- * specific, written prior permission.  Keith Packard makes no
+ * specific, written prior permission.  The authors make no
  * representations about the suitability of this software for any purpose.  It
  * is provided "as is" without express or implied warranty.
  *
- * KEITH PACKARD DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
+ * THE AUTHOR(S) DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
  * INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO
- * EVENT SHALL KEITH PACKARD BE LIABLE FOR ANY SPECIAL, INDIRECT OR
+ * 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
@@ -35,7 +35,8 @@ Creates an empty set.
 @TYPE2@                const char *                    @ARG2@          object
 @PURPOSE@      Add to an object set
 @DESC@
-Adds a proprety name to the set.
+Adds a property name to the set. Returns FcFalse if the property name cannot be
+inserted into the set (due to allocation failure). Otherwise returns FcTrue.
 @@
 
 @RET@          void
@@ -50,12 +51,23 @@ Destroys an object set.
 @FUNC@         FcObjectSetBuild
 @TYPE1@                const char *                    @ARG1@          first
 @TYPE2@                ...
+
 @PROTOTYPE+@
 @RET+@         FcObjectSet *
 @FUNC+@                FcObjectSetVaBuild
 @TYPE1+@       const char *                    @ARG1+@         first
-@TYPE2+@       va_list                         @ARG2+@         va
+@TYPE2+@       va_list%                        @ARG2+@         va
+
+@PROTOTYPE++@
+@RET++@                void
+@FUNC++@       FcObjectSetVapBuild
+@TYPE1++@      FcObjectSet *                   @ARG1++@        result
+@TYPE2++@      const char *                    @ARG2++@        first
+@TYPE3++@      va_list%                        @ARG3++@        va
+
 @PURPOSE@      Build object set from args
 @DESC@
 These build an object set from a null-terminated list of property names.
+FcObjectSetVapBuild is a macro version of FcObjectSetVaBuild which returns
+the result in the <parameter>result</parameter> variable directly.
 @@