ctags.emacs24 - Dalam Talian di Awan

JADUAL:

NAMA

etags, ctags - jana fail tag untuk Emacs, vi

SINOPSIS

etags [-aCDGIRVh] [-i fail] [-l bahasa]
[-atau fail tag] [-r regexp] [--parse-stdin=fail]
[--tambah] [--no-defines] [--globals] [--no-globals] [--include=fail]
[--ignore-indentation] [--language=bahasa] [--ahli] [--tiada-ahli] [--output=fail tag]
[--regex=regexp] [--no-regex] [--help] [--version] fail ...

ctag [-aCdgIRVh] [-BtTuvwx] [-l bahasa]
[-atau fail tag] [-r regexp] [--parse-stdin=fail]
[--tambah] [--carian-belakang] [--cxref] [--tiada-takrif] [--globals] [--no-globals]
[--ignore-indentation] [--language=bahasa] [--ahli] [--tiada-ahli] [--output=fail tag]
[--regex=regexp] [--kemas kini] [--help] [--version] fail ...

DESCRIPTION

. etags program digunakan untuk mencipta fail jadual tag, dalam format yang difahami oleh emacs(1);
yang ctag program digunakan untuk mencipta jadual yang serupa dalam format yang difahami oleh vi(1). Kedua-duanya
bentuk atur cara memahami sintaks C, Objektif C, C++, Java, Fortran, Ada,
Cobol, Erlang, Forth, HTML, LaTeX, Emacs Lisp/Common Lisp, Lua, Makefile, Pascal, Perl,
PHP, PostScript, Python, Prolog, Skim dan kebanyakan sintaks seperti pemasang. Kedua-dua borang dibaca
fail yang ditentukan pada baris arahan, dan tulis jadual tag (lalai: TAGS Untuk etags,
tags Untuk ctag) dalam direktori kerja semasa. Fail yang ditentukan dengan fail relatif
nama akan direkodkan dalam jadual tag dengan nama fail berbanding dengan direktori di mana
jadual tag berada. Jika jadual tag berada di dalam / dev atau adakah output standard, walau bagaimanapun,
nama fail dibuat relatif kepada direktori kerja. Fail ditentukan dengan mutlak
nama fail akan direkodkan dengan nama fail mutlak. Fail yang dijana daripada sumber
fail--seperti fail C yang dijana daripada fail Cweb sumber--akan direkodkan dengan nama
fail sumber. Fail mampat disokong menggunakan gzip, bzip2 dan xz. Program-program tersebut
mengenali bahasa yang digunakan dalam fail input berdasarkan nama fail dan kandungannya. The
--bahasa suis boleh digunakan untuk memaksa menghurai nama fail berikutan suis
mengikut bahasa yang diberikan, mengatasi tekaan berdasarkan sambungan nama fail.

PILIHAN

Beberapa pilihan masuk akal hanya untuk vi fail tag gaya yang dihasilkan oleh ctags; etags tidak
mengenali mereka. Program ini menerima singkatan yang tidak jelas untuk nama pilihan panjang.

-A, --lampirkan
Tambahkan pada fail teg sedia ada. (Untuk vi-format fail tag, lihat juga - kemas kini.)

-B, --cari-belakang
Tag fail yang ditulis dalam format yang diharapkan oleh vi mengandungi carian ungkapan biasa
arahan; yang -B pilihan menulisnya menggunakan pembatas `?', untuk mencari
ke belakang melalui fail. Lalai ialah menggunakan pembatas `/', untuk mencari
ke hadapan melalui fail. Sahaja ctag menerima pilihan ini.

--pengisytiharan
Dalam bahasa C dan terbitan, buat teg untuk pengisytiharan fungsi dan buat teg
untuk pembolehubah luaran melainkan --no-globals digunakan. Dalam Lisp, buat tag untuk (defvar
foo) pengisytiharan.

-D, --tiada-takrif
Jangan buat entri teg untuk definisi pemalar prapemproses C dan enum
pemalar. Ini boleh menjadikan fail tag lebih kecil jika banyak fail pengepala
bertanda.

