-
-
Notifications
You must be signed in to change notification settings - Fork 328
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Manpage: note pre/post actions effect on an alias #4672
Conversation
3d0c7d9
to
b5a2151
Compare
448bca2
to
d53a8ca
Compare
AddPostAction and AddPreAction apply to the action of the alias, which may not have been clear previously (see SCons#2281). Expanded the example for AddPreAction using a multi-step build. Signed-off-by: Mats Wichmann <[email protected]>
The initial version of PR #4872 proposed to document that pre- and post-actions on an alias have no effect if the alias has no action itself. Subsequently, PR #4874 was merged to change this behavior so that statement is backed out, but the other proposed doc improvements in this area are retained. Signed-off-by: Mats Wichmann <[email protected]>
d53a8ca
to
086a92b
Compare
SCons/Environment.xml
Outdated
@@ -440,7 +460,7 @@ file into an object file. | |||
</arguments> | |||
<summary> | |||
<para> | |||
Creates an <firstterm>alias</firstterm> target that | |||
Create an <firstterm>Alias</firstterm> target that |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Should this be Alias entity instead?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Not a term we use anywhere else... but not necessarily averse to using a new term. We don't use "alias target" much either, unless I'm searching poorly.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Maybe the word "Node" is what we want, since that's what is actually made?
AddPostAction
andAddPreAction
apply to the action of the alias, which may not have been clear previously (see #2281).Expanded the example for
AddPreAction
using a multi-step build.I don't consider that this completes the referenced issue, since it only provides information to those who happen to read those manpage snips - there is neither a warning on use nor a lessening of the impression that "it ought to work".
No code is affected.
Contributor Checklist:
CHANGES.txt
andRELEASE.txt
(and read theREADME.rst
).