From 73f90fb04090f67df057856c7857d7477d64622d Mon Sep 17 00:00:00 2001 From: panne Date: Wed, 2 Jun 2004 09:23:43 +0000 Subject: [PATCH] [project @ 2004-06-02 09:23:43 by panne] Extremely strange: Some backend emit an ugly trailing ">" when "xref" is an empty element, but none when only a start tag is used. *sigh* So let's revert this part of the changes for now... --- docs/building/building.sgml | 88 +++++++++++++++++++++---------------------- 1 file changed, 44 insertions(+), 44 deletions(-) diff --git a/docs/building/building.sgml b/docs/building/building.sgml index 312106a..7b150d8 100644 --- a/docs/building/building.sgml +++ b/docs/building/building.sgml @@ -23,7 +23,7 @@ now provided in the user guide. The bulk of this guide applies to building on Unix - systems; see for Windows notes. + systems; see for Windows notes. @@ -82,7 +82,7 @@ scratch. More information about our CVS repository can be found - in . + in . @@ -111,8 +111,8 @@ Getting access to the CVS Repository You can access the repository in one of two ways: - read-only (), or read-write (). + read-only (), or read-write (). Remote Read-only CVS Access @@ -150,7 +150,7 @@ - Now go to . + Now go to . @@ -234,7 +234,7 @@ Protocol 1 - Windows users: see the notes in about ssh wrinkles! + Windows users: see the notes in about ssh wrinkles! @@ -413,7 +413,7 @@ $ cvs checkout ghc hslibs libraries you need at least the ghc, hslibs and libraries modules (for a full list of the projects available, see - ). + ). Remember that if you do not have happy and/or Alex @@ -864,21 +864,21 @@ $ cvs checkout nofib/spectral Use an appropriate machine / operating system. lists the supported platforms; if + linkend="sec-port-info"> lists the supported platforms; if yours isn't amongst these then you can try porting GHC (see - ). + ). Be sure that the “pre-supposed” utilities are - installed. + installed. elaborates. If you have any problem when building or installing the Glasgow tools, please check the “known pitfalls” (). Also check the FAQ for the + linkend="sec-build-pitfalls">). Also check the FAQ for the version you're building, which is part of the User's Guide and available on the GHC web site. @@ -1201,7 +1201,7 @@ $ cvs checkout nofib/spectral GHC is required to build many of the tools, including GHC itself. If you need to port GHC to your platform because there isn't a binary distribution of GHC available, - then see . + then see . Which version of GHC you need will depend on the packages you intend to build. GHC itself will normally @@ -1414,7 +1414,7 @@ $ cvs checkout nofib/spectral More tools are required if you want to format the documentation that comes with GHC and other fptools projects. See . + linkend="building-docs">. @@ -1536,7 +1536,7 @@ $ make install includes sources for the X11 lndir—check out fptools/glafp-utils/lndir). See for a typical invocation. + linkend="sec-storysofar"> for a typical invocation. The build tree does not need to be anywhere near the source tree in the file system. Indeed, one advantage of @@ -1545,7 +1545,7 @@ $ make install support people from backing up untold megabytes of easily-regenerated, and rapidly-changing, gubbins. The golden rule is that (with a single exception—) absolutely everything in + linkend="sec-build-config">) absolutely everything in the build tree is either a symbolic link to the source tree, or else is mechanically generated. It should be perfectly OK for your build tree to vanish overnight; an hour or @@ -1863,7 +1863,7 @@ $ make install myfptools (it does not have to be called fptools). Make sure that you have the essential files (see ). + linkend="sec-source-tree">). @@ -2186,7 +2186,7 @@ $ mkshadowdir . /scratch/joe-bloggs/myfptools-sun4 is only available in the root directory $(FPTOOLS_TOP); it has been discussed in . + linkend="sec-build-config">. @@ -2369,7 +2369,7 @@ directive. As its name suggests, boilerplate.mk consists of a large quantity of standard Makefile code. We discuss this - boilerplate in more detail in . + boilerplate in more detail in . include, directive in Makefiles Makefile inclusion @@ -2420,7 +2420,7 @@ directive. (the executable binary to be built). We will discuss in more detail what the “standard variables” are, and how they affect what happens, in . + linkend="sec-targets">. The definition for SRCS uses the useful GNU make construct @@ -2440,11 +2440,11 @@ directive. target.mktarget.mk. It contains the rules that tell gmake how to make the standard targets (). Why, you ask, can't this + linkend="sec-standard-targets">). Why, you ask, can't this standard code be part of boilerplate.mk? Good question. We discuss the reason later, in . + linkend="sec-boiler-arch">. You do not have to include the @@ -2454,7 +2454,7 @@ directive. canned rules in target.mk; the price tag is that you have to understand what canned rules get enabled, and what they do (). + linkend="sec-targets">). @@ -2644,7 +2644,7 @@ directive. target.mk contains make rules for the standard targets - described in . These + described in . These rules are selectively included, depending on the setting of certain make variables. These variables are usually set in the middle section of the @@ -2717,7 +2717,7 @@ directive. is the build configuration file we discussed at - length in . + length in . @@ -2928,7 +2928,7 @@ directive. strings to pass to each program. For example, it defines HC_OPTSHC_OPTS, the option strings to pass to the Haskell compiler. See - . + . @@ -2938,7 +2938,7 @@ directive. defines standard pattern rules—see . + linkend="sec-suffix">. @@ -3022,7 +3022,7 @@ directive. mp. The variable WAY_CC_OPTS holds options to pass to the C compiler when compiling the - standard way. ( dicusses + standard way. ( dicusses multi-way compilation.) @@ -3056,7 +3056,7 @@ directive. target.mk contains canned rules for all the standard targets described in . It is complicated by the fact + linkend="sec-standard-targets">. It is complicated by the fact that you don't want all of these rules to be active in every Makefile. Rather than have a plethora of tiny files which you can include selectively, there is a single @@ -3182,7 +3182,7 @@ directive. When SUBDIRS is defined, target.mk includes a rather neat rule for - the standard targets ( that + the standard targets ( that simply invokes make recursively in each of the sub-directories. @@ -3272,7 +3272,7 @@ directive. want these targets built for. The mechanism here is very much like the recursive invocation of make in sub-directories (). It is up to you to set + linkend="sec-subdirs">). It is up to you to set WAYS in your Makefile; this is how you control what ways will get built. @@ -3593,14 +3593,14 @@ $ make install supported (or perhaps has been supported in the past, but currently isn't). This is the easiest type of porting job, but it still requires some careful bootstrapping. Proceed to - . + . Your system's hardware architecture isn't supported by GHC. This will be a more difficult port (though by comparison perhaps not as difficult as porting gcc). Proceed to . + linkend="unregisterised-porting">. @@ -3626,7 +3626,7 @@ $ make install supplied on the GHC download page, otherwise you'll have to compile some up yourself, or start from unregisterised HC files - see . + linkend="unregisterised-porting">. The following steps should result in a working GHC build with full libraries: @@ -3880,7 +3880,7 @@ $ make hc-file-bundle Project=Ghc from the intermediate C files we generated above. The process of bootstrapping from C files is automated by the script in distrib/hc-build, and is - described in . + described in . $ ./distrib/hc-build --enable-hc-boot-unregisterised @@ -3943,7 +3943,7 @@ Hello World! Macros that cooperate with the mangler (see ) to make proper tail-calls + linkend="sec-mangler">) to make proper tail-calls work. @@ -4160,7 +4160,7 @@ above. -and try again: gmake. (see for information about +and try again: gmake. (see for information about <module>_HC_OPTS.) Alternatively, just cut to the chase: @@ -4447,7 +4447,7 @@ installing and running GHC may be found in the user guide. In general, Win95/Win98 behave the same, and WinNT/Win2k behave the same. -Make sure you read the preceding section on platforms () +Make sure you read the preceding section on platforms () before reading section. You don't need Cygwin or MSYS to use GHC, but you do need one or the other to build GHC. @@ -4640,7 +4640,7 @@ they don't recognise symlinks. -See the notes in about find and bzip, +See the notes in about find and bzip, which apply to Cygwin too. @@ -4757,7 +4757,7 @@ Make sure the installation directory is in your GHC uses the mingw C compiler to -generate code, so you have to install that (see ). +generate code, so you have to install that (see ). Just pick up a mingw bundle at http://www.mingw.org/. We install it in c:/mingw. @@ -4784,7 +4784,7 @@ so you will need to add emacs/bin to your PATH Finally, check out a copy of GHC sources from -the CVS repository, following the instructions above (). +the CVS repository, following the instructions above (). @@ -4794,7 +4794,7 @@ the CVS repository, following the instructions above (Building GHC OK! -Now go read the documentation above on building from source (); +Now go read the documentation above on building from source (); the bullets below only tell you about Windows-specific wrinkles. @@ -4827,7 +4827,7 @@ Solution: delete configure first. ./configure --host=i386-unknown-mingw32 --with-gcc=c:/mingw/bin/gcc This is the point at which you specify that you are building GHC-mingw -(see ). +(see ). Both these options are important! It's possible to get into trouble using the wrong C compiler! @@ -4857,7 +4857,7 @@ Be warned! -If you want to build GHC-cygwin () +If you want to build GHC-cygwin () you'll have to do something more like: ./configure --with-gcc=...the Cygwin gcc... @@ -4872,7 +4872,7 @@ can be really confusing. You almost certainly want to set SplitObjs = NO -in your build.mk configuration file (see ). +in your build.mk configuration file (see ). This tells the build system not to split each library into a myriad of little object files, one for each function. Doing so reduces binary sizes for statically-linked binaries, but on Windows it dramatically increases the time taken to build the libraries in the first place. -- 1.7.10.4