natgillin/translations-raw huggingface dataset:
In & subversion;, there is no difference between branches, tags, or trunk within the code. It is only a convention used by the developers. This makes it difficult to properly support branches and tags within & kdesvn-build;. However, there are some things that can be done.
У & subversion; немає ніяких відмінностей між версіями, випусками і експериментальною версією (trunk) коду. Подібне відокремлення є лише наслідком певної домовленості між розробниками. Це ускладнює належну підтримку версій і випусків у & kdesvn- build;. Все ж деякі речі можна робити і за допомогою скрипту.
How to use branches and tags
Як користуватися версіями і випусками?
Support for branches and tags is handled by a set of options, which range from a generic request for a version, to a specific & url; to download for advanced users.
Підтримка версій і випусків забезпечується набором параметрів, які призначено для виконання дій у діапазоні від загального запису на певну версію, до визначення адреси & url; для звантаження досвідченими користувачами.
The easiest method is to use the & branch; and & tag; options. You simply use the option along with the name of the desired branch or tag for a module, and & kdesvn-build; will try to determine the appropriate location within the & kde; repository to download from. For most & kde; modules this works very well.
Найпростішим способом є використання параметрів & branch; і & tag;. Ви можете просто скористатися параметром з аргументом- назвою бажаної версії або випуску модуля, — & kdesvn- build; спробує визначити належну адресу у сховищі & kde; для звантаження коду. Для більшості модулів & kde; таких спосіб працює дуже добре.
To download kdelibs from & kde; 3.5 (which is simply known as the 3.5 branch):
Щоб звантажити kdelibs зі складу & kde; 3. 5 (відповідне сховище відоме, як версія 3. 5):
module kdelibs branch 3.5 # other options... end module
module kdelibs branch 3. 5 # інші параметри... end module
Or, to download kdemultimedia as it was released with & kde; 3.4.3:
Або, щоб звантажити kdemultimedia у вигляді, у якому цей модуль було випущено у & kde; 3. 4. 3:
module kdemultimedia tag 3.4.3 # other options... end module
module kdemultimedia tag 3. 4. 3 # інші параметри... end module
You can specify a global branch value. But if you do so, do not forget to specify a different branch for modules that should not use the global branch!
Ви можете вказати загальне значення версії (branch). Але, якщо ви це зробите, не забудьте вказати іншу версію для модулів, які не використовують загальної нумерації версій!
Advanced branch support options
Додаткові параметри підтримки версій
& kdesvn-build; supports two options for situations where & branch; and & tag; guess the correct path improperly: & module-base-path; and & override-url;.
& kdesvn- build; підтримує два параметри, призначені для обробки ситуацій, коли параметри & branch; і & tag; неправильно визначають шлях до сховища: & module- base- path; і & override- url;.
& module-base-path; is used to help & kdesvn-build; fill in the missing part of a module's path. In the & kde; repository, all of the paths are of the form svnRoot/ module-base-path/ module-name. Normally & kdesvn-build; can figure out the appropriate middle part by itself. When it cannot, you can use & module-base-path;, like this:
Параметр & module- base- path; використовується для того, щоб допомогти & kdesvn- build; заповнити відсутню частину шляху до модуля. У сховищі & kde; всіх шляхи виглядають так: Корінь_ svn/ базовий_ шлях_ до_ модуля / назва модуля. Зазвичай, & kdesvn- build; може визначити відповідну середню частину самостійно. Якщо програма не може цього зробити, ви можете скористатися & module- base- path;, ось так:
module qt-copy # branch does not work here yet module-base-path branches/ qt/ 3.3 end module
module qt- copy # тут стабільні версії ще не працюють module- base- path branches/ qt/ 3. 3 end module
This would cause & kdesvn-build; to download qt-copy from (in this example), svn: / /anonsvn. kde. org/ home/ kde/ branches/ qt/ 3.3 / qt-copy.
Таким чином ви накажете & kdesvn- build; звантажити qt- copy з (у нашому прикладі), svn: // anonsvn. kde. org/ home/ kde / branches/ qt/ 3. 3 / qt- copy.
The & override-url; option, on the other hand, requires you to specify the exact path to download from. However, this allows you to pull from paths that & kdesvn-build; would have no hope of downloading from.
З іншого боку, параметр & override- url; дозволяє вам вказати точний шлях для звантаження. За допомогою цього параметра ви можете наказати & kdesvn- build; виконати звантаження з тих адрес, які скрипт не може визначити самостійно.
module qt-copy # Specify exact path to grab. override-url svn: / /anonsvn. kde. org/ home/ kde/ branches/ qt/ 3.3/ qt-copy end module
module qt- copy # Визначення точного шляху для звантаження. override- url svn: // anonsvn. kde. org/ home/ kde/ branches/ qt/ 3. 3/ qt- copy end module
& kdesvn-build; will not touch or correct the value you specify for & override-url; at all, so if you change your & svn-server; setting, you may need to update this as well.
& kdesvn- build; не змінюватиме і не виправлятиме значення, яке ви вкажете для & override- url;, отже, якщо ви зміните ваш параметр & svn- server;, може виникнути потреба і у зміні цього параметра.
How & kdesvn-build; tries to ensure a successful build
Способи, у які & kdesvn- build; намагається забезпечити успішне збирання
Automatic rebuilds
Автоматичне перезбирання
Due to various issues with the & kde; build system & kdesvn-build; will automatically perform a series of steps to automatically try to get a module to compile when it fails.
Через різноманітні недоліки у системі збирання & kde;, & kdesvn- build; автоматично виконує послідовність кроків, за допомогою яких скрипт намагається зібрати модуль, якщо перша спроба збирання завершилася невдало.
On the first failure, & kdesvn-build; will simply re-run the make. Believe it or not, but this sometimes actually works, and is quick to fail if it will not work.
Після першої спроби & kdesvn- build; просто перезапускає make. Вірите чи ні, але іноді такий перезапуск призводить до бажаних результатів, якщо ж це не спрацює, результати будуть відомі дуже скоро.
On the second failure, & kdesvn-build; will try to reconfigure the module and then rebuild it. This usually catches situations where a build-system file that requires reconfiguration changed, but the build system did not perform that step automatically.
За повторної помилки & kdesvn- build; намагається повторно виконати скрипт configure для модуля, а потім ще раз зібрати його. Зазвичай, таким чином можна вирішити проблеми, пов’ язані з файлом системи збирання, для якого потрібне повторне налаштування, яке не виконується системою збирання у автоматичному режимі.
The module build directory is left intact for this step, so, except for the reconfigure step, this will also fail quickly if the build cannot be performed.
Каталог збирання модуля під час виконання цього кроку не змінюється, отже, за винятком кроку з повторного налаштування (запуску скрипту configure), у разі неможливості збирання все теж завершиться досить швидко.
If the module still fails to build, & kdesvn-build; will give up and move on to the next module. There are still things that you can do to manually try to get the module to build, however.
Якщо модуль так і не вдалося зібрати, & kdesvn- build; здається і переходить до збирання іншого модуля. Але існують і способи, за допомогою яких ви можете спробувати зібрати модуль вручну.
& kdesvn-build; will detect most cases where the build system needs to be reconfigured, and will reconfigure automatically in that case.
& kdesvn- build; виявить більшість випадків, коли система збирання потребує повторного налаштування, і виконає його у автоматичному режимі.
Also, if & kdesvn-build; was building the module for the first time, all of these steps are skipped, since the clean rebuild does not usually fail except for a real error.
Крім того, якщо & kdesvn- build; збирає модуль вперше, всі ці кроки можна пропустити, оскільки збирання « на порожньому місці », зазвичай, не призводить до помилок, за винятком існування серйозних проблем у коді.
Manually rebuilding a module
Перезбирання модуля вручну
If you make a change to a module's option settings, or the module's source code changes in a way & kdesvn-build; does not recognize, you may need to manually rebuild the module.
Якщо ви змінили параметри певного модуля або код модуля змінився таким чином, що & kdesvn- build; не може його розпізнати, у вас може виникнути потреба у повторному збиранні цього модуля вручну.
You can do this by simply running kdesvn-build --refresh-build module.
Ви можете зробити це простою командою kdesvn- build -- refresh- build назва_ модуля.
If you would like to have & kdesvn-build; automatically rebuild the module during the next normal build update instead, you can create a special file. Every module has a build directory. If you create a file called. refresh-me in the build directory for a module, & kdesvn-build; will rebuild the module next time the build process occurs, even if it would normally perform the faster incremental build.
Якщо замість цього ви бажаєте, щоб скрипт & kdesvn- build; автоматично перезібрав модуль під час наступного звичайного оновлення збирання, ви можете створити спеціальний файл. Кожен з модулів має власний каталог для збирання. Якщо ви створите у цьому каталозі для збирання файл з назвою. refresh- me, & kdesvn- build; повторно збере модуль під час наступного сеансу збирання, навіть якщо скрипт виконує швидке нарощувальне збирання.
By default, the build directory is ~/ kdesvn/ build/ module /. If you change the setting of the & build-dir; option, then use that instead of ~/ kdesvn/ build.
Типово, каталогом збирання буде ~/ kdesvn/ build / назва модуля /. Якщо ви зміните значення параметра & build- dir;, буде замість ~/ kdesvn/ build буде використано значення цього параметра.
Rebuild using. refresh-me for module arts:
Повторне збирання за допомогою. refresh- me модуля arts:
Controlling rebuild behavior
Керування поведінкою перезбирання
You may not want & kdesvn-build; to always try and rebuild a module. You can permanently disable this behavior by changing the option & no-rebuild-on-fail; to have the value true.
Ймовірно, ви не бажатимете, щоб скрипт & kdesvn- build; завжди намагався перезібрати певний модуль. Ви можете вимкнути повторне збирання зміною значення параметра & no- rebuild- on- fail; на true.
You can disable this behavior temporarily (for one command) by using the & cmd-no-rebuild-on-fail; command line option.
Тимчасово вимкнути повторне збирання (на час виконання одної команди) можна за допомогою параметра командного рядка & cmd- no- rebuild- on- fail;.
Changing environment variable settings
Зміна параметрів змінних середовища
& kdesvn-build; does not read the environment from the caller like the vast majority of most programs do. Instead, it uses the settings it reads from the configuration file to construct the environment. This is done mainly to ensure that builds are repeatable. In other words, & kdesvn-build; can build a module even if you forgot what you set your environment variables to in the shell you ran & kdesvn-build; from.
& kdesvn- build; не читає змінні середовища з оболонки, звідки було викликано скрипт, як це робить більшість програм. Замість цього скрипт використовує параметри, вказані у файлі налаштувань для побудови відповідного середовища. Так зроблено головним чином для того, щоб збирання завжди виконувалося однаково (було повторюваним). Іншими словами, & kdesvn- build; може зібрати певний модуль, навіть якщо ви забули, які змінні середовища ви встановили у оболонці, звідки ви запускаєте & kdesvn- build;.
However, you may want to change the setting for environment variables that & kdesvn-build; does not provide an option for directly. This is possible with the & set-env; option.
Крім того, у вас може виникнути потреба у зміні тих змінних середовища, для яких у & kdesvn- build; не передбачено параметрів. Це можна зробити за допомогою параметра & set- env;.
Unlike most options, it can be set more than once, and it accepts two entries, separated by a space. The first one is the name of the environment variable to set, and the remainder of the line is the value.
На відміну від інших параметрів, цей параметр можна визначати декілька разів, він приймає два записи, відокремлені пробілом. Першим з записів є назва змінної середовища, яку слід встановити, решта рядка вважається значенням цієї змінної.
Set DISTRO = BSD for all modules:
Встановити значення змінної DISTRO = BSD для всіх модулів:
Resuming builds
Поновлення збирання
Resuming a failed or canceled build
Поновлення збирання, яке завершилося помилкою або було скасоване
You can tell & kdesvn-build; to start building from a different module than it normally would. This can be useful when a set of modules failed, or if you canceled a build run in the middle. You can control this using the & cmd-resume-from; option.
Ви можете наказати & kdesvn- build; почати збирання з модуля, відмінного від того, з якого скрипт зазвичай розпочинає збирання. Такі налаштування можуть стати у нагоді, якщо спроба збирання певного набору модулів завершилася невдало або якщо ви перервали попередню спробу збирання. Вказати модуль можна за допомогою параметра & cmd- resume- from;.
Using & cmd-resume-from; will skip the source code update.
Використання параметра & cmd- resume- from; скасовує спробу оновлення початкових кодів.
Resuming the build starting from kdebase:
Відновлення збирання з модуля kdebase:
Ignoring modules in a build
Ігнорування модулів під час збирання
Similar to the way you can resume the build from a module, you can instead choose to update and build everything normally, but ignore a set of modules.
Подібно до способу, у який ви можете поновити збирання, починаючи з певного модуля, ви можете і оновити зібрати компоненти у звичайному режимі, але без певного набору модулів.
You can do this using the & cmd-ignore-modules; option. This option tells & kdesvn-build; to ignore all the modules on the command line when performing the update and build.
Виконати це завдання можна за допомогою параметра & cmd- ignore- modules;. За допомогою цього параметра ви можете повідомити скрипту & kdesvn- build; про те, що слід ігнорувати всі передані як аргументи у командному рядку модулі під час виконання оновлення і збирання.
Ignoring extragear/ multimedia and kdereview during a full run:
Ігнорування extragear/ multimedia і kdereview під час повноцінного запуску:
Changing options from the command line
Зміна параметрів за допомогою командного рядка
Changing global options
Зміна загальних параметрів
You can change the setting of options read from the configuration file directly from the command line. This change will override the configuration file setting, but is only temporary. It only takes effect as long as it is still present on the command line.
Ви можете змінити набір параметрів з файла налаштувань безпосередньо з командного рядка. Ця зміна перевизначить параметри файла налаштувань, але лише тимчасово. Ці параметри працюватимуть лише протягом виконання вказаної у командному рядку команди.
& kdesvn-build; allows you to change options named like option-name by passing an argument on the command line in the form -- option-name =value. & kdesvn-build; will recognize whether it does not know what the option is, and search for the name in its list of option names. If it does not recognize the name, it will warn you, otherwise it will remember the value you set it to and override any setting from the configuration file.
& kdesvn- build; надає вам змогу змінити параметри з назвою назва- параметра передаванням аргументу у командний рядок у формі -- назва- параметра =значення. & kdesvn- build; визначає чи відомий скрипту параметр і намагається знайти назву у власному списку назв параметр. Якщо програмі не вдається знайти назву, вона попередить вас про це, у іншому випадку скрипт запам’ ятає встановлене вами значення і перевизначає значення, встановлення у файлі налаштувань.
Setting the & source-dir; option to / dev/ null for testing:
Встановлення параметра & source- dir; у значення / dev/ null для перевірки:
Changing module options
Зміна параметрів для модулів
It is also possible to change options only for a specific module. The syntax is similar: -- module, option-name = value.
Крім того, можна змінити параметри, вказані для окремого модуля. Синтаксис команди, подібний до синтаксису попередньої команди: -- назва_ модуля, назва- параметра = значення.
This change overrides any duplicate setting for the module found in the configuration file, and applies only while the option is passed on the command line.
Ця зміна перевизначає параметр відповідного модуля у файлі налаштувань і діє лише протягом виконання рядка команди.
Using a different build directory for the kdeedu module:
Використання іншого каталогу збирання для модуля kdeedu:
Features for & kde; developers
Можливості, призначені для розробників & kde;
& ssh; Agent checks
Перевірки агента & ssh;
& kdesvn-build; can ensure that & kde; developers that use & ssh; to access the & kde; source repository do not accidentally forget to leave the & ssh; Agent tool enabled. This can cause & kdesvn-build; to hang indefinitely waiting for the developer to type in their & ssh; password, so by default, & kdesvn-build; will check if the Agent is running before performing source updates.
& kdesvn- build; може забезпечити вимикання інструмента агента & ssh;, якщо розробник & kde;, який використовується & ssh; для доступу до сховища коду & kde;, забуде його вимкнути. Таким чином, & kdesvn- build; може нескінченно очікувати на введення розробником пароля & ssh;, отже, типово, & kdesvn- build; перевіряє, чи запущено агент перед виконанням оновлення коду.
This is only done for & kde; developers using & ssh;. This is because no password is required for the default anonymous checkout. & subversion; will handle passwords for the second possible protocol for & kde; developers, https.
Ці дії виконуються лише для розробників & kde;, які використовують & ssh;. Причиною цього є те, що для типового анонімного доступу для звантаження пароль не потрібен. & subversion; оброблятиме паролі для іншого можливого способу доступу для розробників & kde;, https.
You may wish to disable the & ssh; Agent check, in case of situations where & kdesvn-build; is mis-detecting the presence of an agent. To disable the agent check, set the disable-agent-check option to true.
Ймовірно, ви захочете вимкнути перевірку агента & ssh; у випадку, коли & kdesvn- build; помилково визначає присутність агента. Щоб вимкнути перевірку агента, встановіть для параметра disable- agent- check значення true.
Disabling the & ssh; agent check:
Вимикання перевірки & ssh; - агента:
Other & kdesvn-build; features
Інші можливості & kdesvn- build;
Changing the amount of output from & kdesvn-build;
Зміна рівня докладності виводу & kdesvn- build;
& kdesvn-build; has several options to control the amount of output the script generates. In any case, errors will always be output.
У & kdesvn- build; передбачено декілька параметрів для керування об’ ємом даних, які виводить скрипт. У будь- якому випадку, помилки завжди виводяться.
The --quiet option (short form is -q) causes & kdesvn-build; to be mostly silent. Only important messages, warnings, or errors will be shown. When available, build progress information is still shown.
Запуск & kdesvn- build; з параметром -- quiet (скорочена форма - q) виводить мінімум даних. Буде показано лише важливі повідомлення, попередження або повідомлення про помилки. Відомості щодо поступу збирання, у разі їх наявності, також буде показано.
The --really-quiet option (no short form) causes & kdesvn-build; to only display important warnings or errors while it is running.
За використання параметра -- really- quiet (не має скороченої форми) & kdesvn- build; під час виконання покаже лише важливі повідомлення і повідомлення про помилки.
The --verbose option (short form is -v) causes & kdesvn-build; to be very detailed in its output.
Використання параметра -- verbose (скорочена форма - v) призведе до дуже детального виводу даних & kdesvn- build;.
The --debug option is for debugging purposes only, it causes & kdesvn-build; to act as if --verbose was turned on, causes commands to also output to the terminal, and will display debugging information for many functions.
Параметр -- debug призначено лише для усування вад, за його використання & kdesvn- build; працюватиме так, наче увімкнено -- verbose, команди виводитимуть дані до термінала, крім того, буде показано відомості, призначені для усування вад для багатьох функціональних можливостей.
Color output
Виведення у кольорі
When being run from & konsole; or a different terminal, & kdesvn-build; will normally display with colorized text.
Якщо ви запустите & kdesvn- build; з & konsole; або іншої програми емуляції термінала, скрипт виводитиме розфарбований текст.
You can disable this by using the --no-color on the command line, or by setting the & colorful-output; option in the configuration file to false.
Ви можете вимкнути це розфарбування за допомогою параметра -- no- color, доданого до командного рядка або встановленням для параметра & colorful- output; у файлі налаштувань у значення false.
Disabling color output in the configuration file:
Вимикання виведення у кольорі у файлі налаштувань:
E-mailing build failure reports
Надсилання звітів про невдале збирання електронною поштою
& kdesvn-build; can send a e-mail report to an e-mail address of your choice when a module fails to build for whatever reason. The way it works is that you choose an e-mail address that & kdesvn-build; will send from, and an e-mail address to notify when there is an error.
& kdesvn- build; може надсилати звіти електронною поштою на вибрану вами адресу електронної пошти, якщо модуль не вдалося зібрати з будь- якої причини. Вам слід вказати & kdesvn- build; адресу, з якої слід надсилати електронну пошту та адресу, за якою слід надсилати сповіщення про помилку.
& kdesvn-build; will then, at the end of a complete run, construct an e-mail if there were any modules that failed to build. The e-mail will contain an abbreviated failure log for each module. Only one e-mail is sent for a run, even if 15 modules failed to build.
Після завершення спроби збирання & kdesvn- build; створить повідомлення електронної пошти, якщо спроба збирання якогось з модулів завершилася невдало. У цьому повідомленні міститиметься скорочений журнал помилок для кожного з модулів. Під час одного запуску скрипту може бути надіслано лише одне повідомлення, навіть якщо не вдалося зібрати 15 модулів.
This feature is not enabled by default. To enable it, you need to set both the & email-address; and & email-on-compile-error; options. email-address controls the address & kdesvn-build; sends from, and email-on-compile-error controls where to send the e-mail message to.
Цю можливість типово вимкнено. Для того, щоб увімкнути її, вам слід вказати значення параметрів & email- address; і & email- on- compile- error;. Значення параметра email- address визначає адресу, з якої & kdesvn- build; надсилатиме повідомлення, а значення email- on- compile- error визначає адресу, куди слід надсилати повідомлення.
& kdesvn-build; uses the Perl-standard Mail: :Mailer module to send e-mail. It is included with Perl 5.8, and is installable with Perl 5.6. Mail: :Mailer supports Sendmail (including Sendmail -compatible e-mail clients), native SMTP transport, and qmail.
Для надсилання повідомлень & kdesvn- build; використовує стандартний модуль Perl Mail:: Mailer. Цей модуль включено до складу Perl 5. 8, його можна встановити і у Perl 5. 6. Mail:: Mailer підтримує Sendmail (і зокрема сумісні з Sendmail клієнти електронної пошти), транспорт SMTP і qmail.
Sending email from foo@example. com to bar@example. com on a build failure:
Надсилання повідомлення електронною поштою з foo@ example. com до bar@ example. com у разі невдалої спроби збирання: