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