don't include the line number in the From comment so since unrelated edits
authorTony Cook <tony@develop=help.com>
Sat, 1 Jul 2006 05:38:11 +0000 (05:38 +0000)
committerTony Cook <tony@develop=help.com>
Sat, 1 Jul 2006 05:38:11 +0000 (05:38 +0000)
were causing changes to APIRef.pm.  This is still possible but they should
be a lot less frequence.

apidocs.perl
lib/Imager/APIRef.pod

index 366c425..2674289 100644 (file)
@@ -34,7 +34,7 @@ for my $file (@files) {
     elsif ($func && /^=(cut|head)/) {
       if ($funcs{$func}) { # only save the API functions
         $alldocs{$func} = [ @funcdocs ];
-        $from{$func} = "Line $start in $file";
+        $from{$func} = "File $file";
         if ($category) {
           $funccats{$func} = $category;
           push @{$cats{$category}}, $func;
@@ -72,8 +72,8 @@ print OUT <<'EOS';
 Do not edit this file, it is generated automatically by apidocs.perl
 from Imager's source files.
 
-Each function description has a comment listing the source file and
-line number where you can find the documentation.
+Each function description has a comment listing the source file where
+you can find the documentation.
 
 =head1 NAME
 
index 0773e5c..e92e4c4 100644 (file)
@@ -1,8 +1,8 @@
 Do not edit this file, it is generated automatically by apidocs.perl
 from Imager's source files.
 
-Each function description has a comment listing the source file and
-line number where you can find the documentation.
+Each function description has a comment listing the source file where
+you can find the documentation.
 
 =head1 NAME
 
@@ -66,7 +66,7 @@ of angles in degrees from d1 to d2, with the color.
 
 
 =for comment
-From: Line 209 in draw.c
+From: File draw.c
 
 =item i_arc_aa(im, x, y, rad, d1, d2, color)
 
@@ -76,7 +76,7 @@ the range of angles in degrees from d1 to d2, with the color.
 
 
 =for comment
-From: Line 334 in draw.c
+From: File draw.c
 
 =item i_arc_aa_cfill(im, x, y, rad, d1, d2, fill)
 
@@ -86,7 +86,7 @@ the range of angles in degrees from d1 to d2, with the fill object.
 
 
 =for comment
-From: Line 360 in draw.c
+From: File draw.c
 
 =item i_arc_cfill(im, x, y, rad, d1, d2, fill)
 
@@ -96,7 +96,7 @@ of angles in degrees from d1 to d2, with the fill object.
 
 
 =for comment
-From: Line 234 in draw.c
+From: File draw.c
 
 =item i_box(im, x1, y1, x2, y2, color)
 
@@ -105,7 +105,7 @@ Outlines the box from (x1,y1) to (x2,y2) inclusive with I<color>.
 
 
 =for comment
-From: Line 520 in draw.c
+From: File draw.c
 
 =item i_box_cfill(im, x1, y1, x2, y2, fill)
 
@@ -114,7 +114,7 @@ Fills the box from (x1,y1) to (x2,y2) inclusive with fill.
 
 
 =for comment
-From: Line 563 in draw.c
+From: File draw.c
 
 =item i_box_filled(im, x1, y1, x2, y2, color)
 
@@ -123,7 +123,7 @@ Fills the box from (x1,y1) to (x2,y2) inclusive with color.
 
 
 =for comment
-From: Line 545 in draw.c
+From: File draw.c
 
 =item i_circle_aa(im, x, y, rad, color)
 
@@ -133,7 +133,7 @@ color.
 
 
 =for comment
-From: Line 466 in draw.c
+From: File draw.c
 
 =item i_flood_cfill(im, seedx, seedy, fill)
 
@@ -145,7 +145,7 @@ Returns false if (seedx, seedy) are outside the image.
 
 
 =for comment
-From: Line 1329 in draw.c
+From: File draw.c
 
 =item i_flood_cfill_border(im, seedx, seedy, fill, border)
 
@@ -158,7 +158,7 @@ Returns false if (seedx, seedy) are outside the image.
 
 
 =for comment
-From: Line 1409 in draw.c
+From: File draw.c
 
 =item i_flood_fill(im, seedx, seedy, color)
 
@@ -170,7 +170,7 @@ Returns false if (seedx, seedy) are outside the image.
 
 
 =for comment
-From: Line 1287 in draw.c
+From: File draw.c
 
 =item i_flood_fill_border(im, seedx, seedy, color, border)
 
@@ -183,7 +183,7 @@ Returns false if (seedx, seedy) are outside the image.
 
 
 =for comment
-From: Line 1369 in draw.c
+From: File draw.c
 
 =item i_glin(im, l, r, y, colors)
 
@@ -194,7 +194,7 @@ Returns the number of pixels retrieved.
 
 
 =for comment
-From: Line 210 in imext.c
+From: File imext.c
 
 =item i_glinf(im, l, r, y, colors)
 
@@ -206,7 +206,7 @@ Returns the number of pixels retrieved.
 
 
 =for comment
-From: Line 245 in imext.c
+From: File imext.c
 
 =item i_gpal(im, x, r, y, indexes)
 
@@ -220,7 +220,7 @@ Always returns 0 for direct color images.
 
 
 =for comment
-From: Line 309 in imext.c
+From: File imext.c
 
 =item i_gpix(im, x, y, color)
 
@@ -231,7 +231,7 @@ Returns 0 if the pixel was retrieved, or -1 if not.
 
 
 =for comment
-From: Line 138 in imext.c
+From: File imext.c
 
 =item i_gpixf(im, x, y, fcolor)
 
@@ -243,7 +243,7 @@ Returns 0 if the pixel was retrieved, or -1 if not.
 
 
 =for comment
-From: Line 174 in imext.c
+From: File imext.c
 
 =item i_gsamp(im, l, r, y, samp, chans, chan_count)
 
@@ -260,7 +260,7 @@ chan_count)
 
 
 =for comment
-From: Line 263 in imext.c
+From: File imext.c
 
 =item i_gsampf(im, l, r, y, samp, chans, chan_count)
 
@@ -277,7 +277,7 @@ chan_count)
 
 
 =for comment
-From: Line 286 in imext.c
+From: File imext.c
 
 =item i_line(im, x1, y1, x2, y2, val, endp)
 
@@ -294,7 +294,7 @@ Draw a line to image using bresenhams linedrawing algorithm
 
 
 =for comment
-From: Line 634 in draw.c
+From: File draw.c
 
 =item i_line_aa(im, x1, x2, y1, y2, color, endp)
 
@@ -305,7 +305,7 @@ The point (x2, y2) is drawn only if endp is set.
 
 
 =for comment
-From: Line 838 in draw.c
+From: File draw.c
 
 =item i_plin(im, l, r, y, colors)
 
@@ -317,7 +317,7 @@ Returns the number of pixels set.
 
 
 =for comment
-From: Line 192 in imext.c
+From: File imext.c
 
 =item i_plinf(im, l, r, fcolors)
 
@@ -329,7 +329,7 @@ Returns the number of pixels set.
 
 
 =for comment
-From: Line 227 in imext.c
+From: File imext.c
 
 =item i_ppal(im, x, r, y, indexes)
 
@@ -343,7 +343,7 @@ Always returns 0 for direct color images.
 
 
 =for comment
-From: Line 328 in imext.c
+From: File imext.c
 
 =item i_ppix(im, x, y, color)
 
@@ -357,7 +357,7 @@ color to the image.
 
 
 =for comment
-From: Line 118 in imext.c
+From: File imext.c
 
 =item i_ppixf(im, x, y, fcolor)
 
@@ -371,7 +371,7 @@ color to the image.
 
 
 =for comment
-From: Line 155 in imext.c
+From: File imext.c
 
 
 =back
@@ -389,7 +389,7 @@ Called by any imager function before doing any other processing.
 
 
 =for comment
-From: Line 185 in error.c
+From: File error.c
 
 =item i_push_error(int code, char const *msg)
 
@@ -402,7 +402,7 @@ error handling is calling function that does.).
 
 
 =for comment
-From: Line 211 in error.c
+From: File error.c
 
 =item i_push_errorf(int code, char const *fmt, ...)
 
@@ -411,7 +411,7 @@ A version of i_push_error() that does printf() like formating.
 
 
 =for comment
-From: Line 273 in error.c
+From: File error.c
 
 =item i_push_errorvf(int code, char const *fmt, va_list ap)
 
@@ -421,7 +421,7 @@ and a format to produce the finally pushed error message.
 
 
 =for comment
-From: Line 249 in error.c
+From: File error.c
 
 
 =back
@@ -437,7 +437,7 @@ Retrieves the file limits set by i_set_image_file_limits().
 
 
 =for comment
-From: Line 74 in limits.c
+From: File limits.c
 
 =item i_int_check_image_file_limits(width, height, channels, sample_size)
 
@@ -454,7 +454,7 @@ This function is intended to be called by image file read functions.
 
 
 =for comment
-From: Line 96 in limits.c
+From: File limits.c
 
 =item i_set_image_file_limits(width, height, bytes)
 
@@ -469,7 +469,7 @@ Returns non-zero on success.
 
 
 =for comment
-From: Line 33 in limits.c
+From: File limits.c
 
 
 =back
@@ -485,7 +485,7 @@ Call to destroy any fill object.
 
 
 =for comment
-From: Line 196 in fills.c
+From: File fills.c
 
 =item i_new_fill_fount(xa, ya, xb, yb, type, repeat, combine, super_sample, ssample_param, count, segs)
 
@@ -495,7 +495,7 @@ Creates a new general fill which fills with a fountain fill.
 
 
 =for comment
-From: Line 1713 in filters.c
+From: File filters.c
 
 =item i_new_fill_hatch(fg, bg, combine, hatch, cust_hatch, dx, dy)
 
@@ -513,7 +513,7 @@ If cust_hatch is NULL then one of the standard hatches is used.
 
 
 =for comment
-From: Line 427 in fills.c
+From: File fills.c
 
 =item i_new_fill_hatchf(fg, bg, combine, hatch, cust_hatch, dx, dy)
 
@@ -531,7 +531,7 @@ If cust_hatch is NULL then one of the standard hatches is used.
 
 
 =for comment
-From: Line 452 in fills.c
+From: File fills.c
 
 =item i_new_fill_image(im, matrix, xoff, yoff, combine)
 
@@ -544,7 +544,7 @@ xoff and yoff are the offset into the image to start filling from.
 
 
 =for comment
-From: Line 489 in fills.c
+From: File fills.c
 
 =item i_new_fill_solid(color, combine)
 
@@ -555,7 +555,7 @@ If combine is non-zero then alpha values will be combined.
 
 
 =for comment
-From: Line 244 in fills.c
+From: File fills.c
 
 =item i_new_fill_solidf(color, combine)
 
@@ -566,7 +566,7 @@ If combine is non-zero then alpha values will be combined.
 
 
 =for comment
-From: Line 213 in fills.c
+From: File fills.c
 
 
 =back
@@ -586,7 +586,7 @@ Returns: i_img *
 
 
 =for comment
-From: Line 626 in image.c
+From: File image.c
 
 =item i_copyto(dest, src, x1, y1, x2, y2, tx, ty)
 
@@ -599,7 +599,7 @@ If x1 > x2 or y1 > y2 then the corresponding co-ordinates are swapped.
 
 
 =for comment
-From: Line 557 in image.c
+From: File image.c
 
 =item i_copyto_trans(im, src, x1, y1, x2, y2, tx, ty, trans)
 
@@ -610,7 +610,7 @@ pass NULL in trans for non transparent i_colors.
 
 
 =for comment
-From: Line 515 in image.c
+From: File image.c
 
 =item i_img_destroy(im)
 
@@ -621,7 +621,7 @@ Destroy image and free data via exorcise.
 
 
 =for comment
-From: Line 424 in image.c
+From: File image.c
 
 =item i_img_info(im, info)
 
@@ -640,7 +640,7 @@ info is an array of 4 integers with the following values:
 
 
 =for comment
-From: Line 443 in image.c
+From: File image.c
 
 =item i_rubthru(im, src, tx, ty, src_minx, src_miny, src_maxx, src_maxy )
 
@@ -655,7 +655,7 @@ unmodified.
 
 
 =for comment
-From: Line 701 in image.c
+From: File image.c
 
 
 =back
@@ -673,7 +673,7 @@ Returns the image on success, or NULL on failure.
 
 
 =for comment
-From: Line 192 in img16.c
+From: File img16.c
 
 =item i_img_8_new(x, y, ch)
 
@@ -683,7 +683,7 @@ I<ch> channels.
 
 
 =for comment
-From: Line 257 in image.c
+From: File image.c
 
 =item i_img_double_new(int x, int y, int ch)
 
@@ -692,7 +692,7 @@ Creates a new double per sample image.
 
 
 =for comment
-From: Line 82 in imgdouble.c
+From: File imgdouble.c
 
 =item i_img_pal_new(x, y, channels, maxpal)
 
@@ -703,7 +703,7 @@ Returns a new image or NULL on failure.
 
 
 =for comment
-From: Line 136 in palimg.c
+From: File palimg.c
 
 =item i_sametype(i_img *im, int xsize, int ysize)
 
@@ -714,7 +714,7 @@ For paletted images the palette is copied from the source.
 
 
 =for comment
-From: Line 1107 in image.c
+From: File image.c
 
 =item i_sametype_chans(i_img *im, int xsize, int ysize, int channels)
 
@@ -725,7 +725,7 @@ For paletted images the equivalent direct type is returned.
 
 
 =for comment
-From: Line 1149 in image.c
+From: File image.c
 
 
 =back
@@ -743,7 +743,7 @@ quant->make_colors).
 
 
 =for comment
