fix: pkg_doc_fun multiblock param docs

Author: WetRobot

NEWS.md

@@ -1,5 +1,14 @@
 <!-- generated by R package codedoc; do not modify! -->
 
+## News for version 0.6.2
+
+### codedoc::pkg_doc_fun
+
+Fixed `codedoc::pkg_doc_fun` extraction of param docs.
+Multi-block docs could be mixed between parameters if they appeared in
+a mixed order in text. Now they do not.
+
+
 ## News for version 0.6.1
 
 ### codedoc::pkg_doc_fun

R/pkg_doc.R

@@ -72,6 +72,12 @@ pkg_doc_codedoc_df__ <- function(
     }
     .__PKG_DOC_ENV__.[["text_file_df"]] <- new_text_file_df
     extract_arg_list <- as.list(extract_arg_list)
+    # @codedoc_comment_block news("codedoc::pkg_doc_fun", "2025-03-19", "0.6.2")
+    # Fixed `codedoc::pkg_doc_fun` extraction of param docs.
+    # Multi-block docs could be mixed between parameters if they appeared in
+    # a mixed order in text. Now they do not.
+    # @codedoc_comment_block news("codedoc::pkg_doc_fun", "2025-03-19", "0.6.2")
+    extract_arg_list[["sort_by"]] <- c("key", "first_block_line")
     extract_arg_list[["detect_allowed_keys"]] <- function(x) {
       pkg_nm <- read.dcf(
         "DESCRIPTION",