241412 2019-10-22 11:19:53 +0000 Discrepancy between login.conf(5) and handbook w.r.t. cases when cap_mkdb(1) usage is necessary. 2019-10-22 11:19:53 +0000 1 1 1 Unclassified Documentation Documentation Latest Any Any New --- Affects Many People --- 1 alexandrian.librarian1 doc oldest_to_newest 1072028 0 alexandrian.librarian1 2019-10-22 11:19:53 +0000 In the handbook's (https://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/using-localization.html#locale-lang-country) section Login Classes Method, we have: Whenever /etc/login.conf is edited, remember to execute the following command to update the capability database: # cap_mkdb /etc/login.conf But in login.conf(5) for FreeBSD 12X we have: The default /etc/login.conf shipped with FreeBSD is an out of the box configuration. Whenever changes to this, or the user's ~/.login_conf, file are made, the modifications will not be picked up until cap_mkdb(1) is used to compile the file into a database. The wording in the handbook can be easily interpreted to imply that cap_mkdb(1) need only be used when /etc/.login_conf is modified. But this is not the case - as can be seen from login.conf(5). I request that the handbook includes that cap_mkdb(1) needs to be used even when ~/.login_conf is modified.