zshcompsys - Dalam Talian di Awan

JADUAL:

NAMA

zshcompsys - sistem penyiapan zsh

DESCRIPTION

Ini menerangkan kod shell untuk sistem penyiapan `baru', yang dirujuk sebagai compsys. ia
ditulis dalam fungsi shell berdasarkan ciri yang diterangkan dalam zshcompwid(1).

Ciri adalah kontekstual, sensitif kepada titik di mana penyiapan dimulakan. banyak
penyiapan sudah disediakan. Atas sebab ini, pengguna boleh melakukan banyak tugas yang hebat
tanpa mengetahui sebarang butiran selain cara untuk memulakan sistem, yang diterangkan di bawah
dalam INISIALISASI.

Konteks yang menentukan penyiapan yang akan dilakukan mungkin
· argumen atau kedudukan pilihan: ini menerangkan kedudukan pada baris arahan di
penyempurnaan mana yang diminta. Contohnya `hujah pertama kepada rmdir, perkataan
sedang lengkap menamakan direktori';

· konteks khas, menandakan unsur dalam sintaks shell. Contohnya `satu perkataan
dalam kedudukan arahan' atau `subskrip tatasusunan'.

Spesifikasi konteks penuh mengandungi elemen lain, seperti yang akan kami huraikan.

Selain nama arahan dan konteks, sistem menggunakan dua lagi konsep, gaya and
tags. Ini menyediakan cara untuk pengguna mengkonfigurasi gelagat sistem.

Tag memainkan dua peranan. Mereka berfungsi sebagai sistem klasifikasi untuk perlawanan, biasanya
menunjukkan kelas objek yang mungkin perlu dibezakan oleh pengguna. Sebagai contoh, apabila
melengkapkan hujah-hujah ls arahan pengguna mungkin lebih suka mencuba fail sebelum
direktori, jadi kedua-duanya adalah teg. Mereka juga muncul sebagai elemen paling kanan dalam a
spesifikasi konteks.

Gaya mengubah suai pelbagai operasi sistem penyiapan, seperti pemformatan output, tetapi
juga jenis pelengkap yang digunakan (dan dalam susunan apa), atau teg yang diperiksa.
Gaya boleh menerima hujah dan dimanipulasi menggunakan zstyle perintah yang diterangkan dalam lihat
zshmodules(1).

Secara ringkasnya, teg menerangkan apa objek siap adalah, dan gaya bagaimana mereka akan menjadi
selesai. Pada pelbagai titik pelaksanaan, sistem penyiapan menyemak gaya apa
dan/atau teg ditakrifkan untuk konteks semasa dan menggunakannya untuk mengubah suai tingkah lakunya.
Penerangan penuh pengendalian konteks, yang menentukan cara teg dan elemen lain bagi
konteks mempengaruhi tingkah laku gaya, diterangkan di bawah dalam SISTEM PENYELESAIAN
KONFIGURASI.

Apabila penyiapan diminta, fungsi penghantar dipanggil; lihat penerangan tentang
_utama_lengkap dalam senarai fungsi kawalan di bawah. Penghantar ini memutuskan yang mana
fungsi harus dipanggil untuk menghasilkan penyiapan, dan memanggilnya. Keputusan lulus
kepada satu atau lebih pelengkap, fungsi yang melaksanakan strategi penyelesaian individu:
penyelesaian mudah, pembetulan ralat, penyelesaian dengan pembetulan ralat, pemilihan menu,
dan lain-lain.

Secara umumnya, fungsi cangkang yang terkandung dalam sistem penyiapan terdiri daripada dua jenis:
· yang bermula `comp' hendaklah dipanggil terus; terdapat hanya beberapa daripada ini;

· yang bermula `_' dipanggil oleh kod penyiapan. Fungsi shell ini
set, yang melaksanakan tingkah laku penyiapan dan mungkin terikat pada ketukan kekunci, adalah
dirujuk sebagai `widget'. Ini membiak apabila penyiapan baru diperlukan.

INISIISASI

Jika sistem telah dipasang sepenuhnya, ia sepatutnya cukup untuk memanggil fungsi shell
compinit daripada fail permulaan anda; lihat bahagian seterusnya. Walau bagaimanapun, fungsi
compinstall boleh dijalankan oleh pengguna untuk mengkonfigurasi pelbagai aspek sistem penyiapan.

Biasanya, compinstall akan memasukkan kod ke dalam .zshrc, walaupun jika itu tidak boleh ditulis
akan menyimpannya dalam fail lain dan memberitahu anda lokasi fail itu. Ambil perhatian bahawa ia terpulang kepada anda
untuk memastikan bahawa baris ditambahkan ke .zshrc sebenarnya dijalankan; anda mungkin, sebagai contoh, memerlukan
untuk mengalihkannya ke tempat yang lebih awal dalam fail jika .zshrc selalunya balik awal. Selagi
anda menyimpan kesemuanya bersama-sama (termasuk baris ulasan pada permulaan dan penamat), anda boleh
jalankan semula compinstall dan ia akan mencari dan mengubah suai baris ini dengan betul. Perhatikan, bagaimanapun,
bahawa mana-mana kod yang anda tambahkan pada bahagian ini dengan tangan mungkin akan hilang jika anda menjalankan semula
compinstall, walaupun baris menggunakan arahan `zstyle' harus dikendalikan dengan anggun.

Kod baharu akan berkuat kuasa seterusnya anda memulakan shell atau jalankan .zshrc dengan tangan; di sana
juga merupakan pilihan untuk menjadikannya berkuat kuasa serta-merta. Namun, jika compinstall mempunyai
mengalih keluar definisi, anda perlu memulakan semula shell untuk melihat perubahan.

