From darklogik@pittgoth.com  Fri Jan 18 07:26:13 2002
Return-Path: <darklogik@pittgoth.com>
Received: from pittgoth.com (14.zlnp1.xdsl.nauticom.net [209.195.149.111])
	by hub.freebsd.org (Postfix) with ESMTP id 66A3737B422
	for <FreeBSD-gnats-submit@freebsd.org>; Fri, 18 Jan 2002 07:26:11 -0800 (PST)
Received: (from darklogik@localhost)
	by pittgoth.com (8.11.6/8.11.6) id g0IFRJI67312;
	Fri, 18 Jan 2002 10:27:19 -0500 (EST)
	(envelope-from darklogik)
Message-Id: <200201181527.g0IFRJI67312@pittgoth.com>
Date: Fri, 18 Jan 2002 10:27:19 -0500 (EST)
From: Tom Rhodes <darklogik@pittgoth.com>
Reply-To: Tom Rhodes <darklogik@pittgoth.com>
To: FreeBSD-gnats-submit@freebsd.org
Cc:
Subject: [NEW ARTICLE] Upgrading a.out to Elf
X-Send-Pr-Version: 3.113
X-GNATS-Notify:

>Number:         34038
>Category:       docs
>Synopsis:       [NEW ARTICLE] Upgrading a.out to Elf
>Confidential:   no
>Severity:       non-critical
>Priority:       medium
>Responsible:    trhodes
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Fri Jan 18 07:30:03 PST 2002
>Closed-Date:    Tue Jul 02 13:12:29 PDT 2002
>Last-Modified:  Tue Jul 02 13:12:29 PDT 2002
>Originator:     
>Release:        FreeBSD 4.5 i386
>Organization:
>Environment:
System: FreeBSD localhost 4.5

>Description:
This article (uuencoded) is a pretty good walkthrough of the upgrading process, mainly upgrading
a.out to ELF, but also designed in such a way, that, it can provide a good upgrade model for any FreeBSD version!

>How-To-Repeat:
>Fix:
Commit this article, we need upgrade documentation









