View Issue Details

IDProjectCategoryView StatusLast Update
00010621003.1(2008)/Issue 7Base Definitions and Headerspublic2024-06-11 08:52
ReporterSteve Emmerson Assigned Toajosey  
PrioritynormalSeverityEditorialTypeError
Status ClosedResolutionAccepted As Marked 
NameSteve Emmerson
OrganizationUniversity Corporation for Atmospheric Research
User Reference
Section12.1 Utility Argument Syntax
Page Number215
Line Number7073-7074
Interp Status---
Final Accepted TextSee 0001062:0003819.
Summary0001062: Description of multiple synopsis lines is inconsistent with example
DescriptionThe example needs a newline to separate the multiple synopsis lines.
Desired ActionAdd a newline.
Tagstc3-2008

Activities

Don Cragun

2016-07-21 20:53

manager   bugnote:0003304

Last edited: 2016-07-21 21:50

The description does not say that there is an empty line between mutually exclusive synopsis forms, so I believe the example matches the stated requirements. But, in the XCU volume SYNOPSIS sections that have multiple synopsis forms to have an empty line between the various forms to further clarify the difference between different synopsis forms and synopsis forms that have continuation lines.

I would suggest adding an empty line in the example on P215 between lines 7073 and 7074.

geoffclare

2016-07-22 07:53

manager   bugnote:0003305

I believe the problem Steve reported is an HTML translation issue. The HTML version has both example synopsis "lines" on the same line.

Adding an empty line in the source would undoubtedly cure this, but it ought to be addressed in the forthcoming HTML translation of the 2016 edition rather than waiting until the next update to the source.

ajosey

2016-08-26 14:38

manager   bugnote:0003365

To confirm this will be addressed in the html 2016 edition.

Don Cragun

2017-08-24 15:33

manager   bugnote:0003819

Last edited: 2017-08-24 15:35

P213, L7190-7191 (using 2016 edition page and line numbers):
    
utility_name[−a][−b][−c option_argument]
    [−d|−e][−f[option_argument]][operand...]

should be:
    
utility_name [−a] [−b] [−c option_argument]
    [−d|−e] [−f[option_argument]] [operand...]

and P215, L7269-7270
    
utility_name −d[−a][−c option_argument][operand...]
utility_name[−a][−b][operand...]

should be:
    
utility_name −d [−a] [−c option_argument] [operand...]

utility_name [−a] [−b] [operand...]

Also add an empty line between the two SYNOPSIS forms of the nm utility on P3035, L100963 and 100964.

Issue History

Date Modified Username Field Change
2016-07-21 19:52 Steve Emmerson New Issue
2016-07-21 19:52 Steve Emmerson Status New => Under Review
2016-07-21 19:52 Steve Emmerson Assigned To => ajosey
2016-07-21 19:52 Steve Emmerson Name => Steve Emmerson
2016-07-21 19:52 Steve Emmerson Organization => University Corporation for Atmospheric Research
2016-07-21 19:52 Steve Emmerson Section => 12.1 Utility Argument Syntax
2016-07-21 19:52 Steve Emmerson Page Number => Item 8
2016-07-21 20:53 Don Cragun Page Number Item 8 => 215
2016-07-21 20:53 Don Cragun Line Number => 7073-7074
2016-07-21 20:53 Don Cragun Interp Status => ---
2016-07-21 20:53 Don Cragun Note Added: 0003304
2016-07-21 21:50 Don Cragun Note Edited: 0003304
2016-07-22 07:53 geoffclare Note Added: 0003305
2016-08-26 14:38 ajosey Note Added: 0003365
2017-08-24 15:33 Don Cragun Note Added: 0003819
2017-08-24 15:34 Don Cragun Note Edited: 0003819
2017-08-24 15:35 Don Cragun Note Edited: 0003819
2017-08-24 15:36 Don Cragun Final Accepted Text => See 0001062:0003819.
2017-08-24 15:36 Don Cragun Status Under Review => Resolved
2017-08-24 15:36 Don Cragun Resolution Open => Accepted As Marked
2017-08-24 15:37 Don Cragun Tag Attached: tc3-2008
2019-10-28 11:52 geoffclare Status Resolved => Applied
2024-06-11 08:52 agadmin Status Applied => Closed