2c2
< # Copyright (c) 1998,2004 Doug Rabson
---
> # Copyright (c) 1998-2004 Doug Rabson
26c26
< # $FreeBSD: head/sys/kern/device_if.m 131988 2004-07-11 16:17:42Z dfr $
---
> # $FreeBSD: head/sys/kern/device_if.m 133588 2004-08-12 17:26:22Z imp $
138c138
< * @brief Called by a parent device to allow drivers to add new devices to the parent.
---
> * @brief Allow a device driver to detect devices not otherwise enumerated.
140,144c140,145
< * The DEVICE_IDENTIFY() method is used by some drivers (e.g. the ISA bus driver)
< * to help populate the bus device with a useful set of child devices, normally by
< * calling the BUS_ADD_CHILD() method of the parent device. For instance,
< * the ISA bus driver uses several special drivers, including the isahint driver and
< * the pnp driver to create child devices based on configuration hints and PnP bus
---
> * The DEVICE_IDENTIFY() method is used by some drivers (e.g. the ISA
> * bus driver) to help populate the bus device with a useful set of
> * child devices, normally by calling the BUS_ADD_CHILD() method of
> * the parent device. For instance, the ISA bus driver uses several
> * special drivers, including the isahint driver and the pnp driver to
> * create child devices based on configuration hints and PnP bus
147,149c148,150
< * Many bus drivers which support true plug-and-play do not need to use this method
< * at all since child devices can be discovered automatically without help from
< * child drivers.
---
> * Many bus drivers which support true plug-and-play do not need to
> * use this method at all since child devices can be discovered
> * automatically without help from child drivers.
238,239c239,241
< * @brief This is called by the power-management subsystem when a suspend has been
< * requested by the user or by some automatic mechanism.
---
> * @brief This is called by the power-management subsystem when a
> * suspend has been requested by the user or by some automatic
> * mechanism.
241,243c243,244
< * This gives
< * drivers a chance to veto the suspend or save their configuration before
< * power is removed.
---
> * This gives drivers a chance to veto the suspend or save their
> * configuration before power is removed.
245,246c246,247
< * To include this method in a device driver, use a line like this
< * in the driver's method list:
---
> * To include this method in a device driver, use a line like this in
> * the driver's method list:
255,256c256,257
< * @retval non-zero an error occurred while attempting to prepare the device
< * for suspension
---
> * @retval non-zero an error occurred while attempting to prepare the
> * device for suspension
277,278c278,279
< * @retval non-zero an error occurred while attempting to restore the device
< * from suspension
---
> * @retval non-zero an error occurred while attempting to restore the
> * device from suspension