begin 644 aout.tar.gz
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
(O0:Z6@#(````
`
end
>Release-Note:
>Audit-Trail:

From: "Hiten Pandya" <hitmaster@mysun.com>
To: freebsd-gnats-submit@FreeBSD.org
Cc: darklogik@pittgoth.com
Subject: Re: docs/34038 (vote)
Date: Tue, 05 Feb 2002 18:11:12 GMT

 hi,
 
 I beleive this article is very good, and needs to be added to
 the FreeBSD Documentation Project.  It certainly helped a lot
 of my mates (friends) to solve their a.out problem. :)
 
 Hope it get's in ;)
 
 regards,
 Hiten Pandya
 <hiten@uk.FreeBSD.org>
 <hitmaster@mysun.com>
 
 

From: Szilveszter Adam <sziszi@bsd.hu>
To: freebsd-gnats-submit@freebsd.org
Cc:  
Subject: Re: docs/34038
Date: Tue, 5 Feb 2002 22:06:07 +0100

 On Tue, Feb 05, 2002 at 10:20:02AM -0800, Hiten Pandya wrote:
 >  I beleive this article is very good, and needs to be added to
 >  the FreeBSD Documentation Project.  It certainly helped a lot
 >  of my mates (friends) to solve their a.out problem. :)
 
 Hello,
 
 I think that instead of pushing this submission, please provide some
 justification *why* this article should go in.
 
 I have just looked over it (which was not exactly made easier by the
 submitter who uuencoded *and* tar gzipped the article, which is IMHO
 quite gross for a single text file) and I see not a lot of info there
 that is not yet in various parts of the Handbook. In some cases, the
 info in the article is less accurate than the Handbook, which eg
 describes anon FTP and CTM in detail. Also, the text has some incorrect
 statements. Eg: mergemaster(8) is not a bash script. There are no bash
 scripts in the base system. Also, it says that cvsup needs bandwidth.
 While it is true that it will not hurt, in my experience daily cvsup
 runs took almost exactly the same amount of time over the 10Mbps link at
 university and over a 56kbps modem link. 
 
 Also, I think you should be careful when describing the a.out -> elf
 migration path. It was a special case and is probably more trouble than
 just running "make upgrade" and "make aout-to-elf". The mailing list
 archives from the time when 3.0 was new should be consulted to see any
 pitfalls. Also, I think it does not work as easily as described, ie you
 cannot simply take the latest STABLE code and upgrade to it from 2.2.x
 using source upgrade. Instead, once somebody described the process like
 this (after doing it himself)
 
 - First, upgrade to the latest 2.2.8-STABLE.
 - Do the upgrade to 3.0 using the a.out -> elf migration path and
   looking at the mailing list archives.
 - Upgrade to the latest 3.x-STABLE (which is something like 3.5.1-STABLE
   now)
 - Upgrade to 4.0 or 4.1 perhaps.
 - Upgrade to the latest 4.x-STABLE.
 
 Yes, it is quite difficult, simply reinstalling from CD or FTP is
 probably easier. Merging /etc would be very difficult too. Not to
 mention /dev and the fact that you have to recompile many software
 packages from third-party source.
 
 The gist: Although cutting corners might work once or twice, the source
 upgrade path is actually only for those who are quite good at what they
 do and even then you should follow the guidelines.
 
 The text also has stylistic and spelling errors/typos.
 
 Please, before answering, look over the existing documentation set (incl
 Handbook, FAQ, etc) and say what information this article has that is
 not in one of the existing docs already. If you find any of them lacking
 please consider submitting patches there, first.
 
 P.S.: It is easy to loose track of what is already in the docs, because
 there so much of it already:-) Eg I just planned to sit down and write a
 document about how to connect your FreeBSD box via DSL, but looked in
 the Handbook first and found it is already there:-)
 
 P.P.S: This is not to discourage anyone from writing more howto-like docs
 for users who prefer that. But duplication within the FDP should be
 avoided. Such howtos should be then made available somewhere else.
 
 Hope this message will not be considered flame because it was not the
 intention.
 
 -- 
 Regards:
 
 Szilveszter ADAM
 Szombathely Hungary

From: Tom Rhodes <darklogik@pittgoth.com>
To: Szilveszter Adam <sziszi@bsd.hu>,
	FreeBSD-gnats-submit@FreeBSD.org,
	Hiten Pandya <hitmaster2k@yahoo.com>
Cc:  
Subject: Re: docs/34038
Date: Tue, 05 Feb 2002 17:10:37 -0500

 I am going to defend the hours of work I did on this document...
 
 Szilveszter Adam wrote:
 
   
 >  Hello,
 >  
 >  I think that instead of pushing this submission, please provide some
 >  justification *why* this article should go in.
 
 
 Okie, may I do this though?  I hope as the author my reasons will be as 
 worthwhile has his!
 
 
 >  
 >  I have just looked over it (which was not exactly made easier by the
 >  submitter who uuencoded *and* tar gzipped the article, which is IMHO
 >  quite gross for a single text file) and I see not a lot of info there
 >  that is not yet in various parts of the Handbook.
 
 
 http://www.FreeBSD.org/docproj
 
 and I wish to point out Nik Clayton's document suggestion method: tar, 
 gzip, uuencode.  For more information about submitting documentation for 
 the Docproj, please see the docproj webpage about submitting 
 documentation located at:
 http://www.freebsd.org/docproj/submitting.html
 I know thats kinda cut short, but in essance sums up the uuencode and 
 the gzip.  Many people have submitted uuencoded zipped files and have 
 had ABSOLUTLY no problems.
 
 > In some cases, the
 >  info in the article is less accurate than the Handbook, which eg
 >  describes anon FTP and CTM in detail. Also, the text has some incorrect
 >  statements. Eg: mergemaster(8) is not a bash script.
 
 
  From the mergemaster(8) man page, under DESCRIPTION, and an exact quote:
 "mergemaster is a Bourne shell script which is designed to aid you in 
 updating the various configuration and other files associated with FreeBSD."
 
 If in some point and time, bash and Bourne again somehow demerged, I 
 think that many universities, companies, oganizations, and other 
 entities are very miss informed...
 
 > There are no bash
 >  scripts in the base system. 
 
 
 See my above statement... I'm almost positive that mergemaster(8) is in 
 the base system.
 
 >  Also, it says that cvsup needs bandwidth.
 >  While it is true that it will not hurt, in my experience daily cvsup
 >  runs took almost exactly the same amount of time over the 10Mbps link at
 >  university and over a 56kbps modem link.
 
 
  From the handbook: CTM uses a push method, cvsup uses a pull method, so 
 its obvious that CTM is more friendly on the server bandwidth...
 
 If this statement is incorrect, instead of saying my document is wrong, 
 tell us the handbook is wrong also so that we can fix it, don't just 
 point a finger at one entity please
 
  
 >  
 >  Also, I think you should be careful when describing the a.out -> elf
 >  migration path. It was a special case and is probably more trouble than
 >  just running "make upgrade" and "make aout-to-elf". The mailing list
 >  archives from the time when 3.0 was new should be consulted to see any
 >  pitfalls. Also, I think it does not work as easily as described, ie you
 >  cannot simply take the latest STABLE code and upgrade to it from 2.2.x
 >  using source upgrade. Instead, once somebody described the process like
 >  this (after doing it himself)
 
 
 I actually tested this on a 2.2.5 cd that came with an older version of 
 "The Complete FreeBSD" written by core member Greg Lehey, took some of 
 the information from /usr/src/Makefile, and even read over various 
 materials associated with my project.  I even went as far, as to read 
 over Greg's methods and information... and talked with a few developers 
 on the issue.
 
 
 >  
 >  - First, upgrade to the latest 2.2.8-STABLE.
 >  - Do the upgrade to 3.0 using the a.out -> elf migration path and
 >    looking at the mailing list archives.
 >  - Upgrade to the latest 3.x-STABLE (which is something like 3.5.1-STABLE
 >    now)
 >  - Upgrade to 4.0 or 4.1 perhaps.
 >  - Upgrade to the latest 4.x-STABLE.
 >  
 >  Yes, it is quite difficult, simply reinstalling from CD or FTP is
 >  probably easier. Merging /etc would be very difficult too. Not to
 >  mention /dev and the fact that you have to recompile many software
 >  packages from third-party source.
 
 
 During the upgrade process of the SOFTWARE, a few ports still used the 
 a.out method, this was during a time that the a.out > ELF transision was 
 in progress.  Now that FreeBSD is ELF, and the ports have been cleaned 
 up, I see no reason for all this trouble when *I* had none
 
 
 >  
 >  The gist: Although cutting corners might work once or twice, the source
 >  upgrade path is actually only for those who are quite good at what they
 >  do and even then you should follow the guidelines.
 >  
 >  The text also has stylistic and spelling errors/typos.
 
 
 Maybe aspell didn't do its job as well as I thought it would, I have 
 been meaning to add information on libraries and other things, maybe 
 i'll take another look at it, if your correct on that notion, then its 
 an admitted mistake...
 
 
 >  
 >  Please, before answering, look over the existing documentation set (incl
 >  Handbook, FAQ, etc) and say what information this article has that is
 >  not in one of the existing docs already. If you find any of them lacking
 >  please consider submitting patches there, first.
 
 
 Umm, the Handbook is where I obtained most of my refs, and I will agree 
 that the handbook lacks upgrading information, but it is one of the 
 things on my to do list.  Unfortunatly, like many, I also lack many free 
 hours that could be put to better use.
 
 
 >  
 
 
 In either case, thanks for at least taking a look over the document in 
 the first place, at least I know someone read over it ;)  For more refs 
 of where I got my information I suggest "The Complete FreeBSD" by Greg 
 Lehey.  The various written information in the source, the FreeBSD 
 Handbook, and the various system man pages.  Thanks alot!!
 
 
 
 -- 
 Tom (Darklogik) Rhodes
 www.Pittgoth.com Gothic Liberation Front
 www.FreeBSD.org  The Power To Serve
 

From: Szilveszter Adam <sziszi@bsd.hu>
To: FreeBSD-gnats-submit@FreeBSD.org
Cc:  
Subject: Re: docs/34038
Date: Tue, 5 Feb 2002 23:40:05 +0100

 Hello,
 
 On Tue, Feb 05, 2002 at 05:10:37PM -0500, Tom Rhodes wrote:
 > I am going to defend the hours of work I did on this document...
 
 Understandable:-)
 
 > Okie, may I do this though?  I hope as the author my reasons will be as 
 > worthwhile has his!
 
 Sure! I read your mail with great interest!
 
 > http://www.FreeBSD.org/docproj
 > 
 > and I wish to point out Nik Clayton's document suggestion method: tar, 
 > gzip, uuencode.  For more information about submitting documentation for 
 > the Docproj, please see the docproj webpage about submitting 
 > documentation located at:
 > http://www.freebsd.org/docproj/submitting.html
 > I know thats kinda cut short, but in essance sums up the uuencode and 
 > the gzip.  Many people have submitted uuencoded zipped files and have 
 > had ABSOLUTLY no problems.
 
 OK I take it back then. (Sigh) I still think that tar-ing a single file
 is overkill, simply uuencoding it would have even preserved the indent,
 but since it is not a patch, even that is not that important. I was just
 thinking along the line: Make it easy for me to deal with it without
 going over a lot of steps to decode it first. But if it is in the docs,
 I shall shut up:-)
 
 > From the mergemaster(8) man page, under DESCRIPTION, and an exact quote:
 > "mergemaster is a Bourne shell script which is designed to aid you in 
 > updating the various configuration and other files associated with FreeBSD."
 > 
 > If in some point and time, bash and Bourne again somehow demerged, I 
 > think that many universities, companies, oganizations, and other 
 > entities are very miss informed...
 
 <...>
 
 > See my above statement... I'm almost positive that mergemaster(8) is in 
 > the base system.
 
 Well, this seems like a case of "miss informed" (sic!) statement then. The
 Bourne shell is not bash. Bash is the Bourne *Again* Shell. The confusion
 is even made bigger by the fact that many Linux distros simply symlink
 sh to bash. But our /bin/sh is not bash, I can tell you.
 
 > From the handbook: CTM uses a push method, cvsup uses a pull method, so 
 > its obvious that CTM is more friendly on the server bandwidth...
 
 You are correct but I do not talk about the server side. When you
 upgrade your system, you are just using the server. I was talking about
 the client side, as I assume you were too in the article.
 
 > I actually tested this on a 2.2.5 cd that came with an older version of 
 > "The Complete FreeBSD" written by core member Greg Lehey, took some of 
 > the information from /usr/src/Makefile, and even read over various 
 > materials associated with my project.  I even went as far, as to read 
 > over Greg's methods and information... and talked with a few developers 
 > on the issue.
 
 Well if you did test this then I apologise. I still think that it is not
 the "supported" method though, there were times when you could not
 upgrade even from 3.4 to say 4.2 via "make world" without first going
 through 3.x->3.5.1-STABLE->4.0->4.2. It was discussed several times on
 the mailing lists that if it works otherwise OK but if you have
 problems, always try this way before complaining. I think docs should be
 "safe" and document only the supported methods.
 
 > Umm, the Handbook is where I obtained most of my refs, and I will agree 
 > that the handbook lacks upgrading information, but it is one of the 
 > things on my to do list.  Unfortunatly, like many, I also lack many free 
 > hours that could be put to better use.
 
 I think we have a misunderstanding here. I think that the Handbook very
 much has info on upgrading, although it probably could be improved. But
 this article does not add much to what is already in the Handbook. If
 you read the various chapters on installation, on obtaining FreeBSD, on
 staying up to date with FreeBSD under "The Cutting Edge", and on using make
 world in the same chapter, you will see that almost all is there
 already, including stuff you did not describe like CTM, only the "make
 upgrade" part is missing. Of course it is nice that you have it now in
 one article instead of all over the Handbook, but it is still IMHO
 duplication. That is why it is IMHO better idea to just patch the
 existing Handbook... also, as I said, some people may prefer shorter
 tutorials instead of the Handbook but that is a different story.
 
 -- 
 Regards:
 
 Szilveszter ADAM
 Szombathely Hungary

From: Tom Rhodes <darklogik@pittgoth.com>
To: Szilveszter Adam <sziszi@bsd.hu>,
	FreeBSD-gnats-submit@FreeBSD.org
Cc:  
Subject: Re: docs/34038
Date: Tue, 05 Feb 2002 18:08:48 -0500

 Szilveszter Adam wrote:
 
 > The following reply was made to PR docs/34038; it has been noted by GNATS.
 > 
 > From: Szilveszter Adam <sziszi@bsd.hu>
 > To: FreeBSD-gnats-submit@FreeBSD.org
 > Cc:  
 > Subject: Re: docs/34038
 > Date: Tue, 5 Feb 2002 23:40:05 +0100
 > 
 >  Hello,
 >  
 >  On Tue, Feb 05, 2002 at 05:10:37PM -0500, Tom Rhodes wrote:
 >  > I am going to defend the hours of work I did on this document...
 >  
 >  Understandable:-)
 >  
 >  > Okie, may I do this though?  I hope as the author my reasons will be as 
 >  > worthwhile has his!
 >  
 >  Sure! I read your mail with great interest!
 >  
 >  > http://www.FreeBSD.org/docproj
 >  > 
 >  > and I wish to point out Nik Clayton's document suggestion method: tar, 
 >  > gzip, uuencode.  For more information about submitting documentation for 
 >  > the Docproj, please see the docproj webpage about submitting 
 >  > documentation located at:
 >  > http://www.freebsd.org/docproj/submitting.html
 >  > I know thats kinda cut short, but in essance sums up the uuencode and 
 >  > the gzip.  Many people have submitted uuencoded zipped files and have 
 >  > had ABSOLUTLY no problems.
 >  
 >  OK I take it back then. (Sigh) I still think that tar-ing a single file
 >  is overkill, simply uuencoding it would have even preserved the indent,
 >  but since it is not a patch, even that is not that important. I was just
 >  thinking along the line: Make it easy for me to deal with it without
 >  going over a lot of steps to decode it first. But if it is in the docs,
 >  I shall shut up:-)
 
 
 Perhaps would have been easier, but I felt it may have been more 
 approprate ;)
 
 
 >  
 >  > From the mergemaster(8) man page, under DESCRIPTION, and an exact quote:
 >  > "mergemaster is a Bourne shell script which is designed to aid you in 
 >  > updating the various configuration and other files associated with FreeBSD."
 >  > 
 >  > If in some point and time, bash and Bourne again somehow demerged, I 
 >  > think that many universities, companies, oganizations, and other 
 >  > entities are very miss informed...
 >  
 >  <...>
 >  
 >  > See my above statement... I'm almost positive that mergemaster(8) is in 
 >  > the base system.
 >  
 >  Well, this seems like a case of "miss informed" (sic!) statement then. The
 >  Bourne shell is not bash. Bash is the Bourne *Again* Shell. The confusion
 >  is even made bigger by the fact that many Linux distros simply symlink
 >  sh to bash. But our /bin/sh is not bash, I can tell you.
 
 
 Then we should s/bash/Bourne/ as it is listed as a "Bourne shell script" 
 in the manual page.  So changing it to Bourne is not a hassle, the main 
 point I think is that its still a shell script lol, and I didn't want to 
 frighten anyone with "oh no, large merging program/process"  :)
 
 
 >  
 >  > From the handbook: CTM uses a push method, cvsup uses a pull method, so 
 >  > its obvious that CTM is more friendly on the server bandwidth...
 >  
 >  You are correct but I do not talk about the server side. When you
 >  upgrade your system, you are just using the server. I was talking about
 >  the client side, as I assume you were too in the article.
 
 
 I tried to cover "both" lol
 
 
 >  
 >  > I actually tested this on a 2.2.5 cd that came with an older version of 
 >  > "The Complete FreeBSD" written by core member Greg Lehey, took some of 
 >  > the information from /usr/src/Makefile, and even read over various 
 >  > materials associated with my project.  I even went as far, as to read 
 >  > over Greg's methods and information... and talked with a few developers 
 >  > on the issue.
 >  
 >  Well if you did test this then I apologise. I still think that it is not
 >  the "supported" method though, there were times when you could not
 >  upgrade even from 3.4 to say 4.2 via "make world" without first going
 >  through 3.x->3.5.1-STABLE->4.0->4.2. It was discussed several times on
 >  the mailing lists that if it works otherwise OK but if you have
 >  problems, always try this way before complaining. I think docs should be
 >  "safe" and document only the supported methods.
 
 
 Could go into the "if it fails" method ;)
 
 
 >  
 >  > Umm, the Handbook is where I obtained most of my refs, and I will agree 
 >  > that the handbook lacks upgrading information, but it is one of the 
 >  > things on my to do list.  Unfortunatly, like many, I also lack many free 
 >  > hours that could be put to better use.
 >  
 >  I think we have a misunderstanding here. I think that the Handbook very
 >  much has info on upgrading, although it probably could be improved. But
 >  this article does not add much to what is already in the Handbook. If
 >  you read the various chapters on installation, on obtaining FreeBSD, on
 >  staying up to date with FreeBSD under "The Cutting Edge", and on using make
 >  world in the same chapter, you will see that almost all is there
 >  already, including stuff you did not describe like CTM, only the "make
 >  upgrade" part is missing. Of course it is nice that you have it now in
 >  one article instead of all over the Handbook, but it is still IMHO
 >  duplication. That is why it is IMHO better idea to just patch the
 >  existing Handbook... also, as I said, some people may prefer shorter
 >  tutorials instead of the Handbook but that is a different story.
 
 
 Truely, but scattered about, and in no way a real "step by step" 
 walkthrough, and it does not cover what to do in an a.out situation.  It 
 is also a listed project on the docproj webpage, my attempt was to clean 
 up the current projects.  Also, I never covered CTM as we need the 
 entire source, when I FTP to the CTM directory, the readme tells me that 
 its no longer supported.  Emailing the developer (Kemp) got me a reply 
 very similar.  Large attempts were made NOT to duplicate information, 
 even to the point of taking a few things deeper than I figured required. 
   Since I wrote this though, I have submitted chunchs of information 
 about cvsup and other upgrade parts to the handbook, which I think has 
 maybe helped that along.
 
 
 Enjoy,
 
 
 -- 
 Tom (Darklogik) Rhodes
 www.Pittgoth.com Gothic Liberation Front
 www.FreeBSD.org  The Power To Serve
 

From: Hiten Pandya <hitmaster2k@yahoo.com>
To: freebsd-gnats-submit@FreeBSD.org
Cc: darklogik@pittgoth.com, sziszi@bsd.hu
Subject: Re: docs/34038
Date: Tue, 5 Feb 2002 15:16:55 -0800 (PST)

 --- Szilveszter Adam <sziszi@bsd.hu> wrote:
 >  I think we have a misunderstanding here. I think that the Handbook very
 >  much has info on upgrading, although it probably could be improved. But
 >  this article does not add much to what is already in the Handbook. If
 >  you read the various chapters on installation, on obtaining FreeBSD, on
 >  staying up to date with FreeBSD under "The Cutting Edge", and on using
 > make
  
 > That is why it is IMHO better idea to just patch the existing Handbook...
  
 I don't mean to be against what you say Szilveszter, but I think it would
 be nice to have this as a different article, and it would also be nice to
 patch the relevant sections in the Handbook as well. :)
  
 The other thing is , that, It wouldn't be a good example, to reject this
 article just because it is a duplication, and also, it would serve as a bad
 example for future developers, and -doc writers for FreeBSD; This is how I
 see it ;)
  
 regards,
  --Hiten
  --<hiten@uk.FreeBSD.org>
 
 __________________________________________________
 Do You Yahoo!?
 Send FREE Valentine eCards with Yahoo! Greetings!
 http://greetings.yahoo.com

From: Tom Rhodes <darklogik@pittgoth.com>
To: FreeBSD-gnats-submit@FreeBSD.org
Cc: aftershocks <aftershocks@pittgoth.com>
Subject: Re: docs/34038: [NEW ARTICLE] Upgrading a.out to Elf
Date: Mon, 11 Mar 2002 11:07:02 -0500

 Currently, I am re-evaluating my article.  I've added another 2 
 sections, reworded a few parts, and fixed some grammer.  I will be 
 reviewing the entire printed article where I will fix grammer and try to 
 make some points a bit more clear.  Afterwords, I will put the document 
 into the hands of a less-knowledgeable FreeBSD user who will point out 
 parts that he/she did not understand or is unclear about.
 
 If anyone out there cares, or has reviewed my current work, and would 
 like to make a comment please do so now.  One of the larger aspects is 
 the ``getting FreeBSD'' areas, where I tried to walk users through the 
 use of CVS, CVSup, and other methods.  Some people think this should be 
 scrapped as the handbook describes it, others think that it would be a 
 hassle to read parts of the handbook and jump between article and 
 handbook...
 
 I do not understand how either method would be applicable as a problem, 
 maybe this decision should be left to my ``reviewer'' however, there is 
 a place and an ear for every comment availible.
 
 Thanks to everyone for their time, as I know its a lacking aspect, and 
 we all need more... ;)
 
 -- 
 Tom (Darklogik) Rhodes
 www.Pittgoth.com Gothic Liberation Front
 www.FreeBSD.org  The Power To Serve
 
Responsible-Changed-From-To: freebsd-doc->trhodes 
Responsible-Changed-By: trhodes 
Responsible-Changed-When: Wed Mar 27 20:14:05 PST 2002 
Responsible-Changed-Why:  


http://www.freebsd.org/cgi/query-pr.cgi?pr=34038 
State-Changed-From-To: open->closed 
State-Changed-By: trhodes 
State-Changed-When: Tue Jul 2 13:11:41 PDT 2002 
State-Changed-Why:  
A chat with Nik has closed this PR.  The article is unrequired 

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