git-send-email - онлайн у хмарі

ПРОГРАМА:

ІМ'Я

git-send-email - Надіслати колекцію патчів як електронні листи

СИНТАКСИС

мерзотник відправити лист [параметри] ...
мерзотник відправити лист -- dump-псевдоніми

ОПИС

Бере патчі, надані в командному рядку, і надсилає їх електронною поштою. Патчі можна вказати
як файли, каталоги (які надсилатимуть усі файли в каталозі) або безпосередньо як a
список ревізій. В останньому випадку будь-який формат, прийнятий за git-format-patch(1) можна пройти
щоб git надіслати електронну пошту.

Заголовок електронного листа можна налаштувати за допомогою параметрів командного рядка. Якщо не зазначено на
командного рядка, користувачу буде запропоновано інтерфейс із підтримкою ReadLine для надання
необхідну інформацію.

Для файлів патчів прийнято два формати:

1. файли формату mbox

Це те, що git-format-patch(1) породжує. Більшість заголовків і форматування MIME є
ігнорується.

2. Оригінальний формат, використаний Greg Kroah-Hartman's send_lots_of_email.pl сценарій

У цьому форматі очікується, що перший рядок файлу міститиме значення «Копія:» і значення
«Тема:» повідомлення як другий рядок.

ВАРІАНТИ

Композиція
-- анотувати
Перегляньте та відредагуйте кожен патч, який збираєтеся надіслати. За замовчуванням є значення
sendemail.аннотувати. Перегляньте розділ КОНФІГУРАЦІЯ sendemail.multiEdit.

--bcc= ,...
Вкажіть значення «Прихована копія:» для кожного електронного листа. За замовчуванням є значення sendemail.bcc.

Цей параметр можна вказати кілька разів.

--cc= ,...
Вкажіть початкове значення "Копія:" для кожного електронного листа. За замовчуванням є значення sendemail.cc.

Цей параметр можна вказати кілька разів.

-- скласти
Викличте текстовий редактор (див. GIT_EDITOR в git-вар(1)), щоб відредагувати вступне повідомлення
для серії патчів.

Коли -- скласти використовується, git send-email використовуватиме параметри From, Subject і In-Reply-To
заголовки, зазначені в повідомленні. Якщо тіло повідомлення (те, що ви вводите після
заголовки та порожній рядок) містить лише порожні (або Git: з префіксом) рядки, підсумок
не буде надіслано, але використовуватимуться заголовки From, Subject і In-Reply-To, якщо вони не
вилучено

Буде запропоновано ввести заголовки "Від" або "У відповідь".

Перегляньте розділ КОНФІГУРАЦІЯ sendemail.multiEdit.

--з=
Вкажіть відправника електронних листів. Якщо не вказано в командному рядку, значення
sendemail.from використовується параметр конфігурації. Якщо жодного параметра командного рядка немає
ні sendemail.from встановлені, то користувачу буде запропоновано ввести значення. За замовчуванням
для підказки буде значення GIT_AUTHOR_IDENT або GIT_COMMITTER_IDENT, якщо це
не встановлено, як повертається "git var -l".

--in-reply-to=
Зробіть так, щоб перше повідомлення (або всі листи з --no-thread) відображалися як відповідь на дане повідомлення
Ідентифікатор повідомлення, який дозволяє уникнути розриву потоків, щоб створити нову серію виправлень. Секунда
а наступні електронні листи надсилатимуться як відповіді відповідно до --[no]-chain-reply-to
установка.

Так, наприклад, коли вказано --thread і --no-chain-reply-to, другий і
наступні патчі будуть відповідями на перший, як на ілюстрації нижче
де [PATCH v2 0/3] відповідає на [PATCH 0/2]:

[ПАТЧ 0/2] Ось що я зробив...
[ПАТЧ 1/2] Очищення та тестування
[ПАТЧ 2/2] Реалізація
[PATCH v2 0/3] Ось перерол
[PATCH v2 1/3] Очищення
[PATCH v2 2/3] Нові тести
[PATCH v2 3/3] Реалізація

