groff man-page incompatibility

[Doug McIlroy]

This is the heading I get from "man groff" when
running groff 1.20.1 under cygwin. (Overstrikes and
color effects have been elided for readability.)

NAME
       groff - front-end for the groff document formatting system

SYNOPSIS
       [file ...]  -h | --help -v | --version [option ...]

It appears that the trouble is that the various groff man pages
use .SY and .OP to build the synopsis, but the macro package
doc.tmac doesn't define them.  .SY and .OP are defined in
an-ext.tmac, which is not called from any other .tmac file.

Other groff* man pages suffer similarly. Non-groff man pages
use .Sh and .Op.

The symptom was seen using man-1.6e or man-1.6f; I don't know
about earlier versions.


Doug McIlroy