You are viewing a plain text version of this content. The canonical link for it is here.
Posted to cvs@httpd.apache.org by jo...@apache.org on 2024/04/16 09:27:40 UTC
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
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