Untuk berlari compinstall anda perlu memastikan ia berada dalam direktori yang dinyatakan dalam anda fpath
parameter, yang sepatutnya berlaku jika zsh telah dikonfigurasikan dengan betul selagi anda
fail permulaan tidak mengalih keluar direktori yang sesuai daripada fpath. Kemudian ia mesti
dimuatkan secara automatik (`autoload -U compinstall' adalah disyorkan). Anda boleh membatalkan pemasangan mana-mana
masa anda digesa untuk mendapatkan maklumat, dan anda .zshrc tidak akan diubah sama sekali;
perubahan hanya berlaku pada penghujungnya, di mana anda diminta secara khusus
pengesahan.

Penggunaan of compinit
Bahagian ini menerangkan penggunaan compinit untuk memulakan penyiapan untuk semasa
sesi apabila dipanggil terus; jika anda telah berlari compinstall ia akan dipanggil secara automatik
daripada anda .zshrc.

Untuk memulakan sistem, fungsi compinit harus berada dalam direktori yang disebut dalam
fpath parameter, dan harus dimuatkan secara automatik (`autoload -U compinit' adalah disyorkan), dan
kemudian jalankan hanya sebagai `compinit'. Ini akan menentukan beberapa fungsi utiliti, mengatur untuk semua
fungsi shell yang diperlukan untuk dimuatkan secara automatik, dan kemudian akan mentakrifkan semula semua widget itu
selesaikan untuk menggunakan sistem baharu. Jika anda menggunakan menu-pilih widget, yang merupakan sebahagian daripada
yang zsh/complist modul, anda harus memastikan bahawa modul itu dimuatkan sebelum panggilan
kepada compinit supaya widget itu juga ditakrifkan semula. Jika gaya penyiapan (lihat di bawah) adalah
disediakan untuk melaksanakan pengembangan serta penyiapan secara lalai, dan kunci TAB terikat kepada
kembangkan-atau-lengkap, compinit akan mengikatnya semula perkataan lengkap; ini adalah perlu untuk menggunakan
bentuk pengembangan yang betul.

Sekiranya anda perlu menggunakan arahan penyelesaian asal, anda masih boleh mengikat kekunci pada
widget lama dengan meletakkan `.' di hadapan nama widget, cth `. kembangkan-atau-lengkapkan'.

Untuk mempercepatkan perjalanan compinit, ia boleh dibuat untuk menghasilkan konfigurasi yang dibuang yang
akan dibaca pada seruan akan datang; ini adalah lalai, tetapi boleh dimatikan oleh
memanggil compinit dengan pilihan -D. Fail yang dibuang ialah .zcompdump dalam direktori yang sama
sebagai fail permulaan (cth $ZDOTDIR or $ HOME); sebagai alternatif, nama fail eksplisit boleh
diberikan oleh `compinit -d dumpfile'. Doa seterusnya compinit akan membaca yang dibuang
fail dan bukannya melakukan pemulaan penuh.

Jika bilangan fail siap berubah, compinit akan mengenali ini dan menghasilkan yang baru
buang fail. Walau bagaimanapun, jika nama fungsi atau argumen dalam baris pertama a
#compdef fungsi (seperti yang diterangkan di bawah) berubah, paling mudah untuk memadamkan fail dump dengan
tangan supaya compinit akan menciptanya semula apabila ia dijalankan seterusnya. Semakan yang dilakukan kepada
lihat jika terdapat fungsi baru boleh ditinggalkan dengan memberikan pilihan -C. Dalam kes ini
fail dump hanya akan dibuat jika belum ada.

Lambakan sebenarnya dilakukan oleh fungsi lain, compdump, tetapi anda hanya perlu berlari
ini sendiri jika anda menukar konfigurasi (cth menggunakan compdef) dan kemudian mahu membuang
yang baru. Nama fail lama yang dibuang akan diingati untuk tujuan ini.

Jika parameter _compdir ditetapkan, compinit menggunakannya sebagai direktori di mana selesai
fungsi boleh didapati; ini hanya perlu jika mereka belum berada dalam fungsi
laluan carian.

Atas sebab keselamatan compinit juga menyemak sama ada sistem penyiapan akan menggunakan fail tidak
dimiliki oleh root atau oleh pengguna semasa, atau fail dalam direktori yang dunia- atau
boleh ditulis kumpulan atau yang tidak dimiliki oleh akar atau oleh pengguna semasa. Jika fail tersebut atau
direktori ditemui, compinit akan bertanya sama ada sistem penyiapan harus benar-benar digunakan.
Untuk mengelakkan ujian ini dan membuat semua fail yang ditemui digunakan tanpa bertanya, gunakan pilihan -u,
dan untuk membuat compinit mengabaikan semua fail dan direktori yang tidak selamat menggunakan pilihan itu -i.
Pemeriksaan keselamatan ini dilangkau sepenuhnya apabila -C pilihan diberi.

Pemeriksaan keselamatan boleh dicuba semula pada bila-bila masa dengan menjalankan fungsi tersebut compaudit. Ini adalah
cek yang sama digunakan oleh compinit, tetapi apabila ia dilaksanakan secara langsung sebarang perubahan kepada fpath adalah
dibuat setempat kepada fungsi supaya ia tidak berterusan. Direktori yang akan disemak mungkin
diluluskan sebagai hujah; jika tiada yang diberi, compaudit menggunakan fpath and _compdir untuk mencari
melengkapkan direktori sistem, menambah yang hilang ke fpath sebagai keperluan. Untuk memaksa a
semak dengan tepat direktori yang dinamakan pada masa ini fpath, tetapkan _compdir kepada rentetan kosong
sebelum memanggil compaudit or compinit.

Majlis tersebut bashcompinit menyediakan keserasian dengan penyiapan boleh atur cara bash
sistem. Apabila dijalankan ia akan menentukan fungsi, compgen and melengkapkan yang sesuai dengan
bash builtins dengan nama yang sama. Ia kemudiannya boleh digunakan untuk melengkapkan
spesifikasi dan fungsi yang ditulis untuk bash.

Autoloaded fail
Konvensyen untuk fungsi autoloaded yang digunakan untuk selesai ialah ia bermula dengan
garis bawah; seperti yang telah disebutkan, the fpath/FPATH parameter mesti mengandungi direktori dalam
yang mereka disimpan. Jika zsh telah dipasang dengan betul pada sistem anda, kemudian fpath/FPATH
secara automatik mengandungi direktori yang diperlukan untuk fungsi standard.

Untuk pemasangan yang tidak lengkap, jika compinit tidak menemui fail yang mencukupi bermula dengan
garis bawah (kurang daripada dua puluh) dalam laluan carian, ia akan cuba mencari lebih banyak dengan menambah
direktori _compdir ke laluan carian. Jika direktori itu mempunyai subdirektori bernama Asas,
semua subdirektori akan ditambahkan pada laluan. Tambahan pula, jika subdirektori Asas Mempunyai-A
subdirektori bernama Teras, compinit akan menambah semua subdirektori subdirektori ke
laluan: ini membolehkan fungsi berada dalam format yang sama seperti dalam zsh sumber
Pengedaran.

Bila compinit dijalankan, ia mencari semua fail sedemikian yang boleh diakses melalui fpath/FPATH dan membaca
baris pertama setiap daripada mereka. Baris ini harus mengandungi salah satu teg yang diterangkan di bawah.
Fail yang baris pertamanya tidak bermula dengan salah satu teg ini tidak dianggap sebagai sebahagian
sistem penyiapan dan tidak akan dilayan secara khusus.

Tag tersebut ialah:

#compdef nama ... [ -{p|P} pola ... [ -N nama ... ] ]
Fail akan dibuat autoloadable dan fungsi yang ditakrifkan di dalamnya akan dipanggil
apabila selesai namas, setiap satunya adalah sama ada nama perintah yang
hujah perlu dilengkapkan atau salah satu daripada beberapa konteks khas dalam bentuk
-konteks- terangkan di bawah.

setiap nama mungkin juga dalam bentuk `cmd=perkhidmatan'. Apabila melengkapkan arahan cmd,
fungsi biasanya berkelakuan seolah-olah arahan (atau konteks khas) perkhidmatan adalah
sedang disiapkan sebaliknya. Ini menyediakan cara untuk mengubah tingkah laku
fungsi yang boleh melakukan banyak penyiapan berbeza. Ia dilaksanakan oleh
menetapkan parameter $perkhidmatan apabila memanggil fungsi; fungsi boleh pilih
untuk mentafsir ini seperti yang dikehendakinya, dan fungsi yang lebih mudah mungkin akan mengabaikannya.

Jika #compdef baris mengandungi salah satu pilihan -p or -P, perkataan berikut ialah
diambil sebagai corak. Fungsi akan dipanggil apabila penyiapan cuba untuk
arahan atau konteks yang sepadan dengan salah satu corak. Pilihan -p and -P adalah
digunakan untuk menentukan corak untuk dicuba sebelum atau selepas penyiapan lain
masing-masing. Oleh itu -P boleh digunakan untuk menentukan tindakan lalai.

pilihan -N digunakan selepas senarai berikut -p or -P; ia menyatakan bahawa baki
perkataan tidak lagi menentukan corak. Ia adalah mungkin untuk bertukar-tukar antara tiga
pilihan seberapa banyak yang perlu.

#compdef -k gaya urutan kunci ...
Pilihan ini mencipta widget yang berkelakuan seperti widget terbina gaya dan mengikatnya
yang diberi urutan kuncis, jika ada. The gaya mestilah salah satu widget terbina yang
melaksanakan penyiapan iaitu perkataan lengkap, delete-char-or-list, kembangkan-atau-lengkap,
awalan kembangkan-atau-lengkapkan, senarai-pilihan, menu-lengkap, menu- kembangkan-atau-lengkap, Atau
terbalik-menu-lengkap. Jika zsh/complist modul dimuatkan (lihat zshmodules(1))
widget menu-pilih juga disediakan.

Apabila salah satu daripada urutan kuncis ditaip, fungsi dalam fail akan digunakan untuk
menjana perlawanan. Ambil perhatian bahawa kunci tidak akan diikat semula jika ia sudah ada (itu
adalah, terikat kepada sesuatu selain daripada kunci yang tidak ditentukan). Widget yang dibuat mempunyai
nama yang sama dengan fail dan boleh diikat pada mana-mana kunci lain menggunakan bindkey seperti biasa.

#compdef -K nama widget gaya urutan kunci [ nama gaya seq ... ]
Ini serupa dengan -k kecuali satu sahaja urutan kunci hujah boleh diberikan untuk
setiap nama widget gaya sepasang. Walau bagaimanapun, keseluruhan set tiga hujah mungkin
diulang dengan set hujah yang berbeza. Perhatikan khususnya bahawa
nama widget mestilah berbeza dalam setiap set. Jika ia tidak bermula dengan `_' kehendak ini
ditambah. The nama widget tidak boleh bertembung dengan nama mana-mana widget sedia ada:
nama berdasarkan nama fungsi adalah paling berguna. Sebagai contoh,

#compdef -K _foo_complete perkataan lengkap "^X^C" \
_foo_list senarai-pilihan "^X^D"

(semua pada satu baris) mentakrifkan widget _foo_complete untuk disiapkan, terikat kepada `^X^C',
dan widget _foo_list untuk penyenaraian, terikat kepada `^X^D'.

#autoload [ pilihan ]
Berfungsi dengan #autoload tag ditandakan untuk autoloading tetapi tidak sebaliknya
diperlakukan secara khusus. Biasanya mereka akan dipanggil dari dalam salah satu daripada
fungsi penyiapan. mana-mana pilihan dibekalkan akan diserahkan kepada autoload terbina;
kegunaan biasa ialah +X untuk memaksa fungsi dimuatkan dengan segera. Perhatikan bahawa
-U and -z bendera sentiasa ditambah secara tersirat.

. # adalah sebahagian daripada nama tag dan tiada ruang putih dibenarkan selepasnya. The #compdef tags
menggunakan compdef fungsi yang diterangkan di bawah; perbezaan utama ialah nama
fungsi dibekalkan secara tersirat.

Konteks khas yang mana fungsi penyiapan boleh ditakrifkan ialah:

-nilai-tatasusunan-
Sebelah kanan tugasan tatasusunan (`nama=(...)')

-parameter pendakap-
Nama pengembangan parameter dalam pendakap (`${...}')

-tugaskan-parameter-
Nama parameter dalam tugasan, iaitu di sebelah kiri `='

-perintah-
Satu perkataan dalam kedudukan arahan

-keadaan-
Perkataan dalam keadaan (`[[...]]')

-lalai-
Mana-mana perkataan yang tiada pelengkapan lain ditakrifkan

-sama-
Perkataan yang bermula dengan tanda sama

-pertama-
Ini dicuba sebelum sebarang fungsi penyiapan lain. Fungsi yang dipanggil mungkin ditetapkan
yang _compskip parameter kepada salah satu daripada pelbagai nilai: semua: tiada penyiapan lagi
cuba; rentetan yang mengandungi subrentetan corak: tiada penyiapan corak
fungsi akan dipanggil; rentetan yang mengandungi lalai: fungsi untuk
`-lalai-' konteks tidak akan dipanggil, tetapi fungsi yang ditakrifkan untuk arahan akan.

-matematik- Di dalam konteks matematik, seperti `((...))'

-parameter-
Nama pengembangan parameter (`$...')

-lencong-
Perkataan selepas pengendali ubah hala.

-subskrip-
Kandungan subskrip parameter.

-tilde-
Selepas tilde awal (`~'), tetapi sebelum garis miring pertama dalam perkataan.

-nilai-
Di sebelah kanan tugasan.

Pelaksanaan lalai dibekalkan untuk setiap konteks ini. Dalam kebanyakan kes
konteks -konteks- dilaksanakan oleh fungsi yang sepadan _konteks, contohnya
konteks `-tilde-' dan fungsi `_tilde').

Konteksnya -lencong- and -nilai- membenarkan maklumat khusus konteks tambahan.
(Secara dalaman, ini dikendalikan oleh fungsi untuk setiap konteks yang memanggil fungsi
_penghantaran.) Maklumat tambahan ditambah dipisahkan dengan koma.

Bagi -lencong- konteks, maklumat tambahan adalah dalam bentuk `-lencong-,op,arahan',
di mana op ialah pengendali ubah hala dan arahan ialah nama arahan pada baris.
Jika tiada arahan pada baris lagi, the arahan medan akan kosong.

Bagi -nilai- konteks, bentuknya ialah `-nilai-,nama,arahan', di mana nama adalah nama
parameter di sebelah kiri tugasan. Dalam kes unsur-unsur an
tatasusunan bersekutu, contohnya `assoc=(key ', nama dikembangkan kepada `nama-utama'. Dalam
konteks khas tertentu, seperti melengkapkan selepas `membuat CFLAGS=', yang arahan bahagian memberi
nama arahan, di sini membuat; jika tidak ia kosong.

Ia tidak perlu untuk menentukan penyiapan khusus sepenuhnya seperti yang akan dilakukan oleh fungsi yang disediakan
cuba hasilkan penyiapan dengan menggantikan elemen secara berperingkat dengan `-lalai-'. Untuk
contoh, apabila melengkapkan selepas `foo=', _nilai akan mencuba nama-nama `-nilai-,foo,' (catatan
yang kosong arahan bahagian), `-nilai-,foo,-lalai-' dan`-nilai-,-lalai-,-lalai-', dalam itu
perintah, sehingga ia menemui fungsi untuk mengendalikan konteks.

Sebagai contoh:

compdef '_fail -g "*.log"' '-redirect-,2>,-default-'

melengkapkan pemadanan fail `*.log' selepas `2> ' untuk sebarang arahan yang tidak lebih spesifik
pengendali ditakrifkan.

Juga:
compdef _foo -nilai-,-lalai-,-lalai-
menyatakan bahawa _foo menyediakan pelengkapan untuk nilai parameter yang tidak istimewa
fungsi telah ditakrifkan. Ini biasanya dikendalikan oleh fungsi _nilai sendiri.

Peraturan carian yang sama digunakan semasa mencari gaya (seperti yang diterangkan di bawah); sebagai contoh

zstyle ':completion:*:*:-redirect-,2>,*:*' corak fail '*.log'

adalah satu lagi cara untuk menyiapkan selepas `2> ' fail lengkap sepadan `*.log'.

Fungsi
Fungsi berikut ditakrifkan oleh compinit dan boleh dipanggil terus.

compdef [ -anne ] fungsi nama ... [ -{p|P} pola ... [ -N nama ...]]
compdef -d nama ...
compdef -k [ -an ] fungsi gaya urutan kunci [ urutan kunci ... ]
compdef -K [ -an ] fungsi nama gaya kunci-seq [ nama gaya seq ... ]
Bentuk pertama mentakrifkan fungsi untuk meminta penyiapan dalam konteks yang diberikan sebagai
diterangkan untuk #compdef tag di atas.

Sebagai alternatif, semua hujah mungkin mempunyai bentuk `cmd=perkhidmatan'. Di sini perkhidmatan
sepatutnya sudah ditakrifkan oleh `cmd1=perkhidmatan' baris masuk #compdef fail, sebagai
diterangkan di atas. Hujah untuk cmd akan disiapkan dengan cara yang sama seperti
perkhidmatan.

. fungsi argumen mungkin sebagai rentetan yang mengandungi hampir semua shell
kod. Jika rentetan mengandungi tanda yang sama, perkara di atas akan diutamakan. The
pilihan -e boleh digunakan untuk menentukan hujah pertama untuk dinilai sebagai shell
kod walaupun ia mengandungi tanda yang sama. Rentetan akan dilaksanakan menggunakan menipu
arahan terbina untuk menjana penyiapan. Ini menyediakan cara untuk mengelak daripada terpaksa
tentukan fungsi penyiapan baharu. Contohnya, untuk melengkapkan fail yang berakhir dengan `.h' sebagai
hujah kepada perintah itu foo:

compdef '_fail -g "*.h"' foo

pilihan -n menghalang sebarang penyiapan yang telah ditakrifkan untuk arahan atau konteks
daripada ditimpa.

pilihan -d memadam sebarang penyiapan yang ditakrifkan untuk arahan atau konteks yang disenaraikan.

. namas juga mungkin mengandungi -p, -P and -N pilihan seperti yang diterangkan untuk #compdef tag.
Kesan pada senarai hujah adalah sama, bertukar antara takrifan
corak cuba pada mulanya, corak cuba akhirnya, dan perintah dan konteks biasa.

Parameter tersebut $_compskip boleh ditetapkan oleh mana-mana fungsi yang ditakrifkan untuk konteks corak.
Jika ia ditetapkan kepada nilai yang mengandungi subrentetan `corak' tiada satu pun
corak-fungsi akan dipanggil; jika ia ditetapkan kepada nilai yang mengandungi subrentetan
`semua', tiada fungsi lain akan dipanggil.

Borang dengan -k mentakrifkan widget dengan nama yang sama dengan fungsi yang akan
dipanggil untuk setiap satu urutan kuncis; ini adalah seperti #compdef -k teg. The
fungsi harus menjana penyiapan yang diperlukan dan sebaliknya akan berkelakuan seperti
widget terbina yang namanya diberikan sebagai gaya hujah. Widget yang boleh digunakan untuk
ini adalah: perkataan lengkap, delete-char-or-list, kembangkan-atau-lengkap,
awalan kembangkan-atau-lengkapkan, senarai-pilihan, menu-lengkap, menu- kembangkan-atau-lengkap,
and terbalik-menu-lengkap, Serta menu-pilih jika zsh/complist modul ialah
dimuatkan. Pilihannya -n menghalang kunci terikat jika ia sudah diikat
sesuatu selain kunci yang tidak ditentukan.

Borang dengan -K adalah serupa dan mentakrifkan berbilang widget berdasarkan yang sama
fungsi, setiap satunya memerlukan set tiga hujah nama, gaya and
kunci-sequence, di mana dua yang terakhir adalah sebagai untuk -k dan yang pertama mestilah unik
nama widget bermula dengan garis bawah.

Di mana berkenaan, -a pilihan menjadikan fungsi boleh dimuatkan secara automatik, bersamaan dengan
autoload -U fungsi.

Majlis tersebut compdef boleh digunakan untuk mengaitkan fungsi penyiapan sedia ada dengan yang baru
arahan. Sebagai contoh,

compdef _pids foo

menggunakan fungsi _pids untuk melengkapkan ID proses untuk arahan foo.

Perhatikan juga _gnu_generik fungsi yang diterangkan di bawah, yang boleh digunakan untuk melengkapkan pilihan
untuk arahan yang memahami `- membantu' pilihan.

SELESAI SISTEM CONFIGURATION

Bahagian ini memberikan gambaran ringkas tentang cara sistem penyiapan berfungsi, dan kemudian banyak lagi
terperinci tentang cara pengguna boleh mengkonfigurasi cara dan bila padanan dijana.

Pengenalan
Apabila penyiapan cuba di suatu tempat pada baris arahan sistem penyiapan bermula
membina konteks. Konteks mewakili semua yang shell tahu tentang
maksud baris arahan dan kepentingan kedudukan kursor. Ini memerlukan
mengambil kira beberapa perkara termasuk kata perintah (seperti `grep' atau `zsh') dan
pilihan yang perkataan semasa mungkin menjadi hujah (seperti `-o' pilihan untuk zsh yang
mengambil pilihan shell sebagai hujah).

Konteksnya bermula dengan sangat generik ("kami mula selesai") dan menjadi lebih banyak
khusus kerana lebih banyak dipelajari ("perkataan semasa berada dalam kedudukan yang biasanya perintah
nama" atau "perkataan semasa mungkin nama berubah" dan seterusnya). Oleh itu konteks
akan berbeza-beza semasa panggilan yang sama ke sistem penyiapan.

Maklumat konteks ini dipekatkan menjadi rentetan yang terdiri daripada berbilang medan
dipisahkan oleh titik bertindih, dirujuk hanya sebagai `konteks' dalam baki
dokumentasi. Ambil perhatian bahawa pengguna sistem penyiapan jarang perlu mengarang a
rentetan konteks, melainkan contohnya fungsi baharu sedang ditulis untuk melaksanakan penyiapan
untuk arahan baru. Perkara yang mungkin perlu dilakukan oleh pengguna ialah mengarang a gaya corak, iaitu
dipadankan dengan konteks apabila diperlukan untuk mencari pilihan sensitif konteks yang mengkonfigurasi
sistem penyiapan.

Beberapa perenggan seterusnya menerangkan cara konteks digubah dalam fungsi penyiapan
suite. Berikutan itu adalah perbincangan tentang bagaimana gaya ditakrifkan. Gaya menentukan sedemikian
perkara seperti bagaimana padanan dijana, sama seperti pilihan shell tetapi dengan banyak lagi
kawalan. Mereka ditakrifkan dengan zstyle arahan terbina (lihat zshmodules(1)).

Rentetan konteks sentiasa terdiri daripada set medan tetap, dipisahkan oleh titik bertindih dan dengan
kolon terkemuka sebelum yang pertama. Medan yang belum diketahui dibiarkan kosong, tetapi
kolon di sekeliling kelihatan pula. Medan sentiasa dalam susunan
:selesai:fungsi:pelengkap:arahan:hujah:tag. Ini mempunyai makna berikut:

· Rentetan literal siap, mengatakan bahawa gaya ini digunakan oleh penyiapan
sistem. Ini membezakan konteks daripada yang digunakan oleh, sebagai contoh, zle
widget dan fungsi ZFTP.

· The fungsi, jika penyiapan dipanggil daripada widget bernama dan bukannya melalui
sistem penyiapan biasa. Biasanya ini kosong, tetapi ia ditetapkan oleh khas
widget seperti ramalan dan pelbagai fungsi dalam widget direktori
pengedaran kepada nama fungsi itu, selalunya dalam bentuk singkatan.

· The pelengkap sedang aktif, nama fungsi tanpa petunjuk
garis bawah dan dengan garis bawah lain ditukar kepada tanda sempang. `Pelengkap' sudah masuk
kawalan keseluruhan tentang cara penyiapan dilakukan; `melengkapkan' adalah yang paling mudah,
tetapi pelengkap lain wujud untuk melaksanakan tugas berkaitan seperti pembetulan, atau untuk
mengubah suai tingkah laku pelengkap kemudian. Lihat bahagian `Fungsi Kawalan'
di bawah untuk maklumat lebih lanjut.

· The arahan atau khas -konteks-, hanya pada ia muncul berikutan #compdef tag
atau compdef fungsi. Fungsi penyelesaian untuk arahan yang mempunyai sub-perintah
biasanya mengubah suai medan ini untuk mengandungi nama arahan diikuti dengan tolak
tandatangan dan sub-perintah. Sebagai contoh, fungsi penyiapan untuk cvs arahan
menetapkan medan ini kepada cvs-tambah apabila melengkapkan hujah kepada menambah subperintah.

· The hujah; ini menunjukkan baris arahan atau hujah pilihan yang mana kita
melengkapkan. Untuk hujah arahan ini biasanya mengambil bentuk hujah-n, Di mana
n ialah nombor hujah, dan untuk hujah kepada pilihan borang pilihan-pilih-n
di mana n ialah nombor hujah kepada pilihan pilih. Walau bagaimanapun, ini hanya
kes jika baris arahan dihuraikan dengan pilihan dan hujah gaya UNIX standard,
begitu banyak penyiapan tidak menetapkan ini.

· The tag. Seperti yang diterangkan sebelum ini, teg digunakan untuk mendiskriminasi antara jenis
padanan fungsi penyiapan boleh menjana dalam konteks tertentu. Sebarang penyiapan
fungsi boleh menggunakan mana-mana nama tag yang disukainya, tetapi senarai nama yang lebih biasa diberikan
di bawah.

Konteks secara beransur-ansur disatukan apabila fungsi dilaksanakan, bermula dengan
titik masuk utama, yang menambah :selesai: dan juga fungsi elemen jika perlu. The
completer kemudian menambah pelengkap unsur. Penyiapan kontekstual menambah arahan and
hujah pilihan. Akhirnya, yang tag ditambah apabila jenis penyiapan diketahui. Untuk
contoh, nama konteks

:complete::complete:dvips:option-o-1:files

mengatakan bahawa penyiapan biasa telah dicuba sebagai hujah pertama kepada pilihan -o daripada
arahan dvips:

dvips -o ...

dan fungsi penyiapan akan menjana nama fail.

Biasanya penyiapan akan dicuba untuk semua teg yang mungkin dalam susunan yang diberikan oleh penyiapan
fungsi. Walau bagaimanapun, ini boleh diubah dengan menggunakan perintah tag gaya. Selesai kemudian
terhad kepada senarai tag yang diberikan dalam susunan yang diberikan.

. _bantuan_lengkap arahan bindable menunjukkan semua konteks dan teg yang tersedia untuk
selesai pada titik tertentu. Ini menyediakan cara mudah untuk mencari maklumat untuk
perintah tag dan gaya lain. Ia diterangkan dalam bahagian `Arahan Boleh Diikat' di bawah.

Apabila mencari gaya, sistem penyiapan menggunakan nama konteks penuh, termasuk teg.
Oleh itu, mencari nilai gaya terdiri daripada dua perkara: konteks, iaitu
dipadankan dengan corak gaya yang paling khusus (paling sesuai) dan nama gaya
itu sendiri, yang mesti dipadankan dengan tepat. Contoh berikut menunjukkan gaya itu
corak boleh ditakrifkan secara longgar untuk gaya yang digunakan secara meluas, atau ditakrifkan secara ketat seperti
dikehendaki untuk gaya yang digunakan dalam keadaan yang lebih sempit.

Sebagai contoh, banyak fungsi penyiapan boleh menjana padanan dalam bentuk yang ringkas dan bertele-tele
dan gunakan kata kerja gaya untuk menentukan bentuk yang harus digunakan. Untuk membuat semua fungsi tersebut
gunakan bentuk kata kerja, letak

zstyle ':selesai:*' kata kerja yes

dalam fail permulaan (mungkin .zshrc). Ini memberikan kata kerja gayakan nilai yes dalam setiap
konteks dalam sistem penyiapan, melainkan konteks itu mempunyai definisi yang lebih khusus.
Adalah lebih baik untuk mengelak daripada memberikan konteks sebagai `*' sekiranya gaya itu mempunyai makna di luar
sistem penyiapan.

Banyak gaya tujuan umum sedemikian boleh dikonfigurasikan hanya dengan menggunakan compinstall
fungsi.

Contoh penggunaan yang lebih spesifik kata kerja gaya adalah dengan penyiapan untuk membunuh
terbina. Jika gaya ditetapkan, terbina dalam menyenaraikan teks kerja penuh dan baris arahan proses;
jika tidak, ia menunjukkan nombor kerja kosong dan PID. Untuk mematikan gaya untuk kegunaan ini
hanya:

zstyle ':completion:*:*:kill:*:*' kata kerja tidak

Untuk lebih kawalan, gaya boleh menggunakan salah satu teg `pekerjaan' atau `proses'. Untuk berpaling
paparan tidak jelas hanya untuk kerja:

zstyle ':completion:*:*:kill:*:jobs' kata kerja tidak

. -e pilihan untuk zstyle malah membenarkan kod fungsi penyiapan muncul sebagai hujah kepada
gaya; ini memerlukan sedikit pemahaman tentang dalaman fungsi penyiapan (lihat
lihat zshcompwid(1))). Sebagai contoh,

zstyle -e ':selesai:*' tuan rumah 'reply=($myhosts)'

Ini memaksa nilai tuan rumah gaya untuk dibaca daripada pembolehubah myhosts setiap kali a
nama hos diperlukan; ini berguna jika nilai myhosts boleh berubah secara dinamik. Untuk
contoh lain yang berguna, lihat contoh dalam huraian senarai fail gaya di bawah.
Borang ini boleh menjadi perlahan dan harus dielakkan untuk gaya yang biasa diperiksa seperti menu and
senarai-baris-dahulu.

Ambil perhatian bahawa susunan gaya ditakrifkan tidak mengapa; mekanisme gaya yang digunakan
padanan paling spesifik yang mungkin untuk gaya tertentu untuk menentukan set nilai.
Lebih tepat lagi, rentetan lebih disukai daripada corak (contohnya,
`:completion::complete:::foo' adalah lebih spesifik daripada `:selesai::selesai:::*'), Dan
corak yang lebih panjang diutamakan berbanding corak yang lebih pendek.

Peraturan praktikal yang baik ialah mana-mana corak gaya penyiapan yang perlu disertakan lebih daripada
satu kad bebas (*) dan itu tidak berakhir dengan nama teg, hendaklah termasuk kesemua enam titik bertindih (:),
mungkin mengelilingi kad bebas tambahan.

Nama gaya seperti tag adalah sewenang-wenangnya dan bergantung pada fungsi penyiapan.
Walau bagaimanapun, dua bahagian berikut menyenaraikan beberapa teg dan gaya yang paling biasa.

Standard Tags
Sesetengah daripada berikut hanya digunakan apabila mencari gaya tertentu dan tidak merujuk kepada
sejenis padanan.

akaun
digunakan untuk mencari hos pengguna gaya

semua-pengembangan
digunakan oleh _mengembangkan pelengkap apabila menambah rentetan tunggal yang mengandungi semua yang mungkin
pengembangan

semua fail
untuk nama semua fail (sebagai berbeza daripada subset tertentu, lihat
globbed-fail teg).

hujah
untuk hujah kepada perintah

tatasusunan untuk nama parameter tatasusunan

kunci persatuan
untuk kunci tatasusunan bersekutu; digunakan apabila melengkapkan dalam subskrip kepada a
parameter jenis ini

penanda buku
apabila melengkapkan penanda halaman (cth untuk URL dan zftp suite fungsi)

binaan
untuk nama arahan terbina

aksara
untuk aksara tunggal dalam hujah perintah seperti stty. Juga digunakan apabila
melengkapkan kelas aksara selepas kurungan pembukaan

colormapids
untuk id peta warna X

warna untuk nama warna

arahan
untuk nama arahan luaran. Juga digunakan oleh arahan yang kompleks seperti cvs apabila
melengkapkan subperintah nama.

konteks
untuk konteks dalam hujah kepada zstyle arahan terbina

pembetulan
digunakan oleh _anggaran and _betul pelengkap untuk kemungkinan pembetulan

Kursor
untuk nama kursor yang digunakan oleh program X

lalai
digunakan dalam beberapa konteks untuk menyediakan cara membekalkan lalai apabila lebih khusus
tag juga sah. Ambil perhatian bahawa tag ini digunakan apabila hanya fungsi bidang
nama konteks ditetapkan

penerangan
digunakan apabila mencari nilai format gaya untuk menjana penerangan bagi
jenis padanan

peranti
untuk nama fail khas peranti

direktori
untuk nama direktori -- direktori-tempatan digunakan sebaliknya apabila melengkapkan
hujah daripada cd dan arahan terbina yang berkaitan apabila cdpath tatasusunan ditetapkan

timbunan direktori
untuk entri dalam timbunan direktori

memaparkan
untuk nama paparan X

domain
untuk domain rangkaian

pengembangan
digunakan oleh _mengembangkan pelengkap untuk perkataan individu (berbanding dengan set lengkap
pengembangan) terhasil daripada pengembangan perkataan pada baris arahan

sambungan
untuk sambungan pelayan X

deskriptor fail
untuk bilangan deskriptor fail terbuka

fail tag padanan fail generik yang digunakan oleh fungsi melengkapkan nama fail

fon untuk nama fon X

fstypes
untuk jenis sistem fail (cth mount perintah)

fungsi
nama fungsi -- biasanya fungsi shell, walaupun arahan tertentu mungkin
memahami jenis fungsi lain

globbed-fail
untuk nama fail apabila nama telah dijana oleh padanan corak

kumpulan untuk nama kumpulan pengguna

kata-kata sejarah
untuk kata-kata dari sejarah

tuan rumah untuk nama hos

indeks
untuk indeks tatasusunan

pekerjaan untuk pekerjaan (seperti yang disenaraikan oleh `pekerjaan' terbina)

antara muka
untuk antara muka rangkaian

peta kunci
untuk nama peta kunci zsh

keysyms
untuk nama X keysyms

perpustakaan
untuk nama perpustakaan sistem

had untuk had sistem

direktori-tempatan
untuk nama direktori yang merupakan subdirektori bagi direktori kerja semasa
apabila melengkapkan hujah daripada cd dan arahan terbina yang berkaitan (bandingkan
laluan-direktori) -- apabila cdpath tatasusunan tidak ditetapkan, direktori digunakan sebaliknya

manual
untuk nama halaman manual

peti mel
untuk folder e-mel

peta untuk nama peta (cth peta NIS)

mesej
digunakan untuk mencari format gaya untuk mesej

pengubah
untuk nama pengubahsuai X

modul
untuk modul (cth zsh modul)

akaun saya
digunakan untuk mencari hos pengguna gaya

bernama-direktori
untuk direktori bernama (anda tidak akan meneka itu, bukan?)

nama untuk semua jenis nama

kumpulan berita
untuk kumpulan USENET

nama samaran
untuk nama samaran peta NIS

pilihan
untuk pilihan arahan

asal
digunakan oleh _anggaran, _betul and _mengembangkan pelengkap apabila menawarkan
rentetan asal sebagai padanan

lain-akaun
digunakan untuk mencari hos pengguna gaya

fail lain
untuk nama mana-mana fail bukan direktori. Ini digunakan sebagai ganti semua fail apabila
yang senarai-dirs-dahulu gaya berkuat kuasa.

pakej
untuk pakej (cth rpm atau dipasang Debian pakej)

parameter
untuk nama parameter

laluan-direktori
untuk nama direktori yang ditemui dengan mencari cdpath tatasusunan apabila melengkapkan
hujah daripada cd dan arahan terbina yang berkaitan (bandingkan direktori-tempatan)

laluan digunakan untuk mencari nilai-nilai mengembangkan, samar-samar and pengarah khas gaya

buah untuk pod perl (fail dokumentasi)

pelabuhan untuk pelabuhan komunikasi

awalan
untuk awalan (seperti URL)

pencetak
untuk mencetak nama baris gilir

proses
untuk pengecam proses

nama proses
digunakan untuk mencari arahan gaya apabila menjana nama proses untuk
bunuh semua

urutan
untuk urutan (cth mh urutan)

sesi
untuk sesi dalam zftp suite fungsi

isyarat
untuk nama isyarat

tali
untuk rentetan (cth rentetan gantian untuk cd arahan terbina)

gaya untuk gaya yang digunakan oleh perintah terbina zstyle

akhiran
untuk sambungan nama fail

tags untuk tag (cth rpm teg)

sasaran
untuk sasaran makefile

zon waktu
untuk zon waktu (cth semasa menetapkan TZ parameter)

jenis untuk jenis apa sahaja (cth jenis alamat untuk xhost perintah)

url digunakan untuk mencari url and tempatan gaya semasa melengkapkan URL

pengguna untuk nama pengguna

nilai untuk satu set nilai dalam senarai tertentu

pelbagai
digunakan oleh _pilih_varian untuk mencari arahan untuk dijalankan semasa menentukan program apa
dipasang untuk nama arahan tertentu.

visual
untuk visual X

amaran
digunakan untuk mencari format gaya untuk amaran

widget
untuk nama widget zsh

tingkap
untuk ID tetingkap X

zsh-options
untuk pilihan shell

Standard Gaya
Ambil perhatian bahawa nilai beberapa gaya ini mewakili nilai boolean. Mana-mana daripada
rentetan `benar', `on', `yes', dan `1' boleh digunakan untuk nilai `true' dan mana-mana
rentetan `palsu', `off', `tidak', dan `0' untuk nilai `palsu'. Tingkah laku untuk yang lain
nilai tidak ditentukan kecuali jika dinyatakan secara eksplisit. Nilai lalai mungkin sama ada
`benar' atau `palsu' jika gaya tidak ditetapkan.

Sesetengah gaya ini diuji terlebih dahulu untuk setiap kemungkinan teg yang sepadan dengan jenis
padan, dan jika tiada gaya ditemui, untuk lalai tag. Gaya yang paling ketara ini
jenis adalah menu, senarai-warna dan gaya mengawal penyenaraian penyiapan seperti penuh senarai
and segera terakhir. Apabila diuji untuk lalai tag, hanya fungsi bidang konteks
akan ditetapkan supaya gaya menggunakan teg lalai biasanya akan ditakrifkan di sepanjang baris
daripada:

zstyle ':completion:*:default' menu ...

terima-tepat
Ini diuji untuk teg lalai sebagai tambahan kepada teg yang sah untuk semasa
konteks. Jika ia ditetapkan kepada `benar' dan mana-mana perlawanan percubaan adalah sama dengan
rentetan pada baris arahan, padanan ini akan segera diterima (walaupun ia
sebaliknya akan dianggap samar-samar).

Apabila melengkapkan nama laluan (di mana teg digunakan ialah `laluan') gaya ini menerima mana-mana
bilangan corak sebagai nilai sebagai tambahan kepada nilai boolean. Nama laluan
memadankan salah satu corak ini akan diterima serta-merta walaupun arahan
baris mengandungi beberapa komponen nama laluan yang ditaip separa dan ini tidak sepadan dengan fail
di bawah direktori yang diterima.

Gaya ini juga digunakan oleh _mengembangkan pelengkap untuk memutuskan sama ada perkataan bermula dengan
perluasan tilde atau parameter perlu dikembangkan. Sebagai contoh, jika ada
parameter foo and foobar, rentetan `$foo' hanya akan diperluaskan jika terima-tepat
ditetapkan kepada `benar'; jika tidak sistem penyiapan akan dibenarkan untuk disiapkan $foo
kepada $foobar. Jika gaya ditetapkan kepada `terus', _mengembangkan akan menambah pengembangan sebagai a
perlawanan dan sistem penyiapan juga akan dibenarkan diteruskan.

terima-tepat-dir
Ini digunakan oleh pelengkapan nama fail. Tidak seperti terima-tepat ia adalah boolean. Oleh
lalai, pelengkapan nama fail memeriksa semua komponen laluan untuk melihat sama ada terdapat
penyiapan komponen itu, walaupun komponen itu sepadan dengan direktori sedia ada.
Contohnya, apabila siap selepas / usr / tong /, fungsi memeriksa mungkin
penyiapan kepada / usr.

Apabila gaya ini `benar', sebarang awalan laluan yang sepadan dengan direktori sedia ada
diterima tanpa sebarang percubaan untuk melengkapkannya lagi. Oleh itu, dalam yang diberikan
contoh, jalan / usr / tong / diterima serta-merta dan dicuba untuk menyelesaikannya
direktori.

Jika anda ingin menghalang tingkah laku ini sepenuhnya, tetapkan jalan-penyelesaian gaya (lihat
di bawah) kepada `palsu'.

tambah-ruang
Gaya ini digunakan oleh _mengembangkan pelengkap. Jika ia adalah `benar' (lalai), a
ruang akan disisipkan selepas semua perkataan yang terhasil daripada pengembangan, atau garis miring masuk
kes nama direktori. Jika nilainya ialah `fail', pelengkap hanya akan menambah a
ruang kepada nama fail sedia ada. Sama ada `true' boolean atau nilai `fail' mungkin
digabungkan dengan `subst', dalam hal ini pelengkap tidak akan menambah ruang pada perkataan
terhasil daripada pengembangan penggantian bentuk `$(...)' atau `${...}'.

. _awalan pelengkap menggunakan gaya ini sebagai nilai boolean mudah untuk memutuskan sama ada a
ruang hendaklah disisipkan sebelum akhiran.

samar-samar
Ini terpakai apabila melengkapkan komponen bukan akhir laluan nama fail, dengan kata lain
mereka yang mempunyai garis miring mengekor. Jika ia ditetapkan, kursor dibiarkan selepas yang pertama
komponen samar-samar, walaupun penyelesaian menu sedang digunakan. Gaya sentiasa diuji
dengan laluan tag.

senarai tugasan
Apabila melengkapkan selepas tanda sama yang dianggap sebagai tugasan, yang
sistem penyiapan biasanya melengkapkan hanya satu nama fail. Dalam beberapa kes nilai
mungkin senarai nama fail yang dipisahkan oleh titik bertindih, seperti PATH dan serupa
parameter. Gaya ini boleh ditetapkan kepada senarai corak yang sepadan dengan nama sedemikian
parameter.

Lalai adalah untuk melengkapkan senarai apabila perkataan pada baris sudah mengandungi a
usus besar.

perihalan automatik
Jika ditetapkan, nilai gaya ini akan digunakan sebagai penerangan untuk pilihan yang tidak
diterangkan oleh fungsi penyiapan, tetapi itu mempunyai satu hujah. The
urutan `%d' dalam nilai akan digantikan dengan penerangan untuk hujah ini.
Bergantung pada pilihan peribadi, mungkin berguna untuk menetapkan gaya ini kepada sesuatu
seperti `nyatakan: %d'. Ambil perhatian bahawa ini mungkin tidak berfungsi untuk beberapa arahan.

elak-lengkap
Ini digunakan oleh _semua_perlawanan pelengkap untuk memutuskan sama ada rentetan yang terdiri daripada
semua padanan hendaklah ditambahkan pada senarai yang sedang dijana. Nilainya ialah a
senarai nama pelengkap. Jika mana-mana ini adalah nama pelengkap itu
menjana padanan dalam penyiapan ini, rentetan tidak akan ditambah.

Nilai lalai untuk gaya ini ialah `_mengembangkan _senarai_lama _betul _anggaran', iaitu
ia mengandungi pelengkap yang mana rentetan dengan semua padanan hampir tidak akan ada
mahu.

laluan cache
Gaya ini mentakrifkan laluan di mana mana-mana fail cache yang mengandungi data penyiapan dibuang
disimpan. Ia lalai kepada `$ZDOTDIR/.zcompcache', atau `$HOME/.zcompcache' jika
$ZDOTDIR tidak ditakrifkan. Cache penyiapan tidak akan digunakan melainkan
guna-cache gaya ditetapkan.

dasar cache
Gaya ini mentakrifkan fungsi yang akan digunakan untuk menentukan sama ada cache
memerlukan pembinaan semula. Lihat bahagian pada _cache_invalid fungsi di bawah.

perintah panggilan
Gaya ini digunakan dalam fungsi untuk arahan seperti membuat and semut mana memanggil
arahan secara langsung untuk menjana padanan mengalami masalah seperti lambat atau, sebagai
dalam kes membuat berpotensi menyebabkan tindakan dalam makefile dilaksanakan.
Jika ia ditetapkan kepada `true' arahan dipanggil untuk menjana padanan. Nilai lalai
gaya ini adalah `palsu'.

arahan
Di banyak tempat, fungsi penyiapan perlu memanggil arahan luaran untuk menjana
senarai siap. Gaya ini boleh digunakan untuk mengatasi arahan yang dipanggil
dalam beberapa kes sedemikian. Unsur-unsur nilai dicantumkan dengan ruang untuk membentuk a
baris arahan untuk dilaksanakan. Nilai juga boleh bermula dengan tanda sempang, dalam hal ini
arahan biasa akan ditambah ke penghujung; ini paling berguna untuk meletakkan `dibina'
atau `arahan' di hadapan untuk memastikan versi arahan yang sesuai dipanggil,
contohnya untuk mengelak daripada memanggil fungsi shell dengan nama yang sama seperti luaran
perintah.

Sebagai contoh, fungsi penyiapan untuk ID proses menggunakan gaya ini dengan
proses tag untuk menjana ID untuk dilengkapkan dan senarai proses untuk dipaparkan
(sekiranya kata kerja gaya adalah `benar'). Senarai yang dihasilkan oleh arahan harus kelihatan
seperti output daripada ps perintah. Baris pertama tidak dipaparkan, tetapi adalah
mencari rentetan `PID' (atau `pid') untuk mencari kedudukan ID proses dalam
baris berikut. Jika baris tidak mengandungi `PID', nombor pertama dalam setiap satu
daripada baris lain diambil sebagai ID proses untuk dilengkapkan.

Ambil perhatian bahawa fungsi penyiapan secara amnya perlu memanggil arahan yang ditentukan untuk
setiap percubaan untuk menjana senarai penyiapan. Oleh itu penjagaan harus diambil
tentukan hanya arahan yang mengambil masa yang singkat untuk dijalankan, dan khususnya untuk mengelakkan sebarang
yang mungkin tidak pernah tamat.

laluan arahan
Ini ialah senarai direktori untuk mencari arahan untuk dilengkapkan. Lalai untuk
gaya ini ialah nilai parameter khas jalan.

arahan
Ini digunakan oleh fungsi yang melengkapkan sub-perintah untuk permulaan sistem
skrip (berdiam di /etc/init.d atau di suatu tempat yang tidak terlalu jauh dari itu). Ianya
nilai memberikan arahan lalai untuk dilengkapkan bagi arahan tersebut yang
fungsi penyiapan tidak dapat mencarinya secara automatik. Lalai untuk
gaya ini adalah dua rentetan `permulaan' dan `berhenti'.

melengkapkan
Ini digunakan oleh _expand_alias berfungsi apabila dipanggil sebagai arahan yang boleh diikat. Jika
ditetapkan kepada `true' dan perkataan pada baris arahan bukanlah nama alias,
nama alias yang sepadan akan dilengkapkan.

pilihan lengkap
Ini digunakan oleh pelengkap untuk cd, chdir and pushd. Untuk arahan ini a - is
digunakan untuk memperkenalkan entri timbunan direktori dan penyiapan ini jauh lebih banyak
biasa daripada melengkapkan pilihan. Oleh itu melainkan nilai gaya ini adalah `benar'
pilihan tidak akan selesai, walaupun selepas permulaan -. Jika `benar', pilihan
akan disiapkan selepas permulaan - melainkan ada yang terdahulu -- atas arahan
line.

pelengkap
Rentetan yang diberikan sebagai nilai gaya ini memberikan nama pelengkap
fungsi untuk digunakan. Fungsi pelengkap yang tersedia diterangkan dalam bahagian
`Fungsi Kawalan' di bawah.

Setiap rentetan mungkin sama ada nama fungsi yang lebih lengkap atau rentetan borang
`fungsi:nama'. Dalam kes pertama pelengkap medan konteks akan mengandungi
nama pelengkap tanpa garis bawah utama dan dengan semua yang lain
garis bawah digantikan dengan sempang. Dalam kes kedua fungsi ialah nama
pelengkap untuk memanggil, tetapi konteksnya akan mengandungi yang ditentukan pengguna nama dalam
pelengkap bidang konteks. Sekiranya nama bermula dengan tanda sempang, rentetan untuk
konteks akan dibina daripada nama fungsi pelengkap seperti yang pertama
kes dengan nama dilampirkan kepadanya. Sebagai contoh:

zstyle ':selesai:*' pelengkap _lengkap _lengkap:-foo

Di sini, penyiapan akan memanggil _lengkap pelengkap dua kali, sekali menggunakan `melengkapkan'dan
sekali menggunakan `lengkap-foo' di dalam pelengkap bidang konteks. Biasanya, menggunakan
pelengkap yang sama lebih daripada sekali hanya masuk akal apabila digunakan dengan
`fungsi:nama', kerana jika tidak, nama konteks akan sama dalam semua
panggilan kepada pelengkap; kemungkinan pengecualian kepada peraturan ini ialah _diabaikan and
_awalan pelengkap.

Nilai lalai untuk gaya ini ialah `_lengkap _diabaikan': hanya penyiapan sahaja
selesai, mula-mula menggunakan corak-abaikan gaya dan $fignore tatasusunan dan kemudian
tanpa mengabaikan perlawanan.

keadaan
Gaya ini digunakan oleh _senarai fungsi pelengkap untuk memutuskan sama ada sisipan daripada
perlawanan harus ditangguhkan tanpa syarat. Lalai adalah `benar'.

pembatas
Gaya ini digunakan apabila menambah pembatas untuk digunakan dengan pengubah suai sejarah atau glob
kelayakan yang mempunyai hujah yang terhad. Ia adalah pelbagai pembatas pilihan
untuk menambah. Aksara bukan khas lebih disukai kerana sistem penyiapan mungkin
jika tidak menjadi keliru. Senarai lalai ialah :, +, /, -, %. Senarai itu mungkin
kosong untuk memaksa pembatas ditaip.

orang kurang upaya
Jika ini ditetapkan kepada `benar', the _expand_alias perintah yang lebih lengkap dan boleh diikat akan cuba
untuk mengembangkan alias yang dilumpuhkan juga. Lalai ialah `palsu'.

domain
Senarai nama domain rangkaian untuk dilengkapkan. Jika ini tidak ditetapkan, domain
nama akan diambil daripada fail /etc/resolv.conf.

kira-kira
Gaya persekitaran digunakan apabila melengkapkan untuk `sudo'. Ia ditetapkan kepada tatasusunan
`VAR=nilai' tugasan untuk dieksport ke persekitaran tempatan sebelum
penyempurnaan untuk arahan sasaran dipanggil.
zstyle ':completion:*:sudo::' kira-kira \
PATH="/ sbin:/ usr / sbin:$PATH" RUMAH="/ Akar"

mengembangkan Gaya ini digunakan apabila melengkapkan rentetan yang terdiri daripada berbilang bahagian, seperti
nama laluan.

Jika salah satu nilainya ialah rentetan `awalan', perkataan yang ditaip sebahagian daripada baris
akan diperluaskan sejauh mungkin walaupun bahagian belakang tidak dapat disiapkan.

Jika salah satu nilainya ialah rentetan `akhiran', memadankan nama untuk komponen selepas
yang pertama samar-samar juga akan ditambah. Ini bermakna rentetan yang terhasil
ialah rentetan jelas terpanjang yang mungkin. Walau bagaimanapun, penyiapan menu boleh digunakan
untuk mengharungi semua perlawanan.

palsu Gaya ini boleh ditetapkan untuk sebarang konteks penyiapan. Ia menentukan rentetan tambahan
yang akan sentiasa dilengkapkan dalam konteks itu. Bentuk setiap rentetan ialah
`nilai:Penerangan'; titik bertindih dan perihalan boleh ditinggalkan, tetapi sebarang literal
titik bertindih dalam nilai mesti dipetik dengan garis miring ke belakang. mana-mana Penerangan disediakan ditunjukkan
bersama nilai dalam penyenaraian penyiapan.

Adalah penting untuk menggunakan konteks yang cukup ketat apabila menyatakan palsu
rentetan. Perhatikan bahawa gaya fail palsu and parameter palsu menyediakan tambahan
ciri apabila melengkapkan fail atau parameter.

palsu-selalu
Ini berfungsi sama dengan palsu gaya kecuali bahawa corak-abaikan gaya adalah
tidak digunakan padanya. Ini membolehkan anda membatalkan set padanan sepenuhnya
dengan menetapkan corak yang diabaikan kepada `*'.

Berikut menunjukkan cara untuk menambah sebarang teg dengan data sewenang-wenangnya, tetapi mempunyai
ia berkelakuan untuk tujuan paparan seperti teg berasingan. Dalam contoh ini kita menggunakan
ciri-ciri dari perintah tag gaya untuk membahagikan bernama-direktori tag kepada dua apabila
melaksanakan penyiapan dengan pelengkap standard melengkapkan untuk hujah cd.
Tanda itu bernama-direktori-normal berkelakuan seperti biasa, tetapi tag
bernama-direktori-saya mengandungi set direktori tetap. Ini mempunyai kesan
menambah kumpulan perlawanan `tambahan direktori' dengan penyiapan yang diberikan.

zstyle ':completion::complete:cd:*' perintah tag \
'named-directories:-mine:extra\ direktori
bernama-direktori:-normal:bernama\ direktori *'
zstyle ':completion::complete:cd:*:named-directories-mine' \
palsu-selalu mydir1 mydir2
zstyle ':completion::complete:cd:*:named-directories-mine' \
corak-abaikan '*'

fail palsu
Gaya ini digunakan semasa melengkapkan fail dan mencari tanpa teg. Nilai-nilainya
adalah dalam bentuk `dir:nama...'. Ini akan menambah nama (tali dipisahkan oleh
spaces) sebanyak mungkin sepadan apabila melengkapkan dalam direktori dir, walaupun tidak begitu
fail benar-benar wujud. Dir mungkin corak; aksara corak atau titik bertindih dalam dir
hendaklah dipetik dengan garis miring ke belakang untuk dilayan secara literal.

Ini boleh berguna pada sistem yang menyokong sistem fail khas yang tahap tertingginya
nama laluan tidak boleh disenaraikan atau dijana dengan corak glob. Ia juga boleh digunakan
untuk direktori yang mana satu tidak mempunyai kebenaran membaca.

Borang corak boleh digunakan untuk menambah entri `ajaib' tertentu pada semua direktori pada a
sistem fail tertentu.

parameter palsu
Ini digunakan oleh fungsi penyiapan untuk nama parameter. Nilainya ialah nama
daripada parameter yang mungkin belum ditetapkan tetapi perlu dilengkapkan. setiap satu
nama juga boleh diikuti dengan titik bertindih dan rentetan yang menyatakan jenis
parameter (seperti `skalar', `pelbagai' atau `integer'). Jika jenis diberi, nama
hanya akan dilengkapkan jika parameter jenis itu diperlukan secara khusus
konteks. Nama yang tiada jenis dinyatakan akan sentiasa dilengkapkan.

senarai fail
Gaya ini mengawal sama ada fail disiapkan menggunakan mekanisme terbina dalam standard
akan disenaraikan dengan senarai panjang yang serupa dengan ls -l. Ambil perhatian bahawa ciri ini menggunakan
modul shell zsh/stat untuk maklumat fail; ini memuatkan builtin stat yang
akan menggantikan mana-mana luaran stat boleh dilaksanakan. Untuk mengelakkan ini kod berikut boleh
disertakan dalam fail permulaan:

zmodload -i zsh/stat
melumpuhkan stat

Gaya mungkin sama ada ditetapkan kepada nilai `benar' (atau `semua'), atau salah satu nilai
`memasukkan' atau `senarai', menunjukkan bahawa fail akan disenaraikan dalam format panjang dalam semua
keadaan, atau apabila cuba memasukkan nama fail, atau apabila menyenaraikan nama fail
tanpa cuba memasukkan satu.

Secara umumnya, nilai tersebut mungkin merupakan tatasusunan mana-mana nilai di atas, secara pilihan
diikuti oleh =num. Jika num hadir ia memberikan bilangan maksimum padanan untuk
gaya penyenaraian panjang yang manakah akan digunakan. Sebagai contoh,

zstyle ':selesai:*' senarai fail senarai=20 masukkan=10

menentukan bahawa format panjang akan digunakan apabila menyenaraikan sehingga 20 fail atau memasukkan a
fail dengan sehingga 10 padanan (dengan andaian penyenaraian akan ditunjukkan sama sekali, sebagai contoh
apabila selesai samar-samar), jika tidak, format pendek akan digunakan.

zstyle -e ':selesai:*' senarai fail \
'(( ${+NUMERIC} )) && reply=(true)'

menentukan bahawa format panjang akan digunakan pada bila-bila masa argumen berangka dibekalkan,
lain format pendek.

corak fail
Ini digunakan oleh fungsi standard untuk melengkapkan nama fail, Sila hubungi Pentadbir Sistem. Jika
gaya tidak ditetapkan sehingga tiga teg ditawarkan, `globbed-fail',`direktori'dan
`semua fail', bergantung pada jenis fail yang dijangkakan oleh pemanggil Sila hubungi Pentadbir Sistem.
Dua yang pertama (`globbed-fail' dan `direktori') biasanya ditawarkan bersama-sama kepada
memudahkan untuk melengkapkan fail dalam sub-direktori.

. corak fail style menyediakan alternatif kepada teg lalai, yang tidak
digunakan. Nilainya terdiri daripada unsur-unsur bentuk `pola:tag'; setiap rentetan boleh
mengandungi sebarang bilangan spesifikasi sedemikian yang dipisahkan oleh ruang.

. pola ialah corak yang akan digunakan untuk menjana nama fail. Sebarang kejadian
daripada urutan `%p' digantikan dengan mana-mana corak yang diluluskan oleh panggilan fungsi
Sila hubungi Pentadbir Sistem. Titik bertindih dalam corak mesti didahului dengan garis miring ke belakang untuk menjadikannya
boleh dibezakan daripada kolon sebelum tag. Jika lebih daripada satu corak diperlukan,
corak boleh diberikan dalam pendakap, dipisahkan dengan koma.

. tags daripada semua rentetan dalam nilai akan ditawarkan oleh Sila hubungi Pentadbir Sistem dan digunakan apabila
mencari gaya lain. mana-mana tags dalam perkataan yang sama akan ditawarkan pada masa yang sama
masa dan sebelum perkataan kemudian. Jika tidak `:tag' diberi `failtag ' akan digunakan.

. tag mungkin juga diikuti dengan kolon kedua pilihan dan penerangan, yang
akan digunakan untuk `%d' dalam nilai format gaya (jika itu ditetapkan) sebaliknya
perihalan lalai yang dibekalkan oleh fungsi penyiapan. Jika penerangan
diberikan di sini mengandungi sendiri `%d', yang digantikan dengan perihalan yang dibekalkan
dengan fungsi penyiapan.

Sebagai contoh, untuk membuat rm arahan terlebih dahulu lengkapkan hanya nama fail objek dan
maka nama semua fail jika tiada fail objek yang sepadan:

zstyle ':penyelesaian:*:*:rm:*:*' corak fail \
'*.o:objek-fail' '%p:all-files'

Untuk mengubah tingkah laku lalai penyiapan fail -- tawarkan fail yang sepadan dengan corak
dan direktori pada percubaan pertama, kemudian semua fail -- untuk menawarkan padanan sahaja
fail pada percubaan pertama, kemudian direktori, dan akhirnya semua fail:

zstyle ':selesai:*' corak fail \
'%p:globbed-files' '*(-/):direktori' '*:semua fail'

Ini berfungsi walaupun tidak ada corak khas: Sila hubungi Pentadbir Sistem sepadan dengan semua fail yang digunakan
corak `*' pada langkah pertama dan berhenti apabila ia melihat corak ini. Perhatikan juga
ia tidak akan mencuba corak lebih daripada sekali untuk satu percubaan penyiapan.

Semasa pelaksanaan fungsi penyiapan, EXTENDED_GLOB pilihan sudah masuk
kesan, jadi watak-watak `#', `~' dan `^' mempunyai makna khusus dalam corak.

isihan fail
Fungsi penyiapan nama fail standard menggunakan gaya ini tanpa teg kepada
tentukan dalam susunan mana nama harus disenaraikan; penyiapan menu akan berkitar
melalui mereka dalam susunan yang sama. Nilai yang mungkin adalah: `saiz' untuk mengisih mengikut
saiz fail; `link' untuk mengisih mengikut bilangan pautan ke fail;
`pengubahsuaian' (atau `masa' atau `tarikh') untuk mengisih mengikut masa pengubahsuaian terakhir;
`mengakses' untuk mengisih mengikut masa akses terakhir; dan `masuk' (atau `menukar') untuk mengisih mengikut
masa pertukaran inod terakhir. Jika gaya ditetapkan kepada sebarang nilai lain, atau tidak ditetapkan, fail
akan diisih mengikut abjad mengikut nama. Jika nilai mengandungi rentetan `berbalik',
pengisihan dilakukan dalam susunan yang bertentangan. Jika nilai mengandungi rentetan `mengikuti',
cap masa dikaitkan dengan sasaran pautan simbolik; lalai adalah untuk digunakan
cap masa pautan itu sendiri.

