gronod/lfs
1
0
Fork 0
mirror of https://git.linuxfromscratch.org/lfs.git synced 2025-06-19 03:39:20 +01:00
Code Issues Packages Projects Releases Wiki Activity

Clarified directions in re: UEFI. Tweaked verbiage to make it more

Browse Source 
idiomatic. Clarified meaning of configure options. Made several minor
revisions in program descriptions to improve readability. Added a
little explanatory material. Changed imperative mood to indicative
mood where that was appropriate.
This commit is contained in:
David Bryant 2022-12-10 14:56:15 -06:00
parent 9729cec83d
commit abc36486d0
1 changed files with 27 additions and 25 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

52
chapter08/grub.xml
View File

@ -44,9 +44,9 @@
<para> <para>
If your system has UEFI support and you wish to boot LFS with UEFI, If your system has UEFI support and you wish to boot LFS with UEFI,
you can skip this package in LFS, you can skip this package in LFS,
and install GRUB with UEFI support (and its dependencies) following and install GRUB with UEFI support (and its dependencies) by following
<ulink url="&blfs-book;postlfs/grub-efi.html">the BLFS page</ulink> the instructions on
at the end of this chapter. <ulink url="&blfs-book;postlfs/grub-efi.html">the BLFS page</ulink>.
</para> </para>
</note> </note>
@ -56,9 +56,9 @@
<screen><userinput remap='pre'>unset {C,CPP,CXX,LD}FLAGS</userinput></screen> <screen><userinput remap='pre'>unset {C,CPP,CXX,LD}FLAGS</userinput></screen>
<para>Don't try <quote>tuning</quote> this package with custom <para>Don't try <quote>tuning</quote> this package with custom
compilation flags: this package is a bootloader, with low-level compilation flags. This package is a bootloader. The low-level
operations in the source code which is likely to be broken by some operations in the source code may be broken by
aggressive optimizations.</para> aggressive optimization.</para>
</warning> </warning>
<para>Prepare GRUB for compilation:</para> <para>Prepare GRUB for compilation:</para>
@ -75,7 +75,7 @@
<term><parameter>--disable-werror</parameter></term> <term><parameter>--disable-werror</parameter></term>
<listitem> <listitem>
<para>This allows the build to complete with warnings introduced <para>This allows the build to complete with warnings introduced
by more recent Flex versions.</para> by more recent versions of Flex.</para>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -83,7 +83,7 @@
<term><parameter>--disable-efiemu</parameter></term> <term><parameter>--disable-efiemu</parameter></term>
<listitem> <listitem>
<para>This option minimizes what is built by disabling a feature and <para>This option minimizes what is built by disabling a feature and
testing programs not needed for LFS.</para> eliminating some test programs not needed for LFS.</para>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -102,7 +102,7 @@
<screen><userinput remap="install">make install <screen><userinput remap="install">make install
mv -v /etc/bash_completion.d/grub /usr/share/bash-completion/completions</userinput></screen> mv -v /etc/bash_completion.d/grub /usr/share/bash-completion/completions</userinput></screen>
<para>Using GRUB to make your LFS system bootable will be discussed in <para>Making your LFS system bootable with GRUB will be discussed in
<xref linkend="ch-bootable-grub"/>.</para> <xref linkend="ch-bootable-grub"/>.</para>
</sect2> </sect2>
@ -138,7 +138,7 @@ mv -v /etc/bash_completion.d/grub /usr/share/bash-completion/completions</userin
<varlistentry id="grub-bios-setup"> <varlistentry id="grub-bios-setup">
<term><command>grub-bios-setup</command></term> <term><command>grub-bios-setup</command></term>
<listitem> <listitem>
<para>Is a helper program for grub-install</para> <para>Is a helper program for <command>grub-install</command></para>
<indexterm zone="ch-system-grub grub-bios-setup"> <indexterm zone="ch-system-grub grub-bios-setup">
<primary sortas="b-grub-bios-setup">grub-bios-setup</primary> <primary sortas="b-grub-bios-setup">grub-bios-setup</primary>
</indexterm> </indexterm>
@ -148,7 +148,7 @@ mv -v /etc/bash_completion.d/grub /usr/share/bash-completion/completions</userin
<varlistentry id="grub-editenv"> <varlistentry id="grub-editenv">
<term><command>grub-editenv</command></term> <term><command>grub-editenv</command></term>
<listitem> <listitem>
<para>A tool to edit the environment block</para> <para>Is a tool to edit the environment block</para>
<indexterm zone="ch-system-grub grub-editenv"> <indexterm zone="ch-system-grub grub-editenv">
<primary sortas="b-grub-editenv">grub-editenv</primary> <primary sortas="b-grub-editenv">grub-editenv</primary>
</indexterm> </indexterm>
@ -158,7 +158,7 @@ mv -v /etc/bash_completion.d/grub /usr/share/bash-completion/completions</userin
<varlistentry id="grub-file"> <varlistentry id="grub-file">
<term><command>grub-file</command></term> <term><command>grub-file</command></term>
<listitem> <listitem>
<para>Checks if FILE is of the specified type.</para> <para>Checks to see if the given file is of the specified type</para>
<indexterm zone="ch-system-grub grub-file"> <indexterm zone="ch-system-grub grub-file">
<primary sortas="b-grub-file">grub-file</primary> <primary sortas="b-grub-file">grub-file</primary>
</indexterm> </indexterm>
@ -168,7 +168,7 @@ mv -v /etc/bash_completion.d/grub /usr/share/bash-completion/completions</userin
<varlistentry id="grub-fstest"> <varlistentry id="grub-fstest">
<term><command>grub-fstest</command></term> <term><command>grub-fstest</command></term>
<listitem> <listitem>
<para>Tool to debug the filesystem driver</para> <para>Is a tool to debug the filesystem driver</para>
<indexterm zone="ch-system-grub grub-fstest"> <indexterm zone="ch-system-grub grub-fstest">
<primary sortas="b-grub-fstest">grub-fstest</primary> <primary sortas="b-grub-fstest">grub-fstest</primary>
</indexterm> </indexterm>
@ -178,7 +178,7 @@ mv -v /etc/bash_completion.d/grub /usr/share/bash-completion/completions</userin
<varlistentry id="grub-glue-efi"> <varlistentry id="grub-glue-efi">
<term><command>grub-glue-efi</command></term> <term><command>grub-glue-efi</command></term>
<listitem> <listitem>
<para>Glue 32-bit and 64-bit binary into Apple universal one.</para> <para>Glues 32-bit and 64-bit binaries into a single file (for Apple machines)</para>
<indexterm zone="ch-system-grub grub-glue-efi"> <indexterm zone="ch-system-grub grub-glue-efi">
<primary sortas="b-grub-glue-efi">grub-glue-efi</primary> <primary sortas="b-grub-glue-efi">grub-glue-efi</primary>
</indexterm> </indexterm>
@ -188,7 +188,7 @@ mv -v /etc/bash_completion.d/grub /usr/share/bash-completion/completions</userin
<varlistentry id="grub-install"> <varlistentry id="grub-install">
<term><command>grub-install</command></term> <term><command>grub-install</command></term>
<listitem> <listitem>
<para>Install GRUB on your drive</para> <para>Installs GRUB on your drive</para>
<indexterm zone="ch-system-grub grub-install"> <indexterm zone="ch-system-grub grub-install">
<primary sortas="b-grub-install">grub-install</primary> <primary sortas="b-grub-install">grub-install</primary>
</indexterm> </indexterm>
@ -198,7 +198,7 @@ mv -v /etc/bash_completion.d/grub /usr/share/bash-completion/completions</userin
<varlistentry id="grub-kbdcomp"> <varlistentry id="grub-kbdcomp">
<term><command>grub-kbdcomp</command></term> <term><command>grub-kbdcomp</command></term>
<listitem> <listitem>
<para>Script that converts an xkb layout into one recognized by <para>Is a script that converts an xkb layout into one recognized by
GRUB</para> GRUB</para>
<indexterm zone="ch-system-grub grub-kbdcomp"> <indexterm zone="ch-system-grub grub-kbdcomp">
<primary sortas="b-grub-kbdcomp">grub-kbdcomp</primary> <primary sortas="b-grub-kbdcomp">grub-kbdcomp</primary>
@ -209,7 +209,8 @@ mv -v /etc/bash_completion.d/grub /usr/share/bash-completion/completions</userin
<varlistentry id="grub-macbless"> <varlistentry id="grub-macbless">
<term><command>grub-macbless</command></term> <term><command>grub-macbless</command></term>
<listitem> <listitem>
<para>Mac-style bless on HFS or HFS+ files</para> <para>Is the Mac-style bless for HFS or HFS+ files (<command>bless</command>
is peculiar to Apple machiines; it makes a device bootable)</para>
<indexterm zone="ch-system-grub grub-macbless"> <indexterm zone="ch-system-grub grub-macbless">
<primary sortas="b-grub-macbless">grub-macbless</primary> <primary sortas="b-grub-macbless">grub-macbless</primary>
</indexterm> </indexterm>
@ -230,7 +231,7 @@ mv -v /etc/bash_completion.d/grub /usr/share/bash-completion/completions</userin
<varlistentry id="grub-mkconfig"> <varlistentry id="grub-mkconfig">
<term><command>grub-mkconfig</command></term> <term><command>grub-mkconfig</command></term>
<listitem> <listitem>
<para>Generate a grub config file</para> <para>Generates a <filename>grub.cfg</filename> file</para>
<indexterm zone="ch-system-grub grub-mkconfig"> <indexterm zone="ch-system-grub grub-mkconfig">
<primary sortas="b-grub-mkconfig">grub-mkconfig</primary> <primary sortas="b-grub-mkconfig">grub-mkconfig</primary>
</indexterm> </indexterm>
@ -240,7 +241,7 @@ mv -v /etc/bash_completion.d/grub /usr/share/bash-completion/completions</userin
<varlistentry id="grub-mkimage"> <varlistentry id="grub-mkimage">
<term><command>grub-mkimage</command></term> <term><command>grub-mkimage</command></term>
<listitem> <listitem>
<para>Make a bootable image of GRUB</para> <para>Makes a bootable image of GRUB</para>
<indexterm zone="ch-system-grub grub-mkimage"> <indexterm zone="ch-system-grub grub-mkimage">
<primary sortas="b-grub-mkimage">grub-mkimage</primary> <primary sortas="b-grub-mkimage">grub-mkimage</primary>
</indexterm> </indexterm>
@ -291,7 +292,8 @@ mv -v /etc/bash_completion.d/grub /usr/share/bash-completion/completions</userin
<varlistentry id="grub-mkrescue"> <varlistentry id="grub-mkrescue">
<term><command>grub-mkrescue</command></term> <term><command>grub-mkrescue</command></term>
<listitem> <listitem>
<para>Make a bootable image of GRUB suitable for a floppy disk or CDROM/DVD</para> <para>Makes a bootable image of GRUB suitable for a floppy disk,
CDROM/DVD, or a USB drive</para>
<indexterm zone="ch-system-grub grub-mkrescue"> <indexterm zone="ch-system-grub grub-mkrescue">
<primary sortas="b-grub-mkrescue">grub-mkrescue</primary> <primary sortas="b-grub-mkrescue">grub-mkrescue</primary>
</indexterm> </indexterm>
@ -311,7 +313,7 @@ mv -v /etc/bash_completion.d/grub /usr/share/bash-completion/completions</userin
<varlistentry id="grub-ofpathname"> <varlistentry id="grub-ofpathname">
<term><command>grub-ofpathname</command></term> <term><command>grub-ofpathname</command></term>
<listitem> <listitem>
<para>Is a helper program that prints the path of a GRUB device</para> <para>Is a helper program that prints the path to a GRUB device</para>
<indexterm zone="ch-system-grub grub-ofpathname"> <indexterm zone="ch-system-grub grub-ofpathname">
<primary sortas="b-grub-ofpathname">grub-ofpathname</primary> <primary sortas="b-grub-ofpathname">grub-ofpathname</primary>
</indexterm> </indexterm>
@ -321,7 +323,7 @@ mv -v /etc/bash_completion.d/grub /usr/share/bash-completion/completions</userin
<varlistentry id="grub-probe"> <varlistentry id="grub-probe">
<term><command>grub-probe</command></term> <term><command>grub-probe</command></term>
<listitem> <listitem>
<para>Probe device information for a given path or device</para> <para>Probes device information for a given path or device</para>
<indexterm zone="ch-system-grub grub-probe"> <indexterm zone="ch-system-grub grub-probe">
<primary sortas="b-grub-probe">grub-probe</primary> <primary sortas="b-grub-probe">grub-probe</primary>
</indexterm> </indexterm>
@ -341,7 +343,7 @@ mv -v /etc/bash_completion.d/grub /usr/share/bash-completion/completions</userin
<varlistentry id="grub-render-label"> <varlistentry id="grub-render-label">
<term><command>grub-render-label</command></term> <term><command>grub-render-label</command></term>
<listitem> <listitem>
<para>Render Apple .disk_label for Apple Macs</para> <para>Renders Apple .disk_label for Apple Macs</para>
<indexterm zone="ch-system-grub grub-render-label"> <indexterm zone="ch-system-grub grub-render-label">
<primary sortas="b-grub-render-label">grub-render-label</primary> <primary sortas="b-grub-render-label">grub-render-label</primary>
</indexterm> </indexterm>
@ -351,7 +353,7 @@ mv -v /etc/bash_completion.d/grub /usr/share/bash-completion/completions</userin
<varlistentry id="grub-script-check"> <varlistentry id="grub-script-check">
<term><command>grub-script-check</command></term> <term><command>grub-script-check</command></term>
<listitem> <listitem>
<para>Checks GRUB configuration script for syntax errors</para> <para>Checks the GRUB configuration script for syntax errors</para>
<indexterm zone="ch-system-grub grub-script-check"> <indexterm zone="ch-system-grub grub-script-check">
<primary sortas="b-grub-script-check">grub-script-check</primary> <primary sortas="b-grub-script-check">grub-script-check</primary>
</indexterm> </indexterm>
@ -381,7 +383,7 @@ mv -v /etc/bash_completion.d/grub /usr/share/bash-completion/completions</userin
<varlistentry id="grub-syslinux2cfg"> <varlistentry id="grub-syslinux2cfg">
<term><command>grub-syslinux2cfg</command></term> <term><command>grub-syslinux2cfg</command></term>
<listitem> <listitem>
<para>Transform a syslinux config file into grub.cfg format</para> <para>Transforms a syslinux config file into grub.cfg format</para>
<indexterm zone="ch-system-grub grub-syslinux2cfg"> <indexterm zone="ch-system-grub grub-syslinux2cfg">
<primary sortas="b-grub-syslinux2cfg">grub-syslinux2cfg</primary> <primary sortas="b-grub-syslinux2cfg">grub-syslinux2cfg</primary>
</indexterm> </indexterm>