[cli-users] [bug-report] cli generates incorrect man file (build2-toolchain-0.8.0.tar.xz contains wrong man files)

[Boris Kolpackov]

san <san at masterspline.eu> writes:

>    My opinion is this warnings is due to '\fB*\fR' combination in this
>    man files. And single quotes (') there must be escaped with slashes
>    (\'\fB*\fR\').

Actually, it is more complicated than that: "'" (along with a bunch of
other characters mentioned on the man page you've linked) has to be
escaped if it appears at the beginning of the line and with "\&" instead
of just "\". I've committed the fix and the regenerated pages seem to
render correctly:

https://scm.codesynthesis.com/cgit/cli/cli/commit/?id=49e1a3e6c7b756763e6a7d2f1ea33d23a5c9da04

Thanks for the detailed bug report and analysis!