Ugly, redundant and confusing regular expression in chmod manpage

Bug #55991 reported by Micah Cowan
2
Affects Status Importance Assigned to Milestone
coreutils (Ubuntu)
Undecided
Unassigned

Bug Description

A user just posted to #ubuntu the regex '[ugoa]*([-+=]([rwxXst]*|[ugo]))+', asking for an explanation.

The regex appears in the chmod manpage, in isolation, without the remotest explanation (or even an explanation that it is, in fact, a regex). A path-expression-type version appears towards the top of the manpage, along with detailed explanation. Surely that's confusing?

I would like this to be removed entirely from the manpage...

Unsure whether upstream would be interested... but it hardly seems appropriate for Ubuntu.

Revision history for this message
Micah Cowan (micahcowan) wrote :

(debdiff that addresses this may be found attached to bug 38538)

Revision history for this message
Micah Cowan (micahcowan) wrote :

Never mind the debdiff on bug 38538: it looks like that fix may go in a different direction.

Here's a debdiff for just this fix.

Revision history for this message
Micah Cowan (micahcowan) wrote :

This debdiff may not be appropriate. IIRC the manpage is auto-generated from the tool's usage; it should be changed there as well. And, I should really get upstream to go for it first, as it's not really worth maintaining a patch for.

Changed in coreutils:
assignee: nobody → micahcowan
status: Unconfirmed → In Progress
Revision history for this message
Micah Cowan (micahcowan) wrote :

I think I'm realizing that this fix isn't really worth the trouble of going and discussing it with upstream. If /I/ don't want to bother with it, surely nobody else will.

Changed in coreutils:
assignee: micahcowan → nobody
status: In Progress → Rejected
To post a comment you must log in.
This report contains Public information  Edit
Everyone can see this information.

Other bug subscribers