Mention that escaping "^" as "\(ha" in source code samples improves
authorschwarze <schwarze@openbsd.org>
Sun, 30 Apr 2017 15:05:27 +0000 (15:05 +0000)
committerschwarze <schwarze@openbsd.org>
Sun, 30 Apr 2017 15:05:27 +0000 (15:05 +0000)
commit56fe46ebadb584af9f8937959a922b015243e178
treea9412e0209eea451e5e74d33526b5114caa20f37
parent8cd36b171d9a2f1ab9c6f3bd834886d086ed397e
Mention that escaping "^" as "\(ha" in source code samples improves
portability, in particular when rendering to formats such as PDF
with real typesetters such as groff.

While here, make it even more explicit that the rendering of raw
ASCII accents ( ` ' ~ ^ ) found in the input is kind of a mess and
varies among implementations, software versions, macro sets, and
output devices.

Issue noticed when reading the groff_char(7) manual, and confirmed
by testing with current groff.

OK bentley@, "certainly no objection" jmc@

N.B.: Nobody will get scolded for ignoring this subtlety.
share/man/man7/mandoc_char.7