[Info-mtools] Issues in mtool manpages

[Helge Kreutzmann]

Dear mtools maintainer,
the manpage-l10n project maintains a large number of translations of
man pages both from a large variety of sources (including mtools) as
well for a large variety of target languages.

During their work translators notice different possible issues in the
original (english) man pages. Sometimes this is a straightforward
typo, sometimes a hard to read sentence, sometimes this is a
convention not held up and sometimes we simply do not understand the
original.

We use several distributions as sources and update regularly (at
least every 2 month). This means we are fairly recent (some
distributions like archlinux also update frequently) but might miss
the latest upstream version once in a while, so the error might be
already fixed. We apologize and ask you to close the issue immediately
if this should be the case, but given the huge volume of projects and
the very limited number of volunteers we are not able to double check
each and every issue.

Secondly we translators see the manpages in the neutral po format,
i.e. converted and harmonized, but not the original source (be it man,
groff, xml or other). So we cannot provide a true patch (where
possible), but only an approximation which you need to convert into
your source format.

Finally the issues I'm reporting have accumulated over time and are
not always discovered by me, so sometimes my description of the
problem my be a bit limited - do not hesitate to ask so we can clarify
them.

I'm now reporting the errors for your project. If future reports
should use another channel, please let me know.

Man page: mattrib.1
Issue:    flags → tags

"mattrib - change MSDOS file attribute flags"

"\\&\\&CW<Mattrib> is used to change MS-DOS file attribute flags. It has the "
"following syntax:"

"\\&\\&CW<Mattrib> adds attribute flags to an MS-DOS file (with the `\\&CW<"
"+>' operator) or remove attribute flags (with the `\\&CW<->' operator)."
--
Man page: mattrib.1
Issue:    mformat → \\&CW<mformat>

"Replay mode.  Outputs a series of \\&CW<mformat> commands that will "
"reproduce the current situation, starting from a situation as left by "
"untarring the MS-DOS file system.  Commands are only output for attribute "
"settings that differ from the default (archive bit set for files, unset for "
"directories).  This option is intended to be used in addition to tar. The "
"\\&CW<readonly> attribute is not taken into account, as tar can set that one "
"itself."
--
Man page: mcopy.1
Issue:    (\\(ifname → (see \\(ifname

"No confirmation when overwriting Unix files.  \\&CW<ASCII> doesn't warn the "
"user when overwriting an existing Unix file. If the target file already "
"exists, and the \\&CW<-n> option is not in effect, \\&\\&CW<mcopy> asks "
"whether to overwrite the file or to rename the new file (see \\(ifname "
"clashes\\(is) for details).  In order to switch off confirmation for DOS "
"files, use \\&CW<-o>."
--
Man page: mkmanifest.1
Issue:    Unix → UNIX

"The \\&CW<mkmanifest> command is used to create a shell script (packing "
"list) to restore Unix filenames. Its syntax is:"

"You want to copy the following Unix files to a MS-DOS diskette (using the \\&"
"\\&CW<mcopy> command)."

"Suppose I've copied these files from the diskette to another Unix system, "
"and I now want the files back to their original names.  If the file "
"\"manifest\" (the output captured above) was sent along with those files, it "
"could be used to convert the filenames."
--
Man page: mkmanifest.1
Issue:    makmanifest doesn't touch filenames with both lowercase and uppercase 
letters (see the example below, v4.0.26).

"\\&\\&CW<Mkmanifest> creates a shell script that aids in the restoration of "
"Unix filenames that got clobbered by the MS-DOS filename restrictions.  MS-"
"DOS filenames are restricted to 8 character names, 3 character extensions, "
"upper case only, no device names, and no illegal characters."
--
Man page: mkmanifest.1
Issue 1:  mkmanifest → \\&CW<mkmanifest>
Issue 2:  Unix → UNIX

"The mkmanifest program is compatible with the methods used in \\&"
"\\&CW<pcomm, arc,> and \\&CW<mtools> to change perfectly good Unix filenames "
"to fit the MS-DOS restrictions. This command is only useful if the target "
"system which will read the diskette cannot handle VFAT long names."
--
Man page: mkmanifest.1
Issue:    Capitalization is obviously not of particular interest in the current 
mtools-4.0.26. Should be fixed in the man page (or even fixed in mtools 
itself).  

"B<  mv very_lon very_long_name\n"
"  mv 2xmany.dot 2.many.dots\n"
"  mv illegalx illegal:\n"
"  mv xprn.dev prn.dev\n"
"  mv capital Capital>\n"
--
Man page: mmove.1
Issue:    moves or renames → move or rename

"The \\&CW<mmove> command is used to move or rename an existing MS-DOS file "
"or subdirectory."
--
Man page: mpartition.1
Issue:    mpartition → B<mpartition>

"The starting offset of the partition, expressed in sectors. If begin is not "
"given, \\&CW<mpartition> lets the partition begin at the start of the disk "
"(partition number 1), or immediately after the end of the previous partition."

"The size (length) of the partition, expressed in sectors.  If end is not "
"given, \\&CW<mpartition> figures out the size from the number of sectors, "
"heads and cylinders.  If these are not given either, it gives the partition "
"the biggest possible size, considering disk size and start of the next "
"partition."
--
Man page: mpartition.1
Issue 1:  mpartition → \\&CW<mpartition>
Issue 2:  is not changes → won't be changed

"Usually, before writing back any changes to the partition, mpartition "
"performs certain consistency checks, such as checking for overlaps and "
"proper alignment of the partitions.  If any of these checks fails, the "
"partition table is not changed.  The \\&CW<-f> allows you to override these "
"safeguards."
--
Man page: mpartition.1
Issue:    mpartition → \\&CW<mpartition>

"If the verbosity flag is given twice, \\&CW<mpartition> will print out a "
"hexdump of the partition table when reading it from and writing it to the "
"device."
--
Man page: mpartition.1
Issue:    within the 65536 sector → within 65536 sectors

"For all others, if the partition fits entirely within the first 65536 "
"sectors of the disk, assign 0x01 (``\\&CW<DOS FAT12, CHS>'') for FAT12 "
"partition and 0x04 (``\\&CW<DOS FAT16, CHS>'') for FAT16 partitions"
--
Man page: mren.1
Issue:    There's no difference between the current directory and the directory 
which the mcd command reports; \\&\\&CW<mcd> is superfluous

"If the first syntax is used (only one source file), and if the target name "
"doesn't contain any slashes or colons, the file (or subdirectory)  is "
"renamed in the same directory, instead of being moved to the current \\&"
"\\&CW<mcd> directory as would be the case with \\&CW<mmove>. Unlike the MS-"
"DOS version of \\&CW<REN>, \\&CW<mren> can be used to rename directories."

Greetings

         Helge

-- 
      Dr. Helge Kreutzmann                     debian@helgefjell.de
           Dipl.-Phys.                   http://www.helgefjell.de/debian.php
        64bit GNU powered                     gpg signed mail preferred
           Help keep free software "libre": http://www.ffii.de/

signature.asc
Description: PGP signature