docs(devscripts): use runtime defaults in help text

Replace hardcoded generate-testfile help defaults with the current
variable values so usage output stays accurate when script defaults
change.

Format long printf argument lists in developer scripts one value per
line to make the placeholders easier to review and maintain.

2 files changed, 36 insertions, 13 deletions

diff --git a/devscripts/generate-testfile.sh b/devscripts/generate-testfile.sh
index fab91cd..d1eb57a 100755
--- a/devscripts/generate-testfile.sh
+++ b/devscripts/generate-testfile.sh
@@ -189,13 +189,13 @@ function print_help() {
 ${BOLD}${BLUE}Usage:${ALL_OFF} ${BOLD}${MAGENTA}%s${ALL_OFF} ${BOLD}${YELLOW}[OPTION]...${ALL_OFF} ${BOLD}${GREEN}[OUTPUT]${ALL_OFF}
 
 ${BOLD}${BLUE}Generation options:${ALL_OFF}
-  ${BOLD}${YELLOW}-c, --codec${ALL_OFF} ${BOLD}${GREEN}CODEC${ALL_OFF}               ffmpeg video codec to use (default: libx264)
-  ${BOLD}${YELLOW}-r, --resolution${ALL_OFF} ${BOLD}${GREEN}WIDTHxHEIGHT${ALL_OFF}   output resolution (default: 1280x720)
-  ${BOLD}${YELLOW}-l, --length${ALL_OFF} ${BOLD}${GREEN}DURATION${ALL_OFF}           test file length, in ffmpeg duration syntax (default: 5)
-      ${BOLD}${YELLOW}--rate${ALL_OFF} ${BOLD}${GREEN}FPS${ALL_OFF}                  frame rate for the generated source (default: 30)
-      ${BOLD}${YELLOW}--source${ALL_OFF} ${BOLD}${GREEN}SOURCE${ALL_OFF}             lavfi video source (default: smptebars)
-      ${BOLD}${YELLOW}--pix-fmt${ALL_OFF} ${BOLD}${GREEN}FORMAT${ALL_OFF}            output pixel format (default: yuv420p)
-      ${BOLD}${YELLOW}--ffmpeg-loglevel${ALL_OFF} ${BOLD}${GREEN}LEVEL${ALL_OFF}     ffmpeg log level (default: warning)
+  ${BOLD}${YELLOW}-c, --codec${ALL_OFF} ${BOLD}${GREEN}CODEC${ALL_OFF}               ffmpeg video codec to use (default: ${BOLD}${RED}%s${ALL_OFF})
+  ${BOLD}${YELLOW}-r, --resolution${ALL_OFF} ${BOLD}${GREEN}WIDTHxHEIGHT${ALL_OFF}   output resolution (default: ${BOLD}${RED}%s${ALL_OFF})
+  ${BOLD}${YELLOW}-l, --length${ALL_OFF} ${BOLD}${GREEN}DURATION${ALL_OFF}           test file length, in ffmpeg duration syntax (default: ${BOLD}${RED}%d${ALL_OFF})
+      ${BOLD}${YELLOW}--rate${ALL_OFF} ${BOLD}${GREEN}FPS${ALL_OFF}                  frame rate for the generated source (default: ${BOLD}${RED}%d${ALL_OFF})
+      ${BOLD}${YELLOW}--source${ALL_OFF} ${BOLD}${GREEN}SOURCE${ALL_OFF}             lavfi video source (default: ${BOLD}${RED}%s${ALL_OFF})
+      ${BOLD}${YELLOW}--pix-fmt${ALL_OFF} ${BOLD}${GREEN}FORMAT${ALL_OFF}            output pixel format (default: ${BOLD}${RED}%s${ALL_OFF})
+      ${BOLD}${YELLOW}--ffmpeg-loglevel${ALL_OFF} ${BOLD}${GREEN}LEVEL${ALL_OFF}     ffmpeg log level (default: ${BOLD}${RED}%s${ALL_OFF})
   ${BOLD}${YELLOW}-o, --output${ALL_OFF} ${BOLD}${GREEN}FILE${ALL_OFF}               write to FILE instead of generated testfiles/ name
   ${BOLD}${YELLOW}-f, --force${ALL_OFF}                     overwrite an existing output file
   ${BOLD}${YELLOW}-n, --dry-run${ALL_OFF}                   show the ffmpeg command without creating a file
@@ -218,7 +218,17 @@ ${BOLD}${BLUE}Examples:${ALL_OFF}
 " \
     "$SCRIPTNAME" "$VERSION" "$DESCRIPTION" \
     "$SCRIPTNAME" \
-    "$SCRIPTNAME" "$SCRIPTNAME" "$SCRIPTNAME" "$SCRIPTNAME"
+    "$CODEC" \
+    "$RESOLUTION" \
+    "$LENGTH" \
+    "$FRAME_RATE" \
+    "$FILTER" \
+    "$PIX_FMT" \
+    "$FFMPEG_LOGLEVEL" \
+    "$SCRIPTNAME" \
+    "$SCRIPTNAME" \
+    "$SCRIPTNAME" \
+    "$SCRIPTNAME"
 }
 
 function print_version() {
@@ -256,8 +266,13 @@ SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
 CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
 OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
 OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.\n" \
-    "$SCRIPTNAME" "$VERSION" "$DESCRIPTION" "$AUTHOR" "$DATE_OF_CREATION" \
-    "$DATE_OF_REVISION" "$LICENSE"
+    "$SCRIPTNAME" \
+    "$VERSION" \
+    "$DESCRIPTION" \
+    "$AUTHOR" \
+    "$DATE_OF_CREATION" \
+    "$DATE_OF_REVISION" \
+    "$LICENSE"
 }
 
 ###############################################################################
diff --git a/devscripts/release.sh b/devscripts/release.sh
index 8ef1bd0..0c74282 100755
--- a/devscripts/release.sh
+++ b/devscripts/release.sh
@@ -210,7 +210,10 @@ ${BOLD}${BLUE}Notes:${ALL_OFF}
 " \
     "$SCRIPTNAME" "$VERSION" "$DESCRIPTION" \
     "$SCRIPTNAME" \
-    "$SCRIPTNAME" "$SCRIPTNAME" "$SCRIPTNAME" "$DIST_DIR"
+    "$SCRIPTNAME" \
+    "$SCRIPTNAME" \
+    "$SCRIPTNAME" \
+    "$DIST_DIR"
 }
 
 function print_version() {
@@ -248,8 +251,13 @@ SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
 CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
 OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
 OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.\n" \
-    "$SCRIPTNAME" "$VERSION" "$DESCRIPTION" "$AUTHOR" "$DATE_OF_CREATION" \
-    "$DATE_OF_REVISION" "$LICENSE"
+    "$SCRIPTNAME" \
+    "$VERSION" \
+    "$DESCRIPTION" \
+    "$AUTHOR" \
+    "$DATE_OF_CREATION" \
+    "$DATE_OF_REVISION" \
+    "$LICENSE"
 }
 
 ###############################################################################