View Issue Details

IDProjectCategoryView StatusLast Update
00014211003.1(2016/18)/Issue7+TC2Shell and Utilitiespublic2024-06-11 09:08
Reportergeoffclare Assigned To 
PrioritynormalSeverityCommentTypeClarification Requested
Status ClosedResolutionAccepted 
NameGeoff Clare
OrganizationThe Open Group
User Reference
Sectionmake
Page Number2983
Line Number99076
Interp Status---
Final Accepted Text
Summary0001421: make APPLICATION USAGE about default rules
DescriptionThe 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 ActionOn 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.

Tagstc3-2008

Activities

psmith

2020-11-10 19:49

developer   bugnote:0005112

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
2024-06-11 09:08 agadmin Status Applied => Closed