-From: Line 30 in quant.c
+From: File quant.c
 
 =item i_quant_translate(quant, img)
 
@@ -762,7 +762,7 @@ This function will fail if the supplied palette contains no colors.
 
 
 =for comment
-From: Line 86 in quant.c
+From: File quant.c
 
 =item i_quant_transparent(quant, data, img, trans_index)
 
@@ -774,7 +774,7 @@ The method used depends on the tr_* members of quant.
 
 
 =for comment
-From: Line 1470 in quant.c
+From: File quant.c
 
 
 =back
@@ -796,7 +796,7 @@ Always fails for direct color images.
 
 
 =for comment
-From: Line 347 in imext.c
+From: File imext.c
 
 =item i_colorcount(im)
 
@@ -807,7 +807,7 @@ Returns -1 for direct images.
 
 
 =for comment
-From: Line 393 in imext.c
+From: File imext.c
 
 =item i_findcolor(im, color, &entry)
 
@@ -822,7 +822,7 @@ Always fails on direct color images.
 
 
 =for comment
-From: Line 428 in imext.c
+From: File imext.c
 
 =item i_getcolors(im, index, colors, count)
 
@@ -841,7 +841,7 @@ palette.
 
 
 =for comment
-From: Line 368 in imext.c
+From: File imext.c
 
 =item i_maxcolors(im)
 
