4.7.1 RELEASE

Signed-off-by: Phillip Lougher <phillip@squashfs.org.uk>

Author: plougher

Documentation/manpages/mksquashfs.1

@@ -1,5 +1,5 @@
 .\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.49.3.
-.TH MKSQUASHFS "1" "June 2025" "mksquashfs version 4.7" "User Commands"
+.TH MKSQUASHFS "1" "August 2025" "mksquashfs version 4.7.1" "User Commands"
 .SH NAME
 mksquashfs - tool to create and append to squashfs filesystems
 .SH SYNOPSIS
@@ -20,7 +20,7 @@ needed.
 .SS "Filesystem compression options:"
 .TP
 \fB\-b\fR BLOCK\-SIZE
-set data block to BLOCK\-SIZE.  Default 128 Kbytes. Optionally a suffix of K, KB, Kbytes or M, MB, Mbytes can be given to specify Kbytes or Mbytes respectively.
+set data block to BLOCK\-SIZE.  Default 128 Kbytes.  Optionally a suffix of K, KB, Kbytes or M, MB, Mbytes can be given to specify Kbytes or Mbytes respectively.
 .TP
 \fB\-comp\fR COMP
 select COMP compression.  Run \fB\-help\-comp\fR COMP to get compressor options for COMP, or ALL for all the compressors. Compressors available: gzip (default), lzo, lz4, xz, zstd.
@@ -91,7 +91,7 @@ if one source directory is specified, create a root directory containing that di
 set filesystem creation timestamp to TIME. TIME can be "inode", which means use the latest inode timestamp, an unsigned 32\-bit int indicating seconds since the epoch (1970\-01\-01) or a string value which is passed to the "date" command to parse. Any string value which the date command recognises can be used such as "now", "last week", or "Wed Feb 15 21:02:39 GMT 2023".
 .TP
 \fB\-inode\-time\fR TIME
-set all file and directory timestamps to TIME. TIME can be "inode", which means use the latest inode timestamp, an unsigned 32\-bit int indicating seconds since the epoch (1970\-01\-01) or a string value which is passed to the "date" command to parse. Any string value which the date command recognises can be used such as "now", "last week", or "Wed Feb 15 21:02:39 GMT 2025". This option sets and overrides the \fB\-root\-time\fR option.
+set all file and directory timestamps to TIME. TIME can be "inode", which means use the latest inode timestamp, an unsigned 32\-bit int indicating seconds since the epoch (1970\-01\-01) or a string value which is passed to the "date" command to parse. Any string value which the date command recognises can be used such as "now", "last week", or "Wed Feb 15 21:02:39 GMT 2025".  This option sets and overrides the \fB\-root\-time\fR option.
 .TP
 \fB\-root\-time\fR TIME
 set root directory time to TIME. TIME can be "inode", which means use the latest inode timestamp, an unsigned 32\-bit int indicating seconds since the epoch (1970\-01\-01) or a string value which is passed to the "date" command to parse. Any string value which the date command recognises can be used such as "now", "last week", or "Wed Feb 15 21:02:39 GMT 2025".
@@ -116,7 +116,7 @@ set root directory owner to specified USER, USER can be either an integer uid or
 set root directory group to specified GROUP, GROUP can be either an integer gid or group name.
 .TP
 \fB\-force\-file\-mode\fR MODE
-set all file (non\-directory) permissions to MODE. MODE can be symbolic or octal (see section Symbolic mode specification).
+set all file (non\-directory) permissions to MODE.  MODE can be symbolic or octal (see section Symbolic mode specification).
 .TP
 \fB\-force\-dir\-mode\fR MODE
 set all directory permissions to MODE.  MODE can be symbolic or octal (see section Symbolic mode specification).
@@ -207,10 +207,10 @@ do not display the progress bar.
 display progress bar when using the \fB\-info\fR option.
 .TP
 \fB\-percentage\fR
