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