Bug 57824

Summary: ed(4) man page does not mention that ed requires miibus
Product: Documentation Reporter: Eugene Grosbein <ports>
Component: Books & ArticlesAssignee: freebsd-doc (Nobody) <doc>
Status: Closed FIXED    
Severity: Affects Only Me CC: iedowse
Priority: Normal    
Version: Latest   
Hardware: Any   
OS: Any   

Description Eugene Grosbein 2003-10-10 03:40:21 UTC
	device ed requires device miisbus since 4.4-STABLE.
	ed(4) man page does not document this dependency still.
	Ian Dowse said once this is fixed in CURRENT.

Fix: 

Perform MFC, it's time.
How-To-Repeat: 	man 4 ed
Comment 1 Tom Rhodes freebsd_committer freebsd_triage 2003-10-10 16:02:58 UTC
On Fri, 10 Oct 2003 10:34:03 +0800 (KRAST)
Eugene Grosbein <eugen@www.svzserv.kemerovo.su> wrote:

> 
> >Number:         57824
> >Category:       docs
> >Synopsis:       ed(4) man page does not mention that ed requires miibus

NAME
     ed -- ethernet device driver

SYNOPSIS
     device miibus
     device ed0 at isa? port 0x280 irq 5 iomem 0xd8000

That is in my STABLE tree.

NAME
     ed -- ethernet device driver

SYNOPSIS
     device miibus
     device ed

That is on my current box.

Which branch did you want the MFC to?

-- 
Tom Rhodes
Comment 2 Maxim Konovalov 2003-10-10 16:27:11 UTC
On Fri, 10 Oct 2003, 08:10-0700, Tom Rhodes wrote:

> The following reply was made to PR docs/57824; it has been noted by GNATS.
>
> From: Tom Rhodes <trhodes@FreeBSD.org>
> To: Eugene Grosbein <eugen@www.svzserv.kemerovo.su>
> Cc: FreeBSD-gnats-submit@FreeBSD.org, iedowse@FreeBSD.org
> Subject: Re: docs/57824: ed(4) man page does not mention that ed requires
>  miibus
> Date: Fri, 10 Oct 2003 11:02:58 -0400
>
>  On Fri, 10 Oct 2003 10:34:03 +0800 (KRAST)
>  Eugene Grosbein <eugen@www.svzserv.kemerovo.su> wrote:
>
>  >
>  > >Number:         57824
>  > >Category:       docs
>  > >Synopsis:       ed(4) man page does not mention that ed requires miibus
>
>  NAME
>       ed -- ethernet device driver
>
>  SYNOPSIS
>       device miibus
>       device ed0 at isa? port 0x280 irq 5 iomem 0xd8000
>
>  That is in my STABLE tree.
>
>  NAME
>       ed -- ethernet device driver
>
>  SYNOPSIS
>       device miibus
>       device ed
>
>  That is on my current box.
>
>  Which branch did you want the MFC to?

From docs/57824:

>Release:        FreeBSD 4.8-STABLE i386

-- 
Maxim Konovalov, maxim@macomnet.ru, maxim@FreeBSD.org
Comment 3 Tom Rhodes freebsd_committer freebsd_triage 2003-10-10 16:57:02 UTC
On Fri, 10 Oct 2003 08:30:21 -0700 (PDT)
Maxim Konovalov <maxim@macomnet.ru> wrote:

> The following reply was made to PR docs/57824; it has been noted by GNATS.
> 
> From: Maxim Konovalov <maxim@macomnet.ru>
> To: Tom Rhodes <trhodes@freebsd.org>
> Cc: bug-followup@freebsd.org
> Subject: Re: docs/57824: ed(4) man page does not mention that ed requires
>  miibus
> Date: Fri, 10 Oct 2003 19:27:11 +0400 (MSD)
> 
>  On Fri, 10 Oct 2003, 08:10-0700, Tom Rhodes wrote:
>  
>  > The following reply was made to PR docs/57824; it has been noted by GNATS.
>  >
>  > From: Tom Rhodes <trhodes@FreeBSD.org>
>  > To: Eugene Grosbein <eugen@www.svzserv.kemerovo.su>
>  > Cc: FreeBSD-gnats-submit@FreeBSD.org, iedowse@FreeBSD.org
>  > Subject: Re: docs/57824: ed(4) man page does not mention that ed requires
>  >  miibus
>  > Date: Fri, 10 Oct 2003 11:02:58 -0400
>  >
>  >  On Fri, 10 Oct 2003 10:34:03 +0800 (KRAST)
>  >  Eugene Grosbein <eugen@www.svzserv.kemerovo.su> wrote:
>  >
>  >  >
>  >  > >Number:         57824
>  >  > >Category:       docs
>  >  > >Synopsis:       ed(4) man page does not mention that ed requires miibus
>  >
>  >  NAME
>  >       ed -- ethernet device driver
>  >
>  >  SYNOPSIS
>  >       device miibus
>  >       device ed0 at isa? port 0x280 irq 5 iomem 0xd8000
>  >
>  >  That is in my STABLE tree.
>  >
>  >  NAME
>  >       ed -- ethernet device driver
>  >
>  >  SYNOPSIS
>  >       device miibus
>  >       device ed
>  >
>  >  That is on my current box.
>  >
>  >  Which branch did you want the MFC to?
>  
>  From docs/57824:
>  
>  >Release:        FreeBSD 4.8-STABLE i386

