References not included in `\insertAllCited{}` when rendered after §References

[ms609]

#' FooBar
#' 
#' `FooBar()` implements the methods of 
#' \insertCite{GarciaDiaz2017,GarciaDiaz2019}{MyPackage}.
# [...]
#' @seealso [ExactKCentre()] for the proven optimum;
#' [FarFirst()] for the \insertCite{Gonzalez1985;textual}{MyPackage}
#' 2-approximation baseline.
#' @references \insertAllCited{}

yields:

References

García-Díaz J, Menchaca-Méndez R, Menchaca-Méndez R, Pomares Hernández S, Pérez-Sansalvador JC, Lakouari N (2019). “Approximation algorithms for the vertex-center problem: survey and experimental evaluation.” IEEE Access, 7, 109228–109245. doi:10.1109/ACCESS.2019.2933875 .

García-Díaz J, Sánchez-Hernández J, Menchaca-Méndez R, Menchaca-Méndez R (2017). “When a worse approximation factor gives better performance: a 3-approximation algorithm for the vertex
-center problem.” Journal of Heuristics, 23(5), 349–366. doi:10.1007/s10732-017-9345-x .

See also

ExactKCentre() for the proven optimum; FarFirst() for the González (1985) 2-approximation baseline.

Gonzalez1985 is missing from the \insertAllCited{} section.

My guess is that, although it's included before \insertAllCited{} in the roxygen2 block, it's rendered after the References section in the .Rd file, and thus not included in the References list.

[GeoBosh]

Yes, your diagnosis is correct - insertAllCited{} sees the list of references requested before the command is processed. One cause may be roxygen, but R itself has a canonical order for the standard sections, so off-my-head I think that you will see the same effect even if the Rd file has these two sections in the order in the roxygen comments. I am away and am not able to check now, but you could swap the two sections in the Rd file and remove the roxygen comment at the top stating that the file is produced by roxygen (after the check delete the Rd file to let roxygen recreate it next time).

A workaround is to use \insertNoCite{...} at a suitable place to add a key to the list of references without producing a citation. A suitable place may be just before \insertAllCited.