aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorS. Davilla <davilla@4pi.com>2015-09-18 14:09:54 -0400
committerMemphiz <memphis@machzwo.de>2015-09-21 22:12:55 +0200
commit068253716210248c4b9917e9c969c12bc83cf5c5 (patch)
treedb908480e6f55163af5e29528b79b644b231aff7
parent9e009c1792aa9eb68e7fcd343d2101f169e1f39f (diff)
docs, document what we are doing in depends
-rw-r--r--tools/depends/README24
1 files changed, 24 insertions, 0 deletions
diff --git a/tools/depends/README b/tools/depends/README
index 1db6a04494..398188bbee 100644
--- a/tools/depends/README
+++ b/tools/depends/README
@@ -29,3 +29,27 @@ Linux:
Native toolchain
./configure --with-toolchain=/usr --prefix=/opt/xbmc-deps --host=x86_64-linux-gnu
+
+Details:
+ We build a native tools for platforms that do not have the native tools we need. OSX is
+ the largest builder of native tools as there is not much present. No cmake, no autotools, etc.
+
+ Cross compiling is a real pain is the rear :) Generally there are three forms,
+ autotools (configure/make), cmake driven, and hand crafted makefile. In term
+ of usage, 90 percent are autotools, followed by cmake and hand crafted makefiles.
+ Some libs need patching, most do not. Lib versions are picked for a reason, be prepared
+ for robust testing if you go bumping libs. Never commit bumps unless you have also done
+ a complete distclean nuke of EVERYTHING and rebuild from scratch on ALL platforms.
+ Epic fail if this is not tested.
+
+ 1) autotool driven tend to be simple PROVIDED the authors followed proper autotool format.
+ Try with $(CONFIGURE) 1st, if problem, try adding $(AUTORECONF) -vif before the
+ $(CONFIGURE). Some are do silly things and only a config.site can correct the errors.
+ So watch for this in the config.site.in. config.site rules and this is the only way
+ to handle bad autotool behavior.
+
+ 2) cmake driven tend to be simple, setup cmake flags right and go. On rare cases, you might
+ need to diddle the native cmake setup.
+
+ 3) hand crafted Makefiles typically require manual sed tweeks or patching.
+