From joel@automatvapen.se  Sun Nov 28 13:11:27 2004
Return-Path: <joel@automatvapen.se>
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id E156E16A4CE
	for <FreeBSD-gnats-submit@freebsd.org>; Sun, 28 Nov 2004 13:11:26 +0000 (GMT)
Received: from av9-2-sn3.vrr.skanova.net (av9-2-sn3.vrr.skanova.net [81.228.9.186])
	by mx1.FreeBSD.org (Postfix) with ESMTP id 63A7443D48
	for <FreeBSD-gnats-submit@freebsd.org>; Sun, 28 Nov 2004 13:11:26 +0000 (GMT)
	(envelope-from joel@automatvapen.se)
Received: by av9-2-sn3.vrr.skanova.net (Postfix, from userid 502)
	id 32C0938035; Sun, 28 Nov 2004 14:11:25 +0100 (CET)
Received: from smtp3-1-sn3.vrr.skanova.net (smtp3-1-sn3.vrr.skanova.net [81.228.9.101])
	by av9-2-sn3.vrr.skanova.net (Postfix) with ESMTP id 1A7A237EAD
	for <FreeBSD-gnats-submit@freebsd.org>; Sun, 28 Nov 2004 14:11:25 +0100 (CET)
Received: from dude.automatvapen.se (t2o955p2.telia.com [195.252.52.122])
	by smtp3-1-sn3.vrr.skanova.net (Postfix) with SMTP id E151937E42
	for <FreeBSD-gnats-submit@freebsd.org>; Sun, 28 Nov 2004 14:11:23 +0100 (CET)
Received: by dude.automatvapen.se (sSMTP sendmail emulation); Sun, 28 Nov 2004 14:11:42 +0100
Message-Id: <20041128131123.E151937E42@smtp3-1-sn3.vrr.skanova.net>
Date: Sun, 28 Nov 2004 14:11:42 +0100
From: "Joel Dahl" <joel@automatvapen.se>
Reply-To: Joel Dahl <joel@automatvapen.se>
To: FreeBSD-gnats-submit@freebsd.org
Cc:
Subject: [patch] Correct several links in the contributing article
X-Send-Pr-Version: 3.113
X-GNATS-Notify:

>Number:         74477
>Category:       docs
>Synopsis:       [patch] Correct several links in the contributing article
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Sun Nov 28 13:20:22 GMT 2004
>Closed-Date:    Fri Oct 13 07:36:20 GMT 2006
>Last-Modified:  Fri Oct 13 07:36:20 GMT 2006
>Originator:     Joel Dahl
>Release:        FreeBSD 5.3-STABLE i386
>Organization:
>Environment:
System: FreeBSD dude.automatvapen.se 5.3-STABLE FreeBSD 5.3-STABLE #1: Sat Nov 13 19:50:36 CET 2004 joel@dude.automatvapen.se:/usr/obj/usr/src/sys/WRK i386

	
>Description:
Fix five dead links:
- 1-4: &url.base;{place} points to /usr/share/{place} on my machine, which
       results in dead links.
- 5:   index.html should be article.html.
	
>How-To-Repeat:
	
>Fix:
	
--- contlinks.diff begins here ---
Index: article.sgml
===================================================================
RCS file: /home/ncvs/doc/en_US.ISO8859-1/articles/contributing/article.sgml,v
retrieving revision 1.503
diff -u -r1.503 article.sgml
--- article.sgml	9 Aug 2004 19:49:16 -0000	1.503
+++ article.sgml	28 Nov 2004 11:25:42 -0000
@@ -180,7 +180,7 @@
 	<listitem>
 	  <para>Get copies of formal standards like &posix;.  You can
 	    get some links about these standards at the <ulink
-	    url="&url.base;/projects/c99/index.html">FreeBSD
+	    url="http://www.FreeBSD.org/projects/c99/index.html">FreeBSD
 	    C99 & POSIX Standards Conformance Project</ulink> web
 	    site. Compare FreeBSD's behavior to that required by the
 	    standard. If the behavior differs, particularly in subtle
