guile/guile-core ChangeLog HACKING

[Gary Houston]

CVSROOT:        /cvs
Module name:    guile
Changes by:     Gary Houston <address@hidden>   01/11/21 19:11:37

Modified files:
        guile-core     : ChangeLog HACKING 

Log message:
        * HACKING: Modified the Hacking It Yourself section.  Removed the
        version numbers from the tools.

CVSWeb URLs:
http://savannah.gnu.org/cgi-bin/viewcvs/guile/guile-core/ChangeLog.diff?cvsroot=OldCVS&tr1=1.325&tr2=1.326&r1=text&r2=text
http://savannah.gnu.org/cgi-bin/viewcvs/guile/guile-core/HACKING.diff?cvsroot=OldCVS&tr1=1.61&tr2=1.62&r1=text&r2=text

Patches:
Index: guile/guile-core/ChangeLog
diff -u guile/guile-core/ChangeLog:1.325 guile/guile-core/ChangeLog:1.326
--- guile/guile-core/ChangeLog:1.325    Wed Nov 21 18:39:51 2001
+++ guile/guile-core/ChangeLog  Wed Nov 21 19:11:37 2001
@@ -1,3 +1,8 @@
+2001-11-22  Gary Houston  <address@hidden>
+
+       * HACKING: Modified the Hacking It Yourself section.  Removed the
+       version numbers from the tools.
+
 2001-11-21  Gary Houston  <address@hidden>
 
        * HACKING: Removed reference to no longer practiced * in ChangeLog
Index: guile/guile-core/HACKING
diff -u guile/guile-core/HACKING:1.61 guile/guile-core/HACKING:1.62
--- guile/guile-core/HACKING:1.61       Wed Nov 21 18:38:43 2001
+++ guile/guile-core/HACKING    Wed Nov 21 19:11:37 2001
@@ -22,8 +22,8 @@
 
 However, to see what others have indicated as their interest (and avoid
 potential wasteful duplication of effort), see file TODO.  Note that
-the version you find may be out of date; a CVS checkout is recommended
-(see also file SNAPSHOTS).
+the version you find may be out of date; a CVS checkout is recommended:
+see below for details (see also file SNAPSHOTS).
 
 It's also a good idea to join the address@hidden mailing list.
 See http://www.gnu.org/software/guile/mail/mail.html for more info.
@@ -31,43 +31,42 @@
 
 Hacking It Yourself ==================================================
 
-As distributed, Guile needs only an ANSI C compiler and a Unix system
-to compile.  However, Guile's makefiles, configuration scripts, and a
-few other files are automatically generated, not written by hand.  If
-you want to make changes to the system (which we encourage!) you will
-find it helpful to have the tools we use to develop Guile.  They
-are the following:
+When Guile is obtained from CVS, a few extra steps must be taken
+before the usual configure, make, make install.  You will need to have
+up-to-date versions of the tools listed below, correctly installed.
+i.e., they must be found in the current PATH and not shadowed or
+otherwise broken by files left behind from older versions.
+
+"up-to-date" means the latest released versions at the time that Guile
+was obtained from CVS.  Sometimes older versions will work.
+
+Then you must run the autogen.sh script, as described below.
+
+In case of problems, it may be worth getting a fresh copy of Guile
+from CVS: synchronisation problems have been known to occur
+occasionally.
 
-Autoconf 2.50 --- a system for automatically generating `configure'
+Autoconf --- a system for automatically generating `configure'
        scripts from templates which list the non-portable features a
        program would like to use.  Available in
        "ftp://ftp.gnu.org/pub/gnu/autoconf";
 
-Automake 1.4-p4 --- a system for automatically generating Makefiles that
+Automake --- a system for automatically generating Makefiles that
        conform to the (rather Byzantine) GNU coding standards.  The
        nice thing is that it takes care of hairy targets like 'make
        dist' and 'make distclean', and automatically generates
        Makefile dependencies.  Automake is available in
        "ftp://ftp.gnu.org/pub/gnu/automake";
 
-       Before using automake, you may need to copy `threads.m4' and
-       `guile.m4' from the top directory of the Guile core disty to
-       `/usr/local/share/aclocal'.
-
-libtool 1.4 --- a system for managing the zillion hairy options needed
+libtool --- a system for managing the zillion hairy options needed
        on various systems to produce shared libraries.  Available in
        "ftp://ftp.gnu.org/pub/gnu/libtool";
-
-       To avoid reported tricky errors during the Guile build: After
-       unpacking the libtool distribution, use autoconf (2.50) to
-       regenerate its ./configure script.  Then build and install as
-       usual.
 
-flex 2.5.4 (or newer) --- a scanner generator.  earlier versions will
-        most probably work too.
+flex --- a scanner generator.  It's probably not essential to have the
+        latest version.
 
-You are lost in a little maze of automatically generated files, all
-different.
+One false move and you will be lost in a little maze of automatically
+generated files, all different.
 
 
 Sample GDB Initialization File=========================================