
        *****************************************************
        *           GENERATED FILE, DO NOT EDIT             *
        * THIS IS NO SOURCE FILE, BUT RESULT OF COMPILATION *
        *****************************************************

This file was generated by po4a(7). Do not store it (in VCS, for example),
but store the PO file used as source file by po4a-translate.

In fact, consider this as a binary, and the PO file as a regular .c file:
If the PO get lost, keeping this translation up-to-date will be harder.

=encoding UTF-8

=head1 НАЗВАНИЕ

po4a-updatepo - обновляет перевод документации (в PO-формате)

=head1 КРАТКОЕ СОДЕРЖАНИЕ

B<po4a-updatepo> B<-f> I<формат> (B<-m> I<мастер_документ.doc>)+ (B<-p>
I<XX.po>)+

(I<XX.po> является выходным файлом, всё остальное является входными
параметрами)

=head1 ОПИСАНИЕ

Целью проекта po4a (PO for anything, PO везде и для всего) является
облегчение процесса перевода (и что более важно — поддержки перевода),
используя инструменты gettext в тех случаях, когда их применение может
выглядеть неожиданным, например для документации.

Скрипт B<po4a-updatepo> отвечает за обновление PO-файлов, чтобы в них
отражались изменения, выполненные в оригинальном файле документации. Для
этого он преобразует файл документации в POT-файл и вызывает L<msgmerge(1)>
для нового POT-файла и предоставленного PO-файлов.

Возможно указать более одного PO-файла (если вы хотите обновить несколько
языков сразу), и несколько файлов документации (если вы хотите хранить
переводы нескольких документов в одном PO-файле).

Если мастер-документ содержит какие-либо не ASCII символы, то данный
сценарий преобразует PO-файлы в кодировку UTF-8 (если это ещё не так).

=head1 ПАРАМЕТРЫ

=over 4

=item B<-f>, B<--format>

Формат документации которой вы хотите обработать. Используйте параметр
B<--help-format>, чтобы просмотреть список доступных форматов.

=item B<-m>, B<--master>

Файл(ы), содержащий мастер-документ для перевода.

=item B<-M>, B<--master-charset>

Кодировка файлов, содержащих документ для перевода. Обратите внимание, что
все файлы должны иметь одну и ту же кодировку.

=item B<-p>, B<--po>

PO-файл(ы), которые будут обновлены. Если эти файлы не существуют,
B<po4a-updatepo> создаст их.

=item B<-o>, B<--option>

Дополнительные параметры, передаваемые модулю формата. См. описание
возможных параметров и их значений в документации каждого конкретного
модуля. Например, вы можете указать '-o tablecells' парсеру AsciiDoc, в то
время как парсер text принимал бы '-o tabs=split'.

=item B<--no-previous>

Данный параметр удаляет B<--previous> из параметров передаваемых
B<msgmerge>. Это позволяет поддерживать работу со старыми версиями
B<gettext> (до 0.16).

=item B<--previous>

Данный параметр добавляет B<--previous> к параметрам, передаваемым
B<msgmerge>. Для этого требуется B<gettext> версии 0.16 или выше; данный
параметр активирован по умолчанию.

=item B<--msgmerge-opt> I<параметры>

Дополнительные параметры для B<msgmerge>(1).

=item B<-h>, B<--help>

Отобразить короткую справку.

=item B<--help-format>

Выводит список поддерживаемых po4a форматов.

=item B<-V>, B<--version>

Отобразить версию и завершить работу сценария.

=item B<-v>, B<--verbose>

Увеличить количество выводимой пояснительной информации.

=item B<-d>, B<--debug>

Вывод отладочной информации.

=item B<--porefs> I<тип>[,B<wrap>|B<nowrap>]

Задаёт формат сносок в комментариях PO-файла. Аргумент I<тип> может быть
одним из: B<never> — не выводить никаких сносок, B<file> — не выводить
номера строк (точнее, все номера строк будут заменены на 1), B<counter> —
заменяет номера строк инкрементным счётчиком и B<full> — включает
полноценные сноски (по умолчанию: B<full>).

Аргумент может быть дополнен запятой и одним из ключевых слов: B<wrap> или
B<nowrap>. Сноски по умолчанию записываются в одну строку. Опция B<wrap>
разбивает их на несколько строк, подражая утилитам B<gettext> (B<xgettext> и
B<msgmerge>). Этот вариант будет поведением по умолчанию в будущих версиях,
так как в таком виде сноски лучше заметны. Опция B<nowrap> доступна для тех
пользователей, которые хотят оставить старое поведение.

=item B<--wrap-po> B<no>|B<newlines>|I<число> (по умолчанию: 76)

Задаёт, как должны переносится строки в PO-файле. С помощью этого параметра
можно выбрать одно из двух: или чтобы переносы в файлах были удобно
расставлены для чтения людьми (хотя это и может привести к конфликтам в
git), или чтобы файлы больше подходили для автоматической обработки (хотя
это и снизит удобство чтения оных людьми).

Исторически сложилось так, что gettext переносил строки в PO-файлах на 77-м
столбце (по косметическим соображениям). Этот параметр определяет, как
должен вести себя po4a в связи с этим. Если в нём указано число, po4a будет
переносить строки в PO-файле после указанного столбца, а также после
символов перевода строки в содержимом. Если указано B<newlines>, то po4a
будет разделять msgid и msgstr на строки только в местах перевода строк в
самом их содержимом. Если же указано B<no>, то po4a вообще не будет
переносить строки в PO-файле. Перенос комментариев со сносками на
расположение строк контролируется параметром B<--porefs>.

Замечание: этот параметр ни как не влияет на то, как будут расставлены
переносы строк внутри самих msgid и msgstr, т.е. на то, как переносы строк
будут добавляться к их содержимому.

=item B<--msgid-bugs-address> I<email@address>

Установить адрес для сообщений об ошибках в msgid. По умолчанию, созданные
POT-файлы не имеют поля Report-Msgid-Bugs-To.

=item B<--copyright-holder> I<строка>

Указать владельца авторских прав в заголовке POT файла. Значение по
умолчанию: «Free Software Foundation, Inc.»

=item B<--package-name> I<строка>

Указать имя пакета в заголовке POT-файла. Значение по умолчанию: «PACKAGE».

=item B<--package-version> I<строка>

Указать версию пакета в заголовке POT-файла. Значение по умолчанию:
«VERSION».

=back

=head1 СМОТРИТЕ ТАКЖЕ

L<po4a-gettextize(1)>, L<po4a-normalize(1)>, L<po4a-translate(1)>,
L<po4a(7)>

=head1 АВТОРЫ

 Денис Барбье (Denis Barbier) <barbier@linuxfr.org>
 Николя Франсуа (Nicolas François) <nicolas.francois@centraliens.net>
 Мартин Кенсон (Martin Quinson) (mquinson#debian.org)

=head1 АВТОРСКИЕ ПРАВА И ЛИЦЕНЗИИ

Copyright 2002-2023 by SPI, inc.

Данная программа является свободным программным обеспечением; вы можете
распространять и/или изменять её на условиях Универсальной общественной
лицензии (GPL) GNU v2.0 или новее (см. файл COPYING).