@@ -203,7 +203,7 @@
       <indexterm><primary>problem reports database</primary></indexterm>
 
       <para>The <ulink
-	url="&url.base;/cgi/query-pr-summary.cgi">FreeBSD
+	url="http://www.FreeBSD.org/cgi/query-pr-summary.cgi">FreeBSD
 	PR list</ulink> shows all the current active problem reports
 	and requests for enhancement that have been submitted by
 	FreeBSD users.  The PR database includes both programmer and
@@ -244,7 +244,7 @@
 
       <para>If you find a bug or are submitting a specific change,
 	please report it using the &man.send-pr.1; program or its
-	<ulink url="&url.base;/send-pr.html">WEB-based
+	<ulink url="http://www.FreeBSD.org/send-pr.html">WEB-based
 	equivalent</ulink>.  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
@@ -526,7 +526,7 @@
 	<para>The FreeBSD Project happily accepts donations of
 	  hardware that it can find good use for.  If you are
 	  interested in donating hardware, please contact the <ulink
-	  url="&url.base;/donations/">Donations Liaison
+	  url="http://www.FreeBSD.org/donations/">Donations Liaison
 	  Office</ulink>.</para>
       </sect3>
 
@@ -536,7 +536,7 @@
 	<para>We can always use new mirror sites for FTP, WWW or
 	  <command>cvsup</command>.  If you would like to be such a
 	  mirror, please see the <ulink
-	  url="&url.articles.hubs;/index.html">Mirroring FreeBSD</ulink>
+	  url="&url.articles.hubs;/article.html">Mirroring FreeBSD</ulink>
 	  article for more information.</para>
       </sect3>
     </sect2>
--- contlinks.diff ends here ---


>Release-Note:
>Audit-Trail:

From: Ceri Davies <ceri@submonkey.net>
To: Joel Dahl <joel@automatvapen.se>
Cc: FreeBSD-gnats-submit@FreeBSD.org
Subject: Re: docs/74477: [patch] Correct several links in the contributing article
Date: Sun, 28 Nov 2004 17:08:12 +0000

 On Sun, Nov 28, 2004 at 02:11:42PM +0100, Joel Dahl wrote:
 
 > Fix five dead links:
 > - 1-4: &url.base;{place} points to /usr/share/{place} on my machine, which
 >        results in dead links.
 
 > @@ -180,7 +180,7 @@
 >  	<listitem>
 >  	  <para>Get copies of formal standards like &posix;.  You can
 >  	    get some links about these standards at the <ulink
 > -	    url="&url.base;/projects/c99/index.html">FreeBSD
 > +	    url="http://www.FreeBSD.org/projects/c99/index.html">FreeBSD
 >  	    C99 & POSIX Standards Conformance Project</ulink> web
 >  	    site. Compare FreeBSD's behavior to that required by the
 >  	    standard. If the behavior differs, particularly in subtle
 
 Hmm.  This is not right.  There should be a better way to specify that a
 url is part of the web build and will not be present locally when the
 docs are built.  Perhaps we can make URLS_ABSOLUTE=yes the default and
 override it during a web build?
 
 > - 5:   index.html should be article.html.
 
 Why?
 
 Ceri
 -- 
 Only two things are infinite, the universe and human stupidity, and I'm
 not sure about the former.			  -- Einstein (attrib.)

From: Joel Dahl <joel@automatvapen.se>
To: Ceri Davies <ceri@submonkey.net>
Cc: FreeBSD-gnats-submit@FreeBSD.org
Subject: Re: docs/74477: [patch] Correct several links in the contributing
	article