Необхідно, лише якщо також встановлено --compose. Якщо --compose не встановлено, це буде
запропонували.

--предмет=
Вкажіть початкову тему повідомлення електронної пошти. Необхідно, лише якщо --compose також є
набір. Якщо --compose не встановлено, буде запропоновано ввести це.

--to= ,...
Вкажіть основного одержувача створених електронних листів. Загалом, це буде
вищестоящий супроводжувач проекту. За замовчуванням є значення sendemail.to
значення конфігурації; якщо це не вказано, а --to-cmd не вказано, це буде
бути запрошено.

Цей параметр можна вказати кілька разів.

--8-бітове кодування=
Коли ви зустрічаєте повідомлення або тему, що не містить кодування ASCII, що не оголошує своє кодування,
додати заголовки/цитати, щоб вказати, що він закодований . За замовчуванням є значення
sendemail.assume8bitEncoding; якщо це не вказано, буде запропоновано якщо
зустрічаються будь-які файли, відмінні від ASCII.

Зауважте, що жодних спроб перевірити кодування не робиться.

--compose-encoding=
Вкажіть кодування для створення повідомлення. За замовчуванням є значення
sendemail.composeencoding; якщо це не вказано, передбачається UTF-8.

--transfer-encoding=(7bit|8bit|quoted-printable|base64)
Вкажіть кодування передачі, яке буде використовуватися для надсилання повідомлення через SMTP. 7-бітний не вийде
зіткнувшись з повідомленням, що не містить ASCII. quoted-printable може бути корисним, коли
репозиторій містить файли, які містять повернення каретки, але створює електронний лист із необробленим патчем
файл (збережений з MUA) набагато важче перевірити вручну. base64 ще більш дурний
доказом, але й ще більш непрозорим. За замовчуванням є значення
sendemail.transferEncoding значення конфігурації; якщо це не вказано, git використовуватиме
8 біт і не додавати заголовок Content-Transfer-Encoding.

--xmailer, --no-xmailer
Додайте (або забороніть додавання) заголовок "X-Mailer:". За замовчуванням додається заголовок, але
його можна вимкнути, встановивши для змінної конфігурації sendemail.xmailer значення false.

Посилає
--конверт-відправник=
Вкажіть відправника конверта, який використовується для надсилання електронних листів. Це корисно, якщо за замовчуванням
адреса не є адресою, яка підписана на список. Для того, щоб використовувати Від
адресу, встановіть значення "авто". Якщо ви використовуєте двійковий файл sendmail, ви повинні мати
відповідні привілеї для параметра -f. За замовчуванням є значення
sendemail.envelopeSender змінна конфігурації; якщо це не вказано, виберіть
відправник конверта залишається за вашим MTA.

--smtp-encryption=
Також вкажіть шифрування для використання SSL or тлс. Будь-яке інше значення повертається до звичайного
SMTP. За замовчуванням є значення sendemail.smtpEncryption.

--smtp-domain=
Вказує повне доменне ім’я (FQDN), яке використовується в команді HELO/EHLO для
SMTP-сервер. Деякі сервери вимагають, щоб FQDN відповідав вашій IP-адресі. Якщо не встановлено, git
send-email намагається автоматично визначити ваше FQDN. За замовчуванням є значення
sendemail.smtpDomain.

--smtp-auth=
Розділений пробілами список дозволених механізмів SMTP-AUTH. Цей параметр змушує використовувати
тільки перераховані механізми. приклад:

$ git send-email --smtp-auth="ПРОВИЙ ВХОД GSSAPI" ...

Якщо принаймні один із зазначених механізмів відповідає тим, які рекламуються SMTP
сервер і якщо він підтримується використаною бібліотекою SASL, використовується механізм для
аутентифікація. Якщо ні sendemail.smtpAuth ні --smtp-auth вказано, все
можна використовувати механізми, що підтримуються бібліотекою SASL.

