Release 2.3

[carlosame]

Version 2.3 shall be released in a few days, and this discussion is intended to prepare the Release Notes and any related topics.

svggen: support LinearGradientPaint and RadialGradientPaint (#123)

In addition to the existing SVGLinearGradient, two new SVGConverters have been added: one for LinearGradientPaint and one for RadialGradientPaint (both introduced with Java SE 6).

To make the naming more consistent, the existing SVGLinearGradient was renamed SVGGradient, and the two new ones are called SVGLinearGradient and SVGRadialGradient.

Contribution by Jens Kaiser @jens-kaiser, see issue #122 and PR #123.

svggen: customizable serialization in SVGGraphics2D (#132)

Some people have complained that the SVG output by Batik's SVGGraphics2D is ugly or too big, see BATIK-502 or BATIK-1337. This release introduces:

• A public serializer that has general validity.
• A new XmlSerializer interface that can be used to customize the serialization. Its default methods mimic what the previous code did.
• A CompactXmlSerializer implementation which significantly decreases the size of the output files.
• Methods for setting and getting a custom serializer to SVGGeneratorContext.

To use the compact serializer just set it:

SVGGeneratorContext context = ...
context.setXmlSerializer(new CompactXmlSerializer());

The customizable serialization also addresses BATIK-941 ("Allow toggling the output of DOCTYPE declaration"); if you do not want any DOCTYPE declaration just provide an empty implementation for XmlSerializer.writeDocumentType().

css: SVG2 compliance fixes for stroke-width and stroke-dasharray (#124)

The behavior of the stroke-width and stroke-dasharray properties complied with neither the SVG 1.1 nor the 2 specification. The new handling complies with version 2.

For the stroke-width property, this issue is related to BATIK-1390.

Other improvements

Parts of the code were cleaned up, made a bit smaller and faster. See the changelog below for details.

Detail of changes

• anim,svg-dom: Throwable created but not thrown Throwable created but not thrown #129.
• anim,svg-dom: use assertions to implement checkItemType() anim: use assertions to implement checkItemType() #131.
• awt: remove DEBUG hack from MultipleGradientPaintContext as discussed in User a SLF4J Logger instead of System.out or System.err #130.
• Remove a couple instances of disabled System.out.println debugging code, as discussed in User a SLF4J Logger instead of System.out or System.err #130.
• bridge: small refactor in StrokingTextPainter.
• css: SVG2 compliance fixes for stroke-width and stroke-dasharray css: stroke-width and stroke-dasharray do not comply with the SVG2 specification #124.
• svggen: support LinearGradientPaint and RadialGradientPaint echosvg-svggen: support LinearGradientPaint and RadialGradientPaint #122.
• svggen: customizable serialization in SVGGraphics2D svggen: customizable serialization in SVGGraphics2D #132.
• gvt: fix a get() race condition in b8a747b.
• Some modifiers in final classes are redundant or useless Removing unnecessary or misleading modifiers #126.
• Small cleanup: use for() loops instead of iterators, etc.
• Tests: arguments were reversed in assertNull Assertion always fails #128.
• Tests: use the default SVGDOMImplementation instance in DOMUtilitiesTest.
• Tests: support the excludeTests property across all project tests.
• Tests: remove test-only dependency on commons-io.
• Split a new CODE_STYLE.md file out of CONTRIBUTING.md.
• Add a Test infrastructure section to CONTRIBUTING.md.
• Upgrade to css4j 6.2.
• Upgrade to JUnit 5.14.1.
• actions: upgrade upload-artifact to v5.
• actions: upgrade to actions/checkout v6.

[carlosame]

A few git author statistics:

Version 2.3

Executing and slightly editing the output from

git log v2.2.1..HEAD --shortstat --pretty="%aE" | sed 's/\(.*\)@.*/\1/' | grep -v "^$" | awk 'BEGIN { line=""; } !/^ / { if (line=="" || !match(line, $0)) {line = $0 "," line }} /^ / { print line " # " $0; line=""}' | sort | sed -E 's/# //;s/ files? changed,//;s/([0-9]+) ([0-9]+ deletion)/\1 0 insertions\(+\), \2/;s/\(\+\)$/\(\+\), 0 deletions\(-\)/;s/insertions?\(\+\), //;s/ deletions?\(-\)//' | awk 'BEGIN {name=""; files=0; insertions=0; deletions=0;} {if ($1 != name && name != "") { print name ": " files " files changed, " insertions " insertions(+), " deletions " deletions(-), " insertions-deletions " net"; files=0; insertions=0; deletions=0; name=$1; } name=$1; files+=$2; insertions+=$3; deletions+=$4} END {print name ": " files " files changed, " insertions " insertions(+), " deletions " deletions(-), " insertions-deletions " net";}'

produces

carlosame: 91 files changed, 1958 insertions(+), 700 deletions(-), 1258 net
jens.kaiser: 16 files changed, 1040 insertions(+), 134 deletions(-), 906 net

All time

Editing the output of

git log --shortstat --pretty="%aE" | sed 's/\(.*\)@.*/\1/' | grep -v "^$" | awk 'BEGIN { line=""; } !/^ / { if (line=="" || !match(line, $0)) {line = $0 "," line }} /^ / { print line " # " $0; line=""}' | sort | sed -E 's/# //;s/ files? changed,//;s/([0-9]+) ([0-9]+ deletion)/\1 0 insertions\(+\), \2/;s/\(\+\)$/\(\+\), 0 deletions\(-\)/;s/insertions?\(\+\), //;s/ deletions?\(-\)//' | awk 'BEGIN {name=""; files=0; insertions=0; deletions=0;} {if ($1 != name && name != "") { print name ": " files " files changed, " insertions " insertions(+), " deletions " deletions(-), " insertions-deletions " net"; files=0; insertions=0; deletions=0; name=$1; } name=$1; files+=$2; insertions+=$3; deletions+=$4} END {print name ": " files " files changed, " insertions " insertions(+), " deletions " deletions(-), " insertions-deletions " net";}'

gives

dependabot[bot]: 1 files changed, 1 insertions(+), 1 deletions(-), 0 net
bella: 127 files changed, 8037 insertions(+), 2849 deletions(-), 5188 net
billh: 311 files changed, 10944 insertions(+), 4486 deletions(-), 6458 net
cam: 7510 files changed, 172736 insertions(+), 111759 deletions(-), 60977 net
carlosame: 19167 files changed, 436297 insertions(+), 467165 deletions(-), -30868 net
cjolif: 565 files changed, 17724 insertions(+), 7264 deletions(-), 10460 net
clay: 14 files changed, 1280 insertions(+), 99 deletions(-), 1181 net
deweese: 5033 files changed, 167126 insertions(+), 66978 deletions(-), 100148 net
deweese,clay: 1 files changed, 4 insertions(+), 4 deletions(-), 0 net
deweese,dvholten: 3 files changed, 6 insertions(+), 6 deletions(-), 0 net
deweese,helder: 1 files changed, 2 insertions(+), 0 deletions(-), 2 net
deweese,vhardy: 1 files changed, 0 insertions(+), 3 deletions(-), -3 net
dino: 112 files changed, 10812 insertions(+), 790 deletions(-), 10022 net
duncan: 3 files changed, 9 insertions(+), 1 deletions(-), 8 net
dvholten: 997 files changed, 12886 insertions(+), 11983 deletions(-), 903 net
gadams: 3729 files changed, 6046 insertions(+), 4879 deletions(-), 1167 net
helder: 350 files changed, 2545 insertions(+), 3009 deletions(-), -464 net
hillion: 4623 files changed, 231644 insertions(+), 96139 deletions(-), 135505 net
jens.kaiser: 16 files changed, 1040 insertions(+), 134 deletions(-), 906 net
jeremias: 19 files changed, 290 insertions(+), 557 deletions(-), -267 net
lbernardo: 457 files changed, 3577 insertions(+), 1923 deletions(-), 1654 net
lbernardo,gadams: 1 files changed, 6 insertions(+), 2 deletions(-), 4 net
lbernardo,vhennebert: 1 files changed, 4 insertions(+), 3 deletions(-), 1 net
nsochele: 127 files changed, 18701 insertions(+), 356 deletions(-), 18345 net
paripc: 1 files changed, 6 insertions(+), 0 deletions(-), 6 net
smowton: 3 files changed, 80 insertions(+), 0 deletions(-), 80 net
ssteiner: 1497 files changed, 6872 insertions(+), 14196 deletions(-), -7324 net
stefano: 89 files changed, 6066 insertions(+), 247 deletions(-), 5819 net
tkormann: 3028 files changed, 86437 insertions(+), 59269 deletions(-), 27168 net
vhardy: 12043 files changed, 350686 insertions(+), 203408 deletions(-), 147278 net
vhennebert: 69 files changed, 1549 insertions(+), 1537 deletions(-), 12 net

[carlosame]

Version 2.3 code statistics:

===============================================================================
 Language            Files        Lines         Code     Comments       Blanks
===============================================================================
 Autoconf                6          896          788           64           44
 Batch                   1           94           73            0           21
 CSS                    24          763          338          333           92
 Groovy                  1           54           30           18            6
 Java                 1736       355793       186833       125253        43707
 JavaScript             16         1949         1279          396          274
 JSON                    1           25           25            0            0
 Shell                   2          269          118          125           26
 SVG                   843       121516        92984        16877        11655
 Plain Text             22         1985            0         1685          300
 XSL                     3          374          199          124           51
 XML                    14          827          457          304           66
-------------------------------------------------------------------------------
 HTML                   26          422          355           49           18
 |- CSS                  2          125          110            4           11
 (Total)                            547          465           53           29
-------------------------------------------------------------------------------
 Markdown                8          924            0          663          261
 |- Groovy               1           23           17            5            1
 |- Java                 1            1            0            1            0
 |- Shell                2           45           45            0            0
 (Total)                            993           62          669          262
===============================================================================
 Total                2703       485891       283479       145891        56521
===============================================================================