Add documentation for the installation.

5 files changed, 52 insertions, 9 deletions

diff --git a/ChangeLog b/ChangeLog
index 1972bf7a..21aa6413 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,5 +1,10 @@
 2013-04-15  Bernd Warken  <groff-bernd.warken-72@web.de>
 
+	* README, INSTALL, INSTALL.gen, MANIFEST: Add documentation in the
+	top directory about some parts of `autotools' and `glilypond'.
+
+2013-04-15  Bernd Warken  <groff-bernd.warken-72@web.de>
+
 	Add Perl test to configuration.  During the run of `configure' the
 	program is broken with error when there is no `Perl' or the `perl'
 	program is too old.
diff --git a/INSTALL b/INSTALL
index 83ec56b1..bcfaea76 100644
--- a/INSTALL
+++ b/INSTALL
@@ -1,6 +1,8 @@
-    Copyright 1997, 1999, 2000, 2001, 2002, 2003, 2004, 2006, 2009
+    Copyright 1997,1999,2000,2001,2002,2003,2004,2006,2009,2013
       Free Software Foundation, Inc.
 
+    Last Update: 15 Apr 2013
+
     Copying and distribution of this file, with or without modification,
     are permitted in any medium without royalty provided the copyright
     notice and this notice are preserved.
@@ -94,6 +96,11 @@ usual malloc, it is good idea to include it in LIBS.  For example,
 using the malloc that comes with GNU Emacs version 20 can give a
 worthwhile (and sometimes spectacular) performance improvement.
 
+Many programs within the `groff' system are written in the Perl
+language.  So you need a `perl' program with the least version of
+`v5.6.1'.
+
+
 If you want A4 or letter paper format and the configure script produces
 an incorrect guess, say
 
diff --git a/INSTALL.gen b/INSTALL.gen
index 6e90e07d..898df3cc 100644
--- a/INSTALL.gen
+++ b/INSTALL.gen
@@ -1,8 +1,10 @@
 Installation Instructions
 *************************
 
-Copyright (C) 1994-1996, 1999-2002, 2004-2012 Free Software Foundation,
-Inc.
+Copyright (C) 1994-1996, 1999-2002, 2004-2013
+   Free Software Foundation, Inc.
+
+Last Update: 15 Apr 2013
 
    Copying and distribution of this file, with or without modification,
 are permitted in any medium without royalty provided the copyright
@@ -44,9 +46,23 @@ some point `config.cache' contains results you don't want to keep, you
 may remove or edit it.
 
    The file `configure.ac' (or `configure.in') is used to create
-`configure' by a program called `autoconf'.  You need `configure.ac' if
-you want to change it or regenerate `configure' using a newer version
-of `autoconf'.
+`configure' by a program called `autoconf'.  You need `configure.ac'
+if you want to change it or regenerate `configure' using a newer
+version of `autoconf'.
+
+   You can also use `autoreconf -I m4' which does the same as `autoconf'
+together with some other internal things.  You might get the following
+warnings:
+
+   /usr/share/aclocal/gtkglextmm-1.2.m4:225: warning: underquoted \
+definition of AC_GTKGLEXTMM_SUPPORTS_MULTIHEAD
+   /usr/share/aclocal/gtkglextmm-1.2.m4:225:   run info \
+'(automake)Extending aclocal'
+   /usr/share/aclocal/gtkglextmm-1.2.m4:225:   or see \
+http://www.gnu.org/software/automake/manual/automake.html#Extending-aclocal
+
+Just ignore this.  It is just a small bug that is known, but that was
+not corrected.
 
    The simplest way to compile this package is:
 
diff --git a/MANIFEST b/MANIFEST
index fea4cf65..608851d5 100644
--- a/MANIFEST
+++ b/MANIFEST
@@ -1,6 +1,8 @@
     Copyright 2001-2006, 2009-2013
       Free Software Foundation, Inc.
 
+    Last Update: 15 Apr 2013
+
     Copying and distribution of this file, with or without modification,
     are permitted in any medium without royalty provided the copyright
     notice and this notice are preserved.
@@ -44,6 +46,8 @@ the groff source distribution.
                 graphical formats.
   gdiffmk       An improved implementation of the diffmk command to mark
                 differences between groff/nroff/troff files.
+  glilypond	A preprocessor that handles `lilypond' parts in a `roff'
+  		file.
   grap2graph    Convert grap diagraps into different graphical formats.
   groffer       A wrapper to conveniently view roff files.
   hdtbl         A sophisticated table macro package.
diff --git a/README b/README
index dbee1978..f299fca8 100644
--- a/README
+++ b/README
@@ -1,6 +1,8 @@
     Copyright (C) 1989-2006, 2008, 2009, 2012-2013
       Free Software Foundation, Inc.
 
+    Last Update: 15 Apr 2013
+
     Copying and distribution of this file, with or without modification,
     are permitted in any medium without royalty provided the copyright
     notice and this notice are preserved.
@@ -35,9 +37,17 @@ The most recent released version of `groff' is always available by
 anonymous ftp from `ftp.gnu.org' in the directory `gnu/groff'.
 
 The current development version of `groff' is available from a `CVS'
-repository.  You can access it by first selecting a parent directory
-in which to create a working copy (call it, say, `~/cvswork'), and
-then executing the commands
+repository.
+
+It makes sense if you first declare the following shell variable in
+your system:
+
+  export CVS_RSH
+  CVS_RSH=ssh
+
+You can access it then by selecting a parent directory in which to
+create a working copy (call it, say, `~/cvswork'), and then executing
+the commands
 
   cd ~/cvswork
   cvs -d:pserver:anonymous@cvs.savannah.gnu.org/sources/groff -z5 co groff
@@ -77,6 +87,7 @@ following to apply the diff file:
 Depending on your requirements, you may need at least some of the
 following tools to build `groff' directly from its source:
 
+  perl >= v5.6.1 (see macro GROFF_PERL in m4/groff.m4)
   ghostscript
   the psutils package
   the netpbm package