ctags-exuberant - Dalam Talian di Awan

JADUAL:

NAMA

ctags - Hasilkan fail tag untuk kod sumber

SINOPSIS

ctag [pilihan] [fail (s)]

etags [pilihan] [fail (s)]

DESCRIPTION

. ctag and etags program (selepas ini secara kolektif dirujuk sebagai ctag, kecuali di mana
dibezakan) menjana fail indeks (atau "tag") untuk pelbagai objek bahasa yang ditemui
in fail (s). Fail tag ini membolehkan item ini dikesan dengan cepat dan mudah oleh teks
editor atau utiliti lain. "tag" menandakan objek bahasa yang mana masukan indeksnya
tersedia (atau, sebagai alternatif, entri indeks yang dibuat untuk objek itu).

Sebagai alternatif, ctag boleh menjana fail rujukan silang yang menyenaraikan, dalam boleh dibaca manusia
borang, maklumat tentang pelbagai objek sumber yang terdapat dalam set fail bahasa.

Fail indeks teg disokong oleh banyak editor, yang membolehkan pengguna mencari fail
objek yang dikaitkan dengan nama yang muncul dalam fail sumber dan melompat ke fail dan baris
yang mentakrifkan nama. Mereka yang diketahui pada masa keluaran ini ialah:

Vi(1) dan terbitannya (cth. Elvis, Vim, Vile, Lemmy), CRiSP, Emacs, FTE (Lipat
Editor Teks), JED, jEdit, Dilombong, Nedit (Suntingan Nirvana), TSE (Editor SemWare),
UltraEdit, Ruang Kerja, X2, Zeus

Ctags mampu menghasilkan pelbagai jenis teg untuk setiap satu daripada banyak teg yang berbeza
bahasa. Untuk senarai lengkap bahasa yang disokong, nama yang digunakan
dikenali, dan jenis teg yang dijana untuk setiap satu, lihat --senarai-bahasa
and --senarai-jenis pilihan.

SUMBER FILES

Kecuali --daya-bahasa pilihan ditentukan, bahasa setiap fail sumber ialah
dipilih secara automatik berdasarkan pemetaan nama fail kepada bahasa. Pemetaan dalam
kesan untuk setiap bahasa boleh dipaparkan menggunakan --list-maps pilihan dan boleh diubah
menggunakan --langmap pilihan. Pada platform yang menyokongnya, jika nama fail tidak
dipetakan ke bahasa dan fail boleh laku, baris pertama fail ditandakan ke
lihat jika fail itu ialah "#!" skrip untuk bahasa yang diiktiraf.

Secara lalai, semua nama fail lain diabaikan. Ini membenarkan berjalan ctag pada semua fail dalam
sama ada satu direktori (cth. "ctags *"), atau pada semua fail dalam keseluruhan direktori sumber
pokok (cth. "ctags -R"), kerana hanya fail yang namanya dipetakan kepada bahasa akan
diimbas.

[Sebab sambungan .h dipetakan ke fail C++ dan bukannya fail C adalah kerana ia
adalah perkara biasa untuk menggunakan sambungan .h dalam C++, dan tiada kemudaratan yang menyebabkan mereka menganggapnya sebagai fail C++.]

PILIHAN

Walaupun banyak pilihan yang tersedia, lalai ditetapkan supaya ctag paling biasa
dilaksanakan tanpa sebarang pilihan (cth. "ctags *", atau "ctags -R"), yang akan mencipta fail tag
dalam direktori semasa untuk semua fail sumber yang diiktiraf. Pilihan yang diterangkan di bawah ialah
disediakan semata-mata untuk membolehkan jahitan tersuai untuk memenuhi keperluan khas.

Ambil perhatian bahawa ruang yang memisahkan pilihan satu huruf daripada parameternya adalah pilihan.

Perhatikan juga bahawa parameter boolean kepada pilihan bentuk panjang (yang bermula dengan "--"
dan itu mengambil "[=ya|tidak]"parameter) boleh ditinggalkan, dalam hal ini "=yes" tersirat.
(contohnya --sort adalah bersamaan dengan --sort=yes). Perhatikan lebih lanjut bahawa "=1" dan "=on" adalah dianggap
sinonim untuk "=yes", dan itu "=0" dan "=off" dianggap sinonim untuk "=tidak".

Sesetengah pilihan sama ada diabaikan atau berguna hanya apabila digunakan semasa berjalan dalam mod etags (lihat
-e pilihan). Pilihan sedemikian akan diperhatikan.

Kebanyakan pilihan mungkin muncul di mana-mana pada baris arahan, hanya mempengaruhi fail yang
ikut pilihan. Beberapa pilihan, bagaimanapun, mesti muncul sebelum nama fail pertama dan akan
diperhatikan sedemikian.

Pilihan yang menggunakan nama bahasa akan menerima nama tersebut sama ada dalam huruf besar atau kecil. Lihat
yang --senarai-bahasa pilihan untuk senarai lengkap nama bahasa terbina dalam.

-a Bersamaan dengan --lampirkan.

-B Gunakan corak carian ke belakang (cth. ?corak?). [Diabaikan dalam mod etags]

-e Dayakan mod etags, yang akan mencipta fail tag untuk digunakan dengan editor Emacs.
Sebagai alternatif, jika ctag dipanggil dengan nama yang mengandungi rentetan "etags" (sama ada oleh
menamakan semula, atau mencipta pautan ke, boleh laku), mod etags akan didayakan. ini
pilihan mesti muncul sebelum nama fail pertama.

-f fail tag
Gunakan nama yang ditentukan oleh fail tag untuk fail tag (lalai ialah "tag", atau "TAG" apabila
berjalan dalam mod etags). Jika fail tag ditentukan sebagai "-", kemudian fail tag ditulis
kepada output standard sebaliknya. Ctags akan berdegil enggan menerima pesanan jika fail tag
wujud dan baris pertamanya mengandungi sesuatu selain daripada baris tag yang sah. Ini akan
selamatkan leher anda jika anda tersilap menaip "ctags -f *.c", yang sebaliknya akan menulis ganti
fail C pertama anda dengan tag yang dihasilkan oleh yang lain! Ia juga akan menolak untuk menerima
nama fail berbilang aksara yang bermula dengan aksara '-' (sempang), kerana ini paling banyak
berkemungkinan bermakna anda meninggalkan nama fail tag dan pilihan ini cuba merebut fail
pilihan seterusnya sebagai nama fail. Jika anda benar-benar mahu menamakan fail tag output anda
"-ugly", nyatakan sebagai "./-ugly". Pilihan ini mesti muncul sebelum nama fail pertama.
Jika pilihan ini dinyatakan lebih daripada sekali, hanya yang terakhir akan digunakan.

-F Gunakan corak carian hadapan (cth. /pattern/) (lalai). [Diabaikan dalam mod etags]

