Add text to the Dealing With Broken Ports sectino. First, direct people
to GNATS instead of the mailing lists or the Porter's Handbook. Also provide links to the How To Write Problem Reports article, the mailing list article, and the mirror list. Finally, add text trying to explain the difference between maintained and unmaintained ports. Glanced over by: simon
This commit is contained in:
parent
341bef6be3
commit
56f9a51317
Notes:
svn2git
2020-12-08 03:00:23 +00:00
svn path=/head/; revision=25691
1 changed files with 32 additions and 6 deletions
|
@ -1314,6 +1314,13 @@ ftp://ftp.FreeBSD.org/pub/FreeBSD/ports/distfiles/ fetch</userinput></screen>
|
|||
there are a few things you can do, including:</para>
|
||||
|
||||
<orderedlist>
|
||||
<listitem>
|
||||
<para>Find out if there is a fix pending for the port in
|
||||
the <ulink url="&url.base;/support.html#gnats">Problem Report
|
||||
database</ulink>. If so, you may be able to use the
|
||||
proposed fix.</para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para>Fix it! The <ulink
|
||||
url="&url.books.porters-handbook;/index.html">Porter's
|
||||
|
@ -1323,17 +1330,35 @@ ftp://ftp.FreeBSD.org/pub/FreeBSD/ports/distfiles/ fetch</userinput></screen>
|
|||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para>Gripe—<emphasis>by email only</emphasis>! Send
|
||||
email to the maintainer of the port first. Type
|
||||
<para>Ask the maintainer of the port for help. Type
|
||||
<command>make maintainer</command> or read the
|
||||
<filename>Makefile</filename> to find the maintainer's
|
||||
email address. Remember to include the name and version
|
||||
of the port (send the <literal>$FreeBSD:</literal>
|
||||
line from the <filename>Makefile</filename>) and the
|
||||
output leading up to the error when you email the
|
||||
maintainer. If you do not get a response from the
|
||||
maintainer, you can use &man.send-pr.1; to submit a bug
|
||||
report.</para>
|
||||
maintainer.</para>
|
||||
|
||||
<note>
|
||||
<para>Some ports are not maintained by an individual but
|
||||
instead by a <ulink
|
||||
url="&url.articles.mailing-list-faq;/article.html">mailing
|
||||
list</ulink>. Many, but not all, of these addresses look like
|
||||
<literal>freebsd-listname@FreeBSD.org</literal>. Please
|
||||
take this into account when phrasing your questions.</para>
|
||||
|
||||
<para>In particular, ports shown as maintained by
|
||||
<literal>freebsd-ports@FreeBSD.org</literal> are
|
||||
actually not maintained by anyone. Fixes and support, if
|
||||
any, come from the general community who subscribe to that
|
||||
mailing list. More volunteers are always needed!</para>
|
||||
</note>
|
||||
|
||||
<para>If you do not get a response,
|
||||
you can use &man.send-pr.1; to submit a bug
|
||||
report (see <ulink
|
||||
url="&url.articles.problem-reports;/article.html">Writing
|
||||
FreeBSD Problem Reports</ulink>).</para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
|
@ -1341,7 +1366,8 @@ ftp://ftp.FreeBSD.org/pub/FreeBSD/ports/distfiles/ fetch</userinput></screen>
|
|||
<quote>master</quote> package collection is on <hostid
|
||||
role="fqdn">ftp.FreeBSD.org</hostid> in the <ulink
|
||||
url="ftp://ftp.FreeBSD.org/pub/FreeBSD/ports/packages/">packages
|
||||
directory</ulink>, but be sure to check your local mirror
|
||||
directory</ulink>, but be sure to check your <ulink
|
||||
url="http://mirrorlist.FreeBSD.org/">local mirror</ulink>
|
||||
<emphasis>first</emphasis>! These are more likely to work
|
||||
than trying to compile from source and are a lot faster as
|
||||
well. Use the &man.pkg.add.1; program to install the
|
||||
|
|
Loading…
Reference in a new issue