Exuberant Ctags#
Program ctags#
--totals#
Argument --totals odpowiada za włączenie lub wyłączenie (domyślnie) trybu wyświetlania podsumowujących statystyk dla przetworzonych plików w bieżącym wywołaniu programu ctags. Jeśli przekażemy wiele argumentów --totals to decydujący będzie tylko ten ostatni. Argument --totals to jeden z odroczonych argumentów.
Opis działania#
Prawidłowe użycie argumentu najlepiej objaśnić na zapisie składniowym:
ctags --totals[=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 wyświetlania podsumowujących statystyk (wielkość znaków nie ma znaczenia):
"yes","on","1"lub""- włącza tryb wyświetlania podsumowujących statystyk dla przetworzonych plików."no","off"lub"0"- tryb wyświetlania podsumowujących statystyk dla przetworzonych plików pozostaje wyłączony. Jest to domyślne zachowanie i jest ono równoznaczne z brakiem przekazania argumentu--totals.
- 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 --totals nie zadziała w sytuacji, kiedy użyty zostanie razem z jakimś argumentem pobierającym informacje ze standardowego wejścia, np. -L - lub --filter.
Podsumowujące statystyki dla przetworzonych plików # wyświetlane są w trzech osobnych liniach, gdzie każda z nich zawiera:
- Liczbę przetworzonych plików, liczbę wszystkich linii z tych plików (włącznie z ich rozmiarem w kB/s) oraz czas przetworzenia tych plików (włącznie z prędkością ich odczytu z dysku w kB/s).
- Liczbę odnalezionych w nich tagach.
- Czas sortowania tych tagów (jeśli włączono sortowanie).
Prosty przykład:
ctags --totals=yes *
ctags --totals=on *
ctags --totals=1 *
ctags --totals="" *
ctags --totals= *
ctags --totals *
ctags --totals=no *
ctags --totals=off *
ctags --totals=0 *
ctags *
ctags * --totals=yes
ctags -R --totals=yes
ctags --totals=yes -R
ctags --totals=yes test.js test.html
ctags test.js --totals=yes test.html
ctags -V --totals=yes -R
ctags --totals=yes -V -R
ctags test.js --totals=yes test.html --totals=no :: bez wyświetlania podsumowujących statystyk
ctags --totals=yes -R > log.txt :: przekierowanie podsumowujących statystyk do pliku
:: Błędne przypadki
ctags --totals
ctags --totals=cos
ctags --totals=" "Efekt:
7 files, 55 lines (0 kB) scanned in 0.0 seconds (805 kB/s) 28 tags added to tag file 28 tags sorted in 0.00 seconds