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
0001421 [1003.1(2016/18)/Issue7+TC2] Shell and Utilities Comment Clarification Requested 2020-11-10 12:13 2021-03-19 09:54
Reporter geoffclare View Status public  
Assigned To
Priority normal Resolution Accepted  
Status Applied  
Name Geoff Clare
Organization The Open Group
User Reference
Section make
Page Number 2983
Line Number 99076
Interp Status ---
Final Accepted Text
Summary 0001421: make APPLICATION USAGE about default rules
Description The make APPLICATION USAGE section includes this statement:
The best way to provide portable makefiles is to include all of the rules needed in the makefile itself.
It seems that its purpose is to advise writers of portable applications not to rely on the default rules. (It is followed by other text relating to the default rules.) However, following the addition of include lines to the standard, it can be misinterpreted as advising against the use of include lines.

The problem could be fixed by changing "in the makefile itself" to "in the makefile(s), and any include files, themselves", but since the advice seems dubious I would prefer just to remove it (and make some adjustments to the text that follows it).
Desired Action On page 2983 line 99076 section make (APPLICATION USAGE), change:
The best way to provide portable makefiles is to include all of the rules needed in the makefile itself. The rules provided use only features provided by other parts of this volume of POSIX.1-2017. The default rules include rules for optional commands in this volume of POSIX.1-2017. Only rules pertaining to commands that are provided are needed in an implementation's default set.
to:
The standard set of default rules use only features provided by other parts of this volume of POSIX.1-2017. They include rules for optional utilities in this volume of POSIX.1-2017, but only rules pertaining to utilities that are provided are needed in an implementation's default set.

Tags tc3-2008
Attached Files

- Relationships

-  Notes
(0005112)
psmith (developer)
2020-11-10 19:49

I agree that removing the advice altogether is the best plan.

- Issue History
Date Modified Username Field Change
2020-11-10 12:13 geoffclare New Issue
2020-11-10 12:13 geoffclare Name => Geoff Clare
2020-11-10 12:13 geoffclare Organization => The Open Group
2020-11-10 12:13 geoffclare Section => make
2020-11-10 12:13 geoffclare Page Number => 2983
2020-11-10 12:13 geoffclare Line Number => 99076
2020-11-10 12:13 geoffclare Interp Status => ---
2020-11-10 19:49 psmith Note Added: 0005112
2021-03-04 16:33 Don Cragun Status New => Resolved
2021-03-04 16:33 Don Cragun Resolution Open => Accepted
2021-03-04 16:33 Don Cragun Tag Attached: tc3-2008
2021-03-19 09:54 geoffclare Status Resolved => Applied


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