git-send-email - Dalam talian di Awan

JADUAL:

NAMA

git-send-email - Hantar koleksi patch sebagai e-mel

SINOPSIS

pergi menghantar e-mel [pilihan] ...
pergi menghantar e-mel --buang-alias

DESCRIPTION

Mengambil patch yang diberikan pada baris arahan dan menghantarnya e-mel. Patch boleh ditentukan
sebagai fail, direktori (yang akan menghantar semua fail dalam direktori), atau terus sebagai a
senarai semakan. Dalam kes terakhir, sebarang format yang diterima oleh git-format-patch(1) boleh lulus
ke git hantar-e-mel.

Pengepala e-mel boleh dikonfigurasikan melalui pilihan baris arahan. Jika tidak dinyatakan pada
baris arahan, pengguna akan digesa dengan antara muka yang didayakan ReadLine untuk menyediakan
maklumat yang diperlukan.

Terdapat dua format yang diterima untuk fail tampalan:

1. fail format mbox

Apakah ini git-format-patch(1) menjana. Kebanyakan pengepala dan pemformatan MIME adalah
diabaikan.

2. Format asal yang digunakan oleh Greg Kroah-Hartman send_lots_of_email.pl skrip

Format ini menjangkakan baris pertama fail mengandungi nilai "Sk:" dan
"Subjek:" mesej sebagai baris kedua.

PILIHAN

Mengarang
--anotasi
Semak dan edit setiap tampung yang akan anda hantar. Lalai ialah nilai
sendemail.anotasi. Lihat bahagian KONFIGURASI untuk sendemail.multiEdit.

--bcc= ,...
Tentukan nilai "Skt:" untuk setiap e-mel. Lalai ialah nilai sendemail.bcc.

Pilihan ini mungkin ditetapkan beberapa kali.

--cc= ,...
Tentukan nilai "Sk:" permulaan untuk setiap e-mel. Lalai ialah nilai sendemail.cc.

Pilihan ini mungkin ditetapkan beberapa kali.

--karang
Panggil editor teks (lihat GIT_EDITOR dalam git-var(1)) untuk mengedit mesej pengenalan
untuk siri tampalan.

Bila --karang digunakan, git send-email akan menggunakan From, Subject, dan In-Reply-To
pengepala yang dinyatakan dalam mesej. Jika kandungan mesej (apa yang anda taip selepas
pengepala dan baris kosong) hanya mengandungi baris kosong (atau Git: awalan), ringkasan
tidak akan dihantar, tetapi pengepala Daripada, Subjek dan Balas-Kepada akan digunakan melainkan ia
dikeluarkan.

Pengepala Daripada atau Dalam Balas Kepada yang tiada akan digesa.

Lihat bahagian KONFIGURASI untuk sendemail.multiEdit.

--dari=
Tentukan penghantar e-mel. Jika tidak dinyatakan pada baris arahan, nilai bagi
yang sendemail.daripada pilihan konfigurasi digunakan. Jika tiada pilihan baris arahan
tidak sendemail.daripada ditetapkan, maka pengguna akan diminta untuk nilai. lalai
untuk gesaan ialah nilai GIT_AUTHOR_IDENT, atau GIT_COMMITTER_IDENT jika itu
tidak ditetapkan, seperti yang dikembalikan oleh "git var -l".

--dalam-balas-kepada=
Jadikan mel pertama (atau semua mel dengan --no-thread) muncul sebagai balasan kepada yang diberikan
Message-Id, yang mengelakkan benang putus untuk menyediakan siri tampung baharu. Yang kedua
dan e-mel seterusnya akan dihantar sebagai balasan mengikut --[no]-chain-reply-to
penetapan.

Jadi sebagai contoh apabila --thread dan --no-chain-reply-to ditentukan, yang kedua dan
tampung berikutnya akan menjadi balasan kepada yang pertama seperti dalam ilustrasi di bawah
di mana [PATCH v2 0/3] adalah sebagai balasan kepada [PATCH 0/2]:

[PATCH 0/2] Inilah yang saya lakukan...
[PATCH 1/2] Bersihkan dan uji
[PATCH 2/2] Pelaksanaan
[PATCH v2 0/3] Berikut ialah gulungan semula
[PATCH v2 1/3] Bersihkan
[PATCH v2 2/3] Ujian baharu
[PATCH v2 3/3] Pelaksanaan

Hanya perlu jika --compose juga ditetapkan. Jika --compose tidak ditetapkan, ini akan menjadi
digesa untuk.

