University of California at Berkeley 
	    Department of Electrical Engineering & Computer Sciences
                          Instructional Support Group


/share/b/pub/software.help


							          Jan 5, 2004

             Finding Software on EECS Instructional Systems
             ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

CONTENTS:
	/usr/sww - The EECS UNIX Software Warehouse 
	\\winsww - The EECS Windows Software Warehouse 
	Your search path (UNIX)
	On line manual pages (UNIX)
	On line GNU documentation (UNIX)

/usr/sww - The EECS UNIX Software Warehouse 
-------------------------------------------
  The departmental Software Warehouse (SWW) is accessible via the directory
  /usr/sww (and, in Cory Hall, via /usr/eesww).  The SWW is an extensive 
  collection of application software for different computer types that is 
  available on all CS and EECS UNIX computers, including the Instructional 
  systems.  Many popular UNIX public domain packages are maintained there.  
  Please read the newsgroup ucb.cs.sww.announce for more informtion about 
  products available on the SWW.

  The SWW directories are mounted as "/usr/sww" on all Instructional systems
  To insure that you are accessing the programs available there, be sure the 
  directory /usr/sww/bin in your search path, before other "bin" directories.  

  Use the command "/usr/sww/bin/swwlocate" to search the SWW for files
  related to a specific program or subject.  For example:

    swwlocate perl
    swwlocate emacs

  Some directories under /usr/sww are now "indexed".   To use the indexing
  feature, add the /usr/sww/man directory to your MANPATH (see below) and 
  type "man glimpse".


\\winsww - The EECS Windows Software Warehouse 
----------------------------------------------
  The EECS department maintains a Software Warehouse for WIN2K.  It can be
  accessed by selecting the Start/Run menu option and entering "\\winsww".
  It is available to all WIN2K workstations in the EECS domain.
  Typically, \\winsww\sww is mapped to "S:\" on the Instructional NT 
  systems.

  Additional shared NT applications are available from the CS Division NT
  server, as "\\winsww".


Your search path (UNIX)
-----------------------
  Your UNIX $path variable should look something like:

  % echo $path
  /usr/sww/bin /bin /usr/bin /usr/bin/X11 /usr/local/bin

  Your initial path and other environment variables are set during login 
  when your login shell reads the .cshrc and .login scripts in your home 
  directory.   If yours have become corrupted, you can restore the originals 
  with the commands:

  % cp /share/b/default-named-account/.cshrc ~/.cshrc
  % cp /share/b/default-named-account/.login ~/.login

  ========================================================================
  => NOTE: DO NOT ALTER THE .cshrc AND .login FILES IN A 'class' ACCOUNT.
  ========================================================================

  You can add other directories to your search path with commands such as

  % set path = ( $path /usr/local/bin /share/instsww/lang/java-1.1.8/bin )
  %rehash

  % setenv PATH  $PATH:/usr/local/bin:/share/instsww/lang/java-1.1.8/bin
  % export PATH

  These commands can be inserted at the end of a .cshrc file in a 'named' 
  account.


On line manual pages (UNIX)
---------------------------
  There are two main sources for on-line documentation on the EECS
  Instructional UNIX computers.   The /share/b/pub subdirectory contains
  numerous text files that describe the basic setup procedures and other
  information about application programs.   Type "ls /share/b/pub" for a
  listing of the files; read them with the "more" command, for example:

    more /share/b/pub/dialups

  These files can be also read using "gopher" or a WWW browser, with the
  UNIX commands:

    gopher cory.eecs.berkeley.edu
netscape http://inst.eecs.berkeley.edu/share/b/pub/.

  Most UNIX commands, standard files and programming function calls are
  documented in the UNIX "man" pages.   
  
  You can display the manual page for a command in this way (examples):

    man more
    man matlab 
    man man

  or you can look for related man pages with the "-k" or "-a" options:

    man -k getopt	- all pages with "getopt" in the description
    man -a getopt	- all files, commands, functions called "getopt"

  Most versions on the "man" command will refer to a user-defined shell
  variable called $MANPATH for a list fo directories to search for manual
  pages.  The SWW contains a very good version of the "man command from GNU, 
  called "/usr/sww/bin/gman." "gman" uses the MANPATH variable.
  
  Here is the command to see the contents of your MANPATH variable:

    printenv MANPATH
  
  Here are commands that create or append a MANPATH:

    setenv MANPATH /usr/sww/man
    setenv MANPATH ${MANPATH}:/usr/sww/man

  Note that all commands don't work the same on different versions of UNIX.  
  The man pages can be deceiving because there is a common source of man 
  pages (/usr/sww/man) and the department has elected to put the Solaris 
  man pages there.   You'll see "SunOS" at the bottom of each page.

  There are usually version-specific man pages on the local computers, under 
  /usr/man.  You can check your search path to see if that is listed, by 
  typing "printenv MANPATH".  You can put that in the front of your MANPATH 
  list so that you get those first:

    setenv MANPATH /usr/man:${MANPATH}

  or you can "-M" to give a particular path for a specific manual page:

    man -M /usr/local/man lpr

 
On line GNU documentation (UNIX)
--------------------------------
The command "info" can be typed at the UNIX prompt or via M-x info in emacs.
This provides reference info to much GNU software.   The program is stored
in /usr/sww/bin/info.



						EECS Instructional Support
						378/384/386 Cory, 333 Soda
						inst@eecs.berkeley.edu