Bug 20067

Summary: src/sbin/nologin/nologin.5 is bad place
Product: Documentation Reporter: hagi <hagi>
Component: Books & ArticlesAssignee: freebsd-doc (Nobody) <doc>
Status: Closed FIXED    
Severity: Affects Only Me    
Priority: Normal    
Version: Latest   
Hardware: Any   
OS: Any   

Description hagi 2000-07-20 18:40:01 UTC
src/sbin/nologin/nologin.5 is misplaced.
nologin(5) has no relation to /sbin/nologin.

At the first time I read nologin(5) after nologin(8), I misunderstood that
/var/run/nologin can change the message of /sbin/nologin.

Fix: 

Please suppress cross references of nologin(5) and nologin(8).

Suggestions:
  move src/sbin/nologin/nologin.5 to src/lib/libutil/ or src/usr.bin/login/
  add reference to nologin(5) in src/lib/libutil/login.conf.5

  Change nologin(5) DESCRIPTION like,
     The nologin file disallows logins. If the file /var/run/nologin exists,
     login programs display the contents of /var/run/nologin to the user 
     and exit.
Comment 1 Sheldon Hearn 2000-07-20 19:25:30 UTC
On Thu, 20 Jul 2000 10:38:51 MST, hagi@nandemo.gr.jp wrote:

> >Fix:
> Please suppress cross references of nologin(5) and nologin(8).

Personally, I think that the nologin(5) manual page should go away.
Instead, the manual pages for those programs which honour its presence
should be latered to reflect this (probably by a siple addition to their
FILES sections).

Ciao,
Sheldon.
Comment 2 nik freebsd_committer freebsd_triage 2000-11-12 16:30:01 UTC
State Changed
From-To: open->closed

Updated the descriptive text in the man page, which should help avoid  
confusion.