--smtp-pass[= ]
Пароль для SMTP-AUTH. Аргумент необов’язковий: якщо аргумент не вказано, то
порожній рядок використовується як пароль. За замовчуванням є значення sendemail.smtpPass,
проте --smtp-pass завжди перевизначає це значення.

Крім того, паролі не потрібно вказувати у файлах конфігурації або в команді
лінія. Якщо вказано ім’я користувача (з --smtp-користувач або sendemail.smtpUser), але
не вказано пароль (з --smtp-pass or sendemail.smtpPass), потім а
пароль отримується за допомогою облікові дані git.

--smtp-server=
Якщо встановлено, визначає вихідний SMTP-сервер для використання (наприклад, smtp.example.com або необроблену IP-адресу
адреса). Крім того, він може вказати повний шлях до програми, подібної до sendmail
замість цього; програма повинна підтримувати параметр -i. Значення за замовчуванням можна вказати за допомогою
sendemail.smtpServer варіант конфігурації; вбудований за замовчуванням є /usr/sbin/sendmail
or /usr/lib/sendmail якщо така програма доступна, або localhost інакше.

--smtp-server-port=
Вказує порт, який відрізняється від порту за замовчуванням (сервери SMTP зазвичай слухають
smtp порт 25, але може також слухати порт подання 587 або загальний порт smtp SSL
465); символічні назви портів (наприклад, "submission" замість 587) також приймаються. The
порт також можна встановити за допомогою sendemail.smtpServerPort змінна конфігурації.

--smtp-server-option=
Якщо встановлено, вказує параметр сервера вихідного SMTP для використання. Значення за замовчуванням може бути
визначені sendemail.smtpServerOption варіант налаштування.

Опцію --smtp-server-option необхідно повторити для кожного параметра, до якого ви хочете перейти
сервер. Аналогічно, для кожного потрібно використовувати різні рядки у файлах конфігурації
варіант.

--smtp-ssl
Застарілий псевдонім для --smtp-шифрування SSL.

--smtp-ssl-cert-path
Шлях до сховища довірених сертифікатів ЦС для перевірки сертифікатів SMTP SSL/TLS
(або каталог, який оброблено c_rehash, або один файл, що містить
один або кілька сертифікатів формату PEM, об’єднаних разом: див перевірити(1) -CAfile і
-CApath для отримання додаткової інформації про них). Встановіть порожній рядок, щоб вимкнути
перевірка сертифіката. За замовчуванням встановлено значення sendemail.smtpsslcertpath
змінна конфігурації, якщо вона встановлена, або скомпільована за замовчуванням базова бібліотека SSL
в іншому випадку (що має бути найкращим вибором на більшості платформ).

--smtp-user=
Ім’я користувача для SMTP-AUTH. За замовчуванням є значення sendemail.smtpUser; якщо ім’я користувача є
не вказано (з --smtp-користувач or sendemail.smtpUser), то аутентифікації немає
намагалися.

--smtp-debug=0|1
Увімкнути (1) або вимкнути (0) вихід налагодження. Якщо ввімкнено, команди та відповіді SMTP будуть
друкований. Корисно для налагодження проблем підключення TLS та аутентифікації.

Автоматизація
--to-cmd=
Вкажіть команду, яку потрібно виконати один раз для кожного файлу виправлення, який має генерувати файл виправлення
конкретні записи "Кому:". Результатом цієї команди має бути одна адреса електронної пошти на рядок.
За замовчуванням є значення sendemail.tocmd значення конфігурації.

--cc-cmd=
Вкажіть команду, яку потрібно виконати один раз для кожного файлу виправлення, який має генерувати файл виправлення
окремі записи "Копія:". Результатом цієї команди має бути одна адреса електронної пошти на рядок.
За замовчуванням є значення sendemail.ccCmd значення конфігурації.