--subjek=
Tentukan subjek awal urutan e-mel. Hanya perlu jika --compose juga
ditetapkan. Jika --compose tidak ditetapkan, ini akan digesa untuk.

--kepada= ,...
Tentukan penerima utama e-mel yang dijana. Secara amnya, ini akan menjadi
penyelenggara huluan projek terbabit. Lalai ialah nilai bagi sendemail.to
nilai konfigurasi; jika itu tidak ditentukan, dan --ke-cmd tidak ditentukan, ini akan
digesa untuk.

Pilihan ini mungkin ditetapkan beberapa kali.

--8bit-encoding=
Apabila menemui mesej atau subjek bukan ASCII yang tidak mengisytiharkan pengekodannya,
tambah pengepala/petik untuk menunjukkan ia dikodkan . Lalai ialah nilai
yang sendemail.assume8bitEncoding; jika itu tidak ditentukan, ini akan digesa untuk if
sebarang fail bukan ASCII ditemui.

Ambil perhatian bahawa tiada sebarang percubaan dibuat untuk mengesahkan pengekodan.

--compose-encoding=
Tentukan pengekodan mesej karang. Lalai ialah nilai bagi
sendemail.composeencoding; jika itu tidak dinyatakan, UTF-8 diandaikan.

--transfer-encoding=(7bit|8bit|quoted-printable|base64)
Tentukan pengekodan pemindahan yang akan digunakan untuk menghantar mesej melalui SMTP. 7bit akan gagal
apabila menemui mesej bukan ASCII. quoted-printable boleh berguna apabila
repositori mengandungi fail yang mengandungi pulangan pengangkutan, tetapi membuat e-mel tampung mentah
fail (seperti yang disimpan daripada MUA) lebih sukar untuk diperiksa secara manual. base64 adalah lebih bodoh
bukti, tetapi juga lebih legap. Lalai ialah nilai bagi
sendemail.transferEncoding nilai konfigurasi; jika itu tidak ditentukan, git akan menggunakan
8bit dan tidak menambah pengepala Content-Transfer-Encoding.

--xmailer, --no-xmailer
Tambah (atau elakkan menambah) pengepala "X-Mailer:". Secara lalai, pengepala ditambah, tetapi
ia boleh dimatikan dengan menetapkan pembolehubah konfigurasi sendemail.xmailer kepada palsu.

Menghantar
--pengirim-sampul surat=
Nyatakan penghantar sampul surat yang digunakan untuk menghantar e-mel. Ini berguna jika lalai anda
alamat bukan alamat yang melanggan senarai. Untuk menggunakan daripada
alamat, tetapkan nilai kepada "auto". Jika anda menggunakan binari sendmail, anda mesti mempunyai
keistimewaan yang sesuai untuk parameter -f. Lalai ialah nilai bagi
sendemail.envelopeSender pembolehubah konfigurasi; jika itu tidak dinyatakan, pilih
penghantar sampul diserahkan kepada MTA anda.

--smtp-encryption=
Tentukan penyulitan untuk digunakan, sama ada ssl or tls. Sebarang nilai lain kembali kepada biasa
SMTP. Lalai ialah nilai sendemail.smtpEncryption.

--smtp-domain=
Menentukan Nama Domain Berkelayakan Penuh (FQDN) yang digunakan dalam arahan HELO/EHLO kepada
pelayan SMTP. Sesetengah pelayan memerlukan FQDN untuk memadankan alamat IP anda. Jika tidak ditetapkan, git
percubaan hantar-e-mel untuk menentukan FQDN anda secara automatik. Lalai ialah nilai
sendemail.smtpDomain.

--smtp-auth=
Senarai dipisahkan ruang putih bagi mekanisme SMTP-AUTH yang dibenarkan. Tetapan ini memaksa menggunakan
hanya mekanisme yang disenaraikan. Contoh:

$ git send-email --smtp-auth="PLAIN LOGIN GSSAPI" ...

Jika sekurang-kurangnya satu daripada mekanisme yang ditentukan sepadan dengan yang diiklankan oleh SMTP
pelayan dan jika ia disokong oleh perpustakaan SASL yang digunakan, mekanisme itu digunakan untuk
pengesahan. Jika tiada sendemail.smtpAuth tidak --smtp-auth dinyatakan, semua
mekanisme yang disokong oleh perpustakaan SASL boleh digunakan.

--smtp-lulus[= ]
Kata laluan untuk SMTP-AUTH. Hujah adalah pilihan: Jika tiada hujah dinyatakan, maka
rentetan kosong digunakan sebagai kata laluan. Lalai ialah nilai sendemail.smtpPass,
Walau bagaimanapun --smtp-lulus sentiasa mengatasi nilai ini.

