Doc: README and INSTALL update

Minor cleanups, updates and clarifications. Also removes (incomplete
and well-known) build steps from README, as they are better described
in INSTALL.
This commit is contained in:
Ondrej Zajicek (work) 2019-01-03 17:11:56 +01:00
parent 470740f97b
commit 4d9049dc1a
2 changed files with 15 additions and 17 deletions

14
INSTALL
View file

@ -7,13 +7,15 @@ $ make
Default location for configuration file is /usr/local/etc/bird.conf and Default location for configuration file is /usr/local/etc/bird.conf and
for control socket is /usr/local/var/run/bird.ctl . You can change that for control socket is /usr/local/var/run/bird.ctl . You can change that
by --sysconfdir and --localstatedir configure options. by --prefix, --sysconfdir and --runstatedir configure options, e.g.:
$ ./configure --prefix=/usr --sysconfdir=/etc --runstatedir=/run
To compile current development BIRD source code from Git repository, you To compile current development BIRD source code from Git repository, you
also need Git (to download the source code) and Autoconf (to generate also need Git (to download the source code) and Autoconf (to generate
the configure script and associated files using 'autoreconf' tool): the configure script and associated files using 'autoreconf' tool):
$ git clone git://git.nic.cz/bird.git $ git clone https://gitlab.labs.nic.cz/labs/bird/
$ cd bird $ cd bird
$ autoreconf $ autoreconf
@ -32,9 +34,15 @@ For compiling BIRD you need these programs and libraries:
- Flex - Flex
- ncurses library - ncurses library
- GNU Readline library (2.1 or newer) - GNU Readline library
- libssh library (optional, for RPKI-Router protocol)
For compiling BIRD documentation you also need: For compiling BIRD documentation you also need:
- Linuxdoc-Tools - Linuxdoc-Tools
- LaTeX - LaTeX
Note that build scripts for BIRD documentation expects 'nsgmls' from
James Clark's SP suite, while modern distributions use 'onsgmls' from
OpenSP suite. It is possible to build BIRD documentation with OpenSP
tools, but it requires manually tweaking paths in doc/sgml2* scripts.

18
README
View file

@ -6,7 +6,7 @@
(c) 1998--2008 Martin Mares <mj@ucw.cz> (c) 1998--2008 Martin Mares <mj@ucw.cz>
(c) 1998--2000 Pavel Machek <pavel@ucw.cz> (c) 1998--2000 Pavel Machek <pavel@ucw.cz>
(c) 1998--2008 Ondrej Filip <feela@network.cz> (c) 1998--2008 Ondrej Filip <feela@network.cz>
(c) 2009--2017 CZ.NIC z.s.p.o. (c) 2009--2019 CZ.NIC z.s.p.o.
================================================================================ ================================================================================
@ -48,20 +48,10 @@ How to install BIRD
ftp://bird.network.cz/pub/bird/redhat/ ftp://bird.network.cz/pub/bird/redhat/
o From source code of the latest stable release version o From source code of the latest stable release version
ftp://bird.network.cz/pub/bird/ ftp://bird.network.cz/pub/bird/
o From source code of the actual development version o From current development code in Git repository
git://git.nic.cz/bird.git
https://gitlab.labs.nic.cz/labs/bird/ https://gitlab.labs.nic.cz/labs/bird/
How to install BIRD from source code See the file INSTALL for information about installation from source code.
------------------------------------
$ ./configure
$ make
$ su
# make install
# vi /usr/local/etc/bird.conf
See the file INSTALL for more information about installation from source code.
Documentation Documentation
============= =============
@ -69,7 +59,7 @@ Documentation
Online documentation is available at http://bird.network.cz/?get_doc or as HTML Online documentation is available at http://bird.network.cz/?get_doc or as HTML
files in the doc directory, you can install it by `make install-docs' and files in the doc directory, you can install it by `make install-docs' and
rebuild it by `make docs', but you'll need SGMLtools and LaTeX to be installed rebuild it by `make docs', but you'll need SGMLtools and LaTeX to be installed
on your machine. You can also download a neatly formatted PostScript version as on your machine. You can also download a neatly formatted PDF version as
a separate archive (bird-doc-*.tar.gz) from ftp://bird.network.cz/pub/bird/ a separate archive (bird-doc-*.tar.gz) from ftp://bird.network.cz/pub/bird/
User support User support