Exuberant Ctags#
Program ctags#
--options#
Argument --options określa ścieżkę względną lub bezwzględną do dodatkowego pliku konfiguracyjnego lub wyłącza wstępne pobieranie ustawień z domyślnych plików konfiguracyjnych i zmiennych środowiskowych dla bieżącego wywołania programu ctags. Argument --options można podawać wielokrotnie (separatorem jest spacja). Argument --options to jeden z inicjujących argumentów.
Opis działania#
Prawidłowe użycie argumentu najlepiej objaśnić na zapisie składniowym:
ctags --options=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 konfiguracyjnego. Znaki wieloznaczności*i?nie są obsługiwane (szczegóły)."NONE"- specjalna wartość dla argumentu--options, który użyty jako inicjujący argument wyłączy wstępne pobieranie ustawień z domyślnych plików konfiguracyjnych i zmiennych środowiskowych. Wielkość znaków ma znaczenie.
- 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).
Jeśli przekażemy argument --options=NONE jako inicjujący argument to program ctags całkowicie pominie odczyt ustawień z domyślnych plików konfiguracyjnych i zmiennych środowiskowych. Może być to przydatne w sytuacji, kiedy zdefiniowaliśmy sobie jakieś ogólne ustawienia w domyślnych plikach konfiguracyjnych czy zmiennych środowiskowych, ale przy niektórych wywołaniach programu ctags chcielibyśmy je pomijać. Jeśli przekażemy argument --options=NONE jako standardowy argument to program ctags będzie próbował odczytać wskazywany przez niego dodatkowy plik konfiguracyjny o nazwie "NONE".
Argument --options można potem przekazywać wielokrotnie w dowolnym wariancie konfiguracyjnym, co spowoduje uaktualnienie wszystkich opcji ze wskazywanego przez niego dodatkowego pliku konfiguracyjnego. Istotne jest to, aby ścieżki w kolejnych argumentach --options nie odnosiły się do plików, które już odczytano jako pliki konfiguracyjne, bo wyświetlony zostanie komunikat ctags: cannot open option file "xxx" : xxx. Ma to zapobiec ewentualnemu wzajemnemu odwoływaniu się między plikami konfiguracyjnymi.
Prosty przykład:
ctags -V --options=NONE :: `-V` i `--options` są argumentami inicjującymi
ctags --options=NONE -V :: `-V` i `--options` są argumentami inicjującymi
ctags * --options=none :: `--options` jest standardowym argumentem
ctags * --options=NONE :: `--options` jest standardowym argumentem
ctags -R --options=none :: `--options` jest standardowym argumentem
ctags -R --options=NONE :: `--options` jest standardowym argumentem
ctags -R --options=cfg
ctags --options=cfg1 test.js --options=cfg2 test.html
:: Błędne przypadki
ctags --options
ctags --options=
ctags --options=""
ctags --options=cfg --options=cfg