--globals
Buat entri teg untuk pembolehubah global dalam Perl dan Makefile. Ini adalah lalai
dalam bahasa C dan terbitan.

--tidak-global
Jangan tag pembolehubah global dalam bahasa C dan terbitan. Biasanya ini mengurangkan
saiz fail sebanyak satu perempat.

-i fail, --termasuk=fail
Sertakan nota dalam fail teg yang menunjukkan bahawa, apabila mencari teg, satu
hendaklah juga merujuk fail tag fail selepas menyemak fail semasa. Sahaja etags
menerima pilihan ini.

-saya, --abaikan-lekukan
Jangan bergantung pada lekukan seperti biasa. Pada masa ini, ini bermakna tidak
andaikan bahawa pendakap penutup dalam lajur pertama ialah pendakap akhir fungsi atau
definisi struktur dalam C dan C++.

-l bahasa, --bahasa=bahasa
Parsing fail berikut mengikut bahasa yang diberikan. Lebih daripada satu seperti itu
pilihan mungkin bercampur dengan nama fail. guna - membantu untuk mendapatkan senarai
bahasa yang tersedia dan sambungan nama fail lalainya. Bahasa `auto' boleh
digunakan untuk memulihkan pengesanan automatik bahasa berdasarkan nama fail. The
bahasa `tiada' boleh digunakan untuk melumpuhkan penghuraian bahasa sama sekali; hanya regexp
pemadanan dilakukan dalam kes ini (lihat --regex pilihan).

--ahli
Buat entri teg untuk pembolehubah yang merupakan ahli binaan seperti struktur dalam
PHP. Ini adalah lalai untuk bahasa C dan terbitan.

--tiada ahli
Jangan tag pembolehubah ahli.

--pakej-sahaja
Hanya tag pakej dalam fail Ada.

--parse-stdin=fail
Boleh digunakan (hanya sekali) sebagai ganti nama fail pada baris arahan. etags akan
baca daripada input standard dan tandakan tag yang dihasilkan sebagai kepunyaan fail FAIL.

-o fail tag, --output=fail tag
Nama eksplisit fail untuk jadual tag; untuk etags sahaja, nama fail - bermakna
keluaran standard; mengatasi lalai TAGS or tags. (Tetapi diabaikan dengan -v or -x.)

-r regexp, --regex=regexp

Buat teg berdasarkan padanan regexp untuk fail mengikut pilihan ini, sebagai tambahan
kepada teg yang dibuat dengan penghuraian standard berdasarkan bahasa. Boleh bebas
bercampur dengan nama fail dan -R pilihan. Regexps adalah kumulatif, iaitu,
setiap pilihan tersebut akan menambah kepada yang sebelumnya. Regexps adalah salah satu daripada
borang:
[{bahasa}]/tagregexp/[nameregexp/]pengubah
@regexfile

di mana tagregexp digunakan untuk memadankan tag. Ia tidak sepatutnya sepadan dengan watak yang tidak berguna.
Jika perlawanan itu sedemikian sehingga lebih banyak aksara daripada yang diperlukan tidak dapat dielakkan dipadankan oleh
tagregexp, mungkin berguna untuk menambah a nameregexp, untuk mengecilkan skop teg.
ctag mengabaikan regexps tanpa a nameregexp. Sintaks regexps adalah sama seperti
dalam emacs. Urutan pelarian aksara berikut disokong: \a, \b, \d, \e,
\f, \n, \r, \t, \v, yang masing-masing mewakili aksara ASCII BEL, BS, DEL,
ESC, FF, NL, CR, TAB, VT.
. pengubah ialah urutan 0 atau lebih aksara antara i, yang bermaksud mengabaikan
kes apabila dipadankan; m, yang bermaksud bahawa tagregexp akan dipadankan dengan
keseluruhan kandungan fail sekali gus, bukannya baris demi baris, dan jujukan yang sepadan
boleh memadankan berbilang baris; dan s, yang bermaksud m dan bermakna bahawa watak titik
in tagregexp sepadan dengan aksara baris baharu juga.
Pemisah, iaitu / dalam contoh, boleh menjadi mana-mana watak yang berbeza daripada
ruang, tab, pendakap dan @. Jika watak pemisah diperlukan di dalam biasa
ungkapan, ia mesti dipetik dengan mendahuluinya dengan \.
Pilihannya {bahasa} awalan bermakna bahawa teg harus dibuat hanya untuk fail
daripada bahasa bahasa, dan tidak diendahkan sebaliknya. Ini amat berguna apabila
menyimpan banyak regexp yang telah ditetapkan dalam fail.
Dalam bentuk kedua, regexfile ialah nama fail yang mengandungi sejumlah
hujah kepada --regex= pilihan, satu setiap baris. Garisan bermula dengan ruang atau
tab diandaikan sebagai ulasan dan diabaikan.

