[bug #58507] Errors in grub man pages

[Helge Kreutzmann]

URL:
  <https://savannah.gnu.org/bugs/?58507>

                 Summary: Errors in grub man pages
                 Project: GNU GRUB
            Submitted by: kreutzm
            Submitted on: Sat 06 Jun 2020 12:52:33 PM UTC
                Category: None
                Severity: Major
                Priority: 5 - Normal
              Item Group: Documentation
                  Status: None
                 Privacy: Public
             Assigned to: None
         Originator Name: Helge Kreutzmann
        Originator Email: 
             Open/Closed: Open
                 Release: 
                 Release: other
         Discussion Lock: Any
         Reproducibility: None
         Planned Release: None

    _______________________________________________________

Details:

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

During their work translators notice different possible issues in the
original (english) man pages. Sometiems 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 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: grub2-file.1
Issue:  POWERPC → PowerPC

"Check if FILE is POWERPC Linux"
--
Man page: grub2-file.1
Issue 1: Mac OS X kernel → macOS
Issue 2: second »file« is missing

"Check if FILE is x86_64 XNU (Mac OS X kernel)"

"Check if FILE is i386 XNU (Mac OS X kernel)"
--
Man page: grub2-file.1
Issue: Mac OS X kernel → macOS
"Check if FILE is XNU (Mac OS X kernel) hibernated image"
--
Man page: grub2-fstest.1
Issue: â → a

"B<grub-fstest> â<U+0080><U+0094> Debug tool for GRUB's filesystem driver."
--
Man page: grub2-install.8
Issue: opption → option

"Use I<ID> as the bootloader ID.  This opption is only available on the EFI "
"target platform."
--
Man page: grub2-install.8
Issue 1: opption → option
Issue 2: ta rget → target

"Use I<DIR> as the EFI System Partition root.  This opption is only available
"
"on the EFI ta rget platform."
--
Man page: grub2-macbless.8
Issue: B<grub-mkimage> → B<grub-macbless>

"B<grub-mkimage> blesses a file on an HFS or HFS+ file system, so that it can
"
"be used to boot a Mac."
--
Man page: grub2-mkrescue.1
Issue: Markup strange (only for COLOR?)

"Use I<COLOR as the color for generated labels.>"
--
Man page: grub2-render-label.1
Issue: Markup strange (only for COLOR?)

"Use I<COLOR as the color for generated labels.>"
--
Man page: grub-bios-setup.8
Issue: Double slash

"use FILE as the device map [default=//boot/grub/device.map]"
--
Man page: grub-editenv.1
Issue: Double slash

"If FILENAME is `-', the default value //boot/grub/grubenv is used."
--
Man page: grub-file.1
Issue: POWERPC → PowerPC

"Check if FILE is POWERPC Linux"
--
Man page: grub-file.1
Issue: separation of argument and description in two gettext messages (=
strings) needed

"B<--is-x86_64-knetbsd> Check if FILE is x86_64 kNetBSD"
--
Man page: grub-file.1
Issue 1: Mac OS X kernel → macOS
Issue 2: second »file« is missing

"Check if FILE is x86_64 XNU (Mac OS X kernel)"

"Check if FILE is i386 XNU (Mac OS X kernel)"
--
Man page: grub-file.1
Issue: Mac OS X kernel → macOS

"Check if FILE is XNU (Mac OS X kernel) hibernated image"
--
Man page: grub-file.1
Issue: separation of arguments and descriptions in multiple gettext messages
(= strings) needed

"B<-h>, B<--help> Display this help and exit.  B<-u>, B<--usage> Display the
"
"usage of this command and exit."
--
Man page: grub-fstest.1
Issue: N → NUM (according to previous string)

"Skip N bytes from output file."
--
Man page: grub-install.8
Issue: separation of argument and description in two gettext messages (=
strings) needed

"B<--locale-directory>=I<\\,DIR\\/> use translations under DIR"

"B<--macppc-directory>=I<\\,DIR\\/> use DIR for PPC MAC install."
--
Man page: grub-mkimage.1
Issue: distance between short and long option

msgid "B<-m>,                              B<--memdisk>=I<\\,FILE\\/>"
--
Man page: grub-mkimage.1
Issue: memdisk → ramdisk?

"embed FILE as a memdisk image"
--
Man page: grub-mkimage.1
Issue: in FORMAT available formats: → in FORMAT. Available formats:

"generate an image in FORMAT available formats: i386-coreboot, i386-"
"multiboot, i386-pc, i386-xen_pvh, i386-pc-pxe, i386-pc-eltorito, i386-efi, "
"i386-ieee1275, i386-qemu, x86_64-efi, i386-xen, x86_64-xen,
mipsel-yeeloong-"
"flash, mipsel-fuloong2f-flash, mipsel-loongson-elf, powerpc-ieee1275, "
"sparc64-ieee1275-raw, sparc64-ieee1275-cdcore, sparc64-ieee1275-aout, ia64-"
"efi, mips-arc, mipsel-arc, mipsel-qemu_mips-elf, mips-qemu_mips-flash, "
"mipsel-qemu_mips-flash, mips-qemu_mips-elf, arm-uboot, arm-coreboot-"
"vexpress, arm-coreboot-veyron, arm-efi, arm64-efi, riscv32-efi, riscv64-efi"
--
Man page: grub-mknetdir.1
Issue: separation of argument and description in two gettext messages (=
strings) needed

"B<--locale-directory>=I<\\,DIR\\/> use translations under DIR"
--
Man page: grub-mkrescue.1
Issue: separation of argument and description in two gettext messages (=
strings) needed

"B<--locale-directory>=I<\\,DIR\\/> use translations under DIR"
--
Man page: grub-mkstandalone.1
Issue: memdisk → ramdisk?

"grub-mkstandalone - make a memdisk-based GRUB image"
--
Man page: grub-mkstandalone.1
Issue: separation of argument and description in two gettext messages (=
strings) needed

"B<--locale-directory>=I<\\,DIR\\/> use translations under DIR"
--
Man page: grub-mkstandalone.1
Issue: in FORMAT available formats: → in FORMAT. Available formats:

"generate an image in FORMAT available formats: i386-coreboot, i386-"
"multiboot, i386-pc, i386-xen_pvh, i386-pc-pxe, i386-pc-eltorito, i386-efi, "
"i386-ieee1275, i386-qemu, x86_64-efi, i386-xen, x86_64-xen,
mipsel-yeeloong-"
"flash, mipsel-fuloong2f-flash, mipsel-loongson-elf, powerpc-ieee1275, "
"sparc64-ieee1275-raw, sparc64-ieee1275-cdcore, sparc64-ieee1275-aout, ia64-"
"efi, mips-arc, mipsel-arc, mipsel-qemu_mips-elf, mips-qemu_mips-flash, "
"mipsel-qemu_mips-flash, mips-qemu_mips-elf, arm-uboot, arm-coreboot-"
"vexpress, arm-coreboot-veyron, arm-efi, arm64-efi, riscv32-efi, riscv64-efi"
--
Man page: grub-probe.8
Issue: Double slash
"use FILE as the device map [default=//boot/grub/device.map]"
--
Man page: grub-probe.8
Issue: TARGET available → TARGET. Available

"print TARGET available targets: abstraction, arc_hints, baremetal_hints, "
"bios_hints, compatibility_hint, cryptodisk_uuid, device, disk, drive, "
"efi_hints, fs, fs_label, fs_uuid, gpt_parttype, hints_string, "
"ieee1275_hints, msdos_parttype, partmap, partuuid, zero_check [default=fs]"
--
Man page: grub-sparc64-setup.8
Issue: Double slash

"use FILE as the device map [default=//boot/grub/device.map]"





    _______________________________________________________

Reply to this item at:

  <https://savannah.gnu.org/bugs/?58507>

_______________________________________________
  Message sent via Savannah
  https://savannah.gnu.org/