-h senarai
Menentukan senarai sambungan fail, dipisahkan oleh noktah, yang akan
ditafsirkan sebagai fail termasuk (atau pengepala). Untuk menunjukkan fail tidak mempunyai sambungan, gunakan
tempoh yang tidak diikuti oleh aksara bukan tempoh (cth. ".", "..x", ".x."). Pilihan ini
hanya mempengaruhi cara skop jenis teg tertentu ditafsirkan (iaitu.
sama ada ia dianggap boleh dilihat secara global atau hanya boleh dilihat dalam
fail di mana ia ditakrifkan); ia tidak memetakan sambungan kepada mana-mana tertentu
bahasa. Mana-mana teg yang terletak dalam fail bukan termasuk dan tidak boleh dilihat (cth.
dipautkan ke) daripada fail lain dianggap mempunyai skop terhad fail (cth. statik).
Tiada jenis teg yang muncul dalam fail include akan dianggap mempunyai fail terhad
skop. Jika aksara pertama dalam senarai ialah tanda tambah, maka sambungan dalam
senarai akan dilampirkan pada senarai semasa; jika tidak, senarai akan menggantikan
senarai semasa. Lihat, juga, yang --skop-fail pilihan. Senarai lalai ialah
".h.H.hh.hpp.hxx.h++.inc.def". Untuk memulihkan senarai lalai, nyatakan -h lalai. Catatan
bahawa jika sambungan yang dibekalkan kepada pilihan ini belum dipetakan kepada yang tertentu
bahasa (lihat SUMBER FILES, di atas), anda juga perlu menggunakan sama ada --langmap or
--daya-bahasa pilihan.

