<sect1 id="supported-cmdline-params">
<title
>Параметри командного рядка</title>

<sect2>
<title
>Загальне</title>
<variablelist>

<varlistentry id="cmdline-pretend">
<term
><option
><link linkend="cmdline-pretend"
>--pretend</link
></option
> (або <option
>--dry-run</option
>, або <option
>-p</option
>)</term>
<listitem
><para
>&kdesrc-build; почне процес оновлення і збирання, але замість виконання будь-яких дій з оновлення чи збирання, скрипт виведе перелік дій, які мав би виконати (наприклад, які команди буде виконано, загальні кроки процесу тощо).</para>

<note
><para
>Скрипт виконає прості команди читання (зокрема читання даних щодо файлів), щоб виведені дані відповідали поточній конфігурації (наприклад, щоб правильно імітувати дію: повне отримання чи просте оновлення коду). </para
></note>

<important
><para
>Для забезпечення працездатності цього параметра потрібні деякі метадані, які зазвичай отримуються у автоматичному режимі, але у режимі фіктивної обробки отримання даних вимкнено. Якщо ви до цього ще ніколи не запускали &kdesrc-build; (а тому не маєте відповідних метаданих), вам слід віддати команду <command
>kdesrc-build <option
>--metadata-only</option
></command
>, щоб програма спочатку отримала потрібні їй метадані. </para
></important>
</listitem>
</varlistentry>

<varlistentry id="cmdline-include-dependencies">
<term
><option
><link linkend="cmdline-include-dependencies"
>--include-dependencies</link
></option
> (або <option
>-d</option
>), <option
>--no-include-dependencies</option
> (або <option
>-D</option
>)</term>
<listitem
><para
>Використання цього параметра призводить до того, що &kdesrc-build; автоматично включає інші модулі &kde; та &Qt; до процедури збирання, якщо вони потрібні для модулів, збирання яких було вказано за допомогою параметрів командного рядка або вашого <link linkend="configure-data"
>файла налаштувань</link
>.</para>

<para
>Перелік доданих модулів визначатиметься записами у системі керування початковими кодами програм &kde;. Див. <xref linkend="kde-projects-module-sets"/>.</para>

<para
>Відповідним параметром у файлі налаштувань є параметр <link linkend="conf-include-dependencies"
>include-dependencies</link
>.</para>

<para
>Цей параметр типово увімкнено.</para>
</listitem>
</varlistentry>

<varlistentry id="cmdline-ignore-modules">
<term
><option
><link linkend="cmdline-ignore-modules"
>--ignore-modules</link
></option
> (або <option
>-!</option
>) <parameter
>модуль [модуль ...]</parameter
></term>
<listitem
><para
>Не включати модулі, передані як аргумент параметра командного рядка, у процес оновлення або збирання (корисно, якщо ви бажаєте зібрати більшість модулів у вашому <link linkend="configure-data"
>файлі налаштування</link
> і просто пропустити збирання малої частини списку модулів). </para>
<para
>Зауважте, що цей параметр не має пріоритету над параметром налаштувань <link linkend="conf-ignore-modules"
>ignore-modules</link
> у загальному розділі. Замість цього, значення згаданого параметра буде доповнено.</para>
</listitem>
</varlistentry>

<varlistentry id="cmdline-run">
<term
><option
><link linkend="cmdline-run"
>--run</link
></option
> (або <option
>--start-program</option
>) [-e|--exec назва] [-f|--fork] <parameter
>програма [параметри ...]</parameter
></term>
<listitem
><para
>Цей параметр інтерпретує наступний елемент командного рядка як назву програми, яку слід запустити. &kdesrc-build; завершить читання файла налаштувань, обробить prefix.sh для застосування змінних середовища, а потім виконає вказану програму.</para>
</listitem>
</varlistentry>

<varlistentry id="cmdline-revision">
<term
><option
><link linkend="cmdline-revision"
>--revision</link
></option
> <replaceable
>ідентифікатор</replaceable
></term>
<listitem
><para
>За допомогою цього параметра можна наказати &kdesrc-build; отримати певну версію кожного з модулів &git;, незалежно від параметрів <link linkend="conf-branch"
>branch</link
>, <link linkend="conf-tag"
>tag</link
> та <link linkend="conf-revision"
>revision</link
> вже встановлених для цих модулів.</para>

