magento#108: Clear Shopping Cart - Refactor to fix expected jsdoc-block in shopping-cart.js and fix Grid.php PHPdoc long description

Author: John Carlo Octabio

app/code/Magento/Checkout/Block/Cart/Grid.php

@@ -165,8 +165,8 @@ public function getItems()
     }
 
     /**
-     * Verify if display pager on shopping cart
-     * If cart block has custom_items and items qty in the shopping cart<limit from stores configuration
+     * Verify if display pager on shopping cart if cart block has custom_items and items qty in the shopping cart<limit
+     * from stores configuration
      *
      * @return bool
      */

app/code/Magento/Checkout/view/frontend/web/js/shopping-cart.js

@@ -69,6 +69,9 @@ define([
             confirm({
                 content: $.mage.__('Are you sure you want to remove all items from your shopping cart?'),
                 actions: {
+                    /**
+                     * Confirmation modal handler to execute clear cart action
+                     */
                     confirm: function () {
                         self.clearCart();
                     }