users: add page #2328
users: add page #2328
Conversation
| @@ -0,0 +1,11 @@ | |||
| # users | |||
|
|
|||
| > Display a list of logged in users. | |||
There was a problem hiding this comment.
How about ..
Lists the login names of the users currently on the system, in sorted order.
There was a problem hiding this comment.
I think "logged in users" is fine.
There was a problem hiding this comment.
I think that's a bit too verbose, @mfrw. If possible, we prefer more concise descriptions as opposed to longer ones as they're easier to understand quickly :-)
|
|
||
| `users` | ||
|
|
||
| - Display a list of logged in users according to a specific file: |
There was a problem hiding this comment.
What does "according to a file" mean ? What does the file specify ?
There was a problem hiding this comment.
You can specify a custom file. By default it checks /var/run/utmp. But there's also /var/log/wmtp which is a historical dump of utmp. And btmp which displays failed login attempts.
There was a problem hiding this comment.
Ah I see. I thought it will always show the current logged in users. Perhaps we can mention "/var/log/wmtp" instead of path/to/file ? That may make things more clear.
Part of #2213
The page (if new), does not already exist in the repo.
The page (if new), has been added to the correct platform folder:
common/if it's common to all platforms,linux/if it's Linux-specific, and so on.The page has 8 or fewer examples.
The PR is appropriately titled:
<command name>: add pagefor new pages, or<command name>: <description of changes>for pages being edited.The page follows the contributing guidelines.