Tambahan pula, kata laluan tidak perlu dinyatakan dalam fail konfigurasi atau pada arahan
barisan. Jika nama pengguna telah ditentukan (dengan --smtp-pengguna atau sendemail.smtpUser), tetapi
tiada kata laluan telah ditentukan (dengan --smtp-lulus or sendemail.smtpPass), kemudian a
kata laluan diperoleh menggunakan git-credential.

--smtp-server=
Jika ditetapkan, tentukan pelayan SMTP keluar untuk digunakan (cth smtp.example.com atau IP mentah
alamat). Sebagai alternatif, ia boleh menentukan nama laluan penuh program seperti sendmail
sebaliknya; program mesti menyokong pilihan -i. Nilai lalai boleh ditentukan oleh
sendemail.smtpServer pilihan konfigurasi; lalai terbina dalam ialah /usr/sbin/sendmail
or /usr/lib/sendmail jika program sedemikian tersedia, atau localhost sebaliknya.

--smtp-server-port=
Menentukan port yang berbeza daripada port lalai (pelayan SMTP biasanya mendengar
port smtp 25, tetapi mungkin juga mendengar port penyerahan 587, atau port smtp SSL biasa
465); nama port simbolik (cth "penyerahan" dan bukannya 587) juga diterima. The
port juga boleh ditetapkan dengan sendemail.smtpServerPort pembolehubah konfigurasi.

--smtp-server-option=
Jika ditetapkan, tentukan pilihan pelayan SMTP keluar untuk digunakan. Nilai lalai boleh
ditentukan oleh sendemail.smtpServerOption pilihan konfigurasi.

Pilihan --smtp-server-option mesti diulang untuk setiap pilihan yang anda ingin lalui
pelayan. Begitu juga, baris yang berbeza dalam fail konfigurasi mesti digunakan untuk setiap satu
pilihan.

--smtp-ssl
Alias ​​warisan untuk --smtp-encryption ssl.

--smtp-ssl-cert-path
Laluan ke kedai sijil CA yang dipercayai untuk pengesahan sijil SSL/TLS SMTP
(sama ada direktori yang telah diproses oleh c_rehash, atau satu fail yang mengandungi
satu atau lebih sijil format PEM digabungkan bersama: lihat mengesahkan(1) -CAfail dan
-CApath untuk mendapatkan maklumat lanjut tentang ini). Tetapkannya kepada rentetan kosong untuk melumpuhkan
pengesahan sijil. Lalai kepada nilai sendemail.smtpsslcertpath
pembolehubah konfigurasi, jika ditetapkan, atau lalai terkumpul perpustakaan SSL sokongan
sebaliknya (yang sepatutnya menjadi pilihan terbaik pada kebanyakan platform).

--smtp-user=
Nama pengguna untuk SMTP-AUTH. Lalai ialah nilai sendemail.smtpUser; jika nama pengguna adalah
tidak dinyatakan (dengan --smtp-pengguna or sendemail.smtpUser), maka pengesahan tidak
cuba.

--smtp-debug=0|1
Dayakan (1) atau lumpuhkan (0) output nyahpepijat. Jika didayakan, arahan dan balasan SMTP akan menjadi
dicetak. Berguna untuk menyahpepijat masalah sambungan dan pengesahan TLS.

Mengautomatikkan
--ke-cmd=
Tentukan arahan untuk melaksanakan sekali setiap fail tampalan yang sepatutnya menjana fail tampalan
entri "Kepada:" khusus. Output arahan ini mestilah alamat e-mel tunggal bagi setiap baris.
Lalai ialah nilai sendemail.tocmd nilai konfigurasi.

--cc-cmd=
Tentukan arahan untuk melaksanakan sekali setiap fail tampalan yang sepatutnya menjana fail tampalan
entri "Sk:" tertentu. Output arahan ini mestilah alamat e-mel tunggal bagi setiap baris.
Lalai ialah nilai sendemail.ccCmd nilai konfigurasi.

--[no-]rantai-balas-kepada
Jika ini ditetapkan, setiap e-mel akan dihantar sebagai balasan kepada e-mel sebelumnya yang dihantar. Jika
dilumpuhkan dengan "--no-chain-reply-to", semua e-mel selepas yang pertama akan dihantar sebagai
membalas e-mel pertama yang dihantar. Apabila menggunakan ini, adalah disyorkan bahawa yang pertama
fail yang diberikan adalah gambaran keseluruhan siri tampalan. Dilumpuhkan secara lalai, tetapi
sendemail.chainReplyTo pembolehubah konfigurasi boleh digunakan untuk membolehkannya.

