aboutsummaryrefslogtreecommitdiff
path: root/changelog.txt
blob: 95cbf1c1aeb8ffd8f8ad4cf1ffa631fb88f96783 (plain)
  1. [0.29]
  2.   * Clarify that entities can't be used to indicate structure (#474).
  3. For example, you can't use `*` instead of `*` for a bullet
  4. list, or `
` to create a new paragraph.
  5. * Limit numerical entities to 6 hex or 7 decimal digits (#487).
  6. This is all that is needed given the upper bound on
  7. unicode code points.
  8. * Specify dropping of initial/final whitespace in setext heading content
  9. (#461).
  10. * Add example with a reference link definition where the reference is never
  11. used (#454).
  12. * Add example with setext header after reference link defs (#395).
  13. * Clarify that script, pre, style close tags can begin an HTML block (#517).
  14. * Remove `meta` from list of block tags in start condition #6 of
  15. HTML blocks (#527). meta tags are used in some inline contexts (though
  16. this isn't valid HTML5), e.g. in schema.org.
  17. * Disallow newlines inside of unquoted attributes (#507,
  18. Shyouhei Urabe) as per HTML spec:
  19. <https://html.spec.whatwg.org/multipage/syntax.html#unquoted>.
  20. * Remove vestigial restriction in list item spec (#543).
  21. The "not separated by more than one blank line" was a left-over
  22. from an earlier version of the spec in which two blank lines
  23. ended a list.
  24. * Fix tests where list items are indented 4+ spaces (#497).
  25. The tests did not accord with the spec here; these
  26. lines should be continuation lines (if no blank space)
  27. or indented code blocks (if blank space).
  28. * Clarify tildes and backticks in info strings (#119).
  29. We disallow backticks in info strings after backtick fences
  30. only. Both backticks and tildes are allowed in info strings
  31. after tilde fences. Add example.
  32. * Indicate that info string is trimmed of all whitespace (#505, Ashe
  33. Connor). As noted in
  34. <https://github.com/github/cmark/issues/60>, the info string
  35. is not only trimmed of "spaces" (U+0020) but also of tabs.
  36. * Don't strip spaces in code span containing only spaces (#569).
  37. This allows one to include a code span with just spaces,
  38. using the most obvious syntax.
  39. * Add example w/ reference link w/ empty destination in `<>` (#172).
  40. * Disallow link destination beginning with `<` unless it is inside `<..>`
  41. (#538). This brings the description in line with the spec example:
  42. ```
  43. [foo]: <bar>(baz)
  44. [foo]
  45. .
  46. <p>[foo]: <bar>(baz)</p>
  47. <p>[foo]</p>
  48. ```
  49. * Allow spaces inside link destinations in pointy brackets (#503).
  50. This reverts a change in 0.24 and should make things easier
  51. for people working with image paths containing spaces.
  52. * Remove redundant condition. We don't need to specify that the absolute
  53. URI in an autolink doesn't contain `<`, since this is specified in
  54. the description of an absolute URI.
  55. * Add additional spec examples involving link destinations in `<>` (#473).
  56. * Add test for `[test](<url\>)` (#562).
  57. * Disallow unescaped `(` in parenthesized link titles (#526).
  58. * Add example showing need for space before title in reference link (#469).
  59. * Add codepoints for punctuation characters (#564, Christoph Päper).
  60. * Clarify the left- and right-flanking definitions (#534, Jay Martin).
  61. * Match interior delimiter runs if lengths of both are multiples of 3
  62. (#528). This gives better results on `a***b***c` without giving bad
  63. results on the cases that motivated the original multiple of 3 rule.
  64. * Add another test case for emphasis (#509, Michael Howell).
  65. * Code spans: don't collapse interior space (#532).
  66. * Simplify revisions to code span normalization rules.
  67. Remove the complex rule about ignoring newlines adjacent
  68. to spaces. Now newlines are simply converted to spaces.
  69. * Replace image 'url' with 'destination' (#512, Phill).
  70. * Add some links for occurrences of "above" (#480).
  71. * Various typo fixes (#514, Kenta Sato; #533, nikolas;
  72. tnaia, #556; #551, Grahame Grieve).
  73. * Create .gitattributes so that changelog.txt is highlighted as
  74. markdown (#499, Christoph Päper).
  75. * Update GitHub links (Morten Piibeleht).
  76. * Update references to container and leaf block headers to use the
  77. correct pluralization (#531, Elijah Hamovitz).
  78. * Rephrase example #111 to indicate that the rendering is not mandated
  79. (#568).
  80. * Improve documentation of parsing strategy (#563).
  81. Note that `openers_bottom` needs to be indexed to
  82. delimiter run lengths as well as types.
  83. * make_spec.lua: Fix migration of children nodes in create_anchors (#536,
  84. Zhiming Wang). This resulted in some bugs in the rendered spec
  85. (where words would be dropped from links).
  86. * Fix dingus link when double clicking Markdown code (#535, Zhiming Wang).
  87. Prior to this commit, the link opened is always `/dingus/?text=` (no
  88. text).
  89. * Add spec.json generator to Makefile (M Pacer).
  90. [0.28]
  91. * Allow unlimited balanced pairs of parentheses in link URLs
  92. (@kivikakk, commonmark/cmark#166). The rationale is that there are many URLs
  93. containing unescaped nested parentheses. Note that
  94. implementations are allowed to impose limits on parentheses
  95. nesting for performance reasons, but at least three levels
  96. of nesting should be supported.
  97. * Change Rule 14 for Emphasis. Previously the nesting
  98. Strong (Emph (...)) was preferred over Emph (Strong (...)).
  99. This change makes Emph (Strong (...)) preferred.
  100. Note that the commonmark reference implementations
  101. were not entirely consistent about this rule, giving
  102. different results for
  103. ***hi***
  104. and
  105. ***hi****
  106. This change simplifies parsing. It goes against the majority
  107. of implementations, but only on something utterly trivial.
  108. * Clarify definition of delimiter runs (Aidan Woods, #485).
  109. * Clarify precedence of thematic breaks over list items
  110. in the list spec, not just the thematic break spec (Aidan Woods).
  111. * Clarify definition of link labels and normalization
  112. procedure (Matthias Geier, #479).
  113. * Clarify that the end of an HTML block is determined by its
  114. start, and is not changed by HTML tags encountered inside
  115. the block. Give an example of a case where a block ends
  116. before an interior element has been closed (Yuki Izumi, #459).
  117. In the future we might consider changing the spec to handle
  118. this case more intuitively; this change just documents more
  119. explicitly what the spec requires.
  120. * Acknowledge Aaron Swartz's role in developing Markdown.
  121. * Remove misleading backslash in example for disabling image markup
  122. (Matthias Geier).
  123. * Fix Unicode terminology (general category, not class)
  124. (Philipp Matthias Schaefer).
  125. * Add another illustrative case for code spans (#463).
  126. * Remove possibly misleading 'either's (#467).
  127. * Fix typo (Aidan Woods).
  128. * Clarify that some blocks can contain code spans (Matthias Geier).
  129. * Fix typo and clarified tab expansion rule (Scott Abbey).
  130. * Add a missing "iff" (Matthias Geier).
  131. * Add release checklist.
  132. * Added npm package for spec (Vitaly Puzrin).
  133. * Remove SPEC variable from Makefile.
  134. [0.27]
  135. * Update statement on blank lines and lists (Jesse Rosenthal).
  136. The definition of a list still said that "two blank lines end all
  137. containing lists." That rule has been removed.
  138. * Clarify that the exception for ordered lists only applies to first
  139. item in list (#420).
  140. * Added cases clarifying precedence of shortcut links (#427).
  141. * Added h2..h6 to block tag list (#430).
  142. * Remove duplicated test (Maxim Dikun). Tests 390 and 391 were the same.
  143. * Use fenced code blocks for markdown examples that are not test cases
  144. for uniformity.
  145. * Added closing paren (#428).
  146. * Test suite: Don't mess up on examples with 32 backticks (#423).
  147. * Removed duplicate reference to "container block".
  148. * Add examples for Unicode whitespace (Timothy Gu). In light of
  149. commonmark/commonmark.js#107, add a few examples/test cases to make sure the
  150. distinction between Unicode whitespace and regular whitespace is kept.
  151. * Fix missing closing paren typo (Robin Stocker).
  152. [0.26]
  153. * Empty list items can no longer interrupt a paragraph.
  154. This removes an ambiguity between setext headers and
  155. lists in cases like
  156. foo
  157. -
  158. Removed the "two blank lines breaks out of lists" rule.
  159. This is incompatible with the principle of uniformity
  160. (and indeed with the spec for list items, which requires
  161. that the meaning of a chunk of lines not change when it
  162. is put into a list item.)
  163. * Ordered list markers that interrupt a paragraph must start with 1.
  164. * Improved the section on tabs. Added some test cases for ATX
  165. headers and thematic breaks. Clarified that it's not just cases
  166. that affect indentation that matter, but all cases where whitespace
  167. matters for block structure.
  168. * Removed example of ATX header with tab after `#`.
  169. * Allow HTML blocks to end on the last line of their container
  170. (Colin O'Dell, #103).
  171. * Spec changes in strong/emph parsing. See
  172. https://talk.commonmark.org/t/emphasis-strong-emphasis-corner-cases/2123
  173. for motivation. This restores intuitive parsings for a number of cases.
  174. The main change is to disallow strong or emph when one of
  175. the delimiters is "internal" and the sum of the lengths of
  176. the enclosing delimiter runs is a multiple of 3. Thus,
  177. `**foo*bar***` gets parsed `<strong>foo*bar</strong>` rather than
  178. `<em><em>foo</em>bar</em>**` as before. Thanks to Fletcher Penney
  179. for discussion.
  180. * Add tests to check that markdown parsing is working fine after an HTML
  181. block end tag (Alexandre Mutel).
  182. * Add test case for nested lists with an indent > 4 (Alexandre Mutel).
  183. * Cleaned up terminology around lazy continuation lines. Added some links.
  184. * Fixed broken links and typos (Artyom, Matthias Geier, Sam Estep).
  185. * Use `≤` instead of `<` in list item spec for clarity.
  186. * Add point about readibility to "What is Markdown" section.
  187. * Add example for list item starting with a blank line with spaces
  188. (Robin Stocker).
  189. * Make interact more button-like and clearer (Jeff Atwood).
  190. * `spec_tests.py`: exit code is now sum of failures and errors.
  191. * `spec_tests.py`: specify newline when opening file.
  192. [0.25]
  193. * Added several more tab-handling cases (see commonmark/cmark#101).
  194. * Fixed spec test for tabs. In the blockquote with a tab following
  195. the `>`, only one space should be consumed, yielding two spaces
  196. at the beginning of the content.
  197. * Update license year range to 2016 (Prayag Verma).
  198. * Fixed typo: setext heading line -> setext heading underline (#389).
  199. * Fixed date 2015->2016 (#388)
  200. [0.24]
  201. * New format for spec tests, new lua formatter for specs.
  202. The format for the spec examples has changed from
  203. .
  204. markdown
  205. .
  206. html
  207. .
  208. to
  209. ```````````````````````````````` example
  210. markdown
  211. .
  212. html
  213. ````````````````````````````````
  214. One advantage of this is that `spec.txt` becomes a valid
  215. CommonMark file.
  216. * Change `tests/spec_test.py` to use the new format.
  217. * Replace `tools/makespec.py` with a lua script, `tools/make_spec.lua`,
  218. which uses the `lcmark` rock (and indirectly libcmark). It can
  219. generate HTML, LaTeX, and CommonMark versions of the spec. Pandoc
  220. is no longer needed for the latex/PDF version. And, since the new
  221. program uses the cmark API and operates directly on the parse tree,
  222. we get much more reliable translations than we got with the old
  223. Python script (#387).
  224. * Remove whitelist of valid schemes. Now a scheme is any sequence
  225. of 2-32 characters, beginning with an ASCII letter, and containing
  226. only ASCII letters, digits, and the symbols `-`, `+`, `.`.
  227. Discussion at <http://talk.commonmark.org/t/555>.
  228. * Added an example: URI schemes must be more than one character.
  229. * Disallow spaces in link destinations, even inside pointy braces.
  230. Discussion at <http://talk.commonmark.org/t/779> and
  231. <http://talk.commonmark.org/t/1287/12>.
  232. * Modify setext heading spec to allow multiline headings.
  233. Text like
  234. Foo
  235. bar
  236. ---
  237. baz
  238. is now interpreted as heading + paragraph, rather than
  239. paragraph + thematic break + paragraph.
  240. * Call U+FFFD the REPLACEMENT CHARACTER, not the "unknown code
  241. point character."
  242. * Change misleading undefined entity name example.
  243. * Remove misleading claim about entity references in raw HTML
  244. (a regression in 0.23). Entity references are not treated
  245. as literal text in raw HTML; they are just passed through.
  246. * CommonMark.dtd: allow `item` in `custom_block`.
  247. [0.23]
  248. * Don't allow space between link text and link label in a
  249. reference link. This fixes the problem of inadvertent capture:
  250. [foo] [bar]
  251. [foo]: /u1
  252. [bar]: /u2
  253. * Rename "horizontal rule" -> "thematic break". This matches the HTML5
  254. meaning for the hr element, and recognizes that the element may be
  255. rendered in various ways (not always as a horizontal rule).
  256. See http://talk.commonmark.org/t/horizontal-rule-or-thematic-break/912/3
  257. * Rename "header" -> "heading". This avoids a confusion that might arise
  258. now that HTML5 has a "header" element, distinct from the "headings"
  259. h1, h2, ... Our headings correspond to HTML5 headings, not HTML5 headers.
  260. The terminology of 'headings' is more natural, too.
  261. * ATX headers: clarify that a space (or EOL) is needed; other whitespace
  262. won't do (#373). Added a test case.
  263. * Rewrote "Entities" section with more correct terminology (#375).
  264. Entity references and numeric character references.
  265. * Clarified that spec does not dictate URL encoding/normalization policy.
  266. * New test case: list item code block with empty line (Craig M.
  267. Brandenburg).
  268. * Added example with escaped backslash at end of link label (#325).
  269. * Shortened an example so it doesn't wrap (#371).
  270. * Fixed duplicate id "attribute".
  271. * Fix four link targets (Lucas Werkmeister).
  272. * Fix typo for link to "attributes" (Robin Stocker).
  273. * Fix "delimiter" spellings and links (Sam Rawlins).
  274. * Consistent usage of "we" instead of "I" (renzo).
  275. * CommonMark.dtd - Rename `html` -> `html_block`,
  276. `inline_html` -> `html_inline` for consistency. (Otherwise it is too
  277. hard to remember whether `html` is block or inline, a source of
  278. some bugs.)
  279. * CommonMark.dtd - added `xmlns` attribute to document.
  280. * CommonMark.dtd - added `custom_block`, `custom_inline`.
  281. * CommonMark.dtd - renamed `hrule` to `thematic_break`.
  282. * Fixed some HTML inline tests, which were actually HTML blocks, given
  283. the changes to block parsing rules since these examples were written
  284. (#382).
  285. * Normalize URLs when comparing test output. This way we don't fail
  286. tests for legitimate variations in URL escaping/normalization policies
  287. (#334).
  288. * `normalize.py`: don't use `HTMLParseError`, which has been removed
  289. as of python 3.5 (#380).
  290. * Minor spacing adjustments in test output, to match cmark's output,
  291. since we test cmark without normalization.
  292. * `makespec.py`: remove need for link anchors to be on one line.
  293. * `makespec.py`: Only do two levels in the TOC.
  294. * Use `display:inline-block` rather than floats for side-by-side.
  295. This works when printed too.
  296. * Added better print CSS.
  297. [0.22]
  298. * Don't list `title` twice as HTML block tag (Robin Stocker).
  299. * More direct example of type 7 HTML block starting with closing tag.
  300. * Clarified rule 7 for HTML blocks. `pre`, `script`, and `style`
  301. are excluded because they're covered by other rules.
  302. * Clarified that type 7 HTML blocks can start with a closing tag (#349).
  303. * Removed `pre` tag from rule 6 of HTML blocks (#355).
  304. It is already covered by rule 1, so this removes an ambiguity.
  305. * Added `iframe` to list of tags that always start HTML blocks (#352).
  306. * Added example of list item starting with two blanks (#332).
  307. * Added test case clarifying laziness in block quotes (see
  308. commonmark/commonmark.js#60).
  309. * Add an example with mixed indentation code block in "Tabs" section
  310. (Robin Stocker). This makes sure that implementations skip columns instead
  311. of offsets for continued indented code blocks.
  312. * Clarified that in ATX headers, the closing `#`s must be unescaped,
  313. and removed misleading reference to "non-whitespace character" in
  314. an example (#356).
  315. * Changed anchor for "non-whitespace character" to reflect new name.
  316. * Removed ambiguities concerning lines and line endings (#357, Lasse
  317. R.H. Nielsen). The previous spec allowed, technically, that a line
  318. ending in `\r\n` might be considered to have two line endings,
  319. or that the `\r` might be considered part of the line and the
  320. `\n` the line ending. These fixes rule out those interpretations.
  321. * Clarify that a character is any code point.
  322. * Space in "code point".
  323. * Capitalize "Unicode".
  324. * Reflow paragraph to avoid unwanted list item (#360, #361).
  325. * Avoid extra space before section number in `spec.md`.
  326. * `makespec.py`: Use `check_output` for simpler `pipe_through_prog`.
  327. * In README, clarified build requirements for `spec.html`, `spec.pdf`.
  328. * Fixed some encoding issues in `makespec.py` (#353).
  329. * Fixed various problems with `spec.pdf` generation (#353).
  330. * Added version to coverpage in PDF version of spec.
  331. [0.21.1]
  332. * Added date.
  333. [0.21]
  334. * Changed handling of tabs. Instead of having a preprocessing step
  335. where tabs are converted to spaces, we now handle tabs directly in
  336. the parser. This allows tabs to be retained in code blocks and code
  337. spans. This change adds some general language to the effect that,
  338. for purposes of determining block structure, tabs are to be treated
  339. just like equivalent spaces.
  340. * Completely rewrote spec for HTML blocks. The new spec provides
  341. better handling of tags like `<del>`, which can be either block
  342. or inline level content, better handling of custom tags, and
  343. better handling of verbatim contexts like `<pre>`, comments,
  344. and `<script>`.
  345. * Added 9-digit limit on ordered list start number.
  346. Some browsers use signed 32-bit integers for indexing
  347. the items of an ordered list, and this can lead to odd
  348. or undefined behavior if 10-digit start numbers are allowed.
  349. * Allow (non-initial) hyphens in tag names (#239). Custom
  350. tags in HTML5 must contain hyphens.
  351. * Clarified that HTML block is closed at end of containing
  352. block, not just end of the document (as with fenced code blocks.)
  353. * Specify nested link definition behavior in prose (Benjamin
  354. Dumke-von der Ehe).
  355. * Added test for edge case in link reference parsing
  356. (Benjamin Dumke-von der Ehe, see commonmark/commonmark.js#49).
  357. * Added link tests with fragment identifiers and queries (David
  358. Green, #342).
  359. * Added test cases with a literal backslash in a link destination
  360. (see commonmark/commonmark.js#45).
  361. * Added test for entity `&ngE;` which resolves to two code points.
  362. Put entity tests on several lines for readability (see
  363. commonmark/commonmark.js#47).
  364. * Fixed broken "pre" literal HTML example. Contents
  365. weren't escaped properly.
  366. * Simplified defn of "unicode whitespace character,"
  367. rectifying omission of line tabulation, U+000B (#343).
  368. * Removed ambiguity in definition of "line" (#346).
  369. * Rewrapped two prose lines so `+` does not begin a line (#347).
  370. * Added another test with overlapping emphasis markers.
  371. * Fixed link to 'attributes'.
  372. * Revised appendix, "A parsing strategy," and
  373. added a description of emphasis/link parsing algorithm.
  374. * `spec_tests.py` - set options for conversions, set library
  375. paths in a more cross-platform way.
  376. * `spec_tests.py`: force utf-8 on test failure output and
  377. `--dump-tests` (#344, #345).
  378. * `spec_tests.py`: Properly handle visible tab `→` in expected output.
  379. * `normalize.py`: Don't collapse whitespace inside pre tag.
  380. * Added `spec.html` to `.gitignore` (#339).
  381. * Add `-dev` suffix to spec version after release (eksperimental).
  382. * Rename "non-space" to "non-whitespace" (Konstantin Zudov, #337).
  383. [0.20]
  384. * Require at least one nonspace character in a link label (#322).
  385. * Require replacement (rather than omission) of U+0000 (#327).
  386. * Clarified that entities resolving to U+0000 are to be
  387. replaced by U+FFFD (#323).
  388. * Removed statement that what counts as a line ending is
  389. platform-dependent (#326). We now count `\r`, `\n`,
  390. or `\r\n` as a line ending regardless of the platform.
  391. (The line ending styles can even be mixed in a single document.)
  392. * Defined "space."
  393. * Revised "non-space character". Previously a non-space character
  394. was defined as anything but a space (U+0020). Now it is anything
  395. that is not a whitespace character (as defined in the spec).
  396. * Clarified that tab expansion is a preprocessing step (#330).
  397. * Clarified lazy block quote examples (#328).
  398. * Clarified precedence of indentation that meets conditions for
  399. both list item continuation blocks and indented code.
  400. * Added a test case with `#` directly followed by a letter
  401. (not an ATX header).
  402. * Added two test cases illustrating that a list at the
  403. outer level can have items that are indented by more
  404. than four spaces (see commonmark.js#42 and
  405. <http://talk.commonmark.org/t/odd-list-behaviour/1189>).
  406. * Fixed typo in emphasis examples.
  407. [0.19]
  408. * Fixed rules for `_`-based emphasis and strong emphasis (#317).
  409. Previously `_(bar)_.` was not parsed as containing emphasis
  410. because the closing delimiter is both left- and right- flanking.
  411. This fix allows such delimiters, provided they're followed
  412. by punctuation (i.e., they have punctuation on both sides).
  413. Similarly, mutatis mutandis, for opening delimiters and for `__`.
  414. * Clarified definitions of left-flanking and right-flanking (#310).
  415. The spec now says explicitly that the beginning and end of line count
  416. as whitespace for purposes of this definition.
  417. * Clarified that a code fence followed by header line isn't a header (#306).
  418. * Fixed alignment in flankingness examples (cosmetic).
  419. * Fixed last "right flanking but not left flanking" example (#316).
  420. * Fixed a broken link (Konstantin Zudov).
  421. * Added link to list of implementations on wiki.
  422. * Fixed mistake in examples of left/right flanking delimiters
  423. (Konstantin Zudov).
  424. * Spell out `iff` (if and only if) the first time it is used (#309).
  425. * Fixed typos (isoroku, #309).
  426. * Clarified wording for soft line break: newline can't be preceded
  427. by two spaces or a backslash.
  428. * Replaced some references to UTF-8 that should be to unicode.
  429. * Fixed dingus link in tools/template.html.
  430. * Replaced obsolete reference to `spec2md.pl` in spec (#304).
  431. [0.18]
  432. * Added a shortcut link test with mismatched brackets (#282).
  433. * Added cases with newline whitespace around emphasis open delimiter
  434. (#282).
  435. * Added list item examples with no space after marker (#282).
  436. * Added additional test showing backslash escapes don't work in
  437. autolinks (#282).
  438. * Added test for multiline title in reference definition (#282).
  439. * Added a reference link definition test case (#282).
  440. * Clarified that link titles can't contain blank lines (#271).
  441. * Revised Rule 3 for list items (#275). Previously this just applied to
  442. empty list items. It has been rewritten to apply to any list item
  443. starting with a blank line, including items like:
  444. -
  445. ```
  446. code
  447. ```
  448. * Added U+000B and U+000C as whitespace characters (#300).
  449. * Added comment on sourcepos attribute format in DTD (#298).
  450. * Use `--smart` option in producing HTML version of spec.
  451. * Clarified that delimiter runs at beginning/end of line behave as
  452. if preceded/followed by whitespace (#302).
  453. * Ensure that URLs in examples have slash after domain.
  454. This helps with #9, making these tests less sensitive to
  455. the normalizer used.
  456. * Fixed typo (Robin Stocker).
  457. [0.17]
  458. * Improved rule limiting intraword `_` for emphasis and strong emphasis.
  459. To prevent intra-word emphasis, we used to check to see if
  460. the delimiter was followed/preceded by an ASCII alphanumeric.
  461. We now do something more elegant: whereas an opening `*` must
  462. be left-flanking, an opening `_` must be left-flanking *and
  463. not right-flanking*. And so on for the other cases.
  464. All the original tests passed except some tests with Russian
  465. text with internal `_`, which formerly created emphasis but no
  466. longer do with the new rule. These tests have been adjusted.
  467. A few new test cases have been added to illustrate the rule.
  468. * Added example with link break inside pointy braces (no link) (#295).
  469. * Added spec example: loose list with blank line after fenced code (#285).
  470. [0.16]
  471. * Rewrote beginning of Entities section, clarifying that only
  472. entities not in code blocks or spans are decoded.
  473. * Removed defective Example 449 (#284).
  474. * Fixed typo (#283).
  475. * Added intended two-space hard-breaks in Examples 521, 523.
  476. * Clarified that brackets in general don't take precedence over emph
  477. (#258).
  478. * Clarified that final newline is removed from paragraph content
  479. (#176).
  480. * Talk of "info string" rather than "attributes" for code blocks
  481. (#262).
  482. * Clarified precedence of code spans, HTML tags, autolinks (#259).
  483. * Fixed a number of internal links and duplicate references in the spec.
  484. * Linkify "info string" in spec.
  485. * Use shortcut reference links when possible in spec.txt.
  486. * cmark itself is now used to build spec.html, rather than pandoc.
  487. * Use shortcut reference links when possible in spec.txt. This
  488. relies on the new `spec2md.py` behavior of creating references
  489. for all internal anchors.
  490. * Moved some examples from block to inline HTML section.
  491. * Added examples of non-comments (#264).
  492. * Changed rule for comments to conform to HTML5 spec.
  493. * Made clear that any sequence of characters is a valid document
  494. (#266).
  495. * Changed wording: "is preferred" -> "takes precedence."
  496. * Regularized spelling of "non-space character" and added links
  497. (#260).
  498. * Use four spaces rather than five to show "four spaces is too much"
  499. (#261).
  500. [0.15]
  501. * Fixed some typos with "left-" and "right-flanking" delimiters in the
  502. section on emphasis and strong emphasis (#257).
  503. [0.14]
  504. * Clarified indented code blocks. Previously the spec said, wrongly,
  505. that a blank line was needed between a paragraph and a following
  506. code block. It is only needed between a code block and a following
  507. paragraph (due to lazy continuations). (Thanks to textnut.)
  508. * Added definitions of whitespace, unicode whitespace, punctuation,
  509. ASCII punctuation (#108).
  510. * Improved rules for emphasis and strong emphasis. This improves
  511. parsing of emphasis around punctuation. For background see
  512. <http://talk.commonmark.org/t/903/6>. The basic idea of the change
  513. is that if the delimiter is part of a delimiter clump that has
  514. punctuation to the left and a normal character (non-space,
  515. non-punctuation) to the right, it can only be an opener. If it has
  516. punctuation to the right and a normal character (non-space,
  517. non-punctuation) to the left, it can only be a closer. This handles
  518. cases like
  519. **Gomphocarpus (*Gomphocarpus physocarpus*, syn. *Asclepias
  520. physocarpa*)**
  521. and
  522. **foo "*bar*" foo**
  523. better than before.
  524. * Added test case for link-in-link-in-image (#252).
  525. * Fixed broken internal references.
  526. * Added another example of an unclarity in the canonical Markdown
  527. syntax description.
  528. * Reworded the principle of uniformity to be more general; it applies
  529. to all container blocks, not just list items.
  530. * Added a rule for empty list items (#242).
  531. * Clarified precedence of empty list items over setext header lines
  532. (#95).
  533. * Added an example with two blank lines in fenced code in a sublist (#180).
  534. * Added an explicit CC-BY-SA license to the spec (#55).
  535. [0.13]
  536. * Updated path of test program.
  537. * Use terminology "plain textual content" instead of "string."
  538. * Added condition that conforming parsers strip or replace NULL characters.
  539. * Changed Example 196 to reflect the spec's rules. It should not be a loose
  540. list as it has no blank lines.
  541. * Adjusted semantically insignificant formatting of HTML output.
  542. * Added example to spec of shortcut link with following space (#214).