caml-list - the Caml user's mailing list
 help / color / mirror / Atom feed
* [Caml-list] Feedback on cmdliner doc language changes
@ 2017-01-31 12:22 Daniel Bünzli
  0 siblings, 0 replies; only message in thread
From: Daniel Bünzli @ 2017-01-31 12:22 UTC (permalink / raw)
  To: OCaml List

Hello,

The current cmdliner manual doc language is broken beyond hope. The next release is going to fix that which may break the rendering of some manpages [1]. Your feedback on the changes and new language definition is welcome:

https://github.com/dbuenzli/cmdliner/blob/08be600c4b7f00c08339f078a88b30234d84fc44/CHANGES.md#doc-language-sanitization
https://github.com/dbuenzli/cmdliner/blob/master/src/cmdliner.mli#L755-L768

Discussion can happen here:

https://github.com/dbuenzli/cmdliner/issues/68

Best, 

Daniel

[1] I suspect most will not. But if: 

 git grep '\$([ib],[^)]*\$([mt]name)[^)]*)' 

exits with 0 in your project you are affected for sure. Simply replace these marked up $(b,$(tname)) and $(b,$(mname)) by the variables $(tname) and $(mname) themselves.




^ permalink raw reply	[flat|nested] only message in thread

only message in thread, other threads:[~2017-01-31 12:22 UTC | newest]

Thread overview: (only message) (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2017-01-31 12:22 [Caml-list] Feedback on cmdliner doc language changes Daniel Bünzli

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).