[Groff-commit] groff ChangeLog INSTALL INSTALL.gen MANIFEST RE...

[Bernd Warken]

CVSROOT:        /cvsroot/groff
Module name:    groff
Changes by:     Bernd Warken <bwarken>  13/04/14 23:49:49

Modified files:
        .              : ChangeLog INSTALL INSTALL.gen MANIFEST README 

Log message:
        Add documentation for the installation.

CVSWeb URLs:
http://cvs.savannah.gnu.org/viewcvs/groff/ChangeLog?cvsroot=groff&r1=1.1407&r2=1.1408
http://cvs.savannah.gnu.org/viewcvs/groff/INSTALL?cvsroot=groff&r1=1.17&r2=1.18
http://cvs.savannah.gnu.org/viewcvs/groff/INSTALL.gen?cvsroot=groff&r1=1.6&r2=1.7
http://cvs.savannah.gnu.org/viewcvs/groff/MANIFEST?cvsroot=groff&r1=1.19&r2=1.20
http://cvs.savannah.gnu.org/viewcvs/groff/README?cvsroot=groff&r1=1.24&r2=1.25

Patches:
Index: ChangeLog
===================================================================
RCS file: /cvsroot/groff/groff/ChangeLog,v
retrieving revision 1.1407
retrieving revision 1.1408
diff -u -b -r1.1407 -r1.1408
--- ChangeLog   14 Apr 2013 23:11:00 -0000      1.1407
+++ ChangeLog   14 Apr 2013 23:49:48 -0000      1.1408
@@ -1,5 +1,10 @@
 2013-04-15  Bernd Warken  <address@hidden>
 
+       * README, INSTALL, INSTALL.gen, MANIFEST: Add documentation in the
+       top directory about some parts of `autotools' and `glilypond'.
+
+2013-04-15  Bernd Warken  <address@hidden>
+
        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.

Index: INSTALL
===================================================================
RCS file: /cvsroot/groff/groff/INSTALL,v
retrieving revision 1.17
retrieving revision 1.18
diff -u -b -r1.17 -r1.18
--- INSTALL     5 Jan 2009 20:10:29 -0000       1.17
+++ INSTALL     14 Apr 2013 23:49:48 -0000      1.18
@@ -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 @@
 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
 

Index: INSTALL.gen
===================================================================
RCS file: /cvsroot/groff/groff/INSTALL.gen,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -b -r1.6 -r1.7
--- INSTALL.gen 28 Dec 2012 11:59:30 -0000      1.6
+++ INSTALL.gen 14 Apr 2013 23:49:48 -0000      1.7
@@ -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 @@
 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:
 

Index: MANIFEST
===================================================================
RCS file: /cvsroot/groff/groff/MANIFEST,v
retrieving revision 1.19
retrieving revision 1.20
diff -u -b -r1.19 -r1.20
--- MANIFEST    29 Jan 2013 08:08:33 -0000      1.19
+++ MANIFEST    14 Apr 2013 23:49:48 -0000      1.20
@@ -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 @@
                 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.

Index: README
===================================================================
RCS file: /cvsroot/groff/groff/README,v
retrieving revision 1.24
retrieving revision 1.25
diff -u -b -r1.24 -r1.25
--- README      1 Feb 2013 08:29:55 -0000       1.24
+++ README      14 Apr 2013 23:49:49 -0000      1.25
@@ -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 @@
 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:address@hidden/sources/groff -z5 co groff
@@ -77,6 +87,7 @@
 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