bug.report(utils)
bug.report()所属R语言包：utils
Send a Bug Report
发送错误报告
译者：生物统计家园网 机器人LoveR
描述----------Description----------
Invokes an editor or email program to write a bug report or opens a web page for bug submission. Some standard information on the current version and configuration of R are included automatically.
调用一个编辑器或电子邮件程序写一个bug报告，或提交错误打开网页。 R的当前版本和配置上的一些标准信息自动列入。
用法----------Usage----------
bug.report(subject = "", address,
file = "R.bug.report", package = NULL, lib.loc = NULL,
...)
参数----------Arguments----------
参数：subject
Subject of the email.
电子邮件的主题。
参数：address
Recipient's email address, where applicable: for package bug reports sent by email this defaults to the address of the package maintainer (the first if more than one is listed).
收件人的电子邮件地址，如适用：软件包的bug报告通过电子邮件发送这个默认的软件包的维护者的地址（如果列出了多个第一）。
参数：file
filename to use (if needed) for setting up the email.
文件名用于设立电子邮件（如果需要）。
参数：package
Optional character vector naming a single package which is the subject of the bug report.
可选的特征向量命名一个单一的软件包，这是错误报告的主题。
参数：lib.loc
A character vector describing the location of R library trees in which to search for the package, or NULL. The default value of NULL corresponds to all libraries currently known.
一个特征向量，描述在其中进行搜索的包R库树的位置，或NULL。默认值的NULL对应于目前已知的所有库。
参数：...
additional named arguments such as method and ccaddress to pass to create.post.
额外的命名参数，如method和ccaddress到传递create.post的。
Details
详情----------Details----------
If package is NULL or a base package, this opens the R bugs tracker at http://bugs.r-project.org/.
如果package是NULL或基础包，打开在http://bugs.r-project.org/~~V的的R错误跟踪。
If package is specified, it is assumed that the bug report is about that package, and parts of its "DESCRIPTION" file are added to the standard information. If the package has a BugReports field in the "DESCRIPTION" file, that URL will be opened using browseURL, otherwise an email directed to the package maintainer will be generated using create.post.
如果package指定，它被假定包是错误报告，其DESCRIPTION文件的部分添加到标准的信息。如果包BugReports文件中的一个DESCRIPTION领域，该URL将使用browseURL打开，否则将电子邮件向软件包的维护者使用create.post。
值----------Value----------
Nothing useful.
没什么用处。
如何报告错误----------How to report a bug----------
When you decide that there is a bug, it is important to report it and to report it in a way which is useful. What is most useful is an exact description of what commands you type, from when you start R until the problem happens. Always include the version of R, machine, and operating system that you are using; type <KBD>version</KBD> in R to print this. To help us keep track of which bugs have been fixed and which are still open please send a separate report for each bug.
当你决定有错误的，它是重要的报告和报告的方式，这是非常有用的。什么是最有用的是什么命令你类型的确切描述，当您启动ŕ，直到问题发生。始终包含的R版本，机器，您正在使用的操作系统;类型<KBD>版本</大骨节病>在R打印此。为了帮助我们跟踪错误已得到修复并仍然打开，请为每个错误发送一个单独的报告。
The most important principle in reporting a bug is to report FACTS, not hypotheses or categorizations. It is always easier to report the facts, but people seem to prefer to strain to posit explanations and report them instead. If the explanations are based on guesses about how R is implemented, they will be useless; we will have to try to figure out what the facts must have been to lead to such speculations. Sometimes this is impossible. But in any case, it is unnecessary work for us.
在报告bug的最重要的原则是事实，而不是假设或分类报告。它始终是更容易地报道事实真相，但人们似乎更喜欢应变断定解释和报告他们，而不是。如果根据有关如何R是实施的猜测的解释，他们将是无用的，我们将不得不揣摩什么事实必须已经导致这样的揣测。有时候这是不可能的。但在任何情况下，这对我们来说是不必要的工作。
For example, suppose that on a data set which you know to be quite large the command data.frame(x, y, z, monday, tuesday) never returns. Do not report that data.frame() fails for large data sets. Perhaps it fails when a variable name is a day of the week. If this is so then when we got your report we would try out the data.frame() command on a large data set, probably with no day of the week variable name, and not see any problem. There is no way in the world that we could guess that we should try a day of the week variable name.
例如，假设数据集，你知道这是相当大的命令data.frame(x, y, z, monday, tuesday)从来没有回报。不报告，data.frame()大型数据集的失败。也许失败，当一个变量的名称是一个星期。如果这是这样然后，当我们收到您的报告，我们将尝试在大型数据集的data.frame()命令，大概没有一天一周变量名，并没有看到任何问题。有没有在世界的方式，我们可以猜测，我们应该尝试每天一周的变量名称。
Or perhaps the command fails because the last command you used was a [ method that had a bug causing R's internal data structures to be corrupted and making the data.frame() command fail from then on. This is why we need to know what other commands you have typed (or read from your startup file).
或者在命令失败，因为您使用的最后一个命令是[方法有一个bug，导致R的内部数据结构被破坏，使data.frame()命令失败。这就是为什么我们需要知道什么其他的命令，键入（或从您的启动文件中读取）。
It is very useful to try and find simple examples that produce apparently the same bug, and somewhat useful to find simple examples that might be expected to produce the bug but actually do not. If you want to debug the problem and find exactly what caused it, that is wonderful. You should still report the facts as well as any explanations or solutions.
这是非常有益的尝试，并找到简单的例子，显然会产生同样的错误，有些有用的发现，预期可能产生错误的简单的例子，但实际上没有。如果你要调试的问题，并准确地找到什么原因造成的，是美好的。您仍然应该报告的事实，以及任何解释或解决方案。
Invoking R with the --vanilla option may help in isolating a bug. This ensures that the site profile and saved data files are not read.
调用--vanilla选项R可以帮助隔离错误。这确保该网站的文件和保存的数据文件无法读取。
A bug report can be generated using the function bug.report(). For reports on R this will open the Web page at http://bugs.R-project.org/: for a contributed package it will open the package's bug tracker Web page or help you compose an email to the maintainer.
使用功能bug.report()可以生成一个错误报告。对于R上的报告，这将打开http://bugs.R-project.org/~~V网页：为促成包，它会打开包的bug跟踪系统网页或帮助您撰写电子邮件维护者。
Bug reports on <STRONG>contributed packages</STRONG> should not be sent to the R bug tracker: rather make use of the package argument.
<STRONG>问题报告作出贡献的软件包</强>不应该被发送到R bug跟踪系统，而使用package参数。
作者（S）----------Author(s)----------
This help page is adapted from the Emacs manual and the R FAQ
参见----------See Also----------
help.request which you possibly should try before bug.report.
help.request你可能前应尽量bug.report。
create.post, which handles emailing reports.
的create.post，处理电子邮件报告。
The R FAQ, also sessionInfo() from which you may add to the bug report.
常见的R，也sessionInfo()你可能会增加错误报告。
转载请注明:出自 生物统计家园网(http://www.biostatistic.net)。
注：
注1：为了方便大家学习，本文档为生物统计家园网机器人LoveR翻译而成，仅供个人R语言学习参考使用，生物统计家园保留版权。
注2：由于是机器人自动翻译，难免有不准确之处，使用时仔细对照中、英文内容进行反复理解，可以帮助R语言的学习。
注3：如遇到不准确之处，请在本贴的后面进行回帖，我们会逐渐进行修订。
|
发表于 2012-2-17 09:59:34
