1f010d6bdf
We presently use the ".txt" extension for our AsciiDoc files. While not wrong, most editors do not associate this extension with AsciiDoc, meaning that contributors don't get automatic editor functionality that could be useful, such as syntax highlighting and prose linting. It is much more common to use the ".adoc" extension for AsciiDoc files, since this helps editors automatically detect files and also allows various forges to provide rich (HTML-like) rendering. Let's do that here, renaming all of the files and updating the includes where relevant. Adjust the various build scripts and makefiles to use the new extension as well. Note that this should not result in any user-visible changes to the documentation. Signed-off-by: brian m. carlson <sandals@crustytoothpaste.net> Signed-off-by: Junio C Hamano <gitster@pobox.com>
72 lines
2.9 KiB
Plaintext
72 lines
2.9 KiB
Plaintext
Trace2 config settings are only read from the system and global
|
|
config files; repository local and worktree config files and `-c`
|
|
command line arguments are not respected.
|
|
|
|
trace2.normalTarget::
|
|
This variable controls the normal target destination.
|
|
It may be overridden by the `GIT_TRACE2` environment variable.
|
|
The following table shows possible values.
|
|
|
|
trace2.perfTarget::
|
|
This variable controls the performance target destination.
|
|
It may be overridden by the `GIT_TRACE2_PERF` environment variable.
|
|
The following table shows possible values.
|
|
|
|
trace2.eventTarget::
|
|
This variable controls the event target destination.
|
|
It may be overridden by the `GIT_TRACE2_EVENT` environment variable.
|
|
The following table shows possible values.
|
|
+
|
|
include::../trace2-target-values.adoc[]
|
|
|
|
trace2.normalBrief::
|
|
Boolean. When true `time`, `filename`, and `line` fields are
|
|
omitted from normal output. May be overridden by the
|
|
`GIT_TRACE2_BRIEF` environment variable. Defaults to false.
|
|
|
|
trace2.perfBrief::
|
|
Boolean. When true `time`, `filename`, and `line` fields are
|
|
omitted from PERF output. May be overridden by the
|
|
`GIT_TRACE2_PERF_BRIEF` environment variable. Defaults to false.
|
|
|
|
trace2.eventBrief::
|
|
Boolean. When true `time`, `filename`, and `line` fields are
|
|
omitted from event output. May be overridden by the
|
|
`GIT_TRACE2_EVENT_BRIEF` environment variable. Defaults to false.
|
|
|
|
trace2.eventNesting::
|
|
Integer. Specifies desired depth of nested regions in the
|
|
event output. Regions deeper than this value will be
|
|
omitted. May be overridden by the `GIT_TRACE2_EVENT_NESTING`
|
|
environment variable. Defaults to 2.
|
|
|
|
trace2.configParams::
|
|
A comma-separated list of patterns of "important" config
|
|
settings that should be recorded in the trace2 output.
|
|
For example, `core.*,remote.*.url` would cause the trace2
|
|
output to contain events listing each configured remote.
|
|
May be overridden by the `GIT_TRACE2_CONFIG_PARAMS` environment
|
|
variable. Unset by default.
|
|
|
|
trace2.envVars::
|
|
A comma-separated list of "important" environment variables that should
|
|
be recorded in the trace2 output. For example,
|
|
`GIT_HTTP_USER_AGENT,GIT_CONFIG` would cause the trace2 output to
|
|
contain events listing the overrides for HTTP user agent and the
|
|
location of the Git configuration file (assuming any are set). May be
|
|
overridden by the `GIT_TRACE2_ENV_VARS` environment variable. Unset by
|
|
default.
|
|
|
|
trace2.destinationDebug::
|
|
Boolean. When true Git will print error messages when a
|
|
trace target destination cannot be opened for writing.
|
|
By default, these errors are suppressed and tracing is
|
|
silently disabled. May be overridden by the
|
|
`GIT_TRACE2_DST_DEBUG` environment variable.
|
|
|
|
trace2.maxFiles::
|
|
Integer. When writing trace files to a target directory, do not
|
|
write additional traces if doing so would exceed this many files. Instead,
|
|
write a sentinel file that will block further tracing to this
|
|
directory. Defaults to 0, which disables this check.
|