Added 'REST OBMC Reboot (off)'/'REST OBMC Reboot (run)'

Also remove lines of '#####' comments.

Change-Id: Ia2add1c38304c5b09253bb53d3bd5fa7fe7f1d21
Signed-off-by: Michael Walsh <micwalsh@us.ibm.com>
diff --git a/lib/boot_utils.robot b/lib/boot_utils.robot
index a7ed612..e5f1fd1 100644
--- a/lib/boot_utils.robot
+++ b/lib/boot_utils.robot
@@ -5,7 +5,6 @@
 Resource  ../extended/obmc_boot_test_resource.robot
 
 *** Keywords ***
-###############################################################################
 REST Power On
     [Documentation]  Do "REST Power On" boot test.
     [Arguments]  ${stack_mode}=${stack_mode}  ${quiet}=${quiet}
@@ -31,10 +30,7 @@
     ...  \ loc_stack_mode=${stack_mode} \ loc_quiet=${quiet}
     Run Key U  ${cmd_buf}
 
-###############################################################################
 
-
-###############################################################################
 IPMI Power On
     [Documentation]  Do "IPMI Power On" boot test.
     [Arguments]  ${stack_mode}=${stack_mode}  ${quiet}=${quiet}
@@ -60,10 +56,7 @@
     ...  \ loc_stack_mode=${stack_mode} \ loc_quiet=${quiet}
     Run Key U  ${cmd_buf}
 
-###############################################################################
 
-
-###############################################################################
 REST Power Off
     [Documentation]  Do "REST Power Off" boot test.
     [Arguments]  ${stack_mode}=${stack_mode}  ${quiet}=${quiet}
@@ -89,10 +82,7 @@
     ...  \ loc_stack_mode=${stack_mode} \ loc_quiet=${quiet}
     Run Key U  ${cmd_buf}
 
-###############################################################################
 
-
-###############################################################################
 REST Hard Power Off
     [Documentation]  Do "REST Hard Power Off" boot test.
     [Arguments]  ${stack_mode}=${stack_mode}  ${quiet}=${quiet}
@@ -118,10 +108,7 @@
     ...  \ loc_stack_mode=${stack_mode} \ loc_quiet=${quiet}
     Run Key U  ${cmd_buf}
 
-###############################################################################
 
-
-###############################################################################
 IPMI Power Off
     [Documentation]  Do "IPMI Power Off" boot test.
     [Arguments]  ${stack_mode}=${stack_mode}  ${quiet}=${quiet}
@@ -147,10 +134,7 @@
     ...  \ loc_stack_mode=${stack_mode} \ loc_quiet=${quiet}
     Run Key U  ${cmd_buf}
 
-###############################################################################
 
-
-###############################################################################
 IPMI Power Soft
     [Documentation]  Do "IPMI Power Soft" boot test.
     [Arguments]  ${stack_mode}=${stack_mode}  ${quiet}=${quiet}
@@ -176,10 +160,7 @@
     ...  \ loc_stack_mode=${stack_mode} \ loc_quiet=${quiet}
     Run Key U  ${cmd_buf}
 
-###############################################################################
 
-
-###############################################################################
 Host Power Off
     [Documentation]  Do "Host Power Off" boot test.
     [Arguments]  ${stack_mode}=${stack_mode}  ${quiet}=${quiet}
@@ -205,10 +186,7 @@
     ...  \ loc_stack_mode=${stack_mode} \ loc_quiet=${quiet}
     Run Key U  ${cmd_buf}
 
-###############################################################################
 
-
-###############################################################################
 APOR
     [Documentation]  Do "APOR" boot test.
     [Arguments]  ${stack_mode}=${stack_mode}  ${quiet}=${quiet}
@@ -234,10 +212,7 @@
     ...  \ loc_stack_mode=${stack_mode} \ loc_quiet=${quiet}
     Run Key U  ${cmd_buf}
 
-###############################################################################
 
-
-###############################################################################
 OBMC Reboot (run)
     [Documentation]  Do "OBMC Reboot (run)" boot test.
     [Arguments]  ${stack_mode}=${stack_mode}  ${quiet}=${quiet}
@@ -263,10 +238,34 @@
     ...  \ loc_stack_mode=${stack_mode} \ loc_quiet=${quiet}
     Run Key U  ${cmd_buf}
 
-###############################################################################
+
+REST OBMC Reboot (run)
+    [Documentation]  Do "REST OBMC Reboot (run)" boot test.
+    [Arguments]  ${stack_mode}=${stack_mode}  ${quiet}=${quiet}
+
+    # Description of argument(s):
+    # stack_mode                    If stack_mode is set to "skip", each test
+    #                               specified in the boot_stack is only
+    #                               performed if the machine is not already in
+    #                               the state that would normally result from
+    #                               running the given boot test.  Otherwise,
+    #                               the test is skipped.  If stack_mode is set
+    #                               to "normal", all tests from the boot_stack
+    #                               are performed.  "skip" mode is useful when
+    #                               you simply want the machine in a desired
+    #                               state.  The default value is the global
+    #                               value of "${stack_mode}"
+    # quiet                         If this parameter is set to ${1}, this
+    #                               keyword will print only essential
+    #                               information.  The default value is the
+    #                               global value of "${quiet}"
+
+    ${cmd_buf}  Catenate  OBMC Boot Test
+    ...  \ loc_boot_stack=REST OBMC Reboot (run)
+    ...  \ loc_stack_mode=${stack_mode} \ loc_quiet=${quiet}
+    Run Key U  ${cmd_buf}
 
 
-###############################################################################
 OBMC Reboot (off)
     [Documentation]  Do "OBMC Reboot (off)" boot test.
     [Arguments]  ${stack_mode}=${stack_mode}  ${quiet}=${quiet}
