0001467: Poor language in CHANGE HISTORY entry for Issue 8 for ':' command (defect 1272) changes.

Austin Group Defect Tracker

Aardvark Mark IV

Viewing Issue Simple Details [ Jump to Notes ]

[ Issue History ] [ Print ]

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[^]