[Groff-commit] groff ChangeLog INSTALL.gen

[Bernd Warken]

CVSROOT:        /cvsroot/groff
Module name:    groff
Changes by:     Bernd Warken <bwarken>  06/11/09 00:01:48

Modified files:
        .              : ChangeLog INSTALL.gen 

Log message:
        Extent INSTALL.gen by information on external installation.

CVSWeb URLs:
http://cvs.savannah.gnu.org/viewcvs/groff/ChangeLog?cvsroot=groff&r1=1.1002&r2=1.1003
http://cvs.savannah.gnu.org/viewcvs/groff/INSTALL.gen?cvsroot=groff&r1=1.3&r2=1.4

Patches:
Index: ChangeLog
===================================================================
RCS file: /cvsroot/groff/groff/ChangeLog,v
retrieving revision 1.1002
retrieving revision 1.1003
diff -u -b -r1.1002 -r1.1003
--- ChangeLog   8 Nov 2006 20:07:10 -0000       1.1002
+++ ChangeLog   9 Nov 2006 00:01:47 -0000       1.1003
@@ -1,3 +1,9 @@
+2006-11-09  Bernd Warken
+
+       * INSTALL.gen: Extent the file by information on `external
+       installation'.  Reorder the installation instruction as `normal
+       installation'. 
+
 2006-11-08  Werner Lemberg  <address@hidden>
 
        * doc/Makefile.sub (install_data): Take care of proper paths while

Index: INSTALL.gen
===================================================================
RCS file: /cvsroot/groff/groff/INSTALL.gen,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -b -r1.3 -r1.4
--- INSTALL.gen 7 Oct 2004 10:49:37 -0000       1.3
+++ INSTALL.gen 9 Nov 2006 00:01:47 -0000       1.4
@@ -1,12 +1,78 @@
 Installation Instructions
 *************************
 
-Copyright (C) 1994, 1995, 1996, 1999, 2000, 2001, 2002, 2004 Free
-Software Foundation, Inc.
+Copyright (C) 1994, 1995, 1996, 1999, 2000, 2001, 2002, 2004, 2006
+Free Software Foundation, Inc.
 
 This file is free documentation; the Free Software Foundation gives
 unlimited permission to copy, distribute and modify it.
 
+Normal Installation
+===================
+
+The simplest way to compile this package is:
+
+  1. `cd' to the directory containing the package's source code and type
+     `./configure' to configure the package for your system.  If you're
+     using `csh' on an old version of System V, you might need to type
+     `sh ./configure' instead to prevent `csh' from trying to execute
+     `configure' itself.
+
+     Running `configure' takes awhile.  While running, it prints some
+     messages telling which features it is checking for.
+
+  2. Type `make' to compile the package.
+
+  3. Optionally, type `make check' to run any self-tests that come with
+     the package.
+
+  4. Type `sudo make install' to install the programs and any data
+     files and documentation.  `make install' is the only step for
+     which you need `root' access; this is done by `sudo'.
+
+  5. You can remove the program binaries and object files from the
+     source code directory by typing `make clean'.  To also remove the
+     files that `configure' created (so you can compile the package for
+     a different kind of computer), type `make distclean'.  There is
+     also a `make maintainer-clean' target, but that is intended mainly
+     for the package's developers.  If you use it, you may have to get
+     all sorts of other programs in order to regenerate files that came
+     with the distribution.
+
+External Installation
+=====================
+
+It is also possible to perform the whole installation process outside
+of the source code.  In this case a whole external build directory
+structure is created without changing any parts of the source code.
+This is usefule when the source code is read-only or when several
+different installations, such as for multiple architectures should be
+constructed.
+
+As an example, let's assume that the source code of the `groff' code
+is in `/usr/local/src/groff' and that the installation should be done
+with the directory `/home/my/groff.compile'.
+
+  0. Run `cd /home/my/groff.compile'.
+
+  1. Call `/usr/local/src/groff/configure' in that directory to
+     configure the package for your system.  If you're using `csh' on an
+     old version of System V, you might need to type
+     `sh /usr/local/src/groff/configure' instead.
+
+  2. Type `make' to compile the package in that directory.
+
+  3. Optionally, type `make check' to run any self-tests that come with
+     the package.
+
+  4. Type `sudo make install' to install the programs and any data
+     files and documentation.
+
+  5. You can remove the program binaries and object files from the
+     source code directory by typing `make clean'.  To also remove the
+     files that `configure' created (so you can compile the package for
+     a different kind of computer), type `make distclean'.
+
 Basic Installation
 ==================
 
@@ -39,34 +105,6 @@
 `configure.ac' if you want to change it or regenerate `configure' using
 a newer version of `autoconf'.
 
-The simplest way to compile this package is:
-
-  1. `cd' to the directory containing the package's source code and type
-     `./configure' to configure the package for your system.  If you're
-     using `csh' on an old version of System V, you might need to type
-     `sh ./configure' instead to prevent `csh' from trying to execute
-     `configure' itself.
-
-     Running `configure' takes awhile.  While running, it prints some
-     messages telling which features it is checking for.
-
-  2. Type `make' to compile the package.
-
-  3. Optionally, type `make check' to run any self-tests that come with
-     the package.
-
-  4. Type `make install' to install the programs and any data files and
-     documentation.
-
-  5. You can remove the program binaries and object files from the
-     source code directory by typing `make clean'.  To also remove the
-     files that `configure' created (so you can compile the package for
-     a different kind of computer), type `make distclean'.  There is
-     also a `make maintainer-clean' target, but that is intended mainly
-     for the package's developers.  If you use it, you may have to get
-     all sorts of other programs in order to regenerate files that came
-     with the distribution.
-
 Compilers and Options
 =====================
 
@@ -229,3 +267,8 @@
 `configure' also accepts some other, not widely useful, options.  Run
 `configure --help' for more details.
 
+Emacs settings
+==============
+Local Variables:
+mode: text
+End: