From d318611dd6f23fcfedd50e9b9e24620b102ba96a Mon Sep 17 00:00:00 2001 From: Daniel Baumann Date: Mon, 15 Apr 2024 21:44:05 +0200 Subject: Adding upstream version 1.23.0. Signed-off-by: Daniel Baumann --- tmac/TESTING-HINTS | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) create mode 100644 tmac/TESTING-HINTS (limited to 'tmac/TESTING-HINTS') diff --git a/tmac/TESTING-HINTS b/tmac/TESTING-HINTS new file mode 100644 index 0000000..6e21564 --- /dev/null +++ b/tmac/TESTING-HINTS @@ -0,0 +1,19 @@ +Here are some hints about testing modifications to macro packages and +manual pages. + +1. Use groff's '-ww' option to catch potential problems. + Ideally, there shouldn't be any warnings. + +2. For a well-formedness check, run doclifter (http://catb.org/~esr/doclifter) + against your page. This tool was written to lift pages to XML, but as a + side effect it acts as a validator that will warn you of potential problems + and non-portable constructs. + +3. The two most important groff client types are X terminal emulators + and Postscript printers. Eyeball-check your output under both. + +4. The colorized man output of the Midnight Commander (what you get by + pressing the F3 key on a man page) is good for making small errors + more visible. + +5. Try different terminal line lengths, say, 80 and 100 characters. -- cgit v1.2.3