README revision 1.6.22.1
1# $NetBSD: README,v 1.6.22.1 2008/01/09 01:28:12 matt 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 CPUs which happen to always 81 be installed. 82 83 tests: unit, regression, integration and stress tests for the 84 whole system. 85 86 text: text processing tools. groff and all of its friends. 87 includes man pages for all bins contained within. 88 89 90as noted, in addition to the "standard" files in each dir, there's 91a file called 'md_share' in lists/man. it's the list of man pages 92that are installed from /usr/src/share, which are machine-dependent. 93(note that ones that are installed from elsewhere, and thus are 94installed on only one architecture, are listed in the md.${ARCH} 95file.) basically, it's grepped through, to see which of the 96machine-dependent man pages that are always installed should go 97in the 'man' set, and which should go into the 'misc' set. 98 99 100I've made attempts to get the md files for the amiga, i386, hp300, 101pc532, and sparc done. I've not attempted the rest (though there 102are empty files for all architectures except the da30, in the 103various directories). I think i got the amiga, i386, and sparc 104done correctly, but i know that (because of weirdnesses in how 105their last snapshots were built) i didn't get hp300 or pc532 106done right. 107 108what you folks need to do: 109 110run 'checkflist' on a tree that you've created with 'make 111distribution'. send me the output, and i'll take care of putting 112stuff on the right lists for you. In the future, you'll get 113to do it yourselves, as you add programs and include files, but 114i'd prefer to do it the first time (unless you really want to do it 115yourself -- in that case, please ask me to check your suggestions 116re: the appropriate sets for things...) There should be a minimal 117list output by checkflist -- it should all be things that 118_should_ be on your lsits, but aren't, i.e. machine-dependent 119binaries, man pages, and include files. 120 121Also, please look through the lists, and tell me if you think 122i've put anything in the wrong place. i think i've 123taken care of all of the machine-dependence bugaboos, by 124doing it for the N architectures, but i'm not _sure_... 8-) 125 126 127thanks, 128 129chris 130 131