ctagposix - Інтернет у хмарі

ПРОГРАМА:

ІМ'Я

ctags — створити файл тегів (РОЗВИТОК, ФОРТРАН)

СИНТАКСИС

ctags [−а] [−f файл тегів] ім'я шляху...

ctags −x ім'я шляху...

ОПИС

Команда ctags утиліта надається в системах, які підтримують Розробку програмного забезпечення
Параметр «Утиліти» та один або обидва параметри «Утиліти розробки мови C» і
Варіант утиліт розробки FORTRAN. В інших системах це необов’язково.

Команда ctags утиліта напише a файл тегів або індекс об'єктів з мови C або FORTRAN
вихідні файли, визначені ім'я шляху операнди. The файл тегів наведе список локаторів
мовні об’єкти у вихідних файлах. Локатор складається з імені, імені шляху,
і шаблон пошуку або номер рядка, який можна використовувати для пошуку об'єкта
визначення. Об’єкти, які мають бути розпізнані, вказані в РОЗШИРЕНОМУ ОПИСІ
.

ВАРІАНТИ

Команда ctags утиліта повинна відповідати тому Base Definitions POSIX.1-2008, розділ
12.2, Утиліта синтаксис керівні вказівки.

Підтримуються такі варіанти:

−а Додати до файл тегів.

−f файл тегів
Запишіть списки локаторів об’єктів файл тегів замість файлу за замовчуванням під назвою
теги у поточному каталозі.

−x Створіть список імен об’єктів, номер рядка та ім’я файлу, у якому знаходиться кожен
визначено, а також текст цього рядка, і запишіть це до стандарту
вихід. А файл тегів не створюється, коли −x вказано.

ОПЕРАНДИ

Наступні ім'я шляху підтримуються такі операнди:

файл.c Файли з базовими назвами, що закінчуються на .c суфікс має розглядатися як C-мова
вихідний код. Такі файли, для яких не можна вводити дані c99 виробляти невизначений
результати.

файл.h Файли з базовими назвами, що закінчуються на .h суфікс має розглядатися як C-мова
вихідний код. Такі файли, для яких не можна вводити дані c99 виробляти невизначений
результати.

файл.f Файли з базовими назвами, що закінчуються на .f суфікс має розглядатися як FORTRAN-
вихідний код мови. Такі файли, для яких не можна вводити дані форт77 виробляти
невизначені результати.

Обробка інших файлів визначається реалізацією.

STDIN

Дивіться розділ ВХІДНІ ФАЙЛИ.

ВХІД ФАЙЛИ

Вхідні файли повинні бути текстовими файлами, що містять вихідний код мовою, зазначеною
суфікси імені файлу операнда.

НАВКОЛИШНЄ СЕРЕДОВИЩЕ ЗМІННІ

Наступні змінні середовища мають впливати на виконання ctags:

МОВА Надайте значення за замовчуванням для змінних інтернаціоналізації, які не встановлені або
нуль. (Дивіться том Base Definitions POSIX.1-2008, розділ 8.2,
Internationalization Змінні за пріоритет інтернаціоналізації
змінні, що використовуються для визначення значень категорій мовного стандарту.)

LC_ALL Якщо встановлено не порожнє значення рядка, замініть значення всіх інших
змінні інтернаціоналізації.

LC_COLLATE
Визначте порядок сортування вихідних даних для −x варіант. POSIX
локаль визначає порядок, у якому файл тегів написаний.

LC_CTYPE Визначте локаль для інтерпретації послідовностей байтів текстових даних
як символи (наприклад, однобайтові на відміну від багатобайтових символів у
аргументи та вхідні файли). Під час обробки вихідного коду мовою C, якщо
локаль не сумісна з локалізацією C, описаною стандартом ISO C, the
результати не уточнені.

LC_MESSAGES
Визначте місцевий стандарт, який слід використовувати для впливу на формат і вміст
діагностичні повідомлення, записані у стандартну помилку.

NLSPATH Визначте розташування каталогів повідомлень для обробки LC_MESSAGES.

АСИНХРОННИЙ ПОДІЇ

За замовчуванням.

ВИСТАВКА

