From owner-svn-doc-all@FreeBSD.ORG Fri Jun 20 11:43:45 2014 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id 4E0F03C5; Fri, 20 Jun 2014 11:43:45 +0000 (UTC) Received: from mail-gw12.york.ac.uk (mail-gw12.york.ac.uk [144.32.129.162]) (using TLSv1 with cipher AES256-SHA (256/256 bits)) (Client did not present a certificate) by mx1.freebsd.org (Postfix) with ESMTPS id F0AF5270D; Fri, 20 Jun 2014 11:43:44 +0000 (UTC) Received: from ury.york.ac.uk ([144.32.64.162]:46637) by mail-gw12.york.ac.uk with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.76) (envelope-from ) id 1WxxEM-0004b6-TM; Fri, 20 Jun 2014 12:43:42 +0100 Date: Fri, 20 Jun 2014 12:43:42 +0100 (BST) From: Gavin Atkinson X-X-Sender: gavin@ury.york.ac.uk To: Glen Barber Subject: Re: svn commit: r45075 - in head: en_US.ISO8859-1/articles/building-products en_US.ISO8859-1/articles/contributing en_US.ISO8859-1/articles/problem-reports en_US.ISO8859-1/articles/releng en_US.ISO8859... In-Reply-To: <201406181341.s5IDf4ZC065339@svn.freebsd.org> Message-ID: References: <201406181341.s5IDf4ZC065339@svn.freebsd.org> User-Agent: Alpine 2.00 (BSF 1167 2008-08-23) MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII Cc: svn-doc-head@freebsd.org, svn-doc-all@freebsd.org, doc-committers@freebsd.org X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: "SVN commit messages for the entire doc trees \(except for " user" , " projects" , and " translations" \)" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 20 Jun 2014 11:43:45 -0000 On Wed, 18 Jun 2014, Glen Barber wrote: > Author: gjb > Date: Wed Jun 18 13:41:03 2014 > New Revision: 45075 > URL: http://svnweb.freebsd.org/changeset/doc/45075 > > Log: > Replace query-pr.cgi and send-pr.html with their Bugzilla > equivalents. I think most of these are probably incorrect. The links for searching for bugs should probably point to the generic https://bugs.freebsd.org/search/ link rather than the direct Bugzilla link. All links to "report a bug" should likely point to /support.html and not to Bugzilla directly, in order to give a much more friendly end-user experience. Ones that do need to point directly into the bug tracker should point at the generic https://bugs.freebsd.org/submit/ link rather than the Bugzilla cgi. Note also that the problem-reports article needs more changes than just URL find/replace. I'm happy making these changes, if you don't mind? Thanks, Gavin > > Sponsored by: The FreeBSD Foundation > > Modified: > head/en_US.ISO8859-1/articles/building-products/article.xml > head/en_US.ISO8859-1/articles/contributing/article.xml > head/en_US.ISO8859-1/articles/problem-reports/article.xml > head/en_US.ISO8859-1/articles/releng/article.xml > head/en_US.ISO8859-1/books/faq/book.xml > head/en_US.ISO8859-1/books/fdp-primer/working-copy/chapter.xml > head/en_US.ISO8859-1/books/handbook/eresources/chapter.xml > head/en_US.ISO8859-1/htdocs/commercial/commercial.xml > head/en_US.ISO8859-1/htdocs/docproj/submitting.xml > head/en_US.ISO8859-1/htdocs/search/sitemap.xml > head/share/xml/header.ent > head/share/xml/libcommon.xsl > head/share/xml/navibar.ent > head/share/xml/templates.entries.xsl > > Modified: head/en_US.ISO8859-1/articles/building-products/article.xml > ============================================================================== > --- head/en_US.ISO8859-1/articles/building-products/article.xml Wed Jun 18 00:42:59 2014 (r45074) > +++ head/en_US.ISO8859-1/articles/building-products/article.xml Wed Jun 18 13:41:03 2014 (r45075) > @@ -693,7 +693,7 @@ bde 2005-10-29 16:34:50 UTC > > Report bugs upstream > If you notice bug in the FreeBSD code that you are > - using, file a bug > + using, file a bug > report. This step helps ensure that you do > not have to fix the bug the next time you take a code > drop from upstream. > > Modified: head/en_US.ISO8859-1/articles/contributing/article.xml > ============================================================================== > --- head/en_US.ISO8859-1/articles/contributing/article.xml Wed Jun 18 00:42:59 2014 (r45074) > +++ head/en_US.ISO8859-1/articles/contributing/article.xml Wed Jun 18 13:41:03 2014 (r45075) > @@ -252,7 +252,7 @@ > > If you find a bug or are submitting a specific change, > please report it using the &man.send-pr.1; program or its > - WEB-based > + WEB-based > equivalent. Try to fill-in each field of the bug > report. Unless they exceed 65KB, include any patches directly > in the report. If the patch is suitable to be applied to the > > Modified: head/en_US.ISO8859-1/articles/problem-reports/article.xml > ============================================================================== > --- head/en_US.ISO8859-1/articles/problem-reports/article.xml Wed Jun 18 00:42:59 2014 (r45074) > +++ head/en_US.ISO8859-1/articles/problem-reports/article.xml Wed Jun 18 13:41:03 2014 (r45075) > @@ -258,8 +258,8 @@ > > > Next, the searchable - xlink:href="http://www.FreeBSD.org/cgi/query-pr-summary.cgi?query">&os; > - PR database (GNATS). Unless the problem is recent > + xlink:href="https://bugs.freebsd.org/bugzilla/query.cgi">&os; > + PR database (Bugzilla). Unless the problem is recent > or obscure, there is a fair chance it has already been > reported. > > @@ -498,7 +498,7 @@ > a similar PR. Although this has already been > mentioned above, it bears repeating here. It only take a > minute or two to use the web-based search engine at - xlink:href="http://www.FreeBSD.org/cgi/query-pr-summary.cgi?query">http://www.FreeBSD.org/cgi/query-pr-summary.cgi?query. > + xlink:href="https://bugs.freebsd.org/bugzilla/query.cgi">https://bugs.freebsd.org/bugzilla/query.cgi. > (Of course, everyone is guilty of forgetting to do this > now and then.) > > @@ -562,7 +562,7 @@ > display of the PR will be readable. > > Similar considerations apply to use of the > - web-based > + web-based > PR submission form. Note that cut-and-paste operations > can have their own side-effects on text formatting. In > certain cases it may be necessary to use &man.uuencode.1; to > @@ -571,7 +571,7 @@ > Finally, if the submission is lengthy, prepare the work > offline so that nothing will be lost if there is a problem > submitting it. This can especially be a problem with the > - web > + web > form. > > > @@ -723,7 +723,7 @@ > > The next section describes fields that are common to both > the email interface and the > - web > + web > interface: > > > @@ -1161,7 +1161,7 @@ > strip comments and send it off. > > If you are using the - xlink:href="&url.base;/send-pr.html">web form: > + xlink:href="https://bugs.freebsd.org/bugzilla/enter_bug.cgi">web form: > > Before you hit submit, you will need to > fill in a field containing text that is represented in image > @@ -1207,7 +1207,7 @@ > > The easiest way is to use the followup link on the > individual PR's web page, which you can reach from the - xlink:href="http://www.FreeBSD.org/cgi/query-pr-summary.cgi?query">PR > + xlink:href="https://bugs.freebsd.org/bugzilla/query.cgi">PR > search page. Clicking on this link will bring up > an email window with the correct To: and Subject: lines > filled in (if your browser is configured to do this). > @@ -1329,7 +1329,7 @@ > have happened is that the database index has gotten out of > synchronization with the database itself. The way that you can > test whether this has happened is to pull up the > - view > + view > a single PR page and see whether the PR shows up. If > it does, please notify the GNATS administrators at > bugmeister@FreeBSD.org. Note that there is a > > Modified: head/en_US.ISO8859-1/articles/releng/article.xml > ============================================================================== > --- head/en_US.ISO8859-1/articles/releng/article.xml Wed Jun 18 00:42:59 2014 (r45074) > +++ head/en_US.ISO8859-1/articles/releng/article.xml Wed Jun 18 13:41:03 2014 (r45075) > @@ -165,7 +165,7 @@ > > > through email, the &man.send-pr.1; application, or via the web > - interface provided at http://www.FreeBSD.org/send-pr.html. > + interface provided at https://bugs.freebsd.org/bugzilla/enter_bug.cgi. > > To service our most conservative users, individual release > branches were introduced with &os; 4.3. > > Modified: head/en_US.ISO8859-1/books/faq/book.xml > ============================================================================== > --- head/en_US.ISO8859-1/books/faq/book.xml Wed Jun 18 00:42:59 2014 (r45074) > +++ head/en_US.ISO8859-1/books/faq/book.xml Wed Jun 18 13:41:03 2014 (r45075) > @@ -593,13 +593,13 @@ > > The Problem Report database of all user change > requests may be queried by using our web-based PR - xlink:href="http://www.FreeBSD.org/cgi/query-pr.cgi?query">query > + xlink:href="https://bugs.freebsd.org/bugzilla/query.cgi">query > interface. > > The &man.send-pr.1; command can be used to submit > problem reports and change requests via electronic mail. > Alternatively, the - xlink:href="http://www.freebsd.org/send-pr.html">web-based > + xlink:href="https://bugs.freebsd.org/bugzilla/enter_bug.cgi">web-based > problem report submission interface can be used > to submit problem reports through a web browser. > > > Modified: head/en_US.ISO8859-1/books/fdp-primer/working-copy/chapter.xml > ============================================================================== > --- head/en_US.ISO8859-1/books/fdp-primer/working-copy/chapter.xml Wed Jun 18 00:42:59 2014 (r45074) > +++ head/en_US.ISO8859-1/books/fdp-primer/working-copy/chapter.xml Wed Jun 18 13:41:03 2014 (r45075) > @@ -160,7 +160,7 @@ > documentation tree. > > If the diff file is to be submitted with the web > - Submit a &os; > + Submit a &os; > problem report interface, add a > .txt extension to give the earnest and > simple-minded web form a clue that the contents are plain > > Modified: head/en_US.ISO8859-1/books/handbook/eresources/chapter.xml > ============================================================================== > --- head/en_US.ISO8859-1/books/handbook/eresources/chapter.xml Wed Jun 18 00:42:59 2014 (r45074) > +++ head/en_US.ISO8859-1/books/handbook/eresources/chapter.xml Wed Jun 18 13:41:03 2014 (r45075) > @@ -1069,7 +1069,7 @@ > This is the mailing list for reporting bugs in &os;. > Whenever possible, bugs should be submitted using the > &man.send-pr.1; command or the > - WEB > + WEB > interface to it. > > > > Modified: head/en_US.ISO8859-1/htdocs/commercial/commercial.xml > ============================================================================== > --- head/en_US.ISO8859-1/htdocs/commercial/commercial.xml Wed Jun 18 00:42:59 2014 (r45074) > +++ head/en_US.ISO8859-1/htdocs/commercial/commercial.xml Wed Jun 18 13:41:03 2014 (r45075) > @@ -46,7 +46,7 @@ to the internet, these companies may off > >

