I'm having a frustrating time trying to configure some man pages provided by owfs (1-wire file system). I have configured and built the software OK and it works but it would be really nice if I could read the man pages that come with it.

The man pages are in a slightly 'out of the way' place:-

/opt/owfs/share/man

but that's OK if one adds the above directory to the file /etc/manpath.config, so I have done that and a couple of man pages are now visible. However when I run mandb to rebuild the man pages index I get loads of errors like the following:-

mandb: warning: /opt/owfs/share/man/man1/device.1so: whatis parse for device(1so) failed mandb: can't open /opt/owfs/share/man/ownet.1: No such file or directory mandb: warning: /opt/owfs/share/man/man1/ownetlib.1: bad symlink or ROFF `.so' request mandb: warning: /opt/owfs/share/man/man1/configuration.1so: whatis parse for configuration(1so) failed mandb: warning: /opt/owfs/share/man/man1/format.1so: whatis parse for format(1so) failed mandb: warning: /opt/owfs/share/man/man1/timeout.1so: whatis parse for timeout(1so) failed mandb: can't open /opt/owfs/share/man/owshell.1: No such file or directory mandb: warning: /opt/owfs/share/man/man1/owdir.1: bad symlink or ROFF `.so' request

It turns out that the .1so files are some sort of nroff/troff internal sort of symbolic link though I can find out little more. Does anyone know how these are supposed to work? Google is useless becauser it generates thousands of hits for ISO which mask anyhting useful.

All I want to do is read the man pages!