C-xrefactory - a C/Yacc refactoring and code browsing tool - User Manual

c-xrefactory can operate in three different modes:

Overwrite any existing crossreference data with a completely new set.

"Fast update" ignores updated header files. NOTE: This option might be removed in the future.

c-xrefactory has project-based configurations. The -p selects which of the projects available in the selected configuration file (see -xrefrc option) that should be applied.

Read file as a configuration file containing options, as if it was included from the selected configuration file. This makes it possible to share certain configuration options between multiple configuration files/projects.

Read the indicated file instead of the default ~/.c-xrefrc for configuration information.

Set variable to 'value' in the same fashion as environment variables. Variables set in this way can be used in configuration files and queried using the command line option -get.

Get the value of a previously set "environment variable". The value will be transfered over the edit server protocol as a PPC_SET_INFO record.

Convert various line-ending conventions to LF.

Consider source files to use the indicated text encoding (default, european, euc, sjis, utf, utf-8, utf-16, utf-16le, utf-16be).

Select level of information to print.

Enable debugging of the C and Yacc parsers according to the Yacc manual.

Redirect all output to file rather than to standard output.

Place all log output in file.

Define a preprocessor macro or variable with name macro in the same fashion as for the C/C++ pre-processor. This is typically used to set variables differently for different passes (see -pass).

Look for included C header files also in directory. If used multiple times the order of search will be the same as the order of the occurence of the -I options.

Sets the path of the C compiler to use. c-xrefactory tries to setup pre-defined types, pre-processor variables, include paths etc. so that the parsing of the C source will be as close to what the compiler the project is using does. If the project is not using the default C compiler, cc, then this option allows c-xrefactory to inquire some compilers for their settings and apply them automatically.

This option indicates which file suffixes to consider being a C file. Multiple suffixes should be separated by :.

Reject keywords and types that are not part of the ANSI C standard, such as asm, _near and const.

Applicable only to server mode. Will use a second generation protocol between the edit server and the editor adapter. Using the edit server/refactorer without activating -xrefactory-II is deprecated. Will be deprecated and removed in the future when legacy protocol is removed.

Print short or long help text or version information.

If a symbol is defined in multiple places, like it can be in C, using this flag will consider those instances different based on them being in different locations.

Will sleep n seconds before proceeding with next argument or processing. Useful when attaching a debugger to an edit server process.

Indicates that the current content of the editor copy of file1 is available in file2. If an editor has an edited, non-saved, buffer holding a relevant file1 it is supposed that the editor adaptor saves the content into a file and indicates this to the edit server using this option.

…​