complete [-abcdefgjksuv] [-o tamamlama-seçeneği] [-A eylem] [-G genel-kalıp]
[-W sözcük-listesi] [-P önek] [-S sonek] [-X süzgeç-kalıbı]
[-F işlev] [-C komut] isim [isim …]
complete -pr [isim …]
Argümanların her isime nasıl tamamlanması
gerektiği belirtilir. -p seçeneği verilirse veya
hiç seçenek verilmezse, mevcut tamamlama belirtimleri girdi olarak
yeniden kullanılabilir şekilde basılır. -r seçeneği
her isim için tamamlama belirtimini kaldırır,
hiç isim belirtilmezse tümü kaldırılır.
Sözcük tamamlaması yapılmaya çalışıldığında, bu tamamlama belirtimlerinin
uygulanma süreci
Programlanabilir Tamamlama bölümünde
açıklanmıştır.
Diğer seçenekler belirtildiklerinde aşağıdaki anlamlara gelirler.
-G, -W ve -X
(ve lazımsa -P ve -S)
seçeneklerinin argümanları, complete yerleşiği
çağrılmadan önce yorumlanmaması için tırnak içine alınmış olmalıdır.
-
-o tamamlama-seçeneği
tamamlama-seçeneği tamamlamaların
basit üretimi dışında tamamlama belirtiminin çeşitli davranış
biçimlerini kontrol eder. tamamlama-seçeneği
aşağıdakilerden biri olabilir:
- bashdefault
Tamamlama belirtimi hiç eşleşme üretemezse öntanımlı Bash tamamlamalarının kalanı uygulanır.
- default
Tamamlama belirtimi hiç eşleşme üretemezse Readline'ın
öntanımlı dosyaismitamamlaması kullanılır.
- dirnames
Tamamlama belirtimi hiç eşleşme üretemezse, dizin ismi
tamamlaması uygulanır.
- filenames
Readline'a tamamlama belirtiminin dosyaisimlerini
üretmesini söyler, böylece dosyaismine özel işlemleri
uygulayabilir (dizin isimlerine / eklemek veya
sondaki boşlukların kaldırılması gibi işlemler).
Bu seçenek, -F seçeneği ile
belirtilen kabuk işlevleriyle kullanmak için düşünülmüştür.
- nospace
Readline'a bir sözcüğü tamamlamak için satır sonundayken bir boşluk eklememesini söyler.
- plusdirs
Tamamlama belirtimi tarafından tanımlanmış eşleşmeler üretildikten sonra dizin ismi tamamlanmaya çalışılır ve eşleşenler diğer eylemlerin sonuçlarına eklenir.
- -A eylem
eylem, olası tamamlamaların bir listesinin
üretilmesi için kullanılan aşağıdaki seçeneklerden biridir:
- alias
Takma adlar. -a seçeneği ile aynıdır.
- arrayvar
Dizi değişkeni isimleri.
- binding
- builtin
Kabuk yerleşik komutlarının isimleri. -b seçeneği ile aynıdır.
- command
Komut isimleri. -c seçeneği ile aynıdır.
- directory
Dizin isimleri. -d seçeneği ile aynıdır.
- disabled
İptal edilmiş kabuk yerleşikleri.
- enabled
Etkin kabuk yerleşiklerinin isimleri.
- export
Ortama aktarılmış kabuk değişkenlerinin isimleri.
-e seçeneği ile aynıdır.
- file
Dosya ismi. -f seçeneği ile aynıdır.
- function
Kabuk işlevlerinin isimleri.
- group
Grup isimleri. -g seçeneği ile aynıdır.
- helptopic
- hostname
- job
İş denetimi etkinse, iş isimleri. -j seçeneği ile aynıdır.
- keyword
Kabuk anahtar sözcükleri. -k seçeneği ile aynıdır.
- running
İş denetimi etkinse, çalışan işlerin isimleri.
- service
Servis isimleri. Ayrıca -s olarak da belirtilebilir.
- setopt
- shopt
- signal
Sinyal isimleri
- stopped
İş denetimi etkinse, durmuş işlerin isimleri.
- user
Kullanıcı isimleri. -u seçeneği ile aynıdır.
- variable
Tüm kabuk değişkenlerinin isimleri. -v seçeneği ile aynıdır.
- -G genel-kalıp
Dosyaismi yorumlama kalıbı genel-kalıp,
olası tamamlamaları üretmek için yorumlanır.
- -W sözcük-listesi
sözcük-listesi IFS
özel değişkenindeki karakterler ayraç olarak kullanılarak
ayrıştırılır ve elde edilen sözcük yorumlanır. Olası tamamlamalar,
tamamlanması istenen sözcükle eşleşen sonuç listesinin üyeleridir.
- -C komut
komut bir altkabuk ortamında
çalıştırılır ve çıktısı olası tamamlamalar olarak kullanılır.
- -F işlev
Kabuk işlevi
işlev bulunulan kabuk
ortamında çalıştırılır. Bittiğinde olası tamamlamalar
COMPREPLY
dizi değişkeninden alınır.
- -X süzgeç-kalıbı
süzgeç-kalıbı dosyaismi yorumlaması
için kullanılan bir kalıptır. Önceki seçenek ve argümanlar
tarafından üretilen olası tamamlamaların listesine uygulanır ve
süzgeç-kalıbı ile eşleşen her tamamlama
listeden kaldırılır. Bir ! ile öncelenirse
kalıp zıt işlem yapar yani, eşleşmeyenler listeden kaldırılır.
- -P önek
Tüm seçenekler uygulandıktan sonra her olası tamamlamanın
başlangıcına önek eklenir.
- -S sonek
Tüm seçenekler uygulandıktan sonra her olası tamamlamanın
sonuna sonek eklenir.
Bir geçersiz seçenek verilmedikçe, -p veya
-r seçenekleri dışında bir seçenek bir isim argümanı
ile verilmedikçe, hiç belirtimi olmayan bir isim için bir tamamlama
belirtimi kaldırılmaya çalışılmadıkça veya bir tamamlama belirtimine
eklemenin bir hata oluşturması dışında dönüş durumu sıfırdır.