Annotation of embedaddon/quagga/INSTALL.quagga.txt, revision 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>