[Java.Interop.Tools.JavaSource] Parse <code/> tags (#1044)

Fixes: #1041
Translates Javadoc `<code/>` tags into C# `<c/>` tags, which should
clean up thousands of illegible `&lt;code&gt;foo&lt;/code&gt;`
occurrences.

Author: pjcollins

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

@@ -35,6 +35,7 @@ internal void CreateRules (SourceJavadocToXmldocGrammar grammar)
  | FormCtrlDeclaration
  */
 |InlineHyperLinkDeclaration
+|CodeElementDeclaration
 |grammar.InlineTagsTerms.AllInlineTerms
 |UnknownHtmlElementStart
 ,
@@ -136,6 +137,12 @@ internal void CreateRules (SourceJavadocToXmldocGrammar grammar)
 varaElementValue=newXText(parseNode.ChildNodes[1].AstNode.ToString());
 parseNode.AstNode=aElementValue;
 };
+
+CodeElementDeclaration.Rule=CreateStartElement("code",grammar)+InlineDeclarations+CreateEndElement("code",grammar);
+CodeElementDeclaration.AstConfig.NodeCreator=(context,parseNode)=>{
+vartarget=parseNode.ChildNodes[1].AstNode;
+parseNode.AstNode=newXElement("c",target);
+};
 }
 
 staticIEnumerable<XElement>GetParagraphs(ParseTreeNodeListchildren)
@@ -205,6 +212,7 @@ static IEnumerable<XElement> GetParagraphs (ParseTreeNodeList children)
 publicreadonlyNonTerminalPreBlockDeclaration=newNonTerminal(nameof(PreBlockDeclaration),ConcatChildNodes);
 publicreadonlyNonTerminalInlineHyperLinkDeclaration=newNonTerminal(nameof(InlineHyperLinkDeclaration),ConcatChildNodes);
 publicreadonlyNonTerminalIgnorableElementDeclaration=newNonTerminal(nameof(IgnorableElementDeclaration),ConcatChildNodes);
+publicreadonlyNonTerminalCodeElementDeclaration=newNonTerminal(nameof(CodeElementDeclaration),ConcatChildNodes);
 
 publicreadonlyTerminalInlineHyperLinkOpenTerm=newRegexBasedTerminal("<a href=",@"(?i)<a\s*href\s*="){
 AstConfig=newAstNodeConfig{

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

@@ -67,5 +67,16 @@ public void HyperLinkDeclaration ()
 Assert.AreEqual("\"AutofillService.html#FieldClassification\">field classification",
 r.Root.AstNode.ToString());
 }
+
+[Test]
+publicvoidCodeElementDeclaration()
+{
+varp=CreateParser(g =>g.HtmlTerms.CodeElementDeclaration);
+
+varr=p.Parse("<code>input.position()</code>");
+Assert.IsFalse(r.HasErrors(),DumpMessages(r,p));
+Assert.AreEqual("<c>input.position()</c>",r.Root.AstNode.ToString());
+}
+
 }
 }

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

@@ -146,14 +146,14 @@ more description here.</para>
 newParseResult{
 Javadoc="Something {@link #method}: description, \"<code>declaration</code>\" or \"<code>another declaration</code>\".\n\n@apiSince 1\n",
 FullXml=@"<member>
- <summary>Something <c>#method</c>: description, ""&lt;code&gt;declaration&lt;/code&gt;"" or ""&lt;code&gt;another declaration&lt;/code&gt;"".</summary>
+ <summary>Something <c>#method</c>: description, ""<c>declaration</c>"" or ""<c>another declaration</c>"".</summary>
  <remarks>
- <para>Something <c>#method</c>: description, ""&lt;code&gt;declaration&lt;/code&gt;"" or ""&lt;code&gt;another declaration&lt;/code&gt;"".</para>
+ <para>Something <c>#method</c>: description, ""<c>declaration</c>"" or ""<c>another declaration</c>"".</para>
  <para>Added in API level 1.</para>
  </remarks>
 </member>",
 IntelliSenseXml=@"<member>
- <summary>Something <c>#method</c>: description, ""&lt;code&gt;declaration&lt;/code&gt;"" or ""&lt;code&gt;another declaration&lt;/code&gt;"".</summary>
+ <summary>Something <c>#method</c>: description, ""<c>declaration</c>"" or ""<c>another declaration</c>"".</summary>
 </member>",
 },
 newParseResult{