
        *****************************************************
        *           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<основний.документ>)+ (B<-p> I<XX.po>)+

(I<XX.po> — назви файлів результатів обробки, усі інші аргументи вказують на вхідні дані)

=head1 ОПИС

Метою проєкту po4a (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>

Файли, які слід оновити. Якщо цих файлів не існує, їх буде створено за допомогою B<po4a-updatepo>.

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

Додаткові параметри, які слід передати додатку форматування. Докладніші відомості щодо параметрів кожного з додатків можна знайти у документації до відповідного додатка. Наприклад, ви можете передати «-o tablecells» до обробника AsciiDoc, а обробнику звичайного тексту можна передати «-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>]

Вказує формат посилань. Аргумент I<тип> може мати значення B<never>, якщо не слід взагалі створювати посилань; B<file>, якщо слід вказати файл без номерів рядків; B<counter>, якщо слід замінити номер рядка значенням лічильника; і B<full>, якщо посилання слід включити повністю (типове значення: 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<адреса@електронної.пошти>

Встановити адресу для звітування щодо помилок у msgid (початкових неперекладених рядках). Типово, у створених файлах POT не буде полів Report-Msgid-Bugs-To.

=item B<--copyright-holder> I<рядок>

Встановити запис авторських прав у заголовку POTr. Типовим значенням є «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 АВТОРСЬКІ ПРАВА ТА ЛІЦЕНЗУВАННЯ

© SPI, inc., 2002–2023.

Ця програма є вільним програмним забезпеченням; ви можете поширювати її і/або вносити до неї зміни за умов дотримання GPL версії 2.0 або пізнішої (див. файл COPYING).

