Suppose I have a man page, which I just wrote and passed through nroff -man, called command.1
How do I view it with man now? I lo
There are different versions of man floating around: the one based on the man-db project (used in many Linux distros) and the one that comes with macOS, at least as far as I know. I was unable to find a project page for the latter, but it seems to be maintained by Federico Lucifredi.
The main point is this: Lucifredi's man supports opening a file directly when providing the path to it with a slash:
man ./command.1
This is mentioned in the macOS man page for man:
However, if
namecontains a slash (/) thenmaninterprets it as a file specification, so that you can doman ./foo.5or evenman /cd/foo/bar.1.gz.
and it's also hinted at in a blog post by Lucifredi:
One more tip for you:
man ./foo.1is your friend, to see what you just wrote and marked up in all its glory — and bugs.
Put the command.1 man page in a new folder called man1. Then, assuming you're in the folder containing the new man1 folder, call the man command like this:
man -M . command
Replace the dot by the path to the folder containing the man1 folder if you're located elsewhere.