From b7a97f825768bb3e617cb115540c74b65914e628 Mon Sep 17 00:00:00 2001 From: gdt Date: Fri, 23 Jul 2004 16:23:56 +0000 Subject: (somewhat unrelated cleanups, but all are very minor) 2004-07-23 Greg Troxel * */Makefile.am: Use ../dir/libfoo.la, rather than "-L../dir -lfoo", to avoid linking against installed libraries from a previous version. * {lib,ospfd,ospfclient}/Makefile.am: explicitly define the shared library version number to be 0.0 * configure.ac: remove spurious , so extract.pl is chmod'd +x. * HACKING: explain shared library versioning rules --- HACKING | 24 +++++++++++++++++++++++- 1 file changed, 23 insertions(+), 1 deletion(-) (limited to 'HACKING') diff --git a/HACKING b/HACKING index 1ffdab87..a70b15ee 100644 --- a/HACKING +++ b/HACKING @@ -1,6 +1,6 @@ -*- mode: text; -*- -$Id: HACKING,v 1.6 2004/05/13 13:38:06 paul Exp $ +$Id: HACKING,v 1.7 2004/07/23 16:23:56 gdt Exp $ GUIDELINES FOR HACKING ON QUAGGA @@ -29,6 +29,28 @@ level. [TBD: resolve per-dir vs top-level, perhaps by reading GNU coding standards] +SHARED LIBRARY VERSIONING + +[this section is at the moment just gdt's opinion] + +Quagga builds several shared libaries (lib/libzebra, ospfd/libospf, +ospfclient/libsopfapiclient). These may be used by external programs, +e.g. a new routing protocol that works with the zebra daemon, or +ospfapi clients. The libtool info pages (node Versioning) explain +when major and minor version numbers should be changed. These values +are set in Makefile.am near the definition of the library. If you +make a change that requires changing the shared library version, +please update Makefile.am. + +libospf exports far more than it should, and is needed by ospfapi +clients. Only bump libospf for changes to functions for which it is +reasonable for a user of ospfapi to call, and please err on the side +of not bumping. + +There is no support intended for installing part of zebra. The core +library libzebra and the included daemons should always be built and +installed together. + PATCH SUBMISSION * Send a clean diff against the head of CVS in unified diff format, eg by: -- cgit v1.2.1