View Issue Details

IDProjectCategoryView StatusLast Update
00018421003.1(2024)/Issue8Shell and Utilitiespublic2024-07-25 16:28
Reporterlarryv Assigned To 
PrioritynormalSeverityObjectionTypeError
Status ResolvedResolutionAccepted 
NameLawrence Velázquez
Organization
User Reference
Section1.4
Page Number2462
Line Number79697-79698
Interp Status---
Final Accepted Text
Summary0001842: The phrase "The…utility shall conform to the Utility Syntax Guidelines…" is never used normatively
DescriptionXCU Section 1.4 states:
Each OPTIONS section that uses the phrase "The...utility shall conform to the Utility Syntax Guidelines..." refers only to the use of the utility as specified by this volume of POSIX.1-2024; implementation extensions should also conform to the guidelines, but may allow exceptions for historical practice.
However, the standard never uses the phrase "The...utility shall conform to the Utility Syntax Guidelines..." in the intended context, with the possible exception of the sccs description (page 3349, lines 113847-113849). This is probably because cross-references are generated dynamically; in the PDF version, utility descriptions generally say
The...utility shall conform to XBD Section 12.2 (on page 215)...
while in the HTML version they say
The...utility shall conform to XBD 12.2 Utility Syntax Guidelines..."
This discrepancy may confuse readers of the PDF version in particular.
Desired ActionOn page 2462, lines 79697-79698, change
Each OPTIONS section that uses the phrase "The...utility shall conform to the Utility Syntax Guidelines..."
to
Each OPTIONS section that uses the phrase "The...utility shall conform to XBD Section 12.2 (on page 215)..."
using the same cross-referencing method that is used elsewhere in the standard. This should keep the quoted text synchronized and improve the consistency of the HTML version as well.
Tagstc1-2024

Activities

There are no notes attached to this issue.

Issue History

Date Modified Username Field Change
2024-07-21 01:58 larryv New Issue
2024-07-21 01:58 larryv Name => Lawrence Velázquez
2024-07-21 01:58 larryv Section => 1.4
2024-07-21 01:58 larryv Page Number => 2462
2024-07-21 01:58 larryv Line Number => 79697-79698
2024-07-25 16:28 Don Cragun Interp Status => ---
2024-07-25 16:28 Don Cragun Status New => Resolved
2024-07-25 16:28 Don Cragun Resolution Open => Accepted
2024-07-25 16:28 Don Cragun Tag Attached: tc1-2024