menapis Ini digunakan oleh pemalam LDAP untuk pelengkapan alamat e-mel untuk menentukan
atribut untuk dipadankan semasa menapis entri. Jadi sebagai contoh, jika gaya
ditetapkan kepada `sn', pemadanan dilakukan terhadap nama keluarga. Penapisan LDAP standard digunakan
jadi padanan penyiapan biasa dipintas. Jika gaya ini tidak ditetapkan, LDAP
pemalam dilangkau. Anda juga mungkin perlu menetapkan arahan gaya untuk menentukan cara
sambung ke pelayan LDAP anda.

senarai paksa
Ini memaksa senarai penyiapan ditunjukkan pada mana-mana tempat penyenaraian dilakukan,
walaupun dalam kes di mana senarai biasanya akan ditindas. Sebagai contoh, biasanya
senarai hanya ditunjukkan jika terdapat sekurang-kurangnya dua padanan berbeza. Dengan menetapkan
gaya ini kepada `sentiasa', senarai akan sentiasa ditunjukkan, walaupun hanya terdapat a
perlawanan tunggal yang akan segera diterima. Gaya juga boleh ditetapkan kepada a
nombor. Dalam kes ini senarai akan ditunjukkan jika terdapat sekurang-kurangnya sebanyak itu
padanan, walaupun mereka semua akan memasukkan rentetan yang sama.

Gaya ini diuji untuk teg lalai dan juga untuk setiap teg yang sah untuk
penyiapan semasa. Oleh itu penyenaraian boleh dipaksa hanya untuk jenis tertentu
sepadan.

format Jika ini ditetapkan untuk penerangan tag, nilainya digunakan sebagai rentetan untuk dipaparkan
perlawanan di atas dalam senarai penyelesaian. Urutan `%d' dalam rentetan ini akan menjadi
digantikan dengan penerangan ringkas tentang padanan ini. Rentetan ini juga boleh
mengandungi urutan berikut untuk menentukan atribut output seperti yang diterangkan dalam
bahagian PERLUASAN URUTAN CEPAT dalam zshmisc(1): `%B', `%S', `%U', `%F', `%K'
dan huruf kecil mereka, serta `%{...%}'. `%F', `%K' dan `%{...%}'
ambil hujah dalam bentuk yang sama seperti pengembangan segera. Perhatikan bahawa urutan `%G'
tidak boleh didapati; hujah kepada `%{' hendaklah digunakan sebaliknya.

Gaya diuji dengan setiap teg sah untuk penyiapan semasa sebelum ianya
diuji untuk penerangan tag. Oleh itu rentetan format yang berbeza boleh ditakrifkan untuk
jenis padanan yang berbeza.

Perhatikan juga bahawa beberapa fungsi pelengkap mentakrifkan tambahan `%'-urutan. Ini adalah
diterangkan untuk fungsi yang lebih lengkap yang menggunakannya.

Beberapa fungsi penyiapan memaparkan mesej yang mungkin disesuaikan dengan menetapkan ini
gaya untuk mesej tag. Di sini, `%d' digantikan dengan mesej yang diberikan oleh
fungsi penyiapan.

Akhirnya, rentetan format dicari dengan amaran tag, untuk digunakan apabila tidak
padanan boleh dihasilkan sama sekali. Dalam kes ini `%d' digantikan dengan
penerangan untuk perlawanan yang dijangka dipisahkan oleh ruang. Urutannya
`%D' digantikan dengan perihalan yang sama dipisahkan oleh baris baharu.

Anda boleh menggunakan penentu lebar medan gaya printf dengan `%d' dan seumpamanya
urutan melarikan diri. Ini dikendalikan oleh zformat arahan terbina daripada
zsh/zutil modul, lihat zshmodules(1).

epal Ini digunakan oleh _mengembangkan pelengkap. Jika ia ditetapkan kepada `true' (lalai),
globbing akan dicuba pada perkataan yang terhasil daripada penggantian sebelumnya (lihat
yang pengganti style) atau rentetan asal daripada baris.

global Jika ini ditetapkan kepada `true' (lalai), the _expand_alias lebih lengkap dan boleh diikat
arahan akan cuba mengembangkan alias global.

nama kumpulan
Sistem penyiapan boleh mengumpulkan pelbagai jenis padanan, yang muncul dalam
senarai berasingan. Gaya ini boleh digunakan untuk memberikan nama kumpulan secara khusus
tag. Sebagai contoh, dalam kedudukan arahan sistem penyiapan menjana nama
arahan terbina dan luaran, nama alias, fungsi shell dan parameter dan
perkataan terpelihara sebagai pelengkap yang mungkin. Untuk mempunyai arahan luaran dan shell
fungsi disenaraikan secara berasingan:

zstyle ':completion:*:*:-command-:*:commands' \
nama kumpulan arahan
zstyle ':completion:*:*:-command-:*:functions' \
nama kumpulan fungsi

Akibatnya, sebarang padanan dengan tag yang sama akan dipaparkan dalam kumpulan yang sama.

Jika nama yang diberikan ialah rentetan kosong, nama tag untuk padanan adalah
digunakan sebagai nama kumpulan. Jadi, untuk mempunyai semua jenis padanan yang berbeza
dipaparkan secara berasingan, seseorang hanya boleh menetapkan:

zstyle ':selesai:*' nama kumpulan ''

Semua perlawanan yang tiada nama kumpulan ditentukan akan dimasukkan ke dalam kumpulan yang dinamakan
-lalai-.

susunan kumpulan
Gaya ini adalah tambahan kepada nama kumpulan gaya untuk menentukan pesanan untuk paparan
kumpulan yang ditakrifkan oleh gaya itu (bandingkan perintah tag, yang menentukan yang mana
penyiapan kelihatan sama sekali). Kumpulan yang dinamakan ditunjukkan dalam susunan yang diberikan; mana-mana
kumpulan lain ditunjukkan dalam susunan yang ditakrifkan oleh fungsi penyiapan.

Sebagai contoh, untuk mempunyai nama arahan terbina dalam, fungsi shell dan luaran
arahan muncul dalam susunan itu apabila melengkapkan dalam kedudukan arahan:

zstyle ':completion:*:*:-command-:*:*' susunan kumpulan \
binaan fungsi arahan

kumpulan Senarai nama kumpulan UNIX. Jika ini tidak ditetapkan, nama kumpulan diambil daripada
pangkalan data YP atau fail `/ dll / kumpulan'.

tersembunyi Jika ini ditetapkan kepada `true', padanan untuk konteks yang diberikan tidak akan disenaraikan,
walaupun sebarang penerangan untuk perlawanan yang ditetapkan dengan format gaya akan ditunjukkan.
Jika ia ditetapkan kepada `semua', huraian pun tidak akan dipaparkan.

Ambil perhatian bahawa perlawanan masih akan diselesaikan; mereka hanya tidak ditunjukkan dalam senarai.
Untuk mengelakkan perlawanan dianggap sebagai penyelesaian yang mungkin sama sekali, the perintah tag
gaya boleh diubah suai seperti yang diterangkan di bawah.

tuan rumah Senarai nama hos yang perlu dilengkapkan. Jika ini tidak ditetapkan, nama hos
diambil daripada fail `/ Etc / tuan rumah'.

hos-pelabuhan
Gaya ini digunakan oleh arahan yang memerlukan atau menerima nama hos dan port rangkaian.
Rentetan dalam nilai hendaklah dalam bentuk `tuan rumah:pelabuhan'. Port yang sah adalah
ditentukan oleh kehadiran nama hos; berbilang port untuk hos yang sama boleh
muncul.

abaikan-line
Ini diuji untuk setiap teg yang sah untuk penyiapan semasa. Jika ia ditetapkan kepada
`benar', tiada satu pun perkataan yang sudah ada di talian akan dianggap sebagai
kemungkinan siap. Jika ia ditetapkan kepada `semasa', perkataan kursor berada pada kehendak
tidak dianggap sebagai penyelesaian yang mungkin. Nilai `ditunjukkan semasa' serupa
tetapi hanya terpakai jika senarai penyiapan ditunjukkan pada skrin pada masa ini.
Akhir sekali, jika gaya ditetapkan kepada `lain', semua perkataan pada baris kecuali untuk
yang semasa akan dikecualikan daripada kemungkinan penyiapan.

Nilai-nilai `semasa' dan `ditunjukkan semasa' adalah agak bertentangan dengan
terima-tepat gaya: hanya rentetan dengan aksara yang hilang akan dilengkapkan.

Ambil perhatian bahawa anda hampir pasti tidak mahu menetapkan ini kepada `true' atau `lain' Untuk
konteks umum seperti `:selesai:*'. Ini kerana ia tidak membenarkan
penyiapan, sebagai contoh, pilihan beberapa kali walaupun arahan yang dipersoalkan
menerima pilihan lebih daripada sekali.

abaikan-ibu bapa
Gaya diuji tanpa teg oleh fungsi melengkapkan nama laluan untuk
tentukan sama ada untuk mengabaikan nama direktori yang telah disebut dalam
perkataan semasa, atau nama direktori kerja semasa. Nilai mesti termasuk
satu atau kedua-dua rentetan berikut:

ibu bapa Nama mana-mana direktori yang laluannya sudah terkandung dalam perkataan pada
baris diabaikan. Contohnya, apabila selesai selepas foo/../, direktori
foo tidak akan dianggap sebagai penyiapan yang sah.

jentera Nama direktori kerja semasa tidak akan dilengkapkan; oleh itu, untuk
contoh, siap selepas ../ tidak akan menggunakan nama semasa
direktori.

Di samping itu, nilai mungkin termasuk satu atau kedua-duanya:

.. Abaikan direktori yang ditentukan hanya apabila perkataan pada baris mengandungi
subrentetan `../'.

direktori
Abaikan direktori yang ditentukan hanya apabila nama direktori adalah
selesai, bukan semasa melengkapkan nama fail.

Nilai yang dikecualikan bertindak dalam cara yang serupa dengan nilai corak-abaikan gaya,
supaya mereka boleh dipulihkan kepada pertimbangan oleh _diabaikan pelengkap.

extra-verbose
Jika ditetapkan, penyenaraian penyiapan adalah lebih terperinci dengan kos kemungkinan penurunan
dalam kelajuan penyiapan. Prestasi penyiapan akan terjejas jika gaya ini ditetapkan kepada
`benar'.

corak-abaikan
Senarai corak; sebarang penyelesaian percubaan yang sepadan dengan salah satu corak akan menjadi
dikecualikan daripada pertimbangan. The _diabaikan pelengkap boleh muncul dalam senarai
pelengkap untuk memulihkan padanan yang diabaikan. Ini adalah versi yang lebih boleh dikonfigurasikan
parameter shell $fignore.

Ambil perhatian bahawa EXTENDED_GLOB pilihan ditetapkan semasa pelaksanaan penyiapan
berfungsi, jadi aksara `#', `~' dan `^' mempunyai makna khusus dalam
corak.

memasukkan Gaya ini digunakan oleh _semua_perlawanan pelengkap untuk memutuskan sama ada untuk memasukkan
senarai semua perlawanan tanpa syarat dan bukannya menambah senarai sebagai perlawanan lain.

