changeset 760:f0e3d07c66d8

Documented $r->log_error method, redirection limitation, removed outdated info.
author Vladimir Homutov <vl@nginx.com>
date Mon, 12 Nov 2012 07:45:20 +0000
parents 1f58eb09aa8c
children 84740807c806
files xml/en/docs/http/ngx_http_perl_module.xml xml/ru/docs/http/ngx_http_perl_module.xml
diffstat 2 files changed, 26 insertions(+), 17 deletions(-) [+]
line wrap: on
line diff
--- a/xml/en/docs/http/ngx_http_perl_module.xml	Mon Nov 12 07:14:08 2012 +0000
+++ b/xml/en/docs/http/ngx_http_perl_module.xml	Mon Nov 12 07:45:20 2012 +0000
@@ -10,7 +10,7 @@
 <module name="Module ngx_http_perl_module"
         link="/en/docs/http/ngx_http_perl_module.html"
         lang="en"
-        rev="1">
+        rev="2">
 
 <section id="summary">
 
@@ -359,6 +359,18 @@
 <tag-desc>
 does an internal redirect to the specified <value>uri</value>.
 An actual redirect happens after the Perl handler has completed.
+<note>
+Redirections to named locations are not currently supported.
+</note>
+</tag-desc>
+
+<tag-name><literal>$r->log_error(<value>errno</value>,
+<value>message</value>)</literal></tag-name>
+<tag-desc>
+writes the specified <value>message</value> into the
+<link doc="../ngx_core_module.xml" id="error_log"/>.
+If <value>errno</value> is non-zero, an error code and its description
+will be appended to the message.
 </tag-desc>
 
 <tag-name><literal>$r->print(<value>text</value>, ...)</literal></tag-name>
@@ -412,13 +424,6 @@
 specify an initial offset and length of data to be transmitted.
 The actual data transmission happens after the Perl handler
 has completed.
-It should be noted that when using this method in a subrequest,
-and <link doc="ngx_http_core_module.xml" id="sendfile"/>
-is enabled, the file content will not be passed through the
-<link doc="ngx_http_gzip_module.xml">gzip</link>,
-<link doc="ngx_http_ssi_module.xml">SSI</link>, and
-<link doc="ngx_http_charset_module.xml">charset</link>
-filters.
 </tag-desc>
 
 <tag-name>
--- a/xml/ru/docs/http/ngx_http_perl_module.xml	Mon Nov 12 07:14:08 2012 +0000
+++ b/xml/ru/docs/http/ngx_http_perl_module.xml	Mon Nov 12 07:45:20 2012 +0000
@@ -10,7 +10,7 @@
 <module name="Модуль ngx_http_perl_module"
         link="/ru/docs/http/ngx_http_perl_module.html"
         lang="ru"
-        rev="1">
+        rev="2">
 
 <section id="summary">
 
@@ -360,6 +360,18 @@
 <tag-desc>
 делает внутреннее перенаправление на указанный <value>uri</value>.
 Перенаправление происходит уже после завершения обработчика Perl.
+<note>
+На данный момент перенаправления в именованные location’ы не поддерживаются.
+</note>
+</tag-desc>
+
+<tag-name><literal>$r->log_error(<value>код_ошибки</value>,
+<value>сообщение</value>)</literal></tag-name>
+<tag-desc>
+записывает указанное <value>сообщение</value> в
+<link doc="../ngx_core_module.xml" id="error_log"/>.
+Если <value>код_ошибки</value> ненулевой, то к сообщению будет добавлен
+код ошибки и её описание.
 </tag-desc>
 
 <tag-name><literal>$r->print(<value>текст</value>, ...)</literal></tag-name>
@@ -413,14 +425,6 @@
 задают начальное смещение и длину передаваемых данных.
 Непосредственно передача данных происходит уже после завершения
 обработчика Perl.
-Необходимо учитывать, что при использовании
-этого метода в подзапросе и включённой директиве
-<link doc="ngx_http_core_module.xml" id="sendfile"/>
-содержимое файла не будет проходить через
-<link doc="ngx_http_gzip_module.xml">gzip</link>,
-<link doc="ngx_http_ssi_module.xml">SSI</link> и
-<link doc="ngx_http_charset_module.xml">charset</link>
-фильтры.
 </tag-desc>
 
 <tag-name>