bug-make
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Enhancement request on documentation for 'Multiple Targets in a Rule'


From: Gökçe Aydos
Subject: Enhancement request on documentation for 'Multiple Targets in a Rule'
Date: Fri, 25 Dec 2015 18:22:53 +0100

Hello, section 4.10 'Multiple Targets in a Rule' in make documentation states:
bigoutput littleoutput : text.g
        generate text.g -$(subst output,,$@) > $@

is equivalent to

bigoutput : text.g
        generate text.g -big > bigoutput
littleoutput : text.g
        generate text.g -little > littleoutput

Meaning that one similar recipe applies to multiple targets and the recipe is run multiple times for multiple targets.
But 10.5.1 'Introduction to Pattern Rules' states that pattern rules 
work different than _normal_ rules meaning that one recipe makes 
multiple targets _by executing once_. When I first read section 4.10, I 
believed that it applies to all kind of rules - including pattern rules 
until I discovered the info in section 10.5.1.
It would be helpful to state in section 4.10 that pattern rules behave 
differently. Another idea is to clearly differentiate pattern rules and 
change the title of 4.10 to 'Multiple Targets in a _Normal_ Rule'.
What do you think?

Kind Regards,
Gökçe



reply via email to

[Prev in Thread] Current Thread [Next in Thread]