Розділ 4. Налаштування kdesrc-build

Файл налаштувань буде запущено з загальними параметрами, вказаними у такий спосіб:

global
назва_параметра значення_параметра
[...]
end global

Після цього повинні йти один або декілька розділів модулів, вказаних у одному з двох форматів:

Для модулів Git параметр назва_модуля має бути назвою модуля зі сховища Git KDE (наприклад kdeartwork або kde-wallpapers).

Для модулів Git назвою може бути будь-який рядок, якщо цей рядок не дублює інших назв модулів у налаштуваннях. Пам’ятайте, що розташування каталогів коду і збирання буде визначено на основі назви модуля, якщо ви не використаєте параметра dest-dir.

Але для наборів модулів Git назви-модулів мають відповідати справжнім модулям git modules у вибраному сховищі (параметр repository). Щоб дізнатися більше, ознайомтеся з довідкою щодо git-repository-base і use-modules.

Загалом, увесь вміст рядка після запису назва-параметра буде використано як значення-параметра.

Однією зі змін, які виконує kdesrc-build, є те, що послідовність ${назва-параметра} замінюється на значення цього параметра із загальних налаштувань. Це надає вам змогу посилатися на значення наявних параметрів, зокрема параметрів, значення яких вже встановлено kdesrc-build.

Із прикладом використання цього параметра можна ознайомитися у розділі Приклад 2.1, «Налаштовування Make на компіляцію з використанням усіх доступних процесорів з виключеннями».

Ви також можете додавати власні нестандартні загальні змінні для подальшого використання їх у налаштуваннях. Для цього слід використати для змінної назву, що починається із символу підкреслення. Приклад:

global
  _ver 6  # ← ваша нетипова змінна (починається з підкреслювання)
  _kde ~/kde${_ver}  # ← нетипова змінна може містити іншу визначену змінну
  source-dir ${_kde}/src  # ← зауважте вкладену змінну (_kde → _ver), яку також буде замінено
end global

options kdepim
  log-dir /custom/path/logs${_ver} # ← нетипову змінну можна використовувати як стандартну
end options

Цей останній тип записів файла налаштувань, групи options, яким можна скористатися для записів module або module-set.

options назва_модуля
назва_параметра значення_параметра
[...]
end options

У групі options можна встановлювати значення параметрів так само, як у оголошенні модуля. Цю групу має бути пов’язано з наявним модулем. Усі параметри, встановлені за допомогою цієї групи, буде використано для перевизначення набору параметрів пов’язаного модуля.

Це корисно, якщо треба оголосити повний набір module-set для модулів з використанням однакових параметрів, а потім скористатися групами options для внесення окремих змін.

Групи options можна також застосовувати до іменованих наборів модулів. Ця можливість надає змогу досвідченим користувачам використовувати загальний файл налаштувань (який включено до оголошення module-set) як основу і вносити зміни до параметрів, використовуваних наборами модулів, у файлах налаштувань, використовуючи команду include для посилання на основні налаштування.

module-set kde-multimedia-set
  repository kde-projects
  use-modules kde/kdemultimedia
  branch master
end module-set

# kmix є частиною групи kde/kdemultimedia, навіть якщо kmix раніше у файлі
# не згадувався, kdesrc-build врахує зміну.
options kmix
  branch KDE/4.12
end options