]> git.imager.perl.org - imager.git/blobdiff - tags.c
correct cast
[imager.git] / tags.c
diff --git a/tags.c b/tags.c
index 951d1fe9d42d70c103a55273c8e8046948a24a4b..6812a49e969e72f635d953fbec664e3441de20ab 100644 (file)
--- a/tags.c
+++ b/tags.c
@@ -83,7 +83,7 @@ void i_tags_new(i_img_tags *tags) {
 
 Adds a tag that has an integer value.  A simple wrapper around i_tags_add().
 
-Duplicate tags can be added.
+Use i_tags_setn() instead, this function may be removed in the future.
 
 Returns non-zero on success.
 
@@ -99,7 +99,7 @@ int i_tags_addn(i_img_tags *tags, char const *name, int code, int idata) {
 
 Adds a tag to the tags list.
 
-Duplicate tags can be added.
+Use i_tags_set() instead, this function may be removed in the future.
 
 Returns non-zero on success.
 
@@ -409,7 +409,7 @@ int i_tags_set_float2(i_img_tags *tags, char const *name, int code,
 
 Retrieve a tag specified by name or code as an integer.
 
-On success sets the i_color *I<value> to the color and returns true.
+On success sets the int *I<value> to the integer and returns true.
 
 On failure returns false.
 
@@ -444,7 +444,7 @@ static int parse_long(char *data, char **end, long *out) {
 
   errno = 0;
   result = strtol(data, &myend, 10);
-  if ((result == LONG_MIN || result == LONG_MAX) && errno == ERANGE
+  if (((result == LONG_MIN || result == LONG_MAX) && errno == ERANGE)
       || myend == data) {
     errno = savederr;
     return 0;
@@ -615,11 +615,16 @@ int i_tags_get_string(i_img_tags *tags, char const *name, int code,
 
 /*
 =item i_tags_set(tags, name, data, size)
-
+=synopsis i_tags_set(&img->tags, "i_comment", -1);
 =category Tags
 
 Sets the given tag to the string I<data>
 
+If size is -1 then the strlen(I<data>) bytes are stored.
+
+Even on failure, if an existing tag I<name> exists, it will be
+removed.
+
 =cut
 */
 
@@ -632,11 +637,15 @@ i_tags_set(i_img_tags *tags, char const *name, char const *data, int size) {
 
 /*
 =item i_tags_setn(tags, name, idata)
-
+=synopsis i_tags_setn(&img->tags, "i_xres", 204);
+=synopsis i_tags_setn(&img->tags, "i_yres", 196);
 =category Tags
 
 Sets the given tag to the integer I<idata>
 
+Even on failure, if an existing tag I<name> exists, it will be
+removed.
+
 =cut
 */