| 1 | Initial Setup |
|---|
| 2 | ------------- |
|---|
| 3 | |
|---|
| 4 | You first need to type: |
|---|
| 5 | |
|---|
| 6 | sh autogen.sh |
|---|
| 7 | |
|---|
| 8 | to generate the initial configure and *.in files. You only need to |
|---|
| 9 | type this again if you upgrade you system's versions of |
|---|
| 10 | libtool/automake/autoconf and wish to use these newer version for the build |
|---|
| 11 | |
|---|
| 12 | After doing this type: |
|---|
| 13 | |
|---|
| 14 | ./configure |
|---|
| 15 | |
|---|
| 16 | For a full list of options that can be passed to configure type: |
|---|
| 17 | |
|---|
| 18 | ./configure --help |
|---|
| 19 | |
|---|
| 20 | (typical configure options include the choice of compiler, enabling or |
|---|
| 21 | disabling creation of bindings and the location of HDF libraries) |
|---|
| 22 | |
|---|
| 23 | General Building |
|---|
| 24 | ---------------- |
|---|
| 25 | |
|---|
| 26 | Just typing |
|---|
| 27 | |
|---|
| 28 | make |
|---|
| 29 | |
|---|
| 30 | should be enough to build the NeXus libraries and executables from source. |
|---|
| 31 | Make will automatically re-run configure if it needs to. |
|---|
| 32 | The test programs can then be run with |
|---|
| 33 | |
|---|
| 34 | make check |
|---|
| 35 | |
|---|
| 36 | and everything installed onto the local system with |
|---|
| 37 | |
|---|
| 38 | make install |
|---|
| 39 | |
|---|
| 40 | Making a distribution kit |
|---|
| 41 | ------------------------- |
|---|
| 42 | |
|---|
| 43 | To generate a *.tar.gz distribution kit just type: |
|---|
| 44 | |
|---|
| 45 | make distcheck |
|---|
| 46 | |
|---|
| 47 | If you need to pass arguments to "configure" during the distcheck process, |
|---|
| 48 | you must add these to the DISTCHECK_CONFIGURE_FLAGS variable in Makefile.am |
|---|
| 49 | |
|---|
| 50 | To generate an RPM install kit see README.rpm |
|---|
| 51 | |
|---|
| 52 | If you have problems |
|---|
| 53 | -------------------- |
|---|
| 54 | |
|---|
| 55 | If autogen.sh reports errors, it may be that you need |
|---|
| 56 | to install/upgrade your versions of autoconf, automake and libtool. |
|---|
| 57 | Source for these can be obtained from: |
|---|
| 58 | |
|---|
| 59 | ftp://ftp.gnu.org/gnu/autoconf |
|---|
| 60 | ftp://ftp.gnu.org/gnu/automake |
|---|
| 61 | ftp://ftp.gnu.org/gnu/libtool |
|---|
| 62 | |
|---|
| 63 | Most likely it will be autoconf that will need updating - NeXus |
|---|
| 64 | now requires autoconf 2.61 or above |
|---|
| 65 | |
|---|
| 66 | NeXus Developer Mailing Lists |
|---|
| 67 | ----------------------------- |
|---|
| 68 | |
|---|
| 69 | CVS commit/log messages are automatically sent to the nexus-cvs@anl.gov |
|---|
| 70 | mailing list - if you wish to receive these, subscribe to the list via the link |
|---|
| 71 | |
|---|
| 72 | http://www.neutron.anl.gov/mailman/listinfo/nexus-cvs |
|---|
| 73 | |
|---|
| 74 | Any general developer questions should be directed to nexus-developers@anl.gov |
|---|
| 75 | list - you can subscribe to this via the link |
|---|
| 76 | |
|---|
| 77 | http://www.neutron.anl.gov/mailman/listinfo/nexus-developers |
|---|
| 78 | |
|---|
| 79 | $Id$ |
|---|
