Bug 167742 - Update documentation for group 5, and newgrp 1
Summary: Update documentation for group 5, and newgrp 1
Status: Open
Alias: None
Product: Documentation
Classification: Unclassified
Component: Manual Pages (show other bugs)
Version: Latest
Hardware: Any Any
: Normal Affects Only Me
Assignee: Guangyuan Yang
Keywords: easy, patch
Depends on:
Reported: 2012-05-09 17:20 UTC by Mark Saad
Modified: 2021-10-01 07:16 UTC (History)
3 users (show)

See Also:

newgrp(1) patch (670 bytes, patch)
2021-09-20 03:10 UTC, Felix Johnson
no flags Details | Diff

Note You need to log in before you can comment on or make changes to this bug.
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.


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 2013-04-20 23:44:29 UTC
Responsible Changed
From-To: freebsd-doc->joel

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.