Date: Sun, 28 Nov 2004 21:59:39 +0100

 --=-17x47EOmqzOqPdDVY9F0
 Content-Type: text/plain
 Content-Transfer-Encoding: quoted-printable
 
 On Sun, 2004-11-28 at 17:10 +0000, Ceri Davies wrote:=20
 >  > @@ -180,7 +180,7 @@
 >  >  	<listitem>
 >  >  	  <para>Get copies of formal standards like &posix;.  You can
 >  >  	    get some links about these standards at the <ulink
 >  > -	    url=3D"&url.base;/projects/c99/index.html">FreeBSD
 >  > +	    url=3D"http://www.FreeBSD.org/projects/c99/index.html">FreeBSD
 >  >  	    C99 & POSIX Standards Conformance Project</ulink> web
 >  >  	    site. Compare FreeBSD's behavior to that required by the
 >  >  	    standard. If the behavior differs, particularly in subtle
 > =20
 >  Hmm.  This is not right.  There should be a better way to specify that a
 >  url is part of the web build and will not be present locally when the
 >  docs are built.  Perhaps we can make URLS_ABSOLUTE=3Dyes the default and
 >  override it during a web build?
 
 Yes, I agree, there should be a better way to achieve this. My patch
 does not correct the real problem, it only avoids it.
 
 > =20
 >  > - 5:   index.html should be article.html.
 > =20
 >  Why?
 
 Ahh, I'm obviously missing something here. index.html does not exist on
 my machine (yes, I know that it works on the web). I'm clearly doing
 something wrong during the doc build, since the [Single HTML / Split
 HTML] option is gone.
 
 --=-17x47EOmqzOqPdDVY9F0
 Content-Type: application/pgp-signature; name=signature.asc
 Content-Description: This is a digitally signed message part
 
 -----BEGIN PGP SIGNATURE-----
 Version: GnuPG v1.2.6 (FreeBSD)
 
 iD8DBQBBqjw7Fq4CPaTv3mARAiuXAJ0T7z9TpCl659j0bQjl8lz9jlgbXgCgzK71
 8b4r+VFsst4wL3doyFGsqhY=
 =VYie
 -----END PGP SIGNATURE-----
 
 --=-17x47EOmqzOqPdDVY9F0--
 

From: Vitaly Bogdanov <gad@gad.glazov.net>
To: bug-followup@freebsd.org
Cc:  
Subject: Re: docs/74477: [patch] Correct several links in the contributing article
Date: Fri, 17 Mar 2006 19:49:03 +0400

 >......
 >......
 >>  > @@ -180,7 +180,7 @@
 >>  >  <listitem>
 >>  >    <para>Get copies of formal standards like &posix;.  You can
 >>  >      get some links about these standards at the <ulink
 >>  > -    url=3D"&url.base;/projects/c99/index.html">FreeBSD
 >>  > +
 >>  > url=3D"http://www.FreeBSD.org/projects/c99/index.html">FreeBSD
 >>  >      C99 & POSIX Standards Conformance Project</ulink> web
 >>  >      site. Compare FreeBSD's behavior to that required by the
 >>  >      standard. If the behavior differs, particularly in subtle
 >>
 >>  Hmm.  This is not right.  There should be a better way to specify
 >>  that a
 >>  url is part of the web build and will not be present locally when
 >>  the
 >>  docs are built.  Perhaps we can make URLS_ABSOLUTE= yes the default
 >>  and
 >>  override it during a web build?
 > 
 >Yes, I agree, there should be a better way to achieve this. My patch
 >does not correct the real problem, it only avoids it.
 
 I dissagre.
 Why should something strange and difficult be invented?
 
 As I can understand, there are no advantages in using `'&url.base;/.....`'
 for www/ content.  Simple using absolute dns names
 everywhere in references to web-site content (not doc/ tree) seems to be
 more superior and easy solution.
 
 -- 
 Vitaly

From: Ceri Davies <ceri@submonkey.net>
To: Vitaly Bogdanov <gad@gad.glazov.net>,
	<freebsd-gnats-submit@freebsd.org>
Cc:  
Subject: Re: docs/74477: [patch] Correct several links in the contributing
 article
