Hi Justina, justina colmena wrote on Sat, May 19, 2018 at 06:01:11PM +0000:
> I was looking for more man pages, so I copied the ones > in /usr/X11R6/man and /usr/local/man over to /var/www/man and listed > them in manpath.conf as instructed. So now they are available here. > > https://amarillo.colmena.biz/cgi-bin/man.cgi > > Several issues here: What you report is all intentional and working as designed. > 1.) The search is not falling through to the second and third manpaths. No. That is intentional. For man.cgi(8), different manpaths are intended to represent completely independent manual page trees, for example for different operating systems or different operating system versions. So if you want to search across a given set of manual pages, put them all into the same manpath. For man(1), from the perspective of search tools, having all the pages in a single path would also be simpler, but it would mix base system, Xenocara, and ports content, so we don't do it. That difference also makes sense from the following perspective: Using man(1) locally on a given machine, you typically want to look at manual pages of the installed version of the installed operating system only, so having only one operating system set up is a sane default. Of course, if you want to install pages for a different system, you can still do so in a user-defined tree. For example, the man-pages-posix port does something like that. On a web server, you often want to serve pages for more than one system, so having easy multi-system support is sane. Of course, you can still put everything into a single manpath if that's what you want. That will even automatically hide the selection dropdown. > 2.) The manpath appears in the URL for the second and third manpaths, > but not the first. That's intentional. We shorten the URI as much as possible because that's very convenient for users. As a matter of fact, i type out URIs by hand more often that using the search form. My main use case for the search form is complicated apropos(1) queries. Besides, the first manpath is intended as the default operating system served by the server, the other for alternative systems requested less frequently. I guess every server has a default system. > 3.) The links are not generated in the "see also" section for pages on > the second and third manpaths. No. It is intentional that you cannot link from one operating system to a different one. That would be seriously confusing. Yours, Ingo
