On Tue, 2014-06-17 at 16:38 -0500, Dennis Jenkins wrote:
> I found your notes in the SVN commit messages.  "DrawRect()" is now 
> "Rectangle()" followed by "Stroke()" (although in my existing 
> reports, I did not need to call Stroke, I added the call anyway, per 
> your notes.)
>  
> My project now compiles cleanly with podofo rev 1642, and my PDFs 
> appear ok so far.
>  
> I suppose that I was expecting to see some sort of organized release 
> notes giving a brief mention to the API change details, instead of 
> "hey, I changed stuff and merged it into trunk!".  :)  In any event, 
> I wish to thank you for your contributions.  Now that I have read 
> your notes, your rationales make sense.  I was just frustrated that 
> it broke my own project.  But I'm good now.

        Hi,
that's correct, I wrote detailed description of changes into commit 
messages only. There are no release notes, simply because there is no 
release of these changes yet. Trunk is not a release, trunk is a 
development version of the code, an unstable codebase which will be 
released once the changes settle. That's also the reason why the 
online doxygen still lists the removed functions, it's still relevant 
for the latest release, PoDoFo 0.9.2.

I mean, once the release will be done, the API changes being done 
should be described in the release notes, just as you/all expect, the 
best with a description how to migrate existing code (in my case copy 
of the commit messages should do it).

I also agree with you, API changes are horrible, sometimes even 
deprecation of functions, though I hope those I did are for good 
reason. The drawing API allows more freedom now - you just define the 
path and then Stroke, Fill or StrokeAndFill (the last it in one call, 
not in two with path redefinition).

        Bye,
        zyx


-- 
http://www.litePDF.cz                                 i...@litepdf.cz


------------------------------------------------------------------------------
HPCC Systems Open Source Big Data Platform from LexisNexis Risk Solutions
Find What Matters Most in Your Big Data with HPCC Systems
Open Source. Fast. Scalable. Simple. Ideal for Dirty Data.
Leverages Graph Analysis for Fast Processing & Easy Data Exploration
http://p.sf.net/sfu/hpccsystems
_______________________________________________
Podofo-users mailing list
Podofo-users@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/podofo-users

Reply via email to