From: Maria Matejka <mq@ucw.cz>
Date: Tue, 11 Feb 2025 10:04:01 +0000 (+0100)
Subject: Install: a little bit more explanation
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=e1d59990d1adbd42e7fd03fb3759cfdfa2880905;p=thirdparty%2Fbird.git

Install: a little bit more explanation

Adding several notes on what is the expected workflow of build
and installation.
---

diff --git a/INSTALL b/INSTALL
index 7a1792844..917b90af0 100644
--- a/INSTALL
+++ b/INSTALL
@@ -1,8 +1,17 @@
 How to install BIRD
 ===================
 
+There are packages available for most of the existing distributions, and it is
+possibly a cleaner way to install BIRD than manually.
+
+To install BIRD manually from the source tarball, you need to first build it.
+
 $ ./configure
 $ make
+
+After this, you get binaries bird, birdc and birdcl which will run perfectly
+from wherever you put them. You can install them to the system paths if you want.
+
 # make install
 
 Default location for configuration file is /usr/local/etc/bird.conf and
@@ -21,6 +30,10 @@ $ autoreconf
 
 Then continue as in usual installation above.
 
+For debugging and development, it's recommended to use the -l flag for BIRD
+binaries to use bird.conf and bird.ctl in the current directory, instead of
+system-wide installation of an unstable version.
+
 
 Requirements
 ============