The following issue has been SUBMITTED. ====================================================================== https://austingroupbugs.net/view.php?id=1867 ====================================================================== Reported By: geoffclare Assigned To: ====================================================================== Project: 1003.1(2024)/Issue8 Issue ID: 1867 Category: Base Definitions and Headers Type: Error Severity: Editorial Priority: normal Status: New Name: Geoff Clare Organization: The Open Group User Reference: Section: 3 Page Number: (many) Line Number: (many) Interp Status: --- Final Accepted Text: ====================================================================== Date Submitted: 2024-10-31 11:46 UTC Last Modified: 2024-10-31 11:46 UTC ====================================================================== Summary: ISO editors Issue 8 comment 046 Description: In their comment 046 on Issue 8 the ISO editors requested that we do not use parentheses in chapter 3 subheadings unless they are part of the term being defined. The Austin Group's response was that this change would be considered for the next TC.
There are three way in which parentheses appear in definition headings: 1. To indicate synonyms, e.g. "Directory Entry (or Hard Link)". The ISO style is to put synonyms in bold underneath the preferred term. 2. To provide context, e.g. "Arm (a timer)" and "Disarm (a Timer)". In some cases (including these two) the context is not needed as the term is only ever used in that context. Otherwise, the ISO style for providing context is to put multiple entries for the same term in the definitions clause, with the "domain" in angle brackets before each definition. 3. Character names, e.g. "Alert Character (<alert>)". This usage is not really a synonym or context; it is identifying which character in the portable character set is being defined. This should be done in the definition text instead of the heading. There is also one term defined with parentheses that is never used - Local Interprocess Communication (Local IPC) - and so should be deleted. Desired Action: On page 32 line 1056 section 3.9, change:<blockquote><b>3.9 Alert Character (<alert>)</b><blockquote>A character that in the output stream should cause a terminal to alert its user via a visual or audible notification. It is the character designated by '\a' in the C language.</blockquote></blockquote>to:<blockquote><b>3.9 Alert Character</b><blockquote>A character that in the output stream should cause a terminal to alert its user via a visual or audible notification. It is the character designated by '\a' in the C language and defined in the portable character set as <alert>.</blockquote></blockquote>and make an equivalent change for other character definitions that have the same format (i.e. which include a sentence of the form "It is the character designated by '...' in the C language.") On page 33 line 1091 section 3.17, change:<blockquote><b>3.9 Apostrophe Character (<apostrophe>)</b><blockquote>The character designated by '\'' in the C language</blockquote></blockquote>to:<blockquote><b>3.9 Apostrophe Character</b><blockquote>The character designated by '\'' in the C language and defined in the portable character set as <apostrophe>.</blockquote></blockquote>and make an equivalent change for other character definitions that have the same format. On page 33 line 1100 section 3.20, change:<blockquote>Application Program Interface (API)</blockquote>to:<blockquote>Application Program Interface API</blockquote> On page 34 line 1117 section 3.23, change:<blockquote>Arm (a timer)</blockquote>to:<blockquote>Arm</blockquote> On page 34 line 1120 section 3.24, change:<blockquote><b>3.9 Asterisk Character (<asterisk>)</b><blockquote>The character '*'.</blockquote></blockquote>to:<blockquote><b>3.9 Asterisk Character</b><blockquote>The character '*', defined in the portable character set as <asterisk>.</blockquote></blockquote>and make an equivalent change for other character definitions that have the same format. On page 37 line 1201 section 3.43, change:<blockquote>Basic Regular Expression (BRE)</blockquote>to:<blockquote>Basic Regular Expression BRE</blockquote> On page 37 line 1207 section 3.45, change:<blockquote>Blank Character (<blank>)</blockquote>to:<blockquote>Blank Character</blockquote> On page 37 line 1214 section 3.47, change:<blockquote><b>3.47 Blocked Process (or Thread)</b> A process (or thread) that is waiting for some condition (other than the availability of a processor) to be satisfied before it can continue execution.</blockquote>to:<blockquote><b>3.47 Blocked</b><blockquote><process> A process that is waiting for some condition (other than the availability of a processor) to be satisfied before it can continue execution.</blockquote><b>3.48 Blocked</b><blockquote><thread> A thread that is waiting for some condition (other than the availability of a processor) to be satisfied before it can continue execution.</blockquote></blockquote> On page 39 line 1242 section 3.54, change:<blockquote>Built-In Utility (or Built-In)</blockquote>to:<blockquote>Built-In Utility Built-In</blockquote> On page 44 line 1414 section 3.90, change:<blockquote>CPU Time (Execution Time)</blockquote>to:<blockquote>CPU Time Execution Time</blockquote> On page 45 line 1428 section 3.94, change:<blockquote><b>Current Working Directory</b> See [xref to 3.421 Working Directory]</blockquote>to:<blockquote><b>Current Working Directory</b> <b>Working Directory</b> A directory, associated with a process, that is used in pathname resolution for pathnames that do not begin with a <slash> character.</blockquote> On page 46 line 1459 section 3.104, change:<blockquote>Directory Entry (or Hard Link)</blockquote>to:<blockquote>Directory Entry Hard Link</blockquote> On page 46 line 1465 section 3.106, change:<blockquote>Disarm (a Timer)</blockquote>to:<blockquote>Disarm</blockquote> On page 48 line 1516 section 3.121, change:<blockquote>Empty String (or Null String)</blockquote>to:<blockquote>Empty String Null String</blockquote> On page 50 line 1561 section 3.134, change:<blockquote>Extended Regular Expression (ERE)</blockquote>to:<blockquote>Extended Regular Expression ERE</blockquote> On page 51 line 1583 section 3.138, change:<blockquote>FIFO Special File (or FIFO)</blockquote>to:<blockquote>FIFO Special File FIFO</blockquote> On page 53 line 1668 section 3.156, change:<blockquote>First Open (of a File)</blockquote>to:<blockquote>First Open</blockquote> On page 58 line 1797 section 3.184, change:<blockquote>Last Close (of a File)</blockquote>to:<blockquote>Last Close</blockquote> On page 59 line 1828 section 3.192, delete:<blockquote><b>3.192 Local Interprocess Communication (Local IPC)</b><blockquote>The transfer of data between processes in the same system.</blockquote></blockquote> On page 63 line 1932 section 3.217, change:<blockquote>NaN (Not a Number)</blockquote>to:<blockquote>NaN Not a Number</blockquote> On page 70 line 2152 section 3.266, change:<blockquote>Portable Messages Object Source File (or Dot-Po File)</blockquote>to:<blockquote>Portable Messages Object Source File Dot-Po File</blockquote> On page 71 line 2172 section 3.270, change:<blockquote><b>3.270 Preempted Process (or Thread)</b><blockquote>A running thread whose execution is suspended due to another thread becoming runnable at a higher priority.</blockquote></blockquote>to:<blockquote><b>3.270 Preempted</b><blockquote><process> A running process whose execution is suspended due to another process becoming runnable at a higher priority.</blockquote><b>3.271 Preempted</b><blockquote><thread> A running thread whose execution is suspended due to another thread becoming runnable at a higher priority.</blockquote></blockquote> On page 74 line 2271 section 3.294, change:<blockquote>Radix Character (or Decimal-Point Character)</blockquote>to:<blockquote>Radix Character Decimal-Point Character</blockquote> On page 76 line 2317 section 3.307, change:<blockquote>Regular Built-In Utility (or Regular Built-In)</blockquote>to:<blockquote>Regular Built-In Utility Regular Built-In</blockquote> On page 77 line 2338 section 3.314, change:<blockquote><b>3.314 (Time) Resolution</b><blockquote>The minimum time interval that a clock can measure or whose passage a timer can detect.</blockquote></blockquote>to:<blockquote><b>3.314 Resolution</b><blockquote><pathname> See [xref to 4.16 Pathname Resolution].</blockquote><b>3.315 Resolution</b><blockquote><time> The minimum time interval that a clock can measure or whose passage a timer can detect.</blockquote></blockquote> On page 77 line 2346 section 3.317, change:<blockquote><b>3.317 Runnable Process (or Thread)</b><blockquote>A thread that is capable of being a running thread, but for which no processor is available.</blockquote></blockquote>to:<blockquote><b>3.317 Runnable</b><blockquote><process> A process that is capable of being a running process, but for which no processor is available.</blockquote><b>3.318 Runnable</b><blockquote><thread> A thread that is capable of being a running thread, but for which no processor is available.</blockquote></blockquote> On page 77 line 2348 section 3.318, change:<blockquote><b>Running Process (or Thread)</b> A thread currently executing on a processor. On multi-processor systems there may be more than one such thread in a system at a time.</blockquote>to:<blockquote><b>Running</b> Executing on a processor. On multi-processor systems there can be more than one running thread (in one or more processes) in the system at a time.</blockquote> On page 82 line 2465 section 3.346, change:<blockquote>Space Character (<space>)</blockquote>to:<blockquote>Space Character</blockquote> On page 82 line 2474 section 3.349, change:<blockquote>Special Built-In Utility (or Special Built-In)</blockquote>to:<blockquote>Special Built-In Utility Special Built-In</blockquote> On page 87 line 2647 section 3.384, change:<blockquote>Terminal (or Terminal Device)</blockquote>to:<blockquote>Terminal Terminal Device</blockquote> On page 93 line 2804 section 3.417, change:<blockquote>Wide-Character Code (C Language)</blockquote>to:<blockquote>Wide-Character Code</blockquote> On page 93 line 2822 section 3.421, change:<blockquote><b>Working Directory (or Current Working Directory)</b> A directory, associated with a process, that is used in pathname resolution for pathnames that do not begin with a <slash> character.</blockquote>to:<blockquote><b>Working Directory</b> See [xref to 3.94 Current Working Directory]</blockquote> ====================================================================== Issue History Date Modified Username Field Change ====================================================================== 2024-10-31 11:46 geoffclare New Issue 2024-10-31 11:46 geoffclare Name => Geoff Clare 2024-10-31 11:46 geoffclare Organization => The Open Group 2024-10-31 11:46 geoffclare Section => 3 2024-10-31 11:46 geoffclare Page Number => (many) 2024-10-31 11:46 geoffclare Line Number => (many) 2024-10-31 11:46 geoffclare Interp Status => --- ======================================================================
