Doc strings

Author: pokey

src/processTargets/modifiers/ModifyIfUntypedStage.ts

@@ -5,7 +5,8 @@ import getModifierStage from "../getModifierStage";
 import { ModifierStage } from "../PipelineStages.types";
 
 /**
- * Runs {@link ModifyIfUntypedModifier.modifier} if the target is lacking an explicit modifier.
+ * Runs {@link ModifyIfUntypedModifier.modifier} if the target has no explicit
+ * scope type, ie if {@link Target.hasExplicitScopeType} is `false`.
  */
 export default class ModifyIfUntypedStage implements ModifierStage {
   private nestedStage_?: ModifierStage;
@@ -20,7 +21,7 @@ export default class ModifyIfUntypedStage implements ModifierStage {
 
     /**
      * This target is lacking an explicit scope type and should use inference/upgrade when needed.
-     * See {@link UntypedTarget} for more info
+     * See {@link Target.hasExplicitScopeType} for more info
      */
     return this.nestedStage
       .run(context, target)

src/processTargets/modifiers/commonContainingScopeIfUntypedStages.ts

@@ -1,5 +1,10 @@
 import ModifyIfUntypedStage from "./ModifyIfUntypedStage";
 
+/**
+ * Expands the given target to the nearest containing surrounding pair if the
+ * target has no explicit scope type, ie if {@link Target.hasExplicitScopeType}
+ * is `false`.
+ */
 export const containingSurroundingPairIfUntypedStage = new ModifyIfUntypedStage(
   {
     type: "modifyIfUntyped",
@@ -10,6 +15,10 @@ export const containingSurroundingPairIfUntypedStage = new ModifyIfUntypedStage(
   }
 );
 
+/**
+ * Expands the given target to the nearest containing line if the target has no
+ * explicit scope type, ie if {@link Target.hasExplicitScopeType} is `false`.
+ */
 export const containingLineIfUntypedStage = new ModifyIfUntypedStage({
   type: "modifyIfUntyped",
   modifier: {
@@ -18,6 +27,10 @@ export const containingLineIfUntypedStage = new ModifyIfUntypedStage({
   },
 });
 
+/**
+ * Expands the given target to the nearest containing token if the target has no
+ * explicit scope type, ie if {@link Target.hasExplicitScopeType} is `false`.
+ */
 export const containingTokenIfUntypedStage = new ModifyIfUntypedStage({
   type: "modifyIfUntyped",
   modifier: {