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

[Gökçe Aydos]

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