[pkgsrc/trunk]: pkgsrc/mk/flavor Added a README file with some basic introduc...

[rillig <rillig%pkgsrc.org@localhost>]

details:   https://anonhg.NetBSD.org/pkgsrc/rev/47b4bf39125b
branches:  trunk
changeset: 525630:47b4bf39125b
user:      rillig <rillig%pkgsrc.org@localhost>
date:      Tue Feb 20 13:08:32 2007 +0000

description:
Added a README file with some basic introduction to encourage developers
to port pkgsrc to other packaging systems.

diffstat:

 mk/flavor/README |  56 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 files changed, 56 insertions(+), 0 deletions(-)

diffs (60 lines):

diff -r 58b894a28dab -r 47b4bf39125b mk/flavor/README
--- /dev/null   Thu Jan 01 00:00:00 1970 +0000
+++ b/mk/flavor/README  Tue Feb 20 13:08:32 2007 +0000
@@ -0,0 +1,56 @@
+= Introduction =
+
+A package flavor is a packaging system that is supported by pkgsrc.
+Currently, there is only one (the native pkgsrc tools), but maybe we can
+support RPM, dpkg or the Solaris native packages someday. It can also be
+used to test new variants of the packaging tools.
+
+= Interface =
+
+A package system flavor must define the following variables so that they
+can be used when loading Makefiles. (That is, no references to undefined
+variables.)
+
+* PKG_DBDIR (TODO: Make the other parts of pkgsrc independent of that
+  variable; this should go away.)
+
+* PKG_ADD
+* PKG_ADMIN
+* PKG_CREATE
+* PKG_DELETE
+* PKG_INFO
+* PKG_VIEW
+* LINKFARM
+* PKG_BEST_EXISTS
+
+The variables from the second list are all shell commands, which must
+accept some command line options that are detailed in the respective man
+pages. (TODO: Find out which command line options are really used and
+which ones are useful. Document them.)
+
+The following variables must be defined so that they can be used in
+shell commands. They may contain references to all other variables.
+
+* PKG_FILELIST_CMD
+
+The following make targets must be implemented:
+
+* check-vulnerable
+* deinstall-pkg
+* show-depends
+* depends-install
+* bootstrap-depends
+* register-pkg
+* tarup (XXX: This doesn't sound like a target that should be defined
+  here.)
+* tarup-pkg
+* package-install
+* replace-pkg
+* undo-replace-pkg
+
+= Bugs =
+
+The name "flavor" is badly chosen, especially since flavor is such a
+broad term that OpenBSD ports collection has chosen to implement
+something entirely different using the same name. (This has happended
+before pkgsrc has chosen to use this word, though, so no blame on them.)