src/util/send-pr/INSTALL

   1         Installation procedures for `send-pr'
   2
   3 If you receive `send-pr' as part of a larger software distribution, it
   4 will be automatically installed when the full distribution is
   5 installed.  The `send-pr' directory, however, is easily installed by
   6 itself by following these steps:
   7
   8 1.  Unpack the distribution into a directory which we will refer to as
   9     SRCDIR.
  10
  11 2.  Edit the `Makefile' to reflect local conventions.
  12
  13     Specifically, you should edit the variable "prefix" to alter
  14     the installation location.  The default is '/usr/local'.  All
  15     files are installed under "prefix" (see below).
  16
  17 3.  Run
  18         make all install [ info ] install-info [ clean ]
  19
  20     from the "build directory".  The targets mean the following:
  21
  22          all    Builds `send-pr' and `install-sid'
  23
  24      install    Installs the following:
  25
  26                             send-pr     into PREFIX/bin
  27                         install-sid     into PREFIX/bin
  28                           send-pr.1     into PREFIX/man/man1
  29                          categories     as PREFIX/lib/gnats/SITE
  30                       send-pr-el.in     as PREFIX/lib/emacs/lisp/send-pr.el
  31
  32         info    (optional) Builds "send-pr.info" from "send-pr.texi"
  33                 (send-pr.info is included with this distribution)
  34
  35 install-info    Installs "send-pr.info" into PREFIX/info
  36
  37        clean    (optional) Removes all intermediary build files that can
  38                            be rebuilt from source code
  39
  40 4.  Run
  41
  42         install-sid SID
  43
  44     where SID is the submitter identification code you received with
  45     `send-pr'.  If you've downloaded `send-pr' from the Net, use "net"
  46     for this value.
  47
  48
  49 5.  Any users who wish to use the Emacs version of `send-pr' must place
  50     the following line in their ".emacs" files:
  51
  52         (autoload 'send-pr "send-pr" "Submit a Problem Report." t)
  53
  54
  55 6.  Create a mail alias for the support site you received `send-pr'
  56     from, and for every site with which you wish to use `send-pr' to
  57     communicate with, each with a suffix of `-gnats'.  The support
  58     site(s) will provide the correct addresses toward which these
  59     aliases should point.  For instance, edit your mail aliases file
  60     to contain something like:
  61
  62         # support sites; for use with send-pr
  63         cygnus-gnats:     bugs@cygnus.com            # Cygnus Support
  64         bumblebee-gnats:  bumblebugs@bumblebee.com   # Bumblebee BASIC, Inc.
  65         mycompany-gnats:  bugs@my.company.com      (if you use GNATS locally)
  66
  67     `send-pr' automatically searches for these aliases when you type
  68
  69         send-pr cygnus
  70         send-pr bumblebee
  71         send-pr SITE...
  72
  73     `send-pr' also uses SITE to determine the categories of bugs the site
  74     in question accepts by looking in PREFIX/lib/gnats/SITE
  75
  76
  77 7.  That's it!  See "send-pr.info", "send-pr.texi", and/or "send-pr.1" for
  78     information on using `send-pr'.
  79
  80
  81 Copyright (c) 1993, Free Software Foundation, Inc.
  82 See the file COPYING for copyright information concerning this
  83 distribution and all its components.