From d576731f91231a3e38d3f7a9ebdd2fa2b229e7dc Mon Sep 17 00:00:00 2001
From: Dennis Fink
Date: Sun, 24 May 2026 21:45:38 +0200
Subject: refactor(config)!: reorganize processing settings

Move processing-related configuration keys out of [encoding] and [skip]
into a dedicated [processing] section.

Use [processing].skip_codecs, [processing].backup_dir,
[processing].only_if_smaller, [processing].verify_output, and
[processing].continue so the config structure matches the CLI help
sections.

Update README, man page, startup warnings, and debug output to use the
new configuration layout.

BREAKING CHANGE: config.toml keys for skip codecs and processing options
moved. Replace [skip].codecs with [processing].skip_codecs, and move
[encoding].backup_dir, [encoding].only_if_smaller,
[encoding].verify_output, and [encoding].continue to [processing].
Existing config files using the old keys must be updated.
---
 transcode.sh.1 | 43 +++++++++++++++++++++++++------------------
 1 file changed, 25 insertions(+), 18 deletions(-)

(limited to 'transcode.sh.1')

diff --git a/transcode.sh.1 b/transcode.sh.1
index caa4c1a..5d6d521 100644
--- a/transcode.sh.1
+++ b/transcode.sh.1
@@ -118,27 +118,26 @@ or
 .BR v:1 .
 This option does not change ffmpeg stream mapping; presets remain responsible
 for selecting which stream to encode.
-.SS "Skip options"
+.SS "Processing options"
 .TP
 .BR \-S " \fILIST\fR, " \-\-skip\-codec " \fILIST\fR, " \-\-skip\-codec= \fILIST\fR
 Comma-, space- or colon-separated list of video codec names to skip.
 Files whose detected input codec appears in this list are left untouched.
 By default, codecs specified here are merged with any codecs listed under
-.B [skip] codecs
+.B [processing] skip_codecs
 in
 .B config.toml
 \(em both sources contribute to the skip list.
 .TP
 .BR \-\-skip\-codec\-override
 Ignore codecs listed under
-.B [skip] codecs
+.B [processing] skip_codecs
 in
 .B config.toml
 and use only codecs provided through
 .BR \-S / \-\-skip\-codec
 for this run. The position of this flag on the command line does not matter;
 it changes how the final skip list is resolved after all options are parsed.
-.SS "Processing options"
 .TP
 .BR \-n ", " \-\-dry\-run
 Print what would be done without actually invoking
@@ -440,18 +439,6 @@ enables it with that specific method.
 Equivalent to
 .BR \-\-hwaccel " / " \-\-no\-hwaccel .
 .TP
-.B [encoding] verify_output
-Boolean. Equivalent to
-.BR \-\-verify\-output / \-\-no\-verify\-output .
-Defaults to
-.BR true .
-.TP
-.B [encoding] backup_dir
-String. Existing directory where originals are copied after successful
-encoding and before replacement. Equivalent to
-.BR \-\-backup\-dir .
-CLI \fB--backup-dir\fR takes precedence.
-.TP
 .B [encoding] video_stream
 String. Input video stream to probe for preset helper variables. Defaults to
 .BR v:0 .
@@ -460,7 +447,7 @@ Equivalent to
 Invalid configured values are ignored with a warning and the default is used.
 This setting does not change ffmpeg stream mapping in presets.
 .TP
-.B [skip] codecs
+.B [processing] skip_codecs
 Array of strings. Merged with any codecs from
 .BR \-S
 by default. Use
@@ -468,6 +455,26 @@ by default. Use
 to ignore this configured list and use only codecs provided through
 .BR \-S / \-\-skip\-codec .
 .TP
+.B [processing] backup_dir
+String. Existing directory where originals are copied after successful
+encoding and before replacement. Equivalent to
+.BR \-\-backup\-dir .
+CLI \fB--backup-dir\fR takes precedence.
+.TP
+.B [processing] only_if_smaller
+Boolean. Equivalent to
+.BR \-\-only\-if\-smaller / \-\-no\-only\-if\-smaller .
+.TP
+.B [processing] verify_output
+Boolean. Equivalent to
+.BR \-\-verify\-output / \-\-no\-verify\-output .
+Defaults to
+.BR true .
+.TP
+.B [processing] continue
+Boolean. Equivalent to
+.BR \-c / \-\-continue / \-\-no\-continue .
+.TP
 .B [size_report] enabled
 Boolean. Equivalent to
 .BR \-s / \-\-no\-size\-report .
@@ -495,7 +502,7 @@ Defaults to
 .B Deprecated.
 This file is no longer read. If it exists, a warning is printed.
 Migrate its contents to
-.B [skip] codecs
+.B [processing] skip_codecs
 in
 .B config.toml
 and delete the file.
-- 
cgit v1.3.1