<para
>Вам не варто користуватися цим параметром, він підтримується лише з міркувань сумісності зі старішими версіями скрипту. </para
></listitem>
</varlistentry>

<varlistentry id="cmdline-delete-my-patches">
<term
><option
><link linkend="cmdline-delete-my-patches"
>--delete-my-patches</link
></option
>, <option
>--no-delete-my-patches</option
></term>
<listitem
><para
>Цей параметр призначено для того, щоб дозволити &kdesrc-build; вилучати каталоги початкового коду, у яких можуть міститися записані користувачем дані, щоб модуль можна було повністю переотримати. Зазвичай, така можливість буде корисною лише для розробників &kde;, тобто тих, хто вносить до коду зміни локально і хоче, щоб ці зміни було згодом вилучено.</para>

<para
>Зазвичай, потреби у використанні цього параметра немає. Якщо у параметрі виникне потреба, &kdesrc-build; попросить вас перезапустити програму з ним.</para>
</listitem>
</varlistentry>

<varlistentry id="cmdline-delete-my-settings">
<term
><option
><link linkend="cmdline-delete-my-settings"
>--delete-my-settings</link
></option
>, <option
>--no-delete-my-settings</option
></term>
<listitem
><para
>Цим параметром можна скористатися для того, щоб дозволити &kdesrc-build; перезаписувати вже створені файли, у яких можуть міститися дані, записані туди користувачем.</para>

<para
>У поточній версії цей параметр використовується лише для налаштовування xsession у програмі для керування сеансами. Зазвичай, потреби у використанні цього параметра немає. Якщо у параметрі виникне потреба, &kdesrc-build; попросить вас перезапустити програму з ним.</para>
</listitem>
</varlistentry>

<varlistentry id="cmdline-option-name">
<term
><option
><link linkend="cmdline-option-name"
>--<replaceable
>&lt;назва-параметра&gt;</replaceable
></link
></option
> <replaceable
>значення</replaceable
></term>
<listitem
><para
>Ви можете скористатися цим параметром, щоб перевизначити відповідний параметр у вашому <link linkend="configure-data"
>файлі налаштувань</link
> для кожного з модулів. Наприклад, щоб перевизначити значення параметра <link linkend="conf-log-dir"
>log-dir</link
>, вам слід вказати: <userinput
><parameter
>--log-dir<filename class="directory"
><replaceable
>шлях/до/каталогу</replaceable
></filename
></parameter
></userinput
>. </para>

<note
><para
>Цією можливістю можна скористатися лише для тих назв параметрів, які вже розпізнаються &kdesrc-build; і ще не підтримуються відповідними параметрами командного рядка. Наприклад, параметр файла налаштувань <link linkend="conf-async"
>async</link
> має специфічні параметри командного рядка, <link linkend="cmdline-async"
>--async</link
> та <link linkend="cmdline-async"
>--no-async</link
>, яким надається перевага у &kdesrc-build;. </para
></note>

</listitem>
</varlistentry>

<varlistentry id="cmdline-set-module-option-value">
<term
><option
><link linkend="cmdline-set-module-option-value"
>---set-module-option-value</link
> <replaceable
>&lt;назва модуля&gt;</replaceable
>,<replaceable
>&lt;назва параметра&gt;</replaceable
>,<replaceable
>&lt;значення параметра&gt;</replaceable
></option
></term>
<listitem
><para
>Скористайтеся цим параметром, щоб перевизначити параметр з вашого <link linkend="configure-data"
>файл налаштувань</link
> для окремого модуля. </para
></listitem>
</varlistentry>

</variablelist>
</sect2>

<sect2>
<title
>Поновлення та зупинення</title>
<variablelist>

<varlistentry id="cmdline-resume-from">
<term
><option
><link linkend="cmdline-resume-from"
>--resume-from</link
></option
> (або <option
>--from</option
>, або <option
>-f</option
>) <replaceable
>модуль</replaceable
></term>
<listitem
><para
>Цей параметр використовується для поновлення збирання, починаючи з вказаного модуля. Крім того, вам не слід вказувати інших модулів у командному рядку. </para>

