Documentation updates

git-svn-id: svn+ssh://svn.gna.org/svn/gnustep/tools/make/trunk@17779 72102866-910b-0410-8b05-ffd578937521
This commit is contained in:
Adam Fedor 2003-10-05 02:21:04 +00:00
parent e9d21d10f0
commit 5d3d969588
5 changed files with 39 additions and 72 deletions

View file

@ -1,3 +1,9 @@
2003-10-04 Adam Fedor <fedor@gnu.org>
* GNUmakefile.in (dist): Remove
* Documentation/machines.texi: Doc updates.
* Documentation/faq.texi, Documentattion/userfaq.texi: Idem.
2003-09-29 Adam Fedor <fedor@gnu.org>
* Simplify use of user-defined flags.

View file

@ -60,7 +60,7 @@ Cocoa:
@item Do not use CoreFoundation
@item Do not use Objective-C++
@item Do not use Quicktime or other proprietary extension
@item You need to convert .nib files (see next question @pxref(Tools for porting))
@item You need to convert .nib files (see next question @pxref{Tools for porting})
@item Some unfinished classes include NSToolBar and Drawers.
@end itemize

View file

@ -17,13 +17,13 @@ more popular operating systems. Some machines marked with
* FreeBSD 4.x::
* FreeBSD 3.x::
* FreeBSD 2.x::
* GNU-Linux/Intel::
* GNU-Linux/PowerPC::
* Irix 6.5/MIPS::
* MkLinux/PowerPC::
* RedHat/Intel::
* NetBSD::
* Netwinder::
* OpenBSD 2.x::
* OpenBSD 3.x::
* OSF/Alpha::
* Slackware/Intel::
* Solaris 2.5.1/Sparc::
@ -83,7 +83,7 @@ you completely remove all of it, including installed init scripts.
@c -----------------------------------------
@node Darwin 6.x/PowerPC, Debian/DEC-Alpha, Machine Specific, Machine Specific
@section Darwin 6.x/PowerPC (@emph{Unstable!})
@section Darwin 6.x/PowerPC
@table @samp
@item Recommended compiler
@ -199,7 +199,7 @@ flags to configure: @code{CFLAGS="-I/usr/local/include"} and
@end table
@c -----------------------------------------
@node FreeBSD 2.x, GNU-Linux/Intel, FreeBSD 3.x, Machine Specific
@node FreeBSD 2.x, GNU-Linux/PowerPC, FreeBSD 3.x, Machine Specific
@section FreeBSD 2.x (@emph{Unstable!})
@table @samp
@ -226,60 +226,20 @@ You need to use gmake not make to compile the GNUstep packages.
@end table
@c -----------------------------------------
@node GNU-Linux/Intel, GNU-Linux/PowerPC, FreeBSD 2.x, Machine Specific
@section GNU-Linux/Intel (RedHat 5.x, 6.x, and 7.0)
@table @samp
@item Recommended compiler
With 5.x, the egcs compiler that comes with RedHat. Later versions may
have gcc installed, although 7.0 comes with a snapshot of gcc (called
2.96) which is unsuitable for compiling Objective-C code. For 7.0 you
should install the egcs compatibility packages (or an official gcc release).
For RedHat 7.2 or later, the default gcc apparently works fine
(even if it is 2.96)
@item Extra libs needed
Unknown
@item Special Instructions
Make sure you have a decent version of the compiler. Try @samp{cc -v}
or @samp{gcc -v} to get the version of the compiler.
With 5.x, make sure you set CC=egcs before configuring, as
in:
@example
export CC=egcs
configure ....
@end example
Since RedHat 5.x also comes standard with an old version of gcc.
On RedHat 7.0, configure like this
@example
CC=egcs LDFLAGS="-u shmctl@@GLIBC_2.2 -L/lib -lc -u getpwuid_r@@GLIBC_2.1.2
-L/lib -lc -u getpwnam_r@@GLIBC_2.1.2 -L/lib -lc" ./configure
@end example
@end table
@c -----------------------------------------
@node GNU-Linux/PowerPC, Irix 6.5/MIPS, GNU-Linux/Intel, Machine Specific
@node GNU-Linux/PowerPC, Irix 6.5/MIPS, FreeBSD 2.x, Machine Specific
@section GNU-Linux/PowerPC (LinuxPPC, Yellowdog)
@table @samp
@item Recommended compiler
The default compiler. gcc-3.x works, but you need a new gdb also to debug.
Standard
@item Extra libs needed
None.
Standard (ffcall or libffi)
@item Special Instructions
@end table
ffcall or libffi is required for
invocations (and DO) to work well. The major problem is sending data
with data sizes less than 4 bytes (chars, shorts, etc).
@c -----------------------------------------
@node Irix 6.5/MIPS, MkLinux/PowerPC, GNU-Linux/PowerPC, Machine Specific
@section Irix 6.5/MIPS
@ -307,7 +267,7 @@ No libffi-support: Use ffcall
@end table
@c -----------------------------------------
@node MkLinux/PowerPC, NetBSD, Irix 6.5/MIPS, Machine Specific
@node MkLinux/PowerPC, RedHat/Intel, Irix 6.5/MIPS, Machine Specific
@section MkLinux/PowerPC (@emph{Obsolete})
This configuration is no longer being tested, but it may still work.
@ -332,7 +292,22 @@ and glibc library (which has the threads library) and install both.
@end table
@c -----------------------------------------
@node NetBSD, Netwinder, MkLinux/PowerPC, Machine Specific
@node RedHat/Intel, NetBSD, MkLinux/PowerPC, Machine Specific
@section RedHat/Intel
@table @samp
@item Recommended compiler
Standard
@item Extra libs needed
Standard (ffcall or libffi)
@item Special Instructions
None
@end table
@c -----------------------------------------
@node NetBSD, Netwinder, RedHat/Intel, Machine Specific
@section NetBSD
@table @samp
@ -348,7 +323,7 @@ See the README.NetBSD file located in the gnustep-make package.
@end table
@c -----------------------------------------
@node Netwinder, OpenBSD 2.x, NetBSD, Machine Specific
@node Netwinder, OpenBSD 3.x, NetBSD, Machine Specific
@section Netwinder (@emph{Unstable!})
@table @samp
@ -363,8 +338,8 @@ See @url{http://www.netwinder.org/~patrix}
@end table
@c -----------------------------------------
@node OpenBSD 2.x, OSF/Alpha, Netwinder, Machine Specific
@section OpenBSD 2.x (@emph{Unstable!})
@node OpenBSD 3.x, OSF/Alpha, Netwinder, Machine Specific
@section OpenBSD 3.x (@emph{Unstable!})
@table @samp
@item Recommended compiler
@ -374,12 +349,11 @@ Unknown
Unknown
@item Special Instructions
Can only compile with static libraries. Gives a lot of warnings.
Try reading the README.NetBSD which might work the same on OpenBSD.
@end table
@c -----------------------------------------
@node OSF/Alpha, Slackware/Intel, OpenBSD 2.x, Machine Specific
@node OSF/Alpha, Slackware/Intel, OpenBSD 3.x, Machine Specific
@section OSF Alpha (@emph{Unstable!})
@c Contact: suzukis@file.phys.tohoku.ac.jp
@ -453,7 +427,6 @@ No libffi-support unless you use the patch
@url{http://gcc.gnu.org/ml/java-patches/2002-q3/msg00036.html} (not
particularly recommended).
Using a POSIX shell (zsh or bash, which should come with Solaris) is
highly recommended. In fact, some functions, such as compiling frameworks,
will not work without it.
@ -671,7 +644,7 @@ for shared libs. It's a good idea to remove the libobjc.a that comes with gcc
(gcc -v for location) so that it isn't accidentally found.
For ffcall, you should get version 1.8b or above (the earlier ones don't
compile). There are still some problems with structure passing, but that is
generally not supportred on any architecture.
generally not supportred on any architecture. libffi not supported.
@item Special Instructions
On later versions of Cygwin you may be required to include the win32api

View file

@ -378,6 +378,7 @@ Windows).
* Problems with Alt key::
* Problems with gcc3::
* Problems with fonts::
* No Makefile::
@end menu
@node Problems compiling (loading shared libs), Problems compiling (GNUstep Internal Error), Troubleshooting, Troubleshooting
@ -447,7 +448,7 @@ Mouse Preferences. Then use another value for the "Mouse grab modifier"
Don't forget you need to update binutils and libc also.
@node Problems with fonts, , Problems with gcc3, Troubleshooting
@node Problems with fonts, No Makefile, Problems with gcc3, Troubleshooting
@subsection Problems with fonts
Why do the characters get changed to asterisks ('*')?
@ -479,7 +480,7 @@ better. When compiling gnustep-back, start with
./configure --enable-graphics=art
@end example
@node No Makefile, , Problems with gcc3, Troubleshooting
@node No Makefile, , Problems with fonts, Troubleshooting
@subsection No Makefile
I tried to compile something and I get:

