PERFORCE change 125385 for review

[Constantine A. Murenin]

http://perforce.freebsd.org/chv.cgi?CH=125385

Change 125385 by cnst at dale on 2007/08/20 03:50:39

	add a caveats section documenting sensor_task differences
	
	in OpenBSD 4.2, sensor_task was converted to use use OpenBSD's
	workq_add_task(9), which is not available on FreeBSD.
	
	In cnst-sensors, I have so far ported the older version of sensor_task 
	as all of the necessary functions that it uses are here on FreeBSD. 
	
	It is questionable whether sensor_task in soc2007/cnst-sensors should be 
	compatible with 4.2, because it will involve additional code that is, at 
	this point, noone except for me is testing.  So for now, I think it is a 
	much wiser choice to stick with sensor_task that is compatible with 4.1, 
	and then when I'll have some testers, write an entirely new sensor_task 
	if that will be deemed necessary.  P.S. Converting the drivers from old 
	sensor_task to new sensor_task (and back) is as easy as 123. :)
	
	In any case, any help or hints with sensor_task is appreciated. The 
	current implementation for FreeBSD is long as available in the p4 
	repository, in soc2007/cnst-sensors/sys.kern/kern_sensors.c.

Affected files ...

.. //depot/projects/soc2007/cnst-sensors/share.man.man9/sensor_attach.9#2 edit

Differences ...

==== //depot/projects/soc2007/cnst-sensors/share.man.man9/sensor_attach.9#2 (text+ko) ====

@@ -1,4 +1,4 @@
-.\"	$P4: //depot/projects/soc2007/cnst-sensors/share.man.man9/sensor_attach.9#1 $
+.\"	$P4: //depot/projects/soc2007/cnst-sensors/share.man.man9/sensor_attach.9#2 $
 .\"	$FreeBSD$
 .\"	$OpenBSD: sensor_attach.9,v 1.4 2007/03/22 16:55:31 deraadt Exp $
 .\"
@@ -126,3 +126,22 @@
 by
 .An Constantine A. Murenin
 as a Google Summer of Code 2007 project.
+.Sh CAVEATS
+The
+.Fn sensor_task_register
+and
+.Fn sensor_task_unregister
+functions that are included in
+.Ox 4.2
+and later
+are not compatible with
+.Fx .
+.Fx
+includes an implementation that is similar and compatible
+with an earlier version of
+these
+.Va sensor_task
+functions that was available from
+.Ox 3.9
+until
+.Ox 4.1 .