<note
><para
>Якщо ви бажаєте уникнути оновлення кодів програма під час поновлення збирання, просто додайте до інших параметрів <option
>--no-src</option
>. </para
></note>

<para
>Див. також <link linkend="cmdline-resume-after"
>--resume-after</link
> та <xref linkend="resuming-failed"/>. Вам слід надавати перевагу використанню цього параметра командного рядка, якщо ви виправили помилку збирання і бажаєте, щоб скрипт &kdesrc-build; завершив збирання.</para
></listitem>
</varlistentry>

<varlistentry id="cmdline-resume-after">
<term
><option
><link linkend="cmdline-resume-after"
>--resume-after</link
></option
> (або <option
>--after</option
>, або <option
>-a</option
>) <replaceable
>модуль</replaceable
></term>
<listitem
><para
>Цей параметр використовується для поновлення збирання після вказаного модуля. Крім того, вам не слід вказувати інших модулів у командному рядку. </para>

<note
><para
>Якщо ви бажаєте уникнути оновлення кодів програма під час поновлення збирання, просто додайте до інших параметрів <option
><userinput
>--no-src</userinput
></option
>. </para
></note>

<para
>Див. також <link linkend="cmdline-resume-from"
>--resume-from</link
> та <xref linkend="resuming-failed"/>. Вам слід надавати перевагу використанню цього параметра командного рядка, якщо ви виправили помилку збирання, а також зібрали і встановили модуль власноруч, і бажаєте, щоб скрипт &kdesrc-build; розпочав з обробки наступного модуля.</para
></listitem>
</varlistentry>

<varlistentry id="cmdline-resume">
<term
><option
><link linkend="cmdline-resume"
>--resume</link
></option
></term>
<listitem
><para
>Цим параметром можна скористатися для запуску &kdesrc-build; після аварійного завершення роботи програми під час збирання. </para
><para
>За допомогою цього параметра можна відновити збирання з модуля, під час збирання якого сталася критична помилка, на основі попереднього списку модулів, які очікують на збирання. Оновлення коду та метаданих буде вимкнено. Цей параметр призначено для випадків, коли проста помилка або невстановлена залежність призводить до неможливості зібрати модуль. Щойно помилку буде виправлено, а залежність встановлено, ви можете швидко повернутися до збирання модулів без додаткових вправ зі встановлення належних аргументів для параметрів <option
><link linkend="cmdline-resume-from"
>--resume-from</link
></option
> та <option
><link linkend="cmdline-stop-before"
>--stop-before</link
></option
>. </para
></listitem>
</varlistentry>

<varlistentry id="cmdline-stop-before">
<term
><option
><link linkend="cmdline-stop-before"
>--stop-before</link
></option
> (або <option
>--until</option
>) <replaceable
>модуль</replaceable
></term>
<listitem
><para
>Цим параметром можна скористатися для того, щоб зупинити звичайне збирання <emphasis
>до того</emphasis
>, як розпочнеться збирання вказаного модуля. </para
><para
>Наприклад, якщо порядок у звичайному списку збирання був таким: <simplelist type="inline"
><member
>модульA</member
><member
>модульB</member
><member
>модульC</member
></simplelist
>, і вказано <option
>--stop-before <replaceable
>модульB</replaceable
></option
>, &kdesrc-build; виконає збирання лише модуля <literal
>модульA</literal
>. </para
></listitem>
</varlistentry>

<varlistentry id="cmdline-stop-after">
<term
><option
><link linkend="cmdline-stop-after"
>--stop-after</link
></option
> (або <option
>--to</option
>) <replaceable
>модуль</replaceable
></term>
<listitem
><para
>Цим параметром можна скористатися для того, щоб зупинити звичайне збирання <emphasis
>після того</emphasis
>, як розпочнеться збирання вказаного модуля. </para
><para
>Наприклад, якщо порядок у звичайному списку збирання був таким: <simplelist type="inline"
> <member
>модульA</member
><member
>модульB</member
><member
>модульC</member
></simplelist
>, і вказано <option
>--stop-after <replaceable
>модульB</replaceable
></option
>, &kdesrc-build; виконає збирання модулів <literal
>модульA</literal
> та <literal
>модульB</literal
>. </para
></listitem>
</varlistentry>

