Bump to 1.2.0

DESCRIPTION

@@ -1,8 +1,8 @@
 Package: hetu
 Type: Package
 Title: Structural Handling of Finnish Personal Identity Codes
-Version: 1.1.0
-Date: 2024-12-03
+Version: 1.2.0
+Date: 2025-06-24
 Authors@R: 
     c(
   person(given = "Pyry",

NEWS.md

@@ -1,6 +1,10 @@
 # *News*
 ==========
 
+# hetu 1.2.0 (2025-06-24)
+
+* Edit package citation to include a reference to the joint article in R Journal describing the `hetu` and `sweidnumbr` packages
+
 # hetu 1.1.0 (2024-12-03)
 
 * Add summary method and plot methods for data.frames produced by `hetu_diagnostic()`

README.Rmd

@@ -96,9 +96,11 @@ vignette("hetu")
 
 ## Acknowledgements
 
-**Kindly cite this work** as follows: [Pyry Kantanen](https://github.com/pitkant/), Måns Magnusson, Jussi Paananen, Leo Lahti. Pyry Kantanen, Mans Magnusson, Jussi Paananen and Leo Lahti (2024). hetu: Structural Handling of Finnish
-  Personal Identity Codes [Computer software]. R package version 1.1.0. DOI:
-  https://doi.org/10.32614/CRAN.package.hetu
+**Kindly cite this work** as follows (citing the related paper strongly preferred but we encourage also citing software used in research): 
+
+```{r, comment="", prompt=TRUE, highlight=FALSE}
+print(citation("hetu"), bibtex=TRUE)
+```
 
 We are grateful to all [contributors](https://github.com/rOpenGov/hetu/graphs/contributors)! This project is part of [rOpenGov](https://ropengov.org). 
 

README.md

@@ -117,12 +117,52 @@ vignette("hetu")
 
 ## Acknowledgements
 
-**Kindly cite this work** as follows: [Pyry
-Kantanen](https://github.com/pitkant/), Måns Magnusson, Jussi Paananen,
-Leo Lahti. Pyry Kantanen, Mans Magnusson, Jussi Paananen and Leo Lahti
-(2024). hetu: Structural Handling of Finnish Personal Identity Codes
-\[Computer software\]. R package version 1.1.0. DOI:
-<https://doi.org/10.32614/CRAN.package.hetu>
+**Kindly cite this work** as follows (citing the related paper strongly
+preferred but we encourage also citing software used in research):
+
+``` text
+> print(citation("hetu"), bibtex=TRUE)
+To cite package ‘hetu’ in publications use:
+
+  Kantanen P, Bülow E, Lahtinen A, Magnusson M, Paananen J, Lahti L
+  (2025). "Validating and Extracting Information from National
+  Identification Numbers in R: The Case of Finland and Sweden." _The R
+  Journal_, *16*, 4-14. ISSN 2073-4859, doi:10.32614/RJ-2024-023
+  <https://doi.org/10.32614/RJ-2024-023>.
+
+A BibTeX entry for LaTeX users is
+
+  @Article{RJ-2024-023,
+    title = {Validating and Extracting Information from National Identification Numbers in R: The Case of Finland and Sweden},
+    author = {Pyry Kantanen and Erik B{\"u}low and Aleksi Lahtinen and M{\aa}ns Magnusson and Jussi Paananen and Leo Lahti},
+    year = {2025},
+    doi = {10.32614/RJ-2024-023},
+    journal = {The R Journal},
+    volume = {16},
+    issue = {3},
+    issn = {2073-4859},
+    pages = {4-14},
+  }
+
+We strongly recommend citing the software used in research, as per
+FORCE11 Software citation principles:
+
+  Pyry Kantanen, Måns Magnusson, Jussi Paananen and Leo Lahti (2025).
+  hetu: Structural Handling of Finnish Personal Identity Codes
+  [Computer software]. R package version 1.2.0. DOI:
+  https://doi.org/10.32614/CRAN.package.hetu
+
+A BibTeX entry for LaTeX users is
+
+  @Misc{,
+    title = {hetu: Structural Handling of Finnish Personal Identity Codes},
+    author = {Pyry Kantanen and M{\aa}ns Magnusson and Jussi Paananen and Leo Lahti},
+    doi = {10.32614/CRAN.package.hetu},
+    url = {https://github.com/rOpenGov/hetu},
+    year = {2025},
+    note = {R package version 1.2.0},
+  }
+```
 
 We are grateful to all
 [contributors](https://github.com/rOpenGov/hetu/graphs/contributors)!

inst/CITATION

@@ -1,15 +1,37 @@
-citHeader("Kindly cite the hetu R package as follows:")
-
 year <- sub("-.*", "", meta$Date)
 vers <- paste("R package version", meta$Version)
 
+bibentry(
+  bibtype="article",
+  header="To cite package ‘hetu’ in publications use:",
+  key="RJ-2024-023",
+  title="Validating and Extracting Information from National Identification Numbers in R: The Case of Finland and Sweden",
+  author=
+    c(
+      person(given="Pyry", family="Kantanen"),
+      person(given="Erik", family="B{\\\"u}low"),
+      person(given="Aleksi", family="Lahtinen"),
+      person(given="M{\\aa}ns", family="Magnusson"),
+      person(given="Jussi", family="Paananen"),
+      person(given="Leo", family="Lahti")
+    ),
+  year=2025,
+  doi="10.32614/RJ-2024-023",
+  journal="The R Journal",
+  volume="16",
+  issue="3",
+  issn="2073-4859",
+  pages="4-14"
+)
+
 bibentry(
   bibtype="Misc",
+  header = "We strongly recommend citing the software used in research, as per FORCE11 Software citation principles:",
   title = "hetu: Structural Handling of Finnish Personal Identity Codes",
   author = 
     c(
       person(given ="Pyry", family="Kantanen", email = "pyry.kantanen@gmail.com"),
-      person(given ="Mans", family="Magnusson"),	   
+      person(given ="M{\\aa}ns", family="Magnusson"),	   
       person(given ="Jussi", family="Paananen"),
       person(given ="Leo", family="Lahti")),
   doi = "10.32614/CRAN.package.hetu",
@@ -19,11 +41,9 @@ bibentry(
   note = vers,
   textVersion = 
     paste0(
-      "Pyry Kantanen, Mans Magnusson, Jussi Paananen and Leo Lahti (",year,"). ",
+      "Pyry Kantanen, Måns Magnusson, Jussi Paananen and Leo Lahti (",year,"). ",
       "hetu: Structural Handling of Finnish Personal Identity Codes [Computer software]. ",
       vers,
       ". DOI: https://doi.org/10.32614/CRAN.package.hetu"
       )
     )
-
-citFooter("\nMany thanks for all contributors!")