You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
docs: add missing config settings to README tables and DEVELOPER_GUIDE groups
README.md (EN + JA config tables) were missing 6 settings:
- DisassemblerBlacklistTtlMinutes (default: 10)
- EnableInlineDiff (default: true)
- InlineDiffContextLines (default: 0)
- InlineDiffMaxInputLines (default: 1000)
- InlineDiffMaxOutputLines (default: 500)
- ShouldGenerateHtmlReport (default: true)
DEVELOPER_GUIDE.md configuration groups table (EN + JA) was also
missing these plus ShouldIncludeILCacheStatsInReport, SkipIL,
MaxLogGenerations, and SpinnerFrames. Added new Inline diff,
Report output, and Logging / UX groups; extended IL behavior and
Inclusion and report shape groups accordingly.
https://claude.ai/code/session_0174R4FzjudFBdynScKbhX6m
<td>Minutes before a blacklisted disassembler tool — one that has failed <code>DISASSEMBLE_FAIL_THRESHOLD</code> (3) times consecutively — is removed from the blacklist and retried on the next call.</td>
335
+
</tr>
331
336
<tr id="config-en-skipil">
332
337
<td><code>SkipIL</code></td>
333
338
<td><code>false</code></td>
334
339
<td>When <code>true</code>, skips IL decompilation and IL diff for .NET assemblies. MD5-mismatched assemblies are treated as binary diffs. Equivalent to the <code>--skip-il</code> CLI flag.</td>
335
340
</tr>
341
+
<tr id="config-en-enableinlinediff">
342
+
<td><code>EnableInlineDiff</code></td>
343
+
<td><code>true</code></td>
344
+
<td>When <code>true</code>, text-mismatched and IL-mismatched files in the HTML report include an expandable inline diff showing added and removed lines.</td>
345
+
</tr>
346
+
<tr id="config-en-inlinediffcontextlines">
347
+
<td><code>InlineDiffContextLines</code></td>
348
+
<td><code>0</code></td>
349
+
<td>Number of unchanged context lines to show above and below each changed hunk in inline diffs. <code>0</code> shows only the changed lines themselves.</td>
350
+
</tr>
351
+
<tr id="config-en-inlinediffmaxinputlines">
352
+
<td><code>InlineDiffMaxInputLines</code></td>
353
+
<td><code>1000</code></td>
354
+
<td>Maximum line count of either file before inline diff is skipped for that entry. Guards against very large files causing slow HTML rendering.</td>
355
+
</tr>
356
+
<tr id="config-en-inlinediffmaxoutputlines">
357
+
<td><code>InlineDiffMaxOutputLines</code></td>
358
+
<td><code>500</code></td>
359
+
<td>Maximum number of output lines produced by a single inline diff. When exceeded, the diff is truncated and a note is shown in the report.</td>
360
+
</tr>
336
361
<tr id="config-en-spinnerframes">
337
362
<td><code>SpinnerFrames</code></td>
338
363
<td><code>["|", "/", "-", "\\"]</code></td>
339
364
<td>Array of strings used for the console spinner animation. Each element is one frame in the rotation, so multi-character strings (e.g. block characters, emoji) are supported. Must contain at least one element. Setting <code>null</code> restores the default.</td>
340
365
</tr>
366
+
<tr id="config-en-shouldgeneratehtmlreport">
367
+
<td><code>ShouldGenerateHtmlReport</code></td>
368
+
<td><code>true</code></td>
369
+
<td>When <code>true</code>, generates <code>diff_report.html</code> alongside <code>diff_report.md</code>. The HTML file is a self-contained interactive review document with checkboxes, text inputs, localStorage auto-save, and a download function that bakes the current review state into a portable snapshot. Set to <code>false</code> to produce only the Markdown report.</td>
Copy file name to clipboardExpand all lines: doc/DEVELOPER_GUIDE.md
+10-4Lines changed: 10 additions & 4 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -374,11 +374,14 @@ The nested `DiffSummaryStatistics` sealed record (`AddedCount`, `RemovedCount`,
374
374
375
375
| Group | Keys | Purpose |
376
376
| --- | --- | --- |
377
-
| Inclusion and report shape |[`IgnoredExtensions`](../README.md#configuration-table-en), [`TextFileExtensions`](../README.md#configuration-table-en), [`ShouldIncludeUnchangedFiles`](../README.md#configuration-table-en), [`ShouldIncludeIgnoredFiles`](../README.md#configuration-table-en), [`ShouldOutputFileTimestamps`](../README.md#configuration-table-en), [`ShouldWarnWhenNewFileTimestampIsOlderThanOldFileTimestamp`](../README.md#configuration-table-en)| Controls scope, report verbosity, and timestamp-regression warnings. Note: `ShouldOutputFileTimestamps` is purely supplementary — timestamps are never used in comparison logic; results (Unchanged / Modified / etc.) are determined solely by file content. |
378
-
| IL behavior |[`ShouldOutputILText`](../README.md#configuration-table-en), [`ShouldIgnoreILLinesContainingConfiguredStrings`](../README.md#configuration-table-en), [`ILIgnoreLineContainingStrings`](../README.md#configuration-table-en)| Controls IL normalization and artifact output |
377
+
| Inclusion and report shape |[`IgnoredExtensions`](../README.md#configuration-table-en), [`TextFileExtensions`](../README.md#configuration-table-en), [`ShouldIncludeUnchangedFiles`](../README.md#configuration-table-en), [`ShouldIncludeIgnoredFiles`](../README.md#configuration-table-en), [`ShouldIncludeILCacheStatsInReport`](../README.md#configuration-table-en), [`ShouldOutputFileTimestamps`](../README.md#configuration-table-en), [`ShouldWarnWhenNewFileTimestampIsOlderThanOldFileTimestamp`](../README.md#configuration-table-en)| Controls scope, report verbosity, and timestamp-regression warnings. Note: `ShouldOutputFileTimestamps` is purely supplementary — timestamps are never used in comparison logic; results (Unchanged / Modified / etc.) are determined solely by file content. |
378
+
| IL behavior |[`ShouldOutputILText`](../README.md#configuration-table-en), [`ShouldIgnoreILLinesContainingConfiguredStrings`](../README.md#configuration-table-en), [`ILIgnoreLineContainingStrings`](../README.md#configuration-table-en), [`SkipIL`](../README.md#configuration-table-en), [`DisassemblerBlacklistTtlMinutes`](../README.md#configuration-table-en)| Controls IL normalization, artifact output, and disassembler reliability (blacklist TTL) |
379
+
| Inline diff |[`EnableInlineDiff`](../README.md#configuration-table-en), [`InlineDiffContextLines`](../README.md#configuration-table-en), [`InlineDiffMaxInputLines`](../README.md#configuration-table-en), [`InlineDiffMaxOutputLines`](../README.md#configuration-table-en)| Controls inline diff rendering in the HTML report |
379
380
| Parallelism |[`MaxParallelism`](../README.md#configuration-table-en), [`TextDiffParallelThresholdKilobytes`](../README.md#configuration-table-en), [`TextDiffChunkSizeKilobytes`](../README.md#configuration-table-en), [`TextDiffParallelMemoryLimitMegabytes`](../README.md#configuration-table-en)| Controls CPU usage, chunk sizing, and optional memory budget for large-text comparison |
380
381
| Cache |[`EnableILCache`](../README.md#configuration-table-en), [`ILCacheDirectoryAbsolutePath`](../README.md#configuration-table-en), [`ILCacheStatsLogIntervalSeconds`](../README.md#configuration-table-en), [`ILCacheMaxDiskFileCount`](../README.md#configuration-table-en), [`ILCacheMaxDiskMegabytes`](../README.md#configuration-table-en), [`ILPrecomputeBatchSize`](../README.md#configuration-table-en)| Controls IL cache lifetime, storage, and large-tree precompute batching |
| Report output |[`ShouldGenerateHtmlReport`](../README.md#configuration-table-en)| Controls whether the interactive HTML review report is generated alongside the Markdown report |
384
+
| Logging / UX |[`MaxLogGenerations`](../README.md#configuration-table-en), [`SpinnerFrames`](../README.md#configuration-table-en)| Controls log file retention and the console spinner animation |
382
385
383
386
Additional internal defaults:
384
387
-[`ProgramRunner`](../ProgramRunner.cs) currently applies non-configurable IL cache defaults from [`Common/Constants.cs`](../Common/Constants.cs): `2000` memory entries, `12` hours TTL, and `60` seconds for internal stats logs. Cross-project byte/timestamp literals reused by both projects live in [`FolderDiffIL4DotNet.Core/Common/CoreConstants.cs`](../FolderDiffIL4DotNet.Core/Common/CoreConstants.cs).
| IL 関連 |[`ShouldOutputILText`](../README.md#configuration-table-ja), [`ShouldIgnoreILLinesContainingConfiguredStrings`](../README.md#configuration-table-ja), [`ILIgnoreLineContainingStrings`](../README.md#configuration-table-ja)| IL 正規化と成果物出力の制御 |
0 commit comments