summaryrefslogtreecommitdiff
path: root/mk/buildlink2/README
diff options
context:
space:
mode:
Diffstat (limited to 'mk/buildlink2/README')
-rw-r--r--mk/buildlink2/README46
1 files changed, 0 insertions, 46 deletions
diff --git a/mk/buildlink2/README b/mk/buildlink2/README
deleted file mode 100644
index bbdf38a4561..00000000000
--- a/mk/buildlink2/README
+++ /dev/null
@@ -1,46 +0,0 @@
-$NetBSD: README,v 1.5 2002/12/26 17:08:56 jlam Exp $
-
-For more general information about the use of buildlink2, see the file
-buildlink2.txt in this directory.
-
- 0 buildlink2 Wrapper Script System
- ==================================
-
-The purpose of the buildlink2 wrapper script system is to replace calls to
-compiler tool with scripts that tranlate any arguments into their buildlink
-equivalents, then invoke the actual compiler tools with the translated
-arguments. The pkgsrc/mk/buildlink2 directory contains bits of the wrapper
-script system for the buildlink2 framework. The wrapper script system is
-composed of three parts: the main wrapper script, the "cache", and the
-"logic" script.
-
- 0.1 Main wrapper script
- =======================
-
-The main wrapper script for a compiler tool (cc, ld, as, etc.) is
-generated from wrapper.sh, except for the libtool wrapper script which is
-generated from libtool.sh. The wrapper scripts share a common set of logic
-files that translate arguments into their buildlink equivalents.
-
- 0.2 Cache
- =========
-
-The cache is a giant Bourne shell "case" statement that stores
-pre-translated arguments from previous wrapper invocations. This allows
-speedy translation of already-seen arguments without having to run the
-utilities needed to perform a translation from scratch. There are two
-caches: the common cache and a wrapper-specific cache. The common cache
-is used by all wrapper scripts. The wrapper-specific cache is read before
-the common cache and contains wrapper-specific argument translation that
-shouldn't be used by other wrapper scripts.
-
- 0.3 Logic script
- ================
-
-The logic script contains a large "case" statement that handles the
-actual translation of an argument into its buildlink equivalent. The logic
-script also invokes a wrapper-specific logic script which may contain extra
-commands that perform further translation of an argument after the main
-translation has been performed by the logic script. Finally, the logic
-script may save the translations results into a cache file if requested by
-the wrapper script.