Список інформації про назву об’єкта, створений −x параметр повинен бути записаний до стандартного
вивести в такому форматі:

"%s %d %s %s", <ім'я-об'єкта>,номер рядка>,ім'я файлу>,текст>

детекст> це текст рядканомер рядка> файлуім'я файлу>.

STDERR

Стандартна помилка повинна використовуватися лише для діагностичних повідомлень.

ВИХІД ФАЙЛИ

Коли −x параметр не вказано, формат вихідного файлу має бути таким:

"%s\t%s\t/%s/\n", <ідентифікатор>,ім'я файлу>,модель>

демодель> — шаблон пошуку, який може використовувати редактор для пошуку визначального
примірникідентифікатор> вім'я файлу> (де визначаючи екземпляр позначається символом
декларації, перелічені в РОЗШИРЕНОМУ ОПИСІ).

Необов'язковий ('^') можна додати як префікс домодель> і необов’язковий
можна додати домодель> щоб вказати, що шаблон прив’язаний до
початок (кінець) рядка тексту. Будь-який або символи вмодель>
має передувати a характер. Анкерування , ,
і втікаючи символи не вважаються частиною шаблону пошуку.
Усі інші символи в шаблоні пошуку вважаються літеральними символами.

Альтернативний формат:

"%s\t%s\t?%s?\n", <ідентифікатор>,ім'я файлу>,модель>

який ідентичний першому формату, за винятком того символи вмодель> повинен
не передувати втечі символи, і символи в
<модель> має передувати персонажів.

Другий альтернативний формат:

"%s\t%s\t%d\n", <ідентифікатор>,ім'я файлу>,lineno>

деlineno> — це число в десятковому рядку, яке може використовувати редактор для пошуку
<ідентифікатор> вім'я файлу>.

Жоден альтернативний формат не створюватиметься ctags коли він використовується, як описано
POSIX.1-2008, але стандартні утиліти, які обробляють файли тегів, зможуть обробляти
ці формати, а також перший формат.

У будь-якому з цих форматів файл має бути відсортований за ідентифікатором на основі сортування
послідовність у локалі POSIX.

ПОВЕРНЕНІ ОПИС

Якщо операнд ідентифікує джерело мовою C, ctags утиліта намагатиметься створити ан
вихідний рядок для кожного з наступних об’єктів:

* Визначення функцій

* Визначення типів

* Макроси з аргументами

Він також може створювати вихідні дані для будь-якого з наступних об’єктів:

* Прототипи функцій

* Конструкції

* Союзи

* Визначення глобальних змінних

* Типи перерахувань

* Макроси без аргументів

* #визначити заяви

* #лінія заяви

будь-який # якщо та #ifdef оператори не повинні виводити результат. Тег основний обробляється спеціально
в програмах C. Сформований тег має бути створений префіксом M до назви файлу,
із закінченням .c, а компоненти початкового шляху (якщо такі є) видалено.

У системах, які не підтримують параметр C-Language Development Utilities, ctags випускає
невизначені результати для файлів вихідного коду мовою C. Він повинен писати стандартну помилку a
повідомлення, що ідентифікує цю умову та викликає ненульовий статус виходу.

Якщо операнд ідентифікує джерело FORTRAN, ctags утиліта повинна створити вихідну лінію
для кожного визначення функції. Він також може створювати вихідні дані для будь-якого з наступних об’єктів:

* Визначення підпрограм

* ПОШИРЕНІ твердження

* Оператори PARAMETER

* Оператори DATA і BLOCK DATA

* Номери виписок

У системах, які не підтримують опцію FORTRAN Development Utilities, ctags випускає
невизначені результати для файлів вихідного коду FORTRAN. Він повинен писати стандартну помилку a
повідомлення, що ідентифікує цю умову та викликає ненульовий статус виходу.

Що створюють інші об’єкти (включаючи повторювані ідентифікатори), визначається реалізацією
вихід.

EXIT СТАТУС

Повинні бути повернуті такі вихідні значення:

0 Успішне завершення.

>0 Сталася помилка.

НАСЛІДКИ OF ПОМИЛКИ

За замовчуванням.

