Minor formatting fixes for lines > 80 characters
This commit is contained in:
parent
c5f60ffccf
commit
9f7f340a0f
Notes:
svn2git
2020-12-20 02:59:44 +00:00
svn path=/head/; revision=133588
@ -1,6 +1,6 @@
|
||||
|
||||
#
|
||||
# Copyright (c) 1998,2004 Doug Rabson
|
||||
# Copyright (c) 1998-2004 Doug Rabson
|
||||
# All rights reserved.
|
||||
#
|
||||
# Redistribution and use in source and binary forms, with or without
|
||||
@ -439,12 +439,13 @@ METHOD struct resource_list * get_resource_list {
|
||||
* @brief Is the hardware described by @p _child still attached to the
|
||||
* system?
|
||||
*
|
||||
* This method should return 0 if the device is not present. It should
|
||||
* return -1 if it is present. Any errors in determining should be
|
||||
* returned as a normal errno value. Client drivers are to assume that
|
||||
* the device is present, even if there is an error determining if it is
|
||||
* there. Busses are to try to avoid returning errors, but newcard will return
|
||||
* an error if the device fails to implement this method.
|
||||
* This method should return 0 if the device is not present. It
|
||||
* should return -1 if it is present. Any errors in determining
|
||||
* should be returned as a normal errno value. Client drivers are to
|
||||
* assume that the device is present, even if there is an error
|
||||
* determining if it is there. Busses are to try to avoid returning
|
||||
* errors, but newcard will return an error if the device fails to
|
||||
* implement this method.
|
||||
*
|
||||
* @param _dev the parent device of @p _child
|
||||
* @param _child the device which is being examined
|
||||
|
@ -1,5 +1,5 @@
|
||||
#
|
||||
# Copyright (c) 1998,2004 Doug Rabson
|
||||
# Copyright (c) 1998-2004 Doug Rabson
|
||||
# All rights reserved.
|
||||
#
|
||||
# Redistribution and use in source and binary forms, with or without
|
||||
@ -135,18 +135,19 @@ METHOD int probe {
|
||||
};
|
||||
|
||||
/**
|
||||
* @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.
|
||||
*
|
||||
* 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
|
||||
* probes respectively.
|
||||
*
|
||||
* 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.
|
||||
*
|
||||
* To include this method in a device driver, use a line like this
|
||||
* in the driver's method list:
|
||||
@ -235,15 +236,15 @@ METHOD int shutdown {
|
||||
} DEFAULT null_shutdown;
|
||||
|
||||
/**
|
||||
* @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.
|
||||
*
|
||||
* 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.
|
||||
*
|
||||
* 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:
|
||||
*
|
||||
* @code
|
||||
* KOBJMETHOD(device_suspend, foo_suspend)
|
||||
@ -252,8 +253,8 @@ METHOD int shutdown {
|
||||
* @param dev the device being suspended
|
||||
*
|
||||
* @retval 0 success
|
||||
* @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
|
||||
*
|
||||
* @see DEVICE_RESUME()
|
||||
*/
|
||||
@ -274,8 +275,8 @@ METHOD int suspend {
|
||||
* @param dev the device being resumed
|
||||
*
|
||||
* @retval 0 success
|
||||
* @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
|
||||
*
|
||||
* @see DEVICE_SUSPEND()
|
||||
*/
|
||||
|
Loading…
Reference in New Issue
Block a user