httpd-cvs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From pep...@apache.org
Subject cvs commit: httpd-docs-1.3/htdocs/manual cygwin.html
Date Wed, 11 Jul 2001 21:50:36 GMT
pepper      01/07/11 14:50:35

  Modified:    htdocs/manual cygwin.html
  Log:
  Bunch o' typos, some HTML fixes, and some clarifications.
  
  Revision  Changes    Path
  1.2       +83 -83    httpd-docs-1.3/htdocs/manual/cygwin.html
  
  Index: cygwin.html
  ===================================================================
  RCS file: /home/cvs/httpd-docs-1.3/htdocs/manual/cygwin.html,v
  retrieving revision 1.1
  retrieving revision 1.2
  diff -u -r1.1 -r1.2
  --- cygwin.html	2001/07/11 14:41:41	1.1
  +++ cygwin.html	2001/07/11 21:50:32	1.2
  @@ -17,53 +17,53 @@
   <h1 align="CENTER"><a name="help">Using Apache With Cygwin</a></h1>
   
   <p>This document explains how to install, configure and run Apache 1.3 under
  -   the <a href="http://www.cygwin.com">Cygwin</a> platform for Microsoft
  -   Windows. Cygwin is a POSIX.1 emulation layer for Microsoft Windows 32-bit
  +   the <a href="http://www.cygwin.com">Cygwin</a> layer for Microsoft
  +   Windows. Cygwin is a POSIX.1 emulation layer for 32-bit Microsoft Windows
      operating systems.
   
   <p>The Apache Group does not guarantee that this software will work as
      documented, or even at all. If you find any bugs, please document them on
      our <a href="http://www.apache.org/bug_report.html">bug reporting page.</a>
   
  -<p>Latest development news, pre-compiled distribution binaries and third-party
  -   modules as DLLs may be found at
  +<p>Latest development news, pre-compiled distribution binaries, and third-party
  +   modules as DLLs, may be found at
      <a href="http://apache.dev.wapme.net/">http://apache.dev.wapme.net/</a>.
        Contributions are highly welcome (please see
  -   <a href="http://apache.dev.wapme.net/TODO.cygwin">TODO</a> list), please
  +   <a href="http://apache.dev.wapme.net/TODO.cygwin">TODO</a> list); please
      submit your code or suggestions to the bug report page, or join the
      new-httpd@apache.org mailing list.</p>
   
   <p>The <a href="windows.html">Win32 port</a> of Apache is built on its
own,
  -   custom code within Apache to assure interoperability with the Windows
  +   custom code within Apache to assure interoperability with Windows
      operating systems.  While it is considered release quality, it is slower
      and less thoroughly tested than the Unix ports.  The Cygwin alternative
  -   uses the well tested unix code by using the Cygwin portability layer for
  +   uses the well tested Unix code by using the Cygwin portability layer for
      Unix emulation.  The Cygwin port may suffer from gaps in security or
  -   reliability due to the interaction of the Cygwin compatibility layer to
  +   reliability due to the interaction of the Cygwin compatibility layer with
      the native Windows API.</p>
   
   <p>The <a href="windows.html">Win32 port</a> will be more familiar to