<varlistentry id="cmdline-stop-on-failure">
<term
><option
><link linkend="cmdline-stop-on-failure"
>--stop-on-failure</link
></option
>, <option
>--no-stop-on-failure</option
></term>
<listitem
><para
>За допомогою цього параметра можна керувати тим, чи буде збирання припинено, якщо станеться помилка. Корисний, якщо виконується початкове налаштовування середовища для розробки. Типовою є поведінка --stop-on-failure. Ви можете її перевизначити, якщо хочете продовжити збирання решти модулів у наборі, щоб уникнути втрати часу, якщо проблема виникла лише з одним з цих модулів. </para
><para
>Див. також параметр файла налаштувань <link linkend="conf-stop-on-failure"
>stop-on-failure</link
>. </para
></listitem>
</varlistentry>

<varlistentry id="cmdline-rebuild-failures">
<term
><option
><link linkend="cmdline-rebuild-failures"
>--rebuild-failures</link
></option
></term>
<listitem
><para
>Цим параметром можна скористатися для збирання лише тих модулів, які не вдалося зібрати під час попереднього запуску &kdesrc-build;. Це корисно, якщо одночасно із успішним збиранням декількох модулів не вдалося зібрати значну кількість інших модулів. Після виправлення помилки, що спричинила неможливість збирання, ви можете зібрати усі ті модулі, які не вдалося зібрати раніше.</para>

<note
><para
>Зауважте, що список модулів, які не вдалося зібрати раніше, переписується кожного разу, коли запуск &kdesrc-build; завершується із помилками під час збирання модулів. Втім, такий список не змінюється, якщо збирання було повністю успішним, тому ви можете успішно повторно зібрати один або два модулі, а цей параметр все одно працюватиме.</para
></note>
</listitem>
</varlistentry>

</variablelist>
</sect2>

<sect2>
<title
>Відомості щодо модулів</title>
<variablelist>

<varlistentry id="cmdline-query">
<term
><option
><link linkend="cmdline-query"
>--query</link
></option
> <userinput
><replaceable
>режим</replaceable
></userinput
></term>
<listitem
><para
>За допомогою цієї команди можна наказати &kdesrc-build; визначити значення параметра модулів у списку збирання (з командного рядка або з файла налаштувань) і вивести результат на екран (один рядок для кожного з модулів).</para>

<para
>Разом із цим параметром можна вказати «режим», одне з таких значень:</para>
    <itemizedlist>
    <listitem
><para
><parameter
>source-dir</parameter
> — наказує &kdesrc-build; вивести повний шлях до каталогу, де зберігається код модуля. </para
></listitem>
    <listitem
><para
><parameter
>build-dir</parameter
> — наказує &kdesrc-build; вивести повний шлях до каталогу, де відбуватиметься процес збирання. </para
></listitem>
    <listitem
><para
><parameter
>install-dir</parameter
> — наказує &kdesrc-build; вивести повний шлях до каталогу, куди буде встановлено модуль. </para
></listitem>
    <listitem
><para
><parameter
>project-path</parameter
> — наказує &kdesrc-build; вивести розташування модуля у ієрархії сховищ із початковим кодом програм KDE. Докладний опис цієї ієрархії наведено у розділі <xref linkend="kde-projects-module-sets"/>. </para
></listitem>
    <listitem
><para
><parameter
>branch</parameter
> — наказує &kdesrc-build; вивести назву визначеної гілки git, яку буде використано для кожного з модулів на основі поточних значень параметрів <link linkend="conf-tag"
>tag</link
>, <link linkend="conf-branch"
>branch</link
> та <link linkend="conf-branch-group"
>branch-group</link
>. </para
></listitem>
    <listitem
><para
><parameter
>module-set</parameter
> — наказує &kdesrc-build; вивести назву набору модулів, який містить модуль. Можна використати для створення кешу автоматичного доповнення у zsh. </para
></listitem>
    <listitem
><para
><parameter
>build-system</parameter
> — наказує &kdesrc-build; виводити назву виявленої системи збирання для модуля. Цим можна скористатися для діагностики проблем автоматичного виявлення системи збирання або при розробці тестів для специфічних систем збирання. </para
></listitem>
    <listitem