insert-id
Apabila melengkapkan ID proses, contohnya sebagai hujah kepada membunuh and tunggu binaan
nama arahan boleh ditukar kepada ID proses yang sesuai. Masalah
timbul apabila nama proses yang ditaip bukan unik. Secara lalai (atau jika gaya ini ialah
tetapkan secara eksplisit kepada `menu') nama akan ditukar serta-merta kepada satu set
ID yang mungkin, dan penyiapan menu akan dimulakan untuk mengitarinya.

Jika nilai gaya ialah `tunggal', shell akan menunggu sehingga pengguna telah menaip
cukup untuk menjadikan perintah itu unik sebelum menukar nama kepada ID; percubaan di
penyiapan akan tidak berjaya sehingga ketika itu. Jika nilainya adalah yang lain
rentetan, penyiapan menu akan dimulakan apabila rentetan yang ditaip oleh pengguna lebih panjang
daripada awalan biasa kepada ID yang sepadan.

insert-tab
Jika ini ditetapkan kepada `true', sistem penyiapan akan memasukkan aksara TAB
(dengan mengandaikan bahawa digunakan untuk memulakan penyiapan) dan bukannya melaksanakan penyiapan apabila
tiada aksara bukan kosong di sebelah kiri kursor. Jika ia ditetapkan kepada
`palsu', penyiapan akan dilakukan walaupun di sana.

Nilai juga mungkin mengandungi subrentetan `menunggu' atau `belum selesai=val'. Di dalam ini
kes, aksara yang ditaip akan dimasukkan dan bukannya mula siap apabila
terdapat input yang belum diproses belum selesai. Sekiranya val diberikan, penyiapan tidak akan dilakukan
jika terdapat sekurang-kurangnya banyak aksara input yang tidak diproses. Ini selalunya
berguna apabila menampal aksara ke dalam terminal. Walau bagaimanapun, ambil perhatian bahawa ia bergantung pada
yang $PENDING parameter khas daripada zsh/zle modul ditetapkan dengan betul iaitu
tidak dijamin pada semua platform.

Nilai lalai gaya ini adalah `benar' kecuali untuk penyiapan dalam berbeza
arahan terbina di mana ia adalah `palsu'.

sisip-tidak jelas
Ini digunakan oleh _perlawanan and _anggaran pelengkap. Pelengkap ini selalunya
digunakan dengan pelengkapan menu kerana perkataan yang ditaip mungkin mempunyai sedikit persamaan dengan
penyiapan akhir. Walau bagaimanapun, jika gaya ini adalah `benar', pelengkap akan memulakan menu
penyiapan hanya jika ia tidak menemui rentetan awal yang jelas sekurang-kurangnya selagi
rentetan asal yang ditaip oleh pengguna.

Dalam kes _anggaran pelengkap, medan yang lebih lengkap dalam konteks akan
telah ditetapkan kepada salah satu daripada betul-num or anggaran-num, Di mana num adalah
bilangan ralat yang diterima.

Dalam kes _perlawanan lebih lengkap, gaya juga boleh ditetapkan kepada rentetan
`pola'. Kemudian corak pada baris dibiarkan tidak berubah jika ia tidak sepadan
dengan jelas.

simpan-awalan
Gaya ini digunakan oleh _mengembangkan pelengkap. Jika ia `benar', pelengkap akan
cuba simpan awalan yang mengandungi tilde atau pengembangan parameter. Oleh itu, untuk
contoh, rentetan `~/f*' akan dikembangkan kepada `~/foo' bukannya
`/home/user/foo'. Jika gaya ditetapkan kepada `berubah' (lalai), awalan akan
hanya dibiarkan tidak berubah jika terdapat perubahan lain antara perkataan yang dikembangkan dan
perkataan asal daripada baris arahan. Sebarang nilai lain memaksa awalan menjadi
berkembang tanpa syarat.

Tingkah laku _mengembangkan apabila gaya ini `benar' adalah untuk menyebabkan _mengembangkan Berasa putus asa
apabila pengembangan tunggal dengan awalan yang dipulihkan adalah sama dengan yang asal; oleh itu
mana-mana pelengkap yang tinggal boleh dipanggil.

segera terakhir
Ini adalah bentuk yang lebih fleksibel SENTIASA_LAST_PROMPT pilihan. Jika ia 'benar',
sistem penyiapan akan cuba mengembalikan kursor ke baris arahan sebelumnya
selepas memaparkan senarai siap. Ia diuji untuk semua tag yang sah untuk
siap semasa, kemudian lalai tag. Kursor akan dialihkan semula ke
baris sebelumnya jika gaya ini `benar' untuk semua jenis padanan. Perhatikan bahawa tidak seperti
SENTIASA_LAST_PROMPT pilihan ini adalah bebas daripada hujah berangka.

fail-hos yang dikenali
Gaya ini harus mengandungi senarai fail untuk mencari nama hos dan (jika
use-ip gaya ditetapkan) alamat IP dalam format yang serasi dengan ssh dikenali_hos
fail. Jika ia tidak ditetapkan, fail /etc/ssh/ssh_known_hosts and ~/.ssh/known_hosts
digunakan.

senarai Gaya ini digunakan oleh _sejarah_perkataan_lengkap perintah yang boleh diikat. Jika ia ditetapkan kepada
`benar' tiada kesan. Jika ia ditetapkan kepada `palsu' padanan tidak akan disenaraikan. ini
mengatasi tetapan pilihan mengawal gelagat penyenaraian, khususnya
AUTO_LIST. Konteks sentiasa bermula dengan `:penyelesaian:sejarah-perkataan'.

senarai-warna
Jika zsh/complist modul dimuatkan, gaya ini boleh digunakan untuk menetapkan warna
spesifikasi. Mekanisme ini menggantikan penggunaan ZLS_COLORS and ZLS_COLOURS
parameter yang diterangkan dalam bahagian `Modul zsh/complist' dalam zshmodules(1), tetapi
sintaksnya adalah sama.

Jika gaya ini ditetapkan untuk lalai tag, rentetan dalam nilai diambil sebagai
spesifikasi yang akan digunakan di mana-mana. Jika ia ditetapkan untuk tag lain, teg
spesifikasi digunakan hanya untuk padanan jenis yang diterangkan oleh teg. Untuk
ini untuk berfungsi dengan baik, itu nama kumpulan gaya mesti ditetapkan kepada rentetan kosong.

Selain menetapkan gaya untuk teg tertentu, anda juga boleh menggunakan kumpulan
nama yang dinyatakan secara eksplisit oleh nama kumpulan tag bersama-sama dengan `(kumpulan)'sintaks
dibenarkan oleh ZLS_COLORS and ZLS_COLOURS parameter dan hanya menggunakan lalai
tag.

Anda boleh menggunakan sebarang spesifikasi warna yang telah disediakan untuk versi GNU
daripada ls arahan:

zstyle ':completion:*:default' senarai-warna \
${(s.:.)LS_COLORS}

Warna lalai adalah sama seperti untuk GNU ls perintah dan boleh diperolehi oleh
menetapkan gaya kepada rentetan kosong (cth '').

senarai-dirs-dahulu
Ini digunakan oleh penyiapan fail. Jika ditetapkan, direktori yang perlu disiapkan disenaraikan
secara berasingan daripada dan sebelum siap untuk fail lain, tanpa mengira susunan teg.
Selain itu, tag fail lain digunakan sebagai ganti semua fail untuk selebihnya
fail, untuk menunjukkan bahawa tiada direktori dibentangkan dengan tag itu.

kumpulan senarai
Jika gaya ini `benar' (lalai), sistem penyiapan akan cuba buat
penyenaraian penyiapan tertentu lebih padat dengan mengumpulkan padanan. Sebagai contoh, pilihan
untuk arahan yang mempunyai penerangan yang sama (ditunjukkan apabila kata kerja gaya ditetapkan kepada
`true') akan muncul sebagai satu entri. Walau bagaimanapun, pemilihan menu boleh digunakan untuk
kitaran melalui semua perlawanan.

penuh senarai
Ini diuji untuk setiap teg yang sah dalam konteks semasa serta teg lalai
tag. Jika ia ditetapkan kepada `benar', padanan yang sepadan muncul dalam penyenaraian seolah-olah
yang LIST_PACKED pilihan telah ditetapkan. Jika ia ditetapkan kepada `palsu', ia disenaraikan
biasanya.

segera senarai
Jika gaya ini ditetapkan untuk lalai tag, senarai penyelesaian yang tidak sesuai pada
skrin boleh ditatal (lihat penerangan tentang zsh/complist modul dalam
zshmodules(1)). Nilai, jika bukan rentetan kosong, akan dipaparkan selepas setiap
penuh skrin dan cangkerang akan menggesa untuk menekan kekunci; jika gaya ditetapkan kepada
rentetan kosong, gesaan lalai akan digunakan.

Nilai mungkin mengandungi urutan pelarian: `%l' atau `%L', yang akan digantikan dengan
bilangan baris terakhir yang dipaparkan dan jumlah bilangan baris; `%m' atau `%M',
bilangan perlawanan terakhir ditunjukkan dan jumlah perlawanan; dan `%p'dan
`%P', `Top' apabila pada permulaan senarai, `Bawah' apabila pada akhir dan
kedudukan ditunjukkan sebagai peratusan daripada jumlah panjang sebaliknya. Dalam setiap kes
borang dengan huruf besar akan digantikan dengan rentetan lebar tetap, berlapik
ke kanan dengan ruang, manakala bentuk huruf kecil akan digantikan dengan pembolehubah
rentetan lebar. Seperti dalam rentetan gesaan yang lain, urutan pelarian `%S', `%s', `%B',
`%b', `%U', `%u' untuk memasuki dan meninggalkan mod paparan menonjol, tebal dan
gariskan, dan `%F', `%f', `%K', `%k' untuk menukar latar belakang latar depan
warna, juga tersedia, seperti bentuk `%{...%}' untuk melampirkan urutan pelarian
yang memaparkan dengan lebar sifar (atau, dengan hujah berangka, beberapa yang lain).

Selepas memadam ini, minta pembolehubah LISTPROMPT sepatutnya tidak ditetapkan untuk dialih keluar
untuk berkuat kuasa.

senarai-baris-dahulu
Gaya ini diuji dengan cara yang sama seperti penuh senarai gaya dan menentukan
sama ada perlawanan akan disenaraikan dalam fesyen baris pertama seolah-olah LIST_ROWS_FIRST
pilihan telah ditetapkan.

akhiran senarai
Gaya ini digunakan oleh fungsi yang melengkapkan nama fail. Jika ia `benar', dan
penyiapan cuba pada rentetan yang mengandungi berbilang nama laluan ditaip separa
komponen, semua komponen yang tidak jelas akan ditunjukkan. Jika tidak, penyiapan terhenti di
komponen samar-samar pertama.

pemisah senarai
Nilai gaya ini digunakan dalam penyenaraian penyelesaian untuk memisahkan rentetan kepada
lengkapkan daripada perihalan apabila boleh (cth apabila melengkapkan pilihan). Ia
lalai kepada `--' (dua tanda sempang).

tempatan Ini adalah untuk digunakan dengan fungsi yang melengkapkan URL dengan fail yang sepadan
boleh didapati terus daripada sistem fail. Nilainya harus terdiri daripada tiga
rentetan: nama hos, laluan ke halaman web lalai untuk pelayan, dan
nama direktori yang digunakan oleh pengguna yang meletakkan halaman web dalam kawasan rumah mereka.

Sebagai contoh:

zstyle ':selesai:*' tempatan roti bakar \
/var/http/public/toast public_html

Siap selepas `http://toast/stuff/' akan mencari fail dalam direktori
/var/http/public/toast/stuff, manakala siap selepas `http://toast/~yousir/' kehendak
cari fail dalam direktori ~yousir/public_html.

direktori mel
Jika ditetapkan, zsh akan menganggap bahawa fail peti mel boleh ditemui dalam direktori yang ditentukan.
Ia lalai kepada `~/Mel'.

padan-asli
Ini digunakan oleh _perlawanan pelengkap. Jika ia ditetapkan kepada hanyalah , _perlawanan akan cuba
hasilkan padanan tanpa memasukkan `*' pada kedudukan kursor. Jika ditetapkan kepada mana-mana
nilai bukan kosong yang lain, ia akan cuba menjana padanan terlebih dahulu tanpa memasukkan
`*' dan jika itu tidak menghasilkan padanan, ia akan mencuba lagi dengan `*' dimasukkan. Jika ia
tidak ditetapkan atau ditetapkan kepada rentetan kosong, pemadanan hanya akan dilakukan dengan `*'
dimasukkan.

jodoh
Gaya ini diuji secara berasingan untuk setiap teg yang sah dalam konteks semasa. Ianya
nilai dicuba sebelum sebarang spesifikasi padanan yang diberikan oleh senarai padanan gaya. Ia
hendaklah dalam bentuk yang diterangkan dalam bahagian `Kawalan Padanan Penyiapan' dalam
zshcompwid(1). Untuk contoh perkara ini, lihat penerangan tentang perintah tag gaya.

senarai padanan
Gaya ini boleh ditetapkan kepada senarai spesifikasi padanan yang akan digunakan
dimana - mana. Spesifikasi padanan diterangkan dalam bahagian `Pemadanan Selesai
Kawalan' dalam zshcompwid(1). Sistem penyiapan akan mencubanya satu demi satu
untuk setiap pelengkap yang dipilih. Sebagai contoh, untuk mencuba penyiapan mudah dahulu dan, jika
yang tidak menjana padanan, penyiapan tidak peka huruf besar-besaran:

zstyle ':selesai:*' senarai padanan '' 'm:{a-zA-Z}={A-Za-z}'

Secara lalai setiap spesifikasi menggantikan yang sebelumnya; namun, jika a
spesifikasi diawali dengan +, ia ditambahkan pada senarai sedia ada. Oleh itu ia adalah
mungkin untuk mencipta spesifikasi yang semakin umum tanpa pengulangan:

zstyle ':selesai:*' senarai padanan \
'' '+m:{az}={AZ}' '+m:{AZ}={az}'

Anda boleh membuat spesifikasi padanan yang sah untuk pelengkap tertentu dengan
menggunakan medan ketiga konteks. Ini hanya terpakai kepada pelengkap itu
mengatasi senarai pemadanan global, yang setakat penulisan ini hanya termasuk _awalan
and _diabaikan. Sebagai contoh, untuk menggunakan pelengkap _lengkap and _awalan tapi izinkan
penyiapan tidak peka huruf besar-besaran hanya dengan _lengkap:

zstyle ':selesai:*' pelengkap _lengkap _awalan
zstyle ':completion:*:complete:*:*:*' senarai padanan \
'' 'm:{a-zA-Z}={A-Za-z}'

Nama yang ditentukan pengguna, seperti yang dijelaskan untuk pelengkap gaya, tersedia. ini
membolehkan anda mencuba pelengkap yang sama lebih daripada sekali dengan padanan yang berbeza
spesifikasi setiap kali. Sebagai contoh, untuk mencuba penyiapan biasa tanpa perlawanan
spesifikasi, kemudian penyiapan biasa dengan padanan tidak sensitif huruf besar-besaran, kemudian
pembetulan, dan akhirnya pelengkapan separa perkataan:

zstyle ':selesai:*' pelengkap \
_lengkap _betul _complete:foo
zstyle ':completion:*:complete:*:*:*' senarai padanan \
'' 'm:{a-zA-Z}={A-Za-z}'
zstyle ':penyelesaian:*:foo:*:*:*' senarai padanan \
'm:{a-zA-Z}={A-Za-z} r:|[-_./]=* r:|=*'

Jika gaya tidak ditetapkan dalam mana-mana konteks tiada spesifikasi padanan digunakan. Perhatikan juga
bahawa beberapa pelengkap seperti _betul and _anggaran jangan gunakan perlawanan itu
spesifikasi sama sekali, walaupun pelengkap ini hanya akan dipanggil sekali sahaja
jika senarai padanan mengandungi lebih daripada satu unsur.

Di mana berbilang spesifikasi berguna, ambil perhatian bahawa keseluruhan penyiapan selesai
bagi setiap elemen senarai padanan, yang boleh mengurangkan prestasi shell dengan cepat.
Sebagai peraturan kasar, satu hingga tiga rentetan akan memberikan prestasi yang boleh diterima.
Sebaliknya, meletakkan berbilang nilai yang dipisahkan ruang ke dalam rentetan yang sama
tidak mempunyai kesan yang ketara terhadap prestasi.

Jika tiada padanan semasa atau ia kosong, dan pilihan NO_CASE_GLOB dalam
kesan, pemadanan untuk fail dilakukan secara tidak sensitif huruf besar-besaran dalam apa jua keadaan.
Walau bagaimanapun, mana-mana pemadan mesti menyatakan secara eksplisit padanan tidak sensitif huruf besar-besaran jika itu
diperlukan.

ralat maksimum
Ini digunakan oleh _anggaran and _betul fungsi pelengkap untuk menentukan
bilangan maksimum ralat untuk dibenarkan. Pelengkap akan cuba menjana penyiapan
dengan terlebih dahulu membenarkan satu ralat, kemudian dua ralat, dan seterusnya, sehingga sama ada padanan atau
padanan ditemui atau bilangan maksimum ralat yang diberikan oleh gaya ini telah
dicapai.

Jika nilai untuk gaya ini mengandungi rentetan `angka', fungsi yang lebih lengkap
akan mengambil sebarang hujah berangka sebagai bilangan maksimum ralat yang dibenarkan. Untuk
contoh, dengan

zstyle ':penyelesaian:*:anggaran:::' ralat maksimum 2 angka

dua ralat dibenarkan jika tiada hujah berangka diberikan, tetapi dengan argumen berangka
daripada enam (seperti dalam `ESC-6 TAB'), sehingga enam ralat diterima. Oleh itu dengan nilai
`0 angka', tiada penyelesaian pembetulan akan dicuba melainkan hujah berangka
diberikan.

Jika nilai mengandungi rentetan `bukan angka', pelengkap akan tidak cuba untuk
menjana penyiapan yang diperbetulkan apabila diberi hujah berangka, jadi dalam kes ini
nombor yang diberi hendaklah lebih besar daripada sifar. Contohnya, `2 bukan angka' menyatakan
bahawa pembetulan penyelesaian dengan dua ralat biasanya akan dilakukan, tetapi jika a
hujah berangka diberikan, penyelesaian pembetulan tidak akan dilakukan.

Nilai lalai untuk gaya ini ialah `2 angka'.

maks-padan-lebar
Gaya ini digunakan untuk menentukan pertukaran antara lebar paparan yang digunakan
untuk padanan dan lebar yang digunakan untuk penerangan mereka apabila kata kerja gaya sudah masuk
kesan. Nilai memberikan bilangan lajur paparan untuk ditempah untuk padanan.
Lalai ialah separuh lebar skrin.

Ini mempunyai kesan yang paling besar apabila beberapa perlawanan mempunyai penerangan yang sama dan begitu juga
dikumpulkan bersama. Meningkatkan gaya akan membolehkan lebih banyak padanan dikumpulkan
bersama-sama; mengurangkannya akan membolehkan lebih banyak huraian dapat dilihat.

menu Jika ini `benar' dalam konteks mana-mana teg yang ditakrifkan untuk semasa
penyelesaian menu siap akan digunakan. Nilai untuk teg tertentu akan diambil
keutamaan daripada itu untuk `lalai' tag.

Jika tiada nilai yang ditemui dengan cara ini adalah `benar' tetapi sekurang-kurangnya satu ditetapkan kepada
`auto', cangkerang berkelakuan seolah-olah AUTO_MENU pilihan ditetapkan.

Jika salah satu nilai ditetapkan secara eksplisit kepada `palsu', penyiapan menu akan menjadi
secara eksplisit dimatikan, mengatasi MENU_COMPLETE pilihan dan tetapan lain.

Dalam bentuk `ya=num', di mana `yes' mungkin mana-mana nilai `benar' (`yes', `benar',
`on' dan `1'), penyiapan menu akan dihidupkan sekiranya terdapat sekurang-kurangnya num perlawanan.
Dalam bentuk `ya=panjang', penyiapan menu akan dihidupkan jika senarai tidak sesuai
pada skrin. Ini tidak mengaktifkan penyiapan menu jika widget biasanya sahaja
menyenaraikan penyiapan, tetapi penyiapan menu boleh diaktifkan dalam kes itu dengan nilai
`ya=senarai panjang' (Biasanya, nilai `pilih=senarai panjang' diterangkan kemudian lebih
berguna kerana ia menyediakan kawalan ke atas menatal.)

Begitu juga, dengan mana-mana nilai `palsu' (seperti dalam `tidak=10'), penyiapan menu akan tidak
digunakan jika ada num atau lebih banyak perlawanan.

Nilai widget ini juga mengawal pemilihan menu, seperti yang dilaksanakan oleh
zsh/complist modul. Nilai berikut mungkin muncul sama ada di sebelah atau sebaliknya
daripada nilai di atas.

Jika nilai mengandungi rentetan `pilih', pemilihan menu akan dimulakan
tanpa syarat.

Dalam bentuk `pilih=num', pemilihan menu hanya akan dimulakan sekiranya terdapat sekurang-kurangnya
num perlawanan. Jika nilai untuk lebih daripada satu teg memberikan nombor, yang terkecil
nombor diambil.

Pemilihan menu boleh dimatikan secara eksplisit dengan menentukan nilai yang mengandungi
rentetan`tiada pilihan'.

Ia juga mungkin untuk memulakan pemilihan menu hanya jika senarai padanan tidak
muat pada skrin dengan menggunakan nilai `pilih=panjang'. Untuk memulakan pemilihan menu walaupun
jika widget semasa hanya melakukan penyenaraian, gunakan nilai `pilih=senarai panjang'.

Untuk menghidupkan penyiapan menu atau pemilihan menu apabila terdapat bilangan tertentu
perlawanan or senarai padanan tidak muat pada skrin, kedua-duanya `ya='dan
`pilih=' boleh diberikan dua kali, sekali dengan nombor dan sekali dengan `lama'atau
`senarai panjang'.

Akhir sekali, adalah mungkin untuk mengaktifkan dua mod khas pemilihan menu. Perkataan itu
`interaktif' dalam nilai menyebabkan mod interaktif dimasukkan serta-merta apabila
pemilihan menu dimulakan; lihat penerangan tentang zsh/complist modul dalam
zshmodules(1) untuk penerangan tentang mod interaktif. Termasuk rentetan `cari'
melakukan perkara yang sama untuk mod carian tambahan. Untuk memilih carian tambahan ke belakang,
sertakan rentetan `cari-belakang'.

muttrc Jika ditetapkan, berikan lokasi fail konfigurasi mutt. Ia lalai kepada
`~/.muttrc'.

nombor
Ini digunakan dengan pekerjaan tag. Jika ia `benar', shell akan menyelesaikan kerja
nombor dan bukannya awalan tidak jelas terpendek bagi teks arahan kerja. Sekiranya
nilai ialah nombor, nombor kerja hanya akan digunakan jika banyak perkataan daripada kerja itu
penerangan diperlukan untuk menyelesaikan kekaburan. Sebagai contoh, jika nilai adalah
`1', rentetan hanya akan digunakan jika semua kerja berbeza dalam perkataan pertama pada mereka
baris arahan.

senarai lama
Ini digunakan oleh _senarai lama pelengkap. Jika ia ditetapkan kepada `sentiasa', kemudian standard
widget yang melakukan penyenaraian akan mengekalkan senarai padanan semasa, walau bagaimanapun ia
telah dihasilkan; ini boleh dimatikan secara eksplisit dengan nilai `pernah', memberi
tingkah laku tanpa _senarai lama pelengkap. Jika gaya tidak ditetapkan, atau yang lain
nilai, maka senarai siap sedia ada dipaparkan jika belum;
jika tidak, senarai penyiapan standard dijana; ini ialah tingkah laku lalai
of _senarai lama. Walau bagaimanapun, jika terdapat senarai lama dan gaya ini mengandungi nama
fungsi yang lebih lengkap yang menjana senarai, maka senarai lama akan digunakan walaupun
jika ia dijana oleh widget yang tidak melakukan penyenaraian.

Sebagai contoh, katakan anda menaip ^Xc untuk menggunakan _perkataan_betul widget, yang menjana
senarai pembetulan untuk perkataan di bawah kursor. Biasanya, menaip ^D akan
jana senarai standard pelengkapan untuk perkataan pada baris arahan, dan tunjukkan
itu. Dengan _senarai lama, ia sebaliknya akan menunjukkan senarai pembetulan sudah
dihasilkan.

Sebagai contoh lain pertimbangkan _perlawanan pelengkap: dengan sisip-tidak jelas gaya
ditetapkan kepada `true' ia hanya memasukkan rentetan awalan biasa, jika ada. Walau bagaimanapun,
ini mungkin mengalih keluar bahagian corak asal, supaya penyiapan selanjutnya boleh
menghasilkan lebih banyak perlawanan berbanding percubaan pertama. Dengan menggunakan _senarai lama pelengkap
dan menetapkan gaya ini kepada _perlawanan, senarai padanan yang dijana pada yang pertama
percubaan akan digunakan semula.

perlawanan lama
Ini digunakan oleh _semua_perlawanan pelengkap untuk memutuskan sama ada senarai lama padanan
harus digunakan jika ada. Ini dipilih oleh salah satu nilai `benar' atau oleh
rentetan `hanyalah '. Jika nilainya ialah `hanyalah ', _semua_perlawanan hanya akan menggunakan senarai lama
dan tidak akan mempunyai sebarang kesan pada senarai padanan yang sedang dijana.

Jika gaya ini ditetapkan, biasanya tidak bijak untuk memanggil _semua_perlawanan pelengkap
tanpa syarat. Satu kemungkinan penggunaan adalah untuk gaya ini atau pelengkap gaya
untuk ditakrifkan dengan -e pilihan untuk zstyle untuk membuat gaya bersyarat.

menu lama
Ini digunakan oleh _senarai lama pelengkap. Ia mengawal cara penyiapan menu bertindak
apabila penyiapan telah dimasukkan dan pengguna menaip standard
kunci penyelesaian seperti TAB. Tingkah laku lalai bagi _senarai lama adakah menu itu
penyiapan sentiasa diteruskan dengan senarai siap sedia ada. Jika gaya ini
ditetapkan kepada `palsu', bagaimanapun, penyiapan baharu dimulakan jika senarai lama adalah
dihasilkan oleh arahan penyiapan yang berbeza; inilah perangai tanpa
_senarai lama pelengkap.

Sebagai contoh, katakan anda menaip ^Xc untuk menjana senarai pembetulan dan menu
penyiapan dimulakan dengan salah satu cara biasa. Biasanya, atau dengan gaya ini ditetapkan kepada
`palsu', menaip TAB pada ketika ini akan mula cuba melengkapkan barisan seperti sekarang
muncul. Dengan _senarai lama, ia sebaliknya terus mengitari senarai
pembetulan.

asal
Ini digunakan oleh _anggaran and _betul pelengkap untuk memutuskan sama ada yang asal
rentetan harus ditambah sebagai penyelesaian yang mungkin. Biasanya, ini dilakukan hanya jika
terdapat sekurang-kurangnya dua pembetulan yang mungkin, tetapi jika gaya ini ditetapkan kepada `benar', ia
sentiasa ditambah. Ambil perhatian bahawa gaya akan diperiksa dengan medan yang lebih lengkap dalam
nama konteks ditetapkan kepada betul-num or anggaran-num, Di mana num ialah bilangan
kesilapan yang telah diterima.

set pakej
Gaya ini digunakan apabila melengkapkan hujah Debian `dpkg' program. Ia
mengandungi penggantian untuk set pakej lalai untuk konteks tertentu. Sebagai contoh,

zstyle ':completion:*:complete:dpkg:option--status-1:*' \
set pakej berjaya

menyebabkan pakej yang tersedia, bukan hanya pakej yang dipasang, dilengkapkan untuk
`dpkg --status'.

jalan Fungsi yang melengkapkan nama warna menggunakan gaya ini dengan warna teg. The
nilai hendaklah nama laluan fail yang mengandungi nama warna dalam format an
X11 rgb.txt fail. Jika gaya tidak ditetapkan tetapi fail ini ditemui dalam salah satu daripada pelbagai
lokasi standard ia akan digunakan sebagai lalai.

jalan-penyelesaian
Ini digunakan oleh pelengkapan nama fail. Secara lalai, penyempurnaan nama fail memeriksa semua
komponen laluan untuk melihat sama ada terdapat penyiapan komponen itu. Untuk
contohnya, /u/b/z boleh diselesaikan ke /usr/bin/zsh. Menetapkan gaya ini secara eksplisit kepada
`false' menghalang tingkah laku ini untuk komponen laluan sehingga ke / sebelum kursor;
ini mengatasi tetapan terima-tepat-dir.

Walaupun dengan gaya ditetapkan kepada `palsu', masih boleh melengkapkan berbilang laluan
dengan menetapkan pilihan COMPLETE_IN_WORD dan gerakkan kursor kembali ke yang pertama
komponen dalam laluan yang akan diselesaikan. Sebagai contoh, /u/b/z boleh diselesaikan ke
/usr/bin/zsh jika kursor selepas /u.

direktori pain
Jika ditetapkan, tentukan direktori yang mengandungi fail peti mel PINE. Tidak ada
lalai, kerana mencari direktori ini secara rekursif menyusahkan sesiapa sahaja yang
tidak menggunakan PINE.

pelabuhan Senarai nama perkhidmatan Internet (port rangkaian) untuk dilengkapkan. Jika ini tidak ditetapkan,
nama perkhidmatan diambil daripada fail `/ etc / services'.

awalan-tersembunyi
Ini digunakan untuk penyiapan tertentu yang berkongsi awalan biasa, sebagai contoh
pilihan arahan bermula dengan sempang. Jika ia adalah `benar', awalan tidak akan menjadi
ditunjukkan dalam senarai perlawanan.

Nilai lalai untuk gaya ini ialah `palsu'.

awalan-diperlukan
Gaya ini juga relevan untuk padanan dengan awalan biasa. Jika ia ditetapkan kepada
`true' awalan biasa ini mesti ditaip oleh pengguna untuk menjana padanan.

Gaya ini boleh digunakan untuk pilihan, isyarat, pekerjaan, fungsi, dan parameter
tag penyiapan.

Untuk pilihan arahan, ini bermakna `-', `+', atau `--' mesti ditaip
secara eksplisit sebelum nama pilihan akan dilengkapkan.

Untuk isyarat, `-' diperlukan sebelum nama isyarat akan dilengkapkan.

Untuk pekerjaan, `%' diperlukan sebelum nama kerja disiapkan.

Untuk nama fungsi dan parameter, `_' atau `.' diperlukan sebelum berfungsi
atau nama parameter yang bermula dengan aksara tersebut akan dilengkapkan.

Nilai lalai untuk gaya ini ialah `palsu' untuk fungsi and parameter penyiapan,
dan `benar' sebaliknya.

prefix simpan
Gaya ini digunakan apabila melengkapkan nama laluan. Nilainya harus menjadi corak
memadankan awalan awal perkataan untuk melengkapkan yang sepatutnya dibiarkan tidak berubah
dalam semua keadaan. Sebagai contoh, pada sesetengah Unices `//' (berganda
slash) mempunyai makna khusus; menetapkan gaya ini kepada rentetan `//' akan memelihara
ia. Sebagai contoh lain, tetapkan gaya ini kepada `?:/' di bawah Cygwin akan membenarkan
siap selepas `a:/...' dan sebagainya.

pelbagai Ini digunakan oleh _sejarah pelengkap dan _sejarah_perkataan_lengkap boleh diikat
perintah untuk memutuskan perkataan yang harus dilengkapkan.

Jika ia adalah satu nombor, hanya yang terakhir N kata-kata dari sejarah akan dilengkapkan.

Jika ia adalah julat dalam bentuk `maks:keping', yang terakhir keping perkataan akan dilengkapkan;
maka jika itu tidak menghasilkan padanan, maka keping perkataan sebelum itu akan dicuba dan sebagainya
pada. Proses ini berhenti sama ada apabila sekurang-kurangnya satu padanan ditemui, atau maks perkataan
telah dicuba.

Lalai adalah untuk melengkapkan semua perkataan daripada sejarah sekali gus.

fail rekursif
Jika gaya ini ditetapkan, nilainya ialah tatasusunan corak untuk diuji
`$PWD/': perhatikan garis miring mengekor, yang membenarkan direktori dalam corak menjadi
dibatasi dengan jelas dengan memasukkan garis miring pada kedua-dua belah pihak. Jika fail biasa
penyiapan gagal dan perkataan pada baris arahan belum mempunyai direktori
sebahagian daripada namanya, gaya itu diambil menggunakan tag yang sama seperti untuk penyiapan
baru cuba, kemudian unsur diuji $PWD/ mengikut giliran. Jika ada yang sepadan,
kemudian shell cuba menyelesaikan semula dengan menambah perkataan pada baris arahan
dengan setiap direktori dalam pengembangan **/*(/) mengikut giliran. Biasanya unsur-unsur
gaya akan ditetapkan untuk mengehadkan bilangan direktori di bawah direktori semasa
kepada nombor yang boleh diurus, contohnya `*/.git/*'.

Sebagai contoh,

zstyle ':selesai:*' fail rekursif '*/zsh/*'

Jika direktori semasa ialah /home/pws/zsh/Src, Maka zle_trTAB boleh diselesaikan ke
Zle/zle_tricky.c.

kerap
Gaya ini digunakan oleh _expand_alias perintah yang lebih lengkap dan boleh diikat. Jika ditetapkan kepada
`true' (lalai), alias biasa akan dikembangkan tetapi hanya dalam arahan
kedudukan. Jika ia ditetapkan kepada `palsu', alias biasa tidak akan diperluaskan. Jika ia
ditetapkan kepada `sentiasa', alias biasa akan dikembangkan walaupun tidak dalam arahan
kedudukan.

ulang semula Jika ini ditetapkan semasa melengkapkan arahan luaran, senarai dalaman (cincang) daripada
arahan akan dikemas kini untuk setiap carian dengan mengeluarkan ulang semula perintah. Ada
penalti kelajuan untuk ini yang hanya mungkin ketara apabila direktori masuk
laluan mempunyai akses fail yang perlahan.

akses jauh
Jika ditetapkan kepada `false', arahan tertentu akan dihalang daripada membuat Internet
sambungan untuk mendapatkan maklumat jauh. Ini termasuk penyiapan untuk
CVS perintah.

Tidak selalu mungkin untuk mengetahui sama ada sambungan sebenarnya ke tapak terpencil, jadi
sesetengah mungkin dicegah tanpa perlu.

keluarkan-semua-dups
. _sejarah_perkataan_lengkap arahan yang boleh diikat dan _sejarah completer gunakan ini untuk
tentukan sama ada semua padanan pendua harus dialih keluar, bukan hanya berturut-turut
pendua.

pilih-prompt
Jika ini ditetapkan untuk lalai tag, nilainya akan dipaparkan semasa menu
pemilihan (lihat menu gaya di atas) apabila senarai penyiapan tidak sesuai pada
skrin secara keseluruhan. Melarikan diri yang sama seperti untuk segera senarai gaya difahami,
kecuali bahawa nombor merujuk pada padanan atau garisan tanda itu. lalai
prompt digunakan apabila nilainya ialah rentetan kosong.

pilih-skrol
Gaya ini diuji untuk lalai teg dan menentukan cara senarai penyelesaian
ditatal semasa pemilihan menu (lihat bahagian menu gaya di atas) apabila siap
senarai tidak muat pada skrin secara keseluruhan. Jika nilainya ialah `0' (sifar), senarai
ditatal oleh separuh skrin penuh; jika ia adalah integer positif, senarai itu ditatal
dengan bilangan baris yang diberikan; jika ia adalah nombor negatif, senarai itu ditatal dengan a
screenful tolak nilai mutlak bilangan baris yang diberikan. Lalainya ialah
tatal mengikut satu baris.

bahagian berasingan
Gaya ini digunakan dengan manual tag apabila melengkapkan nama halaman manual. Jika
ia adalah `benar', entri untuk bahagian yang berbeza ditambah secara berasingan menggunakan nama tag
daripada bentuk `Buku panduan.X', di mana X ialah nombor bahagian. Apabila nama kumpulan gaya
juga berkuat kuasa, halaman daripada bahagian yang berbeza akan muncul secara berasingan. ini
gaya juga digunakan sama dengan perkataan gaya semasa melengkapkan perkataan untuk
perintah dict. Ia membenarkan perkataan daripada pangkalan data kamus yang berbeza ditambah
secara berasingan. Lalai untuk gaya ini ialah `palsu'.

menunjukkan-kekaburan
Jika zsh/complist modul dimuatkan, gaya ini boleh digunakan untuk menyerlahkan yang pertama
watak samar-samar dalam senarai penyiapan. Nilai itu sama ada petunjuk warna
seperti yang disokong oleh senarai-warna gaya atau, dengan nilai `benar', a
lalai garis bawah dipilih. Sorotan hanya digunakan jika
rentetan paparan penyiapan sepadan dengan padanan sebenar.

pelengkap persembahan
Diuji apabila pelengkap baharu dicuba. Jika `benar', sistem penyiapan
mengeluarkan mesej kemajuan dalam kawasan penyenaraian yang menunjukkan apa yang sedang dilengkapkan
mencuba. Mesej akan ditimpa oleh mana-mana output apabila pelengkap ditemui
dan dikeluarkan selepas siap selesai.

tunggal diabaikan
Ini digunakan oleh _diabaikan lebih lengkap apabila hanya terdapat satu perlawanan. Jika nilainya
ialah `Menunjukkan', padanan tunggal akan dipaparkan tetapi tidak dimasukkan. Jika nilainya ialah
`menu', maka padanan tunggal dan rentetan asal kedua-duanya ditambah sebagai padanan dan
penyiapan menu dimulakan, menjadikannya mudah untuk memilih salah satu daripadanya.

jenis Banyak widget penyiapan memanggil _penerangan pada satu ketika yang menentukan sama ada
padanan ditambah diisih atau tidak diisih (selalunya secara tidak langsung melalui _mahu or _diminta).
Gaya ini boleh ditetapkan secara eksplisit kepada salah satu nilai `benar' atau `palsu' biasa sebagai
mengatasi. Jika ia tidak ditetapkan untuk konteks, tingkah laku standard panggilan
widget digunakan.

Gaya diuji terlebih dahulu terhadap konteks penuh termasuk teg, dan jika itu
gagal menghasilkan nilai terhadap konteks tanpa teg.

Jika widget panggilan secara eksplisit meminta padanan yang tidak diisih, ini biasanya
dihormati. Walau bagaimanapun, tingkah laku lalai (tidak diisih) penyiapan untuk arahan
sejarah mungkin ditindih dengan menetapkan gaya kepada `benar'.

Dalam _mengembangkan lebih lengkap, jika ia ditetapkan kepada `benar', pengembangan yang dijana akan
sentiasa disusun. Jika ia ditetapkan kepada `menu', maka pengembangan hanya diisih apabila
ia ditawarkan sebagai rentetan tunggal tetapi tidak dalam rentetan yang mengandungi semua yang mungkin
pengembangan.

pengarah khas
Biasanya, kod penyiapan tidak akan menghasilkan nama direktori `.' dan `..' sebagai
kemungkinan siap. Jika gaya ini ditetapkan kepada `benar', ia akan menambah kedua-duanya `.'dan
`..' sebaik mungkin selesai; jika ia ditetapkan kepada `..', hanya `..' akan ditambah.

Contoh berikut set pengarah khas kepada `..' apabila awalan semasa kosong,
adalah satu `.', atau hanya terdiri daripada laluan yang bermula dengan `../'. Jika tidak
nilai adalah `palsu'.

zstyle -e ':selesai:*' pengarah khas \
'[[ $PREFIX = (../)#(|.|..) ]] && balas=(..)'

picit-slash
Jika ditetapkan kepada `true', jujukan garis miring dalam laluan nama fail (contohnya dalam
`foo // bar') akan dianggap sebagai satu garis miring. Ini adalah tingkah laku biasa UNIX
laluan. Walau bagaimanapun, secara lalai fungsi penyiapan fail berkelakuan seolah-olah terdapat a
`*' antara garis miring.

berhenti Jika ditetapkan kepada `true', the _sejarah_perkataan_lengkap arahan bindable akan berhenti sekali apabila
mencapai permulaan atau penghujung sejarah. Menyeru _sejarah_perkataan_lengkap akan
kemudian bungkus ke hujung sejarah yang bertentangan. Jika gaya ini ditetapkan kepada
`palsu' (lalai), _sejarah_perkataan_lengkap akan gelung serta-merta seperti dalam menu
selesai.

strip-komen
Jika ditetapkan kepada `true', gaya ini menyebabkan teks ulasan yang tidak penting dialih keluar daripadanya
perlawanan penyempurnaan. Pada masa ini ia hanya digunakan apabila melengkapkan alamat e-mel
di mana ia mengalih keluar sebarang nama paparan daripada alamat, mengurangkannya kepada biasa
pengguna@hos bentuk.

subst-globs-sahaja
Ini digunakan oleh _mengembangkan pelengkap. Jika ia ditetapkan kepada `benar', pengembangan akan
hanya boleh digunakan jika ia terhasil daripada globbing; oleh itu, jika pengembangan terhasil daripada
menggunakan pengganti gaya yang diterangkan di bawah, tetapi ini tidak diubah lagi oleh
globbing, pengembangan akan ditolak.

Lalai untuk gaya ini ialah `palsu'.

pengganti
Gaya boolean ini mengawal sama ada _mengembangkan pelengkap akan cuba mengembangkan dahulu
semua penggantian dalam rentetan (seperti `$(...)' dan `${...}').

Lalai adalah `benar'.

akhiran Ini digunakan oleh _mengembangkan pelengkap jika perkataan bermula dengan tilde atau mengandungi a
pengembangan parameter. Jika ia ditetapkan kepada `benar', perkataan itu hanya akan dikembangkan jika ia
tidak mempunyai akhiran, iaitu jika ia adalah sesuatu seperti `~foo' atau `$foo' bukannya
`~foo/' atau `$foo/bar', melainkan akhiran itu sendiri mengandungi aksara yang layak untuk
pengembangan. Lalai untuk gaya ini ialah `benar'.

perintah tag
Ini menyediakan mekanisme untuk mengisih cara teg tersedia dalam sesuatu tertentu
konteks akan digunakan.

Nilai untuk gaya ialah set senarai teg yang diasingkan ruang. Tag dalam
setiap nilai akan dicuba pada masa yang sama; jika tiada padanan ditemui, nilai seterusnya ialah
digunakan. (Lihat corak fail gaya untuk pengecualian kepada tingkah laku ini.)

Sebagai contoh:

zstyle ':completion:*:complete:-command-:*:*' perintah tag \
'perintah fungsi'

menentukan bahawa penyiapan dalam kedudukan arahan terlebih dahulu menawarkan arahan luaran dan
fungsi cangkang. Baki teg akan dicuba jika tiada pelengkap ditemui.

Selain nama teg, setiap rentetan dalam nilai mungkin mengambil salah satu daripada yang berikut
borang:

- Jika mana-mana nilai hanya terdiri daripada tanda sempang, maka hanyalah tag yang dinyatakan dalam
nilai lain dijana. Biasanya semua teg yang tidak dipilih secara eksplisit adalah
cuba terakhir jika teg yang ditentukan gagal menjana sebarang padanan. Ini bermaksud
bahawa satu nilai yang hanya terdiri daripada satu tanda sempang mematikan penyiapan.

! tags...
Rentetan yang bermula dengan tanda seru menentukan nama tag yang
tidak untuk digunakan. Kesannya adalah sama seperti semua tag lain yang mungkin untuk
konteks telah disenaraikan.

tag:label ...
Di sini, tag adalah salah satu daripada tag standard dan label adalah nama sewenang-wenangnya.
Padanan dijana seperti biasa tetapi namanya label digunakan dalam konteks
bukan tag. Ini tidak berguna dalam perkataan bermula dengan !.

Jika label bermula dengan tanda sempang, the tag adalah prepended kepada label untuk membentuk
nama yang digunakan untuk mencari. Ini boleh digunakan untuk membuat sistem penyiapan
cuba teg tertentu lebih daripada sekali, membekalkan tetapan gaya yang berbeza untuk
setiap percubaan; lihat di bawah untuk contoh.

tag:label:Penerangan
Seperti dahulu, tetapi Penerangan akan menggantikan `%d' dalam nilai format
gaya dan bukannya perihalan lalai yang dibekalkan oleh penyiapan
fungsi. Ruang dalam huraian mesti dipetik dengan garis miring ke belakang. A
`%d' muncul dalam Penerangan digantikan dengan penerangan yang diberikan oleh
fungsi penyiapan.

Dalam mana-mana borang di atas teg mungkin corak atau beberapa corak dalam borang
`{pat1,tepuk2...}'. Dalam kes ini semua tag yang sepadan akan digunakan kecuali untuk mana-mana yang diberikan
secara eksplisit dalam rentetan yang sama.

Satu penggunaan ciri ini adalah untuk mencuba satu teg lebih daripada sekali, menetapkan gaya lain
berbeza pada setiap percubaan, tetapi masih menggunakan semua tag lain tanpa perlu
ulangi semuanya. Sebagai contoh, untuk melengkapkan nama fungsi dalam arahan
kedudukan mengabaikan semua fungsi penyiapan bermula dengan garis bawah yang pertama
masa siap dicuba:

zstyle ':completion:*:*:-command-:*:*' perintah tag \
'fungsi:-bukan-komp *' fungsi
zstyle ':completion:*:functions-non-comp' \
corak-abaikan '_*'

Pada percubaan pertama, semua tag akan ditawarkan tetapi fungsi tag akan menjadi
digantikan oleh fungsi-bukan-komp. Yang corak-abaikan gaya ditetapkan untuk tag ini
kecualikan fungsi bermula dengan garis bawah. Jika tiada perlawanan, yang kedua
nilai perintah tag gaya digunakan yang melengkapkan fungsi menggunakan lalai
tag, kali ini mungkin termasuk semua nama fungsi.

Padanan untuk satu tag boleh dibahagikan kepada kumpulan yang berbeza. Sebagai contoh:

zstyle ':selesai:*' perintah tag \
'pilihan:-panjang:panjang\ pilihan
pilihan:-short:short\ pilihan
pilihan:-huruf tunggal: tunggal\ surat\ pilihan'
zstyle ':completion:*:options-long' \
corak-abaikan '[-+](|-|[^-]*)'
zstyle ':completion:*:options-short' \
corak-abaikan '--*' '[-+]?'
zstyle ':completion:*:options-single-letter' \
corak-abaikan '???*'

Dengan nama kumpulan set gaya, pilihan bermula dengan `--', pilihan bermula dengan
satu `-' atau `+' tetapi mengandungi berbilang aksara, dan pilihan huruf tunggal
akan dipaparkan dalam kumpulan berasingan dengan penerangan yang berbeza.

Penggunaan corak lain adalah untuk mencuba beberapa spesifikasi padanan satu demi satu.
. senarai padanan gaya menawarkan sesuatu yang serupa, tetapi ia diuji sangat awal dalam
sistem penyiapan dan oleh itu tidak boleh ditetapkan untuk arahan tunggal atau untuk lebih khusus
konteks. Berikut ialah cara untuk mencuba penyiapan biasa tanpa sebarang spesifikasi padanan
dan, jika itu tidak menghasilkan padanan, cuba lagi dengan padanan tidak sensitif huruf besar-besaran,
mengehadkan kesan kepada hujah perintah foo:

zstyle ':penyelesaian:*:*:foo:*:*' perintah tag '*' '*:-kes'
zstyle ':penyelesaian:*-kes' jodoh 'm:{az}={AZ}'

Pertama, semua teg yang ditawarkan apabila melengkapkan selepas itu foo dicuba menggunakan yang biasa
tag nama. Jika itu tidak menghasilkan padanan, nilai kedua bagi perintah tag digunakan,
yang mencuba semua tag sekali lagi kecuali kali ini masing-masing mempunyai -kad dilampirkan padanya
nama untuk mencari gaya. Oleh itu kali ini nilai untuk jodoh gaya dari
panggilan kedua ke zstyle dalam contoh digunakan untuk membuat penyelesaian
huruf besar tidak sensitif.

Ia adalah mungkin untuk menggunakan -e pilihan untuk zstyle arahan terbina untuk ditentukan
syarat untuk penggunaan tag tertentu. Sebagai contoh:

zstyle -e '*:-perintah-:*' perintah tag '
if [[ -n $PREFIX$SUFFIX ]]; kemudian
balas=( )
lagi
balas=( - )
fi'

Penyiapan dalam kedudukan arahan akan dicuba hanya jika rentetan yang ditaip setakat ini adalah
tidak kosong. Ini diuji menggunakan PERMULAAN parameter khas; lihat zshcompwid untuk a
perihalan parameter yang khas dalam widget penyiapan. Tetapan
membalas kepada tatasusunan kosong menyediakan tingkah laku lalai untuk mencuba semua teg sekaligus;
menetapkannya kepada tatasusunan yang mengandungi hanya tanda sempang melumpuhkan penggunaan semua tag dan
oleh itu semua penyiapan.

Jika tidak perintah tag gaya telah ditakrifkan untuk konteks, rentetan `(|*-)hujah-*
(|*-)pilihan-* nilai' dan `pilihan' serta semua tag yang ditawarkan oleh penyiapan
fungsi akan digunakan untuk menyediakan tingkah laku lalai yang wajar yang menyebabkan hujah
(sama ada hujah perintah biasa atau hujah pilihan) untuk dilengkapkan sebelum ini
nama pilihan untuk kebanyakan arahan.

url Ini digunakan bersama-sama dengan url tag mengikut fungsi melengkapkan URL.

Jika nilai terdiri daripada lebih daripada satu rentetan, atau jika satu-satunya rentetan tidak menamakan
fail atau direktori, rentetan digunakan sebagai URL untuk dilengkapkan.

Jika nilai mengandungi hanya satu rentetan yang merupakan nama fail biasa URL
diambil daripada fail tersebut (di mana URL mungkin dipisahkan oleh ruang putih atau
baris baharu).

Akhir sekali, jika satu-satunya rentetan dalam nilai menamakan direktori, hierarki direktori
berakar pada direktori ini memberikan penyiapan. Direktori peringkat atas sepatutnya
kaedah capaian fail, seperti `http', `ftp', `bookmark' dan sebagainya. Dalam banyak kes
peringkat direktori seterusnya ialah nama fail. Hierarki direktori boleh
turun sedalam yang perlu.

Sebagai contoh,

zstyle ':selesai:*' url ~/.urls
mkdir -p ~/.urls/ftp/ftp.zsh.org/pub

membenarkan penyiapan semua komponen URL ftp://ftp.zsh.org/pub selepas
perintah yang sesuai seperti `netscape' atau `Lynx'. Walau bagaimanapun, ambil perhatian bahawa kaedah akses
dan fail dilengkapkan secara berasingan, jadi jika fail tuan rumah gaya ditetapkan hos boleh
diselesaikan tanpa merujuk kepada url gaya.

Lihat penerangan dalam fungsi _url sendiri untuk mendapatkan maklumat lanjut (cth `lebih
$^fpath/_urls(N)').

guna-cache
Jika ini ditetapkan, lapisan caching siap diaktifkan untuk sebarang penyiapan yang
gunakannya (melalui _store_cache, _mendapatkan_cache, dan _cache_invalid fungsi). The
direktori yang mengandungi fail cache boleh ditukar dengan laluan cache gaya.

use-compctl
Jika gaya ini ditetapkan kepada rentetan tidak sama dengan palsu, 0, tidak, dan off, penyiapan
sistem boleh menggunakan sebarang spesifikasi penyiapan yang ditakrifkan dengan compctl dibina
perintah. Jika gaya tidak ditetapkan, ini hanya dilakukan jika zsh/compctl modul ialah
dimuatkan. Rentetan juga mungkin mengandungi subrentetan `pertama' untuk menggunakan penyiapan
ditakrifkan dengan `compctl -T', dan subrentetan `lalai' untuk menggunakan penyiapan
ditakrifkan dengan `compctl -D'.

Ambil perhatian bahawa ini hanya bertujuan untuk melicinkan peralihan daripada compctl kepada yang baru
sistem penyiapan dan mungkin hilang pada masa hadapan.

Perhatikan juga bahawa definisi dari compctl hanya akan digunakan jika tiada
fungsi penyiapan khusus untuk arahan berkenaan. Sebagai contoh, jika ada
satu fungsi _foo untuk melengkapkan hujah kepada arahan foo, compctl tidak akan pernah
diseru untuk foo. Walau bagaimanapun compctl versi akan dicuba jika foo hanya menggunakan
penyiapan lalai.

use-ip Secara lalai, fungsi _tuan rumah yang melengkapkan nama hos jalur alamat IP daripada
entri dibaca daripada pangkalan data hos seperti fail NIS dan ssh. Jika gaya ini
`true', alamat IP yang sepadan boleh dilengkapkan juga. Gaya ini tidak
gunakan dalam mana-mana konteks di mana tuan rumah gaya ditetapkan; ambil perhatian juga ia mesti ditetapkan sebelum
cache nama hos dijana (biasanya percubaan penyiapan pertama).

pengguna Ini mungkin ditetapkan kepada senarai nama pengguna untuk dilengkapkan. Jika tidak ditetapkan semua
nama pengguna akan dilengkapkan. Ambil perhatian bahawa jika ia ditetapkan hanya senarai pengguna yang akan
diselesaikan; ini kerana pada sesetengah sistem yang membuat pertanyaan semua pengguna boleh mengambil a
jumlah masa yang terlarang.

hos pengguna
Nilai gaya ini hendaklah dalam bentuk `pengguna@tuan rumah' atau `pengguna:tuan rumah'. Ia adalah
digunakan untuk arahan yang memerlukan pasangan nama pengguna dan hos. Perintah ini akan
lengkapkan nama pengguna dari gaya ini (sahaja), dan akan menyekat nama hos berikutnya
penyiapan kepada hos yang digandingkan dengan pengguna tersebut dalam salah satu nilai gaya.

Adalah mungkin untuk mengumpulkan nilai untuk set arahan yang membenarkan log masuk jauh,
seperti log masuk and ssh, dengan menggunakan akaun saya tag. Begitu juga, nilai untuk set
perintah yang biasanya merujuk kepada akaun orang lain, seperti bercakap and
jari, boleh dikumpulkan dengan menggunakan lain-akaun tag. Perintah yang lebih ambivalen
boleh menggunakan akaun tag.

pengguna-hos-port
suka hos pengguna tetapi digunakan untuk arahan seperti telnet dan mengandungi rentetan daripada
bentuk `pengguna@tuan rumah:pelabuhan'.

kata kerja
Jika ditetapkan, seperti yang ditetapkan secara lalai, penyenaraian penyiapan adalah lebih bertele-tele. khususnya
banyak arahan menunjukkan penerangan untuk pilihan jika gaya ini adalah `benar'.

perkataan Ini digunakan oleh _senarai pelengkap, yang menghalang penyisipan penyiapan
sehingga percubaan penyiapan kedua apabila baris tidak berubah. Cara biasa
mengetahui sama ada baris telah berubah adalah untuk membandingkan keseluruhan kandungannya antara
dua kali. Jika gaya ini `benar', perbandingan sebaliknya dilakukan sahaja
pada perkataan semasa. Oleh itu jika penyiapan dilakukan pada perkataan lain dengan
kandungan yang sama, penyiapan tidak akan ditangguhkan.

KAWALAN FUNGSI

Skrip permulaan compinit mentakrifkan semula semua widget yang melakukan penyiapan
panggil fungsi widget yang dibekalkan _utama_lengkap. Fungsi ini bertindak sebagai panggilan pembalut
fungsi yang dipanggil `pelengkap' yang menjana padanan. Jika _utama_lengkap dipanggil
dengan hujah, ini diambil sebagai nama fungsi pelengkap untuk dipanggil dalam
pesanan diberi. Jika tiada hujah diberikan, set fungsi untuk dicuba diambil daripada
pelengkap gaya. Contohnya, gunakan penyiapan dan pembetulan biasa jika tidak
menjana sebarang padanan:

zstyle ':selesai:*' pelengkap _lengkap _betul

selepas memanggil compinit. Nilai lalai untuk gaya ini ialah `_lengkap _diabaikan', iaitu
biasanya hanya penyiapan biasa sahaja yang dicuba, pertama dengan kesan corak-abaikan
gaya dan kemudian tanpanya. The _utama_lengkap fungsi menggunakan status pulangan
pelengkap berfungsi untuk memutuskan sama ada pelengkap lain perlu dipanggil. Jika status pulangan
adalah sifar, tiada pelengkap lain dicuba dan _utama_lengkap fungsi kembali.

Jika hujah pertama ke _utama_lengkap adalah satu tanda sempang, hujah tidak akan menjadi
diambil sebagai nama pelengkap. Sebaliknya, hujah kedua memberikan nama untuk digunakan dalam
pelengkap medan konteks dan argumen lain memberikan nama perintah dan argumen
untuk memanggil untuk menjana perlawanan.

Fungsi pelengkap berikut terkandung dalam pengedaran, walaupun pengguna mungkin
tulis sendiri. Ambil perhatian bahawa dalam konteks, garis bawah utama dilucutkan, sebagai contoh
penyiapan asas dilakukan dalam konteks `:complete::complete:...'.

_semua_perlawanan
Pelengkap ini boleh digunakan untuk menambah rentetan yang terdiri daripada semua padanan lain. Kerana ia
mempengaruhi pelengkap kemudian ia mesti muncul sebagai pelengkap pertama dalam senarai. The
senarai semua perlawanan dipengaruhi oleh elak-lengkap and perlawanan lama gaya
diterangkan di atas.

Ia mungkin berguna untuk menggunakan _generik fungsi yang diterangkan di bawah untuk mengikat _semua_perlawanan
kepada ketukan kekuncinya sendiri, sebagai contoh:

lihat -C semua perlawanan perkataan lengkap _generik
bindkey '^Xa' semua perlawanan
zstyle ':completion:semua perlawanan:*' perlawanan lama hanyalah
zstyle ':completion:semua perlawanan::::' pelengkap _semua_perlawanan

Ambil perhatian bahawa ini tidak menjana penyiapan dengan sendirinya: mula-mula gunakan mana-mana
cara standard untuk menjana senarai penyiapan, kemudian gunakan ^Xa untuk menunjukkan semua
perlawanan. Anda boleh menambah pelengkap standard pada senarai dan
meminta senarai semua perlawanan hendaklah dimasukkan terus:

zstyle ':completion:semua perlawanan::::' pelengkap \
_semua_perlawanan _lengkap
zstyle ':completion:semua perlawanan:*' memasukkan benar

Dalam kes ini perlawanan lama gaya tidak sepatutnya ditetapkan.

_anggaran
Ini serupa dengan asas _lengkap lebih lengkap tetapi membenarkan penyiapan untuk
menjalani pembetulan. Bilangan maksimum ralat boleh ditentukan oleh
ralat maksimum gaya; lihat huraian anggaran padanan dalam zshexpn(1) untuk bagaimana
kesilapan dikira. Biasanya pelengkap ini hanya akan dicuba selepas biasa
_lengkap pelengkap:

zstyle ':selesai:*' pelengkap _lengkap _anggaran

Ini akan memberikan penyiapan pembetulan jika dan hanya jika penyiapan biasa menghasilkan tidak
kemungkinan siap. Apabila penyiapan yang diperbetulkan ditemui, pelengkap akan
biasanya memulakan penyiapan menu yang membolehkan anda mengitar rentetan ini.

Pelengkap ini menggunakan tag pembetulan and asal apabila menjana yang mungkin
pembetulan dan rentetan asal. The format gaya untuk bekas mungkin mengandungi
urutan tambahan `%e' dan `%o' yang akan digantikan dengan bilangan
ralat diterima untuk menghasilkan pembetulan dan rentetan asal, masing-masing.

Pelengkap secara beransur-ansur meningkatkan bilangan ralat yang dibenarkan sehingga had
oleh ralat maksimum gaya, oleh itu jika penyiapan ditemui dengan satu ralat, tidak
penyiapan dengan dua ralat akan ditunjukkan, dan seterusnya. Ia mengubah suai pelengkap
nama dalam konteks untuk menunjukkan bilangan ralat yang sedang dicuba: pada percubaan pertama
medan yang lebih lengkap mengandungi `anggaran-1', pada percubaan kedua `anggaran-2',
dan sebagainya.

Bila _anggaran dipanggil dari fungsi lain, bilangan ralat untuk diterima
boleh diluluskan dengan -a pilihan. Hujah adalah dalam format yang sama seperti
ralat maksimum gaya, semuanya dalam satu rentetan.

Ambil perhatian bahawa pelengkap ini (dan _betul pelengkap yang dinyatakan di bawah) boleh agak
mahal untuk dihubungi, terutamanya apabila sejumlah besar ralat dibenarkan. Sehala
untuk mengelakkan ini adalah untuk menyediakan pelengkap gaya menggunakan -e pilihan untuk zstyle jadi
bahawa sesetengah pelengkap hanya digunakan apabila penyiapan cuba untuk kali kedua
rentetan yang sama, cth:

zstyle -e ':selesai:*' pelengkap '
if [[ $_percubaan_terakhir != "$HISTNO$BUFFER$CURSOR" ]]; kemudian
_last_try="$HISTNO$BUFFER$CURSOR"
reply=(_complete _perlawanan _awalan)
lagi
reply=(_diabaikan _betul _anggaran)
fi'

Ini menggunakan HISTNO parameter dan PENAPI and KURSOR parameter khas yang
tersedia di dalam zle dan widget penyiapan untuk mengetahui sama ada baris arahan
tidak berubah sejak kali terakhir penyiapan dicuba. Hanya selepas itu
_diabaikan, _betul and _anggaran pelengkap dipanggil.

_lengkap
Pelengkap ini menjana semua kemungkinan penyiapan dalam cara yang sensitif konteks,
iaitu menggunakan tetapan yang ditakrifkan dengan compdef fungsi yang dijelaskan di atas dan
tetapan semasa semua parameter khas. Ini memberikan penyiapan biasa
tingkah laku.

Untuk melengkapkan hujah perintah, _lengkap menggunakan fungsi utiliti _biasa,
yang seterusnya bertanggungjawab untuk mencari fungsi tertentu; ia diterangkan
di bawah. Pelbagai konteks bentuk -konteks- dikendalikan secara khusus. Ini adalah
semua yang disebutkan di atas sebagai hujah yang mungkin kepada #compdef tag.

Sebelum cuba mencari fungsi untuk konteks tertentu, _lengkap memeriksa sama ada
parameter `konteks ringkas' ditetapkan. Tetapan `konteks ringkas' membolehkan penyiapan biasa
penghantaran untuk ditindih yang berguna di tempat seperti fungsi yang menggunakan
berbeza untuk input. Jika ia ditetapkan kepada tatasusunan, unsur-unsur diambil sebagai
kemungkinan padanan yang akan diselesaikan menggunakan tag `nilai' dan huraian
`nilai'. Jika ia ditetapkan kepada tatasusunan bersekutu, kekunci digunakan sebagai yang mungkin
penyiapan dan nilai (jika tidak kosong) digunakan sebagai penerangan untuk padanan.
Jika `konteks ringkas' ditetapkan kepada rentetan yang mengandungi titik bertindih, ia mestilah dalam bentuk
`tag:penghuraian:tindakan'. Dalam kes ini tag and penghuraian berikan tag dan penerangan kepada
menggunakan dan tindakan menunjukkan apa yang perlu diisi dalam salah satu borang yang diterima
oleh _hujah fungsi utiliti yang diterangkan di bawah.

Akhirnya, jika `konteks ringkas' ditetapkan kepada rentetan tanpa titik bertindih, nilai diambil sebagai
nama konteks untuk digunakan dan fungsi yang ditakrifkan untuk konteks itu ialah
dipanggil. Untuk tujuan ini, terdapat konteks khas yang dinamakan -baris-perintah- Bahawa
melengkapkan keseluruhan baris arahan (arahan dan hujahnya). Ini tidak digunakan oleh
sistem penyiapan itu sendiri tetapi tetap dikendalikan apabila dipanggil secara eksplisit.

_betul
Hasilkan pembetulan, tetapi bukan penyempurnaan, untuk perkataan semasa; ini serupa dengan
_anggaran tetapi tidak akan membenarkan sebarang bilangan aksara tambahan pada kursor sebagai
pelengkap itu lakukan. Kesannya serupa dengan penyemakan ejaan. Ia berdasarkan
_anggaran, tetapi medan yang lebih lengkap dalam nama konteks ialah membetulkan.

Contohnya, dengan:

zstyle ':selesai:::::' pelengkap \
_lengkap _betul _anggaran
zstyle ':penyelesaian:*:betul:::' ralat maksimum 2 bukan angka
zstyle ':penyelesaian:*:anggaran:::' ralat maksimum 3 angka

pembetulan akan menerima sehingga dua ralat. Jika hujah berangka diberikan,
pembetulan tidak akan dilakukan, tetapi penyelesaian pembetulan akan, dan akan
terima seberapa banyak ralat seperti yang diberikan oleh hujah berangka. Tanpa angka
hujah, pembetulan pertama dan kemudian pembetulan penyelesaian akan dicuba, dengan
yang pertama menerima dua kesalahan dan yang kedua menerima tiga kesalahan.

Bila _betul dipanggil sebagai fungsi, bilangan ralat untuk diterima boleh diberikan
berikutan -a pilihan. Hujah adalah dalam bentuk yang sama nilai kepada menerima
gaya, semuanya dalam satu rentetan.

Fungsi pelengkap ini bertujuan untuk digunakan tanpa _anggaran pelengkap
atau, seperti dalam contoh, sebelum itu. Menggunakannya selepas _anggaran pelengkap
tidak berguna sejak _anggaran sekurang-kurangnya akan menjana rentetan yang diperbetulkan
dihasilkan oleh _betul pelengkap -- dan mungkin lebih.

_mengembangkan
Fungsi pelengkap ini tidak benar-benar melaksanakan penyiapan, sebaliknya menyemak jika
perkataan pada baris arahan layak untuk pengembangan dan, jika ada, memberi
kawalan terperinci ke atas cara pengembangan ini dilakukan. Untuk ini berlaku, pihak
sistem penyiapan perlu digunakan dengan perkataan lengkap, Tidak kembangkan-atau-lengkap
(ikatan lalai untuk TAB), kerana jika tidak, rentetan akan dikembangkan oleh
mekanisme dalaman shell sebelum sistem penyiapan dimulakan. Perhatikan juga ini
pelengkap hendaklah dipanggil sebelum _lengkap fungsi yang lebih lengkap.

Teg yang digunakan semasa menjana pengembangan ialah semua-pengembangan untuk rentetan
mengandungi semua kemungkinan pengembangan, pengembangan apabila menambah kemungkinan pengembangan
sebagai perlawanan tunggal dan asal apabila menambah rentetan asal daripada baris. The
susunan rentetan ini dijana, jika ada, boleh dikawal oleh
susunan kumpulan and perintah tag gaya, seperti biasa.

Rentetan format untuk semua-pengembangan dan untuk pengembangan mungkin mengandungi urutan
`%o' yang akan digantikan dengan rentetan asal dari baris.

Jenis pengembangan yang akan dicuba dikawal oleh pengganti, epal and
subst-globs-sahaja gaya.

Ia juga boleh menghubungi _mengembangkan sebagai fungsi, dalam hal ini berbeza
mod boleh dipilih dengan pilihan: -s khususnya pengganti, -g khususnya epal and -o khususnya
subst-globs-sahaja.

_expand_alias
Jika perkataan kursor dihidupkan ialah alias, ia dikembangkan dan tiada pelengkap lain
dipanggil. Jenis alias yang akan dikembangkan boleh dikawal dengan
gaya-gaya kerap, global and orang kurang upaya.

Fungsi ini juga merupakan arahan yang boleh diikat, lihat bahagian `Arahan Boleh Diikat'
di bawah.

_sambungan
Jika kursor mengikut rentetan `*.', sambungan nama fail selesai. The
sambungan diambil daripada fail dalam direktori semasa atau direktori yang ditentukan di
permulaan perkataan semasa. Untuk padanan tepat, penyiapan terus membenarkan
pelengkap lain seperti _mengembangkan untuk mengembangkan corak. Piawaian tambah-ruang and
awalan-tersembunyi gaya diperhatikan.

_sejarah
Lengkapkan perkataan daripada sejarah arahan shell. Pelengkap ini boleh dikawal
oleh keluarkan-semua-dups, dan jenis gaya seperti untuk _sejarah_perkataan_lengkap boleh diikat
arahan, lihat bahagian `Arahan Boleh Diikat' di bawah dan bahagian `Penyelesaian
Konfigurasi Sistem' di atas.

_diabaikan
. corak-abaikan gaya boleh ditetapkan kepada senarai corak yang dibandingkan
terhadap kemungkinan penyiapan; yang sepadan dikeluarkan. Dengan pelengkap ini mereka
perlawanan boleh dikembalikan semula, seolah-olah tidak corak-abaikan gaya telah ditetapkan. Pelengkap
sebenarnya menjana senarai padanannya sendiri; pelengkap yang dipanggil ialah
ditentukan dengan cara yang sama seperti untuk _awalan pelengkap. The tunggal diabaikan gaya
juga tersedia seperti yang diterangkan di atas.

_senarai Pelengkap ini membolehkan pemasukan padanan ditangguhkan sehingga siap
cuba buat kali kedua tanpa perkataan di talian ditukar. Pada yang pertama
percubaan, hanya senarai perlawanan akan ditunjukkan. Ia dipengaruhi oleh gaya
keadaan and perkataan, lihat bahagian `Konfigurasi Sistem Penyiapan' di atas.

_perlawanan Pelengkap ini bertujuan untuk digunakan selepas _lengkap pelengkap. Ia berkelakuan
begitu juga tetapi rentetan pada baris arahan mungkin merupakan corak untuk dipadankan
selesai percubaan. Ini memberikan kesan daripada GLOB_COMPLETE pilihan.

Biasanya penyiapan akan dilakukan dengan mengambil corak dari garisan,
memasukkan `*' pada kedudukan kursor dan membandingkan corak yang terhasil dengan
kemungkinan penyiapan yang dihasilkan. Ini boleh diubah suai dengan padan-asli gaya
diterangkan di atas.

Padanan yang dihasilkan akan ditawarkan dalam pelengkapan menu melainkan jika
sisip-tidak jelas gaya ditetapkan kepada `benar'; lihat penerangan di atas untuk yang lain
pilihan untuk gaya ini.

Ambil perhatian bahawa spesifikasi pemadan ditakrifkan secara global atau digunakan oleh penyiapan
fungsi (gaya senarai padanan and jodoh) tidak akan digunakan.

_menu Pelengkap ini ditulis sebagai fungsi contoh mudah untuk menunjukkan cara penyiapan menu
boleh didayakan dalam kod shell. Walau bagaimanapun, ia mempunyai kesan ketara melumpuhkan menu
pemilihan yang boleh berguna dengan _generik widget berasaskan. Ia harus digunakan sebagai
pelengkap pertama dalam senarai. Ambil perhatian bahawa ini adalah bebas daripada tetapan
MENU_COMPLETE pilihan dan tidak berfungsi dengan widget penyiapan menu lain seperti
as terbalik-menu-lengkap, Atau terima-dan-menu-lengkap.

_senarai lama
Pelengkap ini mengawal cara widget penyelesaian standard berkelakuan apabila terdapat
senarai siap sedia ada yang mungkin telah dijana oleh penyiapan khas
(iaitu perintah penyiapan terikat berasingan). Ia membolehkan penyiapan biasa
kunci untuk terus menggunakan senarai penyiapan yang dijana, bukannya
menghasilkan senarai baharu penyiapan kontekstual biasa. Ia sepatutnya muncul dalam
senarai pelengkap sebelum mana-mana widget yang menjana padanan. Ia menggunakan dua
gaya: senarai lama and menu lama, lihat bahagian `Tatarajah Sistem Penyiapan'
atas.

_awalan
Pelengkap ini boleh digunakan untuk mencuba pelengkapan dengan akhiran (semuanya selepas
kursor) diabaikan. Dalam erti kata lain, akhiran tidak akan dianggap sebagai sebahagian daripada
perkataan untuk melengkapkan. Kesannya serupa dengan awalan kembangkan-atau-lengkapkan
perintah.

. pelengkap gaya digunakan untuk menentukan pelengkap lain yang akan dipanggil
menjana perlawanan. Jika gaya ini tidak ditetapkan, senarai pelengkap ditetapkan untuk
konteks semasa digunakan -- kecuali, sudah tentu, _awalan penyempurna itu sendiri.
Tambahan pula, jika pelengkap ini muncul lebih daripada sekali dalam senarai pelengkap
hanya pelengkap yang belum mencuba dengan seruan terakhir _awalan akan
dipanggil.

Sebagai contoh, pertimbangkan global ini pelengkap gaya:

zstyle ':selesai:*' pelengkap \
_lengkap _awalan _betul _prefix:foo

Di sini, _awalan pelengkap mencuba penyiapan biasa tetapi mengabaikan akhiran. Jika
yang tidak menjana sebarang padanan, dan begitu juga panggilan ke _betul
lebih lengkap selepas itu, _awalan akan dipanggil kali kedua dan, kini hanya mencuba
pembetulan dengan akhiran diabaikan. Pada doa kedua bahagian yang lebih lengkap daripada
konteks muncul sebagai `foo'.

Untuk menggunakan _awalan sebagai pilihan terakhir dan cuba penyiapan biasa sahaja apabila sudah
dipanggil:

zstyle ':selesai:*' pelengkap _lengkap ... _awalan
zstyle ':completion::prefix:*' pelengkap _lengkap

. tambah-ruang gaya juga dihormati. Jika ia ditetapkan kepada `benar' maka _awalan akan
masukkan ruang antara padanan yang dihasilkan (jika ada) dan akhiran.

Ambil perhatian bahawa pelengkap ini hanya berguna jika COMPLETE_IN_WORD pilihan ditetapkan;
jika tidak, kursor akan dialihkan ke hujung perkataan semasa sebelum
kod pelengkap dipanggil dan oleh itu tidak akan ada akhiran.

_user_expand
Pelengkap ini berkelakuan serupa dengan _mengembangkan lebih lengkap tetapi sebaliknya melaksanakan
pengembangan yang ditakrifkan oleh pengguna. Gaya-gaya tambah-ruang and jenis gaya khusus untuk
_mengembangkan pelengkap boleh digunakan dengan _user_expand sebagai tambahan kepada gaya lain yang dikendalikan
lebih umum oleh sistem penyiapan. Tag itu semua-pengembangan juga disediakan.

Pengembangan bergantung pada gaya tatasusunan luaskan pengguna ditakrifkan untuk arus
konteks; ingat bahawa konteks untuk pelengkap adalah kurang khusus daripada itu untuk
penyiapan kontekstual kerana konteks penuh masih belum ditentukan. Elemen daripada
tatasusunan mungkin mempunyai salah satu daripada bentuk berikut:
$hash

hash ialah nama tatasusunan bersekutu. Perhatikan ini bukan parameter penuh
ungkapan, sekadar a $, dipetik sesuai untuk mengelakkan pengembangan segera,
diikuti dengan nama tatasusunan bersekutu. Jika perkataan pengembangan percubaan
sepadan dengan kunci masuk hash, pengembangan yang terhasil ialah nilai yang sepadan.
_func

_func ialah nama fungsi shell yang namanya mesti bermula dengan _ tetapi adalah
tidak sebaliknya istimewa kepada sistem penyiapan. Fungsi dipanggil dengan
perkataan percubaan sebagai hujah. Jika perkataan itu ingin dikembangkan, fungsinya
harus menetapkan tatasusunan membalas kepada senarai perluasan. Secara pilihan, ia boleh ditetapkan
MEMBUAT kepada perkataan yang akan digunakan sebagai penerangan untuk set
pengembangan. Status pemulangan fungsi tidak relevan.

BOLEH TERIKAT PERINTAH

Sebagai tambahan kepada penyiapan bergantung konteks yang disediakan, yang dijangka berfungsi
cara yang jelas secara intuitif, terdapat beberapa widget yang melaksanakan tingkah laku khas yang
boleh diikat secara berasingan pada kunci. Berikut ialah senarai ini dan lalainya
pengikatan.

_bash_completions
Fungsi ini digunakan oleh dua widget, _bash_complete-word and _bash_list-choices.
Ia wujud untuk menyediakan keserasian dengan pengikatan penyiapan dalam bash. Yang terakhir
watak pengikatan menentukan apa yang telah diselesaikan: `!', nama perintah; `$',
pembolehubah persekitaran; `@', nama hos; `/', nama fail; `~' nama pengguna. Dalam bash,
pengikatan didahului oleh `\e' memberikan penyelesaian, dan didahului oleh `^X' menyenaraikan pilihan.
Oleh kerana beberapa ikatan ini bertembung dengan ikatan zsh standard, hanya `\e~' dan `^X~'
terikat secara lalai. Untuk menambah selebihnya, perkara berikut harus ditambah kepada .zshrc
selepas compinit telah dijalankan:

khususnya utama in '!' '$' '@' '/' '~'; do
bindkey "\e$key" _bash_complete-word
bindkey "^X$key" _bash_list-choices
dilakukan

Ini termasuk pengikatan untuk `~' sekiranya mereka sudah terikat dengan sesuatu
lain; kod penyiapan tidak mengatasi pengikatan pengguna.

_correct_filename (^XC)
Betulkan laluan nama fail pada kedudukan kursor. Membenarkan sehingga enam ralat dalam
nama. Juga boleh dipanggil dengan hujah untuk membetulkan laluan nama fail,
bebas daripada zle; pembetulan dicetak pada output standard.

_perkataan_betul (^Xc)
Melakukan pembetulan hujah semasa menggunakan penyelesaian kontekstual biasa
pilihan yang mungkin. Ini menyimpan rentetan `perkataan yang betul' di dalam fungsi bidang
nama konteks dan kemudian memanggil _betul pelengkap.

_expand_alias (^Xa)
Fungsi ini boleh digunakan sebagai pelengkap dan sebagai arahan yang boleh diikat. Ia mengembangkan
perkataan kursor dihidupkan jika ia adalah alias. Jenis alias dikembangkan boleh
dikawal dengan gaya kerap, global and orang kurang upaya.

Apabila digunakan sebagai arahan boleh diikat terdapat satu ciri tambahan yang boleh
dipilih dengan menetapkan melengkapkan gaya kepada `benar'. Dalam kes ini, jika perkataan itu tidak
nama alias, _expand_alias cuba melengkapkan perkataan kepada nama alias penuh
tanpa mengembangkannya. Ia meninggalkan kursor terus selepas perkataan lengkap jadi
menyeru itu _expand_alias sekali lagi akan mengembangkan nama alias yang lengkap sekarang.

_luaskan_perkataan (^Xe)
Melakukan pengembangan pada perkataan semasa: setara dengan standard kembangkan-perkataan
arahan, tetapi menggunakan _mengembangkan pelengkap. Sebelum memanggilnya, yang fungsi bidang
konteks ditetapkan kepada `kembangkan-perkataan'.

_generik
Fungsi ini tidak ditakrifkan sebagai widget dan tidak terikat secara lalai. Walau bagaimanapun, ia boleh
digunakan untuk menentukan widget dan kemudian akan menyimpan nama widget dalam
fungsi medan konteks dan panggil sistem penyiapan. Ini membolehkan adat
widget siap dengan set tetapan gaya mereka sendiri untuk ditakrifkan dengan mudah. Untuk
contoh, untuk menentukan widget yang melakukan penyiapan biasa dan menu mula
pemilihan:

lihat -C foo perkataan lengkap _generik
bindkey '...' foo
zstyle ':completion:foo:*' menu yes pilih=1

Perhatikan khususnya bahawa pelengkap gaya boleh ditetapkan untuk konteks untuk
tukar set fungsi yang digunakan untuk menjana kemungkinan padanan. Jika _generik is
dipanggil dengan hujah-hujah, mereka diteruskan kepada _utama_lengkap sebagai senarai
pelengkap menggantikan yang ditakrifkan oleh pelengkap gaya.

_sejarah_perkataan_lengkap (\e/)
Lengkapkan perkataan daripada sejarah arahan shell. Ini menggunakan senarai,
keluarkan-semua-dups, jenis, dan berhenti gaya.

_fail_terkini (^Xm)
Lengkapkan nama fail yang paling baru diubah suai sepadan dengan corak pada
baris arahan (yang mungkin kosong). Jika diberi hujah angka N, lengkapkan Nth
fail yang paling baru diubah suai. Perhatikan penyiapan, jika ada, sentiasa unik.

_next_tags (^Xn)
Perintah ini mengubah set padanan yang digunakan untuk teg seterusnya, atau set
tag, sama ada seperti yang diberikan oleh perintah tag gaya atau seperti yang ditetapkan secara lalai; perlawanan ini
sebaliknya tidak akan tersedia. Seruan berturut-turut kitaran arahan
melalui semua set tag yang mungkin.

_read_comp (^X^R)
Gesa pengguna untuk rentetan, dan gunakan itu untuk melaksanakan penyiapan pada arus
perkataan. Terdapat dua kemungkinan untuk rentetan. Pertama, ia boleh menjadi satu set perkataan
permulaan `_', contohnya `Sila hubungi Pentadbir Sistem -/', dalam hal ini fungsi dengan sebarang
hujah akan dipanggil untuk menjana penyelesaian. Bahagian yang tidak jelas
nama fungsi akan dilengkapkan secara automatik (penyiapan biasa tidak tersedia
pada ketika ini) sehingga ruang ditaip.

Kedua, sebarang rentetan lain akan dihantar sebagai satu set hujah kepada kompadd dan harus
oleh itu menjadi ungkapan yang menyatakan perkara yang perlu diselesaikan.

Satu set arahan pengeditan yang sangat terhad tersedia apabila membaca rentetan:
`THE' dan `^H' padam aksara terakhir; `^U' memadam baris, dan `^C' dan `^G'
hentikan fungsi, manakala `RET' menerima penyiapan. Perhatikan rentetan digunakan
verbatim sebagai baris arahan, jadi hujah mesti dipetik mengikut standard
peraturan cangkerang.

Setelah rentetan dibaca, panggilan seterusnya ke _read_comp akan menggunakan yang sedia ada
rentetan daripada membaca yang baharu. Untuk memaksa rentetan baharu dibaca, panggil
_read_comp dengan hujah angka.

_complete_debug (^X?)
Widget ini melakukan penyiapan biasa, tetapi menangkap jejak dalam fail sementara
daripada arahan shell yang dilaksanakan oleh sistem penyiapan. Setiap percubaan penyiapan
mendapat fail sendiri. Perintah untuk melihat setiap fail ini ditolak ke editor
timbunan penimbal.

_bantuan_lengkap (^Xh)
Widget ini memaparkan maklumat tentang nama konteks, teg dan
fungsi penyiapan yang digunakan apabila melengkapkan pada kedudukan kursor semasa. Jika diberi
hujah berangka selain daripada 1 (seperti dalam `ESC-2 ^Xh'), kemudian gaya yang digunakan dan
konteks yang mana ia digunakan akan ditunjukkan juga.

Ambil perhatian bahawa maklumat tentang gaya mungkin tidak lengkap; ia bergantung kepada
maklumat yang tersedia daripada fungsi penyiapan dipanggil, yang seterusnya adalah
ditentukan oleh gaya pengguna sendiri dan tetapan lain.

_lengkap_bantuan_generik
Tidak seperti arahan lain yang disenaraikan di sini, ini mesti dibuat sebagai widget ZLE biasa
bukannya widget penyiapan (iaitu dengan lihat -N). Ia digunakan untuk menjana bantuan
dengan widget terikat pada _generik widget yang diterangkan di atas.

Jika widget ini dicipta menggunakan nama fungsi, kerana ia adalah secara lalai, maka
apabila dilaksanakan ia akan membaca urutan kunci. Ini dijangka terikat dengan panggilan
kepada fungsi penyiapan yang menggunakan _generik widget. Widget itu akan menjadi
dilaksanakan, dan maklumat yang diberikan dalam format yang sama yang _bantuan_lengkap
paparan widget untuk penyiapan kontekstual.

Jika nama widget mengandungi debug, contohnya jika ia dicipta sebagai `lihat -N
_complete_debug_generic _lengkap_bantuan_generik', ia akan membaca dan melaksanakan
rentetan kekunci untuk widget generik seperti sebelumnya, tetapi kemudian menjana maklumat penyahpepijatan
seperti yang dilakukan oleh _complete_debug untuk penyiapan kontekstual.

Jika nama widget mengandungi tidak membaca, ia tidak akan membaca rentetan kekunci tetapi sebaliknya
atur bahawa penggunaan seterusnya widget generik yang dijalankan dalam shell yang sama akan mempunyai
kesan seperti yang dinyatakan di atas.

Widget berfungsi dengan menetapkan parameter shell ZSH_TRACE_GENERIC_WIDGET iaitu
dibaca oleh _generik. Menyahtetapkan parameter membatalkan sebarang kesan tertunda bagi tidak membaca
bentuk.

Sebagai contoh, selepas melaksanakan perkara berikut:

lihat -N _complete_debug_generic _lengkap_bantuan_generik
bindkey '^x:' _complete_debug_generic

menaip `Cx :' diikuti dengan urutan kunci untuk widget generik akan menyebabkan kesan
output untuk widget itu disimpan ke fail.

_complete_tag (^Xt)
Widget ini melengkapkan teg simbol yang dibuat oleh etags or ctag program (nota
tiada sambungan dengan teg sistem penyiapan) yang disimpan dalam fail TAGS, Dalam
format yang digunakan oleh etags, Atau tags, dalam format yang dicipta oleh ctag. Ia akan kelihatan
sandarkan hierarki laluan untuk kejadian pertama bagi mana-mana fail; jika kedua-duanya wujud,
fail TAGS diutamakan. Anda boleh menentukan laluan penuh ke a TAGS or tags fail
dengan menetapkan parameter $TAGSFILE or $tagsfile masing-masing. Yang sepadan
tag pelengkap yang digunakan ialah etags and vtags, selepas emacs dan vi masing-masing.

UTILITI FUNGSI

Perihalan berikut untuk fungsi utiliti yang mungkin berguna apabila menulis selesai
fungsi. Jika fungsi dipasang dalam subdirektori, kebanyakannya berada di dalam Asas
subdirektori. Seperti contoh fungsi untuk arahan dalam pengedaran, utiliti
fungsi menjana padanan semuanya mengikut konvensyen mengembalikan status sifar jika ia
penyiapan yang dijana dan bukan sifar jika tiada penyiapan sepadan boleh ditambah.

Dua lagi ciri ditawarkan oleh _utama_lengkap fungsi. Tatasusunan compprefuncs and
comppostfuncs mungkin mengandungi nama fungsi yang perlu dipanggil segera sebelum atau
selepas selesai telah dicuba. Fungsi hanya akan dipanggil sekali melainkan ia secara eksplisit
memasukkan semula dirinya ke dalam tatasusunan.

_semua_label [ -x ] [ -12VJ ] tag nama penghuraian [ arahan berhujah ... ]
Ini adalah antara muka yang mudah untuk _label_seterusnya fungsi di bawah, melaksanakan
gelung ditunjukkan dalam _label_seterusnya contoh. The arahan dan hujah-hujahnya dipanggil
menjana perlawanan. Pilihan yang disimpan dalam parameter nama akan secara automatik
dimasukkan ke dalam berhujahs diluluskan kepada arahan. Biasanya, ia diletakkan terus
selepas arahan, tetapi jika salah satu daripada berhujahs ialah tanda sempang tunggal, ia disisipkan
secara langsung sebelum itu. Jika sempang adalah hujah terakhir, ia akan dialih keluar daripada
senarai hujah sebelum arahan dipanggil. Ini membenarkan _semua_label untuk digunakan
dalam hampir semua kes di mana padanan boleh dijana dengan satu panggilan ke
kompadd arahan terbina atau melalui panggilan ke salah satu fungsi utiliti.

Sebagai contoh:

tempatan mengeksploitasi
...
if _diminta foo; kemudian
...
_semua_label foo mengeksploitasi '...' kompadd ... - $perlawanan
fi

Akan melengkapkan rentetan daripada perlawanan parameter, menggunakan kompadd dengan tambahan
pilihan yang akan diutamakan daripada yang dijana oleh _semua_label.

_alternatif [ -O nama ] [ -C nama ] spec ...
Fungsi ini berguna dalam kes mudah di mana berbilang teg tersedia.
Pada asasnya ia melaksanakan gelung seperti yang diterangkan untuk _tags fungsi
di bawah.

Teg untuk digunakan dan tindakan untuk dilakukan jika teg diminta diterangkan menggunakan
yang specs yang berbentuk: `tag:penghuraian:tindakan'. The tags ditawarkan menggunakan
_tags dan jika teg diminta, teg tindakan dilaksanakan dengan yang diberikan
Penerangan penghuraian. Yang tindakans ialah yang diterima oleh _hujah fungsi
(diterangkan di bawah), tidak termasuk `->adalah' dan `=...' borang.

Sebagai contoh, tindakan mungkin panggilan fungsi mudah:

_alternatif \
'users:user:_users' \
'hosts:host:_hosts'

menawarkan nama pengguna dan nama hos sebanyak mungkin padanan, yang dihasilkan oleh _users and
_tuan rumah fungsi masing-masing.

suka _hujah, fungsi ini menggunakan _semua_label untuk melaksanakan tindakan, yang akan
gelung pada semua set tag. Pengendalian khas hanya diperlukan jika ada
tag tambahan yang sah, contohnya di dalam fungsi yang dipanggil dari _alternatif.

Pilihan `-O nama' digunakan dengan cara yang sama seperti oleh _hujah fungsi. Dalam
perkataan lain, unsur-unsur nama tatasusunan akan dihantar ke kompadd apabila
melaksanakan sesuatu tindakan.

suka _tags fungsi ini menyokong -C pilihan untuk memberikan nama yang berbeza untuk
medan konteks hujah.

_hujah [ -nswWCRS ] [ -A tepuk ] [ -O nama ] [ -M spec ]
[ : ] spec ...
_hujah [ pilih ... ] -- [ -i pats ] [ -s pasangan ] [ helppec ... ]
Fungsi ini boleh digunakan untuk memberikan spesifikasi lengkap untuk penyiapan untuk a
perintah yang hujahnya mengikut pilihan UNIX standard dan konvensyen hujah.

Pilihan gambaran keseluruhan

Pilihan untuk _hujah sendiri mestilah dalam perkataan yang berasingan, iaitu -s -w, Tidak -sw. Yang
pilihan diikuti oleh specs yang menerangkan pilihan dan hujah yang dianalisis
perintah. specs yang menerangkan bendera pilihan mesti didahulukan specs yang menerangkan
hujah bukan pilihan ("kedudukan" atau "biasa") bagi baris yang dianalisis. Untuk mengelakkan
kekaburan, semua pilihan untuk _hujah itu sendiri boleh dipisahkan daripada spec borang oleh
kolon tunggal.

`--' bentuk digunakan untuk intuit spec bentuk daripada output bantuan arahan
sedang dianalisis, dan diterangkan secara terperinci di bawah. The memilih untuk `--' bentuk adalah
sebaliknya pilihan yang sama seperti bentuk pertama. Perhatikan bahawa `-s'mengikuti'--' mempunyai a
makna yang berbeza daripada `-s' mendahului `--', dan kedua-duanya mungkin muncul.

Pilihan bertukar -s, -S, -A, -w, dan -W mempengaruhi bagaimana _hujah menghuraikan
pilihan baris arahan dianalisis. Suis ini berguna untuk arahan dengan
penghuraian hujah standard.

Pilihan daripada _hujah mempunyai maksud berikut:

-n Dengan pilihan ini, _hujah menetapkan parameter NORMARG kepada kedudukan
hujah biasa pertama dalam $perkataan tatasusunan, iaitu kedudukan selepas
akhir pilihan. Jika hujah itu belum tercapai, NORMARG ditetapkan
kepada -1. Pemanggil hendaklah mengisytiharkan `integer NORMARG' jika -n pilihan adalah
lulus; jika tidak, parameter tidak digunakan.

-s enable pilihan menyusun untuk pilihan huruf tunggal, di mana berbilang
pilihan huruf tunggal boleh digabungkan menjadi satu perkataan. Sebagai contoh, yang
dua pilihan `-x' dan `-y' boleh digabungkan menjadi satu perkataan `-xy'. Oleh
lalai, setiap perkataan sepadan dengan satu nama pilihan (`-xy' adalah bujang
pilihan bernama `xy').

Pilihan yang bermula dengan tanda sempang tunggal atau tanda tambah layak untuk
menyusun; perkataan yang bermula dengan dua sempang bukan.

Perhatikan bahawa -s selepas -- mempunyai makna yang berbeza, yang didokumenkan dalam
segmen bertajuk `Deriving spec bentuk daripada output bantuan'.

-w Bersama dengan -s, benarkan tindanan pilihan walaupun satu atau lebih daripada
pilihan mengambil hujah. Sebagai contoh, jika -x mengambil hujah, dengan tidak -s,
`-xy' dianggap sebagai pilihan tunggal (tidak dikendalikan); dengan -s, -xy merupakan
pilihan dengan hujah `y'; dengan kedua-duanya -s and -w, -xy mungkin menjadi pilihan -x
dan pilihan -y dengan hujah yang masih akan datang.

-W Pilihan ini mengambil masa -w peringkat lebih jauh: adalah mungkin untuk diselesaikan
pilihan huruf tunggal walaupun selepas hujah yang berlaku dalam perkataan yang sama.
Walau bagaimanapun, ia bergantung kepada tindakan yang dilakukan sama ada pilihan akan benar-benar menjadi
selesai pada ketika ini. Untuk lebih kawalan, gunakan fungsi utiliti seperti
_penjaga sebagai sebahagian daripada tindakan.

-C Ubah suai konteks singkat parameter untuk tindakan dalam bentuk `->adalah'. ini
dibincangkan secara terperinci di bawah.

-R Kembalikan status 300 dan bukannya sifar apabila a $negeri adalah untuk dikendalikan, dalam
`->rentetan' sintaks.

-S Jangan lengkapkan pilihan selepas `--' muncul di talian, dan mengabaikan
`--'. Contohnya, dengan -S, dalam barisan

foobar -x -- -y

yang `-x' dianggap sebagai pilihan, `-y' dianggap sebagai hujah, dan
yang `--' dianggap bukan kedua-duanya.

-A tepuk Jangan lengkapkan pilihan selepas hujah bukan pilihan pertama pada baris.
tepuk ialah corak yang sepadan dengan semua rentetan yang tidak boleh diambil sebagai
hujah. Sebagai contoh, untuk membuat _hujah berhenti melengkapkan pilihan selepas
hujah biasa pertama, tetapi mengabaikan semua rentetan bermula dengan tanda sempang
walaupun mereka tidak diterangkan oleh salah satu daripada optspecs, borangnya ialah `-A
"-*"'.

-O nama
Lulus elemen tatasusunan nama sebagai hujah kepada fungsi yang dipanggil
melaksanakan tindakans. Ini dibincangkan secara terperinci di bawah.

-M spec
Gunakan spesifikasi padanan spec untuk melengkapkan nama pilihan dan
nilai. lalai spec membenarkan pelengkapan separa perkataan selepas `_'dan
`-', seperti melengkapkan `-fb' kepada `-foo-bar'. lalai spec ialah:
r:|[_-]=* r:|=*

spesifikasi: gambaran keseluruhan

Setiap bentuk berikut ialah a spec menerangkan set individu pilihan atau
hujah pada baris arahan sedang dianalisis.

n:mesej:tindakan
n::mesej:tindakan
Ini menerangkan tentang n'hujah biasa. The mesej akan dicetak di atas
perlawanan yang dihasilkan dan tindakan menunjukkan apa yang boleh diselesaikan dalam ini
kedudukan (lihat di bawah). Jika terdapat dua titik bertindih sebelum mesej yang
hujah adalah pilihan. Sekiranya mesej mengandungi hanya ruang putih, tiada apa-apa
akan dicetak di atas padanan melainkan tindakan itu menambah penjelasan
rentetan itu sendiri.

:mesej:tindakan
::mesej:tindakan
Serupa, tetapi menerangkan seterusnya hujah, apa jua nombor yang berlaku
jadilah. Jika semua hujah dinyatakan dalam borang ini dalam susunan yang betul
nombor tidak diperlukan.

*:mesej:tindakan
*::mesej:tindakan
*:::mesej:tindakan
Ini menerangkan bagaimana argumen (biasanya argumen bukan pilihan, yang tidak
bermula dengan - or +) perlu diselesaikan apabila kedua-dua yang pertama tidak
borang telah disediakan. Sebarang bilangan hujah boleh dilengkapkan dalam ini
fesyen.

Dengan dua titik bertindih sebelum mesej, yang perkataan tatasusunan khas dan SEMASA
parameter khas diubah suai untuk merujuk hanya kepada argumen biasa apabila
yang tindakan dilaksanakan atau dinilai. Dengan tiga titik bertindih sebelum mesej
mereka diubah suai untuk merujuk hanya kepada hujah biasa yang diliputi oleh ini
keterangan.

optspec
optspec:...
Ini menerangkan pilihan. Kolon menunjukkan pengendalian untuk satu atau lebih
hujah kepada pilihan; jika ia tidak hadir, pilihan itu diandaikan untuk diambil
tiada hujah.

Borang berikut tersedia untuk permulaan optspec, sama ada atau tidak
pilihan mempunyai hujah.

*optspec
Di sini optspec adalah salah satu daripada borang yang tinggal di bawah. Ini menunjukkan
berikutan optspec mungkin berulang. Sebaliknya jika sepadan
pilihan sudah ada pada baris arahan di sebelah kiri
kursor ia tidak akan ditawarkan lagi.

-optname
+optname
Dalam bentuk yang paling mudah optspec hanyalah nama pilihan bermula
dengan tanda tolak atau tambah, seperti `-foo'. Hujah pertama untuk
pilihan (jika ada) mesti mengikut sebagai a berasingan perkataan terus selepas
pilihan.

Sama ada daripada `-+optname' dan `+-optname' boleh digunakan untuk menentukannya
-optname and +optname kedua-duanya sah.

Dalam semua bentuk yang tinggal, terkemuka `-' boleh digantikan dengan atau
berpasangan dengan `+' dengan cara ini.

-optname-
Hujah pertama pilihan mesti datang terus selepas pilihan
nama in yang sama perkataan. Contohnya, `-foo-:...' menyatakan bahawa
pilihan dan hujah yang telah selesai akan kelihatan seperti `-fooberhujah'.

-optname+
Hujah pertama mungkin muncul sejurus selepas itu optname dalam yang sama
perkataan, atau mungkin muncul sebagai perkataan berasingan selepas pilihan. Untuk
contoh, `-foo+:...' menyatakan bahawa pilihan dan hujah yang lengkap
akan kelihatan seperti sama ada `-fooberhujah' atau `-foo berhujah'.

-optname=
Hujah mungkin muncul sebagai perkataan seterusnya, atau dalam perkataan yang sama dengan
nama pilihan dengan syarat ia dipisahkan daripadanya dengan tanda sama,
contohnya `-foo=berhujah' atau `-foo berhujah'.

-optname=-
Hujah untuk pilihan mesti muncul selepas tanda sama dalam
perkataan yang sama, dan mungkin tidak diberikan dalam hujah seterusnya.

optspec[penerangan]
Rentetan penjelasan boleh dilampirkan pada mana-mana borang sebelumnya
of optspec dengan melampirkannya dalam kurungan, seperti dalam `-q[pertanyaan operasi]'.

. kata kerja gaya digunakan untuk memutuskan sama ada rentetan penjelasan
dipaparkan dengan pilihan dalam penyenaraian siap.

Jika tiada rentetan penjelasan dalam kurungan diberikan tetapi perihalan automatik
gaya ditetapkan dan hanya satu hujah diterangkan untuk ini optspec, yang
nilai gaya dipaparkan, dengan sebarang rupa urutan
`%d' di dalamnya digantikan dengan mesej yang pertama optarg yang berikut
yang optspec; lihat di bawah.

Ia adalah mungkin untuk pilihan dengan literal `+' atau `=' untuk muncul, tetapi itu
watak mesti dipetik, contohnya `-\+'.

setiap optarg mengikuti an optspec mesti mengambil salah satu daripada borang berikut:

:mesej:tindakan
::mesej:tindakan
Hujah kepada pilihan; mesej and tindakan diperlakukan sebagai untuk
hujah biasa. Dalam bentuk pertama, hujah adalah wajib,
dan dalam bentuk kedua ia adalah pilihan.

Kumpulan ini mungkin diulang untuk pilihan yang mengambil pelbagai hujah.
Dalam erti kata lain, :mesej1:tindakan1:mesej2:tindakan2 menyatakan bahawa
pilihan mengambil dua hujah.

:*pola:mesej:tindakan
:*pola::mesej:tindakan
:*pola:::mesej:tindakan
Ini menerangkan pelbagai hujah. Hanya yang terakhir optarg untuk sebuah
pilihan mengambil berbilang hujah boleh diberikan dalam borang ini. Sekiranya
pola kosong (iaitu :*:), semua perkataan yang tinggal di talian adalah
untuk diselesaikan seperti yang diterangkan oleh tindakan; jika tidak, semua perkataan
sehingga dan termasuk perkataan yang sepadan dengan pola adalah untuk diselesaikan
menggunakan tindakan.

Berbilang titik bertindih dianggap sebagai untuk `*:...' borang untuk biasa
hujah: apabila mesej didahului oleh dua titik bertindih, iaitu perkataan
tatasusunan khas dan SEMASA parameter khas diubah suai semasa
pelaksanaan atau penilaian ke atas tindakan hanya merujuk kepada perkataan
selepas pilihan. Apabila didahului oleh tiga titik bertindih, ia diubah suai
untuk merujuk hanya kepada perkataan yang diliputi oleh huraian ini.

Mana-mana kolon literal dalam an optname, mesej, Atau tindakan mesti didahului dengan a
garis serong ke belakang, `\:'.

Setiap borang di atas boleh didahului dengan senarai dalam kurungan nama pilihan
dan nombor hujah. Jika pilihan yang diberikan adalah pada baris arahan, pilihan dan
hujah yang ditunjukkan dalam kurungan tidak akan ditawarkan. Contohnya, `(-dua -tiga
1)-satu:...' melengkapkan pilihan `-satu'; jika ini muncul pada baris arahan, the
pilihan -dua and -tiga dan hujah biasa pertama tidak akan selesai selepas itu
ia. `(-foo):...' menentukan penyelesaian hujah biasa; -foo tidak akan
selesai jika hujah itu sudah ada.

Item lain mungkin muncul dalam senarai pilihan yang dikecualikan untuk menunjukkan pelbagai yang lain
item yang tidak sepatutnya digunakan apabila spesifikasi semasa dipadankan: a
bintang tunggal (*) untuk argumen yang lain (iaitu spesifikasi bentuk `*:...');
kolon (:) untuk semua argumen biasa (bukan pilihan-); dan tanda sempang (-) untuk semua
pilihan. Contohnya, jika `(*)' muncul sebelum pilihan dan pilihan muncul pada
baris arahan, senarai argumen yang tinggal (yang ditunjukkan dalam jadual di atas
bermula dengan `*:') tidak akan selesai.

Untuk membantu dalam penggunaan semula spesifikasi, adalah mungkin untuk mendahului mana-mana borang di atas
dengan `!'; maka borang tidak akan dilengkapkan lagi, walaupun jika pilihan atau
argumen muncul pada baris arahan mereka akan dilangkau seperti biasa. Kegunaan utama
kerana ini adalah apabila hujah diberikan oleh tatasusunan, dan _hujah dipanggil
berulang kali untuk konteks yang lebih khusus: pada panggilan pertama `_hujah
$global_options' digunakan, dan pada panggilan berikutnya `_hujah !$^global_options'.

spesifikasi: tindakan

Dalam setiap borang di atas tindakan menentukan bagaimana penyiapan sepatutnya
dihasilkan. Kecuali untuk `->rentetan' borang di bawah, the tindakan akan dilaksanakan oleh
memanggil _semua_label berfungsi untuk memproses semua label tag. Tiada pengendalian khas
tag diperlukan melainkan panggilan fungsi memperkenalkan yang baharu.

Fungsi yang dipanggil untuk dilaksanakan tindakans akan dipanggil dengan unsur-unsur
tatasusunan dinamakan oleh `-O nama' pilihan sebagai hujah. Ini boleh digunakan, sebagai contoh,
untuk lulus set pilihan yang sama untuk kompadd terbina kepada semua tindakans.

Borang-borang untuk tindakan adalah seperti berikut.

(ruang tunggal tidak disebut)
Ini berguna apabila hujah diperlukan tetapi tidak mungkin atau
wajar untuk menjana padanan untuknya. The mesej akan dipaparkan tetapi tidak
penyiapan disenaraikan. Ambil perhatian bahawa walaupun dalam kes ini kolon pada akhir
mesej diperlukan; ia hanya boleh ditinggalkan apabila kedua-duanya tidak a mesej tidak juga
tindakan diberikan.

(barang1 barang2 ...)
Salah satu daripada senarai perlawanan yang mungkin, contohnya:

:foo:(foo bar baz)

((barang1\:desc1 ...))
Sama seperti di atas, tetapi dengan penerangan untuk setiap kemungkinan padanan. Catatan
garis miring ke belakang sebelum kolon. Sebagai contoh,

:foo:((a\:bar b\:baz))

Perlawanan akan disenaraikan bersama dengan penerangan mereka jika
Penerangan gaya ditetapkan dengan nilai tag dalam konteks.

->rentetan
Dalam bentuk ini, _hujah memproses hujah dan pilihan dan kemudian
mengembalikan kawalan kepada fungsi panggilan dengan parameter ditetapkan untuk menunjukkan
keadaan pemprosesan; fungsi panggilan kemudian membuat susunannya sendiri
untuk menjana penyiapan. Sebagai contoh, fungsi yang melaksanakan keadaan
mesin boleh menggunakan jenis tindakan ini.

Lokasi _hujah pertemuan tindakan dalam `->rentetan' format, ia akan dilucutkan
semua ruang kosong terkemuka dan mengekori daripada rentetan dan tetapkan tatasusunan adalah kepada
set semua rentetans yang mana tindakan akan dilakukan. Elemen
daripada tatasusunan state_descr diberikan yang sepadan mesej bidang dari
setiap optarg mengandungi sedemikian tindakan.

Secara lalai dan sama dengan semua fungsi penyelesaian lain yang berkelakuan baik,
_arguments mengembalikan status sifar jika ia dapat menambah padanan dan bukan sifar
sebaliknya. Walau bagaimanapun, jika -R pilihan diberi, _hujah sebaliknya akan
kembalikan status 300 untuk menunjukkan bahawa $negeri adalah untuk dikendalikan.

Di samping $negeri and $state_descr, _hujah juga menetapkan global
parameter `konteks', `selaras' dan `opt_args' seperti yang diterangkan di bawah, dan tidak
menetapkan semula sebarang perubahan yang dibuat pada parameter khas seperti PERMULAAN and perkataan.
Ini memberikan fungsi panggilan pilihan untuk menetapkan semula parameter ini atau
menyebarkan perubahan di dalamnya.

Satu fungsi panggilan _hujah dengan sekurang-kurangnya satu tindakan yang mengandungi a
`->rentetan' oleh itu mesti mengisytiharkan parameter tempatan yang sesuai:

tempatan konteks adalah state_descr selaras
set taip -A opt_args

untuk mengelakkan _hujah daripada mengubah persekitaran global.

{eval-string}
Rentetan dalam pendakap dinilai sebagai kod shell untuk menjana padanan. Sekiranya
eval-string itu sendiri tidak bermula dengan kurungan atau pendakap pembukaan
berpecah kepada perkataan berasingan sebelum pelaksanaan.

= tindakan
Jika tindakan bermula dengan `= ' (tanda sama diikuti dengan ruang),
_hujah akan memasukkan kandungan hujah medan arus
konteks sebagai elemen pertama yang baharu dalam perkataan tatasusunan dan kenaikan khas
nilai SEMASA parameter khas. Ini mempunyai kesan
memasukkan perkataan tiruan pada baris arahan pelengkapan sambil tidak berubah
titik di mana penyempurnaan berlaku.

Ini paling berguna dengan salah satu penentu yang menyekat perkataan pada
baris arahan yang tindakan adalah untuk beroperasi (dua dan tiga kolon
borang di atas). Satu kegunaan tertentu ialah apabila an tindakan sendiri menyebabkan _hujah
pada julat terhad; adalah perlu untuk menggunakan helah ini untuk memasukkan an
nama arahan yang sesuai ke dalam julat untuk panggilan kedua ke _hujah kepada
dapat menghuraikan baris.

perkataan...
perkataan...
Ini meliputi semua bentuk selain daripada yang di atas. Sekiranya tindakan bermula dengan a
ruang, senarai perkataan yang tinggal akan dipanggil tidak berubah.

Jika tidak, ia akan dipanggil dengan beberapa rentetan tambahan diletakkan selepas yang pertama
perkataan; ini akan diturunkan sebagai pilihan kepada kompadd terbina. mereka
memastikan bahawa negeri yang ditentukan oleh _hujah, Dalam tertentu
perihalan pilihan dan hujah, dihantar dengan betul hingga selesai
perintah. Argumen tambahan ini diambil daripada parameter tatasusunan
`mengeksploitasi'; ini akan disediakan sebelum melaksanakan tindakan dan oleh itu mungkin
dirujuk di dalamnya, biasanya dalam pengembangan bentuk `$expl[@]'
yang mengekalkan elemen kosong tatasusunan.

Semasa prestasi tindakan tatasusunan `selaras' akan ditetapkan kepada normal
hujah daripada baris arahan, iaitu perkataan daripada baris arahan selepas
nama arahan tidak termasuk semua pilihan dan hujahnya. Pilihan disimpan dalam
tatasusunan bersekutu `opt_args' dengan nama pilihan sebagai kunci dan hujahnya sebagai
nilai. Untuk pilihan yang mempunyai lebih daripada satu hujah ini diberikan sebagai satu
rentetan, dipisahkan oleh titik bertindih. Semua titik bertindih dalam hujah asal didahului
dengan garis miring ke belakang.

Parameter `konteks' ditetapkan apabila kembali ke fungsi panggilan untuk melaksanakan a
tindakan borang `->rentetan'. Ia ditetapkan kepada tatasusunan elemen yang sepadan dengannya
unsur-unsur $negeri. Setiap elemen ialah nama yang sesuai untuk medan hujah
konteks: sama ada rentetan bentuk `pilihan-pilih-n' untuk n'hujah ke-
pilihannya -pilih, atau rentetan bentuk `hujah-n' untuk n'hujah ke-. Untuk
Hujah `rehat', iaitu dalam senarai pada akhir tidak dikendalikan oleh kedudukan, n
ialah rentetan `rehat'. Sebagai contoh, apabila melengkapkan hujah -o pilihan,
namanya `pilihan-o-1', manakala untuk argumen normal kedua (bukan pilihan-) adalah
`hujah-2'.

Tambahan pula, semasa penilaian ke atas tindakan nama konteks dalam konteks singkat
parameter diubah untuk menambahkan rentetan yang sama yang disimpan dalam konteks
parameter.

pilihan -C memberitahu _hujah untuk mengubah suai konteks singkat parameter untuk tindakan
bentuk `->adalah'. Ini ialah parameter standard yang digunakan untuk menjejaki
konteks semasa. Di sini (dan bukan konteks array) hendaklah dibuat setempat kepada
fungsi panggilan untuk mengelak daripada mengembalikan nilai yang diubah suai dan harus dimulakan
kepada nilai semasa pada permulaan fungsi:

tempatan curcontext="$curcontext"

Ini berguna apabila berbilang negeri tidak mungkin sah bersama-sama.

Menentukan pelbagai set of pilihan

Adalah mungkin untuk menentukan beberapa set pilihan dan hujah dengan set
dipisahkan oleh tanda sempang tunggal. Spesifikasi sebelum tanda sempang pertama (jika ada)
dikongsi oleh semua set yang tinggal. Perkataan pertama dalam setiap set lain menyediakan a
nama untuk set yang mungkin muncul dalam senarai pengecualian dalam spesifikasi, sama ada
sahaja atau sebelum salah satu nilai yang mungkin diterangkan di atas. Dalam kes kedua a
`-' sepatutnya muncul di antara nama ini dan selebihnya.

Sebagai contoh:

_hujah \
-a \
- set1 \
-c \
- set2 \
-d \
':arg:(x2 y2)'

Ini mentakrifkan dua set. Apabila baris arahan mengandungi pilihan `-c', yang `-d'
pilihan dan hujah tidak akan dianggap sebagai penyelesaian yang mungkin. Bila ia
mengandungi `-d' atau hujah, pilihan `-c' tidak akan dipertimbangkan. Walau bagaimanapun,
selepas `-a' kedua-dua set masih akan dianggap sah.

Jika nama yang diberikan untuk salah satu set yang saling eksklusif adalah dalam bentuk `(nama)'
maka hanya satu nilai daripada setiap set yang akan dilengkapkan; lebih formal, semua
spesifikasi adalah saling eksklusif kepada semua spesifikasi lain dalam set yang sama.
Ini berguna untuk menentukan beberapa set pilihan yang saling eksklusif
dan di mana pilihan adalah alias untuk satu sama lain. Sebagai contoh:

_hujah \
-a -b \
- '(mampatkan)' \
{-c,--compress}'[compress]' \
- '(nyahmampatkan)' \
{-d,--decompress}'[decompress]'

Oleh kerana kod penyiapan perlu menghuraikan baris arahan secara berasingan untuk setiap set ini
bentuk hujah adalah perlahan dan hanya boleh digunakan apabila perlu. A berguna
alternatif selalunya merupakan spesifikasi pilihan dengan argumen rehat (seperti dalam
`-foo:*:...'); di sini pilihan -foo menelan semua hujah yang tinggal sebagai
digambarkan oleh optarg takrifan.

Datang spec borang dari yang membantu output

Pilihan `--' membenarkan _hujah untuk mengusahakan nama pilihan panjang yang
menyokong `- membantu' pilihan yang standard dalam banyak arahan GNU. Perintah itu
perkataan dipanggil dengan hujah `- membantu' dan output diperiksa untuk nama pilihan.
Jelas sekali, ia boleh berbahaya untuk menyampaikan ini kepada arahan yang mungkin tidak menyokong ini
pilihan kerana tingkah laku arahan tidak ditentukan.

Sebagai tambahan kepada pilihan, `_hujah --' akan cuba menyimpulkan jenis hujah
tersedia untuk pilihan apabila borang `--pilih=val' ianya sah. Ia juga boleh
berikan petunjuk dengan memeriksa teks bantuan arahan dan menambah helppec daripada
bentuk `pola:mesej:tindakan'; perhatikan yang lain _hujah spec borang tidak digunakan.
. pola dipadankan dengan teks bantuan untuk pilihan, dan jika ia sepadan dengan
mesej and tindakan digunakan sebagai penentu hujah lain. Kes khas daripada
`*:' bermaksud kedua-duanya mesej and tindakan kosong, yang mempunyai kesan menyebabkan
pilihan yang tidak mempunyai huraian dalam output bantuan untuk dipesan dalam penyenaraian lebih awal
pilihan yang mempunyai penerangan.

Sebagai contoh:

_hujah -- '*\*:togol:(ya tidak)' \
'*=FILE*:file:_files' \
'*=DIR*:directory:_files -/' \
'*=PATH*:directory:_files -/'

Di sini, `yes' dan `tidak' akan dilengkapkan sebagai hujah pilihan yang penerangannya
berakhir dengan bintang; nama fail akan dilengkapkan untuk pilihan yang mengandungi subrentetan
`=FAIL' dalam keterangan; dan direktori akan dilengkapkan untuk pilihan yang
huraian mengandungi `=DIR' atau `=LALUAN'. Tiga yang terakhir sebenarnya adalah lalai dan
jadi tidak perlu diberikan secara eksplisit, walaupun adalah mungkin untuk mengatasi penggunaan
corak-corak ini. Teks bantuan biasa yang menggunakan ciri ini ialah:

-C, --directory=DIR menukar kepada direktori DIR

supaya spesifikasi di atas akan menyebabkan direktori disiapkan selepas
`--direktori', walaupun tidak selepas `-C'.

Perhatikan juga bahawa _hujah cuba untuk mengetahui secara automatik jika hujah untuk an
pilihan adalah pilihan. Ini boleh dinyatakan secara eksplisit dengan menggandakan kolon sebelum ini
yang mesej.

Jika pola berakhir dengan `(-)', ini akan dialih keluar daripada corak dan tindakan
akan digunakan hanya selepas `=', bukan dalam perkataan seterusnya. Ini adalah
tingkah laku spesifikasi biasa yang ditakrifkan dengan bentuk `=-'.

`_hujah --' boleh diikuti dengan pilihan `-i corak' untuk memberi corak
untuk pilihan yang tidak perlu diselesaikan. Corak boleh diberikan sebagai nama
daripada parameter tatasusunan atau sebagai senarai literal dalam kurungan. Sebagai contoh,

_hujah -- -i \
"(--(en|dis)able-CIRI*)"

akan menyebabkan penyelesaian mengabaikan pilihan `--dayakan-CIRI'dan
`--disable-CIRI' (contoh ini berguna dengan GNU mengkonfigurasi).

`_hujah --' borang juga boleh diikuti dengan pilihan `-s pasangan' untuk menerangkan
alias pilihan. The pasangan terdiri daripada senarai corak berselang-seli dan
penggantian yang sepadan, disertakan dalam parens dan dipetik supaya ia membentuk satu
kata hujah dalam _hujah panggil.

Contohnya, beberapa mengkonfigurasi-output bantuan skrip menerangkan pilihan hanya sebagai
`--dayakan-foo', tetapi skrip juga menerima bentuk yang dinafikan `--disable-foo'. Kepada
benarkan melengkapkan borang kedua:

_hujah -- -s "((#s)--dayakan- --lumpuhkan-)"

Lain-lain nota

Akhirnya, ambil perhatian bahawa _hujah umumnya menjangkakan sebagai pengendalian fungsi utama
sebarang penyiapan yang mana ia digunakan. Ia mungkin mempunyai kesan sampingan yang mengubah
rawatan sebarang padanan yang ditambah oleh fungsi lain yang dipanggil selepasnya. Untuk menggabungkan
_hujah dengan fungsi lain, fungsi tersebut hendaklah dipanggil sama ada sebelum ini
_hujah, sebagai tindakan dalam spec, atau dalam pengendali untuk `->adalah' tindakan.

Berikut adalah contoh yang lebih umum tentang penggunaan _hujah:

_hujah '-l+: kiri sempadan:' \
'-format:kertas saiz :( huruf A4)' \
'*-copy:output file:_files::resolusi:(300 600)' \
':postskrip fail:_files -g \*.\(ps\|eps\)' \
'*:halaman nombor:'

Ini menerangkan tiga pilihan: `-l', `-format', dan `-salinan'. Yang pertama mengambil satu
hujah yang digambarkan sebagai `kiri sempadan' yang mana tiada penyempurnaan akan ditawarkan kerana
daripada tindakan kosong itu. Hujahnya mungkin datang terus selepas `-l' atau mungkin juga
diberikan sebagai perkataan seterusnya pada baris.

`-format' pilihan mengambil satu hujah dalam perkataan seterusnya, diterangkan sebagai `kertas saiz'
yang mana hanya rentetan `surat' dan `A4' akan selesai.

`-salinan' pilihan mungkin muncul lebih daripada sekali pada baris arahan dan mengambil masa dua
hujah. Yang pertama adalah wajib dan akan dilengkapkan sebagai nama fail. Yang kedua
adalah pilihan (kerana kolon kedua sebelum perihalan `resolusi') dan
akan dilengkapkan daripada rentetan `300' dan `600'.

Dua huraian terakhir menyatakan perkara yang perlu dilengkapkan sebagai hujah. Yang pertama
menerangkan hujah pertama sebagai `kata-kata tambahan fail' dan membuat fail berakhir dengan `ps'
atau `eps' selesai. Penerangan terakhir memberikan semua hujah lain
penerangan `halaman nombor' tetapi tidak menawarkan penyiapan.

_cache_invalid pengecam_cache
Fungsi ini mengembalikan status sifar jika cache penyiapan sepadan dengan
pengecam cache yang diberikan memerlukan pembinaan semula. Ia menentukan ini dengan melihat ke atas
dasar cache gaya untuk konteks semasa. Ini harus memberikan nama fungsi
yang dijalankan dengan laluan penuh ke fail cache yang berkaitan sebagai satu-satunya hujah.

Contoh:

_contoh_caching_policy () {
# membina semula if cache is lebih daripada a minggu lama
tempatan -a oldp
lama=( "$1"(Nm+7) )
(( $#oldp ))
}

_fungsi_panggilan pulangan nama [ berhujah ... ]
Jika sesuatu fungsi nama wujud, ia dipanggil dengan hujah berhujahs. Yang pulangan
argumen memberikan nama parameter di mana status pulangan daripada fungsi
nama hendaklah disimpan; jika pulangan kosong atau sempang tunggal diabaikan.

Status pemulangan bagi _fungsi_panggilan sendiri adalah sifar jika fungsi nama wujud dan
dipanggil dan bukan sifar sebaliknya.

_program_panggilan tag rentetan ...
Fungsi ini menyediakan mekanisme untuk pengguna mengatasi penggunaan luaran
perintah. Ia melihat ke atas arahan gaya dengan yang dibekalkan tag. Kalau gayanya
set, nilainya digunakan sebagai arahan untuk melaksanakan. The rentetans daripada panggilan ke
_program_panggilan, atau daripada gaya jika ditetapkan, digabungkan dengan ruang di antaranya
dan rentetan yang terhasil dinilai. Status pemulangan ialah status pemulangan bagi
perintah itu dipanggil.

_gabungan [ -s pola ] tag gaya spec ... bidang memilih ...
Fungsi ini digunakan untuk melengkapkan gabungan nilai, contohnya pasangan
nama hos dan nama pengguna. The gaya hujah memberikan gaya yang mentakrifkan
berpasangan; ia dilihat dalam konteks dengan tag dinyatakan.

Nama gaya terdiri daripada nama medan yang dipisahkan oleh tanda sempang, contohnya
`pengguna-hos-port'. Untuk setiap medan untuk nilai sudah diketahui, a spec daripada
bentuk `bidang=pola' diberikan. Sebagai contoh, jika baris arahan setakat ini menyatakan a
pengguna `pws', hujah `pengguna=pws' sepatutnya muncul.

Argumen seterusnya tanpa tanda sama diambil sebagai nama medan untuknya
penyiapan harus dijana (mungkin bukan salah satu daripada bidangs untuk yang
nilai diketahui).

Padanan yang dihasilkan akan diambil daripada nilai gaya. Ini sepatutnya
mengandungi nilai yang mungkin untuk kombinasi dalam susunan yang sesuai (pengguna,
hos, port dalam contoh di atas). Medan yang berbeza nilai untuk
medan yang berbeza dipisahkan oleh titik bertindih. Ini boleh diubah dengan pilihan -s
kepada _gabungan yang menentukan corak. Biasanya ini adalah kelas watak, sebagai
contohnya `-s "[:@]"' dalam kes hos pengguna gaya. setiap satu
`bidang=pola' spesifikasi mengehadkan penyiapan yang digunakan untuk elemen
gaya dengan medan sepadan yang sesuai.

Jika tiada gaya dengan nama yang diberikan ditakrifkan untuk teg yang diberikan, atau jika tiada satu pun daripada
rentetan dalam padanan nilai gaya, tetapi nama fungsi medan yang diperlukan didahului
dengan garis bawah ditakrifkan, fungsi itu akan dipanggil untuk menjana padanan.
Sebagai contoh, jika tiada `pengguna-hos-port' atau tiada nama hos yang sepadan apabila menjadi hos
diperlukan, fungsi `_tuan rumah' akan dipanggil secara automatik.

Jika nama yang sama digunakan untuk lebih daripada satu medan, dalam kedua-dua medan `bidang=pola'dan
hujah yang memberikan nama medan yang perlu dilengkapkan, nombor
medan (bermula dengan satu) boleh diberikan selepas nama medan, dipisahkan daripadanya dengan a
usus besar.

Semua argumen selepas nama medan yang diperlukan dihantar ke kompadd apabila menjana
padanan daripada nilai gaya, atau kepada fungsi untuk medan jika ada
dipanggil.

_huraikan [-12JVx] [ -oO | -t tag ] penghuraian nama1 [ nama2 ] [ pilih ... ]
[ -- nama1 [ nama2 ] [ pilih ... ] ... ]
Fungsi ini mengaitkan penyiapan dengan penerangan. Berbilang kumpulan dipisahkan
by -- boleh dibekalkan, berpotensi dengan pilihan penyiapan yang berbeza pilihs.

. penghuraian diambil sebagai rentetan untuk dipaparkan di atas padanan jika format gaya untuk
yang penerangan tag ditetapkan. Ini diikuti dengan satu atau dua nama tatasusunan
diikuti dengan pilihan untuk lulus ke kompadd. Tatasusunan pertama mengandungi yang mungkin
melengkapkan dengan penerangan mereka dalam bentuk `siap:Penerangan'. mana-mana
titik bertindih literal dalam siap mesti dipetik dengan garis miring ke belakang. Jika tatasusunan kedua ialah
diberikan, ia sepatutnya mempunyai bilangan elemen yang sama seperti yang pertama; dalam kes ini
elemen yang sepadan ditambah sebagai pelengkap yang mungkin dan bukannya siap
rentetan daripada tatasusunan pertama. Senarai penyiapan akan mengekalkan perihalan
daripada tatasusunan pertama. Akhirnya, satu set pilihan penyiapan boleh muncul.

Jika pilihan `-o' muncul sebelum hujah pertama, padanan yang ditambahkan ialah
dianggap sebagai nama pilihan arahan (NB bukan pilihan shell), biasanya mengikuti a
`-', `--' atau `+' pada baris arahan. Dalam kes ini _huraikan menggunakan
awalan-tersembunyi, awalan-diperlukan and kata kerja gaya untuk mengetahui sama ada rentetan itu sepatutnya
ditambah sebagai pelengkap dan jika huraian harus ditunjukkan. Tanpa `-o'
pilihan, hanya kata kerja gaya digunakan untuk menentukan cara penerangan ditunjukkan. Jika
`-O' digunakan bukannya `-o', pilihan arahan selesai seperti di atas tetapi _huraikan
tidak akan mengendalikan awalan-diperlukan gaya.

Dengan -t pilihan a tag boleh ditentukan. Lalai ialah `nilai' atau, jika -o
pilihan diberikan, `pilihan'.

Pilihannya -1, -2, -J, -V, -x diserahkan kepada _label_seterusnya.

Jika dipilih oleh kumpulan senarai gaya, rentetan dengan penerangan yang sama akan
muncul bersama-sama dalam senarai.

_huraikan menggunakan _semua_label berfungsi untuk menjana padanan, jadi ia tidak
perlu muncul dalam gelung di atas label tag.

_penerangan [ -x ] [ -12VJ ] tag nama penghuraian [ spec ... ]
Fungsi ini tidak boleh dikelirukan dengan yang sebelumnya; ia digunakan sebagai penolong
fungsi untuk mencipta pilihan untuk kompadd. Ia dikebumikan di dalam banyak yang lebih tinggi
fungsi penyiapan tahap dan selalunya tidak perlu dipanggil terus.

Gaya yang disenaraikan di bawah diuji dalam konteks semasa menggunakan yang diberikan tag. Yang
pilihan yang terhasil untuk kompadd dimasukkan ke dalam tatasusunan bernama nama (ini adalah
secara tradisional `mengeksploitasi', tetapi konvensyen ini tidak dikuatkuasakan). Penerangan untuk
set padanan yang sepadan dihantar ke fungsi dalam penghuraian.

Gaya yang diuji ialah: format, tersembunyi, jodoh, corak-abaikan and nama kumpulan.
. format gaya pertama kali diuji untuk yang diberikan tag dan kemudian untuk penerangan
tag jika tiada nilai ditemui, manakala selebihnya hanya diuji untuk teg yang diberikan sebagai
hujah pertama. Fungsi ini juga memanggil _setup yang menguji beberapa lagi gaya.

Rentetan itu dikembalikan oleh format gaya (jika ada) akan diubah suai supaya
urutan `%d' digantikan dengan penghuraian diberikan sebagai hujah ketiga tanpa sebarang
ruang putih mendahului atau mengekori. Jika, selepas mengalihkan ruang putih, penghuraian is
rentetan kosong, gaya format tidak akan digunakan dan pilihan dimasukkan ke dalam
nama tatasusunan tidak akan mengandungi rentetan penjelasan untuk dipaparkan di atas
perlawanan.

If _penerangan dipanggil dengan lebih daripada tiga hujah, tambahan specs
hendaklah dalam bentuk `tangki:str'. Penggantian urutan pelarian bekalan ini untuk
yang format gaya: setiap penampilan `%tangki' akan digantikan dengan rentetan.

Jika -x pilihan diberikan, penerangan akan dihantar kepada kompadd menggunakan -x
pilihan dan bukannya lalai -X. Ini bermakna huraian akan menjadi
dipaparkan walaupun tiada padanan yang sepadan.

Pilihan yang diletakkan dalam tatasusunan nama mengambil kira nama kumpulan gaya, jadi
perlawanan diletakkan dalam kumpulan berasingan jika perlu. Kumpulan itu biasanya mempunyainya
elemen diisih (dengan menghantar pilihan -J kepada kompadd), tetapi jika pilihan bermula
dengan `-V', `-J', `-1', atau `-2' diserahkan kepada _penerangan, pilihan itu ialah
termasuk dalam tatasusunan. Oleh itu adalah mungkin untuk kumpulan penyiapan menjadi
tidak diisih dengan memberikan pilihan `-V', `-1V', atau `-2V'.

Dalam kebanyakan kes, fungsi akan digunakan seperti ini:

tempatan mengeksploitasi
_penerangan fail mengeksploitasi fail
kompadd "$expl[@]" - "$files[@]"

Perhatikan penggunaan parameter mengeksploitasi, tanda sempang dan senarai padanan. Hampir
semua panggilan ke kompadd dalam sistem penyiapan menggunakan format yang sama; ini
memastikan gaya yang ditentukan pengguna diturunkan dengan betul kepada binaan yang
melaksanakan dalaman penyiapan.

_penghantaran konteks rentetan ...
Ini menetapkan konteks semasa kepada konteks dan mencari fungsi penyiapan untuk
mengendalikan konteks ini dengan memburu senarai nama arahan atau khas
konteks (seperti yang diterangkan di atas untuk compdef) diberikan sebagai rentetans. Penyiapan pertama
fungsi yang akan ditakrifkan untuk salah satu konteks dalam senarai digunakan untuk menjana
perlawanan. Biasanya, yang terakhir rentetan is -lalai- untuk menyebabkan fungsi lalai
penyiapan untuk digunakan sebagai sandaran.

Fungsi menetapkan parameter $perkhidmatan kepada rentetan sedang diuji, dan menetapkan
konteks/perintah bidang (yang keempat) daripada $curcontext parameter ke konteks
diberikan sebagai hujah pertama.

Sila hubungi Pentadbir Sistem Majlis tersebut Sila hubungi Pentadbir Sistem panggilan _path_files dengan semua hujah ia telah diluluskan kecuali
khususnya -g and -/. Penggunaan dua pilihan ini bergantung pada tetapan
corak fail gaya.

Fungsi ini menerima set penuh pilihan yang dibenarkan oleh _path_files, diterangkan
di bawah.

_gnu_generik
Fungsi ini adalah pembalut mudah di sekeliling _hujah fungsi yang diterangkan di atas.
Ia boleh digunakan untuk menentukan secara automatik pilihan panjang yang difahami oleh arahan
yang menghasilkan senarai apabila melepasi pilihan `- membantu'. Ia bertujuan untuk digunakan sebagai
fungsi penyiapan peringkat atas dengan haknya sendiri. Sebagai contoh, untuk membolehkan pilihan
penyempurnaan untuk arahan foo and bar, Gunakan

compdef _gnu_generik foo bar

selepas panggilan ke compinit.

Sistem penyiapan seperti yang dibekalkan adalah konservatif dalam penggunaan fungsi ini,
kerana adalah penting untuk memastikan arahan memahami pilihan `- membantu'.

_penjaga [ pilihan ] pola penghuraian
Fungsi ini memaparkan penghuraian if pola sepadan dengan rentetan yang akan dilengkapkan. Ia adalah
bertujuan untuk digunakan dalam tindakan untuk spesifikasi yang diserahkan kepada _hujah and
fungsi yang serupa.

Status pemulangan adalah sifar jika mesej dipaparkan dan perkataan untuk dilengkapkan adalah
tidak kosong, dan bukan sifar sebaliknya.

. pola boleh didahului oleh mana-mana pilihan yang difahami oleh kompadd yang
diturunkan daripada _penerangan, iaitu -M, -J, -V, -1, -2, -n, -F and -X. Semuanya
pilihan ini akan diabaikan. Ini sesuai dengan mudah dengan hujah-lulus
konvensyen tindakan untuk _hujah.

Sebagai contoh, pertimbangkan arahan yang mengambil pilihan -n and -tiada, Di mana -n mesti
diikuti dengan nilai angka dalam perkataan yang sama. Dengan menggunakan:

_hujah '-n-: :_penjaga "[0-9]#" "nombor nilai"' '-tiada'

_hujah boleh dibuat untuk kedua-duanya memaparkan mesej `angka nilai' dan lengkap
pilihan selepas `-n'. Jika `-n' sudah diikuti oleh satu atau lebih digit
(corak diserahkan kepada _penjaga) hanya mesej akan dipaparkan; jika `-n'adalah
diikuti oleh watak lain, hanya pilihan yang dilengkapkan.

_mesej [ -r12 ] [ -VJ kumpulan ] penghuraian
_mesej -e [ tag ] penghuraian
. penghuraian digunakan dengan cara yang sama seperti hujah ketiga kepada _penerangan
fungsi, kecuali rentetan yang terhasil akan sentiasa ditunjukkan sama ada atau tidak
perlawanan telah dihasilkan. Ini berguna untuk memaparkan mesej bantuan di tempat
di mana tiada penyiapan boleh dijana.

. format gaya diperiksa dengan mesej tag untuk mencari mesej; kebiasaan
hari, penerangan, digunakan hanya jika gaya tidak ditetapkan dengan yang terdahulu.

Jika -r pilihan diberikan, tiada gaya digunakan; yang penghuraian diambil secara literal sebagai
rentetan untuk dipaparkan. Ini paling berguna apabila penghuraian datang dari pra-diproses
senarai argumen yang sudah mengandungi penerangan yang diperluaskan.

. -12VJ pilihan dan kumpulan diserahkan kepada kompadd dan seterusnya tentukan kumpulan
rentetan mesej ditambahkan pada.

Kedua -e borang memberikan penerangan untuk pelengkapan dengan tag tag untuk ditunjukkan
walaupun tiada padanan untuk tag itu. Borang ini dipanggil oleh _hujah in
peristiwa bahawa tiada tindakan untuk spesifikasi pilihan. Tag boleh
ditinggalkan dan jika ya tag diambil daripada parameter $curtag; ini dikekalkan
oleh sistem penyiapan dan sebagainya biasanya betul. Perhatikan bahawa jika tiada
sepadan pada masa fungsi ini dipanggil, compstate [masukkan] telah dibersihkan, jadi
padanan tambahan yang dijana kemudian tidak dimasukkan pada baris arahan.

_berbilang_bahagian September pelbagai
Hujahnya September ialah watak pemisah. The pelbagai mungkin sama ada nama an
parameter tatasusunan atau tatasusunan literal dalam bentuk `(foo bar)', senarai dalam kurungan
perkataan yang dipisahkan oleh ruang putih. Penyiapan yang mungkin adalah rentetan daripada
tatasusunan. Walau bagaimanapun, setiap bahagian dibataskan oleh September akan disiapkan secara berasingan. Untuk
contohnya, _tar fungsi menggunakan `_berbilang_bahagian / patarray' untuk melengkapkan fail separa
laluan daripada tatasusunan yang diberikan laluan fail lengkap.

. -i punca pilihan _berbilang_bahagian untuk memasukkan padanan unik walaupun itu memerlukan
berbilang pemisah untuk dimasukkan. Ini biasanya bukan tingkah laku yang diharapkan
dengan nama fail, tetapi beberapa jenis penyiapan lain, contohnya yang mempunyai a
set kemungkinan tetap, mungkin lebih sesuai dengan borang ini.

Seperti fungsi utiliti lain, fungsi ini menerima `-V', `-J', `-1', `-2',
`-n', `-f', `-X', `-M', `-P', `-S', `-r', `-R', dan `-q' pilihan dan menyerahkannya kepada
yang kompadd terbina dalam.

_label_seterusnya [ -x ] [ -12VJ ] tag nama penghuraian [ pilihan ... ]
Fungsi ini digunakan untuk melaksanakan gelung pada label tag yang berbeza untuk a
teg tertentu seperti yang diterangkan di atas untuk perintah tag gaya. Pada setiap panggilan ia menyemak
untuk melihat sama ada terdapat lagi label teg; jika ada ia mengembalikan status sifar,
sebaliknya bukan sifar. Oleh kerana fungsi ini memerlukan teg semasa untuk ditetapkan, ia mesti
sentiasa mengikut panggilan ke _tags or _diminta.

. -x12VJ pilihan dan tiga hujah pertama diserahkan kepada _penerangan
fungsi. Di mana sesuai tag akan digantikan dengan label teg dalam panggilan ini.
Sebarang penerangan yang diberikan dalam perintah tag gaya lebih diutamakan daripada penghuraian berlalu ke
_label_seterusnya.

. pilihans diberikan selepas penghuraian ditetapkan dalam parameter yang diberikan oleh nama, dan dengan itu
akan diserahkan kepada kompadd atau apa sahaja fungsi yang dipanggil untuk menambah padanan.

Berikut ialah penggunaan biasa fungsi ini untuk teg foo. Panggilan kepada _diminta
menentukan sama ada tag foo diperlukan sama sekali; gelung berakhir _label_seterusnya mengendalikan mana-mana
label yang ditakrifkan untuk teg dalam perintah tag gaya.

tempatan mengeksploitasi ret=1
...
if _diminta foo; kemudian
...
manakala _label_seterusnya foo mengeksploitasi '...'; do
kompadd "$expl[@]" ... && ret=0
dilakukan
...
fi
pulangan penolakan

_biasa
Ini ialah fungsi standard yang dipanggil untuk mengendalikan penyiapan di luar sebarang khas
-konteks-. Ia dipanggil untuk melengkapkan kata perintah dan juga hujah
untuk perintah. Dalam kes kedua, _biasa mencari penyiapan khas untuk itu
arahan, dan jika tiada ia menggunakan penyelesaian untuk -lalai- konteks.

Penggunaan kedua adalah untuk memeriksa semula baris arahan yang ditentukan oleh $perkataan tatasusunan dan
$SEMASA parameter selepas itu telah diubah suai. Sebagai contoh, fungsi
_pra-arahan, yang selesai selepas penentu pra-perintah seperti nohup, mengalih keluar
perkataan pertama daripada perkataan tatasusunan, mengurangkan SEMASA parameter, kemudian panggil
_biasa sekali lagi. Kesannya ialah `nohup cmd ...' diperlakukan dengan cara yang sama seperti
`cmd ...'.

Jika nama arahan sepadan dengan salah satu corak yang diberikan oleh salah satu pilihan -p or
-P kepada compdef, fungsi penyiapan sepadan dipanggil dan kemudiannya
parameter _compskip disemak. Jika ia ditetapkan siap ditamatkan pada itu
mata walaupun tiada padanan ditemui. Ini adalah kesan yang sama seperti dalam
-pertama- konteks.

_options
Ini boleh digunakan untuk melengkapkan nama pilihan shell. Ia menyediakan padanan
spesifikasi yang mengabaikan ` terkemukatidak', mengabaikan garis bawah dan membenarkan
huruf besar untuk dipadankan dengan huruf kecil mereka (contohnya, `epal',
`noglob', `NO_GLOB' semuanya telah selesai). Sebarang hujah disebarkan kepada
kompadd terbina dalam.

_options_set and _options_unset
Fungsi ini hanya melengkapkan pilihan yang ditetapkan atau tidak ditetapkan, dengan padanan yang sama
spesifikasi yang digunakan dalam _options fungsi.

Ambil perhatian bahawa anda perlu menyahkomen beberapa baris dalam _utama_lengkap fungsi untuk
fungsi ini berfungsi dengan baik. Garisan yang dimaksudkan digunakan untuk menyimpan
tetapan pilihan berkuat kuasa sebelum widget penyiapan menetapkan pilihannya secara setempat
keperluan. Oleh itu, fungsi ini biasanya tidak digunakan oleh sistem penyiapan.

_parameter
Ini digunakan untuk melengkapkan nama parameter shell.

Pilihan `-g pola' mengehadkan penyiapan kepada parameter yang jenisnya sepadan dengan
pola. Jenis parameter ialah yang ditunjukkan oleh `cetak ${(t)param}', oleh itu
bijak menggunakan `*' dalam pola mungkin perlu.

Semua hujah lain diserahkan kepada kompadd terbina dalam.

_path_files
Fungsi ini digunakan di seluruh sistem penyiapan untuk melengkapkan nama fail. Ia
membolehkan penyiapan laluan separa. Sebagai contoh, rentetan `/u/i/s/sig' mungkin
selesai ke `/usr/include/sys/signal.h'.

Pilihan yang diterima oleh kedua-duanya _path_files and Sila hubungi Pentadbir Sistem ialah:

-f Lengkapkan semua nama fail. Ini adalah lalai.

-/ Menentukan bahawa hanya direktori perlu dilengkapkan.

-g pola
Menentukan bahawa hanya fail yang sepadan dengan pola hendaklah dilengkapkan.

-W laluan
Menentukan awalan laluan yang akan ditambah pada rentetan daripada
baris arahan untuk menjana nama fail tetapi itu tidak boleh dimasukkan sebagai
penyiapan atau ditunjukkan dalam penyenaraian penyiapan. di sini, laluan mungkin namanya
daripada parameter tatasusunan, senarai literal laluan yang disertakan dalam kurungan atau a
nama laluan mutlak.

-F fail diabaikan
Ini berkelakuan seperti untuk pilihan yang sepadan dengan kompadd terbina. Ia
memberikan kawalan langsung ke atas nama fail yang harus diabaikan. Jika pilihan
tidak hadir, itu corak-abaikan gaya digunakan.

Kedua-dua _path_files and Sila hubungi Pentadbir Sistem juga menerima pilihan berikut yang diserahkan kepada
kompadd:`-J', `-V', `-1', `-2', `-n', `-X', `-M', `-P', `-S', `-q', `-r', dan
`-R'.

Akhir sekali, _path_files fungsi menggunakan gaya mengembangkan, samar-samar, pengarah khas,
akhiran senarai and isihan fail diterangkan di atas.

_pilih_varian [ -b label terbina ] [ -c arahan ] [ -r nama ]
label=pola ... label [ berhujah ... ]
Fungsi ini digunakan untuk menyelesaikan situasi di mana satu nama arahan memerlukan
lebih daripada satu jenis pengendalian, sama ada kerana ia mempunyai lebih daripada satu varian atau
kerana terdapat pertembungan nama antara dua arahan yang berbeza.

Perintah untuk dijalankan diambil daripada elemen pertama tatasusunan perkataan melainkan ini
ditindih oleh pilihan -c. Perintah ini dijalankan dan outputnya dibandingkan
dengan satu siri corak. Hujah yang akan dihantar kepada arahan boleh ditentukan
pada akhirnya selepas semua hujah lain. Corak untuk mencuba mengikut urutan diberikan
oleh hujah-hujah label=pola; jika keluaran `arahan berhujah ...' mengandungi
pola, Maka label dipilih sebagai label untuk varian arahan. Jika tiada
corak sepadan, label arahan akhir dipilih dan status 1 dikembalikan.

Jika `-b label terbina' diberikan, arahan itu diuji untuk melihat sama ada ia disediakan
sebagai shell builtin, mungkin autoloaded; jika ya, label label terbina dipilih
sebagai label untuk varian.

Jika `-r nama' diberikan, iaitu label yang dipilih disimpan dalam parameter bernama nama.

Hasilnya juga dicache dalam _cmd_variant tatasusunan bersekutu diindeks oleh
nama arahan dijalankan.

_regex_arguments nama spec ...
Fungsi ini menjana fungsi penyiapan nama yang sepadan dengan spesifikasi
specs, satu set ungkapan biasa seperti yang diterangkan di bawah. Selepas berlari
_regex_arguments, fungsinya nama harus dipanggil sebagai penyiapan biasa
fungsi. Corak yang hendak dipadankan diberikan oleh kandungan perkataan susun atur
ke kedudukan kursor semasa yang dicantumkan dengan aksara nol; tiada sebut harga
digunakan.

Argumen dikumpulkan sebagai set alternatif yang dipisahkan oleh `|', yang dicuba
satu demi satu sehingga satu perlawanan. Setiap alternatif terdiri daripada satu atau lebih
spesifikasi yang dicuba dari kiri ke kanan, dengan setiap corak dipadankan
dilucutkan secara bergilir-gilir daripada baris arahan yang sedang diuji, sehingga semua kumpulan
berjaya atau sehingga seseorang gagal; dalam kes kedua, alternatif seterusnya dicuba.
Struktur ini boleh diulang ke kedalaman sewenang-wenangnya dengan menggunakan kurungan; sepadan
berjalan dari dalam ke luar.

Prosedur khas digunakan jika tiada ujian berjaya tetapi baris arahan yang tinggal
rentetan tidak mengandungi aksara nol (menyiratkan perkataan yang selebihnya ialah perkataan yang digunakan
penyiapan akan dijana). Sasaran penyiapan adalah terhad kepada
baki perkataan dan mana-mana tindakans untuk corak yang sepadan dilaksanakan. Dalam
kes ini, tiada apa yang dilucutkan daripada rentetan baris arahan. Perintah daripada
penilaian terhadap tindakans boleh ditentukan oleh perintah tag gaya; pelbagai
format yang disokong oleh _alternatif boleh digunakan dalam tindakan. Yang penghuraian digunakan untuk
menyediakan parameter tatasusunan mengeksploitasi.

Argumen spesifikasi mengambil salah satu daripada bentuk berikut, di mana metacharacter sedemikian
sebagai `(', `)', `#' dan `|' hendaklah dipetik.

/pola/ [%pandang kehadapan%] [-pengawal] [:tag:penghuraian:tindakan]
Ini adalah komponen primitif tunggal. Fungsi menguji sama ada
corak gabungan `(#b)((#B)pola)pandang kehadapan*' sepadan dengan baris arahan
tali. Jika ya, `pengawal' dinilai dan status pemulangannya diperiksa
menentukan sama ada ujian itu berjaya. The pola rentetan `[]' dijamin
tidak pernah sepadan. The pandang kehadapan tidak dilucutkan daripada baris arahan sebelum ini
corak seterusnya diteliti.

Hujah bermula dengan : digunakan dengan cara yang sama seperti hujah untuk
_alternatif.

Komponen digunakan seperti berikut: pola diuji untuk melihat sama ada komponen
sudah wujud pada baris arahan. Jika ia berlaku, mana-mana berikut
spesifikasi diperiksa untuk mencari sesuatu untuk dilengkapkan. Jika komponen
dicapai tetapi tiada corak sedemikian wujud lagi pada baris arahan, rentetan
mengandungi tindakan digunakan untuk menjana padanan untuk disisipkan pada ketika itu.

/pola/+ [%pandang kehadapan%] [-pengawal] [:tag:penghuraian:tindakan]
Ini serupa dengan `/pola/ ...' tetapi bahagian kiri baris arahan
rentetan (iaitu bahagian yang telah dipadankan dengan corak sebelumnya) juga
dianggap sebagai sebahagian daripada sasaran penyiapan.

/pola/- [%pandang kehadapan%] [-pengawal] [:tag:penghuraian:tindakan]
Ini serupa dengan `/pola/ ...' tetapi tindakans daripada semasa dan
corak yang dipadankan sebelum ini diabaikan walaupun `pola'
sepadan dengan rentetan kosong.

( spec )
Tanda kurung boleh digunakan untuk kumpulan specs; ambil perhatian setiap kurungan adalah tunggal
hujah untuk _regex_arguments.

spec # Ini membolehkan sebarang bilangan ulangan spec.

spec spec
Dua specs hendaklah dipadankan satu demi satu seperti yang diterangkan di atas.

spec | spec
salah satu daripada keduanya specs boleh dipadankan.

Majlis tersebut _regex_words boleh digunakan sebagai fungsi pembantu untuk menjana padanan untuk
satu set perkataan alternatif yang mungkin dengan hujah mereka sendiri sebagai baris arahan
hujah.

Contoh:

_regex_arguments _tst /$'[^\0]#\0'/ \
/$'[^\0]#\0'/ :'compadd aaa'

Ini menjana fungsi _tst yang melengkapkan aaa sebagai satu-satunya hujahnya. The tag
and Penerangan kerana tindakan itu telah ditinggalkan untuk ringkas (ini berfungsi tetapi tidak
disyorkan dalam penggunaan biasa). Komponen pertama sepadan dengan kata perintah, iaitu
sewenang-wenangnya; yang kedua sepadan dengan sebarang hujah. Oleh kerana hujah itu juga sewenang-wenangnya,
mana-mana komponen berikut tidak akan bergantung kepada aaa sedang hadir.

_regex_arguments _tst /$'[^\0]#\0'/ \
/$'aaa\0'/ :'compadd aaa'

Ini adalah penggunaan yang lebih tipikal; ia adalah serupa, tetapi mana-mana corak berikut sahaja
padankan jika aaa hadir sebagai hujah pertama.

_regex_arguments _tst /$'[^\0]#\0'/ \( \
/$'aaa\0'/ :'compadd aaa' \
/$'bbb\0'/ :'compadd bbb' \) \#

Dalam contoh ini, bilangan argumen perintah yang tidak ditentukan boleh dilengkapkan. ganjil
hujah diselesaikan sebagai aaa dan juga hujah sebagai bbb. Penyiapan gagal melainkan
set daripada aaa and bbb hujah sebelum yang semasa dipadankan dengan betul.

_regex_arguments _tst /$'[^\0]#\0'/ \
\( /$'aaa\0'/ :'compadd aaa' \| \
/$'bbb\0'/ :'compadd bbb' \) \#

Ini serupa, tetapi sama ada aaa or bbb boleh dilengkapkan untuk sebarang hujah. Di dalam ini
kes _regex_words boleh digunakan untuk menghasilkan ungkapan yang sesuai untuk
hujah-hujah.

_regex_words tag Penerangan spec ...
Fungsi ini boleh digunakan untuk menjana hujah untuk _regex_arguments arahan
yang boleh dimasukkan pada bila-bila masa di mana satu set peraturan dijangka. The tag and
Penerangan berikan teg dan huraian standard yang berkaitan dengan konteks semasa.
setiap spec mengandungi dua atau tiga hujah yang dipisahkan oleh titik bertindih: ambil perhatian bahawa ada
tiada kolon utama dalam kes ini.

setiap spec memberikan satu set perkataan yang boleh dilengkapkan pada ketika ini, bersama-sama
dengan hujah. Oleh itu, ia hampir sama dengan _hujah berfungsi apabila digunakan
dalam penyiapan biasa (bukan regex).

Bahagian dari spec sebelum titik bertindih pertama ialah perkataan yang perlu dilengkapkan. Ini mungkin
mengandungi a *; keseluruhan perkataan, sebelum dan selepas * selesai, tetapi hanya
teks sebelum * diperlukan untuk konteks dipadankan, supaya selanjutnya
hujah boleh dilengkapkan selepas borang yang disingkatkan.

Bahagian kedua daripada spec ialah keterangan bagi perkataan yang sedang dilengkapkan.

Bahagian ketiga pilihan daripada spec menerangkan bagaimana perkataan mengikut makhluk yang satu
selesai adalah sendiri untuk disiapkan. Ia akan dinilai untuk mengelakkan
masalah dengan petikan. Ini bermakna lazimnya ia mengandungi rujukan kepada an
tatasusunan yang mengandungi argumen regex yang dijana sebelum ini.

pilihan -t jangka menentukan penamat untuk perkataan dan bukannya ruang biasa.
Ini dikendalikan sebagai akhiran boleh alih automatik mengikut cara pilihan -s September kepada
_nilai.

Hasil pemprosesan oleh _regex_words diletakkan dalam tatasusunan membalas, Yang
hendaklah dibuat setempat kepada fungsi panggilan. Jika himpunan perkataan dan hujah
boleh dipadankan berulang kali, a # hendaklah dilampirkan pada tatasusunan yang dijana pada masa itu
titik.

Sebagai contoh:

tempatan -a membalas
_regex_words mydb-commands 'mydb perintah' \
'tambah:tambah an kemasukan kepada mydb:$mydb_add_cmds' \
'tunjukkan:tunjukkan penyertaan in mydb'
_regex_arguments _mydb "$reply[@]"
_mydb "$@"

Ini menunjukkan fungsi penyiapan untuk arahan mydb yang mengambil dua perintah
hujah, menambah and Menunjukkan. Menunjukkan tidak mengambil hujah, manakala hujah untuk menambah mempunyai
sudah disediakan dalam tatasusunan mydb_add_cmds, kemungkinan besar melalui panggilan sebelumnya
kepada _regex_words.

_diminta [ -x ] [ -12VJ ] tag [ nama penghuraian [ arahan [ berhujah ... ] ]
Fungsi ini dipanggil untuk memutuskan sama ada teg telah didaftarkan melalui panggilan ke
_tags (lihat di bawah) telah diminta oleh pengguna dan oleh itu penyiapan sepatutnya
dilakukan untuknya. Ia mengembalikan status sifar jika teg diminta dan bukan sifar
sebaliknya. Fungsi ini biasanya digunakan sebagai sebahagian daripada gelung pada tag yang berbeza sebagai
ikut:

_tags foo bar asas
manakala _tag; do
if _diminta foo; kemudian
... # melaksanakan siap khususnya foo
fi
... # ujian yang tags bar and asas in yang sama cara
... # keluar gelung if perlawanan adalah dijana
dilakukan

Ambil perhatian bahawa ujian untuk sama ada padanan dijana tidak dilakukan sehingga
akhir dari _tags gelung. Ini supaya pengguna boleh menetapkan perintah tag gaya ke
tentukan satu set tag untuk dilengkapkan pada masa yang sama.

If nama and penghuraian diberikan, _diminta memanggil _penerangan berfungsi dengan ini
hujah bersama dengan pilihan yang diserahkan kepada _diminta.

If arahan diberikan, iaitu _semua_label fungsi akan dipanggil serta-merta dengan
hujah yang sama. Dalam kes-kes yang mudah ini memungkinkan untuk melakukan ujian untuk
tag dan padanan sekali gus. Sebagai contoh:

tempatan mengeksploitasi ret=1
_tags foo bar asas
manakala _tag; do
_diminta foo mengeksploitasi 'keterangan' \
kompadd foobar foobaz && ret=0
...
(( penolakan )) || memecahkan
dilakukan

Jika arahan tidak kompadd, ia bagaimanapun mesti bersedia untuk mengendalikan perkara yang sama
pilihan.

_mendapatkan_cache pengecam_cache
Fungsi ini mendapatkan semula maklumat penyiapan daripada fail yang diberikan oleh
pengecam_cache, disimpan dalam direktori yang ditentukan oleh laluan cache gaya yang
lalai kepada ~/.zcompcache. Status pemulangan adalah sifar jika pengambilan berjaya.
Ia hanya akan cuba mendapatkan semula jika guna-cache gaya ditetapkan, jadi anda boleh memanggil ini
berfungsi tanpa perlu risau sama ada pengguna mahu menggunakan lapisan caching.

Lihat _store_cache di bawah untuk butiran lanjut.

_sep_bahagian
Fungsi ini diluluskan tatasusunan berselang-seli dan pemisah sebagai argumen. Tatasusunan
nyatakan penyiapan bagi bahagian rentetan yang akan dipisahkan oleh pemisah. The
tatasusunan mungkin nama parameter tatasusunan atau senarai perkataan yang dipetik dalam
kurungan. Sebagai contoh, dengan tatasusunan `hos=(ftp berita)'panggilan itu'_sep_bahagian
'(foo bar)' @ tuan rumah' akan melengkapkan rentetan `f' kepada `foo' dan rentetan `b@n'ke
`bar@berita'.

Fungsi ini menerima kompadd pilihan `-V', `-J', `-1', `-2', `-n', `-X', `-M',
`-P', `-S', `-r', `-R', dan `-q' dan menyerahkannya kepada kompadd terbina dulu
tambah padanan.

_urutan [ -s September ] [ -n maks ] [ -d ] fungsi [ - ] ...
Fungsi ini adalah pembalut kepada fungsi lain untuk melengkapkan item secara berasingan
senarai. Fungsi yang sama digunakan untuk melengkapkan setiap item dalam senarai. Pemisah adalah
dinyatakan dengan -s pilihan. Jika -s ditinggalkan ia akan menggunakan `,'. Nilai pendua
tidak dipadankan melainkan -d dinyatakan. Jika terdapat bilangan tetap atau maksimum
item dalam senarai, ini boleh ditentukan dengan -n pilihan.

Common kompadd pilihan diteruskan ke fungsi. Ia adalah mungkin untuk digunakan kompadd
secara langsung dengan _urutan, walaupun _nilai mungkin lebih sesuai dalam situasi ini.

_setup tag [ kumpulan ]
Fungsi ini menyediakan parameter khas yang digunakan oleh sistem penyiapan
sewajarnya untuk tag diberikan sebagai hujah pertama. Ia menggunakan gaya
senarai-warna, penuh senarai, senarai-baris-dahulu, segera terakhir, terima-tepat, menu and
senarai paksa.

Pilihannya kumpulan membekalkan nama kumpulan di mana perlawanan akan diadakan
ditempatkan. Jika ia tidak diberikan, yang tag digunakan sebagai nama kumpulan.

Fungsi ini dipanggil secara automatik daripada _penerangan dan oleh itu tidak seperti biasa
dipanggil secara eksplisit.

_store_cache pengecam_cache param ...
Fungsi ini, bersama-sama dengan _mendapatkan_cache and _cache_invalid, melaksanakan a
lapisan caching yang boleh digunakan dalam mana-mana fungsi penyiapan. Data yang diperolehi oleh
operasi yang mahal disimpan dalam parameter; fungsi ini kemudian membuang nilai-nilai
parameter tersebut ke fail. Data kemudiannya boleh diambil semula dengan cepat daripada fail itu
melalui _mendapatkan_cache, walaupun dalam keadaan berbeza shell.

. pengecam_cache menentukan fail yang mana data harus dibuang. The
fail disimpan dalam direktori yang ditentukan oleh laluan cache gaya yang lalai kepada
~/.zcompcache. Baki params argumen ialah parameter untuk dibuang ke
fail.

Status pemulangan adalah sifar jika storan berjaya. Fungsi hanya akan
cuba menyimpan jika guna-cache gaya ditetapkan, jadi anda boleh memanggil fungsi ini
tanpa perlu risau sama ada pengguna mahu menggunakan lapisan caching.

Fungsi penyelesaian mungkin mengelakkan panggilan _mendapatkan_cache apabila ia sudah mempunyai
data penyiapan tersedia sebagai parameter. Walau bagaimanapun, dalam kes itu ia harus memanggil
_cache_invalid untuk menyemak sama ada data dalam parameter dan dalam cache adalah
masih sah.

Lihat fungsi penyiapan _perl_modules untuk contoh mudah penggunaan
lapisan caching.

_tags [ [ -C nama ] tag ... ]
Jika dipanggil dengan hujah, ini dianggap sebagai nama tag yang sah untuknya
penyiapan dalam konteks semasa. Teg ini disimpan secara dalaman dan diisih mengikut
menggunakan perintah tag gaya.

Seterusnya, _tags dipanggil berulang kali tanpa hujah dari penyelesaian yang sama
fungsi. Ini berturut-turut memilih set teg pertama, kedua, dsb. yang diminta
oleh pengguna. Status pemulangan adalah sifar jika sekurang-kurangnya satu daripada teg diminta
dan bukan sifar sebaliknya. Untuk menguji sama ada teg tertentu ingin dicuba, teg _diminta
fungsi harus dipanggil (lihat di atas).

Jika `-C nama' diberikan, nama disimpan sementara dalam medan hujah (yang kelima)
konteks dalam konteks singkat parameter semasa panggilan ke _tags; padang adalah
dipulihkan semasa keluar. Ini membenarkan _tags untuk menggunakan konteks yang lebih khusus tanpa perlu
untuk menukar dan menetapkan semula konteks singkat parameter (yang mempunyai kesan yang sama).

_nilai [ -O nama ] [ -s September ] [ -S September ] [ -wC ] menurun spec ...
Ini digunakan untuk melengkapkan kata kunci (nilai) arbitrari dan hujah atau senarainya
daripada gabungan tersebut.

Jika hujah pertama ialah pilihan `-O nama', ia akan digunakan dengan cara yang sama seperti
oleh _hujah fungsi. Dengan kata lain, unsur-unsur nama array akan menjadi
berlalu ke kompadd semasa melaksanakan sesuatu tindakan.

Jika hujah pertama (atau hujah pertama selepas `-O nama') ialah `-s', seterusnya
argumen digunakan sebagai aksara yang memisahkan berbilang nilai. watak ini
ditambah secara automatik selepas setiap nilai dalam fesyen boleh alih automatik (lihat di bawah);
semua nilai dilengkapkan oleh `_nilai -s' muncul dalam perkataan yang sama pada baris arahan,
tidak seperti selesai menggunakan _hujah. Jika pilihan ini tidak ada, hanya satu
nilai akan dilengkapkan setiap perkataan.

Biasanya, _nilai hanya akan menggunakan perkataan semasa untuk menentukan nilai yang mana
sudah ada pada baris arahan dan oleh itu tidak akan disiapkan lagi. Jika
yang -w pilihan diberikan, hujah lain juga diteliti.

Argumen bukan pilihan pertama digunakan sebagai rentetan untuk dicetak sebagai penerangan sebelum ini
menyenaraikan nilai.

Semua hujah lain menerangkan nilai yang mungkin dan hujahnya sama
format yang digunakan untuk penerangan pilihan oleh _hujah fungsi (lihat di atas).
Satu-satunya perbezaan ialah tiada tanda tolak atau tambah diperlukan pada permulaan,
nilai hanya boleh mempunyai satu hujah, dan bentuk tindakan bermula dengan yang sama
tanda tidak disokong.

Watak yang memisahkan nilai daripada hujahnya boleh ditetapkan menggunakan pilihan -S
(seperti -s, diikuti dengan watak untuk digunakan sebagai pemisah dalam hujah seterusnya).
Secara lalai, tanda sama akan digunakan sebagai pemisah antara nilai dan
hujah-hujah.

Contoh:

_nilai -s , 'keterangan' \
'*foo[bar]' \
'(dua)*satu[nombor]:pertama kira:' \
'dua [satu lagi nombor]::kedua kiraan: (1 2 3)'

Ini menerangkan tiga nilai yang mungkin: `foo', `1', dan `2'. Yang pertama ialah
digambarkan sebagai `bar', tidak mengambil hujah dan mungkin muncul lebih daripada sekali. Yang kedua ialah
digambarkan sebagai `nombor', mungkin muncul lebih daripada sekali, dan mengambil satu hujah wajib
digambarkan sebagai `pertama mengira'; tiada tindakan dinyatakan, jadi ia tidak akan selesai.
`(dua)' pada mulanya mengatakan bahawa jika nilai `1' adalah pada baris, nilai
`2' tidak lagi dianggap sebagai kemungkinan siap. Akhirnya, nilai terakhir
(`2') digambarkan sebagai `lain nombor' dan mengambil hujah pilihan yang diterangkan
sebagai `kedua mengira' yang mana penyiapan (akan muncul selepas `=') ialah `1', `2',
dan `3'. The _nilai fungsi akan melengkapkan senarai nilai ini dipisahkan oleh
koma.

suka _hujah, fungsi ini menambah satu lagi komponen nama konteks buat sementara waktu
elemen hujah (kelima) konteks semasa semasa melaksanakan
tindakan. Di sini nama ini hanyalah nama nilai yang menjadi hujahnya
selesai.

Gaya kata kerja digunakan untuk memutuskan sama ada huraian untuk nilai (tetapi tidak
mereka untuk hujah) hendaklah dicetak.

Tatasusunan bersekutu val_args digunakan untuk melaporkan nilai dan hujahnya; ini
berfungsi sama dengan opt_args tatasusunan bersekutu yang digunakan oleh _hujah. Oleh itu
panggilan fungsi _nilai harus mengisytiharkan parameter tempatan adalah, state_descr,
selaras, konteks and val_args:

tempatan konteks adalah state_descr selaras
set taip -A val_args

apabila menggunakan tindakan dalam bentuk `->rentetan'. Dengan fungsi ini konteks
parameter akan ditetapkan kepada nama nilai yang hujahnya akan dilengkapkan.
Perhatikan bahawa untuk _nilai, yang adalah and state_descr ialah skalar dan bukannya tatasusunan.
Hanya satu keadaan padanan dikembalikan.

Perhatikan juga bahawa _nilai biasanya menambah aksara yang digunakan sebagai pemisah antara
nilai sebagai akhiran boleh alih automatik (serupa dengan `/' selepas direktori). Walau bagaimanapun,
ini tidak mungkin untuk `->rentetan' tindakan sebagai padanan untuk hujah adalah
dihasilkan oleh fungsi panggilan. Untuk mendapatkan tingkah laku biasa, panggilan
fungsi boleh menambah pemisah x sebagai akhiran dengan melepasi pilihan `-qS x' sama ada
secara langsung atau tidak langsung kepada kompadd.

pilihan -C diperlakukan dengan cara yang sama seperti yang dilakukan oleh _hujah. Dalam kes itu
parameter konteks singkat hendaklah dibuat tempatan bukannya konteks (seperti yang diterangkan di atas).

_mahu [ -x ] [ -C nama ] [ -12VJ ] tag nama penghuraian arahan [ berhujah ...]
Dalam banyak konteks, penyiapan hanya boleh menjana satu set padanan tertentu,
biasanya sepadan dengan tag tunggal. Walau bagaimanapun, ia masih perlu untuk membuat keputusan
sama ada pengguna memerlukan padanan jenis ini. Fungsi ini berguna dalam a
kes.

Hujah untuk _mahu adalah sama seperti yang kepada _diminta, iaitu hujah untuk menjadi
berlalu ke _penerangan. Walau bagaimanapun, dalam kes ini arahan bukan pilihan; semua
pemprosesan teg, termasuk gelung pada kedua-dua teg dan label teg dan
penjanaan perlawanan, dijalankan secara automatik oleh _mahu.

Oleh itu untuk menawarkan hanya satu tag dan serta-merta menambah padanan yang sepadan dengan
penerangan yang diberikan:

tempatan mengeksploitasi
_mahu tag mengeksploitasi 'keterangan' \
kompadd padanan ...

Perhatikan bahawa, untuk _diminta, yang arahan mesti boleh menerima pilihan untuk menjadi
diturunkan kepada kompadd.

suka _tags fungsi ini menyokong -C pilihan untuk memberikan nama yang berbeza untuk
medan konteks hujah. The -x pilihan mempunyai maksud yang sama seperti untuk _penerangan.

SELESAI DIREKTORI

Dalam pengedaran sumber, fail terkandung dalam pelbagai subdirektori bagi
Selesai direktori. Mereka mungkin telah dipasang dalam struktur yang sama, atau menjadi satu
direktori fungsi tunggal. Berikut adalah penerangan tentang fail yang terdapat dalam
struktur direktori asal. Jika anda ingin mengubah fail yang dipasang, anda perlu
salin ke beberapa direktori yang muncul lebih awal dalam anda fpath daripada direktori standard
di mana ia muncul.

Asas Fungsi teras dan widget penyiapan khas secara automatik terikat pada kekunci. awak
pastinya akan memerlukan kebanyakan ini, walaupun mungkin tidak perlu mengubahnya.
Banyak daripada ini didokumenkan di atas.

Zsh Fungsi untuk melengkapkan hujah perintah terbina dalam shell dan fungsi utiliti
untuk ini. Sebahagian daripada ini juga digunakan oleh fungsi dari Unix direktori.

Unix Berfungsi untuk melengkapkan hujah perintah luaran dan set perintah.
Mereka mungkin memerlukan pengubahsuaian untuk sistem anda, walaupun dalam banyak kes beberapa percubaan adalah
dibuat untuk menentukan versi arahan yang ada. Sebagai contoh, penyiapan untuk
yang mount arahan cuba menentukan sistem yang sedang dijalankan, semasa selesai
untuk banyak utiliti lain cuba tentukan sama ada versi GNU arahan itu ada
gunakan, dan oleh itu sama ada - membantu pilihan disokong.

X, AIX, BSD...
Fungsi penyiapan dan utiliti untuk arahan hanya tersedia pada beberapa sistem. Ini
tidak disusun secara hierarki, jadi, sebagai contoh, kedua-duanya Linux and Debian
direktori, serta X direktori, mungkin berguna pada sistem anda.

Gunakan zshcompsys dalam talian menggunakan perkhidmatan onworks.net