[Java.Interop.Tools.JavaSource] Parse {@param} tags

Fixes: #1042

Translates `{@param foo}` into `<paramref>foo</paramref>`, which should
fix ~70 instances of broken summary/remarks/param elements.

Author: pjcollins

src/Java.Interop.Tools.JavaSource/Java.Interop.Tools.JavaSource/SourceJavadocToXmldocGrammar.InlineTagsBnfTerms.cs

@@ -28,6 +28,7 @@ internal void CreateRules (SourceJavadocToXmldocGrammar grammar)
 					| LiteralDeclaration
 					| SeeDeclaration
 					| ValueDeclaration
+					| InlineParamDeclaration
 					;
 
 				CodeDeclaration.Rule = grammar.ToTerm ("{@code") + InlineValue + "}";
@@ -97,6 +98,12 @@ internal void CreateRules (SourceJavadocToXmldocGrammar grammar)
 						parseNode.AstNode = new XText ("To be added");
 					}
 				};
+
+				InlineParamDeclaration.Rule = grammar.ToTerm ("{@param") + InlineValue + "}";
+				InlineParamDeclaration.AstConfig.NodeCreator = (context, parseNode) => {
+					var target = parseNode.ChildNodes [1].AstNode;
+					parseNode.AstNode = new XElement ("paramref", target);
+				};
 			}
 
 			public  readonly    NonTerminal AllInlineTerms              = new NonTerminal (nameof (AllInlineTerms), ConcatChildNodes);
@@ -129,6 +136,8 @@ internal void CreateRules (SourceJavadocToXmldocGrammar grammar)
 
 			// https://docs.oracle.com/javase/7/docs/technotes/tools/windows/javadoc.html#value
 			public  readonly    NonTerminal ValueDeclaration            = new NonTerminal (nameof (ValueDeclaration));
+
+			public  readonly    NonTerminal InlineParamDeclaration      = new NonTerminal (nameof (InlineParamDeclaration));
 		}
 	}
 }

tests/Java.Interop.Tools.JavaSource-Tests/SourceJavadocToXmldocGrammar.InlineTagsBnfTermsTests.cs

@@ -98,5 +98,15 @@ public void ValueDeclaration ()
 			Assert.IsFalse (r.HasErrors (), DumpMessages (r, p));
 			Assert.AreEqual ("<c>#field</c>", r.Root.AstNode.ToString ());
 		}
+
+		[Test]
+		public void InlineParamDeclaration ()
+		{
+			var p = CreateParser (g => g.InlineTagsTerms.InlineParamDeclaration);
+
+			var r = p.Parse ("{@param phoneNumberString}");
+			Assert.IsFalse (r.HasErrors (), DumpMessages (r, p));
+			Assert.AreEqual ("<paramref>phoneNumberString</paramref>", r.Root.AstNode.ToString ());
+		}
 	}
 }

tests/Java.Interop.Tools.JavaSource-Tests/SourceJavadocToXmldocParserTests.cs

@@ -188,12 +188,12 @@ more description here.
 How about another link <a href=""http://man7.org/linux/man-pages/man2/accept.2.html"">accept(2)</a>
 @param manifest The value of the <a
 href=""{@docRoot}guide/topics/manifest/manifest-element.html#vcode"">{@code
-android:versionCode}</a> manifest attribute.
+android:versionCode}</a> manifest attribute.  See {@param empty}.
 @param empty
 @return the return value
 ",
 				FullXml = $@"<member>
-  <param name=""manifest"">The value of the <see href=""{DocRootPrefixExpected}guide/topics/manifest/manifest-element.html#vcode""><c>android:versionCode</c></see> manifest attribute.</param>
+  <param name=""manifest"">The value of the <see href=""{DocRootPrefixExpected}guide/topics/manifest/manifest-element.html#vcode""><c>android:versionCode</c></see> manifest attribute.  See <paramref>empty</paramref>.</param>
   <param name=""empty"">empty</param>
   <summary>See <see href=""http://man7.org/linux/man-pages/man2/accept.2.html"">accept(2)</see>.</summary>
   <remarks>
@@ -204,7 +204,7 @@ more description here.
   <returns>the return value</returns>
 </member>",
 				IntelliSenseXml = $@"<member>
-  <param name=""manifest"">The value of the <see href=""{DocRootPrefixExpected}guide/topics/manifest/manifest-element.html#vcode""><c>android:versionCode</c></see> manifest attribute.</param>
+  <param name=""manifest"">The value of the <see href=""{DocRootPrefixExpected}guide/topics/manifest/manifest-element.html#vcode""><c>android:versionCode</c></see> manifest attribute.  See <paramref>empty</paramref>.</param>
   <param name=""empty"">empty</param>
   <summary>See <see href=""http://man7.org/linux/man-pages/man2/accept.2.html"">accept(2)</see>.</summary>
   <returns>the return value</returns>