><para
>Будь-яка назва параметра, яка є коректною для модулів у <link linkend="conf-options-table"
>файлі налаштувань</link
>. </para
></listitem>
    </itemizedlist>

<informalexample>
<para
>Наприклад, команда <userinput
><command
>kdesrc-build</command
> <option
>--query</option
> <option
>branch</option
> <replaceable
>kactivities</replaceable
> <replaceable
>kdepim</replaceable
></userinput
> призведе до виведення даних, подібних до цих:</para>
<screen
>kactivities: master
kdepim: master
</screen>
</informalexample>
</listitem>
</varlistentry>

<varlistentry id="cmdline-dependency-tree">
<term
><option
><link linkend="cmdline-dependency-tree"
>--dependency-tree</link
></option
></term>
<listitem>
<para
>Виводить дані щодо залежностей модулів, які має бути зібрано, з використанням рекурсивного ієрархічного формату. У виведених даних буде зазначено внесок, гілку і мітку залежностей та те, чи має бути зібрано залежність. Зауваження: виведені дані можуть бути доволі об'ємними для програм із багатьма залежностями. </para>
</listitem>
</varlistentry>

<varlistentry id="cmdline-dependency-tree-fullpath">
<term
><option
><link linkend="cmdline-dependency-tree-fullpath"
>--dependency-tree-fullpath</link
></option
></term>
<listitem>
<para
>Виводить дані щодо залежностей модулів, які має бути зібрано, з використанням рекурсивного ієрархічного формату, у форматі повного шляху. Зауваження: виведені дані можуть бути доволі об'ємними для програм із багатьма залежностями. </para>
</listitem>
</varlistentry>

<varlistentry id="cmdline-list-installed">
<term
><option
><link linkend="cmdline-list-installed"
>--list-installed</link
></option
></term>
<listitem>
<para
>Вивести список встановлених модулів і завершити роботу. Цим можна скористатися для створення даних автоматичного доповнення для параметра --run. </para>
</listitem>
</varlistentry>

</variablelist>
</sect2>

<sect2>
<title
>Виключення певної дії</title>
<variablelist>

<varlistentry id="cmdline-no-metadata">
<term
><option
><link linkend="cmdline-no-metadata"
>--no-metadata</link
></option
> (або <option
>-M</option
>)</term>
<listitem
><para
>Не отримувати автоматично додаткових метаданих для модулів git &kde;. Оновлення самого коду модулів все одно відбуватиметься, якщо ви не додасте параметр <link linkend="cmdline-no-src"
>--no-src</link
>. </para
><para
>Цей параметр корисний, якщо ви часто перезапускаєте &kdesrc-build;, оскільки метадані змінюються доволі нечасто. Втім, слід пам’ятати, що метадані потрібні для роботи багатьох інших можливостей програми. Ви можете просто запустити &kdesrc-build; з параметром <link linkend="cmdline-metadata-only"
>--metadata-only</link
> один раз, а потім користуватися цим параметром під час наступних запусків. </para
></listitem>
</varlistentry>

<varlistentry id="cmdline-no-src">
<term
><option
><link linkend="cmdline-no-src"
>--no-src</link
></option
> (або <option
>-S</option
>)</term>
<listitem
><para
>Пропустити зв’язок з сервером &git;. </para
></listitem>
</varlistentry>

<varlistentry id="cmdline-no-build">
<term
><option
><link linkend="cmdline-no-build"
>--no-build</link
></option
></term>
<listitem
><para
>Пропустити процес збирання. </para
></listitem>
</varlistentry>

<varlistentry id="cmdline-no-install">
<term
><option
><link linkend="cmdline-no-install"
>--no-install</link
></option
></term>
<listitem
><para
>Не встановлювати автоматично пакунки після збирання. </para
></listitem>
</varlistentry>

</variablelist>
</sect2>

<sect2>
<title
>Лише певна дія</title>
<variablelist>

<varlistentry id="cmdline-metadata-only">
<term
><option
><link linkend="cmdline-metadata-only"
>--metadata-only</link
></option
></term>
<listitem
><para
>Виконали лише дії з отримання метаданих. Зазвичай, &kdesrc-build; виконує отримання метаданих у автоматичному режимі, тому цей параметр потрібен, лише якщо вам хочеться уможливити виконання команди з параметром <option
><link linkend="cmdline-pretend"
>--pretend</link
></option
>. </para
></listitem>
</varlistentry>