@@ -292,10 +291,34 @@
     ...  \ loc_stack_mode=${stack_mode} \ loc_quiet=${quiet}
     Run Key U  ${cmd_buf}
 
-###############################################################################
+
+REST OBMC Reboot (off)
+    [Documentation]  Do "REST OBMC Reboot (off)" boot test.
+    [Arguments]  ${stack_mode}=${stack_mode}  ${quiet}=${quiet}
+
+    # Description of argument(s):
+    # stack_mode                    If stack_mode is set to "skip", each test
+    #                               specified in the boot_stack is only
+    #                               performed if the machine is not already in
+    #                               the state that would normally result from
+    #                               running the given boot test.  Otherwise,
+    #                               the test is skipped.  If stack_mode is set
+    #                               to "normal", all tests from the boot_stack
+    #                               are performed.  "skip" mode is useful when
+    #                               you simply want the machine in a desired
+    #                               state.  The default value is the global
+    #                               value of "${stack_mode}"
+    # quiet                         If this parameter is set to ${1}, this
+    #                               keyword will print only essential
+    #                               information.  The default value is the
+    #                               global value of "${quiet}"
+
+    ${cmd_buf}  Catenate  OBMC Boot Test
+    ...  \ loc_boot_stack=REST OBMC Reboot (off)
+    ...  \ loc_stack_mode=${stack_mode} \ loc_quiet=${quiet}
+    Run Key U  ${cmd_buf}
 
 
-###############################################################################
 PDU AC Cycle (run)
     [Documentation]  Do "PDU AC Cycle (run)" boot test.
     [Arguments]  ${stack_mode}=${stack_mode}  ${quiet}=${quiet}
@@ -321,10 +344,7 @@
     ...  \ loc_stack_mode=${stack_mode} \ loc_quiet=${quiet}
     Run Key U  ${cmd_buf}
 
-###############################################################################
 
-
-###############################################################################
 PDU AC Cycle (off)
     [Documentation]  Do "PDU AC Cycle (off)" boot test.
     [Arguments]  ${stack_mode}=${stack_mode}  ${quiet}=${quiet}
@@ -350,10 +370,7 @@
     ...  \ loc_stack_mode=${stack_mode} \ loc_quiet=${quiet}
     Run Key U  ${cmd_buf}
 
-###############################################################################
 
-
-###############################################################################
 IPMI MC Reset Warm (run)
     [Documentation]  Do "IPMI MC Reset Warm (run)" boot test.
     [Arguments]  ${stack_mode}=${stack_mode}  ${quiet}=${quiet}
@@ -380,10 +397,7 @@
     ...  \ loc_stack_mode=${stack_mode} \ loc_quiet=${quiet}
     Run Key U  ${cmd_buf}
 
-###############################################################################
 
-
-###############################################################################
 IPMI MC Reset Warm (off)
     [Documentation]  Do "IPMI MC Reset Warm (off)" boot test.
     [Arguments]  ${stack_mode}=${stack_mode}  ${quiet}=${quiet}
@@ -410,10 +424,7 @@
     ...  \ loc_stack_mode=${stack_mode} \ loc_quiet=${quiet}
     Run Key U  ${cmd_buf}
 
-###############################################################################
 
-
-###############################################################################
 IPMI Power Cycle
     [Documentation]  Do "IPMI Power Cycle" boot test.
     [Arguments]  ${stack_mode}=${stack_mode}  ${quiet}=${quiet}
@@ -439,10 +450,7 @@
     ...  \ loc_stack_mode=${stack_mode} \ loc_quiet=${quiet}
     Run Key U  ${cmd_buf}
 
-###############################################################################
 
-
-###############################################################################
 IPMI Power Reset
     [Documentation]  Do "IPMI Power Reset" boot test.
     [Arguments]  ${stack_mode}=${stack_mode}  ${quiet}=${quiet}
@@ -468,10 +476,7 @@
     ...  \ loc_stack_mode=${stack_mode} \ loc_quiet=${quiet}
     Run Key U  ${cmd_buf}
 
-###############################################################################
 
-
-###############################################################################
 Auto Reboot
     [Documentation]  Do "Auto Reboot" boot test.
     [Arguments]  ${stack_mode}=${stack_mode}  ${quiet}=${quiet}
@@ -497,10 +502,7 @@
     ...  \ loc_stack_mode=${stack_mode} \ loc_quiet=${quiet}
     Run Key U  ${cmd_buf}
 
-###############################################################################
 
-
-###############################################################################
 Host Reboot
     [Documentation]  Do "Host Reboot" boot test.
     [Arguments]  ${stack_mode}=${stack_mode}  ${quiet}=${quiet}
@@ -526,11 +528,7 @@
     ...  \ loc_stack_mode=${stack_mode} \ loc_quiet=${quiet}
     Run Key U  ${cmd_buf}
 
-###############################################################################
 
-
-# Additional boot test keywords.
-###############################################################################
 Smart Power Off
     [Documentation]  Do a smart power off.
     [Arguments]  ${quiet}=${QUIET}
@@ -561,4 +559,3 @@
     ...  \ \ quiet=${loc_quiet}
     Run Key U  ${cmd_buf}  quiet=${loc_quiet}
 
-###############################################################################