[pkgsrc/trunk]: pkgsrc/mk/flavor Added headings.

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

details:   https://anonhg.NetBSD.org/pkgsrc/rev/cbcbb1f081a9
branches:  trunk
changeset: 526390:cbcbb1f081a9
user:      rillig <rillig%pkgsrc.org@localhost>
date:      Thu Mar 08 22:57:00 2007 +0000

description:
Added headings.

diffstat:

 mk/flavor/README |  20 +++++++++++++++-----
 1 files changed, 15 insertions(+), 5 deletions(-)

diffs (49 lines):

diff -r b507e0a5df5d -r cbcbb1f081a9 mk/flavor/README
--- a/mk/flavor/README  Thu Mar 08 22:49:05 2007 +0000
+++ b/mk/flavor/README  Thu Mar 08 22:57:00 2007 +0000
@@ -7,13 +7,24 @@
 
 = Interface =
 
+== Variables usable at load-time ==
+
 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.)
 
+=== Legacy ===
+
 * PKG_DBDIR (TODO: Make the other parts of pkgsrc independent of that
   variable; this should go away.)
 
+=== Packaging commands ===
+
+The following variables all refer to 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.)
+
 * PKG_ADD
 * PKG_ADMIN
 * PKG_CREATE
@@ -23,16 +34,15 @@
 * 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
 
+XXX: Why isn't this variable in the previous list?
+
+== Make targets ==
+
 The following make targets must be implemented:
 
 * check-vulnerable