From: Bill Stoddard Date: Fri, 21 Apr 2000 13:57:43 +0000 (+0000) Subject: Win32: Update docs to reflect new build environment. X-Git-Tag: APACHE_2_0_ALPHA_3~71 X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=a8065b5af2b94e61bd9799ed1c089b23581f3d45;p=thirdparty%2Fapache%2Fhttpd.git Win32: Update docs to reflect new build environment. Submitted by: William Rowe git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@85009 13f79535-47bb-0310-9956-ffa450edef68 --- diff --git a/docs/manual/platform/win_compiling.html b/docs/manual/platform/win_compiling.html index 54970ea86d0..734521819f3 100644 --- a/docs/manual/platform/win_compiling.html +++ b/docs/manual/platform/win_compiling.html @@ -14,22 +14,6 @@ > - - - -Using Apache with Microsoft Windows - - - - - -

Compiling Apache for Microsoft Windows

There are many important points before you begin compiling Apache. @@ -47,7 +31,7 @@

The master Apache makefile instructions are contained in the Makefile.win file. To compile Apache on Windows, simply - use one of the following commands: + use one of the following commands:

nmake /f Makefile.win _apacher (release build)
nmake /f Makefile.win _apached (debug build) @@ -64,56 +48,106 @@ Project files (.DSP) are included for each of the portions of Apache. To build Apache from the these projects files you will need to build the following projects in this order: - This needs updating for Apache 2.0 -
1. os\win32\ApacheOS.dsp + +
  1. regex\regex.dsp +
  2. lib\apr\aprlib.dsp
  3. ap\ap.dsp
  4. main\gen_uri_delims.dsp
  5. main\gen_test_char.dsp
  6. ApacheCore.dsp
  7. Apache.dsp -
  - - In addition, the src\os\win32 subdirectory contains - project files for the optional modules (see below).
  +
+ + In addition, the os\win32 subdirectory contains + project files for the optional modules. + +
1. os\win32\ApacheModuleAuthAnon.dsp +
2. os\win32\ApacheModuleCERNMeta.dsp +
3. os\win32\ApacheModuleDigest.dsp +
4. os\win32\ApacheModuleExpires.dsp +
5. os\win32\ApacheModuleHeaders.dsp +
6. os\win32\ApacheModuleInfo.dsp +
7. os\win32\ApacheModuleRewrite.dsp +
8. os\win32\ApacheModuleSpeling.dsp +
9. os\win32\ApacheModuleStatus.dsp +
10. os\win32\ApacheModuleUserTrack.dsp +
+ + The support\ folder contains project files for additional + programs that are not part of the apache runtime, but are used by + the administrator to maintain password and log files.
+ +
1. support\htdigest.dsp +
2. support\htpasswd.dsp +
3. support\logresolve.dsp +
4. support\rotatelogs.dsp +
Once Apache has been compiled, it needs to be installed in its server root directory. The default is the \Apache directory, on the current hard drive.
-
To install the files into the \Apache directory - automatically, use one the following nmake commands (see above):
+
To build and install all the files into the desired folder dir + automatically, use one the following nmake commands: +
- nmake /f Makefile.win installr INSTDIR=dir - (for release build) -
- nmake /f Makefile.win installd INSTDIR=dir - (for debug build) +
- nmake /f Makefile.win installr INSTDIR=dir + (for release build) +
- nmake /f Makefile.win installd INSTDIR=dir + (for debug build)
-The dir argument to INSTDIR gives the installation directory; it can -be omitted if Apache is to be installed into \Apache. + The dir argument to INSTDIR gives the installation directory; it can + be omitted if Apache is to be installed into \Apache.

This will install the following:
- dir\Apache.exe - Apache executable -
- dir\ApacheCore.dll - Main Apache shared library +
- dir\aprlib.dll - Apache Portable Runtime shared library +
- dir\ApacheCore.dll - Apache Core application
- dir\modules\ApacheModule*.dll - Optional Apache modules (7 files) +
- dir\support\*.exe - Administrator support executables
- dir\conf - Empty configuration directory
- dir\logs - Empty logging directory
If you do not have nmake, or wish to install in a different directory, - be sure to use a similar naming scheme.
- -
-Before running the server you must fill out the conf directory. -Copy the *.conf-dist-win from the distribution conf directory -and rename *.conf. Edit the @@ServerRoot@@ entries to your -actual server root (for example "C:\apache"). Copy over -the conf/magic and conf/mime.types files as well. + be sure to use a similar naming scheme, or use the following shortcut.
+ +
To simplify the process, dependencies between all projects + are defined in the Microsoft VisualStudio workspace file: + +
```
+   src/Apache.dsw
+
```
+ + This assures that lower-level sources are rebuilt from within + VisualStudio. The top level project is InstallBin, which invokes + Makefile.win to move the compiled executables and dlls. You may + 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.
+ +
Warning about building Apache from the development tree
+ +
Only the .dsp files are distributed between release builds. The + .mak files are NOT regenerated, due to the tremendous waste of + reviewer's time. Therefore, you cannot rely on the NMAKE commands + above unless you -frequently- export all .mak files yourself from + the project. This is unnecessary if you build from withing the + Microsoft DeveloperStudio environment.
+ +
Before running the server you must fill out the conf directory. + Copy the *.conf-dist-win from the distribution conf directory + and rename *.conf. Edit the @@ServerRoot@@ entries to your + actual server root (for example "C:\apache"). Copy over + the conf/magic and conf/mime.types files as well.