grub-devel
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: [PATCH 2/2] docs: Add documentation for the efitextmode command


From: Paul Menzel
Subject: Re: [PATCH 2/2] docs: Add documentation for the efitextmode command
Date: Fri, 13 May 2022 08:41:20 +0200
User-agent: Mozilla/5.0 (X11; Linux x86_64; rv:91.0) Gecko/20100101 Thunderbird/91.8.1

Dear Glenn,


Am 13.05.22 um 00:46 schrieb Glenn Washburn:
On Thu, 12 May 2022 08:08:32 +0200 Paul Menzel wrote:

[…]

Am 12.05.22 um 05:07 schrieb Glenn Washburn:
Signed-off-by: Glenn Washburn <development@efficientek.com>

*Add documentation for …* could be abbreviated to *Document …* in the
git commit message summary.

---
   docs/grub.texi | 23 +++++++++++++++++++++++
   1 file changed, 23 insertions(+)

diff --git a/docs/grub.texi b/docs/grub.texi
index 3b5522b0a..50ef28edd 100644
--- a/docs/grub.texi
+++ b/docs/grub.texi
@@ -4202,6 +4202,7 @@ you forget a command, you can run the command 
@command{help}
  * distrust::                    Remove a pubkey from trusted keys
  * drivemap::                    Map a drive to another
  * echo::                        Display a line of text
+* efitextmode::                 Set/Get text output mode resolution
  * eval::                        Evaluate agruments as GRUB commands
  * export::                      Export an environment variable
  * false::                       Do nothing, unsuccessfully
@@ -4638,6 +4639,28 @@ character will print that character.
   @end deffn
+@node efitextmode
+@subsection efitextmode
+
+@deffn Command efitextmode [min | max | mode_num]
+When used with no arguments displays all available text output modes. The
+set mode determines the columns and rows of the text display when in
+text mode. An asterisk, @samp{*}, will be at the end of the line of the
+currently set mode.
+
+Otherwise the command only takes a single parameter, which can be
+@samp{min}, @samp{max}, or a mode number given by the listing when run
+with no arguments. These arguments set the mode to the minimum, maximum,
+and particular mode respectively.
+
+By default GRUB will start in whatever mode the EFI firmware defaults to.
+There are firmwares known to setup the default mode such that output

The verb *set up* is spelled with a space.

+behaves strangely. Setting the mode can fix this.

Should your device be mentioned in the documentation, and one of the
strangeness be described?

I deliberately was vague here because I don't think the specifics
matter. The point I wanted to get across is that if your text mode
EFI console is behaving strangely (define it how ever you want), that a
mode switch may fix things. This is not to presume that other
strangeness can't be fixed by doing a mode switch. Perhaps I could add
after "strangely", ", for example your cursor in the grub shell never
reaches the bottom of the screen or when typing input characters from
previous command output are overwritten". I don't think my device need
be mentioned.

Yes, I like your suggestion.

[…]


Kind regards,

Paul



reply via email to

[Prev in Thread] Current Thread [Next in Thread]