Updates

git-svn-id: svn+ssh://svn.gna.org/svn/gnustep/tools/make/trunk@17936 72102866-910b-0410-8b05-ffd578937521

Documentation/gnustep-howto.texi

@@ -128,6 +128,8 @@ compatible with GPL, and in the hopes that if someone writes an openssl
 replacement, it can quickly be used by creating another bundle.
 
 @item libiconv (OPTIONAL)
+Note: Do not install this library unless you are sure you need it.
+iconv support except perhaps MinGW.
 Unicode support functions (iconv) come with glibc version 2.1 or greater. If
 you don't have glibc (try iconv --version), you can get the separate 
 libiconv library from 
@@ -135,6 +137,7 @@ libiconv library from
 neither one is required to use GNUstep.
 
 @item gnustep-objc package (for gcc version < 3.0 ONLY) (RECOMMENDED)
+Note: Do not install this library unless you are sure you need it.
 This is a special version of the Objective-C runtime that include several
 bug fixes and features that were not in gcc versions previous to 3.0.
 It is available at @url{ftp://ftp.gnustep.org/pub/gnustep/libs} which
@@ -145,10 +148,9 @@ just copy to the place where the gcc libobjc library is (type gcc -v to
 get this location). Note you have to install gnustep-make (below) before
 installing this library.
 
-@item GDB and Objective-C patch (OPTIONAL)
-GDB can be obtained from @url{ftp://ftp.gnu.org/gnu/gdb}. The patch to
-make it work better with GNUstep can be obtained from
-@url{ftp://ftp.gnustep.org/pub/gnustep/patches}
+@item GDB (OPTIONAL)
+GDB can be obtained from @url{ftp://ftp.gnu.org/gnu/gdb}. As of release
+6.0, gdb has special support for debugging Objective-C programs.
     
 @item TeX (OPTIONAL)
 You need a TeX implementation, like tetex, to compile some of the
@@ -238,7 +240,7 @@ gnustep-make you need to execute GNUstep's shell configuration
 script, as follows:
 
 @example
- . /usr/GNUstep/System/Makefiles/GNUstep.sh
+ . /usr/GNUstep/System/Library/Makefiles/GNUstep.sh
 @end example
 
 before proceeding any further. 
@@ -280,7 +282,7 @@ package to your shell startup file (such as @file{.profile}). For instance,
 if your GNUSTEP_SYSTEM_ROOT is @file{/usr/GNUstep/System},
 
 @example
-. /usr/GNUstep/System/Makefiles/GNUstep.sh
+. /usr/GNUstep/System/Library/Makefiles/GNUstep.sh
 @end example
 
 in your @file{.profile} file will work (Note the period at the beginning
@@ -296,7 +298,7 @@ set up GNUstep for every user on your system, you can try
 copying/linking the @file{GNUstep.sh} there. For csh or tcsh, try
 
 @example
-source /usr/GNUstep/System/Makefiles/GNUstep.csh
+source /usr/GNUstep/System/Library/Makefiles/GNUstep.csh
 @end example
 
 @node GNUstep Home, Time Zone, Environment Setup, Additional Installation

Documentation/machines.texi

@@ -91,7 +91,9 @@ gcc 3.2.2
 
 Default compiler has some odd memory(?) related problems.
 Use the GNU runtime. Download the gcc compiler and configure it with
---enable-threads=posix. Usually the installed compiler will produce object
+--enable-threads=posix. You don't need binutils or anything else.
+
+Optional: Usually the installed compiler will produce object
 files for the NeXT runtime if you don't say gcc -fgnu-runtime. To change
 this behaviour, edit src-dir/gcc/config/darwin.h: You have to change the
 word #define in line 73 to #undef. Then the runtime default is gnu. When
@@ -100,20 +102,21 @@ bootstrapping the compiler a nice working objective C gnu-runtime library
 and installed when make install. To use it, there is one (important) thing
 left: After installing the compiler, you have to go to
 install-dir/lib and produce the following dynamic link:
+@example
 ln -s libobjc.a libobjc.dylib
+@end example
 This might seem senseless, but it forces the linker to use this library
 instead of the NeXT-runtime!
 
-Make sure to configure gnustep-make with ./configure
---with-library-combo=gnu-gnu-gnu if you want to use all the GNUstep libraries.
-
 @item Extra libs needed 
 Use libffi (not ffcall). This should be enabled by default in gnustep-base
-so you don't have to type --enable-libffi. Also need the dlcompat library
-(from @url{www.opendarwin.org}) to load bundles.
+so you don't have to type --enable-libffi. Also you need the dlcompat library
+(from @url{www.opendarwin.org}) to load bundles (like the backend bundle).
 
 @item Special Instructions 
 
+Make sure to configure gnustep-make with ./configure
+--with-library-combo=gnu-gnu-gnu if you want to use all the GNUstep libraries.
 
 @end table
 

Documentation/userfaq.texi

@@ -401,7 +401,12 @@ make[1]: Leaving directory `/home/multix/gnustep-gui-0.8.6/Tools'
 make: *** [internal-all] Error 2
 @end example
 
-This means your GNU make is broken on your system. Try this:
+This means your GNU make is being overly protective. When you try to
+become root (e.g. to install something), certain environment variables
+like LD_LIBRARY_PATH are unset in order to reduce the possibility of
+a security breach.  If you are becoming root to install
+something, you need to exec the GNUstep.sh file as root, just as you
+do when you login. Although for simplicity, you can also try this:
 
 @example
 make LD_LIBRARY_PATH=$LD_LIBRARY_PATH