summaryrefslogtreecommitdiff
path: root/mk
diff options
context:
space:
mode:
authorrillig <rillig@pkgsrc.org>2006-02-02 23:08:31 +0000
committerrillig <rillig@pkgsrc.org>2006-02-02 23:08:31 +0000
commitb11d1504d0ce0bd55ae12045a1064156477ab566 (patch)
tree297b730e756cf1026dcc8f24e137b7b25c463a6d /mk
parentf2268631dbec730d02d98ed7354748eaab021cc3 (diff)
downloadpkgsrc-b11d1504d0ce0bd55ae12045a1064156477ab566.tar.gz
Replaced jlam's initial sketch with one in which the parts are arranged
in a much simpler way, which hopefully makes the wrapper framework less frightening to the pkgsrc developers. Added some additional notes.
Diffstat (limited to 'mk')
-rw-r--r--mk/wrapper/NOTES62
1 files changed, 35 insertions, 27 deletions
diff --git a/mk/wrapper/NOTES b/mk/wrapper/NOTES
index 342781d35da..4d78403183d 100644
--- a/mk/wrapper/NOTES
+++ b/mk/wrapper/NOTES
@@ -1,31 +1,39 @@
-$NetBSD: NOTES,v 1.2 2005/01/18 17:25:13 jlam Exp $
+$NetBSD: NOTES,v 1.3 2006/02/02 23:08:31 rillig Exp $
+The wrapper scripts work roughly like the block diagram below.
- ==> {"$@"} ,--> {argbuf} ,--> {cmdbuf}
- | |
- ^ | | | | |
- | `------. | | | |
- | | | | | |
- v v | | | |
- | |
- [scan] [arg-source] `--> [logic] `--------> [cmd-sink]
+===> {"$@"} <---> [scan]
+ |
+ v
+ [arg-source]
+ |
+ v
+ {argbuf}
+ | / [arg-pp-main]
+ v | [arg-pp]
+ [logic] <---------> <| [cache]
+ | | [transform.sed]
+ v \ [transform]
+ {cmdbuf}
+ |
+ v
+ [cmd-sink] <---.
+ | |
+ v |
+ [buildcmd] ----'
+ | |
+ v v
+ {cmd} {libs}
+ | |
+ | v
+ | [reorderlibs]
+ | |
+ | /
+ \ /
+ v v
+<=== {cmd}
- ^ ^ ^ ^ ^ ^
- ,-----------------------------' | | | | |
- | ,-------------------' | | | |
- | | ,-------------' | | |
- | | | ,---' `-------. |
- v v v v v v
+Additional notes:
- [arg-pp-main] [arg-pp] [cache] [transform.sed] [transform] [buildcmd]
-
- |
- ,-- {cmd} <--|
- {cmd} <===| |
- `-- {libs} <--'
-
- ^
- |
- v
-
- [reorderlibs]
+* The <---> between the "$@" and the [scan] is indentional. The [scan]
+ program may indeed modify "$@" by using the "set --" shell command.