Merge pull request github#5121 from alexet/fix-js-jdoc

Javascript Extractor: Update <tt> tages to <code>

Author: alexet

javascript/extractor/src/com/semmle/js/ast/DeclarationFlags.java

@@ -88,59 +88,59 @@ public static boolean hasDeclareKeyword(int flags) {
     return (flags & declareKeyword) != 0;
   }
 
-  /** Returns a mask with the computed bit set to the value of <tt>enable</tt>. */
+  /** Returns a mask with the computed bit set to the value of <code>enable</code>. */
   public static int getComputed(boolean enable) {
     return enable ? computed : 0;
   }
 
-  /** Returns a mask with the abstract bit set to the value of <tt>enable</tt>. */
+  /** Returns a mask with the abstract bit set to the value of <code>enable</code>. */
   public static int getAbstract(boolean enable) {
     return enable ? abstract_ : 0;
   }
 
-  /** Returns a mask with the static bit set to the value of <tt>enable</tt>. */
+  /** Returns a mask with the static bit set to the value of <code>enable</code>. */
   public static int getStatic(boolean enable) {
     return enable ? static_ : 0;
   }
 
-  /** Returns a mask with the public bit set to the value of <tt>enable</tt>. */
+  /** Returns a mask with the public bit set to the value of <code>enable</code>. */
   public static int getPublic(boolean enable) {
     return enable ? public_ : 0;
   }
 
-  /** Returns a mask with the readonly bit set to the value of <tt>enable</tt>. */
+  /** Returns a mask with the readonly bit set to the value of <code>enable</code>. */
   public static int getReadonly(boolean enable) {
     return enable ? readonly : 0;
   }
 
-  /** Returns a mask with the private bit set to the value of <tt>enable</tt>. */
+  /** Returns a mask with the private bit set to the value of <code>enable</code>. */
   public static int getPrivate(boolean enable) {
     return enable ? private_ : 0;
   }
 
-  /** Returns a mask with the protected bit set to the value of <tt>enable</tt>. */
+  /** Returns a mask with the protected bit set to the value of <code>enable</code>. */
   public static int getProtected(boolean enable) {
     return enable ? protected_ : 0;
   }
 
-  /** Returns a mask with the optional bit set to the value of <tt>enable</tt>. */
+  /** Returns a mask with the optional bit set to the value of <code>enable</code>. */
   public static int getOptional(boolean enable) {
     return enable ? optional : 0;
   }
 
   /**
-   * Returns a mask with the definite assignment assertion bit set to the value of <tt>enable</tt>.
+   * Returns a mask with the definite assignment assertion bit set to the value of <code>enable</code>.
    */
   public static int getDefiniteAssignmentAssertion(boolean enable) {
     return enable ? definiteAssignmentAssertion : 0;
   }
 
-  /** Returns a mask with the declare keyword bit set to the value of <tt>enable</tt>. */
+  /** Returns a mask with the declare keyword bit set to the value of <code>enable</code>. */
   public static int getDeclareKeyword(boolean enable) {
     return enable ? declareKeyword : 0;
   }
 
-  /** Returns true if the <tt>n</tt>th bit is set in <tt>flags</tt>. */
+  /** Returns true if the <code>n</code>th bit is set in <code>flags</code>. */
   public static boolean hasNthFlag(int flags, int n) {
     return (flags & (1 << n)) != 0;
   }

javascript/extractor/src/com/semmle/js/ast/Literal.java

