You are viewing a plain text version of this content. The canonical link for it is here.
Posted to cvs@httpd.apache.org by rb...@apache.org on 2011/01/13 15:48:21 UTC

svn commit: r1058589 - in /httpd/httpd/trunk/docs/manual: dso.html.en dso.xml.ja dso.xml.ko dso.xml.tr mod/mod_proxy.xml.ja

Author: rbowen
Date: Thu Jan 13 14:48:21 2011
New Revision: 1058589

URL: http://svn.apache.org/viewvc?rev=1058589&view=rev
Log:
Rebuild transformations and translations.

Modified:
    httpd/httpd/trunk/docs/manual/dso.html.en
    httpd/httpd/trunk/docs/manual/dso.xml.ja
    httpd/httpd/trunk/docs/manual/dso.xml.ko
    httpd/httpd/trunk/docs/manual/dso.xml.tr
    httpd/httpd/trunk/docs/manual/mod/mod_proxy.xml.ja

Modified: httpd/httpd/trunk/docs/manual/dso.html.en
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/dso.html.en?rev=1058589&r1=1058588&r2=1058589&view=diff
==============================================================================
--- httpd/httpd/trunk/docs/manual/dso.html.en (original)
+++ httpd/httpd/trunk/docs/manual/dso.html.en Thu Jan 13 14:48:21 2011
@@ -56,7 +56,7 @@
     <code class="module"><a href="./mod/core.html">core</a></code> which cannot be put into a DSO
     itself. Practically all other distributed Apache httpd modules will then
     be placed into a DSO. After a module is compiled into a DSO named
-    <code>mod_foo.so</code> you can use <code class="module"><a href="./mod/mod_so.html">mod_so</a></code>'s <code class="directive"><a href="./mod/mod_so.html#loadmodule">LoadModule</a></code> command in your
+    <code>mod_foo.so</code> you can use <code class="module"><a href="./mod/mod_so.html">mod_so</a></code>'s <code class="directive"><a href="./mod/mod_so.html#loadmodule">LoadModule</a></code> directive in your
     <code>httpd.conf</code> file to load this module at server startup
     or restart.</p>
     <p>The DSO builds for individual modules can be disabled via
@@ -132,13 +132,13 @@ $ apxs -cia mod_foo.c
 <div class="section">
 <h2><a name="background" id="background">Background</a></h2>
 
-    <p>On modern Unix derivatives there exists a nifty mechanism
-    usually called dynamic linking/loading of <em>Dynamic Shared
+    <p>On modern Unix derivatives there exists a mechanism
+    called dynamic linking/loading of <em>Dynamic Shared
     Objects</em> (DSO) which provides a way to build a piece of
     program code in a special format for loading it at run-time
     into the address space of an executable program.</p>
 
-    <p>This loading can usually be done in two ways: Automatically
+    <p>This loading can usually be done in two ways: automatically
     by a system program called <code>ld.so</code> when an
     executable program is started or manually from within the
     executing program via a programmatic system interface to the
@@ -217,8 +217,7 @@ $ apxs -cia mod_foo.c
     <p>The shared library approach is the typical one, because it
     is what the DSO mechanism was designed for, hence it is used
     for nearly all types of libraries the operating system
-    provides. On the other hand using shared objects for extending
-    a program is not used by a lot of programs.</p>
+    provides.</p>
 
 </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
 <div class="section">
@@ -229,23 +228,22 @@ $ apxs -cia mod_foo.c
 
     <ul>
       <li>The server package is more flexible at run-time because
-      the actual server process can be assembled at run-time via
+      the server process can be assembled at run-time via
       <code class="directive"><a href="./mod/mod_so.html#loadmodule">LoadModule</a></code>
-      <code>httpd.conf</code> configuration commands instead of
-      <code class="program"><a href="./programs/configure.html">configure</a></code> options at build-time. For instance
+      <code>httpd.conf</code> configuration directives instead of
+      <code class="program"><a href="./programs/configure.html">configure</a></code> options at build-time. For instance,
       this way one is able to run different server instances
-      (standard &amp; SSL version, minimalistic &amp; powered up
-      version [mod_perl, PHP3], <em>etc.</em>) with only one Apache httpd
+      (standard &amp; SSL version, minimalistic &amp; dynamic
+      version [mod_perl, mod_php], <em>etc.</em>) with only one Apache httpd
       installation.</li>
 
       <li>The server package can be easily extended with
-      third-party modules even after installation. This is at least
-      a great benefit for vendor package maintainers who can create
-      a Apache httpd core package and additional packages containing
-      extensions like PHP, mod_perl, mod_security,
-      <em>etc.</em></li>
+      third-party modules even after installation. This is
+      a great benefit for vendor package maintainers, who can create
+      an Apache httpd core package and additional packages containing
+      extensions like PHP, mod_perl, mod_security, <em>etc.</em></li>
 