most
  -   Windows users.  The Cygwin port will be more familiar to Unix admins and
  -   developers, including the Apache/Unix build environment.  Due to these
  +   Windows users.  The Cygwin port (including the build environment) will be
  +   more familiar to Unix admins and developers.  Due to these
      two different code bases, the security and reliability of the two ports
      are unrelated to each other.  The Win32 port should be considered the
      more secure of the two at this time.  The Win32 port is recommended for
      most Windows users, however the Cygwin port offers an extra layer of
      compatibility for Unix developers.</p>
   
  -<p>Apache still performs best, and is most reliable on Unix platforms. First
  +<p>Apache still performs best, and is most reliable, on Unix platforms. First
      benchmarks have shown that the same Apache setup on Cygwin performs about
      30% slower than the corresponding native Windows version.</p>
   
   <p>Most of this document assumes that you have a working Cygwin installation
  -   and want to compile Apache yourself from the orginal distribution
  +   and want to compile Apache yourself from the original distribution
      sources.</p>
   
   <hr>
   
   <ul>
     <li><a href="#hist">History of Apache for Cygwin</a>
  -  <li><a href="#diff">Differences to Apache for Windows (native)</a>
  +  <li><a href="#diff">Differences from Apache for Windows (native)</a>
     <li><a href="#req">Requirements</a>
     <li><a href="#down">Downloading Apache for Cygwin</a>
     <li><a href="#inst">Configuring and installing Apache for Cygwin</a>
  @@ -76,57 +76,58 @@
   
   <h2><a name="hist">History of Apache for Cygwin</a></h2>
   
  -<p>Cygwin support for Apache has been developed since Apache 1.2.6 and
  -   Cygwin b18.
  +<p>Cygwin support for Apache began with Apache 1.2.6 and Cygwin b18.
   <p>Due to licensing issues there has not been an official binary distribution
  -   until Red Hat Inc. (former Cygnus Solutions Inc.) changed their Cygwin license
  -   to ensure compiled executables do not fall under GPL license if the distributed
  -   software is considered as open source.
  +   until Red Hat Inc. (who merged with Cygnus Solutions Inc.) changed their
  +   Cygwin license to ensure compiled executables do not fall under GPL
  +   license if the distributed software is considered as open source.
   <p>Cygwin is supported in the official source distributions from Apache 1.3.20
  -   and on. Pre-compiled binaries for the Cygwin platform (without the
  +   and later. Pre-compiled binaries for the Cygwin platform (without the
      <code>cygwin1.dll</code>) will be supplied at
      <a href="http://www.apache.org/httpd">http://www.apache.org/httpd</a> for
each
      released version.
   
   
  -<h2><a name="diff">Differences to Apache for Windows (native)</a></h2>
  -<p>Both versions, Apache for Windows and Apache for Cygwin are designed to run
  +<h2><a name="diff">Differences from Apache for Windows (native)</a></h2>
  +<p>Both versions, Apache for Windows and Apache for Cygwin, are designed to run
      on the same operating systems, the Windows NT and Windows 2000 family. But
  -   there are considerable differences for those.
  -<p>While Apache for Windows is a native Windows port, Apache for Cywin relies on
  +   there are considerable differences between the two flavors.
  +<p>While Apache for Windows is a native Windows port, Apache for Cygwin relies on
      the Cygwin POSIX.1 emulation layer provided by the <code>cygwin1.dll</code>
  -   dynamic library to fake a Unix compliant enviroment. Therefore we consider
  -   Apache for Cygwin more closer to the Unix side then to the Windows side, even
  +   dynamic library to create a Unix compatible environment. Therefore we consider
  +   Apache for Cygwin closer to the Unix side then to the Windows side, even
      while it runs on Windows.
  -<p>Most significant differences are the ammount of changes to the source code
  +<p>Most significant differences are the amount of changes to the source code
      needed to compile and run Apache on the Cygwin platform. While the native
  -   Windows port needs huge changes and platform specific additions, the Cygwin
  -   based port changes are very small and most of the present source code can
  +   Windows port needs major changes and platform specific additions, the Cygwin
  +   based port changes are very small and most of the Unix source code can
      be used without major changes on the Cygwin platform.
   
  -<p><strong>When to use Apache for Cygwin and/or Apache for Windows?</strong><br>
  -   Apache for Cygwin is considered to be very useful if you want a seamless
  -   transition from Unix sytems to Windows systems for your HTTP services.
  +<p><strong>When to use Apache for Cygwin and/or Apache versus Windows?</strong><br>
  +   Apache for Cygwin is intended to be most useful if you want a seamless
  +   transition from Unix systems to Windows systems for your HTTP services.
   <p>If you are using Windows NT or Windows 2000 for development and office
  -   purposes, but your productive HTTP server environments are Unix based systems
  -   you may use Apache for Cygwin to develop on Windows and simply copy the whole
  -   Apache configurations (i.e. <code>httpd.conf</code>) and Perl
  +   purposes, but your productive HTTP server environments are Unix based systems,
  +   you may use Apache for Cygwin to develop on Windows and simply copy whole
  +   Apache configurations (<em>i.e.,</em> <code>httpd.conf</code>)
and Perl
      (<code>mod_perl</code>), PHP (<code>mod_php</code>) or Python
      (<code>mod_snake</code>) applications to your productive Unix systems.
   
   <p><strong>What about modules (<code>mod_foo</code>) for Apache
for Cygwin?</strong><br>
  -   Apache for Cygwin can be build with most of the available Apache modules with
  -   no or very few effort in changes. Most popular modules have been compiled and
  -   tested with Apache for Cygwin, including <code>mod_dav, mod_ssl, mod_php, mod_perl,
  -   mod_gzip, mod_jserv</code>.
  -<p>While there are developers that support the Windows native port of Apache, very
  -   fiew module developers do. That is why it is usually very hard to make a Unix
  -   based Apache installation with different modules work the same way on the
  -   Windows side using the native port. Apache for Cygwin makes it possible.
  -
  -<p><strong>What are the differences for the configuration files?</strong><br>
  -   While the Apache for Windows port uses Windows native path names to refer a
  -   specific file or directory, like
  +   Apache for Cygwin can be built with most of the available Apache modules with
  +   no or minimal changes. Many popular modules have been compiled and
  +   tested with Apache for Cygwin, including <code>mod_dav</code>,
  +   <code>mod_ssl</code>, <code>mod_php</code>, mod_perl</code>,
  +   <code>mod_gzip</code>, and <code>mod_jserv</code>.
  +<p>While there are developers who directly support the Windows native port of
  +   Apache, very few module developers do. That is why it is can be
  +   difficult to make a Unix-based Apache installation with third-party
  +   modules work the same way on the Windows side using the native port.
  +   Apache for Cygwin makes this much easier.
  +
  +<p><strong>What are the differences in the configuration files?</strong><br>
  +   While the Apache for Windows port uses Windows native path names to refer
  +   files and directorys, like
   <pre>
     # httpd.conf (for Windows)
     DocumentRoot "c:/apache/htdocs"
  @@ -139,31 +140,30 @@
   </pre>
   
   <p><strong>What about performance?</strong><br>
  -   Apache for Cygwin is and should be considered not as performative as Apache
  -   for Windows on the same hardware architecture.
  -<p>This is trivial, because Cygwin emulates a Unix enviroment on a
  -   "foreign" operating system, while Apache for Windows runs in its own native
  -   environment. First benchmark results have shown that Apache for Cygwin is
  -   about 30% slower then his native Apache for Windows counterpart.
  +   Apache for Cygwin is not as high-performance as Apache
  +   for Windows on the same hardware.
  +<p>This is to be expected, because Cygwin emulates a Unix environment on a
  +   "foreign" operating system, while Apache for Windows uses Windows code
  +   in its own native environment. First benchmark results have shown
  +   that Apache for Cygwin is about 30% slower than native Apache for
  +   Windows counterpart.</p>
   
   
  -
  -
   <h2><a name="req">Requirements</a></h2>
   
   <p>This Apache 1.3 port for Cygwin is designed to run on Windows NT 4.0 and
  -   Windows 2000, <strong>NOT</strong> on Windows 95 and 98. Windows NT 4.0
  +   Windows 2000, <strong>NOT</strong> on Windows 95 or 98. Windows NT 4.0
      and Windows 2000 have both been successfully tested and approved.
      In all cases TCP/IP networking must be installed.</p>
   
   <p>Cygwin 1.x is required to compile and run this version. Cygwin 1.1.8
  -   and 1.3.2 have been tested and approved on both supported OS.
  +   and 1.3.2 have been tested and approved on both supported OSes.</p>
   
   <p><strong>Note:</strong>If you want to compile shared DLL modules using
      <a href="programs/apxs.html"><code>apxs</code></a> you will
need a
      patched version of <code>ld.exe</code> with <code>--auto-import</code>
  -   support which can be found
  -   <a href="http://sourceforge.net/projects/kde-cygwin/">here</a>.</p>
  +   support, which can be found at <a
  +    href="http://sourceforge.net/projects/kde-cygwin/">http://sourceforge.net/projects/kde-cygwin/</a>.</p>
   
   
   <h2><a name="down">Downloading Apache for Cygwin</a></h2>
  @@ -191,18 +191,18 @@
   <li><strong>Static linked version</strong>
   <p>To build a static linked version of <code>httpd</code> including
      additional modules you will have to give the following statements to
  -   the shell:
  +   the shell:</p>
   <pre>
     $ cd apache_1.3.x
     $ ./configure [--enable-module=<i>module</i>|--add-module=<i>/path/to/module</i>]
     $ make
   </pre>
  -     This will produce the required extra libaries or object files for
  +<p>This will produce the required extra libraries or object files for
      <i>module</i> and link everything to <code>src/httpd.exe</code>.</p>
   
   <li><strong>Shared core DLL linked version (one for all version)</strong>
   <p>To build a DLL version of <code>httpd</code> including additional
  -   modules you have to give the following statements to the shell:
  +   modules you have to give the following statements to the shell:</p>
   <pre>
     $ cd apache_1.3.x
     $ ./configure --enable-rule=SHARED_CORE \
  @@ -211,7 +211,7 @@
     $ make install
   </pre>
   
  -  This will produce the required extra libraries or object files which hold all
  +<p>This will produce the required extra libraries or object files which hold all
     static linked code. Then <code>dllwrap</code> and <code>dlltool</code>
will
     export all of those (including any added extra module code) to the shared
     <code>libhttpd.dll</code> and create the <code>libhttpd.a</code>
import
  @@ -228,7 +228,7 @@
   <ul>
   
   <li><p>First build Apache's shared core giving the following statements
  -  to the shell:
  +  to the shell:</p>
   <pre>
     $ cd apache_1.3.x
     $ ./configure --enable-rule=SHARED_CORE --enable-module=so \
  @@ -237,7 +237,7 @@
     $ make
     $ make install
   </pre>
  -  Now the <code>make</code> process will break when trying to compile the
  +<p>Now the <code>make</code> process will break when trying to compile
the
     shared module defined using <code>--enable-shared</code>. You will have
     to use a work-around, due to the fact that currently there is no
     <code>src/libhttpd.dll</code> build that is required to link against the
  @@ -250,7 +250,7 @@
     $ make
     $ make install
   </pre>
  -  This will build the core dynamic library <code>libhttpd.dll</code> as
  +<p>This will build the core dynamic library <code>libhttpd.dll</code>
as
     described in the previous build alternative.</p>
   
   <li> Now we have to link the shared module against that library:
  @@ -258,7 +258,7 @@
     $ cd <i>/path/to/module</i>
     $ gcc --shared -o <i>module</i>.dll <i>module</i>.lo <i>/path/to/libhttpd.dll</i>
   </pre>
  -  The build shared DLL module has to be placed to Apache's installation
  +<p>The build shared DLL module has to be placed to Apache's installation
     <code>bin</code>directory where <code>libhttpd.dll</code> goes
too.</p>
   
   <li>Add configuration directives to <code>conf/httpd.conf</code> to load
  @@ -273,7 +273,7 @@
   
   </ul>
   
  -   The above steps have to be repeated for each shared DLL module you want
  +<p>The above steps have to be repeated for each shared DLL module you want
      to create.</p>
   
   <li><strong>Using apxs to create shared DLL modules</strong>
  @@ -285,7 +285,7 @@
      <code>apxs</code> to include the <code>--shared</code> directive
and
      the path to the shared code DLL <code>libhttpd.dll</code>.
   
  -<p>Now you shoud be able to create a shared DLL module from a <code>mod_foo.c</code>
  +<p>Now you should be able to create a shared DLL module from a <code>mod_foo.c</code>
      source code file with:
   <pre>
     $ apxs -c mod_foo.c -o mod_foo.dll
  @@ -299,26 +299,26 @@
   
   <h2><a name="inst">Running Apache for Cygwin</a></h2>
   
  -<p>Apache on Cygwin can be started and stoped in the same manner
  +<p>Apache on Cygwin can be started and stopped in the same manner
      as on Unix systems. You may also use the
      <a href="programs/apachctl.html"><code>apachectl</code></a>
tool for
  -   starting and stoping Apache.
  +   starting and stopping Apache.
   
   <ul>
   
   <li><strong>Starting Apache</strong>
   <p>If installed to the default Apache layout directory you can start
  -   <code>httpd</code> as follows:
  +   <code>httpd</code> as follows:</p>
   <pre>
     $ /usr/local/apache/bin/httpd
   </pre>
  -   An explicit background <code>&</code> indicator is not required. The
  +<p>An explicit background <code>&amp;</code> indicator is not required.
The
      resulting parent process is detached from the current terminal.
      Check the global <code>error_log</code> to see if Apache has started
      cleanly without any major problems.</p>
   
   <li><strong>Stopping Apache</strong>
  -<p>To stop Apache send at least a  <code>SIGTERM</code> sginal to the
  +<p>To stop Apache send at least a  <code>SIGTERM</code> signal to the
      parent <code>httpd</code> process:
   <pre>
     $ kill -TERM `cat /usr/local/apache/logs/httpd.pid`
  @@ -345,12 +345,12 @@
   <ul>
   <li><strong>Installing Apache as a new Service</strong>
   <p>Use the following statement to install the <code>httpd.exe</code>
as a new
  -   service:
  +   service:</p>
   <pre>
     $ cygrunsrv -I <i>service_name</i>-p /usr/local/apache/bin/httpd.exe [-a
<i>arguments</i>] \
         [-e <i>VAR=VALUE</i>] [-t auto|manual] [-u <i>user</i>] [-w
<i>passwd</i>]
   </pre>
  -  Where <code>-a</code> is used to pass command line arguments to
  +<p>Where <code>-a</code> is used to pass command line arguments to
     <code>httpd.exe</code>, like <code>-DFOO</code> defines and <code>-e</code>
     is used to pass environment variables to the starting environment. If necessary
     you may use the <code>-t</code> options to set the starting type of the service.
  @@ -359,28 +359,28 @@
   
   <li><strong>Starting Apache as a Service</strong>
   <p>After the new service is installed it can be started using the following
  -   command:
  +   command:</p>
   <pre>
     $ cygrunsrv -S <i>service_name</i>
   </pre>
  -  Check your process table and global <code>error_log</code> file to ensure
Apache
  +<p>Check your process table and global <code>error_log</code> file to
ensure Apache
     has started without any major problems.</p>
   
  -<li><strong>Stoping Apache Service</strong>
  -<p>A running Apache service may be stopped using the following comand:
  +<li><strong>Stopping Apache Service</strong>
  +<p>A running Apache service may be stopped using the following command:</p>
   <pre>
     $ cygrunsrv -E <i>service_name</i>
   </pre>
  -  This will stop all running <code>httpd.exe</code> processes and shutdown
the HTTP
  +<p>This will stop all running <code>httpd.exe</code> processes and shutdown
the HTTP
     service for the machine.</p>
   
   <li><strong>Removing Apache Service</strong>
  -<p>An installed Apache service may be removed from the internal service invokation
  -   table of Windows NT or Windows 2000 using the following comand:
  +<p>An installed Apache service may be removed from the internal service invocation
  +   table of Windows NT or Windows 2000 using the following command:</p>
   <pre>
     $ cygrunsrv -R <i>service_name</i>
   </pre>
  -   This will remove your previously defined and installed service from the machine.</p>
  +<p>This will remove your previously defined and installed service from the machine.</p>
   
   </ul>
   
  
  
  

Mime
View raw message