'\" t .\" Title: \fBkabcclient\fR .\" Author: Kevin Krammer .\" Generator: DocBook XSL Stylesheets v1.79.1 .\" Date: 8 вересня 2005 року .\" Manual: Інструкція користувача KDE .\" Source: Стільничне середовище KDE .\" Language: Ukrainian .\" .TH "\fBkabcclient\fR" "1" "8 вересня 2005 року" "Стільничне середовище KDE" "Інструкція користувача KDE" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .\" http://bugs.debian.org/507673 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" ----------------------------------------------------------------- .\" * set default formatting .\" ----------------------------------------------------------------- .\" disable hyphenation .nh .\" disable justification (adjust text to left margin only) .ad l .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- .SH "НАЗВА" kabcclient \- клієнт адресної книги KDE, який працює з командного рядка .SH "КОРОТКИЙ ОГЛЯД" .HP \w'\fBkabcclient\fR\ 'u \fBkabcclient\fR [[\-A] | [\-R] | [\-M] | [\-S] | [\-L]] [\-\-match\-case] [\-\-nosave] [\-ic\ \fIкодек\fR] [\-if\ \fIформат\fR] [\-if\-opts\ \fIпараметри\ формату\fR] [\-oc\ \fIкодек\fR] [\-of\ \fIформат\fR] [\-of\-opts\ \fIпараметри\ формату\fR] [вхідні\ дані] .SH "ОПИС" .PP За допомогою \fBkabcclient\fR можна у командному рядку, наприклад зі скриптів оболонки, отримати доступ до адресної книги KDE\&. Програма підтримує отримання вхідних відомостей з stdin або з параметрів командного рядка\&. Результат дій завжди виводиться до stdout\&. .SH "ПАРАМЕТРИ" .PP \fIРежими роботи\fR .RS 4 .PP \fB\-A, \-\-add\fR .RS 4 Додати новий запис контакту до адресної книги .RE .PP \fB\-R, \-\-remove\fR .RS 4 Вилучає існуючий запис контакту з адресної книги .RE .PP \fB\-M, \-\-merge\fR .RS 4 Об\(cqєднує вхідні дані з існуючим записом контакту з адресної книги\&. За допомогою цього параметра можна додати будь\-яку нову інформацію до вже існуючої\&. .RE .PP \fB\-S, \-\-search\fR .RS 4 Виконує пошук у адресній книзі відповідних записі контактів .RE .PP \fB\-L, \-\-list\fR .RS 4 Виводить список всіх записів контактів з адресної книги\&. .RE .RE .PP \fIПараметри вхідної інформації\fR .RS 4 .PP \fB\-ic, \-\-input\-codec\fR .RS 4 Визначає кодування для вхідного тексту\&. Додаткові відомості щодо наявних кодеків можна отримати за допомогою параметра \fB\-ic\fR \fIhelp\fR\&. Типовим значенням є \fIlocal\fR, за якого буде використано кодек, що відповідає поточним параметрам \fBlocale\fR(5) .RE .PP \fB\-if, \-\-input\-format\fR .RS 4 Обробляє вхідний текст відповідно до вказаних параметрів форматування\&. Список доступних форматів можна переглянути за допомогою параметра \fB\-if\fR\fI help\fR\&. Типовим є режим \fIsearch\fR .RE .PP Замість читання вхідного тексту kabcclient може показати діалогове повідомлення для вибору контактів на основі вхідного формату .RS 4 \fIдіалогове вікно\fR .RE .PP \fB\-if\-opts, \-\-input\-format\-options\fR .RS 4 Додаткові параметри для обраного вхідного формату\&. Можуть бути обов\(cqязковими або необов\(cqязковими, залежно від формату\&. Список доступних параметрів формату можна переглянути за допомогою параметра \fB\-if\-opts\fR\fI help\fR\&. .RE .RE .PP \fIПараметри вихідних даних\fR .RS 4 .PP \fB\-oc, \-\-output\-codec\fR .RS 4 Визначає кодування для вихідного тексту\&. Додаткові відомості щодо наявних кодеків можна отримати за допомогою параметра \fB\-oc\fR \fIhelp\fR\&. Типовим значенням є \fIlocal\fR, за якого буде використано кодек, що відповідає поточним параметрам \fBlocale\fR(5) .RE .PP \fB\-of, \-\-output\-format\fR .RS 4 Форматує вихідний текст відповідно до вказаних правил форматування\&. Список доступних форматів можна отримати за допомогою параметра \fB\-of\fR\fI help\fR\&. Типовим значенням є \fIvcard\fR\&. .RE .PP \fB\-of\-opts, \-\-output\-format\-options\fR .RS 4 Додаткові параметри для обраного формату вихідних даних\&. Можуть бути обов\(cqязковими або необов\(cqязковими, залежно від формату\&. Список доступних параметрів формату можна переглянути за допомогою параметра \fB\-of\-opts\fR\fI help\fR\&. .RE .RE .PP \fIДодаткові параметри\fR .RS 4 .PP \fB\-\-match\-case\fR .RS 4 Враховувати регістр символів під час порівняння вхідного тексту з записами контактів\&. .RE .PP \fB\-\-nosave\fR .RS 4 Виконати дії зі зміни відомостей, на зразок дій, що відповідають параметрам \fB\-A, \-R\fR або \fB\-M\fR, лише у пам\(cqяті комп\(cqютера, без запису цих змін до адресної книги\&. .RE .RE .SH "ДІАГНОСТИКА" .PP Зазвичай, нульовий стан виходу означає успіх\&. Залежно від обраного режиму дій, ненульовий стан виходу означає певні негаразди з програмою\&. .PP \fIADD\fR .RS 4 .PP 1 .RS 4 Спроба читання вхідного тексту була невдалою .RE .PP 2 .RS 4 Спроба створення відповідного запису контакту на основі вхідного тексту була невдалою, причиною може бути відсутність даних або помилковий формат даних для обраного вхідного формату\&. .RE .PP 3 .RS 4 Спроба збереження адресної книги була невдалою\&. Причиною цього може бути те, що інші програми блокують доступ до адресної книги\&. .RE .RE .PP \fIREMOVE\fR .RS 4 .PP 1 .RS 4 Спроба читання вхідного тексту була невдалою .RE .PP 2 .RS 4 Програмі не вдалося вилучити жодного запису з адресної книги\&. Причиною цього може бути невдала спроба обробки вхідних даних, неможливість знаходження відповідного запису контакту у адресній книзі або знаходження декількох записів контактів у адресній книзі\&. У останньому випадку повідомлення про помилку буде записано до stderr\&. .RE .PP 3 .RS 4 Спроба збереження адресної книги була невдалою\&. Причиною цього може бути те, що інші програми блокують доступ до адресної книги\&. .RE .RE .PP \fIMERGE\fR .RS 4 .PP 1 .RS 4 Спроба читання вхідного тексту була невдалою .RE .PP 2 .RS 4 Програмі не вдалося об\(cqєднати вхідні дані з записом з адресної книги\&. Причиною цього може бути невдала спроба обробки вхідних даних, неможливість знаходження відповідного запису контакту у адресній книзі або знаходження декількох записів контактів у адресній книзі\&. У останньому випадку повідомлення про помилку буде записано до stderr\&. .RE .PP 3 .RS 4 Спроба збереження адресної книги була невдалою\&. Причиною цього може бути те, що інші програми блокують доступ до адресної книги\&. .RE .PP \fISEARCH\fR, 1 .RS 4 Спроба читання вхідного тексту була невдалою .RE .PP 2 .RS 4 Програмі не вдалося знайти відповідний запис контакту у адресній книзі\&. Причиною цього може бути невдала спроба обробки вхідного тексту або невдала спроба пошуку запису контакту у адресній книзі\&. .RE .RE .SH "ПРИКЛАДИ" .PP \fIЗнайти записи контактів з рядком \(FoJoe\(Fc у імені або адресі електронної пошти\fR .sp .if n \{\ .RS 4 .\} .nf kabcclient \-S Joe .fi .if n \{\ .RE .\} .PP \fIВиконати ті самі дії але з врахуванням регістру\&.\fR .sp .if n \{\ .RS 4 .\} .nf kabcclient \-\-match\-case \-S Joe .fi .if n \{\ .RE .\} .PP \fIВиконати ті самі дії, але прочитати вхідний текст з stdin\&.\fR .sp .if n \{\ .RS 4 .\} .nf echo "Joe" | kabcclient \-\-match\-case \-S .fi .if n \{\ .RE .\} .PP \fIСпробувати додати новий запис контакту на основі даних з форматованої адреси електронної пошти\&.\fR .sp .if n \{\ .RS 4 .\} .nf kabcclient \-\-nosave \-\-add \-if email "Marilyn Monroe " .fi .if n \{\ .RE .\} .PP \fIВиконати ті самі дії, але цього разу насправді зберегти зміни до адресної книги\&.\fR .sp .if n \{\ .RS 4 .\} .nf kabcclient \-\-add \-if email "Marilyn Monroe " .fi .if n \{\ .RE .\} .PP \fIВивести список доступних форматів вхідних даних\&.\fR .sp .if n \{\ .RS 4 .\} .nf kabcclient \-if help .fi .if n \{\ .RE .\} .PP \fIВивести список всіх доступних форматів вихідної інформації\&.\fR .sp .if n \{\ .RS 4 .\} .nf kabcclient \-of help .fi .if n \{\ .RE .\} .PP \fIВивести список всіх доступних параметрів для вихідного формату \(Foemail\(Fc\fR .sp .if n \{\ .RS 4 .\} .nf kabcclient \-of email \-of\-opts help .fi .if n \{\ .RE .\} .PP \fIПоказати список всіх адрес електронної пошти всіх контактів, відомості яких містять слово \(FoMarilyn\(Fc\fR .sp .if n \{\ .RS 4 .\} .nf kabcclient \-of email \-of\-opts allemails \-S Marilyn .fi .if n \{\ .RE .\} .PP \fIВилучити всі контакти, які користувач обрав у діалозі вибору контактів\&.\fR .sp .if n \{\ .RS 4 .\} .nf kabcclient \-\-remove \-if dialog .fi .if n \{\ .RE .\} .PP \fIЕкспортувати вибрані контакти до файла vCard (типовий формат вихідної інформації)\fR .sp .if n \{\ .RS 4 .\} .nf kabcclient \-S \-if dialog > contacts\&.vcf .fi .if n \{\ .RE .\} .SH "АВТОР" .PP Автором цієї сторінки довідки є Kevin Krammer \&. Ви можете копіювати, розповсюджувати і/або змінювати цей документ за умов дотримання GNU General Public License, версії 2 або будь\-якої пізнішої версії, оприлюдненої Free Software Foundation\&. .PP У системах Debian повний текст GNU General Public License можна знайти у файлі /usr/share/common\-licenses/GPL\&. .SH "АВТОР" .PP \fBKevin Krammer\fR <\&kevin\&.krammer@gmx\&.at\&> .RS 4 Автор .RE