Add doc changes

Forgot to add these before merging #139

Author: serenity4

README.md

@@ -8,7 +8,7 @@ CodeTracking can be thought of as an extension of Julia's
 It provides an interface for obtaining:
 
 - the strings and expressions of method definitions
-- the method signatures at a specific file & line number
+- the method signatures (and their corresponding method table) at a specific file & line number
 - location information for "dynamic" code that might have moved since it was first loaded
 - a list of files that comprise a particular package.
 
@@ -112,7 +112,7 @@ PkgFiles(ColorTypes [3da002f7-5984-5a60-b8a6-cbb66c0b333f]):
 ```
 
 
-You can also find the method-signatures at a particular location:
+You can also find the method signatures at a particular location:
 
 ```julia
 julia> signatures_at(ColorTypes, "src/traits.jl", 14)
@@ -124,7 +124,7 @@ julia> signatures_at("/home/tim/.julia/packages/ColorTypes/BsAWO/src/traits.jl",
  nothing => Tuple{typeof(red),AbstractRGB}
 ```
 
-with the first element being the method table for which the method has been defined (a value of `nothing` denotes the default method table).
+with the first element being the method table for which the method was added (a value of `nothing` denotes the default method table).
 
 CodeTracking also helps correcting for [Julia issue #26314](https://github.com/JuliaLang/julia/issues/26314):
 

src/CodeTracking.jl

@@ -6,7 +6,7 @@ CodeTracking can be thought of as an extension of InteractiveUtils, and pairs we
 - `definition`: a lower-level variant of the above
 - `pkgfiles`: return information about the source files that define a package
 - `whereis`: Return location information about methods (with Revise, it updates as you edit files)
-- `signatures_at`: return the signatures of all methods whose definition spans the specified location
+- `signatures_at`: return the signatures (and the corresponding method table) of all methods whose definition spans the specified location
 """
 module CodeTracking
 
@@ -54,8 +54,8 @@ const method_lookup_callback = Ref{Any}(nothing)
 #    id is the PkgId of the corresponding package
 #    relpath is the path of the file from the basedir of `id`
 #    mod is the "active" module at that point in the source
-#    exsigs is a ex=>sigs dictionary, where `ex` is the source expression and `sigs`
-#        a list of method-signatures defined by that expression.
+#    exsigs is a `ex => mt_sigs` dictionary, where `ex` is the source expression and `mt_sigs`
+#        a list of `method_table => signature` pairs defined by that expression.
 const expressions_callback = Ref{Any}(nothing)
 
 const juliabase = joinpath("julia", "base")
@@ -69,9 +69,7 @@ MethodInfoKey(method::Method) = MethodInfoKey(method_table(method), method.sig)
 """
     filepath, line = whereis(method::Method)
 
-Return the file and line of the definition of `method`. The meaning of `line`
-depends on the Julia version: on Julia 1.5 and higher it is the line number of
-the method declaration, otherwise it is the first line of the method's body.
+Return the file and line of the definition of `method`.
 """
 function whereis(method::Method)
     file, line = String(method.file), method.line
@@ -140,11 +138,9 @@ function whereis(lineinfo::Core.LineInfoNode, method::Method)
 end
 
 """
-    sigs = signatures_at(filename, line)
+    mt_sigs = signatures_at(filename, line)
 
-Return the signatures of all methods whose definition spans the specified location.
-Prior to Julia 1.5, `line` must correspond to a line in the method body
-(not the signature or final `end`).
+Return the `method_table => signature` pairs of all methods whose definition spans the specified location.
 
 Returns `nothing` if there are no methods at that location.
 """
@@ -181,11 +177,11 @@ function signatures_at(filename::AbstractString, line::Integer)
 end
 
 """
-    sigs = signatures_at(mod::Module, relativepath, line)
+    mt_sigs = signatures_at(mod::Module, relativepath, line)
 
-For a package that defines module `mod`, return the signatures of all methods whose definition
-spans the specified location. `relativepath` indicates the path of the file relative to
-the packages top-level directory, e.g., `"src/utils.jl"`.
+For a package that defines module `mod`, return the `method_table => signature` pairs of
+all methods whose definition spans the specified location. `relativepath` indicates the
+path of the file relative to the packages top-level directory, e.g., `"src/utils.jl"`.
 `line` must correspond to a line in the method body (not the signature or final `end`).
 
 Returns `nothing` if there are no methods at that location.
@@ -200,10 +196,10 @@ function signatures_at(id::PkgId, relpath::AbstractString, line::Integer)
     expressions === nothing && error("cannot look up methods by line number, try `using Revise` before loading other packages")
     try
         for (mod, exsigs) in Base.invokelatest(expressions, id, relpath)
-            for (ex, sigs) in exsigs
+            for (ex, mt_sigs) in exsigs
                 lr = linerange(ex)
                 lr === nothing && continue
-                line ∈ lr && return sigs
+                line ∈ lr && return mt_sigs
             end
         end
     catch