-display a percentage rather than the full progress bar. Can be used with dialog \fB\-\-gauge\fR etc.
+display a percentage rather than the full progress bar.  Can be used with dialog \fB\-\-gauge\fR etc.
 .TP
 \fB\-throttle\fR PERCENTAGE
-throttle the I/O input rate by the given percentage. This can be used to reduce the I/O and CPU consumption of Mksquashfs.
+throttle the I/O input rate by the given percentage.  This can be used to reduce the I/O and CPU consumption of Mksquashfs.
 .TP
 \fB\-limit\fR PERCENTAGE
 limit the I/O input rate to the given percentage.  This can be used to reduce the I/O and CPU consumption of Mksquashfs (alternative to \fB\-throttle\fR).
@@ -282,7 +282,7 @@ as \fB\-false\-action\fR, but read actions from FILE.
 .SS "Tar file only options:"
 .TP
 \fB\-default\-mode\fR MODE
-tar files often do not store permissions for intermediate directories.  This option sets the default directory permissions to MODE.  MODE can be symbolic or octal (see section Symbolic mode specification). Default mode is u=rwx,go=rx or 0755 octal.  This also sets the root directory mode.
+tar files often do not store permissions for intermediate directories.  This option sets the default directory permissions to MODE.  MODE can be symbolic or octal (see section Symbolic mode specification).  Default mode is u=rwx,go=rx or 0755 octal.  This also sets the root directory mode.
 .TP
 \fB\-default\-uid\fR VALUE
 tar files often do not store uids for intermediate directories.  This option sets the default directory owner to VALUE, rather than the user running Mksquashfs.  VALUE can be either an integer uid or user name.  This also sets the root directory uid.
@@ -298,14 +298,14 @@ allow tar files to be concatenated together and fed to Mksquashfs.  Normally a t
 do not pad filesystem to a multiple of 4K.
 .TP
 \fB\-offset\fR OFFSET
-skip OFFSET bytes at the beginning of FILESYSTEM. Optionally a suffix of K, M or G can be given to specify Kbytes, Mbytes or Gbytes respectively.  Default 0 bytes.
+skip OFFSET bytes at the beginning of FILESYSTEM.  Optionally a suffix of K, M or G can be given to specify Kbytes, Mbytes or Gbytes respectively.  Default 0 bytes.
 .TP
 \fB\-o\fR OFFSET
 synonym for \fB\-offset\fR.
 .SS "Help options:"
 .TP
 \fB\-help\fR
-print help summary information to stdout.
+print help summary information to pager (or stdout if not a terminal).
 .TP
 \fB\-help\-option\fR REGEX
 print the help information for options matching REGEX to pager (or stdout if not a terminal).
@@ -333,6 +333,12 @@ shorthand alternative to \fB\-help\-section\fR.
 .TP
 \fB\-ha\fR
 shorthand alternative to \fB\-help\-all\fR.
+.TP
+\fB\-no\-pager\fR
+do not use a pager to output help information.
+.TP
+\fB\-cols\fR WIDTH
+use WIDTH columns to output help information.  Useful if output is not to a terminal.
 .SS "Miscellaneous options:"
 .TP
 \fB\-fstime\fR TIME
@@ -417,35 +423,22 @@ create symlink with timestamp time.
 \fB\-p\fR "filename I time mode uid gid [s|f]"
 create socket/fifo with timestamp time.
 .SH "SYMBOLIC MODE SPECIFICATION"
-The symbolic mode is of the format [ugoa]*[[+\-=]PERMS]+.  PERMS = [rwxXst]+ or
-[ugo], and the sequence can be repeated separated with commas.
+The symbolic mode is of the format [ugoa]*[[+\-=]PERMS]+.  PERMS = [rwxXst]+ or [ugo], and the sequence can be repeated separated with commas.
 .PP
-A combination of the letters ugoa specify which permission bits will be
-affected, u means user, g means group, o means other, and a means all or ugo.
+A combination of the letters ugoa specify which permission bits will be affected, u means user, g means group, o means other, and a means all or ugo.
 .PP
