Since detect 0.9.31 a new format is being used in the isa.lst file.
The following is a procedure to add entries or update this file.


a) Preliminary:
===============

  Download the detect package and install it 
  (http://www.linux-mandrake.com/harddrake/download.html)
  After the installation procedure is completed, copy the file
  /usr/share/detect/isa.lst to your home directory. 
  Now use your favorite editor to edit the copy.


b) Structure of isa.lst:
========================

- The following is an example of an entry in the isa.lst file: ( '\t'
  expands to a tabulation )
  
  +----8<---------------------------------------------------------------
  |YMH0021\tsound\topl3sa\tYamaha\tOPL3-SAx Sound System\tHAS_OPL3
  +----8<---------------------------------------------------------------
  
- Description of the fields

  * First field: [Logical device ID]
    --------------------------------
  
    How to get it: Use the 'pnpdump' program. Usually installed in /sbin
  
    Example:
  
  +----8<---------------------------------------------------------------
  | [root@luke alex]#pnpdump | grep "Logical device id"
  |
  | # Logical device id YMH0021
  | # Logical device id YMH0022
  | # Logical device id ESS0000
  | # Logical device id ESS1868
  | # Logical device id ESS0001
  | # Logical device id ESS0002
  +----8<---------------------------------------------------------------
  
    Each 'Logical device id' maps a device present in your computer to a
    unique combination of letters and numbers, either mapping a unique
    device present in a board or a set of devices.
    For example, a single sound board usually reports several logical
    devices, like the joystick port, the mpu401 port, etc.
    Look for 'this logical device id' in the isa.lst file. If you find 
    an entry and some of their fields are set to 'unknown', please 
    udpate it.
    Else add a new entry following the format being explained in this 
    document.
    
  * Second field: [type of logical device]
    --------------------------------------
    How to get it:
    
    Detect has the following keywords based on the board type
    
    ethernet: For ethernet device network.
    ide:      For ide interface.
    joystick: For gameport and joystick.
    modem:    For modem card.
    sound:    For soundcard.
    scsi:     For scsi interface.
    
    In case you don't know or you're not sure where your board fits, use
    'unknown', or send an e-mail to adussart@mandrake.com if you think 
    a new type is needed.
    
  * Third field: [kernel module name used to drive the device]
    ----------------------------------------------------------
    If there is no module for this device, just use "ignore" as dummy
    module name
    
  * Fourth field: [vendor name]
    ---------------------------
    
  * Fifth field:  [model name of the logical device]
    ------------------------------------------------
    
  * Sixth field: [special field]
    ----------------------------
    This is a special field currently being used only by the logical
    devices belonging to sound boards to tell detect which kernel modules
    should be loaded for the particular logical device in order to make 
    it work.

    Example:
  
  +----8<---------------------------------------------------------------
  | HAS_OPL3
  | HAS_MPU401
  | HAS_DMA16
  | HAS_AWE
  | HAS_DREAM
  | HAS_MAD16
  | HAS_TRIX
  | HAS_PAS2
  | HAS_SMGAMES
  | HAS_JOYSTICK
  +----8<---------------------------------------------------------------
  
  
c) Adding a new line:
=====================
  
  Use the format described above to create a line for each logical 
  device and put them in the isa.lst file, in ascending alphabetical 
  order.


d) Updating a line:
===================

  You'll notice that the current isa.lst file has many entries with one 
  or more fields set to 'unknown'. 

  I hope this situation will be solved as soon as possible with the help
  of the community.

