initial commit
[goodguy/cinelerra.git] / cinelerra-5.1 / README
1 Jun 3, 2016
2
3 == for configuration help:
4   ./autogen.sh
5   ./configure --help
6
7 == for system BUILD install:
8   ./autogen.sh
9   ./configure --prefix=/usr
10   make 2>&1 | tee log
11   make install
12
13 == for shared BUILD for $HOME/cin install:
14   ./autogen.sh
15   ./configure --without-system_build
16   make >& log
17   make install >> log
18   grep "\*\*\*.*error" -ai log
19   mkdir -p $HOME/cin
20   cp -a ./bin/. $HOME/cin/.
21
22 == to RUN from $HOME/cin install:
23   cd
24   ./cin/cinelerra
25
26 == Build notes:
27 Shared builds are not recommended, since system versions of thirdparty
28 libraries are not always known to be free of problems.  The build
29 will use known (perhaps patched) libraries if built statically.
30
31 The amount of time needed for the build is decreased by adding more
32 build jobs via --with-jobs=#, the default is 1.5*mach cpus + 2 jobs.
33 eg. --with-jobs=12
34
35 There are several packages which are "forced" either because they
36 vary widely between systems, or are buggy and have patches in the build.
37
38 Using disable-pkg means that the static build is not used, and a system
39 library will be used to replace it.  
40 eg. --disable-giflib
41
42 Using without-feature means that the feature is omitted from cinelerra.
43 eg. --without-firewire
44
45 == variable parameters    description                     default
46   --with-jobs=n:          n = parallel build jobs         1.5*cpus+2
47   --exec-name=<app>       app = binary executable name    cin
48   --with-cinlib=lib       lib = cinelerra library path    $libdir/$app
49   --with-cindat=dat       dat = cinelerra share path      $datadir/$app
50   --with-config-dir=cfg   cfg = .bcast config dir         $$HOME/.bcast5
51   --with-plugin-dir=plg   plg = plugin install dir        $cinlib/plugins
52   --with-ladspa_dir=lad   lad = ladspa install dir        $cinlib/ladspa
53
54 $var represents configure shell value
55 $$ stuttered represents as makefile data = $
56