<varlistentry id="cmdline-src-only">
<term
><option
><link linkend="cmdline-src-only"
>--src-only</link
></option
> (або <option
>-s</option
>)</term>
<listitem
><para
>Виконати лише оновлення початкових кодів. </para
></listitem>
</varlistentry>

<varlistentry id="cmdline-build-only">
<term
><option
><link linkend="cmdline-build-only"
>--build-only</link
></option
></term>
<listitem
><para
>Виконати лише процес збирання. </para
></listitem>
</varlistentry>

<varlistentry id="cmdline-install-only">
<term
><option
><link linkend="cmdline-install-only"
>--install-only</link
></option
></term>
<listitem
><para
>Якщо цей параметр буде єдиним, скрипт намагатиметься встановити всі модулі, вказані у <filename
>log/latest/build-status</filename
>. Якщо після цього параметра буде вказано інші параметри командного рядка, всі ці параметри вважатимуться назвами модулів, які слід встановити (навіть якщо їх не вдалося зібрати під час попереднього запуску). </para
></listitem>
</varlistentry>

<varlistentry id="cmdline-build-system-only">
<term
><option
><link linkend="cmdline-build-system-only"
>--build-system-only</link
></option
></term>
<listitem
><para
>За допомогою цього параметра можна наказати &kdesrc-build; перервати збирання модуля безпосередньо перед виконанням команди <command
>make</command
>. Параметр підтримується лише з міркувань сумісності зі старішими версіями скрипту, у ньому немає користі за поточної системи збирання &kde;. </para
></listitem>
</varlistentry>

</variablelist>
</sect2>

<sect2>
<title
>Поведінка під час збирання</title>
<variablelist>

<varlistentry id="cmdline-build-when-unchanged">
<term
><option
><link linkend="cmdline-build-when-unchanged"
>--build-when-unchanged</link
></option
> (або <option
>--force-build</option
>), <option
>--no-build-when-unchanged</option
> (або <option
>--no-force-build</option
>)</term>
<listitem
><para
>За допомогою цього параметра можна явним чином вимкнути пропуски у процесі збирання (оптимізацію, якою керує <link linkend="conf-build-when-unchanged"
>build-when-unchanged</link
> параметр). Параметр буде корисним для запуску збирання за допомогою &kdesrc-build; у разі внесення вами змін, які не може бути автоматично виявлено &kdesrc-build;. Типово увімкнено.</para>
</listitem>
</varlistentry>

<varlistentry id="cmdline-refresh-build">
<term
><option
><link linkend="cmdline-refresh-build"
>--refresh-build</link
></option
> (або <option
>-r</option
>)</term>
<listitem
><para
>Повторно створити систему збирання і виконати збирання з початку. </para
></listitem>
</varlistentry>

<varlistentry id="cmdline-reconfigure">
<term
><option
><link linkend="cmdline-reconfigure"
>--reconfigure</link
></option
></term>
<listitem
><para
>Виконати <command
>cmake</command
> (для модулів &kde;) або <command
>configure</command
> (для &Qt;) знову, без спорожнення каталогу збирання. Зазвичай, потреби у такій поведінці немає, оскільки &kdesrc-build; сам може виявити зміни у відповідних параметрах і автоматично перезапустити налаштування збирання. Цей параметр буде використано, якщо ви скористаєтеся параметром <parameter
><link linkend="cmdline-refresh-build"
>--refresh-build</link
></parameter
>. </para
></listitem>
</varlistentry>

<varlistentry id="cmdline-install-dir">
<term
><option
><link linkend="cmdline-install-dir"
>--install-dir</link
> <replaceable
>шлях</replaceable
></option
></term>
<listitem
><para
>За допомогою цього параметра можна змінити каталог, до якого буде встановлено модуль. За використання цього параметра автоматично використовується параметр <link linkend="cmdline-reconfigure"
><option
>--reconfigure</option
></link
>, але можливо доведеться окремо скористатися параметром <link linkend="cmdline-refresh-build"
><option
>--refresh-build</option
></link
>. </para
></listitem>
</varlistentry>

