ctags(1p)

Från Wiki.linux.se
Hoppa till navigering Hoppa till sök

PROLOG

Denna manualsida är en del av POSIX Programmer's Manual. Linux-implementationen av detta gränssnitt kan skilja sig (konsultera motsvarande Linux-manualsida för detaljer om Linux-beteende), eller så kan gränssnittet vara oimplementerat på Linux.

NAMN

ctags — skapa en taggfil (UTVECKLING, FORTRAN)

SYNOPSIS

ctags [-a] [-f taggfil] sökväg...

ctags -x sökväg...

BESKRIVNING

Verktyget ctags ska tillhandahållas på system som stöder alternativet för Programvaruutvecklingsverktyg, och antingen eller båda av alternativen för C-språksutvecklingsverktyg och FORTRAN-utvecklingsverktyg. På andra system är det valfritt.

Verktyget ctags ska skriva en taggfil eller ett index över objekt från källkodsfiler i C-språket eller FORTRAN som specificeras av operanderna sökväg. Taggfilen ska lista lokalisatorerna för språkspecifika objekt inom källkodsfilerna. En lokalisator består av ett namn, en sökväg och antingen ett sökmönster eller ett radnummer som kan användas för att söka efter objektets definition.

ALTERNATIV

Verktyget ctags ska följa riktlinjerna för verktygssyntax enligt POSIX.1-2017.

De följande alternativen ska stödas:

  • -a — Lägg till i taggfilen.
  • -f taggfil — Skriv objektens lokalisatorlistor i taggfilen istället för standardfilen som heter tags i den aktuella katalogen.
  • -x — Skapa en lista över objektnamn, radnummer och filnamn där varje objekt är definierat, samt texten från den raden, och skriv detta till standardutmatningen. Ingen taggfil skapas när -x anges.

OPERANDER

De följande sökvägs-operanderna stöds:

  • fil.c — Filer med filnamn som slutar med suffixet .c ska behandlas som C-språkets källkod.
  • fil.h — Filer med filnamn som slutar med suffixet .h ska behandlas som C-språkets källkod.
  • fil.f — Filer med filnamn som slutar med suffixet .f ska behandlas som FORTRAN-språkets källkod.

STANDARDINMATNING

Se avsnittet INMATNINGSFILER.

INMATNINGSFILER

Inmatningsfilerna ska vara textfiler som innehåller källkod i språket som anges av operandens filnamnssuffix.

MILJÖVARIABLER

Följande miljövariabler ska påverka körningen av ctags:

  • LANG — Tillhandahåll ett standardvärde för de internationaliseringsvariabler som är osatta eller tomma.
  • LC_ALL — Om den är satt till en icke-tom sträng, åsidosätt värdena för alla andra internationaliseringsvariabler.
  • LC_COLLATE — Bestäm ordningen för utdata som sorteras med alternativet -x.
  • LC_CTYPE — Bestäm tolkningsmetoden för textdata som tecken.
  • LC_MESSAGES — Bestäm språk och format för diagnostiska meddelanden.
  • NLSPATH — Bestäm platsen för meddelandekataloger för bearbetning av LC_MESSAGES.

ASYNKRONA HÄNDELSER

Standard.

STANDARDUTGÅNG

Listan över objektnamn som skapas med alternativet -x ska skrivas till standardutmatning i följande format:

"%s %d %s %s", <objektnamn>, <radnummer>, <filnamn>, <text>

FELUTGÅNG

Standardfel ska användas enbart för diagnostiska meddelanden.

UTGÅNGSSTATUS

Följande utgångsvärden ska returneras:

  • 0 — Lyckad avslutning.
  • >0 — Ett fel inträffade.

EXEMPEL

  • Skapa en taggfil för alla C-filer i en katalog:
ctags *.c
  • Lägg till nya taggar i en befintlig taggfil:
ctags -a -f mina_taggar nya_filer.c
  • Lista alla taggar och deras plats i källkod:
ctags -x *.c
  • Skapa taggar för både C och FORTRAN-filer:
ctags fil1.c fil2.f
  • Spara taggar i en specifik fil:
ctags -f projekt_taggar *.c

SE ÄVEN

COPYRIGHT

Delar av denna text är återgivna och reproducerade i elektronisk form från IEEE Std 1003.1-2017, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 7, 2018 Edition, Copyright (C) 2018 av Institute of Electrical and Electronics Engineers, Inc och The Open Group.

Vid eventuella skillnader mellan denna version och den ursprungliga IEEE och The Open Group-standarden är det den ursprungliga standarden som gäller.

Sidslut

Orginalhemsidan på Engelska :https://man7.org/linux/man-pages/man1/ctags.1p.html


Det här är en maskinöversättning av Linux man sidor till svenska. Om du hittar fel är vi tacksamma om du rapporterar dem via formuläret som finns på https://www.linux.se/kontaka-linux-se/

Tack till PC-Service som har sponsrat Linux.se med webbhotell.