-The next letter is +, \- or =.  The letter + means add to the existing permission
-bits, \- means remove the bits from the existing permission bits, and = means set
-the permission bits.
+The next letter is +, \- or =.  The letter + means add to the existing permission bits, \- means remove the bits from the existing permission bits, and = means set the permission bits.
 .PP
-The permission bits (PERMS) are a combination of [rwxXst] which
-sets/adds/removes those bits for the specified ugoa combination, r means read, w
-means write and x means execute for files or search for directories.  X has a
-special meaning, if the file is a directory it is equivalent to x or search, but
-if it is a non\-directory, it only takes effect if execute is already set for
-user, group or other.  The s flag sets user or group ID on execution, and the t
-flag on a directory sets restricted deletion, or historically made the file
-sticky if a non\-directory.
+The permission bits (PERMS) are a combination of [rwxXst] which sets/adds/removes those bits for the specified ugoa combination, r means read, w means write and x means execute for files or search for directories.  X has a special meaning, if the file is a directory it is equivalent to x or search, but if it is a non\-directory, it only takes effect if execute is already set for user, group or other.  The s flag sets user or group ID on execution, and the t flag on a directory sets restricted deletion, or historically made the file sticky if a non\-directory.
 .PP
-The permission bits can also be u, g or o, which takes the permission bits from
-the user, group or other of the file respectively.
+The permission bits can also be u, g or o, which takes the permission bits from the user, group or other of the file respectively.
 .SH "EXIT STATUS"
 .TP
 0
 Mksquashfs successfully generated a filesystem.
 .TP
 1
-Fatal errors occurred, Mksquashfs aborted and did not generate a
-filesystem (or update if appending).
+Fatal errors occurred, Mksquashfs aborted and did not generate a filesystem (or update if appending).
 .SH "COMPRESSORS AVAILABLE AND COMPRESSOR SPECIFIC OPTIONS"
 .SS "gzip (default):"
 .TP
@@ -474,7 +467,7 @@ Compress using LZ4 High Compression.
 Compress using filter1,filter2,...,filterN in turn (in addition to no filter), and choose the best compression.  Available filters: x86, arm, armthumb, arm64, powerpc, sparc, ia64, riscv.
 .TP
 \fB\-Xdict\-size\fR DICT\-SIZE
-Use DICT\-SIZE as the XZ dictionary size.  The dictionary size can be specified as a percentage of the block size, or as an absolute value.  The dictionary size must be less than or equal to the block size and 8192 bytes or larger.  It must also be storable in the xz header as either 2^n or as 2^n+2^(n+1). Example dict\-sizes are 75%, 50%, 37.5%, 25%, or 32K, 16K, 8K etc.
+Use DICT\-SIZE as the XZ dictionary size.  The dictionary size can be specified as a percentage of the block size, or as an absolute value.  The dictionary size must be less than or equal to the block size and 8192 bytes or larger.  It must also be storable in the xz header as either 2^n or as 2^n+2^(n+1).  Example dict\-sizes are 75%, 50%, 37.5%, 25%, or 32K, 16K, 8K etc.
 .SS "zstd:"
 .TP
 \fB\-Xcompression\-level\fR COMPRESSION\-LEVEL
@@ -485,7 +478,7 @@ SQFS_CMDLINE
 If set, this is used as the directory to write the file sqfs_cmdline which contains the command line arguments given to Mksquashfs.  Each command line argument is wrapped in quotes to ensure there is no ambiguity when arguments contain spaces.  If the file already exists then the command line is appended to the file.
 .TP
 SOURCE_DATE_EPOCH
-If set, this is used as the filesystem creation timestamp.  Also any file timestamps which are after SOURCE_DATE_EPOCH will be clamped to SOURCE_DATE_EPOCH. See https://reproducible\-builds.org/docs/source\-date\-epoch/ for more information.
+If set, this is used as the filesystem creation timestamp.  Also any file timestamps which are after SOURCE_DATE_EPOCH will be clamped to SOURCE_DATE_EPOCH.  See https://reproducible\-builds.org/docs/source\-date\-epoch/ for more information.
 .TP
 PAGER
 If set, this is used as the name of the program used to display the help text.  The value can be a simple command or a pathname.  The default is \fI\,/usr/bin/pager\/\fP.
