# HG changeset patch
# User Yaroslav Zhuravlev <yar@nginx.com>
# Date 1480960906 -10800
# Node ID 9463f1412255c9d24802dcd51fe4759b8268e575
# Parent  8eae6bc1ea2233be20f6673e0c4a6730ae32968a
Documented ngx_google_perftools_module.

diff -r 8eae6bc1ea22 -r 9463f1412255 xml/en/GNUmakefile
--- a/xml/en/GNUmakefile	Tue Dec 06 15:30:08 2016 +0300
+++ b/xml/en/GNUmakefile	Mon Dec 05 21:01:46 2016 +0300
@@ -113,6 +113,7 @@
 		stream/ngx_stream_ssl_preread_module			\
 		stream/ngx_stream_upstream_module			\
 		stream/stream_processing				\
+		ngx_google_perftools_module				\
 
 TOP =									\
 		download						\
diff -r 8eae6bc1ea22 -r 9463f1412255 xml/en/docs/index.xml
--- a/xml/en/docs/index.xml	Tue Dec 06 15:30:08 2016 +0300
+++ b/xml/en/docs/index.xml	Mon Dec 05 21:01:46 2016 +0300
@@ -8,7 +8,7 @@
 <article name="nginx documentation"
          link="/en/docs/"
          lang="en"
-         rev="36"
+         rev="37"
          toc="no">
 
 
@@ -585,6 +585,17 @@
 </list>
 </para>
 
+<para>
+<list type="bullet">
+
+<listitem>
+<link doc="ngx_google_perftools_module.xml">
+ngx_google_perftools_module</link>
+</listitem>
+
+</list>
+</para>
+
 </section>
 
 </article>
diff -r 8eae6bc1ea22 -r 9463f1412255 xml/en/docs/ngx_google_perftools_module.xml
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/xml/en/docs/ngx_google_perftools_module.xml	Mon Dec 05 21:01:46 2016 +0300
@@ -0,0 +1,67 @@
+<?xml version="1.0"?>
+
+<!--
+  Copyright (C) Nginx, Inc.
+  -->
+
+<!DOCTYPE module SYSTEM "../../../dtd/module.dtd">
+
+<module name="Module ngx_google_perftools_module"
+        link="/en/docs/ngx_google_perftools_module.html"
+        lang="en"
+        rev="1">
+
+<section id="summary">
+
+<para>
+The <literal>ngx_google_perftoos_module</literal> module (0.6.29) enables
+profiling of nginx worker processes using
+<link url="https://github.com/gperftools/gperftools">Google Performance Tools</link>.
+The module is intended for nginx developers.
+</para>
+
+<para>
+This module is not built by default, it should be enabled with the
+<literal>--with-google_perftools_module</literal>
+configuration parameter.
+<note>
+This module requires the
+<link url="https://github.com/gperftools/gperftools">gperftools</link> library.
+</note>
+</para>
+
+</section>
+
+
+<section id="example" name="Example Configuration">
+
+<para>
+<example>
+google_perftools_profiles /path/to/profile;
+</example>
+Profiles will be stored as
+<literal>/path/to/profile.&lt;worker_pid&gt;</literal>.
+</para>
+
+</section>
+
+
+<section id="directives" name="Directives">
+
+<directive name="google_perftools_profiles">
+<syntax><value>file</value></syntax>
+<default/>
+<context>main</context>
+
+<para>
+Sets a file name that keeps profiling information of
+nginx worker process.
+The ID of the worker process is always a part of the file name
+and is appended to the end of the file name, after a dot.
+</para>
+
+</directive>
+
+</section>
+
+</module>
diff -r 8eae6bc1ea22 -r 9463f1412255 xml/ru/GNUmakefile
--- a/xml/ru/GNUmakefile	Tue Dec 06 15:30:08 2016 +0300
+++ b/xml/ru/GNUmakefile	Mon Dec 05 21:01:46 2016 +0300
@@ -102,6 +102,7 @@
 		stream/ngx_stream_ssl_preread_module			\
 		stream/ngx_stream_upstream_module			\
 		stream/stream_processing				\
+		ngx_google_perftools_module				\
 
 TOP =									\
 		download						\
diff -r 8eae6bc1ea22 -r 9463f1412255 xml/ru/docs/index.xml
--- a/xml/ru/docs/index.xml	Tue Dec 06 15:30:08 2016 +0300
+++ b/xml/ru/docs/index.xml	Mon Dec 05 21:01:46 2016 +0300
@@ -8,7 +8,7 @@
 <article name="nginx: документация"
          link="/ru/docs/"
          lang="ru"
-         rev="36"
+         rev="37"
          toc="no">
 
 
@@ -589,6 +589,17 @@
 </list>
 </para>
 
+<para>
+<list type="bullet">
+
+<listitem>
+<link doc="ngx_google_perftools_module.xml">
+ngx_google_perftools_module</link>
+</listitem>
+
+</list>
+</para>
+
 </section>
 
 </article>
diff -r 8eae6bc1ea22 -r 9463f1412255 xml/ru/docs/ngx_google_perftools_module.xml
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/xml/ru/docs/ngx_google_perftools_module.xml	Mon Dec 05 21:01:46 2016 +0300
@@ -0,0 +1,67 @@
+<?xml version="1.0"?>
+
+<!--
+  Copyright (C) Nginx, Inc.
+  -->
+
+<!DOCTYPE module SYSTEM "../../../dtd/module.dtd">
+
+<module name="Модуль ngx_google_perftools_module"
+        link="/ru/docs/ngx_google_perftools_module.html"
+        lang="ru"
+        rev="1">
+
+<section id="summary">
+
+<para>
+Модуль <literal>ngx_google_perftoos_module</literal> (0.6.29) включает
+поддержку профилирования рабочих процессов nginx при помощи
+<link url="https://github.com/gperftools/gperftools">Google Performance Tools</link>.
+Модуль предназначен для разработчиков nginx.
+</para>
+
+<para>
+По умолчанию этот модуль не собирается, его сборку необходимо
+разрешить с помощью конфигурационного параметра
+<literal>--with-google_perftools_module</literal>.
+<note>
+Для сборки и работы этого модуля нужна библиотека
+<link url="https://github.com/gperftools/gperftools">gperftools</link>.
+</note>
+</para>
+
+</section>
+
+
+<section id="example" name="Пример конфигурации">
+
+<para>
+<example>
+google_perftools_profiles /path/to/profile;
+</example>
+Профили будут сохраняться как
+<literal>/path/to/profile.&lt;worker_pid&gt;</literal>.
+</para>
+
+</section>
+
+
+<section id="directives" name="Директивы">
+
+<directive name="google_perftools_profiles">
+<syntax><value>файл</value></syntax>
+<default/>
+<context>main</context>
+
+<para>
+Задаёт имя файла, который хранит информацию о профилировании
+рабочего процесса nginx.
+Идентификатор рабочего процесса всегда является частью имени файла
+и прибавляется в конце имени после точки.
+</para>
+
+</directive>
+
+</section>
+
+</module>