--- /dev/null
+<?xml version='1.0' encoding='UTF-8'?>
+<chapter xmlns="http://docbook.org/ns/docbook">
+ <title>Управление сообщениями пользователю</title>
+ <para>В этом разделе собраны вызовы API для отправки сообщений пользователям.</para>
+ <refentry id="stargazer.send_user_message">
+ <refmeta>
+ <refentrytitle>stargazer.send_user_message</refentrytitle>
+ </refmeta>
+ <refnamediv>
+ <refname>stargazer.send_user_message</refname>
+ <refpurpose>Отправляет сообщение пользователям</refpurpose>
+ </refnamediv>
+ <refsynopsisdiv>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef><function>stargazer.send_user_message</function></funcdef>
+ <paramdef>string <parameter>cookie</parameter></paramdef>
+ <paramdef>array of strings <parameter>logins</parameter></paramdef>
+ <paramdef>struct <parameter>info</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ </refsynopsisdiv>
+ <refsect1>
+ <title>Description</title>
+ <para>Метод <function>stargazer.send_user_message</function> отправляет сообщение пользователям, логины которых перечислены в списке.</para>
+ <variablelist>
+ <varlistentry>
+ <term>string <parameter>cookie</parameter></term>
+ <listitem>
+ <para>Авторизационный cookie. Для авторизации в системе используется метод <function><link linkend="stargazer.login">stargazer.login</link></function></para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>array of strings <parameter>logins</parameter></term>
+ <listitem>
+ <para>Список логинов пользователей</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>struct <parameter>info</parameter></term>
+ <listitem>
+ <para>
+ Структура с параметрами сообщения:
+ <variablelist>
+ <varlistentry>
+ <term>int <parameter>version</parameter></term>
+ <listitem>
+ <para>Версия системы сообщений (не обязательный параметр, по умолчанию - 1)</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ <variablelist>
+ <varlistentry>
+ <term>int <parameter>type</parameter></term>
+ <listitem>
+ <para>Тип сообщения (не обязательный параметр, по умолчанию - 1)</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ <variablelist>
+ <varlistentry>
+ <term>int <parameter>repeat</parameter></term>
+ <listitem>
+ <para>Количество показов сообщеня</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ <variablelist>
+ <varlistentry>
+ <term>int <parameter>repeat_period</parameter></term>
+ <listitem>
+ <para>Период повторения показа сообщений (в минутах)</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ <variablelist>
+ <varlistentry>
+ <term>int <parameter>show_time</parameter></term>
+ <listitem>
+ <para>Время отображения сообщения (в секундах)</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ <variablelist>
+ <varlistentry>
+ <term>string <parameter>text</parameter></term>
+ <listitem>
+ <para>Текст сообщения в кодировке UTF-8</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ <refsect2>
+ <title>Return Value</title>
+ <para>Возвращает true в случае успеха и false в случае неудачи</para>
+ </refsect2>
+ </refsect1>
+ </refentry>
+</chapter>