Exuberant Ctags#
Program ctags#
-a#
Argument -a nakazuje programowi ctags, aby tagi z bieżącej generacji zostały dołączone do już istniejących tagów w pliku indeksu, a nie całkowicie je zastępowały. Jest to skrócona wersja dla argumentu --append. Jeśli przekazano jakieś argumenty path to argument -a musi pojawić się jeszcze przed pierwszym takim argumentem, aby w ogóle zadziałał. Argument -a to jeden z odroczonych argumentów.
Opis działania#
Prawidłowe użycie argumentu najlepiej objaśnić na zapisie składniowym:
ctags -a [--argument | -argument] [path]
gdzie poszczególne człony oznaczają:
- ctags - ścieżka względna lub bezwzględna do pliku binarnego programu ctags (
ctags.exe). Wszystko zależy od sposobu uruchamiania programu ctags, np. z systemowej konsoli, ze skrótu do programu czy z innego programu/skryptu. - argument - jeden lub więcej dodatkowych argumentów dostrajających działanie programu ctags.
- path - jedna lub więcej dodatkowych ścieżek do plików/folderów, które będą analizowane przy generowaniu tagów (szczegóły).
Trzeba wyraźnie zaznaczyć, że argument -a nie zadziała w sytuacji, kiedy tagi z bieżącej generacji spróbujemy wyświetlić do standardowego wyjścia poprzez argument -f -, -o -, -x lub --filter, o czym zostaniemy poinformowani stosownym komunikatem "ctags: append mode is not compatible with tags to stdout".
Prosty przykład:
ctags -a *
ctags --append=yes *
ctags --append=on *
ctags --append=1 *
ctags --append="" *
ctags --append= *
ctags --append *
ctags --append=no *
ctags --append=off *
ctags --append=0 *
ctags *
ctags -a -R
ctags -R a
ctags -a test.js test.html
ctags -a --append=no test.js
ctags --append=no -a test.js
ctags -a -Lpliki
ctags -Lpliki -a
:: Błędne przypadki
ctags -a
ctags -A
ctags * -a
ctags test.js -a
ctags -a -f - *