Параметри командного рядка і змінні середовищаЗміст
kdesrc-build має бути запущено так:
kdesrc-build [--параметри...] [модулі, які слід зібрати...]
Якщо у командному рядку не буде вказано жодних модулів, kdesrc-build збиратиме всі модулі, визначені у файлі налаштувань, за вказаним у файлі порядком (таку поведінку можна змінити за допомогою різних параметрів файла налаштувань).
Повний список параметрів командного рядка наведено у «Параметри командного рядка». Ось найпоширеніші параметри:
--pretend(або-p)За допомогою цього параметра kdesrc-build можна вказати, які дії слід виконати, без їхнього виконання. Це може бути корисним, якщо вам потрібно переконатися, що модулі, які вам потрібно зібрати, буде насправді зібрано.
--refresh-buildЗа допомогою цього параметра можна наказати kdesrc-build зібрати вказані модулі від початку. Всі вже створені каталоги збирання модуля буде вилучено, після чого його збирання буде повторено. Цей параметр корисний, якщо під час збирання модуля сталися помилки. Іноді ним доведеться користуватися у разі зміни бібліотек Qt™ або KDE.
--no-srcЗа допомогою цього параметра можна пропустити процедуру оновлення коду. Ви можете скористатися ним, якщо у вас є нещодавно оновлений початковий код (ви могли зробити це вручну або під час нещодавнього запуску kdesrc-build), але вам перезібрати певні модулі.
--no-buildЦей параметр подібний до наведеного вище параметра
--no-src, але у разі його використання процес збирання буде пропущено.
Загалом, визначення модулів для збирання доволі просте: достатньо передати назву модуля, яку визначено у файлі налаштувань. Ви також можете передати модулі, які є частиною набору модулів у форматі назв use-modules або назви всього набору модулів, якщо ви дали йому назву.
У окремому випадку наборів модулів, заснованих на базі даних проєктів KDE, kdesrc-build розгорне компоненти назв модулів для визначення потрібного вам модуля. Наприклад, запис проєкту KDE kdesrc-build відповідає проєкту у extragear/utils/kdesrc-build. Ви можете вказати будь-що з вказаного нижче для збирання kdesrc-build:
%kdesrc-build+extragear/utils/kdesrc-build%kdesrc-build+utils/kdesrc-build%kdesrc-build+kdesrc-build
Примітка
Команди у наведеному вище прикладі вказано перед назвою модуля з префіксом +. Це наказує програмі вважати назву модуля назвою з бази даних проєктів KDE, навіть якщо цей модуль не було визначено у вашому файлі налаштувань.
Будьте обережні з визначенням дуже загальних проєктів (наприклад extragear/utils), оскільки це може призвести до збирання надмірної кількості модулів. Вам слід скористатися параметром --pretend перед збиранням нового набору модулів, щоб було зібрано лише потрібні вам модулі.