Formatting edits to misc.c, line up columns with tabs, etc.

Added section about autofixer.sh



git-svn-id: https://hamlib.svn.sourceforge.net/svnroot/hamlib/trunk@2812 7ae35d74-ebe9-4afe-98af-79ac388436b8

README.developer

@@ -157,9 +157,17 @@ version or you won't even be able to build from the SVN checkout.
 * Gnu make  (or any modern one, BSD okay)   # make --version
 * autoconf      2.54                        # autoconf --version
 * automake      1.7                         # automake --version
-* libtool       1.5                         # libtool --version
+* libtool       1.5|2.2.6                   # libtool --version
+* libltdl-dev   2.2.6                       # (Debian package for new libtool)
 * svn for connection to hamlib.svn.sourceforge.net
 
+N.B. The libtool package is in a state of flux where we need to support the
+older 1.5 version and the newer 2.2.x version.  As luck would have it, they
+are incompatible with their Autotools syntax.  A test is in place in the
+`autogen.sh' script for `libtool' version 1.x.  Please advise on the 
+hamlib-developer mailing list you have an older version of libtool and are
+receiving errors.
+
 Optional:
 * GNU C++                           # g++ --version
 * swig (for bindings)   1.3.14      # swig -version
@@ -192,19 +200,27 @@ It is important to note that the SVN repository holds no autogenerated
 files, i.e. configure, config.guess, Makefile, etc.  Hence after a fresh
 checkout, you'll have to generate those files.
 
+NOTE: The following paragraph and running the autofixer.sh script may not be
+needed.  Please try running the `autogen.sh' script first and please report any
+errors to the hamlib-developer mailing list.
+
+-----
 The provided autogen.sh and configure.ac files are appropriate for systems with
-libtool version 2.  Many systems may still provide libtool version 1, however.
+libtool version 2.2.x  Many systems may still provide libtool version 1.x,
-To set up for version 1 of libtool, you may run the procedure autofixer.sh
+however.  To set up for version 1.x of libtool, you may run the `autofixer.sh'
-before running autogen.sh, as described below.  I.e., give the following
+script before running `autogen.sh', as described below.  i.e., give the
-command.
+following command in the hamlib root directory.
 
+    cd hamlib
     sh ./autofixer.sh
+-----
 
-To proceed, first edit the autogen.sh, and set appropriately the AUTOCONF,
+To proceed, first edit the autogen.sh script, and set appropriately the
-AUTOHEADER, AUTOHEADER, and ACLOCAL variables with the required versions
+AUTOCONF, AUTOHEADER, AUTOHEADER, and ACLOCAL variables with the required
-seen in the previous section (most systems will be fine with the default
+versions seen in the previous section (most systems will be fine with the
-names).
+default names).
 
+    cd hamlib
     sh ./autogen.sh --disable-static --prefix=/usr/local CFLAGS="-g -O0"
     make
     make install
@@ -220,27 +236,30 @@ following in the same parent directory of hamlib:
 This will keep the binary output files seperate from the source tree and aid
 in development by reducing clutter in the source tree.
 
-Once you've run autogen.sh, make sure you've got some recent config.guess and
+Once you've run `autogen.sh', make sure you've got some recent config.guess and
 config.sub (needed to guess your system type).  Anything of at least year 2004
 should be fine, unless you run some exotic hardware/software system:
 
     ./config.guess --version
     ./config.sub --version
 
-The prefix argument is optional.  Convention is that local packages be placed
+The '--prefix' option to `autogen.sh' is optional.  Convention is that locally
-in /usr/local away from distribution installed packages.  The --disable-static
+built packages be installed in /usr/local away from distribution installed
-and CFLAGS="-g -O0" speeds up compilation if you don't plan to use static
+packages.  The '--disable-static' and 'CFLAGS="-g -O0"' speeds up compilation
-libraries and can bear less optimized binaries while the -g option adds
+if you don't plan to use static libraries and can bear less optimized binaries
-debugging info which can be changed to -ggdb to generate debugging info for
+while the '-g' option adds debugging info which can be changed to -ggdb to
-gdb.
+generate debugging info for gdb.  Additionally, you may want to add the
+'--without-perl-binding' and '--without-python-binding' if you are not
+interested in those scripting languages.
 
-NOTE: autogen.sh has only to be run the first time after a fresh checkout or
+NOTE: The autogen.sh script has only to be run the first time after a fresh
-when a Makefile.am or other build file is modified or added.
+checkout or when a Makefile.am or other build file is modified or added.
 
-The difference between building as a tester and a developer is in the 
+The difference between building as a beta tester and a developer is in the 
-'--enable-maintainer-mode' option passed to configure.  This option will add 
+'--enable-maintainer-mode' option passed to configure from .  This option will add 
 new Makefile targets and dependencies and not force a rebuild of the Makefiles
-when make is executed.
+when make is executed.  This is why we recommend that beta testers use the
+daily SVN snapshot from http://n0nb.users.sourceforge.net
 
 For a Tcl build, add this if needed:
 

src/misc.c

@@ -2,7 +2,7 @@
  *  Hamlib Interface - toolbox
  *  Copyright (c) 2000-2005 by Stephane Fillod
  *
- *	$Id: misc.c,v 1.51 2009-01-11 17:36:24 mrtembry Exp $
+ *	$Id$
  *
  *   This library is free software; you can redistribute it and/or modify
  *   it under the terms of the GNU Library General Public License as