bugGNU GRUB - Bugs: bug #58507, Errors in grub man pages

 
 

You are not allowed to post comments on this tracker with your current authentication level.

bug #58507: Errors in grub man pages

Submitter:  Helge Kreutzmann <kreutzm>
Submitted:  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
Open/Closed:  Open Release:  other
Release:  Reproducibility:  None
Planned Release:  None

Sat 06 Jun 2020 12:52:33 PM UTC, original submission:  

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]"

Helge Kreutzmann <kreutzm>

 

(Note: upload size limit is set to 16384 kB, after insertion of the required escape characters.)

No files currently attached

 

Depends on the following items: None found

Items that depend on this one: None found

 

Carbon-Copy List
  • -email is unavailable- added by kreutzm (Submitted the item)
  •  

    There are 0 votes so far. Votes easily highlight which items people would like to see resolved in priority, independently of the priority of the item set by tracker managers.

     

    No changes have been made to this item

    Back to the top

    Powered by Savane 3.13-f8d8.
    Corresponding source code