UNIX ON-LINE Man Pages - Die Onlinehilfe

Die Syntax von Unixbefehlen wird in den entsprechenden Manpages dokumentiert. Hier können Sie diese Onlinehilfe für viele Standardbefehle abrufen.

Suchoptionen:
Seiten auflisten, welche beginnen mit:
A   B   C   D   E   F   G   H   I   J   K   L   M   N   O   P   Q   R   S   T   U   V   W   X   Y   Z   ALPHA   NUM   ANDERE   ALLE
CTAGS(1P)                  POSIX Programmer's Manual                 CTAGS(1P)

PROLOG
       This  manual  page is part of the POSIX Programmer's Manual.  The Linux
       implementation of this interface may differ (consult the  corresponding
       Linux  manual page for details of Linux behavior), or the interface may
       not be implemented on Linux.

NAME
       ctags - create a tags file (DEVELOPMENT, FORTRAN)

SYNOPSIS
       ctags [-a][-f tagsfile] pathname ...

       ctags -x pathname ...

DESCRIPTION
       The ctags utility shall be provided on systems that  support  the  User
       Portability   Utilities  option,  the  Software  Development  Utilities
       option, and either or both  of  the  C-Language  Development  Utilities
       option  and  FORTRAN Development Utilities option. On other systems, it
       is optional.

       The ctags utility shall write a tagsfile or an index of objects from C-
       language  or  FORTRAN  source files specified by the pathname operands.
       The tagsfile shall  list  the  locators  of  language-specific  objects
       within  the  source files.  A locator consists of a name, pathname, and
       either a search pattern or a line number that can be used in  searching
       for  the  object  definition.  The objects that shall be recognized are
       specified in the EXTENDED DESCRIPTION section.

OPTIONS
       The ctags utility shall conform  to  the  Base  Definitions  volume  of
       IEEE Std 1003.1-2001, Section 12.2, Utility Syntax Guidelines.

       The following options shall be supported:

       -a     Append to tagsfile.

       -f  tagsfile
              Write  the  object  locator  lists  into tagsfile instead of the
              default file named tags in the current directory.

       -x     Produce a list of object names, the line number, and filename in
              which  each  is  defined,  as well as the text of that line, and
              write this to the standard output. A tagsfile shall not be  cre-
              ated when -x is specified.

OPERANDS
       The following pathname operands are supported:

       file.c Files  with basenames ending with the .c suffix shall be treated
              as C-language source code. Such files that are not  valid  input
              to c99 produce unspecified results.

       file.h Files  with basenames ending with the .h suffix shall be treated
              as C-language source code. Such files that are not  valid  input
              to c99 produce unspecified results.

       file.f Files  with basenames ending with the .f suffix shall be treated
              as FORTRAN-language source code. Such files that are  not  valid
              input to fort77 produce unspecified results.

       The handling of other files is implementation-defined.

STDIN
       See the INPUT FILES section.

INPUT FILES
       The  input files shall be text files containing source code in the lan-
       guage indicated by the operand filename suffixes.

ENVIRONMENT VARIABLES
       The following environment  variables  shall  affect  the  execution  of
       ctags:

       LANG   Provide  a  default value for the internationalization variables
              that are unset or null. (See  the  Base  Definitions  volume  of
              IEEE Std 1003.1-2001,  Section  8.2,  Internationalization Vari-
              ables for the precedence of internationalization variables  used
              to determine the values of locale categories.)

       LC_ALL If  set  to a non-empty string value, override the values of all
              the other internationalization variables.

       LC_COLLATE

              Determine the order in which output is sorted for the -x option.
              The  POSIX  locale determines the order in which the tagsfile is
              written.

       LC_CTYPE
              Determine the locale for  the  interpretation  of  sequences  of
              bytes  of  text  data as characters (for example, single-byte as
              opposed to multi-byte characters in arguments and input  files).
              When  processing  C-language  source  code, if the locale is not
              compatible with the C locale described by  the  ISO C  standard,
              the results are unspecified.

       LC_MESSAGES
              Determine  the  locale  that should be used to affect the format
              and contents of diagnostic messages written to standard error.

       NLSPATH
              Determine the location of message catalogs for the processing of
              LC_MESSAGES .

ASYNCHRONOUS EVENTS
       Default.

STDOUT
       The  list of object name information produced by the -x option shall be
       written to standard output in the following format:

              "%s %d %s %s", <object-name>, <line-number>, <filename>, <text>

       where <text> is the text of line <line-number> of file <filename>.

STDERR
       The standard error shall be used only for diagnostic messages.

OUTPUT FILES
       When the -x option is not specified, the  format  of  the  output  file
       shall be:

              "%s\t%s\t/%s/\n", <identifier>, <filename>, <pattern>

       where  <pattern> is a search pattern that could be used by an editor to
       find the defining instance of <identifier> in <filename> (where  defin-
       ing  instance  is  indicated by the declarations listed in the EXTENDED
       DESCRIPTION).

       An optional circumflex ( '^' ) can be added as a prefix  to  <pattern>,
       and  an  optional  dollar sign can be appended to <pattern> to indicate
       that the pattern is anchored to the beginning (end) of a line of  text.
       Any  slash  or backslash characters in <pattern> shall be preceded by a
       backslash character. The anchoring circumflex, dollar sign, and  escap-
       ing  backslash  characters  shall  not be considered part of the search
       pattern. All other characters in the search pattern shall be considered
       literal characters.

       An alternative format is:

              "%s\t%s\t?%s?\n", <identifier>, <filename>, <pattern>

       which is identical to the first format except that slashes in <pattern>
       shall not be preceded by escaping backslash  characters,  and  question
       mark characters in <pattern> shall be preceded by backslash characters.

       A second alternative format is:

              "%s\t%s\t%d\n", <identifier>, <filename>, <lineno>

       where <lineno> is a decimal line number that could be used by an editor
       to find <identifier> in <filename>.

       Neither  alternative  format shall be produced by ctags when it is used
       as described by IEEE Std 1003.1-2001, but the standard  utilities  that
       process  tags  files  shall be able to process those formats as well as
       the first format.

       In any of these formats, the file shall be sorted by identifier,  based
       on the collation sequence in the POSIX locale.

EXTENDED DESCRIPTION
       If  the  operand  identifies C-language source, the ctags utility shall
       attempt to produce an output line for each of the following objects:

        * Function definitions

        * Type definitions

        * Macros with arguments

       It may also produce output for any of the following objects:

        * Function prototypes

        * Structures

        * Unions

        * Global variable definitions

        * Enumeration types

        * Macros without arguments

        * #define statements

        * #line statements

       Any #if and #ifdef statements shall produce no output.  The tag main is
       treated  specially  in  C  programs. The tag formed shall be created by
       prefixing M to the name of the file, with the trailing .c, and  leading
       pathname components (if any) removed.

       On  systems  that  do  not support the C-Language Development Utilities
       option, ctags produces unspecified results for C-language  source  code
       files.  It  should  write  to standard error a message identifying this
       condition and cause a non-zero exit status to be produced.
 

Scannen Sie den Barcode um die Webseite zu öffnen


Quelle: http://www.trinler.net/de/service/doc/linux/man.html?command=ctags
Gedruckt am: 11.12.2017 14:07 GMT+0100 (2017-12-11T14:07:52+01:00)