Lin: >> These man page do not describe any configuration options or files >> used to manage how gamin operates. Is this because there is no way >> to configure it? > I didn't provide the man page for configuration files because those > interfaces hadn't been ARCed. So I referred to the home page of Gamin in > the man page as compensation. I think people can find sufficient > information there.
Considering that Gamin is clearly defined to be "Volatile", the interfaces are not guaranteed to be Stable. I think it would be better to discuss configuration interfaces in the manpage even if we neglected to mention them at ARC time. >> gam_server is installed to /usr/lib, not /usr/bin. Therefore, it should >> be a section 3 manpage, not a section 1 manpage. > I don't think so, according to intro(3), this section only documents > functions and libraries. Though gam_server is in /usr/lib, it's a > command. Probably section 1M is the better here. e.g. pcmciad(1M), > lpsched(1M). Okay, based on Alan's comments, I think section 1 is correct. Sorry. >> Are there any online API docs you could point to in the libgamin-1.3 >> manpage? > Yes, for the exported symbols of libgamin there are links in the home > page point to FAM project/document of SGI. It would be good to mention in the manpage that user's are expected to go to the Gamin home page for API documentation. The URL to the home page, by itself, isn't so clear. -- Brian