If your company supports a FreeBSD related product, service, > consulting, or support that should be added to this page, please > - fill out a problem report > + fill out a problem report > for category www. Submissions should contain a medium-sized > paragraph in length, describing your company. > Please note that the inclusion of vendors in our list does > > Modified: head/en_US.ISO8859-1/htdocs/docproj/submitting.xml > ============================================================================== > --- head/en_US.ISO8859-1/htdocs/docproj/submitting.xml Wed Jun 18 00:42:59 2014 (r45074) > +++ head/en_US.ISO8859-1/htdocs/docproj/submitting.xml Wed Jun 18 13:41:03 2014 (r45075) > @@ -65,7 +65,7 @@ >

You should then let the Documentation Project know about it. The > correct way to do this is to use a command called send-pr, which > should be installed on your machine. > - The WWW problem report form may also be used.

> + The WWW problem report form may also be used.

> >

You do this so that your submission can be tracked. When you submit a PR > (Problem Report) it is assigned a unique number. One of the committers > > Modified: head/en_US.ISO8859-1/htdocs/search/sitemap.xml > ============================================================================== > --- head/en_US.ISO8859-1/htdocs/search/sitemap.xml Wed Jun 18 00:42:59 2014 (r45074) > +++ head/en_US.ISO8859-1/htdocs/search/sitemap.xml Wed Jun 18 13:41:03 2014 (r45075) > @@ -1201,12 +1201,12 @@ > > > Submit a FreeBSD problem report > - &base;/send-pr.html > + https://bugs.freebsd.org/bugzilla/enter_bug.cgi > > > > Bug report, submit > - &base;/send-pr.html > + https://bugs.freebsd.org/bugzilla/enter_bug.cgi > > > > > Modified: head/share/xml/header.ent > ============================================================================== > --- head/share/xml/header.ent Wed Jun 18 00:42:59 2014 (r45074) > +++ head/share/xml/header.ent Wed Jun 18 13:41:03 2014 (r45075) > @@ -125,8 +125,8 @@ >