@@ -651,9 +644,6 @@ GNU General Public License for more details.
 .SH "SEE ALSO"
 unsquashfs(1), sqfstar(1), sqfscat(1)
 .PP
-The README for the Squashfs\-tools 4.7 release, describing the new features can
-be read here
-https://github.com/plougher/squashfs\-tools/blob/master/Documentation/4.7/README
+The README for the Squashfs\-tools 4.7.1 release, describing the new features can be read here https://github.com/plougher/squashfs\-tools/blob/master/Documentation/4.7.1/README
 .PP
-The Squashfs\-tools USAGE guides and other documentation can be read here
-https://github.com/plougher/squashfs\-tools/blob/master/Documentation/4.7
+The Squashfs\-tools USAGE guides and other documentation can be read here https://github.com/plougher/squashfs\-tools/blob/master/Documentation/4.7.1

Documentation/manpages/sqfscat.1

@@ -1,5 +1,5 @@
 .\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.49.3.
-.TH SQFSCAT "1" "June 2025" "sqfscat version 4.7" "User Commands"
+.TH SQFSCAT "1" "August 2025" "sqfscat version 4.7.1" "User Commands"
 .SH NAME
 sqfscat - tool to cat files from a squashfs filesystem to stdout
 .SH SYNOPSIS
@@ -52,7 +52,7 @@ treat filenames as POSIX regular expressions rather than use the default shell w
 .SS "Help options:"
 .TP
 \fB\-h\fR, \fB\-help\fR
-print help summary information to stdout.
+print help summary information to pager (or stdout if not a terminal).
 .TP
 \fB\-help\-option\fR REGEX
 print the help information for options matching REGEX to pager (or stdout if not a terminal).
@@ -71,6 +71,12 @@ shorthand alternative to \fB\-help\-section\fR.
 .TP
 \fB\-ha\fR
 shorthand alternative to \fB\-help\-all\fR.
+.TP
+\fB\-no\-pager\fR
+do not use a pager to output help information.
+.TP
+\fB\-cols\fR WIDTH
+use WIDTH columns to output help information.  Useful if output is not to a terminal.
 .SH "EXIT STATUS"
 .TP
 0
@@ -82,8 +88,7 @@ FATAL errors occurred, e.g. filesystem corruption, I/O errors.  Sqfscat did not
 2
 Non\-fatal errors occurred, e.g. not a regular file, or failed to resolve pathname.  Sqfscat continued and did not abort.
 .PP
-See \fB\-ignore\-errors\fR, \fB\-strict\-errors\fR and \fB\-no\-exit\-code\fR options for how they affect
-the exit status.
+See \fB\-ignore\-errors\fR, \fB\-strict\-errors\fR and \fB\-no\-exit\-code\fR options for how they affect the exit status.
 .SH "DECOMPRESSORS AVAILABLE"
 gzip, lzo, lz4, xz, zstd
 .SH ENVIRONMENT
@@ -124,9 +129,6 @@ GNU General Public License for more details.
 .SH "SEE ALSO"
 mksquashfs(1), unsquashfs(1), sqfstar(1)
 .PP
-The README for the Squashfs\-tools 4.7 release, describing the new features can
-be read here
-https://github.com/plougher/squashfs\-tools/blob/master/Documentation/4.7/README
+The README for the Squashfs\-tools 4.7.1 release, describing the new features can be read here https://github.com/plougher/squashfs\-tools/blob/master/Documentation/4.7.1/README
 .PP
-The Squashfs\-tools USAGE guides and other documentation can be read here
-https://github.com/plougher/squashfs\-tools/blob/master/Documentation/4.7
+The Squashfs\-tools USAGE guides and other documentation can be read here https://github.com/plougher/squashfs\-tools/blob/master/Documentation/4.7.1