@@ -853,7 +853,7 @@ Returns -1 for direct color images.
 
 
 =for comment
-From: Line 410 in imext.c
+From: File imext.c
 
 =item i_setcolors(im, index, colors, count)
 
@@ -871,7 +871,7 @@ Always fails on direct color images.
 
 
 =for comment
-From: Line 448 in imext.c
+From: File imext.c
 
 
 =back
@@ -889,7 +889,7 @@ Returns the number of tags deleted.
 
 
 =for comment
-From: Line 294 in tags.c
+From: File tags.c
 
 =item i_tags_delbyname(tags, name)
 
@@ -900,7 +900,7 @@ Returns the number of tags deleted.
 
 
 =for comment
-From: Line 264 in tags.c
+From: File tags.c
 
 =item i_tags_delete(tags, index)
 
@@ -911,7 +911,7 @@ Returns true on success.
 
 
 =for comment
-From: Line 235 in tags.c
+From: File tags.c
 
 =item i_tags_destroy(tags)
 
@@ -920,7 +920,7 @@ Destroys the given tags structure.  Called by i_img_destroy().
 
 
 =for comment
-From: Line 158 in tags.c
+From: File tags.c
 
 =item i_tags_find(tags, name, start, &entry)
 
@@ -933,7 +933,7 @@ On failure returns false.
 
 
 =for comment
