docs: better describe output of all_shortest_paths()

R/structural.properties.R

@@ -788,10 +788,16 @@ degree_distribution <- function(graph, cumulative = FALSE, ...) {
 #'   was not requested.} \item{inbound_edges}{Numeric vector, the inbound edge
 #'   for each vertex, or `NULL`, if it was not requested.}
 #'
-#'   For `all_shortest_paths()` a list is returned, each list element
+#'   For `all_shortest_paths()` a list is returned:
+#'   \item{vpaths}{This is a list. Each list element
 #'   contains a shortest path from `from` to a vertex in `to`. The
 #'   shortest paths to the same vertex are collected into consecutive elements
-#'   of the list.
+#'   of the list.}
+#'   \item{epaths}{This is a list similar to vpaths,
+#'   but the vectors of the list contain the edge ids along the shortest paths,
+#'   instead of the vertex ids.}
+#'   \item{nrgeo}{Number of geodesics.}
+#'   \item{res}{}
 #'
 #'   For `mean_distance()` a single number is returned if `details=FALSE`,
 #'   or a named list with two entries: `res` is the mean distance as a numeric