source: trunk/doc/third-party @ 21099

Revision 21099, 18.3 KB checked in by ghudson, 20 years ago (diff)
Add location for hicolor-icon-theme.
Line 
1For the most part, third-party software is easy to locate because it
2is found in the third hierarchy.  Nevertheless, it's a good idea to
3keep track of what we get from outside, especially for things outside
4of third.  There are also some notes at the end of this file on how we
5deal with building third-party software.
6
7Third-party stuff not under third
8---------------------------------
9
10        * athena/etc/xlogin/bitmaps/menu16
11
12                This is from the X11 release; it probably never
13                changes.  We have a copy of it here because xlogin
14                needs all its bitmaps locally in /etc/athena/login,
15                and fetching it out of the vendor X distribution at
16                build time is contrary to principles.
17
18        * packs/build/autoconf/
19
20                The files in this directory are copied from
21                third/autoconf and used by do.sh.
22
23        * packs/config/named.root
24
25                This is a copy of the named.root file available at
26                rs.internic.net:/domain/named.root.
27
28        * packs/config/Dash.fallback
29
30                A fallback copy of
31                /afs/athena.mit.edu/system/config/dash/Dash.menus for
32                when the master copy is inaccessible.  This should be
33                updated at release time.
34
35        * packs/dotfiles/arch/sgi_*/cshrc
36
37                A line to set XUSERFILESEARCHPATH in .cshrc is derived
38                from a piece of the IRIX file /var/X11/xdm/Xsession.dt.
39
40        * packs/dotfiles/{README.mail,dot.cshrc,dot.login,dot.logout,
41                dot.mh_profile,welcome}
42
43                These should be kept in sync with the copies on
44                moira's local disk (/moira/dotfiles/*), which are
45                what actually get copied into new home directories.
46
47        * Modified operating system files
48
49                We keep some modified configuration files from the
50                operating systems we use in the os and arch
51                subdirectories of packs/config and packs/maint.
52                The files and their origins are:
53
54                Solaris files in packs/config:
55
56                Athena4.kt      /usr/openwin/share/etc/keytables/US4.kt.Z
57                Athena5.kt      /usr/openwin/share/etc/keytables/US_UNIX5.kt.Z
58                devlink.tab     /etc/devlink.tab
59                inetd.conf      /etc/inet/inetd.conf
60                inittab         /etc/inittab
61                logindevperm    /etc/logindevperm
62                keytable.map    /usr/openwin/share/etc/keytables/keytable.map
63                minor_perm      /etc/minor_perm
64                name_to_sysnum  /etc/name_to_sysnum
65                nsswitch.conf   /etc/nsswitch.conf
66                services        /etc/inet/services
67                su              /etc/default/su
68                system          /etc/system
69
70                Solaris files in packs/maint:
71
72                nfs.client      /etc/init.d/nfs.client
73                rpc             /etc/init.d/rpc
74
75                IRIX files in packs/config:
76
77                4DWm            /usr/lib/X11/app-defaults/4DWm
78                Mwm             /usr/lib/X11/app-defaults/Mwm
79                Toolchest       /usr/lib/X11/app-defaults/Toolchest
80                crontab.root    /var/spool/cron/crontabs/root
81                fonts.alias     /usr/lib/X11/fonts/100dpi/fonts.alias
82                fonts.dir       /usr/lib/X11/fonts/100dpi/fonts.dir
83                inetd.conf      /etc/inetd.conf
84                services        /etc/services
85                system.chestrc  /usr/lib/X11/system.chestrc
86
87                IRIX files in packs/maint:
88
89                network         /etc/init.d/network
90
91Distribution sites for software under third
92-------------------------------------------
93
94  acme                  ftp.gnome.org:pub/gnome/sources/acme
95  afs-krb5              ftp.cmf.nrl.navy.mil:pub/kerberos5
96  afsbin                See below.
97  ammonite              ftp.gnome.org:pub/gnome/sources/ammonite
98  aspell                ftp.gnu.org:pub/gnu/aspell
99  aspell-dict           ftp.gnu.org:pub/gnu/aspell
100  at-spi                ftp.gnome.org:pub/gnome/sources/at-spi
101  atk                   ftp.gnome.org:pub/gnome/sources/atk
102  audiofile             ftp.gnome.org:pub/gnome/sources/audiofile
103  autoconf              ftp.gnu.org:pub/gnu/autoconf
104  bash                  ftp.gnu.org:pub/gnu/bash
105  bind                  ftp.isc.org:isc/bind/src
106  binutils              ftp.gnu.org:pub/gnu/binutils
107  bison                 ftp.gnu.org:pub/gnu/bison
108  bonobo                ftp.gnome.org:pub/gnome/sources/bonobo
109  bonobo-activation     ftp.gnome.org:pub/gnome/sources/bonobo-activation
110  bonobo-conf           ftp.gnome.org:pub/gnome/sources/bonobo
111  bug-buddy             ftp.gnome.org:pub/gnome/sources/bug-buddy
112  bzip2                 sources.redhat.com:pub/bzip2
113  control-center        ftp.gnome.org:pub/gnome/sources/control-center
114  cyrus-imapd           ftp.andrew.cmu.edu:pub/cyrus-mail
115  cyrus-sasl            ftp.andrew.cmu.edu:pub/cyrus-mail
116  db                    http://www.sleepycat.com/download.html
117  diffutils             ftp.gnu.org:pub/gnu/diffutils
118  eel                   ftp.gnome.org:pub/gnome/sources/eel
119  emacs                 ftp.gnu.org:pub/gnu/emacs; see below
120  enscript              ftp.gnu.org:pub/gnu/enscript
121  eog                   ftp.gnome.org:pub/gnome/sources/eog
122  esound                ftp.gnome.org:pub/gnome/sources/esound
123  evolution             ftp.gnome.org:pub/gnome/sources/evolution
124  expat                 http://sourceforge.net/projects/expat/
125  fcpackage             http://fontconfig.org/
126  file-roller           ftp.gnome.org:pub/gnome/sources/file-roller
127  findutils             ftp.gnu.org:pub/gnu/findutils
128  flex                  ftp.gnu.org:pub/gnu/non-gnu/flex
129  freetype              ftp.freetype.org:pub/freetype2
130  gail                  ftp.gnome.org:pub/gnome/sources/gail
131  gal                   ftp.gnome.org:pub/gnome/sources/gal
132  gal2                  ftp.gnome.org:pub/gnome/sources/gal
133  gcc                   ftp.gnu.org:pub/gnu/gcc
134  GConf                 ftp.gnome.org:pub/gnome/sources/GConf
135  GConf2                ftp.gnome.org:pub/gnome/sources/GConf
136  gconf-editor          ftp.gnome.org:pub/gnome/sources/gconf-editor
137  gdbm                  ftp.gnu.org:pub/gnu/gdbm
138  gdk-pixbuf            ftp.gnome.org:pub/gnome/sources/gdk-pixbuf
139  gedit                 ftp.gnome.org:pub/gnome/sources/gedit
140  gettext               ftp.gnu.org:pub/gnu/gettext
141  ggv                   ftp.gnome.org:pub/gnome/sources/ggv
142  glib                  ftp.gtk.org:pub/gtk
143  glib2                 ftp.gtk.org:pub/gtk
144  gmake                 ftp.gnu.org:pub/gnu/make
145  gmp                   ftp.gnu.org:pub/gnu/gmp
146  gnome-applets         ftp.gnome.org:pub/gnome/sources/gnome-applets
147  gnome-core            ftp.gnome.org:pub/gnome/sources/gnome-core
148  gnome-desktop         ftp.gnome.org:pub/gnome/sources/gnome-desktop
149  gnome-icon-theme      ftp.gnome.org:pub/gnome/sources/gnome-icon-theme
150  gnome-libs            ftp.gnome.org:pub/gnome/sources/gnome-libs
151  gnome-media           ftp.gnome.org:pub/gnome/sources/gnome-media
152  gnome-mime-data       ftp.gnome.org:pub/gnome/sources/gnome-mime-data
153  gnome-panel           ftp.gnome.org:pub/gnome/sources/gnome-panel
154  gnome-print           ftp.gnome.org:pub/gnome/sources/gnome-print
155  gnome-spell           ftp.gnome.org:pub/gnome/sources/gnome-spell
156  gnome-system-monitor  ftp.gnome.org:pub/gnome/sources/gnome-spell
157  gnome-terminal        ftp.gnome.org:pub/gnome/sources/gnome-terminal
158  gnome-themes          ftp.gnome.org:pub/gnome/sources/gnome-themes
159  gnome-utils           ftp.gnome.org:pub/gnome/sources/gnome-utils
160  gnome-vfs             ftp.gnome.org:pub/gnome/sources/gnome-vfs
161  gnome-vfs2            ftp.gnome.org:pub/gnome/sources/gnome-vfs
162  gnome2-user-docs      ftp.gnome.org:pub/gnome/sources/gnome2-user-docs
163  gst-plugins           ftp.gnome.org:pub/gnome/sources/gst-plugsin
164  gstreamer             ftp.gnome.org:pub/gnome/sources/gstreamer
165  gtk                   ftp.gtk.org:pub/gtk
166  gtk-engines           ftp.gtk.org:pub/gtk
167  gtk-thinice-engine    ftp.gtk.org:pub/gtk
168  gtk2                  ftp.gtk.org:pub/gtk
169  gtkhtml               ftp.gnome.org:pub/gnome/sources/gtkhtml
170  gtkhtml3              ftp.gnome.org:pub/gnome/sources/gtkhtml
171  hicolor-icon-theme    http://freedesktop.org/Software/icon-theme/releases/
172  ifplugd               http://0pointer.de/lennart/projects/ifplugd/
173  imlib                 (Formerly www.rasterman.com; imlib 1 is dead now)
174  inetd                 From NetBSD (ftp.netbsd.org), usr.sbin/inetd
175  intlfonts             ftp.gnu.org:pub/gnu/intlfonts
176  ispell                ftp.cs.ucla.edu:pub/ispell-3.1
177  jot                   From NetBSD (ftp.netbsd.org), usr.bin/jot
178  jpeg                  ftp://ftp.uu.net/graphics/jpeg/
179  kermit                http://www.columbia.edu/kermit
180  krb5*                 http://web.mit.edu/network/kerberos-form.html
181  lam                   From NetBSD (ftp.netbsd.org), usr.bin/lam
182  libart_lgpl           ftp.gnome.org:pub/gnome/sources/libart_lgpl
183  libbonobo             ftp.gnome.org:pub/gnome/sources/libbonobo
184  libbonoboui           ftp.gnome.org:pub/gnome/sources/libbonoboui
185  libdaemon             http://0pointer.de/lennart/projects/libdaemon/
186  libgail-gnome         ftp.gnome.org:pub/gnome/sources/libgail-gnome
187  libghttp              ftp.gnome.org:pub/gnome/sources/libghttp
188  libglade              ftp.gnome.org:pub/gnome/sources/libglade
189  libglade2             ftp.gnome.org:pub/gnome/sources/libglade
190  libgnome              ftp.gnome.org:pub/gnome/sources/libgnome
191  libgnomecanvas        ftp.gnome.org:pub/gnome/sources/libgnomecanvas
192  libgnomeprint         ftp.gnome.org:pub/gnome/sources/libgnomeprint
193  libgnomeprintui       ftp.gnome.org:pub/gnome/sources/libgnomeprintui
194  libgnomeui            ftp.gnome.org:pub/gnome/sources/libgnomeui
195  libgtkhtml            ftp.gnome.org:pub/gnome/sources/libgtkhtml
196  libgtop               ftp.gnome.org:pub/gnome/sources/libgtop
197  libiconv              ftp.gnu.org:pub/gnu/libiconv
198  libIDL                ftp.gnome.org:pub/gnome/sources/libIDL
199  libole2               ftp.gnome.org:pub/gnome/sources/libole2
200  libpng                swrinde.nde.swri.edu:pub/png/src
201  librep                librep.sourceforge.net:pub/librep
202  librsvg               ftp.gnome.org:pub/gnome/sources/librsvg
203  libsoup               ftp.gnome.org:pub/gnome/sources/libsoup
204  libungif              prtr-13.ucsc.edu:pub/libungif
205  libwnck               ftp.gnome.org:pub/gnome/sources/libwnck
206  libxml                ftp.gnome.org:pub/gnome/sources/libxml
207  libxml2               ftp.gnome.org:pub/gnome/sources/libxml
208  libxslt               ftp.gnome.org:pub/gnome/sources/libxslt
209  libzvt                ftp.gnome.org:pub/gnome/sources/libzvt
210  linc                  ftp.gnome.org:pub/gnome/sources/linc
211  look                  From NetBSD (ftp.netbsd.org), usr.bin/look
212  lprng                 ftp.astart.com:pub/LPRng; see below
213  m4                    ftp.gnu.org:pub/gnu/m4
214  mdoc                  From NetBSD (ftp.netbsd.org), share/tmac
215  medusa                ftp.gnome.org:pub/gnome/sources/medusa
216  metacity              ftp.gnome.org:pub/gnome/sources/metacity
217  mingetty              ftp.gnome.org:pub/gnome/sources/mingetty
218  mozilla               ftp.mozilla.org:pub/mozilla.org/mozilla/releases
219  nautilus              ftp.gnome.org:pub/gnome/sources/nautilus
220  nautilus-media        ftp.gnome.org:pub/gnome/sources/nautilus-media
221  nmh                   ftp.math.gatech.edu:pub/nmh
222  nvi                   http://www.bostic.com/vi/
223  oaf                   ftp.gnome.org:pub/gnome/sources/oaf
224  openafs               http://www.openafs.org/release
225  openmotif             http://www.opengroup.org/openmotif
226  openssh               ftp.openbsd.org:pub/OpenBSD/OpenSSH
227  openssl               ftp.openssl.org:source
228  ORBit                 ftp.gnome.org:pub/gnome/sources/ORBit
229  ORBit2                ftp.gnome.org:pub/gnome/sources/ORBit2
230  pango                 ftp.gnome.org:pub/gnome/sources/pango
231  patch                 ftp.gnu.org:pub/gnu/patch
232  pcre                  ftp.sourceforge.net:pub/sourceforge/pcre
233  perl                  ftp.cpan.org:pub/CPAN/src
234  perl-xml-parser       ftp.cpan.org:pub/CPAN/authors/id/C/CO/COOPERCL
235  pine                  ftp.cac.washington.edu:pine
236                        ftp.cac.washington.edu:mail/kerberos4-patches.tar.Z
237  pkgconfig             http://www.freedesktop.org/software/pkgconfig.html
238  popt                  ftp.rpm.org:pub/rpm/dist/rpm-4.0.x
239  rcs                   ftp.gnu.org:pub/gnu/rcs
240  read-edid             http://web.onetel.net.uk/~elephant/john/programs\
241                        /linux/read-edid/
242  readline              ftp.gnu.org:pub/gnu/readline
243  redhat-fonts          See README file contained within
244  rep-gtk               rep-gtk.sourceforge.net:pub/rep-gtk
245  rpm                   ftp.rpm.org:pub/rpm/dist
246  rs                    From NetBSD (ftp.netbsd.org), usr.bin/rs
247  sawfish               sawmill.sourceforge.net:pub/sawmill
248  scrollkeeper          ftp.gnome.org:pub/gnome/sources/scrollkeeper
249  sed                   ftp.gnu.org:pub/gnu/sed
250  sendmail*             ftp.sendmail.org:pub/sendmail
251  soup                  ftp.gnome.org:pub/gnome/sources/soup
252  ssh*                  ftp.cs.hut.fi:pub/ssh
253  startup-notification  ftp.gnome.org:pub/gnome/sources/startup-notification
254  sysinfo               http://www.magnicomp.com/
255  talk                  From NetBSD (ftp.netbsd.org)
256                        usr.bin/talk goes in the talk subdirectory
257                        libexec/talkd goes in the talkd subdirectory
258                        protocols/talkd.h is from include/protocols,
259                         with some modifications for portability.
260  tcp_wrappers*         ftp.porcupine.org:/pub/security
261  tcsh                  ftp.astron.com:pub/tcsh
262  tetex                 ctan.tug.org:tex-archive/systems/unix/teTeX
263  texinfo               ftp.gnu.org:pub/gnu/texinfo
264  tiff                  ftp.remotesensing.org:pub/libtiff
265  top                   ftp.groupsys.com:pub/top
266  traceroute            ftp.ee.lbl.gov (top level)
267  transcript            From Adobe
268  vte                   ftp.gnome.org:pub/gnome/sources/vte
269  wcl                   ftp.x.org:contrib/devel_tools
270                        (seems to have disappeared; older versoins than
271                        what we have are available in R5contrib)
272  whois                 From NetBSD (ftp.netbsd.org), usr.bin/whois
273  x11-ssh-askpass       http://www.pobox.com/~jmknoble/software/x11-ssh-askpass
274  x3270                 ftp.x.org:contrib/applications
275  xalf                  http://www.lysator.liu.se/~astrand/projects/xalf/
276  xmh                   From X11R5
277  xml-i18n-tools        ftp.gnome.org:pub/gnome/sources/xml-18n-tools
278  xntp                  ftp.udel.edu:pub/ntp/ntp4
279  xpm                   ftp.x.org:contrib/libraries
280  xscreensaver          http://www.jwz.org/xscreensaver/
281  yelp                  ftp.gnome.org:pub/gnome/sources/yelp
282  zlib                  ftp.info-zip.org:pub/infozip/zlib
283
284PGP Signatures
285--------------
286
287The (*)ed packages above come PGP-signed. Note that some packages have
288signatures of the .tar.gz files, and others have signatures of the .tar
289files themselves even though you can only download the .tar.gz files.
290
291Local copies of the PGP signing keys, are kept in doc/pgpkeys. You can
292add them to your PGP keyring by doing:
293
294        pgp -ka pgpkeys [PGP 2.6]
295        pgpk -a pgpkeys [PGP 5]
296
297And you can verify the signature of a package with
298
299        pgp sigfile  [PGP 2.6]
300        pgpv sigfile [PGP 5]
301
302(You will be prompted for the name of the file to compare the
303signature against.)
304
305AFS Binaries
306------------
307
308AFS binaries are placed under arch/<architecture name> for each
309architecture.  For each platform, you should do an import of the
310"include" and "lib" directories of the dest tree, using the vendor tag
311"transarc" and a release tag like "afs-3_4a_patches_2".  For "lib",
312you will have to use the options "-kb -I \!".  At the top level, you
313should have afsd, fs, tokens, unlog, and possibly afs.rc; we don't
314bother with "cvs import" for these files.  You will also need the
315kernel module itself, which varies per platform.
316
317LPRng
318-----
319
320We import three packages: the LPRng sources themselves
321(LPRng/LPRng-x.tgz) into third/lprng/lprng, the LPRng documentation
322(LPRng/LPRng_DOC-x.tgz) into third/lprng/doc, and the ifhp filter
323(FILTERS/ifhp-x.tgz) into third/lprng/ifhp.
324
325Emacs
326-----
327
328LEIM (Library of Emacs Input Methods) is built as part of Emacs, but
329distributed separately.  Untar both emacs and leim (leim will untar
330into emacs-xx.yy/leim) and import them both with one command.
331
332Emacs is distributed with .elc files.  When you import new versions of
333emacs, do so with the "-I \!" option to prevent CVS from ignoring
334these files.  .elc files should be tagged as binary, using "cvs admin
335-kb", although that's not terribly critical to Unix CVS clients
336(except for the vc-mode files).
337
338Elisp source related to vc-mode needs to be set to "-ko" mode to
339prevent expansion of those keywords.  Use "cvs admin -ko" on these
340files if they move or if new ones are added.
341
342Third-party build systems
343-------------------------
344
345There are two avenues one can take for building third-party software:
346
347        * You can use the native build system.
348
349        * You can declare the native build system a loss, and use one
350          of the two Athena build systems described in the file
351          "build-system" in this directory.  This option is not
352          preferred, but is necessary in cases like afsbin (where we
353          are simply installing target files) or software imported
354          from NetBSD.
355
356In a some cases, the native build system may already conform to the
357Athena build system (a configure script which needs no special options
358for the Athena environment besides those given in our config.site
359file), but generally you will have to write either a configure.athena
360or a Makefile.athena file specifying how to build and install the
361program.
362
363configure.athena is used when the package builds and installs
364normally, but needs to have extra options passed to configure (or has
365a configure script which isn't named "configure", or needs additional
366steps performed before or after the configure script).
367
368Makefile.athena is needed if the package needs to do anything unusual
369at any of the other steps.  A Makefile.athena must have the following
370targets:
371
372        prepare         Prepare to build the source tree
373        clean           Remove files generated by the all target
374        all             Generate all automatically build files
375        check           Perform automatic tests, if any
376        install         Install the software in $SRVD.
377
378A Makefile.athena file may rely on the following environment variables
379(it is most robust to use `"$$VARNAME"' instead of `"${VARNAME}"' in
380rules to get the value of such variables):
381
382        ATHENA_SYS      Architecture name for this system
383        HOSTTYPE        Platform name for this system
384        SRVD            Install destination directory (e.g. /srvd)
385        SOURCE          Source tree (e.g. /mit/source)
386        COMPILER        Appropriate compiler/linker for this system
387        CONFIGDIR       Location of Athena Imake templates
388        XCONFIGDIR      Location of X-style Imake templates
389        ATHTOOLROOT     Root of installed Athena tree
390
391Following is a sample Makefile.athena file, used to build a package
392which uses an X-style Imakefile:
393
394        # $Id: $
395
396        SHELL=/bin/sh
397
398        prepare:
399                imake "-I$$XCONFIGDIR" -DUseInstalled "-DSRCDIR=$$SOURCE"
400                ${MAKE} Makefiles
401
402        clean:
403                ${MAKE} clean
404
405        all:
406                ${MAKE} includes depend all
407
408        check:
409
410        install:
411                ${MAKE} install DESTDIR="$$SRVD"
Note: See TracBrowser for help on using the repository browser.