R语言:news()函数中文帮助文档(中英文对照)

loveR

news(utils)
news()所属R语言包：utils

                                        Build and Query R or Package News Information
                                         建立和查询R或包装新闻信息

                                         译者：生物统计家园网 机器人LoveR

描述----------Description----------

Build and query the news for R or add-on packages.
建立和查询为R的消息，或附加软件包。


用法----------Usage----------


news(query, package = "R", lib.loc = NULL, format = NULL,
     reader = NULL, db = NULL)



参数----------Arguments----------

参数：query
an expression for selecting news entries
选择新闻条目的表达


参数：package
a character string giving the name of an installed add-on package, or "R".
一个字符串附加软件包已安装的名称，或"R"。


参数：lib.loc
a character vector of directory names of R libraries, or NULL.  The default value of NULL corresponds to all libraries currently known.
特征向量的研发图书馆的目录名，或NULL。默认值的NULL对应于目前已知的所有库。


参数：format
Not yet used.
尚未使用。


参数：reader
Not yet used.
尚未使用。


参数：db
a news db obtained from news().
新闻DBnews()。


Details

详情----------Details----------

If package is "R" (default), a news db is built with the news since the 2.10.0 release of R (corresponding to R's top-level "NEWS" file).  Otherwise, if the given add-on package can be found in the given libraries, it is attempted to read its news in structured form from files "inst/NEWS.Rd", "NEWS" or "inst/NEWS" (in that order).
如果package是"R"（默认），新闻数据库是建立与新闻自研发2.10.0版本（对应于R的顶级NEWS文件） 。否则，如果给定的附加软件包，可以发现在给定的库，它试图在结构形式读取文件inst/NEWS.Rd，NEWS或新闻inst/NEWS（按顺序）。

File "inst/NEWS.Rd" should be an Rd file given the entries as Rd
文件inst/NEWS.Rd应该是一个号文件中给出的条目路

Entries are grouped according to version, with version header “Changes in version” at the beginning of a line, followed by a version number, optionally followed by an ISO 8601 format date, possibly parenthesized.
条目按照版本与版本标题“版本中的变化”，在一行的开头，后跟一个版本号，后面可以通过ISO 8601格式的日期，可能括号。

Entries may be grouped according to category, with a category header (different from a version header) starting at the beginning of a line.
参赛作品可以按类别，一类标题行的开头开始（从不同版本头）。

Entries are written as itemize-type lists, using one of o, *, - or + as item tag.  Entries must be indented, and ideally use a common indentation for the item texts.
条目会被写入逐项类型的列表，使用o，*，-或+项标签。参赛作品必须缩进，最好使用一个共同的项目文本缩进。

Additional formats and readers may be supported in the future.
在未来可以支持更多的格式和读者。

Package tools provides an (internal) utility function news2Rd to convert plain text "NEWS" files to Rd.  For "NEWS" files in a format which can successfully be handled by the default reader, package maintainers can use tools:::news2Rd(dir,     "NEWS.Rd"), possibly with additional argument codify = TRUE, with dir a character string specifying the path to a package's root directory.  Upon success, the "NEWS.Rd" file can further be improved and then be moved to the "inst" subdirectory of the package source directory.
包tools提供实用功能（内部）news2Rd转换成纯文本NEWS文件号。 NEWS默认读者一个可以成功地处理格式的文件，对于“包维护者可以使用tools:::news2Rd(dir,     "NEWS.Rd")，可能有额外的参数codify = TRUE，dir一个字符串，指定包的根目录的路径。成功后，可以进一步加以改进的NEWS.Rd文件，然后被转移到inst包源目录的子目录。

The news db built is a character data frame inheriting from "news_db" with variables Version, Category, Date and Text, where the last contains the entry texts read, and the other variables may be NA if they were missing or could not be determined.
新闻数据库的建立是一个字符数据框继承"news_db"变量Version，Category，Date和Text，其中包含最后进入文本阅读，和其他变量可能NA“如果他们丢失或无法确定的。

Using query, one can select news entries from the db.  If missing or NULL, the complete db is returned.  Otherwise, query should be an expression involving (a subset of) the variables Version, Category, Date and Text, and when evaluated within the db returning a logical vector with length the number of entries in the db.  The entries for which evaluation gave TRUE are selected.  When evaluating, Version and Date are coerced to numeric_version and Date objects, respectively, so that the comparison operators for these classes can be employed.
使用query，可以从数据库中选择的新闻条目。如果丢失或NULL，完整的DB返回。否则，query应该是一个表达式涉及（子集）的变量Version，Category，Date和Text，在分贝评估时返回在DB中的条目数量与长度的逻辑向量。参赛作品评价了TRUE选择。评估时，Version和Date被强制numeric_version和Date对象，分别可以采用，使这些类的比较运算符。


值----------Value----------

An data frame inheriting from class "news_db".
一个数据框的继承类"news_db"。


举例----------Examples----------


## Build a db of all R news entries.[＃建立一个DB的所有R的新闻条目。]
db <- news()
## Bug fixes with PR number in 2.11.0.[PR在2.11.0＃Bug修复。]
news(Version == "2.11.0" &amp; grepl("^BUG", Category) &amp; grepl("PR#", Text),[“文本）]
     db = db)
## Entries with version &gt;= 2.10.1 (including "2.10.1 patched"):[＃版本的条目> = 2.10.1（包括“2.10.1补丁”）：]
table(news(Version >= "2.10.1", db = db)$Version)

转载请注明:出自 生物统计家园网(http://www.biostatistic.net)。


注：
注1：为了方便大家学习，本文档为生物统计家园网机器人LoveR翻译而成，仅供个人R语言学习参考使用，生物统计家园保留版权。
注2：由于是机器人自动翻译，难免有不准确之处，使用时仔细对照中、英文内容进行反复理解，可以帮助R语言的学习。
注3：如遇到不准确之处，请在本贴的后面进行回帖，我们会逐渐进行修订。