View file

@ -257,19 +257,6 @@ cvs-snapshot:
tar --gzip -cf gnustep-make-$(GNUSTEP_MAKE_VERSION).tar.gz gnustep-make-$(GNUSTEP_MAKE_VERSION)
rm -rf gnustep-make-$(GNUSTEP_MAKE_VERSION)
dist:
@echo "Generating gnustep-make-$(GNUSTEP_MAKE_VERSION).tar.gz"; \
echo "in the parent directory..."; \
SNAPSHOT_DIR=`basename $$(pwd)`; \
cd ..; \
if [ "$$SNAPSHOT_DIR" != "gnustep-make-$(GNUSTEP_MAKE_VERSION)" ]; then \
mv $$SNAPSHOT_DIR gnustep-make-$(GNUSTEP_MAKE_VERSION); \
fi; \
tar cfz gnustep-make-$(GNUSTEP_MAKE_VERSION).tar.gz gnustep-make-$(GNUSTEP_MAKE_VERSION); \
if [ "$$SNAPSHOT_DIR" != "gnustep-make-$(GNUSTEP_MAKE_VERSION)" ]; then \
mv gnustep-make-$(GNUSTEP_MAKE_VERSION) $$SNAPSHOT_DIR; \
fi;
test-RPM_TOPDIR:
@(if [ -z "$(RPM_TOPDIR)" ]; then \
echo "Error - RPM_TOPDIR variable not set."; \