bug-make
[Top][All Lists]
Advanced

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

Re: [bug #17881] Better documentation of make rules


From: Howard Chu
Subject: Re: [bug #17881] Better documentation of make rules
Date: Thu, 28 Sep 2006 13:30:14 -0700
User-agent: Mozilla/5.0 (Windows; U; Windows NT 5.1; en-US; rv:1.9a1) Gecko/20060911 Netscape/7.2 (ax) Firefox/1.5 SeaMonkey/1.5a

Bah. Pretty sure I selected "Documentation" for this submission, not "Enhancement".

Howard Chu wrote:
URL:
  <http://savannah.gnu.org/bugs/?17881>

                 Summary: Better documentation of make rules
                 Project: make
            Submitted by: hyc
            Submitted on: Thursday 09/28/2006 at 20:26
                Severity: 3 - Normal
              Item Group: Enhancement
                  Status: None
                 Privacy: Public
             Assigned to: None
             Open/Closed: Open
       Component Version: None
        Operating System: None
           Fixed Release: None

    _______________________________________________________

Details:

The GNU make manual should state explicitly in section 4.2, Rule Syntax,
something to this effect:

When multiple prerequisites are listed for a rule, their order is
insignificant. In particular, you should not assume that prerequisites will
be processed in left-to-right order. Rules that list prerequisites that
depend on other prerequisites in the same rule are invalid and will break
when processed by a parallel make.

For example, given a rule

targetA: reqOne reqTwo reqThree


if "reqThree" cannot be built successfully until "reqOne" already exists,
then this rule does not specify the actual dependencies of targetA. The
correct rules would be:

reqThree: reqOne

targetA: reqTwo reqThree




--
 -- Howard Chu
 Chief Architect, Symas Corp.  http://www.symas.com
 Director, Highland Sun        http://highlandsun.com/hyc
 OpenLDAP Core Team            http://www.openldap.org/project/





reply via email to

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