$Id: README,v 1.3 1994/12/03 02:11:23 dd Exp $

This is Unix file /public/doc/README.

/public/bin is a directory containing Unix programs supported by a group
of volunteer custodians here at Adobe. /public/bin currently contains such
programs as ispell, Lucid Emacs, Emacs 19, olvwm, tex, dvips, new versions
of gcc and gdb and many others.


USER'S GUIDE:

1. TO USE /public/bin:
   a. add /public/bin to your $path (csh) or $PATH (sh)
   b. add /public/man to your $MANPATH
   c. add /public/lib/X11/%T/%N%S to your $XFILESEARCHPATH

   If your system does not have a /public or /public/bin, ask helpdesk
   to create one for you.  This is the only support ISCF provides for
   /public.

2. TO GET MESSAGES about /public/bin:

   Use your favorite newsreader to read newsgroup:

	adobe.public-software

   If you prefer to receive messages as mail:

	send aliasmgr a message with body:

	subscribe adobe-public-software

3. TO REPORT BUGS IN /public:

   Mail your bug reports and questions to:

	adobe-public-software-bugs

   Be sure to give the name of the machine where you experienced the
   problem, and any other information necessary to reproduce it.

	*************************************************************
	*       ICSF does not provide support for /public/bin       *
	*            Please do NOT send bug reports about           *
	*            /public/bin programs to helpdesk.              *
	*************************************************************

4. If you have a Unix program that you want to share with the whole Unix
   community, you might want to think about becoming a public software
   custodian and placing your program on /public/bin. This effort will not
   work if people do not help. To become a public software custodian,
   contact Jeff Finger.

5. See file /public/bin/README.TXT for a description of the
   programs present.  If you need a program that is not available for
   your system, contact the custodian listed in the file.


POLICY:

	NO NAME CONFLICTS:
	In order for be able to add /public/bin to PATH without
	causing any unforseen effects on the current working environment,
	programs on /public/bin shall not conflict in name those in
	/usr/local/bin, /usr/ucb/bin, /usr/bin, /bin, or other standard
	system directories.

	UPDATING:
	Every attempt will be made to maintain and update /public/bin
	keeping in mind that many people will be depending on this
	directory.

	README.TXT:
	All programs in /public/bin will have an entry in
	/public/bin/README.TXT or be subject to deletion.


NOTABLE FILES AND DIRECTORIES:

/public/bin.orignames
	There is another directory /public/bin.orignames which contains
	names of executables that might conflict with /usr/local/bin
	names. Please note that having /public/bin.orignames on your path can
	change behavior of many things, for example, a "make" of the
	2ps world.

/public/bin/README.TXT
	Contains information about the contents of each /public/bin program.

/public/doc/README
	This file.

