[pdf-devel] Re: API consistency report problem

[gerel]

 > Date: Thu, 10 Jul 2008 14:38:51 +0200
 > From: Aleksander Morgado <address@hidden>
 > 
 > Hi gerel,
 > 
 > It seems the API consistency report is not working completely well. Some
 > of the functions in the Time module (pdf_time_get_utc_cal()  for
 > example) are reported as not implemented, but they actually are
 > available in the pdf.h header.
 > 


Hi aleks,

Well, the script only matches exactly what is documented with each implemented 
function.
The procedures you mention are not exactly the same, 

##
Documentation says:
@deftypefun pdf_status_t pdf_time_span_negate (pdf_time_span_t @var{span})

API says:
pdf_status_t
pdf_time_span_negate (pdf_time_span_t *p_span);
###

The first argument is named '*p_span' which conflicts with 'span' (beware it's 
not a pointer either).

##
Documentation says:
@deftypefun pdf_64_t pdf_time_span_to_secs (const pdf_time_span_t @var{span})

API says:
pdf_i64_t
pdf_time_span_to_secs (const pdf_time_span_t span);
###

In this case the return value conflicts, 'pdf_64_t' and 'pdf_i64_t'.


regards,

-gerel