View Issue Details

IDProjectCategoryView StatusLast Update
0001370Issue 8 draftsRationalepublic2024-06-11 09:12
Reportergeoffclare Assigned To 
PrioritynormalSeverityEditorialTypeError
Status ClosedResolutionAccepted As Marked 
Product VersionDraft 1 
NameGeoff Clare
OrganizationThe Open Group
User Reference
SectionB.1.1, C.1.1
Page Number3433, 3555
Line Number117421, 122714
Final Accepted TextSee 0001370:0004992.
Summary0001370: Where change history starts
DescriptionXRAT B.1.1 says:
The CHANGE HISTORY section for each entry details the technical changes that have been made to that entry from Issue 5. Changes between earlier versions of the base document and Issue 5 are not included.

and C.1.1 says:
The CHANGE HISTORY section for each utility describes technical changes made to that utility from Issue 5. Changes between earlier versions of the base document and Issue 5 are not included.

These statements are not actually true. The change history starts with an "Issue 5" subheading, but changes listed under that subheading give the changes made in Issue 5, not the changes from Issue 5. So the changes between Issue 4 Version 2 and Issue 5 are included, contrary to what the second sentence of each of those paragraphs says.

However, rather than fixing this text, perhaps what we should do is make it true. I.e. remove change history before the "Issue 6" subheading.

Looking back at how much change history was included in old versions:
  • XPG4 only had 1 heading: "Issue 4"
  • SUSv1 had 2: "Issue 4" and "Issue 4, Version 2"
  • SUSv2 had 3: "Issue 4", "Issue 4, Version 2", and "Issue 5"
  • SUSv3 had 2: "Issue 5" and "Issue 6"
  • SUSv4 had 3: "Issue 5", "Issue 6" and "Issue 7"
If we don't remove "Issue 5" in SUSv5, it will have 4 headings which is more than any previous version. Also, since Issue 6 was the POSIX.1/SUS merge, it seems like a good place to start the change history.
Desired ActionOn each header, function, built-in utility, and utility page that has an "Issue 5" subheading under CHANGE HISTORY, delete from that heading down to (but not including) the next subheading.
Tagsissue8

Activities

rhansen

2020-09-14 15:57

manager   bugnote:0004992

On page 3433 line 117421 (XRAT B.1.1) change:
The CHANGE HISTORY section for each entry details the technical changes that have been made to that entry from Issue 5. Changes between earlier versions of the base document and Issue 5 are not included.
to:
The CHANGE HISTORY section for each entry details the technical changes that have been made in Issue 5 and later. Changes made before Issue 5 are not included.

On page 3555 line 122714 (XRAT C.1.1) change:
The CHANGE HISTORY section for each utility describes technical changes made to that utility from Issue 5. Changes between earlier versions of the base document and Issue 5 are not included.
to:
The CHANGE HISTORY section for each utility describes technical changes made to that utility in Issue 5 and later. Changes made before Issue 5 are not included.

Issue History

Date Modified Username Field Change
2020-07-10 09:21 geoffclare New Issue
2020-07-10 09:21 geoffclare Name => Geoff Clare
2020-07-10 09:21 geoffclare Organization => The Open Group
2020-07-10 09:21 geoffclare Section => B.1.1, C.1.1
2020-07-10 09:21 geoffclare Page Number => 3433, 3555
2020-07-10 09:21 geoffclare Line Number => 117421, 122714
2020-09-14 15:57 rhansen Note Added: 0004992
2020-09-17 15:10 Don Cragun Final Accepted Text => See 0001370:0004992.
2020-09-17 15:10 Don Cragun Status New => Resolved
2020-09-17 15:10 Don Cragun Resolution Open => Accepted As Marked
2020-09-17 15:11 Don Cragun Tag Attached: issue8
2020-09-30 14:27 geoffclare Status Resolved => Applied
2024-06-11 09:12 agadmin Status Applied => Closed