asciidoctor 1.5.8 → 2.0.17

data/CHANGELOG.adoc

@@ -1,5 +1,5 @@
 = Asciidoctor Changelog
-:uri-asciidoctor: http://asciidoctor.org
+:uri-asciidoctor: https://asciidoctor.org
 :uri-asciidoc: {uri-asciidoctor}/docs/what-is-asciidoc
 :uri-repo: https://github.com/asciidoctor/asciidoctor
 :icons: font
@@ -8,10 +8,569 @@ ifndef::icons[]
 :star: ★
 endif::[]
 
-{uri-asciidoctor}[Asciidoctor] is a _fast_, open source text processor and publishing toolchain for converting {uri-asciidoc}[AsciiDoc] content into HTML5, DocBook 5 (or 4.5) and other formats.
+{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 a detailed view of 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 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)
+  * Convert apostrophe to the portable `+\*(Aq+` variable instead of the groff-specific escape `\(aq` (#4060) (*@felipec*)
+  * Document the `-e, --embedded` option flag in the man page, which replaces the outdated `-e, --eruby` option flag
+
+Improvements::
+
+  * Use queue to iterate over lines in reader instead of stack (#4106)
+  * Uppercase automatic reftext for level-2 section titles in manpage output if reftext matches section title (#4110)
+  * Show safe modes in strictness order in CLI help (#4065)
+  * Remove redundant styles from the default stylesheet
+  * Update font styles for summary element in default stylesheet to match font styles of paragraph (#4114)
+  * Update default stylesheet to indent content of details element (#4116)
+  * Update default stylesheet to use custom marker for summary element to make appearance consistent (#4116)
+  * Add Vietnamese translation of built-in attributes (PR #4066) (*@nguyenhoa93*)
+  * Add Thai translation of built-in attributes (PR #4113) (*@ammaneena*)
+
+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)
+
+== 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)
+  * Don't assign nil value to named attribute mapped to absent positional attribute when parsing attrlist (#4033)
+  * Remove leading and trailing spaces around role on inline phrase (#4035)
+  * Ignore empty role on inline phrase defined using legacy syntax and followed by comma (#4035)
+  * Use xreftext on document as fallback link text in HTML output for inter-document xref that resolves to current document when no link text is provided (#4032)
+  * Use xreftext on document as fallback link text in HTML output for internal xref with empty fragment when no link text is provided (#4032)
+  * Use document ID as linkend in DocBook output for internal xref with empty fragment; auto-generating one if necessary (#4032)
+
+Improvements::
+
+  * Format keyboard references in monospace in manpage output
+
+Build / Infrastructure::
+
+  * Get remaining invoker tests working on JRuby 9.1 for Windows
+
+== 2.0.14 (2021-04-19) - @mojavelinux
+
+Bug Fixes::
+
+  * Don't allow AsciiDoc table cell to set document attribute that was unset from the API (exceptions include: `compat-mode`, `toc`, `showtitle`, and `notitle`) (#4017)
+  * Ensure default document attributes unset in parent document remain unset in AsciiDoc table cell (#2586)
+  * Allow the `showtitle` / `notitle` attribute to be toggled in an AsciiDoc table cell if set or unset in parent document (#4018)
+  * Ensure mtime of input file honors TZ environment variable on JRuby for Windows (affects value of `docdatetime` attribute) (#3550)
+  * Honor caption attribute on blocks that support captioned title even if corresponding `*-caption` document attribute (e.g., `example-caption`) is not set (#4023)
+  * Suppress missing attribute warning when applying substitutions to implicit document title for assignment to intrinsic `doctitle` attribute (#4024)
+  * Increment counter (but not the corresponding attribute) if attribute is locked (#4013)
+
+Improvements::
+
+  * Use attribute, if set, as seed value for counter even if not already registered as a counter (#4014)
+  * Allow subs attribute value on Inline node returned by process method for custom inline macro to be a String (#3938)
+  * Allow value of `user-home` attribute to be overridden by API or CLI (#3732)
+
+Build / Infrastructure::
+
+  * Run tests on JRuby for Windows (#3550)
+
+== 2.0.13 (2021-04-10) - @mojavelinux
+
+Bug Fixes::
+
+  * Rollback change for #3470, which added logic to remove leading and trailing empty lines in an AsciiDoc include file; instead skip empty lines before processing document header (#3997)
+  * Don't allow `counter` and `counter2` attribute directives to override locked attributes (#3939) (*@mogztter*)
+  * Fix crash when resolving next value in sequence for counter with non-numeric value (#3940)
+  * Honor list of tags following negated wildcard on include directive (#3932)
+  * Update default stylesheet to remove dash in front of cite on nested quote block (#3847)
+  * Don't mangle formatting macros when uppercasing section titles in man page output (#3892)
+  * Don't escape hyphen in `manname` in man page output
+  * Remove extra `.sp` line before content of verse block in man page output
+  * Fix layout of footnotes in man page output (#3989)
+  * Fix formatting of footnote text with URL in man page output (#3988)
+  * Remove redundant trailing space on URL followed by non-adjacent text in man page output (#4004)
+  * Use `.bp` macro at location of page break in man page output (#3992)
+
+Improvements::
+
+  * Extract method to create lexer and formatter in Rouge adapter (#3953) (*@Oblomov*)
+  * Add support for pygments.rb 2.x (#3969) (*@slonopotamus*)
+  * Allow `NullLogger` to be enabled by setting the `:logger` option to a falsy value (#3982)
+  * Substitute attributes in manpurpose part of NAME section in manpage doctype (#4000)
+  * Output all mannames in name section of HTML output for manpage doctype (#3757)
+
+Build / Infrastructure::
+
+  * Enable running tests as root (PR #3874) (*@mikemckiernan*)
+  * Run tests against both pygments.rb 1.x and 2.x (#3969) (*@slonopotamus*)
+  * Speed up CI by using Bundler cache (PR #3901) (*@slonopotamus*)
+
+Documentation::
+
+  * Import documentation for processor into this repository (#3861) (*@graphitefriction*)
+  * Add Belarusian translation of built-in attributes (PR #3928) (*@morganov*)
+
+== 2.0.12 (2020-11-10) - @mojavelinux
+
+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 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)
+
+Compliance::
+
+  * Defer use of Ruby >= 2.3 constructs to restore compatibility with Ruby 2.0 until at least next minor release (#3827)
+  * Don't append the default px unit identifier to the explicit width or height value when inlining an SVG (#3829)
+
+Build / Infrastructure::
+
+  * Migrate Linux CI jobs to GitHub Actions (#3837)
+  * Migrate Windows CI jobs to GitHub Actions (#3839)
+  * Run CI job on macOS (#3842)
+
+== 2.0.11 (2020-11-02) - @mojavelinux
+
+Bug Fixes::
+
+  * Fix infinite loop when callout list with obsolete syntax is found inside list item (#3472)
+  * Fix infinite loop when xreftext contains a circular reference path in HTML and manpage converters (#3543)
+  * Apply text formatting to table cells in implicit header row when column has the "a" or "l" style (#3760)
+  * Fix errant reference warning for valid reference when running in compat mode (#3555)
+  * Initialize backend traits for converter (if not previously initialized) using assigned basebackend; mimics Asciidoctor < 2 behavior (#3341)
+  * Set source_location on preamble block when sourcemap option is enabled (#3799)
+  * Link the notitle and showtitle attributes so they act as opposites for the same toggle (#3804)
+  * Pass options to constructor of Rouge lexer instead of #lex method; restores compatibility with Rouge >= 3.4 (#3336)
+  * Don't clobber cgi-style options on language when enabling start_inline option on the Rouge PHP lexer (#3336)
+  * Fix parsing of wrapped link and xref text, including when an attrlist signature is detected (#3331)
+  * Restore deprecated writable number property on AbstractBlock
+  * Always use title as xreftext if target block has an empty caption, regardless of xrefstyle value (#3745)
+  * Allow a bibliography reference to be used inside a footnote (#3325)
+  * Fix bottom margin collapsing on AsciiDoc table cell (#3370)
+  * Remove excess hard line break in multi-line AsciiMath blocks (#3407)
+  * Only strip trailing spaces from lines of AsciiDoc include file (#3436)
+  * Remove errant optional flag in regexp for menu macro that breaks Asciidoctor.js (#3433)
+  * Preserve repeating backslashes when generating manpage output (#3456)
+  * Honor percentage width specified on macro of inline SVG (#3464)
+  * Removing leading and trailing blank lines in AsciiDoc include file to match assumption of parser (#3470)
+  * Activate extensions when :extensions option is set even if Extensions API is not yet loaded (#3570)
+  * Don't activate global extensions if :extensions option is false (#3570)
+  * Escape ellipsis at start of line in manpage output (#3645) (*@jnavila*)
+  * Don't register footnote with ID if a footnote is already registered with that ID (#3690)
+  * Honor start attribute on ordered list in manpage output (#3714)
+  * Warn instead of crashing if SVG to inline is empty (#3638) (*@mogztter*)
+  * Compute highlight line ranges on source block relative to value of start attribute (#3519) (*@mogztter*)
+  * Prevent collapsible block from incrementing example number by assigning an empty caption (#3639)
+  * Use custom init function for highlight.js to select the correct `code` elements (#3761)
+  * Fix resolved value of :to_dir when both :to_file and :to_dir options are set to absolute paths (#3778)
+  * Fix crash if value of `stylesheets` attribute contains a folder and the destination directory for the stylesheet does not exist (even when the `:mkdirs` option is set) (#3808)
+  * Fix crash if value passed by API for `copycss` attribute is not a string (#3592)
+  * Restore label in front of each bibliography entry in DocBook output that was dropped by fix for #3085 (#3782)
+  * Apply max width to each top-level container instead of body in HTML output (#3513)
+  * Don't apply border-collapse: separate to HTML for table blocks; fixes double border at boundary of colspan/rowspan (#3793) (*@ahus1*)
+  * Don't remove right border on last table cell in row (#2563)
+  * Rework table borders to leverage border collapsing (apply frame border to table, grid border to cells, and selectively override border on cells to accommodate frame) (#3387)
+
+Compliance::
+
+  * Account for empty positional attribute when parsing attrlist (#3813)
+  * Add support for muted option to self-hosted video (#3408)
+  * Move style tag for convert-time syntax highlighters (coderay, rouge, pygments) into head (#3462)
+  * Move style tag for client-side syntax highlighters (highlight.js, prettify) into head (#3503)
+  * Define entry point API methods (load, convert, load_file, convert_file) as class methods instead of module_function to avoid conflict with Kernel.load (#3625)
+  * Retain attribute order on HTML code tag for source block to remain consistent with output from 1.5.x (#3786)
+  * Correct language code for Korean language file from kr to ko (#3807) (*@jnavila*)
+
+Improvements::
+
+  * Apply word wrap (i.e., `word-wrap: anywhere`) to body in default stylesheet (#3544)
+  * Allow `nobreak` and `nowrap` roles to be used on any inline element (#3544)
+  * Add CSS class to support pre-wrap role to preserve leading, trailing, and repeating spaces in phrase (#3815)
+  * Preserve guard around XML-style callout when icons are not enabled (#3319)
+  * Use `.fam C` command to switch font family for verbatim blocks to monospaced text in manpage output (#3561)
+  * Remove redundant test for halign and valign attributes on table cell in DocBook converter
+  * Allow encoding of include file to be specified using encoding attribute (#3248)
+  * Allow template to be used to override outline by only specifying the outline template (#3491)
+  * Upgrade MathJax from 2.7.5 to 2.7.9
+  * Upgrade highlight.js from 9.15.10 to 9.18.3 (note that this increases script size from 48.8 KB to 71.5 KB)
+  * Skip unused default attribute assignments for embedded document
+  * Allow a URL macro to have a preceding single or double quote (#3376)
+  * Add support for erubi template engine; use it in place of erubis in test suite; note the use of erubis is deprecated (#3737)
+  * Download and embed remote custom stylesheet if allow-uri-read is set (#3765)
+  * Remove direction property from default stylesheet (#3753) (*@abdnh*)
+  * remove max width setting on content column for print media in default stylesheet (#3802)
+  * Normalize frame value "topbot" to "ends" in HTML output (consistently use frame-ends class) (#3797)
+  * Add role setter method on AbstractNode (#3614)
+  * Map chapter-signifier and part-signifier attributes in locale attribute files to replace chapter-label and part-label (#3817)
+
+Build / Infrastructure::
+
+  * Run test suite on TruffleRuby nightly (*@mogztter*, *@erebor*)
+  * Upgrade TruffleRuby to 20.0.0 (*@mogztter*)
+  * Trigger upstream builds for AsciidoctorJ on Github Actions (*@robertpanzer*)
+
+== 2.0.10 (2019-05-31) - @mojavelinux
+
+Bug Fixes::
+
+  * fix Asciidoctor.convert_file to honor `header_footer: false` option when writing to file (#3316)
+  * fix placement of title on excerpt block (#3289)
+  * always pass same options to SyntaxHighlighter#docinfo, regardless of value of location argument
+  * fix signature of SyntaxHighlighter#docinfo method (#3300)
+  * when `icons` is set to `image`, enable image icons, but don't use it as the value of the `icontype` attribute (#3308)
+
+== 2.0.9 (2019-04-30) - @mojavelinux
+
+Bug Fixes::
+
+  * process multiple single-item menu macros in same line (#3279)
+  * register images in catalog correctly (#3283)
+  * rename AbstractNode#options method to AbstractNode#enabled_options so it doesn't get shadowed by Document#options (#3282)
+  * don't fail to convert document if alt attribute is not set on block or inline image (typically by an extension)
+  * fix lineno of source location on blocks that follow a detached list continuation (#3281)
+  * assume inline image type is "image" if not set (typically by an extension)
+
+== 2.0.8 (2019-04-22) - @mojavelinux
+
+Bug Fixes::
+
+  * restore background color applied to literal blocks by default stylesheet (#3258)
+  * use portability constants (CC_ALL, CC_ANY) in regular expressions defined in built-in converters (DocBook5 and ManPage)
+  * use portability constant (CC_ANY) in regular expression for custom inline macros
+  * use smarter margin collapsing for AsciiDoc table cell content; prevent passthrough content from being cut off (#3256)
+  * don't limit footnote ref to ASCII charset; allow any word character in Unicode to be used (#3269)
+
+Improvements::
+
+  * register_for methods accept arguments as symbols (#3274)
+  * use Concurrent::Map instead of Concurrent::Hash in template converter
+  * use module_function keyword to define methods in Helpers
+  * move regular expression definitions to separate source file (internal change)
+
+== 2.0.7 (2019-04-13) - @mojavelinux
+
+Bug Fixes::
+
+  * fix crash when resolving ID from text and at least one candidate contains an unresolved xref (#3254)
+  * fix compatibility with Rouge 2.0
+
+Improvements::
+
+  * improve documentation for the `-a` CLI option; explain that `@` modifier can be placed at end of name as alternative to end of value
+  * move source for main API entry points (load, load_file, convert, convert_file) to separate files (internal change)
+  * define main API entry points (load, load_file, convert, convert_file) as module functions
+
+Also see https://github.com/asciidoctor/asciidoctor/milestone/33?closed=1[issues resolved in 2.0.x] (cumulative).
+
+== 2.0.6 (2019-04-04) - @mojavelinux
+
+Bug Fixes::
+
+  * assume implicit AsciiDoc extension on inter-document xref macro target with no extension (e.g., `document#`); restores 1.5.x behavior (#3231)
+  * don't fail to load application if call to Dir.home fails; use a rescue with fallback values (#3238)
+  * Helpers.rootname should only consider final path segment when dropping file extension
+
+Improvements::
+
+  * implement Helpers.extname as a more efficient and flexible File.extname method
+  * check for AsciiDoc file extension using end_with? instead of resolving the extname and using a lookup
+
+Also see https://github.com/asciidoctor/asciidoctor/milestone/33?closed=1[issues resolved in 2.0.x] (cumulative).
+
+== 2.0.5 (2019-04-01) - @mojavelinux
+
+Bug Fixes::
+
+  * fix crash when source highlighter is Rouge and source language is not set on block (#3223)
+  * update CLI and SyntaxHighlighter to allow Asciidoctor to load cleanly on Ruby 2.0 - 2.2
+  * CLI should use $stdin instead of STDIN to be consistent with the use of $stdout
+  * mark encoding of stdio objects used in CLI as UTF-8 (#3225)
+  * make Asciidoctor::SyntaxHighlighter::Config.register_for method public as documented
+
+Also see https://github.com/asciidoctor/asciidoctor/milestone/33?closed=1[issues resolved in 2.0.x] (cumulative).
+
+== 2.0.4 (2019-03-31) - @mojavelinux
+
+Bug Fixes::
+
+  * allow Asciidoctor to load cleanly on Ruby 2.0 - 2.2 for distributions that provide support for these older Ruby versions
+  * make Asciidoctor::Converter::Config.register_for method public as documented
+  * remove unused Asciidoctor::Converter::BackendTraits#derive_backend_traits private method
+  * move Asciidoctor::Converter::BackendTraits.derive_backend_traits method to Asciidoctor::Converter
+  * mark render and render_file methods as deprecated in API docs
+
+Also see https://github.com/asciidoctor/asciidoctor/milestone/33?closed=1[issues resolved in 2.0.x] (cumulative).
+
+== 2.0.3 (2019-03-28) - @mojavelinux
+
+Bug Fixes::
+
+  * fix crash when attrlist is used on literal monospace phrase (#3216)
+  * update use of magic regexp variables to fix compatibility with Opal / Asciidoctor.js (#3214)
+
+Also see https://github.com/asciidoctor/asciidoctor/milestone/33?closed=1[issues resolved in 2.0.x] (cumulative).
+
+== 2.0.2 (2019-03-26) - @mojavelinux
+
+Bug Fixes::
+
+  * apply verbatim substitutions to literal paragraphs attached to list item (#3205)
+  * implement #lines and #source methods on Table::Cell based on cell text (#3207)
+
+Also see https://github.com/asciidoctor/asciidoctor/milestone/33?closed=1[issues resolved in 2.0.x] (cumulative).
+
+== 2.0.1 (2019-03-25) - @mojavelinux
+
+Bug Fixes::
+
+  * convert titles of cataloged block and section nodes containing attribute references eagerly to resolve attributes while in scope (#3202)
+  * customize MathJax (using a postfilter hook) to apply displaymath formatting to AsciiMath block (#2498)
+  * fix misspelling of deprecated default_attrs DSL function (missing trailing "s")
+  * remove unused location property (attr_accessor :location) on DocinfoProcessor class
+  * look for deprecated extension option :pos_attrs if :positional_attrs option is missing (#3199)
+  * add detail to load error message if path differs from gem name (#1884)
+
+Build / Infrastructure::
+
+  * bundle .yardopts in RubyGem (#3193)
+
+Also see https://github.com/asciidoctor/asciidoctor/milestone/33?closed=1[issues resolved in 2.0.x] (cumulative).
+
+== 2.0.0 (2019-03-22) - @mojavelinux
+
+Enhancements / Compliance::
+
+  * drop support for Ruby < 2.3 and JRuby < 9.1 and remove workarounds (#2764)
+  * drop support for Slim < 3 (#2998)
+  * drop the converter for the docbook45 backend from core; moved to https://github.com/asciidoctor/asciidoctor-docbook45 (#3005)
+  * apply substitutions to section and block titles in normal substitution order (#1173)
+  * make syntax highlighter pluggable; extract all logic into adapter classes (#2106)
+  * add syntax highlighter adapter for Rouge (#1040)
+  * redesign Converter API based on SyntaxHighlighter API; remap deprecated API to new API to ensure compatibility (#2891)
+  * repurpose built-in converters as regular converters (#2891)
+  * make registration and resolution of global converters thread-safe (#2891)
+  * fold the default converter factory into the Converter module (#2891)
+  * add a default implementation for Converter#convert in the Base converter (#2891)
+  * rename Converter::BackendInfo to Converter::BackendTraits; map backend_info to new backend_traits method (#2891)
+  * allow built-in converter classes to be resolved using Converter#for and instantiated using Converter#create (#2891)
+  * allow converter factory to be passed using :converter_factory API option (#2891)
+  * honor htmlsyntax if defined on converter (#2891)
+  * add backend_traits_source keyword argument to CompositeConverter constructor (#2891)
+  * add support for start attribute when using prettify to highlight source blocks with line numbering enabled
+  * use String#encode to encode String as UTF-8 instead of using String#force_encoding (#2764)
+  * add FILE_READ_MODE, URI_READ_MODE, and FILE_WRITE_MODE constants to control open mode when reading files and URIs and writing files (#2764)
+  * set visibility of private and protected methods (#2764)
+  * always run docinfo processor extensions regardless of safe mode (gives control to extension) (#2966)
+  * use infinitive verb form for extension DSL method names; map deprecated method names where appropriate
+  * add docinfo insertion slot for header location to built-in converters (#1720)
+  * add support for the `muted` option on vimeo videos (allows autoplay to work in Chrome) (#3014)
+  * use value of prettify-theme attribute as is if it starts with http:// or https:// (#3020)
+  * allow icontype to be set using icons attribute (#2953)
+  * when using a server-side syntax highlighter, highlight content of source block even if source language is not set (#3027)
+  * automatically promote a listing block without an explicit style to a source block if language is set (#1117)
+  * remove the 2-character (i.e., `""`) quote block syntax
+  * don't allow block role to inherit from document attribute; only look for role in block attributes (#1944)
+  * split out functionality of -w CLI flag (script warnings) from -v CLI flag (verbose logging) (#3030)
+  * log possible invalid references at info level (#3030)
+  * log dropped lines at info level when attribute-missing=drop-line (#2861)
+  * honor attribute-missing setting when processing include directives and block macros (#2855)
+  * log warning when include directive is not resolved due to missing attribute or blank target; always include warning in output document (#2868)
+  * use the third argument of AbstractNode#attr / AbstractNode#attr? to set the name of a fallback attribute to look for on the document (#1934)
+  * change default value of third argument to Abstractnode#attr / AbstractNode#attr? to nil so attribute doesn't inherit by default (#3059)
+  * look for table-frame, table-grid, and table-stripes attributes on document as fallback for frame, grid, and stripes attributes on table (#3059)
+  * add support for hover mode for table stripes (stripes=hover) (#3110)
+  * always assume the target of a shorthand inter-document xref is a reference to an AsciiDoc document (source-to-source) (#3021)
+  * if the target of a formal xref macro has a file extension, assume it's a path reference (#3021)
+  * never assume target of a formal xref macro is a path reference unless a file extension or fragment is present (#3021)
+  * encode characters in URI to comply with RFC-3986
+  * implement full support for styled xreftext in manpage converter (#3077)
+  * allow the ID and role properties to be set on a list item of ordered and unordered lists via the API (#2840)
+  * yield processor instance to registration block for document processor if block has non-zero arity (i.e., has parameters)
+  * add Document#parsed? method to check whether document has been parsed
+  * modify Cell class to extend from AbstractBlock instead of AbstractNode (#2963)
+  * implement block? and inline? methods on Column, both which return false (#2963)
+  * drop verse table cell style (treat as normal table cell) (#3111)
+  * allow negated subs to be specified on inline pass macro (#2191)
+  * log warning if footnoteref macro is found and compat mode is not enabled (#3114)
+  * log info message if inline macro processor returns a String value (#3176)
+  * apply subs to Inline node returned by inline macro processor if subs attribute is specified (#3178)
+  * add create_inline_pass helper method to base extension processor class (#3178)
+  * log debug message instead of warning if block style is unknown (#3092)
+  * allow backend to delegate to a registered backend using the syntax synthetic:delegate when using custom templates (e.g., slides:html) (#891)
+  * AbstractBlock#find_by looks inside AsciiDoc table cells if traverse_documents selector option is true (#3101)
+  * AbstractBlock#find_by finds table cells, which can be selected using the :table_cell context in the selector (#2524)
+  * allow ampersand to be used in e-mail address (#2553)
+  * propagate ID assigned to inline passthrough (#2912)
+  * rename control keywords in find_by to better align with the standard NodeFilter terminology
+  * stop find_by iteration if filter block returns :stop directive
+  * rename header_footer option to standalone (while still honoring header_footer for backwards compatibility) (#1444)
+  * replace anchors and xrefs before footnotes (replace footnotes last in macros substitution group)
+  * apply substitution for custom inline macro before all other macros
+  * only promote index terms automatically (A, B, C becomes A > B > C + B > C + C) if indexterm-promotion option is set on document (#1487)
+  * add support for see and see-also on index terms; parse attributes on indexterm macros if text contains `=` (#2047)
+  * drop :indexterms table from document catalog (in preparation for solution to #450 in a 2.x release)
+  * load additional languages for highlight.js as defined in the comma-separated highlightjs-languages attribute (#3036)
+  * log warning if conditional expression in ifeval directive is invalid (#3161)
+  * drop lines that contain an invalid preprocessor directive (#3161)
+  * rename AbstractBlock#find_by directives; use :prune in place of :skip_children and :reject in place of :skip
+  * convert example block into details/summary tag set if collapsible option is set; open by default if open option is set (#1699)
+  * substitute replacements in author values used in document header (#2441)
+  * require space after semi-colon that separates multiple authors (#2441)
+  * catalog inline anchors at start of callout list items (#2818) (*@owenh000*)
+  * add parse_attributes helper method to base extension Processor class (#2134)
+  * require at least one character in the term position of a description list (#2766)
+
+Improvements::
+
+  * propagate document ID to DocBook output (#3011)
+  * always store section numeral as string; compute roman numeral for part at assignment time (@vmj)
+  * refactor code to use modern Hash syntax
+  * define LIB_DIR constant; rename *_PATH constants to *_DIR constants to be consistent with RubyGems terminology (#2764)
+  * only define ROOT_DIR if not already defined (for compatibility with Asciidoctor.js)
+  * move custom docinfo content in footer below built-in docinfo content in footer in HTML converter (#3017)
+  * read and write files using File methods instead of IO methods (#2995)
+  * value comparison in AbstractNode#attr? is only performed if expected value is truthy
+  * align default CodeRay style with style for other syntax highlighters (#2106)
+  * ensure linenos class is added to linenos column when source highlighter is pygments and pygments-css=style
+  * disable table stripes by default (#3110)
+  * rename CSS class of Pygments line numbering table to linenotable (to align with Rouge) (#1040)
+  * remove unused Converter#convert_with_options method (#2891)
+  * add -e, --embedded CLI flag as alias for -s, --no-header-footer (require long option to specify eRuby impl) (#1444)
+  * don't store the options attribute on the block once the options are parsed (#3051)
+  * add an options method on AbstractNode to retrieve the set of option names (#3051)
+  * pass :input_mtime option to Document constructor; let Document constructor assign docdate/time/year attributes (#3029)
+  * never mutate strings; add a `frozen_string_literal: true` magic comment to top of all Ruby source files (#3054)
+  * always use docdate and doctime to compute docyear and docdatetime (#3064)
+  * rename PreprocessorReader#exceeded_max_depth? to PreprocessorReader#exceeds_max_depth? and return nil if includes are disabled
+  * stop populating :ids table in document catalog (#3084)
+  * always use :refs table in document catalog to look for registered IDs (#3084)
+  * don't compute and store reference text in document catalog (#3084)
+  * populate reference text table lazily for resolving ID by reference text (#3084)
+  * don't store fallback reference text on :bibref node (#3085)
+  * call AbstractNode#reftext instead of AbstractNode#text to retrieve reference text for bibref node (#3085)
+  * only map unparsed attrlist of inline macro to target when format is short
+  * add clearer exception message when source data is binary or has invalid encoding (#2884)
+  * rename context for table cell and table column to :table_cell and :table_column, respectively
+  * rename hardbreaks document attribute to hardbreaks-option; retain hardbreaks as a deprecated alias (#3123)
+  * extend TLD for implicit e-mail addresses to 5 characters (#3154)
+  * truncate with precision (instead of rounding) when computing absolute width for columns in DocBook output (#3131)
+  * drop legacy LaTeX math delimiters (e.g, `$..$`) if present (#1339)
+  * use proper terminology in warning message about mismatched preprocessor directive (#3165)
+  * rename low-level extension attribute name :pos_attrs to :positional_attrs
+  * mark default_attrs extension DSL method deprecated in favor of default_attributes
+  * upgrade MathJax to 2.7.5
+
+Bug Fixes::
+
+  * fix crash caused by inline passthrough macro with the macros sub clearing the remaining passthrough placeholders (#3089)
+  * fix crash if ifeval directive is missing expression (#3164)
+  * prevent relative leveloffset from making section level negative and causing hang (#3152)
+  * don't fail to parse Markdown-style quote block that only contains attribution line (#2989)
+  * enforce rule that Setext section title must have at least one alphanumeric character; fixes problem w/ block nested inside quote block (#3060)
+  * apply header subs to doctitle value when assigning it back to the doctitle document attribute (#3106)
+  * don't fail if value of pygments-style attribute is not recognized; gracefully fallback to default style (#2106)
+  * do not alter the $LOAD_PATH (#2764)
+  * fix crash if stem block is empty (#3118)
+  * remove conditional comment for IE in output of built-in HTML converter; fixes sidebar table of contents (#2983)
+  * fix styling of source blocks with linenums enabled when using prettify as syntax highlighter (#640)
+  * update default stylesheet to support prettify themes (#3020)
+  * remove hard-coded color values on source blocks in default stylesheet (#3020)
+  * add fallback if relative path cannot be computed because the paths are located on different drives (#2944)
+  * ignore explicit section level style (#1852)
+  * don't eat space before callout number in source block if line-comment attribute is empty (#3121)
+  * check if type is defined in a way that's compatible with autoload
+  * fix invalid check for DSL in extension class (previously always returned true)
+  * scope constant lookups (#2764)
+  * use byteslice instead of slice to remove BOM from string (#2764)
+  * don't fail if value of -a CLI option is empty string or equals sign (#2997)
+  * allow failure level of CLI to be set to info
+  * Reader#push_include should not fail if data is nil
+  * fix deprecated ERB trim mode that was causing warning (#3006)
+  * move time anchor after query string on vimeo video to avoid dropping options
+  * allow color for generic text, line numbers, and line number border to inherit from Pygments style (#2106)
+  * enforce and report relative include depth properly (depth=0 rather than depth=1 disables nested includes)
+  * allow outfilesuffix to be soft set from API (#2640)
+  * don't split paragraphs in table cell at line that resolves to blank if adjacent to other non-blank lines (#2963)
+  * initialize the level to WARN when instantiating the NullLogger
+  * next_adjacent_block should not fail when called on dlist item (#3133)
+  * don't suppress browser styles for summary tag; add pointer cursor and panel margin bottom (#3155)
+  * only consider TLDs in e-mail address that have ASCII alpha characters
+  * allow underscore in domain of e-mail address
+
+Build / Infrastructure::
+
+  * clear SOURCE_DATE_EPOCH env var when testing timezones (PR #2969) (*@aerostitch*)
+  * remove compat folder (removes the AsciiDoc.py config file that provides pseudo-compliance with Asciidoctor and a stylesheet for an old Font Awesome migration)
+  * add Ruby 2.6.0 to build matrix
+  * stop running CI job on unsupported versions of Ruby
+  * exclude test suite, build script, and Gemfile from gem (#3044)
+  * split build tasks out into individual files
+
+Also see https://github.com/asciidoctor/asciidoctor/milestone/33?closed=1[issues resolved in 2.0.x] (cumulative).
 
 == 1.5.8 (2018-10-28) - @mojavelinux
 
@@ -37,9 +596,10 @@ Enhancements::
   * add support for start attribute on source block to set starting line number when converting to DocBook (#2915)
   * track imagesdir for image on node and in catalog (#2779)
   * allow starting line number to be set using start attribute when highighting source block with Pygments or CodeRay (#1742)
+  * add intrinsic attribute named `pp` that effectively resolves to `++` (#2807)
   * upgrade highlight.js to 9.13.1
 
-Fixes::
+Bug Fixes::
 
   * don't hang on description list item that begins with /// (#2888)
   * don't crash when using AsciiDoc table cell style on column in CSV table (#2817)
@@ -102,10 +662,9 @@ Build / Infrastructure::
 
   * replace thread_safe with concurrent-ruby (PR #2822) (*@junaruga*)
 
-// tag::compact[]
 == 1.5.7.1 (2018-05-10) - @mojavelinux
 
-Fixes::
+Bug Fixes::
 
   * fix regression where block attributes where being inherited by sibling blocks in a complex list item (#2771)
   * don't apply lead styling to first paragraph in nested document (AsciiDoc table cell) if role is present (#2624)
@@ -122,6 +681,11 @@ Enhancements::
 
   * BREAKING: drop XML tags, character refs, and non-word characters (except hyphen, dot, and space) when auto-generating section IDs (#794)
    ** hyphen, dot, and space are replaced with value of idseparator, if set; otherwise, spaces are dropped
+  * BREAKING: disable inter-document xrefs in compat mode (#2740)
+  * BREAKING: automatically parse attributes in link macro if equals is present, ignoring linkattrs (except in compat mode) (#2059)
+  * pass non-AsciiDoc file extensions in target of xref through unprocessed (#2740)
+  * process any known AsciiDoc file extension in target of shorthand inter-document xref if hash is also present (e.g., `<<target.asciidoc#,text>>`) (#2740)
+  * only allow .adoc to be used in target of formal xref macro to create an inter-document xref (with or without a hash) (#2740)
   * allow attribute names to contain any word character defined by Unicode (#2376, PR #2393)
   * do not recognize attribute entry line if name contains a colon (PR #2377)
   * route all processor messages through a logger instead of using Kernel#warn (#44, PR #2660)
@@ -133,15 +697,16 @@ Enhancements::
   * add `--failure-level=LEVEL` option to CLI to force non-zero exit code if specified logging level is reached (#2003, PR #2674)
   * parse text of xref macro as attributes if attribute signature found (equal sign) (#2381)
   * allow xrefstyle to be specified per xref by assigning the xrefstyle attribute on the xref macro (#2365)
-  * recognize target with .adoc extension in xref macro as an interdocument xref
+  * recognize target with .adoc extension in xref macro as an inter-document xref
   * resolve nested includes in remote documents relative to URI (#2506, PR #2511)
-  * allow `relfilesuffix` attribute to control file extension used for interdoc xrefs (#1273)
+  * allow `relfilesuffix` attribute to control file extension used for inter-document xrefs (#1273)
   * support `!name@` (preferred), `!name=@`, `name!@`, and `name!=@` syntax to soft unset attribute from API or CLI (#642, PR #2649)
   * allow modifier to be placed at end of name to soft set an attribute (e.g., `icons@=font`) (#642, PR #2649)
   * interpret `false` attribute value defined using API as a soft unset (#642, PR #2649)
   * number parts if `partnums` attribute is set (#2298)
   * allow footnote macro to define or reference footnote reference (footnoteref macro now deprecated) (#2347, PR #2362)
   * allow custom converter to be used with custom templates; converter must declare that it supports templates (#2619)
+  * add syntax help topic to CLI (`-h syntax`) (#1573)
   * allow manpage path for manpage help topic to be specified using ASCIIDOCTOR_MANPAGE_PATH environment variable (PR #2653) (*@aerostitch*)
   * if manpage cannot be found in default path inside gem, use `man -w asciidoctor` to resolve installed path (PR #2653)
   * uncompress contents of manpage for manpage help topic if path ends with .gz (PR #2653) (*@aerostitch*)
@@ -160,7 +725,7 @@ Enhancements::
   * 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)
@@ -170,7 +735,7 @@ Enhancements::
   * upgrade to Font Awesome 4.7.0 (#2569)
   * upgrade to MathJax 4.7.4
 
-Bug fixes::
+Bug Fixes::
 
   * set `:to_dir` option value correctly when output file is specified (#2382)
   * preserve leading indentation in contents of AsciiDoc table cell if contents starts with a newline (#2712)
@@ -240,7 +805,6 @@ Improvements / Refactoring::
   * move callouts into document catalog (PR #2394)
   * document ID defined in block attribute line takes precedence over ID defined inside document title line
   * don't look for link and window attributes on document when resolving these attributes for an image
-  * when linkattrs is set, only parse attributes in link macro if equals is present
   * skip line comments in name section of manpage (#2584, PR #2585)
   * always activate extension registry passed to processor (PR #2379)
   * skip extension registry activation if no groups are registered (PR #2373)
@@ -249,7 +813,7 @@ Improvements / Refactoring::
   * add methods to read results from timings (#2578, PR #2580)
   * collapse bottom margin of last block in AsciiDoc table cell (#2568, PR #2593)
   * set authorcount to 0 if there are no authors (#2519, PR #2520)
-  * validate fragment of interdoc xref that resolves to current doc (#2448, PR #2449)
+  * validate fragment of inter-document xref that resolves to current doc (#2448, PR #2449)
   * put id attribute on tag around phrase instead of preceding anchor (#2445, PR #2446)
   * add .plist extension to XML circumfix comment family (#2430, PR #2431) (*@akosma*)
   * alias Document#title method to no args Document#doctitle method (#2429, PR #2432)
@@ -293,11 +857,10 @@ Distribution Packages::
   * https://packages.ubuntu.com/search?keywords=asciidoctor[Ubuntu (asciidoctor)]
   * https://pkgs.alpinelinux.org/packages?name=asciidoctor[Alpine Linux (asciidoctor)]
   * https://software.opensuse.org/package/rubygem-asciidoctor[OpenSUSE (rubygem-asciidoctor)]
-// end::compact[]
 
 == 1.5.6.2 (2018-03-20) - @mojavelinux
 
-Bug fixes::
+Bug Fixes::
 
   * fix match for multiple xref macros w/ implicit text in same line (#2450)
   * PathResolver#root? returns true for absolute URL in browser env (#2595)
@@ -336,7 +899,7 @@ Enhancements::
 
   * Don't include title of special section in DocBook output if untitled option is set (e.g., dedication%untitled)
 
-Bug fixes::
+Bug Fixes::
 
   * continue to read blocks inside a delimited block after content is skipped (PR #2318)
   * don't create an empty paragraph for skipped content inside a delimited block (PR #2319)
@@ -390,6 +953,7 @@ https://github.com/asciidoctor/asciidoctor/compare/v1.5.6\...v1.5.6.1[full diff]
 == 1.5.6 (2017-07-12) - @mojavelinux
 
 Enhancements::
+
   * use custom cross reference text if xrefstyle attribute is set (full, short, basic) (#858, #1132)
   * store referenceable nodes under refs key in document catalog (PR #2220)
   * apply reftext substitutions (specialchars, quotes, replacements) to value returned by reftext method (PR #2220)
@@ -426,6 +990,7 @@ Enhancements::
   * add Cell#text= method
 
 Improvements::
+
   * significant improvements to performance, especially in parser and substitutors
   * process include directive inside text of short form preprocessor conditional (#2146)
   * add support for include tags in languages that only support only circumfix comments (#1729)
@@ -487,9 +1052,10 @@ Improvements::
   * rename macro regexp constants so name follows type (e.g., InlineImageMacroRx)
 
 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
@@ -530,7 +1096,8 @@ Compliance::
   * remove regexp hacks for Opal (#2110)
   * drop outdated quoting exceptions for Opal (PR #2081)
 
-Bug fixes::
+Bug Fixes::
+
   * don't allow table borders to cascade to nested tables (#2151)
   * escape special characters in reftext of anchor (#1694)
   * sanitize content of authors meta tag in HTML output (#2112)
@@ -566,6 +1133,7 @@ Bug fixes::
   * handle cases when there are no lines for include directive to select
 
 Documentation::
+
   * enable admonition icons in README when displayed on GitHub
   * add German translation of chapter-label (PR #1920) (*@fapdash*)
   * add Ukrainian translation of built-in attributes (PR #1955) (*@hedrok*)
@@ -576,6 +1144,7 @@ Documentation::
   * add Bahasa Indonesia translation of built-in labels (*@triyanwn*)
 
 Build / Infrastructure::
+
   * upgrade highlight.js to 9.12.0 (#1652)
   * include entire test suite in gem (PR #1952) (*@voxik*)
   * upgrade Slim development dependency to 3.0.x (PR #1953) (*@voxik*)
@@ -607,17 +1176,19 @@ https://github.com/asciidoctor/asciidoctor/compare/v1.5.5\...v1.5.6[full diff]
 == 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; add roles to prevent breaks (#1814)
+  * 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)
   * Translate README to Chinese (*@diguage*)
   * Translate README to Japanese (*@Mizuho32*)
 
 Improvements::
+
   * Style nested emphasized phrases properly when using default stylesheet (#1691)
   * Honor explicit table width even when autowidth option is set (#1843)
   * Only explicit noheader option on table should disable implicit table header (#1849)
@@ -638,11 +1209,12 @@ Improvements::
   * 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::
+Bug Fixes::
   * Use method_defined? instead of respond_to? to check if method is already defined when patching (#1838)
   * Fix invalid conditional in HTML5 converter when handling of SVG
   * Processor#parse_content helper no longer shares attribute list between blocks (#1651)
@@ -654,7 +1226,8 @@ Bug fixes::
   * 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::
@@ -672,10 +1245,12 @@ https://github.com/asciidoctor/asciidoctor/compare/v1.5.4\...v1.5.5[full diff]
 == 1.5.4 (2016-01-03) - @mojavelinux
 
 Enhancements::
+
   * translate README into French (#1630) (*@anthonny*, *@mogztter*, *@gscheibel*, *@mgreau*)
   * allow linkstyle in manpage output to be configured (#1610)
 
 Improvements::
+
   * upgrade to MathJax 2.6.0 and disable loading messages
   * upgrade to Font Awesome 4.5.0
   * disable toc if document has no sections (#1633)
@@ -687,12 +1262,14 @@ Improvements::
   * allow asciidoctor cli to resolve library path when invoked without leading ./
 
 Compliance::
+
   * allow special section to be nested at any depth (#1591)
   * ensure colpcwidth values add up to 100%; increase precision of values to 4 decimal places (#1647)
   * ignore blank cols attribute on table (#1647)
   * support shorthand syntax for block attributes on document title (#1650)
 
-Bug fixes::
+Bug Fixes::
+
   * don't include default toc in AsciiDoc table cell; don't pass toc location attributes to nested document (#1582)
   * guard against nil dlist list item in find_by (#1618)
   * don't swallow trailing line when include file is not readable (#1602)
@@ -710,7 +1287,8 @@ Bug fixes::
   * don't fail if library is loaded more than once
 
 Infrastructure::
-  * remove trailing endlines in project source code
+
+  * remove trailing newlines in project source code
   * update contributing guidelines
   * explicitly test ifeval scenario raised in issue #1585
   * remove backreference substitution hack for Opal/Asciidoctor.js
@@ -731,6 +1309,7 @@ https://github.com/asciidoctor/asciidoctor/compare/v1.5.3\...v1.5.4[full diff]
 == 1.5.3 (2015-10-31) - @mojavelinux
 
 Enhancements::
+
   * add support for interactive & inline SVGs (#1301, #1224)
   * add built-in manpage backend (#651) (*@davidgamba*)
   * create Mallard backend; asciidoctor/asciidoctor-mallard (#425) (*@bk2204*)
@@ -743,6 +1322,7 @@ Enhancements::
   * make XrefInlineRx regexp more permissive (Mathieu Boespflug) (#844)
 
 Improvements::
+
   * load JavaScript and CSS at bottom of HTML document (#1238) (*@mogztter*)
   * list available backends in help text (#1271) (*@plaindocs*)
   * properly expand tabs in literal text (#1170, #841)
@@ -785,6 +1365,7 @@ Improvements::
   * prevent CodeRay from bolding every 10th line number
 
 Compliance::
+
   * use `<sup>` for footnote reference in text instead of `<span>` (#1523)
   * fix alignment of wrapped text in footnote (#1524)
   * include full stop after footnote number in embeddable HTML
@@ -792,7 +1373,8 @@ Compliance::
   * resolve missing attribute in ifeval to empty string (#1387)
   * support unbreakable & breakable options on table (rockyallen) (#1140)
 
-Bug fixes::
+Bug Fixes::
+
   * don't truncate exception stack in `Asciidoctor.load` (#1248)
   * don't fail to save cause of Java exception (#1458) (*@robertpanzer*)
   * fix precision error in timings report (#1342)
@@ -819,6 +1401,7 @@ Bug fixes::
   * fix grammar in warning messages regarding thread_safe gem
 
 Infrastructure::
+
   * migrate opal_ext from core to Asciidoctor.js (#1517)
   * add Ruby 2.2 to CI build; only specify minor Ruby versions
   * enable containerized builds on Travis CI
@@ -852,7 +1435,7 @@ Improvements::
   * define JAVASCRIPT_PLATFORM constant to simplify conditional logic in the JavaScript environment (#897)
   * provide access to destination directory, outfile and outdir via Document object (#1203)
   * print encoding information in version report produced by `asciidoctor -v` (#1210)
-  * add intrinsic attribute named `cpp` with value `C++` (#1208)
+  * add intrinsic attribute named `cpp` that effectively resolves to `C++` (#1208)
   * preserve URI targets passed to `stylesheet` and related attributes (#1192)
   * allow numeric characters in block attribute name (#1103)
   * support custom YouTube playlists (#1105)
@@ -873,7 +1456,7 @@ Compliance::
   * allow empty cell to appear at end of table row (#1106)
   * only produce one row for table in CSV or DSV format with a single cell (#1180)
 
-Bug fixes::
+Bug Fixes::
 
   * add explicit to_s call to generate delimiter settings for MathJax config (#1198)
   * fix includes that reference absolute Windows paths (#1144)
@@ -892,7 +1475,7 @@ https://github.com/asciidoctor/asciidoctor/compare/v1.5.1\...v1.5.2[full diff]
 
 == 1.5.1 (2014-09-29) - @mojavelinux
 
-Bug fixes::
+Bug Fixes::
 
   * recognize tag directives inside comments within XML files for including tagged regions
   * restore passthroughs inside footnotes when more than one footnote appears on the same line
@@ -999,7 +1582,7 @@ Improvements::
   * print runtime environment in version output, support -v as version flag (#785)
   * unwrap preamble if standalone (#533)
   * drop leading & trailing blank lines in verbatim & raw content (#724)
-  * remove trailing endlines from source data (#727)
+  * remove trailing newlines from source data (#727)
   * add flag to cli to suppress warnings (#557)
   * emit warning if tag(s) not found in include file (#639)
   * use <th> element for vertical table headers instead of header class (#738) (*@davidgamba*)
@@ -1087,7 +1670,7 @@ Bug Fixes::
 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*)
@@ -1172,13 +1755,13 @@ Compliance::
   * skip include directives when processing comment blocks
   * added xmlns to root element in docbook45 backend, set noxmlns attribute to disable
   * added a Compliance module to control compliance-related behavior
-  * added linkattrs feature to AsciiDoc compatibility file (#441)
-  * added level-5 heading to AsciiDoc compatibility file (#388)
-  * added new XML-based callouts to AsciiDoc compatibility file
-  * added absolute and uri image target matching to AsciiDoc compatibility file
-  * added float attribute on inline image macro to AsciiDoc compatibility file
-  * removed linkcss in AsciiDoc compatibility file
-  * fixed fenced code entry in compatibility file
+  * added linkattrs feature to AsciiDoc.py compatibility file (#441)
+  * added level-5 heading to AsciiDoc.py compatibility file (#388)
+  * added new XML-based callouts to AsciiDoc.py compatibility file
+  * added absolute and uri image target matching to AsciiDoc.py compatibility file
+  * added float attribute on inline image macro to AsciiDoc.py compatibility file
+  * removed linkcss in AsciiDoc.py compatibility file
+  * fixed fenced code entry in AsciiDoc.py compatibility file
 
 Bug Fixes::
 
@@ -1276,7 +1859,7 @@ Enhancements::
 
 Compliance::
 
-  * ~ 99.5% compliance with AsciiDoc
+  * ~ 99.5% compliance with AsciiDoc.py
   * drop line if target of include directive is blank (#376)
   * resolve attribute references in target of include directive (#367)
   * added irc scheme to link detection (#314)
@@ -1309,7 +1892,7 @@ Distribution Packages::
   * https://rubygems.org/gems/asciidoctor[RubyGem (asciidoctor)]
   * https://apps.fedoraproject.org/packages/rubygem-asciidoctor[Fedora (rubygem-asciidoctor)]
 
-http://asciidoctor.org/news/2013/05/31/asciidoctor-0-1-3-released[release notes] |
+https://asciidoctor.org/news/2013/05/31/asciidoctor-0-1-3-released[release notes] |
 https://github.com/asciidoctor/asciidoctor/issues?milestone=4&state=closed[issues resolved] |
 https://github.com/asciidoctor/asciidoctor/releases/tag/v0.1.3[git tag] |
 https://github.com/asciidoctor/asciidoctor/compare/v0.1.2\...v0.1.3[full diff]
@@ -1322,7 +1905,7 @@ Performance::
 
 Enhancements::
 
-  * new website at http://asciidoctor.org
+  * new website at https://asciidoctor.org
   * added a default stylesheet (#76)
   * added viewport meta tag for mobile browsers (#238)
   * set attributes based on safe mode (#244)
@@ -1337,7 +1920,7 @@ Enhancements::
 
 Compliance::
 
-  * added AsciiDoc compatibility file to make AsciiDoc behave like Asciidoctor (#257)
+  * added compatibility file to make AsciiDoc.py behave like Asciidoctor (#257)
   * restore alpha-based xml entities (#211)
   * implement video and audio block macros (#155)
   * implement toc block macro (#269)
@@ -1364,7 +1947,7 @@ Distribution Packages::
 
   * https://rubygems.org/gems/asciidoctor[RubyGem (asciidoctor)]
 
-http://asciidoctor.org/news/2013/04/25/asciidoctor-0-1-2-released[release notes] |
+https://asciidoctor.org/news/2013/04/25/asciidoctor-0-1-2-released[release notes] |
 https://github.com/asciidoctor/asciidoctor/issues?milestone=3&state=closed[issues resolved] |
 https://github.com/asciidoctor/asciidoctor/releases/tag/v0.1.2[git tag] |
 https://github.com/asciidoctor/asciidoctor/compare/v0.1.1\...v0.1.2[full diff]
@@ -1393,7 +1976,7 @@ Compliance::
   * 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
@@ -1437,7 +2020,7 @@ Enhancements::
   * added hardbreaks option to preserve line breaks in paragraph text (#119)
   * :header_footer option defaults to false when using the API, unless rendering to file
   * added idseparator attribute to customized separator used in generated section ids
-  * do not number special sections (differs from AsciiDoc)
+  * do not number special sections (differs from AsciiDoc.py)
 
 Compliance::
 
@@ -1445,7 +2028,7 @@ Compliance::
   * added support for name=value@ attribute syntax passed via cli (#97)
   * attr refs no longer case sensitive (#109)
   * fixed several cases of incorrect list handling
-  * don't allow links to consume endlines or surrounding angled brackets
+  * don't allow links to consume newlines or surrounding angled brackets
   * recognize single quote in author name
   * support horizontal labeled list style
   * added support for the d cell style