From b1ead9c0febfc46d5d2b31e40356a9b68ca41a56 Mon Sep 17 00:00:00 2001 From: Matthijs Berends Date: Sat, 10 Dec 2022 10:09:57 +0100 Subject: [PATCH] doc update --- DESCRIPTION | 4 ++-- NEWS.md | 8 ++++---- R/translate.R | 8 ++++---- man/translate.Rd | 8 ++++---- 4 files changed, 14 insertions(+), 14 deletions(-) diff --git a/DESCRIPTION b/DESCRIPTION index 8f36c4d0..622c7c90 100644 --- a/DESCRIPTION +++ b/DESCRIPTION @@ -1,6 +1,6 @@ Package: AMR -Version: 1.8.2.9059 -Date: 2022-12-09 +Version: 1.8.2.9060 +Date: 2022-12-10 Title: Antimicrobial Resistance Data Analysis Description: Functions to simplify and standardise antimicrobial resistance (AMR) data analysis and to work with microbial and antimicrobial properties by diff --git a/NEWS.md b/NEWS.md index 0afaf92d..4c7460e7 100755 --- a/NEWS.md +++ b/NEWS.md @@ -1,9 +1,9 @@ -# AMR 1.8.2.9059 +# AMR 1.8.2.9060 This version will eventually become v2.0! We're happy to reach a new major milestone soon! ### Breaking -* Removed all species of the taxonomic kingdom Chromista from the package. This was done for multiple reasons: +* **Removed all species of the taxonomic kingdom Chromista** from the package. This was done for multiple reasons: * CRAN allows packages to be around 5 MB maximum, some packages are exempted but this package is not one of them * Chromista are not relevant when it comes to antimicrobial resistance, thus lacking the primary scope of this package * Chromista are almost never clinically relevant, thus lacking the secondary scope of this package @@ -16,8 +16,8 @@ This version will eventually become v2.0! We're happy to reach a new major miles ### New * **EUCAST 2022 and CLSI 2022 guidelines** have been added for `as.rsi()`. EUCAST 2022 (v12.0) is now the new default guideline for all MIC and disks diffusion interpretations, and for `eucast_rules()` to apply EUCAST Expert Rules. -* Support for the following languages: Chinese, Greek, Japanese, Polish, Turkish and Ukrainian. We are very grateful for the valuable input by our colleagues from other countries. The `AMR` package is now available in 16 languages. The automatic language determination will give a note at start-up on systems in supported languages. -* **All new algorithm for `as.mo()`** (and thus all `mo_*()` functions) while still following our original set-up as described in our recently submitted JSS paper (DOI [10.18637/jss.v104.i03](https://doi.org/10.18637/jss.v104.i03)). +* Support for the following languages: Chinese, Greek, Japanese, Polish, Turkish and Ukrainian. We are very grateful for the valuable input by our colleagues from other countries. The `AMR` package is now available in 16 languages. The automatic language determination will give a note on systems in supported languages. +* **All new algorithm for `as.mo()`** (and thus all `mo_*()` functions) while still following our original set-up as described in our recently published JSS paper (DOI [10.18637/jss.v104.i03](https://doi.org/10.18637/jss.v104.i03)). * A new argument `keep_synonyms` allows to *not* correct for updated taxonomy, in favour of the now deleted argument `allow_uncertain` * It has increased tremendously in speed and returns generally more consequent results * Sequential coercion is now extremely fast as results are stored to the package environment, although coercion of unknown values must be run once per session. Previous results can be reset/removed with the new `mo_reset_session()` function. diff --git a/R/translate.R b/R/translate.R index 007c9736..08108d99 100755 --- a/R/translate.R +++ b/R/translate.R @@ -34,13 +34,13 @@ #' @param language language to choose. Use one of these supported language names or ISO-639-1 codes: `r vector_or(paste0(sapply(LANGUAGES_SUPPORTED_NAMES, function(x) x[[1]]), " (" , LANGUAGES_SUPPORTED, ")"), quotes = FALSE, sort = FALSE)`. #' @details The currently `r length(LANGUAGES_SUPPORTED)` supported languages are `r vector_or(paste0(sapply(LANGUAGES_SUPPORTED_NAMES, function(x) x[[1]]), " (" , LANGUAGES_SUPPORTED, ")"), quotes = FALSE, sort = FALSE)`. All these languages have translations available for all antimicrobial drugs and colloquial microorganism names. #' -#' **To silence language notes when this package loads** on a non-English operating system, you can set the option `AMR_locale` in your `.Rprofile` file like this: +#' To permanently silence the once-per-session language notes on a non-English operating system, you can set the option `AMR_locale` in your `.Rprofile` file like this: #' #' ```r #' # Open .Rprofile file #' utils::file.edit("~/.Rprofile") #' -#' # Add e.g. Italian support to that file using: +#' # Then add e.g. Italian support to that file using: #' options(AMR_locale = "Italian") #' ``` #' @@ -84,11 +84,11 @@ #' set_AMR_locale("Deutsch") #' set_AMR_locale("German") #' set_AMR_locale("de") -#' ab_name("amoxi/clav") +#' ab_name("amox/clav") #' #' # reset to system default #' reset_AMR_locale() -#' ab_name("amoxi/clav") +#' ab_name("amox/clav") get_AMR_locale <- function() { # a message for this will be thrown in translate_into_language() if outcome is non-English if (!is.null(getOption("AMR_locale", default = NULL))) { diff --git a/man/translate.Rd b/man/translate.Rd index 807f2f04..3f413a96 100644 --- a/man/translate.Rd +++ b/man/translate.Rd @@ -27,12 +27,12 @@ For language-dependent output of AMR functions, like \code{\link[=mo_name]{mo_na \details{ The currently 16 supported languages are English (en), Chinese (zh), Danish (da), Dutch (nl), French (fr), German (de), Greek (el), Italian (it), Japanese (ja), Polish (pl), Portuguese (pt), Russian (ru), Spanish (es), Swedish (sv), Turkish (tr) or Ukrainian (uk). All these languages have translations available for all antimicrobial drugs and colloquial microorganism names. -\strong{To silence language notes when this package loads} on a non-English operating system, you can set the option \code{AMR_locale} in your \code{.Rprofile} file like this: +To permanently silence the once-per-session language notes on a non-English operating system, you can set the option \code{AMR_locale} in your \code{.Rprofile} file like this: \if{html}{\out{
}}\preformatted{# Open .Rprofile file utils::file.edit("~/.Rprofile") -# Add e.g. Italian support to that file using: +# Then add e.g. Italian support to that file using: options(AMR_locale = "Italian") }\if{html}{\out{
}} @@ -76,9 +76,9 @@ mo_name("Coagulase-negative Staphylococcus (CoNS)") set_AMR_locale("Deutsch") set_AMR_locale("German") set_AMR_locale("de") -ab_name("amoxi/clav") +ab_name("amox/clav") # reset to system default reset_AMR_locale() -ab_name("amoxi/clav") +ab_name("amox/clav") }