vbatts/grub
1
0
Fork 0
Code Issues Pull requests Releases Wiki Activity

* docs/grub.texi: Graphical options information update.

Browse source 
Removed outdated. Updated current. Inserted missed.
This commit is contained in:
Vladimir Testov 2013-10-17 15:07:09 +04:00
parent 6176a0cdfa
commit ad543f123b
2 changed files with 104 additions and 44 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

5
ChangeLog
View file

@ -1,3 +1,8 @@
2013-10-17 Vladimir Testov <vladimir.testov@rosalab.ru>
* docs/grub.texi: Graphical options information update.
Removed outdated. Updated current. Inserted missed.
2013-10-17 Vladimir Serbinenko <phcoder@gmail.com> 2013-10-17 Vladimir Serbinenko <phcoder@gmail.com>
* docs/grub.texi: Mention few new platform-specific commands. * docs/grub.texi: Mention few new platform-specific commands.

143
docs/grub.texi
View file

@ -1974,12 +1974,18 @@ In this example, name3 is assigned a color value.
@subsection Global Property List @subsection Global Property List
@multitable @columnfractions 0.3 0.6 @multitable @columnfractions 0.3 0.6
@item title-text @tab Specifies the text to display at the top center of the screen as a title. @item title-text
@item title-font @tab Defines the font used for the title message at the top of the screen. @tab Specifies the text to display at the top center of the screen as a title.
@item title-color @tab Defines the color of the title message. @item title-font
@item message-font @tab Defines the font used for messages, such as when GRUB is unable to automatically boot an entry. @tab Defines the font used for the title message at the top of the screen.
@item message-color @tab Defines the color of the message text. @item title-color
@item message-bg-color @tab Defines the background color of the message text area. @tab Defines the color of the title message.
@item message-font
@tab Currently unused. Left for backward compatibility.
@item message-color
@tab Currently unused. Left for backward compatibility.
@item message-bg-color
@tab Currently unused. Left for backward compatibility.
@item desktop-image @item desktop-image
@tab Specifies the image to use as the background. It will be scaled @tab Specifies the image to use as the background. It will be scaled
to fit the screen size or proportionally scaled depending on the scale to fit the screen size or proportionally scaled depending on the scale
@ -2002,13 +2008,26 @@ In this example, name3 is assigned a color value.
@tab Specifies the vertical alignment of the *desktop-image* if @tab Specifies the vertical alignment of the *desktop-image* if
*desktop-image-scale-method* isn't equeal to ``stretch``. Options are *desktop-image-scale-method* isn't equeal to ``stretch``. Options are
``top``, ``center``, ``bottom``. Default is ``center``. ``top``, ``center``, ``bottom``. Default is ``center``.
@item desktop-color @tab Specifies the color for the background if *desktop-image* is not specified. @item desktop-color
@item terminal-box @tab Specifies the file name pattern for the styled box slices used for the command line terminal window. For example, ``terminal-box: terminal_*.png'' will use the images ``terminal_c.png`` as the center area, ``terminal_n.png`` as the north (top) edge, ``terminal_nw.png`` as the northwest (upper left) corner, and so on. If the image for any slice is not found, it will simply be left empty. @tab Specifies the color for the background if *desktop-image* is not
@item terminal-border @tab Specifies the border width of the terminal window. specified.
@item terminal-left @tab Specifies the left coordinate of the terminal window. @item terminal-box
@item terminal-top @tab Specifies the top coordinate of the terminal window. @tab Specifies the file name pattern for the styled box slices used for the
@item terminal-width @tab Specifies the width of the terminal window. command line terminal window. For example, ``terminal-box: terminal_*.png``
@item terminal-height @tab Specifies the height of the terminal window. will use the images ``terminal_c.png`` as the center area, ``terminal_n.png``
as the north (top) edge, ``terminal_nw.png`` as the northwest (upper left)
corner, and so on. If the image for any slice is not found, it will simply
be left empty.
@item terminal-border
@tab Specifies the border width of the terminal window.
@item terminal-left
@tab Specifies the left coordinate of the terminal window.
@item terminal-top
@tab Specifies the top coordinate of the terminal window.
@item terminal-width
@tab Specifies the width of the terminal window.
@item terminal-height
@tab Specifies the height of the terminal window.
@end multitable @end multitable
@ -2042,21 +2061,34 @@ The following is a list of the components and the properties they support.
Properties: Properties:
@multitable @columnfractions 0.2 0.7 @multitable @columnfractions 0.2 0.7
@item text @tab The text to display. @item id
@item font @tab The font to use for text display. @tab Set to ``__timeout__`` to display the time elapsed to an automatical
@item color @tab The color of the text. boot of the default entry.
@item align @tab The horizontal alignment of the text within the component. Options are ``left``, ``center``, and ``right``. @item text
@tab The text to display. If ``id`` is set to ``__timeout__`` and no
``text`` property is set then the amount of seconds will be shown.
If set to ``@@KEYMAP_SHORT@@``, ``@@KEYMAP_MIDDLE@@`` or
``@@KEYMAP_LONG@@`` then predefined hotkey information will be shown.
@item font
@tab The font to use for text display.
@item color
@tab The color of the text.
@item align
@tab The horizontal alignment of the text within the component.
Options are ``left``, ``center`` and ``right``.
@item visible
@tab Set to ``false`` to hide the label.
@end multitable @end multitable
@item image @item image
A component that displays an image. The image is scaled to fit the A component that displays an image. The image is scaled to fit
component, although the preferred size defaults to the image's original the component.
size unless the ``preferred_size`` property is explicitly set.
Properties: Properties:
@multitable @columnfractions 0.2 0.7 @multitable @columnfractions 0.2 0.7
@item file @tab The full path to the image file to load. @item file
@tab The full path to the image file to load.
@end multitable @end multitable
@item progress_bar @item progress_bar
@ -2066,17 +2098,37 @@ The following is a list of the components and the properties they support.
Properties: Properties:
@multitable @columnfractions 0.2 0.7 @multitable @columnfractions 0.2 0.7
@item fg_color @tab The foreground color for plain solid color rendering. @item id
@item bg_color @tab The background color for plain solid color rendering. @tab Set to ``__timeout__`` to display the time elapsed to an automatical
@item border_color @tab The border color for plain solid color rendering. boot of the default entry.
@item text_color @tab The text color. @item fg_color
@item show_text @tab Boolean value indicating whether or not text should be displayed on the progress bar. If set to *false*, then no text will be displayed on the bar. If set to any other value, text will be displayed on the bar. @tab The foreground color for plain solid color rendering.
@item bar_style @tab The styled box specification for the frame of the progress bar. Example: ``progress_frame_*.png`` @item bg_color
@item highlight_style @tab The styled box specification for the highlighted region of the progress bar. This box will be used to paint just the highlighted region of the bar, and will be increased in size as the bar nears completion. Example: ``progress_hl_*.png``. @tab The background color for plain solid color rendering.
@item text @tab The text to display on the progress bar. If the progress bar's ID is set to ``__timeout__``, then GRUB will updated this property with an informative message as the timeout approaches. @item border_color
@item value @tab The progress bar current value. Normally not set manually. @tab The border color for plain solid color rendering.
@item start @tab The progress bar start value. Normally not set manually. @item text_color
@item end @tab The progress bar end value. Normally not set manually. @tab The text color.
@item bar_style
@tab The styled box specification for the frame of the progress bar.
Example: ``progress_frame_*.png``
If the value is equal to ``highlight_style`` then no styled boxes
will be shown.
@item highlight_style
@tab The styled box specification for the highlighted region of the
progress bar. This box will be used to paint just the highlighted region
of the bar, and will be increased in size as the bar nears completion.
Example: ``progress_hl_*.png``.
If the value is equal to ``bar_style`` then no styled boxes
will be shown.
@item font
@tab The font to use for progress bar.
@item text
@tab The text to display on the progress bar. If the progress bar's ID
is set to ``__timeout__`` and the value of this property is set to
``@@TIMEOUT_NOTIFICATION_SHORT@@``, ``@@TIMEOUT_NOTIFICATION_MIDDLE@@``
or ``@@TIMEOUT_NOTIFICATION_LONG@@``, then GRUB will update this
property with an informative message as the timeout approaches.
@end multitable @end multitable
@item circular_progress @item circular_progress
@ -2090,6 +2142,9 @@ The following is a list of the components and the properties they support.
Properties: Properties:
@multitable @columnfractions 0.3 0.6 @multitable @columnfractions 0.3 0.6
@item id
@tab Set to ``__timeout__`` to display the time elapsed to an automatical
boot of the default entry.
@item center_bitmap @item center_bitmap
@tab The file name of the image to draw in the center of the component. @tab The file name of the image to draw in the center of the component.
@item tick_bitmap @item tick_bitmap
@ -2099,14 +2154,13 @@ The following is a list of the components and the properties they support.
@item ticks_disappear @item ticks_disappear
@tab Boolean value indicating whether tick marks should progressively appear, @tab Boolean value indicating whether tick marks should progressively appear,
or progressively disappear as *value* approaches *end*. Specify or progressively disappear as *value* approaches *end*. Specify
``true`` or ``false``. ``true`` or ``false``. Default is ``false``.
@item value @item start_angle
@tab The progress indicator current value. Normally not set manually. @tab The position of the first tick mark to appear or disappear.
@item start Measured in "parrots", 1 "parrot" = 1 / 256 of the full circle.
@tab The progress indicator start value. Normally not set manually. Use values ``xxx deg`` or ``xxx \xc2\xb0`` to set the angle in degrees.
@item end
@tab The progress indicator end value. Normally not set manually.
@end multitable @end multitable
@item boot_menu @item boot_menu
Displays the GRUB boot menu. It allows selecting items and executing them. Displays the GRUB boot menu. It allows selecting items and executing them.
@ -2185,10 +2239,8 @@ The following is a list of the components and the properties they support.
@tab The top scrollbar padding in pixels. @tab The top scrollbar padding in pixels.
@item scrollbar_bottom_pad @item scrollbar_bottom_pad
@tab The bottom scrollbar padding in pixels. @tab The bottom scrollbar padding in pixels.
@item max_items_shown @item visible
@tab The maximum number of items to show on the menu. If there are more than @tab Set to ``false`` to hide the boot menu.
*max_items_shown* items in the menu, the list will scroll to make all
items accessible.
@end multitable @end multitable
@item canvas @item canvas
@ -2232,7 +2284,10 @@ The following properties are supported by all components:
recognizes: recognizes:
@multitable @columnfractions 0.2 0.7 @multitable @columnfractions 0.2 0.7
@item ``__timeout__`` @tab Any component with this ID will have its *text*, *start*, *end*, *value*, and *visible* properties set by GRUB when it is counting down to an automatic boot of the default menu entry. @item ``__timeout__``
@tab Component with this ID will be updated by GRUB and will indicate
time elapsed to an automatical boot of the default entry.
Affected components: ``label``, ``circular_progress``, ``progress_bar``.
@end multitable @end multitable
@end table @end table