tech-userlevel archive

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index][Old Index]

Upgrade to NetBSD 7: no _mandb entry found in man.conf



I just upgraded using the upgrade UI from NetBSD 5.0.1 to NetBSD 7.0

Everything went very well, except that when I try to run apropos, or
makemandb, I get:

$ man -k makemandb
apropos: _mandb entry not found in man.conf
$ makemandb
makemandb: _mandb entry not found in man.conf

I looked at man.conf; there is no entry.

I looked at the manpages for apropos, makemandb, and man, and saw only text
of the form:

(man apropros)
FILES
     /etc/man.conf  The location of the Sqlite FTS database can be
configured
                    using the _mandb tag.

(man makemandb)
FILES
     /etc/man.conf  The location of the Sqlite FTS database can be
configured
                    using the _mandb tag.

(man man.conf | grep _mandb) gives no output.

So my questions are:

1) Shouldn't a default location be provided as part of an upgrade?
2) Shouldn't a recommended location be documented in the manpages?
3) Shouldn't _mandb be documented in man.conf(5)?
4) Shouldn't there be a suitable example?
5) shouldn't the text in the man pages be:
	"The location of the Sqlite FTS database MUST be configured"
   rather than "can be configured"? It appears that if it's not configured, 
   the commands are non-functional and won't assume defaults.

The commit log 
(https://www.mail-archive.com/source-changes-full%netbsd.org@localhost/msg41786.html) 
says (inter alia) "Set _mandb in man.conf to same value as was used before."

This gave me the clue as to the default line which should be:
	_mandb /var/db/man.db 
(instead of the _whatdb lines)

I think the answers are:
1) yes
2) yes (should be documented as /var/db/man.db)
3) yes
4) There is, but it's not visible if you upgrade
5) I think so, to minimize frustration.

Best regards,
--Terry






Home | Main Index | Thread Index | Old Index