frederik
/
xserver
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: purge some ISA references 

The respective ISA functions were dropped back in 2008

Reviewed-by: Adam Jackson <ajax@redhat.com>
Signed-off-by: Emil Velikov <emil.velikov@collabora.com>
This commit is contained in:
Emil Velikov 2018-04-02 18:51:20 +01:00 committed by Adam Jackson
parent 80d4098411
commit 32c07e6b83
1 changed files with 2 additions and 87 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

89
hw/xfree86/doc/ddxDesign.xml
View File

@ -820,13 +820,11 @@ Here is what <function>InitOutput()</function> does:
like probing for other details such as the amount of memory like probing for other details such as the amount of memory
installed, etc. It is recommended that the installed, etc. It is recommended that the
<function>xf86MatchPciInstances()</function> helper function be used <function>xf86MatchPciInstances()</function> helper function be used
for identifying matching PCI devices, and similarly the for identifying matching PCI devices
<function>xf86MatchIsaInstances()</function> for ISA (non-PCI) devices
(see the <link linkend="rac">RAC</link> section). These helpers also (see the <link linkend="rac">RAC</link> section). These helpers also
checks and claims the appropriate entity. When not using the checks and claims the appropriate entity. When not using the
helper, that should be done with <function>xf86CheckPciSlot()</function> helper, that should be done with <function>xf86CheckPciSlot()</function>
and <function>xf86ClaimPciSlot()</function> for PCI devices and and <function>xf86ClaimPciSlot()</function> for PCI devices (see the
<function>xf86ClaimIsaSlot()</function> for ISA devices (see the
<link linkend="rac">RAC</link> section). <link linkend="rac">RAC</link> section).
</para> </para>
@ -2491,53 +2489,6 @@ xorg.conf file to the devices:
return value of <constant>-1</constant> indicates an internal error. return value of <constant>-1</constant> indicates an internal error.
The returned <parameter>foundEntities</parameter> array should be freed The returned <parameter>foundEntities</parameter> array should be freed
by the driver with <function>xfree()</function> when it is no longer by the driver with <function>xfree()</function> when it is no longer
needed in cases where the return value is greater than zero.
</para>
</blockquote></para></blockquote>
<blockquote><para>
<programlisting>
int xf86MatchIsaInstances(const char *driverName,
SymTabPtr chipsets, IsaChipsets *ISAchipsets,
DriverPtr drvp, FindIsaDevProc FindIsaDevice,
GDevPtr *devList, int numDevs,
int **foundEntities);
</programlisting>
<blockquote><para>
This function finds matches between ISA cards that a driver supports
and config file device sections. It is intended for use in the
<function>ChipProbe()</function> function of drivers for ISA cards.
<parameter>devList</parameter> and <parameter>numDevs</parameter> are
typically those found from calling <function>xf86MatchDevice()</function>,
and represent the active config file device sections relevant to
the driver. <parameter>ISAchipsets</parameter> is a table that provides
a mapping between the driver's internal chipset tokens and the
resource classes. <parameter>FindIsaDevice</parameter> is a
driver-provided function that probes the hardware and returns the
chipset token corresponding to what was detected, and
<constant>-1</constant> if nothing was detected.
</para>
<para>
If the config file device section contains a chipset entry, then
it is checked against the <parameter>chipsets</parameter> list. When
no chipset entry is present, the <parameter>FindIsaDevice</parameter>
function is called instead.
</para>
<para>
Entity index numbers for confirmed matches are returned as an
array via <parameter>foundEntities</parameter>. The chipset token and
device section for each match are found in the
<structname>EntityInfoRec</structname> referenced by the indices.
</para>
<para>
The function return value is the number of confirmed matches. A
return value of <constant>-1</constant> indicates an internal error.
The returned <parameter>foundEntities</parameter> array should be freed
by the driver with <function>xfree()</function> when it is no longer
needed in cases where the return value is greater than zero. needed in cases where the return value is greater than zero.
</para> </para>
@ -2581,18 +2532,6 @@ available at the driver level:
</blockquote></para></blockquote> </blockquote></para></blockquote>
<blockquote><para>
<programlisting>
Bool xf86ParseIsaBusString(const char *busID);
</programlisting>
<blockquote><para>
Compares a <parameter>BusID</parameter> string with the ISA bus ID string
("ISA" or "ISA:"). If they match <constant>TRUE</constant> is returned,
and <constant>FALSE</constant> if they don't.
</para>
</blockquote></para></blockquote>
<blockquote><para> <blockquote><para>
<programlisting> <programlisting>
Bool xf86CheckPciSlot(int bus, int device, int func); Bool xf86CheckPciSlot(int bus, int device, int func);
@ -2632,30 +2571,6 @@ available at the driver level:
</blockquote></para></blockquote> </blockquote></para></blockquote>
<blockquote><para>
<programlisting>
int xf86ClaimIsaSlot(DriverPtr drvp, int chipset,
GDevPtr dev, Bool active);
</programlisting>
<blockquote><para>
This allocates an entity record entity and initialise the data
structures. The return value is the index of the newly allocated
entity record.
</para>
</blockquote></para></blockquote>
<blockquote><para>
<programlisting>
Bool xf86IsPrimaryIsa(void);
</programlisting>
<blockquote><para>
This function returns <constant>TRUE</constant> if the primary card is
an ISA (non-PCI) device, and <constant>FALSE</constant> otherwise.
</para>
</blockquote></para></blockquote>
<para> <para>
Two helper functions are provided to aid configuring entities: Two helper functions are provided to aid configuring entities:
</para> </para>