Annotation of embedaddon/quagga/INSTALL.quagga.txt, revision 1.1.1.1

1.1       misho       1: --------------------------------------------------------------------------
                      2: Building and Installing Quagga from releases or snapshots:
                      3: 
                      4: The 'INSTALL' file contains generic instructions on how to use 'configure'
                      5: scripts.
                      6: 
                      7: Quagga requires a C compiler (and associated header files and
                      8: libraries) supporting the C99 standard.
                      9: 
                     10: Quagga requires a reasonable make.  It is considered a bug if quagga
                     11: does not compile with the system make on recent FreeBSD, NetBSD or
                     12: OpenBSD, and a very serious bug if it does not compile with GNU make.
                     13: 
                     14: Quagga expects a POSIX.2 compliant system, more or less.  Clean
                     15: workarounds for POSIX non-compliance are welcome.
                     16: 
                     17: It is considered a bug if Quagga fails to build and run on any of the
                     18: following systems (where .x indicates the most recent release), or
                     19: such systems "-current" versions.  (Note that considering it a bug is
                     20: not a guarantee of support, merely "we agree that it is broken".)
                     21: 
                     22:   Dragonfly ?
                     23:   FreeBSD 4.x  [In 2007, this is getting tenous.]
                     24:   FreeBSD 5.x
                     25:   FreeBSD 6.x
                     26:   FreeBSD-current
                     27:   Linux [kernel/distribution information needed]
                     28:   NetBSD 2.x   [Note texinfo 4.6  in base system]
                     29:   NetBSD 3.x
                     30:   NetBSD 4.x
                     31:   NetBSD-current
                     32:   OpenBSD ? [info needed on what should work]
                     33:   Solaris 9
                     34:   Solaris 10
                     35: 
                     36: 
                     37: For further Quagga specific information on 'configure' and build-time
                     38: configuration of the software, please read the Quagga info
                     39: documentation, (doc/quagga.info).  To read the info page included with
                     40: the Quagga sources without first installing Quagga:
                     41: 
                     42:   cd doc
                     43:   # one of the following, depending on your info viewer preferences
                     44:   info quagga.info
                     45:   pinfo -r quagga.info
                     46:   emacs -eval '(info "quagga.info")'
                     47: 
                     48: The Quagga website (http://www.quagga.net) currently has the info
                     49: files available in various formats.
                     50: 
                     51: --------------------------------------------------------------------------
                     52: Building Quagga from CVS checkouts:
                     53: 
                     54: In order to build from CVS, you will need recent versions of several GNU
                     55: tools, particularly autoconf, automake, libtool, GNU awk and texinfo.  Note
                     56: that the CVS snapshots on the Quagga website should not require these tools;
                     57: everything is already setup ready to run 'configure'.  If you have trouble
                     58: building from CVS checkout it is recommended that you try a CVS snapshot
                     59: instead.
                     60: 
                     61: We declare that the following versions should work for building from
                     62: CVS checkouts.  Earlier versions may work, but failure to do so is not
                     63: a bug.  Required versions can be moved earlier if no problems, or
                     64: later after a judgement that a system without a higher version is
                     65: deficient is made.
                     66: 
                     67:        automake:       1.9.6 (released 2005-07-10)
                     68:        autoconf:       2.59 (2.60 on 2006-06-26 is too recent to require)
                     69:        libtool:        1.5.22 (released 2005-12-18)
                     70:        texinfo:        4.7 (released 2004-04-10; 4.8 is not yet common)
                     71:        GNU AWK:        3.1.5 (released 2005-08-12)
                     72: 
                     73: Becuase some systems provide texinfo 4.6 (4.7 is new), quagga.info is
                     74: checked in so that texinfo will generally not be invoked.  When
                     75: texinfo 4.7 is widespread, quagga.info will be removed from CVS and
                     76: texinfo will become required again.  (4.7 has figure support, needed
                     77: for the route server docs, which is why 4.6 doesn't work.)
                     78: 
                     79: In order to create PostScript or PDF versions of the Texinfo documentation,
                     80: you will need the convert utility, from the ImageMagick toolset installed,
                     81: and epstopdf from the TeTeX suite.
                     82: 
                     83: To create the required autotools files (Makefile.in, configure, etc.),
                     84: run "./bootstrap.sh".  After this you may run configure as for a
                     85: snapshot or release.
                     86: 
                     87: Please refer to "Building and Installing Quagga" above for further
                     88: instructions.
                     89: 
                     90: --------------------------------------------------------------------------
                     91: Notes on required versions:
                     92: 
                     93: The general goal is to use a modern baseline of tools, while not
                     94: imposing pain on those tracking stable distributions.  The notes below
                     95: explain what versions are present in various environments.
                     96: 
                     97: NetBSD 1.6 and 2 provide texinfo 4.6.  This is now considered old.
                     98: NetBSD 3 and 4 provide texinfo 4.7.
                     99: 
                    100: Fedora Core ? provides autoconf 2.59.
                    101: 
                    102: OpenBSD 3.6 provides texinfo 4.2.
                    103: OpenBSD [3.6] ports provides automake 1.4-p6 autoconf 2.5.9 libtool 1.5.8
                    104: 
                    105: --------------------------------------------------------------------------

FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>