Package: mtools Version: 4.0.33-1+really4.0.32-1 Severity: minor Tags: patch
Dear Maintainer, here are some fixes. Input file is mtools.1 Output from "mandoc.loc -T lint mtools.1" mandoc: mtools.1:16:2: WARNING: skipping paragraph macro: PP empty mandoc: mtools.1:27:82: STYLE: input text line longer than 80 bytes: instance, commands s... mandoc: mtools.1:31:2: WARNING: skipping paragraph macro: PP empty mandoc: mtools.1:33:2: WARNING: skipping paragraph macro: PP after SH mandoc: mtools.1:44:1: WARNING: skipping paragraph macro: sp after PP mandoc: mtools.1:60:2: WARNING: skipping paragraph macro: PP empty mandoc: mtools.1:62:2: WARNING: skipping paragraph macro: PP empty mandoc: mtools.1:92:2: WARNING: skipping paragraph macro: PP empty mandoc: mtools.1:94:2: WARNING: skipping paragraph macro: PP after SS mandoc: mtools.1:119:1: WARNING: skipping paragraph macro: sp after PP mandoc: mtools.1:138:1: WARNING: skipping paragraph macro: sp after PP mandoc: mtools.1:143:2: WARNING: skipping paragraph macro: PP empty mandoc: mtools.1:145:2: WARNING: skipping paragraph macro: PP after SS mandoc: mtools.1:151:2: WARNING: skipping paragraph macro: PP empty mandoc: mtools.1:153:2: WARNING: skipping paragraph macro: PP after SS mandoc: mtools.1:161:1: WARNING: skipping paragraph macro: sp after PP mandoc: mtools.1:176:1: WARNING: skipping paragraph macro: sp after PP mandoc: mtools.1:210:1: WARNING: skipping paragraph macro: sp after PP mandoc: mtools.1:223:1: WARNING: skipping paragraph macro: sp after PP mandoc: mtools.1:236:1: WARNING: skipping paragraph macro: sp after PP mandoc: mtools.1:248:1: WARNING: skipping paragraph macro: sp after PP mandoc: mtools.1:259:2: WARNING: skipping paragraph macro: PP empty mandoc: mtools.1:261:2: WARNING: skipping paragraph macro: PP after SS mandoc: mtools.1:334:2: WARNING: skipping paragraph macro: PP empty mandoc: mtools.1:336:2: WARNING: skipping paragraph macro: PP after SS mandoc: mtools.1:354:2: WARNING: skipping paragraph macro: PP empty mandoc: mtools.1:356:2: WARNING: skipping paragraph macro: PP after SS mandoc: mtools.1:374:1: WARNING: skipping paragraph macro: sp after PP mandoc: mtools.1:380:2: WARNING: skipping paragraph macro: PP empty mandoc: mtools.1:382:2: WARNING: skipping paragraph macro: PP after SS mandoc: mtools.1:398:2: WARNING: skipping paragraph macro: PP empty mandoc: mtools.1:411:2: WARNING: skipping paragraph macro: PP empty mandoc: mtools.1:413:2: WARNING: skipping paragraph macro: PP after SS mandoc: mtools.1:433:2: WARNING: skipping paragraph macro: PP empty mandoc: mtools.1:435:2: WARNING: skipping paragraph macro: PP after SS mandoc: mtools.1:442:86: STYLE: input text line longer than 80 bytes: configuration file. ... mandoc: mtools.1:457:2: WARNING: skipping paragraph macro: PP empty mandoc: mtools.1:470:55: STYLE: whitespace at end of input line mandoc: mtools.1:476:2: WARNING: skipping paragraph macro: PP empty ####### Remove space characters at the end of lines. Use "git apply ... --whitespace=fix" to fix extra space issues, or use global configuration "core.whitespace". 470:from the device driver. These can be safely ignored. ##### Reduce space between words. 103:changes using a configuration file (see section Configuration). 466:(see section global variables) ##### Increase size of ~ (tilde) to make it more visible with "troff" by using character \(ti. 167:thisisatest THISIS~1 filename too long 168:alain.knaff ALAIN~1.KNA extension too long 169:prn.txt PRN~1.TXT PRN is a device name 170:\&\&.abc ABC~1 null filename 171:hot+cold HOT_CO~1 illegal character ##### Use the word (in)valid instead of (il)legal if not related to legal matters. See "www.gnu.org/prep/standards". Think about translations into other languages! mtools.1:171:hot+cold HOT_CO~1 illegal character mtools.1:183:Illegal characters are replaced by underscores. The illegal characters mtools.1:232:that are not acceptable, even in VFAT. There are still some illegal mtools.1:243:ab:c ab_c-1 illegal character mtools.1:252:illegal: mtools.1:255:Illegal characters are replaces by underscores, ##### Change a HYPHEN-MINUS (code 0x55, 2D) to a minus (\-), if in front of a name for an option. 114: mcopy -i my-image-file.bin ::file1 ::file2 . 133: mcopy -i my-image-file.bin@@1M ::file1 ::file2 . ##### Use \(en for a dash (en-dash) between space characters, not a minus (\-) or a hyphen (-), except in the NAME section. mtools.1:4:mtools - utilities to access DOS disks in Unix. ##### "\fR" might be redundant, use "\fP" or remove. 45:\&\fR 120:\&\fR 177:\&\fR 249:\&\fR 375:\&\fR ##### --- mtools.1 2023-06-06 00:35:33.000000000 +0000 +++ mtools.1.new 2023-06-11 16:06:28.000000000 +0000 @@ -1,7 +1,7 @@ '\" t .TH mtools 1 "10Jul21" mtools-4.0.32 .SH Name -mtools - utilities to access DOS disks in Unix. +mtools \- utilities to access DOS disks in Unix. '\" t .de TQ .br @@ -13,7 +13,6 @@ mtools - utilities to access DOS disks i .tr \(if` .tr \(pd" -.PP .SH Introduction Mtools is a collection of tools to allow Unix systems to manipulate MS-DOS files: read, write, and move around files on an MS-DOS @@ -28,9 +27,8 @@ instance, commands such as \fR\&\f(CWmdi without any preliminary mounting or initialization (assuming the default \&\fR\&\f(CW\(if/etc/mtools.conf\(is\fR works on your machine). With mtools, one can change floppies too without unmounting and mounting. -.PP +. .SH Where\ to\ get\ mtools -.PP Mtools can be found at the following places (and their mirrors): .nf @@ -40,9 +38,7 @@ http://ftp.gnu.org/gnu/mtools/mtools-4.0 .fi .in -0.3i .ft R -.PP -\&\fR .PP These patches are named \&\fR\&\f(CWmtools-\fR\fIversion\fR\fR\&\f(CW-\fR\fIddmm\fR\fR\&\f(CW.taz\fR, where version @@ -57,9 +53,9 @@ remove the spaces around the "@". I left spambots.) Announcements of new mtools versions will also be sent to the list, in addition to the Linux announce newsgroups. The mailing list is archived at http://lists.gnu.org/pipermail/info-mtools/ -.PP +. .SH Common\ features\ of\ all\ mtools\ commands -.PP +. .SS Options\ and\ filenames MS-DOS filenames are composed of a drive letter followed by a colon, a subdirectory, and a filename. Only the filename part is mandatory, the @@ -89,9 +85,8 @@ accept the \fR\&\f(CW-v\fR flag, which s mode, these commands print out the name of the MS-DOS files upon which they act, unless stated otherwise. See section Commands, for a description of the options which are specific to each command. -.PP +. .SS Drive\ letters -.PP The meaning of the drive letters depends on the target architectures. However, on most target architectures, drive A is the first floppy drive, drive B is the second floppy drive (if available), drive J is a @@ -100,7 +95,7 @@ those systems where the device name is d drive is assumed to be at SCSI target 4, and the Zip at SCSI target 5 (factory default settings). On Linux, both drives are assumed to be the second drive on the SCSI bus (/dev/sdb). The default settings can be -changes using a configuration file (see section Configuration). +changes using a configuration file (see section Configuration). .PP The drive letter : (colon) has a special meaning. It is used to access image files which are directly specified on the command line using the @@ -111,13 +106,11 @@ Example: .nf .ft 3 .in +0.3i - mcopy -i my-image-file.bin ::file1 ::file2 . + mcopy \-i my-image-file.bin ::file1 ::file2 . .fi .in -0.3i .ft R -.PP -\&\fR .PP This copies \fR\&\f(CWfile1\fR and \fR\&\f(CWfile2\fR from the image file (\fR\&\f(CWmy-image-file.bin\fR) to the \fR\&\f(CW/tmp\fR directory. @@ -130,27 +123,23 @@ Example: .nf .ft 3 .in +0.3i - mcopy -i my-image-file.bin@@1M ::file1 ::file2 . + mcopy \-i my-image-file.bin@@1M ::file1 ::file2 . .fi .in -0.3i .ft R -.PP -\&\fR .PP This looks for the image at the offset of 1M in the file, rather than at its beginning. -.PP +. .SS Current\ working\ directory -.PP The \fR\&\f(CWmcd\fR command (\(ifmcd\(is) is used to establish the device and the current working directory (relative to the MS-DOS file system), otherwise the default is assumed to be \fR\&\f(CWA:/\fR. However, unlike MS-DOS, there is only one working directory for all drives, and not one per drive. -.PP +. .SS VFAT-style\ long\ file\ names -.PP This version of mtools supports VFAT style long filenames. If a Unix filename is too long to fit in a short DOS name, it is stored as a VFAT long name, and a companion short name is generated. This short @@ -164,23 +153,21 @@ of DOS. .in +0.3i Long name MS-DOS name Reason for the change --------- ---------- --------------------- -thisisatest THISIS~1 filename too long -alain.knaff ALAIN~1.KNA extension too long -prn.txt PRN~1.TXT PRN is a device name -\&\&.abc ABC~1 null filename -hot+cold HOT_CO~1 illegal character +thisisatest THISIS\(ti1 filename too long +alain.knaff ALAIN\(ti1.KNA extension too long +prn.txt PRN\(ti1.TXT PRN is a device name +\&\&.abc ABC\(ti1 null filename +hot+cold HOT_CO\(ti1 invalid character .fi .in -0.3i .ft R -.PP -\&\fR .PP As you see, the following transformations happen to derive a short name: .TP * \ \ -Illegal characters are replaced by underscores. The illegal characters +Invalid characters are replaced by underscores. The invalid characters are \fR\&\f(CW;+=[]',\e"*\e\e<>/?:|\fR. .TP * \ \ @@ -221,7 +208,7 @@ secondary name. .ft R .PP -\&\fR Motd fits into the DOS filename limits. Mtools doesn't need to +Motd fits into the DOS filename limits. Mtools doesn't need to derivate another name. Motd is the primary name, and there is no secondary name. .PP @@ -229,7 +216,7 @@ secondary name. the short name if there is no long name. .PP Although VFAT is much more flexible than FAT, there are still names -that are not acceptable, even in VFAT. There are still some illegal +that are not acceptable, even in VFAT. There are still some invalid characters left (\fR\&\f(CW\e"*\e\e<>/?:|\fR), and device names are still reserved. .PP @@ -240,25 +227,22 @@ reserved. Unix name Long name Reason for the change --------- ---------- --------------------- prn prn-1 PRN is a device name -ab:c ab_c-1 illegal character +ab:c ab_c-1 invalid character .fi .in -0.3i .ft R -.PP -\&\fR .PP As you see, the following transformations happen if a long name is -illegal: +invalid: .TP * \ \ -Illegal characters are replaces by underscores, +Invalid characters are replaced by underscores, .TP * \ \ A \fR\&\f(CW-\fR\fIn\fR number is generated, -.PP +. .SS Name\ clashes -.PP When writing a file to disk, its long name or short name may collide with an already existing file or directory. This may happen for all commands which create new directory entries, such as \fR\&\f(CWmcopy\fR, @@ -331,9 +315,8 @@ secondary name is autorenamed. .PP If a name clash occurs in a Unix directory, mtools only asks whether to overwrite the file, or to skip it. -.PP +. .SS Case\ sensitivity\ of\ the\ VFAT\ file\ system -.PP The VFAT file system is able to remember the case of the filenames. However, filenames which differ only in case are not allowed to coexist in the same directory. For example if you store a file called @@ -351,9 +334,8 @@ results when applied to files written us Indeed, the old style filenames map to all upper case. This is different from the behavior of the old version of mtools which used to generate lower case Unix filenames. -.PP +. .SS high\ capacity\ formats -.PP Mtools supports a number of formats which allow storage of more data on disk than usual. Due to different operating system abilities, these formats are not supported on all operating systems. Mtools recognizes @@ -370,16 +352,13 @@ specific tool. For Linux, suitable flopp .fi .in -0.3i .ft R -.PP -\&\fR .PP See the manual pages included in that package for further detail: Use \&\fR\&\f(CWsuperformat\fR to format all formats except XDF, and use \&\fR\&\f(CWxdfcopy\fR to format XDF. -.PP +. .SS \ \ More\ sectors -.PP The oldest method of fitting more data on a disk is to use more sectors and more cylinders. Although the standard format uses 80 cylinders and 18 sectors (on a 3 1/2 high density disk), it is possible to use up to @@ -395,7 +374,7 @@ believed that he invented this, and call \&\fR\&\f(CW\(ifWindows formatted disks\(is\fR. But in reality, it has already existed years before! Mtools supports these formats on Linux, on SunOS and on the DELL Unix PC. -.PP +. .SS \ \ Bigger\ sectors By using bigger sectors it is possible to go beyond the capacity which can be obtained by the standard 512-byte sectors. This is because of the @@ -408,9 +387,8 @@ headers, for the same amount of useful d This method permits storage of up to 1992K on a 3 1/2 HD disk. .PP Mtools supports these formats only on Linux. -.PP +. .SS \ \ 2m -.PP The 2m format was originally invented by Ciriaco Garcia de Celis. It also uses bigger sectors than usual in order to fit more data on the disk. However, it uses the standard format (18 sectors of 512 bytes @@ -430,9 +408,8 @@ is saved.) This also means that you shou to store anything else than a DOS file system\fR. .PP Mtools supports these formats only on Linux. -.PP +. .SS \ \ XDF -.PP XDF is a high capacity format used by OS/2. It can hold 1840 K per disk. That's lower than the best 2m formats, but its main advantage is that it is fast: 600 milliseconds per track. That's faster than the 21 @@ -454,7 +431,7 @@ compiled on kernels older than 1.3.34 un be out, mtools binaries compiled on newer kernels may (and should) be distributed. Mtools binaries compiled on kernels older than 1.3.34 won't run on any 2.1 kernel or later. -.PP +. .SS Exit\ codes All the Mtools commands return 0 on success, 1 on utter failure, or 2 on partial failure. All the Mtools commands perform a few sanity @@ -467,13 +444,13 @@ environmental variable or the correspond .SS Bugs An unfortunate side effect of not guessing the proper device (when multiple disk capacities are supported) is an occasional error message -from the device driver. These can be safely ignored. +from the device driver. These can be safely ignored. .PP The fat checking code chokes on 1.72 Mb disks mformatted with pre-2.0.7 mtools. Set the environmental variable MTOOLS_FAT_COMPATIBILITY (or the corresponding configuration file variable, \(ifglobal variables\(is) to bypass the fat checking. -.PP +. .SH See also floppyd_installtest mattrib -- System Information: Debian Release: 12.0 APT prefers testing APT policy: (500, 'testing') Architecture: amd64 (x86_64) Kernel: Linux 6.1.27-1 (SMP w/2 CPU threads; PREEMPT) Locale: LANG=is_IS.iso88591, LC_CTYPE=is_IS.iso88591 (charmap=ISO-8859-1), LANGUAGE not set Shell: /bin/sh linked to /usr/bin/dash Init: sysvinit (via /sbin/init) Versions of packages mtools depends on: ii libc6 2.36-9 mtools recommends no packages. Versions of packages mtools suggests: pn floppyd <none> -- no debconf information