-I senarai pengecam
Menentukan senarai pengecam yang akan dikendalikan khas semasa menghuraikan C dan
Fail sumber C++. Pilihan ini disediakan khusus untuk mengendalikan kes khas
timbul melalui penggunaan makro prapemproses. Apabila pengecam yang disenaraikan ialah
pengecam mudah, pengecam ini akan diabaikan semasa menghuraikan sumber
fail. Jika pengecam diakhiri dengan aksara '+', ctag juga akan mengabaikan mana-mana
senarai hujah yang dilampirkan kurungan yang mungkin mengikuti pengecam dalam
fail sumber. Jika dua pengecam dipisahkan dengan aksara '=', yang pertama
pengecam digantikan dengan pengecam kedua untuk tujuan penghuraian. senarai
pengecam boleh dibekalkan terus pada baris arahan atau dibaca dari yang berasingan
fail. Jika watak pertama daripada senarai pengecam ialah '@', '.' atau pemisah nama laluan
('/' atau '\'), atau dua aksara pertama menentukan huruf pemacu (cth. "C:"),
parameter senarai pengecam akan ditafsirkan sebagai nama fail untuk membaca senarai
pengecam, satu setiap baris input. Jika tidak, senarai pengecam adalah senarai
pengecam (atau pasangan pengecam) untuk dikendalikan khas, setiap satunya dibatasi oleh sama ada
koma atau dengan ruang putih (dalam hal ini senarai harus dipetik untuk menyimpan keseluruhan
senarai sebagai satu hujah baris arahan). Pelbagai -I pilihan mungkin dibekalkan. Untuk membersihkan
senarai abaikan pengecam, bekalkan satu sempang ("-") untuk senarai pengecam.

Ciri ini berguna apabila makro prapemproses digunakan sedemikian rupa sehingga ia
menyebabkan kekeliruan sintaksis kerana kehadiran mereka. Sesungguhnya, ini adalah cara terbaik
mengatasi beberapa masalah yang disebabkan oleh kehadiran makro penghalang sintaks
dalam fail sumber (lihat CATATAN, di bawah). Beberapa contoh akan menggambarkan perkara ini.

int foo ARGDECL4(void *, ptr, long int, nbait)

Dalam contoh di atas, makro "ARGDECL4" akan tersilap ditafsirkan sebagai
nama fungsi dan bukannya nama "foo" yang betul. Menentukan -I ARGDECL4
menghasilkan tingkah laku yang betul.

/* mencipta rentetan versi RCS dalam modul */
MODULE_VERSION("$Semakan: 750 $")

Dalam contoh di atas, seruan makro kelihatan terlalu banyak seperti definisi fungsi
kerana ia tidak diikuti oleh koma bertitik (malah, ia juga boleh diikuti oleh a
definisi pembolehubah global yang akan kelihatan seperti parameter fungsi gaya K&R
pengisytiharan). Malah, definisi fungsi yang kelihatan ini mungkin boleh menyebabkan
selebihnya fail untuk dilangkau semasa cuba melengkapkan definisi.
Menentukan -I MODUL_VERSION+ akan mengelakkan masalah sedemikian.

Contoh KELAS {
// kandungan anda di sini
};

Contoh di atas menggunakan "CLASS" sebagai makro prapemproses yang berkembang kepada sesuatu
berbeza untuk setiap platform. Contohnya CLASS boleh ditakrifkan sebagai "class
__declspec(dllexport)" pada platform Win32 dan hanya "kelas" pada UNIX. Biasanya,
ketiadaan "kelas" kata kunci C++ akan menyebabkan fail sumber menjadi tidak betul
dihuraikan. Tingkah laku yang betul boleh dipulihkan dengan menentukan -I KELAS=kelas.

-L fail
Baca dari fail senarai nama fail yang mana teg harus dijana. Jika fail is
dinyatakan sebagai "-", kemudian nama fail dibaca daripada input standard. Nama fail dibaca menggunakan
pilihan ini diproses berikutan nama fail yang muncul pada baris arahan. Pilihan
juga diterima dalam input ini. Jika pilihan ini dinyatakan lebih daripada sekali, hanya pilihan
terakhir akan digunakan. Catatan: fail dibaca dalam mod berorientasikan baris, di mana baris baharu ialah
hanya pembatas dan ruang putih tidak mengekor dianggap penting, supaya itu
nama fail yang mengandungi ruang boleh dibekalkan (bagaimanapun, ruang putih mengekori adalah
dilucutkan daripada baris); ini boleh menjejaskan cara pilihan dihuraikan jika disertakan dalam
input.

-n Bersamaan dengan --excmd=nombor.

-N Bersamaan dengan --excmd=pola.

-o fail tag
Bersamaan dengan -f fail tag.

-R Bersamaan dengan --berulang.

-u Bersamaan dengan --sort=tidak (iaitu "tidak diisih").

-V Bersamaan dengan --verbose.

-w Pilihan ini diabaikan secara senyap kerana keserasian ke belakang dengan ctag SVR4
Unix.

-x Cetak fail rujukan silang (xref) jadual yang boleh dibaca manusia kepada output standard
bukannya menjana fail tag. Maklumat yang terkandung dalam output termasuk:
nama tag; jenis tag; nombor baris, nama fail dan baris sumber (dengan
ruang putih tambahan dipekatkan) bagi fail yang mentakrifkan teg. Tiada fail tag
ditulis dan semua pilihan yang mempengaruhi output fail tag akan diabaikan. Contoh
aplikasi untuk ciri ini menjana senarai semua fungsi yang terletak di a
fail sumber (cth. ctag -x --c-jenis=f fail), atau menjana senarai semua secara luaran
pembolehubah global yang boleh dilihat terletak dalam fail sumber (cth. ctag -x --c-jenis=v
--skop-fail=tidak fail). Pilihan ini mesti muncul sebelum nama fail pertama.

--lampirkan[=yes|tidak]
Menunjukkan sama ada teg yang dijana daripada fail yang ditentukan harus dilampirkan pada fail tersebut
sudah ada dalam fail tag atau harus menggantikannya. Pilihan ini dimatikan oleh
lalai. Pilihan ini mesti muncul sebelum nama fail pertama.

--etag-termasuk=fail
Sertakan rujukan kepada fail dalam fail tag. Pilihan ini boleh ditentukan seberapa banyak
kali seperti yang dikehendaki. Ini menyokong keupayaan Emacs untuk menggunakan fail tag yang "termasuk"
fail tag lain. [Tersedia hanya dalam mod etags]

--kecualikan=[pola]
Tambah pola ke senarai fail dan direktori yang dikecualikan. Pilihan ini mungkin ditentukan
seberapa banyak yang dikehendaki. Untuk setiap nama fail yang dipertimbangkan oleh ctag, masing-masing pola
yang ditentukan menggunakan pilihan ini akan dibandingkan dengan kedua-dua laluan lengkap (cth.
some/path/base.ext) dan nama asas (cth. base.ext) fail, dengan itu membenarkan
corak yang sepadan dengan nama fail yang diberikan tanpa mengira laluannya, atau hanya sepadan dengan a
laluan tertentu. Jika sokongan yang sesuai tersedia daripada pustaka masa jalan C anda
pengkompil, kemudian pola mungkin mengandungi kad bebas shell biasa (bukan biasa
ekspresi) biasa pada Unix (pastikan anda memetik parameter pilihan untuk melindungi
kad bebas daripada dikembangkan oleh cangkerang sebelum dihantar ke ctag; juga menjadi
sedar bahawa kad bebas boleh memadankan aksara slash, '/'). Anda boleh menentukan sama ada shell
kad bebas tersedia pada platform anda dengan memeriksa output --versi
pilihan, yang akan termasuk "+wildcards" dalam senarai ciri yang disusun; jika tidak,
pola dipadankan dengan nama fail menggunakan perbandingan teks yang mudah.

If pola bermula dengan aksara '@', kemudian rentetan selebihnya ditafsirkan
sebagai nama fail untuk membaca corak pengecualian, satu setiap baris. Jika pola is
kosong, senarai corak yang dikecualikan dikosongkan. Ambil perhatian bahawa pada permulaan program,
senarai pengecualian lalai mengandungi "EIFGEN", "SCCS", "RCS" dan "CVS", yang merupakan nama
direktori yang pada umumnya tidak diingini untuk diturunkan semasa memproses
--berulang pilihan.

--excmd=jenis
Menentukan jenis perintah EX yang digunakan untuk mencari tag dalam fail sumber. [Diabaikan
dalam mod etags]

Nilai yang sah untuk jenis (sama ada keseluruhan perkataan atau huruf pertama diterima)
ialah:

nombor Gunakan hanya nombor baris dalam fail teg untuk mencari teg. Ini mempunyai empat
kelebihan:
1. Mengurangkan saiz fail tag yang terhasil dengan ketara.
2. Menghapuskan kegagalan untuk mencari tag kerana garis yang mentakrifkan tag mempunyai
berubah, menyebabkan padanan corak gagal (perhatikan bahawa sesetengah editor, seperti
as VIM, dapat pulih dalam banyak keadaan sedemikian).
3. Menghapuskan mencari padanan yang sama, tetapi tidak betul, baris sumber (lihat
BUANG, di bawah).
4. Mengekalkan entri berasingan dalam fail tag untuk baris yang serupa
dalam kandungan. Dalam pola mod, entri pendua digugurkan kerana
corak carian yang mereka hasilkan adalah sama, menjadikan pendua
entri tidak berguna.

Walau bagaimanapun, pilihan ini mempunyai satu kelemahan yang ketara: perubahan kepada sumber
fail boleh menyebabkan nombor baris yang direkodkan dalam fail tag tidak lagi
sepadan dengan baris dalam fail sumber, menyebabkan lompatan ke beberapa tag ke
terlepas definisi sasaran dengan satu atau lebih baris. Pada asasnya, pilihan ini adalah
paling baik digunakan apabila kod sumber yang digunakan tidak tertakluk kepada
ubah. Memilih jenis pilihan ini menyebabkan pilihan berikut menjadi
diabaikan: -BF.

pola Gunakan hanya corak carian untuk semua teg, bukannya nombor baris biasanya
digunakan untuk definisi makro. Ini mempunyai kelebihan tidak merujuk
nombor baris usang apabila baris telah ditambah atau dialih keluar sejak teg
fail telah dihasilkan.

bercampur Dalam mod ini, corak biasanya digunakan dengan beberapa pengecualian. Untuk C, garisan
nombor digunakan untuk teg definisi makro. Ini ialah format lalai
dihasilkan oleh yang asal ctag dan, oleh itu, dikekalkan sebagai lalai
untuk pilihan ini. Untuk Fortran, nombor baris digunakan untuk blok biasa
kerana talian sumber yang sepadan secara amnya adalah sama, menjadikan
carian corak tidak berguna untuk mencari semua padanan.

--tambahan=[+|-]bendera
Menentukan sama ada untuk memasukkan entri teg tambahan untuk jenis maklumat tertentu. The
parameter bendera ialah satu set bendera satu huruf, setiap satu mewakili satu jenis teg tambahan
entri untuk dimasukkan ke dalam fail tag. Jika bendera didahului oleh sama ada '+' atau '-'
watak, kesan setiap bendera ditambahkan pada, atau dialih keluar daripada, bendera pada masa ini
didayakan; jika tidak, bendera menggantikan sebarang tetapan semasa. Maksud setiap bendera
adalah seperti berikut:

f Sertakan entri untuk nama fail asas setiap fail sumber (cth.
"example.c"), yang menangani baris pertama fail.

q Sertakan entri teg layak kelas tambahan untuk setiap teg yang merupakan ahli a
kelas (untuk bahasa yang maklumat ini diekstrak; pada masa ini C++,
Eiffel, dan Jawa). Bentuk sebenar teg yang layak bergantung pada
bahasa dari mana teg itu diperoleh (menggunakan bentuk yang paling semula jadi untuk
cara panggilan yang layak dinyatakan dalam bahasa). Untuk C++, ia adalah dalam bentuk
"kelas::ahli"; untuk Eiffel dan Java, ia adalah dalam bentuk "class.member". ini
boleh membenarkan lokasi yang lebih mudah bagi teg tertentu apabila berbilang kejadian a
nama tag berlaku dalam fail tag. Walau bagaimanapun, ambil perhatian bahawa ini berpotensi
lebih daripada dua kali ganda saiz fail tag.

--bidang=[+|-]bendera
Menentukan medan sambungan tersedia yang akan disertakan dalam entri
fail tag (lihat TAG FAIL FORMAT, di bawah, untuk maklumat lanjut). Parameter bendera
ialah satu set bendera satu huruf, setiap satu mewakili satu jenis medan sambungan kepada
termasuk, dengan makna berikut (dilumpuhkan secara lalai melainkan dinyatakan):

a Akses (atau eksport) ahli kelas
f Skop terhad fail [didayakan]
i Maklumat pewarisan
k Jenis teg sebagai satu huruf [didayakan]
K Jenis tag sebagai nama penuh
l Bahasa fail sumber yang mengandungi tag
m Maklumat pelaksanaan
n Nombor baris definisi teg
s Skop definisi teg [didayakan]
S Tandatangan rutin (cth. prototaip atau senarai parameter)
z Sertakan kekunci "jenis:" dalam medan jenis
t Jenis dan nama pembolehubah atau typedef sebagai medan "typeref:" [didayakan]

Setiap huruf atau kumpulan huruf boleh didahului sama ada '+' untuk menambahkannya pada
set lalai, atau '-' untuk mengecualikannya. Sekiranya tiada tanda '+' atau '-' sebelumnya,
hanya jenis yang disenaraikan secara eksplisit bendera akan dimasukkan ke dalam output (iaitu.
mengatasi set lalai). Pilihan ini diabaikan jika pilihan --format=1 telah
ditentukan. Nilai lalai pilihan ini ialah fkst.

--skop-fail[=yes|tidak]
Menunjukkan sama ada teg diskop hanya untuk satu fail (iaitu teg yang tidak dapat dilihat
di luar fail di mana ia ditakrifkan, seperti teg "statik") sepatutnya
termasuk dalam output. Lihat, juga, yang -h pilihan. Pilihan ini didayakan secara lalai.

--penapis[=yes|tidak]
Punca ctag untuk berkelakuan sebagai penapis, membaca nama fail sumber daripada input standard dan
mencetak tag mereka kepada output standard berdasarkan fail demi fail. Jika --disusun is
didayakan, teg diisih hanya dalam fail sumber yang ditakrifkan. Fail
nama dibaca daripada input standard dalam mod input berorientasikan baris (lihat nota untuk -L
pilihan) dan hanya selepas nama fail disenaraikan pada baris arahan atau dari mana-mana fail
dibekalkan menggunakan -L pilihan. Apabila pilihan ini didayakan, pilihan -f, -o, dan
--jumlah tidak diendahkan. Pilihan ini agak esoterik dan dilumpuhkan secara lalai. ini
pilihan mesti muncul sebelum nama fail pertama.

--penapis-terminator=rentetan
Menentukan rentetan untuk dicetak ke output standard mengikut tag untuk setiap nama fail
dihuraikan apabila --penapis pilihan didayakan. Ini mungkin membenarkan bacaan permohonan
output ctags untuk menentukan apabila output bagi setiap fail selesai. Perhatikan bahawa
jika nama fail yang dibaca ialah direktori dan --berulang didayakan, rentetan ini akan menjadi
dicetak sekali sahaja pada penghujung semua teg yang ditemui dengan menurunkan direktori. ini
rentetan akan sentiasa dipisahkan daripada baris tag terakhir untuk fail olehnya
menamatkan baris baharu. Pilihan ini agak esoterik dan kosong secara lalai. ini
pilihan mesti muncul sebelum nama fail pertama.

--format=tahap
Tukar format fail tag output. Pada masa ini satu-satunya nilai yang sah untuk tahap
adalah 1 or 2. Tahap 1 menentukan format fail tag asal dan tahap 2 menentukan a
format lanjutan baharu yang mengandungi medan sambungan (tetapi dengan cara yang mengekalkan
keserasian ke belakang dengan asal vi(1) pelaksanaan). Tahap lalai ialah 2.
Pilihan ini mesti muncul sebelum nama fail pertama. [Diabaikan dalam mod etags]

- membantu
Mencetak kepada output standard penerangan penggunaan terperinci, dan kemudian keluar.

--jika0[=yes|tidak]
Menunjukkan keutamaan sama ada kod dalam cawangan "#if 0" prapemproses
bersyarat harus diperiksa untuk tag bukan makro (tag makro sentiasa disertakan).
Kerana niat binaan ini adalah untuk melumpuhkan kod, nilai lalai ini
pilihan adalah tidak. Ambil perhatian bahawa ini menunjukkan keutamaan sahaja dan tidak menjamin
melangkau kod dalam cawangan "#if 0", kerana algoritma sandaran digunakan
menjana tag apabila syarat prapemproses terlalu kompleks mengikut semua cabang
bersyarat. Pilihan ini dilumpuhkan secara lalai.

---macam=[+|-]jenis
Menentukan senarai jenis teg (atau jenis) khusus bahasa untuk disertakan dalam
fail output untuk bahasa tertentu, di mana tidak peka huruf besar dan kecil dan merupakan salah satu daripadanya
nama bahasa terbina dalam (lihat --senarai-bahasa pilihan untuk senarai lengkap).
Parameter tersebut jenis ialah sekumpulan bendera satu huruf yang menetapkan jenis teg
(terutama kepada bahasa) sama ada untuk memasukkan atau mengecualikan daripada output. The
set bendera tertentu yang diiktiraf untuk setiap bahasa, makna dan lalainya mungkin
disenaraikan menggunakan --senarai-jenis pilihan. Setiap huruf atau kumpulan huruf mungkin
didahului sama ada '+' untuk menambahnya, atau '-' untuk mengalih keluarnya daripada set lalai. Dalam
ketiadaan tanda '+' atau '-' sebelum ini, hanya jenis yang disenaraikan secara jelas dalam
jenis akan disertakan dalam output (iaitu mengatasi lalai untuk yang ditentukan
bahasa).

Sebagai contoh untuk bahasa C, untuk menambah prototaip dan pembolehubah luaran
pengisytiharan kepada set lalai jenis teg, tetapi tidak termasuk makro, gunakan
--c-jenis=+px-d; untuk memasukkan hanya tag untuk fungsi, gunakan --c-jenis=f.

--langdef=nama
Mentakrifkan bahasa yang ditakrifkan pengguna baharu, nama, untuk dihuraikan dengan ungkapan biasa.
Setelah ditakrifkan, nama boleh digunakan dalam pilihan lain yang mengambil nama bahasa. Yang tipikal
penggunaan pilihan ini adalah untuk mentakrifkan dahulu bahasa, kemudian memetakan nama fail kepadanya menggunakan
--langmap, kemudian tentukan ungkapan biasa menggunakan --regex- untuk menentukan bagaimana ia
tag ditemui.

--langmap=peta[,peta[...]]
Mengawal cara nama fail dipetakan kepada bahasa (lihat --list-maps pilihan). setiap satu
dipisahkan dengan koma peta terdiri daripada nama bahasa (sama ada terbina dalam atau ditentukan pengguna
bahasa), titik bertindih dan senarai sambungan fail dan/atau corak nama fail. Sebuah fail
sambungan ditentukan dengan mendahului sambungan dengan noktah (cth. ".c"). Sebuah fail
corak nama ditentukan dengan melampirkan corak dalam kurungan (cth.
"([Mm]akefile)"). Jika sokongan yang sesuai tersedia daripada pustaka runtime of
pengkompil C anda, maka corak nama fail mungkin mengandungi kad bebas shell biasa
biasa pada Unix (pastikan anda memetik parameter pilihan untuk melindungi kad bebas daripada
dikembangkan oleh cangkerang sebelum dihantar ke ctag). Anda boleh menentukan sama ada shell
kad bebas tersedia pada platform anda dengan memeriksa output --versi
pilihan, yang akan termasuk "+wildcards" dalam senarai ciri yang disusun; jika tidak, yang
corak nama fail dipadankan dengan nama fail menggunakan perbandingan tekstual yang mudah.
Apabila memetakan sambungan fail, ia akan dinyahpetakan terlebih dahulu daripada mana-mana bahasa lain.

Jika aksara pertama dalam peta ialah tanda tambah, maka sambungan dan nama fail
corak dalam peta itu akan dilampirkan pada peta semasa untuk bahasa itu;
jika tidak, peta akan menggantikan peta semasa. Sebagai contoh, untuk menyatakan itu sahaja
fail dengan sambungan .c dan .x akan dianggap sebagai fail bahasa C, gunakan
"--langmap=c:.cx"; untuk turut menambah fail dengan sambungan .j sebagai fail bahasa Java,
nyatakan "--langmap=c:.cx,java:+.j". Untuk memetakan makefiles (cth. fail bernama sama ada
"Makefile", "makefile", atau mempunyai sambungan ".mak") kepada bahasa yang dipanggil "make",
nyatakan "--langmap=buat:([Mm]akefile).mak". Untuk memetakan fail yang tidak mempunyai sambungan,
nyatakan tempoh yang tidak diikuti oleh aksara bukan tempoh (cth. ".", "..x", ".x."). Kepada
kosongkan pemetaan untuk bahasa tertentu (dengan itu menghalang penjanaan automatik
teg untuk bahasa itu), tentukan senarai sambungan kosong (cth.
"--langmap=fortran:"). Untuk memulihkan pemetaan bahasa lalai untuk semua perkara tertentu
bahasa, berikan kata kunci "lalai" untuk pemetaan. Untuk menentukan memulihkan
pemetaan bahasa lalai untuk semua bahasa, nyatakan "--langmap=lalai".Perhatikan bahawa
sambungan fail diuji sebelum corak nama fail apabila membuat kesimpulan bahasa a
fail.

--daya-bahasa=bahasa
Secara lalai, ctag secara automatik memilih bahasa fail sumber, mengabaikannya
fail yang bahasanya tidak dapat ditentukan (lihat SUMBER FILES, atas). Pilihan ini
memaksa yang ditentukan bahasa (tidak peka huruf besar-besaran; sama ada terbina dalam atau ditentukan pengguna) kepada
digunakan untuk setiap fail yang dibekalkan dan bukannya memilih bahasa berasaskan secara automatik
pada pelanjutannya. Di samping itu, nilai istimewa auto menunjukkan bahawa bahasa
hendaklah dipilih secara automatik (yang melumpuhkan pilihan ini dengan berkesan).

--bahasa=[+|-]senarai
Menentukan bahasa yang penjanaan teg didayakan, dengan senarai mengandungi a
senarai nama bahasa yang dipisahkan koma (tidak peka huruf besar-besaran; sama ada terbina dalam atau pengguna-
ditakrifkan). Jika bahasa pertama senarai tidak didahului oleh '+' atau '-', iaitu
senarai semasa akan dikosongkan sebelum menambah atau mengalih keluar bahasa dalam senarai. Sehingga a
'-' ditemui, setiap bahasa dalam senarai akan ditambah ke senarai semasa. Sebagai
sama ada '+' atau '-' ditemui dalam senarai, bahasa yang mengikutinya adalah
ditambah atau dialih keluar daripada senarai semasa, masing-masing. Oleh itu, ia menjadi mudah untuk
gantikan senarai semasa dengan yang baharu, atau untuk menambah atau mengalih keluar bahasa daripada
senarai semasa. Senarai sebenar fail yang mana teg akan dijana bergantung kepada
pemetaan sambungan bahasa berkuat kuasa (lihat --langmap pilihan). Perhatikan bahawa semua
bahasa, termasuk bahasa yang ditentukan pengguna didayakan melainkan dilumpuhkan secara eksplisit
menggunakan pilihan ini. Nama bahasa disertakan dalam senarai mungkin mana-mana bahasa terbina dalam atau
satu yang ditakrifkan sebelum ini dengan --langdef. Lalai ialah "semua", yang juga diterima
sebagai hujah yang sahih. Lihat --senarai-bahasa pilihan untuk senarai lengkap
nama bahasa terbina dalam.

--lesen
Mencetak ringkasan lesen perisian kepada output standard, dan kemudian keluar.

--line-directives[=yes|tidak]
Menentukan sama ada arahan "#line" harus diiktiraf. Ini terdapat dalam
output prapemproses dan mengandungi nombor baris, dan mungkin nama fail, daripada
fail sumber asal dari mana fail output prapemproses dijana.
Apabila didayakan, pilihan ini akan menyebabkan ctag untuk menjana entri tag yang ditandakan dengan
nama fail dan nombor baris lokasi mereka fail sumber asal, bukannya
lokasi sebenar mereka dalam output prapemproses. Nama fail sebenar diletakkan ke dalam
fail tag akan mempunyai komponen laluan utama yang sama seperti output prapemproses
fail, kerana diandaikan bahawa fail sumber asal terletak relatif kepada fail
fail output prapemproses (melainkan, sudah tentu, arahan #line menentukan a
jalan mutlak). Pilihan ini dimatikan secara lalai. Catatan: Pilihan ini secara amnya sahaja
berguna apabila digunakan bersama-sama dengan --excmd=nombor (-n) pilihan. Juga, anda mungkin perlu
gunakan sama ada --langmap or --daya-bahasa pilihan jika lanjutan daripada
fail output prapemproses tidak diketahui ctag.

--pautan[=yes|tidak]
Menunjukkan sama ada pautan simbolik (jika disokong) harus diikuti. Apabila cacat,
pautan simbolik diabaikan. Pilihan ini dihidupkan secara lalai.

--senarai-jenis[=bahasa|semua]
Menyenaraikan jenis teg yang diiktiraf sama ada untuk bahasa yang ditentukan atau semua bahasa,
dan kemudian keluar. Setiap jenis teg yang direkodkan dalam fail teg diwakili oleh satu-
bendera huruf, yang juga digunakan untuk menapis tag yang diletakkan ke dalam output melalui penggunaan
daripada ---macam pilihan. Ambil perhatian bahawa sesetengah bahasa dan/atau jenis teg mungkin
dilaksanakan menggunakan ungkapan biasa dan mungkin tidak tersedia jika sokongan regex adalah
tidak disusun ke dalam ctag (Lihat --regex- pilihan). Setiap jenis yang disenaraikan didayakan
melainkan diikuti dengan "[mati]".

--list-maps[=bahasa|semua]
Menyenaraikan sambungan fail dan corak nama fail yang mengaitkan nama fail dengan a
bahasa untuk sama ada bahasa yang ditentukan atau semua bahasa, dan kemudian keluar. Lihat
--langmap pilihan, dan SUMBER FILES, di atas.

--senarai-bahasa
Menyenaraikan nama bahasa yang difahami oleh ctag, dan kemudian keluar. bahasa ini
nama tidak peka huruf besar dan boleh digunakan dalam --daya-bahasa, --bahasa,
---macam, dan --regex- pilihan.

--pilihan=fail
Baca pilihan tambahan daripada fail. Fail harus mengandungi satu pilihan setiap baris. Sebagai
kes khas, jika --pilihan=NONE dinyatakan sebagai pilihan pertama pada baris arahan,
ia akan melumpuhkan pembacaan automatik sebarang pilihan konfigurasi daripada sama ada fail
atau persekitaran (lihat FILES).

--berulang[=yes|tidak]
Kembali ke direktori yang ditemui dalam senarai fail yang dibekalkan. Jika senarai
fail yang dibekalkan kosong dan tiada senarai fail dinyatakan dengan -L pilihan, kemudian
direktori semasa (iaitu ".") diandaikan. Pautan simbolik diikuti. Jika anda tidak
seperti tingkah laku ini, sama ada secara eksplisit menyatakan fail atau paip output
mencari(1) menjadi ctag -L- sebaliknya. Catatan: Pilihan ini tidak disokong pada semua platform
pada masa ini. Ia tersedia jika output daripada - membantu pilihan termasuk pilihan ini.
Lihat, juga, yang --kecualikan untuk menghadkan pengulangan.

--regex-=/regexp/replacement/[kind-spec/][flags]
. /regexp/replacement/ pasangan menentukan corak penggantian ungkapan biasa,
serupa dengan gaya sed arahan penggantian, yang digunakan untuk menjana teg daripada
fail sumber dipetakan ke bahasa yang dinamakan, , (tidak peka huruf besar-besaran; sama ada terbina-
dalam atau bahasa yang ditentukan pengguna). Ungkapan biasa, regexp, mentakrifkan lanjutan
ungkapan biasa (kira-kira yang digunakan oleh egrep(1)), yang digunakan untuk mencari satu
baris sumber yang mengandungi teg dan boleh menentukan aksara tab menggunakan \t. Apabila padanan
baris ditemui, teg akan dijana untuk nama yang ditakrifkan oleh penggantian, Yang
secara amnya akan mengandungi rujukan belakang khas \1 hingga \9 untuk merujuk pada padanan
kumpulan sub-ungkapan dalam regexp. Aksara pemisah '/' ditunjukkan dalam
parameter kepada pilihan sebenarnya boleh digantikan dengan mana-mana aksara. Perhatikan bahawa
mana-mana aksara pemisah yang digunakan perlu dilepaskan dengan garis miring ke belakang ('\')
aksara di mana sahaja ia digunakan dalam parameter sebagai sesuatu selain pemisah.
Ungkapan biasa yang ditakrifkan oleh pilihan ini ditambahkan pada senarai biasa semasa
ungkapan untuk bahasa yang ditentukan melainkan parameter ditinggalkan, dalam hal ini
senarai semasa dikosongkan.

Melainkan diubah suai oleh bendera, regexp ditafsirkan sebagai Posix dilanjutkan tetap
ungkapan. The penggantian perlu dikembangkan untuk semua baris yang sepadan kepada yang tidak kosong
rentetan aksara, atau mesej amaran akan dilaporkan. Jenis pilihan
penentu untuk padanan tag regexp boleh ikut penggantian, yang akan menentukan apa
jenis teg dilaporkan dalam medan sambungan "jenis" (lihat TAG FAIL FORMAT, di bawah).
Bentuk lengkap dari jenis-spesifikasi adalah dalam bentuk satu huruf, koma, nama
(tanpa ruang), koma, perihalan, diikuti dengan pemisah, yang menyatakan
bentuk pendek dan panjang bagi nilai jenis dan penerangan teksnya (dipaparkan menggunakan
--senarai-jenis). Sama ada nama jenis dan/atau perihalan boleh ditinggalkan. Jika
jenis-spesifikasi ditinggalkan, ia lalai kepada "r, regex". Akhirnya, bendera adalah satu atau lebih
aksara satu huruf yang mempunyai kesan berikut terhadap tafsiran
regexp:

b Corak itu ditafsirkan sebagai ungkapan biasa asas Posix.

e Corak ditafsirkan sebagai ungkapan biasa lanjutan Posix (lalai).

i Ungkapan biasa hendaklah digunakan dalam cara yang tidak peka huruf besar-besaran.

Ambil perhatian bahawa pilihan ini tersedia hanya jika ctag telah disusun dengan sokongan untuk
ungkapan biasa, yang bergantung pada platform anda. Anda boleh menentukan sama ada sokongan
untuk ungkapan biasa disusun dengan memeriksa output --versi
pilihan, yang akan menyertakan "+regex" dalam senarai ciri yang disusun.

Untuk maklumat lanjut tentang ungkapan biasa yang digunakan oleh ctag, lihat sama ada
regex(5,7) halaman manual, atau dokumentasi maklumat GNU untuk regex (cth. "info regex").

--sort[=yes|tidak|sarung lipatan]
Menunjukkan sama ada fail tag harus diisih pada nama tag (lalai ialah yes).
Perhatikan bahawa asal vi(1) tag diisih yang diperlukan. The sarung lipatan nilai menentukan kes
pengisihan tidak sensitif (atau berlipat huruf besar). Carian binari pantas fail tag diisih dengan
lipatan kes akan memerlukan sokongan khas daripada alatan yang menggunakan fail tag, seperti itu
ditemui dalam pustaka tag baca ctags, atau Vim versi 6.2 atau lebih tinggi (menggunakan "set
ignorecase"). Pilihan ini mesti muncul sebelum nama fail pertama. [Diabaikan dalam etags
mod]

--tag-saudara[=yes|tidak]
Menunjukkan bahawa laluan fail yang direkodkan dalam fail tag hendaklah relatif kepada
direktori yang mengandungi fail tag, bukannya relatif kepada direktori semasa,
melainkan fail yang dibekalkan pada baris arahan ditentukan dengan laluan mutlak. ini
pilihan mesti muncul sebelum nama fail pertama. Lalainya ialah yes apabila berlari masuk
mod etags (lihat -e pilihan), tidak sebaliknya.

--jumlah[=yes|tidak]
Mencetak statistik tentang fail sumber yang dibaca dan fail tag yang ditulis semasa
seruan semasa ctag. Pilihan ini dimatikan secara lalai. Pilihan ini mesti muncul
sebelum nama fail pertama.

--verbose[=yes|tidak]
Dayakan mod verbose. Ini mencetak maklumat mengenai pemprosesan pilihan dan ringkasan
mesej yang menerangkan tindakan yang sedang diambil untuk setiap fail yang dipertimbangkan oleh ctag.
Biasanya, ctag tidak membaca argumen baris arahan sehingga selepas pilihan dibaca
daripada fail konfigurasi (lihat FILES, di bawah) dan CTAGS pembolehubah persekitaran.
Walau bagaimanapun, jika pilihan ini ialah hujah pertama pada baris arahan, ia akan mengambil masa
kesan sebelum sebarang pilihan dibaca daripada sumber ini. Lalainya ialah tidak.

--versi
Mencetak pengecam versi untuk ctag kepada output standard, dan kemudian keluar. Ini adalah
dijamin sentiasa mengandungi rentetan "Exuberant Ctags".

OPERASI BUTIRAN

As ctag mempertimbangkan setiap nama fail pada gilirannya, ia cuba menentukan bahasa fail
dengan menggunakan tiga ujian berikut mengikut urutan: jika sambungan fail telah dipetakan ke a
bahasa, jika nama fail sepadan dengan corak cangkerang yang dipetakan ke bahasa, dan akhirnya jika
fail boleh laku dan baris pertamanya menentukan jurubahasa menggunakan gaya Unix
"#!" spesifikasi (jika disokong pada platform). Jika bahasa dikenal pasti, fail
dibuka dan kemudian penghurai bahasa yang sesuai dipanggil untuk beroperasi pada saat ini
buka fail. Penghurai menghuraikan fail dan menambah entri pada fail tag untuk setiap satu
objek bahasa yang ditulis untuk dikendalikan. Lihat TAG FAIL FORMAT, di bawah, untuk butiran mengenai perkara ini
penyertaan.

Pelaksanaan ini ctag tidak mengenakan keperluan pemformatan pada kod C seperti juga warisan
pelaksanaan. Pelaksanaan ctag yang lebih lama cenderung bergantung pada pemformatan tertentu
andaian untuk membantunya menyelesaikan dilema pengekodan yang disebabkan oleh prapemproses
bersyarat.

Secara umum, ctag cuba bijak tentang arahan prapemproses bersyarat. Sekiranya
bersyarat prapemproses ditemui dalam pernyataan yang mentakrifkan teg, ctag
hanya mengikut cawangan pertama bersyarat itu (kecuali dalam kes khas "#if 0",
dalam kes ini ia hanya mengikuti cawangan terakhir). Sebab untuk ini adalah kerana gagal
mengejar hanya satu cabang boleh menghasilkan sintaks yang tidak jelas, seperti dalam contoh berikut:

#ifdef DUA_ALTERNATIF
struct {
#selamat
kesatuan {
#endif
pendek a;
panjang b;
}

Kedua-dua cawangan tidak boleh diikuti, atau pendakap menjadi tidak seimbang dan ctag tidak akan dapat
memahami sintaks.

Jika aplikasi heuristik ini gagal menghuraikan fail dengan betul, secara amnya disebabkan oleh
gandingan yang rumit dan tidak konsisten dalam syarat, ctag akan mencuba semula fail
menggunakan heuristik berbeza yang tidak selektif mengikut prapemproses bersyarat
cawangan, tetapi sebaliknya bergantung pada pendakap penutup ("}") dalam lajur 1 sebagai
menunjukkan penghujung blok apabila sebarang ketidakseimbangan pendakap terhasil daripada mengikut #jika
cawangan bersyarat.

Ctags juga akan cuba mengendalikan senarai argumen yang disertakan dalam set berganda
kurungan untuk menerima binaan bersyarat berikut:

extern void foo __ARGS((int one, char two));

Mana-mana nama segera sebelum "((" akan diabaikan secara automatik dan nama sebelumnya
nama akan digunakan.

Takrif operator C++ dikendalikan khas. Dalam usaha untuk konsisten dengan semua jenis
operator (terlebih beban dan penukaran), nama operator dalam fail teg akan sentiasa
didahului oleh rentetan "pengendali" (iaitu walaupun definisi pengendali sebenar ialah
ditulis sebagai "operator<<").

Selepas mencipta atau menambahkan pada fail tag, ia diisih mengikut nama tag, mengalih keluar
baris tag yang sama.

TAG FAIL FORMAT

Apabila tidak berjalan dalam mod etags, setiap entri dalam fail tag terdiri daripada baris yang berasingan,
masing-masing kelihatan seperti ini dalam kes yang paling umum:

tag_namefile_nameex_cmd;"extension_fields

Medan dan pemisah baris ini ditentukan seperti berikut:

1. tag nama
2. aksara tab tunggal
3. nama fail di mana objek yang dikaitkan dengan tag berada
4. aksara tab tunggal
5. Perintah EX digunakan untuk mencari tag dalam fail; secara amnya corak carian
(sama ada /corak/ atau ?corak?) atau nombor baris (lihat --excmd). Format fail tag 2
(Lihat --format) melanjutkan perintah EX ini dalam keadaan tertentu untuk memasukkan a
set medan sambungan (diterangkan di bawah) dibenamkan dalam ulasan EX serta-merta
dilampirkan pada perintah EX, yang menjadikannya serasi ke belakang dengan asal
vi(1) pelaksanaan.

Beberapa tag khas ditulis ke dalam fail tag untuk tujuan dalaman. Tag ini ialah
digubah sedemikian rupa sehingga mereka sentiasa mengisih ke bahagian atas fail. Oleh itu, yang pertama
dua aksara tag ini digunakan nombor ajaib untuk mengesan fail tag untuk tujuan
menentukan sama ada fail teg yang sah sedang ditimpa dan bukannya fail sumber.

Ambil perhatian bahawa nama setiap fail sumber akan direkodkan dalam fail tag sama persis dengannya
muncul pada baris arahan. Oleh itu, jika laluan yang anda tentukan pada baris arahan ialah
berbanding dengan direktori semasa, maka ia akan direkodkan dengan cara yang sama dalam teg
fail. Lihat, bagaimanapun, --tag-saudara pilihan untuk bagaimana tingkah laku ini boleh diubah suai.

Medan sambungan ialah pasangan nilai kunci yang dipisahkan tab yang dilampirkan pada penghujung arahan EX
sebagai ulasan, seperti yang diterangkan di atas. Pasangan nilai utama ini muncul dalam bentuk umum
"utama:nilai". Kehadiran mereka dalam baris fail tag dikawal oleh --bidang
pilihan. Kunci yang mungkin dan makna nilainya adalah seperti berikut:

mengakses Menunjukkan keterlihatan ahli kelas ini, di mana nilai adalah khusus kepada
bahasa.

fail Menunjukkan bahawa teg mempunyai keterlihatan terhad fail. Kunci ini tidak mempunyai
nilai yang sepadan.

jenis Menunjukkan jenis, atau jenis, tag. Nilainya sama ada salah satu daripada
bendera satu huruf yang sepadan yang diterangkan di bawah pelbagai ---macam
pilihan di atas, atau nama penuh. Ia dibenarkan (dan sebenarnya, lalai)
agar bahagian utama medan ini ditinggalkan. Tingkah laku pilihan ialah
dikawal dengan --bidang pilihan.

pelaksanaan
Apabila ada, ini menunjukkan pelaksanaan yang terhad (abstrak vs. konkrit)
rutin atau kelas, di mana nilai adalah khusus untuk bahasa ("maya" atau
"maya tulen" untuk C++; "abstrak" untuk Java).

mewarisi Apabila hadir, nilai. ialah senarai kelas yang dipisahkan koma dari mana ini
kelas diperolehi (iaitu mewarisi daripada).

tanda tangan Apabila hadir, nilai ialah perwakilan yang bergantung kepada bahasa bagi tandatangan
satu rutin. Tandatangan rutin dalam bentuk lengkapnya menentukan jenis pulangan
rutin dan senarai hujah formalnya. Medan sambungan ini pada masa ini
disokong hanya untuk bahasa berasaskan C dan tidak termasuk jenis pemulangan.

Di samping itu, maklumat tentang skop definisi teg mungkin tersedia, dengan kunci
bahagian yang sama dengan beberapa nama binaan yang bergantung kepada bahasa dan nilainya yang diisytiharkan nama
untuk binaan itu dalam program. Entri skop ini menunjukkan skop di mana teg
telah dijumpai. Sebagai contoh, teg yang dijana untuk ahli struktur C akan mempunyai skop
kelihatan seperti "struct:myStruct".

BAGAIMANA KEPADA Cara Guna DENGAN VI

Vi akan, secara lalai, mengharapkan fail tag dengan nama "tag" dalam direktori semasa. sekali
fail tag dibina, arahan berikut menggunakan ciri pengindeksan tag:

vi -t tag Mulakan vi dan letakkan kursor pada fail dan baris di mana "tag" ditakrifkan.

:ta tag Cari tag.

Ctrl-] Cari teg di bawah kursor.

Ctrl-T Kembali ke lokasi sebelumnya sebelum melompat ke tag (tidak dilaksanakan secara meluas).

BAGAIMANA KEPADA Cara Guna DENGAN GNU EMACS

Emacs akan, secara lalai, mengharapkan fail tag dengan nama "TAGS" dalam direktori semasa.
Setelah fail teg dibina, arahan berikut menggunakan ciri pengindeksan teg:

Mx lawatan-tag-meja FAIL
Pilih fail tag, "FILE", untuk digunakan.

M-. [TAG]
Cari takrifan pertama TAG. Teg lalai ialah pengecam di bawah
kursor.

M-* Kembali ke tempat anda memanggil "M-." sebelum ini.

Cu M-. Cari definisi seterusnya untuk teg terakhir.

Untuk lebih banyak arahan, lihat Tags topik dalam dokumen maklumat Emacs.

BAGAIMANA KEPADA Cara Guna DENGAN NEDIT

NEdit versi 5.1 dan lebih baru boleh mengendalikan format fail tag lanjutan baharu (lihat --format). Ke
buat NEdit menggunakan fail tag, pilih "Fail->Muat Fail Tag". Untuk melompat ke definisi untuk
teg, serlahkan perkataan, kemudian tekan Ctrl-D. NEdit 5.1 boleh membaca berbilang fail tag
daripada direktori yang berbeza. Menetapkan sumber X nedit.tagFile kepada nama tag
fail mengarahkan NEdit untuk memuatkan fail tag secara automatik pada masa permulaan.

CATATAN

Kerana ctag bukan prapemproses mahupun pengkompil, penggunaan makro prapemproses boleh
menipu ctag ke dalam sama ada teg yang hilang atau menghasilkan teg yang tidak sesuai dengan betul. Walaupun
ctag telah direka untuk mengendalikan kes-kes biasa tertentu, ini adalah punca terbesar tunggal
masalah yang dilaporkan. Khususnya, penggunaan konstruk prapemproses yang mengubah
sintaks teks C boleh menipu ctag. Anda boleh mengatasi banyak masalah sedemikian dengan menggunakan -I
pilihan.

Perhatikan bahawa sejak ctag menjana corak untuk mencari tag (lihat --excmd pilihan), ia adalah
kemungkinan besar bahawa baris yang salah mungkin ditemui oleh editor anda jika ada baris lain
baris sumber yang sama dengan baris yang mengandungi tag. Contoh berikut
menunjukkan keadaan ini:

pemboleh ubah int;

/* ... */
void foo(pembolehubah)
pemboleh ubah int;
{
/* ... */
}

Bergantung pada editor yang anda gunakan dan di mana dalam kod anda berada, ia adalah mungkin
bahawa corak carian boleh mencari pengisytiharan parameter tempatan dalam foo() sebelum itu
mencari definisi pembolehubah global sebenar, sejak baris (dan oleh itu carian mereka
corak adalah sama). Ini boleh dielakkan dengan menggunakan --excmd=n pilihan.

Gunakan ctags-exuberant dalam talian menggunakan perkhidmatan onworks.net