office-gobmx/config_office
Rüdiger Timm 1ed9828013 INTEGRATION: CWS ooo20040704 (1.45.20); FILE MERGED
2004/07/04 03:09:22 waratah 1.45.20.1: #i28835#  Implement a switch for non-product builds without full debugging
2004-09-08 14:24:05 +00:00
..
aclocal.m4 INTEGRATION: CWS ooo20040704 (1.3.34); FILE MERGED 2004-09-08 14:23:18 +00:00
bootstrap.1 INTEGRATION: CWS geordi2q11 (1.14.4); FILE MERGED 2003-12-17 14:00:10 +00:00
configure INTEGRATION: CWS ooo20040704 (1.45.2); FILE MERGED 2004-09-08 14:23:34 +00:00
configure.in INTEGRATION: CWS ooo20040704 (1.64.2); FILE MERGED 2004-09-08 14:23:49 +00:00
makefile.rc INTEGRATION: CWS ooo20040704 (1.45.20); FILE MERGED 2004-09-08 14:24:05 +00:00
README INTEGRATION: CWS mh11rc (1.8.16); FILE MERGED 2003-06-12 09:15:33 +00:00
set_soenv.in INTEGRATION: CWS pj01 (1.19.4); FILE MERGED 2004-09-08 11:26:43 +00:00

Various unresolved issues with configure:
----------------------------------------

* --with-gcc-home may cause a warning message to be displayed even if the
  correct version of gcc is found. This should be harmless.

* It is at present time not possible to use --with-local-solenv to point
  to a solenv residing at a non-standard location.

* The configure script also creates a bootstrap script in the top-level
  directory to support the creation of the build executable tools needed to
  bootstrap the build process. These tools normally reside in the
  solenv/$OUTPATH/bin directory for the supported platforms. It is hoped that
  these tools will be removed from the solenv tree at some stage.

Running configure on Windows NT:
-------------------------------

* configure must be run from the Cygnus bash shell. On the bash command line
  type "bash configure <options>" to run the script. The generated winenv.bat
  file must then be executed from the 4NT shell in which you will be building
  OpenOffice.org

* The path to the Microsoft C/C++ compiler home directory must be given as an
  MS-DOS format path on the command line with the configure option
  --with-cl-home. MS-DOS format names are <8 characters in length and don't
  contain spaces. To get the MS-DOS format of a Windows pathname select the
  directory in a window and right-click and choose properties.   

* configure automatically copies the top level makefile.rc from the
  config_office directory to the top level directory when run. If you are not
  running configure and are using a pre-generated winenv.bat to set up the
  build environment, then you must manually copy the makefile.rc file in
  config_office to the top level directory.

* It is recommended that you close the Cygnus bash shell before you start the
  build as it might cause problems later on.


Some quasi standards for configure
----------------------------------

* configure will use four type of parameters:

   --with-xyz-home  to locate an executable tool and related libraries, eg jdk.
   
   --with-xyz to locate a library of that type

   --without-xyz to disable a library,  not always available.

   --enable-xyz to set a compile feature such as debugging.

* Try and make tests as generic as possible, specific is good for early testing
  of a feature but don't keep the pattern,  make it generic quickly.

* configure should terminate with an error if it does not locate something that
  is needed for a build to succeed, note that this conflicts with previous
  standards which had a manual entry override.  This is less than successful
  configure either works or it fails, no data entry allowed.

Premises for configure
----------------------

* This is not a true autoconf project.  The code base is huge and the ability
  to test for everything is impossible.  We are currently supporting only a
  subset of compilers therefore do not need a lot of testing on compiler
  capabilities.