--[no-]chain-reply-to
Якщо це встановлено, кожен лист надсилатиметься як відповідь на попередній. Якщо
вимкнено з "--no-chain-reply-to", усі листи після першого надсилатимуться як
відповіді на перший надісланий електронний лист. При використанні цього рекомендується першим
надається огляд усієї серії патчів. Вимкнено за замовчуванням, але
sendemail.chainReplyTo змінну конфігурації можна використовувати для її активації.

--ідентичність=
Ідентифікатор конфігурації. Коли задано, викликає значення в відправити лист.
Підрозділ мати пріоритет над значеннями в відправити лист розділ. За замовчуванням
ідентичність є цінністю sendemail.identity.

--[no-]signed-off-by-cc
Якщо це встановлено, додайте електронні листи, знайдені в рядках Signed-off-by: або Cc: до списку копій.
За замовчуванням є значення sendemail.signedoffbycc значення конфігурації; якщо це так
не вказано, за замовчуванням --signed-off-by-cc.

--[no-]cc-cover
Якщо це налаштовано, електронні листи знайдено в заголовках Копія: у першому виправленні серії
(зазвичай супровідний лист) додаються до списку копій для кожного набору електронних листів. За замовчуванням є
Значення sendemail.cccover значення конфігурації; якщо це не вказано, за замовчуванням
--no-cc-cover.

--[ні-]прикривати
Якщо це налаштовано, електронні листи знайдено в заголовках To: у першому виправленні серії
(зазвичай супровідний лист) додаються до списку для кожного набору електронних листів. За замовчуванням є
Значення sendemail.tocover значення конфігурації; якщо це не вказано, за замовчуванням
--не прикривати.

--suppress-cc=
Вкажіть додаткову категорію одержувачів, щоб придушити автоматичне копіювання:

· автор уникатиме включення автора патча

· себе уникатиме включення відправника

· cc уникатиме включення тих, хто згадується в рядках копії в заголовку виправлення, крім
для себе (використовувати себе для того).

· bodycc уникатиме включення тих, хто згадується в рядках копії, до тіла патча (commit
повідомлення), крім власного (використання себе для того).

· ридати уникатиме включення тих, хто згадується в рядках «Підписаний», крім себе
(використання себе для того).

· cccmd уникатиме запуску --cc-cmd.

· тіло еквівалентна ридати + bodycc

· всі пригнічує всі значення автоматичної копії.

За замовчуванням є значення sendemail.suppresscc значення конфігурації; якщо це так
невизначений, за замовчуванням себе якщо вказано --suppress-from, а також тіло if
--no-signed-off-cc вказано.

--[ні-]придушити-від
Якщо це встановлено, не додавайте адресу From: до списку cc:. За замовчуванням є значення
sendemail.suppressFrom значення конфігурації; якщо це не вказано, за замовчуванням
--no-suppress-from.

--[no-]thread
Якщо це встановлено, заголовки In-Reply-To та References будуть додані до кожного електронного листа
надісланий. Чи посилається кожне повідомлення на попередній лист (глибка ланцюжок за мерзотник
формат-патч формулювання) або до першої електронної пошти (мілкі потоки) регулюється
"--[no-]chain-reply-to".

Якщо вимкнено за допомогою «--no-thread», ці заголовки не будуть додані (якщо не вказано в
--у-відповідь). За замовчуванням є значення sendemail.thread значення конфігурації; якщо
що не вказано, за замовчуванням --thread.

Користувач повинен переконатися, що заголовок In-Reply-To вже не існує, коли мерзотник
відправити лист просять додати його (особливо зверніть увагу, що мерзотник формат-патч можна налаштувати
щоб зробити саму нитку). Якщо цього не зробити, це може не дати очікуваного результату
MUA одержувача.

Адміністрування
--підтвердити=
Підтвердьте безпосередньо перед відправкою:

· завжди завжди підтверджуватиме перед відправкою

· ніколи ніколи не підтвердить перед відправкою

· cc підтвердить перед відправкою, коли адреси send-email автоматично додадуть
від патча до списку копій

· скласти підтвердить перед надсиланням першого повідомлення при використанні --compose.

· автоматичний еквівалентна cc + скласти

