|
2 | 2 |
|
3 | 3 | <sect1 id="bug-reporting">
|
4 | 4 | <!-- <title>Bug Reporting Guidelines</title> -->
|
5 |
| -<title>Bug汇报指导</title> |
| 5 | +<title>Bug报告指导</title> |
6 | 6 |
|
7 | 7 | <!--
|
8 | 8 | <para>
|
|
16 | 16 | -->
|
17 | 17 | <para>
|
18 | 18 | 当你在<productname>PostgreSQL</productname>里碰到Bug时,我们也希望能知道它。
|
19 |
| -你的Bug汇报是将<productname>PostgreSQL</productname>做得更加可靠的一个非常重要的部分, |
| 19 | +你的Bug报告是将<productname>PostgreSQL</productname>做得更加可靠的一个非常重要的部分, |
20 | 20 | 因为再细致的工作也不能保证在任何情况、任何平台下<productname>PostgreSQL</productname>
|
21 | 21 | 的每一个部分都能正常工作。
|
22 | 22 | </para>
|
|
64 | 64 | the following circumstances:
|
65 | 65 | -->
|
66 | 66 | 在你报告Bug之前,请一再仔细地读文档,以确认你确实可以做你在做的事情。
|
67 |
| -如果文档中对你能否处理你所做的事情并不清楚,也请你汇报过来,因为这个是文档的Bug。 |
| 67 | +如果文档中对你能否处理你所做的事情并不清楚,也请你报告过来,因为这个是文档的Bug。 |
68 | 68 | 如果发现你的程序表现的不像文档里说的那样,那就是一个Bug。
|
69 | 69 | 这时可能包括(不过不一定局限于)下面的现像:
|
70 | 70 | <itemizedlist>
|
|
157 | 157 | </para>
|
158 | 158 | -->
|
159 | 159 | <para>
|
160 |
| - 在你准备继续汇报Bug之前,请检查 TODO 列表和 FAQ ,看看你报告的Bug是否已知。 |
161 |
| - 如果你不能解析 TODO 列表里面的信息,请汇报你的问题。至少我们可以把 TODO 列表做得更清晰。 |
| 160 | + 在你准备继续报告Bug之前,请检查 TODO 列表和 FAQ ,看看你报告的Bug是否已知。 |
| 161 | + 如果你不能解析 TODO 列表里面的信息,请报告你的问题。至少我们可以把 TODO 列表做得更清晰。 |
162 | 162 | </para>
|
163 | 163 | </sect2>
|
164 | 164 |
|
165 | 165 | <sect2>
|
166 | 166 | <!-- <title>What to Report</title> -->
|
167 |
| -<title>汇报什么</title> |
| 167 | +<title>报告什么</title> |
168 | 168 | <!--
|
169 | 169 | <para>
|
170 | 170 | The most important thing to remember about bug reporting is to state all
|
|
182 | 182 | </para>
|
183 | 183 | -->
|
184 | 184 | <para>
|
185 |
| - 关于汇报Bug需要记住的最重要的事就是写出所有事实并且只写事实。不要推测你认为是什么错了, |
| 185 | + 关于报告Bug需要记住的最重要的事就是写出所有事实并且只写事实。不要推测你认为是什么错了, |
186 | 186 | 什么<quote>看起来像</quote>,或者是推测程序的哪一部分失灵了。如果你不熟悉 PostgreSQL 的实现,
|
187 | 187 | 你很可能猜错因而不能帮我们任何忙。而且即使你熟悉 Postgres 的实现,
|
188 | 188 | 提炼出来的解释也只是事实的补充而不是代替。如果我们准备修理这个Bug,
|
189 | 189 | 我们仍然需要首先亲自看到Bug的出现。报告简单的事实相对而言比较直接 (你可以从屏幕上拷贝和粘贴),
|
190 |
| - 不过经常发生的是很多人认为这些事实不重要而忽略了重要的细节,否则汇报总是能够被我们理解。 |
| 190 | + 不过经常发生的是很多人认为这些事实不重要而忽略了重要的细节,否则报告总是能够被我们理解。 |
191 | 191 | </para>
|
192 | 192 |
|
193 | 193 | <para>
|
194 | 194 | <!-- The following items should be contained in every bug report: -->
|
195 | 195 |
|
196 |
| -下面的条目应该包含在所有Bug汇报里面: |
| 196 | +下面的条目应该包含在所有Bug报告里面: |
197 | 197 | <itemizedlist>
|
198 | 198 | <listitem>
|
199 | 199 | <!--
|
|
423 | 423 | -->
|
424 | 424 | <para>
|
425 | 425 | 平台信息。这包括内核名称和版本、C 库、处理器、存储器信息。
|
426 |
| -大多数情况下只需要汇报供应商和版本,但是不要指望每个人都很清楚<quote>Debian</quote> |
| 426 | +大多数情况下只需要报告供应商和版本,但是不要指望每个人都很清楚<quote>Debian</quote> |
427 | 427 | 包括什么东西或者说每个人都运行在i386s上。如果你安装有问题,
|
428 |
| -那么还要详细汇报你机器上的工具的信息(编译器和 <application>make</application>等)。 |
| 428 | +那么还要详细报告你机器上的工具的信息(编译器和 <application>make</application>等)。 |
429 | 429 | </para>
|
430 | 430 | </listitem>
|
431 | 431 | </itemizedlist>
|
|
437 | 437 | an <ulink url="http://www.chiark.greenend.org.uk/~sgtatham/bugs.html">article</ulink>
|
438 | 438 | that outlines some more tips on reporting bugs.
|
439 | 439 | -->
|
440 |
| -不要怕你的Bug汇报太长,这就是生活。一开始就汇报所有的事情要比让我们从你那里挤出事实要好。 |
| 440 | +不要怕你的Bug报告太长,这就是生活。一开始就报告所有的事情要比让我们从你那里挤出事实要好。 |
441 | 441 | 另外,如果你的输入文件非常巨大,先问问有没有人有兴趣查看它也是合理的。这里有一篇
|
442 | 442 | <ulink url="http://www.chiark.greenend.org.uk/~sgtatham/bugs.html">文章</ulink>,
|
443 |
| -概述了一些汇报Bug的更多的提示。 |
| 443 | +概述了一些报告Bug的更多的提示。 |
444 | 444 | </para>
|
445 | 445 |
|
446 | 446 | <!--
|
|
474 | 474 | </para>
|
475 | 475 | -->
|
476 | 476 | <para>
|
477 |
| -在你书写Bug汇报时,请选用不易混淆的术语。软件包本身被称为<quote>PostgreSQL</quote>, |
| 477 | +在你书写Bug报告时,请选用不易混淆的术语。软件包本身被称为<quote>PostgreSQL</quote>, |
478 | 478 | 有时简称为<quote>Postgres</quote>。当你特指后端服务器进程时,请明确说明,
|
479 | 479 | 而不要仅仅是说<quote>PostgreSQL 崩溃了</quote>。一个独立后端服务器进程的崩溃和父进程
|
480 | 480 | <quote>postgres</>崩溃是相当不同的;如果你是说独立后端进程崩溃了,那么请不要说<quote>服务器崩溃了</>,
|
|
485 | 485 |
|
486 | 486 | <sect2>
|
487 | 487 | <!-- <title>Where to Report Bugs</title> -->
|
488 |
| -<title>到哪里汇报Bug</title> |
| 488 | +<title>到哪里报告Bug</title> |
489 | 489 | <!--
|
490 | 490 | <para>
|
491 | 491 | In general, send bug reports to the bug report mailing list at
|
|
495 | 495 | </para>
|
496 | 496 | -->
|
497 | 497 | <para>
|
498 |
| -通常,把汇报发到Bug汇报邮件列表<email>pgsql-bugs@postgresql.org</email>。 |
| 498 | +通常,把报告发到Bug报告邮件列表<email>pgsql-bugs@postgresql.org</email>。 |
499 | 499 | 我们要求你为电子邮件消息选用一个描述性的题目,也许就用错误信息的一部分。
|
500 | 500 | </para>
|
501 | 501 | <!--
|
|
536 | 536 | </para>
|
537 | 537 | -->
|
538 | 538 | <para>
|
539 |
| -不要把Bug汇报发送到任何用户邮件列表里,例如 SQL 语言邮件列表<email>pgsql-sql@postgresql.org</email> |
| 539 | +不要把Bug报告发送到任何用户邮件列表里,例如 SQL 语言邮件列表<email>pgsql-sql@postgresql.org</email> |
540 | 540 | 或<email>pgsql-general@postgresql.org</email>。这些邮件列表用于回答用户问题,
|
541 |
| -而且那些订阅者通常不希望接收Bug汇报。更重要的是,他们很可能不会修理这些Bug。 |
| 541 | +而且那些订阅者通常不希望接收Bug报告。更重要的是,他们很可能不会修理这些Bug。 |
542 | 542 | </para>
|
543 | 543 | <!--
|
544 | 544 | <para>
|
|
553 | 553 | -->
|
554 | 554 | <para>
|
555 | 555 | 还有,请<emphasis>不要</emphasis>向开发者邮件列表<email>pgsql-hackers@postgresql.org</email>
|
556 |
| -发送Bug汇报。这个列表用于讨论<productname>PostgreSQL</productname>的开发, |
557 |
| -因而我们很希望能和Bug汇报分离开。如果修理某个毛病需要更多评论, |
| 556 | +发送Bug报告。这个列表用于讨论<productname>PostgreSQL</productname>的开发, |
| 557 | +因而我们很希望能和Bug报告分离开。如果修理某个毛病需要更多评论, |
558 | 558 | 我们可能会在这个<literal>pgsql-hackers</literal>列表开一个关于你的Bug的讨论会。
|
559 | 559 | </para>
|
560 | 560 | <!--
|
|
567 | 567 | -->
|
568 | 568 | <para>
|
569 | 569 | 如果你觉得文档有问题,请发电子邮件到文档邮件列表<email>pgsql-docs@postgresql.org</email>,
|
570 |
| -在你的问题汇报里面指明你认为哪部分有错误。 |
| 570 | +在你的问题报告里面指明你认为哪部分有错误。 |
571 | 571 | </para>
|
572 | 572 | <!--
|
573 | 573 | <para>
|
|
0 commit comments