It's fixed for the next release; is it normal to MFC something
this trivial to a past release branch?  The GENERIC config file
explains what devices require miibus(4).  So does the handbook,
and the LINT file.

-- 
Tom Rhodes
Comment 4 Maxim Konovalov 2003-10-10 17:00:51 UTC
[...]
> >  >Release:        FreeBSD 4.8-STABLE i386
>
> It's fixed for the next release; is it normal to MFC something
> this trivial to a past release branch?  The GENERIC config file
> explains what devices require miibus(4).  So does the handbook,
> and the LINT file.

I am pretty sure we can wait until after 4.9.

-- 
Maxim Konovalov, maxim@macomnet.ru, maxim@FreeBSD.org
Comment 5 Peter Pentchev 2003-10-10 17:20:29 UTC
On Fri, Oct 10, 2003 at 08:00:51PM +0400, Maxim Konovalov wrote:
> [...]
> > >  >Release:        FreeBSD 4.8-STABLE i386
> >
> > It's fixed for the next release; is it normal to MFC something
> > this trivial to a past release branch?  The GENERIC config file
> > explains what devices require miibus(4).  So does the handbook,
> > and the LINT file.
> 
> I am pretty sure we can wait until after 4.9.

Erm... What do you mean, 'wait'?  What Tom is saying is that
the branch currently referred to as -STABLE, which *is* what was
formerly known as 4.8-STABLE, but is right now called 4.9-RC due
to the pending 4.9-RELEASE -- well, that branch already documents
that ed needs miibus.  I can also confirm that: my ed(4) manpage
shows 'device miibus' in the synopsis section.

This was already MFC'd in ed.4 rev. 1.19.2.10 from February 17th,
committed by - surprise, surprise - Tom Rhodes :)

G'luck,
Peter

-- 
Peter Pentchev	roam@ringlet.net    roam@sbnd.net    roam@FreeBSD.org
PGP key:	http://people.FreeBSD.org/~roam/roam.key.asc
Key fingerprint	FDBA FD79 C26F 3C51 C95E  DF9E ED18 B68D 1619 4553
If this sentence were in Chinese, it would say something else.
Comment 6 Tom Rhodes freebsd_committer freebsd_triage 2003-10-10 18:03:31 UTC
On Fri, 10 Oct 2003 19:20:29 +0300
Peter Pentchev <roam@ringlet.net> wrote:

> On Fri, Oct 10, 2003 at 08:00:51PM +0400, Maxim Konovalov wrote:
> > [...]
> > > >  >Release:        FreeBSD 4.8-STABLE i386
> > >
> > > It's fixed for the next release; is it normal to MFC something
> > > this trivial to a past release branch?  The GENERIC config file
> > > explains what devices require miibus(4).  So does the handbook,
> > > and the LINT file.
> > 
> > I am pretty sure we can wait until after 4.9.
> 
> Erm... What do you mean, 'wait'?  What Tom is saying is that
> the branch currently referred to as -STABLE, which *is* what was
> formerly known as 4.8-STABLE, but is right now called 4.9-RC due
> to the pending 4.9-RELEASE -- well, that branch already documents
> that ed needs miibus.  I can also confirm that: my ed(4) manpage
> shows 'device miibus' in the synopsis section.
> 
> This was already MFC'd in ed.4 rev. 1.19.2.10 from February 17th,
> committed by - surprise, surprise - Tom Rhodes :)

I've done so much -doc that I completely forgot that I did this!

Thanks for pointing this out, I think this PR can be closed now.  What
does our submitter say?

-- 
Tom Rhodes
Comment 7 Maxim Konovalov 2003-10-10 18:28:51 UTC
[...]
>  > I am pretty sure we can wait until after 4.9.
>
>  Erm... What do you mean, 'wait'?  What Tom is saying is that
>  the branch currently referred to as -STABLE, which *is* what was
>  formerly known as 4.8-STABLE, but is right now called 4.9-RC due
>  to the pending 4.9-RELEASE -- well, that branch already documents
>  that ed needs miibus.  I can also confirm that: my ed(4) manpage
>  shows 'device miibus' in the synopsis section.
>
>  This was already MFC'd in ed.4 rev. 1.19.2.10 from February 17th,
>  committed by - surprise, surprise - Tom Rhodes :)

You are quite right :-)

-- 
Maxim Konovalov, maxim@macomnet.ru, maxim@FreeBSD.org
Comment 8 Eugene Grosbein 2003-10-13 05:17:12 UTC
Tom Rhodes wrote:
> 
> On Fri, 10 Oct 2003 10:34:03 +0800 (KRAST)
> Eugene Grosbein <eugen@www.svzserv.kemerovo.su> wrote:
> 
> >
> > >Number:         57824
> > >Category:       docs
> > >Synopsis:       ed(4) man page does not mention that ed requires miibus
> 
> NAME
>      ed -- ethernet device driver
> 
> SYNOPSIS
>      device miibus
>      device ed0 at isa? port 0x280 irq 5 iomem 0xd8000
> 
> That is in my STABLE tree.

I'm sorry, my 'man 4 ed' shows me /usr/share/man/cat4/ed.4.gz
that is staled since 2001. Please close this PR.

Eugene Grosbein
Comment 9 Peter Pentchev freebsd_committer freebsd_triage 2003-10-13 08:15:57 UTC
State Changed
From-To: open->closed

Submitter agrees that the change has already been MFC'd :) 
Still, thanks for reporting what you thought was a genuine FreeBSD problem!