From 5cc60fa89784199fad27416d1d3bde0a24e808b1 Mon Sep 17 00:00:00 2001
From: Arun Raghavan <arun.raghavan@collabora.co.uk>
Date: Sat, 3 Nov 2012 11:50:10 +0100
Subject: build-sys: Document libpulsecommon vs. libpulse duplication

---
 src/Makefile.am | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/src/Makefile.am b/src/Makefile.am
index ed6f8e28..cbd7733a 100644
--- a/src/Makefile.am
+++ b/src/Makefile.am
@@ -559,6 +559,11 @@ echo_cancel_test_LDFLAGS = $(AM_LDFLAGS) $(BINLDFLAGS)
 pkglib_LTLIBRARIES = \
 		libpulsecommon-@PA_MAJORMINOR@.la
 
+# We duplicate files from pulse/ in this to allow as-needed linking. If we did
+# not do this, in situations where code in libpulsecommon uses code in
+# libpulse, we would then need to link libpulsecommon to libpulse (in addition
+# to the existing libpulse being linked to libpulsecommon). Duplicating the
+# code allows us to prevent this circular linking.
 libpulsecommon_@PA_MAJORMINOR@_la_SOURCES = \
 		pulse/client-conf.c pulse/client-conf.h \
 		pulse/fork-detect.c pulse/fork-detect.h \
-- 
cgit v1.2.3