Yes, the man pages have issues. Not necessarily with the content, but it's an archaic system on many levels. Still, man pages are short, consistent, familiar, and "easy" to write. In theory they are portable and usable even on systems with just a text console.
1. I probably should have made all the man pages for slaves as ".5" instead of ".3" 2. There is a lot of duplicated content (which is desirable, so the interface and function of the salves and programs have many common elements). Rather than try to modify all the pages each time, I use the source inclusion ".so" function. 3. This breaks the debian installation, so a special script is run on installation using sed to substitute the content into the original before packaging. 4. The sed script used gnu extensions, so an ed script was needed instead for Mac and BSD. 5. The website man pages are made by man2html which has some translation problems. 6. The content management system sometimes screws up the embedded links for the man pages so they are occasionally misfiled. After "make install", the man pages are supposed to be installed in /opt/owfs/man/... Personally I use midnight commander (mc) to view the man pages in the source tree. It seems to mange the links just fine. Paul Alfille On Fri, Dec 10, 2010 at 4:17 AM, Chris G <c...@isbd.net> wrote: > On Fri, Dec 10, 2010 at 09:03:45AM +0000, Chris G wrote: >> I have just installed and built owfs on my little ubuntu 10.04 system. >> >> I couldn't find any man pages for the owfs commands etc., a little >> searching revealed the following problems:- >> >> For mandb to rebuild the man page indexes and so that the owfs man >> pages can be found entries need to be added to /etc/manpath.config. >> This meybe different on other systems of course. >> >> I added the requisite lines to /etc/manpath.config. and ran mandb >> and saw lots of errors/warnings about some of the files. On looking >> I see that many of the man page entries in /opt/owfs/share/man/xx >> have file names ending in .1so rather than the normal .1. The mandb >> command complains about these. >> >> Are the man pages ending in .1so different/special in some way, i.e. is >> the naming intentional, or is this an error? >> > I now realise that the .so stuff is a roff special, the pages are > supposed to be links to other pages. However the links aren't working, > that's what mandb is complaining about. > > -- > Chris Green > > ------------------------------------------------------------------------------ > _______________________________________________ > Owfs-developers mailing list > Owfs-developers@lists.sourceforge.net > https://lists.sourceforge.net/lists/listinfo/owfs-developers > ------------------------------------------------------------------------------ _______________________________________________ Owfs-developers mailing list Owfs-developers@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/owfs-developers
