chore(website): Fix parsing of summaries in function list

Still not a great solution.  See "locator" in #/api?view=ElementFinder

fixes #2486

Author: sjelin

website/js/api-controller.js

@@ -153,8 +153,30 @@
 
       // Add short description.
       if (item.description) {
-        item.shortDescription =
-            item.description.substring(0., item.description.indexOf('.') + 1);
+        // Find the correct portion of the description
+        
+        // The following parsing is OK most of the time
+        var sentenceEnd = item.description.indexOf('.') + 1 || Infinity;
+        var paragraphEnd = item.description.indexOf('</p>') + 4;
+        if (paragraphEnd == 3) {
+          paragraphEnd = Infinity
+        }
+        var shortDescription = item.description.substring(0, Math.min(
+            item.description.length, sentenceEnd, paragraphEnd)).trim();
+
+        // Remove <p> tags
+        if (shortDescription.substr(0,3) == '<p>') {
+          shortDescription = shortDescription.substr(3);
+          if (shortDescription.substr(-4) == '</p>') {
+            shortDescription = shortDescription.substr(0, shortDescription.length - 4);
+          }
+        }
+        item.shortDescription = shortDescription;
+
+        if(shortDescription.substr(0, 3) == 'See') {
+          console.log(item.description + ' -> ' + shortDescription);
+          console.log([sentenceEnd, paragraphEnd, item.description.length]);
+        }
       }
     });
 

website/js/directives.js

@@ -56,6 +56,11 @@
       scope: {
         list: '=ptorFunctionList'
       },
+      controller: function($scope, $sce) {
+        $scope.trust = function(html) {
+          return $sce.trustAsHtml(html);
+        };
+      },
       templateUrl: 'partials/ptor-function-list.html'
     };
   });

website/partials/ptor-function-list.html

@@ -14,7 +14,7 @@
             ng-bind="item.displayName">
         </a>
       </td>
-      <td ng-bind="item.shortDescription"></td>
+      <td ng-bind-html="trust(item.shortDescription)"></td>
     </tr>
     </tbody>
   </table>