Document Number: AUSTIN/94 Title: XBDd7 Aardvark Change Request Report Revision Date: 2001-07-09 Source: Andrew Josey, Chair Action: for review This report contains the dispositions of the aardvark comments submitted against the XBD Draft 7. Aardvark Summary Table ______________________ ERN 1 Accept as marked ERN 2 Duplicate of 1 ERN 3 Duplicate of 1 ERN 4 Duplicate of 1 ERN 5 Duplicate of 1 ERN 6 Duplicate of 1 ERN 7 Duplicate of 1 ERN 8 Duplicate of 1 ERN 9 Accept ERN 10 Accept ERN 11 Accept ERN 12 Duplicate of 1 ERN 13 Accept ERN 14 Accept ERN 15 Accept _____________________________________________________________________________ Editorial Enhancement Request Number 1 dwc@spartan.eng.sun.com Bug in XBD6d7 (rdvk# 7) [DWC-62] Thu, 28 Jun 2001 18:24:55 -0700 (PDT) _____________________________________________________________________________ Accept_____ Accept as marked below_X___ Duplicate_____ Reject_____ Rationale for rejected or partial changes: On balance, having reviewed each case in this ERN and the other similar ones filed against Draft 7 the editors felt that the current text was least confusing to the reader. We have added two additional examples to the typographical conventions (in frontmatter) for literal character so it now says: 'c', '\r', '\' and have added to note 2 on the same page: For literal characters, '\' (or any of the other sequences such as ''') is the same as the C constant '\\' (or '\''). Some editorial changes have been also made for consistency with this. _____________________________________________________________________________ Page: 38 Line: 1388 Section: 3.36 Problem: (backslash character constant in Backslash definition) The character constant representing the backslash character is "'\\'". Action: Change "'\'" on P38, L1388 to "'\\'". ------------------------------------------------------------------------------ _____________________________________________________________________________ Editorial Enhancement Request Number 2 dwc@spartan.eng.sun.com Bug in XBDd6 (rdvk# 4) [DWC-1] Fri, 22 Jun 2001 12:49:46 -0700 (PDT) _____________________________________________________________________________ Accept_____ Accept as marked below_____ Duplicate_of_1 Reject_____ Rationale for rejected or partial changes: _____________________________________________________________________________ Page: 81 Line: 2614 Section: 3.346 Problem: (single-quote character constant in Single-Quote definition) The character constant representing the single-quote character is "'\''". Action: Change "'''" on P81, L2614 to "'\''". ------------------------------------------------------------------------------ _____________________________________________________________________________ Editorial Enhancement Request Number 3 dwc@spartan.eng.sun.com Bug in XBD6d7 (rdvk# 8) [DWC-63] Thu, 28 Jun 2001 18:24:55 -0700 (PDT) _____________________________________________________________________________ Accept_____ Accept as marked below_____ Duplicate_of_1 Reject_____ Rationale for rejected or partial changes: _____________________________________________________________________________ Page: 110 Line: 3439 Section: 5 Problem: (backslash character constant in table 5-1) The character constant representing the backslash character is "'\\'". Action: Change "'\'" on P110, L3439 to "'\\'". ------------------------------------------------------------------------------ _____________________________________________________________________________ Editorial Enhancement Request Number 4 dwc@spartan.eng.sun.com Bug in XBD6d7 (rdvk# 9) [DWC-64] Thu, 28 Jun 2001 18:24:55 -0700 (PDT) _____________________________________________________________________________ Accept_____ Accept as marked below_____ Duplicate_of_1 Reject_____ Rationale for rejected or partial changes: _____________________________________________________________________________ Page: 117,118 Line: 3758,3785 Section: 6.4 Problem: (backslash character constant in character set description file discussion) The character constant representing the backslash character is "'\\'". Action: Change "'\'" on P117, L3758 to "'\\'". Change "'\'" on P118, L3785 to "'\\'". ------------------------------------------------------------------------------ _____________________________________________________________________________ Editorial Enhancement Request Number 5 dwc@spartan.eng.sun.com Bug in XBD6d7 (rdvk# 10) [DWC-65] Thu, 28 Jun 2001 18:24:55 -0700 (PDT) _____________________________________________________________________________ Accept_____ Accept as marked below_____ Duplicate_of_1 Reject_____ Rationale for rejected or partial changes: _____________________________________________________________________________ Page: 169,170 Line: 5968,6005 Section: 9.3 Problem: (backslash character constant in BREs) The character constant representing the backslash character is "'\\'". Action: Change "'\'" on P169, L5968 to "'\\'". Change "'\'" on P170, L6005 to "'\\'". ------------------------------------------------------------------------------ _____________________________________________________________________________ Editorial Enhancement Request Number 6 dwc@spartan.eng.sun.com Bug in XBD6d7 (rdvk# 11) [DWC-66] Thu, 28 Jun 2001 18:24:55 -0700 (PDT) _____________________________________________________________________________ Accept_____ Accept as marked below_____ Duplicate_of_1 Reject_____ Rationale for rejected or partial changes: _____________________________________________________________________________ Page: 174 Line: 6168 Section: 9.4 Problem: (backslash character constant in EREs) The character constant representing the backslash character is "'\\'". Action: Change "'\'" on P174, L6168 to "'\\'". ------------------------------------------------------------------------------ _____________________________________________________________________________ Editorial Enhancement Request Number 7 dwc@spartan.eng.sun.com Bug in XBD6d7 (rdvk# 12) [DWC-67] Thu, 28 Jun 2001 18:24:55 -0700 (PDT) _____________________________________________________________________________ Accept_____ Accept as marked below_____ Duplicate_of_1 Reject_____ Rationale for rejected or partial changes: _____________________________________________________________________________ Page: 177,181 Line: 6287,6291,6466 Section: 9.5 Problem: (backslash character constant in RE grammar) The character constant representing the backslash character is "'\\'". Action: Change "'\'" on P177, L6287 to "'\\'". Change "'\'" on P177, L6291 to "'\\'". Change "'\'" on P181, L6466 to "'\\'". ------------------------------------------------------------------------------ _____________________________________________________________________________ Editorial Enhancement Request Number 8 dwc@spartan.eng.sun.com Bug in XBD6d7 (rdvk# 13) [DWC-68] Thu, 28 Jun 2001 18:24:55 -0700 (PDT) _____________________________________________________________________________ Accept_____ Accept as marked below_____ Duplicate_of_1 Reject_____ Rationale for rejected or partial changes: _____________________________________________________________________________ Page: 190 Line: 6775 Section: 11.1.9 Problem: (backslash character constant in GTI special characters) The character constant representing the backslash character is "'\\'". Action: Change "'\'" on P190, L6775 to "'\\'". ------------------------------------------------------------------------------ _____________________________________________________________________________ editorial Enhancement Request Number 9 pete.forman@westerngeco.com BUG in XBDd7 (rdvk# 2) [PWF20010615/2] Fri, 15 Jun 2001 15:22:05 +0100 _____________________________________________________________________________ Accept_X___ Accept as marked below_____ Duplicate_____ Reject_____ Rationale for rejected or partial changes: (note also see ERN 10) _____________________________________________________________________________ Page: 221 Line: 7876 Section: Problem: There are five instances of exec() in draft 7. They should have their parentheses removed for consistency with the other instances. exec refers here to the family of functions execl(), etc. In particular the section name in XSH, 3. System interfaces, does not use parentheses. This report was previously submitted to austin-group-l after the d6 review period had closed as [PWF20010522/2]. Action: Here and at XBDd7 page 311 line 11159 section editorial XBDd7 page 413 line 14722 section editorial XSHd7 page 976 line 30148 section posix_trace_create() editorial XRATd7 page 3488 line 8230 section B.2.11.4 editorial (maybe) Change "exec()" to "exec" [Ed recommendation: Accept] _____________________________________________________________________________ Editorial Enhancement Request Number 10 dwc@spartan.eng.sun.com Bug in XBDd6 (rdvk# 5) [DWC-2] Fri, 22 Jun 2001 12:49:46 -0700 (PDT) _____________________________________________________________________________ Accept_X___ Accept as marked below_____ Duplicate_____ Reject_____ Rationale for rejected or partial changes: _____________________________________________________________________________ Page: 221 Line: 7876 Section: Problem: (references to exec()) I agree with the issue raised by Pete Forman (filed against P221, L7876), but some of his page and line number references are off, and I suggest alternative replacement text for two of his proposed changes. The actions below are intended to replace the actions suggested by Mr. Forman, correcting page and line number references and proposing two changes to the wording he suggested. Note that these actions request changes in XBD, XSH, and XRAT. I did not split these into three aardvark reports because the original report didn't either and I want to keep the comments close to each other on the aardvark reports. Action: Change "exec()," on P223, L7876 in XBD6 draft 7 to "exec,". Change "exec()," on P311, L11159 in XBD6 draft 7 to "exec,". Change "exec()," on P413, L14722 in XBD6 draft 7 to "exec,". Change "invokes an exec() call," on P1423, L30148 in XSH6 draft 7 to "invokes a member of the exec family of functions,". Change "exec()" in the figure following P3488, L8230 in XRAT6 draft 7 to "exec*()". (Note that "exec" could also be used here, but might be confused with the exec shell special built-in utility in this context.) ------------------------------------------------------------------------------ _____________________________________________________________________________ editorial Enhancement Request Number 11 pete.forman@westerngeco.com BUG in XBDd7 (rdvk# 3) [PWF20010615/3] Fri, 15 Jun 2001 15:22:05 +0100 _____________________________________________________________________________ Accept_X___ Accept as marked below_____ Duplicate_____ Reject_____ Rationale for rejected or partial changes: _____________________________________________________________________________ Page: 288 Line: 10255 Section: Problem: Redundant backslash. While the existing text is correct it is inconsistent with the rest of the document. In all other places declarations that span multiple lines do not use backslashes. They are used only where needed in macro definitions. This report was previously submitted to austin-group-l after the d6 review period had closed as [PWF20010522/3] and /4. Action: Change "pthread_barrierattr_getpshared( \" to "pthread_barrierattr_getpshared(" also at page 289 line 10305 section editorial Change "pthread_mutexattr_getprioceiling( \" to "pthread_mutexattr_getprioceiling(" [Ed recommendation:Accept] _____________________________________________________________________________ Editorial Enhancement Request Number 12 dwc@spartan.eng.sun.com Bug in XBD6d7 (rdvk# 14) [DWC-69] Thu, 28 Jun 2001 18:24:55 -0700 (PDT) _____________________________________________________________________________ Accept_____ Accept as marked below_____ Duplicate_of_1 Reject_____ Rationale for rejected or partial changes: _____________________________________________________________________________ Page: 293 Line: 10491 Section: Problem: (backslash character constant in ) The character constant representing the backslash character is "'\\'". Action: Change "'''" on P293, L10491 to "'\\'". ------------------------------------------------------------------------------ _____________________________________________________________________________ editorial Enhancement Request Number 13 curtis.smith@simtrol.com Bug in XBDd7 sys/socket.h app usage (rdvk# 6) {cms=PAD2SIZE} Thu, 21 Jun 2001 20:01:16 +0100 (BST) _____________________________________________________________________________ Accept_X___ Accept as marked below_____ Duplicate_____ Reject_____ Rationale for rejected or partial changes: _____________________________________________________________________________ Page: 355 Line: 12580 Section: sys/socket.h Problem: (Draft 5 ERN reference: NA ) Macro definition is split across two lines without a \ to join them. Action: Add \ at end of line 12580 _____________________________________________________________________________ Editorial Enhancement Request Number 14 Donn Terry Bug in xbdd7 nested comment (rdvk# 15) [DST-5] Thu, 28 Jun 2001 09:14:17 -0700 _____________________________________________________________________________ Accept_X___ Accept as marked below_____ Duplicate_____ Reject_____ Rationale for rejected or partial changes: _____________________________________________________________________________ Page: 355 Line: 12585 Section: sys/socket.h Problem: Nested comment. Action: Remove the "*/" at the end of 12585, as the one at 12586 serves the purpose. _____________________________________________________________________________ editorial Enhancement Request Number 15 pete.forman@westerngeco.com BUG in XBDd7 (rdvk# 1) [PWF20010615/1] Fri, 15 Jun 2001 15:22:05 +0100 _____________________________________________________________________________ Accept_X___ Accept as marked below_____ Duplicate_____ Reject_____ Rationale for rejected or partial changes: _____________________________________________________________________________ Page: 362 Line: 12843 Section: Problem: Typo. FD_SETSIZE as defined in is an object-like macro, not function-like. This report was previously submitted to austin-group-l after the d6 review period had closed as [PWF20010522/1]. Action: Change "FD_SETSIZE()" to "FD_SETSIZE" [Ed recommendation:Accept]