# HG changeset patch
# User Roman Arutyunyan <arut@nginx.com>
# Date 1497438837 -10800
# Node ID 18404f5a5600e85521aeceeb5fa892c0b9a32c0c
# Parent  eeb9cb8f8a548a4165f104e1ea53b4aac8cec37f
DevGuide: string initialization macros.

diff -r eeb9cb8f8a54 -r 18404f5a5600 xml/en/docs/dev/development_guide.xml
--- a/xml/en/docs/dev/development_guide.xml	Wed Jun 14 12:38:32 2017 +0300
+++ b/xml/en/docs/dev/development_guide.xml	Wed Jun 14 14:13:57 2017 +0300
@@ -397,6 +397,36 @@
 </list>
 </para>
 
+<para>
+The following macros simplify string initialization:
+</para>
+
+<list type="bullet">
+
+<listitem>
+<literal>ngx_string(text)</literal> — static initializer for the
+<literal>ngx_str_t</literal> type from the C string literal
+<literal>text</literal>
+</listitem>
+
+<listitem>
+<literal>ngx_null_string</literal> — static empty string initializer for the
+<literal>ngx_str_t</literal> type
+</listitem>
+
+<listitem>
+<literal>ngx_str_set(str, text)</literal> — initializes string
+<literal>str</literal> of <literal>ngx_str_t *</literal> type with the C string
+literal <literal>text</literal>
+</listitem>
+
+<listitem>
+<literal>ngx_str_null(str)</literal> — initializes string <literal>str</literal>
+of <literal>ngx_str_t *</literal> type with the empty string
+</listitem>
+
+</list>
+
 </section>