d/freebsd-skq
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Minor formatting fixes for lines > 80 characters

Browse Source
This commit is contained in:
imp 2004-08-12 17:26:22 +00:00
parent 09c41336ae
commit 482740a238
2 changed files with 30 additions and 28 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

15
sys/kern/bus_if.m
View File

@ -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

43
sys/kern/device_if.m
View File

@ -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()
*/