Bug 167742

Summary: Update documentation for group 5, and newgrp 1
Product: Documentation Reporter: Mark Saad <msaad>
Component: Manual PagesAssignee: freebsd-bugs (Nobody) <bugs>
Status: Open ---    
Severity: Affects Only Me CC: doc, felix.the.red, ygy
Priority: Normal Keywords: easy, patch
Version: Latest   
Hardware: Any   
OS: Any   
Attachments:
Description Flags
newgrp(1) patch none

Description Mark Saad 2012-05-09 17:20:11 UTC 
	The man pages for both group 5 and newgrp 1 do not include examples of how to use group passwords.

Fix: 

eadler@freebsd.org stated that a short example similar to this would do in the newgrp man page

Create the group
% pw group add foo

Set the group password
% pw group mod foo -h 0

As a non root user switch to the group
% newgrp foo

Also in the group 5 man the See Also section should include a refrence to newgrp 1
How-To-Repeat: 	See man 1 newgrp and man 5 group
Comment 1 Joel Dahl freebsd_committer freebsd_triage 2013-04-20 23:44:29 UTC 
Responsible Changed
From-To: freebsd-doc->joel

Take.
Comment 2 Eitan Adler freebsd_committer freebsd_triage 2017-12-31 07:58:23 UTC 
For bugs matching the following criteria:

Status: In Progress Changed: (is less than) 2014-06-01

Reset to default assignee and clear in-progress tags.

Mail being skipped
Comment 3 Felix Johnson freebsd_triage 2021-09-20 03:10:50 UTC 
Created attachment 228037 [details]
newgrp(1) patch

Add an example of creating a group, setting a group password, and switching to the new group.
Comment 4 Felix Johnson freebsd_triage 2021-09-20 03:11:58 UTC 
group(5) has a cross-reference to newgrp(1) in the SEE ALSO section.