|Anonymous | Login | Signup for a new account||2018-12-15 09:36 CET|
|Main | My View | View Issues | Change Log | Roadmap|
|View Issue Details|
|ID||Project||Category||View Status||Date Submitted||Last Update|
|0007875||OCaml||documentation||public||2018-11-24 07:12||2018-11-24 19:18|
|Target Version||Fixed in Version|
|Summary||0007875: move Changes file to a parsable text format|
|Description||The Changes file is currently over 8000 lines, with the first 700 lines devoted to working changes. Because this file is currently in just a text format, there is scrolling and/or text search required to see changes of even recently released versions.|
By moving to a parsable format such as AsciiDoc or Markdown, editors which already have support for parsing such a format can outline and collapse the structure of this file.
Additionally, such a change can give the ocaml source code root directory a slightly more modern feel than a plain text file.
|Additional Information||The file is already parsable as a Markdown file, with the exception that there is a semantic distinction between a bulleted item beginning with "-" and a bulleted item beginning with "*" (Markdown treats these as equivalent).|
|Tags||No tags attached.|
Would adding the `.md` extension suffice as a first step?
Do you have a suggestion how to semantically differentiate '-' and '*'?
|What about using strong emphasis (**) to highlight the list items currently marked with '*' ?|
Yes, `.md` extension and adding strong emphasis (**) would be great.
Some of the asterisks within the text would need to be escaped or put into inline code.
|2018-11-24 07:12||0xc0||New Issue|
|2018-11-24 07:52||nojebar||Note Added: 0019480|
|2018-11-24 08:09||nojebar||Note Added: 0019481|
|2018-11-24 19:18||0xc0||Note Added: 0019482|
|Copyright © 2000 - 2011 MantisBT Group|