URL: <https://savannah.gnu.org/bugs/?66018>
Summary: Recommendation: document .ONESHELL behavior in
sections concerning line prefixes [@+-]
Group: make
Submitter: None
Submitted: Wed 24 Jul 2024 05:33:17 PM UTC
Severity: 3 - Normal
Item Group: Documentation
Status: None
Privacy: Public
Assigned to: None
Open/Closed: Open
Discussion Lock: Any
Component Version: 4.4.1
Operating System: Any
Fixed Release: None
Triage Status: None
_______________________________________________________
Follow-up Comments:
-------------------------------------------------------
Date: Wed 24 Jul 2024 05:33:17 PM UTC By: Anonymous
Context: I recently was updating a Makefile, and noticed unexpected behavior
when using "@" to prevent Make line echoing. Since the behavior involved
echoing, I searched those docs first. It was only after incrementally removing
other lines that I finally determined that .ONESHELL was responsible for the
behavior I observed, and was able to find the correct documentation. This took
some time.
My recommendation would be to provide a mention of .ONESHELL behavior with
regard to line prefixes in the relevant sections, so that users investigating
issues with their Makefiles can trace more easily from the symptom they
observe to the cause of the behavior.
Such an addition could be very brief. For example:
"'@' has slightly different behavior when the special target '.ONESHELL' is
defined. See the section on '.ONESHELL'."
My recommendation would be to add such a mention in each of the following
sections:
- Section 5.2 (@)
- Section 5.5 (-)
- Section 5.7.1 (+)
My system details:
- GNU Make version 4.4.1
- OpenSUSE Tumbleweed and MacOS via Homebrew
_______________________________________________________
Reply to this item at:
<https://savannah.gnu.org/bugs/?66018>
_______________________________________________
Message sent via Savannah
https://savannah.gnu.org/
signature.asc
Description: PGP signature