> > > > Modified: head/share/xml/libcommon.xsl > ============================================================================== > --- head/share/xml/libcommon.xsl Wed Jun 18 00:42:59 2014 (r45074) > +++ head/share/xml/libcommon.xsl Wed Jun 18 13:41:03 2014 (r45075) > @@ -243,7 +243,7 @@ >

FreeBSD's widespread popularity has spawned a number of user groups > around the world.

>

If you know of a FreeBSD user group not listed here, > - please fill out a > + please fill out a > problem report for category www with the following information:

>
    >
  1. A URL for the user group's website.
    2. > > Modified: head/share/xml/navibar.ent > ============================================================================== > --- head/share/xml/navibar.ent Wed Jun 18 00:42:59 2014 (r45074) > +++ head/share/xml/navibar.ent Wed Jun 18 13:41:03 2014 (r45075) > @@ -180,7 +180,7 @@ > >
  2. Bug Reports >
    3. >
  3. Web Resources
    4. > > > Modified: head/share/xml/templates.entries.xsl > ============================================================================== > --- head/share/xml/templates.entries.xsl Wed Jun 18 00:42:59 2014 (r45074) > +++ head/share/xml/templates.entries.xsl Wed Jun 18 13:41:03 2014 (r45075) > @@ -40,7 +40,7 @@ > commercial listing into several sections. If your company > supports a FreeBSD-compatible product or service that should > be added to this page, please fill out a > - problem report for > + problem report for > category www. Submissions should be in HTML and a medium-sized > paragraph in length.

    > > >