Page MenuHomeFreeBSD

Clarify in unlink(1) that like rm, unlink too requires "--"
Needs RevisionPublic

Authored by dteske on May 21 2018, 7:51 PM.
Tags
None
Referenced Files
Unknown Object (File)
Dec 23 2023, 2:40 AM
Unknown Object (File)
Oct 4 2023, 11:25 PM
Unknown Object (File)
Jun 19 2023, 9:00 AM
Unknown Object (File)
Apr 25 2023, 9:36 AM
Unknown Object (File)
Apr 7 2023, 4:24 PM
Subscribers

Details

Reviewers
jilles
Group Reviewers
manpages
Summary

While it is explicitly stated with rm that "--" and "./" are methods
for removing a file with rm, the paragraph on unlink is misleading.
Add that unlink too supports "--" and change the wording so that it
is clear that unlink does process arguments, just that none are supported.

Diff Detail

Repository
rS FreeBSD src repository - subversion
Lint
Lint Passed
Unit
No Test Coverage
Build Status
Buildable 16742
Build 16631: arc lint + arc unit

Event Timeline

jilles requested changes to this revision.May 21 2018, 8:13 PM
jilles added a subscriber: jilles.

I agree that the man page should be changed, but I think it can be done better.

bin/rm/rm.1
150

"argument" should be changed to "operand", per POSIX's definitions.

160

I would like to see this addition with the corresponding note about rm in NOTES instead of separately here.

This revision now requires changes to proceed.May 21 2018, 8:13 PM
bin/rm/rm.1
160

This is a common enough FAQ. Do we need it in the manual? Also, some circles recommend ./-f instead of -- -f.

bin/rm/rm.1
150

I'll leave that for someone else to battle ...

Manuals containing "argument": 5614
Manuals containing "operand": 131
Total manuals: 9816

160

There is already a note about this and "rm", just scroll down.

160

The note about ./-f is already in the manual, just scroll down.