Berikut adalah beberapa contoh. Semua regexps dipetik untuk melindungi mereka daripada shell
tafsiran.

Tandai makro DEFVAR dalam fail sumber emacs:
--regex='/[ \t]*DEFVAR_[AZ_ \t(]+"\([^"]+\)"/'

Tag fail VHDL (contoh ini ialah satu baris panjang, dipecahkan di sini untuk pemformatan
sebab):
--bahasa=tiada --regex='/[ \t]*\(SENIBINA\|\
KONFIGURASI\) +[^ ]* +DARI/' --regex='/[ \t]*\
\(ATRIBUTE\|ENTITI\|FUNGSI\|PAKEJ\( BADAN\)?\
\|PROSEDUR\|PROSES\|JENIS\)[ \t]+\([^ \t(]+\)/\3/'

Tag fail TCL (contoh terakhir ini menunjukkan penggunaan a tagregexp):
--lang= tiada --regex='/ proc[ \t]+\([^ \t]+\)/\1/'

Regexp boleh didahului oleh {lang}, dengan itu mengehadkannya untuk memadankan baris fail
bahasa yang ditentukan. guna etags - membantu untuk mendapatkan senarai yang diiktiraf
bahasa. Ciri ini amat berguna di dalam regex fail. Fail regex
mengandungi satu regex setiap baris. Garisan kosong, dan garisan tersebut bermula dengan ruang atau
tab diabaikan. Baris yang bermula dengan @ adalah rujukan kepada fail regex yang namanya
mengikut tanda @. Baris lain dianggap sebagai ungkapan biasa seperti itu
berikutan --regex.
Sebagai contoh, arahan
etags [e-mel dilindungi] *.c
membaca regex yang terkandung dalam fail regex.file.

-R, --tiada-regex
Jangan lakukan pemadanan regexp lagi pada fail berikut. Boleh dicampur secara bebas
dengan nama fail dan --regex pilihan.

-u, - kemas kini
Kemas kini entri teg untuk fail ditentukan pada baris arahan, meninggalkan entri tag untuk
fail lain di tempat. Pada masa ini, ini dilaksanakan dengan memadam yang sedia ada
entri untuk fail yang diberikan dan kemudian menulis semula entri baharu pada penghujung fail
fail tag. Selalunya lebih cepat untuk membina semula keseluruhan fail tag daripada menggunakan
ini. Sahaja ctag menerima pilihan ini.

-v, --vgrind
Daripada menjana fail tag, tulis indeks (dalam vgrind format) kepada standard
pengeluaran. Sahaja ctag menerima pilihan ini.

-x, --cxref
Daripada menjana fail tag, tulis rujukan silang (dalam cxref format) kepada
keluaran standard. Sahaja ctag menerima pilihan ini.

-h, -H, - membantu
Cetak maklumat penggunaan. Diikuti dengan satu atau lebih --language=LANG cetakan terperinci
maklumat tentang cara teg dicipta untuk LANG.

-V, --versi
Cetak versi semasa program (sama seperti versi emacs etags is
dihantar dengan).

Gunakan ctags.emacs24 dalam talian menggunakan perkhidmatan onworks.net