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
0001370 [Issue 8 drafts] Rationale Editorial Error 2020-07-10 09:21 2020-07-10 09:21
Reporter geoffclare View Status public  
Assigned To
Priority normal Resolution Open  
Status New   Product Version Draft 1
Name Geoff Clare
Organization The Open Group
User Reference
Section B.1.1, C.1.1
Page Number 3433, 3555
Line Number 117421, 122714
Final Accepted Text
Summary 0001370: Where change history starts
Description XRAT 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 Action On 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.
Tags No tags attached.
Attached Files

- Relationships

There are no notes attached to this issue.

- 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

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