Команда після розділам він має інформативний.

ЗАСТОСУВАННЯ ВИКОРИСТАННЯ

Вихід с −x має на увазі простий покажчик, який можна записати як автономний
читабельний індекс функції. Якщо вхідні файли до ctags (Такі, як .c файли) не були створені
використовуючи ту саму мову, що й у дійсності, коли ctags −x результати можуть бути не такими
очікується.

В описі обробки мовою C сказано «спроби», тому що мова C може
бути дуже заплутаним, особливо через використання #визначитиs, і ця утиліта буде of
немає сенсу, якщо для їх ідентифікації запускався справжній препроцесор C. Вихід з ctags може бути
обдурені та неправильні для різних конструкцій.

ПРИКЛАДИ

Ні.

ОБГОВОРЕННЯ

Список варіантів значно скорочено порівняно з тим, що надається історичними
реалізації. The −Ф опція була пропущена як зайва, оскільки вона є типовою. The −Б
опція була пропущена через дуже обмежену корисність. The −t варіант був пропущений, оскільки
визнання typedefs тепер необхідний для вихідних файлів C. The −u опція була пропущена
оскільки функцію оновлення було визнано не лише неефективною, але й рідко потрібною.

Перша пропозиція включала a −w опція придушення діагностики попереджень. Оскільки види
таку діагностику неможливо було описати, опція була пропущена як некорисна.

Текст для LC_CTYPE про сумісність із мовою C визнає, що ISO C
стандарт накладає вимоги на локаль, яка використовується для обробки джерела C. Це легко може бути
наднабір того, що відомий як `` локаль C'' шляхом розширення реалізації, або один
кількох альтернативних локалей для систем, що підтримують різні кодові набори. Ніякої заяви немає
зроблено для FORTRAN, тому що стандарт ANSI X3.9-1978 (FORTRAN 77) (ще) не визначає
подібна концепція локалі. Однак загальне правило в цьому томі POSIX.1-2008 полягає в тому, що будь-який
час, коли локалі не збігаються (підготовка файлу для однієї локалі та його обробка в
інший), результати підозрілі.

Послідовність сортування файлу тегів не впливає LC_COLLATE тому що це
зазвичай не використовується читачами, а лише такими програмами, як vi щоб знайти тег
у вихідних файлах. Використання локалі POSIX усуває деякі проблеми
координуючи локалі між ctags творець файлів і vi читач файлів.

Історично файл тегів використовувався лише ex та vi. Однак формат в
файл тегів було опубліковано, щоб заохотити інші програми використовувати теги по-новому. The
Формат дозволяє або шаблони, або номери рядків для пошуку ідентифікаторів, оскільки
історичний vi визнає будь-який. The ctags утиліта не створює формат за допомогою рядка
чисел, оскільки це не корисно після будь-яких змін вихідного файлу, які додають або видаляють
лінії. Задокументовані моделі пошуку відповідають історичній практиці. Слід зазначити, що
буквальне ведення або в кінці символів у шаблоні пошуку
працюватиме правильно, лише якщо прив’язано до початку або кінця рядка
додатковий або характер.

Історичні реалізації також розуміють об’єкти, які використовуються мовами Pascal і
іноді LISP, і вони розуміють вихідні дані C за допомогою лекс та yacc, ctags
утиліта не потрібна для розміщення цих мов, хоча розробники є
заохочував до цього.

Не вказувався наступний історичний варіант, т.к vgrind сюди не входить
том POSIX.1-2008:

−v Якщо −v задано прапорець, індекс форми, очікуваний від vgrind виробляється на
стандартний вихід. Цей список містить назву функції, назву файлу та сторінку
номер (передбачається, що 64-рядкові сторінки). Оскільки вихідні дані сортуються на лексикографічні
порядку, може знадобитися виконати вихід сортувати −f. Зразок використання:

ctags −v файли | сортувати −f > індекс vgrind −x індекс

Особлива обробка бирки основний використовує ctags практичні в довідниках с
більше однієї програми.

Майбутнє НАПРЯМКИ

Ні.

Використовуйте ctagposix онлайн за допомогою сервісів onworks.net