Date: Sun, 19 Mar 2006 18:32:12 +0000

 On 17/3/06 17:00, "Vitaly Bogdanov" <gad@gad.glazov.net> wrote:
 
 >  As I can understand, there are no advantages in using `'&url.base;/.....`'
 >  for www/ content.  Simple using absolute dns names
 >  everywhere in references to web-site content (not doc/ tree) seems to be
 >  more superior and easy solution.
 
 That breaks mirroring.
 
 Ceri
 -- 
 That must be wonderful!  I don't understand it at all.
                                       -- Moliere
 
 
 

From: Vitaly Bogdanov <gad@gad.glazov.net>
To: Ceri Davies <ceri@submonkey.net>
Cc: freebsd-gnats-submit@freebsd.org
Subject: Re: docs/74477: [patch] Correct several links in the contributing article
Date: Mon, 20 Mar 2006 11:04:58 +0400

 On Sun, Mar 19, 2006, Ceri Davies wrote:
 > The following reply was made to PR docs/74477; it has been noted by GNATS.
 > 
 > From: Ceri Davies <ceri@submonkey.net>
 > To: Vitaly Bogdanov <gad@gad.glazov.net>,
 > 	<freebsd-gnats-submit@freebsd.org>
 > Cc:  
 > Subject: Re: docs/74477: [patch] Correct several links in the contributing
 >  article
 > Date: Sun, 19 Mar 2006 18:32:12 +0000
 > 
 >  On 17/3/06 17:00, "Vitaly Bogdanov" <gad@gad.glazov.net> wrote:
 >  
 >  >  As I can understand, there are no advantages in using `'&url.base;/.....`'
 >  >  for www/ content.  Simple using absolute dns names
 >  >  everywhere in references to web-site content (not doc/ tree) seems to be
 >  >  more superior and easy solution.
 >  
 >  That breaks mirroring.
 
 But we use absolute dns names in many (maybe in all) FDP documents.
 -- 
 Vitaly

From: Ceri Davies <ceri@submonkey.net>
To: Vitaly Bogdanov <gad@gad.glazov.net>
Cc: freebsd-gnats-submit@freebsd.org
Subject: Re: docs/74477: [patch] Correct several links in the contributing article
Date: Mon, 20 Mar 2006 09:26:11 +0000

 On Mon, Mar 20, 2006 at 11:04:58AM +0400, Vitaly Bogdanov wrote:
 > On Sun, Mar 19, 2006, Ceri Davies wrote:
 > > The following reply was made to PR docs/74477; it has been noted by GNATS.
 > > 
 > > From: Ceri Davies <ceri@submonkey.net>
 > > To: Vitaly Bogdanov <gad@gad.glazov.net>,
 > > 	<freebsd-gnats-submit@freebsd.org>
 > > Cc:  
 > > Subject: Re: docs/74477: [patch] Correct several links in the contributing
 > >  article
 > > Date: Sun, 19 Mar 2006 18:32:12 +0000
 > > 
 > >  On 17/3/06 17:00, "Vitaly Bogdanov" <gad@gad.glazov.net> wrote:
 > >  
 > >  >  As I can understand, there are no advantages in using `'&url.base;/.....`'
 > >  >  for www/ content.  Simple using absolute dns names
 > >  >  everywhere in references to web-site content (not doc/ tree) seems to be
 > >  >  more superior and easy solution.
 > >  
 > >  That breaks mirroring.
 > 
 > But we use absolute dns names in many (maybe in all) FDP documents.
 
 Actually, we try hard not to.  That's why &base; and &enbase; exist.
 
 Ceri
 -- 
 That must be wonderful!  I don't understand it at all.
                                                   -- Moliere
State-Changed-From-To: open->closed 
State-Changed-By: remko 
State-Changed-When: Fri Oct 13 07:35:43 UTC 2006 
State-Changed-Why:  
As far as I can see, this problem is solved (I have no issues when browsing the article.html file). 
Joel, please let me know when this is not true. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=74477 
>Unformatted:
