unified: Add some missing qldoc

Author: asgerf

shared/namebinding/codeql/namebinding/LocalNameBinding.qll

@@ -382,6 +382,7 @@ module LocalNameBinding<LocationSig Location, LocalNameBindingInputSig<Location>
       )
     }
 
+    /** Holds if `access` resolves to `l`. */
     predicate access(AstNode access, Local l) {
       exists(Scope lookup, string name |
         accessCandInLookupScope(access, name, lookup) and
@@ -412,6 +413,7 @@ module LocalNameBinding<LocationSig Location, LocalNameBindingInputSig<Location>
 
   private module DefaultAccesses = ResolveAccesses<accessCand/2>;
 
+  /** Holds if `access` resolves to `l`. */
   cached
   predicate access(AstNode access, Local l) {
     CachedStage::ref() and

unified/ql/lib/codeql/unified/internal/LocalNameBinding.qll

@@ -367,6 +367,7 @@ module Public {
     /** Gets the name of this local, as a string. */
     string getName() { result = super.getName() }
 
+    /** Gets an access to this entity, through its lexically scoped name. */
     LocalNameAccess getAnAccess() { result.getLocalName() = this }
 
     /** Gets a name binding that declares this local name. */
@@ -458,8 +459,10 @@ module Public {
  * ```
  */
 class PotentialLocalNameAccess extends IdentifierExpr {
+  /** Gets the representative for the local name being accessed. */
   LocalName getLocalName() { result = this.(LocalNameBindingOutput::LocalAccess).getLocal() }
 
+  /** Gets the name being accessed. */
   string getName() { result = this.getValue() }
 
   /** Holds if this is one of the binding sites for a name, such as the `x` in `let x = 123`. */

unified/ql/lib/utils/test/TestUtils.qll

@@ -23,6 +23,7 @@ private predicate declAt(NameBinding v, string filepath, int line) {
   v.getLocation().hasLocationInfo(filepath, line, _, _, _)
 }
 
+/** Holds if the name-binding `v` has been assigned the given `alias` by a comment in the test code. */
 predicate nameBinding(NameBinding v, string alias) {
   exists(string filepath, int line | declAt(v, filepath, line) |
     keyValueCommentAt(filepath, line, "name", alias)