diff --git a/doc/developers/proc b/doc/developers/proc
index ddde205e..9786c1c2 100644
--- a/doc/developers/proc
+++ b/doc/developers/proc
@@ -48,6 +48,9 @@ alarms	  1	Alarm bitmask.
 		Read only.
 		Integer representation of one, two, or three bytes.
 		A '1' bit means an alarm.
+		Chips should be programmed for 'comparator' mode so that
+		the alarm will 'come back' after you read the register
+		if it is still valid.
 		Generally a direct representation of a chip's internal
 		alarm registers; there is no standard for the position
 		of individual bits.
@@ -91,9 +94,10 @@ in[0-8]   3	Voltage min, max, and input value.
 			in7	varies
 			in8	varies
 
-pwm[1-3]   1	Pulse width modulation fan control.
+pwm[1-3]  1- 2	Pulse width modulation fan control.
 		Integer 0 - 255, read/write.
 		Corresponds to the fans 1-3.
+		Second value, if present, is an enable (0 or 1)
 
 sensor[1-3]  1	Sensor type selection.
 		Integers 1,2,3, or thermistor Beta value (3435); read/write.
@@ -104,7 +108,7 @@ temp[1-3]  3	Temperature max, min or hysteresis, and input value.
 		'temp' is used if there is only one temperature sensor on the
 		chip. Temp1 is generally the sensor inside the chip itself,
 		generally reported as "motherboard temperature".
-		temp2 and temp3 are generally external sensors, 
+		Temp2 and temp3 are generally external sensors, 
 		the thermal diode inside the CPU, generally reported as
 		"CPU temperature".
 
@@ -113,7 +117,7 @@ vid	   1	CPU core voltage.
 		Floating point X.XX or X.XXX corresponding to CPU core voltage
 		as told to the sensor chip. Not always correct.
 
-vrm        1   Voltage Regulator Module version number. 
-               "Floating point" X.X. Default 8.2.
+vrm        1	Voltage Regulator Module version number. 
+		"Floating point" X.X. Default 8.2.
 		Affects the way the driver calculates the core voltage from
 		the vid pins. See doc/vid for details.