--identiti=
Identiti konfigurasi. Apabila diberikan, menyebabkan nilai dalam menghantar e-mel.
subseksyen untuk diutamakan daripada nilai dalam menghantar e-mel bahagian. lalai
identiti adalah nilai sendemail.identity.

--[no-]ditandatangani-oleh-cc
Jika ini ditetapkan, tambahkan e-mel yang terdapat dalam baris Ditandatangani oleh: atau Sk: ke senarai cc.
Lalai ialah nilai sendemail.signedoffbycc nilai konfigurasi; kalau begitu
tidak ditentukan, lalai kepada --ditandatangani-oleh-cc.

--[no-]cc-cover
Jika ini ditetapkan, e-mel ditemui dalam Sk: pengepala dalam tampung pertama siri ini
(biasanya surat lamaran) ditambahkan pada senarai cc untuk setiap set e-mel. Lalai ialah
nilai sendemail.cccover nilai konfigurasi; jika itu tidak ditentukan, lalai kepada
--tiada-cc-cover.

--[no-]untuk-melindungi
Jika ini ditetapkan, e-mel ditemui dalam To: pengepala dalam tampung pertama siri ini
(biasanya surat lamaran) ditambahkan pada senarai untuk setiap set e-mel. Lalai ialah
nilai sendemail.tocover nilai konfigurasi; jika itu tidak ditentukan, lalai kepada
--tiada-untuk-tutup.

--suppress-cc=
Tentukan kategori penerima tambahan untuk menyekat auto-cc:

· pengarang akan mengelak daripada memasukkan pengarang tampalan

· diri akan mengelak daripada memasukkan pengirim

· cc akan mengelak daripada memasukkan sesiapa yang disebut dalam baris Sc dalam pengepala tampalan kecuali
untuk diri sendiri (gunakan diri untuk itu).

· bodycc akan mengelak daripada memasukkan sesiapa sahaja yang disebut dalam baris Cc dalam badan tampalan (commit
mesej) kecuali untuk diri sendiri (menggunakan diri untuk itu).

· teruk akan mengelak daripada menyertakan sesiapa sahaja yang disebut dalam baris Ditandatangani oleh kecuali diri sendiri
(gunakan diri untuk itu).

· cccmd akan mengelakkan menjalankan --cc-cmd.

· badan adalah bersamaan dengan teruk + bodycc

· semua akan menyekat semua nilai cc automatik.

Lalai ialah nilai sendemail.suppresscc nilai konfigurasi; kalau begitu
tidak ditentukan, lalai kepada diri jika --suppress-from ditentukan, serta badan if
--no-signed-off-cc ditentukan.

--[no-]tekan-daripada
Jika ini ditetapkan, jangan tambahkan alamat Daripada: pada senarai cc:. Lalai ialah nilai
sendemail.suppressFrom nilai konfigurasi; jika itu tidak ditentukan, lalai kepada
--tidak-menekan-daripada.

--[tiada-]benang
Jika ini ditetapkan, pengepala In-Reply-To dan Rujukan akan ditambahkan pada setiap e-mel
dihantar. Sama ada setiap mel merujuk kepada e-mel sebelumnya (benang dalam setiap pergi
tampalan format perkataan) atau kepada e-mel pertama (benang cetek) dikawal oleh
"--[no-]rantai-balas-kepada".

Jika dilumpuhkan dengan "--no-thread", pengepala tersebut tidak akan ditambahkan (melainkan dinyatakan dengan
--dalam-balas-kepada). Lalai ialah nilai bagi sendemail.thread nilai konfigurasi; jika
yang tidak ditentukan, lalai kepada --thread.

Terpulang kepada pengguna untuk memastikan tiada pengepala In-Reply-To sudah wujud apabila pergi
menghantar e-mel diminta untuk menambahnya (terutamanya ambil perhatian bahawa pergi tampalan format boleh dikonfigurasikan
untuk melakukan threading itu sendiri). Kegagalan berbuat demikian mungkin tidak menghasilkan hasil yang diharapkan dalam
MUA penerima.

Mengurus
--confirm=
Sahkan sejurus sebelum menghantar:

· sentiasa akan sentiasa mengesahkan sebelum menghantar

· pernah tidak akan mengesahkan sebelum menghantar

· cc akan mengesahkan sebelum menghantar apabila e-mel hantar telah menambah alamat secara automatik
daripada tampalan kepada senarai Sc

