Re: [RFC][PATCH] documentation update

[Vladimir Testov <vladimir.testov@rosalab.ru>]

[-- Attachment #1: Type: text/plain, Size: 487 bytes --]

Dear Paul,

Thanks for your reply!

> you can use the [RFC] tag (*r*equest *f*or *c*omments) to mark draf
> patches.
Thanks for the useful information. :)
 
> Also inline patches (not sure how to do this with Bazaar) would it make
> easier for me to comment them.
Mmm... I don't know what exactly inline patch is.

I have corrected errors. Please, take a look at the new version. :)

-- 
With best regards,
_______________________________
Vladimir Testov, ROSA Laboratory.
www.rosalab.ru

[-- Attachment #2: grub-documentation.patch --]
[-- Type: text/x-patch, Size: 8304 bytes --]

diff -Naur grub-2.01/docs/grub.texi grub-new/docs/grub.texi
--- grub-2.01/docs/grub.texi	2013-03-28 23:28:47.000000000 +0400
+++ grub-new/docs/grub.texi	2013-04-23 17:52:20.895409004 +0400
@@ -1934,24 +1934,48 @@
 @itemize
 @item label
    A label displays a line of text.
-   
+
    Properties:
+
    @multitable @columnfractions 0.2 0.7
-   @item text @tab The text to display.
-   @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 id
+      @tab Set the value of this property to ``__timeout__`` to display
+      the elapsed time to booting the default entry.
+   @item text
+      @tab The text to display. If ``id`` is set to ``__timeout__`` and no
+      ``text`` property is set the amount of seconds will be shown. If the
+      value of this property is set to ``@@KEYMAP_SHORT@@``,
+      ``@@KEYMAP_MIDDLE@@`` or ``@@KEYMAP_LONG@@`` then predefined hotkey
+      information will be shown.
+      Example: ``text`` = ``@@KEYMAP_SHORT@@`` - we will see ``enter: boot, e: options, c: cmd-line``
+   @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 theme_dir
+      @tab The full path to the directory where theme elements for this
+      component are placed.
+      This property should be set if theme elements for this component
+      are not placed in the default directory.
    @end multitable
 
 @item image
    A component that displays an image.  The image is scaled to fit the
-   component, although the preferred size defaults to the image's original
-   size unless the ``preferred_size`` property is explicitly set.
+   component.
 
    Properties:
 
    @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.
+   @item theme_dir
+      @tab The full path to the directory where theme elements for this
+      component are placed.
+      This property should be set if theme elements for this component
+      are not placed in the default directory.
    @end multitable
 
 @item progress_bar
@@ -1961,17 +1985,41 @@
    Properties:
 
    @multitable @columnfractions 0.2 0.7
-   @item fg_color @tab The foreground color for plain solid color rendering.
-   @item bg_color @tab The background color for plain solid color rendering.
-   @item border_color @tab The border color for plain solid color rendering.
-   @item text_color @tab The text 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.
-   @item bar_style @tab The styled box specification for the frame of the progress bar. Example: ``progress_frame_*.png``
-   @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``.
-   @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 value @tab The progress bar current value.  Normally not set manually.
-   @item start @tab The progress bar start value.  Normally not set manually.
-   @item end @tab The progress bar end value.  Normally not set manually.
+   @item id
+      @tab Set the value of this property to ``__timeout__`` to display
+      the elapsed time to booting the default entry.
+   @item fg_color
+      @tab The foreground color for plain solid color rendering.
+   @item bg_color
+      @tab The background color for plain solid color rendering.
+   @item border_color
+      @tab The border color for plain solid color rendering.
+   @item text_color
+      @tab The text color.
+   @item font
+      @tab The font to use for the progress bar.
+   @item bar_style
+      @tab The styled box specification for the frame of the progress bar.
+      Example: ``progress_frame_*.png``
+   @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 of the ``bar_style`` property is equal to 
+      the value of the ``highlight_style`` property
+      then no styled boxes will be drawn.
+   @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.
+   @item theme_dir
+      @tab The full path to the directory where theme elements for this
+      component are placed.
+      This property should be set if theme elements for this component
+      are not placed in the default directory.
    @end multitable
 
 @item circular_progress
@@ -1985,6 +2033,9 @@
    Properties:
 
    @multitable @columnfractions 0.3 0.6
+   @item id
+      @tab Set the value of this property to ``__timeout__`` to display
+      the elapsed time to booting the default entry.
    @item center_bitmap
       @tab The file name of the image to draw in the center of the component.
    @item tick_bitmap
@@ -1994,14 +2045,17 @@
    @item ticks_disappear
       @tab Boolean value indicating whether tick marks should progressively appear,
       or progressively disappear as *value* approaches *end*.  Specify
-      ``true`` or ``false``.
-   @item value
-      @tab The progress indicator current value.  Normally not set manually.
-   @item start
-      @tab The progress indicator start value.  Normally not set manually.
-   @item end
-      @tab The progress indicator end value.  Normally not set manually.
+      ``true`` or ``false``. Default value is ``false``.
+   @item start_angle
+      @tab The position of the first tick mark to appear or disappear. Measured in
+      ``parrots``, where 1 ``parrot`` equals to 1 / 256 of the full circle.
+   @item theme_dir
+      @tab The full path to the directory where theme elements for this
+      component are placed.
+      This property should be set if theme elements for this component
+      are not placed in the default directory.
    @end multitable
+
 @item boot_menu
    Displays the GRUB boot menu.  It allows selecting items and executing them.
 
@@ -2047,10 +2101,14 @@
       @tab The image file pattern for the scroll bar thumb (the part of the scroll
       bar that moves as scrolling occurs).
       Example:  ``scrollbar_thumb_*.png``
-   @item max_items_shown
-      @tab The maximum number of items to show on the menu.  If there are more than
-      *max_items_shown* items in the menu, the list will scroll to make all
-      items accessible.
+   @item visible
+      @tab Show or hide boot menu. Specify ``true`` or ``false``.
+      Default value is ``true``.
+   @item theme_dir
+      @tab The full path to the directory where theme elements for this
+      component are placed.
+      This property should be set if theme elements for this component
+      are not placed in the default directory.
    @end multitable
 
 @item canvas
@@ -2062,7 +2120,7 @@
    The *hbox* container lays out its children from left to right, giving each
    one its preferred width.  The height of each child is set to the maximum of
    the preferred heights of all children.
-   
+
 @item vbox
    The *vbox* container lays out its children from top to bottom, giving each
    one its preferred height.  The width of each child is set to the maximum of