Improve docstring of search methods

Author: juliohm

docs/src/algorithms/neighborsearch.md

@@ -10,6 +10,7 @@ point of reference. This can be performed with search methods:
 
 ```@docs
 NeighborSearchMethod
+BoundedNeighborSearchMethod
 search
 search!
 searchdists

src/neighborsearch.jl

@@ -10,53 +10,61 @@ A method for searching neighbors given a reference point.
 abstract type NeighborSearchMethod end
 
 """
-    search!(neighbors, pₒ, method; mask=nothing)
+    search(pₒ, method, mask=nothing)
 
-Update `neighbors` of point `pₒ` using `method` and return
-number of neighbors found. Optionally, specify a `mask` for
-all indices of the domain.
+Return neighbors of point `pₒ` using `method`. Optionally,
+specify a `mask` for all indices of the domain.
 """
-function search! end
+function search end
 
 """
-    searchdists!(neighbors, distances, pₒ, method; mask=nothing)
+    BoundedNeighborSearchMethod
 
-Update `neighbors` and `distances` of point `pₒ` using `method`
-and return number of neighbors found. Optionally, specify a
-`mask` for all indices of the domain.
+A method for searching neighbors with the property that the number of neighbors
+is bounded above by a known constant (e.g. k-nearest neighbors).
 """
-function searchdists! end
+abstract type BoundedNeighborSearchMethod <: NeighborSearchMethod end
 
 """
-    search(pₒ, method, mask=nothing)
+    maxneighbors(method)
 
-Return neighbors of point `pₒ` using `method`. Optionally,
-specify a `mask` for all indices of the domain.
+Return the maximum number of neighbors obtained with bounded search `method`.
+
+See [`BoundedNeighborSearchMethod`](@ref) for additional details.
 """
-function search end
+function maxneighbors end
 
 """
-    searchdists(pₒ, method, mask=nothing)
+    search!(neighbors, pₒ, method; mask=nothing)
 
-Return neighbors and distances of point `pₒ` using `method`.
-Optionally, specify a `mask` for all indices of the domain.
+Update `neighbors` of point `pₒ` using bounded search `method` and return
+number of neighbors found. Optionally, specify a `mask` for all indices of
+the domain.
+
+See [`BoundedNeighborSearchMethod`](@ref) for additional details.
 """
-function searchdists end
+function search! end
 
 """
-    BoundedNeighborSearchMethod
+    searchdists!(neighbors, distances, pₒ, method; mask=nothing)
 
-A method for searching neighbors with the property that the number of neighbors
-is bounded above by a known constant (e.g. k-nearest neighbors).
+Update `neighbors` and `distances` of point `pₒ` using bounded search `method`
+and return number of neighbors found. Optionally, specify a `mask` for all
+indices of the domain.
+
+See [`BoundedNeighborSearchMethod`](@ref) for additional details.
 """
-abstract type BoundedNeighborSearchMethod <: NeighborSearchMethod end
+function searchdists! end
 
 """
-    maxneighbors(method)
+    searchdists(pₒ, method, mask=nothing)
 
-Return the maximum number of neighbors obtained with `method`.
+Return neighbors and distances of point `pₒ` using bounded search `method`.
+Optionally, specify a `mask` for all indices of the domain.
+
+See [`BoundedNeighborSearchMethod`](@ref) for additional details.
 """
-function maxneighbors end
+function searchdists end
 
 # ----------
 # FALLBACKS