/public/doc/*.ps
	Contains manuals for many of the /public/bin programs.

/public/doc/emacs.faq
/public/doc/lemacs.faq
	Frequently asked questions about emacs and lemacs.

/public/doc/showps
	Documentation for Adobe ShowPS and filterps.

/public/doc/MAIL-ARCHIVE
	Archives of the adobe-public-software mailing list.
	Note that mh users can make a link
	ln -s /public/doc/MAIL-ARCHIVE $HOME/Mail/public-software
	this directory and treat it like a regular mh folder
	called +public-software.

/public/doc/BUGS-ARCHIVE
	Archives of the adobe-public-software-bugs mailing list.

/public/doc/CUSTODIAN-MAIL-ARCHIVE.
	Archives of the adobe-public-software-custodians mailing list.

/public/info/*
	Emacs info tree, which is accessed by /public/bin/lemacs and
	/public/bin/emacs-19.


ACKNOWLEDGEMENTS:

Thanks to John Hammond, Jay Morewood, Ron Weaver, and James Woods for
their help.


STATUS:

Configs:
  1. alphaosf1		DEC Alpha AXP, OSF/1 2.0
  2. hppahpux		HP 700 series, HP-UX 9.0
  3. mc68020mach	NeXT 680x0, NeXT Mach 3.2
  4. mc68020sun		Sun-3, SunOS 4.1.1_U1
  5. r2000beirixV	SGI, Irix 5.x
  6. r2000leultrix	DECstation, Ultrix 4.2
  7. rs6000aix		IBM RS6000, AIX 3.2
  8. sparcsolaris	Sun SPARC, SunOS 5.3 (Solaris 2.3)
  9. sparcsun		Sun SPARC, SunOS 4.1.2 (Solaris 1.0)

1 2 3 4 5 6 7 8 9 D Program, Custodian
---------------------------------------------
0 0 0 0 0 1 0 0 1 y MakeTeXPK jfinger
0 0 0 0 0 0 0 0 1 y ad2c jfinger
0 0 0 0 0 1 0 0 1 y afm2tfm jfinger
0 0 0 0 0 0 0 0 1 y attraction jfinger
0 0 0 0 0 1 0 1 1 y b2m jfinger
0 0 0 0 0 0 0 0 1 y b2m-gnuemacs-19.26 jfinger
0 0 0 0 0 1 0 1 1 y bibtex jfinger
0 0 0 0 0 0 0 0 1 y blitspin jfinger
0 0 0 0 0 1 0 1 1 y buildhash jfinger
0 0 0 0 0 1 0 1 0 y c++ jfinger
0 0 0 0 0 0 0 0 1 . c++-2.5.8 jfinger
0 0 0 0 0 S 0 S S y cmmf jfinger
0 0 0 0 0 0 0 1 0 y cmp jfinger
0 0 0 0 0 1 0 1 1 y ctags jfinger
0 0 0 0 0 1 0 0 0 . decstation-gcc jfinger
0 0 0 0 0 0 0 1 0 y diff jfinger
0 0 0 0 0 0 0 1 0 y diff3 jfinger
0 S 0 0 0 0 0 S S y dpsnx.agent caro
0 0 0 0 0 1 0 1 1 y dvicopy jfinger
0 0 0 0 0 1 0 0 1 y dvips jfinger
0 0 0 0 0 1 0 1 1 y dvitype jfinger
0 0 0 0 0 S 0 S S y emacs-19 jfinger
0 0 0 0 0 0 0 0 S . emacs-19.23 jfinger
0 0 0 0 0 1 0 1 1 . emacs-19.25 jfinger
0 0 0 0 0 0 0 0 1 . emacs-19.25.2 jfinger
0 0 0 0 0 1 0 1 1 N emacs-19.28 jfinger
0 0 0 0 0 1 0 1 1 y emacsclient jfinger
0 0 0 0 0 1 0 1 1 y etags jfinger
0 1 0 0 0 0 0 S 1 y execnx caro
S S S S S S S S S y filterpsps jensen
0 0 0 0 0 1 0 1 1 y findaffix jfinger
0 0 0 0 0 S 0 0 S y flex jfinger
0 0 0 0 0 S 0 0 S . flex++ jfinger
0 0 0 0 0 1 0 0 1 . flex-2.4.6 jfinger
0 0 0 0 0 1 0 1 1 y formail dd
0 0 0 0 0 1 0 1 0 y g++ jfinger
0 0 0 0 0 0 0 0 1 . g++-2.5.8 jfinger
0 0 0 0 0 1 0 1 1 . gcc-2.5.8 jfinger
0 0 0 0 0 1 0 0 1 y gcmp jfinger
0 0 0 0 0 1 0 1 1 . gdb-4.12 jfinger
0 0 0 0 0 1 0 0 1 y gdiff jfinger
0 0 0 0 0 1 0 0 1 y gdiff3 jfinger
0 0 0 0 0 1 0 1 1 y gftodvi jfinger
0 0 0 0 0 1 0 1 1 y gftopk jfinger
0 0 0 0 0 1 0 1 1 y gftype jfinger
0 0 0 0 0 S 0 0 S y gm4 jfinger
S 0 0 0 0 S 0 S S y gmake jfinger
0 0 0 0 0 0 0 0 1 N gnuclient jfinger
0 0 0 0 0 0 0 0 1 N gnudoit jfinger
0 0 0 0 0 0 0 0 1 y greynetic jfinger
0 0 0 0 0 1 0 1 1 y gsdiff jfinger
0 0 0 0 0 0 0 0 1 y helix jfinger
S S 0 0 S S S S S y hot-convert dd
0 0 0 0 0 0 0 0 1 y hopalong jfinger
0 0 0 0 0 1 0 1 1 y icombine jfinger
0 0 0 0 0 1 0 1 1 y ijoin jfinger
0 0 0 0 0 1 0 1 1 y inimf jfinger
0 0 0 0 0 1 0 1 1 y initex jfinger
0 0 0 0 0 1 0 1 1 y ispell jfinger
0 0 0 0 0 S 0 S S y latex jfinger
0 0 0 0 0 S 0 S S y lemacs jfinger
0 0 0 0 0 1 0 1 1 . lemacs-19.10 jfinger
0 0 0 0 0 S 0 S S . lemacs-19.9 jfinger
0 1 0 0 0 0 0 S 1 y listnx caro
0 0 0 0 0 1 0 1 1 y lockfile dd
0 S S 0 0 S S S S y lsof dd
0 0 0 0 0 1 0 0 1 . m4-1.1 jfinger
0 0 0 0 0 1 0 1 1 y mailstat dd
1 0 0 0 0 1 0 1 1 . make-3.70 jfinger
0 0 0 0 0 1 0 1 1 . make-3.71 jfinger
0 0 0 0 0 S 0 S S y mf jfinger
0 0 0 0 0 1 0 1 1 y mft jfinger
0 0 0 0 0 1 0 1 1 y munchlist jfinger
1 1 0 0 1 0 1 1 1 y netscape dd
0 0 0 0 0 0 0 0 1 y noseguy jfinger
0 0 0 0 0 0 0 S S y olvwm dd
0 0 0 0 0 0 0 0 1 . olvwm-3.3 dd
0 0 0 0 0 1 0 1 1 y patgen jfinger
0 0 0 0 0 1 0 1 1 y pktogf jfinger
0 0 0 0 0 1 0 1 1 y pktype jfinger
0 0 0 0 0 1 0 1 1 y pltotf jfinger
0 0 0 0 0 1 0 1 1 y pooltype jfinger
0 0 0 0 0 1 0 1 1 y procmail dd
0 0 0 0 0 1 0 1 0 y protoize jfinger
0 0 0 0 0 0 0 0 1 . protoize-2.5.8 jfinger
S S S S S S S S S y public_config dd
0 0 0 0 0 0 0 0 1 y pyro jfinger
0 0 0 0 0 0 0 0 1 y qix jfinger
0 0 0 0 0 1 0 1 1 y rcs-checkin jfinger
0 0 0 0 0 0 0 0 1 y rocks jfinger
0 0 0 0 0 0 0 0 1 y rorschach jfinger
S S 0 0 S S S S S y showps jensen
0 0 0 0 0 1 0 1 1 y sq jfinger
0 0 0 0 0 0 0 1 1 y strace dd
0 0 0 S 0 0 0 S S y suntype dd
0 0 0 0 0 1 0 1 1 y sxpm jfinger
0 0 0 0 0 1 0 1 1 y tangle jfinger
0 0 0 0 0 S 0 S S y tex jfinger
0 0 0 0 0 S 0 S S y texinfo jfinger
0 0 0 0 0 1 0 1 1 y tftopl jfinger
0 S 0 0 0 S 0 S S y top dd
0 0 0 0 0 1 0 1 1 y tryaffix jfinger
0 0 0 0 0 1 0 1 0 y unprotoize jfinger
0 0 0 0 0 0 0 0 1 . unprotoize-2.5.8 jfinger
0 0 0 0 0 1 0 1 1 y unsq jfinger
0 0 0 0 0 1 0 1 1 y vftovp jfinger
0 0 0 0 0 1 0 1 1 y virmf jfinger
0 0 0 0 0 1 0 1 1 y virtex jfinger
0 0 0 0 0 1 0 1 1 y vptovf jfinger
0 0 0 0 0 1 0 1 1 y weave jfinger
0 1 0 0 0 1 0 1 1 N workman dd
0 1 0 0 0 1 0 1 1 y xautolock dd
0 0 0 0 0 1 0 S 1 y xcb dd
S S S S S S S S S y xcolorize dd
0 0 0 0 0 0 0 0 S N xemacs jfinger
0 0 0 0 0 0 0 0 1 N xemacs-19.11 jfinger
0 0 0 0 0 0 0 0 1 y xfishtank jfinger
0 S 0 0 0 S 0 S S y xkeycaps dd
0 1 0 0 0 1 0 0 1 . xkeycaps-2.11 dd
0 0 0 0 0 0 0 0 1 y xroger jfinger
0 1 0 0 0 1 0 1 1 y xrunclient dd
0 0 0 0 0 0 0 0 1 y xscreensaver jfinger
0 0 0 0 0 0 0 0 1 y xscreensaver-command jfinger
0 1 0 0 0 1 0 S 1 y xwit dd

Conflicts with /usr/local/bin (may vary on some systems):
    r2000leultrix /usr/local/bin/ctags
    r2000leultrix /usr/local/bin/etags
    r2000leultrix /usr/local/bin/top

    sparcsolaris /usr/local/bin/ctags
    sparcsolaris /usr/local/bin/emacsclient
    sparcsolaris /usr/local/bin/etags

    sparcsun /usr/local/bin/b2m
    sparcsun /usr/local/bin/c++
    sparcsun /usr/local/bin/cmp
    sparcsun /usr/local/bin/ctags
    sparcsun /usr/local/bin/diff
    sparcsun /usr/local/bin/diff3
    sparcsun /usr/local/bin/emacsclient
    sparcsun /usr/local/bin/etags
    sparcsun /usr/local/bin/g++
    sparcsun /usr/local/bin/protoize
    sparcsun /usr/local/bin/rcs-checkin
    sparcsun /usr/local/bin/unprotoize
