CHANGELOG.adoc in asciidoctor-2.0.16 vs CHANGELOG.adoc in asciidoctor-2.0.17

@@ -9,26 +9,66 @@
 endif::[]
 
 {uri-asciidoctor}[Asciidoctor] is a _fast_, open source text processor and publishing toolchain for converting {uri-asciidoc}[AsciiDoc] content into HTML 5, DocBook 5, and other formats.
 
 This document provides a high-level view of the changes introduced in Asciidoctor by release.
-For an even more detailed look at what has changed, refer to the {uri-repo}/commits/master[commit history] on GitHub.
+For an even more detailed look at what has changed, refer to the {uri-repo}/commits/[commit history] on GitHub.
 
 This project utilizes semantic versioning.
 
 // tag::compact[]
+== 2.0.17 (2022-01-05) - @mojavelinux
+
+Bug Fixes::
+
+  * Don't crash if process method for custom block returns an abstract block with context `:compound` that isn't of type `Block` (e.g., a list)
+  * Ignore return value of process method for custom block or block macro if value matches parent argument
+  * Remove unnamespaced selectors in Pygments stylesheet
+  * Normalize output from Pygments to use `linenos` class for inline line numbering and trim space after number; update default stylesheet accordingly
+  * Change `AbstractBlock#sections?` to return false when called on block that isn't a Section or Document (PR #3591) *@mogztter*
+  * Hide built-in marker on HTML summary element in Safari when using default stylesheet (#4162)
+  * Hide outline around HTML summary when activated in Safari (#4162)
+  * Include primary video in value of `playlist` attribute when embeddding YouTube video (#4156)
+  * Honor stripes=none on nested table (#4165)
+  * Update default stylesheet to fix spacing around empty list item (#4184)
+  * Honor `:header_only` option when parsing document with manpage doctype (#4192)
+  * Use numeric character reference for closing square bracket around alt text of icon
+  * Process author or authors document attribute in document header when implicit doctitle is absent (#4206)
+  * Patch open-uri-cached gem to work with Ruby 3.1 (update: drop patch now that open-uri-cached has been fixed) (#4227)
+
+Improvements::
+
+  * Prevent line numbers on source blocks in HTML output from being selected (applies to pygments and coderay) (#4128)
+  * Allow hash to be specified for Vimeo video either in video ID or using `hash` attribute (#4176)
+  * Remove unnecessary specificity in default stylesheet for styling p element inside list item
+  * Remove obsolete gist embed styles from default stylesheet
+  * Allow `--failure-level` to be set to default value, `FATAL`
+  * Sort levels in help for `--failure-level` option in ascending order
+  * Invert FR translations for caution & warning admonition labels (#4212) (*cyChop*)
+  * Add tests for open-uri-cached integration that is activated by the `cache-uri` attribute
+  * Don't warn if negated tag is not found in include file (#4230)
+
+Documentation::
+
+  * Document how to extend an existing converter or create a new converter (#4136)
+  * Document the syntax topic of the `--help` CLI option (#4175)
+  * Document how to uninstall the Asciidoctor gem (#4154)
+  * Document how to enable and use the sourcemap (the `:sourcemap` option)
+  * Document how to catalog additional assets (the `:catalog_assets` option)
+
+// end::compact[]
 == 2.0.16 (2021-08-03) - @mojavelinux
 
 Bug Fixes::
 
   * Include all lines outside of specified tagged region when tag filter on include directive is a single negated tag (#4048)
   * Only interpret negated wildcard in tag filter on include directive as implicit globstar if it precedes other tags (#4086)
   * Change ifeval directive to resolve to false if comparison operation cannot be performed (#4046)
   * Don't crash if `:to_file` option is passed to `load` or `load_file` and value is not a string (#4055)
   * Use automatic link text if ID in shorthand xref is followed by dangling comma (e.g., `+<<idname,>>+`)
   * Update default stylesheet to indent blocks attached to list item in checklist (#2550)
-  * Update default stylesheet to reenable styling of implicit lead role on first paragraph of preamble inside AsciiDoc table cell
+  * Update default stylesheet to re-enable styling of implicit lead role on first paragraph of preamble inside AsciiDoc table cell
   * Update default stylesheet to fix conflict between text decoration and bottom border on abbr[title] element
   * Change invalid font family "sans" in default stylesheet to "sans-serif"
   * Fix missing automatic reftext for internal xrefs in manpage output (#4110)
   * Replace numeric character reference for plus in manpage output (#4059)
   * Replace numeric character reference for degree sign in manpage output (#4059)
@@ -50,11 +90,10 @@
 Build / Infrastructure::
 
   * Import source of default stylesheet into this repository; use PostCSS with cssnano to minify (#4062)
   * Use autoprefixer to manage browser prefixes in default stylesheet (#4118)
 
-// end::compact[]
 == 2.0.15 (2021-04-27) - @mojavelinux
 
 Bug Fixes::
 
   * Don't include trailing period, question mark, or exclamation point in target (URL) of autolink (#3860)
@@ -135,11 +174,11 @@
 
 Bug Fixes::
 
   * Set type and target property on unresolved footnote reference and unset id property (fixes regression) (#3825)
   * Fix crash when inlining an SVG if the explicit width or height value on the image node is not a string (#3829)
-  * Reset word wrap behavior to normal on tables, then reenable again for admonition content, horizontal dlist description, and AsciiDoc table cells (#3833)
+  * Reset word wrap behavior to normal on tables, then re-enable again for admonition content, horizontal dlist description, and AsciiDoc table cells (#3833)
 
 Improvements::
 
   * Pass through role to DocBook output for inline image (#3832)
 
@@ -684,11 +723,11 @@
   * allow block title to begin with a period (#2358, PR #2359)
   * catalog inline anchor at start of list items in ordered and unordered lists, description list terms, and table cells (#2257)
   * register document in catalog if id is set; assign reftext to document attributes if specified in a block attribute line (#2301, PR #2428)
   * allow automatic width to be applied to individual columns in a table using the special value `~` (#1844)
   * use the quote element in DocBook converter to represent smart quotes (#2272, PR #2356) (@bk2204)
-  * parse and pass all manpage names to output document master (i.e., shadow man pages) (#1811, #2543, PR #2414)
+  * parse and pass all manpage names to output (i.e., shadow man pages) (#1811, #2543, PR #2414)
   * parse credit line of shorthand quote block as block attributes; apply normal subs to credit line in shorthand quote blocks (#1667, PR #2452)
   * populate copyright element in DocBook output from value of copyright attribute (#2728)
   * preserve directories if source dir and destination dir are set (#1394, PR #2421)
   * allow linkcss to be unset from API or CLI when safe mode is secure
   * convert quote to epigraph element in DocBook output if block has epigraph role (#1195, PR #2664) (*@bk2204*)
@@ -1014,11 +1053,11 @@
 
 Compliance::
 
   * retain block content in items of callout list when converting to HTML and man page (#1478)
   * only substitute specialchars for content in literal table cells (#1912)
-  * fix operator logic for ifndef directive with multiple attributes (#1983)
+  * fix operator logic for ifndef directive with multiple attributes to align with behavior of AsciiDoc.py; when attributes are separated by commas, content is only included if none of the attributes listed are set; when attributes are separated by pluses, content is included if at least one of the attributes is not set (#1983)
   * only recognize uniform underline for setext section title (#2083)
   * don't match headings with mixed leading characters (#2074)
   * fix layout break from matching lines it shouldn't
   * fix behavior of attribute substitution in docinfo content (PR #2296)
   * encode spaces in URI (PR #2274)
@@ -1137,11 +1176,11 @@
 == 1.5.5 (2016-10-05) - @mojavelinux
 
 Enhancements::
 
   * Add preference to limit the maximum size of an attribute value (#1861)
-  * Honor SOURCE_DATE_EPOCH environment variable to accomodate reproducible builds (#1721) (*@JojoBoulix*)
+  * Honor SOURCE_DATE_EPOCH environment variable to accommodate reproducible builds (#1721) (*@JojoBoulix*)
   * Add reversed attribute to ordered list if reversed option is enabled (#1830)
   * Add support for additional docinfo locations (e.g., :header)
   * Configure default stylesheet to break monospace word if exceeds length of line using `word-wrap: break-word`; add `nobreak` and `nowrap` roles to prevent breaks (#1814)
   * Introduce translation file for built-in labels (*@ciampix*)
   * Provide translations for built-in labels (*@JmyL* - kr, *@ciampix* - it, *@ivannov* - bg, *@maxandersen* - da, *@radcortez* - pt, *@eddumelendez* - es, *@leathersole* - jp, *@aslakknutsen* - no, *@shahryareiv* - fa, *@AlexanderZobkov* - ru, *@dongwq* - zh, *@rmpestano* - pt_BR, *@ncomet* - fr, *@lgvz* - fi, *@patoi* - hu, *@BojanStipic* - sr, *@fwilhe* - de, *@rahmanusta* - tr, *@abelsromero* - ca, *@aboullaite* - ar, *@roelvs* - nl)
@@ -1169,11 +1208,11 @@
   * Move list_marker_keyword method from AbstractNode to AbstractBlock
   * Rename definition list to description list internally
 
 Compliance::
 
-  * Support 6-digit decimal char refs, 5-digit hexidecimal char refs (#1824)
+  * Support 6-digit decimal char refs, 5-digit hexadecimal char refs (#1824)
   * Compatibility fixes for Opal
   * Check for number using Integer instead of Fixnum class for compatibility with Ruby 2.4
 
 Bug Fixes::
   * Use method_defined? instead of respond_to? to check if method is already defined when patching (#1838)
@@ -1186,11 +1225,11 @@
   * Use stronger CSS rule for general text color in Pygments stylesheet (#1802)
   * Don't duplicate forward slash for path relative to root (#1822)
 
 Infrastructure::
 
-  * Build gem properly in the absense of a git workspace, make compatible with JRuby (#1779)
+  * Build gem properly in the absence of a git workspace, make compatible with JRuby (#1779)
   * Run tests in CI using latest versions of Ruby, including Ruby 2.3 (*@ferdinandrosario*)
 
 Distribution Packages::
 
   * https://rubygems.org/gems/asciidoctor[RubyGem (asciidoctor)]
@@ -1629,11 +1668,11 @@
   * output and style HTML for toc macro correctly
 
 Infrastructure::
 
   * add Ruby 2.1 to list of supported platforms
-  * reenable rbx in Travis build
+  * re-enable rbx in Travis build
   * switch tests to minitest (*@ktdreyer*)
   * update RPM for Fedora Rawhide (*@ktdreyer*)
   * refactor unit tests so they work in RubyMine (*@cmoulliard*)
   * add preliminary benchmark files to repository (#1021)
   * clean out old fixtures from test suite (#960)
@@ -1935,10 +1974,10 @@
 
   * refactor reader, process attribute entries and conditional blocks while parsing (#143)
   * support limited value comparison functionality of ifeval (#83)
   * added support for multiple attributes in ifdef and ifndef directives
   * don't attempt to embed image with uri reference when data-uri is set (#157)
-  * accomodate trailing dot in author name (#156)
+  * accommodate trailing dot in author name (#156)
   * don't hardcode language attribute in html backend (#185)
   * removed language from DocBook root node (#188)
   * fixed revinfo line swallowing attribute entry
   * auto-generate caption for listing blocks if listing-caption attribute is set
   * support nested includes