Fixes Hugo warning messages that indicated real problems
with missing lines due to misinterpretation of
square brackets placed on a single line (started and
finished with square brackets belonging to different
AsciiDoc constructs).
The AsciiDoctor parser interprets a line that starts with an opening square
bracket and ends with a closing square bracket as a block attribute
directive. In the release notes for 9.1-10.3R, some paragraphs follow this
pattern:
[amd64,i386] The drm2(4) Radeon GPU driver... http://...[(r254885)]
The first "[" and the last "]" in this line are matched by the parser,
which then discards the entire content of the block. The parser only
emits a warning when it cannot parse the content of the directive,
which is why only certain lines produce visible errors. Most of these
paragraphs were silently dropped from the rendered output.
*The fix is to break the line* so that the paragraph does not begin with
"[" and end with "]". Moving the URL to a new line resolves the issue:
[amd64,i386] The drm2(4) Radeon GPU driver... http://...[(r254885)]
This problem only appears in the 9.1R-10.3R release notes.
Previous releases had HTML format. Later releases
switched to a different format for commit references that does not use
trailing square brackets, so they are unaffected.
Because the parser discards the
affected content silently without a warning in most cases, the problem
can easily go unnoticed. This makes it particularly dangerous, as it
can remove large sections of text without any indication that something
went wrong. We should keep this in mind when writing or reviewing any
AsciiDoc content.