<varlistentry id="cmdline-generate-vscode-project-config">
<term
><option
><link linkend="cmdline-generate-vscode-project-config"
>--generate-vscode-project-config</link
></option
>, <option
>--no-generate-vscode-project-config</option
></term>
<listitem
><para
>Створити каталог <filename
>.vscode</filename
> із налаштуваннями для збирання та діагностики у Visual Studio Code. Типово вимкнено. </para
></listitem>
</varlistentry>

</variablelist>
</sect2>

<sect2>
<title
>Під час виконання скрипту</title>
<variablelist>

<varlistentry id="cmdline-async">
<term
><option
><link linkend="cmdline-async"
>--async</link
></option
>, <option
>--no-async</option
></term>
<listitem
><para
>Вмикає або вимикає <link linkend="conf-async"
>асинхронний режим</link
>, за якого оновлення початкового коду і збирання модуля відбувається одночасно. Якщо вимкнено, перед початком збирання відбуватиметься повне оновлення вихідних кодів. Вимикання цього параметра уповільнить процес збирання, але, якщо ви бачите помилки щодо IPC під час виконання скрипту &kdesrc-build;, спробуйте його вимкнути, а також надішліть <ulink url="https://bugs.kde.org/"
>звіт про ваду</ulink
>. Типово, цей параметр увімкнено. </para
></listitem>
</varlistentry>

<varlistentry id="cmdline-color">
<term
><option
><link linkend="cmdline-color"
>--color</link
></option
> (або <option
>--colorful-output</option
>), <option
>--no-color</option
> (або <option
>--no-colorful-output</option
>)</term>
<listitem
><para
>Вмикає або вимикає виведення інформації у кольорі. Типово увімкнено для інтерактивних терміналів. </para
></listitem>
</varlistentry>

<varlistentry id="cmdline-nice">
<term
><option
><link linkend="cmdline-nice"
>--nice</link
></option
> (або <option
>--niceness</option
>) <replaceable
>значення</replaceable
></term>
<listitem
><para
>За допомогою цього параметра можна скоригувати пріоритет використання процесора &kdesrc-build;. Значенням має бути число у діапазоні 0-20. 0 відповідає найвищому пріоритету, 20 — найнижчому. Типовим значенням є 10. </para
></listitem>
</varlistentry>

<varlistentry id="cmdline-rc-file">
<term
><option
><link linkend="cmdline-rc-file"
>--rc-file</link
></option
> <replaceable
>файл</replaceable
></term>
<listitem
><para
>Файл, з якого слід читати параметри налаштування. Типовим значенням цього параметра є <filename
>kdesrc-buildrc</filename
> (скрипт шукатиме його у поточному робочому каталозі). Якщо цього файла не існуватиме, замість нього буде використано <filename
>~/.config/kdesrc-buildrc</filename
> (<filename
>$XDG_CONFIG_HOME/kdesrc-buildrc</filename
>, якщо встановлено значення <envar
>$XDG_CONFIG_HOME</envar
>). Див. також <xref linkend="kdesrc-buildrc"/>. </para
></listitem>
</varlistentry>

</variablelist>
</sect2>

<sect2>
<title
>Налаштовування</title>
<variablelist>

<varlistentry id="cmdline-initial-setup">
<term
><option
><link linkend="cmdline-initial-setup"
>--initial-setup</link
></option
></term>
<listitem
><para
>Наказує &kdesrc-build; виконати одноразове початкове налаштовування, яке потрібне для приготування системи до роботи з &kdesrc-build; та забезпечення можливості запуску нововстановленого програмного забезпечення &kde;. </para>
<para
>Це зокрема:</para>
<itemizedlist>
<listitem
><para
>Встановлення відомих залежностей (для підтримуваних дистрибутивів &Linux;)</para
></listitem>
<listitem
><para
>Додавання потрібних змінних середовища до <literal
>~/.bashrc</literal
></para
></listitem>
</itemizedlist>
<para
>Цей параметр є точним відповідником спільного використання параметрів <option
><link linkend="cmdline-install-distro-packages"
>--install-distro-packages</link
></option
> <option
><link linkend="cmdline-generate-config"
>--generate-config</link
></option
>. У kdesrc-build (реалізація на perl) додатково використовується «--install-distro-packages-perl». </para>
</listitem>
</varlistentry>

