Advanced
Mailing List Archive

Mailing List Archive

  1. Home >
  2. Apache>
  3. CVS
svn commit: r1917015 - in /httpd/httpd/trunk/docs/manual: developer/modguide.xml mod/mod_so.xml mod/mod_so.xml.fr mod/mod_so.xml.ja mod/mod_so.xml.ko mod/mod_so.xml.tr
jorton at apache
Apr 16, 2024, 2:27 AM
Post #1 of 1 (17 views)
Permalink
Author: jorton
Date: Tue Apr 16 09:27:40 2024
New Revision: 1917015

URL: http://svn.apache.org/viewvc?rev=1917015&view=rev
Log:
docs: Use AP_DECLARE_MODULE in Developing modules and mod_so guides

Submitted by: Vladimír Chlup <vchlup redhat.com>
Github: closes #432

Modified:
httpd/httpd/trunk/docs/manual/developer/modguide.xml
httpd/httpd/trunk/docs/manual/mod/mod_so.xml
httpd/httpd/trunk/docs/manual/mod/mod_so.xml.fr
httpd/httpd/trunk/docs/manual/mod/mod_so.xml.ja
httpd/httpd/trunk/docs/manual/mod/mod_so.xml.ko
httpd/httpd/trunk/docs/manual/mod/mod_so.xml.tr

Modified: httpd/httpd/trunk/docs/manual/developer/modguide.xml
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/developer/modguide.xml?rev=1917015&r1=1917014&r2=1917015&view=diff
==============================================================================
--- httpd/httpd/trunk/docs/manual/developer/modguide.xml (original)
+++ httpd/httpd/trunk/docs/manual/developer/modguide.xml Tue Apr 16 09:27:40 2024
@@ -94,7 +94,7 @@ that defines a module as <em>a separate

