Re: bin/37822: make's IMPSRC should be better documented

[Quentin Garnier <cube%cubidou.net@localhost>]

The following reply was made to PR bin/37822; it has been noted by GNATS.

From: Quentin Garnier <cube%cubidou.net@localhost>
To: gnats-bugs%NetBSD.org@localhost
Cc: cheusov%tut.by@localhost
Subject: Re: bin/37822: make's IMPSRC should be better documented
Date: Sun, 10 Aug 2008 21:33:37 +0200

 --UKNXkkdQCYZ6W5l3
 Content-Type: text/plain; charset=us-ascii
 Content-Disposition: inline
 Content-Transfer-Encoding: quoted-printable
 
 On Sun, Jan 20, 2008 at 03:40:00PM +0000, cheusov%tut.by@localhost wrote:
 > >Number:         37822
 > >Category:       bin
 > >Synopsis:       IMPSRC should be better documented
 > >Confidential:   no
 > >Severity:       serious
 > >Priority:       medium
 > >Responsible:    bin-bug-people
 > >State:          open
 > >Class:          doc-bug
 > >Submitter-Id:   net
 > >Arrival-Date:   Sun Jan 20 15:40:00 +0000 2008
 > >Originator:     cheusov%tut.by@localhost
 > >Release:        NetBSD 4.0_STABLE
 > >Organization:
 > >Environment:
 > System: NetBSD chen.chizhovka.net 4.0_STABLE NetBSD 4.0_STABLE (GENERIC) =
 #2: Tue Dec 25 17:42:38 EET 2007 
cheusov%chen.chizhovka.net@localhost:/srv/obj/sys/ar=
 ch/i386/compile/GENERIC i386
 > Architecture: i386
 > Machine: i386
 > >Description:
 > May be I missed something but the following Makefile
 > doesn't work as it is documented.=20
 >=20
 > man make says
 >=20
 >              .IMPSRC The name/path of the source from which the target
 >                        is to be transformed (the ``implied'' source);
 >                        also known as `<'.
 >=20
 > .IMPSRC is expanded to the empty string.
 >=20
 > Something important is missed in the documentation.
 
 What's missing from the documentation is the meaning of "implied" here.
 This variable is for implicit rules.
 
 E.g.:
 
 =2ESUFFIXES: .bar
 =2Efoo.bar:
        echo ${.IMPSRC}
 
 touch toto.foo; make toto.bar will print toto.foo.
 
 =2EIMPSRC doesn't make sense in any other context because you can have
 more than a unique dependency in explicit rules, which is why you are
 supposed to use .ALLSRC in that context.
 
 I think just adding "For implicit rules (see special target .SUFFIXES);
 the name/path ...".  And then of course add a bit of documentation in
 =2ESUFFIXES.
 
 --=20
 Quentin Garnier - cube%cubidou.net@localhost - cube%NetBSD.org@localhost
 "See the look on my face from staying too long in one place
 [...] every time the morning breaks I know I'm closer to falling"
 KT Tunstall, Saving My Face, Drastic Fantastic, 2007.
 
 --UKNXkkdQCYZ6W5l3
 Content-Type: application/pgp-signature
 Content-Disposition: inline
 
 -----BEGIN PGP SIGNATURE-----
 Version: GnuPG v1.4.9 (NetBSD)
 
 iQEcBAEBAgAGBQJIn0KQAAoJENgoQloHrPnoWBEH/1Sqh7GMufPmcrDg3tVZ9lZg
 jDZMBnyp19zG+BKywBE2mh/QNyHS3nUCfeByHGGmdhwxJhkUE7vhneiWqj24ylsF
 LNv0nyKUvBalTWBAbGklB99+MEJL8qhA2cCx7BQeF4EoTw59dmbMRa9NIS/D5Y2L
 1ETFADK7pdWgaqxqf2fPQQT3V3eKH/Zevj4h6pS1nFF56WR8VTgun/Ucnn0wOoPb
 bnPZ/N44B7DNut7mPZXCnyC1Ol0NgCc/0xG1yDFWN8lRN6X4no3fy//L3eLpF80+
 U9woEUT3agPheZ8ACwCq/13YGjG59od8L2/GyIlyATM8buaVcUgiricAe16Eruo=
 =8tfa
 -----END PGP SIGNATURE-----
 
 --UKNXkkdQCYZ6W5l3--