<varlistentry id="cmdline-install-distro-packages">
<term
><option
><link linkend="cmdline-install-distro-packages"
>--install-distro-packages</link
></option
></term>
<listitem
><para
>Встановити пакунки дистрибутива (для підтримуваних дистрибутивів &Linux;), які потрібні для приготування системи до роботи з &kdesrc-build; та забезпечення можливості запуску нововстановленого програмного забезпечення &kde;. </para>
<para
>Див. також <option
><link linkend="cmdline-initial-setup"
>--initial-setup</link
></option
></para>
</listitem>
</varlistentry>

<varlistentry id="cmdline-generate-config">
<term
><option
><link linkend="cmdline-generate-config"
>--generate-config</link
></option
></term>
<listitem
><para
>Створити файл налаштувань &kdesrc-build;. </para>
<para
>Див. також <option
><link linkend="cmdline-initial-setup"
>--initial-setup</link
></option
></para>
</listitem>
</varlistentry>

</variablelist>
</sect2>

<sect2>
<title
>Рівень подробиць</title>
 
<variablelist>

<varlistentry id="cmdline-debug">
<term
><option
><link linkend="cmdline-debug"
>--debug</link
></option
></term>
<listitem
><para
>Вмикає режим усування вад для скрипту. У поточній версії це означає, що всі виведені скриптом дані буде спрямовано у стандартний вивід оболонки на додачу до їх запису до каталогу журналу у звичайному режимі. Крім того, у такому режимі багато з функціональних можливостей скрипту надають у цьому режимі значно докладніші відомості про свою роботу. </para
></listitem>
</varlistentry>

<varlistentry id="cmdline-quiet">
<term
><option
><link linkend="cmdline-quiet"
>--quiet</link
></option
> (або <option
>--quite</option
>, або <option
>-q</option
>)</term>
<listitem
><para
>Виводити лише скорочену інформацію. За використання цього параметра буде виведено лише базові відомості. </para
></listitem>
</varlistentry>

<varlistentry id="cmdline-really-quiet">
<term
><option
><link linkend="cmdline-really-quiet"
>--really-quiet</link
></option
></term>
<listitem
><para
>Повідомляти лише про попередження і помилки. </para
></listitem>
</varlistentry>

<varlistentry id="cmdline-verbose">
<term
><option
><link linkend="cmdline-verbose"
>--verbose</link
></option
></term>
<listitem
><para
>Виводити докладну інформацію про те, що відбувається, і про дії, які виконує &kdesrc-build;. </para
></listitem>
</varlistentry>

</variablelist>
</sect2>

<sect2>
<title
>Відомості щодо скрипту</title>
<variablelist>

<varlistentry id="cmdline-version">
<term
><option
><link linkend="cmdline-version"
>--version</link
></option
> (або <option
>-v</option
>)</term>
<listitem
><para
>Показує версію програми. </para
></listitem>
</varlistentry>

<varlistentry id="cmdline-help">
<term
><option
><link linkend="cmdline-help"
>--help</link
></option
> (або <option
>-h</option
>)</term>
<listitem
><para
>Показати лише короткі довідкові відомості про скрипт. </para
></listitem>
</varlistentry>

<varlistentry id="cmdline-show-info">
<term
><option
><link linkend="cmdline-show-info"
>--show-info</link
></option
></term>
<listitem
><para
>Показати відомості щодо &kdesrc-build; та операційної системи. Ці відомості можуть бути корисними для звітів щодо вад або запитань на форумах чи у списках листування. </para>
</listitem>
</varlistentry>

<varlistentry id="cmdline-show-options-specifiers">
<term
><option
><link linkend="cmdline-show-options-specifiers"
>--show-options-specifiers</link
></option
></term>
<listitem
><para
>Вивести рядки специфікаторів (у форматі, який приймає GetOpts::Long) для усіх параметрів командного рядка, підтримку яких передбачено у скрипті. Цим параметром можуть скористатися розробники, наприклад, для створення функцій автоматичного доповнення у zsh. </para
></listitem>
</varlistentry>

</variablelist>

</sect2>
</sect1>
