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