-      <li>Easier Apache httpd module prototyping because with the
+      <li>Easier Apache httpd module prototyping, because with the
       DSO/<code class="program"><a href="./programs/apxs.html">apxs</a></code> pair you can both work outside the
       Apache httpd source tree and only need an <code>apxs -i</code>
       command followed by an <code>apachectl restart</code> to
@@ -256,18 +254,14 @@ $ apxs -cia mod_foo.c
     <p>DSO has the following disadvantages:</p>
 
     <ul>
-      <li>The DSO mechanism cannot be used on every platform
-      because not all operating systems support dynamic loading of
-      code into the address space of a program.</li>
-
       <li>The server is approximately 20% slower at startup time
       because of the symbol resolving overhead the Unix loader now
       has to do.</li>
 
       <li>The server is approximately 5% slower at execution time
-      under some platforms because position independent code (PIC)
+      under some platforms, because position independent code (PIC)
       sometimes needs complicated assembler tricks for relative
-      addressing which are not necessarily as fast as absolute
+      addressing, which are not necessarily as fast as absolute
       addressing.</li>
 
       <li>Because DSO modules cannot be linked against other

Modified: httpd/httpd/trunk/docs/manual/dso.xml.ja
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/dso.xml.ja?rev=1058589&r1=1058588&r2=1058589&view=diff
==============================================================================
--- httpd/httpd/trunk/docs/manual/dso.xml.ja [utf-8] (original)
+++ httpd/httpd/trunk/docs/manual/dso.xml.ja [utf-8] Thu Jan 13 14:48:21 2011
@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="UTF-8" ?>
 <!DOCTYPE manualpage SYSTEM "./style/manualpage.dtd">
 <?xml-stylesheet type="text/xsl" href="./style/manual.ja.xsl"?>
-<!-- English Revision: 587444:952009 (outdated) -->
+<!-- English Revision: 587444:1058587 (outdated) -->
 
 <!--
  Licensed to the Apache Software Foundation (ASF) under one or more

Modified: httpd/httpd/trunk/docs/manual/dso.xml.ko
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/dso.xml.ko?rev=1058589&r1=1058588&r2=1058589&view=diff
==============================================================================
--- httpd/httpd/trunk/docs/manual/dso.xml.ko [euc-kr] (original)
+++ httpd/httpd/trunk/docs/manual/dso.xml.ko [euc-kr] Thu Jan 13 14:48:21 2011
@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="EUC-KR" ?>
 <!DOCTYPE manualpage SYSTEM "./style/manualpage.dtd">
 <?xml-stylesheet type="text/xsl" href="./style/manual.ko.xsl"?>
-<!-- English Revision: 105989:952009 (outdated) -->
+<!-- English Revision: 105989:1058587 (outdated) -->
 
 <!--
  Licensed to the Apache Software Foundation (ASF) under one or more

Modified: httpd/httpd/trunk/docs/manual/dso.xml.tr
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/dso.xml.tr?rev=1058589&r1=1058588&r2=1058589&view=diff
==============================================================================
--- httpd/httpd/trunk/docs/manual/dso.xml.tr [utf-8] (original)
+++ httpd/httpd/trunk/docs/manual/dso.xml.tr [utf-8] Thu Jan 13 14:48:21 2011
@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="UTF-8" ?>
 <!DOCTYPE manualpage SYSTEM "./style/manualpage.dtd">
 <?xml-stylesheet type="text/xsl" href="./style/manual.tr.xsl"?>
-<!-- English Revision: 587444:952009 (outdated) -->
+<!-- English Revision: 587444:1058587 (outdated) -->
 <!-- =====================================================
  Translated by: Nilgün Belma Bugüner <nilgun belgeler.org>
    Reviewed by: Yücel Haluk Bugüner <haluk buguner.name.tr>

Modified: httpd/httpd/trunk/docs/manual/mod/mod_proxy.xml.ja
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/mod/mod_proxy.xml.ja?rev=1058589&r1=1058588&r2=1058589&view=diff
==============================================================================
--- httpd/httpd/trunk/docs/manual/mod/mod_proxy.xml.ja [utf-8] (original)
+++ httpd/httpd/trunk/docs/manual/mod/mod_proxy.xml.ja [utf-8] Thu Jan 13 14:48:21 2011
@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="UTF-8" ?>
 <!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
 <?xml-stylesheet type="text/xsl" href="../style/manual.ja.xsl"?>
-<!-- English Revision: 344971:1043126 (outdated) -->
+<!-- English Revision: 344971:1058192 (outdated) -->
 
 <!--
  Licensed to the Apache Software Foundation (ASF) under one or more