@@ -6,7 +6,7 @@
 /**
  * A literal constant.
  *
- * <p>A <tt>null</tt> literal may occur as a TypeScript type annotation - other literals are always
+ * <p>A <code>null</code> literal may occur as a TypeScript type annotation - other literals are always
  * expressions.
  */
 public class Literal extends Expression implements ITypeExpression {

javascript/extractor/src/com/semmle/js/ast/MemberDefinition.java

@@ -40,7 +40,7 @@ public int getFlags() {
     return flags;
   }
 
-  /** Returns true if this has the <tt>static</tt> modifier. */
+  /** Returns true if this has the <code>static</code> modifier. */
   public boolean isStatic() {
     return DeclarationFlags.isStatic(flags);
   }
@@ -55,7 +55,7 @@ public boolean isAbstract() {
     return DeclarationFlags.isAbstract(flags);
   }
 
-  /** Returns true if has the <tt>public</tt> modifier (not true for implicitly public members). */
+  /** Returns true if has the <code>public</code> modifier (not true for implicitly public members). */
   public boolean hasPublicKeyword() {
     return DeclarationFlags.isPublic(flags);
   }
@@ -75,7 +75,7 @@ public boolean hasReadonlyKeyword() {
     return DeclarationFlags.isReadonly(flags);
   }
 
-  /** Returns true if this has the <tt>declare</tt> modifier. */
+  /** Returns true if this has the <code>declare</code> modifier. */
   public boolean hasDeclareKeyword() {
     return DeclarationFlags.hasDeclareKeyword(flags);
   }

javascript/extractor/src/com/semmle/js/extractor/ASTExtractor.java

@@ -253,7 +253,7 @@ public enum IdContext {
 
     /**
      * An identifier that refers to a variable from inside a type, i.e. the operand to a
-     * <tt>typeof</tt> type or left operand to an <tt>is</tt> type.
+     * <code>typeof</code> type or left operand to an <code>is</code> type.
      *
      * <p>This is generally treated as a type, except a variable binding will be emitted for it.
      */
@@ -288,7 +288,7 @@ public enum IdContext {
     VAR_AND_TYPE_AND_NAMESPACE_DECL,
 
     /**
-     * An identifier that occurs as part of a named export, such as <tt>export { A }</tt>.
+     * An identifier that occurs as part of a named export, such as <code>export { A }</code>.
      *
      * <p>This may refer to a variable, type, and/or a namespace, and will export exactly those that
      * can be resolved.
@@ -301,7 +301,7 @@ public enum IdContext {
 
     /**
      * An identifier that occurs as a qualified name in a default export expression, such as
-     * <tt>A</tt> in <tt>export default A.B</tt>.
+     * <code>A</code> in <code>export default A.B</code>.
      *
      * <p>This acts like {@link #EXPORT}, except it cannot refer to a type (i.e. it must be a
      * variable and/or a namespace).

javascript/extractor/src/com/semmle/js/extractor/AutoBuild.java

@@ -722,13 +722,13 @@ public static Path tryRelativize(Path from, Path to) {
   }
 
   /**
-   * Prepares <tt>package.json</tt> files in a virtual source root, and, if enabled,
+   * Prepares <code>package.json</code> files in a virtual source root, and, if enabled,
    * installs dependencies for use by the TypeScript type checker.
    * <p>
    * Some packages must be downloaded while others exist within the same repo ("monorepos")
    * but are not in a location where TypeScript would look for it.
    * <p>
-   * Downloaded packages are intalled under <tt>SCRATCH_DIR</tt>, in a mirrored directory hierarchy
+   * Downloaded packages are intalled under <code>SCRATCH_DIR</code>, in a mirrored directory hierarchy
    * we call the "virtual source root".
    * <p>
    * Packages that exists within the repo are not downloaded. Since they are part of the main source tree,

javascript/extractor/src/com/semmle/js/extractor/ScopeManager.java

@@ -149,7 +149,7 @@ public Scope enterScope(Node scopeNode) {
   }
 
   /**
-   * Enters a scope for a block of form <tt>declare global { ... }</tt>.
+   * Enters a scope for a block of form <code>declare global { ... }</code>.
    *
    * <p>Declarations in this block will contribute to the global scope, but references can still be
    * resolved in the scope enclosing the declaration itself. The scope itself does not have its own

javascript/extractor/src/com/semmle/js/parser/ParsedProject.java

@@ -14,7 +14,7 @@ public ParsedProject(File tsConfigFile, Set<File> ownFiles, Set<File> allFiles)
     this.allFiles = allFiles;
   }
 
-  /** Returns the <tt>tsconfig.json</tt> file that defines this project. */
+  /** Returns the <code>tsconfig.json</code> file that defines this project. */
   public File getTsConfigFile() {
     return tsConfigFile;
   }

javascript/extractor/src/com/semmle/ts/ast/ArrayTypeExpr.java

@@ -4,7 +4,7 @@
 import com.semmle.js.ast.Visitor;
 
 /**
- * An array type, such as <tt>number[]</tt>, or in general <tt>T[]</tt> where <tt>T</tt> is a type.
+ * An array type, such as <code>number[]</code>, or in general <code>T[]</code> where <code>T</code> is a type.
  */
 public class ArrayTypeExpr extends TypeExpression {
   private final ITypeExpression elementType;

javascript/extractor/src/com/semmle/ts/ast/ConditionalTypeExpr.java

@@ -3,7 +3,7 @@
 import com.semmle.js.ast.SourceLocation;
 import com.semmle.js.ast.Visitor;
 
-/** A conditional type annotation, such as <tt>T extends any[] ? A : B</tt>. */
+/** A conditional type annotation, such as <code>T extends any[] ? A : B</code>. */
 public class ConditionalTypeExpr extends TypeExpression {
   private ITypeExpression checkType;
   private ITypeExpression extendsType;

javascript/extractor/src/com/semmle/ts/ast/ExportAsNamespaceDeclaration.java

@@ -5,7 +5,7 @@
 import com.semmle.js.ast.Statement;
 import com.semmle.js.ast.Visitor;
 
-/** A statement of form <tt>export as namespace X</tt> where <tt>X</tt> is an identifier. */
+/** A statement of form <code>export as namespace X</code> where <code>X</code> is an identifier. */
 public class ExportAsNamespaceDeclaration extends Statement {
   private Identifier id;