Austin Group Defect Tracker

Aardvark Mark III

Main | My View | View Issues | Change Log | Docs
  

Viewing Issue Simple Details [ Jump to Notes ] [ Issue History ] [ Print ]
ID Category Severity Type Date Submitted Last Update
0000214 [1003.1(2008)/Issue 7] Shell and Utilities Editorial Clarification Requested 2010-01-15 14:03 2010-01-21 17:11
Reporter Konrad_Schwarz View Status public  
Assigned To ajosey
Priority normal Resolution Accepted As Marked  
Status Resolved  
Name Konrad Schwarz
Organization Siemens AG
User Reference dot-return
Section http://www.opengroup.org/onlinepubs/9699919799/utilities/V3_chap02.html#dot [^]
Page Number 2341
Line Number 74026-74031
Interp Status ---
Final Accepted Text Note: 0000380
Summary 0000214: "dot" should mention the effect of `return'
Description The description of "dot" never mentions `return'.
Desired Action Add a new paragraph at the end of DESCRIPTION:

The `return' utility shall cause the shell to stop executing the dot script.

Or mention `return' explicitly in the SEE ALSO list, despite it being subsumed by the `Special Built-In Utilities' already mentioned there.
Tags tc1-2008
Attached Files

- Relationships

-  Notes
(0000374)
Don Cragun (manager)
2010-01-15 19:53

 I don't understand why anything needs to be said about the return special built-in utility in the description of the dot special built-in utility. The EXIT STATUS section of the dot utility description already says that the exit status will be the exit status of the last command exeuted in file. And, the description of the return special built-in utility says that it will cause the shell to stop executing the current function or dot script.
(0000376)
Konrad_Schwarz (reporter)
2010-01-18 08:01

 This change would be purely for the reader's convenience.

I agree that the current version of the standard is complete. Is "Editorial"/"Clarification Requested" not the right classification for such a change request?
(0000379)
nick (manager)
2010-01-21 16:47

 In austin-group-l:archive/latest/13351 Konrad Schwarz says:

In POSIX, "return" is defined solely for dot scripts and shell functions.
Given its limited scope, I think there is a certain justification for
referring to it from those two scopes.

And indeed, 2.8.5, "Function Definition Command", does mention the special effect
of return: "If the special built-in _return_ is executed in the
_compound-command_, the function completes [...]."

I also just noticed that the "return" NAME section currently reads
"return from a function". This could be extended, e.g., to
"return from a function or script".
(0000380)
msbrown (manager)
2010-01-21 17:10
edited on: 2010-01-21 17:12

 Page 2342 line 74074 add

(add a cross reference to return special built-in utility to the See Also list)

Page 2356 line 74480 add to the See Also list references to:
Section 2.9.5 Function Definition Command
dot special built-in

Page 2324 line 73400 after the word return add:
(a cross-reference to the return special built in utility)

p 2355 l74432 add to the end of the line:
"or dot script"

- Issue History
Date Modified Username Field Change
2010-01-15 14:03 Konrad_Schwarz New Issue
2010-01-15 14:03 Konrad_Schwarz Status New => Under Review
2010-01-15 14:03 Konrad_Schwarz Assigned To => ajosey
2010-01-15 14:03 Konrad_Schwarz Name => Konrad Schwarz
2010-01-15 14:03 Konrad_Schwarz Organization => Siemens AG
2010-01-15 14:03 Konrad_Schwarz User Reference => dot-return
2010-01-15 14:03 Konrad_Schwarz Section => http://www.opengroup.org/onlinepubs/9699919799/utilities/V3_chap02.html#dot [^]
2010-01-15 14:03 Konrad_Schwarz Page Number => 0
2010-01-15 14:03 Konrad_Schwarz Line Number => 0
2010-01-15 19:53 Don Cragun Page Number 0 => 2341
2010-01-15 19:53 Don Cragun Line Number 0 => 74026-74031
2010-01-15 19:53 Don Cragun Interp Status => ---
2010-01-15 19:53 Don Cragun Note Added: 0000374
2010-01-18 08:01 Konrad_Schwarz Note Added: 0000376
2010-01-21 16:47 nick Note Added: 0000379
2010-01-21 17:10 msbrown Note Added: 0000380
2010-01-21 17:10 msbrown Status Under Review => Resolved
2010-01-21 17:10 msbrown Resolution Open => Accepted As Marked
2010-01-21 17:11 msbrown Final Accepted Text => Note: 0000380
2010-01-21 17:12 msbrown Note Edited: 0000380
2010-08-27 12:53 ajosey Tag Attached: tc1-2008

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