-From: Line 181 in tags.c
+From: File tags.c
 
 =item i_tags_findn(tags, code, start, &entry)
 
@@ -946,7 +946,7 @@ On failure returns false.
 
 
 =for comment
-From: Line 208 in tags.c
+From: File tags.c
 
 =item i_tags_get_color(tags, name, code, &value)
 
@@ -959,7 +959,7 @@ On failure returns false.
 
 
 =for comment
-From: Line 505 in tags.c
+From: File tags.c
 
 =item i_tags_get_float(tags, name, code, value)
 
@@ -975,7 +975,7 @@ On failure returns false.
 
 
 =for comment
-From: Line 320 in tags.c
+From: File tags.c
 
 =item i_tags_get_int(tags, name, code, &value)
 
@@ -988,7 +988,7 @@ On failure returns false.
 
 
 =for comment
-From: Line 406 in tags.c
+From: File tags.c
 
 =item i_tags_get_string(tags, name, code, value, value_size)
 
@@ -1007,7 +1007,7 @@ The copied value is always NUL terminated.
 
 
 =for comment
-From: Line 569 in tags.c
+From: File tags.c
 
 =item i_tags_new(i_img_tags *tags)
 
@@ -1022,7 +1022,7 @@ To destroy the contents use i_tags_destroy()
 
 
 =for comment
-From: Line 61 in tags.c
+From: File tags.c
 
 =item i_tags_set(tags, name, data, size)
 
@@ -1031,7 +1031,7 @@ Sets the given tag to the string I<data>
 
 
 =for comment
-From: Line 617 in tags.c
+From: File tags.c
 
 =item i_tags_set_color(tags, name, code, &value)
 
@@ -1040,7 +1040,7 @@ Stores the given color as a tag with the given name and code.
 
 
 =for comment
-From: Line 545 in tags.c
+From: File tags.c
 
 =item i_tags_set_float(tags, name, code, value)
 
@@ -1049,7 +1049,7 @@ Equivalent to i_tags_set_float2(tags, name, code, value, 30).
 
 
 =for comment
-From: Line 359 in tags.c
+From: File tags.c
 
 =item i_tags_set_float2(tags, name, code, value, places)
 
@@ -1062,7 +1062,7 @@ storage at the precision specified by C<places>.
 
 
 =for comment
-From: Line 374 in tags.c
+From: File tags.c
 
 =item i_tags_setn(tags, name, idata)
 
@@ -1071,7 +1071,7 @@ Sets the given tag to the integer I<idata>
 
 
 =for comment
-From: Line 634 in tags.c
+From: File tags.c
 
 
 =back