From owner-freebsd-commit  Wed Jun 14 01:22:36 1995
Return-Path: commit-owner
Received: (from majordom@localhost)
          by freefall.cdrom.com (8.6.10/8.6.6) id BAA21206
          for commit-outgoing; Wed, 14 Jun 1995 01:22:36 -0700
Received: (from majordom@localhost)
          by freefall.cdrom.com (8.6.10/8.6.6) id BAA21148
          for cvs-sys-outgoing; Wed, 14 Jun 1995 01:21:13 -0700
Received: from gndrsh.aac.dev.com (gndrsh.aac.dev.com [198.145.92.241])
          by freefall.cdrom.com (8.6.10/8.6.6) with ESMTP id BAA21136
          ; Wed, 14 Jun 1995 01:20:59 -0700
Received: (from rgrimes@localhost) by gndrsh.aac.dev.com (8.6.11/8.6.9) id BAA00829; Wed, 14 Jun 1995 01:21:00 -0700
From: "Rodney W. Grimes" <rgrimes@gndrsh.aac.dev.com>
Message-Id: <199506140821.BAA00829@gndrsh.aac.dev.com>
Subject: Re: cvs commit: src/sys/i386/isa isa.h
To: bde@freefall.cdrom.com (Bruce Evans)
Date: Wed, 14 Jun 1995 01:20:59 -0700 (PDT)
Cc: CVS-commiters@freefall.cdrom.com, cvs-sys@freefall.cdrom.com
In-Reply-To: <199506140738.AAA18507@freefall.cdrom.com> from "Bruce Evans" at Jun 14, 95 00:38:33 am
X-Mailer: ELM [version 2.4 PL24]
MIME-Version: 1.0
Content-Type: text/plain; charset=US-ASCII
Content-Transfer-Encoding: 7bit
Content-Length: 2060      
Sender: commit-owner@FreeBSD.org
Precedence: bulk

> 
> bde         95/06/14 00:38:32
> 
>   Modified:    sys/i386/isa  isa.h
>   Log:
>   Convert to ANSI C: change #endif THING to #endif /* THING */.
>   Fix one such THING in code to match comment.
>   Sort IO_GSC* into numeric order and update comments about the gaps.
>   Sort common SCSI addresses into alphabetical order.
>   Remove bogus comments about com ports having i/o size 4.

What was the reference document for this???  I was the one who
put that comment in there, and it comes from no less than IBM
documents itself.  The fact is PS/2 class machines only have 4
addresses for COM ports, and can have a com port at 0x3fc!!

>   Uniformize whitespace.
>   Uniformize case in hex digits.
>   
>   This file is very incomplete.  In particular, it doesn't mention any
>   network cards.  This doesn't matter much for the base addresses, but
>   it means that the comments about which addresses are free are mostly
>   bogus.

That is because there is no formal documentation that states where
these things are.  IBM never has assigned a ``network interface''
address.  Even there own products are all over the place.

>   The i/o sizes are unreliable because of split address ranges
>   for many devices (VGA, wd).

VGA???  Maybe if you consider the fact that the ``syscons'' driver
should be split so that we don't have both the VGA ports and the
Keyboard ports all in one driver (along with a ton of architecual
reasons to split this out).

>   The i/o sizes are incomplete.  In
>   particular, there are no sizes for SCSI controllers.  The bt driver
>   still returns a truth value instead of a size.

:-(.

Pretty much I created the current content of that file from official
IBM documentation for the XT, AT, and PS/2 family.

The SCSI card I/O addresses where added to make the GENERIC config
file consistent.  I did not have size docs for those cards when I
created it.  I do now though.

-- 
Rod Grimes                                      rgrimes@gndrsh.aac.dev.com
Accurate Automation Company                   Custom computers for FreeBSD