If the patch for #473230 is applied, then this patch will bring the documentation for themes in line, and also better document verbose mode and F2.
--- a/themes/default/theme.xml 2009-01-09 23:25:35.000000000 +1100 +++ b/themes/default/theme.xml 2009-01-09 23:26:00.000000000 +1100 @@ -81,8 +81,8 @@ </dimension> </background> <textbox> - <!-- whether you want the textbox always - shown or no. If no, it will be shown only on error, + <!-- whether you want the textbox enabled. + If no, the F2 key does nothing see autoverboseonerror --> <enable>yes</enable> <!-- here are tags to set the text area... x coordinate, --- a/doc/splashy-theme.xml.pod 2009-01-09 23:25:35.000000000 +1100 +++ b/doc/splashy-theme.xml.pod 2009-01-09 23:26:00.000000000 +1100 @@ -73,6 +73,8 @@ The following values are allowed in it: I<< <enable> >>, I<< <x> >>, I<< <y> >>, I<< <width> >>, I<< <height> >>, I<< <background> >>, I<< <border> >>, I<< <text> >> +If I<< <enable> >> is 'no', F2 does nothing; the textbox is disabled. + =item I<< <text> >> Describes how the text should look like @@ -230,8 +232,8 @@ <height>0</height> </background> <textbox> - <!-- whether you want the textbox always - shown or no. If no, it will be shown only on error, + <!-- whether you want the textbox enabled. + If no, the F2 key does nothing see autoverboseonerror --> <enable>yes</enable> <!-- here are tags to set the text area... x coordinate, --- a/doc/splashy.pod 2009-01-09 23:26:11.000000000 +1100 +++ b/doc/splashy.pod 2009-01-09 23:23:26.000000000 +1100 @@ -23,7 +23,15 @@ =head1 DESCRIPTION -Splashy displays an image and a progress bar at boot time. When called as splashy_chvt, it allows the same functionality as the UNIX command chvt. +Splashy displays an image and a progress bar at boot time. + +The look and feel of splashy is provided by a theme, installed by B<splashy_config>(1). + +If the theme enables a textbox, pressing F2 during the boot will toggle verbose mode, the display of boot messages that are otherwise hidden by splashy. + +Splashy may time-out and exit during long file-system checks. No update of the progress bar happens during file-system checks. + +When called as splashy_chvt, it allows the same functionality as the UNIX command chvt. =head1 OPTIONS