From 872187d2cf3804ae14b337544877f6cfcfd699e5 Mon Sep 17 00:00:00 2001
From: Mitchel Tighe <56122439+MitchelTighe@users.noreply.github.com>
Date: Thu, 15 Oct 2026 18:19:34 -0400
Subject: [PATCH 1/2] ltfs_ordered_copy: document --sort-files in the man page
(#513)
--sort-files was added in #512 but the man page was not updated. It is a
plain flag (action='store_true'), so it is documented as off by default,
matching the --help text.
Fixes #513
---
man/sgml/ltfs_ordered_copy.sgml | 6 ++++++
1 file changed, 6 insertions(+)
diff --git a/man/sgml/ltfs_ordered_copy.sgml b/man/sgml/ltfs_ordered_copy.sgml
index 46f52406..6c2942a7 100644
--- a/man/sgml/ltfs_ordered_copy.sgml
+++ b/man/sgml/ltfs_ordered_copy.sgml
@@ -104,6 +104,12 @@
No message outout
+
+
+
+ Sort the source file list alphabetically before copying (default: not sorted)
+
+
From 1536248ee4a52e3fbe21ca77cc89747884af52ae Mon Sep 17 00:00:00 2001
From: Mitchel Tighe <56122439+MitchelTighe@users.noreply.github.com>
Date: Thu, 15 Oct 2026 20:36:55 -0400
Subject: [PATCH 2/2] ltfs_ordered_copy: add --sort-files to the synopsis and
the generated man page
The SGML source and the checked-in man/ltfs_ordered_copy.1 are both
updated, so the installed man page shows the option too.
---
man/ltfs_ordered_copy.1 | 5 ++++-
man/sgml/ltfs_ordered_copy.sgml | 1 +
2 files changed, 5 insertions(+), 1 deletion(-)
diff --git a/man/ltfs_ordered_copy.1 b/man/ltfs_ordered_copy.1
index 0444daee..a31d988f 100644
--- a/man/ltfs_ordered_copy.1
+++ b/man/ltfs_ordered_copy.1
@@ -4,7 +4,7 @@
ltfs_ordered_copy \- Copy files from source to destination with LTFS order optimization
.SH SYNOPSIS
.sp
-\fBltfs_ordered_copy\fR [ \fB-p\fR ] [ \fB-r\fR ] [ \fB-t \fITARGET_DIRECTORY\fB\fR ] [ \fB--keep-tree \fICUTOFF_PREFIX\fB\fR ] [ \fB-a\fR ] [ \fB-v\fR ] [ \fB--verbose \fILOG_LEVEL\fB\fR ] [ \fB-q\fR ] [ \fB-h\fR ] [ \fBSOURCE \fR\fI...\fR ] [ \fBDESTINATION\fR ]
+\fBltfs_ordered_copy\fR [ \fB-p\fR ] [ \fB-r\fR ] [ \fB-t \fITARGET_DIRECTORY\fB\fR ] [ \fB--keep-tree \fICUTOFF_PREFIX\fB\fR ] [ \fB-a\fR ] [ \fB-v\fR ] [ \fB--verbose \fILOG_LEVEL\fB\fR ] [ \fB-q\fR ] [ \fB--sort-files\fR ] [ \fB-h\fR ] [ \fBSOURCE \fR\fI...\fR ] [ \fBDESTINATION\fR ]
.SH "DESCRIPTION"
.PP
\fBltfs_ordered_copy\fR is a program to copy files from source to destination with LTFS
@@ -40,6 +40,9 @@ Configure verbosity of logger. VERBOSE shall be 0-6. (Default: 4)
.TP
\fB-q, --quiet\fR
No message outout
+.TP
+\fB--sort-files\fR
+Sort the source file list alphabetically before copying (default: not sorted)
.SH "COMMAND EXAMPLES"
.PP
This section shows various command examples.
diff --git a/man/sgml/ltfs_ordered_copy.sgml b/man/sgml/ltfs_ordered_copy.sgml
index 6c2942a7..69fbad40 100644
--- a/man/sgml/ltfs_ordered_copy.sgml
+++ b/man/sgml/ltfs_ordered_copy.sgml
@@ -31,6 +31,7 @@
+
SOURCE
DESTINATION