Exuberant Ctags#
Program ctags#
−−etags−include#
Argument −etags−include określa dodatkową informację (zwykle ścieżkę względną lub bezwzględną do dodatkowego pliku z tagami), która zostanie dodana na samym końcu wygenerowanych tagów pochodzących z bieżącego wywołania programu ctags. Argument −−etags−include to jeden z odroczonych argumentów i działa tylko w trybie etags.
Opis działania#
Prawidłowe użycie argumentu najlepiej objaśnić na zapisie składniowym:
ctags −e −etags−include[=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 - łańcuch znakowy reprezentujący dodatkową informację, która będzie dodawana na samym końcu wygenerowanych tagów. Za przekazaną wartością zawsze pojawi się stały dopisek w postaci
",include". - 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 −−etags−include:
- Użycie argumentu
−−etags−includebez wcześniejszego przejścia w tryb etags zwróci komunikat"ctags: Etags must be enabled to use "etags-include" option". - Argument
−−etags−includemożna podawać wielokrotnie (separatorem jest spacja), i każdy z nich będzie traktowany jak odroczony argument. - Wartością argumentu
−−etags−includemoże być dowolny łańcuch znakowy (nawet pusty), ale w praktyce najczęściej podaje się ścieżkę względną lub bezwzględną do dodatkowego pliku z tagami, co pozwala na używanie pliku z tagami, który zawiera inne pliki z tagami. Późniejsza obsługa tego mechanizmu jest silnie uzależniona od narzędzia przetwarzającego wygenerowane tagi (np. domyślnie działa w edytorze Emacs). - Przekazanie argumentu
−−etags−includebez podania jakiejkolwiek wartości jest równoważne z niejawnym użyciem pustej wartości.
Prosty przykład:
ctags -e −−etags−include=""
ctags -e -−−etags−include=
ctags -e −−etags−include
ctags -e -−etags−include=tagi
ctags -e −−etags−include=../tagi
ctags -e -−etags−include -−etags−include
ctags -e -−etags−include=tagi -−etags−include=../tagi
ctags -e -−etags−include *
ctags -e * -−etags−include
ctags -e -−etags−include -R
ctags -e -R -−etags−include
ctags -e -−etags−include test.js -−etags−include test.html
:: Błędne przypadki
ctags −−etags−include
ctags −−etags−include -ePasek społecznościowy