changeset 684:2ff9c3ea8c98

Documented the userid_mark directive in the userid module.
author Vladimir Homutov <vl@nginx.com>
date Tue, 18 Sep 2012 08:39:31 +0000
parents 6c14c73d74ee
children 3f43a59a1dba
files xml/en/docs/http/ngx_http_userid_module.xml xml/ru/docs/http/ngx_http_userid_module.xml
diffstat 2 files changed, 37 insertions(+), 2 deletions(-) [+]
line wrap: on
line diff
--- a/xml/en/docs/http/ngx_http_userid_module.xml
+++ b/xml/en/docs/http/ngx_http_userid_module.xml
@@ -10,7 +10,7 @@
 <module name="Module ngx_http_userid_module"
         link="/en/docs/http/ngx_http_userid_module.html"
         lang="en"
-        rev="1">
+        rev="2">
 
 <section id="summary">
 
@@ -121,6 +121,24 @@ This is the maximum time understood by o
 </directive>
 
 
+<directive name="userid_mark">
+<syntax><value>off | letter | digit | =</value></syntax>
+<default>off</default>
+<context>http</context>
+<context>server</context>
+<context>location</context>
+
+<para>
+Sets the first symbol of the cookie’s representation base64 tail
+(“<literal>==</literal>” by default) and resets all accepted cookies
+with another tail.
+It may be useful if it's required to add or change the P3P or the cookie expire
+time and leave the internally encoded value unchanged.
+</para>
+
+</directive>
+
+
 <directive name="userid_name">
 <syntax><value>name</value></syntax>
 <default>uid</default>
--- a/xml/ru/docs/http/ngx_http_userid_module.xml
+++ b/xml/ru/docs/http/ngx_http_userid_module.xml
@@ -10,7 +10,7 @@
 <module name="Модуль ngx_http_userid_module"
         link="/ru/docs/http/ngx_http_userid_module.html"
         lang="ru"
-        rev="1">
+        rev="2">
 
 <section id="summary">
 
@@ -120,6 +120,23 @@ userid_p3p     'policyref="/w3c/p3p.xml"
 </directive>
 
 
+<directive name="userid_mark">
+<syntax><value>off | буква | цифра | =</value></syntax>
+<default>off</default>
+<context>http</context>
+<context>server</context>
+<context>location</context>
+
+<para>
+Задаёт первый символ хвоста base64 (по умолчанию “<literal>==</literal>”)
+представления куки и перевыдаёт все принятые куки, у которых этот хвост другой.
+Это полезно, если необходимо добавить или поменять P3P или время
+хранения куки, но при этом оставить неизменным закодированное внутри число.
+</para>
+
+</directive>
+
+
 <directive name="userid_name">
 <syntax><value>имя</value></syntax>
 <default>uid</default>