From san at masterspline.eu Sun Nov 18 13:09:17 2018 From: san at masterspline.eu (san) Date: Tue Nov 20 08:31:27 2018 Subject: [cli-users] [bug-report] cli generates incorrect man file (build2-toolchain-0.8.0.tar.xz contains wrong man files) Message-ID: Skipped content of type multipart/mixed-------------- next part -------------- A non-text attachment was scrubbed... Name: signature.asc Type: application/pgp-signature Size: 228 bytes Desc: OpenPGP digital signature Url : https://codesynthesis.com/pipermail/cli-users/attachments/20181118/2a5ce32f/signature.pgp From boris at codesynthesis.com Tue Nov 20 09:06:19 2018 From: boris at codesynthesis.com (Boris Kolpackov) Date: Tue Nov 20 09:17:03 2018 Subject: [cli-users] [bug-report] cli generates incorrect man file (build2-toolchain-0.8.0.tar.xz contains wrong man files) In-Reply-To: References: Message-ID: san 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!