· mengarang akan mengesahkan sebelum menghantar mesej pertama apabila menggunakan --compose.

· auto adalah bersamaan dengan cc + mengarang

Lalai ialah nilai sendemail.confirm nilai konfigurasi; jika itu tidak dinyatakan,
lalai kepada auto melainkan jika mana-mana pilihan penindasan telah ditentukan, dalam hal ini
lalai kepada mengarang.

--lari kering
Lakukan segala-galanya kecuali menghantar e-mel.

--[no-]format-tampalan
Apabila hujah boleh difahami sama ada sebagai rujukan atau sebagai nama fail, pilih untuk
memahaminya sebagai argumen tampalan format (--format-tampalan) atau sebagai nama fail
(--tiada-format-tampalan). Secara lalai, apabila konflik sedemikian berlaku, git send-email akan
gagal.

--senyap
Jadikan git-send-email kurang bertele-tele. Satu baris setiap e-mel sepatutnya menjadi semua yang dikeluarkan.

--[no-]sahkan
Lakukan pemeriksaan kewarasan pada tampalan. Pada masa ini, pengesahan bermaksud perkara berikut:

· Amaran tentang tompok yang mengandungi garisan lebih panjang daripada 998 aksara; ini disebabkan oleh SMTP
had seperti yang diterangkan oleh http://www.ietf.org/rfc/rfc2821.txt.

Lalai ialah nilai sendemail.validate; jika ini tidak ditetapkan, lalai kepada --sahkan.

- kekuatan
Hantar e-mel walaupun semakan keselamatan akan menghalangnya.

Maklumat
--buang-alias
Daripada operasi biasa, buang nama alias singkatan daripada yang dikonfigurasikan
fail alias, satu setiap baris dalam susunan abjad. Perhatikan, ini hanya termasuk alias
nama dan bukan alamat e-melnya yang dikembangkan. Lihat sendemail.aliasesfile selama lebih
maklumat tentang alias.

CONFIGURATION

sendemail.aliasesFile
Untuk mengelak daripada menaip alamat e-mel yang panjang, arahkan ini ke satu atau lebih fail alias e-mel.
Anda juga mesti membekalkan sendemail.aliasFileType.

sendemail.aliasFileType
Format fail yang dinyatakan dalam sendemail.aliasesFile. Mesti salah satu kambing, mailrc,
pain, elm, Atau seladang, Atau hantar surat.

Rupa fail alias dalam setiap format boleh didapati dalam dokumentasi fail
program e-mel dengan nama yang sama. Perbezaan dan batasan daripada piawaian
format diterangkan di bawah:

hantar surat

· Alias ​​yang dipetik dan alamat yang dipetik tidak disokong: baris yang mengandungi "
simbol diabaikan.

· Ubah hala ke fail (/path/name) atau paip (|command) tidak disokong.

· Kemasukan fail (:include: /path/name) tidak disokong.

· Amaran dicetak pada output ralat standard untuk sebarang secara eksplisit
binaan tidak disokong, dan mana-mana baris lain yang tidak dikenali oleh
penghurai.

sendemail.multiEdit
Jika benar (lalai), satu contoh editor akan dihasilkan untuk mengedit fail yang anda perlu lakukan
edit (tampal bila --anotasi digunakan, dan ringkasan bila --karang digunakan). Jika
palsu, fail akan diedit satu demi satu, menghasilkan editor baharu setiap kali.

sendemail.confirm
Tetapkan lalai untuk sama ada mengesahkan sebelum menghantar. Mesti salah satu sentiasa, pernah,
cc, mengarang, Atau auto. Lihat --confirm dalam bahagian sebelumnya untuk maksud ini
nilai-nilai.

CONTOH

Penggunaan gmail as yang smtp server
Untuk menggunakan pergi menghantar e-mel untuk menghantar patch anda melalui pelayan SMTP GMail, edit
~ / .gitconfig untuk menentukan tetapan akaun anda:

[menghantar e-mel]
smtpEncryption = tls
smtpServer = smtp.gmail.com
smtpUser = [e-mel dilindungi]
smtpServerPort = 587

Setelah komitmen anda sedia untuk dihantar ke senarai mel, jalankan arahan berikut:

$ git format-patch --cover-letter -M origin/master -o outgoing/
$ edit keluar/0000-*
$ git hantar-e-mel keluar/*

Nota: modul perl berikut diperlukan Net::SMTP::SSL, MIME::Base64 dan
Authen::SASL

Gunakan git-send-email dalam talian menggunakan perkhidmatan onworks.net