Austin Group Defect Tracker

Aardvark Mark IV


Viewing Issue Simple Details Jump to Notes ] Issue History ] Print ]
ID Category Severity Type Date Submitted Last Update
0001467 [Issue 8 drafts] Shell and Utilities Editorial Enhancement Request 2021-04-16 22:37 2024-06-11 09:12
Reporter kre View Status public  
Assigned To
Priority normal Resolution Accepted  
Status Closed   Product Version Draft 1.1
Name Robert Elz
Organization
User Reference
Section XCU 2.14 Special Built-In Utilities, "colon"
Page Number 2316
Line Number 75174-5
Final Accepted Text
Summary 0001467: Poor language in CHANGE HISTORY entry for Issue 8 for ':' command (defect 1272) changes.
Description The CHANGE HISTORY added to the colon special built-in shell command
includes the words:

   the null utility does not expand its arguments,

This was added because the earlier description of the command said:

   This utility shall only expand command arguments.

which was incorrect, the shell does the arg expanding, the utility
does nothing at all with its arguments.

However the choice of words "does not expand" could be misinterpreted to
indicate that the shell should also not expand the arguments to this utility.
That is not what is intended.

Please note that (by request) this bug is being submitted against
Issue 8, draft 1.1 (and the page and line numbers reflect that) but
bug 1272 (which caused this section to be inserted) is tagged for Issue7-tc3
so if there ever is a tc3 for issue 7 (I know, not currently planned, but...)
this bug should be handled when the CHANGE HISTORY for this issue is
modified from Issue 8 to whatever it will be in that case.
Desired Action Change the clause (which spans lines 75174 and 75175) from

    the null utility does not expand its arguments,

to

    the null utility does not process its arguments,

which reinforces the args being ignored, which they are, while not
suggesting that the args would not be expanded before the utility is invoked.

Other wording which avoids the suggestion that the args do not get
expanded would be fine.
Tags tc3-2008
Attached Files

- Relationships

-  Notes
(0005320)
kre (reporter)
2021-04-16 22:48

Ugh: When I added that "Please Note" paragraph in the Description
(the last thing I did before submitting) I though I was added it right
at the end of the description ... the paragraph that follows should
come before that one!

Apologies for not checking more thoroughly.
(0005321)
Don Cragun (manager)
2021-04-17 00:33

Description modified as suggested in Note: 0005320.
(0005322)
geoffclare (manager)
2021-04-19 08:13

Regarding getting this change into TC3 (if there is one), this bug should be tagged tc3-2008 when it is accepted, so that it will be applied in the Issue7TC3 branch in gitlab.
(0005324)
kre (reporter)
2021-04-19 17:09

Re Note: 0005321 Thanks.

- Issue History
Date Modified Username Field Change
2021-04-16 22:37 kre New Issue
2021-04-16 22:37 kre Name => Robert Elz
2021-04-16 22:37 kre Section => XCU 2.14 Special Built-In Utilities, "colon"
2021-04-16 22:37 kre Page Number => 2316
2021-04-16 22:37 kre Line Number => 75174-5
2021-04-16 22:48 kre Note Added: 0005320
2021-04-17 00:33 Don Cragun Note Added: 0005321
2021-04-17 00:33 Don Cragun Description Updated
2021-04-17 00:33 Don Cragun Desired Action Updated
2021-04-19 08:13 geoffclare Note Added: 0005322
2021-04-19 17:09 kre Note Added: 0005324
2021-05-06 15:08 geoffclare Status New => Resolved
2021-05-06 15:08 geoffclare Resolution Open => Accepted
2021-05-06 15:09 geoffclare Tag Attached: tc3-2008
2021-05-11 09:33 geoffclare Status Resolved => Applied
2024-06-11 09:12 agadmin Status Applied => Closed


Mantis 1.1.6[^]
Copyright © 2000 - 2008 Mantis Group
Powered by Mantis Bugtracker