]> git.proxmox.com Git - mirror_frr.git/blobdiff - INSTALL.quagga.txt
lib: vty: add infrastructure for qobj ID "index"
[mirror_frr.git] / INSTALL.quagga.txt
index ec4e799d2af18f34148f71b8f4c056cef54c4dbe..b414d948614bd07c2c0db7262a89cfee651c3536 100644 (file)
@@ -16,23 +16,23 @@ workarounds for POSIX non-compliance are welcome.
 
 It is considered a bug if Quagga fails to build and run on any of the
 following systems (where .x indicates the most recent release), or
-such systems "-current" versions.  (Note that considering it a bug is
+such systems "-current" versions.  Or, it might be that this list is
+out of date and will be updated.  (Note that considering it a bug is
 not a guarantee of support, merely "we agree that it is broken".)
 
   Dragonfly ?
-  FreeBSD 4.x  [In 2007, this is getting tenous.]
-  FreeBSD 5.x
-  FreeBSD 6.x
+  FreeBSD (stable branches currently supported, plus perhaps one)
   FreeBSD-current
   Linux [kernel/distribution information needed]
-  NetBSD 2.x   [Note texinfo 4.6  in base system]
-  NetBSD 3.x
   NetBSD 4.x
+  NetBSD 5.x
+  NetBSD 6.x
   NetBSD-current
   OpenBSD ? [info needed on what should work]
-  Solaris 9
-  Solaris 10
+  Solaris (modern/supported versions, including OpenSolaris forks) 
 
+On BSD systems, installing libexecinfo is strongly recommended in order
+to get backtrace support.
 
 For further Quagga specific information on 'configure' and build-time
 configuration of the software, please read the Quagga info
@@ -49,9 +49,9 @@ The Quagga website (http://www.quagga.net) currently has the info
 files available in various formats.
 
 --------------------------------------------------------------------------
-Building Quagga from CVS checkouts:
+Building Quagga from git checkouts:
 
-In order to build from CVS, you will need recent versions of several GNU
+In order to build from git, you will need recent versions of several GNU
 tools, particularly autoconf, automake, libtool, GNU awk and texinfo.  Note
 that the CVS snapshots on the Quagga website should not require these tools;
 everything is already setup ready to run 'configure'.  If you have trouble
@@ -64,13 +64,18 @@ a bug.  Required versions can be moved earlier if no problems, or
 later after a judgement that a system without a higher version is
 deficient is made.
 
+       [TODO: this list is out of date as of 2013-07]
        automake:       1.9.6 (released 2005-07-10)
        autoconf:       2.59 (2.60 on 2006-06-26 is too recent to require)
        libtool:        1.5.22 (released 2005-12-18)
        texinfo:        4.7 (released 2004-04-10; 4.8 is not yet common)
-       GNU AWK:        3.1.5 (released 2005-08-12)
 
-Becuase some systems provide texinfo 4.6 (4.7 is new), quagga.info is
+For running tests, one also needs:
+
+       DejaGnu:
+
+[TODO: texinfo 4.6 is now ancient and this should be revisited/fixed]
+Because some systems provide texinfo 4.6 (4.7 is new), quagga.info is
 checked in so that texinfo will generally not be invoked.  When
 texinfo 4.7 is widespread, quagga.info will be removed from CVS and
 texinfo will become required again.  (4.7 has figure support, needed
@@ -91,11 +96,12 @@ instructions.
 Notes on required versions:
 
 The general goal is to use a modern baseline of tools, while not
-imposing pain on those tracking stable distributions.  The notes below
-explain what versions are present in various environments.
+imposing pain on those tracking supported (or almost supported) stable
+distributions.  The notes below explain what versions are present in
+various environments.
 
-NetBSD 1.6 and 2 provide texinfo 4.6.  This is now considered old.
-NetBSD 3 and 4 provide texinfo 4.7.
+NetBSD 4 provides texinfo 4.7.
+NetBSD 5 and 6 provides texinfo 4.8
 
 Fedora Core ? provides autoconf 2.59.