fix for period inside parens (#36)

jjergus · web-flow · commit 16362a9386ae · 2019-10-25T13:22:10.000-07:00
diff --git a/docs/class.Facebook.HHAPIDoc.DocBlock.DocBlock.html b/docs/class.Facebook.HHAPIDoc.DocBlock.DocBlock.html
@@ -43,8 +43,7 @@
 </head>
 <body>
 <h1>Facebook\HHAPIDoc\DocBlock\DocBlock</h1>
-<p>Class to represent and parse a docblock (a</p>
-<p>k.a. doc comment).</p>
+<p>Class to represent and parse a docblock (a.k.a. doc comment)</p>
 <p>These comments always are delimeted by <code>/**</code> and <code>*\/</code>.</p>
 <p>DocBlocks are treated as GitHub Flavored Markdown, and standard
 JavaDoc style tags are supported, such as <code>@param</code>, <code>@see</code>, and
diff --git a/src/DocBlock/DocBlock.hack b/src/DocBlock/DocBlock.hack
@@ -65,7 +65,21 @@ final class DocBlock {
 
     $content = Str\trim_left(Str\join($content_lines, "\n"));
 
-    $first_period = Str\search($content, '.');
+    // Find first period that is not nested e.g. inside a link's URL.
+    $first_period = null;
+    $nesting_level = 0;
+    for ($i = 0; $i < Str\length($content); ++$i) {
+      if ($content[$i] === '.' && $nesting_level === 0) {
+        $first_period = $i;
+        break;
+      } else if ($content[$i] === '(' || $content[$i] === '[') {
+        ++$nesting_level;
+      } else if ($content[$i] === ')' || $content[$i] === ']') {
+        // Trim at 0 in case the docblock is not correctly parenthesized.
+        $nesting_level = Math\maxva($nesting_level - 1, 0);
+      }
+    }
+
     if ($first_period !== null) {
       // Handle '...'
       $slice = Str\slice($content, $first_period);
