Merge pull request #11294 from erik-krogh/fileDoc

QL: improve the "this block-comment should have been a QLDoc"-query

java/ql/lib/semmle/code/java/frameworks/Properties.qll

@@ -1,4 +1,5 @@
-/* Definitions related to `java.util.Properties`. */
+/** Definitions related to `java.util.Properties`. */
+
 import semmle.code.java.Type
 private import semmle.code.java.dataflow.FlowSteps
 

java/ql/lib/semmle/code/java/frameworks/Rmi.qll

@@ -1,4 +1,5 @@
-/* Remote Method Invocation. */
+/** Remote Method Invocation. */
+
 import java
 
 /** The interface `java.rmi.Remote`. */

java/ql/lib/semmle/code/java/frameworks/apache/Exec.qll

@@ -1,4 +1,5 @@
-/* Definitions related to the Apache Commons Exec library. */
+/** Definitions related to the Apache Commons Exec library. */
+
 import semmle.code.java.Type
 import semmle.code.java.security.ExternalProcess
 

java/ql/lib/semmle/code/java/security/ExternalProcess.qll

@@ -1,4 +1,5 @@
-/* Definitions related to external processes. */
+/** Definitions related to external processes. */
+
 import semmle.code.java.Member
 
 private module Instances {

java/ql/lib/semmle/code/java/security/RelativePaths.qll

@@ -1,4 +1,5 @@
-/* Detection of strings and arrays of strings containing relative paths. */
+/** Detection of strings and arrays of strings containing relative paths. */
+
 import java
 
 /**

java/ql/lib/semmle/code/java/security/SqlUnescapedLib.qll

@@ -1,4 +1,5 @@
-/* Definitions used by `SqlUnescaped.ql`. */
+/** Definitions used by `SqlUnescaped.ql`. */
+
 import semmle.code.java.security.ControlledString
 import semmle.code.java.dataflow.TaintTracking
 

java/ql/src/Violations of Best Practice/Dead Code/DeadLocals.qll

@@ -1,4 +1,4 @@
-/*
+/**
  * Provides classes and predicates for "dead locals": which variables are used, which assignments are useless, etc.
  */