Exuberant Ctags#
Program ctags#
-L#
Argument -L
określa ścieżkę względną lub bezwzględną do dodatkowego pliku z listą ścieżek i/lub opcji, które będą analizowane w bieżącym wywołaniu programu ctags, lub pobiera te informacje ze standardowego wejścia. Argument -L
to jeden z odroczonych argumentów.
Opis działania#
Prawidłowe użycie argumentu najlepiej objaśnić na zapisie składniowym:
ctags -L value [--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. value - jedna z dwóch dostępnych wartości:
"file"
- ścieżka względną lub bezwzględną do dodatkowego pliku z listą ścieżek i/lub opcji. Znaki wieloznaczności*
i?
są obsługiwane (szczegóły)."-"
- specjalna wartość rozpoczynająca proces pobierania informacji o ścieżkach i/lub opcjach ze standardowego wejścia. Można opuścić ten tryb wciskając kombinację klawiszyCtrl+Z
, a następnie zatwierdzając wyjście klawiszemEnter
(tylko pod Windowsem).
- 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).
Kilka uwag odnośnie stosowania argumentu -L
:
- Jeśli przekażemy wiele argumentów
-L
to decydujący będzie tylko ten ostatni, o czym zostaniemy poinformowani stosownym komunikatem"ctags: Warning: -L option specified more than once, last value used"
. - Argument
-L
stanowi jeden z odroczonych argumentów, dlatego reprezentowana przez niego akcja (tj. odczyt dodatkowego pliku z listą ścieżek i/lub opcji lub pobranie tych danych ze standardowego wejścia) nastąpi dopiero po ostatnim argumencie z wywołania programu ctags. - Dodatkowy plik z listą ścieżek i/lub opcji # to zwykły plik tekstowy z identycznymi wymaganiami składniowymi, jak w przypadku plików konfiguracyjnych, ale z możliwością umieszczania w nim ścieżek względnych lub bezwzględnych do plików/folderów, które będą analizowane w bieżącym wywołaniu programu ctags. Znaki wieloznaczności
*
i?
w ścieżkach nie są obsługiwane (szczegóły). Ścieżki zawierające spacje podajemy bez otaczania ich podwójnymi cudzysłowami. Można stosować zamiennie znak"\"
i"/"
.
Prosty przykład:
ctags -L files
ctags -L files *
ctags * -L files
ctags -L files1 -L files2 test.js :: odczytanie tylko 'files2'
ctags -L files1 test.js -L files2 :: odczytanie tylko 'files2'
ctags test.js -L files1 -L files2 :: odczytanie tylko 'files2'
ctags -L -
ctags -L - *
ctags * -L -
ctags -L files -L - test.js :: pobranie danych ze standardowego wejścia
ctags -L files test.js -L - :: pobranie danych ze standardowego wejścia
ctags test.js -L files test.js -L - :: pobranie danych ze standardowego wejścia
:: Błędne przypadki
ctags -l
ctags -L ""
ctags -L " "
Pasek społecznościowy