Backward compatibility

classic Classic list List threaded Threaded
4 messages Options
Reply | Threaded
Open this post in threaded view
|

Backward compatibility

1marc1
Is asciidoctor-PDF 1.5.0.alpha.17 backward compatible with version 1.5.0.alpha.16?

I.e. if I have an asciidoctor document that I turn into a PDF file using 1.5.0.alpha.16, should I expect to see the same PDF file if I turn it into a PDF file using 1.5.0.alpha.17?

Marc.
Reply | Threaded
Open this post in threaded view
|

Re: Backward compatibility

mojavelinux
Administrator
Marc.

No. That's what the alpha label is meant to communicate. And the reason for that label is because there was previously no test suite to verify compatibility (and although it now exists, it's still filling out).

Having said that, I've tried hard to ensure a smooth transition from one release to the next, given how many users Asciidoctor PDF has. The only major difference between these two releases (that come to mind) is that footnotes are now placed in a dedicated block and you need to add the title-page attribute to the document header (or via the CLI or API) if you still want a title page when the doctype is not book.

You can find a list of everything that changes in the CHANGELOG (https://github.com/asciidoctor/asciidoctor-pdf/blob/master/CHANGELOG.adoc). I'm very diligent about keeping that up to date.

Now that we have a test suite, I think we'll be ready to exit alpha in the next release, if not the one after that.

Cheers,

-Dan

On Thu, May 2, 2019 at 6:19 AM 1marc1 [via Asciidoctor :: Discussion] <[hidden email]> wrote:
Is asciidoctor-PDF 1.5.0.alpha.17 backward compatible with version 1.5.0.alpha.16?

I.e. if I have an asciidoctor document that I turn into a PDF file using 1.5.0.alpha.16, should I expect to see the same PDF file if I turn it into a PDF file using 1.5.0.alpha.17?

Marc.


If you reply to this email, your message will be added to the discussion below:
http://discuss.asciidoctor.org/Backward-compatibility-tp6880.html
To start a new topic under Asciidoctor :: Discussion, email [hidden email]
To unsubscribe from Asciidoctor :: Discussion, click here.
NAML


--
Dan Allen | @mojavelinux | https://twitter.com/mojavelinux
Reply | Threaded
Open this post in threaded view
|

Re: Backward compatibility

1marc1
Dan,

It took me a while to get back on this, because I indeed thought at least the vast majority would be backward compatible, however I noticed something odd in the very first document I created. This was a document that worked fine under 1.5.0.alpha.16, however when I created the PDF with 1.5.0.alpha.17, the tables had additional spacing in each row.

I spent some time working out exactly what was going on and where the root cause is. I opened issue #1053 for this and added the details I found, along with screenshots of the issue.

Marc.
Reply | Threaded
Open this post in threaded view
|

Re: Backward compatibility

mojavelinux
Administrator
Marc.

I've heard some reports about the table cell padding going haywire,
but I wasn't able to get any details about it. Your report will help
me to track down the problem. Thank you for taking the time to put
that together. I'll schedule a fix for the next release.

Best,

-Dan


On Sun, May 5, 2019 at 7:49 AM 1marc1 [via Asciidoctor :: Discussion]
<[hidden email]> wrote:

>
> Dan,
>
> It took me a while to get back on this, because I indeed thought at least the vast majority would be backward compatible, however I noticed something odd in the very first document I created. This was a document that worked fine under 1.5.0.alpha.16, however when I created the PDF with 1.5.0.alpha.17, the tables had additional spacing in each row.
>
> I spent some time working out exactly what was going on and where the root cause is. I opened issue #1053 for this and added the details I found, along with screenshots of the issue.
>
> Marc.
>
> ________________________________
> If you reply to this email, your message will be added to the discussion below:
> http://discuss.asciidoctor.org/Backward-compatibility-tp6880p6898.html
> To start a new topic under Asciidoctor :: Discussion, email [hidden email]
> To unsubscribe from Asciidoctor :: Discussion, click here.
> NAML



--
Dan Allen | @mojavelinux | https://twitter.com/mojavelinux