Home | History | Annotate | Line # | Download | only in sets
README revision 1.4.2.2 
      1 # $NetBSD: README,v 1.4.2.2 2000/06/20 06:00:29 thorpej Exp $
      2 
      3 To: "NetBSD Port Maintainers"
      4 Subject: distribution sets, etc...
      5 Date: Mon, 18 Jul 1994 05:02:11 -0400
      6 From: "Chris G. Demetriou"
      7 
      8 [ this is also going in a README in the 'sets' directory... ]
      9 
     10 well, i've finally sat down and started doing distribution set
     11 stuff in a "nice, machine-independent way."  Should have done
     12 it months ago, but too much other stuff going on then...
     13 
     14 anyway, grab ~cgd/sets.tar.gz -- it's three scripts, and a bunch
     15 of files.
     16 
     17 the scripts should be run from the directory where they reside.
     18 
     19 makeflist:	output the list of files that should be in a
     20 		distribution, according to the contents of the
     21 		'lists' directory.
     22 
     23 checkflist:	check the file list (as internally generated
     24 		by makeflist) against the tree living in $DESTDIR.
     25 		(that tree should be made with 'make distribution'.)
     26 
     27 maketars:	make tarballs of the various sets in the distribution,
     28 		based on the contents of the lists, the tree in
     29 		$DESTDIR, and put the tarballs in $RELEASEDIR.
     30 		Note that this script _doesn't_ create the 'secr'
     31 		distribution, because (for now) it requires
     32 		manual intervention to get the binaries right...
     33 		(i'll add another script to create that dist, later.)
     34 
     35 what's in 'lists':
     36 
     37 lists describing file sets.  There are two sets of lists per file
     38 set: machine dependent and machine-independent files. (there's
     39 also another file in the 'man' dir, which is used by the 'man'
     40 and 'misc' sets, but that's explained later.)
     41 
     42 There is one machine-independent file, named "mi".  There are
     43 N machine-dependent files (one per architecture), named "md.${ARCH}".
     44 
     45 the sets are as follows:
     46 
     47 	base:	the base binary set.  excludes everything described
     48 		below.
     49 
     50 	comp:	compiler tools.  All of the tools relating to C, C++,
     51 		and FORTRAN (yes, there are two!) that are in the
     52 		tree.  This includes includes, the linker, tool chain,
     53 		and the .a versions of the libraries.  (obviously,
     54 		base includes ldd, ld.so, and the shared versions.
     55 		base also includes 'cpp', because that's used by X11.)
     56 		includes the man pages for all the binaries contained
     57 		within.  Also, includes all library and system call
     58 		manual pages.
     59 
     60 	etc:	/etc, and associated files (/var/cron/tabs, /root,
     61 		etc.).  things that shouldn't be blindly reinstalled
     62 		on an upgrade.
     63 
     64 	games:	the games and their man pages.
     65 
     66 	man:	all of the man pages for the system, except those
     67 		listed elsewhere (e.g. in comp, games, misc, text).
     68 		Includes machine-dependent man pages for this CPU.
     69 
     70 	misc:	share/dict, share/doc, and the machine-dependent
     71 		man pages for other cpu's which happen to always
     72 		be installed.
     73 
     74 	text:	text processing tools.  groff and all of its friends.
     75 		includes man pages for all bins contained within.
     76 
     77 
     78 as noted, in addition to the "standard" files in each dir, there's
     79 a file called 'md_share' in lists/man.  it's the list of man pages
     80 that are installed from /usr/src/share, which are machine-dependent.
     81 (note that ones that are installed from elsewhere, and thus are
     82 installed on only one architecture, are listed in the md.${ARCH}
     83 file.)  basically, it's grepped through, to see which of the
     84 machine-dependent man pages that are always installed should go
     85 in the 'man' set, and which should go into the 'misc' set.
     86 
     87 
     88 I've made attempts to get the md files for the amiga, i386, hp300,
     89 pc532, and sparc done.  I've not attempted the rest (though there
     90 are empty files for all architectures except the da30, in the
     91 various directories).  I think i got the amiga, i386, and sparc
     92 done correctly, but i know that (because of weirdnesses in how
     93 their last snapshots were built) i didn't get hp300 or pc532
     94 done right.
     95 
     96 what you folks need to do:
     97 
     98 run 'checkflist' on a tree that you've created with 'make
     99 distribution'.  send me the output, and i'll take care of putting
    100 stuff on the right lists for you.  In the future, you'll get
    101 to do it yourselves, as you add programs and include files, but
    102 i'd prefer to do it the first time (unless you really want to do it
    103 yourself -- in that case, please ask me to check your suggestions
    104 re: the appropriate sets for things...)  There should be a minimal
    105 list output by checkflist -- it should all be things that
    106 _should_ be on your lsits, but aren't, i.e. machine-dependent
    107 binaries, man pages, and include files.
    108 
    109 Also, please look through the lists, and tell me if you think
    110 i've put anything in the wrong place.  i think i've
    111 taken care of all of the machine-dependence bugaboos, by
    112 doing it for the N architectures, but i'm not _sure_...  8-)
    113 
    114 
    115 thanks,
    116 
    117 chris
    118 
    119