Exuberant Ctags#
Program ctags#
--verbose#
Argument --verbose odpowiada za włączenie (to samo, co argument -V) lub wyłączenie (domyślnie) trybu komentowania poszczególnych akcji wykonywanych przez program ctags. Im wcześniej przekażemy argument --verbose (względem innych argumentów) tym pełniejsze informacje uzyskamy. Argument --verbose to jeden z inicjujących argumentów.
Opis działania#
Prawidłowe użycie argumentu najlepiej objaśnić na zapisie składniowym:
ctags --verbose[=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 wartości logicznych wpływająca na tryb komentowania (wielkość znaków nie ma znaczenia):
"yes","on","1"lub""- włącza tryb komentowania dla kolejnych akcji wykonywanych przez program ctags. Jeszcze przed właściwym przetwarzaniem plików może wyświetlić informacje dla wszystkich ustawień programu ctags (wewnętrznych lub pochodzących z konfiguracji). Alternatywnie można skorzystać z identycznie działającego skróconego argumentu-V."no","off"lub"0"- tryb komentowania dla kolejnych akcji wykonywanych przez program ctags pozostaje wyłączony. Jest to domyślne zachowanie i jest ono równoznaczne z brakiem przekazania argumentu--verbose.
- 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 --verbose jako inicjujący argument to program ctags wyświetli pełne informacje dla kolejnych kroków swojego działania. Na początku będą to informacje o wewnętrznym stanie programu # (np. o zainstalowanych parserach, domyślnych ustawieniach dla plików z nagłówkami, mapowań dla języków czy wykluczonych plików/folderów), a dopiero potem dalsze informacje opisujące bieżące działanie programu (np. o odczycie plików konfiguracyjnych, zmianie jakiegoś ustawienia czy analizowaniu konkretnego pliku/folderu).
Argument --verbose można potem przekazywać wielokrotnie w dowolnym wariancie konfiguracyjnym, co spowoduje wyrywkowe włączenie/wyłączenie wyświetlarnia informacji opisujących działanie programu ctags. Jeśli przekażemy ten argument tylko w sposób standardowy (np. w plikach konfiguracyjnych, zmiennych środowiskowych lub w wywołaniu programu ctags, ale na dalszych pozycjach) to na pewno pominięte zostaną informacje o wewnętrznym stanie programu, a reszta informacji (np. o odczycie plików konfiguracyjnych) zależy już od konkretnego umiejscowienia tego argumentu (tj. im wcześniej włączymy komentowanie, tym więcej informacji uzyskamy).
Prosty przykład:
:: Same opisy konfiguracji (bez przetwarzania plików)
ctags --verbose=yes
ctags --verbose=on
ctags --verbose=1
ctags --verbose=""
ctags --verbose=
ctags --verbose
ctags -V
:: Opisy konfiguracji i przetwarzania plików
ctags --verbose=yes *
ctags --verbose=on *
ctags --verbose=1 *
ctags --verbose="" *
ctags --verbose= *
ctags --verbose *
ctags -V *
:: Bez opisów (domyślnie)
ctags --verbose=no *
ctags --verbose=off *
ctags --verbose=0 *
ctags *
:: Dodatkowe przypadki
ctags * --verbose=yes
ctags -R --verbose=yes
ctags --verbose=yes -R
ctags --verbose=yes test.js test.html
ctags test.js --verbose=yes test.html
ctags --verbose=yes --verbose=no :: zadziała jak inicjujący argument (opisy wyłączone)
ctags --verbose=no --verbose=yes :: zadziała jak inicjujący argument (opisy włączone)
ctags --verbose=no --options=NONE --verbose=yes :: zadziała jak inicjujący argument (opisy włączone)
ctags --verbose=yes -R > log.txt :: przekierowanie opisów do pliku
:: Błędne przypadki
ctags --verbose=cos
ctags --verbose=" "