Skip to content

Commit 3d4548e

Browse files
steadmongitster
authored andcommitted
docs: mention trace2 target-dir mode in git-config
Move the description of trace2's target-directory behavior into the shared trace2-target-values file so that it is included in both the git-config and api-trace2 docs. Leave the SID discussion only in api-trace2 since it's a technical detail. Signed-off-by: Josh Steadmon <[email protected]> Signed-off-by: Junio C Hamano <[email protected]>
1 parent bc12974 commit 3d4548e

File tree

2 files changed

+6
-5
lines changed

2 files changed

+6
-5
lines changed

Documentation/technical/api-trace2.txt

Lines changed: 3 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -142,10 +142,9 @@ system or global config value to one of the following:
142142

143143
include::../trace2-target-values.txt[]
144144

145-
If the target already exists and is a directory, the traces will be
146-
written to files (one per process) underneath the given directory. They
147-
will be named according to the last component of the SID (optionally
148-
followed by a counter to avoid filename collisions).
145+
When trace files are written to a target directory, they will be named according
146+
to the last component of the SID (optionally followed by a counter to avoid
147+
filename collisions).
149148

150149
== Trace2 API
151150

Documentation/trace2-target-values.txt

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,9 @@
22
* `0` or `false` - Disables the target.
33
* `1` or `true` - Writes to `STDERR`.
44
* `[2-9]` - Writes to the already opened file descriptor.
5-
* `<absolute-pathname>` - Writes to the file in append mode.
5+
* `<absolute-pathname>` - Writes to the file in append mode. If the target
6+
already exists and is a directory, the traces will be written to files (one
7+
per process) underneath the given directory.
68
* `af_unix:[<socket_type>:]<absolute-pathname>` - Write to a
79
Unix DomainSocket (on platforms that support them). Socket
810
type can be either `stream` or `dgram`; if omitted Git will

0 commit comments

Comments
 (0)