Changes

See also INFO/Changes_2025 for earlier version 3 release logs.

3.029     2026-04-29    UNRELEASED 
* = work in progress

  ==== New features

*   lib/PDF/Builder/Content/Column.pm
     Finish cross references for column() to support multiple passes, for
      forward references when the link text needs to be picked up later in
      the source.

*   lib/PDF/Builder/Content/Text.pm, lib/PDF/Builder/Content/Column.pm (new),
      lib/PDF/Builder/Content.pm, examples/Column.pl, MANIFEST, META.json,
      META.yml
     Split out column() and related routines into their own file. Refactor
      column() code to improve maintainability.

    lib/PDF/Builder/Content.pm
     In addition to the existing positional parameter flags move, larc (larger),
      and dir (reverse), bogen() now permits option-style 'move'=>flag, 
      'larc'=>flag (or 'larger'=>flag), and 'dir'=>flag (or 'reverse'=>flag)
      in addition to, or instead of, the positional flags.

    Makefile.PL
     Remind user to check INFO/Prereq_fixes.md for information on problems
      with various prerequisite packages, and workarounds or fixes.

  ==== Bug fixes

*   lib/PDF/Builder/Content/Column.pm
     Fix problem with loss of vertical margin between bottom of a list
      and top of a paragraph.

    lib/PDF/Builder.pm
     Per #228 Clarify in Builder.pm POD that ttffont()'s "file" input can be
      either a file path/name, or an existing Font::TTF::Font object. See
      also PDF::API2 PR 92.

    lib/PDF/Builder/Content.pm
     Per #208, squeeze out very tiny segments in bogen() calls, caused by 
      numeric "noise" (very close to 0, usually within 10^-14 degree) primary 
      angles. This does not affect arc(), pie(), or curve() calls, nor anyone 
      calling them.

    lib/PDF/Builder/Content/Text.pm, lib/PDF/Builder/Content.pm,
      examples/020_textunderline, examples/ContentText.pl
     Per #217, restore capability of textlabel() method to be called from
      either text or graphics context. The original API2 implementation 
      was in graphics context, which never made a lot of sense (this is
      text handling), and so long ago Builder moved it to the text context.
      However, some users wish to maintain API2 compatibility and to be
      able to call it from the graphics context. In examples, add a
      couple of graphics context calls.

    INFO/Prereq_fixes.md
     Document Image::Info minimum version for SVGPDF usage.

    INFO/Prereq_fixes.md
     Document how to install or upgrade HarfBuzz::Shaper optional prereq 
      on Strawberry Perl (Windows) 5.28, if the latest (0.032 or higher) 
      will not install or upgrade due to failure to build latest harfbuzz
      library.

    META.json, META.yml, xt/kwalitee.t (new), MANIFEST, README.md, 
      examples/Column.pl
     Add kwalitee for CPAN tests, update META files for minor errors. I can't
      find a good spec for META.yml, so it is possibly ignoring the 'provides'
      section. No matter, as META.json is supposedly preferred by CPAN. Note 
      that META.json is version 2 of the spec, while META.yml is version 1.4.

(see INFO/Changes_2025 for earlier changes)

Note that INFO/Changes-ver_2 (for changes released for PDF::API2, and 
incorporated into PDF::Builder) is NOT being updated any longer. You may
assume that any change logged for API2 has also been incorporated into
Builder, with any exceptions or differences noted here.