<!-- BEGIN EXAMPLE CODE -->
<highlight language="c">
-module AP_MODULE_DECLARE_DATA example_module =
+AP_DECLARE_MODULE(example) =
{
STANDARD20_MODULE_STUFF,
create_dir_conf, /* Per-directory configuration handler */
@@ -110,11 +110,12 @@ module AP_MODULE_DECLARE_DATA example_
<p>
This bit of code lets the server know that we have now registered a new module
in the system, and that its name is <code>example_module</code>. The name
-of the module is used primarily for two things:<br/>
+of the module is used primarily for three things:<br/>
</p>
<ul>
<li>Letting the server know how to load the module using the LoadModule</li>
<li>Setting up a namespace for the module to use in configurations</li>
+<li>Allowing the user to distinguish an origin of log messages</li>
</ul>
<p>
For now, we're only concerned with the first purpose of the module name,
@@ -188,7 +189,7 @@ definition will look like this:</p>

<!-- BEGIN EXAMPLE CODE -->
<highlight language="c">
-module AP_MODULE_DECLARE_DATA example_module =
+AP_DECLARE_MODULE(example) =
{
STANDARD20_MODULE_STUFF,
NULL,
@@ -795,7 +796,7 @@ static void register_hooks(apr_pool_t *p

/* Define our module as an entity and assign a function for registering hooks */

-module AP_MODULE_DECLARE_DATA example_module =
+AP_DECLARE_MODULE(example) =
{
STANDARD20_MODULE_STUFF,
NULL, /* Per-directory configuration handler */
@@ -834,7 +835,7 @@ reference to the configuration directive

<!-- BEGIN EXAMPLE CODE -->
<highlight language="c">
-module AP_MODULE_DECLARE_DATA example_module =
+AP_DECLARE_MODULE(example) =
{
STANDARD20_MODULE_STUFF,
NULL, /* Per-directory configuration handler */
@@ -1045,7 +1046,7 @@ static void register_hooks(apr_pool_t *p
Our module name tag:
==============================================================================
*/
-module AP_MODULE_DECLARE_DATA example_module =
+AP_DECLARE_MODULE(example) =
{
STANDARD20_MODULE_STUFF,
NULL, /* Per-directory configuration handler */
@@ -1210,7 +1211,7 @@ per-directory creator and merger functio

<!-- BEGIN EXAMPLE CODE -->
<highlight language="c">
-module AP_MODULE_DECLARE_DATA example_module =
+AP_DECLARE_MODULE(example) =
{
STANDARD20_MODULE_STUFF,
create_dir_conf, /* Per-directory configuration handler */
@@ -1408,7 +1409,7 @@ static const command_rec directives[]
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
*/

-module AP_MODULE_DECLARE_DATA example_module =
+AP_DECLARE_MODULE(example) =
{
STANDARD20_MODULE_STUFF,
create_dir_conf, /* Per-directory configuration handler */

Modified: httpd/httpd/trunk/docs/manual/mod/mod_so.xml
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/mod/mod_so.xml?rev=1917015&r1=1917014&r2=1917015&view=diff
==============================================================================
--- httpd/httpd/trunk/docs/manual/mod/mod_so.xml (original)
+++ httpd/httpd/trunk/docs/manual/mod/mod_so.xml Tue Apr 16 09:27:40 2024
@@ -90,7 +90,7 @@ Windows</compatibility>
<p>To create a module DLL, a small change is necessary to the
module's source file: The module record must be exported from
the DLL (which will be created later; see below). To do this,
- add the <code>AP_MODULE_DECLARE_DATA</code> (defined in the
+ add the <code>AP_DECLARE_MODULE</code> (defined in the
Apache httpd header files) to your module's module record definition.
For example, if your module has:</p>

@@ -100,7 +100,7 @@ Windows</compatibility>

<p>Replace the above with:</p>
<example>
- module AP_MODULE_DECLARE_DATA foo_module;
+ AP_DECLARE_MODULE(foo);
</example>

<p>Note that this will only be activated on Windows, so the

Modified: httpd/httpd/trunk/docs/manual/mod/mod_so.xml.fr
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/mod/mod_so.xml.fr?rev=1917015&r1=1917014&r2=1917015&view=diff
==============================================================================
--- httpd/httpd/trunk/docs/manual/mod/mod_so.xml.fr [utf-8] (original)
+++ httpd/httpd/trunk/docs/manual/mod/mod_so.xml.fr [utf-8] Tue Apr 16 09:27:40 2024
@@ -100,7 +100,7 @@ Windows</title>
modification à son fichier source : l'enregistrement du module doit
être exporté depuis la DLL (qui sera elle-même créée plus tard ;
voir plus loin). Pour ce faire, ajoutez la macro
- <code>AP_MODULE_DECLARE_DATA</code> (définie dans les fichiers
+ <code>AP_DECLARE_MODULE</code> (définie dans les fichiers
d'en-têtes d'Apache httpd) à la définition de l'enregistrement de votre
module. Par exemple, si votre module est déclaré comme suit :</p>

@@ -110,7 +110,7 @@ Windows</title>

<p>Remplacez cette ligne par :</p>
<example>
- module AP_MODULE_DECLARE_DATA foo_module;
+ AP_DECLARE_MODULE(foo);
</example>

<p>Notez que cette macro ne sera prise en compte que sous Windows,

Modified: httpd/httpd/trunk/docs/manual/mod/mod_so.xml.ja
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/mod/mod_so.xml.ja?rev=1917015&r1=1917014&r2=1917015&view=diff
==============================================================================
--- httpd/httpd/trunk/docs/manual/mod/mod_so.xml.ja [utf-8] (original)
+++ httpd/httpd/trunk/docs/manual/mod/mod_so.xml.ja [utf-8] Tue Apr 16 09:27:40 2024
@@ -90,7 +90,7 @@
??????????????????????????
?????????????? (????????????
???????????) ? DLL ????????????????????
- ?????????<code>AP_MODULE_DECLARE_DATA</code> (Apache httpd
+ ?????????<code>AP_DECLARE_MODULE</code> (Apache httpd
?????????????????) ????????????????
??????????????????????????</p>
<example>
@@ -99,7 +99,7 @@

<p>??????????????????????????</p>
<example>
- module AP_MODULE_DECLARE_DATA foo_module;
+ AP_DECLARE_MODULE(foo);
</example>

<p>Unix ???????????

Modified: httpd/httpd/trunk/docs/manual/mod/mod_so.xml.ko
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/mod/mod_so.xml.ko?rev=1917015&r1=1917014&r2=1917015&view=diff
==============================================================================
--- httpd/httpd/trunk/docs/manual/mod/mod_so.xml.ko [euc-kr] (original)
+++ httpd/httpd/trunk/docs/manual/mod/mod_so.xml.ko [euc-kr] Tue Apr 16 09:27:40 2024
@@ -77,7 +77,7 @@
<p>?? DLL? ??????? ??? ????? ?? ????
??. DLL? module record? export?? ??. (?? ??)
?? ?? ??? module record ??? (??? ?????
- ???) <code>AP_MODULE_DECLARE_DATA</code>? ????.
+ ???) <code>AP_DECLARE_MODULE</code>? ????.
?? ??, ??? ?? ??? ???:</p>

<example>
@@ -86,7 +86,7 @@

<p>??? ?? ????:</p>
<example>
- module AP_MODULE_DECLARE_DATA foo_module;
+ AP_DECLARE_MODULE(foo);
</example>

<p>? ??? ??????? ??????? ????? ?????

Modified: httpd/httpd/trunk/docs/manual/mod/mod_so.xml.tr
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/mod/mod_so.xml.tr?rev=1917015&r1=1917014&r2=1917015&view=diff
==============================================================================
--- httpd/httpd/trunk/docs/manual/mod/mod_so.xml.tr [utf-8] (original)
+++ httpd/httpd/trunk/docs/manual/mod/mod_so.xml.tr [utf-8] Tue Apr 16 09:27:40 2024
@@ -91,7 +91,7 @@ yeniden ba?lat?lmas? s?ras?nda yük
de?i?iklik yapmak gerekir: Modül kayd?n?n daha sonra olu?turulacak olan
DLL’den ihraç edilebilmesi gerekir (a?a??ya bak?n?z). Bunu yapmak için
modülün modül kayd? tan?m?na (Apache httpd ba?l?k dosyalar?nda
- tan?mlanm?? olan) <code>AP_MODULE_DECLARE_DATA</code> eklenmelidir.
+ tan?mlanm?? olan) <code>AP_DECLARE_MODULE</code> eklenmelidir.
Örne?in, modülünüz</p>

<example>
@@ -101,7 +101,7 @@ yeniden ba?lat?lmas? s?ras?nda yük
<p>diye bir sat?r içeriyorsa bunu,</p>

<example>
- module AP_MODULE_DECLARE_DATA foo_module;
+ AP_DECLARE_MODULE(foo);
</example>

<p>olarak de?i?tirmelisiniz. Bunun yaln?z Windows üzerinde etkili oldu?unu

©2024 GT.net. A Gossamer Threads company.
5th Floor, 455 Granville St., Vancouver, BC V6C 1T1, Canada | Legal