very minor changes

[wxWidgets.git] / docs / motif / install.txt

diff --git a/docs/motif/install.txt b/docs/motif/install.txt
index 7860a169a7a0ffc6eeedcbf7c3b0be26ffe9e212..740a726ea9420dcddd45c4f62e93e4622d8ac28b 100644 (file)
--- a/docs/motif/install.txt
+++ b/docs/motif/install.txt
@@ -19,19 +19,39 @@ COMPILING USING CONFIGURE
   you can follow the following steps to use the simpler (but
   less automatic) makefile system. If using configure, the
   following script should make the library and samples, when
   you can follow the following steps to use the simpler (but
   less automatic) makefile system. If using configure, the
   following script should make the library and samples, when

-  run from the top-level wxWindows directory (see also 'makewx'
-  in this directory):
-
-  # Make wxMotif using the configure system
-  chmod a+x install/unix/config.sub
-  install/unix/setup/general/* \
-    install/unix/config.guess install/unix/setup/shared/*
-  cd install/unix
-  autoconf && ./configure --with-shared --with-motif --with-debug_flag \
-   --with-debug_info --without-threads
-  cd ../..
+  run from the top-level wxWindows directory (see also 'makewxmotif'
+  in this directory). Make this script executable with the command
+  chmod a+x makewxmotif.
+
+  -------:x-----Cut here-----:x-----
+  # makewxmotif
+  # Sets permissions (in case we extracted wxMotif from zip files)
+  # and makes wxMotif.
+  # Call from top-level wxWindows directory.
+  # Note that this uses standard (but commonly-used) configure options;
+  # if you're feeling brave, you may wish to compile with threads.
+  # -- Julian Smart
+  chmod a+x configure config.sub config.guess setup/general/* setup/shared/*
+  ./configure --with-shared --with-motif --without-gtk --with-debug_flag --with-debug_info --without-threads

   make makefiles
   make
   make makefiles
   make

+  -------:x-----Cut here-----:x-----
+
+  This script will build wxMotif using shared libraries.
+
+- Change directory to a sample e.g. samples/minimal, and type make.
+  The binary will end up under the Linux (or other appropriate) subdirectory.
+
+- To build an application outside the wxWindows hierarchy, you can
+  use `wx-config --cflags` when compiling source files and `wx-config --libs`
+  when linking, where wx-config is in the wxWindows root directory.
+  These invocations return the appropriate flags for the compiler.
+
+- When compiling certain utilities such as Dialog Editor, you may find
+  that the makefile refers to wx-config as above. Unless you have used
+  "make install" to install wxWindows, wx-config won't be found, so
+  either edit the makefile to hard-wire the flags, or place wx-config
+  where it will be found by the makefile.

 
 COMPILING USING MAKEFILES
 
 
 COMPILING USING MAKEFILES
 


@@ -46,8 +66,6 @@ COMPILING USING MAKEFILES
 
     export WXWIN=/home/jacs/wx2
 
 
     export WXWIN=/home/jacs/wx2
 

-  Later, there will be a better makefile system
-  and/or alternate make.env files as per wxWindows 1.68.

   Please feel free to contribute settings files for your environment.
 
 - Change directory to src/motif and type:
   Please feel free to contribute settings files for your environment.
 
 - Change directory to src/motif and type:


@@ -55,7 +73,10 @@ COMPILING USING MAKEFILES
     make -f makefile.unx motif
 
   This should make the library libwx_motif.a in the lib
     make -f makefile.unx motif
 
   This should make the library libwx_motif.a in the lib

-  directory.
+  directory. Note that this makefile system does not build shared
+  libraries, only static ones (that is, the wxWindows library will be
+  linked statically; to see remaining dependencies on shared libraries,
+  type e.g. ldd minimal_motif).

 
 - Make a sample, such as the minimal sample:
 
 
 - Make a sample, such as the minimal sample:
 


@@ -68,19 +89,29 @@ Notes:
 ------
 
 - Better installation and makefile systems are
 ------
 
 - Better installation and makefile systems are

-  required. Although the wxGTK config system can be used to make
-  wxMotif and samples, it can't easily be made to work
-  with applications outside the wxWindows hierarchy. Hence the
-  simple makefile system.
+  required. A revised configure system is in preparation.

 
 - Debugging mode is switched on by default. To compile in non-debug
 
 - Debugging mode is switched on by default. To compile in non-debug

-  mode, remove the -D__WXDEBUG__ switch in make.env.
+  mode, remove the -D__WXDEBUG__ switch in make.env (or if using the
+  configure system, change --with-debug_flag to --without_debug_flag
+  and --with-debug_info to --without-debug_info in the makewxmotif
+  script).

 
 - Some classes can be switched off in include/wx/motif/setup.h,
   if you are having trouble with a particular file. However,
   I'd prefer you to fix the problem and send the fix to me :-) or at
   least let me know about it.
 
 
 - Some classes can be switched off in include/wx/motif/setup.h,
   if you are having trouble with a particular file. However,
   I'd prefer you to fix the problem and send the fix to me :-) or at
   least let me know about it.
 

+- Thread support is switched off by default in setup.h (wxUSE_THREADS)
+  because standard Unices often do not have the necessary thread library
+  installed. Please see ../docs/gtk/install.txt for more details on this.
+  For Linux, the problem is expected to go away with future
+  distributions of the operating system.
+
+- If you have trouble compiling the file y_tab.c, or have strange
+  linking errors, check whether you're using a C or C++ compiler for this file.
+  You should specify a C compiler in the CCLEX variable in src/make.env.
+

 - If you run into problems with a missing X11/Xpm.h header, you
   need to install the XPM package. It can be obtained from:
 
 - If you run into problems with a missing X11/Xpm.h header, you
   need to install the XPM package. It can be obtained from:
 


@@ -101,5 +132,5 @@ Notes:
     wxwin-users@wx.dent.med.uni-muenchen.de
 
 
     wxwin-users@wx.dent.med.uni-muenchen.de
 
 

-Julian Smart, December 1998.
+Julian Smart, January 1999.

 julian.smart@ukonline.co.uk
 julian.smart@ukonline.co.uk