finger: add page #2141
finger: add page #2141
Conversation
pages/common/finger.md
Outdated
|
|
||
| > User information lookup program. | ||
|
|
||
| - Display the user's login name, real name, terminal name and write status (as a "\*" after the terminal name if write permission is denied), idle time, login time, office location and office phone number: |
There was a problem hiding this comment.
We should start with the simplest invocation - finger. And probably shorten the description to Display the user's info
pages/common/finger.md
Outdated
|
|
||
| `finger -s` | ||
|
|
||
| - Produce a multi-line format displaying all the information described for the option ```-s``` as well as the user's home directory, home phone number, login shell, mail status, and the contents of the files ".plan", ".project", ".pgpkey" and ".forward" from the user's home directory: |
There was a problem hiding this comment.
This is copied verbatim from the man page. Please shorten it to a simpler version, and if possible use a word starting with l.
There was a problem hiding this comment.
Shortened it up, but no word came to mind that starts with an l.
pages/common/finger.md
Outdated
|
|
||
| `finger -l` | ||
|
|
||
| - Prevent the ```-l``` option of finger from displaying the contents of the ".plan", ".project" and ".pgpkey" files: |
There was a problem hiding this comment.
I don't think this option is required to be in a tldr page.
|
The build for this PR has failed with the following error(s): Please fix the error(s) and push again. |
pages/common/finger.md
Outdated
|
|
||
| `finger -s` | ||
|
|
||
| - Produce multi-line format displaying same information as `-s` as well as user's home directory, home phone number, login shell, mail status as well as contents of files ".plan", ".project", ".pgpkey", and ".foward" in their home directory: |
There was a problem hiding this comment.
This part can be removed as well as contents of files ".plan", ".project", ".pgpkey", and ".foward" in their home directory and just put etc. in place of it.
pages/common/finger.md
Outdated
|
|
||
| `finger {{username}}` | ||
|
|
||
| - Display the user's login name, real name, terminal name and write status (as a "\*" after the terminal name if write permission is denied), idle time, login time, office location and office phone number: |
There was a problem hiding this comment.
Remove - write status (as a "\*" after the terminal name if write permission is denied), idle time, login time, office location and office phone number and just put other information.
pages/common/finger.md
Outdated
|
|
||
| `finger -s` | ||
|
|
||
| - Produce multi-line format displaying same information as `-s` as well as user's home directory, home phone number, login shell, mail status as well as contents of files ".plan", ".project", ".pgpkey", and ".foward" in their home directory: |
There was a problem hiding this comment.
Produce a multi-line output format
There was a problem hiding this comment.
differs from the man page description, but I agree that it's clearer this way.
There was a problem hiding this comment.
Yes, the whole point is to differ from the man page. 😄
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.