wrowe 00/12/18 16:00:21
Modified: htdocs/manual win_compiling.html
Log:
Document the use of awk and other minor changes. Remove the language
about copying files that are now handled by InstallBin.dsp/Makefile.win.
Revision Changes Path
1.8 +23 -28 httpd-docs-1.3/htdocs/manual/win_compiling.html
Index: win_compiling.html
===================================================================
RCS file: /home/cvs/httpd-docs-1.3/htdocs/manual/win_compiling.html,v
retrieving revision 1.7
retrieving revision 1.8
diff -u -r1.7 -r1.8
--- win_compiling.html 2000/12/13 15:54:04 1.7
+++ win_compiling.html 2000/12/19 00:00:20 1.8
@@ -21,14 +21,29 @@
before you begin.</P>
<P>Compiling Apache requires Microsoft Visual C++ 5.0 or 6.0 to be properly
- installed. It can be built with command-line tools, or within the
+ installed. It can be built with command-line tools, or within the
Visual Studio environment. Consult the VC++ manual to determine how
to install them. Be especially aware that the vcvars32.bat file
from the Program Files/DevStudio/VC/bin folder, and the setenv.bat file
from the Platform SDK may be required to prepare the command-line tools
- for command-line builds (e.g. using nmake).</P>
+ for command-line builds (e.g. using nmake). To install apache with the
+ Makefile.win or the InstallBin project in the Visual Studio IDE, the
+ awk utility is also required.</P>
+
+<P>First, you should install awk.exe where it can be found in the path and
+ the DevStudio environment, if you plan to use the IDE. There are many
+ versions of awk available for Windows, the easiest to install is available
+ from Brian Kernighan's <a href="http://cm.bell-labs.com/cm/cs/who/bwk/"
+ >http://cm.bell-labs.com/cm/cs/who/bwk/</a> site. When downloading
+ site <a href="http://cm.bell-labs.com/cm/cs/who/bwk/awk95.exe"
+ >http://cm.bell-labs.com/cm/cs/who/bwk/awk95.exe</a> from this site,
+ you must save it with the name awk.exe rather than awk95.exe.</P>
+
+<P>Note that DevStudio will only find awk.exe from the <u>T</u>ools menu
+ <u>O</u>ptions... Directories settings of the Executable files. Add
+ the path for awk.exe to this list, as needed.</P>
-<P>First, unpack the Apache distribution into an appropriate
+<P>Then unpack the Apache distribution into an appropriate
directory. Open a command-line prompt, and change to the
<CODE>src</CODE> subdirectory of the Apache distribution.</P>
@@ -73,7 +88,9 @@
Apache.dsw, is provided in the <CODE>src</CODE> folder. This workspace
exposes the entire list of working .dsp projects that are required for the
complete Apache binary release. It includes dependencies between
- the projects to assure that they are built in the appropriate order.</P>
+ the projects to assure that they are built in the appropriate order.
+ InstallBin is the top-level project that will build all other projects,
+ and install the compiled files into their proper locations.</P>
<P>These .dsp project files are distributed in Visual C++ 6.0 format. Visual
C++ 5.0 (97) will recognize them with the single exception of the /ZI
flag,
@@ -188,30 +205,8 @@
personalize the INSTDIR= setting by changing the Settings for
InstallBin, Build command line entry under the General tab.
The default from within the InstallBin.dsp project is one level up
- (..) from the src tree.</P>
-
-<P>Before running the server you must fill out the conf directory. Copy the
- *.conf-dist-win from the distribution conf directory and rename them to
- *.conf. You will need to copy over the conf/magic and conf/mime.types
- files as well. In order to serve documents you will need to create a
- htdocs\index.html or just copy over the standard Apache ones (This is a
- good idea as then you get the full Apache documentation on line). If you
- have previously run Apache from the c:\ServerRoot directory then please
make
- sure you backup any files you wish to retain or only copy the files you
want
- replaced. The following commands will copy all the required files to your
- c:\ServerRoot directory (***over-writing any that were there***);</P>
-
-<UL>
-<LI><CODE>xcopy ..\conf\*.conf-dist-win
<EM>c:\ServerRoot</EM>\conf\*.conf</CODE>
-<LI><CODE>xcopy ..\conf\magic <EM>c:\ServerRoot</EM>\conf\</CODE>
-<LI><CODE>xcopy ..\conf\mime.types <EM>c:\ServerRoot</EM>\conf\</CODE>
-<LI><CODE>xcopy ..\htdocs\*.* <EM>c:\ServerRoot</EM>\htdocs\ /s</CODE>
-</UL>
-<P>(adjust these so <EM>c:\ServerRoot</EM> matches the INSTDIR used
above.)</P>
-
-<P>Change the @@ServerRoot@@ entries in
<EM>c:\ServerRoot</EM>\conf\httpd.conf
- to your actual server root (for example "<EM>c:/ServerRoot</EM>" Note:
you
- must use forward slashes in Apache configuration files!)</P>
+ (..) from the src tree. Modify the InstallBin settings and edit
+ the INSTDIR=.. entry to the desired target directory.</P>
<!--#include virtual="footer.html" -->
</BODY>