Bug 38850

Summary: handbook/kernelopts/ should be in Developer's Handbook tree not in Handbook one
Product: Documentation Reporter: Marc Fonvieille <marc>
Component: Books & ArticlesAssignee: Giorgos Keramidas <keramida>
Status: Closed FIXED    
Severity: Affects Only Me    
Priority: Normal    
Version: Latest   
Hardware: Any   
OS: Any   

Description Marc Fonvieille 2002-06-03 09:50:01 UTC
handbook/kernelopts/ has nothing to do in Handbook tree, it should 
be in the Developer's Handbook and/or removed.
Comment 1 Giorgos Keramidas freebsd_committer freebsd_triage 2002-06-04 18:53:31 UTC
On 2002-06-03 10:39 +0200, Marc Fonvieille wrote:
> 
> handbook/kernelopts/ has nothing to do in Handbook tree, it should 
> be in the Developer's Handbook and/or removed.

I'm not really sure.  It is definitely something that is aimed towards
advanced users, and newcomers to FreeBSD might find it all confusing,
and strange, at first.  However, having a section like that to pair
the kernel compiling parts of the Handbook, is probably a good idea
too.  What do you others think?

- Giorgos
Comment 2 Marc Fonvieille 2002-06-04 19:37:20 UTC
On Tue, Jun 04, 2002 at 11:30:04AM -0700, Giorgos Keramidas wrote:
>  I'm not really sure.  It is definitely something that is aimed towards
>  advanced users, and newcomers to FreeBSD might find it all confusing,
>  and strange, at first.  However, having a section like that to pair
>  the kernel compiling parts of the Handbook, is probably a good idea
>  too.  What do you others think?
>  
But that section is not built during Handbook build (look at Makefile).
It's a remain of transfert of the Kernel Debug section to Developer's
Handbook.

Marc
Comment 3 Giorgos Keramidas freebsd_committer freebsd_triage 2002-06-05 01:17:53 UTC
On 2002-06-04 20:37 +0200, Marc Fonvieille wrote:
> On Tue, Jun 04, 2002 at 11:30:04AM -0700, Giorgos Keramidas wrote:
> >  I'm not really sure.  It is definitely something that is aimed towards
> >  advanced users, ..
>
> But that section is not built during Handbook build (look at Makefile).
> It's a remain of transfert of the Kernel Debug section to Developer's
> Handbook.

Whoopsie!  You are right.  It seems this has been removed in revision
1.41 of the Makefile.

	----------------------------
	revision 1.41
	date: 2001/08/08 19:23:55;  author: murray;  state: Exp;  lines: +1 -3
	kerneldebug/ was repo-copied to the Developer's Handbook
	The contents of staff/ was moved into a separate article.
	Update the Makefile appropriately.
	=============================================================================

handbook$ cvs -q diff -u -r1.40 -r1.41 Makefile | grep kernelopts
-SRCS+= kernelopts/chapter.sgml

Ho, hum.
Murray, should we `cvs rm' the kernelopts/ subdir of the Handbook?

Giorgos.
Comment 4 Murray Stokely freebsd_committer freebsd_triage 2002-06-05 01:21:57 UTC
Yes, please 'cvs rm' it.  Thanks!

     - Murray

On Wed, Jun 05, 2002 at 03:17:53AM +0300, Giorgos Keramidas wrote:
> On 2002-06-04 20:37 +0200, Marc Fonvieille wrote:
> > On Tue, Jun 04, 2002 at 11:30:04AM -0700, Giorgos Keramidas wrote:
> > >  I'm not really sure.  It is definitely something that is aimed towards
> > >  advanced users, ..
> >
> > But that section is not built during Handbook build (look at Makefile).
> > It's a remain of transfert of the Kernel Debug section to Developer's
> > Handbook.
> 
> Whoopsie!  You are right.  It seems this has been removed in revision
> 1.41 of the Makefile.
> 
> 	----------------------------
> 	revision 1.41
> 	date: 2001/08/08 19:23:55;  author: murray;  state: Exp;  lines: +1 -3
> 	kerneldebug/ was repo-copied to the Developer's Handbook
> 	The contents of staff/ was moved into a separate article.
> 	Update the Makefile appropriately.
> 	=============================================================================
> 
> handbook$ cvs -q diff -u -r1.40 -r1.41 Makefile | grep kernelopts
> -SRCS+= kernelopts/chapter.sgml
> 
> Ho, hum.
> Murray, should we `cvs rm' the kernelopts/ subdir of the Handbook?
> 
> Giorgos.
Comment 5 Giorgos Keramidas freebsd_committer freebsd_triage 2002-06-05 01:39:31 UTC
State Changed
From-To: open->closed

Removed from the Handbook.  I'll see what parts can be added to our 
developer's Handbook and take care of the moving. 

Grazie ;) 


Comment 6 Giorgos Keramidas freebsd_committer freebsd_triage 2002-06-05 01:39:31 UTC
Responsible Changed
From-To: freebsd-doc->keramida

Remind me to get the rest of the work done.
Comment 7 Giorgos Keramidas freebsd_committer freebsd_triage 2002-06-05 01:41:24 UTC
State Changed
From-To: closed->patched

More work needs to be done.  Don't close this just yet.
Comment 8 Siebrand Mazeland 2005-02-27 22:07:15 UTC
I guess whoever's supposed to be working on this has forgotten what still
needs to be done (last change Tue Jun 4 17:41:24 PDT 2002). Kernelopts has
been removed from the Handbook and this PR might as well be closed.

http://www.freebsd.org/cgi/query-pr.cgi?pr=docs/38850
Comment 9 Matteo Riondato freebsd_committer freebsd_triage 2005-08-16 21:18:27 UTC
State Changed
From-To: patched->closed

To me, this seems to be fixed