Skip to content

Conversation

@Alasdair
Copy link
Collaborator

We've been stuck on Omd 1 for a long time. While we could upgrade to the newer Omd version, it does not seem very actively maintained, and since we'd have to rewrite all our code using it anyway it seems like a good opportunity to switch to the newer Cmarkit library which has some nice additional features and sticks closely to the CommonMark spec.

A best effort attempt has been made to preserve sail --doc and sail --latex features, but there may be small changes in functionality and appearance.

This does require increasing our minimum OCaml version to 4.14+, but that might be overdue at this point (and we might also just want to require OCaml 5 soon anyway).

We've been stuck on Omd 1 for a long time. While we could upgrade
to the newer Omd version, it does not seem very actively maintained,
and since we'd have to rewrite anyway it seems like a good opportunity to
switch to the newer Cmarkit library which has some nice additional
features.

A best effort attempt has been made to preserve `sail --doc` and
`sail --latex` features, but there may be small changes in functionality.

This does require increasing our minimum OCaml version to 4.14+
@github-actions
Copy link

github-actions bot commented Jan 30, 2025

Test Results

   12 files  ±0     24 suites  ±0   0s ⏱️ ±0s
  759 tests ±0    759 ✅ ±0  0 💤 ±0  0 ❌ ±0 
2 503 runs  ±0  2 503 ✅ ±0  0 💤 ±0  0 ❌ ±0 

Results for commit c11cf0d. ± Comparison against base commit 5152e25.

♻️ This comment has been updated with latest results.

@arichardson
Copy link
Contributor

I rebuilt the cheri-specification with this change: https://gist.github.com/arichardson/a10e2188ba0b88739e546eab3b2be2ef

This mostly looks like just whitespace changes, but the \subsection*{} part is a bit odd?

@arichardson
Copy link
Contributor

\saildocabbrev{i.e.} is also now i.e. but I'm not sure we really need that macro.

arichardson added a commit to CTSRD-CHERI/cheribuild that referenced this pull request Mar 11, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants