You are viewing a plain text version of this content. The canonical link for it is here.
Posted to cvs@httpd.apache.org by wr...@locus.apache.org on 2000/05/11 05:39:40 UTC
cvs commit: apache-2.0/htdocs/manual win_compiling.html windows.html
wrowe 00/05/10 20:39:40
Modified: htdocs/manual win_compiling.html windows.html
Log:
Clean up documentation on both sides (1.3 and 2.0) for the Win32 build.
Revision Changes Path
1.3 +27 -21 apache-2.0/htdocs/manual/win_compiling.html
Index: win_compiling.html
===================================================================
RCS file: /home/cvs/apache-2.0/htdocs/manual/win_compiling.html,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- win_compiling.html 2000/04/21 13:57:43 1.2
+++ win_compiling.html 2000/05/11 03:39:39 1.3
@@ -23,7 +23,9 @@
<P>Compiling Apache requires Microsoft Visual C++ 5.0 (or later) to be
properly installed. It is easiest to compile with the command-line tools
(nmake, <EM>etc.</EM>..). Consult the VC++ manual to determine how to install
- them.</P>
+ them. Be especially aware that the vcvars32.bat file from the
+ Program Files/DevStudio/VC/bin folder may be required to prepare the
+ command-line environment for command-line builds!</P>
<P>First, unpack the Apache distribution into an appropriate
directory. Open a command-line prompt, and change to the
@@ -37,26 +39,27 @@
<LI><CODE>nmake /f Makefile.win _apached</CODE> (debug build)
</UL>
-<P>These will both compile Apache. The latter will include debugging
- information in the resulting files, making it easier to find bugs and
- track down problems.</P>
<P>Apache can also be compiled using VC++'s Visual Studio development
- environment. Although compiling Apache in this manner is not as
- simple, it makes it possible to easily modify the Apache source, or
- to compile Apache if the command-line tools are not installed.
- Project files (<CODE>.DSP</CODE>) 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 <EM>in this order</EM>:
+ environment. To simplify this process, a Visual Studio workspace,
+ Apache.dsw, is provided in the src 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>
<OL>
- <LI><CODE>regex\regex.dsp</CODE>
<LI><CODE>lib\apr\aprlib.dsp</CODE>
+ <LI><CODE>lib\apr\aprlibdll.dsp <EM>requires aprlib</EM></CODE>
+ <LI><CODE>lib\pcre\dftables.dsp</CODE>
+ <LI><CODE>lib\pcre\pcre.dsp <EM>requires dftables</EM></CODE>
+ <LI><CODE>lib\pcre\pcreposix.dsp <EM>requires dftables and pcre</EM></CODE>
+ <LI><CODE>lib\expat-lite\xmltok.dsp</CODE>
+ <LI><CODE>lib\expat-lite\xmlparse.dsp <EM>requires xmltok</EM></CODE>
<LI><CODE>ap\ap.dsp</CODE>
<LI><CODE>main\gen_uri_delims.dsp</CODE>
<LI><CODE>main\gen_test_char.dsp</CODE>
- <LI><CODE>ApacheCore.dsp</CODE>
- <LI><CODE>Apache.dsp</CODE>
+ <LI><CODE>ApacheCore.dsp <EM>requires all of the above</EM></CODE>
+ <LI><CODE>Apache.dsp <EM>requires ApacheCore and aprlibdll</EM></CODE>
</OL>
In addition, the <CODE>os\win32</CODE> subdirectory contains
@@ -64,22 +67,25 @@
<OL>
<LI><CODE>os\win32\ApacheModuleAuthAnon.dsp</CODE>
+ <LI><CODE>os\win32\ApacheModuleAuthDigest.dsp</CODE>
<LI><CODE>os\win32\ApacheModuleCERNMeta.dsp</CODE>
- <LI><CODE>os\win32\ApacheModuleDigest.dsp</CODE>
<LI><CODE>os\win32\ApacheModuleExpires.dsp</CODE>
+ <LI><CODE>os\win32\ApacheModuleFileCache.dsp</CODE>
<LI><CODE>os\win32\ApacheModuleHeaders.dsp</CODE>
<LI><CODE>os\win32\ApacheModuleInfo.dsp</CODE>
<LI><CODE>os\win32\ApacheModuleRewrite.dsp</CODE>
<LI><CODE>os\win32\ApacheModuleSpeling.dsp</CODE>
<LI><CODE>os\win32\ApacheModuleStatus.dsp</CODE>
<LI><CODE>os\win32\ApacheModuleUserTrack.dsp</CODE>
+ <LI><CODE>modules\proxy\ApacheModuleProxy.dsp</CODE>
</OL>
The <CODE>support\</CODE> 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.</P>
+ the administrator to test Apache and maintain password and log files.</P>
<OL>
+ <LI><CODE>support\ab.dsp</CODE>
<LI><CODE>support\htdigest.dsp</CODE>
<LI><CODE>support\htpasswd.dsp</CODE>
<LI><CODE>support\logresolve.dsp</CODE>
@@ -100,8 +106,8 @@
(for debug build)
</UL>
- The dir argument to INSTDIR gives the installation directory; it can
- be omitted if Apache is to be installed into <SAMP>\Apache</SAMP>.</P>
+ The <EM>dir</EM> argument to INSTDIR gives the installation directory; it
+ can be omitted if Apache is to be installed into <SAMP>\Apache</SAMP>.</P>
<P>This will install the following:</P>
@@ -109,9 +115,9 @@
<LI><CODE><EM>dir</EM>\Apache.exe</CODE> - Apache executable
<LI><CODE><EM>dir</EM>\aprlib.dll</CODE> - Apache Portable Runtime shared library
<LI><CODE><EM>dir</EM>\ApacheCore.dll</CODE> - Apache Core application
- <LI><CODE><EM>dir</EM>\modules\ApacheModule*.dll</CODE> - Optional Apache
- modules (7 files)
- <LI><CODE><EM>dir</EM>\support\*.exe</CODE> - Administrator support executables
+ <LI><CODE><EM>dir</EM>\modules\ApacheModule*.dll</CODE> - Loadable Apache
+ modules
+ <LI><CODE><EM>dir</EM>\bin\*.exe</CODE> - Administrator support executables
<LI><CODE><EM>dir</EM>\conf</CODE> - Empty configuration directory
<LI><CODE><EM>dir</EM>\logs</CODE> - Empty logging directory
</UL>
@@ -126,7 +132,7 @@
src/Apache.dsw
</PRE>
- This assures that lower-level sources are rebuilt from within
+<P>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
1.35 +10 -13 apache-2.0/htdocs/manual/windows.html
Index: windows.html
===================================================================
RCS file: /home/cvs/apache-2.0/htdocs/manual/windows.html,v
retrieving revision 1.34
retrieving revision 1.35
diff -u -r1.34 -r1.35
--- windows.html 2000/05/05 02:38:29 1.34
+++ windows.html 2000/05/11 03:39:39 1.35
@@ -217,6 +217,14 @@
service for Apache, first attempt to start it from the command
line to assure that the service starts with no errors.</P>
+<P>Because Apache <EMP>CANNOT</EMP> share the same port with another
+ TCPIP application, you may need to stop or uninstall certain
+ services first. These include (but are not limited to) other
+ web servers, and firewall products such as BlackIce. If you can
+ only start Apache with these services disabled, reconfigure either
+ Apache or the other product so that they do not listen on the
+ same TCPIP ports.</P>
+
<H2><A NAME="use">Configuring Apache for Windows</A></H2>
<P>Apache is configured by files in the <SAMP>conf</SAMP>
@@ -276,7 +284,8 @@
<LI><P>Apache can also load ISAPI Extensions (<EM>i.e.</EM>, Internet Server
Applications), such as those used by Microsoft's IIS, and other
Windows servers. <A HREF="mod/mod_isapi.html">More information
- is available.</A>
+ is available.</A> Note that Apache <EMP>CANNOT</EMP> load ISAPI
+ Filters.
</UL>
<H2><A NAME="service">Running Apache for Windows as a Service</A></H2>
@@ -468,12 +477,6 @@
apache -k shutdown
</PRE>
-<BLOCKQUOTE>
- <STRONG>Note: This option is only available with Apache 1.3.3 and
- later. For earlier versions, you need to use Control-C in the
- Apache console window to shut down the server.</STRONG>
-</BLOCKQUOTE>
-
<P>This should be used instead of pressing Control-C in the running
Apache console window, because it lets Apache end any current
transactions and cleanup gracefully.</P>
@@ -485,12 +488,6 @@
<PRE>
apache -k restart
</PRE>
-
-<BLOCKQUOTE>
- <STRONG>Note: This option is only available with Apache 1.3.3 and
- later. For earlier versions, you need to use Control-C in the
- Apache console window to shut down the server.</STRONG>
-</BLOCKQUOTE>
<P>Note for people familiar with the Unix version of Apache: these
commands provide a Windows equivalent to <CODE>kill -TERM