X-Git-Url: http://git.megacz.com/?p=ghc-hetmet.git;a=blobdiff_plain;f=docs%2Fbuilding%2Fbuilding.sgml;h=bd5246c598cf56cd7461655577c95f2a0a60adcc;hp=045aa9e37f050a0059c690edede2d791ce97ab34;hb=cab3c5cb1a0038412472172cb0b25bc81dfdde8f;hpb=a67323d3b8b65cad455646635f780919b406a595
diff --git a/docs/building/building.sgml b/docs/building/building.sgml
index 045aa9e..bd5246c 100644
--- a/docs/building/building.sgml
+++ b/docs/building/building.sgml
@@ -240,34 +240,10 @@
- [Windows users.] The programs ssh-keygen1, ssh1, and cvs,
- seem to lock up bash entirely if they try to get user input (e.g. if
- they ask for a password). To solve this, start up cmd.exe
- and run it as follows:
-
- c:\tmp> set CYGWIN32=tty
- c:\tmp> c:/user/local/bin/ssh-keygen1
-
+ Windows users: see the notes in about ssh wrinkles!
+
+
- [Windows users.] To protect your
- .ssh from access by anyone else,
- right-click your .ssh directory, and
- select Properties. If you are not on
- the access control list, add yourself, and give yourself
- full permissions (the second panel). Remove everyone else
- from the access control list. Don't leave them there but
- deny them access, because 'they' may be a list that
- includes you!
- [March 2003] In fact ssh 3.6.1 now seems to require
- you to have Unix permissions 600 (read/write for owner only)
- on the .ssh/identity file, else it
- bombs out. For your local C drive, it seems that chmod 600 identity works,
- but on Windows NT/XP, it doesn't work on a network drive (exact dteails obscure).
- The solution seems to be to set the CYGWIN environment
- variable to "ntsec neta". The CYGWIN environment variable is discussed
- in the Cygwin User's Guide,
- and there are more details in the Cygwin FAQ.
-
@@ -457,7 +433,7 @@ setsockopt IPTOS_THROUGHPUT: Invalid argument
modules (for a full list of the projects available, see
).
- Remeber that if you do not have
+ Remember that if you do not have
happy installed, you need to check it out
as well.
@@ -495,7 +471,14 @@ $ cvs diff
you the results.
-
+
+ If you changed something in the
+ fptools/libraries subdirectories, also run
+ make html to check if the documentation can
+ be generated successfully, too.
+
+
+
Before checking in a change, you need to update your
source tree:
@@ -578,7 +561,7 @@ $ cvs commit -F commit-message directory
major cause of headaches.
So, to avoid a lot of hassle, follow this recipe for
- updating your tree:
+ updating your tree:
$ cd fptools
@@ -758,11 +741,11 @@ $ cvs checkout nofib/spectral
- green-card
- green-cardproject
+ greencard
+ greencardproject
The Green Card
+ url="http://www.haskell.org/greencard/">GreenCard
system for generating Haskell foreign function
interfaces.
@@ -1220,7 +1203,7 @@ $ cvs checkout nofib/spectral
GCC 3.2 is currently known to have problems building
GHC on Sparc, but is stable on x86.
- GCC 3.3 currnetly cannot be used to build GHC, due to
+ GCC 3.3 currently cannot be used to build GHC, due to
some problems with the new C preprocessor.
If your GCC dies with “internal error” on
@@ -1254,7 +1237,7 @@ $ cvs checkout nofib/spectral
(fptools/happy). It can be built from
source, but bear in mind that you'll need GHC installed in
order to build it. To avoid the chicken/egg problem,
- install a binary distribtion of either Happy or GHC to get
+ install a binary distribution of either Happy or GHC to get
started. Happy distributions are available from Happy's Web
Page.
@@ -1275,7 +1258,7 @@ $ cvs checkout nofib/spectral
6.1.
Autoconf builds the configure
- script from configure.in and
+ script from configure.ac and
aclocal.m4. If you modify either of
these files, you'll need autoconf to
rebuild configure.
@@ -1432,7 +1415,7 @@ $ make install
- configure.in,
+ configure.ac,
config.sub,
config.guess: these files support the
configuration process.
@@ -1455,7 +1438,7 @@ $ make install
only one project (happy, say), you must have
a source tree whose root directory contains
Makefile, mk/,
- configure.in, and the project(s) you want
+ configure.ac, and the project(s) you want
(happy/ in this case). You cannot get by
with just the happy/ directory.
@@ -1572,20 +1555,20 @@ $ make install
issue the command
autoconfautoconf
(with no arguments). This GNU program converts
- $(FPTOOLS_TOP)/configure.in
+ $(FPTOOLS_TOP)/configure.ac
to a shell script called
$(FPTOOLS_TOP)/configure.
Some projects, including GHC, have their own
configure script. If there's an
- $(FPTOOLS_TOP)/<project>/configure.in,
+ $(FPTOOLS_TOP)/<project>/configure.ac,
then you need to run autoconf in that
directory too.
Both these steps are completely
platform-independent; they just mean that the
- human-written file (configure.in) can
+ human-written file (configure.ac) can
be short, although the resulting shell script,
configure, and
mk/config.h.in, are long.
@@ -1606,7 +1589,7 @@ $ make install
round your computer working out what architecture it has,
what operating system, whether it has the
vfork system call, where
- yacc is kept, whether
+ tar is kept, whether
gcc is available, where various obscure
#include files are, whether it's a
leap year, and what the systems manager had for lunch. It
@@ -1786,17 +1769,17 @@ GhcHcOpts=-DDEBUG -Rghc-timing
For example, there's a line that says:
-YACC = @YaccCmd@
+TAR = @TarCmd@
- This defines the Make variables YACC
- to the pathname for a yacc that
+ This defines the Make variables TAR
+ to the pathname for a tar that
configure finds somewhere. If you have your
- own pet yacc you want to use instead, that's
+ own pet tar you want to use instead, that's
fine. Just add this line to mk/build.mk:
-YACC = myyacc
+TAR = mytar
You do not have to have a
@@ -4341,6 +4324,73 @@ variable. You can always invoke find with an absolute path,
+Configuring SSH
+
+ssh comes with Cygwin, provided you remember to ask for it when
+you install Cygwin. (If not, the installer lets you update easily.) Look for openssh
+(not ssh) in the Cygwin list of applications!
+
+There are several strange things about ssh on Windows that you need to know.
+
+
+
+ The programs ssh-keygen1, ssh1, and cvs,
+ seem to lock up bash entirely if they try to get user input (e.g. if
+ they ask for a password). To solve this, start up cmd.exe
+ and run it as follows:
+
+ c:\tmp> set CYGWIN32=tty
+ c:\tmp> c:/user/local/bin/ssh-keygen1
+
+
+
+
+ssh needs to access your directory .ssh, in your home directory.
+To determine your home directory ssh first looks in
+c:/cygwin/etc/passwd (or wherever you have Cygwin installed). If there's an entry
+there with your userid, it'll use that entry to determine your home directory, ignoring
+the setting of the environment variable $HOME. If the home directory is
+bogus, ssh fails horribly. The best way to see what is going on is to say
+
+ ssh -v cvs.haskell.org
+
+which makes ssh print out information about its activity.
+
+ You can fix this problem, either by correcting the home-directory field in
+c:/cygwin/etc/passwd, or by simply deleting the entire entry for your userid. If
+you do that, ssh uses the $HOME environment variable instead.
+
+
+
+
+
+ To protect your
+ .ssh from access by anyone else,
+ right-click your .ssh directory, and
+ select Properties. If you are not on
+ the access control list, add yourself, and give yourself
+ full permissions (the second panel). Remove everyone else
+ from the access control list. Don't leave them there but
+ deny them access, because 'they' may be a list that
+ includes you!
+
+
+
+ In fact ssh 3.6.1 now seems to require
+ you to have Unix permissions 600 (read/write for owner only)
+ on the .ssh/identity file, else it
+ bombs out. For your local C drive, it seems that chmod 600 identity works,
+ but on Windows NT/XP, it doesn't work on a network drive (exact dteails obscure).
+ The solution seems to be to set the $CYGWIN environment
+ variable to "ntsec neta". The $CYGWIN environment variable is discussed
+ in the Cygwin User's Guide,
+ and there are more details in the Cygwin FAQ.
+
+
+
+
+
+
Other things you need to install
You have to install the following other things to build GHC: