[bug #55718] Command-line interface gotchas

[INVALID.NOREPLY]

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

                 Summary: Command-line interface gotchas
                 Project: GNU GRUB
            Submitted by: jidanni
            Submitted on: Fri 15 Feb 2019 11:59:00 PM UTC
                Category: Documentation
                Severity: Major
                Priority: 5 - Normal
              Item Group: Documentation
                  Status: None
                 Privacy: Public
             Assigned to: None
         Originator Name: 
        Originator Email: 
             Open/Closed: Open
         Discussion Lock: Any
                 Release: 
                 Release: 2.02
         Reproducibility: None
         Planned Release: None

    _______________________________________________________

Details:

On (info "(grub) Command-line interface")

      Note that you cannot use the completion functionality in the TFTP
   filesystem.  This is because TFTP doesn't support file name listing for
   the security.
   ^^^ remove "the".

On (info "(grub) echo") give an -e example,
so we know if we should use
echo -e \a  #or
echo -e \\a #or
echo -e '\a'

On (info "(grub) Command-line and menu entry commands")
"exit" is not listed, but indeed "works" from the
grub>
prompt. Be sure to make a page about it...

Indeed, "c" gets a command line. And on top a message saying to use ESC
to get back out. But then subsequent "c" only get the command line, not
the message. Therefore the user might likely try "exit" at the command
line, getting stuck!

By the way the vbe* commands don't have an INFO page.
And *test commands should mention while showing their test results, how
to exit them and get back to the menu.

(info "(grub) videoinfo") should mention what to do if output is too
long for the screen.

2.02+dfsg1-11




    _______________________________________________________

Reply to this item at:

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

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