source: trunk/doc/third-party @ 22077

Revision 22077, 18.3 KB checked in by ghudson, 19 years ago (diff)
Add libao.
RevLine 
[8975]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
[9117]4of third.  There are also some notes at the end of this file on how we
5deal with building third-party software.
[8975]6
7Third-party stuff not under third
8---------------------------------
9
[13834]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
[13835]18        * packs/build/autoconf/
19
20                The files in this directory are copied from
21                third/autoconf and used by do.sh.
22
[8975]23        * packs/config/named.root
24
[12903]25                This is a copy of the named.root file available at
[12558]26                rs.internic.net:/domain/named.root.
[8975]27
[8992]28        * packs/config/Dash.fallback
29
30                A fallback copy of
[9871]31                /afs/athena.mit.edu/system/config/dash/Dash.menus for
32                when the master copy is inaccessible.  This should be
[8992]33                updated at release time.
34
[13834]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
[11771]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
[9990]47        * Modified operating system files
[9483]48
[9990]49                We keep some modified configuration files from the
[12551]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:
[9483]53
[12551]54                Solaris files in packs/config:
[9990]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
[12551]70                Solaris files in packs/maint:
[9990]71
72                nfs.client      /etc/init.d/nfs.client
73                rpc             /etc/init.d/rpc
74
[12551]75                IRIX files in packs/config:
[9990]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
[12551]87                IRIX files in packs/maint:
[9990]88
89                network         /etc/init.d/network
90
[8975]91Distribution sites for software under third
92-------------------------------------------
93
[20062]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
[21099]171  hicolor-icon-theme    http://freedesktop.org/Software/icon-theme/releases/
[20384]172  ifplugd               http://0pointer.de/lennart/projects/ifplugd/
[20062]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
[22077]182  libao                 http://www.xiph.org/ao/
[20062]183  libart_lgpl           ftp.gnome.org:pub/gnome/sources/libart_lgpl
184  libbonobo             ftp.gnome.org:pub/gnome/sources/libbonobo
185  libbonoboui           ftp.gnome.org:pub/gnome/sources/libbonoboui
[20384]186  libdaemon             http://0pointer.de/lennart/projects/libdaemon/
[20062]187  libgail-gnome         ftp.gnome.org:pub/gnome/sources/libgail-gnome
188  libghttp              ftp.gnome.org:pub/gnome/sources/libghttp
189  libglade              ftp.gnome.org:pub/gnome/sources/libglade
190  libglade2             ftp.gnome.org:pub/gnome/sources/libglade
191  libgnome              ftp.gnome.org:pub/gnome/sources/libgnome
192  libgnomecanvas        ftp.gnome.org:pub/gnome/sources/libgnomecanvas
193  libgnomeprint         ftp.gnome.org:pub/gnome/sources/libgnomeprint
194  libgnomeprintui       ftp.gnome.org:pub/gnome/sources/libgnomeprintui
195  libgnomeui            ftp.gnome.org:pub/gnome/sources/libgnomeui
196  libgtkhtml            ftp.gnome.org:pub/gnome/sources/libgtkhtml
197  libgtop               ftp.gnome.org:pub/gnome/sources/libgtop
198  libiconv              ftp.gnu.org:pub/gnu/libiconv
199  libIDL                ftp.gnome.org:pub/gnome/sources/libIDL
200  libole2               ftp.gnome.org:pub/gnome/sources/libole2
201  libpng                swrinde.nde.swri.edu:pub/png/src
202  librep                librep.sourceforge.net:pub/librep
203  librsvg               ftp.gnome.org:pub/gnome/sources/librsvg
204  libsoup               ftp.gnome.org:pub/gnome/sources/libsoup
205  libungif              prtr-13.ucsc.edu:pub/libungif
206  libwnck               ftp.gnome.org:pub/gnome/sources/libwnck
207  libxml                ftp.gnome.org:pub/gnome/sources/libxml
208  libxml2               ftp.gnome.org:pub/gnome/sources/libxml
209  libxslt               ftp.gnome.org:pub/gnome/sources/libxslt
210  libzvt                ftp.gnome.org:pub/gnome/sources/libzvt
211  linc                  ftp.gnome.org:pub/gnome/sources/linc
212  look                  From NetBSD (ftp.netbsd.org), usr.bin/look
213  lprng                 ftp.astart.com:pub/LPRng; see below
214  m4                    ftp.gnu.org:pub/gnu/m4
215  mdoc                  From NetBSD (ftp.netbsd.org), share/tmac
216  medusa                ftp.gnome.org:pub/gnome/sources/medusa
217  metacity              ftp.gnome.org:pub/gnome/sources/metacity
218  mingetty              ftp.gnome.org:pub/gnome/sources/mingetty
219  mozilla               ftp.mozilla.org:pub/mozilla.org/mozilla/releases
220  nautilus              ftp.gnome.org:pub/gnome/sources/nautilus
221  nautilus-media        ftp.gnome.org:pub/gnome/sources/nautilus-media
222  nmh                   ftp.math.gatech.edu:pub/nmh
223  nvi                   http://www.bostic.com/vi/
224  oaf                   ftp.gnome.org:pub/gnome/sources/oaf
225  openafs               http://www.openafs.org/release
226  openmotif             http://www.opengroup.org/openmotif
227  openssh               ftp.openbsd.org:pub/OpenBSD/OpenSSH
228  openssl               ftp.openssl.org:source
229  ORBit                 ftp.gnome.org:pub/gnome/sources/ORBit
230  ORBit2                ftp.gnome.org:pub/gnome/sources/ORBit2
231  pango                 ftp.gnome.org:pub/gnome/sources/pango
232  patch                 ftp.gnu.org:pub/gnu/patch
233  pcre                  ftp.sourceforge.net:pub/sourceforge/pcre
234  perl                  ftp.cpan.org:pub/CPAN/src
[21087]235  perl-xml-parser       ftp.cpan.org:pub/CPAN/authors/id/C/CO/COOPERCL
[20062]236  pine                  ftp.cac.washington.edu:pine
237                        ftp.cac.washington.edu:mail/kerberos4-patches.tar.Z
238  pkgconfig             http://www.freedesktop.org/software/pkgconfig.html
239  popt                  ftp.rpm.org:pub/rpm/dist/rpm-4.0.x
240  rcs                   ftp.gnu.org:pub/gnu/rcs
241  read-edid             http://web.onetel.net.uk/~elephant/john/programs\
242                        /linux/read-edid/
243  readline              ftp.gnu.org:pub/gnu/readline
244  redhat-fonts          See README file contained within
245  rep-gtk               rep-gtk.sourceforge.net:pub/rep-gtk
246  rpm                   ftp.rpm.org:pub/rpm/dist
247  rs                    From NetBSD (ftp.netbsd.org), usr.bin/rs
248  sawfish               sawmill.sourceforge.net:pub/sawmill
249  scrollkeeper          ftp.gnome.org:pub/gnome/sources/scrollkeeper
250  sed                   ftp.gnu.org:pub/gnu/sed
251  sendmail*             ftp.sendmail.org:pub/sendmail
252  soup                  ftp.gnome.org:pub/gnome/sources/soup
253  ssh*                  ftp.cs.hut.fi:pub/ssh
254  startup-notification  ftp.gnome.org:pub/gnome/sources/startup-notification
255  sysinfo               http://www.magnicomp.com/
256  talk                  From NetBSD (ftp.netbsd.org)
257                        usr.bin/talk goes in the talk subdirectory
258                        libexec/talkd goes in the talkd subdirectory
259                        protocols/talkd.h is from include/protocols,
260                         with some modifications for portability.
261  tcp_wrappers*         ftp.porcupine.org:/pub/security
262  tcsh                  ftp.astron.com:pub/tcsh
263  tetex                 ctan.tug.org:tex-archive/systems/unix/teTeX
264  texinfo               ftp.gnu.org:pub/gnu/texinfo
265  tiff                  ftp.remotesensing.org:pub/libtiff
266  top                   ftp.groupsys.com:pub/top
267  traceroute            ftp.ee.lbl.gov (top level)
268  transcript            From Adobe
269  vte                   ftp.gnome.org:pub/gnome/sources/vte
270  wcl                   ftp.x.org:contrib/devel_tools
271                        (seems to have disappeared; older versoins than
272                        what we have are available in R5contrib)
273  whois                 From NetBSD (ftp.netbsd.org), usr.bin/whois
274  x11-ssh-askpass       http://www.pobox.com/~jmknoble/software/x11-ssh-askpass
275  x3270                 ftp.x.org:contrib/applications
276  xalf                  http://www.lysator.liu.se/~astrand/projects/xalf/
277  xmh                   From X11R5
278  xml-i18n-tools        ftp.gnome.org:pub/gnome/sources/xml-18n-tools
279  xntp                  ftp.udel.edu:pub/ntp/ntp4
280  xpm                   ftp.x.org:contrib/libraries
281  xscreensaver          http://www.jwz.org/xscreensaver/
282  yelp                  ftp.gnome.org:pub/gnome/sources/yelp
283  zlib                  ftp.info-zip.org:pub/infozip/zlib
[9117]284
[12557]285PGP Signatures
286--------------
287
288The (*)ed packages above come PGP-signed. Note that some packages have
289signatures of the .tar.gz files, and others have signatures of the .tar
290files themselves even though you can only download the .tar.gz files.
291
292Local copies of the PGP signing keys, are kept in doc/pgpkeys. You can
293add them to your PGP keyring by doing:
294
295        pgp -ka pgpkeys [PGP 2.6]
296        pgpk -a pgpkeys [PGP 5]
297
298And you can verify the signature of a package with
299
300        pgp sigfile  [PGP 2.6]
301        pgpv sigfile [PGP 5]
302
303(You will be prompted for the name of the file to compare the
304signature against.)
305
[9681]306AFS Binaries
307------------
308
309AFS binaries are placed under arch/<architecture name> for each
310architecture.  For each platform, you should do an import of the
311"include" and "lib" directories of the dest tree, using the vendor tag
312"transarc" and a release tag like "afs-3_4a_patches_2".  For "lib",
[16129]313you will have to use the options "-kb -I \!".  At the top level, you
314should have afsd, fs, tokens, unlog, and possibly afs.rc; we don't
315bother with "cvs import" for these files.  You will also need the
316kernel module itself, which varies per platform.
[9681]317
[12505]318LPRng
319-----
320
321We import three packages: the LPRng sources themselves
322(LPRng/LPRng-x.tgz) into third/lprng/lprng, the LPRng documentation
323(LPRng/LPRng_DOC-x.tgz) into third/lprng/doc, and the ifhp filter
[14039]324(FILTERS/ifhp-x.tgz) into third/lprng/ifhp.
[12505]325
[17048]326Emacs
327-----
[14039]328
329LEIM (Library of Emacs Input Methods) is built as part of Emacs, but
[15431]330distributed separately.  Untar both emacs and leim (leim will untar
331into emacs-xx.yy/leim) and import them both with one command.
[14039]332
[17048]333Emacs is distributed with .elc files.  When you import new versions of
334emacs, do so with the "-I \!" option to prevent CVS from ignoring
335these files.  .elc files should be tagged as binary, using "cvs admin
336-kb", although that's not terribly critical to Unix CVS clients
337(except for the vc-mode files).
338
339Elisp source related to vc-mode needs to be set to "-ko" mode to
340prevent expansion of those keywords.  Use "cvs admin -ko" on these
341files if they move or if new ones are added.
342
[9117]343Third-party build systems
344-------------------------
345
346There are two avenues one can take for building third-party software:
347
348        * You can use the native build system.
349
350        * You can declare the native build system a loss, and use one
351          of the two Athena build systems described in the file
352          "build-system" in this directory.  This option is not
353          preferred, but is necessary in cases like afsbin (where we
354          are simply installing target files) or software imported
355          from NetBSD.
356
357In a some cases, the native build system may already conform to the
358Athena build system (a configure script which needs no special options
[13629]359for the Athena environment besides those given in our config.site
360file), but generally you will have to write either a configure.athena
361or a Makefile.athena file specifying how to build and install the
362program.
[9117]363
[12978]364configure.athena is used when the package builds and installs
365normally, but needs to have extra options passed to configure (or has
366a configure script which isn't named "configure", or needs additional
367steps performed before or after the configure script).
368
369Makefile.athena is needed if the package needs to do anything unusual
370at any of the other steps.  A Makefile.athena must have the following
371targets:
372
[10786]373        prepare         Prepare to build the source tree
[9156]374        clean           Remove files generated by the all target
375        all             Generate all automatically build files
376        check           Perform automatic tests, if any
377        install         Install the software in $SRVD.
[9117]378
[9156]379A Makefile.athena file may rely on the following environment variables
380(it is most robust to use `"$$VARNAME"' instead of `"${VARNAME}"' in
381rules to get the value of such variables):
[9117]382
[9156]383        ATHENA_SYS      Architecture name for this system
384        HOSTTYPE        Platform name for this system
385        SRVD            Install destination directory (e.g. /srvd)
[10295]386        SOURCE          Source tree (e.g. /mit/source)
[10782]387        COMPILER        Appropriate compiler/linker for this system
[9174]388        CONFIGDIR       Location of Athena Imake templates
[9156]389        XCONFIGDIR      Location of X-style Imake templates
[10409]390        ATHTOOLROOT     Root of installed Athena tree
[9156]391
392Following is a sample Makefile.athena file, used to build a package
393which uses an X-style Imakefile:
394
395        # $Id: $
396
397        SHELL=/bin/sh
398
[10787]399        prepare:
[9156]400                imake "-I$$XCONFIGDIR" -DUseInstalled "-DSRCDIR=$$SOURCE"
401                ${MAKE} Makefiles
402
403        clean:
404                ${MAKE} clean
405
406        all:
407                ${MAKE} includes depend all
408
409        check:
410
411        install:
412                ${MAKE} install DESTDIR="$$SRVD"
Note: See TracBrowser for help on using the repository browser.