За замовчуванням є значення sendemail.confirm значення конфігурації; якщо це не вказано,
за замовчуванням до автоматичний якщо в цьому випадку не вказано жодну з опцій придушення
за замовчуванням до скласти.

--сушить
Робіть все, крім фактично надсилання електронних листів.

--[no-]format-patch
Якщо аргумент можна розуміти або як посилання, чи як ім’я файлу, виберіть це
розуміти це як аргумент format-patch (--format-patch) або як ім'я файлу
(--no-format-patch). За замовчуванням, коли виникає такий конфлікт, git send-email буде
збій.

--спокійно
Зробіть git-send-email менш багатослівним. Один рядок на електронну пошту має бути всім, що виводиться.

--[ні-]підтвердити
Виконуйте перевірку працездатності на патчах. Наразі підтвердження означає наступне:

· Попередження про патчі, які містять рядки довше 998 символів; це через SMTP
межі, як описано в http://www.ietf.org/rfc/rfc2821.txt.

За замовчуванням є значення sendemail.validate; якщо це не встановлено, за замовчуванням --підтвердити.

--сила
Надсилайте електронні листи, навіть якщо перевірки безпеки завадять цьому.

Інформація
-- dump-псевдоніми
Замість звичайної роботи викачуйте скорочені імена псевдонімів із налаштованого
файл(и) псевдоніма, по одному на рядок в алфавітному порядку. Зауважте, це включає лише псевдонім
ім'я, а не його розширені адреси електронної пошти. Подивитися sendemail.aliasesfile більше
інформація про псевдоніми.

КОНФІГУРАЦІЯ

sendemail.aliasesFile
Щоб уникнути введення довгих адрес електронної пошти, наведіть це на один або кілька файлів псевдонімів електронної пошти.
Ви також повинні надати sendemail.aliasFileType.

sendemail.aliasFileType
Формат файлів, зазначених у sendemail.aliasesFile. Має бути одним із бовдур, mailrc,
сосновий, в'язабо гнусабо sendmail.

Як виглядає файл псевдоніма в кожному форматі, можна знайти в документації до
однойменна програма електронної пошти. Відмінності та обмеження від стандарту
формати описані нижче:

sendmail

· Псевдоніми в лапках і адреси в лапках не підтримуються: рядки, які містять "
символ ігноруються.

· Перенаправлення до файлу (/шлях/ім'я) або каналу (|команда) не підтримується.

· Включення файлів (:include: /path/name) не підтримується.

· Попередження друкуються на стандартному виводі помилок для будь-яких явних
непідтримувані конструкції та будь-які інші рядки, які не розпізнаються
синтаксичний аналізатор.

sendemail.multiEdit
Якщо значення true (за замовчуванням), буде створено один екземпляр редактора для редагування файлів, які вам потрібно
редагувати (виправляти, коли -- анотувати використовується, а резюме коли -- скласти використовується). Якщо
false, файли будуть редагуватися один за одним, щоразу створюючи новий редактор.

sendemail.confirm
Встановлює за замовчуванням, чи підтверджувати перед надсиланням. Має бути одним із завжди, ніколи,
cc, скластиабо автоматичний, Побачити --підтвердити у попередньому розділі щодо значення цих
значень.

приклад

Скористайтесь Gmail as SMTP сервер
використовувати мерзотник відправити лист щоб надіслати свої патчі через SMTP-сервер GMail, редаг
~ / .gitconfig щоб вказати налаштування облікового запису:

[відправити лист]
smtpEncryption = tls
smtpServer = smtp.gmail.com
smtpUser = [захищено електронною поштою]
smtpServerPort = 587

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

$ git format-patch --cover-letter -M origin/master -o outgoing/
$ редагувати вихідний/0000-*
$ git відправити вихідну пошту/*

Примітка: потрібні такі модулі perl Net::SMTP::SSL, MIME::Base64 та
Authen::SASL

Використовуйте git-send-email онлайн за допомогою служб onworks.net