Skip to content

Commit 29a5ffe

Browse files
committed
incremental: add instructions to bug reporting
1 parent d452144 commit 29a5ffe

File tree

1 file changed

+13
-1
lines changed

1 file changed

+13
-1
lines changed

docs/incremental.md

+13-1
Original file line numberDiff line numberDiff line change
@@ -118,4 +118,16 @@ indirectly. In KSP, propagation of dirtyness is done in 2 steps:
118118
If a source file is *changed* or *affected*, all other source files having some output in common
119119
with that file are *affected*.
120120

121-
Note that both of them are transitive and the second forms equivalence classes.
121+
Note that both of them are transitive and the second forms equivalence classes.
122+
123+
## Reporting Bugs
124+
To report a bug, please set Gradle properties `ksp.incremental=true` and `ksp.incremental.log=true`,
125+
and start with a clean build. There are 4 log files:
126+
127+
* `build/kspDirtySetByDeps.log`
128+
* `build/kspDirtySetByOutputs.log`
129+
* `build/kspDirtySet.log`
130+
* `build/kspSourceToOutputs.log`
131+
132+
They contain file names of sources and outputs, plus the timestamps of the builds.
133+
The first two are only avaiable in successive incremental builds and not available in clean builds.

0 commit comments

Comments
 (0)