linux-kernel.vger.kernel.org archive mirror
 help / color / mirror / Atom feed
* [PATCH v2 00/21] Convert hwmon documentation to ReST
@ 2019-04-10 19:22 Mauro Carvalho Chehab
  2019-04-10 19:22 ` [PATCH v2 01/21] docs: hwmon: k10temp: convert to ReST format Mauro Carvalho Chehab
                   ` (21 more replies)
  0 siblings, 22 replies; 73+ messages in thread
From: Mauro Carvalho Chehab @ 2019-04-10 19:22 UTC (permalink / raw)
  To: Linux Doc Mailing List
  Cc: Mauro Carvalho Chehab, Mauro Carvalho Chehab, linux-kernel,
	Jonathan Corbet, Andrew Jeffery, Benjamin Herrenschmidt,
	Guenter Roeck, Jean Delvare, Joel Stanley, linux-arm-kernel,
	linux-aspeed, linux-hwmon, linuxppc-dev, Liviu Dudau,
	Lorenzo Pieralisi, Michael Ellerman, Paul Mackerras,
	Sudeep Holla

[-- Warning: decoded text below may be mangled, UTF-8 assumed --]
[-- Attachment #1: Type: text/plain; charset=UTF-8, Size: 21522 bytes --]

This series converts the contents of Documentation/hwmon to ReST
format.

PS.: I opted to group the conversion files per groups of maintainer
set, as, if I were to generate one patch per file, it would give around
160 patches.

I also added those patches to my development tree at:
	https://git.linuxtv.org/mchehab/experimental.git/log/?h=hwmon

If you want to see the results, they're at:
	https://www.infradead.org/~mchehab/hwmon/

Version 2:

- Fixed broken SOB lines;
- changed submitting-patches.rst to mention that drivers should be
  documented as Documentation/hwmon/<driver_name>.rst,
  as suggested by Jonathan Neuschäfer.

Mauro Carvalho Chehab (21):
  docs: hwmon: k10temp: convert to ReST format
  docs: hwmon: vexpress: convert to ReST format
  docs: hwmon: menf21bmc: convert to ReST format
  docs: hwmon: sch5627: convert to ReST format
  docs: hwmon: emc2103: convert to ReST format
  docs: hwmon: pc87360: convert to ReST format
  docs: hwmon: fam15h_power: convert to ReST format
  docs: hwmon: w83791d: convert to ReST format
  docs: hwmon: coretemp: convert to ReST format
  docs: hwmon: aspeed-pwm-tacho: convert to ReST format
  docs: hwmon: ibmpowernv: convert to ReST format
  docs: hwmon: asc7621: convert to ReST format
  docs: hwmon: ads1015: convert to ReST format
  docs: hwmon: dme1737, vt1211: convert to ReST format
  docs: hwmon: wm831x, wm8350: convert to ReST format
  docs: hwmon: da9052, da9055: convert to ReST format
  docs: hwmon: k8temp, w83793: convert to ReST format
  docs: hwmon: pmbus files: convert to ReST format
  docs: hwmon: misc files: convert to ReST format
  docs: hwmon: convert remaining files to ReST format
  docs: hwmon: Add an index file and rename docs to *.rst

 .../devicetree/bindings/hwmon/g762.txt        |   2 +-
 Documentation/hwmon/{ab8500 => ab8500.rst}    |  10 +-
 Documentation/hwmon/abituguru                 |  92 ---
 ...guru-datasheet => abituguru-datasheet.rst} | 160 ++--
 Documentation/hwmon/abituguru.rst             | 113 +++
 .../hwmon/{abituguru3 => abituguru3.rst}      |  36 +-
 Documentation/hwmon/{abx500 => abx500.rst}    |   8 +-
 ...{acpi_power_meter => acpi_power_meter.rst} |  25 +-
 Documentation/hwmon/{ad7314 => ad7314.rst}    |   9 +
 .../hwmon/{adc128d818 => adc128d818.rst}      |   7 +-
 Documentation/hwmon/{adm1021 => adm1021.rst}  |  44 +-
 Documentation/hwmon/{adm1025 => adm1025.rst}  |  13 +-
 Documentation/hwmon/{adm1026 => adm1026.rst}  |  24 +-
 Documentation/hwmon/{adm1031 => adm1031.rst}  |  16 +-
 Documentation/hwmon/{adm1275 => adm1275.rst}  |  30 +-
 Documentation/hwmon/{adm9240 => adm9240.rst}  |  50 +-
 Documentation/hwmon/{ads1015 => ads1015.rst}  |  72 +-
 Documentation/hwmon/{ads7828 => ads7828.rst}  |  29 +-
 Documentation/hwmon/{adt7410 => adt7410.rst}  |  49 +-
 Documentation/hwmon/{adt7411 => adt7411.rst}  |  20 +-
 Documentation/hwmon/{adt7462 => adt7462.rst}  |  10 +-
 Documentation/hwmon/{adt7470 => adt7470.rst}  |   8 +-
 Documentation/hwmon/{adt7475 => adt7475.rst}  |  38 +-
 Documentation/hwmon/{amc6821 => amc6821.rst}  |  19 +-
 Documentation/hwmon/{asb100 => asb100.rst}    |  50 +-
 Documentation/hwmon/{asc7621 => asc7621.rst}  | 146 ++--
 ...{aspeed-pwm-tacho => aspeed-pwm-tacho.rst} |   2 +
 .../hwmon/{coretemp => coretemp.rst}          |  46 +-
 Documentation/hwmon/{da9052 => da9052.rst}    |  40 +-
 Documentation/hwmon/{da9055 => da9055.rst}    |  20 +-
 Documentation/hwmon/{dme1737 => dme1737.rst}  |  88 ++-
 Documentation/hwmon/{ds1621 => ds1621.rst}    | 154 ++--
 Documentation/hwmon/{ds620 => ds620.rst}      |  12 +-
 Documentation/hwmon/{emc1403 => emc1403.rst}  |  33 +-
 Documentation/hwmon/{emc2103 => emc2103.rst}  |   6 +-
 .../hwmon/{emc6w201 => emc6w201.rst}          |   5 +
 Documentation/hwmon/{f71805f => f71805f.rst}  |  36 +-
 .../hwmon/{f71882fg => f71882fg.rst}          |  56 +-
 .../hwmon/{fam15h_power => fam15h_power.rst}  |  85 ++-
 .../hwmon/{ftsteutates => ftsteutates.rst}    |  14 +-
 Documentation/hwmon/{g760a => g760a.rst}      |   4 +
 Documentation/hwmon/{g762 => g762.rst}        |  67 +-
 Documentation/hwmon/{gl518sm => gl518sm.rst}  |  21 +-
 Documentation/hwmon/{hih6130 => hih6130.rst}  |  14 +-
 ...on-kernel-api.txt => hwmon-kernel-api.rst} | 298 ++++----
 .../hwmon/{ibm-cffps => ibm-cffps.rst}        |   3 +
 Documentation/hwmon/{ibmaem => ibmaem.rst}    |  10 +-
 .../hwmon/{ibmpowernv => ibmpowernv.rst}      |   3 +
 Documentation/hwmon/{ina209 => ina209.rst}    |  18 +-
 Documentation/hwmon/{ina2xx => ina2xx.rst}    |  41 +-
 Documentation/hwmon/{ina3221 => ina3221.rst}  |  17 +-
 Documentation/hwmon/index.rst                 | 179 +++++
 Documentation/hwmon/{ir35221 => ir35221.rst}  |  12 +-
 Documentation/hwmon/{it87 => it87.rst}        | 102 ++-
 Documentation/hwmon/{jc42 => jc42.rst}        |  55 +-
 Documentation/hwmon/{k10temp => k10temp.rst}  |  37 +-
 Documentation/hwmon/{k8temp => k8temp.rst}    |  17 +-
 .../hwmon/{lineage-pem => lineage-pem.rst}    |  16 +-
 Documentation/hwmon/{lm25066 => lm25066.rst}  |  32 +-
 Documentation/hwmon/{lm63 => lm63.rst}        |  24 +-
 Documentation/hwmon/{lm70 => lm70.rst}        |  13 +-
 Documentation/hwmon/{lm73 => lm73.rst}        |  16 +-
 Documentation/hwmon/{lm75 => lm75.rst}        |  96 ++-
 Documentation/hwmon/{lm77 => lm77.rst}        |   9 +-
 Documentation/hwmon/{lm78 => lm78.rst}        |  20 +-
 Documentation/hwmon/{lm80 => lm80.rst}        |  19 +-
 Documentation/hwmon/{lm83 => lm83.rst}        |  16 +-
 Documentation/hwmon/{lm85 => lm85.rst}        |  97 ++-
 Documentation/hwmon/{lm87 => lm87.rst}        |  23 +-
 Documentation/hwmon/{lm90 => lm90.rst}        | 174 ++++-
 Documentation/hwmon/{lm92 => lm92.rst}        |  17 +-
 Documentation/hwmon/{lm93 => lm93.rst}        | 157 ++--
 Documentation/hwmon/{lm95234 => lm95234.rst}  |  11 +-
 Documentation/hwmon/{lm95245 => lm95245.rst}  |  13 +-
 Documentation/hwmon/{ltc2945 => ltc2945.rst}  |  16 +-
 Documentation/hwmon/{ltc2978 => ltc2978.rst}  | 267 +++++--
 Documentation/hwmon/{ltc2990 => ltc2990.rst}  |  23 +-
 Documentation/hwmon/{ltc3815 => ltc3815.rst}  |  12 +-
 Documentation/hwmon/{ltc4151 => ltc4151.rst}  |  16 +-
 Documentation/hwmon/{ltc4215 => ltc4215.rst}  |  16 +-
 Documentation/hwmon/{ltc4245 => ltc4245.rst}  |  17 +-
 Documentation/hwmon/{ltc4260 => ltc4260.rst}  |  16 +-
 Documentation/hwmon/{ltc4261 => ltc4261.rst}  |  16 +-
 .../hwmon/{max16064 => max16064.rst}          |  17 +-
 .../hwmon/{max16065 => max16065.rst}          |  24 +-
 Documentation/hwmon/{max1619 => max1619.rst}  |  11 +-
 Documentation/hwmon/{max1668 => max1668.rst}  |  14 +-
 Documentation/hwmon/{max197 => max197.rst}    |  36 +-
 .../hwmon/{max20751 => max20751.rst}          |   9 +-
 .../hwmon/{max31722 => max31722.rst}          |  12 +
 .../hwmon/{max31785 => max31785.rst}          |   6 +
 .../hwmon/{max31790 => max31790.rst}          |   6 +
 .../hwmon/{max34440 => max34440.rst}          |  90 ++-
 Documentation/hwmon/{max6639 => max6639.rst}  |  16 +-
 Documentation/hwmon/{max6642 => max6642.rst}  |  10 +-
 Documentation/hwmon/{max6650 => max6650.rst}  |  16 +-
 Documentation/hwmon/{max6697 => max6697.rst}  |  33 +
 Documentation/hwmon/{max8688 => max8688.rst}  |  20 +-
 .../hwmon/{mc13783-adc => mc13783-adc.rst}    |  27 +-
 Documentation/hwmon/{mcp3021 => mcp3021.rst}  |  15 +-
 .../hwmon/{menf21bmc => menf21bmc.rst}        |   5 +
 .../hwmon/{mlxreg-fan => mlxreg-fan.rst}      |  60 +-
 Documentation/hwmon/{nct6683 => nct6683.rst}  |  11 +-
 Documentation/hwmon/{nct6775 => nct6775.rst}  | 114 ++-
 Documentation/hwmon/{nct7802 => nct7802.rst}  |  11 +-
 Documentation/hwmon/{nct7904 => nct7904.rst}  |   9 +-
 .../{npcm750-pwm-fan => npcm750-pwm-fan.rst}  |   4 +
 Documentation/hwmon/{nsa320 => nsa320.rst}    |  15 +-
 .../{ntc_thermistor => ntc_thermistor.rst}    | 123 ++--
 Documentation/hwmon/{occ => occ.rst}          |  93 ++-
 Documentation/hwmon/{pc87360 => pc87360.rst}  |  38 +-
 Documentation/hwmon/{pc87427 => pc87427.rst}  |   4 +
 Documentation/hwmon/{pcf8591 => pcf8591.rst}  |  52 +-
 .../hwmon/{pmbus-core => pmbus-core.rst}      | 173 +++--
 Documentation/hwmon/{pmbus => pmbus.rst}      |  90 ++-
 .../hwmon/{powr1220 => powr1220.rst}          |  12 +-
 Documentation/hwmon/{pwm-fan => pwm-fan.rst}  |   0
 ...aspberrypi-hwmon => raspberrypi-hwmon.rst} |   3 +
 Documentation/hwmon/{sch5627 => sch5627.rst}  |   4 +
 Documentation/hwmon/{sch5636 => sch5636.rst}  |   3 +
 .../hwmon/{scpi-hwmon => scpi-hwmon.rst}      |   7 +-
 Documentation/hwmon/{sht15 => sht15.rst}      |  28 +-
 Documentation/hwmon/{sht21 => sht21.rst}      |  24 +-
 Documentation/hwmon/{sht3x => sht3x.rst}      |  42 +-
 Documentation/hwmon/{shtc1 => shtc1.rst}      |  19 +-
 Documentation/hwmon/{sis5595 => sis5595.rst}  |  40 +-
 Documentation/hwmon/{smm665 => smm665.rst}    |  42 +-
 .../hwmon/{smsc47b397 => smsc47b397.rst}      | 158 ++--
 .../hwmon/{smsc47m1 => smsc47m1.rst}          |  43 +-
 Documentation/hwmon/smsc47m192                | 103 ---
 Documentation/hwmon/smsc47m192.rst            | 116 +++
 ...mitting-patches => submitting-patches.rst} |  21 +-
 .../{sysfs-interface => sysfs-interface.rst}  | 696 ++++++++++++------
 Documentation/hwmon/{tc654 => tc654.rst}      |   9 +-
 Documentation/hwmon/{tc74 => tc74.rst}        |   3 +
 Documentation/hwmon/{thmc50 => thmc50.rst}    |  36 +-
 Documentation/hwmon/{tmp102 => tmp102.rst}    |   7 +-
 Documentation/hwmon/{tmp103 => tmp103.rst}    |   7 +-
 Documentation/hwmon/{tmp108 => tmp108.rst}    |   7 +-
 Documentation/hwmon/{tmp401 => tmp401.rst}    |  32 +-
 Documentation/hwmon/{tmp421 => tmp421.rst}    |  26 +-
 .../hwmon/{tps40422 => tps40422.rst}          |  25 +-
 ...4030-madc-hwmon => twl4030-madc-hwmon.rst} |   8 +-
 Documentation/hwmon/{ucd9000 => ucd9000.rst}  |  35 +-
 Documentation/hwmon/{ucd9200 => ucd9200.rst}  |  46 +-
 .../{userspace-tools => userspace-tools.rst}  |   3 +
 .../hwmon/{vexpress => vexpress.rst}          |  13 +-
 Documentation/hwmon/{via686a => via686a.rst}  |  30 +-
 Documentation/hwmon/{vt1211 => vt1211.rst}    |  84 ++-
 .../hwmon/{w83627ehf => w83627ehf.rst}        | 160 ++--
 .../hwmon/{w83627hf => w83627hf.rst}          |  65 +-
 Documentation/hwmon/{w83773g => w83773g.rst}  |  12 +-
 Documentation/hwmon/{w83781d => w83781d.rst}  | 330 +++++----
 Documentation/hwmon/{w83791d => w83791d.rst}  | 123 ++--
 Documentation/hwmon/{w83792d => w83792d.rst}  | 112 +--
 Documentation/hwmon/w83793                    | 106 ---
 Documentation/hwmon/w83793.rst                | 113 +++
 Documentation/hwmon/w83795                    | 127 ----
 Documentation/hwmon/w83795.rst                | 142 ++++
 .../hwmon/{w83l785ts => w83l785ts.rst}        |   9 +-
 .../hwmon/{w83l786ng => w83l786ng.rst}        |  42 +-
 Documentation/hwmon/{wm831x => wm831x.rst}    |   9 +-
 Documentation/hwmon/{wm8350 => wm8350.rst}    |  10 +-
 .../hwmon/{xgene-hwmon => xgene-hwmon.rst}    |  24 +-
 Documentation/hwmon/{zl6100 => zl6100.rst}    |  71 +-
 Documentation/index.rst                       |   1 +
 Documentation/thermal/sysfs-api.txt           |   2 +-
 MAINTAINERS                                   | 108 +--
 drivers/hwmon/Kconfig                         |   8 +-
 drivers/hwmon/ads7828.c                       |   2 +-
 drivers/hwmon/max197.c                        |   2 +-
 drivers/hwmon/sht15.c                         |   2 +-
 include/linux/platform_data/ads7828.h         |   2 +-
 include/linux/platform_data/ds620.h           |   2 +-
 include/linux/platform_data/ina2xx.h          |   2 +-
 include/linux/platform_data/max197.h          |   2 +-
 include/linux/platform_data/ntc_thermistor.h  |   2 +-
 177 files changed, 5604 insertions(+), 2609 deletions(-)
 rename Documentation/hwmon/{ab8500 => ab8500.rst} (69%)
 delete mode 100644 Documentation/hwmon/abituguru
 rename Documentation/hwmon/{abituguru-datasheet => abituguru-datasheet.rst} (69%)
 create mode 100644 Documentation/hwmon/abituguru.rst
 rename Documentation/hwmon/{abituguru3 => abituguru3.rst} (75%)
 rename Documentation/hwmon/{abx500 => abx500.rst} (89%)
 rename Documentation/hwmon/{acpi_power_meter => acpi_power_meter.rst} (65%)
 rename Documentation/hwmon/{ad7314 => ad7314.rst} (98%)
 rename Documentation/hwmon/{adc128d818 => adc128d818.rst} (95%)
 rename Documentation/hwmon/{adm1021 => adm1021.rst} (97%)
 rename Documentation/hwmon/{adm1025 => adm1025.rst} (96%)
 rename Documentation/hwmon/{adm1026 => adm1026.rst} (89%)
 rename Documentation/hwmon/{adm1031 => adm1031.rst} (80%)
 rename Documentation/hwmon/{adm1275 => adm1275.rst} (93%)
 rename Documentation/hwmon/{adm9240 => adm9240.rst} (85%)
 rename Documentation/hwmon/{ads1015 => ads1015.rst} (64%)
 rename Documentation/hwmon/{ads7828 => ads7828.rst} (68%)
 rename Documentation/hwmon/{adt7410 => adt7410.rst} (70%)
 rename Documentation/hwmon/{adt7411 => adt7411.rst} (67%)
 rename Documentation/hwmon/{adt7462 => adt7462.rst} (94%)
 rename Documentation/hwmon/{adt7470 => adt7470.rst} (95%)
 rename Documentation/hwmon/{adt7475 => adt7475.rst} (89%)
 rename Documentation/hwmon/{amc6821 => amc6821.rst} (90%)
 rename Documentation/hwmon/{asb100 => asb100.rst} (69%)
 rename Documentation/hwmon/{asc7621 => asc7621.rst} (80%)
 rename Documentation/hwmon/{aspeed-pwm-tacho => aspeed-pwm-tacho.rst} (79%)
 rename Documentation/hwmon/{coretemp => coretemp.rst} (78%)
 rename Documentation/hwmon/{da9052 => da9052.rst} (66%)
 rename Documentation/hwmon/{da9055 => da9055.rst} (80%)
 rename Documentation/hwmon/{dme1737 => dme1737.rst} (89%)
 rename Documentation/hwmon/{ds1621 => ds1621.rst} (68%)
 rename Documentation/hwmon/{ds620 => ds620.rst} (88%)
 rename Documentation/hwmon/{emc1403 => emc1403.rst} (83%)
 rename Documentation/hwmon/{emc2103 => emc2103.rst} (95%)
 rename Documentation/hwmon/{emc6w201 => emc6w201.rst} (99%)
 rename Documentation/hwmon/{f71805f => f71805f.rst} (88%)
 rename Documentation/hwmon/{f71882fg => f71882fg.rst} (97%)
 rename Documentation/hwmon/{fam15h_power => fam15h_power.rst} (63%)
 rename Documentation/hwmon/{ftsteutates => ftsteutates.rst} (65%)
 rename Documentation/hwmon/{g760a => g760a.rst} (99%)
 rename Documentation/hwmon/{g762 => g762.rst} (59%)
 rename Documentation/hwmon/{gl518sm => gl518sm.rst} (89%)
 rename Documentation/hwmon/{hih6130 => hih6130.rst} (85%)
 rename Documentation/hwmon/{hwmon-kernel-api.txt => hwmon-kernel-api.rst} (59%)
 rename Documentation/hwmon/{ibm-cffps => ibm-cffps.rst} (90%)
 rename Documentation/hwmon/{ibmaem => ibmaem.rst} (92%)
 rename Documentation/hwmon/{ibmpowernv => ibmpowernv.rst} (94%)
 rename Documentation/hwmon/{ina209 => ina209.rst} (90%)
 rename Documentation/hwmon/{ina2xx => ina2xx.rst} (81%)
 rename Documentation/hwmon/{ina3221 => ina3221.rst} (77%)
 create mode 100644 Documentation/hwmon/index.rst
 rename Documentation/hwmon/{ir35221 => ir35221.rst} (89%)
 rename Documentation/hwmon/{it87 => it87.rst} (92%)
 rename Documentation/hwmon/{jc42 => jc42.rst} (92%)
 rename Documentation/hwmon/{k10temp => k10temp.rst} (98%)
 rename Documentation/hwmon/{k8temp => k8temp.rst} (83%)
 rename Documentation/hwmon/{lineage-pem => lineage-pem.rst} (88%)
 rename Documentation/hwmon/{lm25066 => lm25066.rst} (91%)
 rename Documentation/hwmon/{lm63 => lm63.rst} (95%)
 rename Documentation/hwmon/{lm70 => lm70.rst} (96%)
 rename Documentation/hwmon/{lm73 => lm73.rst} (92%)
 rename Documentation/hwmon/{lm75 => lm75.rst} (80%)
 rename Documentation/hwmon/{lm77 => lm77.rst} (97%)
 rename Documentation/hwmon/{lm78 => lm78.rst} (95%)
 rename Documentation/hwmon/{lm80 => lm80.rst} (94%)
 rename Documentation/hwmon/{lm83 => lm83.rst} (95%)
 rename Documentation/hwmon/{lm85 => lm85.rst} (86%)
 rename Documentation/hwmon/{lm87 => lm87.rst} (89%)
 rename Documentation/hwmon/{lm90 => lm90.rst} (85%)
 rename Documentation/hwmon/{lm92 => lm92.rst} (90%)
 rename Documentation/hwmon/{lm93 => lm93.rst} (80%)
 rename Documentation/hwmon/{lm95234 => lm95234.rst} (94%)
 rename Documentation/hwmon/{lm95245 => lm95245.rst} (91%)
 rename Documentation/hwmon/{ltc2945 => ltc2945.rst} (89%)
 rename Documentation/hwmon/{ltc2978 => ltc2978.rst} (58%)
 rename Documentation/hwmon/{ltc2990 => ltc2990.rst} (76%)
 rename Documentation/hwmon/{ltc3815 => ltc3815.rst} (83%)
 rename Documentation/hwmon/{ltc4151 => ltc4151.rst} (80%)
 rename Documentation/hwmon/{ltc4215 => ltc4215.rst} (78%)
 rename Documentation/hwmon/{ltc4245 => ltc4245.rst} (89%)
 rename Documentation/hwmon/{ltc4260 => ltc4260.rst} (85%)
 rename Documentation/hwmon/{ltc4261 => ltc4261.rst} (88%)
 rename Documentation/hwmon/{max16064 => max16064.rst} (88%)
 rename Documentation/hwmon/{max16065 => max16065.rst} (95%)
 rename Documentation/hwmon/{max1619 => max1619.rst} (82%)
 rename Documentation/hwmon/{max1668 => max1668.rst} (85%)
 rename Documentation/hwmon/{max197 => max197.rst} (59%)
 rename Documentation/hwmon/{max20751 => max20751.rst} (89%)
 rename Documentation/hwmon/{max31722 => max31722.rst} (83%)
 rename Documentation/hwmon/{max31785 => max31785.rst} (92%)
 rename Documentation/hwmon/{max31790 => max31790.rst} (88%)
 rename Documentation/hwmon/{max34440 => max34440.rst} (77%)
 rename Documentation/hwmon/{max6639 => max6639.rst} (83%)
 rename Documentation/hwmon/{max6642 => max6642.rst} (82%)
 rename Documentation/hwmon/{max6650 => max6650.rst} (86%)
 rename Documentation/hwmon/{max6697 => max6697.rst} (91%)
 rename Documentation/hwmon/{max8688 => max8688.rst} (85%)
 rename Documentation/hwmon/{mc13783-adc => mc13783-adc.rst} (82%)
 rename Documentation/hwmon/{mcp3021 => mcp3021.rst} (90%)
 rename Documentation/hwmon/{menf21bmc => menf21bmc.rst} (93%)
 rename Documentation/hwmon/{mlxreg-fan => mlxreg-fan.rst} (53%)
 rename Documentation/hwmon/{nct6683 => nct6683.rst} (89%)
 rename Documentation/hwmon/{nct6775 => nct6775.rst} (86%)
 rename Documentation/hwmon/{nct7802 => nct7802.rst} (73%)
 rename Documentation/hwmon/{nct7904 => nct7904.rst} (88%)
 rename Documentation/hwmon/{npcm750-pwm-fan => npcm750-pwm-fan.rst} (79%)
 rename Documentation/hwmon/{nsa320 => nsa320.rst} (93%)
 rename Documentation/hwmon/{ntc_thermistor => ntc_thermistor.rst} (52%)
 rename Documentation/hwmon/{occ => occ.rst} (67%)
 rename Documentation/hwmon/{pc87360 => pc87360.rst} (88%)
 rename Documentation/hwmon/{pc87427 => pc87427.rst} (99%)
 rename Documentation/hwmon/{pcf8591 => pcf8591.rst} (62%)
 rename Documentation/hwmon/{pmbus-core => pmbus-core.rst} (68%)
 rename Documentation/hwmon/{pmbus => pmbus.rst} (88%)
 rename Documentation/hwmon/{powr1220 => powr1220.rst} (90%)
 rename Documentation/hwmon/{pwm-fan => pwm-fan.rst} (100%)
 rename Documentation/hwmon/{raspberrypi-hwmon => raspberrypi-hwmon.rst} (85%)
 rename Documentation/hwmon/{sch5627 => sch5627.rst} (99%)
 rename Documentation/hwmon/{sch5636 => sch5636.rst} (99%)
 rename Documentation/hwmon/{scpi-hwmon => scpi-hwmon.rst} (96%)
 rename Documentation/hwmon/{sht15 => sht15.rst} (74%)
 rename Documentation/hwmon/{sht21 => sht21.rst} (92%)
 rename Documentation/hwmon/{sht3x => sht3x.rst} (75%)
 rename Documentation/hwmon/{shtc1 => shtc1.rst} (94%)
 rename Documentation/hwmon/{sis5595 => sis5595.rst} (79%)
 rename Documentation/hwmon/{smm665 => smm665.rst} (92%)
 rename Documentation/hwmon/{smsc47b397 => smsc47b397.rst} (62%)
 rename Documentation/hwmon/{smsc47m1 => smsc47m1.rst} (77%)
 delete mode 100644 Documentation/hwmon/smsc47m192
 create mode 100644 Documentation/hwmon/smsc47m192.rst
 rename Documentation/hwmon/{submitting-patches => submitting-patches.rst} (93%)
 rename Documentation/hwmon/{sysfs-interface => sysfs-interface.rst} (70%)
 rename Documentation/hwmon/{tc654 => tc654.rst} (81%)
 rename Documentation/hwmon/{tc74 => tc74.rst} (99%)
 rename Documentation/hwmon/{thmc50 => thmc50.rst} (84%)
 rename Documentation/hwmon/{tmp102 => tmp102.rst} (92%)
 rename Documentation/hwmon/{tmp103 => tmp103.rst} (91%)
 rename Documentation/hwmon/{tmp108 => tmp108.rst} (95%)
 rename Documentation/hwmon/{tmp401 => tmp401.rst} (92%)
 rename Documentation/hwmon/{tmp421 => tmp421.rst} (96%)
 rename Documentation/hwmon/{tps40422 => tps40422.rst} (75%)
 rename Documentation/hwmon/{twl4030-madc-hwmon => twl4030-madc-hwmon.rst} (82%)
 rename Documentation/hwmon/{ucd9000 => ucd9000.rst} (87%)
 rename Documentation/hwmon/{ucd9200 => ucd9200.rst} (80%)
 rename Documentation/hwmon/{userspace-tools => userspace-tools.rst} (97%)
 rename Documentation/hwmon/{vexpress => vexpress.rst} (85%)
 rename Documentation/hwmon/{via686a => via686a.rst} (79%)
 rename Documentation/hwmon/{vt1211 => vt1211.rst} (73%)
 rename Documentation/hwmon/{w83627ehf => w83627ehf.rst} (64%)
 rename Documentation/hwmon/{w83627hf => w83627hf.rst} (73%)
 rename Documentation/hwmon/{w83773g => w83773g.rst} (91%)
 rename Documentation/hwmon/{w83781d => w83781d.rst} (66%)
 rename Documentation/hwmon/{w83791d => w83791d.rst} (59%)
 rename Documentation/hwmon/{w83792d => w83792d.rst} (78%)
 delete mode 100644 Documentation/hwmon/w83793
 create mode 100644 Documentation/hwmon/w83793.rst
 delete mode 100644 Documentation/hwmon/w83795
 create mode 100644 Documentation/hwmon/w83795.rst
 rename Documentation/hwmon/{w83l785ts => w83l785ts.rst} (91%)
 rename Documentation/hwmon/{w83l786ng => w83l786ng.rst} (64%)
 rename Documentation/hwmon/{wm831x => wm831x.rst} (86%)
 rename Documentation/hwmon/{wm8350 => wm8350.rst} (81%)
 rename Documentation/hwmon/{xgene-hwmon => xgene-hwmon.rst} (51%)
 rename Documentation/hwmon/{zl6100 => zl6100.rst} (83%)

-- 
2.20.1



^ permalink raw reply	[flat|nested] 73+ messages in thread

* [PATCH v2 01/21] docs: hwmon: k10temp: convert to ReST format
  2019-04-10 19:22 [PATCH v2 00/21] Convert hwmon documentation to ReST Mauro Carvalho Chehab
@ 2019-04-10 19:22 ` Mauro Carvalho Chehab
  2019-04-10 19:22 ` [PATCH v2 02/21] docs: hwmon: vexpress: " Mauro Carvalho Chehab
                   ` (20 subsequent siblings)
  21 siblings, 0 replies; 73+ messages in thread
From: Mauro Carvalho Chehab @ 2019-04-10 19:22 UTC (permalink / raw)
  To: Linux Doc Mailing List
  Cc: Mauro Carvalho Chehab, Mauro Carvalho Chehab, linux-kernel,
	Jonathan Corbet, Jean Delvare, Guenter Roeck, linux-hwmon

Convert k10temp to ReST format, in order to allow it to
be parsed by Sphinx.

Signed-off-by: Mauro Carvalho Chehab <mchehab+samsung@kernel.org>
---
 Documentation/hwmon/k10temp | 37 ++++++++++++++++++++++++++++++++++++-
 1 file changed, 36 insertions(+), 1 deletion(-)

diff --git a/Documentation/hwmon/k10temp b/Documentation/hwmon/k10temp
index 254d2f55345a..12a86ba17de9 100644
--- a/Documentation/hwmon/k10temp
+++ b/Documentation/hwmon/k10temp
@@ -2,42 +2,77 @@ Kernel driver k10temp
 =====================
 
 Supported chips:
+
 * AMD Family 10h processors:
+
   Socket F: Quad-Core/Six-Core/Embedded Opteron (but see below)
+
   Socket AM2+: Quad-Core Opteron, Phenom (II) X3/X4, Athlon X2 (but see below)
+
   Socket AM3: Quad-Core Opteron, Athlon/Phenom II X2/X3/X4, Sempron II
+
   Socket S1G3: Athlon II, Sempron, Turion II
+
 * AMD Family 11h processors:
+
   Socket S1G2: Athlon (X2), Sempron (X2), Turion X2 (Ultra)
+
 * AMD Family 12h processors: "Llano" (E2/A4/A6/A8-Series)
+
 * AMD Family 14h processors: "Brazos" (C/E/G/Z-Series)
+
 * AMD Family 15h processors: "Bulldozer" (FX-Series), "Trinity", "Kaveri", "Carrizo"
+
 * AMD Family 16h processors: "Kabini", "Mullins"
 
   Prefix: 'k10temp'
+
   Addresses scanned: PCI space
+
   Datasheets:
+
   BIOS and Kernel Developer's Guide (BKDG) For AMD Family 10h Processors:
+
     http://support.amd.com/us/Processor_TechDocs/31116.pdf
+
   BIOS and Kernel Developer's Guide (BKDG) for AMD Family 11h Processors:
+
     http://support.amd.com/us/Processor_TechDocs/41256.pdf
+
   BIOS and Kernel Developer's Guide (BKDG) for AMD Family 12h Processors:
+
     http://support.amd.com/us/Processor_TechDocs/41131.pdf
+
   BIOS and Kernel Developer's Guide (BKDG) for AMD Family 14h Models 00h-0Fh Processors:
+
     http://support.amd.com/us/Processor_TechDocs/43170.pdf
+
   Revision Guide for AMD Family 10h Processors:
+
     http://support.amd.com/us/Processor_TechDocs/41322.pdf
+
   Revision Guide for AMD Family 11h Processors:
+
     http://support.amd.com/us/Processor_TechDocs/41788.pdf
+
   Revision Guide for AMD Family 12h Processors:
+
     http://support.amd.com/us/Processor_TechDocs/44739.pdf
+
   Revision Guide for AMD Family 14h Models 00h-0Fh Processors:
+
     http://support.amd.com/us/Processor_TechDocs/47534.pdf
+
   AMD Family 11h Processor Power and Thermal Data Sheet for Notebooks:
+
     http://support.amd.com/us/Processor_TechDocs/43373.pdf
+
   AMD Family 10h Server and Workstation Processor Power and Thermal Data Sheet:
+
     http://support.amd.com/us/Processor_TechDocs/43374.pdf
+
   AMD Family 10h Desktop Processor Power and Thermal Data Sheet:
+
     http://support.amd.com/us/Processor_TechDocs/43375.pdf
 
 Author: Clemens Ladisch <clemens@ladisch.de>
@@ -60,7 +95,7 @@ are using an AM3 processor on an AM2+ mainboard, you can safely use the
 
 There is one temperature measurement value, available as temp1_input in
 sysfs. It is measured in degrees Celsius with a resolution of 1/8th degree.
-Please note that it is defined as a relative value; to quote the AMD manual:
+Please note that it is defined as a relative value; to quote the AMD manual::
 
   Tctl is the processor temperature control value, used by the platform to
   control cooling systems. Tctl is a non-physical temperature on an
-- 
2.20.1


^ permalink raw reply related	[flat|nested] 73+ messages in thread

* [PATCH v2 02/21] docs: hwmon: vexpress: convert to ReST format
  2019-04-10 19:22 [PATCH v2 00/21] Convert hwmon documentation to ReST Mauro Carvalho Chehab
  2019-04-10 19:22 ` [PATCH v2 01/21] docs: hwmon: k10temp: convert to ReST format Mauro Carvalho Chehab
@ 2019-04-10 19:22 ` Mauro Carvalho Chehab
  2019-04-11 13:05   ` Liviu Dudau
  2019-04-10 19:22 ` [PATCH v2 03/21] docs: hwmon: menf21bmc: " Mauro Carvalho Chehab
                   ` (19 subsequent siblings)
  21 siblings, 1 reply; 73+ messages in thread
From: Mauro Carvalho Chehab @ 2019-04-10 19:22 UTC (permalink / raw)
  To: Linux Doc Mailing List
  Cc: Mauro Carvalho Chehab, Mauro Carvalho Chehab, linux-kernel,
	Jonathan Corbet, Jean Delvare, Guenter Roeck, Liviu Dudau,
	Sudeep Holla, Lorenzo Pieralisi, linux-hwmon, linux-arm-kernel

Convert vexpress to ReST format, in order to allow it to
be parsed by Sphinx.

Signed-off-by: Mauro Carvalho Chehab <mchehab+samsung@kernel.org>
---
 Documentation/hwmon/vexpress | 13 ++++++++++---
 1 file changed, 10 insertions(+), 3 deletions(-)

diff --git a/Documentation/hwmon/vexpress b/Documentation/hwmon/vexpress
index 557d6d5ad90d..8c861c8151ac 100644
--- a/Documentation/hwmon/vexpress
+++ b/Documentation/hwmon/vexpress
@@ -2,14 +2,21 @@ Kernel driver vexpress
 ======================
 
 Supported systems:
+
   * ARM Ltd. Versatile Express platform
+
     Prefix: 'vexpress'
+
     Datasheets:
+
       * "Hardware Description" sections of the Technical Reference Manuals
-        for the Versatile Express boards:
-        http://infocenter.arm.com/help/topic/com.arm.doc.subset.boards.express/index.html
+	for the Versatile Express boards:
+
+	- http://infocenter.arm.com/help/topic/com.arm.doc.subset.boards.express/index.html
+
       * Section "4.4.14. System Configuration registers" of the V2M-P1 TRM:
-        http://infocenter.arm.com/help/index.jsp?topic=/com.arm.doc.dui0447-/index.html
+
+	- http://infocenter.arm.com/help/index.jsp?topic=/com.arm.doc.dui0447-/index.html
 
 Author: Pawel Moll
 
-- 
2.20.1


^ permalink raw reply related	[flat|nested] 73+ messages in thread

* [PATCH v2 03/21] docs: hwmon: menf21bmc: convert to ReST format
  2019-04-10 19:22 [PATCH v2 00/21] Convert hwmon documentation to ReST Mauro Carvalho Chehab
  2019-04-10 19:22 ` [PATCH v2 01/21] docs: hwmon: k10temp: convert to ReST format Mauro Carvalho Chehab
  2019-04-10 19:22 ` [PATCH v2 02/21] docs: hwmon: vexpress: " Mauro Carvalho Chehab
@ 2019-04-10 19:22 ` Mauro Carvalho Chehab
  2019-04-10 19:22 ` [PATCH v2 04/21] docs: hwmon: sch5627: " Mauro Carvalho Chehab
                   ` (18 subsequent siblings)
  21 siblings, 0 replies; 73+ messages in thread
From: Mauro Carvalho Chehab @ 2019-04-10 19:22 UTC (permalink / raw)
  To: Linux Doc Mailing List
  Cc: Mauro Carvalho Chehab, Mauro Carvalho Chehab, linux-kernel,
	Jonathan Corbet, Jean Delvare, Guenter Roeck, linux-hwmon

Convert menf21bmc to ReST format, in order to allow it to
be parsed by Sphinx.

Signed-off-by: Mauro Carvalho Chehab <mchehab+samsung@kernel.org>
---
 Documentation/hwmon/menf21bmc | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/Documentation/hwmon/menf21bmc b/Documentation/hwmon/menf21bmc
index 2a273a065c5e..1f0c6b2235ab 100644
--- a/Documentation/hwmon/menf21bmc
+++ b/Documentation/hwmon/menf21bmc
@@ -2,8 +2,11 @@ Kernel driver menf21bmc_hwmon
 =============================
 
 Supported chips:
+
 	* MEN 14F021P00
+
 	  Prefix: 'menf21bmc_hwmon'
+
 	  Adresses scanned: -
 
 Author: Andreas Werner <andreas.werner@men.de>
@@ -34,6 +37,7 @@ Sysfs entries
 The following attributes are supported. All attributes are read only
 The Limits are read once by the driver.
 
+=============== ==========================
 in0_input	+3.3V input voltage
 in1_input	+5.0V input voltage
 in2_input	+12.0V input voltage
@@ -48,3 +52,4 @@ in1_label	"MON_5V"
 in2_label	"MON_12V"
 in3_label	"5V_STANDBY"
 in4_label	"VBAT"
+=============== ==========================
-- 
2.20.1


^ permalink raw reply related	[flat|nested] 73+ messages in thread

* [PATCH v2 04/21] docs: hwmon: sch5627: convert to ReST format
  2019-04-10 19:22 [PATCH v2 00/21] Convert hwmon documentation to ReST Mauro Carvalho Chehab
                   ` (2 preceding siblings ...)
  2019-04-10 19:22 ` [PATCH v2 03/21] docs: hwmon: menf21bmc: " Mauro Carvalho Chehab
@ 2019-04-10 19:22 ` Mauro Carvalho Chehab
  2019-04-10 19:22 ` [PATCH v2 05/21] docs: hwmon: emc2103: " Mauro Carvalho Chehab
                   ` (17 subsequent siblings)
  21 siblings, 0 replies; 73+ messages in thread
From: Mauro Carvalho Chehab @ 2019-04-10 19:22 UTC (permalink / raw)
  To: Linux Doc Mailing List
  Cc: Mauro Carvalho Chehab, Mauro Carvalho Chehab, linux-kernel,
	Jonathan Corbet, Jean Delvare, Guenter Roeck, linux-hwmon

Convert sch5627 to ReST format, in order to allow it to
be parsed by Sphinx.

Signed-off-by: Mauro Carvalho Chehab <mchehab+samsung@kernel.org>
---
 Documentation/hwmon/sch5627 | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/Documentation/hwmon/sch5627 b/Documentation/hwmon/sch5627
index 0551d266c51c..187682e99114 100644
--- a/Documentation/hwmon/sch5627
+++ b/Documentation/hwmon/sch5627
@@ -2,9 +2,13 @@ Kernel driver sch5627
 =====================
 
 Supported chips:
+
   * SMSC SCH5627
+
     Prefix: 'sch5627'
+
     Addresses scanned: none, address read from Super I/O config space
+
     Datasheet: Application Note available upon request
 
 Author: Hans de Goede <hdegoede@redhat.com>
-- 
2.20.1


^ permalink raw reply related	[flat|nested] 73+ messages in thread

* [PATCH v2 05/21] docs: hwmon: emc2103: convert to ReST format
  2019-04-10 19:22 [PATCH v2 00/21] Convert hwmon documentation to ReST Mauro Carvalho Chehab
                   ` (3 preceding siblings ...)
  2019-04-10 19:22 ` [PATCH v2 04/21] docs: hwmon: sch5627: " Mauro Carvalho Chehab
@ 2019-04-10 19:22 ` Mauro Carvalho Chehab
  2019-04-10 19:22 ` [PATCH v2 06/21] docs: hwmon: pc87360: " Mauro Carvalho Chehab
                   ` (16 subsequent siblings)
  21 siblings, 0 replies; 73+ messages in thread
From: Mauro Carvalho Chehab @ 2019-04-10 19:22 UTC (permalink / raw)
  To: Linux Doc Mailing List
  Cc: Mauro Carvalho Chehab, Mauro Carvalho Chehab, linux-kernel,
	Jonathan Corbet, Jean Delvare, Guenter Roeck, linux-hwmon

Convert emc2103 to ReST format, in order to allow it to
be parsed by Sphinx.

Signed-off-by: Mauro Carvalho Chehab <mchehab+samsung@kernel.org>
---
 Documentation/hwmon/emc2103 | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/Documentation/hwmon/emc2103 b/Documentation/hwmon/emc2103
index a12b2c127140..6a6ca6d1b34e 100644
--- a/Documentation/hwmon/emc2103
+++ b/Documentation/hwmon/emc2103
@@ -2,13 +2,17 @@ Kernel driver emc2103
 ======================
 
 Supported chips:
+
   * SMSC EMC2103
+
     Addresses scanned: I2C 0x2e
+
     Prefix: 'emc2103'
+
     Datasheet: Not public
 
 Authors:
-        Steve Glendinning <steve.glendinning@smsc.com>
+	Steve Glendinning <steve.glendinning@smsc.com>
 
 Description
 -----------
-- 
2.20.1


^ permalink raw reply related	[flat|nested] 73+ messages in thread

* [PATCH v2 06/21] docs: hwmon: pc87360: convert to ReST format
  2019-04-10 19:22 [PATCH v2 00/21] Convert hwmon documentation to ReST Mauro Carvalho Chehab
                   ` (4 preceding siblings ...)
  2019-04-10 19:22 ` [PATCH v2 05/21] docs: hwmon: emc2103: " Mauro Carvalho Chehab
@ 2019-04-10 19:22 ` Mauro Carvalho Chehab
  2019-04-10 19:22 ` [PATCH v2 07/21] docs: hwmon: fam15h_power: " Mauro Carvalho Chehab
                   ` (15 subsequent siblings)
  21 siblings, 0 replies; 73+ messages in thread
From: Mauro Carvalho Chehab @ 2019-04-10 19:22 UTC (permalink / raw)
  To: Linux Doc Mailing List
  Cc: Mauro Carvalho Chehab, Mauro Carvalho Chehab, linux-kernel,
	Jonathan Corbet, Jean Delvare, Guenter Roeck, linux-hwmon

Convert pc87360 to ReST format, in order to allow it to
be parsed by Sphinx.

Signed-off-by: Mauro Carvalho Chehab <mchehab+samsung@kernel.org>
---
 Documentation/hwmon/pc87360 | 38 +++++++++++++++++++++++++------------
 1 file changed, 26 insertions(+), 12 deletions(-)

diff --git a/Documentation/hwmon/pc87360 b/Documentation/hwmon/pc87360
index d5f5cf16ce59..4bad07bce54b 100644
--- a/Documentation/hwmon/pc87360
+++ b/Documentation/hwmon/pc87360
@@ -2,14 +2,19 @@ Kernel driver pc87360
 =====================
 
 Supported chips:
+
   * National Semiconductor PC87360, PC87363, PC87364, PC87365 and PC87366
+
     Prefixes: 'pc87360', 'pc87363', 'pc87364', 'pc87365', 'pc87366'
+
     Addresses scanned: none, address read from Super I/O config space
+
     Datasheets: No longer available
 
 Authors: Jean Delvare <jdelvare@suse.de>
 
 Thanks to Sandeep Mehta, Tonko de Rooy and Daniel Ceregatti for testing.
+
 Thanks to Rudolf Marek for helping me investigate conversion issues.
 
 
@@ -17,11 +22,13 @@ Module Parameters
 -----------------
 
 * init int
-  Chip initialization level:
-   0: None
-  *1: Forcibly enable internal voltage and temperature channels, except in9
-   2: Forcibly enable all voltage and temperature channels, except in9
-   3: Forcibly enable all voltage and temperature channels, including in9
+    Chip initialization level:
+
+    - 0: None
+    - **1**: Forcibly enable internal voltage and temperature channels,
+      except in9
+    - 2: Forcibly enable all voltage and temperature channels, except in9
+    - 3: Forcibly enable all voltage and temperature channels, including in9
 
 Note that this parameter has no effect for the PC87360, PC87363 and PC87364
 chips.
@@ -43,13 +50,15 @@ hardware monitoring chipsets, not only controlling and monitoring three fans,
 but also monitoring eleven voltage inputs and two (PC87365) or up to four
 (PC87366) temperatures.
 
+  =========== ======= ======= ======= ======= =====
   Chip        #vin    #fan    #pwm    #temp   devid
-
+  =========== ======= ======= ======= ======= =====
   PC87360     -       2       2       -       0xE1
   PC87363     -       2       2       -       0xE8
   PC87364     -       3       3       -       0xE4
   PC87365     11      3       3       2       0xE5
   PC87366     11      3       3       3-4     0xE9
+  =========== ======= ======= ======= ======= =====
 
 The driver assumes that no more than one chip is present, and one of the
 standard Super I/O addresses is used (0x2E/0x2F or 0x4E/0x4F)
@@ -68,18 +77,23 @@ have to care no more.
 
 For reference, here are a few values about clock dividers:
 
-                slowest         accuracy        highest
-                measurable      around 3000     accurate
+    =========== =============== =============== ===========
+		slowest         accuracy        highest
+		measurable      around 3000     accurate
     divider     speed (RPM)     RPM (RPM)       speed (RPM)
-         1        1882              18           6928
-         2         941              37           4898
-         4         470              74           3464
-         8         235             150           2449
+    =========== =============== =============== ===========
+	 1        1882              18           6928
+	 2         941              37           4898
+	 4         470              74           3464
+	 8         235             150           2449
+    =========== =============== =============== ===========
 
 For the curious, here is how the values above were computed:
+
  * slowest measurable speed: clock/(255*divider)
  * accuracy around 3000 RPM: 3000^2/clock
  * highest accurate speed: sqrt(clock*100)
+
 The clock speed for the PC87360 family is 480 kHz. I arbitrarily chose 100
 RPM as the lowest acceptable accuracy.
 
-- 
2.20.1


^ permalink raw reply related	[flat|nested] 73+ messages in thread

* [PATCH v2 07/21] docs: hwmon: fam15h_power: convert to ReST format
  2019-04-10 19:22 [PATCH v2 00/21] Convert hwmon documentation to ReST Mauro Carvalho Chehab
                   ` (5 preceding siblings ...)
  2019-04-10 19:22 ` [PATCH v2 06/21] docs: hwmon: pc87360: " Mauro Carvalho Chehab
@ 2019-04-10 19:22 ` Mauro Carvalho Chehab
  2019-04-10 19:22 ` [PATCH v2 08/21] docs: hwmon: w83791d: " Mauro Carvalho Chehab
                   ` (14 subsequent siblings)
  21 siblings, 0 replies; 73+ messages in thread
From: Mauro Carvalho Chehab @ 2019-04-10 19:22 UTC (permalink / raw)
  To: Linux Doc Mailing List
  Cc: Mauro Carvalho Chehab, Mauro Carvalho Chehab, linux-kernel,
	Jonathan Corbet, Jean Delvare, Guenter Roeck, linux-hwmon

Convert fam15h_power to ReST format, in order to allow it to
be parsed by Sphinx.

Signed-off-by: Mauro Carvalho Chehab <mchehab+samsung@kernel.org>
---
 Documentation/hwmon/fam15h_power | 85 +++++++++++++++++++++-----------
 1 file changed, 57 insertions(+), 28 deletions(-)

diff --git a/Documentation/hwmon/fam15h_power b/Documentation/hwmon/fam15h_power
index fb594c281c46..fdde632c93a3 100644
--- a/Documentation/hwmon/fam15h_power
+++ b/Documentation/hwmon/fam15h_power
@@ -2,15 +2,20 @@ Kernel driver fam15h_power
 ==========================
 
 Supported chips:
+
 * AMD Family 15h Processors
+
 * AMD Family 16h Processors
 
   Prefix: 'fam15h_power'
+
   Addresses scanned: PCI space
+
   Datasheets:
-  BIOS and Kernel Developer's Guide (BKDG) For AMD Family 15h Processors
-  BIOS and Kernel Developer's Guide (BKDG) For AMD Family 16h Processors
-  AMD64 Architecture Programmer's Manual Volume 2: System Programming
+
+  - BIOS and Kernel Developer's Guide (BKDG) For AMD Family 15h Processors
+  - BIOS and Kernel Developer's Guide (BKDG) For AMD Family 16h Processors
+  - AMD64 Architecture Programmer's Manual Volume 2: System Programming
 
 Author: Andreas Herrmann <herrmann.der.user@googlemail.com>
 
@@ -31,14 +36,19 @@ For AMD Family 15h and 16h processors the following power values can
 be calculated using different processor northbridge function
 registers:
 
-* BasePwrWatts: Specifies in watts the maximum amount of power
-  consumed by the processor for NB and logic external to the core.
-* ProcessorPwrWatts: Specifies in watts the maximum amount of power
-  the processor can support.
-* CurrPwrWatts: Specifies in watts the current amount of power being
-  consumed by the processor.
+* BasePwrWatts:
+    Specifies in watts the maximum amount of power
+    consumed by the processor for NB and logic external to the core.
+
+* ProcessorPwrWatts:
+    Specifies in watts the maximum amount of power
+    the processor can support.
+* CurrPwrWatts:
+    Specifies in watts the current amount of power being
+    consumed by the processor.
 
 This driver provides ProcessorPwrWatts and CurrPwrWatts:
+
 * power1_crit (ProcessorPwrWatts)
 * power1_input (CurrPwrWatts)
 
@@ -53,35 +63,53 @@ calculate the average power consumed by a processor during a
 measurement interval Tm. The feature of accumulated power mechanism is
 indicated by CPUID Fn8000_0007_EDX[12].
 
-* Tsample: compute unit power accumulator sample period
-* Tref: the PTSC counter period
-* PTSC: performance timestamp counter
-* N: the ratio of compute unit power accumulator sample period to the
-  PTSC period
-* Jmax: max compute unit accumulated power which is indicated by
-  MaxCpuSwPwrAcc MSR C001007b
-* Jx/Jy: compute unit accumulated power which is indicated by
-  CpuSwPwrAcc MSR C001007a
-* Tx/Ty: the value of performance timestamp counter which is indicated
-  by CU_PTSC MSR C0010280
-* PwrCPUave: CPU average power
+* Tsample:
+	compute unit power accumulator sample period
+
+* Tref:
+	the PTSC counter period
+
+* PTSC:
+	performance timestamp counter
+
+* N:
+	the ratio of compute unit power accumulator sample period to the
+	PTSC period
+
+* Jmax:
+	max compute unit accumulated power which is indicated by
+	MaxCpuSwPwrAcc MSR C001007b
+
+* Jx/Jy:
+	compute unit accumulated power which is indicated by
+	CpuSwPwrAcc MSR C001007a
+* Tx/Ty:
+	the value of performance timestamp counter which is indicated
+	by CU_PTSC MSR C0010280
+
+* PwrCPUave:
+	CPU average power
 
 i. Determine the ratio of Tsample to Tref by executing CPUID Fn8000_0007.
+
 	N = value of CPUID Fn8000_0007_ECX[CpuPwrSampleTimeRatio[15:0]].
 
 ii. Read the full range of the cumulative energy value from the new
-MSR MaxCpuSwPwrAcc.
+    MSR MaxCpuSwPwrAcc.
+
 	Jmax = value returned.
+
 iii. At time x, SW reads CpuSwPwrAcc MSR and samples the PTSC.
-	Jx = value read from CpuSwPwrAcc and Tx = value read from
-PTSC.
+
+	Jx = value read from CpuSwPwrAcc and Tx = value read from PTSC.
 
 iv. At time y, SW reads CpuSwPwrAcc MSR and samples the PTSC.
-	Jy = value read from CpuSwPwrAcc and Ty = value read from
-PTSC.
+
+	Jy = value read from CpuSwPwrAcc and Ty = value read from PTSC.
 
 v. Calculate the average power consumption for a compute unit over
-time period (y-x). Unit of result is uWatt.
+   time period (y-x). Unit of result is uWatt::
+
 	if (Jy < Jx) // Rollover has occurred
 		Jdelta = (Jy + Jmax) - Jx
 	else
@@ -90,13 +118,14 @@ time period (y-x). Unit of result is uWatt.
 
 This driver provides PwrCPUave and interval(default is 10 millisecond
 and maximum is 1 second):
+
 * power1_average (PwrCPUave)
 * power1_average_interval (Interval)
 
 The power1_average_interval can be updated at /etc/sensors3.conf file
 as below:
 
-chip "fam15h_power-*"
+chip `fam15h_power-*`
 	set power1_average_interval 0.01
 
 Then save it with "sensors -s".
-- 
2.20.1


^ permalink raw reply related	[flat|nested] 73+ messages in thread

* [PATCH v2 08/21] docs: hwmon: w83791d: convert to ReST format
  2019-04-10 19:22 [PATCH v2 00/21] Convert hwmon documentation to ReST Mauro Carvalho Chehab
                   ` (6 preceding siblings ...)
  2019-04-10 19:22 ` [PATCH v2 07/21] docs: hwmon: fam15h_power: " Mauro Carvalho Chehab
@ 2019-04-10 19:22 ` Mauro Carvalho Chehab
  2019-04-10 19:22 ` [PATCH v2 09/21] docs: hwmon: coretemp: " Mauro Carvalho Chehab
                   ` (13 subsequent siblings)
  21 siblings, 0 replies; 73+ messages in thread
From: Mauro Carvalho Chehab @ 2019-04-10 19:22 UTC (permalink / raw)
  To: Linux Doc Mailing List
  Cc: Mauro Carvalho Chehab, Mauro Carvalho Chehab, linux-kernel,
	Jonathan Corbet, Jean Delvare, Guenter Roeck, linux-hwmon

Convert w83791d to ReST format, in order to allow it to
be parsed by Sphinx.

Signed-off-by: Mauro Carvalho Chehab <mchehab+samsung@kernel.org>
---
 Documentation/hwmon/w83791d | 123 +++++++++++++++++++++---------------
 1 file changed, 71 insertions(+), 52 deletions(-)

diff --git a/Documentation/hwmon/w83791d b/Documentation/hwmon/w83791d
index f4021a285460..a91f9e5fb0c6 100644
--- a/Documentation/hwmon/w83791d
+++ b/Documentation/hwmon/w83791d
@@ -2,9 +2,13 @@ Kernel driver w83791d
 =====================
 
 Supported chips:
+
   * Winbond W83791D
+
     Prefix: 'w83791d'
+
     Addresses scanned: I2C 0x2c - 0x2f
+
     Datasheet: http://www.winbond-usa.com/products/winbond_products/pdfs/PCIC/W83791D_W83791Gb.pdf
 
 Author: Charles Spirakis <bezaur@gmail.com>
@@ -12,39 +16,46 @@ Author: Charles Spirakis <bezaur@gmail.com>
 This driver was derived from the w83781d.c and w83792d.c source files.
 
 Credits:
+
   w83781d.c:
-    Frodo Looijaard <frodol@dds.nl>,
-    Philip Edelbrock <phil@netroedge.com>,
-    and Mark Studebaker <mdsxyz123@yahoo.com>
+
+    - Frodo Looijaard <frodol@dds.nl>,
+    - Philip Edelbrock <phil@netroedge.com>,
+    - Mark Studebaker <mdsxyz123@yahoo.com>
+
   w83792d.c:
-    Shane Huang (Winbond),
-    Rudolf Marek <r.marek@assembler.cz>
+
+    - Shane Huang (Winbond),
+    - Rudolf Marek <r.marek@assembler.cz>
 
 Additional contributors:
-    Sven Anders <anders@anduras.de>
-    Marc Hulsman <m.hulsman@tudelft.nl>
+
+    - Sven Anders <anders@anduras.de>
+    - Marc Hulsman <m.hulsman@tudelft.nl>
 
 Module Parameters
 -----------------
 
 * init boolean
-  (default 0)
-  Use 'init=1' to have the driver do extra software initializations.
-  The default behavior is to do the minimum initialization possible
-  and depend on the BIOS to properly setup the chip. If you know you
-  have a w83791d and you're having problems, try init=1 before trying
-  reset=1.
+    (default 0)
+
+    Use 'init=1' to have the driver do extra software initializations.
+    The default behavior is to do the minimum initialization possible
+    and depend on the BIOS to properly setup the chip. If you know you
+    have a w83791d and you're having problems, try init=1 before trying
+    reset=1.
 
 * reset boolean
-  (default 0)
-  Use 'reset=1' to reset the chip (via index 0x40, bit 7). The default
-  behavior is no chip reset to preserve BIOS settings.
+    (default 0)
+
+    Use 'reset=1' to reset the chip (via index 0x40, bit 7). The default
+    behavior is no chip reset to preserve BIOS settings.
 
 * force_subclients=bus,caddr,saddr,saddr
-  This is used to force the i2c addresses for subclients of
-  a certain chip. Example usage is `force_subclients=0,0x2f,0x4a,0x4b'
-  to force the subclients of chip 0x2f on bus 0 to i2c addresses
-  0x4a and 0x4b.
+    This is used to force the i2c addresses for subclients of
+    a certain chip. Example usage is `force_subclients=0,0x2f,0x4a,0x4b`
+    to force the subclients of chip 0x2f on bus 0 to i2c addresses
+    0x4a and 0x4b.
 
 
 Description
@@ -91,11 +102,11 @@ This file is used for both legacy and new code.
 
 The sysfs interface to the beep bitmask has migrated from the original legacy
 method of a single sysfs beep_mask file to a newer method using multiple
-*_beep files as described in .../Documentation/hwmon/sysfs-interface.
+`*_beep` files as described in `Documentation/hwmon/sysfs-interface`.
 
 A similar change has occurred for the bitmap corresponding to the alarms. The
 original legacy method used a single sysfs alarms file containing a bitmap
-of triggered alarms. The newer method uses multiple sysfs *_alarm files
+of triggered alarms. The newer method uses multiple sysfs `*_alarm` files
 (again following the pattern described in sysfs-interface).
 
 Since both methods read and write the underlying hardware, they can be used
@@ -116,46 +127,54 @@ User mode code requesting values more often will receive cached values.
 The sysfs-interface is documented in the 'sysfs-interface' file. Only
 chip-specific options are documented here.
 
-pwm[1-3]_enable -	this file controls mode of fan/temperature control for
+======================= =======================================================
+pwm[1-3]_enable		this file controls mode of fan/temperature control for
 			fan 1-3. Fan/PWM 4-5 only support manual mode.
-		            * 1 Manual mode
-		            * 2 Thermal Cruise mode
-		            * 3 Fan Speed Cruise mode (no further support)
 
-temp[1-3]_target -	defines the target temperature for Thermal Cruise mode.
+			    * 1 Manual mode
+			    * 2 Thermal Cruise mode
+			    * 3 Fan Speed Cruise mode (no further support)
+
+temp[1-3]_target	defines the target temperature for Thermal Cruise mode.
 			Unit: millidegree Celsius
 			RW
 
-temp[1-3]_tolerance -	temperature tolerance for Thermal Cruise mode.
+temp[1-3]_tolerance	temperature tolerance for Thermal Cruise mode.
 			Specifies an interval around the target temperature
 			in which the fan speed is not changed.
 			Unit: millidegree Celsius
 			RW
+======================= =======================================================
 
 Alarms bitmap vs. beep_mask bitmask
-------------------------------------
+-----------------------------------
+
 For legacy code using the alarms and beep_mask files:
 
-in0 (VCORE)  :  alarms: 0x000001 beep_mask: 0x000001
-in1 (VINR0)  :  alarms: 0x000002 beep_mask: 0x002000 <== mismatch
-in2 (+3.3VIN):  alarms: 0x000004 beep_mask: 0x000004
-in3 (5VDD)   :  alarms: 0x000008 beep_mask: 0x000008
-in4 (+12VIN) :  alarms: 0x000100 beep_mask: 0x000100
-in5 (-12VIN) :  alarms: 0x000200 beep_mask: 0x000200
-in6 (-5VIN)  :  alarms: 0x000400 beep_mask: 0x000400
-in7 (VSB)    :  alarms: 0x080000 beep_mask: 0x010000 <== mismatch
-in8 (VBAT)   :  alarms: 0x100000 beep_mask: 0x020000 <== mismatch
-in9 (VINR1)  :  alarms: 0x004000 beep_mask: 0x004000
-temp1        :  alarms: 0x000010 beep_mask: 0x000010
-temp2        :  alarms: 0x000020 beep_mask: 0x000020
-temp3        :  alarms: 0x002000 beep_mask: 0x000002 <== mismatch
-fan1         :  alarms: 0x000040 beep_mask: 0x000040
-fan2         :  alarms: 0x000080 beep_mask: 0x000080
-fan3         :  alarms: 0x000800 beep_mask: 0x000800
-fan4         :  alarms: 0x200000 beep_mask: 0x200000
-fan5         :  alarms: 0x400000 beep_mask: 0x400000
-tart1        :  alarms: 0x010000 beep_mask: 0x040000 <== mismatch
-tart2        :  alarms: 0x020000 beep_mask: 0x080000 <== mismatch
-tart3        :  alarms: 0x040000 beep_mask: 0x100000 <== mismatch
-case_open    :  alarms: 0x001000 beep_mask: 0x001000
-global_enable:  alarms: -------- beep_mask: 0x800000 (modified via beep_enable)
+=============  ========  ========= ==========================
+Signal         Alarms    beep_mask Obs
+=============  ========  ========= ==========================
+in0 (VCORE)    0x000001  0x000001
+in1 (VINR0)    0x000002  0x002000  <== mismatch
+in2 (+3.3VIN)  0x000004  0x000004
+in3 (5VDD)     0x000008  0x000008
+in4 (+12VIN)   0x000100  0x000100
+in5 (-12VIN)   0x000200  0x000200
+in6 (-5VIN)    0x000400  0x000400
+in7 (VSB)      0x080000  0x010000  <== mismatch
+in8 (VBAT)     0x100000  0x020000  <== mismatch
+in9 (VINR1)    0x004000  0x004000
+temp1          0x000010  0x000010
+temp2          0x000020  0x000020
+temp3          0x002000  0x000002  <== mismatch
+fan1           0x000040  0x000040
+fan2           0x000080  0x000080
+fan3           0x000800  0x000800
+fan4           0x200000  0x200000
+fan5           0x400000  0x400000
+tart1          0x010000  0x040000  <== mismatch
+tart2          0x020000  0x080000  <== mismatch
+tart3          0x040000  0x100000  <== mismatch
+case_open      0x001000  0x001000
+global_enable  -         0x800000  (modified via beep_enable)
+=============  ========  ========= ==========================
-- 
2.20.1


^ permalink raw reply related	[flat|nested] 73+ messages in thread

* [PATCH v2 09/21] docs: hwmon: coretemp: convert to ReST format
  2019-04-10 19:22 [PATCH v2 00/21] Convert hwmon documentation to ReST Mauro Carvalho Chehab
                   ` (7 preceding siblings ...)
  2019-04-10 19:22 ` [PATCH v2 08/21] docs: hwmon: w83791d: " Mauro Carvalho Chehab
@ 2019-04-10 19:22 ` Mauro Carvalho Chehab
  2019-04-10 19:22 ` [PATCH v2 10/21] docs: hwmon: aspeed-pwm-tacho: " Mauro Carvalho Chehab
                   ` (12 subsequent siblings)
  21 siblings, 0 replies; 73+ messages in thread
From: Mauro Carvalho Chehab @ 2019-04-10 19:22 UTC (permalink / raw)
  To: Linux Doc Mailing List
  Cc: Mauro Carvalho Chehab, Mauro Carvalho Chehab, linux-kernel,
	Jonathan Corbet, Jean Delvare, Guenter Roeck, linux-hwmon

Convert coretemp to ReST format, in order to allow it to
be parsed by Sphinx.

Signed-off-by: Mauro Carvalho Chehab <mchehab+samsung@kernel.org>
---
 Documentation/hwmon/coretemp | 46 +++++++++++++++++++++++-------------
 1 file changed, 30 insertions(+), 16 deletions(-)

diff --git a/Documentation/hwmon/coretemp b/Documentation/hwmon/coretemp
index fec5a9bf755f..c609329e3bc4 100644
--- a/Documentation/hwmon/coretemp
+++ b/Documentation/hwmon/coretemp
@@ -3,20 +3,29 @@ Kernel driver coretemp
 
 Supported chips:
   * All Intel Core family
+
     Prefix: 'coretemp'
-    CPUID: family 0x6, models 0xe (Pentium M DC), 0xf (Core 2 DC 65nm),
-                              0x16 (Core 2 SC 65nm), 0x17 (Penryn 45nm),
-                              0x1a (Nehalem), 0x1c (Atom), 0x1e (Lynnfield),
-                              0x26 (Tunnel Creek Atom), 0x27 (Medfield Atom),
-                              0x36 (Cedar Trail Atom)
-    Datasheet: Intel 64 and IA-32 Architectures Software Developer's Manual
-               Volume 3A: System Programming Guide
-               http://softwarecommunity.intel.com/Wiki/Mobility/720.htm
+
+    CPUID: family 0x6, models
+
+			    - 0xe (Pentium M DC), 0xf (Core 2 DC 65nm),
+			    - 0x16 (Core 2 SC 65nm), 0x17 (Penryn 45nm),
+			    - 0x1a (Nehalem), 0x1c (Atom), 0x1e (Lynnfield),
+			    - 0x26 (Tunnel Creek Atom), 0x27 (Medfield Atom),
+			    - 0x36 (Cedar Trail Atom)
+
+    Datasheet:
+
+	       Intel 64 and IA-32 Architectures Software Developer's Manual
+	       Volume 3A: System Programming Guide
+
+	       http://softwarecommunity.intel.com/Wiki/Mobility/720.htm
 
 Author: Rudolf Marek
 
 Description
 -----------
+
 This driver permits reading the DTS (Digital Temperature Sensor) embedded
 inside Intel CPUs. This driver can read both the per-core and per-package
 temperature using the appropriate sensors. The per-package sensor is new;
@@ -35,14 +44,17 @@ may be raised, if the temperature grows enough (more than TjMax) to trigger
 the Out-Of-Spec bit. Following table summarizes the exported sysfs files:
 
 All Sysfs entries are named with their core_id (represented here by 'X').
-tempX_input	 - Core temperature (in millidegrees Celsius).
-tempX_max	 - All cooling devices should be turned on (on Core2).
-tempX_crit	 - Maximum junction temperature (in millidegrees Celsius).
-tempX_crit_alarm - Set when Out-of-spec bit is set, never clears.
-		   Correct CPU operation is no longer guaranteed.
-tempX_label	 - Contains string "Core X", where X is processor
-		   number. For Package temp, this will be "Physical id Y",
-		   where Y is the package number.
+
+================= ========================================================
+tempX_input	  Core temperature (in millidegrees Celsius).
+tempX_max	  All cooling devices should be turned on (on Core2).
+tempX_crit	  Maximum junction temperature (in millidegrees Celsius).
+tempX_crit_alarm  Set when Out-of-spec bit is set, never clears.
+		  Correct CPU operation is no longer guaranteed.
+tempX_label	  Contains string "Core X", where X is processor
+		  number. For Package temp, this will be "Physical id Y",
+		  where Y is the package number.
+================= ========================================================
 
 On CPU models which support it, TjMax is read from a model-specific register.
 On other models, it is set to an arbitrary value based on weak heuristics.
@@ -52,6 +64,7 @@ as a module parameter (tjmax).
 Appendix A. Known TjMax lists (TBD):
 Some information comes from ark.intel.com
 
+=============== =============================================== ================
 Process		Processor					TjMax(C)
 
 22nm		Core i5/i7 Processors
@@ -179,3 +192,4 @@ Process		Processor					TjMax(C)
 65nm		Celeron Processors
 		T1700/1600					100
 		560/550/540/530					100
+=============== =============================================== ================
-- 
2.20.1


^ permalink raw reply related	[flat|nested] 73+ messages in thread

* [PATCH v2 10/21] docs: hwmon: aspeed-pwm-tacho: convert to ReST format
  2019-04-10 19:22 [PATCH v2 00/21] Convert hwmon documentation to ReST Mauro Carvalho Chehab
                   ` (8 preceding siblings ...)
  2019-04-10 19:22 ` [PATCH v2 09/21] docs: hwmon: coretemp: " Mauro Carvalho Chehab
@ 2019-04-10 19:22 ` Mauro Carvalho Chehab
  2019-04-11  0:27   ` Andrew Jeffery
  2019-04-10 19:22 ` [PATCH v2 11/21] docs: hwmon: ibmpowernv: " Mauro Carvalho Chehab
                   ` (11 subsequent siblings)
  21 siblings, 1 reply; 73+ messages in thread
From: Mauro Carvalho Chehab @ 2019-04-10 19:22 UTC (permalink / raw)
  To: Linux Doc Mailing List
  Cc: Mauro Carvalho Chehab, Mauro Carvalho Chehab, linux-kernel,
	Jonathan Corbet, Jean Delvare, Guenter Roeck, Joel Stanley,
	Andrew Jeffery, linux-hwmon, linux-arm-kernel, linux-aspeed

Convert aspeed-pwm-tacho to ReST format, in order to allow it to
be parsed by Sphinx.

Signed-off-by: Mauro Carvalho Chehab <mchehab+samsung@kernel.org>
---
 Documentation/hwmon/aspeed-pwm-tacho | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/Documentation/hwmon/aspeed-pwm-tacho b/Documentation/hwmon/aspeed-pwm-tacho
index 7cfb34977460..6dcec845fbc7 100644
--- a/Documentation/hwmon/aspeed-pwm-tacho
+++ b/Documentation/hwmon/aspeed-pwm-tacho
@@ -15,8 +15,10 @@ controller supports up to 16 tachometer inputs.
 
 The driver provides the following sensor accesses in sysfs:
 
+=============== ======= =====================================================
 fanX_input	ro	provide current fan rotation value in RPM as reported
 			by the fan to the device.
 
 pwmX		rw	get or set PWM fan control value. This is an integer
 			value between 0(off) and 255(full speed).
+=============== ======= =====================================================
-- 
2.20.1


^ permalink raw reply related	[flat|nested] 73+ messages in thread

* [PATCH v2 11/21] docs: hwmon: ibmpowernv: convert to ReST format
  2019-04-10 19:22 [PATCH v2 00/21] Convert hwmon documentation to ReST Mauro Carvalho Chehab
                   ` (9 preceding siblings ...)
  2019-04-10 19:22 ` [PATCH v2 10/21] docs: hwmon: aspeed-pwm-tacho: " Mauro Carvalho Chehab
@ 2019-04-10 19:22 ` Mauro Carvalho Chehab
  2019-04-10 19:22 ` [PATCH v2 12/21] docs: hwmon: asc7621: " Mauro Carvalho Chehab
                   ` (10 subsequent siblings)
  21 siblings, 0 replies; 73+ messages in thread
From: Mauro Carvalho Chehab @ 2019-04-10 19:22 UTC (permalink / raw)
  To: Linux Doc Mailing List
  Cc: Mauro Carvalho Chehab, Mauro Carvalho Chehab, linux-kernel,
	Jonathan Corbet, Jean Delvare, Guenter Roeck,
	Benjamin Herrenschmidt, Paul Mackerras, Michael Ellerman,
	linux-hwmon, linuxppc-dev

Convert ibmpowernv to ReST format, in order to allow it to
be parsed by Sphinx.

Signed-off-by: Mauro Carvalho Chehab <mchehab+samsung@kernel.org>
---
 Documentation/hwmon/ibmpowernv | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/Documentation/hwmon/ibmpowernv b/Documentation/hwmon/ibmpowernv
index 56468258711f..3f1feae3901c 100644
--- a/Documentation/hwmon/ibmpowernv
+++ b/Documentation/hwmon/ibmpowernv
@@ -2,6 +2,7 @@ Kernel Driver IBMPOWERNV
 ========================
 
 Supported systems:
+
   * Any recent IBM P servers based on POWERNV platform
 
 Author: Neelesh Gupta
@@ -29,6 +30,7 @@ CONFIG_SENSORS_IBMPOWERNV. It can also be built as module 'ibmpowernv'.
 Sysfs attributes
 ----------------
 
+======================= =======================================================
 fanX_input		Measured RPM value.
 fanX_min		Threshold RPM for alert generation.
 fanX_fault		0: No fail condition
@@ -78,3 +80,4 @@ currX_enable		Enable/disable all current sensors belonging to the
 			0: Disable
 
 energyX_input		Cumulative energy (microJoule)
+======================= =======================================================
-- 
2.20.1


^ permalink raw reply related	[flat|nested] 73+ messages in thread

* [PATCH v2 12/21] docs: hwmon: asc7621: convert to ReST format
  2019-04-10 19:22 [PATCH v2 00/21] Convert hwmon documentation to ReST Mauro Carvalho Chehab
                   ` (10 preceding siblings ...)
  2019-04-10 19:22 ` [PATCH v2 11/21] docs: hwmon: ibmpowernv: " Mauro Carvalho Chehab
@ 2019-04-10 19:22 ` Mauro Carvalho Chehab
  2019-04-10 19:22 ` [PATCH v2 13/21] docs: hwmon: ads1015: " Mauro Carvalho Chehab
                   ` (9 subsequent siblings)
  21 siblings, 0 replies; 73+ messages in thread
From: Mauro Carvalho Chehab @ 2019-04-10 19:22 UTC (permalink / raw)
  To: Linux Doc Mailing List
  Cc: Mauro Carvalho Chehab, Mauro Carvalho Chehab, linux-kernel,
	Jonathan Corbet, Jean Delvare, Guenter Roeck, linux-hwmon

Convert asc7621 to ReST format, in order to allow it to
be parsed by Sphinx.

Signed-off-by: Mauro Carvalho Chehab <mchehab+samsung@kernel.org>
---
 Documentation/hwmon/asc7621 | 146 ++++++++++++++++++++++--------------
 1 file changed, 88 insertions(+), 58 deletions(-)

diff --git a/Documentation/hwmon/asc7621 b/Documentation/hwmon/asc7621
index 7287be7e1f21..b5a9fad0f172 100644
--- a/Documentation/hwmon/asc7621
+++ b/Documentation/hwmon/asc7621
@@ -1,10 +1,15 @@
+=====================
 Kernel driver asc7621
-==================
+=====================
 
 Supported chips:
+
     Andigilog aSC7621 and aSC7621a
+
     Prefix: 'asc7621'
+
     Addresses scanned: I2C 0x2c, 0x2d, 0x2e
+
     Datasheet: http://www.fairview5.com/linux/asc7621/asc7621.pdf
 
 Author:
@@ -73,8 +78,10 @@ Finally, we have added a tach disable function that turns off the tach
 measurement system for individual tachs in order to save power. That is
 in register 75h.
 
---
+--------------------------------------------------------------------------
+
 aSC7621 Product Description
+===========================
 
 The aSC7621 has a two wire digital interface compatible with SMBus 2.0.
 Using a 10-bit ADC, the aSC7621 measures the temperature of two remote diode
@@ -102,6 +109,8 @@ System voltages of VCCP, 2.5V, 3.3V, 5.0V, and 12V motherboard power are
 monitored efficiently with internal scaling resistors.
 
 Features
+--------
+
 - Supports PECI interface and monitors internal and remote thermal diodes
 - 2-wire, SMBus 2.0 compliant, serial interface
 - 10-bit ADC
@@ -110,7 +119,7 @@ Features
 - Noise filtering of temperature reading for fan speed control
 - 0.25C digital temperature sensor resolution
 - 3 PWM fan speed control outputs for 2-, 3- or 4-wire fans and up to 4 fan
-	tachometer inputs
+  tachometer inputs
 - Enhanced measured temperature to Temperature Zone assignment.
 - Provides high and low PWM frequency ranges
 - 3 GPIO pins for custom use
@@ -123,17 +132,20 @@ Except where noted below, the sysfs entries created by this driver follow
 the standards defined in "sysfs-interface".
 
 temp1_source
+	=	===============================================
 	0 	(default) peci_legacy = 0, Remote 1 Temperature
-			peci_legacy = 1, PECI Processor Temperature 0
+		peci_legacy = 1, PECI Processor Temperature 0
 	1 	Remote 1 Temperature
 	2 	Remote 2 Temperature
 	3 	Internal Temperature
 	4 	PECI Processor Temperature 0
 	5 	PECI Processor Temperature 1
 	6 	PECI Processor Temperature 2
-	7  PECI Processor Temperature 3
+	7	PECI Processor Temperature 3
+	=	===============================================
 
 temp2_source
+	=	===============================================
 	0 	(default) Internal Temperature
 	1 	Remote 1 Temperature
 	2 	Remote 2 Temperature
@@ -142,8 +154,10 @@ temp2_source
 	5 	PECI Processor Temperature 1
 	6 	PECI Processor Temperature 2
 	7 	PECI Processor Temperature 3
+	=	===============================================
 
 temp3_source
+	=	===============================================
 	0 	(default) Remote 2 Temperature
 	1 	Remote 1 Temperature
 	2 	Remote 2 Temperature
@@ -152,10 +166,12 @@ temp3_source
 	5 	PECI Processor Temperature 1
 	6 	PECI Processor Temperature 2
 	7 	PECI Processor Temperature 3
+	=	===============================================
 
 temp4_source
+	=	===============================================
 	0 	(default) peci_legacy = 0, PECI Processor Temperature 0
-			peci_legacy = 1, Remote 1 Temperature
+		peci_legacy = 1, Remote 1 Temperature
 	1 	Remote 1 Temperature
 	2 	Remote 2 Temperature
 	3 	Internal Temperature
@@ -163,58 +179,65 @@ temp4_source
 	5 	PECI Processor Temperature 1
 	6 	PECI Processor Temperature 2
 	7 	PECI Processor Temperature 3
+	=	===============================================
 
-temp[1-4]_smoothing_enable
-temp[1-4]_smoothing_time
+temp[1-4]_smoothing_enable / temp[1-4]_smoothing_time
 	Smooths spikes in temp readings caused by noise.
 	Valid values in milliseconds are:
-	35000
-	17600
-	11800
-	 7000
-	 4400
-	 3000
-	 1600
-	  800
+
+	* 35000
+	* 17600
+	* 11800
+	*  7000
+	*  4400
+	*  3000
+	*  1600
+	*   800
 
 temp[1-4]_crit
 	When the corresponding zone temperature reaches this value,
 	ALL pwm outputs will got to 100%.
 
-temp[5-8]_input
-temp[5-8]_enable
+temp[5-8]_input / temp[5-8]_enable
 	The aSC7621 can also read temperatures provided by the processor
 	via the PECI bus.  Usually these are "core" temps and are relative
 	to the point where the automatic thermal control circuit starts
 	throttling.  This means that these are usually negative numbers.
 
 pwm[1-3]_enable
+	=============== ========================================================
 	0		Fan off.
 	1		Fan on manual control.
 	2		Fan on automatic control and will run at the minimum pwm
-				if the temperature for the zone is below the minimum.
-	3		Fan on automatic control but will be off if the temperature
-				for the zone is below the minimum.
-	4-254	Ignored.
+			if the temperature for the zone is below the minimum.
+	3		Fan on automatic control but will be off if the
+			temperature for the zone is below the minimum.
+	4-254		Ignored.
 	255		Fan on full.
+	=============== ========================================================
 
 pwm[1-3]_auto_channels
 	Bitmap as described in sysctl-interface with the following
 	exceptions...
+
 	Only the following combination of zones (and their corresponding masks)
 	are valid:
-	1
-	2
-	3
-	2,3
-	1,2,3
-	4
-	1,2,3,4
 
-	Special values:
-	0			Disabled.
-	16		Fan on manual control.
-	31		Fan on full.
+	* 1
+	* 2
+	* 3
+	* 2,3
+	* 1,2,3
+	* 4
+	* 1,2,3,4
+
+	* Special values:
+
+	  ==		======================
+	  0		Disabled.
+	  16		Fan on manual control.
+	  31		Fan on full.
+	  ==		======================
 
 
 pwm[1-3]_invert
@@ -226,22 +249,22 @@ pwm[1-3]_freq
 	PWM frequency in Hz
 	Valid values in Hz are:
 
-	10
-	15
-	23
-	30  (default)
-	38
-	47
-	62
-	94
-	23000
-	24000
-	25000
-	26000
-	27000
-	28000
-	29000
-	30000
+	* 10
+	* 15
+	* 23
+	* 30  (default)
+	* 38
+	* 47
+	* 62
+	* 94
+	* 23000
+	* 24000
+	* 25000
+	* 26000
+	* 27000
+	* 28000
+	* 29000
+	* 30000
 
 	Setting any other value will be ignored.
 
@@ -251,17 +274,17 @@ peci_enable
 peci_avg
 	Input filter average time.
 
-	0 	0 Sec. (no Smoothing) (default)
-	1 	0.25 Sec.
-	2 	0.5 Sec.
-	3 	1.0 Sec.
-	4 	2.0 Sec.
-	5 	4.0 Sec.
-	6 	8.0 Sec.
-	7 	0.0 Sec.
+	* 0 	0 Sec. (no Smoothing) (default)
+	* 1 	0.25 Sec.
+	* 2 	0.5 Sec.
+	* 3 	1.0 Sec.
+	* 4 	2.0 Sec.
+	* 5 	4.0 Sec.
+	* 6 	8.0 Sec.
+	* 7 	0.0 Sec.
 
 peci_legacy
-
+	=	============================================
 	0	Standard Mode (default)
 		Remote Diode 1 reading is associated with
 		Temperature Zone 1, PECI is associated with
@@ -270,10 +293,12 @@ peci_legacy
 	1	Legacy Mode
 		PECI is associated with Temperature Zone 1,
 		Remote Diode 1 is associated with Zone 4
+	=	============================================
 
 peci_diode
 	Diode filter
 
+	=	====================
 	0	0.25 Sec.
 	1 	1.1 Sec.
 	2 	2.4 Sec.  (default)
@@ -282,15 +307,20 @@ peci_diode
 	5 	6.8 Sec.
 	6 	10.2 Sec.
 	7 	16.4 Sec.
+	=	====================
 
 peci_4domain
 	Four domain enable
 
+	=	===============================================
 	0 	1 or 2 Domains for enabled processors (default)
 	1 	3 or 4 Domains for enabled processors
+	=	===============================================
 
 peci_domain
 	Domain
 
+	=	==================================================
 	0 	Processor contains a single domain (0) 	 (default)
 	1 	Processor contains two domains (0,1)
+	=	==================================================
-- 
2.20.1


^ permalink raw reply related	[flat|nested] 73+ messages in thread

* [PATCH v2 13/21] docs: hwmon: ads1015: convert to ReST format
  2019-04-10 19:22 [PATCH v2 00/21] Convert hwmon documentation to ReST Mauro Carvalho Chehab
                   ` (11 preceding siblings ...)
  2019-04-10 19:22 ` [PATCH v2 12/21] docs: hwmon: asc7621: " Mauro Carvalho Chehab
@ 2019-04-10 19:22 ` Mauro Carvalho Chehab
  2019-04-10 19:22 ` [PATCH v2 14/21] docs: hwmon: dme1737, vt1211: " Mauro Carvalho Chehab
                   ` (8 subsequent siblings)
  21 siblings, 0 replies; 73+ messages in thread
From: Mauro Carvalho Chehab @ 2019-04-10 19:22 UTC (permalink / raw)
  To: Linux Doc Mailing List
  Cc: Mauro Carvalho Chehab, Mauro Carvalho Chehab, linux-kernel,
	Jonathan Corbet, Jean Delvare, Guenter Roeck, linux-hwmon

Convert ads1015 to ReST format, in order to allow it to
be parsed by Sphinx.

Signed-off-by: Mauro Carvalho Chehab <mchehab+samsung@kernel.org>
---
 Documentation/hwmon/ads1015 | 72 ++++++++++++++++++++++---------------
 1 file changed, 43 insertions(+), 29 deletions(-)

diff --git a/Documentation/hwmon/ads1015 b/Documentation/hwmon/ads1015
index 02d2a459385f..e0951c4e57bb 100644
--- a/Documentation/hwmon/ads1015
+++ b/Documentation/hwmon/ads1015
@@ -2,17 +2,25 @@ Kernel driver ads1015
 =====================
 
 Supported chips:
+
   * Texas Instruments ADS1015
+
     Prefix: 'ads1015'
-    Datasheet: Publicly available at the Texas Instruments website :
-               http://focus.ti.com/lit/ds/symlink/ads1015.pdf
+
+    Datasheet: Publicly available at the Texas Instruments website:
+
+	       http://focus.ti.com/lit/ds/symlink/ads1015.pdf
+
   * Texas Instruments ADS1115
+
     Prefix: 'ads1115'
-    Datasheet: Publicly available at the Texas Instruments website :
-               http://focus.ti.com/lit/ds/symlink/ads1115.pdf
+
+    Datasheet: Publicly available at the Texas Instruments website:
+
+	       http://focus.ti.com/lit/ds/symlink/ads1115.pdf
 
 Authors:
-        Dirk Eibach, Guntermann & Drunck GmbH <eibach@gdsys.de>
+	Dirk Eibach, Guntermann & Drunck GmbH <eibach@gdsys.de>
 
 Description
 -----------
@@ -24,14 +32,15 @@ This device is a 12/16-bit A-D converter with 4 inputs.
 The inputs can be used single ended or in certain differential combinations.
 
 The inputs can be made available by 8 sysfs input files in0_input - in7_input:
-in0: Voltage over AIN0 and AIN1.
-in1: Voltage over AIN0 and AIN3.
-in2: Voltage over AIN1 and AIN3.
-in3: Voltage over AIN2 and AIN3.
-in4: Voltage over AIN0 and GND.
-in5: Voltage over AIN1 and GND.
-in6: Voltage over AIN2 and GND.
-in7: Voltage over AIN3 and GND.
+
+  - in0: Voltage over AIN0 and AIN1.
+  - in1: Voltage over AIN0 and AIN3.
+  - in2: Voltage over AIN1 and AIN3.
+  - in3: Voltage over AIN2 and AIN3.
+  - in4: Voltage over AIN0 and GND.
+  - in5: Voltage over AIN1 and GND.
+  - in6: Voltage over AIN2 and GND.
+  - in7: Voltage over AIN3 and GND.
 
 Which inputs are available can be configured using platform data or devicetree.
 
@@ -42,29 +51,34 @@ Platform Data
 
 In linux/platform_data/ads1015.h platform data is defined, channel_data contains
 configuration data for the used input combinations:
+
 - pga is the programmable gain amplifier (values are full scale)
-  0: +/- 6.144 V
-  1: +/- 4.096 V
-  2: +/- 2.048 V
-  3: +/- 1.024 V
-  4: +/- 0.512 V
-  5: +/- 0.256 V
+
+    - 0: +/- 6.144 V
+    - 1: +/- 4.096 V
+    - 2: +/- 2.048 V
+    - 3: +/- 1.024 V
+    - 4: +/- 0.512 V
+    - 5: +/- 0.256 V
+
 - data_rate in samples per second
-  0: 128
-  1: 250
-  2: 490
-  3: 920
-  4: 1600
-  5: 2400
-  6: 3300
 
-Example:
-struct ads1015_platform_data data = {
+    - 0: 128
+    - 1: 250
+    - 2: 490
+    - 3: 920
+    - 4: 1600
+    - 5: 2400
+    - 6: 3300
+
+Example::
+
+  struct ads1015_platform_data data = {
 	.channel_data = {
 		[2] = { .enabled = true, .pga = 1, .data_rate = 0 },
 		[4] = { .enabled = true, .pga = 4, .data_rate = 5 },
 	}
-};
+  };
 
 In this case only in2_input (FS +/- 4.096 V, 128 SPS) and in4_input
 (FS +/- 0.512 V, 2400 SPS) would be created.
-- 
2.20.1


^ permalink raw reply related	[flat|nested] 73+ messages in thread

* [PATCH v2 14/21] docs: hwmon: dme1737, vt1211: convert to ReST format
  2019-04-10 19:22 [PATCH v2 00/21] Convert hwmon documentation to ReST Mauro Carvalho Chehab
                   ` (12 preceding siblings ...)
  2019-04-10 19:22 ` [PATCH v2 13/21] docs: hwmon: ads1015: " Mauro Carvalho Chehab
@ 2019-04-10 19:22 ` Mauro Carvalho Chehab
  2019-04-10 19:22 ` [PATCH v2 15/21] docs: hwmon: wm831x, wm8350: " Mauro Carvalho Chehab
                   ` (7 subsequent siblings)
  21 siblings, 0 replies; 73+ messages in thread
From: Mauro Carvalho Chehab @ 2019-04-10 19:22 UTC (permalink / raw)
  To: Linux Doc Mailing List
  Cc: Mauro Carvalho Chehab, Mauro Carvalho Chehab, linux-kernel,
	Jonathan Corbet, Jean Delvare, Guenter Roeck, linux-hwmon

Convert dme1737 and vt1211 to ReST format, in order to allow
them to be parsed by Sphinx.

Signed-off-by: Mauro Carvalho Chehab <mchehab+samsung@kernel.org>
---
 Documentation/hwmon/dme1737 | 88 ++++++++++++++++++++++++++-----------
 Documentation/hwmon/vt1211  | 84 +++++++++++++++++++++--------------
 2 files changed, 114 insertions(+), 58 deletions(-)

diff --git a/Documentation/hwmon/dme1737 b/Documentation/hwmon/dme1737
index 4d2935145a1c..82fcbc6b2b43 100644
--- a/Documentation/hwmon/dme1737
+++ b/Documentation/hwmon/dme1737
@@ -2,21 +2,37 @@ Kernel driver dme1737
 =====================
 
 Supported chips:
+
   * SMSC DME1737 and compatibles (like Asus A8000)
+
     Prefix: 'dme1737'
+
     Addresses scanned: I2C 0x2c, 0x2d, 0x2e
+
     Datasheet: Provided by SMSC upon request and under NDA
+
   * SMSC SCH3112, SCH3114, SCH3116
+
     Prefix: 'sch311x'
+
     Addresses scanned: none, address read from Super-I/O config space
+
     Datasheet: Available on the Internet
+
   * SMSC SCH5027
+
     Prefix: 'sch5027'
+
     Addresses scanned: I2C 0x2c, 0x2d, 0x2e
+
     Datasheet: Provided by SMSC upon request and under NDA
+
   * SMSC SCH5127
+
     Prefix: 'sch5127'
+
     Addresses scanned: none, address read from Super-I/O config space
+
     Datasheet: Provided by SMSC upon request and under NDA
 
 Authors:
@@ -26,11 +42,14 @@ Authors:
 Module Parameters
 -----------------
 
-* force_start: bool	Enables the monitoring of voltage, fan and temp inputs
+* force_start: bool
+			Enables the monitoring of voltage, fan and temp inputs
 			and PWM output control functions. Using this parameter
 			shouldn't be required since the BIOS usually takes care
 			of this.
-* probe_all_addr: bool	Include non-standard LPC addresses 0x162e and 0x164e
+
+* probe_all_addr: bool
+			Include non-standard LPC addresses 0x162e and 0x164e
 			when probing for ISA devices. This is required for the
 			following boards:
 			- VIA EPIA SN18000
@@ -70,7 +89,8 @@ scaling resistors. The values returned by the driver therefore reflect true
 millivolts and don't need scaling. The voltage inputs are mapped as follows
 (the last column indicates the input ranges):
 
-DME1737, A8000:
+DME1737, A8000::
+
 	in0: +5VTR	(+5V standby)		0V - 6.64V
 	in1: Vccp	(processor core)	0V - 3V
 	in2: VCC	(internal +3.3V)	0V - 4.38V
@@ -79,7 +99,8 @@ DME1737, A8000:
 	in5: VTR	(+3.3V standby)		0V - 4.38V
 	in6: Vbat	(+3.0V)			0V - 4.38V
 
-SCH311x:
+SCH311x::
+
 	in0: +2.5V				0V - 3.32V
 	in1: Vccp	(processor core)	0V - 2V
 	in2: VCC	(internal +3.3V)	0V - 4.38V
@@ -88,7 +109,8 @@ SCH311x:
 	in5: VTR	(+3.3V standby)		0V - 4.38V
 	in6: Vbat	(+3.0V)			0V - 4.38V
 
-SCH5027:
+SCH5027::
+
 	in0: +5VTR	(+5V standby)		0V - 6.64V
 	in1: Vccp	(processor core)	0V - 3V
 	in2: VCC	(internal +3.3V)	0V - 4.38V
@@ -97,7 +119,8 @@ SCH5027:
 	in5: VTR	(+3.3V standby)		0V - 4.38V
 	in6: Vbat	(+3.0V)			0V - 4.38V
 
-SCH5127:
+SCH5127::
+
 	in0: +2.5				0V - 3.32V
 	in1: Vccp	(processor core)	0V - 3V
 	in2: VCC	(internal +3.3V)	0V - 4.38V
@@ -119,7 +142,7 @@ Celsius. The chip also features offsets for all 3 temperature inputs which -
 when programmed - get added to the input readings. The chip does all the
 scaling by itself and the driver therefore reports true temperatures that don't
 need any user-space adjustments. The temperature inputs are mapped as follows
-(the last column indicates the input ranges):
+(the last column indicates the input ranges)::
 
 	temp1: Remote diode 1 (3904 type) temperature	-127C - +127C
 	temp2: DME1737 internal temperature		-127C - +127C
@@ -171,6 +194,7 @@ pwm[1-3]_auto_pwm_min, respectively. The thermal thresholds of the zones are
 programmed via zone[1-3]_auto_point[1-3]_temp and
 zone[1-3]_auto_point1_temp_hyst:
 
+	=============================== =======================================
 	pwm[1-3]_auto_point2_pwm	full-speed duty-cycle (255, i.e., 100%)
 	pwm[1-3]_auto_point1_pwm	low-speed duty-cycle
 	pwm[1-3]_auto_pwm_min		min-speed duty-cycle
@@ -179,6 +203,7 @@ zone[1-3]_auto_point1_temp_hyst:
 	zone[1-3]_auto_point2_temp	full-speed temp
 	zone[1-3]_auto_point1_temp	low-speed temp
 	zone[1-3]_auto_point1_temp_hyst	min-speed temp
+	=============================== =======================================
 
 The chip adjusts the output duty-cycle linearly in the range of auto_point1_pwm
 to auto_point2_pwm if the temperature of the associated zone is between
@@ -192,17 +217,21 @@ all PWM outputs are set to 100% duty-cycle.
 Following is another representation of how the chip sets the output duty-cycle
 based on the temperature of the associated thermal zone:
 
-			Duty-Cycle	Duty-Cycle
-	Temperature	Rising Temp	Falling Temp
-	-----------	-----------	------------
+	=============== =============== =================
+	Temperature	Duty-Cycle	Duty-Cycle
+			Rising Temp	Falling Temp
+	=============== =============== =================
 	full-speed	full-speed	full-speed
 
-			< linearly adjusted duty-cycle >
+	-		< linearly	-
+			adjusted
+			duty-cycle >
 
 	low-speed	low-speed	low-speed
-			min-speed	low-speed
+	-		min-speed	low-speed
 	min-speed	min-speed	min-speed
-			min-speed	min-speed
+	-		min-speed	min-speed
+	=============== =============== =================
 
 
 Sysfs Attributes
@@ -211,8 +240,9 @@ Sysfs Attributes
 Following is a list of all sysfs attributes that the driver provides, their
 permissions and a short description:
 
+=============================== ======= =======================================
 Name				Perm	Description
-----				----	-----------
+=============================== ======= =======================================
 cpu0_vid			RO	CPU core reference voltage in
 					millivolts.
 vrm				RW	Voltage regulator module version
@@ -242,9 +272,10 @@ temp[1-3]_fault			RO	Temp input fault. Returns 1 if the chip
 zone[1-3]_auto_channels_temp	RO	Temperature zone to temperature input
 					mapping. This attribute is a bitfield
 					and supports the following values:
-						1: temp1
-						2: temp2
-						4: temp3
+
+						- 1: temp1
+						- 2: temp2
+						- 4: temp3
 zone[1-3]_auto_point1_temp_hyst	RW	Auto PWM temp point1 hysteresis. The
 					output of the corresponding PWM is set
 					to the pwm_auto_min value if the temp
@@ -275,9 +306,10 @@ pmw[1-3,5-6]			RO/RW	Duty-cycle of PWM output. Supported
 					manual mode.
 pwm[1-3]_enable			RW	Enable of PWM outputs 1-3. Supported
 					values are:
-						 0: turned off (output @ 100%)
-						 1: manual mode
-						 2: automatic mode
+
+						- 0: turned off (output @ 100%)
+						- 1: manual mode
+						- 2: automatic mode
 pwm[5-6]_enable			RO	Enable of PWM outputs 5-6. Always
 					returns 1 since these 2 outputs are
 					hard-wired to manual mode.
@@ -294,11 +326,12 @@ pmw[1-3]_ramp_rate		RW	Ramp rate of PWM output. Determines how
 pwm[1-3]_auto_channels_zone	RW	PWM output to temperature zone mapping.
 					This attribute is a bitfield and
 					supports the following values:
-						1: zone1
-						2: zone2
-						4: zone3
-						6: highest of zone[2-3]
-						7: highest of zone[1-3]
+
+						- 1: zone1
+						- 2: zone2
+						- 4: zone3
+						- 6: highest of zone[2-3]
+						- 7: highest of zone[1-3]
 pwm[1-3]_auto_pwm_min		RW	Auto PWM min pwm. Minimum PWM duty-
 					cycle. Supported values are 0 or
 					auto_point1_pwm.
@@ -307,12 +340,14 @@ pwm[1-3]_auto_point1_pwm	RW	Auto PWM pwm point. Auto_point1 is the
 pwm[1-3]_auto_point2_pwm	RO	Auto PWM pwm point. Auto_point2 is the
 					full-speed duty-cycle which is hard-
 					wired to 255 (100% duty-cycle).
+=============================== ======= =======================================
 
 Chip Differences
 ----------------
 
+======================= ======= ======= ======= =======
 Feature			dme1737	sch311x	sch5027	sch5127
--------------------------------------------------------
+======================= ======= ======= ======= =======
 temp[1-3]_offset	yes	yes
 vid			yes
 zone3			yes	yes	yes
@@ -326,3 +361,4 @@ pwm5			opt		opt
 fan6			opt		opt
 pwm6			opt		opt
 in7						yes
+======================= ======= ======= ======= =======
diff --git a/Documentation/hwmon/vt1211 b/Documentation/hwmon/vt1211
index 77fa633b97a8..ddbcde7dd642 100644
--- a/Documentation/hwmon/vt1211
+++ b/Documentation/hwmon/vt1211
@@ -2,9 +2,13 @@ Kernel driver vt1211
 ====================
 
 Supported chips:
+
   * VIA VT1211
+
     Prefix: 'vt1211'
+
     Addresses scanned: none, address read from Super-I/O config space
+
     Datasheet: Provided by VIA upon request and under NDA
 
 Authors: Juerg Haefliger <juergh@gmail.com>
@@ -19,14 +23,17 @@ technical support.
 Module Parameters
 -----------------
 
-* uch_config: int	Override the BIOS default universal channel (UCH)
+
+* uch_config: int
+			Override the BIOS default universal channel (UCH)
 			configuration for channels 1-5.
 			Legal values are in the range of 0-31. Bit 0 maps to
 			UCH1, bit 1 maps to UCH2 and so on. Setting a bit to 1
 			enables the thermal input of that particular UCH and
 			setting a bit to 0 enables the voltage input.
 
-* int_mode: int		Override the BIOS default temperature interrupt mode.
+* int_mode: int
+			Override the BIOS default temperature interrupt mode.
 			The only possible value is 0 which forces interrupt
 			mode 0. In this mode, any pending interrupt is cleared
 			when the status register is read but is regenerated as
@@ -55,8 +62,9 @@ connected to the PWM outputs of the VT1211 :-().
 The following table shows the relationship between the vt1211 inputs and the
 sysfs nodes.
 
+=============== ============== =========== ================================
 Sensor          Voltage Mode   Temp Mode   Default Use (from the datasheet)
-------          ------------   ---------   --------------------------------
+=============== ============== =========== ================================
 Reading 1                      temp1       Intel thermal diode
 Reading 3                      temp2       Internal thermal diode
 UCH1/Reading2   in0            temp3       NTC type thermistor
@@ -65,6 +73,7 @@ UCH3            in2            temp5       VccP (processor core)
 UCH4            in3            temp6       +5V
 UCH5            in4            temp7       +12V
 +3.3V           in5                        Internal VCC (+3.3V)
+=============== ============== =========== ================================
 
 
 Voltage Monitoring
@@ -82,19 +91,22 @@ follows. And this is of course totally dependent on the actual board
 implementation :-) You will have to find documentation for your own
 motherboard and edit sensors.conf accordingly.
 
-                                      Expected
+============= ====== ====== ========= ============
+				      Expected
 Voltage       R1     R2     Divider   Raw Value
------------------------------------------------
+============= ====== ====== ========= ============
 +2.5V         2K     10K    1.2       2083 mV
-VccP          ---    ---    1.0       1400 mV (1)
+VccP          ---    ---    1.0       1400 mV [1]_
 +5V           14K    10K    2.4       2083 mV
 +12V          47K    10K    5.7       2105 mV
-+3.3V (int)   2K     3.4K   1.588     3300 mV (2)
++3.3V (int)   2K     3.4K   1.588     3300 mV [2]_
 +3.3V (ext)   6.8K   10K    1.68      1964 mV
+============= ====== ====== ========= ============
 
-(1) Depending on the CPU (1.4V is for a VIA C3 Nehemiah).
-(2) R1 and R2 for 3.3V (int) are internal to the VT1211 chip and the driver
-    performs the scaling and returns the properly scaled voltage value.
+.. [1] Depending on the CPU (1.4V is for a VIA C3 Nehemiah).
+
+.. [2] R1 and R2 for 3.3V (int) are internal to the VT1211 chip and the driver
+       performs the scaling and returns the properly scaled voltage value.
 
 Each measured voltage has an associated low and high limit which triggers an
 alarm when crossed.
@@ -124,35 +136,37 @@ compute temp1 (@-Offset)/Gain, (@*Gain)+Offset
 According to the VIA VT1211 BIOS porting guide, the following gain and offset
 values should be used:
 
+=============== ======== ===========
 Diode Type      Offset   Gain
-----------      ------   ----
+=============== ======== ===========
 Intel CPU       88.638   0.9528
-                65.000   0.9686   *)
+		65.000   0.9686 [3]_
 VIA C3 Ezra     83.869   0.9528
 VIA C3 Ezra-T   73.869   0.9528
+=============== ======== ===========
 
-*) This is the formula from the lm_sensors 2.10.0 sensors.conf file. I don't
-know where it comes from or how it was derived, it's just listed here for
-completeness.
+.. [3] This is the formula from the lm_sensors 2.10.0 sensors.conf file. I don't
+       know where it comes from or how it was derived, it's just listed here for
+       completeness.
 
 Temp3-temp7 support NTC thermistors. For these channels, the driver returns
 the voltages as seen at the individual pins of UCH1-UCH5. The voltage at the
 pin (Vpin) is formed by a voltage divider made of the thermistor (Rth) and a
-scaling resistor (Rs):
+scaling resistor (Rs)::
 
-Vpin = 2200 * Rth / (Rs + Rth)   (2200 is the ADC max limit of 2200 mV)
+  Vpin = 2200 * Rth / (Rs + Rth)   (2200 is the ADC max limit of 2200 mV)
 
 The equation for the thermistor is as follows (google it if you want to know
-more about it):
+more about it)::
 
-Rth = Ro * exp(B * (1 / T - 1 / To))   (To is 298.15K (25C) and Ro is the
-                                        nominal resistance at 25C)
+  Rth = Ro * exp(B * (1 / T - 1 / To))   (To is 298.15K (25C) and Ro is the
+					  nominal resistance at 25C)
 
 Mingling the above two equations and assuming Rs = Ro and B = 3435 yields the
-following formula for sensors.conf:
+following formula for sensors.conf::
 
-compute tempx 1 / (1 / 298.15 - (` (2200 / @ - 1)) / 3435) - 273.15,
-              2200 / (1 + (^ (3435 / 298.15 - 3435 / (273.15 + @))))
+  compute tempx 1 / (1 / 298.15 - (` (2200 / @ - 1)) / 3435) - 273.15,
+		2200 / (1 + (^ (3435 / 298.15 - 3435 / (273.15 + @))))
 
 
 Fan Speed Control
@@ -176,31 +190,37 @@ registers in the VT1211 and programming one set is sufficient (actually only
 the first set pwm1_auto_point[1-4]_temp is writable, the second set is
 read-only).
 
+========================== =========================================
 PWM Auto Point             PWM Output Duty-Cycle
-------------------------------------------------
+========================== =========================================
 pwm[1-2]_auto_point4_pwm   full speed duty-cycle (hard-wired to 255)
 pwm[1-2]_auto_point3_pwm   high speed duty-cycle
 pwm[1-2]_auto_point2_pwm   low speed duty-cycle
 pwm[1-2]_auto_point1_pwm   off duty-cycle (hard-wired to 0)
+========================== =========================================
 
+==========================  =================
 Temp Auto Point             Thermal Threshold
----------------------------------------------
+==========================  =================
 pwm[1-2]_auto_point4_temp   full speed temp
 pwm[1-2]_auto_point3_temp   high speed temp
 pwm[1-2]_auto_point2_temp   low speed temp
 pwm[1-2]_auto_point1_temp   off temp
+==========================  =================
 
 Long story short, the controller implements the following algorithm to set the
 PWM output duty-cycle based on the input temperature:
 
-Thermal Threshold             Output Duty-Cycle
-                    (Rising Temp)           (Falling Temp)
-----------------------------------------------------------
-                    full speed duty-cycle   full speed duty-cycle
+=================== ======================= ========================
+Thermal Threshold   Output Duty-Cycle       Output Duty-Cycle
+		    (Rising Temp)           (Falling Temp)
+=================== ======================= ========================
+-                   full speed duty-cycle   full speed duty-cycle
 full speed temp
-                    high speed duty-cycle   full speed duty-cycle
+-		    high speed duty-cycle   full speed duty-cycle
 high speed temp
-                    low speed duty-cycle    high speed duty-cycle
+-		    low speed duty-cycle    high speed duty-cycle
 low speed temp
-                    off duty-cycle          low speed duty-cycle
+-		    off duty-cycle          low speed duty-cycle
 off temp
+=================== ======================= ========================
-- 
2.20.1


^ permalink raw reply related	[flat|nested] 73+ messages in thread

* [PATCH v2 15/21] docs: hwmon: wm831x, wm8350: convert to ReST format
  2019-04-10 19:22 [PATCH v2 00/21] Convert hwmon documentation to ReST Mauro Carvalho Chehab
                   ` (13 preceding siblings ...)
  2019-04-10 19:22 ` [PATCH v2 14/21] docs: hwmon: dme1737, vt1211: " Mauro Carvalho Chehab
@ 2019-04-10 19:22 ` Mauro Carvalho Chehab
  2019-04-10 19:22 ` [PATCH v2 16/21] docs: hwmon: da9052, da9055: " Mauro Carvalho Chehab
                   ` (6 subsequent siblings)
  21 siblings, 0 replies; 73+ messages in thread
From: Mauro Carvalho Chehab @ 2019-04-10 19:22 UTC (permalink / raw)
  To: Linux Doc Mailing List
  Cc: Mauro Carvalho Chehab, Mauro Carvalho Chehab, linux-kernel,
	Jonathan Corbet, Jean Delvare, Guenter Roeck, linux-hwmon

Convert wm831x and wm8350 to ReST format, in order to allow
them to be parsed by Sphinx.

Signed-off-by: Mauro Carvalho Chehab <mchehab+samsung@kernel.org>
---
 Documentation/hwmon/wm831x |  9 ++++++---
 Documentation/hwmon/wm8350 | 10 +++++++---
 2 files changed, 13 insertions(+), 6 deletions(-)

diff --git a/Documentation/hwmon/wm831x b/Documentation/hwmon/wm831x
index 11446757c8c8..c56fb35a2fb3 100644
--- a/Documentation/hwmon/wm831x
+++ b/Documentation/hwmon/wm831x
@@ -3,11 +3,14 @@ Kernel driver wm831x-hwmon
 
 Supported chips:
   * Wolfson Microelectronics WM831x PMICs
+
     Prefix: 'wm831x'
+
     Datasheet:
-	http://www.wolfsonmicro.com/products/WM8310
-	http://www.wolfsonmicro.com/products/WM8311
-	http://www.wolfsonmicro.com/products/WM8312
+
+	- http://www.wolfsonmicro.com/products/WM8310
+	- http://www.wolfsonmicro.com/products/WM8311
+	- http://www.wolfsonmicro.com/products/WM8312
 
 Authors: Mark Brown <broonie@opensource.wolfsonmicro.com>
 
diff --git a/Documentation/hwmon/wm8350 b/Documentation/hwmon/wm8350
index 98f923bd2e92..cec044ca5900 100644
--- a/Documentation/hwmon/wm8350
+++ b/Documentation/hwmon/wm8350
@@ -2,12 +2,16 @@ Kernel driver wm8350-hwmon
 ==========================
 
 Supported chips:
+
   * Wolfson Microelectronics WM835x PMICs
+
     Prefix: 'wm8350'
+
     Datasheet:
-	http://www.wolfsonmicro.com/products/WM8350
-	http://www.wolfsonmicro.com/products/WM8351
-	http://www.wolfsonmicro.com/products/WM8352
+
+	- http://www.wolfsonmicro.com/products/WM8350
+	- http://www.wolfsonmicro.com/products/WM8351
+	- http://www.wolfsonmicro.com/products/WM8352
 
 Authors: Mark Brown <broonie@opensource.wolfsonmicro.com>
 
-- 
2.20.1


^ permalink raw reply related	[flat|nested] 73+ messages in thread

* [PATCH v2 16/21] docs: hwmon: da9052, da9055: convert to ReST format
  2019-04-10 19:22 [PATCH v2 00/21] Convert hwmon documentation to ReST Mauro Carvalho Chehab
                   ` (14 preceding siblings ...)
  2019-04-10 19:22 ` [PATCH v2 15/21] docs: hwmon: wm831x, wm8350: " Mauro Carvalho Chehab
@ 2019-04-10 19:22 ` Mauro Carvalho Chehab
  2019-04-10 19:22 ` [PATCH v2 17/21] docs: hwmon: k8temp, w83793: " Mauro Carvalho Chehab
                   ` (5 subsequent siblings)
  21 siblings, 0 replies; 73+ messages in thread
From: Mauro Carvalho Chehab @ 2019-04-10 19:22 UTC (permalink / raw)
  To: Linux Doc Mailing List
  Cc: Mauro Carvalho Chehab, Mauro Carvalho Chehab, linux-kernel,
	Jonathan Corbet, Jean Delvare, Guenter Roeck, linux-hwmon

Convert da9052 and da9055 to ReST format, in order to allow
them to be parsed by Sphinx.

Signed-off-by: Mauro Carvalho Chehab <mchehab+samsung@kernel.org>
---
 Documentation/hwmon/da9052 | 40 ++++++++++++++++++++++++++------------
 Documentation/hwmon/da9055 | 20 ++++++++++++++-----
 2 files changed, 43 insertions(+), 17 deletions(-)

diff --git a/Documentation/hwmon/da9052 b/Documentation/hwmon/da9052
index 5bc51346b689..556e2778b9e5 100644
--- a/Documentation/hwmon/da9052
+++ b/Documentation/hwmon/da9052
@@ -1,6 +1,12 @@
+Kernel driver da9052
+====================
+
 Supported chips:
+
   * Dialog Semiconductors DA9052-BC and DA9053-AA/Bx PMICs
+
     Prefix: 'da9052'
+
     Datasheet: Datasheet is not publicly available.
 
 Authors: David Dajun Chen <dchen@diasemi.com>
@@ -15,17 +21,20 @@ different inputs. The track and hold circuit ensures stable input voltages at
 the input of the ADC during the conversion.
 
 The ADC is used to measure the following inputs:
-Channel 0: VDDOUT - measurement of the system voltage
-Channel 1: ICH - internal battery charger current measurement
-Channel 2: TBAT - output from the battery NTC
-Channel 3: VBAT - measurement of the battery voltage
-Channel 4: ADC_IN4 - high impedance input (0 - 2.5V)
-Channel 5: ADC_IN5 - high impedance input (0 - 2.5V)
-Channel 6: ADC_IN6 - high impedance input (0 - 2.5V)
-Channel 7: XY - TSI interface to measure the X and Y voltage of the touch
-	   screen resistive potentiometers
-Channel 8: Internal Tjunc. - sense (internal temp. sensor)
-Channel 9: VBBAT - measurement of the backup battery voltage
+
+========= ===================================================================
+Channel 0 VDDOUT - measurement of the system voltage
+Channel 1 ICH - internal battery charger current measurement
+Channel 2 TBAT - output from the battery NTC
+Channel 3 VBAT - measurement of the battery voltage
+Channel 4 ADC_IN4 - high impedance input (0 - 2.5V)
+Channel 5 ADC_IN5 - high impedance input (0 - 2.5V)
+Channel 6 ADC_IN6 - high impedance input (0 - 2.5V)
+Channel 7 XY - TSI interface to measure the X and Y voltage of the touch
+	  screen resistive potentiometers
+Channel 8 Internal Tjunc. - sense (internal temp. sensor)
+Channel 9 VBBAT - measurement of the backup battery voltage
+========= ===================================================================
 
 By using sysfs attributes we can measure the system voltage VDDOUT, the battery
 charging current ICH, battery temperature TBAT, battery junction temperature
@@ -37,12 +46,15 @@ Voltage Monitoring
 Voltages are sampled by a 10 bit ADC.
 
 The battery voltage is calculated as:
+
 	Milli volt = ((ADC value * 1000) / 512) + 2500
 
 The backup battery voltage is calculated as:
+
 	Milli volt = (ADC value * 2500) / 512;
 
 The voltages on ADC channels 4, 5 and 6 are calculated as:
+
 	Milli volt = (ADC value * 2500) / 1023
 
 Temperature Monitoring
@@ -52,10 +64,14 @@ Temperatures are sampled by a 10 bit ADC.  Junction and battery temperatures
 are monitored by the ADC channels.
 
 The junction temperature is calculated:
+
 	Degrees celsius = 1.708 * (TJUNC_RES - T_OFFSET) - 108.8
+
 The junction temperature attribute is supported by the driver.
 
 The battery temperature is calculated:
-	Degree Celsius = 1 / (t1 + 1/298)- 273
+
+	Degree Celsius = 1 / (t1 + 1/298) - 273
+
 where t1 = (1/B)* ln(( ADCval * 2.5)/(R25*ITBAT*255))
 Default values of R25, B, ITBAT are 10e3, 3380 and 50e-6 respectively.
diff --git a/Documentation/hwmon/da9055 b/Documentation/hwmon/da9055
index 855c3f536e00..beae271a3312 100644
--- a/Documentation/hwmon/da9055
+++ b/Documentation/hwmon/da9055
@@ -1,6 +1,11 @@
+Kernel driver da9055
+====================
+
 Supported chips:
   * Dialog Semiconductors DA9055 PMIC
+
     Prefix: 'da9055'
+
     Datasheet: Datasheet is not publicly available.
 
 Authors: David Dajun Chen <dchen@diasemi.com>
@@ -15,11 +20,12 @@ different inputs. The track and hold circuit ensures stable input voltages at
 the input of the ADC during the conversion.
 
 The ADC is used to measure the following inputs:
-Channel 0: VDDOUT - measurement of the system voltage
-Channel 1: ADC_IN1 - high impedance input (0 - 2.5V)
-Channel 2: ADC_IN2 - high impedance input (0 - 2.5V)
-Channel 3: ADC_IN3 - high impedance input (0 - 2.5V)
-Channel 4: Internal Tjunc. - sense (internal temp. sensor)
+
+- Channel 0: VDDOUT - measurement of the system voltage
+- Channel 1: ADC_IN1 - high impedance input (0 - 2.5V)
+- Channel 2: ADC_IN2 - high impedance input (0 - 2.5V)
+- Channel 3: ADC_IN3 - high impedance input (0 - 2.5V)
+- Channel 4: Internal Tjunc. - sense (internal temp. sensor)
 
 By using sysfs attributes we can measure the system voltage VDDOUT,
 chip junction temperature and auxiliary channels voltages.
@@ -31,9 +37,11 @@ Voltages are sampled in a AUTO mode it can be manually sampled too and results
 are stored in a 10 bit ADC.
 
 The system voltage is calculated as:
+
 	Milli volt = ((ADC value * 1000) / 85) + 2500
 
 The voltages on ADC channels 1, 2 and 3 are calculated as:
+
 	Milli volt = (ADC value * 1000) / 102
 
 Temperature Monitoring
@@ -43,5 +51,7 @@ Temperatures are sampled by a 10 bit ADC.  Junction temperatures
 are monitored by the ADC channels.
 
 The junction temperature is calculated:
+
 	Degrees celsius = -0.4084 * (ADC_RES - T_OFFSET) + 307.6332
+
 The junction temperature attribute is supported by the driver.
-- 
2.20.1


^ permalink raw reply related	[flat|nested] 73+ messages in thread

* [PATCH v2 17/21] docs: hwmon: k8temp, w83793: convert to ReST format
  2019-04-10 19:22 [PATCH v2 00/21] Convert hwmon documentation to ReST Mauro Carvalho Chehab
                   ` (15 preceding siblings ...)
  2019-04-10 19:22 ` [PATCH v2 16/21] docs: hwmon: da9052, da9055: " Mauro Carvalho Chehab
@ 2019-04-10 19:22 ` Mauro Carvalho Chehab
  2019-04-10 19:22 ` [PATCH v2 18/21] docs: hwmon: pmbus files: " Mauro Carvalho Chehab
                   ` (4 subsequent siblings)
  21 siblings, 0 replies; 73+ messages in thread
From: Mauro Carvalho Chehab @ 2019-04-10 19:22 UTC (permalink / raw)
  To: Linux Doc Mailing List
  Cc: Mauro Carvalho Chehab, Mauro Carvalho Chehab, linux-kernel,
	Jonathan Corbet, Jean Delvare, Guenter Roeck, linux-hwmon

Convert k8temp and w83793 to ReST format, in order to allow them
to be parsed by Sphinx.

Signed-off-by: Mauro Carvalho Chehab <mchehab+samsung@kernel.org>
---
 Documentation/hwmon/k8temp |  17 +++--
 Documentation/hwmon/w83793 | 123 ++++++++++++++++++++-----------------
 2 files changed, 77 insertions(+), 63 deletions(-)

diff --git a/Documentation/hwmon/k8temp b/Documentation/hwmon/k8temp
index 716dc24c7237..72da12aa17e5 100644
--- a/Documentation/hwmon/k8temp
+++ b/Documentation/hwmon/k8temp
@@ -2,12 +2,17 @@ Kernel driver k8temp
 ====================
 
 Supported chips:
+
   * AMD Athlon64/FX or Opteron CPUs
+
     Prefix: 'k8temp'
+
     Addresses scanned: PCI space
+
     Datasheet: http://support.amd.com/us/Processor_TechDocs/32559.pdf
 
 Author: Rudolf Marek
+
 Contact: Rudolf Marek <r.marek@assembler.cz>
 
 Description
@@ -27,10 +32,12 @@ implemented sensors.
 
 Mapping of /sys files is as follows:
 
-temp1_input - temperature of Core 0 and "place" 0
-temp2_input - temperature of Core 0 and "place" 1
-temp3_input - temperature of Core 1 and "place" 0
-temp4_input - temperature of Core 1 and "place" 1
+============= ===================================
+temp1_input   temperature of Core 0 and "place" 0
+temp2_input   temperature of Core 0 and "place" 1
+temp3_input   temperature of Core 1 and "place" 0
+temp4_input   temperature of Core 1 and "place" 1
+============= ===================================
 
 Temperatures are measured in degrees Celsius and measurement resolution is
 1 degree C. It is expected that future CPU will have better resolution. The
@@ -48,7 +55,7 @@ computed temperature called TControl, which must be lower than TControlMax.
 
 The relationship is following:
 
-temp1_input - TjOffset*2 < TControlMax,
+	temp1_input - TjOffset*2 < TControlMax,
 
 TjOffset is not yet exported by the driver, TControlMax is usually
 70 degrees C. The rule of the thumb -> CPU temperature should not cross
diff --git a/Documentation/hwmon/w83793 b/Documentation/hwmon/w83793
index 6cc5f639b721..83bb40c48645 100644
--- a/Documentation/hwmon/w83793
+++ b/Documentation/hwmon/w83793
@@ -2,29 +2,34 @@ Kernel driver w83793
 ====================
 
 Supported chips:
+
   * Winbond W83793G/W83793R
+
     Prefix: 'w83793'
+
     Addresses scanned: I2C 0x2c - 0x2f
+
     Datasheet: Still not published
 
 Authors:
-    Yuan Mu (Winbond Electronics)
-    Rudolf Marek <r.marek@assembler.cz>
+    - Yuan Mu (Winbond Electronics)
+    - Rudolf Marek <r.marek@assembler.cz>
 
 
 Module parameters
 -----------------
 
 * reset int
-  (default 0)
-  This parameter is not recommended, it will lose motherboard specific
-  settings. Use 'reset=1' to reset the chip when loading this module.
+    (default 0)
+
+    This parameter is not recommended, it will lose motherboard specific
+    settings. Use 'reset=1' to reset the chip when loading this module.
 
 * force_subclients=bus,caddr,saddr1,saddr2
-  This is used to force the i2c addresses for subclients of
-  a certain chip. Typical usage is `force_subclients=0,0x2f,0x4a,0x4b'
-  to force the subclients of chip 0x2f on bus 0 to i2c addresses
-  0x4a and 0x4b.
+    This is used to force the i2c addresses for subclients of
+    a certain chip. Typical usage is `force_subclients=0,0x2f,0x4a,0x4b`
+    to force the subclients of chip 0x2f on bus 0 to i2c addresses
+    0x4a and 0x4b.
 
 
 Description
@@ -33,70 +38,72 @@ Description
 This driver implements support for Winbond W83793G/W83793R chips.
 
 * Exported features
-  This driver exports 10 voltage sensors, up to 12 fan tachometer inputs,
-  6 remote temperatures, up to 8 sets of PWM fan controls, SmartFan
-  (automatic fan speed control) on all temperature/PWM combinations, 2
-  sets of 6-pin CPU VID input.
+    This driver exports 10 voltage sensors, up to 12 fan tachometer inputs,
+    6 remote temperatures, up to 8 sets of PWM fan controls, SmartFan
+    (automatic fan speed control) on all temperature/PWM combinations, 2
+    sets of 6-pin CPU VID input.
 
 * Sensor resolutions
-  If your motherboard maker used the reference design, the resolution of
-  voltage0-2 is 2mV, resolution of voltage3/4/5 is 16mV, 8mV for voltage6,
-  24mV for voltage7/8. Temp1-4 have a 0.25 degree Celsius resolution,
-  temp5-6 have a 1 degree Celsiis resolution.
+    If your motherboard maker used the reference design, the resolution of
+    voltage0-2 is 2mV, resolution of voltage3/4/5 is 16mV, 8mV for voltage6,
+    24mV for voltage7/8. Temp1-4 have a 0.25 degree Celsius resolution,
+    temp5-6 have a 1 degree Celsiis resolution.
 
 * Temperature sensor types
-  Temp1-4 have 2 possible types. It can be read from (and written to)
-  temp[1-4]_type.
-  - If the value is 3, it starts monitoring using a remote termal diode
-    (default).
-  - If the value is 6, it starts monitoring using the temperature sensor
-    in Intel CPU and get result by PECI.
-  Temp5-6 can be connected to external thermistors (value of
-  temp[5-6]_type is 4).
+    Temp1-4 have 2 possible types. It can be read from (and written to)
+    temp[1-4]_type.
+
+    - If the value is 3, it starts monitoring using a remote termal diode
+      (default).
+    - If the value is 6, it starts monitoring using the temperature sensor
+      in Intel CPU and get result by PECI.
+
+    Temp5-6 can be connected to external thermistors (value of
+    temp[5-6]_type is 4).
 
 * Alarm mechanism
-  For voltage sensors, an alarm triggers if the measured value is below
-  the low voltage limit or over the high voltage limit.
-  For temperature sensors, an alarm triggers if the measured value goes
-  above the high temperature limit, and wears off only after the measured
-  value drops below the hysteresis value.
-  For fan sensors, an alarm triggers if the measured value is below the
-  low speed limit.
+    For voltage sensors, an alarm triggers if the measured value is below
+    the low voltage limit or over the high voltage limit.
+    For temperature sensors, an alarm triggers if the measured value goes
+    above the high temperature limit, and wears off only after the measured
+    value drops below the hysteresis value.
+    For fan sensors, an alarm triggers if the measured value is below the
+    low speed limit.
 
 * SmartFan/PWM control
-  If you want to set a pwm fan to manual mode, you just need to make sure it
-  is not controlled by any temp channel, for example, you want to set fan1
-  to manual mode, you need to check the value of temp[1-6]_fan_map, make
-  sure bit 0 is cleared in the 6 values. And then set the pwm1 value to
-  control the fan.
+    If you want to set a pwm fan to manual mode, you just need to make sure it
+    is not controlled by any temp channel, for example, you want to set fan1
+    to manual mode, you need to check the value of temp[1-6]_fan_map, make
+    sure bit 0 is cleared in the 6 values. And then set the pwm1 value to
+    control the fan.
 
-  Each temperature channel can control all the 8 PWM outputs (by setting the
-  corresponding bit in tempX_fan_map), you can set the temperature channel
-  mode using temp[1-6]_pwm_enable, 2 is Thermal Cruise mode and 3
-  is the SmartFanII mode. Temperature channels will try to speed up or
-  slow down all controlled fans, this means one fan can receive different
-  PWM value requests from different temperature channels, but the chip
-  will always pick the safest (max) PWM value for each fan.
+    Each temperature channel can control all the 8 PWM outputs (by setting the
+    corresponding bit in tempX_fan_map), you can set the temperature channel
+    mode using temp[1-6]_pwm_enable, 2 is Thermal Cruise mode and 3
+    is the SmartFanII mode. Temperature channels will try to speed up or
+    slow down all controlled fans, this means one fan can receive different
+    PWM value requests from different temperature channels, but the chip
+    will always pick the safest (max) PWM value for each fan.
 
-  In Thermal Cruise mode, the chip attempts to keep the temperature at a
-  predefined value, within a tolerance margin. So if tempX_input >
-  thermal_cruiseX + toleranceX, the chip will increase the PWM value,
-  if tempX_input < thermal_cruiseX - toleranceX, the chip will decrease
-  the PWM value. If the temperature is within the tolerance range, the PWM
-  value is left unchanged.
+    In Thermal Cruise mode, the chip attempts to keep the temperature at a
+    predefined value, within a tolerance margin. So if tempX_input >
+    thermal_cruiseX + toleranceX, the chip will increase the PWM value,
+    if tempX_input < thermal_cruiseX - toleranceX, the chip will decrease
+    the PWM value. If the temperature is within the tolerance range, the PWM
+    value is left unchanged.
 
-  SmartFanII works differently, you have to define up to 7 PWM, temperature
-  trip points, defining a PWM/temperature curve which the chip will follow.
-  While not fundamentally different from the Thermal Cruise mode, the
-  implementation is quite different, giving you a finer-grained control.
+    SmartFanII works differently, you have to define up to 7 PWM, temperature
+    trip points, defining a PWM/temperature curve which the chip will follow.
+    While not fundamentally different from the Thermal Cruise mode, the
+    implementation is quite different, giving you a finer-grained control.
 
 * Chassis
-  If the case open alarm triggers, it will stay in this state unless cleared
-  by writing 0 to the sysfs file "intrusion0_alarm".
+    If the case open alarm triggers, it will stay in this state unless cleared
+    by writing 0 to the sysfs file "intrusion0_alarm".
 
 * VID and VRM
-  The VRM version is detected automatically, don't modify the it unless you
-  *do* know the cpu VRM version and it's not properly detected.
+    The VRM version is detected automatically, don't modify the it unless you
+    *do* know the cpu VRM version and it's not properly detected.
 
 
 Notes
-- 
2.20.1


^ permalink raw reply related	[flat|nested] 73+ messages in thread

* [PATCH v2 18/21] docs: hwmon: pmbus files: convert to ReST format
  2019-04-10 19:22 [PATCH v2 00/21] Convert hwmon documentation to ReST Mauro Carvalho Chehab
                   ` (16 preceding siblings ...)
  2019-04-10 19:22 ` [PATCH v2 17/21] docs: hwmon: k8temp, w83793: " Mauro Carvalho Chehab
@ 2019-04-10 19:22 ` Mauro Carvalho Chehab
  2019-04-10 19:22 ` [PATCH v2 19/21] docs: hwmon: misc " Mauro Carvalho Chehab
                   ` (3 subsequent siblings)
  21 siblings, 0 replies; 73+ messages in thread
From: Mauro Carvalho Chehab @ 2019-04-10 19:22 UTC (permalink / raw)
  To: Linux Doc Mailing List
  Cc: Mauro Carvalho Chehab, Mauro Carvalho Chehab, linux-kernel,
	Jonathan Corbet, Jean Delvare, Guenter Roeck, linux-hwmon

Convert pmbus files to ReST format, in order to allow them to
be parsed by Sphinx.

Signed-off-by: Mauro Carvalho Chehab <mchehab+samsung@kernel.org>
---
 Documentation/hwmon/adm1275    |  26 ++++
 Documentation/hwmon/ibm-cffps  |   3 +
 Documentation/hwmon/ir35221    |  12 +-
 Documentation/hwmon/lm25066    |  30 ++++
 Documentation/hwmon/ltc2978    | 267 +++++++++++++++++++++++++--------
 Documentation/hwmon/ltc3815    |  12 +-
 Documentation/hwmon/max16064   |  15 +-
 Documentation/hwmon/max20751   |   7 +
 Documentation/hwmon/max31785   |   6 +
 Documentation/hwmon/max34440   |  88 +++++++++--
 Documentation/hwmon/max8688    |  18 ++-
 Documentation/hwmon/pmbus      |  90 +++++++----
 Documentation/hwmon/pmbus-core | 173 ++++++++++++---------
 Documentation/hwmon/tps40422   |  23 ++-
 Documentation/hwmon/ucd9000    |  31 ++--
 Documentation/hwmon/ucd9200    |  42 ++++--
 Documentation/hwmon/zl6100     |  69 ++++++++-
 17 files changed, 685 insertions(+), 227 deletions(-)

diff --git a/Documentation/hwmon/adm1275 b/Documentation/hwmon/adm1275
index 5e277b0d91ce..5c5860011d6e 100644
--- a/Documentation/hwmon/adm1275
+++ b/Documentation/hwmon/adm1275
@@ -2,29 +2,53 @@ Kernel driver adm1275
 =====================
 
 Supported chips:
+
   * Analog Devices ADM1075
+
     Prefix: 'adm1075'
+
     Addresses scanned: -
+
     Datasheet: www.analog.com/static/imported-files/data_sheets/ADM1075.pdf
+
   * Analog Devices ADM1272
+
     Prefix: 'adm1272'
+
     Addresses scanned: -
+
     Datasheet: www.analog.com/static/imported-files/data_sheets/ADM1272.pdf
+
   * Analog Devices ADM1275
+
     Prefix: 'adm1275'
+
     Addresses scanned: -
+
     Datasheet: www.analog.com/static/imported-files/data_sheets/ADM1275.pdf
+
   * Analog Devices ADM1276
+
     Prefix: 'adm1276'
+
     Addresses scanned: -
+
     Datasheet: www.analog.com/static/imported-files/data_sheets/ADM1276.pdf
+
   * Analog Devices ADM1278
+
     Prefix: 'adm1278'
+
     Addresses scanned: -
+
     Datasheet: www.analog.com/static/imported-files/data_sheets/ADM1278.pdf
+
   * Analog Devices ADM1293/ADM1294
+
     Prefix: 'adm1293', 'adm1294'
+
     Addresses scanned: -
+
     Datasheet: http://www.analog.com/media/en/technical-documentation/data-sheets/ADM1293_1294.pdf
 
 Author: Guenter Roeck <linux@roeck-us.net>
@@ -75,6 +99,7 @@ Sysfs entries
 The following attributes are supported. Limits are read-write, history reset
 attributes are write-only, all other attributes are read-only.
 
+======================= =======================================================
 inX_label		"vin1" or "vout1" depending on chip variant and
 			configuration. On ADM1075, ADM1293, and ADM1294,
 			vout1 reports the voltage on the VAUX pin.
@@ -120,3 +145,4 @@ temp1_reset_history	Write any value to reset history.
 
 			Temperature attributes are supported on ADM1272 and
 			ADM1278.
+======================= =======================================================
diff --git a/Documentation/hwmon/ibm-cffps b/Documentation/hwmon/ibm-cffps
index e05ecd8ecfcf..52e74e39463a 100644
--- a/Documentation/hwmon/ibm-cffps
+++ b/Documentation/hwmon/ibm-cffps
@@ -2,6 +2,7 @@ Kernel driver ibm-cffps
 =======================
 
 Supported chips:
+
   * IBM Common Form Factor power supply
 
 Author: Eddie James <eajames@us.ibm.com>
@@ -24,6 +25,7 @@ Sysfs entries
 
 The following attributes are supported:
 
+======================= ======================================================
 curr1_alarm		Output current over-current alarm.
 curr1_input		Measured output current in mA.
 curr1_label		"iout1"
@@ -52,3 +54,4 @@ temp2_alarm		Secondary rectifier temp over-temperature alarm.
 temp2_input		Measured secondary rectifier temp in millidegrees C.
 temp3_alarm		ORing FET temperature over-temperature alarm.
 temp3_input		Measured ORing FET temperature in millidegrees C.
+======================= ======================================================
diff --git a/Documentation/hwmon/ir35221 b/Documentation/hwmon/ir35221
index f7e112752c04..4e757a766177 100644
--- a/Documentation/hwmon/ir35221
+++ b/Documentation/hwmon/ir35221
@@ -2,9 +2,13 @@ Kernel driver ir35221
 =====================
 
 Supported chips:
+
   * Infinion IR35221
+
     Prefix: 'ir35221'
+
     Addresses scanned: -
+
     Datasheet: Datasheet is not publicly available.
 
 Author: Samuel Mendoza-Jonas <sam@mendozajonas.com>
@@ -23,15 +27,16 @@ This driver does not probe for PMBus devices. You will have to instantiate
 devices explicitly.
 
 Example: the following commands will load the driver for an IR35221
-at address 0x70 on I2C bus #4:
+at address 0x70 on I2C bus #4::
 
-# modprobe ir35221
-# echo ir35221 0x70 > /sys/bus/i2c/devices/i2c-4/new_device
+	# modprobe ir35221
+	# echo ir35221 0x70 > /sys/bus/i2c/devices/i2c-4/new_device
 
 
 Sysfs attributes
 ----------------
 
+======================= =======================================================
 curr1_label		"iin"
 curr1_input		Measured input current
 curr1_max		Maximum current
@@ -85,3 +90,4 @@ temp[1-2]_highest	Highest temperature
 temp[1-2]_lowest	Lowest temperature
 temp[1-2]_max		Maximum temperature
 temp[1-2]_max_alarm	Chip temperature high alarm
+======================= =======================================================
diff --git a/Documentation/hwmon/lm25066 b/Documentation/hwmon/lm25066
index 51b32aa203a8..60b7f2722931 100644
--- a/Documentation/hwmon/lm25066
+++ b/Documentation/hwmon/lm25066
@@ -2,34 +2,62 @@ Kernel driver lm25066
 =====================
 
 Supported chips:
+
   * TI LM25056
+
     Prefix: 'lm25056'
+
     Addresses scanned: -
+
     Datasheets:
+
 	http://www.ti.com/lit/gpn/lm25056
+
 	http://www.ti.com/lit/gpn/lm25056a
+
   * National Semiconductor LM25066
+
     Prefix: 'lm25066'
+
     Addresses scanned: -
+
     Datasheets:
+
 	http://www.national.com/pf/LM/LM25066.html
+
 	http://www.national.com/pf/LM/LM25066A.html
+
   * National Semiconductor LM5064
+
     Prefix: 'lm5064'
+
     Addresses scanned: -
+
     Datasheet:
+
 	http://www.national.com/pf/LM/LM5064.html
+
   * National Semiconductor LM5066
+
     Prefix: 'lm5066'
+
     Addresses scanned: -
+
     Datasheet:
+
 	http://www.national.com/pf/LM/LM5066.html
+
   * Texas Instruments LM5066I
+
     Prefix: 'lm5066i'
+
     Addresses scanned: -
+
 	Datasheet:
+
     http://www.ti.com/product/LM5066I
 
+
 Author: Guenter Roeck <linux@roeck-us.net>
 
 
@@ -64,6 +92,7 @@ Sysfs entries
 The following attributes are supported. Limits are read-write; all other
 attributes are read-only.
 
+======================= =======================================================
 in1_label		"vin"
 in1_input		Measured input voltage.
 in1_average		Average measured input voltage.
@@ -105,3 +134,4 @@ temp1_max		Maximum temperature.
 temp1_crit		Critical high temperature.
 temp1_max_alarm		Chip temperature high alarm.
 temp1_crit_alarm	Chip temperature critical high alarm.
+======================= =======================================================
diff --git a/Documentation/hwmon/ltc2978 b/Documentation/hwmon/ltc2978
index dfb2caa401d9..01a24fd6d5fe 100644
--- a/Documentation/hwmon/ltc2978
+++ b/Documentation/hwmon/ltc2978
@@ -2,85 +2,143 @@ Kernel driver ltc2978
 =====================
 
 Supported chips:
+
   * Linear Technology LTC2974
+
     Prefix: 'ltc2974'
+
     Addresses scanned: -
+
     Datasheet: http://www.linear.com/product/ltc2974
+
   * Linear Technology LTC2975
+
     Prefix: 'ltc2975'
+
     Addresses scanned: -
+
     Datasheet: http://www.linear.com/product/ltc2975
+
   * Linear Technology LTC2977
+
     Prefix: 'ltc2977'
+
     Addresses scanned: -
+
     Datasheet: http://www.linear.com/product/ltc2977
+
   * Linear Technology LTC2978, LTC2978A
+
     Prefix: 'ltc2978'
+
     Addresses scanned: -
+
     Datasheet: http://www.linear.com/product/ltc2978
-    	       http://www.linear.com/product/ltc2978a
+
+	       http://www.linear.com/product/ltc2978a
+
   * Linear Technology LTC2980
+
     Prefix: 'ltc2980'
+
     Addresses scanned: -
+
     Datasheet: http://www.linear.com/product/ltc2980
+
   * Linear Technology LTC3880
+
     Prefix: 'ltc3880'
+
     Addresses scanned: -
+
     Datasheet: http://www.linear.com/product/ltc3880
+
   * Linear Technology LTC3882
+
     Prefix: 'ltc3882'
+
     Addresses scanned: -
+
     Datasheet: http://www.linear.com/product/ltc3882
+
   * Linear Technology LTC3883
+
     Prefix: 'ltc3883'
+
     Addresses scanned: -
+
     Datasheet: http://www.linear.com/product/ltc3883
+
   * Linear Technology LTC3886
+
     Prefix: 'ltc3886'
+
     Addresses scanned: -
+
     Datasheet: http://www.linear.com/product/ltc3886
+
   * Linear Technology LTC3887
+
     Prefix: 'ltc3887'
+
     Addresses scanned: -
+
     Datasheet: http://www.linear.com/product/ltc3887
+
   * Linear Technology LTM2987
+
     Prefix: 'ltm2987'
+
     Addresses scanned: -
+
     Datasheet: http://www.linear.com/product/ltm2987
+
   * Linear Technology LTM4675
+
     Prefix: 'ltm4675'
+
     Addresses scanned: -
+
     Datasheet: http://www.linear.com/product/ltm4675
+
   * Linear Technology LTM4676
+
     Prefix: 'ltm4676'
+
     Addresses scanned: -
+
     Datasheet: http://www.linear.com/product/ltm4676
+
   * Analog Devices LTM4686
+
     Prefix: 'ltm4686'
+
     Addresses scanned: -
+
     Datasheet: http://www.analog.com/ltm4686
 
+
 Author: Guenter Roeck <linux@roeck-us.net>
 
 
 Description
 -----------
 
-LTC2974 and LTC2975 are quad digital power supply managers.
-LTC2978 is an octal power supply monitor.
-LTC2977 is a pin compatible replacement for LTC2978.
-LTC2980 is a 16-channel Power System Manager, consisting of two LTC2977
-in a single die. The chip is instantiated and reported as two separate chips
-on two different I2C bus addresses.
-LTC3880, LTC3882, LTC3886, and LTC3887 are dual output poly-phase step-down
-DC/DC controllers.
-LTC3883 is a single phase step-down DC/DC controller.
-LTM2987 is a 16-channel Power System Manager with two LTC2977 plus
-additional components on a single die. The chip is instantiated and reported
-as two separate chips on two different I2C bus addresses.
-LTM4675 is a dual 9A or single 18A μModule regulator
-LTM4676 is a dual 13A or single 26A uModule regulator.
-LTM4686 is a dual 10A or single 20A uModule regulator.
+- LTC2974 and LTC2975 are quad digital power supply managers.
+- LTC2978 is an octal power supply monitor.
+- LTC2977 is a pin compatible replacement for LTC2978.
+- LTC2980 is a 16-channel Power System Manager, consisting of two LTC2977
+- in a single die. The chip is instantiated and reported as two separate chips
+- on two different I2C bus addresses.
+- LTC3880, LTC3882, LTC3886, and LTC3887 are dual output poly-phase step-down
+- DC/DC controllers.
+- LTC3883 is a single phase step-down DC/DC controller.
+- LTM2987 is a 16-channel Power System Manager with two LTC2977 plus
+- additional components on a single die. The chip is instantiated and reported
+- as two separate chips on two different I2C bus addresses.
+- LTM4675 is a dual 9A or single 18A μModule regulator
+- LTM4676 is a dual 13A or single 26A uModule regulator.
+- LTM4686 is a dual 10A or single 20A uModule regulator.
 
 
 Usage Notes
@@ -90,127 +148,208 @@ This driver does not probe for PMBus devices. You will have to instantiate
 devices explicitly.
 
 Example: the following commands will load the driver for an LTC2978 at address
-0x60 on I2C bus #1:
+0x60 on I2C bus #1::
 
-# modprobe ltc2978
-# echo ltc2978 0x60 > /sys/bus/i2c/devices/i2c-1/new_device
+	# modprobe ltc2978
+	# echo ltc2978 0x60 > /sys/bus/i2c/devices/i2c-1/new_device
 
 
 Sysfs attributes
 ----------------
 
+======================= ========================================================
 in1_label		"vin"
+
 in1_input		Measured input voltage.
+
 in1_min			Minimum input voltage.
+
 in1_max			Maximum input voltage.
+
 			LTC2974, LTC2975, LTC2977, LTC2980, LTC2978, and
 			LTM2987 only.
+
 in1_lcrit		Critical minimum input voltage.
+
 			LTC2974, LTC2975, LTC2977, LTC2980, LTC2978, and
 			LTM2987 only.
+
 in1_crit		Critical maximum input voltage.
+
 in1_min_alarm		Input voltage low alarm.
+
 in1_max_alarm		Input voltage high alarm.
+
 			LTC2974, LTC2975, LTC2977, LTC2980, LTC2978, and
 			LTM2987 only.
 in1_lcrit_alarm		Input voltage critical low alarm.
+
 			LTC2974, LTC2975, LTC2977, LTC2980, LTC2978, and
 			LTM2987 only.
 in1_crit_alarm		Input voltage critical high alarm.
+
 in1_lowest		Lowest input voltage.
+
 			LTC2974, LTC2975, LTC2977, LTC2980, LTC2978, and
 			LTM2987 only.
 in1_highest		Highest input voltage.
+
 in1_reset_history	Reset input voltage history.
 
 in[N]_label		"vout[1-8]".
-			LTC2974, LTC2975: N=2-5
-			LTC2977, LTC2980, LTM2987: N=2-9
-			LTC2978: N=2-9
-			LTC3880, LTC3882, LTC23886 LTC3887, LTM4675, LTM4676:
-				N=2-3
-			LTC3883: N=2
+
+			- LTC2974, LTC2975: N=2-5
+			- LTC2977, LTC2980, LTM2987: N=2-9
+			- LTC2978: N=2-9
+			- LTC3880, LTC3882, LTC23886 LTC3887, LTM4675, LTM4676:
+			  N=2-3
+			- LTC3883: N=2
+
 in[N]_input		Measured output voltage.
+
 in[N]_min		Minimum output voltage.
+
 in[N]_max		Maximum output voltage.
+
 in[N]_lcrit		Critical minimum output voltage.
+
 in[N]_crit		Critical maximum output voltage.
+
 in[N]_min_alarm		Output voltage low alarm.
+
 in[N]_max_alarm		Output voltage high alarm.
+
 in[N]_lcrit_alarm	Output voltage critical low alarm.
+
 in[N]_crit_alarm	Output voltage critical high alarm.
-in[N]_lowest		Lowest output voltage. LTC2974, LTC2975,
-			and LTC2978 only.
+
+in[N]_lowest		Lowest output voltage.
+
+
+			LTC2974, LTC2975,and LTC2978 only.
+
 in[N]_highest		Highest output voltage.
+
 in[N]_reset_history	Reset output voltage history.
 
 temp[N]_input		Measured temperature.
-			On LTC2974 and LTC2975, temp[1-4] report external
-			temperatures, and temp5 reports the chip temperature.
-			On LTC2977, LTC2980, LTC2978, and LTM2987, only one
-			temperature measurement is supported and reports
-			the chip temperature.
-			On LTC3880, LTC3882, LTC3887, LTM4675, and LTM4676,
-			temp1 and temp2 report external temperatures, and temp3
-			reports the chip temperature.
-			On LTC3883, temp1 reports an external temperature,
-			and temp2 reports the chip temperature.
-temp[N]_min		Mimimum temperature. LTC2974, LCT2977, LTM2980, LTC2978,
-			and LTM2987 only.
+
+			- On LTC2974 and LTC2975, temp[1-4] report external
+			  temperatures, and temp5 reports the chip temperature.
+			- On LTC2977, LTC2980, LTC2978, and LTM2987, only one
+			  temperature measurement is supported and reports
+			  the chip temperature.
+			- On LTC3880, LTC3882, LTC3887, LTM4675, and LTM4676,
+			  temp1 and temp2 report external temperatures, and
+			  temp3 reports the chip temperature.
+			- On LTC3883, temp1 reports an external temperature,
+			  and temp2 reports the chip temperature.
+
+temp[N]_min		Mimimum temperature.
+
+			LTC2974, LCT2977, LTM2980, LTC2978, and LTM2987 only.
+
 temp[N]_max		Maximum temperature.
+
 temp[N]_lcrit		Critical low temperature.
+
 temp[N]_crit		Critical high temperature.
+
 temp[N]_min_alarm	Temperature low alarm.
+
 			LTC2974, LTC2975, LTC2977, LTM2980, LTC2978, and
 			LTM2987 only.
+
 temp[N]_max_alarm	Temperature high alarm.
+
+
 temp[N]_lcrit_alarm	Temperature critical low alarm.
+
 temp[N]_crit_alarm	Temperature critical high alarm.
+
 temp[N]_lowest		Lowest measured temperature.
-			LTC2974, LTC2975, LTC2977, LTM2980, LTC2978, and
-			LTM2987 only.
-			Not supported for chip temperature sensor on LTC2974 and
-			LTC2975.
-temp[N]_highest		Highest measured temperature. Not supported for chip
-			temperature sensor on LTC2974 and LTC2975.
-temp[N]_reset_history	Reset temperature history. Not supported for chip
-			temperature sensor on LTC2974 and LTC2975.
+
+			- LTC2974, LTC2975, LTC2977, LTM2980, LTC2978, and
+			  LTM2987 only.
+			- Not supported for chip temperature sensor on LTC2974
+			  and LTC2975.
+
+temp[N]_highest		Highest measured temperature.
+
+			Not supported for chip temperature sensor on
+			LTC2974 and LTC2975.
+
+temp[N]_reset_history	Reset temperature history.
+
+			Not supported for chip temperature sensor on
+			LTC2974 and LTC2975.
 
 power1_label		"pin". LTC3883 and LTC3886 only.
+
 power1_input		Measured input power.
 
 power[N]_label		"pout[1-4]".
-			LTC2974, LTC2975: N=1-4
-			LTC2977, LTC2980, LTM2987: Not supported
-			LTC2978: Not supported
-			LTC3880, LTC3882, LTC3886, LTC3887, LTM4675, LTM4676:
-				N=1-2
-			LTC3883: N=2
+
+			- LTC2974, LTC2975: N=1-4
+			- LTC2977, LTC2980, LTM2987: Not supported
+			- LTC2978: Not supported
+			- LTC3880, LTC3882, LTC3886, LTC3887, LTM4675, LTM4676:
+			  N=1-2
+			- LTC3883: N=2
+
 power[N]_input		Measured output power.
 
-curr1_label		"iin". LTC3880, LTC3883, LTC3886, LTC3887, LTM4675,
+curr1_label		"iin".
+
+			LTC3880, LTC3883, LTC3886, LTC3887, LTM4675,
 			and LTM4676 only.
+
 curr1_input		Measured input current.
+
 curr1_max		Maximum input current.
+
 curr1_max_alarm		Input current high alarm.
-curr1_highest		Highest input current. LTC3883 and LTC3886 only.
-curr1_reset_history	Reset input current history. LTC3883 and LTC3886 only.
+
+curr1_highest		Highest input current.
+
+			LTC3883 and LTC3886 only.
+
+curr1_reset_history	Reset input current history.
+
+			LTC3883 and LTC3886 only.
 
 curr[N]_label		"iout[1-4]".
-			LTC2974, LTC2975: N=1-4
-			LTC2977, LTC2980, LTM2987: not supported
-			LTC2978: not supported
-			LTC3880, LTC3882, LTC3886, LTC3887, LTM4675, LTM4676:
-				N=2-3
-			LTC3883: N=2
+
+			- LTC2974, LTC2975: N=1-4
+			- LTC2977, LTC2980, LTM2987: not supported
+			- LTC2978: not supported
+			- LTC3880, LTC3882, LTC3886, LTC3887, LTM4675, LTM4676:
+			  N=2-3
+			- LTC3883: N=2
+
 curr[N]_input		Measured output current.
+
 curr[N]_max		Maximum output current.
+
 curr[N]_crit		Critical high output current.
-curr[N]_lcrit		Critical low output current. LTC2974 and LTC2975 only.
+
+curr[N]_lcrit		Critical low output current.
+
+			LTC2974 and LTC2975 only.
+
 curr[N]_max_alarm	Output current high alarm.
+
 curr[N]_crit_alarm	Output current critical high alarm.
+
 curr[N]_lcrit_alarm	Output current critical low alarm.
+
 			LTC2974 and LTC2975 only.
-curr[N]_lowest		Lowest output current. LTC2974 and LTC2975 only.
+
+curr[N]_lowest		Lowest output current.
+
+			LTC2974 and LTC2975 only.
+
 curr[N]_highest		Highest output current.
+
 curr[N]_reset_history	Reset output current history.
+======================= ========================================================
diff --git a/Documentation/hwmon/ltc3815 b/Documentation/hwmon/ltc3815
index eb7db2d13587..fb0135fc1925 100644
--- a/Documentation/hwmon/ltc3815
+++ b/Documentation/hwmon/ltc3815
@@ -2,9 +2,13 @@ Kernel driver ltc3815
 =====================
 
 Supported chips:
+
   * Linear Technology LTC3815
+
     Prefix: 'ltc3815'
+
     Addresses scanned: -
+
     Datasheet: http://www.linear.com/product/ltc3815
 
 Author: Guenter Roeck <linux@roeck-us.net>
@@ -23,15 +27,16 @@ This driver does not probe for PMBus devices. You will have to instantiate
 devices explicitly.
 
 Example: the following commands will load the driver for an LTC3815
-at address 0x20 on I2C bus #1:
+at address 0x20 on I2C bus #1::
 
-# modprobe ltc3815
-# echo ltc3815 0x20 > /sys/bus/i2c/devices/i2c-1/new_device
+	# modprobe ltc3815
+	# echo ltc3815 0x20 > /sys/bus/i2c/devices/i2c-1/new_device
 
 
 Sysfs attributes
 ----------------
 
+======================= =======================================================
 in1_label		"vin"
 in1_input		Measured input voltage.
 in1_alarm		Input voltage alarm.
@@ -59,3 +64,4 @@ curr2_input		Measured output current.
 curr2_alarm		Output current alarm.
 curr2_highest		Highest output current.
 curr2_reset_history	Reset output current history.
+======================= =======================================================
diff --git a/Documentation/hwmon/max16064 b/Documentation/hwmon/max16064
index 265370f5cb82..61ec679dc477 100644
--- a/Documentation/hwmon/max16064
+++ b/Documentation/hwmon/max16064
@@ -2,9 +2,13 @@ Kernel driver max16064
 ======================
 
 Supported chips:
+
   * Maxim MAX16064
+
     Prefix: 'max16064'
+
     Addresses scanned: -
+
     Datasheet: http://datasheets.maxim-ic.com/en/ds/MAX16064.pdf
 
 Author: Guenter Roeck <linux@roeck-us.net>
@@ -40,16 +44,20 @@ Sysfs entries
 The following attributes are supported. Limits are read-write; all other
 attributes are read-only.
 
+======================= ========================================================
 in[1-4]_label		"vout[1-4]"
 in[1-4]_input		Measured voltage. From READ_VOUT register.
 in[1-4]_min		Minimum Voltage. From VOUT_UV_WARN_LIMIT register.
 in[1-4]_max		Maximum voltage. From VOUT_OV_WARN_LIMIT register.
 in[1-4]_lcrit		Critical minimum Voltage. VOUT_UV_FAULT_LIMIT register.
-in[1-4]_crit		Critical maximum voltage. From VOUT_OV_FAULT_LIMIT register.
+in[1-4]_crit		Critical maximum voltage. From VOUT_OV_FAULT_LIMIT
+			register.
 in[1-4]_min_alarm	Voltage low alarm. From VOLTAGE_UV_WARNING status.
 in[1-4]_max_alarm	Voltage high alarm. From VOLTAGE_OV_WARNING status.
-in[1-4]_lcrit_alarm	Voltage critical low alarm. From VOLTAGE_UV_FAULT status.
-in[1-4]_crit_alarm	Voltage critical high alarm. From VOLTAGE_OV_FAULT status.
+in[1-4]_lcrit_alarm	Voltage critical low alarm. From VOLTAGE_UV_FAULT
+			status.
+in[1-4]_crit_alarm	Voltage critical high alarm. From VOLTAGE_OV_FAULT
+			status.
 in[1-4]_highest		Historical maximum voltage.
 in[1-4]_reset_history	Write any value to reset history.
 
@@ -64,3 +72,4 @@ temp1_crit_alarm	Chip temperature critical high alarm. Set by comparing
 			status is set.
 temp1_highest		Historical maximum temperature.
 temp1_reset_history	Write any value to reset history.
+======================= ========================================================
diff --git a/Documentation/hwmon/max20751 b/Documentation/hwmon/max20751
index f9fa25ebb521..d546695900ef 100644
--- a/Documentation/hwmon/max20751
+++ b/Documentation/hwmon/max20751
@@ -2,10 +2,15 @@ Kernel driver max20751
 ======================
 
 Supported chips:
+
   * maxim MAX20751
+
     Prefix: 'max20751'
+
     Addresses scanned: -
+
     Datasheet: http://datasheets.maximintegrated.com/en/ds/MAX20751.pdf
+
     Application note: http://pdfserv.maximintegrated.com/en/an/AN5941.pdf
 
 Author: Guenter Roeck <linux@roeck-us.net>
@@ -40,6 +45,7 @@ Sysfs entries
 
 The following attributes are supported.
 
+======================= =======================================================
 in1_label		"vin1"
 in1_input		Measured voltage.
 in1_min			Minimum input voltage.
@@ -75,3 +81,4 @@ temp1_crit_alarm	Chip temperature critical high alarm.
 
 power1_input		Output power.
 power1_label		"pout1"
+======================= =======================================================
diff --git a/Documentation/hwmon/max31785 b/Documentation/hwmon/max31785
index 270c5f865261..c8c6756d0ee1 100644
--- a/Documentation/hwmon/max31785
+++ b/Documentation/hwmon/max31785
@@ -2,9 +2,13 @@ Kernel driver max31785
 ======================
 
 Supported chips:
+
   * Maxim MAX31785, MAX31785A
+
     Prefix: 'max31785' or 'max31785a'
+
     Addresses scanned: -
+
     Datasheet: https://datasheets.maximintegrated.com/en/ds/MAX31785.pdf
 
 Author: Andrew Jeffery <andrew@aj.id.au>
@@ -30,6 +34,7 @@ devices explicitly.
 Sysfs attributes
 ----------------
 
+======================= =======================================================
 fan[1-4]_alarm		Fan alarm.
 fan[1-4]_fault		Fan fault.
 fan[1-8]_input		Fan RPM. On the MAX31785A, inputs 5-8 correspond to the
@@ -58,3 +63,4 @@ temp[1-11]_crit_alarm	Chip temperature critical high alarm
 temp[1-11]_input	Measured temperature
 temp[1-11]_max		Maximum temperature
 temp[1-11]_max_alarm	Chip temperature high alarm
+======================= =======================================================
diff --git a/Documentation/hwmon/max34440 b/Documentation/hwmon/max34440
index b2de8fa49273..639838ef29fd 100644
--- a/Documentation/hwmon/max34440
+++ b/Documentation/hwmon/max34440
@@ -2,34 +2,63 @@ Kernel driver max34440
 ======================
 
 Supported chips:
+
   * Maxim MAX34440
+
     Prefixes: 'max34440'
+
     Addresses scanned: -
+
     Datasheet: http://datasheets.maximintegrated.com/en/ds/MAX34440.pdf
+
   * Maxim MAX34441
+
     PMBus 5-Channel Power-Supply Manager and Intelligent Fan Controller
+
     Prefixes: 'max34441'
+
     Addresses scanned: -
+
     Datasheet: http://datasheets.maximintegrated.com/en/ds/MAX34441.pdf
+
   * Maxim MAX34446
+
     PMBus Power-Supply Data Logger
+
     Prefixes: 'max34446'
+
     Addresses scanned: -
+
     Datasheet: http://datasheets.maximintegrated.com/en/ds/MAX34446.pdf
+
   * Maxim MAX34451
+
     PMBus 16-Channel V/I Monitor and 12-Channel Sequencer/Marginer
+
     Prefixes: 'max34451'
+
     Addresses scanned: -
+
     Datasheet: http://datasheets.maximintegrated.com/en/ds/MAX34451.pdf
+
   * Maxim MAX34460
+
     PMBus 12-Channel Voltage Monitor & Sequencer
+
     Prefix: 'max34460'
+
     Addresses scanned: -
+
     Datasheet: http://datasheets.maximintegrated.com/en/ds/MAX34460.pdf
+
   * Maxim MAX34461
+
     PMBus 16-Channel Voltage Monitor & Sequencer
+
     Prefix: 'max34461'
+
     Addresses scanned: -
+
     Datasheet: http://datasheets.maximintegrated.com/en/ds/MAX34461.pdf
 
 Author: Guenter Roeck <linux@roeck-us.net>
@@ -77,42 +106,67 @@ Sysfs entries
 The following attributes are supported. Limits are read-write; all other
 attributes are read-only.
 
+In
+~~
+
+======================= =======================================================
 in[1-6]_label		"vout[1-6]".
 in[1-6]_input		Measured voltage. From READ_VOUT register.
 in[1-6]_min		Minimum Voltage. From VOUT_UV_WARN_LIMIT register.
 in[1-6]_max		Maximum voltage. From VOUT_OV_WARN_LIMIT register.
 in[1-6]_lcrit		Critical minimum Voltage. VOUT_UV_FAULT_LIMIT register.
-in[1-6]_crit		Critical maximum voltage. From VOUT_OV_FAULT_LIMIT register.
+in[1-6]_crit		Critical maximum voltage. From VOUT_OV_FAULT_LIMIT
+			register.
 in[1-6]_min_alarm	Voltage low alarm. From VOLTAGE_UV_WARNING status.
 in[1-6]_max_alarm	Voltage high alarm. From VOLTAGE_OV_WARNING status.
-in[1-6]_lcrit_alarm	Voltage critical low alarm. From VOLTAGE_UV_FAULT status.
-in[1-6]_crit_alarm	Voltage critical high alarm. From VOLTAGE_OV_FAULT status.
+in[1-6]_lcrit_alarm	Voltage critical low alarm. From VOLTAGE_UV_FAULT
+			status.
+in[1-6]_crit_alarm	Voltage critical high alarm. From VOLTAGE_OV_FAULT
+			status.
 in[1-6]_lowest		Historical minimum voltage.
 in[1-6]_highest		Historical maximum voltage.
 in[1-6]_reset_history	Write any value to reset history.
+======================= =======================================================
 
-			MAX34446 only supports in[1-4].
+.. note:: MAX34446 only supports in[1-4].
 
+Curr
+~~~~
+
+======================= ========================================================
 curr[1-6]_label		"iout[1-6]".
 curr[1-6]_input		Measured current. From READ_IOUT register.
 curr[1-6]_max		Maximum current. From IOUT_OC_WARN_LIMIT register.
-curr[1-6]_crit		Critical maximum current. From IOUT_OC_FAULT_LIMIT register.
+curr[1-6]_crit		Critical maximum current. From IOUT_OC_FAULT_LIMIT
+			register.
 curr[1-6]_max_alarm	Current high alarm. From IOUT_OC_WARNING status.
 curr[1-6]_crit_alarm	Current critical high alarm. From IOUT_OC_FAULT status.
 curr[1-4]_average	Historical average current (MAX34446/34451 only).
 curr[1-6]_highest	Historical maximum current.
 curr[1-6]_reset_history	Write any value to reset history.
+======================= ========================================================
 
-			in6 and curr6 attributes only exist for MAX34440.
-			MAX34446 only supports curr[1-4].
+.. note::
 
+    - in6 and curr6 attributes only exist for MAX34440.
+    - MAX34446 only supports curr[1-4].
+
+Power
+~~~~~
+
+======================= ========================================================
 power[1,3]_label	"pout[1,3]"
 power[1,3]_input	Measured power.
 power[1,3]_average	Historical average power.
 power[1,3]_highest	Historical maximum power.
+======================= ========================================================
 
-			Power attributes only exist for MAX34446.
+.. note:: Power attributes only exist for MAX34446.
 
+Temp
+~~~~
+
+======================= ========================================================
 temp[1-8]_input		Measured temperatures. From READ_TEMPERATURE_1 register.
 			temp1 is the chip's internal temperature. temp2..temp5
 			are remote I2C temperature sensors. For MAX34441, temp6
@@ -125,11 +179,17 @@ temp[1-8]_crit_alarm	Temperature critical high alarm.
 temp[1-8]_average	Historical average temperature (MAX34446 only).
 temp[1-8]_highest	Historical maximum temperature.
 temp[1-8]_reset_history	Write any value to reset history.
+======================= ========================================================
 
-			temp7 and temp8 attributes only exist for MAX34440.
-			MAX34446 only supports temp[1-3].
 
-MAX34451 supports attribute groups in[1-16] (or curr[1-16] based on input pins)
-and temp[1-5].
-MAX34460 supports attribute groups in[1-12] and temp[1-5].
-MAX34461 supports attribute groups in[1-16] and temp[1-5].
+.. note::
+   - temp7 and temp8 attributes only exist for MAX34440.
+   - MAX34446 only supports temp[1-3].
+
+
+.. note::
+
+   - MAX34451 supports attribute groups in[1-16] (or curr[1-16] based on
+     input pins) and temp[1-5].
+   - MAX34460 supports attribute groups in[1-12] and temp[1-5].
+   - MAX34461 supports attribute groups in[1-16] and temp[1-5].
diff --git a/Documentation/hwmon/max8688 b/Documentation/hwmon/max8688
index ca233bec7a8a..43da139234c1 100644
--- a/Documentation/hwmon/max8688
+++ b/Documentation/hwmon/max8688
@@ -2,9 +2,13 @@ Kernel driver max8688
 =====================
 
 Supported chips:
+
   * Maxim MAX8688
+
     Prefix: 'max8688'
+
     Addresses scanned: -
+
     Datasheet: http://datasheets.maxim-ic.com/en/ds/MAX8688.pdf
 
 Author: Guenter Roeck <linux@roeck-us.net>
@@ -40,23 +44,28 @@ Sysfs entries
 The following attributes are supported. Limits are read-write; all other
 attributes are read-only.
 
+======================= ========================================================
 in1_label		"vout1"
 in1_input		Measured voltage. From READ_VOUT register.
 in1_min			Minimum Voltage. From VOUT_UV_WARN_LIMIT register.
 in1_max			Maximum voltage. From VOUT_OV_WARN_LIMIT register.
 in1_lcrit		Critical minimum Voltage. VOUT_UV_FAULT_LIMIT register.
-in1_crit		Critical maximum voltage. From VOUT_OV_FAULT_LIMIT register.
+in1_crit		Critical maximum voltage. From VOUT_OV_FAULT_LIMIT
+			register.
 in1_min_alarm		Voltage low alarm. From VOLTAGE_UV_WARNING status.
 in1_max_alarm		Voltage high alarm. From VOLTAGE_OV_WARNING status.
-in1_lcrit_alarm		Voltage critical low alarm. From VOLTAGE_UV_FAULT status.
-in1_crit_alarm		Voltage critical high alarm. From VOLTAGE_OV_FAULT status.
+in1_lcrit_alarm		Voltage critical low alarm. From VOLTAGE_UV_FAULT
+			status.
+in1_crit_alarm		Voltage critical high alarm. From VOLTAGE_OV_FAULT
+			status.
 in1_highest		Historical maximum voltage.
 in1_reset_history	Write any value to reset history.
 
 curr1_label		"iout1"
 curr1_input		Measured current. From READ_IOUT register.
 curr1_max		Maximum current. From IOUT_OC_WARN_LIMIT register.
-curr1_crit		Critical maximum current. From IOUT_OC_FAULT_LIMIT register.
+curr1_crit		Critical maximum current. From IOUT_OC_FAULT_LIMIT
+			register.
 curr1_max_alarm		Current high alarm. From IOUT_OC_WARN_LIMIT register.
 curr1_crit_alarm	Current critical high alarm. From IOUT_OC_FAULT status.
 curr1_highest		Historical maximum current.
@@ -73,3 +82,4 @@ temp1_crit_alarm	Chip temperature critical high alarm. Set by comparing
 			status is set.
 temp1_highest		Historical maximum temperature.
 temp1_reset_history	Write any value to reset history.
+======================= ========================================================
diff --git a/Documentation/hwmon/pmbus b/Documentation/hwmon/pmbus
index dfd9c65996c0..abfb9dd4857d 100644
--- a/Documentation/hwmon/pmbus
+++ b/Documentation/hwmon/pmbus
@@ -1,42 +1,77 @@
 Kernel driver pmbus
-====================
+===================
 
 Supported chips:
+
   * Ericsson BMR453, BMR454
+
     Prefixes: 'bmr453', 'bmr454'
+
     Addresses scanned: -
+
     Datasheet:
+
  http://archive.ericsson.net/service/internet/picov/get?DocNo=28701-EN/LZT146395
+
   * ON Semiconductor ADP4000, NCP4200, NCP4208
+
     Prefixes: 'adp4000', 'ncp4200', 'ncp4208'
+
     Addresses scanned: -
+
     Datasheets:
+
 	http://www.onsemi.com/pub_link/Collateral/ADP4000-D.PDF
+
 	http://www.onsemi.com/pub_link/Collateral/NCP4200-D.PDF
+
 	http://www.onsemi.com/pub_link/Collateral/JUNE%202009-%20REV.%200.PDF
+
   * Lineage Power
+
     Prefixes: 'mdt040', 'pdt003', 'pdt006', 'pdt012', 'udt020'
+
     Addresses scanned: -
+
     Datasheets:
+
 	http://www.lineagepower.com/oem/pdf/PDT003A0X.pdf
+
 	http://www.lineagepower.com/oem/pdf/PDT006A0X.pdf
+
 	http://www.lineagepower.com/oem/pdf/PDT012A0X.pdf
+
 	http://www.lineagepower.com/oem/pdf/UDT020A0X.pdf
+
 	http://www.lineagepower.com/oem/pdf/MDT040A0X.pdf
+
   * Texas Instruments TPS40400, TPS544B20, TPS544B25, TPS544C20, TPS544C25
+
     Prefixes: 'tps40400', 'tps544b20', 'tps544b25', 'tps544c20', 'tps544c25'
+
     Addresses scanned: -
+
     Datasheets:
+
 	http://www.ti.com/lit/gpn/tps40400
+
 	http://www.ti.com/lit/gpn/tps544b20
+
 	http://www.ti.com/lit/gpn/tps544b25
+
 	http://www.ti.com/lit/gpn/tps544c20
+
 	http://www.ti.com/lit/gpn/tps544c25
+
   * Generic PMBus devices
+
     Prefix: 'pmbus'
+
     Addresses scanned: -
+
     Datasheet: n.a.
 
+
 Author: Guenter Roeck <linux@roeck-us.net>
 
 
@@ -62,9 +97,10 @@ supported by all chips), and since there is no well defined address range for
 PMBus devices. You will have to instantiate the devices explicitly.
 
 Example: the following will load the driver for an LTC2978 at address 0x60
-on I2C bus #1:
-$ modprobe pmbus
-$ echo ltc2978 0x60 > /sys/bus/i2c/devices/i2c-1/new_device
+on I2C bus #1::
+
+	$ modprobe pmbus
+	$ echo ltc2978 0x60 > /sys/bus/i2c/devices/i2c-1/new_device
 
 
 Platform data support
@@ -72,9 +108,9 @@ Platform data support
 
 Support for additional PMBus chips can be added by defining chip parameters in
 a new chip specific driver file. For example, (untested) code to add support for
-Emerson DS1200 power modules might look as follows.
+Emerson DS1200 power modules might look as follows::
 
-static struct pmbus_driver_info ds1200_info = {
+  static struct pmbus_driver_info ds1200_info = {
 	.pages = 1,
 	/* Note: All other sensors are in linear mode */
 	.direct[PSC_VOLTAGE_OUT] = true,
@@ -95,45 +131,45 @@ static struct pmbus_driver_info ds1200_info = {
 		   | PMBUS_HAVE_PIN | PMBUS_HAVE_POUT
 		   | PMBUS_HAVE_TEMP | PMBUS_HAVE_STATUS_TEMP
 		   | PMBUS_HAVE_FAN12 | PMBUS_HAVE_STATUS_FAN12,
-};
+  };
 
-static int ds1200_probe(struct i2c_client *client,
-			const struct i2c_device_id *id)
-{
+  static int ds1200_probe(struct i2c_client *client,
+			  const struct i2c_device_id *id)
+  {
 	return pmbus_do_probe(client, id, &ds1200_info);
-}
+  }
 
-static int ds1200_remove(struct i2c_client *client)
-{
+  static int ds1200_remove(struct i2c_client *client)
+  {
 	return pmbus_do_remove(client);
-}
+  }
 
-static const struct i2c_device_id ds1200_id[] = {
+  static const struct i2c_device_id ds1200_id[] = {
 	{"ds1200", 0},
 	{}
-};
+  };
 
-MODULE_DEVICE_TABLE(i2c, ds1200_id);
+  MODULE_DEVICE_TABLE(i2c, ds1200_id);
 
-/* This is the driver that will be inserted */
-static struct i2c_driver ds1200_driver = {
+  /* This is the driver that will be inserted */
+  static struct i2c_driver ds1200_driver = {
 	.driver = {
 		   .name = "ds1200",
 		   },
 	.probe = ds1200_probe,
 	.remove = ds1200_remove,
 	.id_table = ds1200_id,
-};
+  };
 
-static int __init ds1200_init(void)
-{
+  static int __init ds1200_init(void)
+  {
 	return i2c_add_driver(&ds1200_driver);
-}
+  }
 
-static void __exit ds1200_exit(void)
-{
+  static void __exit ds1200_exit(void)
+  {
 	i2c_del_driver(&ds1200_driver);
-}
+  }
 
 
 Sysfs entries
@@ -148,6 +184,7 @@ a given sysfs entry.
 The following attributes are supported. Limits are read-write; all other
 attributes are read-only.
 
+======================= ========================================================
 inX_input		Measured voltage. From READ_VIN or READ_VOUT register.
 inX_min			Minimum Voltage.
 			From VIN_UV_WARN_LIMIT or VOUT_UV_WARN_LIMIT register.
@@ -214,3 +251,4 @@ tempX_lcrit_alarm	Chip temperature critical low alarm. Set by comparing
 tempX_crit_alarm	Chip temperature critical high alarm. Set by comparing
 			READ_TEMPERATURE_X with OT_FAULT_LIMIT if
 			TEMP_OT_FAULT status is set.
+======================= ========================================================
diff --git a/Documentation/hwmon/pmbus-core b/Documentation/hwmon/pmbus-core
index 8ed10e9ddfb5..92515c446fe3 100644
--- a/Documentation/hwmon/pmbus-core
+++ b/Documentation/hwmon/pmbus-core
@@ -1,3 +1,4 @@
+==================================
 PMBus core driver and internal API
 ==================================
 
@@ -120,24 +121,24 @@ Specifically, it provides the following information.
   non-standard PMBus commands to standard commands, or to augment standard
   command return values with device specific information.
 
-  API functions
-  -------------
+API functions
+=============
 
-  Functions provided by chip driver
-  ---------------------------------
+Functions provided by chip driver
+---------------------------------
 
-  All functions return the command return value (read) or zero (write) if
-  successful. A return value of -ENODATA indicates that there is no manufacturer
-  specific command, but that a standard PMBus command may exist. Any other
-  negative return value indicates that the commands does not exist for this
-  chip, and that no attempt should be made to read or write the standard
-  command.
+All functions return the command return value (read) or zero (write) if
+successful. A return value of -ENODATA indicates that there is no manufacturer
+specific command, but that a standard PMBus command may exist. Any other
+negative return value indicates that the commands does not exist for this
+chip, and that no attempt should be made to read or write the standard
+command.
 
-  As mentioned above, an exception to this rule applies to virtual commands,
-  which  _must_ be handled in driver specific code. See "Virtual PMBus Commands"
-  above for more details.
+As mentioned above, an exception to this rule applies to virtual commands,
+which *must* be handled in driver specific code. See "Virtual PMBus Commands"
+above for more details.
 
-  Command execution in the core PMBus driver code is as follows.
+Command execution in the core PMBus driver code is as follows::
 
 	if (chip_access_function) {
 		status = chip_access_function();
@@ -148,128 +149,160 @@ Specifically, it provides the following information.
 		return -EINVAL;
 	return generic_access();
 
-  Chip drivers may provide pointers to the following functions in struct
-  pmbus_driver_info. All functions are optional.
+Chip drivers may provide pointers to the following functions in struct
+pmbus_driver_info. All functions are optional.
+
+::
 
   int (*read_byte_data)(struct i2c_client *client, int page, int reg);
 
-  Read byte from page <page>, register <reg>.
-  <page> may be -1, which means "current page".
+Read byte from page <page>, register <reg>.
+<page> may be -1, which means "current page".
+
+
+::
 
   int (*read_word_data)(struct i2c_client *client, int page, int reg);
 
-  Read word from page <page>, register <reg>.
+Read word from page <page>, register <reg>.
+
+::
 
   int (*write_word_data)(struct i2c_client *client, int page, int reg,
-		         u16 word);
+			 u16 word);
 
-  Write word to page <page>, register <reg>.
+Write word to page <page>, register <reg>.
+
+::
 
   int (*write_byte)(struct i2c_client *client, int page, u8 value);
 
-  Write byte to page <page>, register <reg>.
-  <page> may be -1, which means "current page".
+Write byte to page <page>, register <reg>.
+<page> may be -1, which means "current page".
+
+::
 
   int (*identify)(struct i2c_client *client, struct pmbus_driver_info *info);
 
-  Determine supported PMBus functionality. This function is only necessary
-  if a chip driver supports multiple chips, and the chip functionality is not
-  pre-determined. It is currently only used by the generic pmbus driver
-  (pmbus.c).
+Determine supported PMBus functionality. This function is only necessary
+if a chip driver supports multiple chips, and the chip functionality is not
+pre-determined. It is currently only used by the generic pmbus driver
+(pmbus.c).
 
-  Functions exported by core driver
-  ---------------------------------
+Functions exported by core driver
+---------------------------------
 
-  Chip drivers are expected to use the following functions to read or write
-  PMBus registers. Chip drivers may also use direct I2C commands. If direct I2C
-  commands are used, the chip driver code must not directly modify the current
-  page, since the selected page is cached in the core driver and the core driver
-  will assume that it is selected. Using pmbus_set_page() to select a new page
-  is mandatory.
+Chip drivers are expected to use the following functions to read or write
+PMBus registers. Chip drivers may also use direct I2C commands. If direct I2C
+commands are used, the chip driver code must not directly modify the current
+page, since the selected page is cached in the core driver and the core driver
+will assume that it is selected. Using pmbus_set_page() to select a new page
+is mandatory.
+
+::
 
   int pmbus_set_page(struct i2c_client *client, u8 page);
 
-  Set PMBus page register to <page> for subsequent commands.
+Set PMBus page register to <page> for subsequent commands.
+
+::
 
   int pmbus_read_word_data(struct i2c_client *client, u8 page, u8 reg);
 
-  Read word data from <page>, <reg>. Similar to i2c_smbus_read_word_data(), but
-  selects page first.
+Read word data from <page>, <reg>. Similar to i2c_smbus_read_word_data(), but
+selects page first.
+
+::
 
   int pmbus_write_word_data(struct i2c_client *client, u8 page, u8 reg,
 			    u16 word);
 
-  Write word data to <page>, <reg>. Similar to i2c_smbus_write_word_data(), but
-  selects page first.
+Write word data to <page>, <reg>. Similar to i2c_smbus_write_word_data(), but
+selects page first.
+
+::
 
   int pmbus_read_byte_data(struct i2c_client *client, int page, u8 reg);
 
-  Read byte data from <page>, <reg>. Similar to i2c_smbus_read_byte_data(), but
-  selects page first. <page> may be -1, which means "current page".
+Read byte data from <page>, <reg>. Similar to i2c_smbus_read_byte_data(), but
+selects page first. <page> may be -1, which means "current page".
+
+::
 
   int pmbus_write_byte(struct i2c_client *client, int page, u8 value);
 
-  Write byte data to <page>, <reg>. Similar to i2c_smbus_write_byte(), but
-  selects page first. <page> may be -1, which means "current page".
+Write byte data to <page>, <reg>. Similar to i2c_smbus_write_byte(), but
+selects page first. <page> may be -1, which means "current page".
+
+::
 
   void pmbus_clear_faults(struct i2c_client *client);
 
-  Execute PMBus "Clear Fault" command on all chip pages.
-  This function calls the device specific write_byte function if defined.
-  Therefore, it must _not_ be called from that function.
+Execute PMBus "Clear Fault" command on all chip pages.
+This function calls the device specific write_byte function if defined.
+Therefore, it must _not_ be called from that function.
+
+::
 
   bool pmbus_check_byte_register(struct i2c_client *client, int page, int reg);
 
-  Check if byte register exists. Return true if the register exists, false
-  otherwise.
-  This function calls the device specific write_byte function if defined to
-  obtain the chip status. Therefore, it must _not_ be called from that function.
+Check if byte register exists. Return true if the register exists, false
+otherwise.
+This function calls the device specific write_byte function if defined to
+obtain the chip status. Therefore, it must _not_ be called from that function.
+
+::
 
   bool pmbus_check_word_register(struct i2c_client *client, int page, int reg);
 
-  Check if word register exists. Return true if the register exists, false
-  otherwise.
-  This function calls the device specific write_byte function if defined to
-  obtain the chip status. Therefore, it must _not_ be called from that function.
+Check if word register exists. Return true if the register exists, false
+otherwise.
+This function calls the device specific write_byte function if defined to
+obtain the chip status. Therefore, it must _not_ be called from that function.
+
+::
 
   int pmbus_do_probe(struct i2c_client *client, const struct i2c_device_id *id,
-                     struct pmbus_driver_info *info);
+		     struct pmbus_driver_info *info);
 
-  Execute probe function. Similar to standard probe function for other drivers,
-  with the pointer to struct pmbus_driver_info as additional argument. Calls
-  identify function if supported. Must only be called from device probe
-  function.
+Execute probe function. Similar to standard probe function for other drivers,
+with the pointer to struct pmbus_driver_info as additional argument. Calls
+identify function if supported. Must only be called from device probe
+function.
+
+::
 
   void pmbus_do_remove(struct i2c_client *client);
 
-  Execute driver remove function. Similar to standard driver remove function.
+Execute driver remove function. Similar to standard driver remove function.
+
+::
 
   const struct pmbus_driver_info
 	*pmbus_get_driver_info(struct i2c_client *client);
 
-  Return pointer to struct pmbus_driver_info as passed to pmbus_do_probe().
+Return pointer to struct pmbus_driver_info as passed to pmbus_do_probe().
 
 
 PMBus driver platform data
 ==========================
 
 PMBus platform data is defined in include/linux/pmbus.h. Platform data
-currently only provides a flag field with a single bit used.
+currently only provides a flag field with a single bit used::
 
-#define PMBUS_SKIP_STATUS_CHECK (1 << 0)
+	#define PMBUS_SKIP_STATUS_CHECK (1 << 0)
 
-struct pmbus_platform_data {
-        u32 flags;              /* Device specific flags */
-};
+	struct pmbus_platform_data {
+		u32 flags;              /* Device specific flags */
+	};
 
 
 Flags
 -----
 
 PMBUS_SKIP_STATUS_CHECK
-
-During register detection, skip checking the status register for
-communication or command errors.
+	During register detection, skip checking the status register for
+	communication or command errors.
 
 Some PMBus chips respond with valid data when trying to read an unsupported
 register. For such chips, checking the status register is mandatory when
diff --git a/Documentation/hwmon/tps40422 b/Documentation/hwmon/tps40422
index 24bb0688d515..359751eb5ed4 100644
--- a/Documentation/hwmon/tps40422
+++ b/Documentation/hwmon/tps40422
@@ -2,9 +2,13 @@ Kernel driver tps40422
 ======================
 
 Supported chips:
+
   * TI TPS40422
+
     Prefix: 'tps40422'
+
     Addresses scanned: -
+
     Datasheet: http://www.ti.com/lit/gpn/tps40422
 
 Author: Zhu Laiwen <richard.zhu@nsn.com>
@@ -39,6 +43,7 @@ Sysfs entries
 
 The following attributes are supported.
 
+======================= =======================================================
 in[1-2]_label		"vout[1-2]"
 in[1-2]_input		Measured voltage. From READ_VOUT register.
 in[1-2]_alarm		voltage alarm.
@@ -46,19 +51,23 @@ in[1-2]_alarm		voltage alarm.
 curr[1-2]_input		Measured current. From READ_IOUT register.
 curr[1-2]_label		"iout[1-2]"
 curr1_max		Maximum current. From IOUT_OC_WARN_LIMIT register.
-curr1_crit		Critical maximum current. From IOUT_OC_FAULT_LIMIT register.
+curr1_crit		Critical maximum current. From IOUT_OC_FAULT_LIMIT
+			register.
 curr1_max_alarm		Current high alarm. From IOUT_OC_WARN_LIMIT status.
 curr1_crit_alarm	Current critical high alarm. From IOUT_OC_FAULT status.
 curr2_alarm		Current high alarm. From IOUT_OC_WARNING status.
 
-temp1_input		Measured temperature. From READ_TEMPERATURE_2 register on page 0.
+temp1_input		Measured temperature. From READ_TEMPERATURE_2 register
+			on page 0.
 temp1_max		Maximum temperature. From OT_WARN_LIMIT register.
 temp1_crit		Critical high temperature. From OT_FAULT_LIMIT register.
 temp1_max_alarm		Chip temperature high alarm. Set by comparing
-			READ_TEMPERATURE_2 on page 0 with OT_WARN_LIMIT if TEMP_OT_WARNING
-			status is set.
+			READ_TEMPERATURE_2 on page 0 with OT_WARN_LIMIT if
+			TEMP_OT_WARNING status is set.
 temp1_crit_alarm	Chip temperature critical high alarm. Set by comparing
-			READ_TEMPERATURE_2 on page 0 with OT_FAULT_LIMIT if TEMP_OT_FAULT
-			status is set.
-temp2_input		Measured temperature. From READ_TEMPERATURE_2 register on page 1.
+			READ_TEMPERATURE_2 on page 0 with OT_FAULT_LIMIT if
+			TEMP_OT_FAULT status is set.
+temp2_input		Measured temperature. From READ_TEMPERATURE_2 register
+			on page 1.
 temp2_alarm		Chip temperature alarm on page 1.
+======================= =======================================================
diff --git a/Documentation/hwmon/ucd9000 b/Documentation/hwmon/ucd9000
index 262e713e60ff..d69061b7312c 100644
--- a/Documentation/hwmon/ucd9000
+++ b/Documentation/hwmon/ucd9000
@@ -2,15 +2,20 @@ Kernel driver ucd9000
 =====================
 
 Supported chips:
+
   * TI UCD90120, UCD90124, UCD90160, UCD9090, and UCD90910
+
     Prefixes: 'ucd90120', 'ucd90124', 'ucd90160', 'ucd9090', 'ucd90910'
+
     Addresses scanned: -
+
     Datasheets:
-	http://focus.ti.com/lit/ds/symlink/ucd90120.pdf
-	http://focus.ti.com/lit/ds/symlink/ucd90124.pdf
-	http://focus.ti.com/lit/ds/symlink/ucd90160.pdf
-	http://focus.ti.com/lit/ds/symlink/ucd9090.pdf
-	http://focus.ti.com/lit/ds/symlink/ucd90910.pdf
+
+	- http://focus.ti.com/lit/ds/symlink/ucd90120.pdf
+	- http://focus.ti.com/lit/ds/symlink/ucd90124.pdf
+	- http://focus.ti.com/lit/ds/symlink/ucd90160.pdf
+	- http://focus.ti.com/lit/ds/symlink/ucd9090.pdf
+	- http://focus.ti.com/lit/ds/symlink/ucd90910.pdf
 
 Author: Guenter Roeck <linux@roeck-us.net>
 
@@ -76,23 +81,28 @@ Sysfs entries
 The following attributes are supported. Limits are read-write; all other
 attributes are read-only.
 
+======================= ========================================================
 in[1-12]_label		"vout[1-12]".
 in[1-12]_input		Measured voltage. From READ_VOUT register.
 in[1-12]_min		Minimum Voltage. From VOUT_UV_WARN_LIMIT register.
 in[1-12]_max		Maximum voltage. From VOUT_OV_WARN_LIMIT register.
 in[1-12]_lcrit		Critical minimum Voltage. VOUT_UV_FAULT_LIMIT register.
-in[1-12]_crit		Critical maximum voltage. From VOUT_OV_FAULT_LIMIT register.
+in[1-12]_crit		Critical maximum voltage. From VOUT_OV_FAULT_LIMIT
+			register.
 in[1-12]_min_alarm	Voltage low alarm. From VOLTAGE_UV_WARNING status.
 in[1-12]_max_alarm	Voltage high alarm. From VOLTAGE_OV_WARNING status.
-in[1-12]_lcrit_alarm	Voltage critical low alarm. From VOLTAGE_UV_FAULT status.
-in[1-12]_crit_alarm	Voltage critical high alarm. From VOLTAGE_OV_FAULT status.
+in[1-12]_lcrit_alarm	Voltage critical low alarm. From VOLTAGE_UV_FAULT
+			status.
+in[1-12]_crit_alarm	Voltage critical high alarm. From VOLTAGE_OV_FAULT
+			status.
 
 curr[1-12]_label	"iout[1-12]".
 curr[1-12]_input	Measured current. From READ_IOUT register.
 curr[1-12]_max		Maximum current. From IOUT_OC_WARN_LIMIT register.
-curr[1-12]_lcrit	Critical minimum output current. From IOUT_UC_FAULT_LIMIT
+curr[1-12]_lcrit	Critical minimum output current. From
+			IOUT_UC_FAULT_LIMIT register.
+curr[1-12]_crit		Critical maximum current. From IOUT_OC_FAULT_LIMIT
 			register.
-curr[1-12]_crit		Critical maximum current. From IOUT_OC_FAULT_LIMIT register.
 curr[1-12]_max_alarm	Current high alarm. From IOUT_OC_WARNING status.
 curr[1-12]_crit_alarm	Current critical high alarm. From IOUT_OC_FAULT status.
 
@@ -116,3 +126,4 @@ fan[1-4]_fault		Fan fault.
 			created only for enabled fans.
 			Note that even though UCD90910 supports up to 10 fans,
 			only up to four fans are currently supported.
+======================= ========================================================
diff --git a/Documentation/hwmon/ucd9200 b/Documentation/hwmon/ucd9200
index 1e8060e631bd..44eda4a579b6 100644
--- a/Documentation/hwmon/ucd9200
+++ b/Documentation/hwmon/ucd9200
@@ -2,18 +2,23 @@ Kernel driver ucd9200
 =====================
 
 Supported chips:
+
   * TI UCD9220, UCD9222, UCD9224, UCD9240, UCD9244, UCD9246, and UCD9248
+
     Prefixes: 'ucd9220', 'ucd9222', 'ucd9224', 'ucd9240', 'ucd9244', 'ucd9246',
-	'ucd9248'
+    'ucd9248'
+
     Addresses scanned: -
+
     Datasheets:
-	http://focus.ti.com/lit/ds/symlink/ucd9220.pdf
-	http://focus.ti.com/lit/ds/symlink/ucd9222.pdf
-	http://focus.ti.com/lit/ds/symlink/ucd9224.pdf
-	http://focus.ti.com/lit/ds/symlink/ucd9240.pdf
-	http://focus.ti.com/lit/ds/symlink/ucd9244.pdf
-	http://focus.ti.com/lit/ds/symlink/ucd9246.pdf
-	http://focus.ti.com/lit/ds/symlink/ucd9248.pdf
+
+	- http://focus.ti.com/lit/ds/symlink/ucd9220.pdf
+	- http://focus.ti.com/lit/ds/symlink/ucd9222.pdf
+	- http://focus.ti.com/lit/ds/symlink/ucd9224.pdf
+	- http://focus.ti.com/lit/ds/symlink/ucd9240.pdf
+	- http://focus.ti.com/lit/ds/symlink/ucd9244.pdf
+	- http://focus.ti.com/lit/ds/symlink/ucd9246.pdf
+	- http://focus.ti.com/lit/ds/symlink/ucd9248.pdf
 
 Author: Guenter Roeck <linux@roeck-us.net>
 
@@ -52,12 +57,14 @@ Sysfs entries
 The following attributes are supported. Limits are read-write; all other
 attributes are read-only.
 
+======================= ========================================================
 in1_label		"vin".
 in1_input		Measured voltage. From READ_VIN register.
 in1_min			Minimum Voltage. From VIN_UV_WARN_LIMIT register.
 in1_max			Maximum voltage. From VIN_OV_WARN_LIMIT register.
 in1_lcrit		Critical minimum Voltage. VIN_UV_FAULT_LIMIT register.
-in1_crit		Critical maximum voltage. From VIN_OV_FAULT_LIMIT register.
+in1_crit		Critical maximum voltage. From VIN_OV_FAULT_LIMIT
+			register.
 in1_min_alarm		Voltage low alarm. From VIN_UV_WARNING status.
 in1_max_alarm		Voltage high alarm. From VIN_OV_WARNING status.
 in1_lcrit_alarm		Voltage critical low alarm. From VIN_UV_FAULT status.
@@ -68,11 +75,14 @@ in[2-5]_input		Measured voltage. From READ_VOUT register.
 in[2-5]_min		Minimum Voltage. From VOUT_UV_WARN_LIMIT register.
 in[2-5]_max		Maximum voltage. From VOUT_OV_WARN_LIMIT register.
 in[2-5]_lcrit		Critical minimum Voltage. VOUT_UV_FAULT_LIMIT register.
-in[2-5]_crit		Critical maximum voltage. From VOUT_OV_FAULT_LIMIT register.
+in[2-5]_crit		Critical maximum voltage. From VOUT_OV_FAULT_LIMIT
+			register.
 in[2-5]_min_alarm	Voltage low alarm. From VOLTAGE_UV_WARNING status.
 in[2-5]_max_alarm	Voltage high alarm. From VOLTAGE_OV_WARNING status.
-in[2-5]_lcrit_alarm	Voltage critical low alarm. From VOLTAGE_UV_FAULT status.
-in[2-5]_crit_alarm	Voltage critical high alarm. From VOLTAGE_OV_FAULT status.
+in[2-5]_lcrit_alarm	Voltage critical low alarm. From VOLTAGE_UV_FAULT
+			status.
+in[2-5]_crit_alarm	Voltage critical high alarm. From VOLTAGE_OV_FAULT
+			status.
 
 curr1_label		"iin".
 curr1_input		Measured current. From READ_IIN register.
@@ -80,9 +90,10 @@ curr1_input		Measured current. From READ_IIN register.
 curr[2-5]_label		"iout[1-4]".
 curr[2-5]_input		Measured current. From READ_IOUT register.
 curr[2-5]_max		Maximum current. From IOUT_OC_WARN_LIMIT register.
-curr[2-5]_lcrit		Critical minimum output current. From IOUT_UC_FAULT_LIMIT
+curr[2-5]_lcrit		Critical minimum output current. From
+			IOUT_UC_FAULT_LIMIT register.
+curr[2-5]_crit		Critical maximum current. From IOUT_OC_FAULT_LIMIT
 			register.
-curr[2-5]_crit		Critical maximum current. From IOUT_OC_FAULT_LIMIT register.
 curr[2-5]_max_alarm	Current high alarm. From IOUT_OC_WARNING status.
 curr[2-5]_crit_alarm	Current critical high alarm. From IOUT_OC_FAULT status.
 
@@ -97,7 +108,7 @@ power[2-5]_label	"pout[1-4]"
 			rails. See chip datasheets for details.
 
 temp[1-5]_input		Measured temperatures. From READ_TEMPERATURE_1 and
-		        READ_TEMPERATURE_2 registers.
+			READ_TEMPERATURE_2 registers.
 			temp1 is the chip internal temperature. temp[2-5] are
 			rail temperatures.  temp[2-5] attributes are only
 			created for enabled rails. See chip datasheets for
@@ -110,3 +121,4 @@ temp[1-5]_crit_alarm	Temperature critical high alarm.
 fan1_input		Fan RPM. ucd9240 only.
 fan1_alarm		Fan alarm. ucd9240 only.
 fan1_fault		Fan fault. ucd9240 only.
+======================= ========================================================
diff --git a/Documentation/hwmon/zl6100 b/Documentation/hwmon/zl6100
index 477a94b131ae..4029970bace4 100644
--- a/Documentation/hwmon/zl6100
+++ b/Documentation/hwmon/zl6100
@@ -2,57 +2,106 @@ Kernel driver zl6100
 ====================
 
 Supported chips:
+
   * Intersil / Zilker Labs ZL2004
+
     Prefix: 'zl2004'
+
     Addresses scanned: -
+
     Datasheet: http://www.intersil.com/data/fn/fn6847.pdf
+
   * Intersil / Zilker Labs ZL2005
+
     Prefix: 'zl2005'
+
     Addresses scanned: -
+
     Datasheet: http://www.intersil.com/data/fn/fn6848.pdf
+
   * Intersil / Zilker Labs ZL2006
+
     Prefix: 'zl2006'
+
     Addresses scanned: -
+
     Datasheet: http://www.intersil.com/data/fn/fn6850.pdf
+
   * Intersil / Zilker Labs ZL2008
+
     Prefix: 'zl2008'
+
     Addresses scanned: -
+
     Datasheet: http://www.intersil.com/data/fn/fn6859.pdf
+
   * Intersil / Zilker Labs ZL2105
+
     Prefix: 'zl2105'
+
     Addresses scanned: -
+
     Datasheet: http://www.intersil.com/data/fn/fn6851.pdf
+
   * Intersil / Zilker Labs ZL2106
+
     Prefix: 'zl2106'
+
     Addresses scanned: -
+
     Datasheet: http://www.intersil.com/data/fn/fn6852.pdf
+
   * Intersil / Zilker Labs ZL6100
+
     Prefix: 'zl6100'
+
     Addresses scanned: -
+
     Datasheet: http://www.intersil.com/data/fn/fn6876.pdf
+
   * Intersil / Zilker Labs ZL6105
+
     Prefix: 'zl6105'
+
     Addresses scanned: -
+
     Datasheet: http://www.intersil.com/data/fn/fn6906.pdf
+
   * Intersil / Zilker Labs ZL9101M
+
     Prefix: 'zl9101'
+
     Addresses scanned: -
+
     Datasheet: http://www.intersil.com/data/fn/fn7669.pdf
+
   * Intersil / Zilker Labs ZL9117M
+
     Prefix: 'zl9117'
+
     Addresses scanned: -
+
     Datasheet: http://www.intersil.com/data/fn/fn7914.pdf
+
   * Ericsson BMR450, BMR451
+
     Prefix: 'bmr450', 'bmr451'
+
     Addresses scanned: -
+
     Datasheet:
+
 http://archive.ericsson.net/service/internet/picov/get?DocNo=28701-EN/LZT146401
+
   * Ericsson BMR462, BMR463, BMR464
+
     Prefixes: 'bmr462', 'bmr463', 'bmr464'
+
     Addresses scanned: -
+
     Datasheet:
-http://archive.ericsson.net/service/internet/picov/get?DocNo=28701-EN/LZT146256
 
+	http://archive.ericsson.net/service/internet/picov/get?DocNo=28701-EN/LZT146256
 
 Author: Guenter Roeck <linux@roeck-us.net>
 
@@ -75,13 +124,15 @@ This driver does not auto-detect devices. You will have to instantiate the
 devices explicitly. Please see Documentation/i2c/instantiating-devices for
 details.
 
-WARNING: Do not access chip registers using the i2cdump command, and do not use
-any of the i2ctools commands on a command register used to save and restore
-configuration data (0x11, 0x12, 0x15, 0x16, and 0xf4). The chips supported by
-this driver interpret any access to those command registers (including read
-commands) as request to execute the command in question. Unless write accesses
-to those registers are protected, this may result in power loss, board resets,
-and/or Flash corruption. Worst case, your board may turn into a brick.
+.. warning::
+
+  Do not access chip registers using the i2cdump command, and do not use
+  any of the i2ctools commands on a command register used to save and restore
+  configuration data (0x11, 0x12, 0x15, 0x16, and 0xf4). The chips supported by
+  this driver interpret any access to those command registers (including read
+  commands) as request to execute the command in question. Unless write accesses
+  to those registers are protected, this may result in power loss, board resets,
+  and/or Flash corruption. Worst case, your board may turn into a brick.
 
 
 Platform data support
@@ -110,6 +161,7 @@ Sysfs entries
 The following attributes are supported. Limits are read-write; all other
 attributes are read-only.
 
+======================= ========================================================
 in1_label		"vin"
 in1_input		Measured input voltage.
 in1_min			Minimum input voltage.
@@ -158,3 +210,4 @@ temp[12]_min_alarm	Chip temperature low alarm.
 temp[12]_max_alarm	Chip temperature high alarm.
 temp[12]_lcrit_alarm	Chip temperature critical low alarm.
 temp[12]_crit_alarm	Chip temperature critical high alarm.
+======================= ========================================================
-- 
2.20.1


^ permalink raw reply related	[flat|nested] 73+ messages in thread

* [PATCH v2 19/21] docs: hwmon: misc files: convert to ReST format
  2019-04-10 19:22 [PATCH v2 00/21] Convert hwmon documentation to ReST Mauro Carvalho Chehab
                   ` (17 preceding siblings ...)
  2019-04-10 19:22 ` [PATCH v2 18/21] docs: hwmon: pmbus files: " Mauro Carvalho Chehab
@ 2019-04-10 19:22 ` Mauro Carvalho Chehab
  2019-04-10 19:22 ` [PATCH v2 20/21] docs: hwmon: convert remaining files " Mauro Carvalho Chehab
                   ` (2 subsequent siblings)
  21 siblings, 0 replies; 73+ messages in thread
From: Mauro Carvalho Chehab @ 2019-04-10 19:22 UTC (permalink / raw)
  To: Linux Doc Mailing List
  Cc: Mauro Carvalho Chehab, Mauro Carvalho Chehab, linux-kernel,
	Jonathan Corbet, Jean Delvare, Guenter Roeck, linux-hwmon

Convert other files maintained by Guenter to ReST format, in order
to allow them to be parsed by Sphinx.

Signed-off-by: Mauro Carvalho Chehab <mchehab+samsung@kernel.org>
---
 Documentation/hwmon/ina209   |  18 ++++--
 Documentation/hwmon/ina2xx   |  39 +++++++++---
 Documentation/hwmon/jc42     |  55 ++++++++++++++++-
 Documentation/hwmon/lm95234  |  11 +++-
 Documentation/hwmon/ltc4261  |  16 +++--
 Documentation/hwmon/max16065 |  24 +++++++-
 Documentation/hwmon/max6697  |  33 ++++++++++
 Documentation/hwmon/nct6775  | 114 ++++++++++++++++++++++++++++-------
 Documentation/hwmon/smm665   |  42 +++++++++++--
 Documentation/hwmon/tmp401   |  30 ++++++++-
 10 files changed, 328 insertions(+), 54 deletions(-)

diff --git a/Documentation/hwmon/ina209 b/Documentation/hwmon/ina209
index 672501de4509..64322075a145 100644
--- a/Documentation/hwmon/ina209
+++ b/Documentation/hwmon/ina209
@@ -1,16 +1,21 @@
 Kernel driver ina209
-=====================
+====================
 
 Supported chips:
+
   * Burr-Brown / Texas Instruments INA209
+
     Prefix: 'ina209'
+
     Addresses scanned: -
+
     Datasheet:
-        http://www.ti.com/lit/gpn/ina209
+	http://www.ti.com/lit/gpn/ina209
 
-Author: Paul Hays <Paul.Hays@cattail.ca>
-Author: Ira W. Snyder <iws@ovro.caltech.edu>
-Author: Guenter Roeck <linux@roeck-us.net>
+Author:
+	- Paul Hays <Paul.Hays@cattail.ca>
+	- Ira W. Snyder <iws@ovro.caltech.edu>
+	- Guenter Roeck <linux@roeck-us.net>
 
 
 Description
@@ -31,7 +36,7 @@ the I2C bus. See the datasheet for details.
 This tries to expose most monitoring features of the hardware via
 sysfs. It does not support every feature of this chip.
 
-
+======================= =======================================================
 in0_input		shunt voltage (mV)
 in0_input_highest	shunt voltage historical maximum reading (mV)
 in0_input_lowest	shunt voltage historical minimum reading (mV)
@@ -70,6 +75,7 @@ curr1_input		current measurement (mA)
 
 update_interval		data conversion time; affects number of samples used
 			to average results for shunt and bus voltages.
+======================= =======================================================
 
 General Remarks
 ---------------
diff --git a/Documentation/hwmon/ina2xx b/Documentation/hwmon/ina2xx
index 0f36c021192d..95badf9c396f 100644
--- a/Documentation/hwmon/ina2xx
+++ b/Documentation/hwmon/ina2xx
@@ -2,35 +2,56 @@ Kernel driver ina2xx
 ====================
 
 Supported chips:
+
   * Texas Instruments INA219
+
+
     Prefix: 'ina219'
     Addresses: I2C 0x40 - 0x4f
+
     Datasheet: Publicly available at the Texas Instruments website
-               http://www.ti.com/
+
+	       http://www.ti.com/
 
   * Texas Instruments INA220
+
     Prefix: 'ina220'
+
     Addresses: I2C 0x40 - 0x4f
+
     Datasheet: Publicly available at the Texas Instruments website
-               http://www.ti.com/
+
+	       http://www.ti.com/
 
   * Texas Instruments INA226
+
     Prefix: 'ina226'
+
     Addresses: I2C 0x40 - 0x4f
+
     Datasheet: Publicly available at the Texas Instruments website
-               http://www.ti.com/
+
+	       http://www.ti.com/
 
   * Texas Instruments INA230
+
     Prefix: 'ina230'
+
     Addresses: I2C 0x40 - 0x4f
+
     Datasheet: Publicly available at the Texas Instruments website
-               http://www.ti.com/
+
+	       http://www.ti.com/
 
   * Texas Instruments INA231
+
     Prefix: 'ina231'
+
     Addresses: I2C 0x40 - 0x4f
+
     Datasheet: Publicly available at the Texas Instruments website
-               http://www.ti.com/
+
+	       http://www.ti.com/
 
 Author: Lothar Felten <lothar.felten@gmail.com>
 
@@ -64,16 +85,20 @@ lower limit of the update_interval is 2 ms, the upper limit is 2253 ms.
 The actual programmed interval may vary from the desired value.
 
 General sysfs entries
--------------
+---------------------
 
+======================= ===============================
 in0_input		Shunt voltage(mV) channel
 in1_input		Bus voltage(mV) channel
 curr1_input		Current(mA) measurement channel
 power1_input		Power(uW) measurement channel
 shunt_resistor		Shunt resistance(uOhm) channel
+======================= ===============================
 
 Sysfs entries for ina226, ina230 and ina231 only
--------------
+------------------------------------------------
 
+======================= ====================================================
 update_interval		data conversion time; affects number of samples used
 			to average results for shunt and bus voltages.
+======================= ====================================================
diff --git a/Documentation/hwmon/jc42 b/Documentation/hwmon/jc42
index b4b671f22453..5b14b49bb6f7 100644
--- a/Documentation/hwmon/jc42
+++ b/Documentation/hwmon/jc42
@@ -2,53 +2,100 @@ Kernel driver jc42
 ==================
 
 Supported chips:
+
   * Analog Devices ADT7408
+
     Datasheets:
+
 	http://www.analog.com/static/imported-files/data_sheets/ADT7408.pdf
+
   * Atmel AT30TS00, AT30TS002A/B, AT30TSE004A
+
     Datasheets:
+
 	http://www.atmel.com/Images/doc8585.pdf
+
 	http://www.atmel.com/Images/doc8711.pdf
+
 	http://www.atmel.com/Images/Atmel-8852-SEEPROM-AT30TSE002A-Datasheet.pdf
+
 	http://www.atmel.com/Images/Atmel-8868-DTS-AT30TSE004A-Datasheet.pdf
+
   * IDT TSE2002B3, TSE2002GB2, TSE2004GB2, TS3000B3, TS3000GB0, TS3000GB2,
+
 	TS3001GB2
+
     Datasheets:
+
 	Available from IDT web site
+
   * Maxim MAX6604
+
     Datasheets:
+
 	http://datasheets.maxim-ic.com/en/ds/MAX6604.pdf
+
   * Microchip MCP9804, MCP9805, MCP9808, MCP98242, MCP98243, MCP98244, MCP9843
+
     Datasheets:
+
 	http://ww1.microchip.com/downloads/en/DeviceDoc/22203C.pdf
+
 	http://ww1.microchip.com/downloads/en/DeviceDoc/21977b.pdf
+
 	http://ww1.microchip.com/downloads/en/DeviceDoc/25095A.pdf
+
 	http://ww1.microchip.com/downloads/en/DeviceDoc/21996a.pdf
+
 	http://ww1.microchip.com/downloads/en/DeviceDoc/22153c.pdf
+
 	http://ww1.microchip.com/downloads/en/DeviceDoc/22327A.pdf
+
   * NXP Semiconductors SE97, SE97B, SE98, SE98A
+
     Datasheets:
+
 	http://www.nxp.com/documents/data_sheet/SE97.pdf
+
 	http://www.nxp.com/documents/data_sheet/SE97B.pdf
+
 	http://www.nxp.com/documents/data_sheet/SE98.pdf
+
 	http://www.nxp.com/documents/data_sheet/SE98A.pdf
+
   * ON Semiconductor CAT34TS02, CAT6095
+
     Datasheet:
+
 	http://www.onsemi.com/pub_link/Collateral/CAT34TS02-D.PDF
+
 	http://www.onsemi.com/pub/Collateral/CAT6095-D.PDF
+
   * ST Microelectronics STTS424, STTS424E02, STTS2002, STTS2004, STTS3000
+
     Datasheets:
+
 	http://www.st.com/web/en/resource/technical/document/datasheet/CD00157556.pdf
+
 	http://www.st.com/web/en/resource/technical/document/datasheet/CD00157558.pdf
+
 	http://www.st.com/web/en/resource/technical/document/datasheet/CD00266638.pdf
+
 	http://www.st.com/web/en/resource/technical/document/datasheet/CD00225278.pdf
+
 	http://www.st.com/web/en/resource/technical/document/datasheet/DM00076709.pdf
+
   * JEDEC JC 42.4 compliant temperature sensor chips
+
     Datasheet:
+
 	http://www.jedec.org/sites/default/files/docs/4_01_04R19.pdf
 
+
   Common for all chips:
+
     Prefix: 'jc42'
+
     Addresses scanned: I2C 0x18 - 0x1f
 
 Author:
@@ -67,10 +114,10 @@ The driver auto-detects the chips listed above, but can be manually instantiated
 to support other JC 42.4 compliant chips.
 
 Example: the following will load the driver for a generic JC 42.4 compliant
-temperature sensor at address 0x18 on I2C bus #1:
+temperature sensor at address 0x18 on I2C bus #1::
 
-# modprobe jc42
-# echo jc42 0x18 > /sys/bus/i2c/devices/i2c-1/new_device
+	# modprobe jc42
+	# echo jc42 0x18 > /sys/bus/i2c/devices/i2c-1/new_device
 
 A JC 42.4 compliant chip supports a single temperature sensor. Minimum, maximum,
 and critical temperature can be configured. There are alarms for high, low,
@@ -90,6 +137,7 @@ cannot be changed.
 Sysfs entries
 -------------
 
+======================= ===========================================
 temp1_input		Temperature (RO)
 temp1_min		Minimum temperature (RO or RW)
 temp1_max		Maximum temperature (RO or RW)
@@ -101,3 +149,4 @@ temp1_max_hyst		Maximum hysteresis temperature (RO)
 temp1_min_alarm		Temperature low alarm
 temp1_max_alarm		Temperature high alarm
 temp1_crit_alarm	Temperature critical alarm
+======================= ===========================================
diff --git a/Documentation/hwmon/lm95234 b/Documentation/hwmon/lm95234
index 32b777ef224c..e4c14bea5efd 100644
--- a/Documentation/hwmon/lm95234
+++ b/Documentation/hwmon/lm95234
@@ -2,15 +2,22 @@ Kernel driver lm95234
 =====================
 
 Supported chips:
+
   * National Semiconductor / Texas Instruments LM95233
+
     Addresses scanned: I2C 0x18, 0x2a, 0x2b
+
     Datasheet: Publicly available at the Texas Instruments website
-               http://www.ti.com/product/lm95233
+
+	       http://www.ti.com/product/lm95233
+
   * National Semiconductor / Texas Instruments LM95234
+
     Addresses scanned: I2C 0x18, 0x4d, 0x4e
+
     Datasheet: Publicly available at the Texas Instruments website
-               http://www.ti.com/product/lm95234
 
+	       http://www.ti.com/product/lm95234
 
 Author: Guenter Roeck <linux@roeck-us.net>
 
diff --git a/Documentation/hwmon/ltc4261 b/Documentation/hwmon/ltc4261
index 9378a75c6134..c80233f8082e 100644
--- a/Documentation/hwmon/ltc4261
+++ b/Documentation/hwmon/ltc4261
@@ -2,11 +2,16 @@ Kernel driver ltc4261
 =====================
 
 Supported chips:
+
   * Linear Technology LTC4261
+
     Prefix: 'ltc4261'
+
     Addresses scanned: -
+
     Datasheet:
-        http://cds.linear.com/docs/Datasheet/42612fb.pdf
+
+	http://cds.linear.com/docs/Datasheet/42612fb.pdf
 
 Author: Guenter Roeck <linux@roeck-us.net>
 
@@ -26,9 +31,10 @@ which can be safely used to identify the chip. You will have to instantiate
 the devices explicitly.
 
 Example: the following will load the driver for an LTC4261 at address 0x10
-on I2C bus #1:
-$ modprobe ltc4261
-$ echo ltc4261 0x10 > /sys/bus/i2c/devices/i2c-1/new_device
+on I2C bus #1::
+
+	$ modprobe ltc4261
+	$ echo ltc4261 0x10 > /sys/bus/i2c/devices/i2c-1/new_device
 
 
 Sysfs entries
@@ -51,6 +57,7 @@ the proximity of the ADIN2 pin to the OV pin. ADIN2 is, however, not available
 on all chip variants. To ensure that the alarm condition is reported to the user,
 report it with both voltage sensors.
 
+======================= =============================
 in1_input		ADIN2 voltage (mV)
 in1_min_alarm		ADIN/ADIN2 Undervoltage alarm
 in1_max_alarm		ADIN/ADIN2 Overvoltage alarm
@@ -61,3 +68,4 @@ in2_max_alarm		ADIN/ADIN2 Overvoltage alarm
 
 curr1_input		SENSE current (mA)
 curr1_alarm		SENSE overcurrent alarm
+======================= =============================
diff --git a/Documentation/hwmon/max16065 b/Documentation/hwmon/max16065
index 208a29e43010..fa5c852a178c 100644
--- a/Documentation/hwmon/max16065
+++ b/Documentation/hwmon/max16065
@@ -1,29 +1,49 @@
 Kernel driver max16065
 ======================
 
+
 Supported chips:
+
   * Maxim MAX16065, MAX16066
+
     Prefixes: 'max16065', 'max16066'
+
     Addresses scanned: -
+
     Datasheet:
+
 	http://datasheets.maxim-ic.com/en/ds/MAX16065-MAX16066.pdf
+
  *  Maxim MAX16067
+
     Prefix: 'max16067'
+
     Addresses scanned: -
+
     Datasheet:
+
 	http://datasheets.maxim-ic.com/en/ds/MAX16067.pdf
+
  *  Maxim MAX16068
+
     Prefix: 'max16068'
+
     Addresses scanned: -
+
     Datasheet:
+
 	http://datasheets.maxim-ic.com/en/ds/MAX16068.pdf
+
  *  Maxim MAX16070/MAX16071
+
     Prefixes: 'max16070', 'max16071'
+
     Addresses scanned: -
+
     Datasheet:
+
 	http://datasheets.maxim-ic.com/en/ds/MAX16070-MAX16071.pdf
 
-
 Author: Guenter Roeck <linux@roeck-us.net>
 
 
@@ -73,6 +93,7 @@ turn into a brick.
 Sysfs entries
 -------------
 
+======================= ========================================================
 in[0-11]_input		Input voltage measurements.
 
 in12_input		Voltage on CSP (Current Sense Positive) pin.
@@ -103,3 +124,4 @@ curr1_input		Current sense input; only if the chip supports current
 
 curr1_alarm		Overcurrent alarm; only if the chip supports current
 			sensing and if current sensing is enabled.
+======================= ========================================================
diff --git a/Documentation/hwmon/max6697 b/Documentation/hwmon/max6697
index 6594177ededa..ffc5a7d8d33b 100644
--- a/Documentation/hwmon/max6697
+++ b/Documentation/hwmon/max6697
@@ -2,38 +2,69 @@ Kernel driver max6697
 =====================
 
 Supported chips:
+
   * Maxim MAX6581
+
     Prefix: 'max6581'
+
     Datasheet: http://datasheets.maximintegrated.com/en/ds/MAX6581.pdf
+
   * Maxim MAX6602
+
     Prefix: 'max6602'
+
     Datasheet: http://datasheets.maximintegrated.com/en/ds/MAX6602.pdf
+
   * Maxim MAX6622
+
     Prefix: 'max6622'
+
     Datasheet: http://datasheets.maximintegrated.com/en/ds/MAX6622.pdf
+
   * Maxim MAX6636
+
     Prefix: 'max6636'
+
     Datasheet: http://datasheets.maximintegrated.com/en/ds/MAX6636.pdf
+
   * Maxim MAX6689
+
     Prefix: 'max6689'
+
     Datasheet: http://datasheets.maximintegrated.com/en/ds/MAX6689.pdf
+
   * Maxim MAX6693
+
     Prefix: 'max6693'
+
     Datasheet: http://datasheets.maximintegrated.com/en/ds/MAX6693.pdf
+
   * Maxim MAX6694
+
     Prefix: 'max6694'
+
     Datasheet: http://datasheets.maximintegrated.com/en/ds/MAX6694.pdf
+
   * Maxim MAX6697
+
     Prefix: 'max6697'
+
     Datasheet: http://datasheets.maximintegrated.com/en/ds/MAX6697.pdf
+
   * Maxim MAX6698
+
     Prefix: 'max6698'
+
     Datasheet: http://datasheets.maximintegrated.com/en/ds/MAX6698.pdf
+
   * Maxim MAX6699
+
     Prefix: 'max6699'
+
     Datasheet: http://datasheets.maximintegrated.com/en/ds/MAX6699.pdf
 
 Author:
+
     Guenter Roeck <linux@roeck-us.net>
 
 Description
@@ -50,9 +81,11 @@ The driver provides the following sysfs attributes. temp1 is the local (chip)
 temperature, temp[2..n] are remote temperatures. The actually supported
 per-channel attributes are chip type and channel dependent.
 
+================ == ==========================================================
 tempX_input      RO temperature
 tempX_max        RW temperature maximum threshold
 tempX_max_alarm  RO temperature maximum threshold alarm
 tempX_crit       RW temperature critical threshold
 tempX_crit_alarm RO temperature critical threshold alarm
 tempX_fault      RO temperature diode fault (remote sensors only)
+================ == ==========================================================
diff --git a/Documentation/hwmon/nct6775 b/Documentation/hwmon/nct6775
index bd59834d310f..1d0315c40952 100644
--- a/Documentation/hwmon/nct6775
+++ b/Documentation/hwmon/nct6775
@@ -1,52 +1,90 @@
-Note
-====
-
-This driver supersedes the NCT6775F and NCT6776F support in the W83627EHF
-driver.
-
 Kernel driver NCT6775
 =====================
 
+.. note::
+
+    This driver supersedes the NCT6775F and NCT6776F support in the W83627EHF
+    driver.
+
 Supported chips:
+
   * Nuvoton NCT6102D/NCT6104D/NCT6106D
+
     Prefix: 'nct6106'
+
     Addresses scanned: ISA address retrieved from Super I/O registers
+
     Datasheet: Available from the Nuvoton web site
+
   * Nuvoton NCT5572D/NCT6771F/NCT6772F/NCT6775F/W83677HG-I
+
     Prefix: 'nct6775'
+
     Addresses scanned: ISA address retrieved from Super I/O registers
+
     Datasheet: Available from Nuvoton upon request
+
   * Nuvoton NCT5573D/NCT5577D/NCT6776D/NCT6776F
+
     Prefix: 'nct6776'
+
     Addresses scanned: ISA address retrieved from Super I/O registers
+
     Datasheet: Available from Nuvoton upon request
+
   * Nuvoton NCT5532D/NCT6779D
+
     Prefix: 'nct6779'
+
     Addresses scanned: ISA address retrieved from Super I/O registers
+
     Datasheet: Available from Nuvoton upon request
+
   * Nuvoton NCT6791D
+
     Prefix: 'nct6791'
+
     Addresses scanned: ISA address retrieved from Super I/O registers
+
     Datasheet: Available from Nuvoton upon request
+
   * Nuvoton NCT6792D
+
     Prefix: 'nct6792'
+
     Addresses scanned: ISA address retrieved from Super I/O registers
+
     Datasheet: Available from Nuvoton upon request
+
   * Nuvoton NCT6793D
+
     Prefix: 'nct6793'
+
     Addresses scanned: ISA address retrieved from Super I/O registers
+
     Datasheet: Available from Nuvoton upon request
+
   * Nuvoton NCT6795D
+
     Prefix: 'nct6795'
+
     Addresses scanned: ISA address retrieved from Super I/O registers
+
     Datasheet: Available from Nuvoton upon request
+
   * Nuvoton NCT6796D
+
     Prefix: 'nct6796'
+
     Addresses scanned: ISA address retrieved from Super I/O registers
+
     Datasheet: Available from Nuvoton upon request
 
+
+
 Authors:
-        Guenter Roeck <linux@roeck-us.net>
+
+	Guenter Roeck <linux@roeck-us.net>
 
 Description
 -----------
@@ -96,10 +134,14 @@ The mode works for fan1-fan5.
 sysfs attributes
 ----------------
 
-pwm[1-7] - this file stores PWM duty cycle or DC value (fan speed) in range:
+pwm[1-7]
+    - this file stores PWM duty cycle or DC value (fan speed) in range:
+
 	   0 (lowest speed) to 255 (full)
 
-pwm[1-7]_enable - this file controls mode of fan/temperature control:
+pwm[1-7]_enable
+    - this file controls mode of fan/temperature control:
+
 	* 0 Fan control disabled (fans set to maximum speed)
 	* 1 Manual mode, write to pwm[0-5] any value 0-255
 	* 2 "Thermal Cruise" mode
@@ -107,15 +149,19 @@ pwm[1-7]_enable - this file controls mode of fan/temperature control:
 	* 4 "Smart Fan III" mode (NCT6775F only)
 	* 5 "Smart Fan IV" mode
 
-pwm[1-7]_mode - controls if output is PWM or DC level
-        * 0 DC output
-        * 1 PWM output
+pwm[1-7]_mode
+    - controls if output is PWM or DC level
+
+	* 0 DC output
+	* 1 PWM output
 
 Common fan control attributes
 -----------------------------
 
-pwm[1-7]_temp_sel	Temperature source. Value is temperature sensor index.
+pwm[1-7]_temp_sel
+			Temperature source. Value is temperature sensor index.
 			For example, select '1' for temp1_input.
+
 pwm[1-7]_weight_temp_sel
 			Secondary temperature source. Value is temperature
 			sensor index. For example, select '1' for temp1_input.
@@ -126,13 +172,16 @@ following attributes.
 
 pwm[1-7]_weight_duty_step
 			Duty step size.
+
 pwm[1-7]_weight_temp_step
 			Temperature step size. With each step over
 			temp_step_base, the value of weight_duty_step is added
 			to the current pwm value.
+
 pwm[1-7]_weight_temp_step_base
 			Temperature at which secondary temperature control kicks
 			in.
+
 pwm[1-7]_weight_temp_step_tol
 			Temperature step tolerance.
 
@@ -141,24 +190,35 @@ Thermal Cruise mode (2)
 
 If the temperature is in the range defined by:
 
-pwm[1-7]_target_temp	Target temperature, unit millidegree Celsius
+pwm[1-7]_target_temp
+			Target temperature, unit millidegree Celsius
 			(range 0 - 127000)
+
 pwm[1-7]_temp_tolerance
 			Target temperature tolerance, unit millidegree Celsius
 
-there are no changes to fan speed. Once the temperature leaves the interval, fan
+There are no changes to fan speed. Once the temperature leaves the interval, fan
 speed increases (if temperature is higher that desired) or decreases (if
 temperature is lower than desired), using the following limits and time
 intervals.
 
-pwm[1-7]_start		fan pwm start value (range 1 - 255), to start fan
+pwm[1-7]_start
+			fan pwm start value (range 1 - 255), to start fan
 			when the temperature is above defined range.
-pwm[1-7]_floor		lowest fan pwm (range 0 - 255) if temperature is below
+
+pwm[1-7]_floor
+			lowest fan pwm (range 0 - 255) if temperature is below
 			the defined range. If set to 0, the fan is expected to
 			stop if the temperature is below the defined range.
-pwm[1-7]_step_up_time	milliseconds before fan speed is increased
-pwm[1-7]_step_down_time	milliseconds before fan speed is decreased
-pwm[1-7]_stop_time	how many milliseconds must elapse to switch
+
+pwm[1-7]_step_up_time
+			milliseconds before fan speed is increased
+
+pwm[1-7]_step_down_time
+			milliseconds before fan speed is decreased
+
+pwm[1-7]_stop_time
+			how many milliseconds must elapse to switch
 			corresponding fan off (when the temperature was below
 			defined range).
 
@@ -167,7 +227,9 @@ Speed Cruise mode (3)
 
 This modes tries to keep the fan speed constant.
 
-fan[1-7]_target		Target fan speed
+fan[1-7]_target
+			Target fan speed
+
 fan[1-7]_tolerance
 			Target speed tolerance
 
@@ -188,16 +250,22 @@ critical temperature mode, in which the fans should run at full speed.
 pwm[1-7]_auto_point[1-7]_pwm
 			pwm value to be set if temperature reaches matching
 			temperature range.
+
 pwm[1-7]_auto_point[1-7]_temp
 			Temperature over which the matching pwm is enabled.
+
 pwm[1-7]_temp_tolerance
 			Temperature tolerance, unit millidegree Celsius
+
 pwm[1-7]_crit_temp_tolerance
 			Temperature tolerance for critical temperature,
 			unit millidegree Celsius
 
-pwm[1-7]_step_up_time	milliseconds before fan speed is increased
-pwm[1-7]_step_down_time	milliseconds before fan speed is decreased
+pwm[1-7]_step_up_time
+			milliseconds before fan speed is increased
+
+pwm[1-7]_step_down_time
+			milliseconds before fan speed is decreased
 
 Usage Notes
 -----------
diff --git a/Documentation/hwmon/smm665 b/Documentation/hwmon/smm665
index a341eeedab75..a0e27f62b57b 100644
--- a/Documentation/hwmon/smm665
+++ b/Documentation/hwmon/smm665
@@ -2,31 +2,57 @@ Kernel driver smm665
 ====================
 
 Supported chips:
+
   * Summit Microelectronics SMM465
+
     Prefix: 'smm465'
+
     Addresses scanned: -
+
     Datasheet:
+
       http://www.summitmicro.com/prod_select/summary/SMM465/SMM465DS.pdf
+
   * Summit Microelectronics SMM665, SMM665B
+
     Prefix: 'smm665'
+
     Addresses scanned: -
+
     Datasheet:
+
       http://www.summitmicro.com/prod_select/summary/SMM665/SMM665B_2089_20.pdf
+
   * Summit Microelectronics SMM665C
+
     Prefix: 'smm665c'
+
     Addresses scanned: -
+
     Datasheet:
+
       http://www.summitmicro.com/prod_select/summary/SMM665C/SMM665C_2125.pdf
+
   * Summit Microelectronics SMM764
+
     Prefix: 'smm764'
+
     Addresses scanned: -
+
     Datasheet:
+
       http://www.summitmicro.com/prod_select/summary/SMM764/SMM764_2098.pdf
+
   * Summit Microelectronics SMM766, SMM766B
+
     Prefix: 'smm766'
+
     Addresses scanned: -
+
     Datasheets:
+
       http://www.summitmicro.com/prod_select/summary/SMM766/SMM766_2086.pdf
+
       http://www.summitmicro.com/prod_select/summary/SMM766B/SMM766B_2122.pdf
 
 Author: Guenter Roeck <linux@roeck-us.net>
@@ -36,9 +62,10 @@ Module Parameters
 -----------------
 
 * vref: int
-  Default: 1250 (mV)
-  Reference voltage on VREF_ADC pin in mV. It should not be necessary to set
-  this parameter unless a non-default reference voltage is used.
+    Default: 1250 (mV)
+
+    Reference voltage on VREF_ADC pin in mV. It should not be necessary to set
+    this parameter unless a non-default reference voltage is used.
 
 
 Description
@@ -64,9 +91,10 @@ the devices explicitly. When instantiating the device, you have to specify
 its configuration register address.
 
 Example: the following will load the driver for an SMM665 at address 0x57
-on I2C bus #1:
-$ modprobe smm665
-$ echo smm665 0x57 > /sys/bus/i2c/devices/i2c-1/new_device
+on I2C bus #1::
+
+	$ modprobe smm665
+	$ echo smm665 0x57 > /sys/bus/i2c/devices/i2c-1/new_device
 
 
 Sysfs entries
@@ -84,6 +112,7 @@ max otherwise. For details please see the SMM665 datasheet.
 
 For SMM465 and SMM764, values for Channel E and F are reported but undefined.
 
+======================= =======================================================
 in1_input		12V input voltage (mV)
 in2_input		3.3V (VDD) input voltage (mV)
 in3_input		Channel A voltage (mV)
@@ -155,3 +184,4 @@ temp1_min		Mimimum chip temperature
 temp1_max		Maximum chip temperature
 temp1_crit		Critical chip temperature
 temp1_crit_alarm	Temperature critical alarm
+======================= =======================================================
diff --git a/Documentation/hwmon/tmp401 b/Documentation/hwmon/tmp401
index 2d9ca42213cf..bd865bbdb38d 100644
--- a/Documentation/hwmon/tmp401
+++ b/Documentation/hwmon/tmp401
@@ -2,33 +2,59 @@ Kernel driver tmp401
 ====================
 
 Supported chips:
+
   * Texas Instruments TMP401
+
     Prefix: 'tmp401'
+
     Addresses scanned: I2C 0x4c
+
     Datasheet: http://focus.ti.com/docs/prod/folders/print/tmp401.html
+
   * Texas Instruments TMP411
+
     Prefix: 'tmp411'
+
     Addresses scanned: I2C 0x4c, 0x4d, 0x4e
+
     Datasheet: http://focus.ti.com/docs/prod/folders/print/tmp411.html
+
   * Texas Instruments TMP431
+
     Prefix: 'tmp431'
+
     Addresses scanned: I2C 0x4c, 0x4d
+
     Datasheet: http://focus.ti.com/docs/prod/folders/print/tmp431.html
+
   * Texas Instruments TMP432
+
     Prefix: 'tmp432'
+
     Addresses scanned: I2C 0x4c, 0x4d
+
     Datasheet: http://focus.ti.com/docs/prod/folders/print/tmp432.html
+
   * Texas Instruments TMP435
+
     Prefix: 'tmp435'
+
     Addresses scanned: I2C 0x48 - 0x4f
+
     Datasheet: http://focus.ti.com/docs/prod/folders/print/tmp435.html
+
   * Texas Instruments TMP461
+
     Prefix: 'tmp461'
+
     Datasheet: http://www.ti.com/product/tmp461
 
+
+
 Authors:
-         Hans de Goede <hdegoede@redhat.com>
-	 Andre Prendel <andre.prendel@gmx.de>
+
+	- Hans de Goede <hdegoede@redhat.com>
+	- Andre Prendel <andre.prendel@gmx.de>
 
 Description
 -----------
-- 
2.20.1


^ permalink raw reply related	[flat|nested] 73+ messages in thread

* [PATCH v2 20/21] docs: hwmon: convert remaining files to ReST format
  2019-04-10 19:22 [PATCH v2 00/21] Convert hwmon documentation to ReST Mauro Carvalho Chehab
                   ` (18 preceding siblings ...)
  2019-04-10 19:22 ` [PATCH v2 19/21] docs: hwmon: misc " Mauro Carvalho Chehab
@ 2019-04-10 19:22 ` Mauro Carvalho Chehab
  2019-04-10 19:22 ` [PATCH v2 21/21] docs: hwmon: Add an index file and rename docs to *.rst Mauro Carvalho Chehab
  2019-04-11 18:43 ` [PATCH v2 00/21] Convert hwmon documentation to ReST Jonathan Corbet
  21 siblings, 0 replies; 73+ messages in thread
From: Mauro Carvalho Chehab @ 2019-04-10 19:22 UTC (permalink / raw)
  To: Linux Doc Mailing List
  Cc: Mauro Carvalho Chehab, Mauro Carvalho Chehab, linux-kernel,
	Jonathan Corbet, Jean Delvare, Guenter Roeck, linux-hwmon

Convert all other hwmon files to ReST format, in order to allow
them to be parsed by Sphinx.

Signed-off-by: Mauro Carvalho Chehab <mchehab+samsung@kernel.org>
---
 Documentation/hwmon/ab8500               |   8 +-
 Documentation/hwmon/abituguru            |  97 ++--
 Documentation/hwmon/abituguru-datasheet  | 160 +++---
 Documentation/hwmon/abituguru3           |  36 +-
 Documentation/hwmon/abx500               |   8 +-
 Documentation/hwmon/acpi_power_meter     |  23 +-
 Documentation/hwmon/ad7314               |   9 +
 Documentation/hwmon/adc128d818           |   7 +-
 Documentation/hwmon/adm1021              |  44 +-
 Documentation/hwmon/adm1025              |  13 +-
 Documentation/hwmon/adm1026              |  24 +-
 Documentation/hwmon/adm1031              |  16 +-
 Documentation/hwmon/adm9240              |  50 +-
 Documentation/hwmon/ads7828              |  29 +-
 Documentation/hwmon/adt7410              |  49 +-
 Documentation/hwmon/adt7411              |  20 +-
 Documentation/hwmon/adt7462              |  10 +-
 Documentation/hwmon/adt7470              |   8 +-
 Documentation/hwmon/adt7475              |  38 +-
 Documentation/hwmon/amc6821              |  19 +-
 Documentation/hwmon/asb100               |  50 +-
 Documentation/hwmon/ds1621               | 154 +++--
 Documentation/hwmon/ds620                |  12 +-
 Documentation/hwmon/emc1403              |  33 +-
 Documentation/hwmon/emc6w201             |   5 +
 Documentation/hwmon/f71805f              |  36 +-
 Documentation/hwmon/f71882fg             |  56 +-
 Documentation/hwmon/ftsteutates          |  14 +-
 Documentation/hwmon/g760a                |   4 +
 Documentation/hwmon/g762                 |  65 ++-
 Documentation/hwmon/gl518sm              |  21 +-
 Documentation/hwmon/hih6130              |  14 +-
 Documentation/hwmon/hwmon-kernel-api.txt | 294 +++++-----
 Documentation/hwmon/ibmaem               |  10 +-
 Documentation/hwmon/ina3221              |  17 +-
 Documentation/hwmon/it87                 | 102 +++-
 Documentation/hwmon/lineage-pem          |  16 +-
 Documentation/hwmon/lm63                 |  24 +-
 Documentation/hwmon/lm70                 |  13 +-
 Documentation/hwmon/lm73                 |  16 +-
 Documentation/hwmon/lm75                 |  96 +++-
 Documentation/hwmon/lm77                 |   9 +-
 Documentation/hwmon/lm78                 |  20 +-
 Documentation/hwmon/lm80                 |  19 +-
 Documentation/hwmon/lm83                 |  16 +-
 Documentation/hwmon/lm85                 |  97 +++-
 Documentation/hwmon/lm87                 |  23 +-
 Documentation/hwmon/lm90                 | 174 +++++-
 Documentation/hwmon/lm92                 |  17 +-
 Documentation/hwmon/lm93                 | 157 ++---
 Documentation/hwmon/lm95245              |  13 +-
 Documentation/hwmon/ltc2945              |  16 +-
 Documentation/hwmon/ltc2990              |  23 +-
 Documentation/hwmon/ltc4151              |  16 +-
 Documentation/hwmon/ltc4215              |  16 +-
 Documentation/hwmon/ltc4245              |  17 +-
 Documentation/hwmon/ltc4260              |  16 +-
 Documentation/hwmon/max1619              |  11 +-
 Documentation/hwmon/max1668              |  14 +-
 Documentation/hwmon/max197               |  36 +-
 Documentation/hwmon/max31722             |  12 +
 Documentation/hwmon/max31790             |   6 +
 Documentation/hwmon/max6639              |  16 +-
 Documentation/hwmon/max6642              |  10 +-
 Documentation/hwmon/max6650              |  16 +-
 Documentation/hwmon/mc13783-adc          |  27 +-
 Documentation/hwmon/mcp3021              |  15 +-
 Documentation/hwmon/mlxreg-fan           |  60 +-
 Documentation/hwmon/nct6683              |  11 +-
 Documentation/hwmon/nct7802              |  11 +-
 Documentation/hwmon/nct7904              |   9 +-
 Documentation/hwmon/npcm750-pwm-fan      |   4 +
 Documentation/hwmon/nsa320               |  15 +-
 Documentation/hwmon/ntc_thermistor       | 123 ++--
 Documentation/hwmon/occ                  |  93 ++-
 Documentation/hwmon/pc87427              |   4 +
 Documentation/hwmon/pcf8591              |  52 +-
 Documentation/hwmon/powr1220             |  12 +-
 Documentation/hwmon/raspberrypi-hwmon    |   3 +
 Documentation/hwmon/sch5636              |   3 +
 Documentation/hwmon/scpi-hwmon           |   7 +-
 Documentation/hwmon/sht15                |  28 +-
 Documentation/hwmon/sht21                |  24 +-
 Documentation/hwmon/sht3x                |  42 +-
 Documentation/hwmon/shtc1                |  19 +-
 Documentation/hwmon/sis5595              |  40 +-
 Documentation/hwmon/smsc47b397           | 158 +++--
 Documentation/hwmon/smsc47m1             |  43 +-
 Documentation/hwmon/smsc47m192           |  97 ++--
 Documentation/hwmon/submitting-patches   |  15 +-
 Documentation/hwmon/sysfs-interface      | 696 ++++++++++++++++-------
 Documentation/hwmon/tc654                |   9 +-
 Documentation/hwmon/tc74                 |   3 +
 Documentation/hwmon/thmc50               |  36 +-
 Documentation/hwmon/tmp102               |   5 +
 Documentation/hwmon/tmp103               |   5 +
 Documentation/hwmon/tmp108               |   5 +
 Documentation/hwmon/tmp421               |  26 +-
 Documentation/hwmon/twl4030-madc-hwmon   |   8 +-
 Documentation/hwmon/userspace-tools      |   3 +
 Documentation/hwmon/via686a              |  30 +-
 Documentation/hwmon/w83627ehf            | 160 ++++--
 Documentation/hwmon/w83627hf             |  65 ++-
 Documentation/hwmon/w83773g              |  12 +-
 Documentation/hwmon/w83781d              | 330 ++++++-----
 Documentation/hwmon/w83792d              | 112 ++--
 Documentation/hwmon/w83795               | 221 +++----
 Documentation/hwmon/w83l785ts            |   9 +-
 Documentation/hwmon/w83l786ng            |  42 +-
 Documentation/hwmon/xgene-hwmon          |  24 +-
 110 files changed, 3503 insertions(+), 1703 deletions(-)

diff --git a/Documentation/hwmon/ab8500 b/Documentation/hwmon/ab8500
index cf169c8ef4e3..d87c61151239 100644
--- a/Documentation/hwmon/ab8500
+++ b/Documentation/hwmon/ab8500
@@ -2,14 +2,18 @@ Kernel driver ab8500
 ====================
 
 Supported chips:
+
   * ST-Ericsson AB8500
+
     Prefix: 'ab8500'
+
     Addresses scanned: -
+
     Datasheet: http://www.stericsson.com/developers/documentation.jsp
 
 Authors:
-        Martin Persson <martin.persson@stericsson.com>
-        Hongbo Zhang <hongbo.zhang@linaro.org>
+	- Martin Persson <martin.persson@stericsson.com>
+	- Hongbo Zhang <hongbo.zhang@linaro.org>
 
 Description
 -----------
diff --git a/Documentation/hwmon/abituguru b/Documentation/hwmon/abituguru
index 44013d23b3f0..d8243c827de9 100644
--- a/Documentation/hwmon/abituguru
+++ b/Documentation/hwmon/abituguru
@@ -2,69 +2,85 @@ Kernel driver abituguru
 =======================
 
 Supported chips:
+
   * Abit uGuru revision 1 & 2 (Hardware Monitor part only)
+
     Prefix: 'abituguru'
+
     Addresses scanned: ISA 0x0E0
+
     Datasheet: Not available, this driver is based on reverse engineering.
-	A "Datasheet" has been written based on the reverse engineering it
-	should be available in the same dir as this file under the name
-	abituguru-datasheet.
+    A "Datasheet" has been written based on the reverse engineering it
+    should be available in the same dir as this file under the name
+    abituguru-datasheet.
+
     Note:
 	The uGuru is a microcontroller with onboard firmware which programs
 	it to behave as a hwmon IC. There are many different revisions of the
 	firmware and thus effectivly many different revisions of the uGuru.
 	Below is an incomplete list with which revisions are used for which
 	Motherboards:
-	uGuru 1.00    ~ 1.24    (AI7, KV8-MAX3, AN7) (1)
-	uGuru 2.0.0.0 ~ 2.0.4.2 (KV8-PRO)
-	uGuru 2.1.0.0 ~ 2.1.2.8 (AS8, AV8, AA8, AG8, AA8XE, AX8)
-	uGuru 2.2.0.0 ~ 2.2.0.6 (AA8 Fatal1ty)
-	uGuru 2.3.0.0 ~ 2.3.0.9 (AN8)
-	uGuru 3.0.0.0 ~ 3.0.x.x (AW8, AL8, AT8, NI8 SLI, AT8 32X, AN8 32X,
-				 AW9D-MAX) (2)
-	1) For revisions 2 and 3 uGuru's the driver can autodetect the
-	   sensortype (Volt or Temp) for bank1 sensors, for revision 1 uGuru's
-	   this does not always work. For these uGuru's the autodetection can
-	   be overridden with the bank1_types module param. For all 3 known
-	   revison 1 motherboards the correct use of this param is:
-	   bank1_types=1,1,0,0,0,0,0,2,0,0,0,0,2,0,0,1
-	   You may also need to specify the fan_sensors option for these boards
-	   fan_sensors=5
-	2) There is a separate abituguru3 driver for these motherboards,
-	   the abituguru (without the 3 !) driver will not work on these
-	   motherboards (and visa versa)!
+
+	- uGuru 1.00    ~ 1.24    (AI7, KV8-MAX3, AN7) [1]_
+	- uGuru 2.0.0.0 ~ 2.0.4.2 (KV8-PRO)
+	- uGuru 2.1.0.0 ~ 2.1.2.8 (AS8, AV8, AA8, AG8, AA8XE, AX8)
+	- uGuru 2.2.0.0 ~ 2.2.0.6 (AA8 Fatal1ty)
+	- uGuru 2.3.0.0 ~ 2.3.0.9 (AN8)
+	- uGuru 3.0.0.0 ~ 3.0.x.x (AW8, AL8, AT8, NI8 SLI, AT8 32X, AN8 32X,
+	  AW9D-MAX) [2]_
+
+.. [1]  For revisions 2 and 3 uGuru's the driver can autodetect the
+	sensortype (Volt or Temp) for bank1 sensors, for revision 1 uGuru's
+	this does not always work. For these uGuru's the autodetection can
+	be overridden with the bank1_types module param. For all 3 known
+	revison 1 motherboards the correct use of this param is:
+	bank1_types=1,1,0,0,0,0,0,2,0,0,0,0,2,0,0,1
+	You may also need to specify the fan_sensors option for these boards
+	fan_sensors=5
+
+.. [2]  There is a separate abituguru3 driver for these motherboards,
+	the abituguru (without the 3 !) driver will not work on these
+	motherboards (and visa versa)!
 
 Authors:
-	Hans de Goede <j.w.r.degoede@hhs.nl>,
-	(Initial reverse engineering done by Olle Sandberg
-	 <ollebull@gmail.com>)
+	- Hans de Goede <j.w.r.degoede@hhs.nl>,
+	- (Initial reverse engineering done by Olle Sandberg
+	  <ollebull@gmail.com>)
 
 
 Module Parameters
 -----------------
 
-* force: bool		Force detection. Note this parameter only causes the
+* force: bool
+			Force detection. Note this parameter only causes the
 			detection to be skipped, and thus the insmod to
 			succeed. If the uGuru can't be read the actual hwmon
 			driver will not load and thus no hwmon device will get
 			registered.
-* bank1_types: int[]	Bank1 sensortype autodetection override:
-			  -1 autodetect (default)
-			   0 volt sensor
-			   1 temp sensor
-			   2 not connected
-* fan_sensors: int	Tell the driver how many fan speed sensors there are
+* bank1_types: int[]
+			Bank1 sensortype autodetection override:
+
+			  * -1 autodetect (default)
+			  *  0 volt sensor
+			  *  1 temp sensor
+			  *  2 not connected
+* fan_sensors: int
+			Tell the driver how many fan speed sensors there are
 			on your motherboard. Default: 0 (autodetect).
-* pwms: int		Tell the driver how many fan speed controls (fan
+* pwms: int
+			Tell the driver how many fan speed controls (fan
 			pwms) your motherboard has. Default: 0 (autodetect).
-* verbose: int		How verbose should the driver be? (0-3):
-			   0 normal output
-			   1 + verbose error reporting
-			   2 + sensors type probing info (default)
-			   3 + retryable error reporting
+* verbose: int
+			How verbose should the driver be? (0-3):
+
+			   * 0 normal output
+			   * 1 + verbose error reporting
+			   * 2 + sensors type probing info (default)
+			   * 3 + retryable error reporting
+
 			Default: 2 (the driver is still in the testing phase)
 
-Notice if you need any of the first three options above please insmod the
+Notice: if you need any of the first three options above please insmod the
 driver with verbose set to 3 and mail me <j.w.r.degoede@hhs.nl> the output of:
 dmesg | grep abituguru
 
@@ -90,3 +106,8 @@ Known Issues
 ------------
 
 The voltage and frequency control parts of the Abit uGuru are not supported.
+
+.. toctree::
+   :maxdepth: 1
+
+   abituguru-datasheet.rst
diff --git a/Documentation/hwmon/abituguru-datasheet b/Documentation/hwmon/abituguru-datasheet
index 86c0b1251c81..6d5253e2223b 100644
--- a/Documentation/hwmon/abituguru-datasheet
+++ b/Documentation/hwmon/abituguru-datasheet
@@ -1,3 +1,4 @@
+===============
 uGuru datasheet
 ===============
 
@@ -168,34 +169,35 @@ This bank contains 0 sensors, iow the sensor address is ignored (but must be
 written) just use 0. Bank 0x20 contains 3 bytes:
 
 Byte 0:
-This byte holds the alarm flags for sensor 0-7 of Sensor Bank1, with bit 0
-corresponding to sensor 0, 1 to 1, etc.
+  This byte holds the alarm flags for sensor 0-7 of Sensor Bank1, with bit 0
+  corresponding to sensor 0, 1 to 1, etc.
 
 Byte 1:
-This byte holds the alarm flags for sensor 8-15 of Sensor Bank1, with bit 0
-corresponding to sensor 8, 1 to 9, etc.
+  This byte holds the alarm flags for sensor 8-15 of Sensor Bank1, with bit 0
+  corresponding to sensor 8, 1 to 9, etc.
 
 Byte 2:
-This byte holds the alarm flags for sensor 0-5 of Sensor Bank2, with bit 0
-corresponding to sensor 0, 1 to 1, etc.
+  This byte holds the alarm flags for sensor 0-5 of Sensor Bank2, with bit 0
+  corresponding to sensor 0, 1 to 1, etc.
 
 
 Bank 0x21 Sensor Bank1 Values / Readings (R)
 --------------------------------------------
 This bank contains 16 sensors, for each sensor it contains 1 byte.
 So far the following sensors are known to be available on all motherboards:
-Sensor  0 CPU temp
-Sensor  1 SYS temp
-Sensor  3 CPU core volt
-Sensor  4 DDR volt
-Sensor 10 DDR Vtt volt
-Sensor 15 PWM temp
+
+- Sensor  0 CPU temp
+- Sensor  1 SYS temp
+- Sensor  3 CPU core volt
+- Sensor  4 DDR volt
+- Sensor 10 DDR Vtt volt
+- Sensor 15 PWM temp
 
 Byte 0:
-This byte holds the reading from the sensor. Sensors in Bank1 can be both
-volt and temp sensors, this is motherboard specific. The uGuru however does
-seem to know (be programmed with) what kindoff sensor is attached see Sensor
-Bank1 Settings description.
+  This byte holds the reading from the sensor. Sensors in Bank1 can be both
+  volt and temp sensors, this is motherboard specific. The uGuru however does
+  seem to know (be programmed with) what kindoff sensor is attached see Sensor
+  Bank1 Settings description.
 
 Volt sensors use a linear scale, a reading 0 corresponds with 0 volt and a
 reading of 255 with 3494 mV. The sensors for higher voltages however are
@@ -207,96 +209,118 @@ Temp sensors also use a linear scale, a reading of 0 corresponds with 0 degree
 Celsius and a reading of 255 with a reading of 255 degrees Celsius.
 
 
-Bank 0x22 Sensor Bank1 Settings (R)
-Bank 0x23 Sensor Bank1 Settings (W)
------------------------------------
+Bank 0x22 Sensor Bank1 Settings (R) and Bank 0x23 Sensor Bank1 Settings (W)
+---------------------------------------------------------------------------
 
-This bank contains 16 sensors, for each sensor it contains 3 bytes. Each
+Those banks contain 16 sensors, for each sensor it contains 3 bytes. Each
 set of 3 bytes contains the settings for the sensor with the same sensor
 address in Bank 0x21 .
 
 Byte 0:
-Alarm behaviour for the selected sensor. A 1 enables the described behaviour.
-Bit 0: Give an alarm if measured temp is over the warning threshold	(RW) *
-Bit 1: Give an alarm if measured volt is over the max threshold		(RW) **
-Bit 2: Give an alarm if measured volt is under the min threshold	(RW) **
-Bit 3: Beep if alarm							(RW)
-Bit 4: 1 if alarm cause measured temp is over the warning threshold	(R)
-Bit 5: 1 if alarm cause measured volt is over the max threshold		(R)
-Bit 6: 1 if alarm cause measured volt is under the min threshold	(R)
-Bit 7: Volt sensor: Shutdown if alarm persist for more than 4 seconds	(RW)
-       Temp sensor: Shutdown if temp is over the shutdown threshold	(RW)
-
-*  This bit is only honored/used by the uGuru if a temp sensor is connected
-** This bit is only honored/used by the uGuru if a volt sensor is connected
-Note with some trickery this can be used to find out what kinda sensor is
-detected see the Linux kernel driver for an example with many comments on
-how todo this.
+  Alarm behaviour for the selected sensor. A 1 enables the described
+  behaviour.
+
+Bit 0:
+  Give an alarm if measured temp is over the warning threshold		(RW) [1]_
+
+Bit 1:
+  Give an alarm if measured volt is over the max threshold		(RW) [2]_
+
+Bit 2:
+  Give an alarm if measured volt is under the min threshold		(RW) [2]_
+
+Bit 3:
+  Beep if alarm								(RW)
+
+Bit 4:
+  1 if alarm cause measured temp is over the warning threshold		(R)
+
+Bit 5:
+  1 if alarm cause measured volt is over the max threshold		(R)
+
+Bit 6:
+  1 if alarm cause measured volt is under the min threshold		(R)
+
+Bit 7:
+  - Volt sensor: Shutdown if alarm persist for more than 4 seconds	(RW)
+  - Temp sensor: Shutdown if temp is over the shutdown threshold	(RW)
+
+.. [1] This bit is only honored/used by the uGuru if a temp sensor is connected
+
+.. [2] This bit is only honored/used by the uGuru if a volt sensor is connected
+       Note with some trickery this can be used to find out what kinda sensor
+       is detected see the Linux kernel driver for an example with many
+       comments on how todo this.
 
 Byte 1:
-Temp sensor: warning threshold  (scale as bank 0x21)
-Volt sensor: min threshold      (scale as bank 0x21)
+  - Temp sensor: warning threshold  (scale as bank 0x21)
+  - Volt sensor: min threshold      (scale as bank 0x21)
 
 Byte 2:
-Temp sensor: shutdown threshold (scale as bank 0x21)
-Volt sensor: max threshold      (scale as bank 0x21)
+  - Temp sensor: shutdown threshold (scale as bank 0x21)
+  - Volt sensor: max threshold      (scale as bank 0x21)
 
 
-Bank 0x24 PWM outputs for FAN's (R)
-Bank 0x25 PWM outputs for FAN's (W)
------------------------------------
+Bank 0x24 PWM outputs for FAN's (R) and Bank 0x25 PWM outputs for FAN's (W)
+---------------------------------------------------------------------------
 
-This bank contains 3 "sensors", for each sensor it contains 5 bytes.
-Sensor 0 usually controls the CPU fan
-Sensor 1 usually controls the NB (or chipset for single chip) fan
-Sensor 2 usually controls the System fan
+Those banks contain 3 "sensors", for each sensor it contains 5 bytes.
+  - Sensor 0 usually controls the CPU fan
+  - Sensor 1 usually controls the NB (or chipset for single chip) fan
+  - Sensor 2 usually controls the System fan
 
 Byte 0:
-Flag 0x80 to enable control, Fan runs at 100% when disabled.
-low nibble (temp)sensor address at bank 0x21 used for control.
+  Flag 0x80 to enable control, Fan runs at 100% when disabled.
+  low nibble (temp)sensor address at bank 0x21 used for control.
 
 Byte 1:
-0-255 = 0-12v (linear), specify voltage at which fan will rotate when under
-low threshold temp (specified in byte 3)
+  0-255 = 0-12v (linear), specify voltage at which fan will rotate when under
+  low threshold temp (specified in byte 3)
 
 Byte 2:
-0-255 = 0-12v (linear), specify voltage at which fan will rotate when above
-high threshold temp (specified in byte 4)
+  0-255 = 0-12v (linear), specify voltage at which fan will rotate when above
+  high threshold temp (specified in byte 4)
 
 Byte 3:
-Low threshold temp  (scale as bank 0x21)
+  Low threshold temp  (scale as bank 0x21)
 
 byte 4:
-High threshold temp (scale as bank 0x21)
+  High threshold temp (scale as bank 0x21)
 
 
 Bank 0x26 Sensors Bank2 Values / Readings (R)
 ---------------------------------------------
 
 This bank contains 6 sensors (AFAIK), for each sensor it contains 1 byte.
+
 So far the following sensors are known to be available on all motherboards:
-Sensor 0: CPU fan speed
-Sensor 1: NB (or chipset for single chip) fan speed
-Sensor 2: SYS fan speed
+  - Sensor 0: CPU fan speed
+  - Sensor 1: NB (or chipset for single chip) fan speed
+  - Sensor 2: SYS fan speed
 
 Byte 0:
-This byte holds the reading from the sensor. 0-255 = 0-15300 (linear)
+  This byte holds the reading from the sensor. 0-255 = 0-15300 (linear)
 
 
-Bank 0x27 Sensors Bank2 Settings (R)
-Bank 0x28 Sensors Bank2 Settings (W)
-------------------------------------
+Bank 0x27 Sensors Bank2 Settings (R) and Bank 0x28 Sensors Bank2 Settings (W)
+-----------------------------------------------------------------------------
 
-This bank contains 6 sensors (AFAIK), for each sensor it contains 2 bytes.
+Those banks contain 6 sensors (AFAIK), for each sensor it contains 2 bytes.
 
 Byte 0:
-Alarm behaviour for the selected sensor. A 1 enables the described behaviour.
-Bit 0: Give an alarm if measured rpm is under the min threshold	(RW)
-Bit 3: Beep if alarm						(RW)
-Bit 7: Shutdown if alarm persist for more than 4 seconds	(RW)
+  Alarm behaviour for the selected sensor. A 1 enables the described behaviour.
+
+Bit 0:
+  Give an alarm if measured rpm is under the min threshold	(RW)
+
+Bit 3:
+  Beep if alarm							(RW)
+
+Bit 7:
+  Shutdown if alarm persist for more than 4 seconds		(RW)
 
 Byte 1:
-min threshold (scale as bank 0x26)
+  min threshold (scale as bank 0x26)
 
 
 Warning for the adventurous
diff --git a/Documentation/hwmon/abituguru3 b/Documentation/hwmon/abituguru3
index a6ccfe4bb6aa..514f11f41e8b 100644
--- a/Documentation/hwmon/abituguru3
+++ b/Documentation/hwmon/abituguru3
@@ -3,41 +3,51 @@ Kernel driver abituguru3
 
 Supported chips:
   * Abit uGuru revision 3 (Hardware Monitor part, reading only)
+
     Prefix: 'abituguru3'
+
     Addresses scanned: ISA 0x0E0
+
     Datasheet: Not available, this driver is based on reverse engineering.
+
     Note:
 	The uGuru is a microcontroller with onboard firmware which programs
 	it to behave as a hwmon IC. There are many different revisions of the
 	firmware and thus effectivly many different revisions of the uGuru.
 	Below is an incomplete list with which revisions are used for which
 	Motherboards:
-	uGuru 1.00    ~ 1.24    (AI7, KV8-MAX3, AN7)
-	uGuru 2.0.0.0 ~ 2.0.4.2 (KV8-PRO)
-	uGuru 2.1.0.0 ~ 2.1.2.8 (AS8, AV8, AA8, AG8, AA8XE, AX8)
-	uGuru 2.3.0.0 ~ 2.3.0.9 (AN8)
-	uGuru 3.0.0.0 ~ 3.0.x.x (AW8, AL8, AT8, NI8 SLI, AT8 32X, AN8 32X,
-				 AW9D-MAX)
+
+	- uGuru 1.00    ~ 1.24    (AI7, KV8-MAX3, AN7)
+	- uGuru 2.0.0.0 ~ 2.0.4.2 (KV8-PRO)
+	- uGuru 2.1.0.0 ~ 2.1.2.8 (AS8, AV8, AA8, AG8, AA8XE, AX8)
+	- uGuru 2.3.0.0 ~ 2.3.0.9 (AN8)
+	- uGuru 3.0.0.0 ~ 3.0.x.x (AW8, AL8, AT8, NI8 SLI, AT8 32X, AN8 32X,
+	  AW9D-MAX)
+
 	The abituguru3 driver is only for revison 3.0.x.x motherboards,
 	this driver will not work on older motherboards. For older
 	motherboards use the abituguru (without the 3 !) driver.
 
 Authors:
-	Hans de Goede <j.w.r.degoede@hhs.nl>,
-	(Initial reverse engineering done by Louis Kruger)
+	- Hans de Goede <j.w.r.degoede@hhs.nl>,
+	- (Initial reverse engineering done by Louis Kruger)
 
 
 Module Parameters
 -----------------
 
-* force: bool		Force detection. Note this parameter only causes the
+* force: bool
+			Force detection. Note this parameter only causes the
 			detection to be skipped, and thus the insmod to
 			succeed. If the uGuru can't be read the actual hwmon
 			driver will not load and thus no hwmon device will get
 			registered.
-* verbose: bool		Should the driver be verbose?
-			0/off/false  normal output
-			1/on/true    + verbose error reporting (default)
+* verbose: bool
+			Should the driver be verbose?
+
+			* 0/off/false  normal output
+			* 1/on/true    + verbose error reporting (default)
+
 			Default: 1 (the driver is still in the testing phase)
 
 Description
@@ -62,4 +72,4 @@ neither is writing any of the sensor settings and writing / reading the
 fanspeed control registers (FanEQ)
 
 If you encounter any problems please mail me <j.w.r.degoede@hhs.nl> and
-include the output of: "dmesg | grep abituguru"
+include the output of: `dmesg | grep abituguru`
diff --git a/Documentation/hwmon/abx500 b/Documentation/hwmon/abx500
index 319a058cec7c..3d88b2ce0f00 100644
--- a/Documentation/hwmon/abx500
+++ b/Documentation/hwmon/abx500
@@ -2,14 +2,18 @@ Kernel driver abx500
 ====================
 
 Supported chips:
+
   * ST-Ericsson ABx500 series
+
     Prefix: 'abx500'
+
     Addresses scanned: -
+
     Datasheet: http://www.stericsson.com/developers/documentation.jsp
 
 Authors:
-        Martin Persson <martin.persson@stericsson.com>
-        Hongbo Zhang <hongbo.zhang@linaro.org>
+	Martin Persson <martin.persson@stericsson.com>
+	Hongbo Zhang <hongbo.zhang@linaro.org>
 
 Description
 -----------
diff --git a/Documentation/hwmon/acpi_power_meter b/Documentation/hwmon/acpi_power_meter
index c80399a00c50..7665ca6ba957 100644
--- a/Documentation/hwmon/acpi_power_meter
+++ b/Documentation/hwmon/acpi_power_meter
@@ -4,8 +4,11 @@ Kernel driver power_meter
 This driver talks to ACPI 4.0 power meters.
 
 Supported systems:
+
   * Any recent system with ACPI 4.0.
+
     Prefix: 'power_meter'
+
     Datasheet: http://acpi.info/, section 10.4.
 
 Author: Darrick J. Wong
@@ -23,21 +26,21 @@ of Documentation/hwmon/sysfs-interface.
 Special Features
 ----------------
 
-The power[1-*]_is_battery knob indicates if the power supply is a battery.
-Both power[1-*]_average_{min,max} must be set before the trip points will work.
+The `power[1-*]_is_battery` knob indicates if the power supply is a battery.
+Both `power[1-*]_average_{min,max}` must be set before the trip points will work.
 When both of them are set, an ACPI event will be broadcast on the ACPI netlink
 socket and a poll notification will be sent to the appropriate
-power[1-*]_average sysfs file.
+`power[1-*]_average` sysfs file.
 
-The power[1-*]_{model_number, serial_number, oem_info} fields display arbitrary
-strings that ACPI provides with the meter.  The measures/ directory contains
-symlinks to the devices that this meter measures.
+The `power[1-*]_{model_number, serial_number, oem_info}` fields display
+arbitrary strings that ACPI provides with the meter.  The measures/ directory
+contains symlinks to the devices that this meter measures.
 
 Some computers have the ability to enforce a power cap in hardware.  If this is
-the case, the power[1-*]_cap and related sysfs files will appear.  When the
+the case, the `power[1-*]_cap` and related sysfs files will appear.  When the
 average power consumption exceeds the cap, an ACPI event will be broadcast on
 the netlink event socket and a poll notification will be sent to the
-appropriate power[1-*]_alarm file to indicate that capping has begun, and the
+appropriate `power[1-*]_alarm` file to indicate that capping has begun, and the
 hardware has taken action to reduce power consumption.  Most likely this will
 result in reduced performance.
 
@@ -46,6 +49,6 @@ all cases the ACPI event will be broadcast on the ACPI netlink event socket as
 well as sent as a poll notification to a sysfs file.  The events are as
 follows:
 
-power[1-*]_cap will be notified if the firmware changes the power cap.
-power[1-*]_interval will be notified if the firmware changes the averaging
+`power[1-*]_cap` will be notified if the firmware changes the power cap.
+`power[1-*]_interval` will be notified if the firmware changes the averaging
 interval.
diff --git a/Documentation/hwmon/ad7314 b/Documentation/hwmon/ad7314
index 1912549c7467..bf389736bcd1 100644
--- a/Documentation/hwmon/ad7314
+++ b/Documentation/hwmon/ad7314
@@ -2,14 +2,23 @@ Kernel driver ad7314
 ====================
 
 Supported chips:
+
    * Analog Devices AD7314
+
      Prefix: 'ad7314'
+
      Datasheet: Publicly available at Analog Devices website.
+
    * Analog Devices ADT7301
+
      Prefix: 'adt7301'
+
      Datasheet: Publicly available at Analog Devices website.
+
    * Analog Devices ADT7302
+
      Prefix: 'adt7302'
+
      Datasheet: Publicly available at Analog Devices website.
 
 Description
diff --git a/Documentation/hwmon/adc128d818 b/Documentation/hwmon/adc128d818
index 39c95004dabc..6753468932ab 100644
--- a/Documentation/hwmon/adc128d818
+++ b/Documentation/hwmon/adc128d818
@@ -2,11 +2,14 @@ Kernel driver adc128d818
 ========================
 
 Supported chips:
+
   * Texas Instruments ADC818D818
+
     Prefix: 'adc818d818'
+
     Addresses scanned: I2C 0x1d, 0x1e, 0x1f, 0x2d, 0x2e, 0x2f
-    Datasheet: Publicly available at the TI website
-               http://www.ti.com/
+
+    Datasheet: Publicly available at the TI website http://www.ti.com/
 
 Author: Guenter Roeck
 
diff --git a/Documentation/hwmon/adm1021 b/Documentation/hwmon/adm1021
index 02ad96cf9b2b..6cbb0f75fe00 100644
--- a/Documentation/hwmon/adm1021
+++ b/Documentation/hwmon/adm1021
@@ -2,51 +2,91 @@ Kernel driver adm1021
 =====================
 
 Supported chips:
+
   * Analog Devices ADM1021
+
     Prefix: 'adm1021'
+
     Addresses scanned: I2C 0x18 - 0x1a, 0x29 - 0x2b, 0x4c - 0x4e
+
     Datasheet: Publicly available at the Analog Devices website
+
   * Analog Devices ADM1021A/ADM1023
+
     Prefix: 'adm1023'
+
     Addresses scanned: I2C 0x18 - 0x1a, 0x29 - 0x2b, 0x4c - 0x4e
+
     Datasheet: Publicly available at the Analog Devices website
+
   * Genesys Logic GL523SM
+
     Prefix: 'gl523sm'
+
     Addresses scanned: I2C 0x18 - 0x1a, 0x29 - 0x2b, 0x4c - 0x4e
+
     Datasheet:
+
   * Maxim MAX1617
+
     Prefix: 'max1617'
+
     Addresses scanned: I2C 0x18 - 0x1a, 0x29 - 0x2b, 0x4c - 0x4e
+
     Datasheet: Publicly available at the Maxim website
+
   * Maxim MAX1617A
+
     Prefix: 'max1617a'
+
     Addresses scanned: I2C 0x18 - 0x1a, 0x29 - 0x2b, 0x4c - 0x4e
+
     Datasheet: Publicly available at the Maxim website
+
   * National Semiconductor LM84
+
     Prefix: 'lm84'
+
     Addresses scanned: I2C 0x18 - 0x1a, 0x29 - 0x2b, 0x4c - 0x4e
+
     Datasheet: Publicly available at the National Semiconductor website
+
   * Philips NE1617
+
     Prefix: 'max1617' (probably detected as a max1617)
+
     Addresses scanned: I2C 0x18 - 0x1a, 0x29 - 0x2b, 0x4c - 0x4e
+
     Datasheet: Publicly available at the Philips website
+
   * Philips NE1617A
+
     Prefix: 'max1617' (probably detected as a max1617)
+
     Addresses scanned: I2C 0x18 - 0x1a, 0x29 - 0x2b, 0x4c - 0x4e
+
     Datasheet: Publicly available at the Philips website
+
   * TI THMC10
+
     Prefix: 'thmc10'
+
     Addresses scanned: I2C 0x18 - 0x1a, 0x29 - 0x2b, 0x4c - 0x4e
+
     Datasheet: Publicly available at the TI website
+
   * Onsemi MC1066
+
     Prefix: 'mc1066'
+
     Addresses scanned: I2C 0x18 - 0x1a, 0x29 - 0x2b, 0x4c - 0x4e
+
     Datasheet: Publicly available at the Onsemi website
 
 
 Authors:
-        Frodo Looijaard <frodol@dds.nl>,
-        Philip Edelbrock <phil@netroedge.com>
+	- Frodo Looijaard <frodol@dds.nl>,
+	- Philip Edelbrock <phil@netroedge.com>
 
 Module Parameters
 -----------------
diff --git a/Documentation/hwmon/adm1025 b/Documentation/hwmon/adm1025
index 99f05049c68a..283e65e348a5 100644
--- a/Documentation/hwmon/adm1025
+++ b/Documentation/hwmon/adm1025
@@ -2,23 +2,32 @@ Kernel driver adm1025
 =====================
 
 Supported chips:
+
   * Analog Devices ADM1025, ADM1025A
+
     Prefix: 'adm1025'
+
     Addresses scanned: I2C 0x2c - 0x2e
+
     Datasheet: Publicly available at the Analog Devices website
+
   * Philips NE1619
+
     Prefix: 'ne1619'
+
     Addresses scanned: I2C 0x2c - 0x2d
+
     Datasheet: Publicly available at the Philips website
 
 The NE1619 presents some differences with the original ADM1025:
+
   * Only two possible addresses (0x2c - 0x2d).
   * No temperature offset register, but we don't use it anyway.
   * No INT mode for pin 16. We don't play with it anyway.
 
 Authors:
-        Chen-Yuan Wu <gwu@esoft.com>,
-        Jean Delvare <jdelvare@suse.de>
+	- Chen-Yuan Wu <gwu@esoft.com>,
+	- Jean Delvare <jdelvare@suse.de>
 
 Description
 -----------
diff --git a/Documentation/hwmon/adm1026 b/Documentation/hwmon/adm1026
index d8fabe0c23ac..35d63e6498a3 100644
--- a/Documentation/hwmon/adm1026
+++ b/Documentation/hwmon/adm1026
@@ -3,28 +3,36 @@ Kernel driver adm1026
 
 Supported chips:
   * Analog Devices ADM1026
+
     Prefix: 'adm1026'
+
     Addresses scanned: I2C 0x2c, 0x2d, 0x2e
+
     Datasheet: Publicly available at the Analog Devices website
-               http://www.onsemi.com/PowerSolutions/product.do?id=ADM1026
+
+	       http://www.onsemi.com/PowerSolutions/product.do?id=ADM1026
 
 Authors:
-        Philip Pokorny <ppokorny@penguincomputing.com> for Penguin Computing
-        Justin Thiessen <jthiessen@penguincomputing.com>
+	- Philip Pokorny <ppokorny@penguincomputing.com> for Penguin Computing
+	- Justin Thiessen <jthiessen@penguincomputing.com>
 
 Module Parameters
 -----------------
 
 * gpio_input: int array (min = 1, max = 17)
-  List of GPIO pins (0-16) to program as inputs
+    List of GPIO pins (0-16) to program as inputs
+
 * gpio_output: int array (min = 1, max = 17)
-  List of GPIO pins (0-16) to program as outputs
+    List of GPIO pins (0-16) to program as outputs
+
 * gpio_inverted: int array (min = 1, max = 17)
-  List of GPIO pins (0-16) to program as inverted
+    List of GPIO pins (0-16) to program as inverted
+
 * gpio_normal: int array (min = 1, max = 17)
-  List of GPIO pins (0-16) to program as normal/non-inverted
+    List of GPIO pins (0-16) to program as normal/non-inverted
+
 * gpio_fan: int array (min = 1, max = 8)
-  List of GPIO pins (0-7) to program as fan tachs
+    List of GPIO pins (0-7) to program as fan tachs
 
 
 Description
diff --git a/Documentation/hwmon/adm1031 b/Documentation/hwmon/adm1031
index a143117c99cb..a677c3ab5574 100644
--- a/Documentation/hwmon/adm1031
+++ b/Documentation/hwmon/adm1031
@@ -3,20 +3,28 @@ Kernel driver adm1031
 
 Supported chips:
   * Analog Devices ADM1030
+
     Prefix: 'adm1030'
+
     Addresses scanned: I2C 0x2c to 0x2e
+
     Datasheet: Publicly available at the Analog Devices website
-               http://www.analog.com/en/prod/0%2C2877%2CADM1030%2C00.html
+
+	       http://www.analog.com/en/prod/0%2C2877%2CADM1030%2C00.html
 
   * Analog Devices ADM1031
+
     Prefix: 'adm1031'
+
     Addresses scanned: I2C 0x2c to 0x2e
+
     Datasheet: Publicly available at the Analog Devices website
-               http://www.analog.com/en/prod/0%2C2877%2CADM1031%2C00.html
+
+	       http://www.analog.com/en/prod/0%2C2877%2CADM1031%2C00.html
 
 Authors:
-        Alexandre d'Alton <alex@alexdalton.org>
-        Jean Delvare <jdelvare@suse.de>
+	- Alexandre d'Alton <alex@alexdalton.org>
+	- Jean Delvare <jdelvare@suse.de>
 
 Description
 -----------
diff --git a/Documentation/hwmon/adm9240 b/Documentation/hwmon/adm9240
index 9b174fc700cc..91063b0f4c6f 100644
--- a/Documentation/hwmon/adm9240
+++ b/Documentation/hwmon/adm9240
@@ -2,30 +2,43 @@ Kernel driver adm9240
 =====================
 
 Supported chips:
+
   * Analog Devices ADM9240
+
     Prefix: 'adm9240'
+
     Addresses scanned: I2C 0x2c - 0x2f
+
     Datasheet: Publicly available at the Analog Devices website
-    http://www.analog.com/UploadedFiles/Data_Sheets/79857778ADM9240_0.pdf
+
+	http://www.analog.com/UploadedFiles/Data_Sheets/79857778ADM9240_0.pdf
 
   * Dallas Semiconductor DS1780
+
     Prefix: 'ds1780'
+
     Addresses scanned: I2C 0x2c - 0x2f
+
     Datasheet: Publicly available at the Dallas Semiconductor (Maxim) website
-    http://pdfserv.maxim-ic.com/en/ds/DS1780.pdf
+
+	http://pdfserv.maxim-ic.com/en/ds/DS1780.pdf
 
   * National Semiconductor LM81
+
     Prefix: 'lm81'
+
     Addresses scanned: I2C 0x2c - 0x2f
+
     Datasheet: Publicly available at the National Semiconductor website
-    http://www.national.com/ds.cgi/LM/LM81.pdf
+
+	http://www.national.com/ds.cgi/LM/LM81.pdf
 
 Authors:
-    Frodo Looijaard <frodol@dds.nl>,
-    Philip Edelbrock <phil@netroedge.com>,
-    Michiel Rook <michiel@grendelproject.nl>,
-    Grant Coady <gcoady.lk@gmail.com> with guidance
-        from Jean Delvare <jdelvare@suse.de>
+    - Frodo Looijaard <frodol@dds.nl>,
+    - Philip Edelbrock <phil@netroedge.com>,
+    - Michiel Rook <michiel@grendelproject.nl>,
+    - Grant Coady <gcoady.lk@gmail.com> with guidance
+      from Jean Delvare <jdelvare@suse.de>
 
 Interface
 ---------
@@ -87,11 +100,13 @@ rpm = (22500 * 60) / (count * divider)
 Automatic fan clock divider
 
   * User sets 0 to fan_min limit
+
     - low speed alarm is disabled
     - fan clock divider not changed
     - auto fan clock adjuster enabled for valid fan speed reading
 
   * User sets fan_min limit too low
+
     - low speed alarm is enabled
     - fan clock divider set to max
     - fan_min set to register value 254 which corresponds
@@ -101,18 +116,20 @@ Automatic fan clock divider
     - auto fan clock adjuster disabled
 
   * User sets reasonable fan speed
+
     - low speed alarm is enabled
     - fan clock divider set to suit fan_min
     - auto fan clock adjuster enabled: adjusts fan_min
 
   * User sets unreasonably high low fan speed limit
+
     - resolution of the low speed limit may be reduced
     - alarm will be asserted
     - auto fan clock adjuster enabled: adjusts fan_min
 
-    * fan speed may be displayed as zero until the auto fan clock divider
-      adjuster brings fan speed clock divider back into chip measurement
-      range, this will occur within a few measurement cycles.
+  * fan speed may be displayed as zero until the auto fan clock divider
+    adjuster brings fan speed clock divider back into chip measurement
+    range, this will occur within a few measurement cycles.
 
 Analog Output
 -------------
@@ -122,16 +139,21 @@ power up or reset. This doesn't do much on the test Intel SE440BX-2.
 
 Voltage Monitor
 
+^^^^^^^^^^^^^^^
+
 Voltage (IN) measurement is internally scaled:
 
+    === =========== =========== ========= ==========
     nr  label       nominal     maximum   resolution
-                      mV          mV         mV
+		      mV          mV         mV
+    === =========== =========== ========= ==========
     0   +2.5V        2500        3320       13.0
     1   Vccp1        2700        3600       14.1
     2   +3.3V        3300        4380       17.2
     3     +5V        5000        6640       26.0
     4    +12V       12000       15940       62.5
     5   Vccp2        2700        3600       14.1
+    === =========== =========== ========= ==========
 
 The reading is an unsigned 8-bit value, nominal voltage measurement is
 represented by a reading of 192, being 3/4 of the measurement range.
@@ -159,8 +181,9 @@ Clear the CI latch by writing value 0 to the sysfs intrusion0_alarm file.
 
 Alarm flags reported as 16-bit word
 
+    ===     =============       ==========================
     bit     label               comment
-    ---     -------------       --------------------------
+    ===     =============       ==========================
      0      +2.5 V_Error        high or low limit exceeded
      1      VCCP_Error          high or low limit exceeded
      2      +3.3 V_Error        high or low limit exceeded
@@ -171,6 +194,7 @@ Alarm flags reported as 16-bit word
      8      +12 V_Error         high or low limit exceeded
      9      VCCP2_Error         high or low limit exceeded
     12      Chassis_Error       CI pin went high
+    ===     =============       ==========================
 
 Remaining bits are reserved and thus undefined. It is important to note
 that alarm bits may be cleared on read, user-space may latch alarms and
diff --git a/Documentation/hwmon/ads7828 b/Documentation/hwmon/ads7828
index f6e263e0f607..b830b490cfe4 100644
--- a/Documentation/hwmon/ads7828
+++ b/Documentation/hwmon/ads7828
@@ -2,20 +2,27 @@ Kernel driver ads7828
 =====================
 
 Supported chips:
+
   * Texas Instruments/Burr-Brown ADS7828
+
     Prefix: 'ads7828'
+
     Datasheet: Publicly available at the Texas Instruments website:
-               http://focus.ti.com/lit/ds/symlink/ads7828.pdf
+
+	       http://focus.ti.com/lit/ds/symlink/ads7828.pdf
 
   * Texas Instruments ADS7830
+
     Prefix: 'ads7830'
+
     Datasheet: Publicly available at the Texas Instruments website:
-               http://focus.ti.com/lit/ds/symlink/ads7830.pdf
+
+	       http://focus.ti.com/lit/ds/symlink/ads7830.pdf
 
 Authors:
-        Steve Hardy <shardy@redhat.com>
-        Vivien Didelot <vivien.didelot@savoirfairelinux.com>
-        Guillaume Roguez <guillaume.roguez@savoirfairelinux.com>
+	- Steve Hardy <shardy@redhat.com>
+	- Vivien Didelot <vivien.didelot@savoirfairelinux.com>
+	- Guillaume Roguez <guillaume.roguez@savoirfairelinux.com>
 
 Platform data
 -------------
@@ -24,16 +31,16 @@ The ads7828 driver accepts an optional ads7828_platform_data structure (defined
 in include/linux/platform_data/ads7828.h). The structure fields are:
 
 * diff_input: (bool) Differential operation
-  set to true for differential mode, false for default single ended mode.
+    set to true for differential mode, false for default single ended mode.
 
 * ext_vref: (bool) External reference
-  set to true if it operates with an external reference, false for default
-  internal reference.
+    set to true if it operates with an external reference, false for default
+    internal reference.
 
 * vref_mv: (unsigned int) Voltage reference
-  if using an external reference, set this to the reference voltage in mV,
-  otherwise it will default to the internal value (2500mV). This value will be
-  bounded with limits accepted by the chip, described in the datasheet.
+    if using an external reference, set this to the reference voltage in mV,
+    otherwise it will default to the internal value (2500mV). This value will be
+    bounded with limits accepted by the chip, described in the datasheet.
 
  If no structure is provided, the configuration defaults to single ended
  operation and internal voltage reference (2.5V).
diff --git a/Documentation/hwmon/adt7410 b/Documentation/hwmon/adt7410
index 9817941e5f19..24caaa83c8ec 100644
--- a/Documentation/hwmon/adt7410
+++ b/Documentation/hwmon/adt7410
@@ -2,26 +2,45 @@ Kernel driver adt7410
 =====================
 
 Supported chips:
+
   * Analog Devices ADT7410
+
     Prefix: 'adt7410'
+
     Addresses scanned: None
+
     Datasheet: Publicly available at the Analog Devices website
-               http://www.analog.com/static/imported-files/data_sheets/ADT7410.pdf
+
+	       http://www.analog.com/static/imported-files/data_sheets/ADT7410.pdf
   * Analog Devices ADT7420
+
     Prefix: 'adt7420'
+
     Addresses scanned: None
+
     Datasheet: Publicly available at the Analog Devices website
-               http://www.analog.com/static/imported-files/data_sheets/ADT7420.pdf
+
+	       http://www.analog.com/static/imported-files/data_sheets/ADT7420.pdf
+
   * Analog Devices ADT7310
+
     Prefix: 'adt7310'
+
     Addresses scanned: None
+
     Datasheet: Publicly available at the Analog Devices website
-               http://www.analog.com/static/imported-files/data_sheets/ADT7310.pdf
+
+	       http://www.analog.com/static/imported-files/data_sheets/ADT7310.pdf
+
   * Analog Devices ADT7320
+
     Prefix: 'adt7320'
+
     Addresses scanned: None
+
     Datasheet: Publicly available at the Analog Devices website
-               http://www.analog.com/static/imported-files/data_sheets/ADT7320.pdf
+
+	       http://www.analog.com/static/imported-files/data_sheets/ADT7320.pdf
 
 Author: Hartmut Knaack <knaack.h@gmx.de>
 
@@ -61,13 +80,15 @@ The device is set to 16 bit resolution and comparator mode.
 sysfs-Interface
 ---------------
 
-temp#_input		- temperature input
-temp#_min		- temperature minimum setpoint
-temp#_max		- temperature maximum setpoint
-temp#_crit		- critical temperature setpoint
-temp#_min_hyst		- hysteresis for temperature minimum (read-only)
-temp#_max_hyst		- hysteresis for temperature maximum (read/write)
-temp#_crit_hyst		- hysteresis for critical temperature (read-only)
-temp#_min_alarm		- temperature minimum alarm flag
-temp#_max_alarm		- temperature maximum alarm flag
-temp#_crit_alarm	- critical temperature alarm flag
+======================== ====================================================
+temp#_input		 temperature input
+temp#_min		 temperature minimum setpoint
+temp#_max		 temperature maximum setpoint
+temp#_crit		 critical temperature setpoint
+temp#_min_hyst		 hysteresis for temperature minimum (read-only)
+temp#_max_hyst		 hysteresis for temperature maximum (read/write)
+temp#_crit_hyst		 hysteresis for critical temperature (read-only)
+temp#_min_alarm		 temperature minimum alarm flag
+temp#_max_alarm		 temperature maximum alarm flag
+temp#_crit_alarm	 critical temperature alarm flag
+======================== ====================================================
diff --git a/Documentation/hwmon/adt7411 b/Documentation/hwmon/adt7411
index 1632960f9745..57ad16fb216a 100644
--- a/Documentation/hwmon/adt7411
+++ b/Documentation/hwmon/adt7411
@@ -2,9 +2,13 @@ Kernel driver adt7411
 =====================
 
 Supported chips:
+
   * Analog Devices ADT7411
+
     Prefix: 'adt7411'
+
     Addresses scanned: 0x48, 0x4a, 0x4b
+
     Datasheet: Publicly available at the Analog Devices website
 
 Author: Wolfram Sang (based on adt7470 by Darrick J. Wong)
@@ -26,15 +30,19 @@ Check the datasheet for details.
 sysfs-Interface
 ---------------
 
-in0_input	- vdd voltage input
-in[1-8]_input	- analog 1-8 input
-temp1_input	- temperature input
+================ =================
+in0_input	 vdd voltage input
+in[1-8]_input	 analog 1-8 input
+temp1_input	 temperature input
+================ =================
 
 Besides standard interfaces, this driver adds (0 = off, 1 = on):
 
-  adc_ref_vdd	- Use vdd as reference instead of 2.25 V
-  fast_sampling	- Sample at 22.5 kHz instead of 1.4 kHz, but drop filters
-  no_average	- Turn off averaging over 16 samples
+  ============== =======================================================
+  adc_ref_vdd	 Use vdd as reference instead of 2.25 V
+  fast_sampling	 Sample at 22.5 kHz instead of 1.4 kHz, but drop filters
+  no_average	 Turn off averaging over 16 samples
+  ============== =======================================================
 
 Notes
 -----
diff --git a/Documentation/hwmon/adt7462 b/Documentation/hwmon/adt7462
index ec660b328275..a7a831118d32 100644
--- a/Documentation/hwmon/adt7462
+++ b/Documentation/hwmon/adt7462
@@ -1,10 +1,14 @@
 Kernel driver adt7462
-======================
+=====================
 
 Supported chips:
+
   * Analog Devices ADT7462
+
     Prefix: 'adt7462'
+
     Addresses scanned: I2C 0x58, 0x5C
+
     Datasheet: Publicly available at the Analog Devices website
 
 Author: Darrick J. Wong
@@ -57,8 +61,8 @@ Besides standard interfaces driver adds the following:
 * pwm#_auto_point1_pwm and temp#_auto_point1_temp and
 * pwm#_auto_point2_pwm and temp#_auto_point2_temp -
 
-point1: Set the pwm speed at a lower temperature bound.
-point2: Set the pwm speed at a higher temperature bound.
+  - point1: Set the pwm speed at a lower temperature bound.
+  - point2: Set the pwm speed at a higher temperature bound.
 
 The ADT7462 will scale the pwm between the lower and higher pwm speed when
 the temperature is between the two temperature boundaries.  PWM values range
diff --git a/Documentation/hwmon/adt7470 b/Documentation/hwmon/adt7470
index fe68e18a0c8d..d225f816e992 100644
--- a/Documentation/hwmon/adt7470
+++ b/Documentation/hwmon/adt7470
@@ -2,9 +2,13 @@ Kernel driver adt7470
 =====================
 
 Supported chips:
+
   * Analog Devices ADT7470
+
     Prefix: 'adt7470'
+
     Addresses scanned: I2C 0x2C, 0x2E, 0x2F
+
     Datasheet: Publicly available at the Analog Devices website
 
 Author: Darrick J. Wong
@@ -56,8 +60,8 @@ Besides standard interfaces driver adds the following:
 * pwm#_auto_point1_pwm and pwm#_auto_point1_temp and
 * pwm#_auto_point2_pwm and pwm#_auto_point2_temp -
 
-point1: Set the pwm speed at a lower temperature bound.
-point2: Set the pwm speed at a higher temperature bound.
+  - point1: Set the pwm speed at a lower temperature bound.
+  - point2: Set the pwm speed at a higher temperature bound.
 
 The ADT7470 will scale the pwm between the lower and higher pwm speed when
 the temperature is between the two temperature boundaries.  PWM values range
diff --git a/Documentation/hwmon/adt7475 b/Documentation/hwmon/adt7475
index 01b46b290532..ef3ea1ea9bc1 100644
--- a/Documentation/hwmon/adt7475
+++ b/Documentation/hwmon/adt7475
@@ -2,28 +2,44 @@ Kernel driver adt7475
 =====================
 
 Supported chips:
+
   * Analog Devices ADT7473
+
     Prefix: 'adt7473'
+
     Addresses scanned: I2C 0x2C, 0x2D, 0x2E
+
     Datasheet: Publicly available at the On Semiconductors website
+
   * Analog Devices ADT7475
+
     Prefix: 'adt7475'
+
     Addresses scanned: I2C 0x2E
+
     Datasheet: Publicly available at the On Semiconductors website
+
   * Analog Devices ADT7476
+
     Prefix: 'adt7476'
+
     Addresses scanned: I2C 0x2C, 0x2D, 0x2E
+
     Datasheet: Publicly available at the On Semiconductors website
+
   * Analog Devices ADT7490
+
     Prefix: 'adt7490'
+
     Addresses scanned: I2C 0x2C, 0x2D, 0x2E
+
     Datasheet: Publicly available at the On Semiconductors website
 
 Authors:
-	Jordan Crouse
-	Hans de Goede
-	Darrick J. Wong (documentation)
-	Jean Delvare
+	- Jordan Crouse
+	- Hans de Goede
+	- Darrick J. Wong (documentation)
+	- Jean Delvare
 
 
 Description
@@ -82,14 +98,16 @@ ADT7490:
 Sysfs Mapping
 -------------
 
-     ADT7490     ADT7476     ADT7475   ADT7473
-     -------     -------     -------   -------
+==== =========== =========== ========= ==========
+in   ADT7490     ADT7476     ADT7475   ADT7473
+==== =========== =========== ========= ==========
 in0  2.5VIN (22) 2.5VIN (22) -         -
 in1  VCCP   (23) VCCP   (23) VCCP (14) VCCP (14)
 in2  VCC    (4)  VCC    (4)  VCC  (4)  VCC  (3)
 in3  5VIN   (20) 5VIN   (20)
 in4  12VIN  (21) 12VIN  (21)
 in5  VTT    (8)
+==== =========== =========== ========= ==========
 
 Special Features
 ----------------
@@ -107,8 +125,8 @@ Fan Speed Control
 
 The driver exposes two trip points per PWM channel.
 
-point1: Set the PWM speed at the lower temperature bound
-point2: Set the PWM speed at the higher temperature bound
+- point1: Set the PWM speed at the lower temperature bound
+- point2: Set the PWM speed at the higher temperature bound
 
 The ADT747x will scale the PWM linearly between the lower and higher PWM
 speed when the temperature is between the two temperature boundaries.
@@ -123,12 +141,12 @@ the PWM control exceeds temp#_max.
 
 At Tmin - hysteresis the PWM output can either be off (0% duty cycle) or at the
 minimum (i.e. auto_point1_pwm). This behaviour can be configured using the
-pwm[1-*]_stall_disable sysfs attribute. A value of 0 means the fans will shut
+`pwm[1-*]_stall_disable sysfs attribute`. A value of 0 means the fans will shut
 off. A value of 1 means the fans will run at auto_point1_pwm.
 
 The responsiveness of the ADT747x to temperature changes can be configured.
 This allows smoothing of the fan speed transition. To set the transition time
-set the value in ms in the temp[1-*]_smoothing sysfs attribute.
+set the value in ms in the `temp[1-*]_smoothing` sysfs attribute.
 
 Notes
 -----
diff --git a/Documentation/hwmon/amc6821 b/Documentation/hwmon/amc6821
index ced8359c50f8..d10eabcbc0f3 100644
--- a/Documentation/hwmon/amc6821
+++ b/Documentation/hwmon/amc6821
@@ -2,9 +2,13 @@ Kernel driver amc6821
 =====================
 
 Supported chips:
+
 	Texas Instruments AMC6821
+
 	Prefix: 'amc6821'
+
 	Addresses scanned: 0x18, 0x19, 0x1a, 0x2c, 0x2d, 0x2e, 0x4c, 0x4d, 0x4e
+
 	Datasheet: http://focus.ti.com/docs/prod/folders/print/amc6821.html
 
 Authors:
@@ -21,10 +25,11 @@ The pwm can be controlled either from software or automatically.
 
 The driver provides the following sensor accesses in sysfs:
 
+======================= ==      ===============================================
 temp1_input		ro	on-chip temperature
 temp1_min		rw	"
 temp1_max		rw	"
-temp1_crit	 	rw	"
+temp1_crit		rw	"
 temp1_min_alarm		ro	"
 temp1_max_alarm		ro	"
 temp1_crit_alarm	ro	"
@@ -32,16 +37,16 @@ temp1_crit_alarm	ro	"
 temp2_input		ro	remote temperature
 temp2_min		rw	"
 temp2_max		rw	"
-temp2_crit	 	rw	"
+temp2_crit		rw	"
 temp2_min_alarm		ro	"
 temp2_max_alarm		ro	"
 temp2_crit_alarm	ro	"
 temp2_fault		ro	"
 
-fan1_input	 	ro	tachometer speed
+fan1_input		ro	tachometer speed
 fan1_min		rw	"
 fan1_max		rw	"
-fan1_fault	 	ro	"
+fan1_fault		ro	"
 fan1_div		rw	Fan divisor can be either 2 or 4.
 
 pwm1			rw	pwm1
@@ -87,6 +92,7 @@ temp2_auto_point3_temp	rw	Above this temperature fan runs at maximum
 				values which depend on temp2_auto_point2_temp
 				and pwm1_auto_point2_pwm. Read it out after
 				writing to get actual value.
+======================= ==      ===============================================
 
 
 Module parameters
@@ -97,6 +103,7 @@ load the module with: init=0.
 
 If your board BIOS doesn't initialize the chip, or you want
 different settings, you can set the following parameters:
-init=1,
-pwminv: 0 default pwm output, 1 inverts pwm output.
+
+- init=1,
+- pwminv: 0 default pwm output, 1 inverts pwm output.
 
diff --git a/Documentation/hwmon/asb100 b/Documentation/hwmon/asb100
index ab7365e139be..311d9f7b6926 100644
--- a/Documentation/hwmon/asb100
+++ b/Documentation/hwmon/asb100
@@ -2,9 +2,13 @@ Kernel driver asb100
 ====================
 
 Supported Chips:
+
   * Asus ASB100 and ASB100-A "Bach"
+
     Prefix: 'asb100'
+
     Addresses scanned: I2C 0x2d
+
     Datasheet: none released
 
 Author: Mark M. Hoffman <mhoffman@lightlink.com>
@@ -41,32 +45,30 @@ processor itself. It is a value in volts.
 
 Alarms: (TODO question marks indicate may or may not work)
 
-0x0001 => in0 (?)
-0x0002 => in1 (?)
-0x0004 => in2
-0x0008 => in3
-0x0010 => temp1 (1)
-0x0020 => temp2
-0x0040 => fan1
-0x0080 => fan2
-0x0100 => in4
-0x0200 => in5 (?) (2)
-0x0400 => in6 (?) (2)
-0x0800 => fan3
-0x1000 => chassis switch
-0x2000 => temp3
+- 0x0001 => in0 (?)
+- 0x0002 => in1 (?)
+- 0x0004 => in2
+- 0x0008 => in3
+- 0x0010 => temp1 [1]_
+- 0x0020 => temp2
+- 0x0040 => fan1
+- 0x0080 => fan2
+- 0x0100 => in4
+- 0x0200 => in5 (?) [2]_
+- 0x0400 => in6 (?) [2]_
+- 0x0800 => fan3
+- 0x1000 => chassis switch
+- 0x2000 => temp3
 
-Alarm Notes:
+.. [1]	This alarm will only trigger if the hysteresis value is 127C.
+	I.e. it behaves the same as w83781d.
 
-(1) This alarm will only trigger if the hysteresis value is 127C.
-I.e. it behaves the same as w83781d.
-
-(2) The min and max registers for these values appear to
-be read-only or otherwise stuck at 0x00.
+.. [2]	The min and max registers for these values appear to
+	be read-only or otherwise stuck at 0x00.
 
 TODO:
-* Experiment with fan divisors > 8.
-* Experiment with temp. sensor types.
-* Are there really 13 voltage inputs? Probably not...
-* Cleanups, no doubt...
+  * Experiment with fan divisors > 8.
+  * Experiment with temp. sensor types.
+  * Are there really 13 voltage inputs? Probably not...
+  * Cleanups, no doubt...
 
diff --git a/Documentation/hwmon/ds1621 b/Documentation/hwmon/ds1621
index fa3407997795..552b37e9dd34 100644
--- a/Documentation/hwmon/ds1621
+++ b/Documentation/hwmon/ds1621
@@ -2,42 +2,61 @@ Kernel driver ds1621
 ====================
 
 Supported chips:
+
   * Dallas Semiconductor / Maxim Integrated DS1621
+
     Prefix: 'ds1621'
+
     Addresses scanned: none
+
     Datasheet: Publicly available from www.maximintegrated.com
 
   * Dallas Semiconductor DS1625
+
     Prefix: 'ds1625'
+
     Addresses scanned: none
+
     Datasheet: Publicly available from www.datasheetarchive.com
 
   * Maxim Integrated DS1631
+
     Prefix: 'ds1631'
+
     Addresses scanned: none
+
     Datasheet: Publicly available from www.maximintegrated.com
 
   * Maxim Integrated DS1721
+
     Prefix: 'ds1721'
+
     Addresses scanned: none
+
     Datasheet: Publicly available from www.maximintegrated.com
 
   * Maxim Integrated DS1731
+
     Prefix: 'ds1731'
+
     Addresses scanned: none
+
     Datasheet: Publicly available from www.maximintegrated.com
 
 Authors:
-        Christian W. Zuckschwerdt <zany@triq.net>
-        valuable contributions by Jan M. Sendler <sendler@sendler.de>
-        ported to 2.6 by Aurelien Jarno <aurelien@aurel32.net>
-        with the help of Jean Delvare <jdelvare@suse.de>
+      - Christian W. Zuckschwerdt <zany@triq.net>
+      - valuable contributions by Jan M. Sendler <sendler@sendler.de>
+      - ported to 2.6 by Aurelien Jarno <aurelien@aurel32.net>
+	with the help of Jean Delvare <jdelvare@suse.de>
 
 Module Parameters
 ------------------
 
 * polarity int
-  Output's polarity: 0 = active high, 1 = active low
+  Output's polarity:
+
+  * 0 = active high,
+  * 1 = active low
 
 Description
 -----------
@@ -87,28 +106,31 @@ are used internally, however, these flags do get set and cleared as the actual
 temperature crosses the min or max settings (which by default are set to 75
 and 80 degrees respectively).
 
-Temperature Conversion:
------------------------
-DS1621 - 750ms (older devices may take up to 1000ms)
-DS1625 - 500ms
-DS1631 - 93ms..750ms for 9..12 bits resolution, respectively.
-DS1721 - 93ms..750ms for 9..12 bits resolution, respectively.
-DS1731 - 93ms..750ms for 9..12 bits resolution, respectively.
+Temperature Conversion
+----------------------
+
+- DS1621 - 750ms (older devices may take up to 1000ms)
+- DS1625 - 500ms
+- DS1631 - 93ms..750ms for 9..12 bits resolution, respectively.
+- DS1721 - 93ms..750ms for 9..12 bits resolution, respectively.
+- DS1731 - 93ms..750ms for 9..12 bits resolution, respectively.
 
 Note:
 On the DS1621, internal access to non-volatile registers may last for 10ms
 or less (unverified on the other devices).
 
-Temperature Accuracy:
----------------------
-DS1621: +/- 0.5 degree Celsius (from 0 to +70 degrees)
-DS1625: +/- 0.5 degree Celsius (from 0 to +70 degrees)
-DS1631: +/- 0.5 degree Celsius (from 0 to +70 degrees)
-DS1721: +/- 1.0 degree Celsius (from -10 to +85 degrees)
-DS1731: +/- 1.0 degree Celsius (from -10 to +85 degrees)
+Temperature Accuracy
+--------------------
 
-Note:
-Please refer to the device datasheets for accuracy at other temperatures.
+- DS1621: +/- 0.5 degree Celsius (from 0 to +70 degrees)
+- DS1625: +/- 0.5 degree Celsius (from 0 to +70 degrees)
+- DS1631: +/- 0.5 degree Celsius (from 0 to +70 degrees)
+- DS1721: +/- 1.0 degree Celsius (from -10 to +85 degrees)
+- DS1731: +/- 1.0 degree Celsius (from -10 to +85 degrees)
+
+.. Note::
+
+   Please refer to the device datasheets for accuracy at other temperatures.
 
 Temperature Resolution:
 -----------------------
@@ -117,60 +139,67 @@ support, which is achieved via the R0 and R1 config register bits, where:
 
 R0..R1
 ------
- 0  0 => 9 bits, 0.5 degrees Celsius
- 1  0 => 10 bits, 0.25 degrees Celsius
- 0  1 => 11 bits, 0.125 degrees Celsius
- 1  1 => 12 bits, 0.0625 degrees Celsius
 
-Note:
-At initial device power-on, the default resolution is set to 12-bits.
+== ==  ===============================
+R0 R1
+== ==  ===============================
+ 0  0  9 bits, 0.5 degrees Celsius
+ 1  0  10 bits, 0.25 degrees Celsius
+ 0  1  11 bits, 0.125 degrees Celsius
+ 1  1  12 bits, 0.0625 degrees Celsius
+== ==  ===============================
+
+.. Note::
+
+   At initial device power-on, the default resolution is set to 12-bits.
 
 The resolution mode for the DS1631, DS1721, or DS1731 can be changed from
 userspace, via the device 'update_interval' sysfs attribute. This attribute
 will normalize the range of input values to the device maximum resolution
 values defined in the datasheet as follows:
 
+============= ================== ===============
 Resolution    Conversion Time    Input Range
  (C/LSB)       (msec)             (msec)
-------------------------------------------------
+============= ================== ===============
 0.5             93.75              0....94
 0.25            187.5              95...187
 0.125           375                188..375
 0.0625          750                376..infinity
-------------------------------------------------
+============= ================== ===============
 
 The following examples show how the 'update_interval' attribute can be
-used to change the conversion time:
+used to change the conversion time::
 
-$ cat update_interval
-750
-$ cat temp1_input
-22062
-$
-$ echo 300 > update_interval
-$ cat update_interval
-375
-$ cat temp1_input
-22125
-$
-$ echo 150 > update_interval
-$ cat update_interval
-188
-$ cat temp1_input
-22250
-$
-$ echo 1 > update_interval
-$ cat update_interval
-94
-$ cat temp1_input
-22000
-$
-$ echo 1000 > update_interval
-$ cat update_interval
-750
-$ cat temp1_input
-22062
-$
+  $ cat update_interval
+  750
+  $ cat temp1_input
+  22062
+  $
+  $ echo 300 > update_interval
+  $ cat update_interval
+  375
+  $ cat temp1_input
+  22125
+  $
+  $ echo 150 > update_interval
+  $ cat update_interval
+  188
+  $ cat temp1_input
+  22250
+  $
+  $ echo 1 > update_interval
+  $ cat update_interval
+  94
+  $ cat temp1_input
+  22000
+  $
+  $ echo 1000 > update_interval
+  $ cat update_interval
+  750
+  $ cat temp1_input
+  22062
+  $
 
 As shown, the ds1621 driver automatically adjusts the 'update_interval'
 user input, via a step function. Reading back the 'update_interval' value
@@ -182,6 +211,7 @@ via the following function:
    g(x) = 0.5 * [minimum_conversion_time/x]
 
 where:
- -> 'x' = the output from 'update_interval'
- -> 'g(x)' = the resolution in degrees C per LSB.
- -> 93.75ms = minimum conversion time
+
+ - 'x' = the output from 'update_interval'
+ - 'g(x)' = the resolution in degrees C per LSB.
+ - 93.75ms = minimum conversion time
diff --git a/Documentation/hwmon/ds620 b/Documentation/hwmon/ds620
index 1fbe3cd916cc..2d686b17b547 100644
--- a/Documentation/hwmon/ds620
+++ b/Documentation/hwmon/ds620
@@ -2,15 +2,19 @@ Kernel driver ds620
 ===================
 
 Supported chips:
+
   * Dallas Semiconductor DS620
+
     Prefix: 'ds620'
+
     Datasheet: Publicly available at the Dallas Semiconductor website
-               http://www.dalsemi.com/
+
+	       http://www.dalsemi.com/
 
 Authors:
-        Roland Stigge <stigge@antcom.de>
-        based on ds1621.c by
-        Christian W. Zuckschwerdt <zany@triq.net>
+	Roland Stigge <stigge@antcom.de>
+	based on ds1621.c by
+	Christian W. Zuckschwerdt <zany@triq.net>
 
 Description
 -----------
diff --git a/Documentation/hwmon/emc1403 b/Documentation/hwmon/emc1403
index a869b0ef6a9d..3a4913b63ef3 100644
--- a/Documentation/hwmon/emc1403
+++ b/Documentation/hwmon/emc1403
@@ -2,28 +2,48 @@ Kernel driver emc1403
 =====================
 
 Supported chips:
+
   * SMSC / Microchip EMC1402, EMC1412
+
     Addresses scanned: I2C 0x18, 0x1c, 0x29, 0x4c, 0x4d, 0x5c
+
     Prefix: 'emc1402'
+
     Datasheets:
-	http://ww1.microchip.com/downloads/en/DeviceDoc/1412.pdf
-	http://ww1.microchip.com/downloads/en/DeviceDoc/1402.pdf
+
+	- http://ww1.microchip.com/downloads/en/DeviceDoc/1412.pdf
+	- http://ww1.microchip.com/downloads/en/DeviceDoc/1402.pdf
+
   * SMSC / Microchip EMC1403, EMC1404, EMC1413, EMC1414
+
     Addresses scanned: I2C 0x18, 0x29, 0x4c, 0x4d
+
     Prefix: 'emc1403', 'emc1404'
+
     Datasheets:
-	http://ww1.microchip.com/downloads/en/DeviceDoc/1403_1404.pdf
-	http://ww1.microchip.com/downloads/en/DeviceDoc/1413_1414.pdf
+
+	- http://ww1.microchip.com/downloads/en/DeviceDoc/1403_1404.pdf
+	- http://ww1.microchip.com/downloads/en/DeviceDoc/1413_1414.pdf
+
   * SMSC / Microchip EMC1422
+
     Addresses scanned: I2C 0x4c
+
     Prefix: 'emc1422'
+
     Datasheet:
-	http://ww1.microchip.com/downloads/en/DeviceDoc/1422.pdf
+
+	- http://ww1.microchip.com/downloads/en/DeviceDoc/1422.pdf
+
   * SMSC / Microchip EMC1423, EMC1424
+
     Addresses scanned: I2C 0x4c
+
     Prefix: 'emc1423', 'emc1424'
+
     Datasheet:
-	http://ww1.microchip.com/downloads/en/DeviceDoc/1423_1424.pdf
+
+	- http://ww1.microchip.com/downloads/en/DeviceDoc/1423_1424.pdf
 
 Author:
     Kalhan Trisal <kalhan.trisal@intel.com
@@ -46,6 +66,7 @@ difference between the limit and its hysteresis is always the same for
 all three limits.
 
 This implementation detail implies the following:
+
 * When setting a limit, its hysteresis will automatically follow, the
   difference staying unchanged. For example, if the old critical limit
   was 80 degrees C, and the hysteresis was 75 degrees C, and you change
diff --git a/Documentation/hwmon/emc6w201 b/Documentation/hwmon/emc6w201
index 757629b12897..a8e1185b9bb6 100644
--- a/Documentation/hwmon/emc6w201
+++ b/Documentation/hwmon/emc6w201
@@ -2,9 +2,13 @@ Kernel driver emc6w201
 ======================
 
 Supported chips:
+
   * SMSC EMC6W201
+
     Prefix: 'emc6w201'
+
     Addresses scanned: I2C 0x2c, 0x2d, 0x2e
+
     Datasheet: Not public
 
 Author: Jean Delvare <jdelvare@suse.de>
@@ -38,5 +42,6 @@ Known Systems With EMC6W201
 
 The EMC6W201 is a rare device, only found on a few systems, made in
 2005 and 2006. Known systems with this device:
+
 * Dell Precision 670 workstation
 * Gigabyte 2CEWH mainboard
diff --git a/Documentation/hwmon/f71805f b/Documentation/hwmon/f71805f
index 48a356084bc6..1efe5e5d337c 100644
--- a/Documentation/hwmon/f71805f
+++ b/Documentation/hwmon/f71805f
@@ -2,17 +2,29 @@ Kernel driver f71805f
 =====================
 
 Supported chips:
+
   * Fintek F71805F/FG
+
     Prefix: 'f71805f'
+
     Addresses scanned: none, address read from Super I/O config space
+
     Datasheet: Available from the Fintek website
+
   * Fintek F71806F/FG
+
     Prefix: 'f71872f'
+
     Addresses scanned: none, address read from Super I/O config space
+
     Datasheet: Available from the Fintek website
+
   * Fintek F71872F/FG
+
     Prefix: 'f71872f'
+
     Addresses scanned: none, address read from Super I/O config space
+
     Datasheet: Available from the Fintek website
 
 Author: Jean Delvare <jdelvare@suse.de>
@@ -64,24 +76,26 @@ you can only set the limits in steps of 32 mV (before scaling).
 
 The wirings and resistor values suggested by Fintek are as follow:
 
-        pin                                           expected
-        name    use           R1      R2     divider  raw val.
-
+======= ======= =========== ==== ======= ============ ==============
+in      pin                                           expected
+	name    use           R1      R2     divider  raw val.
+======= ======= =========== ==== ======= ============ ==============
 in0     VCC     VCC3.3V     int.    int.        2.00    1.65 V
 in1     VIN1    VTT1.2V      10K       -        1.00    1.20 V
-in2     VIN2    VRAM        100K    100K        2.00   ~1.25 V (1)
-in3     VIN3    VCHIPSET     47K    100K        1.47    2.24 V (2)
+in2     VIN2    VRAM        100K    100K        2.00   ~1.25 V [1]_
+in3     VIN3    VCHIPSET     47K    100K        1.47    2.24 V [2]_
 in4     VIN4    VCC5V       200K     47K        5.25    0.95 V
 in5     VIN5    +12V        200K     20K       11.00    1.05 V
 in6     VIN6    VCC1.5V      10K       -        1.00    1.50 V
-in7     VIN7    VCORE        10K       -        1.00   ~1.40 V (1)
+in7     VIN7    VCORE        10K       -        1.00   ~1.40 V [1]_
 in8     VIN8    VSB5V       200K     47K        1.00    0.95 V
-in10    VSB     VSB3.3V     int.    int.        2.00    1.65 V (3)
-in9     VBAT    VBATTERY    int.    int.        2.00    1.50 V (3)
+in10    VSB     VSB3.3V     int.    int.        2.00    1.65 V [3]_
+in9     VBAT    VBATTERY    int.    int.        2.00    1.50 V [3]_
+======= ======= =========== ==== ======= ============ ==============
 
-(1) Depends on your hardware setup.
-(2) Obviously not correct, swapping R1 and R2 would make more sense.
-(3) F71872F/FG only.
+.. [1] Depends on your hardware setup.
+.. [2] Obviously not correct, swapping R1 and R2 would make more sense.
+.. [3] F71872F/FG only.
 
 These values can be used as hints at best, as motherboard manufacturers
 are free to use a completely different setup. As a matter of fact, the
diff --git a/Documentation/hwmon/f71882fg b/Documentation/hwmon/f71882fg
index 4c3cb8377d74..5c0b7b0db150 100644
--- a/Documentation/hwmon/f71882fg
+++ b/Documentation/hwmon/f71882fg
@@ -2,60 +2,114 @@ Kernel driver f71882fg
 ======================
 
 Supported chips:
+
   * Fintek F71808E
+
     Prefix: 'f71808e'
+
     Addresses scanned: none, address read from Super I/O config space
+
     Datasheet: Not public
+
   * Fintek F71808A
+
     Prefix: 'f71808a'
+
     Addresses scanned: none, address read from Super I/O config space
+
     Datasheet: Not public
+
   * Fintek F71858FG
+
     Prefix: 'f71858fg'
+
     Addresses scanned: none, address read from Super I/O config space
+
     Datasheet: Available from the Fintek website
+
   * Fintek F71862FG and F71863FG
+
     Prefix: 'f71862fg'
+
     Addresses scanned: none, address read from Super I/O config space
+
     Datasheet: Available from the Fintek website
+
   * Fintek F71869F and F71869E
+
     Prefix: 'f71869'
+
     Addresses scanned: none, address read from Super I/O config space
+
     Datasheet: Available from the Fintek website
+
   * Fintek F71869A
+
     Prefix: 'f71869a'
+
     Addresses scanned: none, address read from Super I/O config space
+
     Datasheet: Not public
+
   * Fintek F71882FG and F71883FG
+
     Prefix: 'f71882fg'
+
     Addresses scanned: none, address read from Super I/O config space
+
     Datasheet: Available from the Fintek website
+
   * Fintek F71889FG
+
     Prefix: 'f71889fg'
+
     Addresses scanned: none, address read from Super I/O config space
+
     Datasheet: Available from the Fintek website
+
   * Fintek F71889ED
+
     Prefix: 'f71889ed'
+
     Addresses scanned: none, address read from Super I/O config space
+
     Datasheet: Should become available on the Fintek website soon
+
   * Fintek F71889A
+
     Prefix: 'f71889a'
+
     Addresses scanned: none, address read from Super I/O config space
+
     Datasheet: Should become available on the Fintek website soon
+
   * Fintek F8000
+
     Prefix: 'f8000'
+
     Addresses scanned: none, address read from Super I/O config space
+
     Datasheet: Not public
+
   * Fintek F81801U
+
     Prefix: 'f71889fg'
+
     Addresses scanned: none, address read from Super I/O config space
+
     Datasheet: Not public
-    Note: This is the 64-pin variant of the F71889FG, they have the
+
+    Note:
+	  This is the 64-pin variant of the F71889FG, they have the
 	  same device ID and are fully compatible as far as hardware
 	  monitoring is concerned.
+
   * Fintek F81865F
+
     Prefix: 'f81865f'
+
     Addresses scanned: none, address read from Super I/O config space
+
     Datasheet: Available from the Fintek website
 
 Author: Hans de Goede <hdegoede@redhat.com>
diff --git a/Documentation/hwmon/ftsteutates b/Documentation/hwmon/ftsteutates
index af54db92391b..58a2483d8d0d 100644
--- a/Documentation/hwmon/ftsteutates
+++ b/Documentation/hwmon/ftsteutates
@@ -1,9 +1,12 @@
 Kernel driver ftsteutates
-=====================
+=========================
 
 Supported chips:
+
   * FTS Teutates
+
     Prefix: 'ftsteutates'
+
     Addresses scanned: I2C 0x73 (7-Bit)
 
 Author: Thilo Cestonaro <thilo.cestonaro@ts.fujitsu.com>
@@ -11,6 +14,7 @@ Author: Thilo Cestonaro <thilo.cestonaro@ts.fujitsu.com>
 
 Description
 -----------
+
 The BMC Teutates is the Eleventh generation of Superior System
 monitoring and thermal management solution. It is builds on the basic
 functionality of the BMC Theseus and contains several new features and
@@ -19,9 +23,11 @@ enhancements. It can monitor up to 4 voltages, 16 temperatures and
 implemented in this driver.
 
 To clear a temperature or fan alarm, execute the following command with the
-correct path to the alarm file:
+correct path to the alarm file::
+
 	echo 0 >XXXX_alarm
 
 Specification of the chip can be found here:
-ftp://ftp.ts.fujitsu.com/pub/Mainboard-OEM-Sales/Services/Software&Tools/Linux_SystemMonitoring&Watchdog&GPIO/BMC-Teutates_Specification_V1.21.pdf
-ftp://ftp.ts.fujitsu.com/pub/Mainboard-OEM-Sales/Services/Software&Tools/Linux_SystemMonitoring&Watchdog&GPIO/Fujitsu_mainboards-1-Sensors_HowTo-en-US.pdf
+
+- ftp://ftp.ts.fujitsu.com/pub/Mainboard-OEM-Sales/Services/Software&Tools/Linux_SystemMonitoring&Watchdog&GPIO/BMC-Teutates_Specification_V1.21.pdf
+- ftp://ftp.ts.fujitsu.com/pub/Mainboard-OEM-Sales/Services/Software&Tools/Linux_SystemMonitoring&Watchdog&GPIO/Fujitsu_mainboards-1-Sensors_HowTo-en-US.pdf
diff --git a/Documentation/hwmon/g760a b/Documentation/hwmon/g760a
index cfc894537061..d82952cc8319 100644
--- a/Documentation/hwmon/g760a
+++ b/Documentation/hwmon/g760a
@@ -2,9 +2,13 @@ Kernel driver g760a
 ===================
 
 Supported chips:
+
   * Global Mixed-mode Technology Inc. G760A
+
     Prefix: 'g760a'
+
     Datasheet: Publicly available at the GMT website
+
       http://www.gmt.com.tw/product/datasheet/EDS-760A.pdf
 
 Author: Herbert Valerio Riedel <hvr@gnu.org>
diff --git a/Documentation/hwmon/g762 b/Documentation/hwmon/g762
index 923db9c5b5bc..54574e26df21 100644
--- a/Documentation/hwmon/g762
+++ b/Documentation/hwmon/g762
@@ -21,34 +21,43 @@ documented in Documentation/devicetree/bindings/hwmon/g762.txt or
 using a specific platform_data structure in board initialization
 file (see include/linux/platform_data/g762.h).
 
-  fan1_target: set desired fan speed. This only makes sense in closed-loop
-            fan speed control (i.e. when pwm1_enable is set to 2).
-
-  fan1_input: provide current fan rotation value in RPM as reported by
-            the fan to the device.
-
-  fan1_div: fan clock divisor. Supported value are 1, 2, 4 and 8.
-
-  fan1_pulses: number of pulses per fan revolution. Supported values
-            are 2 and 4.
-
-  fan1_fault: reports fan failure, i.e. no transition on fan gear pin for
-            about 0.7s (if the fan is not voluntarily set off).
-
-  fan1_alarm: in closed-loop control mode, if fan RPM value is 25% out
-            of the programmed value for over 6 seconds 'fan1_alarm' is
-            set to 1.
-
-  pwm1_enable: set current fan speed control mode i.e. 1 for manual fan
-            speed control (open-loop) via pwm1 described below, 2 for
-            automatic fan speed control (closed-loop) via fan1_target
-            above.
-
-  pwm1_mode: set or get fan driving mode: 1 for PWM mode, 0 for DC mode.
-
-  pwm1: get or set PWM fan control value in open-loop mode. This is an
-            integer value between 0 and 255. 0 stops the fan, 255 makes
-            it run at full speed.
+  fan1_target:
+	    set desired fan speed. This only makes sense in closed-loop
+	    fan speed control (i.e. when pwm1_enable is set to 2).
+
+  fan1_input:
+	    provide current fan rotation value in RPM as reported by
+	    the fan to the device.
+
+  fan1_div:
+	    fan clock divisor. Supported value are 1, 2, 4 and 8.
+
+  fan1_pulses:
+	    number of pulses per fan revolution. Supported values
+	    are 2 and 4.
+
+  fan1_fault:
+	    reports fan failure, i.e. no transition on fan gear pin for
+	    about 0.7s (if the fan is not voluntarily set off).
+
+  fan1_alarm:
+	    in closed-loop control mode, if fan RPM value is 25% out
+	    of the programmed value for over 6 seconds 'fan1_alarm' is
+	    set to 1.
+
+  pwm1_enable:
+	    set current fan speed control mode i.e. 1 for manual fan
+	    speed control (open-loop) via pwm1 described below, 2 for
+	    automatic fan speed control (closed-loop) via fan1_target
+	    above.
+
+  pwm1_mode:
+	    set or get fan driving mode: 1 for PWM mode, 0 for DC mode.
+
+  pwm1:
+	    get or set PWM fan control value in open-loop mode. This is an
+	    integer value between 0 and 255. 0 stops the fan, 255 makes
+	    it run at full speed.
 
 Both in PWM mode ('pwm1_mode' set to 1) and DC mode ('pwm1_mode' set to 0),
 when current fan speed control mode is open-loop ('pwm1_enable' set to 1),
diff --git a/Documentation/hwmon/gl518sm b/Documentation/hwmon/gl518sm
index 494bb55b6e72..bf1e0b5e824b 100644
--- a/Documentation/hwmon/gl518sm
+++ b/Documentation/hwmon/gl518sm
@@ -2,27 +2,34 @@ Kernel driver gl518sm
 =====================
 
 Supported chips:
+
   * Genesys Logic GL518SM release 0x00
+
     Prefix: 'gl518sm'
+
     Addresses scanned: I2C 0x2c and 0x2d
+
   * Genesys Logic GL518SM release 0x80
+
     Prefix: 'gl518sm'
+
     Addresses scanned: I2C 0x2c and 0x2d
+
     Datasheet: http://www.genesyslogic.com/
 
 Authors:
-        Frodo Looijaard <frodol@dds.nl>,
-        Kyösti Mälkki <kmalkki@cc.hut.fi>
-        Hong-Gunn Chew <hglinux@gunnet.org>
-        Jean Delvare <jdelvare@suse.de>
+       - Frodo Looijaard <frodol@dds.nl>,
+       - Kyösti Mälkki <kmalkki@cc.hut.fi>
+       - Hong-Gunn Chew <hglinux@gunnet.org>
+       - Jean Delvare <jdelvare@suse.de>
 
 Description
 -----------
 
-IMPORTANT:
+.. important::
 
-For the revision 0x00 chip, the in0, in1, and in2  values (+5V, +3V,
-and +12V) CANNOT be read. This is a limitation of the chip, not the driver.
+   For the revision 0x00 chip, the in0, in1, and in2  values (+5V, +3V,
+   and +12V) CANNOT be read. This is a limitation of the chip, not the driver.
 
 This driver supports the Genesys Logic GL518SM chip. There are at least
 two revision of this chip, which we call revision 0x00 and 0x80. Revision
diff --git a/Documentation/hwmon/hih6130 b/Documentation/hwmon/hih6130
index 73dae918ea7b..649bd4be4fc2 100644
--- a/Documentation/hwmon/hih6130
+++ b/Documentation/hwmon/hih6130
@@ -2,11 +2,16 @@ Kernel driver hih6130
 =====================
 
 Supported chips:
+
   * Honeywell HIH-6130 / HIH-6131
+
     Prefix: 'hih6130'
+
     Addresses scanned: none
+
     Datasheet: Publicly available at the Honeywell website
-    http://sensing.honeywell.com/index.php?ci_id=3106&la_id=1&defId=44872
+
+	http://sensing.honeywell.com/index.php?ci_id=3106&la_id=1&defId=44872
 
 Author:
   Iain Paton <ipaton0@gmail.com>
@@ -28,8 +33,11 @@ instantiate I2C devices.
 sysfs-Interface
 ---------------
 
-temp1_input - temperature input
-humidity1_input - humidity input
+temp1_input
+	temperature input
+
+humidity1_input
+	humidity input
 
 Notes
 -----
diff --git a/Documentation/hwmon/hwmon-kernel-api.txt b/Documentation/hwmon/hwmon-kernel-api.txt
index 8bdefb41be30..b56343f5c2c4 100644
--- a/Documentation/hwmon/hwmon-kernel-api.txt
+++ b/Documentation/hwmon/hwmon-kernel-api.txt
@@ -1,5 +1,5 @@
-The Linux Hardware Monitoring kernel API.
-=========================================
+The Linux Hardware Monitoring kernel API
+========================================
 
 Guenter Roeck
 
@@ -21,33 +21,34 @@ The API
 -------
 Each hardware monitoring driver must #include <linux/hwmon.h> and, in most
 cases, <linux/hwmon-sysfs.h>. linux/hwmon.h declares the following
-register/unregister functions:
+register/unregister functions::
 
-struct device *
-hwmon_device_register_with_groups(struct device *dev, const char *name,
-				  void *drvdata,
-				  const struct attribute_group **groups);
+  struct device *
+  hwmon_device_register_with_groups(struct device *dev, const char *name,
+				    void *drvdata,
+				    const struct attribute_group **groups);
 
-struct device *
-devm_hwmon_device_register_with_groups(struct device *dev,
-				       const char *name, void *drvdata,
-				       const struct attribute_group **groups);
+  struct device *
+  devm_hwmon_device_register_with_groups(struct device *dev,
+					 const char *name, void *drvdata,
+					 const struct attribute_group **groups);
 
-struct device *
-hwmon_device_register_with_info(struct device *dev,
-				const char *name, void *drvdata,
-				const struct hwmon_chip_info *info,
-				const struct attribute_group **extra_groups);
+  struct device *
+  hwmon_device_register_with_info(struct device *dev,
+				  const char *name, void *drvdata,
+				  const struct hwmon_chip_info *info,
+				  const struct attribute_group **extra_groups);
 
-struct device *
-devm_hwmon_device_register_with_info(struct device *dev,
-				const char *name,
-				void *drvdata,
-				const struct hwmon_chip_info *info,
-				const struct attribute_group **extra_groups);
+  struct device *
+  devm_hwmon_device_register_with_info(struct device *dev,
+				       const char *name,
+				       void *drvdata,
+				       const struct hwmon_chip_info *info,
+				       const struct attribute_group **extra_groups);
 
-void hwmon_device_unregister(struct device *dev);
-void devm_hwmon_device_unregister(struct device *dev);
+  void hwmon_device_unregister(struct device *dev);
+
+  void devm_hwmon_device_unregister(struct device *dev);
 
 hwmon_device_register_with_groups registers a hardware monitoring device.
 The first parameter of this function is a pointer to the parent device.
@@ -100,78 +101,89 @@ Using devm_hwmon_device_register_with_info()
 hwmon_device_register_with_info() registers a hardware monitoring device.
 The parameters to this function are
 
-struct device *dev	Pointer to parent device
-const char *name	Device name
-void *drvdata		Driver private data
-const struct hwmon_chip_info *info
-			Pointer to chip description.
-const struct attribute_group **extra_groups
-			Null-terminated list of additional non-standard
-			sysfs attribute groups.
+=============================================== ===============================================
+`struct device *dev`				Pointer to parent device
+`const char *name`				Device name
+`void *drvdata`					Driver private data
+`const struct hwmon_chip_info *info`		Pointer to chip description.
+`const struct attribute_group **extra_groups` 	Null-terminated list of additional non-standard
+						sysfs attribute groups.
+=============================================== ===============================================
 
 This function returns a pointer to the created hardware monitoring device
 on success and a negative error code for failure.
 
-The hwmon_chip_info structure looks as follows.
+The hwmon_chip_info structure looks as follows::
 
-struct hwmon_chip_info {
-	const struct hwmon_ops *ops;
-	const struct hwmon_channel_info **info;
-};
+	struct hwmon_chip_info {
+		const struct hwmon_ops *ops;
+		const struct hwmon_channel_info **info;
+	};
 
 It contains the following fields:
 
-* ops:	Pointer to device operations.
-* info: NULL-terminated list of device channel descriptors.
+* ops:
+	Pointer to device operations.
+* info:
+	NULL-terminated list of device channel descriptors.
 
-The list of hwmon operations is defined as:
+The list of hwmon operations is defined as::
 
-struct hwmon_ops {
+  struct hwmon_ops {
 	umode_t (*is_visible)(const void *, enum hwmon_sensor_types type,
 			      u32 attr, int);
 	int (*read)(struct device *, enum hwmon_sensor_types type,
 		    u32 attr, int, long *);
 	int (*write)(struct device *, enum hwmon_sensor_types type,
 		     u32 attr, int, long);
-};
+  };
 
 It defines the following operations.
 
-* is_visible: Pointer to a function to return the file mode for each supported
-  attribute. This function is mandatory.
+* is_visible:
+    Pointer to a function to return the file mode for each supported
+    attribute. This function is mandatory.
 
-* read: Pointer to a function for reading a value from the chip. This function
-  is optional, but must be provided if any readable attributes exist.
+* read:
+    Pointer to a function for reading a value from the chip. This function
+    is optional, but must be provided if any readable attributes exist.
 
-* write: Pointer to a function for writing a value to the chip. This function is
-  optional, but must be provided if any writeable attributes exist.
+* write:
+    Pointer to a function for writing a value to the chip. This function is
+    optional, but must be provided if any writeable attributes exist.
 
 Each sensor channel is described with struct hwmon_channel_info, which is
-defined as follows.
+defined as follows::
 
-struct hwmon_channel_info {
-	enum hwmon_sensor_types type;
-	u32 *config;
-};
+	struct hwmon_channel_info {
+		enum hwmon_sensor_types type;
+		u32 *config;
+	};
 
 It contains following fields:
 
-* type: The hardware monitoring sensor type.
-  Supported sensor types are
-  * hwmon_chip		A virtual sensor type, used to describe attributes
-  *			which are not bound to a specific input or output
-  * hwmon_temp		Temperature sensor
-  * hwmon_in		Voltage sensor
-  * hwmon_curr		Current sensor
-  * hwmon_power		Power sensor
-  * hwmon_energy	Energy sensor
-  * hwmon_humidity	Humidity sensor
-  * hwmon_fan		Fan speed sensor
-  * hwmon_pwm		PWM control
+* type:
+    The hardware monitoring sensor type.
 
-* config: Pointer to a 0-terminated list of configuration values for each
-  sensor of the given type. Each value is a combination of bit values
-  describing the attributes supposed by a single sensor.
+    Supported sensor types are
+
+     ================== ==================================================
+     hwmon_chip		A virtual sensor type, used to describe attributes
+			which are not bound to a specific input or output
+     hwmon_temp		Temperature sensor
+     hwmon_in		Voltage sensor
+     hwmon_curr		Current sensor
+     hwmon_power		Power sensor
+     hwmon_energy	Energy sensor
+     hwmon_humidity	Humidity sensor
+     hwmon_fan		Fan speed sensor
+     hwmon_pwm		PWM control
+     ================== ==================================================
+
+* config:
+    Pointer to a 0-terminated list of configuration values for each
+    sensor of the given type. Each value is a combination of bit values
+    describing the attributes supposed by a single sensor.
 
 As an example, here is the complete description file for a LM75 compatible
 sensor chip. The chip has a single temperature sensor. The driver wants to
@@ -179,48 +191,49 @@ register with the thermal subsystem (HWMON_C_REGISTER_TZ), and it supports
 the update_interval attribute (HWMON_C_UPDATE_INTERVAL). The chip supports
 reading the temperature (HWMON_T_INPUT), it has a maximum temperature
 register (HWMON_T_MAX) as well as a maximum temperature hysteresis register
-(HWMON_T_MAX_HYST).
+(HWMON_T_MAX_HYST)::
 
-static const u32 lm75_chip_config[] = {
-	HWMON_C_REGISTER_TZ | HWMON_C_UPDATE_INTERVAL,
-	0
-};
+	static const u32 lm75_chip_config[] = {
+		HWMON_C_REGISTER_TZ | HWMON_C_UPDATE_INTERVAL,
+		0
+	};
 
-static const struct hwmon_channel_info lm75_chip = {
-	.type = hwmon_chip,
-	.config = lm75_chip_config,
-};
+	static const struct hwmon_channel_info lm75_chip = {
+		.type = hwmon_chip,
+		.config = lm75_chip_config,
+	};
 
-static const u32 lm75_temp_config[] = {
-	HWMON_T_INPUT | HWMON_T_MAX | HWMON_T_MAX_HYST,
-	0
-};
+	static const u32 lm75_temp_config[] = {
+		HWMON_T_INPUT | HWMON_T_MAX | HWMON_T_MAX_HYST,
+		0
+	};
 
-static const struct hwmon_channel_info lm75_temp = {
-	.type = hwmon_temp,
-	.config = lm75_temp_config,
-};
+	static const struct hwmon_channel_info lm75_temp = {
+		.type = hwmon_temp,
+		.config = lm75_temp_config,
+	};
 
-static const struct hwmon_channel_info *lm75_info[] = {
-	&lm75_chip,
-	&lm75_temp,
-	NULL
-};
+	static const struct hwmon_channel_info *lm75_info[] = {
+		&lm75_chip,
+		&lm75_temp,
+		NULL
+	};
 
-static const struct hwmon_ops lm75_hwmon_ops = {
-	.is_visible = lm75_is_visible,
-	.read = lm75_read,
-	.write = lm75_write,
-};
+	static const struct hwmon_ops lm75_hwmon_ops = {
+		.is_visible = lm75_is_visible,
+		.read = lm75_read,
+		.write = lm75_write,
+	};
 
-static const struct hwmon_chip_info lm75_chip_info = {
-	.ops = &lm75_hwmon_ops,
-	.info = lm75_info,
-};
+	static const struct hwmon_chip_info lm75_chip_info = {
+		.ops = &lm75_hwmon_ops,
+		.info = lm75_info,
+	};
 
 A complete list of bit values indicating individual attribute support
 is defined in include/linux/hwmon.h. Definition prefixes are as follows.
 
+=============== =================================================
 HWMON_C_xxxx	Chip attributes, for use with hwmon_chip.
 HWMON_T_xxxx	Temperature attributes, for use with hwmon_temp.
 HWMON_I_xxxx	Voltage attributes, for use with hwmon_in.
@@ -231,57 +244,76 @@ HWMON_E_xxxx	Energy attributes, for use with hwmon_energy.
 HWMON_H_xxxx	Humidity attributes, for use with hwmon_humidity.
 HWMON_F_xxxx	Fan speed attributes, for use with hwmon_fan.
 HWMON_PWM_xxxx	PWM control attributes, for use with hwmon_pwm.
+=============== =================================================
 
 Driver callback functions
 -------------------------
 
 Each driver provides is_visible, read, and write functions. Parameters
-and return values for those functions are as follows.
+and return values for those functions are as follows::
 
-umode_t is_visible_func(const void *data, enum hwmon_sensor_types type,
-			u32 attr, int channel)
+  umode_t is_visible_func(const void *data, enum hwmon_sensor_types type,
+			  u32 attr, int channel)
 
 Parameters:
-	data:	Pointer to device private data structure.
-	type:	The sensor type.
-	attr:	Attribute identifier associated with a specific attribute.
+	data:
+		Pointer to device private data structure.
+	type:
+		The sensor type.
+	attr:
+		Attribute identifier associated with a specific attribute.
 		For example, the attribute value for HWMON_T_INPUT would be
 		hwmon_temp_input. For complete mappings of bit fields to
 		attribute values please see include/linux/hwmon.h.
-	channel:The sensor channel number.
+	channel:
+		The sensor channel number.
 
 Return value:
 	The file mode for this attribute. Typically, this will be 0 (the
 	attribute will not be created), S_IRUGO, or 'S_IRUGO | S_IWUSR'.
 
-int read_func(struct device *dev, enum hwmon_sensor_types type,
-	      u32 attr, int channel, long *val)
+::
+
+	int read_func(struct device *dev, enum hwmon_sensor_types type,
+		      u32 attr, int channel, long *val)
 
 Parameters:
-	dev:	Pointer to the hardware monitoring device.
-	type:	The sensor type.
-	attr:	Attribute identifier associated with a specific attribute.
+	dev:
+		Pointer to the hardware monitoring device.
+	type:
+		The sensor type.
+	attr:
+		Attribute identifier associated with a specific attribute.
 		For example, the attribute value for HWMON_T_INPUT would be
 		hwmon_temp_input. For complete mappings please see
 		include/linux/hwmon.h.
-	channel:The sensor channel number.
-	val:	Pointer to attribute value.
+	channel:
+		The sensor channel number.
+	val:
+		Pointer to attribute value.
 
 Return value:
 	0 on success, a negative error number otherwise.
 
-int write_func(struct device *dev, enum hwmon_sensor_types type,
-	       u32 attr, int channel, long val)
+::
+
+	int write_func(struct device *dev, enum hwmon_sensor_types type,
+		       u32 attr, int channel, long val)
 
 Parameters:
-	dev:	Pointer to the hardware monitoring device.
-	type:	The sensor type.
-	attr:	Attribute identifier associated with a specific attribute.
+	dev:
+		Pointer to the hardware monitoring device.
+	type:
+		The sensor type.
+	attr:
+		Attribute identifier associated with a specific attribute.
 		For example, the attribute value for HWMON_T_INPUT would be
 		hwmon_temp_input. For complete mappings please see
 		include/linux/hwmon.h.
-	channel:The sensor channel number.
-	val:	The value to write to the chip.
+	channel:
+		The sensor channel number.
+	val:
+		The value to write to the chip.
 
 Return value:
 	0 on success, a negative error number otherwise.
@@ -317,25 +349,25 @@ Standard functions, similar to DEVICE_ATTR_{RW,RO,WO}, have _show and _store
 appended to the provided function name.
 
 SENSOR_DEVICE_ATTR and its variants define a struct sensor_device_attribute
-variable. This structure has the following fields.
+variable. This structure has the following fields::
 
-struct sensor_device_attribute {
-	struct device_attribute dev_attr;
-	int index;
-};
+	struct sensor_device_attribute {
+		struct device_attribute dev_attr;
+		int index;
+	};
 
 You can use to_sensor_dev_attr to get the pointer to this structure from the
 attribute read or write function. Its parameter is the device to which the
 attribute is attached.
 
 SENSOR_DEVICE_ATTR_2 and its variants define a struct sensor_device_attribute_2
-variable, which is defined as follows.
+variable, which is defined as follows::
 
-struct sensor_device_attribute_2 {
-	struct device_attribute dev_attr;
-	u8 index;
-	u8 nr;
-};
+	struct sensor_device_attribute_2 {
+		struct device_attribute dev_attr;
+		u8 index;
+		u8 nr;
+	};
 
 Use to_sensor_dev_attr_2 to get the pointer to this structure. Its parameter
 is the device to which the attribute is attached.
diff --git a/Documentation/hwmon/ibmaem b/Documentation/hwmon/ibmaem
index 1e0d59e000b4..f07a14a1c2f5 100644
--- a/Documentation/hwmon/ibmaem
+++ b/Documentation/hwmon/ibmaem
@@ -1,15 +1,21 @@
 Kernel driver ibmaem
-======================
+====================
 
 This driver talks to the IBM Systems Director Active Energy Manager, known
 henceforth as AEM.
 
 Supported systems:
+
   * Any recent IBM System X server with AEM support.
+
     This includes the x3350, x3550, x3650, x3655, x3755, x3850 M2,
-    x3950 M2, and certain HC10/HS2x/LS2x/QS2x blades.  The IPMI host interface
+    x3950 M2, and certain HC10/HS2x/LS2x/QS2x blades.
+
+    The IPMI host interface
     driver ("ipmi-si") needs to be loaded for this driver to do anything.
+
     Prefix: 'ibmaem'
+
     Datasheet: Not available
 
 Author: Darrick J. Wong
diff --git a/Documentation/hwmon/ina3221 b/Documentation/hwmon/ina3221
index 4b82cbfb551c..9eb983c24402 100644
--- a/Documentation/hwmon/ina3221
+++ b/Documentation/hwmon/ina3221
@@ -2,11 +2,16 @@ Kernel driver ina3221
 =====================
 
 Supported chips:
+
   * Texas Instruments INA3221
+
     Prefix: 'ina3221'
+
     Addresses: I2C 0x40 - 0x43
+
     Datasheet: Publicly available at the Texas Instruments website
-               http://www.ti.com/
+
+	       http://www.ti.com/
 
 Author: Andrew F. Davis <afd@ti.com>
 
@@ -21,17 +26,19 @@ and power are calculated host-side from these.
 Sysfs entries
 -------------
 
+======================= =======================================================
 in[123]_label           Voltage channel labels
 in[123]_enable          Voltage channel enable controls
 in[123]_input           Bus voltage(mV) channels
 curr[123]_input         Current(mA) measurement channels
 shunt[123]_resistor     Shunt resistance(uOhm) channels
 curr[123]_crit          Critical alert current(mA) setting, activates the
-                          corresponding alarm when the respective current
-                          is above this value
+			corresponding alarm when the respective current
+			is above this value
 curr[123]_crit_alarm    Critical alert current limit exceeded
 curr[123]_max           Warning alert current(mA) setting, activates the
-                          corresponding alarm when the respective current
-                          average is above this value.
+			corresponding alarm when the respective current
+			average is above this value.
 curr[123]_max_alarm     Warning alert current limit exceeded
 in[456]_input           Shunt voltage(uV) for channels 1, 2, and 3 respectively
+======================= =======================================================
diff --git a/Documentation/hwmon/it87 b/Documentation/hwmon/it87
index fff6f6bf55bc..2d83f23bee93 100644
--- a/Documentation/hwmon/it87
+++ b/Documentation/hwmon/it87
@@ -2,105 +2,179 @@ Kernel driver it87
 ==================
 
 Supported chips:
+
   * IT8603E/IT8623E
+
     Prefix: 'it8603'
+
     Addresses scanned: from Super I/O config space (8 I/O ports)
+
     Datasheet: Not publicly available
+
   * IT8620E
+
     Prefix: 'it8620'
+
     Addresses scanned: from Super I/O config space (8 I/O ports)
+
   * IT8628E
+
     Prefix: 'it8628'
+
     Addresses scanned: from Super I/O config space (8 I/O ports)
+
     Datasheet: Not publicly available
+
   * IT8705F
+
     Prefix: 'it87'
+
     Addresses scanned: from Super I/O config space (8 I/O ports)
+
     Datasheet: Once publicly available at the ITE website, but no longer
+
   * IT8712F
+
     Prefix: 'it8712'
+
     Addresses scanned: from Super I/O config space (8 I/O ports)
+
     Datasheet: Once publicly available at the ITE website, but no longer
+
   * IT8716F/IT8726F
+
     Prefix: 'it8716'
+
     Addresses scanned: from Super I/O config space (8 I/O ports)
+
     Datasheet: Once publicly available at the ITE website, but no longer
+
   * IT8718F
+
     Prefix: 'it8718'
+
     Addresses scanned: from Super I/O config space (8 I/O ports)
+
     Datasheet: Once publicly available at the ITE website, but no longer
+
   * IT8720F
+
     Prefix: 'it8720'
+
     Addresses scanned: from Super I/O config space (8 I/O ports)
+
     Datasheet: Not publicly available
+
   * IT8721F/IT8758E
+
     Prefix: 'it8721'
+
     Addresses scanned: from Super I/O config space (8 I/O ports)
+
     Datasheet: Not publicly available
+
   * IT8728F
+
     Prefix: 'it8728'
+
     Addresses scanned: from Super I/O config space (8 I/O ports)
+
     Datasheet: Not publicly available
+
   * IT8732F
+
     Prefix: 'it8732'
+
     Addresses scanned: from Super I/O config space (8 I/O ports)
+
     Datasheet: Not publicly available
+
   * IT8771E
+
     Prefix: 'it8771'
+
     Addresses scanned: from Super I/O config space (8 I/O ports)
+
     Datasheet: Not publicly available
+
   * IT8772E
+
     Prefix: 'it8772'
+
     Addresses scanned: from Super I/O config space (8 I/O ports)
+
     Datasheet: Not publicly available
+
   * IT8781F
+
     Prefix: 'it8781'
+
     Addresses scanned: from Super I/O config space (8 I/O ports)
+
     Datasheet: Not publicly available
+
   * IT8782F
+
     Prefix: 'it8782'
+
     Addresses scanned: from Super I/O config space (8 I/O ports)
+
     Datasheet: Not publicly available
+
   * IT8783E/F
+
     Prefix: 'it8783'
+
     Addresses scanned: from Super I/O config space (8 I/O ports)
+
     Datasheet: Not publicly available
+
   * IT8786E
+
     Prefix: 'it8786'
+
     Addresses scanned: from Super I/O config space (8 I/O ports)
+
     Datasheet: Not publicly available
+
   * IT8790E
+
     Prefix: 'it8790'
+
     Addresses scanned: from Super I/O config space (8 I/O ports)
+
     Datasheet: Not publicly available
+
   * SiS950   [clone of IT8705F]
+
     Prefix: 'it87'
+
     Addresses scanned: from Super I/O config space (8 I/O ports)
+
     Datasheet: No longer be available
 
+
 Authors:
-    Christophe Gauthron
-    Jean Delvare <jdelvare@suse.de>
+    - Christophe Gauthron
+    - Jean Delvare <jdelvare@suse.de>
 
 
 Module Parameters
 -----------------
 
 * update_vbat: int
-
-  0 if vbat should report power on value, 1 if vbat should be updated after
-  each read. Default is 0. On some boards the battery voltage is provided
-  by either the battery or the onboard power supply. Only the first reading
-  at power on will be the actual battery voltage (which the chip does
-  automatically). On other boards the battery voltage is always fed to
-  the chip so can be read at any time. Excessive reading may decrease
-  battery life but no information is given in the datasheet.
+    0 if vbat should report power on value, 1 if vbat should be updated after
+    each read. Default is 0. On some boards the battery voltage is provided
+    by either the battery or the onboard power supply. Only the first reading
+    at power on will be the actual battery voltage (which the chip does
+    automatically). On other boards the battery voltage is always fed to
+    the chip so can be read at any time. Excessive reading may decrease
+    battery life but no information is given in the datasheet.
 
 * fix_pwm_polarity int
-
-  Force PWM polarity to active high (DANGEROUS). Some chips are
-  misconfigured by BIOS - PWM values would be inverted. This option tries
-  to fix this. Please contact your BIOS manufacturer and ask him for fix.
+    Force PWM polarity to active high (DANGEROUS). Some chips are
+    misconfigured by BIOS - PWM values would be inverted. This option tries
+    to fix this. Please contact your BIOS manufacturer and ask him for fix.
 
 
 Hardware Interfaces
diff --git a/Documentation/hwmon/lineage-pem b/Documentation/hwmon/lineage-pem
index 83b2ddc160c8..10c271dc20e8 100644
--- a/Documentation/hwmon/lineage-pem
+++ b/Documentation/hwmon/lineage-pem
@@ -2,11 +2,16 @@ Kernel driver lineage-pem
 =========================
 
 Supported devices:
+
   * Lineage Compact Power Line Power Entry Modules
+
     Prefix: 'lineage-pem'
+
     Addresses scanned: -
+
     Documentation:
-        http://www.lineagepower.com/oem/pdf/CPLI2C.pdf
+
+	http://www.lineagepower.com/oem/pdf/CPLI2C.pdf
 
 Author: Guenter Roeck <linux@roeck-us.net>
 
@@ -31,9 +36,10 @@ which can be safely used to identify the chip. You will have to instantiate
 the devices explicitly.
 
 Example: the following will load the driver for a Lineage PEM at address 0x40
-on I2C bus #1:
-$ modprobe lineage-pem
-$ echo lineage-pem 0x40 > /sys/bus/i2c/devices/i2c-1/new_device
+on I2C bus #1::
+
+	$ modprobe lineage-pem
+	$ echo lineage-pem 0x40 > /sys/bus/i2c/devices/i2c-1/new_device
 
 All Lineage CPL power entry modules have a built-in I2C bus master selector
 (PCA9541). To ensure device access, this driver should only be used as client
@@ -51,6 +57,7 @@ Input voltage, input current, input power, and fan speed measurement is only
 supported on newer devices. The driver detects if those attributes are supported,
 and only creates respective sysfs entries if they are.
 
+======================= ===============================
 in1_input		Output voltage (mV)
 in1_min_alarm		Output undervoltage alarm
 in1_max_alarm		Output overvoltage alarm
@@ -75,3 +82,4 @@ temp1_crit
 temp1_alarm
 temp1_crit_alarm
 temp1_fault
+======================= ===============================
diff --git a/Documentation/hwmon/lm63 b/Documentation/hwmon/lm63
index 4a00461512a6..f478132b0408 100644
--- a/Documentation/hwmon/lm63
+++ b/Documentation/hwmon/lm63
@@ -2,26 +2,43 @@ Kernel driver lm63
 ==================
 
 Supported chips:
+
   * National Semiconductor LM63
+
     Prefix: 'lm63'
+
     Addresses scanned: I2C 0x4c
+
     Datasheet: Publicly available at the National Semiconductor website
-               http://www.national.com/pf/LM/LM63.html
+
+	       http://www.national.com/pf/LM/LM63.html
+
   * National Semiconductor LM64
+
     Prefix: 'lm64'
+
     Addresses scanned: I2C 0x18 and 0x4e
+
     Datasheet: Publicly available at the National Semiconductor website
-               http://www.national.com/pf/LM/LM64.html
+
+	       http://www.national.com/pf/LM/LM64.html
+
   * National Semiconductor LM96163
+
     Prefix: 'lm96163'
+
     Addresses scanned: I2C 0x4c
+
     Datasheet: Publicly available at the National Semiconductor website
-               http://www.national.com/pf/LM/LM96163.html
+
+	       http://www.national.com/pf/LM/LM96163.html
+
 
 Author: Jean Delvare <jdelvare@suse.de>
 
 Thanks go to Tyan and especially Alex Buckingham for setting up a remote
 access to their S4882 test platform for this driver.
+
   http://www.tyan.com/
 
 Description
@@ -32,6 +49,7 @@ and control.
 
 The LM63 is basically an LM86 with fan speed monitoring and control
 capabilities added. It misses some of the LM86 features though:
+
  - No low limit for local temperature.
  - No critical limit for local temperature.
  - Critical limit for remote temperature can be changed only once. We
diff --git a/Documentation/hwmon/lm70 b/Documentation/hwmon/lm70
index c3a1f2ea017d..f259bc1fcd91 100644
--- a/Documentation/hwmon/lm70
+++ b/Documentation/hwmon/lm70
@@ -2,19 +2,30 @@ Kernel driver lm70
 ==================
 
 Supported chips:
+
   * National Semiconductor LM70
+
     Datasheet: http://www.national.com/pf/LM/LM70.html
+
   * Texas Instruments TMP121/TMP123
+
     Information: http://focus.ti.com/docs/prod/folders/print/tmp121.html
+
   * Texas Instruments TMP122/TMP124
+
     Information: http://www.ti.com/product/tmp122
+
   * National Semiconductor LM71
+
     Datasheet: http://www.ti.com/product/LM71
+
   * National Semiconductor LM74
+
     Datasheet: http://www.ti.com/product/LM74
 
+
 Author:
-        Kaiwan N Billimoria <kaiwan@designergraphix.com>
+	Kaiwan N Billimoria <kaiwan@designergraphix.com>
 
 Description
 -----------
diff --git a/Documentation/hwmon/lm73 b/Documentation/hwmon/lm73
index 8af059dcb642..1d6a46844e85 100644
--- a/Documentation/hwmon/lm73
+++ b/Documentation/hwmon/lm73
@@ -2,13 +2,20 @@ Kernel driver lm73
 ==================
 
 Supported chips:
+
   * Texas Instruments LM73
+
     Prefix: 'lm73'
+
     Addresses scanned: I2C 0x48, 0x49, 0x4a, 0x4c, 0x4d, and 0x4e
+
     Datasheet: Publicly available at the Texas Instruments website
-               http://www.ti.com/product/lm73
+
+	       http://www.ti.com/product/lm73
+
 
 Author: Guillaume Ligneul <guillaume.ligneul@gmail.com>
+
 Documentation: Chris Verges <kg4ysn@gmail.com>
 
 
@@ -29,17 +36,18 @@ conversion time via the 'update_interval' sysfs attribute for the
 device.  This attribute will normalize ranges of input values to the
 maximum times defined for the resolution in the datasheet.
 
+    ============= ============= ============
     Resolution    Conv. Time    Input Range
     (C/LSB)       (msec)        (msec)
-    --------------------------------------
+    ============= ============= ============
     0.25          14             0..14
     0.125         28            15..28
     0.0625        56            29..56
     0.03125       112           57..infinity
-    --------------------------------------
+    ============= ============= ============
 
 The following examples show how the 'update_interval' attribute can be
-used to change the conversion time:
+used to change the conversion time::
 
     $ echo 0 > update_interval
     $ cat update_interval
diff --git a/Documentation/hwmon/lm75 b/Documentation/hwmon/lm75
index 010583608f12..6fd4d2df5420 100644
--- a/Documentation/hwmon/lm75
+++ b/Documentation/hwmon/lm75
@@ -2,68 +2,130 @@ Kernel driver lm75
 ==================
 
 Supported chips:
+
   * National Semiconductor LM75
+
     Prefix: 'lm75'
+
     Addresses scanned: I2C 0x48 - 0x4f
+
     Datasheet: Publicly available at the National Semiconductor website
-               http://www.national.com/
+
+	       http://www.national.com/
+
   * National Semiconductor LM75A
+
     Prefix: 'lm75a'
+
     Addresses scanned: I2C 0x48 - 0x4f
+
     Datasheet: Publicly available at the National Semiconductor website
-               http://www.national.com/
+
+	       http://www.national.com/
+
   * Dallas Semiconductor (now Maxim) DS75, DS1775, DS7505
+
     Prefixes: 'ds75', 'ds1775', 'ds7505'
+
     Addresses scanned: none
+
     Datasheet: Publicly available at the Maxim website
-               http://www.maximintegrated.com/
+
+	       http://www.maximintegrated.com/
+
   * Maxim MAX6625, MAX6626, MAX31725, MAX31726
+
     Prefixes: 'max6625', 'max6626', 'max31725', 'max31726'
+
     Addresses scanned: none
+
     Datasheet: Publicly available at the Maxim website
-               http://www.maxim-ic.com/
+
+	       http://www.maxim-ic.com/
+
   * Microchip (TelCom) TCN75
+
     Prefix: 'tcn75'
+
     Addresses scanned: none
+
     Datasheet: Publicly available at the Microchip website
-               http://www.microchip.com/
+
+	       http://www.microchip.com/
+
   * Microchip MCP9800, MCP9801, MCP9802, MCP9803
+
     Prefix: 'mcp980x'
+
     Addresses scanned: none
+
     Datasheet: Publicly available at the Microchip website
-               http://www.microchip.com/
+
+	       http://www.microchip.com/
+
   * Analog Devices ADT75
+
     Prefix: 'adt75'
+
     Addresses scanned: none
+
     Datasheet: Publicly available at the Analog Devices website
-               http://www.analog.com/adt75
+
+	       http://www.analog.com/adt75
+
   * ST Microelectronics STDS75
+
     Prefix: 'stds75'
+
     Addresses scanned: none
+
     Datasheet: Publicly available at the ST website
-               http://www.st.com/internet/analog/product/121769.jsp
+
+	       http://www.st.com/internet/analog/product/121769.jsp
+
   * ST Microelectronics STLM75
+
     Prefix: 'stlm75'
+
     Addresses scanned: none
+
     Datasheet: Publicly available at the ST website
+
 	       https://www.st.com/resource/en/datasheet/stlm75.pdf
+
   * Texas Instruments TMP100, TMP101, TMP105, TMP112, TMP75, TMP75C, TMP175, TMP275
+
     Prefixes: 'tmp100', 'tmp101', 'tmp105', 'tmp112', 'tmp175', 'tmp75', 'tmp75c', 'tmp275'
+
     Addresses scanned: none
+
     Datasheet: Publicly available at the Texas Instruments website
-               http://www.ti.com/product/tmp100
-               http://www.ti.com/product/tmp101
-               http://www.ti.com/product/tmp105
-               http://www.ti.com/product/tmp112
-               http://www.ti.com/product/tmp75
-               http://www.ti.com/product/tmp75c
-               http://www.ti.com/product/tmp175
-               http://www.ti.com/product/tmp275
+
+	       http://www.ti.com/product/tmp100
+
+	       http://www.ti.com/product/tmp101
+
+	       http://www.ti.com/product/tmp105
+
+	       http://www.ti.com/product/tmp112
+
+	       http://www.ti.com/product/tmp75
+
+	       http://www.ti.com/product/tmp75c
+
+	       http://www.ti.com/product/tmp175
+
+	       http://www.ti.com/product/tmp275
+
   * NXP LM75B
+
     Prefix: 'lm75b'
+
     Addresses scanned: none
+
     Datasheet: Publicly available at the NXP website
-               http://www.nxp.com/documents/data_sheet/LM75B.pdf
+
+	       http://www.nxp.com/documents/data_sheet/LM75B.pdf
 
 Author: Frodo Looijaard <frodol@dds.nl>
 
diff --git a/Documentation/hwmon/lm77 b/Documentation/hwmon/lm77
index bfc915fe3639..4ed3fe6b999a 100644
--- a/Documentation/hwmon/lm77
+++ b/Documentation/hwmon/lm77
@@ -2,11 +2,17 @@ Kernel driver lm77
 ==================
 
 Supported chips:
+
   * National Semiconductor LM77
+
     Prefix: 'lm77'
+
     Addresses scanned: I2C 0x48 - 0x4b
+
     Datasheet: Publicly available at the National Semiconductor website
-               http://www.national.com/
+
+	       http://www.national.com/
+
 
 Author: Andras BALI <drewie@freemail.hu>
 
@@ -25,6 +31,7 @@ register on the chip, which means that the relative difference between
 the limit and its hysteresis is always the same for all 3 limits.
 
 This implementation detail implies the following:
+
 * When setting a limit, its hysteresis will automatically follow, the
   difference staying unchanged. For example, if the old critical limit
   was 80 degrees C, and the hysteresis was 75 degrees C, and you change
diff --git a/Documentation/hwmon/lm78 b/Documentation/hwmon/lm78
index 4dd47731789f..cb7a4832f35e 100644
--- a/Documentation/hwmon/lm78
+++ b/Documentation/hwmon/lm78
@@ -2,19 +2,31 @@ Kernel driver lm78
 ==================
 
 Supported chips:
+
   * National Semiconductor LM78 / LM78-J
+
     Prefix: 'lm78'
+
     Addresses scanned: I2C 0x28 - 0x2f, ISA 0x290 (8 I/O ports)
+
     Datasheet: Publicly available at the National Semiconductor website
-               http://www.national.com/
+
+	       http://www.national.com/
+
   * National Semiconductor LM79
+
     Prefix: 'lm79'
+
     Addresses scanned: I2C 0x28 - 0x2f, ISA 0x290 (8 I/O ports)
+
     Datasheet: Publicly available at the National Semiconductor website
-               http://www.national.com/
 
-Authors: Frodo Looijaard <frodol@dds.nl>
-         Jean Delvare <jdelvare@suse.de>
+	       http://www.national.com/
+
+
+Authors:
+	- Frodo Looijaard <frodol@dds.nl>
+	- Jean Delvare <jdelvare@suse.de>
 
 Description
 -----------
diff --git a/Documentation/hwmon/lm80 b/Documentation/hwmon/lm80
index a60b43efc32b..c53186abd82e 100644
--- a/Documentation/hwmon/lm80
+++ b/Documentation/hwmon/lm80
@@ -2,20 +2,31 @@ Kernel driver lm80
 ==================
 
 Supported chips:
+
   * National Semiconductor LM80
+
     Prefix: 'lm80'
+
     Addresses scanned: I2C 0x28 - 0x2f
+
     Datasheet: Publicly available at the National Semiconductor website
-               http://www.national.com/
+
+	       http://www.national.com/
+
   * National Semiconductor LM96080
+
     Prefix: 'lm96080'
+
     Addresses scanned: I2C 0x28 - 0x2f
+
     Datasheet: Publicly available at the National Semiconductor website
-               http://www.national.com/
+
+	       http://www.national.com/
+
 
 Authors:
-        Frodo Looijaard <frodol@dds.nl>,
-        Philip Edelbrock <phil@netroedge.com>
+       - Frodo Looijaard <frodol@dds.nl>,
+       - Philip Edelbrock <phil@netroedge.com>
 
 Description
 -----------
diff --git a/Documentation/hwmon/lm83 b/Documentation/hwmon/lm83
index 50be5cb26de9..ecf83819960e 100644
--- a/Documentation/hwmon/lm83
+++ b/Documentation/hwmon/lm83
@@ -2,16 +2,24 @@ Kernel driver lm83
 ==================
 
 Supported chips:
+
   * National Semiconductor LM83
+
     Prefix: 'lm83'
+
     Addresses scanned: I2C 0x18 - 0x1a, 0x29 - 0x2b, 0x4c - 0x4e
+
     Datasheet: Publicly available at the National Semiconductor website
-               http://www.national.com/pf/LM/LM83.html
+
+	       http://www.national.com/pf/LM/LM83.html
+
   * National Semiconductor LM82
+
     Addresses scanned: I2C 0x18 - 0x1a, 0x29 - 0x2b, 0x4c - 0x4e
+
     Datasheet: Publicly available at the National Semiconductor website
-               http://www.national.com/pf/LM/LM82.html
 
+	       http://www.national.com/pf/LM/LM82.html
 
 Author: Jean Delvare <jdelvare@suse.de>
 
@@ -34,13 +42,17 @@ fact that any of these motherboards do actually have an LM83, please
 contact us. Note that the LM90 can easily be misdetected as a LM83.
 
 Confirmed motherboards:
+    ===		=====
     SBS         P014
     SBS         PSL09
+    ===		=====
 
 Unconfirmed motherboards:
+    =========== ==========
     Gigabyte    GA-8IK1100
     Iwill       MPX2
     Soltek      SL-75DRV5
+    =========== ==========
 
 The LM82 is confirmed to have been found on most AMD Geode reference
 designs and test platforms.
diff --git a/Documentation/hwmon/lm85 b/Documentation/hwmon/lm85
index 2329c383efe4..faa92f54431c 100644
--- a/Documentation/hwmon/lm85
+++ b/Documentation/hwmon/lm85
@@ -2,49 +2,85 @@ Kernel driver lm85
 ==================
 
 Supported chips:
+
   * National Semiconductor LM85 (B and C versions)
+
     Prefix: 'lm85b' or 'lm85c'
+
     Addresses scanned: I2C 0x2c, 0x2d, 0x2e
+
     Datasheet: http://www.national.com/pf/LM/LM85.html
+
   * Texas Instruments LM96000
+
     Prefix: 'lm9600'
+
     Addresses scanned: I2C 0x2c, 0x2d, 0x2e
+
     Datasheet: http://www.ti.com/lit/ds/symlink/lm96000.pdf
+
   * Analog Devices ADM1027
+
     Prefix: 'adm1027'
+
     Addresses scanned: I2C 0x2c, 0x2d, 0x2e
+
     Datasheet: http://www.onsemi.com/PowerSolutions/product.do?id=ADM1027
+
   * Analog Devices ADT7463
+
     Prefix: 'adt7463'
+
     Addresses scanned: I2C 0x2c, 0x2d, 0x2e
+
     Datasheet: http://www.onsemi.com/PowerSolutions/product.do?id=ADT7463
+
   * Analog Devices ADT7468
+
     Prefix: 'adt7468'
+
     Addresses scanned: I2C 0x2c, 0x2d, 0x2e
+
     Datasheet: http://www.onsemi.com/PowerSolutions/product.do?id=ADT7468
+
   * SMSC EMC6D100, SMSC EMC6D101
+
     Prefix: 'emc6d100'
+
     Addresses scanned: I2C 0x2c, 0x2d, 0x2e
-    Datasheet: http://www.smsc.com/media/Downloads_Public/discontinued/6d100.pdf 
+
+    Datasheet: http://www.smsc.com/media/Downloads_Public/discontinued/6d100.pdf
+
   * SMSC EMC6D102
+
     Prefix: 'emc6d102'
+
     Addresses scanned: I2C 0x2c, 0x2d, 0x2e
+
     Datasheet: http://www.smsc.com/main/catalog/emc6d102.html
+
   * SMSC EMC6D103
+
     Prefix: 'emc6d103'
+
     Addresses scanned: I2C 0x2c, 0x2d, 0x2e
+
     Datasheet: http://www.smsc.com/main/catalog/emc6d103.html
+
   * SMSC EMC6D103S
+
     Prefix: 'emc6d103s'
+
     Addresses scanned: I2C 0x2c, 0x2d, 0x2e
+
     Datasheet: http://www.smsc.com/main/catalog/emc6d103s.html
 
 Authors:
-        Philip Pokorny <ppokorny@penguincomputing.com>,
-        Frodo Looijaard <frodol@dds.nl>,
-        Richard Barrington <rich_b_nz@clear.net.nz>,
-        Margit Schubert-While <margitsw@t-online.de>,
-        Justin Thiessen <jthiessen@penguincomputing.com>
+       - Philip Pokorny <ppokorny@penguincomputing.com>,
+       - Frodo Looijaard <frodol@dds.nl>,
+       - Richard Barrington <rich_b_nz@clear.net.nz>,
+       - Margit Schubert-While <margitsw@t-online.de>,
+       - Justin Thiessen <jthiessen@penguincomputing.com>
 
 Description
 -----------
@@ -177,38 +213,50 @@ Each temperature sensor is associated with a Zone. There are three
 sensors and therefore three zones (# 1, 2 and 3). Each zone has the following
 temperature configuration points:
 
-* temp#_auto_temp_off - temperature below which fans should be off or spinning very low.
-* temp#_auto_temp_min - temperature over which fans start to spin.
-* temp#_auto_temp_max - temperature when fans spin at full speed.
-* temp#_auto_temp_crit - temperature when all fans will run full speed.
+* temp#_auto_temp_off
+	- temperature below which fans should be off or spinning very low.
+* temp#_auto_temp_min
+	- temperature over which fans start to spin.
+* temp#_auto_temp_max
+	- temperature when fans spin at full speed.
+* temp#_auto_temp_crit
+	- temperature when all fans will run full speed.
 
-* PWM Control
+PWM Control
+^^^^^^^^^^^
 
 There are three PWM outputs. The LM85 datasheet suggests that the
 pwm3 output control both fan3 and fan4. Each PWM can be individually
 configured and assigned to a zone for its control value. Each PWM can be
 configured individually according to the following options.
 
-* pwm#_auto_pwm_min - this specifies the PWM value for temp#_auto_temp_off
-                      temperature. (PWM value from 0 to 255)
+* pwm#_auto_pwm_min
+	- this specifies the PWM value for temp#_auto_temp_off
+	  temperature. (PWM value from 0 to 255)
 
-* pwm#_auto_pwm_minctl - this flags selects for temp#_auto_temp_off temperature
-                         the behaviour of fans. Write 1 to let fans spinning at
-			 pwm#_auto_pwm_min or write 0 to let them off.
+* pwm#_auto_pwm_minctl
+	- this flags selects for temp#_auto_temp_off temperature
+	  the behaviour of fans. Write 1 to let fans spinning at
+	  pwm#_auto_pwm_min or write 0 to let them off.
 
-NOTE: It has been reported that there is a bug in the LM85 that causes the flag
-to be associated with the zones not the PWMs. This contradicts all the
-published documentation. Setting pwm#_min_ctl in this case actually affects all
-PWMs controlled by zone '#'.
+.. note::
 
-* PWM Controlling Zone selection
+	It has been reported that there is a bug in the LM85 that causes
+	the flag to be associated with the zones not the PWMs. This
+	contradicts all the published documentation. Setting pwm#_min_ctl
+	in this case actually affects all PWMs controlled by zone '#'.
 
-* pwm#_auto_channels - controls zone that is associated with PWM
+PWM Controlling Zone selection
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+* pwm#_auto_channels
+	- controls zone that is associated with PWM
 
 Configuration choices:
 
-   Value     Meaning
-  ------  ------------------------------------------------
+========== =============================================
+Value      Meaning
+========== =============================================
       1    Controlled by Zone 1
       2    Controlled by Zone 2
       3    Controlled by Zone 3
@@ -217,6 +265,7 @@ Configuration choices:
       0    PWM always 0%  (off)
      -1    PWM always 100%  (full on)
      -2    Manual control (write to 'pwm#' to set)
+========== =============================================
 
 The National LM85's have two vendor specific configuration
 features. Tach. mode and Spinup Control. For more details on these,
diff --git a/Documentation/hwmon/lm87 b/Documentation/hwmon/lm87
index a2339fd9acb9..72fcb577ef2a 100644
--- a/Documentation/hwmon/lm87
+++ b/Documentation/hwmon/lm87
@@ -2,23 +2,32 @@ Kernel driver lm87
 ==================
 
 Supported chips:
+
   * National Semiconductor LM87
+
     Prefix: 'lm87'
+
     Addresses scanned: I2C 0x2c - 0x2e
+
     Datasheet: http://www.national.com/pf/LM/LM87.html
+
   * Analog Devices ADM1024
+
     Prefix: 'adm1024'
+
     Addresses scanned: I2C 0x2c - 0x2e
+
     Datasheet: http://www.analog.com/en/prod/0,2877,ADM1024,00.html
 
+
 Authors:
-        Frodo Looijaard <frodol@dds.nl>,
-        Philip Edelbrock <phil@netroedge.com>,
-        Mark Studebaker <mdsxyz123@yahoo.com>,
-        Stephen Rousset <stephen.rousset@rocketlogix.com>,
-        Dan Eaton <dan.eaton@rocketlogix.com>,
-        Jean Delvare <jdelvare@suse.de>,
-        Original 2.6 port Jeff Oliver
+	- Frodo Looijaard <frodol@dds.nl>,
+	- Philip Edelbrock <phil@netroedge.com>,
+	- Mark Studebaker <mdsxyz123@yahoo.com>,
+	- Stephen Rousset <stephen.rousset@rocketlogix.com>,
+	- Dan Eaton <dan.eaton@rocketlogix.com>,
+	- Jean Delvare <jdelvare@suse.de>,
+	- Original 2.6 port Jeff Oliver
 
 Description
 -----------
diff --git a/Documentation/hwmon/lm90 b/Documentation/hwmon/lm90
index 8122675d30f6..953315987c06 100644
--- a/Documentation/hwmon/lm90
+++ b/Documentation/hwmon/lm90
@@ -2,132 +2,256 @@ Kernel driver lm90
 ==================
 
 Supported chips:
+
   * National Semiconductor LM90
+
     Prefix: 'lm90'
+
     Addresses scanned: I2C 0x4c
+
     Datasheet: Publicly available at the National Semiconductor website
-               http://www.national.com/pf/LM/LM90.html
+
+	       http://www.national.com/pf/LM/LM90.html
+
   * National Semiconductor LM89
+
     Prefix: 'lm89' (no auto-detection)
+
     Addresses scanned: I2C 0x4c and 0x4d
+
     Datasheet: Publicly available at the National Semiconductor website
-               http://www.national.com/mpf/LM/LM89.html
+
+	       http://www.national.com/mpf/LM/LM89.html
+
   * National Semiconductor LM99
+
     Prefix: 'lm99'
+
     Addresses scanned: I2C 0x4c and 0x4d
+
     Datasheet: Publicly available at the National Semiconductor website
-               http://www.national.com/pf/LM/LM99.html
+
+	       http://www.national.com/pf/LM/LM99.html
+
   * National Semiconductor LM86
+
     Prefix: 'lm86'
+
     Addresses scanned: I2C 0x4c
+
     Datasheet: Publicly available at the National Semiconductor website
-               http://www.national.com/mpf/LM/LM86.html
+
+	       http://www.national.com/mpf/LM/LM86.html
+
   * Analog Devices ADM1032
+
     Prefix: 'adm1032'
+
     Addresses scanned: I2C 0x4c and 0x4d
+
     Datasheet: Publicly available at the ON Semiconductor website
-               http://www.onsemi.com/PowerSolutions/product.do?id=ADM1032
+
+	       http://www.onsemi.com/PowerSolutions/product.do?id=ADM1032
+
   * Analog Devices ADT7461
+
     Prefix: 'adt7461'
+
     Addresses scanned: I2C 0x4c and 0x4d
+
     Datasheet: Publicly available at the ON Semiconductor website
-               http://www.onsemi.com/PowerSolutions/product.do?id=ADT7461
+
+	       http://www.onsemi.com/PowerSolutions/product.do?id=ADT7461
+
   * Analog Devices ADT7461A
+
     Prefix: 'adt7461a'
+
     Addresses scanned: I2C 0x4c and 0x4d
+
     Datasheet: Publicly available at the ON Semiconductor website
-               http://www.onsemi.com/PowerSolutions/product.do?id=ADT7461A
+
+	       http://www.onsemi.com/PowerSolutions/product.do?id=ADT7461A
+
   * ON Semiconductor NCT1008
+
     Prefix: 'nct1008'
+
     Addresses scanned: I2C 0x4c and 0x4d
+
     Datasheet: Publicly available at the ON Semiconductor website
-               http://www.onsemi.com/PowerSolutions/product.do?id=NCT1008
+
+	       http://www.onsemi.com/PowerSolutions/product.do?id=NCT1008
+
   * Maxim MAX6646
+
     Prefix: 'max6646'
+
     Addresses scanned: I2C 0x4d
+
     Datasheet: Publicly available at the Maxim website
-               http://www.maxim-ic.com/quick_view2.cfm/qv_pk/3497
+
+	       http://www.maxim-ic.com/quick_view2.cfm/qv_pk/3497
+
   * Maxim MAX6647
+
     Prefix: 'max6646'
+
     Addresses scanned: I2C 0x4e
+
     Datasheet: Publicly available at the Maxim website
-               http://www.maxim-ic.com/quick_view2.cfm/qv_pk/3497
+
+	       http://www.maxim-ic.com/quick_view2.cfm/qv_pk/3497
+
   * Maxim MAX6648
+
     Prefix: 'max6646'
+
     Addresses scanned: I2C 0x4c
+
     Datasheet: Publicly available at the Maxim website
-               http://www.maxim-ic.com/quick_view2.cfm/qv_pk/3500
+
+	       http://www.maxim-ic.com/quick_view2.cfm/qv_pk/3500
+
   * Maxim MAX6649
+
     Prefix: 'max6646'
+
     Addresses scanned: I2C 0x4c
+
     Datasheet: Publicly available at the Maxim website
-               http://www.maxim-ic.com/quick_view2.cfm/qv_pk/3497
+
+	       http://www.maxim-ic.com/quick_view2.cfm/qv_pk/3497
+
   * Maxim MAX6657
+
     Prefix: 'max6657'
+
     Addresses scanned: I2C 0x4c
+
     Datasheet: Publicly available at the Maxim website
-               http://www.maxim-ic.com/quick_view2.cfm/qv_pk/2578
+
+	       http://www.maxim-ic.com/quick_view2.cfm/qv_pk/2578
+
   * Maxim MAX6658
+
     Prefix: 'max6657'
+
     Addresses scanned: I2C 0x4c
+
     Datasheet: Publicly available at the Maxim website
-               http://www.maxim-ic.com/quick_view2.cfm/qv_pk/2578
+
+	       http://www.maxim-ic.com/quick_view2.cfm/qv_pk/2578
+
   * Maxim MAX6659
+
     Prefix: 'max6659'
+
     Addresses scanned: I2C 0x4c, 0x4d, 0x4e
+
     Datasheet: Publicly available at the Maxim website
-               http://www.maxim-ic.com/quick_view2.cfm/qv_pk/2578
+
+	       http://www.maxim-ic.com/quick_view2.cfm/qv_pk/2578
+
   * Maxim MAX6680
+
     Prefix: 'max6680'
+
     Addresses scanned: I2C 0x18, 0x19, 0x1a, 0x29, 0x2a, 0x2b,
-                           0x4c, 0x4d and 0x4e
+
+			   0x4c, 0x4d and 0x4e
+
     Datasheet: Publicly available at the Maxim website
-               http://www.maxim-ic.com/quick_view2.cfm/qv_pk/3370
+
+	       http://www.maxim-ic.com/quick_view2.cfm/qv_pk/3370
+
   * Maxim MAX6681
+
     Prefix: 'max6680'
+
     Addresses scanned: I2C 0x18, 0x19, 0x1a, 0x29, 0x2a, 0x2b,
-                           0x4c, 0x4d and 0x4e
+
+			   0x4c, 0x4d and 0x4e
+
     Datasheet: Publicly available at the Maxim website
-               http://www.maxim-ic.com/quick_view2.cfm/qv_pk/3370
+
+	       http://www.maxim-ic.com/quick_view2.cfm/qv_pk/3370
+
   * Maxim MAX6692
+
     Prefix: 'max6646'
+
     Addresses scanned: I2C 0x4c
+
     Datasheet: Publicly available at the Maxim website
-               http://www.maxim-ic.com/quick_view2.cfm/qv_pk/3500
+
+	       http://www.maxim-ic.com/quick_view2.cfm/qv_pk/3500
+
   * Maxim MAX6695
+
     Prefix: 'max6695'
+
     Addresses scanned: I2C 0x18
+
     Datasheet: Publicly available at the Maxim website
-               http://www.maxim-ic.com/datasheet/index.mvp/id/4199
+
+	       http://www.maxim-ic.com/datasheet/index.mvp/id/4199
+
   * Maxim MAX6696
+
     Prefix: 'max6695'
+
     Addresses scanned: I2C 0x18, 0x19, 0x1a, 0x29, 0x2a, 0x2b,
-                           0x4c, 0x4d and 0x4e
+
+			   0x4c, 0x4d and 0x4e
+
     Datasheet: Publicly available at the Maxim website
-               http://www.maxim-ic.com/datasheet/index.mvp/id/4199
+
+	       http://www.maxim-ic.com/datasheet/index.mvp/id/4199
+
   * Winbond/Nuvoton W83L771W/G
+
     Prefix: 'w83l771'
+
     Addresses scanned: I2C 0x4c
+
     Datasheet: No longer available
+
   * Winbond/Nuvoton W83L771AWG/ASG
+
     Prefix: 'w83l771'
+
     Addresses scanned: I2C 0x4c
+
     Datasheet: Not publicly available, can be requested from Nuvoton
+
   * Philips/NXP SA56004X
+
     Prefix: 'sa56004'
+
     Addresses scanned: I2C 0x48 through 0x4F
+
     Datasheet: Publicly available at NXP website
-               http://ics.nxp.com/products/interface/datasheet/sa56004x.pdf
+
+	       http://ics.nxp.com/products/interface/datasheet/sa56004x.pdf
+
   * GMT G781
+
     Prefix: 'g781'
+
     Addresses scanned: I2C 0x4c, 0x4d
+
     Datasheet: Not publicly available from GMT
+
   * Texas Instruments TMP451
+
     Prefix: 'tmp451'
+
     Addresses scanned: I2C 0x4c
+
     Datasheet: Publicly available at TI website
-               http://www.ti.com/litv/pdf/sbos686
 
+	       http://www.ti.com/litv/pdf/sbos686
 
 Author: Jean Delvare <jdelvare@suse.de>
 
diff --git a/Documentation/hwmon/lm92 b/Documentation/hwmon/lm92
index cfa99a353b8c..c131b923ed36 100644
--- a/Documentation/hwmon/lm92
+++ b/Documentation/hwmon/lm92
@@ -2,22 +2,35 @@ Kernel driver lm92
 ==================
 
 Supported chips:
+
   * National Semiconductor LM92
+
     Prefix: 'lm92'
+
     Addresses scanned: I2C 0x48 - 0x4b
+
     Datasheet: http://www.national.com/pf/LM/LM92.html
+
   * National Semiconductor LM76
+
     Prefix: 'lm92'
+
     Addresses scanned: none, force parameter needed
+
     Datasheet: http://www.national.com/pf/LM/LM76.html
+
   * Maxim MAX6633/MAX6634/MAX6635
+
     Prefix: 'max6635'
+
     Addresses scanned: none, force parameter needed
+
     Datasheet: http://www.maxim-ic.com/quick_view2.cfm/qv_pk/3074
 
+
 Authors:
-        Abraham van der Merwe <abraham@2d3d.co.za>
-        Jean Delvare <jdelvare@suse.de>
+       - Abraham van der Merwe <abraham@2d3d.co.za>
+       - Jean Delvare <jdelvare@suse.de>
 
 
 Description
diff --git a/Documentation/hwmon/lm93 b/Documentation/hwmon/lm93
index f3b2ad2ceb01..49d199b45b67 100644
--- a/Documentation/hwmon/lm93
+++ b/Documentation/hwmon/lm93
@@ -2,20 +2,29 @@ Kernel driver lm93
 ==================
 
 Supported chips:
+
   * National Semiconductor LM93
+
     Prefix 'lm93'
+
     Addresses scanned: I2C 0x2c-0x2e
+
     Datasheet: http://www.national.com/ds.cgi/LM/LM93.pdf
+
   * National Semiconductor LM94
+
     Prefix 'lm94'
+
     Addresses scanned: I2C 0x2c-0x2e
+
     Datasheet: http://www.national.com/ds.cgi/LM/LM94.pdf
 
+
 Authors:
-	Mark M. Hoffman <mhoffman@lightlink.com>
-	Ported to 2.6 by Eric J. Bowersox <ericb@aspsys.com>
-	Adapted to 2.6.20 by Carsten Emde <ce@osadl.org>
-	Modified for mainline integration by Hans J. Koch <hjk@hansjkoch.de>
+	- Mark M. Hoffman <mhoffman@lightlink.com>
+	- Ported to 2.6 by Eric J. Bowersox <ericb@aspsys.com>
+	- Adapted to 2.6.20 by Carsten Emde <ce@osadl.org>
+	- Modified for mainline integration by Hans J. Koch <hjk@hansjkoch.de>
 
 Module Parameters
 -----------------
@@ -67,7 +76,8 @@ LM94 are not supported.
 User Interface
 --------------
 
-#PROCHOT:
+#PROCHOT
+^^^^^^^^
 
 The LM93 can monitor two #PROCHOT signals.  The results are found in the
 sysfs files prochot1, prochot2, prochot1_avg, prochot2_avg, prochot1_max,
@@ -86,7 +96,8 @@ prochot2_interval.  The values in these files specify the intervals for
 list will cause the driver to use the next largest interval.  The available
 intervals are (in seconds):
 
-#PROCHOT intervals: 0.73, 1.46, 2.9, 5.8, 11.7, 23.3, 46.6, 93.2, 186, 372
+#PROCHOT intervals:
+	0.73, 1.46, 2.9, 5.8, 11.7, 23.3, 46.6, 93.2, 186, 372
 
 It is possible to configure the LM93 to logically short the two #PROCHOT
 signals.  I.e. when #P1_PROCHOT is asserted, the LM93 will automatically
@@ -105,16 +116,15 @@ contains a value controlling the duty cycle for the PWM signal used when
 the override function is enabled.  This value ranges from 0 to 15, with 0
 indicating minimum duty cycle and 15 indicating maximum.
 
-#VRD_HOT:
+#VRD_HOT
+^^^^^^^^
 
 The LM93 can monitor two #VRD_HOT signals. The results are found in the
 sysfs files vrdhot1 and vrdhot2. There is one value per file: a boolean for
 which 1 indicates #VRD_HOT is asserted and 0 indicates it is negated. These
 files are read-only.
 
-Smart Tach Mode:
-
-(from the datasheet)
+Smart Tach Mode (from the datasheet)::
 
 	If a fan is driven using a low-side drive PWM, the tachometer
 	output of the fan is corrupted. The LM93 includes smart tachometer
@@ -127,7 +137,8 @@ the fan tachometer with a pwm) to the sysfs file fan<n>_smart_tach.  A zero
 will disable the function for that fan.  Note that Smart tach mode cannot be
 enabled if the PWM output frequency is 22500 Hz (see below).
 
-Manual PWM:
+Manual PWM
+^^^^^^^^^^
 
 The LM93 has a fixed or override mode for the two PWM outputs (although, there
 are still some conditions that will override even this mode - see section
@@ -141,7 +152,8 @@ will cause the driver to use the next largest value.  Also note: when manual
 PWM mode is disabled, the value of pwm1 and pwm2 indicates the current duty
 cycle chosen by the h/w.
 
-PWM Output Frequency:
+PWM Output Frequency
+^^^^^^^^^^^^^^^^^^^^
 
 The LM93 supports several different frequencies for the PWM output channels.
 The sysfs files pwm1_freq and pwm2_freq are used to select the frequency. The
@@ -149,9 +161,11 @@ frequency values are constrained by the hardware.  Selecting a value which is
 not available will cause the driver to use the next largest value.  Also note
 that this parameter has implications for the Smart Tach Mode (see above).
 
-PWM Output Frequencies (in Hz): 12, 36, 48, 60, 72, 84, 96, 22500 (default)
+PWM Output Frequencies (in Hz):
+	12, 36, 48, 60, 72, 84, 96, 22500 (default)
 
-Automatic PWM:
+Automatic PWM
+^^^^^^^^^^^^^
 
 The LM93 is capable of complex automatic fan control, with many different
 points of configuration.  To start, each PWM output can be bound to any
@@ -163,14 +177,16 @@ The eight control sources are: temp1-temp4 (aka "zones" in the datasheet),
 in the sysfs files pwm<n>_auto_channels, where a "1" enables the binding, and
 a "0" disables it. The h/w default is 0x0f (all temperatures bound).
 
-	0x01 - Temp 1
-	0x02 - Temp 2
-	0x04 - Temp 3
-	0x08 - Temp 4
-	0x10 - #PROCHOT 1
-	0x20 - #PROCHOT 2
-	0x40 - #VRDHOT 1
-	0x80 - #VRDHOT 2
+	====== ===========
+	0x01   Temp 1
+	0x02   Temp 2
+	0x04   Temp 3
+	0x08   Temp 4
+	0x10   #PROCHOT 1
+	0x20   #PROCHOT 2
+	0x40   #VRDHOT 1
+	0x80   #VRDHOT 2
+	====== ===========
 
 The function y = f(x) takes a source temperature x to a PWM output y.  This
 function of the LM93 is derived from a base temperature and a table of 12
@@ -180,7 +196,9 @@ degrees C, with the value of offset <i> for temperature value <n> being
 contained in the file temp<n>_auto_offset<i>.  E.g. if the base temperature
 is 40C:
 
+     ========== ======================= =============== =======
      offset #	temp<n>_auto_offset<i>	range		pwm
+     ========== ======================= =============== =======
 	 1		0		-		 25.00%
 	 2		0		-		 28.57%
 	 3		1		40C - 41C	 32.14%
@@ -193,7 +211,8 @@ is 40C:
 	10		2		54C - 56C	 57.14%
 	11		2		56C - 58C	 71.43%
 	12		2		58C - 60C	 85.71%
-					> 60C		100.00%
+	-		-		> 60C		100.00%
+     ========== ======================= =============== =======
 
 Valid offsets are in the range 0C <= x <= 7.5C in 0.5C increments.
 
@@ -213,7 +232,8 @@ temp<n>_auto_pwm_min.  Note, there are only two minimums: one each for temp[12]
 and temp[34].  Therefore, any change to e.g. temp1_auto_pwm_min will also
 affect temp2_auto_pwm_min.
 
-PWM Spin-Up Cycle:
+PWM Spin-Up Cycle
+^^^^^^^^^^^^^^^^^
 
 A spin-up cycle occurs when a PWM output is commanded from 0% duty cycle to
 some value > 0%.  The LM93 supports a minimum duty cycle during spin-up.  These
@@ -225,10 +245,11 @@ the spin-up time in seconds.  The available spin-up times are constrained by
 the hardware.  Selecting a value which is not available will cause the driver
 to use the next largest value.
 
-Spin-up Durations: 0 (disabled, h/w default), 0.1, 0.25, 0.4, 0.7, 1.0,
-		   2.0, 4.0
+Spin-up Durations:
+	0 (disabled, h/w default), 0.1, 0.25, 0.4, 0.7, 1.0, 2.0, 4.0
 
-#PROCHOT and #VRDHOT PWM Ramping:
+#PROCHOT and #VRDHOT PWM Ramping
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 If the #PROCHOT or #VRDHOT signals are asserted while bound to a PWM output
 channel, the LM93 will ramp the PWM output up to 100% duty cycle in discrete
@@ -237,9 +258,11 @@ one value each in seconds: pwm_auto_prochot_ramp and pwm_auto_vrdhot_ramp.
 The available ramp times are constrained by the hardware.  Selecting a value
 which is not available will cause the driver to use the next largest value.
 
-Ramp Times: 0 (disabled, h/w default) to 0.75 in 0.05 second intervals
+Ramp Times:
+	0 (disabled, h/w default) to 0.75 in 0.05 second intervals
 
-Fan Boost:
+Fan Boost
+^^^^^^^^^
 
 For each temperature channel, there is a boost temperature: if the channel
 exceeds this limit, the LM93 will immediately drive both PWM outputs to 100%.
@@ -249,7 +272,8 @@ limit is reached, the temperature channel must drop below this value before
 the boost function is disabled.  This temperature is also expressed in degrees
 C in the sysfs files temp<n>_auto_boost_hyst.
 
-GPIO Pins:
+GPIO Pins
+^^^^^^^^^
 
 The LM93 can monitor the logic level of four dedicated GPIO pins as well as the
 four tach input pins.  GPIO0-GPIO3 correspond to (fan) tach 1-4, respectively.
@@ -260,50 +284,29 @@ LSB is GPIO0, and the MSB is GPIO7.
 LM93 Unique sysfs Files
 -----------------------
 
-	file			description
-	-------------------------------------------------------------
-
-	prochot<n>		current #PROCHOT %
-
-	prochot<n>_avg		moving average #PROCHOT %
-
-	prochot<n>_max		limit #PROCHOT %
-
-	prochot_short		enable or disable logical #PROCHOT pin short
-
-	prochot<n>_override	force #PROCHOT assertion as PWM
-
-	prochot_override_duty_cycle
-				duty cycle for the PWM signal used when
-				#PROCHOT is overridden
-
-	prochot<n>_interval	#PROCHOT PWM sampling interval
-
-	vrdhot<n>		0 means negated, 1 means asserted
-
-	fan<n>_smart_tach	enable or disable smart tach mode
-
-	pwm<n>_auto_channels	select control sources for PWM outputs
-
-	pwm<n>_auto_spinup_min	minimum duty cycle during spin-up
-
-	pwm<n>_auto_spinup_time	duration of spin-up
-
-	pwm_auto_prochot_ramp	ramp time per step when #PROCHOT asserted
-
-	pwm_auto_vrdhot_ramp	ramp time per step when #VRDHOT asserted
-
-	temp<n>_auto_base	temperature channel base
-
-	temp<n>_auto_offset[1-12]
-				temperature channel offsets
-
-	temp<n>_auto_offset_hyst
-				temperature channel offset hysteresis
-
-	temp<n>_auto_boost	temperature channel boost (PWMs to 100%) limit
-
-	temp<n>_auto_boost_hyst	temperature channel boost hysteresis
-
-	gpio			input state of 8 GPIO pins; read-only
-
+=========================== ===============================================
+file			    description
+=========================== ===============================================
+prochot<n>		    current #PROCHOT %
+prochot<n>_avg		    moving average #PROCHOT %
+prochot<n>_max		    limit #PROCHOT %
+prochot_short		    enable or disable logical #PROCHOT pin short
+prochot<n>_override	    force #PROCHOT assertion as PWM
+prochot_override_duty_cycle duty cycle for the PWM signal used when
+			    #PROCHOT is overridden
+prochot<n>_interval	    #PROCHOT PWM sampling interval
+vrdhot<n>		    0 means negated, 1 means asserted
+fan<n>_smart_tach	    enable or disable smart tach mode
+pwm<n>_auto_channels	    select control sources for PWM outputs
+pwm<n>_auto_spinup_min	    minimum duty cycle during spin-up
+pwm<n>_auto_spinup_time	    duration of spin-up
+pwm_auto_prochot_ramp	    ramp time per step when #PROCHOT asserted
+pwm_auto_vrdhot_ramp	    ramp time per step when #VRDHOT asserted
+temp<n>_auto_base	    temperature channel base
+temp<n>_auto_offset[1-12]   temperature channel offsets
+temp<n>_auto_offset_hyst    temperature channel offset hysteresis
+temp<n>_auto_boost	    temperature channel boost (PWMs to 100%)
+			    limit
+temp<n>_auto_boost_hyst     temperature channel boost hysteresis
+gpio			    input state of 8 GPIO pins; read-only
+=========================== ===============================================
diff --git a/Documentation/hwmon/lm95245 b/Documentation/hwmon/lm95245
index d755901f58c4..566d1dc8c5a6 100644
--- a/Documentation/hwmon/lm95245
+++ b/Documentation/hwmon/lm95245
@@ -1,16 +1,23 @@
 Kernel driver lm95245
-==================
+=====================
 
 Supported chips:
+
   * TI LM95235
+
     Addresses scanned: I2C 0x18, 0x29, 0x4c
+
     Datasheet: Publicly available at the TI website
-               http://www.ti.com/lit/ds/symlink/lm95235.pdf
+
+	       http://www.ti.com/lit/ds/symlink/lm95235.pdf
+
   * TI / National Semiconductor LM95245
+
     Addresses scanned: I2C 0x18, 0x19, 0x29, 0x4c, 0x4d
+
     Datasheet: Publicly available at the TI website
-               http://www.ti.com/lit/ds/symlink/lm95245.pdf
 
+	       http://www.ti.com/lit/ds/symlink/lm95245.pdf
 
 Author: Alexander Stein <alexander.stein@systec-electronic.com>
 
diff --git a/Documentation/hwmon/ltc2945 b/Documentation/hwmon/ltc2945
index f8d0f7f19adb..20c884985367 100644
--- a/Documentation/hwmon/ltc2945
+++ b/Documentation/hwmon/ltc2945
@@ -2,11 +2,16 @@ Kernel driver ltc2945
 =====================
 
 Supported chips:
+
   * Linear Technology LTC2945
+
     Prefix: 'ltc2945'
+
     Addresses scanned: -
+
     Datasheet:
-        http://cds.linear.com/docs/en/datasheet/2945fa.pdf
+
+	http://cds.linear.com/docs/en/datasheet/2945fa.pdf
 
 Author: Guenter Roeck <linux@roeck-us.net>
 
@@ -26,9 +31,10 @@ which can be safely used to identify the chip. You will have to instantiate
 the devices explicitly.
 
 Example: the following will load the driver for an LTC2945 at address 0x10
-on I2C bus #1:
-$ modprobe ltc2945
-$ echo ltc2945 0x10 > /sys/bus/i2c/devices/i2c-1/new_device
+on I2C bus #1::
+
+	$ modprobe ltc2945
+	$ echo ltc2945 0x10 > /sys/bus/i2c/devices/i2c-1/new_device
 
 
 Sysfs entries
@@ -45,6 +51,7 @@ Current Sense register. The reported value assumes that a 1 mOhm sense resistor
 is installed. If a different sense resistor is installed, calculate the real
 current by dividing the reported value by the sense resistor value in mOhm.
 
+======================= ========================================================
 in1_input		VIN voltage (mV). Voltage is measured either at
 			SENSE+ or VDD pin depending on chip configuration.
 in1_min			Undervoltage threshold
@@ -82,3 +89,4 @@ power1_input_highest	Historical maximum power use
 power1_reset_history	Write 1 to reset power1 history
 power1_min_alarm	Low power alarm
 power1_max_alarm	High power alarm
+======================= ========================================================
diff --git a/Documentation/hwmon/ltc2990 b/Documentation/hwmon/ltc2990
index 3ed68f676c0f..e0a369e679d3 100644
--- a/Documentation/hwmon/ltc2990
+++ b/Documentation/hwmon/ltc2990
@@ -1,14 +1,23 @@
 Kernel driver ltc2990
 =====================
 
+
 Supported chips:
+
   * Linear Technology LTC2990
+
     Prefix: 'ltc2990'
+
     Addresses scanned: -
+
     Datasheet: http://www.linear.com/product/ltc2990
 
-Author: Mike Looijmans <mike.looijmans@topic.nl>
-        Tom Levens <tom.levens@cern.ch>
+
+
+Author:
+
+	- Mike Looijmans <mike.looijmans@topic.nl>
+	- Tom Levens <tom.levens@cern.ch>
 
 
 Description
@@ -31,17 +40,21 @@ devices explicitly.
 Sysfs attributes
 ----------------
 
+============= ==================================================
 in0_input     Voltage at Vcc pin in millivolt (range 2.5V to 5V)
-temp1_input   Internal chip temperature in millidegrees Celcius
+temp1_input   Internal chip temperature in millidegrees Celsius
+============= ==================================================
 
 A subset of the following attributes are visible, depending on the measurement
 mode of the chip.
 
+============= ==========================================================
 in[1-4]_input Voltage at V[1-4] pin in millivolt
-temp2_input   External temperature sensor TR1 in millidegrees Celcius
-temp3_input   External temperature sensor TR2 in millidegrees Celcius
+temp2_input   External temperature sensor TR1 in millidegrees Celsius
+temp3_input   External temperature sensor TR2 in millidegrees Celsius
 curr1_input   Current in mA across V1-V2 assuming a 1mOhm sense resistor
 curr2_input   Current in mA across V3-V4 assuming a 1mOhm sense resistor
+============= ==========================================================
 
 The "curr*_input" measurements actually report the voltage drop across the
 input pins in microvolts. This is equivalent to the current through a 1mOhm
diff --git a/Documentation/hwmon/ltc4151 b/Documentation/hwmon/ltc4151
index 43c667e6677a..c39229b19624 100644
--- a/Documentation/hwmon/ltc4151
+++ b/Documentation/hwmon/ltc4151
@@ -2,11 +2,16 @@ Kernel driver ltc4151
 =====================
 
 Supported chips:
+
   * Linear Technology LTC4151
+
     Prefix: 'ltc4151'
+
     Addresses scanned: -
+
     Datasheet:
-        http://www.linear.com/docs/Datasheet/4151fc.pdf
+
+	http://www.linear.com/docs/Datasheet/4151fc.pdf
 
 Author: Per Dalen <per.dalen@appeartv.com>
 
@@ -25,9 +30,10 @@ which can be safely used to identify the chip. You will have to instantiate
 the devices explicitly.
 
 Example: the following will load the driver for an LTC4151 at address 0x6f
-on I2C bus #0:
-# modprobe ltc4151
-# echo ltc4151 0x6f > /sys/bus/i2c/devices/i2c-0/new_device
+on I2C bus #0::
+
+	# modprobe ltc4151
+	# echo ltc4151 0x6f > /sys/bus/i2c/devices/i2c-0/new_device
 
 
 Sysfs entries
@@ -40,8 +46,10 @@ Current reading provided by this driver is reported as obtained from the Current
 Sense register. The reported value assumes that a 1 mOhm sense resistor is
 installed.
 
+======================= ==================
 in1_input		VDIN voltage (mV)
 
 in2_input		ADIN voltage (mV)
 
 curr1_input		SENSE current (mA)
+======================= ==================
diff --git a/Documentation/hwmon/ltc4215 b/Documentation/hwmon/ltc4215
index c196a1846259..8d5044d99bab 100644
--- a/Documentation/hwmon/ltc4215
+++ b/Documentation/hwmon/ltc4215
@@ -2,11 +2,16 @@ Kernel driver ltc4215
 =====================
 
 Supported chips:
+
   * Linear Technology LTC4215
+
     Prefix: 'ltc4215'
+
     Addresses scanned: 0x44
+
     Datasheet:
-        http://www.linear.com/pc/downloadDocument.do?navId=H0,C1,C1003,C1006,C1163,P17572,D12697
+
+	http://www.linear.com/pc/downloadDocument.do?navId=H0,C1,C1003,C1006,C1163,P17572,D12697
 
 Author: Ira W. Snyder <iws@ovro.caltech.edu>
 
@@ -26,9 +31,10 @@ of the possible addresses are unfriendly to probing. You will have to
 instantiate the devices explicitly.
 
 Example: the following will load the driver for an LTC4215 at address 0x44
-on I2C bus #0:
-$ modprobe ltc4215
-$ echo ltc4215 0x44 > /sys/bus/i2c/devices/i2c-0/new_device
+on I2C bus #0::
+
+	$ modprobe ltc4215
+	$ echo ltc4215 0x44 > /sys/bus/i2c/devices/i2c-0/new_device
 
 
 Sysfs entries
@@ -38,6 +44,7 @@ The LTC4215 has built-in limits for overvoltage, undervoltage, and
 undercurrent warnings. This makes it very likely that the reference
 circuit will be used.
 
+======================= =========================
 in1_input		input voltage
 in2_input		output voltage
 
@@ -49,3 +56,4 @@ curr1_max_alarm		overcurrent alarm
 
 power1_input		power usage
 power1_alarm		power bad alarm
+======================= =========================
diff --git a/Documentation/hwmon/ltc4245 b/Documentation/hwmon/ltc4245
index 4ca7a9da09f9..3dafd08a4e87 100644
--- a/Documentation/hwmon/ltc4245
+++ b/Documentation/hwmon/ltc4245
@@ -2,11 +2,16 @@ Kernel driver ltc4245
 =====================
 
 Supported chips:
+
   * Linear Technology LTC4245
+
     Prefix: 'ltc4245'
+
     Addresses scanned: 0x20-0x3f
+
     Datasheet:
-        http://www.linear.com/pc/downloadDocument.do?navId=H0,C1,C1003,C1006,C1140,P19392,D13517
+
+	http://www.linear.com/pc/downloadDocument.do?navId=H0,C1,C1003,C1006,C1140,P19392,D13517
 
 Author: Ira W. Snyder <iws@ovro.caltech.edu>
 
@@ -27,9 +32,10 @@ of the possible addresses are unfriendly to probing. You will have to
 instantiate the devices explicitly.
 
 Example: the following will load the driver for an LTC4245 at address 0x23
-on I2C bus #1:
-$ modprobe ltc4245
-$ echo ltc4245 0x23 > /sys/bus/i2c/devices/i2c-1/new_device
+on I2C bus #1::
+
+	$ modprobe ltc4245
+	$ echo ltc4245 0x23 > /sys/bus/i2c/devices/i2c-1/new_device
 
 
 Sysfs entries
@@ -42,6 +48,7 @@ This driver uses the values in the datasheet to change the register values
 into the values specified in the sysfs-interface document. The current readings
 rely on the sense resistors listed in Table 2: "Sense Resistor Values".
 
+======================= =======================================================
 in1_input		12v input voltage (mV)
 in2_input		5v  input voltage (mV)
 in3_input		3v  input voltage (mV)
@@ -80,6 +87,7 @@ power1_input		12v power usage (mW)
 power2_input		5v  power usage (mW)
 power3_input		3v  power usage (mW)
 power4_input		Vee (-12v) power usage (mW)
+======================= =======================================================
 
 
 Note 1
@@ -96,6 +104,7 @@ slowly, -EAGAIN will be returned when you read the sysfs attribute containing
 the sensor reading.
 
 The LTC4245 chip can be configured to sample all GPIO pins with two methods:
+
 1) platform data -- see include/linux/platform_data/ltc4245.h
 2) OF device tree -- add the "ltc4245,use-extra-gpios" property to each chip
 
diff --git a/Documentation/hwmon/ltc4260 b/Documentation/hwmon/ltc4260
index c4ff4ad998b2..4c335b6a51d1 100644
--- a/Documentation/hwmon/ltc4260
+++ b/Documentation/hwmon/ltc4260
@@ -2,11 +2,16 @@ Kernel driver ltc4260
 =====================
 
 Supported chips:
+
   * Linear Technology LTC4260
+
     Prefix: 'ltc4260'
+
     Addresses scanned: -
+
     Datasheet:
-        http://cds.linear.com/docs/en/datasheet/4260fc.pdf
+
+	http://cds.linear.com/docs/en/datasheet/4260fc.pdf
 
 Author: Guenter Roeck <linux@roeck-us.net>
 
@@ -26,9 +31,10 @@ which can be safely used to identify the chip. You will have to instantiate
 the devices explicitly.
 
 Example: the following will load the driver for an LTC4260 at address 0x10
-on I2C bus #1:
-$ modprobe ltc4260
-$ echo ltc4260 0x10 > /sys/bus/i2c/devices/i2c-1/new_device
+on I2C bus #1::
+
+	$ modprobe ltc4260
+	$ echo ltc4260 0x10 > /sys/bus/i2c/devices/i2c-1/new_device
 
 
 Sysfs entries
@@ -45,6 +51,7 @@ Current Sense register. The reported value assumes that a 1 mOhm sense resistor
 is installed. If a different sense resistor is installed, calculate the real
 current by dividing the reported value by the sense resistor value in mOhm.
 
+======================= =======================
 in1_input		SOURCE voltage (mV)
 in1_min_alarm		Undervoltage alarm
 in1_max_alarm		Overvoltage alarm
@@ -54,3 +61,4 @@ in2_alarm		Power bad alarm
 
 curr1_input		SENSE current (mA)
 curr1_alarm		SENSE overcurrent alarm
+======================= =======================
diff --git a/Documentation/hwmon/max1619 b/Documentation/hwmon/max1619
index 518bae3a80c4..4b3762c4eceb 100644
--- a/Documentation/hwmon/max1619
+++ b/Documentation/hwmon/max1619
@@ -2,15 +2,20 @@ Kernel driver max1619
 =====================
 
 Supported chips:
+
   * Maxim MAX1619
+
     Prefix: 'max1619'
+
     Addresses scanned: I2C 0x18-0x1a, 0x29-0x2b, 0x4c-0x4e
+
     Datasheet: Publicly available at the Maxim website
-               http://pdfserv.maxim-ic.com/en/ds/MAX1619.pdf
+
+	       http://pdfserv.maxim-ic.com/en/ds/MAX1619.pdf
 
 Authors:
-        Oleksij Rempel <bug-track@fisher-privat.net>,
-        Jean Delvare <jdelvare@suse.de>
+       - Oleksij Rempel <bug-track@fisher-privat.net>,
+       - Jean Delvare <jdelvare@suse.de>
 
 Description
 -----------
diff --git a/Documentation/hwmon/max1668 b/Documentation/hwmon/max1668
index 8f9d570dbfec..417f17d750e6 100644
--- a/Documentation/hwmon/max1668
+++ b/Documentation/hwmon/max1668
@@ -2,12 +2,17 @@ Kernel driver max1668
 =====================
 
 Supported chips:
+
   * Maxim MAX1668, MAX1805 and MAX1989
+
     Prefix: 'max1668'
+
     Addresses scanned: I2C 0x18, 0x19, 0x1a, 0x29, 0x2a, 0x2b, 0x4c, 0x4d, 0x4e
+
     Datasheet: http://datasheets.maxim-ic.com/en/ds/MAX1668-MAX1989.pdf
 
 Author:
+
     David George <david.george@ska.ac.za>
 
 Description
@@ -23,8 +28,9 @@ two ICs.
 The driver is able to distinguish between the devices and creates sysfs
 entries as follows:
 
-MAX1805, MAX1668 and MAX1989:
+- MAX1805, MAX1668 and MAX1989:
 
+=============== == ============================================================
 temp1_input     ro local (ambient) temperature
 temp1_max       rw local temperature maximum threshold for alarm
 temp1_max_alarm ro local temperature maximum threshold alarm
@@ -40,8 +46,11 @@ temp3_max       rw remote temperature 2 maximum threshold for alarm
 temp3_max_alarm ro remote temperature 2 maximum threshold alarm
 temp3_min       rw remote temperature 2 minimum threshold for alarm
 temp3_min_alarm ro remote temperature 2 minimum threshold alarm
+=============== == ============================================================
 
-MAX1668 and MAX1989 only:
+- MAX1668 and MAX1989 only:
+
+=============== == ============================================================
 temp4_input     ro remote temperature 3
 temp4_max       rw remote temperature 3 maximum threshold for alarm
 temp4_max_alarm ro remote temperature 3 maximum threshold alarm
@@ -52,6 +61,7 @@ temp5_max       rw remote temperature 4 maximum threshold for alarm
 temp5_max_alarm ro remote temperature 4 maximum threshold alarm
 temp5_min       rw remote temperature 4 minimum threshold for alarm
 temp5_min_alarm ro remote temperature 4 minimum threshold alarm
+=============== == ============================================================
 
 Module Parameters
 -----------------
diff --git a/Documentation/hwmon/max197 b/Documentation/hwmon/max197
index 8d89b9009df8..02fe19bc3428 100644
--- a/Documentation/hwmon/max197
+++ b/Documentation/hwmon/max197
@@ -1,16 +1,22 @@
-Maxim MAX197 driver
-===================
+Kernel driver max197
+====================
 
 Author:
+
   * Vivien Didelot <vivien.didelot@savoirfairelinux.com>
 
 Supported chips:
+
   * Maxim MAX197
+
     Prefix: 'max197'
+
     Datasheet: http://datasheets.maxim-ic.com/en/ds/MAX197.pdf
 
   * Maxim MAX199
+
     Prefix: 'max199'
+
     Datasheet: http://datasheets.maxim-ic.com/en/ds/MAX199.pdf
 
 Description
@@ -26,7 +32,7 @@ Platform data
 -------------
 
 The MAX197 platform data (defined in linux/platform_data/max197.h) should be
-filled with a pointer to a conversion function, defined like:
+filled with a pointer to a conversion function, defined like::
 
     int convert(u8 ctrl);
 
@@ -36,25 +42,29 @@ or a negative error code otherwise.
 
 Control byte format:
 
+======= ========== ============================================
 Bit     Name       Description
 7,6     PD1,PD0    Clock and Power-Down modes
 5       ACQMOD     Internal or External Controlled Acquisition
 4       RNG        Full-scale voltage magnitude at the input
 3       BIP        Unipolar or Bipolar conversion mode
 2,1,0   A2,A1,A0   Channel
+======= ========== ============================================
 
 Sysfs interface
 ---------------
 
-* in[0-7]_input: The conversion value for the corresponding channel.
-                 RO
+  ============== ==============================================================
+  in[0-7]_input  The conversion value for the corresponding channel.
+		 RO
 
-* in[0-7]_min:   The lower limit (in mV) for the corresponding channel.
-                 For the MAX197, it will be adjusted to -10000, -5000, or 0.
-                 For the MAX199, it will be adjusted to -4000, -2000, or 0.
-                 RW
+  in[0-7]_min    The lower limit (in mV) for the corresponding channel.
+		 For the MAX197, it will be adjusted to -10000, -5000, or 0.
+		 For the MAX199, it will be adjusted to -4000, -2000, or 0.
+		 RW
 
-* in[0-7]_max:   The higher limit (in mV) for the corresponding channel.
-                 For the MAX197, it will be adjusted to 0, 5000, or 10000.
-                 For the MAX199, it will be adjusted to 0, 2000, or 4000.
-                 RW
+  in[0-7]_max    The higher limit (in mV) for the corresponding channel.
+		 For the MAX197, it will be adjusted to 0, 5000, or 10000.
+		 For the MAX199, it will be adjusted to 0, 2000, or 4000.
+		 RW
+  ============== ==============================================================
diff --git a/Documentation/hwmon/max31722 b/Documentation/hwmon/max31722
index 090da84538c8..0ab15c00b226 100644
--- a/Documentation/hwmon/max31722
+++ b/Documentation/hwmon/max31722
@@ -2,15 +2,25 @@ Kernel driver max31722
 ======================
 
 Supported chips:
+
   * Maxim Integrated MAX31722
+
     Prefix: 'max31722'
+
     ACPI ID: MAX31722
+
     Addresses scanned: -
+
     Datasheet: https://datasheets.maximintegrated.com/en/ds/MAX31722-MAX31723.pdf
+
   * Maxim Integrated MAX31723
+
     Prefix: 'max31723'
+
     ACPI ID: MAX31723
+
     Addresses scanned: -
+
     Datasheet: https://datasheets.maximintegrated.com/en/ds/MAX31722-MAX31723.pdf
 
 Author: Tiberiu Breana <tiberiu.a.breana@intel.com>
@@ -31,4 +41,6 @@ Sysfs entries
 
 The following attribute is supported:
 
+======================= =======================================================
 temp1_input		Measured temperature. Read-only.
+======================= =======================================================
diff --git a/Documentation/hwmon/max31790 b/Documentation/hwmon/max31790
index 855e62430da9..84c62a12ef3a 100644
--- a/Documentation/hwmon/max31790
+++ b/Documentation/hwmon/max31790
@@ -2,9 +2,13 @@ Kernel driver max31790
 ======================
 
 Supported chips:
+
   * Maxim MAX31790
+
     Prefix: 'max31790'
+
     Addresses scanned: -
+
     Datasheet: http://pdfserv.maximintegrated.com/en/ds/MAX31790.pdf
 
 Author: Il Han <corone.il.han@gmail.com>
@@ -30,8 +34,10 @@ also be configured to serve as tachometer inputs.
 Sysfs entries
 -------------
 
+================== === =======================================================
 fan[1-12]_input    RO  fan tachometer speed in RPM
 fan[1-12]_fault    RO  fan experienced fault
 fan[1-6]_target    RW  desired fan speed in RPM
 pwm[1-6]_enable    RW  regulator mode, 0=disabled, 1=manual mode, 2=rpm mode
 pwm[1-6]           RW  fan target duty cycle (0-255)
+================== === =======================================================
diff --git a/Documentation/hwmon/max6639 b/Documentation/hwmon/max6639
index dc49f8be7167..3da54225f83c 100644
--- a/Documentation/hwmon/max6639
+++ b/Documentation/hwmon/max6639
@@ -2,14 +2,18 @@ Kernel driver max6639
 =====================
 
 Supported chips:
+
   * Maxim MAX6639
+
     Prefix: 'max6639'
+
     Addresses scanned: I2C 0x2c, 0x2e, 0x2f
+
     Datasheet: http://pdfserv.maxim-ic.com/en/ds/MAX6639.pdf
 
 Authors:
-    He Changqing <hechangqing@semptian.com>
-    Roland Stigge <stigge@antcom.de>
+    - He Changqing <hechangqing@semptian.com>
+    - Roland Stigge <stigge@antcom.de>
 
 Description
 -----------
@@ -21,19 +25,20 @@ diode-connected transistors.
 
 The following device attributes are implemented via sysfs:
 
+====================== ==== ===================================================
 Attribute              R/W  Contents
-----------------------------------------------------------------------------
+====================== ==== ===================================================
 temp1_input            R    Temperature channel 1 input (0..150 C)
 temp2_input            R    Temperature channel 2 input (0..150 C)
 temp1_fault            R    Temperature channel 1 diode fault
 temp2_fault            R    Temperature channel 2 diode fault
 temp1_max              RW   Set THERM temperature for input 1
-                            (in C, see datasheet)
+			    (in C, see datasheet)
 temp2_max              RW   Set THERM temperature for input 2
 temp1_crit             RW   Set ALERT temperature for input 1
 temp2_crit             RW   Set ALERT temperature for input 2
 temp1_emergency        RW   Set OT temperature for input 1
-                            (in C, see datasheet)
+			    (in C, see datasheet)
 temp2_emergency        RW   Set OT temperature for input 2
 pwm1                   RW   Fan 1 target duty cycle (0..255)
 pwm2                   RW   Fan 2 target duty cycle (0..255)
@@ -47,3 +52,4 @@ temp1_crit_alarm       R    Alarm on ALERT temperature on channel 1
 temp2_crit_alarm       R    Alarm on ALERT temperature on channel 2
 temp1_emergency_alarm  R    Alarm on OT temperature on channel 1
 temp2_emergency_alarm  R    Alarm on OT temperature on channel 2
+====================== ==== ===================================================
diff --git a/Documentation/hwmon/max6642 b/Documentation/hwmon/max6642
index afbd3e4942e2..7e5b7d4f9492 100644
--- a/Documentation/hwmon/max6642
+++ b/Documentation/hwmon/max6642
@@ -2,14 +2,20 @@ Kernel driver max6642
 =====================
 
 Supported chips:
+
   * Maxim MAX6642
+
     Prefix: 'max6642'
+
     Addresses scanned: I2C 0x48-0x4f
+
     Datasheet: Publicly available at the Maxim website
-               http://datasheets.maxim-ic.com/en/ds/MAX6642.pdf
+
+	       http://datasheets.maxim-ic.com/en/ds/MAX6642.pdf
 
 Authors:
-        Per Dalen <per.dalen@appeartv.com>
+
+	Per Dalen <per.dalen@appeartv.com>
 
 Description
 -----------
diff --git a/Documentation/hwmon/max6650 b/Documentation/hwmon/max6650
index dff1d296a48b..74dc3f0caaa2 100644
--- a/Documentation/hwmon/max6650
+++ b/Documentation/hwmon/max6650
@@ -2,19 +2,27 @@ Kernel driver max6650
 =====================
 
 Supported chips:
+
   * Maxim MAX6650
+
     Prefix: 'max6650'
+
     Addresses scanned: none
+
     Datasheet: http://pdfserv.maxim-ic.com/en/ds/MAX6650-MAX6651.pdf
+
   * Maxim MAX6651
+
     Prefix: 'max6651'
+
     Addresses scanned: none
+
     Datasheet: http://pdfserv.maxim-ic.com/en/ds/MAX6650-MAX6651.pdf
 
 Authors:
-    Hans J. Koch <hjk@hansjkoch.de>
-    John Morris <john.morris@spirentcom.com>
-    Claus Gindhart <claus.gindhart@kontron.com>
+    - Hans J. Koch <hjk@hansjkoch.de>
+    - John Morris <john.morris@spirentcom.com>
+    - Claus Gindhart <claus.gindhart@kontron.com>
 
 Description
 -----------
@@ -28,6 +36,7 @@ The driver is not able to distinguish between the 2 devices.
 
 The driver provides the following sensor accesses in sysfs:
 
+=============== ======= =======================================================
 fan1_input	ro	fan tachometer speed in RPM
 fan2_input	ro	"
 fan3_input	ro	"
@@ -40,6 +49,7 @@ pwm1		rw	relative speed (0-255), 255=max. speed.
 fan1_div	rw	sets the speed range the inputs can handle. Legal
 			values are 1, 2, 4, and 8. Use lower values for
 			faster fans.
+=============== ======= =======================================================
 
 Usage notes
 -----------
diff --git a/Documentation/hwmon/mc13783-adc b/Documentation/hwmon/mc13783-adc
index 05ccc9f159f1..cae70350ba2f 100644
--- a/Documentation/hwmon/mc13783-adc
+++ b/Documentation/hwmon/mc13783-adc
@@ -2,16 +2,25 @@ Kernel driver mc13783-adc
 =========================
 
 Supported chips:
+
   * Freescale MC13783
+
     Prefix: 'mc13783'
+
     Datasheet: https://www.nxp.com/docs/en/data-sheet/MC13783.pdf
+
   * Freescale MC13892
+
     Prefix: 'mc13892'
+
     Datasheet: https://www.nxp.com/docs/en/data-sheet/MC13892.pdf
 
+
+
 Authors:
-    Sascha Hauer <s.hauer@pengutronix.de>
-    Luotao Fu <l.fu@pengutronix.de>
+
+   - Sascha Hauer <s.hauer@pengutronix.de>
+   - Luotao Fu <l.fu@pengutronix.de>
 
 Description
 -----------
@@ -30,9 +39,11 @@ the General Purpose inputs and touchscreen.
 See the following tables for the meaning of the different channels and their
 chip internal scaling:
 
-MC13783:
+- MC13783:
+
+======= =============================================== =============== =======
 Channel	Signal						Input Range	Scaling
--------------------------------------------------------------------------------
+======= =============================================== =============== =======
 0	Battery Voltage (BATT)				2.50 - 4.65V	-2.40V
 1	Battery Current (BATT - BATTISNS)		-50 - 50 mV	x20
 2	Application Supply (BP)				2.50 - 4.65V	-2.40V
@@ -52,10 +63,13 @@ Channel	Signal						Input Range	Scaling
 13	General Purpose TSX2 / Touchscreen X-plate 2	0 - 2.30V	No
 14	General Purpose TSY1 / Touchscreen Y-plate 1	0 - 2.30V	No
 15	General Purpose TSY2 / Touchscreen Y-plate 2	0 - 2.30V	No
+======= =============================================== =============== =======
 
-MC13892:
+- MC13892:
+
+======= =============================================== =============== =======
 Channel	Signal						Input Range	Scaling
--------------------------------------------------------------------------------
+======= =============================================== =============== =======
 0	Battery Voltage (BATT)				0 - 4.8V	/2
 1	Battery Current (BATT - BATTISNSCC)		-60 - 60 mV	x20
 2	Application Supply (BPSNS)			0 - 4.8V	/2
@@ -72,3 +86,4 @@ Channel	Signal						Input Range	Scaling
 13	General Purpose TSX2 / Touchscreen X-plate 2	0 - 2.4V	No
 14	General Purpose TSY1 / Touchscreen Y-plate 1	0 - 2.4V	No
 15	General Purpose TSY2 / Touchscreen Y-plate 2	0 - 2.4V	No
+======= =============================================== =============== =======
diff --git a/Documentation/hwmon/mcp3021 b/Documentation/hwmon/mcp3021
index 74a6b72adf5f..83f4bda2f269 100644
--- a/Documentation/hwmon/mcp3021
+++ b/Documentation/hwmon/mcp3021
@@ -1,17 +1,26 @@
 Kernel driver MCP3021
-======================
+=====================
 
 Supported chips:
+
   * Microchip Technology MCP3021
+
     Prefix: 'mcp3021'
+
     Datasheet: http://ww1.microchip.com/downloads/en/DeviceDoc/21805a.pdf
+
   * Microchip Technology MCP3221
+
     Prefix: 'mcp3221'
+
     Datasheet: http://ww1.microchip.com/downloads/en/DeviceDoc/21732c.pdf
 
+
+
 Authors:
-   Mingkai Hu
-   Sven Schuchmann <schuchmann@schleissheimer.de>
+
+   - Mingkai Hu
+   - Sven Schuchmann <schuchmann@schleissheimer.de>
 
 Description
 -----------
diff --git a/Documentation/hwmon/mlxreg-fan b/Documentation/hwmon/mlxreg-fan
index fc531c6978d4..c92b8e885f7e 100644
--- a/Documentation/hwmon/mlxreg-fan
+++ b/Documentation/hwmon/mlxreg-fan
@@ -2,33 +2,39 @@ Kernel driver mlxreg-fan
 ========================
 
 Provides FAN control for the next Mellanox systems:
-QMB700, equipped with 40x200GbE InfiniBand ports;
-MSN3700, equipped with 32x200GbE or 16x400GbE Ethernet ports;
-MSN3410, equipped with 6x400GbE plus 48x50GbE Ethernet ports;
-MSN3800, equipped with 64x1000GbE Ethernet ports;
+
+- QMB700, equipped with 40x200GbE InfiniBand ports;
+- MSN3700, equipped with 32x200GbE or 16x400GbE Ethernet ports;
+- MSN3410, equipped with 6x400GbE plus 48x50GbE Ethernet ports;
+- MSN3800, equipped with 64x1000GbE Ethernet ports;
+
+Author: Vadim Pasternak <vadimp@mellanox.com>
+
 These are the Top of the Rack systems, equipped with Mellanox switch
 board with Mellanox Quantum or Spectrume-2 devices.
 FAN controller is implemented by the programmable device logic.
 
 The default registers offsets set within the programmable device is as
 following:
-- pwm1			0xe3
-- fan1 (tacho1)		0xe4
-- fan2 (tacho2)		0xe5
-- fan3 (tacho3)		0xe6
-- fan4 (tacho4)		0xe7
-- fan5 (tacho5)		0xe8
-- fan6 (tacho6)		0xe9
-- fan7 (tacho7)		0xea
-- fan8 (tacho8)		0xeb
-- fan9 (tacho9)		0xec
-- fan10 (tacho10)	0xed
-- fan11 (tacho11)	0xee
-- fan12 (tacho12)	0xef
+
+======================= ====
+pwm1			0xe3
+fan1 (tacho1)		0xe4
+fan2 (tacho2)		0xe5
+fan3 (tacho3)		0xe6
+fan4 (tacho4)		0xe7
+fan5 (tacho5)		0xe8
+fan6 (tacho6)		0xe9
+fan7 (tacho7)		0xea
+fan8 (tacho8)		0xeb
+fan9 (tacho9)		0xec
+fan10 (tacho10)		0xed
+fan11 (tacho11)		0xee
+fan12 (tacho12)		0xef
+======================= ====
+
 This setup can be re-programmed with other registers.
 
-Author: Vadim Pasternak <vadimp@mellanox.com>
-
 Description
 -----------
 
@@ -48,13 +54,17 @@ thermal's sysfs interfaces.
 /sys files in hwmon subsystem
 -----------------------------
 
-fan[1-12]_fault - RO files for tachometers TACH1-TACH12 fault indication
-fan[1-12]_input - RO files for tachometers TACH1-TACH12 input (in RPM)
-pwm1		- RW file for fan[1-12] target duty cycle (0..255)
+================= == ===================================================
+fan[1-12]_fault   RO files for tachometers TACH1-TACH12 fault indication
+fan[1-12]_input   RO files for tachometers TACH1-TACH12 input (in RPM)
+pwm1		  RW file for fan[1-12] target duty cycle (0..255)
+================= == ===================================================
 
 /sys files in thermal subsystem
 -------------------------------
 
-cur_state	- RW file for current cooling state of the cooling device
-		  (0..max_state)
-max_state	- RO file for maximum cooling state of the cooling device
+================= == ====================================================
+cur_state	  RW file for current cooling state of the cooling device
+		     (0..max_state)
+max_state	  RO file for maximum cooling state of the cooling device
+================= == ====================================================
diff --git a/Documentation/hwmon/nct6683 b/Documentation/hwmon/nct6683
index c1301d4300cd..efbf7e9703ec 100644
--- a/Documentation/hwmon/nct6683
+++ b/Documentation/hwmon/nct6683
@@ -2,13 +2,18 @@ Kernel driver nct6683
 =====================
 
 Supported chips:
+
   * Nuvoton NCT6683D
+
     Prefix: 'nct6683'
+
     Addresses scanned: ISA address retrieved from Super I/O registers
+
     Datasheet: Available from Nuvoton upon request
 
 Authors:
-        Guenter Roeck <linux@roeck-us.net>
+
+	Guenter Roeck <linux@roeck-us.net>
 
 Description
 -----------
@@ -50,8 +55,10 @@ Tested Boards and Firmware Versions
 The driver has been reported to work with the following boards and
 firmware versions.
 
+=============== ===============================================
 Board		Firmware version
----------------------------------------------------------------
+=============== ===============================================
 Intel DH87RL	NCT6683D EC firmware version 1.0 build 04/03/13
 Intel DH87MC	NCT6683D EC firmware version 1.0 build 04/03/13
 Intel DB85FL	NCT6683D EC firmware version 1.0 build 04/03/13
+=============== ===============================================
diff --git a/Documentation/hwmon/nct7802 b/Documentation/hwmon/nct7802
index 5438deb6be02..8b7365a7cb32 100644
--- a/Documentation/hwmon/nct7802
+++ b/Documentation/hwmon/nct7802
@@ -2,13 +2,18 @@ Kernel driver nct7802
 =====================
 
 Supported chips:
+
   * Nuvoton NCT7802Y
+
     Prefix: 'nct7802'
+
     Addresses scanned: I2C 0x28..0x2f
+
     Datasheet: Available from Nuvoton web site
 
 Authors:
-        Guenter Roeck <linux@roeck-us.net>
+
+	Guenter Roeck <linux@roeck-us.net>
 
 Description
 -----------
@@ -25,7 +30,9 @@ Tested Boards and BIOS Versions
 The driver has been reported to work with the following boards and
 BIOS versions.
 
+======================= ===============================================
 Board			BIOS version
----------------------------------------------------------------
+======================= ===============================================
 Kontron COMe-bSC2	CHR2E934.001.GGO
 Kontron COMe-bIP2	CCR2E212
+======================= ===============================================
diff --git a/Documentation/hwmon/nct7904 b/Documentation/hwmon/nct7904
index 57fffe33ebfc..5b2f111582ff 100644
--- a/Documentation/hwmon/nct7904
+++ b/Documentation/hwmon/nct7904
@@ -1,11 +1,16 @@
 Kernel driver nct7904
-====================
+=====================
 
 Supported chip:
+
   * Nuvoton NCT7904D
+
     Prefix: nct7904
+
     Addresses: I2C 0x2d, 0x2e
+
     Datasheet: Publicly available at Nuvoton website
+
 	http://www.nuvoton.com/
 
 Author: Vadim V. Vlasov <vvlasov@dev.rtsoft.ru>
@@ -25,6 +30,7 @@ Sysfs entries
 
 Currently, the driver supports only the following features:
 
+======================= =======================================================
 in[1-20]_input		Input voltage measurements (mV)
 
 fan[1-12]_input		Fan tachometer measurements (rpm)
@@ -40,6 +46,7 @@ pwm[1-4]_enable		R/W, 1/2 for manual or SmartFan mode
 			previously configured by BIOS (or configuration EEPROM)
 
 pwm[1-4]		R/O in SmartFan mode, R/W in manual control mode
+======================= =======================================================
 
 The driver checks sensor control registers and does not export the sensors
 that are not enabled. Anyway, a sensor that is enabled may actually be not
diff --git a/Documentation/hwmon/npcm750-pwm-fan b/Documentation/hwmon/npcm750-pwm-fan
index 6156ef7398e6..c67af08b6773 100644
--- a/Documentation/hwmon/npcm750-pwm-fan
+++ b/Documentation/hwmon/npcm750-pwm-fan
@@ -2,9 +2,11 @@ Kernel driver npcm750-pwm-fan
 =============================
 
 Supported chips:
+
 	NUVOTON NPCM750/730/715/705
 
 Authors:
+
 	<tomer.maimon@nuvoton.com>
 
 Description:
@@ -15,8 +17,10 @@ controller supports up to 16 tachometer inputs.
 
 The driver provides the following sensor accesses in sysfs:
 
+=============== ======= =====================================================
 fanX_input	ro	provide current fan rotation value in RPM as reported
 			by the fan to the device.
 
 pwmX		rw	get or set PWM fan control value. This is an integer
 			value between 0(off) and 255(full speed).
+=============== ======= =====================================================
diff --git a/Documentation/hwmon/nsa320 b/Documentation/hwmon/nsa320
index fdbd6947799b..4fe75fd2f937 100644
--- a/Documentation/hwmon/nsa320
+++ b/Documentation/hwmon/nsa320
@@ -2,14 +2,23 @@ Kernel driver nsa320_hwmon
 ==========================
 
 Supported chips:
+
   * Holtek HT46R065 microcontroller with onboard firmware that configures
+
 	it to act as a hardware monitor.
+
     Prefix: 'nsa320'
+
     Addresses scanned: none
+
     Datasheet: Not available, driver was reverse engineered based upon the
+
 	Zyxel kernel source
 
+
+
 Author:
+
   Adam Baker <linux@baker-net.org.uk>
 
 Description
@@ -31,8 +40,10 @@ tenths of a degree.
 sysfs-Interface
 ---------------
 
-temp1_input - temperature input
-fan1_input - fan speed
+============= =================
+temp1_input   temperature input
+fan1_input    fan speed
+============= =================
 
 Notes
 -----
diff --git a/Documentation/hwmon/ntc_thermistor b/Documentation/hwmon/ntc_thermistor
index 8b9ff23edc32..d0e7f91726b9 100644
--- a/Documentation/hwmon/ntc_thermistor
+++ b/Documentation/hwmon/ntc_thermistor
@@ -1,22 +1,29 @@
 Kernel driver ntc_thermistor
-=================
+============================
 
 Supported thermistors from Murata:
+
 * Murata NTC Thermistors NCP15WB473, NCP18WB473, NCP21WB473, NCP03WB473,
   NCP15WL333, NCP03WF104, NCP15XH103
+
   Prefixes: 'ncp15wb473', 'ncp18wb473', 'ncp21wb473', 'ncp03wb473',
   'ncp15wl333', 'ncp03wf104', 'ncp15xh103'
+
   Datasheet: Publicly available at Murata
 
 Supported thermistors from EPCOS:
+
 * EPCOS NTC Thermistors B57330V2103
+
   Prefixes: b57330v2103
+
   Datasheet: Publicly available at EPCOS
 
 Other NTC thermistors can be supported simply by adding compensation
 tables; e.g., NCP15WL333 support is added by the table ncpXXwl333.
 
 Authors:
+
 	MyungJoo Ham <myungjoo.ham@samsung.com>
 
 Description
@@ -29,57 +36,60 @@ compensation table to get the temperature input.
 The NTC driver provides lookup tables with a linear approximation function
 and four circuit models with an option not to use any of the four models.
 
+Using the following convention::
+
+   $	resistor
+   [TH]	the thermistor
+
 The four circuit models provided are:
 
-	$: resister, [TH]: the thermistor
-
- 1. connect = NTC_CONNECTED_POSITIVE, pullup_ohm > 0
-
-   [pullup_uV]
-       |    |
-      [TH]  $ (pullup_ohm)
-       |    |
-       +----+-----------------------[read_uV]
-       |
-       $ (pulldown_ohm)
-       |
-      --- (ground)
-
- 2. connect = NTC_CONNECTED_POSITIVE, pullup_ohm = 0 (not-connected)
-
-   [pullup_uV]
-       |
-      [TH]
-       |
-       +----------------------------[read_uV]
-       |
-       $ (pulldown_ohm)
-       |
-      --- (ground)
-
- 3. connect = NTC_CONNECTED_GROUND, pulldown_ohm > 0
-
-   [pullup_uV]
-       |
-       $ (pullup_ohm)
-       |
-       +----+-----------------------[read_uV]
-       |    |
-      [TH]  $ (pulldown_ohm)
-       |    |
-      -------- (ground)
-
- 4. connect = NTC_CONNECTED_GROUND, pulldown_ohm = 0 (not-connected)
-
-   [pullup_uV]
-       |
-       $ (pullup_ohm)
-       |
-       +----------------------------[read_uV]
-       |
-      [TH]
-       |
-      --- (ground)
+1. connect = NTC_CONNECTED_POSITIVE, pullup_ohm > 0::
+
+     [pullup_uV]
+	 |    |
+	[TH]  $ (pullup_ohm)
+	 |    |
+	 +----+-----------------------[read_uV]
+	 |
+	 $ (pulldown_ohm)
+	 |
+	-+- (ground)
+
+2. connect = NTC_CONNECTED_POSITIVE, pullup_ohm = 0 (not-connected)::
+
+     [pullup_uV]
+	 |
+	[TH]
+	 |
+	 +----------------------------[read_uV]
+	 |
+	 $ (pulldown_ohm)
+	 |
+	-+- (ground)
+
+3. connect = NTC_CONNECTED_GROUND, pulldown_ohm > 0::
+
+     [pullup_uV]
+	 |
+	 $ (pullup_ohm)
+	 |
+	 +----+-----------------------[read_uV]
+	 |    |
+	[TH]  $ (pulldown_ohm)
+	 |    |
+	-+----+- (ground)
+
+4. connect = NTC_CONNECTED_GROUND, pulldown_ohm = 0 (not-connected)::
+
+     [pullup_uV]
+	 |
+	 $ (pullup_ohm)
+	 |
+	 +----------------------------[read_uV]
+	 |
+	[TH]
+	 |
+	-+- (ground)
 
 When one of the four circuit models is used, read_uV, pullup_uV, pullup_ohm,
 pulldown_ohm, and connect should be provided. When none of the four models
@@ -88,13 +98,14 @@ provide read_ohm and _not_ provide the others.
 
 Sysfs Interface
 ---------------
-name		the mandatory global attribute, the thermistor name.
 
-temp1_type	always 4 (thermistor)
-		RO
+=============== == =============================================================
+name		   the mandatory global attribute, the thermistor name.
+=============== == =============================================================
+temp1_type	RO always 4 (thermistor)
 
-temp1_input	measure the temperature and provide the measured value.
-		(reading this file initiates the reading procedure.)
-		RO
+temp1_input	RO measure the temperature and provide the measured value.
+		   (reading this file initiates the reading procedure.)
+=============== == =============================================================
 
 Note that each NTC thermistor has only _one_ thermistor; thus, only temp1 exists.
diff --git a/Documentation/hwmon/occ b/Documentation/hwmon/occ
index e787596e03fe..bf41c162d70e 100644
--- a/Documentation/hwmon/occ
+++ b/Documentation/hwmon/occ
@@ -2,6 +2,7 @@ Kernel driver occ-hwmon
 =======================
 
 Supported chips:
+
   * POWER8
   * POWER9
 
@@ -37,53 +38,87 @@ Some entries are only present with certain OCC sensor versions or only on
 certain OCCs in the system. The version number is not exported to the user
 but can be inferred.
 
-temp[1-n]_label		OCC sensor ID.
+temp[1-n]_label
+	OCC sensor ID.
+
 [with temperature sensor version 1]
-    temp[1-n]_input	Measured temperature of the component in millidegrees
+
+    temp[1-n]_input
+			Measured temperature of the component in millidegrees
 			Celsius.
+
 [with temperature sensor version >= 2]
-    temp[1-n]_type		The FRU (Field Replaceable Unit) type
+
+    temp[1-n]_type
+				The FRU (Field Replaceable Unit) type
 				(represented by an integer) for the component
 				that this sensor measures.
-    temp[1-n]_fault		Temperature sensor fault boolean; 1 to indicate
+    temp[1-n]_fault
+				Temperature sensor fault boolean; 1 to indicate
 				that a fault is present or 0 to indicate that
 				no fault is present.
+
     [with type == 3 (FRU type is VRM)]
-        temp[1-n]_alarm		VRM temperature alarm boolean; 1 to indicate
+
+	temp[1-n]_alarm
+				VRM temperature alarm boolean; 1 to indicate
 				alarm, 0 to indicate no alarm
+
     [else]
-        temp[1-n]_input		Measured temperature of the component in
+
+	temp[1-n]_input
+				Measured temperature of the component in
 				millidegrees Celsius.
 
-freq[1-n]_label		OCC sensor ID.
-freq[1-n]_input		Measured frequency of the component in MHz.
-
-power[1-n]_input	Latest measured power reading of the component in
+freq[1-n]_label
+			OCC sensor ID.
+freq[1-n]_input
+			Measured frequency of the component in MHz.
+power[1-n]_input
+			Latest measured power reading of the component in
 			microwatts.
-power[1-n]_average	Average power of the component in microwatts.
-power[1-n]_average_interval	The amount of time over which the power average
+power[1-n]_average
+			Average power of the component in microwatts.
+power[1-n]_average_interval
+				The amount of time over which the power average
 				was taken in microseconds.
+
 [with power sensor version < 2]
-    power[1-n]_label	OCC sensor ID.
+
+    power[1-n]_label
+			OCC sensor ID.
+
 [with power sensor version >= 2]
-    power[1-n]_label	OCC sensor ID + function ID + channel in the form
+
+    power[1-n]_label
+			OCC sensor ID + function ID + channel in the form
 			of a string, delimited by underscores, i.e. "0_15_1".
 			Both the function ID and channel are integers that
 			further identify the power sensor.
+
 [with power sensor version 0xa0]
-    power[1-n]_label	OCC sensor ID + sensor type in the form of a string,
+
+    power[1-n]_label
+			OCC sensor ID + sensor type in the form of a string,
 			delimited by an underscore, i.e. "0_system". Sensor
 			type will be one of "system", "proc", "vdd" or "vdn".
 			For this sensor version, OCC sensor ID will be the same
 			for all power sensors.
+
 [present only on "master" OCC; represents the whole system power; only one of
- this type of power sensor will be present]
-    power[1-n]_label		"system"
-    power[1-n]_input		Latest system output power in microwatts.
-    power[1-n]_cap		Current system power cap in microwatts.
-    power[1-n]_cap_not_redundant	System power cap in microwatts when
-					there is not redundant power.
-    power[1-n]_cap_max		Maximum power cap that the OCC can enforce in
+this type of power sensor will be present]
+
+    power[1-n]_label
+				"system"
+    power[1-n]_input
+				Latest system output power in microwatts.
+    power[1-n]_cap
+				Current system power cap in microwatts.
+    power[1-n]_cap_not_redundant
+				System power cap in microwatts when
+				there is not redundant power.
+    power[1-n]_cap_max
+				Maximum power cap that the OCC can enforce in
 				microwatts.
     power[1-n]_cap_min		Minimum power cap that the OCC can enforce in
 				microwatts.
@@ -94,8 +129,11 @@ power[1-n]_average_interval	The amount of time over which the power average
 				ignored, i.e. requesting a power cap of
 				500900000 microwatts will result in a power cap
 				request of 500 watts.
+
     [with caps sensor version > 1]
-        power[1-n]_cap_user_source	Indicates how the user power cap was
+
+	power[1-n]_cap_user_source
+					Indicates how the user power cap was
 					set. This is an integer that maps to
 					system or firmware components that can
 					set the user power cap.
@@ -104,9 +142,12 @@ The following "extn" sensors are exported as a way for the OCC to provide data
 that doesn't fit anywhere else. The meaning of these sensors is entirely
 dependent on their data, and cannot be statically defined.
 
-extn[1-n]_label		ASCII ID or OCC sensor ID.
-extn[1-n]_flags		This is one byte hexadecimal value. Bit 7 indicates the
+extn[1-n]_label
+			ASCII ID or OCC sensor ID.
+extn[1-n]_flags
+			This is one byte hexadecimal value. Bit 7 indicates the
 			type of the label attribute; 1 for sensor ID, 0 for
 			ASCII ID. Other bits are reserved.
-extn[1-n]_input		6 bytes of hexadecimal data, with a meaning defined by
+extn[1-n]_input
+			6 bytes of hexadecimal data, with a meaning defined by
 			the sensor ID.
diff --git a/Documentation/hwmon/pc87427 b/Documentation/hwmon/pc87427
index c313eb66e08a..22d8f62d851f 100644
--- a/Documentation/hwmon/pc87427
+++ b/Documentation/hwmon/pc87427
@@ -2,9 +2,13 @@ Kernel driver pc87427
 =====================
 
 Supported chips:
+
   * National Semiconductor PC87427
+
     Prefix: 'pc87427'
+
     Addresses scanned: none, address read from Super I/O config space
+
     Datasheet: No longer available
 
 Author: Jean Delvare <jdelvare@suse.de>
diff --git a/Documentation/hwmon/pcf8591 b/Documentation/hwmon/pcf8591
index 447c0702c0ec..e98bd542a441 100644
--- a/Documentation/hwmon/pcf8591
+++ b/Documentation/hwmon/pcf8591
@@ -2,16 +2,21 @@ Kernel driver pcf8591
 =====================
 
 Supported chips:
+
   * Philips/NXP PCF8591
+
     Prefix: 'pcf8591'
+
     Addresses scanned: none
+
     Datasheet: Publicly available at the NXP website
-               http://www.nxp.com/pip/PCF8591_6.html
+
+	       http://www.nxp.com/pip/PCF8591_6.html
 
 Authors:
-        Aurelien Jarno <aurelien@aurel32.net>
-        valuable contributions by Jan M. Sendler <sendler@sendler.de>,
-        Jean Delvare <jdelvare@suse.de>
+      - Aurelien Jarno <aurelien@aurel32.net>
+      - valuable contributions by Jan M. Sendler <sendler@sendler.de>,
+      - Jean Delvare <jdelvare@suse.de>
 
 
 Description
@@ -22,24 +27,25 @@ analog output) for the I2C bus produced by Philips Semiconductors (now NXP).
 It is designed to provide a byte I2C interface to up to 4 separate devices.
 
 The PCF8591 has 4 analog inputs programmable as single-ended or
-differential inputs :
+differential inputs:
+
 - mode 0 : four single ended inputs
-        Pins AIN0 to AIN3 are single ended inputs for channels 0 to 3
+	Pins AIN0 to AIN3 are single ended inputs for channels 0 to 3
 
 - mode 1 : three differential inputs
-        Pins AIN3 is the common negative differential input
-        Pins AIN0 to AIN2 are positive differential inputs for channels 0 to 2
+	Pins AIN3 is the common negative differential input
+	Pins AIN0 to AIN2 are positive differential inputs for channels 0 to 2
 
 - mode 2 : single ended and differential mixed
-        Pins AIN0 and AIN1 are single ended inputs for channels 0 and 1
-        Pins AIN2 is the positive differential input for channel 3
-        Pins AIN3 is the negative differential input for channel 3
+	Pins AIN0 and AIN1 are single ended inputs for channels 0 and 1
+	Pins AIN2 is the positive differential input for channel 3
+	Pins AIN3 is the negative differential input for channel 3
 
 - mode 3 : two differential inputs
-        Pins AIN0 is the positive differential input for channel 0
-        Pins AIN1 is the negative differential input for channel 0
-        Pins AIN2 is the positive differential input for channel 1
-        Pins AIN3 is the negative differential input for channel 1
+	Pins AIN0 is the positive differential input for channel 0
+	Pins AIN1 is the negative differential input for channel 0
+	Pins AIN2 is the positive differential input for channel 1
+	Pins AIN3 is the negative differential input for channel 1
 
 See the datasheet for details.
 
@@ -49,10 +55,11 @@ Module parameters
 * input_mode int
 
     Analog input mode:
-         0 = four single ended inputs
-         1 = three differential inputs
-         2 = single ended and differential mixed
-         3 = two differential inputs
+
+	 - 0 = four single ended inputs
+	 - 1 = three differential inputs
+	 - 2 = single ended and differential mixed
+	 - 3 = two differential inputs
 
 
 Accessing PCF8591 via /sys interface
@@ -67,11 +74,12 @@ for details.
 Directories are being created for each instantiated PCF8591:
 
 /sys/bus/i2c/devices/<0>-<1>/
-where <0> is the bus the chip is connected to (e. g. i2c-0)
-and <1> the chip address ([48..4f])
+   where <0> is the bus the chip is connected to (e. g. i2c-0)
+   and <1> the chip address ([48..4f])
 
 Inside these directories, there are such files:
-in0_input, in1_input, in2_input, in3_input, out0_enable, out0_output, name
+
+   in0_input, in1_input, in2_input, in3_input, out0_enable, out0_output, name
 
 Name contains chip name.
 
diff --git a/Documentation/hwmon/powr1220 b/Documentation/hwmon/powr1220
index 21e44f71ae6e..a7fc258da0a8 100644
--- a/Documentation/hwmon/powr1220
+++ b/Documentation/hwmon/powr1220
@@ -1,12 +1,17 @@
 Kernel driver powr1220
-==================
+======================
 
 Supported chips:
+
   * Lattice POWR1220AT8
+
     Prefix: 'powr1220'
+
     Addresses scanned: none
+
     Datasheet: Publicly available at the Lattice website
-               http://www.latticesemi.com/
+
+	       http://www.latticesemi.com/
 
 Author: Scott Kanowitz <scott.kanowitz@gmail.com>
 
@@ -26,7 +31,9 @@ value over the low measurement range maximum of 2 V.
 
 The input naming convention is as follows:
 
+============== ========
 driver name    pin name
+============== ========
 in0            VMON1
 in1            VMON2
 in2            VMON3
@@ -41,5 +48,6 @@ in10           VMON11
 in11           VMON12
 in12           VCCA
 in13           VCCINP
+============== ========
 
 The ADC readings are updated on request with a minimum period of 1s.
diff --git a/Documentation/hwmon/raspberrypi-hwmon b/Documentation/hwmon/raspberrypi-hwmon
index 3c92e2cb52d6..8038ade36490 100644
--- a/Documentation/hwmon/raspberrypi-hwmon
+++ b/Documentation/hwmon/raspberrypi-hwmon
@@ -2,6 +2,7 @@ Kernel driver raspberrypi-hwmon
 ===============================
 
 Supported boards:
+
   * Raspberry Pi A+ (via GPIO on SoC)
   * Raspberry Pi B+ (via GPIO on SoC)
   * Raspberry Pi 2 B (via GPIO on SoC)
@@ -19,4 +20,6 @@ undervoltage conditions.
 Sysfs entries
 -------------
 
+======================= ==================
 in0_lcrit_alarm		Undervoltage alarm
+======================= ==================
diff --git a/Documentation/hwmon/sch5636 b/Documentation/hwmon/sch5636
index 7b0a01da0717..4aaee3672f13 100644
--- a/Documentation/hwmon/sch5636
+++ b/Documentation/hwmon/sch5636
@@ -2,8 +2,11 @@ Kernel driver sch5636
 =====================
 
 Supported chips:
+
   * SMSC SCH5636
+
     Prefix: 'sch5636'
+
     Addresses scanned: none, address read from Super I/O config space
 
 Author: Hans de Goede <hdegoede@redhat.com>
diff --git a/Documentation/hwmon/scpi-hwmon b/Documentation/hwmon/scpi-hwmon
index 4cfcdf2d5eab..eee7022b44db 100644
--- a/Documentation/hwmon/scpi-hwmon
+++ b/Documentation/hwmon/scpi-hwmon
@@ -2,8 +2,11 @@ Kernel driver scpi-hwmon
 ========================
 
 Supported chips:
+
  * Chips based on ARM System Control Processor Interface
+
    Addresses scanned: -
+
    Datasheet: http://infocenter.arm.com/help/index.jsp?topic=/com.arm.doc.dui0922b/index.html
 
 Author: Punit Agrawal <punit.agrawal@arm.com>
@@ -14,7 +17,7 @@ Description
 This driver supports hardware monitoring for SoC's based on the ARM
 System Control Processor (SCP) implementing the System Control
 Processor Interface (SCPI). The following sensor types are supported
-by the SCP -
+by the SCP:
 
   * temperature
   * voltage
@@ -30,4 +33,4 @@ Usage Notes
 The driver relies on device tree node to indicate the presence of SCPI
 support in the kernel. See
 Documentation/devicetree/bindings/arm/arm,scpi.txt for details of the
-devicetree node.
\ No newline at end of file
+devicetree node.
diff --git a/Documentation/hwmon/sht15 b/Documentation/hwmon/sht15
index 5e3207c3b177..485abe037f6c 100644
--- a/Documentation/hwmon/sht15
+++ b/Documentation/hwmon/sht15
@@ -2,29 +2,37 @@ Kernel driver sht15
 ===================
 
 Authors:
+
   * Wouter Horre
   * Jonathan Cameron
   * Vivien Didelot <vivien.didelot@savoirfairelinux.com>
   * Jerome Oufella <jerome.oufella@savoirfairelinux.com>
 
 Supported chips:
+
   * Sensirion SHT10
+
     Prefix: 'sht10'
 
   * Sensirion SHT11
+
     Prefix: 'sht11'
 
   * Sensirion SHT15
+
     Prefix: 'sht15'
 
   * Sensirion SHT71
+
     Prefix: 'sht71'
 
   * Sensirion SHT75
+
     Prefix: 'sht75'
 
 Datasheet: Publicly available at the Sensirion website
-http://www.sensirion.ch/en/pdf/product_information/Datasheet-humidity-sensor-SHT1x.pdf
+
+	http://www.sensirion.ch/en/pdf/product_information/Datasheet-humidity-sensor-SHT1x.pdf
 
 Description
 -----------
@@ -63,11 +71,13 @@ Platform data
 Sysfs interface
 ---------------
 
-* temp1_input:     temperature input
-* humidity1_input: humidity input
-* heater_enable:   write 1 in this attribute to enable the on-chip heater,
-                   0 to disable it. Be careful not to enable the heater
-                   for too long.
-* temp1_fault:     if 1, this means that the voltage is low (below 2.47V) and
-                   measurement may be invalid.
-* humidity1_fault: same as temp1_fault.
+================== ==========================================================
+temp1_input        temperature input
+humidity1_input    humidity input
+heater_enable      write 1 in this attribute to enable the on-chip heater,
+		   0 to disable it. Be careful not to enable the heater
+		   for too long.
+temp1_fault        if 1, this means that the voltage is low (below 2.47V) and
+		   measurement may be invalid.
+humidity1_fault    same as temp1_fault.
+================== ==========================================================
diff --git a/Documentation/hwmon/sht21 b/Documentation/hwmon/sht21
index 8b3cdda541c1..f1f5da030108 100644
--- a/Documentation/hwmon/sht21
+++ b/Documentation/hwmon/sht21
@@ -2,19 +2,33 @@ Kernel driver sht21
 ===================
 
 Supported chips:
+
   * Sensirion SHT21
+
     Prefix: 'sht21'
+
     Addresses scanned: none
+
     Datasheet: Publicly available at the Sensirion website
+
     http://www.sensirion.com/file/datasheet_sht21
 
+
+
   * Sensirion SHT25
+
     Prefix: 'sht25'
+
     Addresses scanned: none
+
     Datasheet: Publicly available at the Sensirion website
+
     http://www.sensirion.com/file/datasheet_sht25
 
+
+
 Author:
+
   Urs Fleisch <urs.fleisch@sensirion.com>
 
 Description
@@ -33,9 +47,13 @@ in the board setup code.
 sysfs-Interface
 ---------------
 
-temp1_input - temperature input
-humidity1_input - humidity input
-eic - Electronic Identification Code
+temp1_input
+	- temperature input
+
+humidity1_input
+	- humidity input
+eic
+	- Electronic Identification Code
 
 Notes
 -----
diff --git a/Documentation/hwmon/sht3x b/Documentation/hwmon/sht3x
index d9daa6ab1e8e..978a7117e4b2 100644
--- a/Documentation/hwmon/sht3x
+++ b/Documentation/hwmon/sht3x
@@ -2,14 +2,19 @@ Kernel driver sht3x
 ===================
 
 Supported chips:
+
   * Sensirion SHT3x-DIS
+
     Prefix: 'sht3x'
+
     Addresses scanned: none
+
     Datasheet: https://www.sensirion.com/file/datasheet_sht3x_digital
 
 Author:
-  David Frey <david.frey@sensirion.com>
-  Pascal Sachs <pascal.sachs@sensirion.com>
+
+  - David Frey <david.frey@sensirion.com>
+  - Pascal Sachs <pascal.sachs@sensirion.com>
 
 Description
 -----------
@@ -24,6 +29,7 @@ addresses 0x44 or 0x45, depending on the wiring. See
 Documentation/i2c/instantiating-devices for methods to instantiate the device.
 
 There are two options configurable by means of sht3x_platform_data:
+
 1. blocking (pull the I2C clock line down while performing the measurement) or
    non-blocking mode. Blocking mode will guarantee the fastest result but
    the I2C bus will be busy during that time. By default, non-blocking mode
@@ -35,12 +41,15 @@ There are two options configurable by means of sht3x_platform_data:
 The sht3x sensor supports a single shot mode as well as 5 periodic measure
 modes, which can be controlled with the update_interval sysfs interface.
 The allowed update_interval in milliseconds are as follows:
-  *     0   single shot mode
-  *  2000   0.5 Hz periodic measurement
-  *  1000   1   Hz periodic measurement
-  *   500   2   Hz periodic measurement
-  *   250   4   Hz periodic measurement
-  *   100  10   Hz periodic measurement
+
+    ===== ======= ====================
+       0          single shot mode
+    2000   0.5 Hz periodic measurement
+    1000   1   Hz periodic measurement
+     500   2   Hz periodic measurement
+     250   4   Hz periodic measurement
+     100  10   Hz periodic measurement
+    ===== ======= ====================
 
 In the periodic measure mode, the sensor automatically triggers a measurement
 with the configured update interval on the chip. When a temperature or humidity
@@ -53,6 +62,7 @@ low.
 sysfs-Interface
 ---------------
 
+=================== ============================================================
 temp1_input:        temperature input
 humidity1_input:    humidity input
 temp1_max:          temperature max value
@@ -64,13 +74,15 @@ temp1_min_hyst:     temperature hysteresis value for min limit
 humidity1_min:      humidity min value
 humidity1_min_hyst: humidity hysteresis value for min limit
 temp1_alarm:        alarm flag is set to 1 if the temperature is outside the
-                    configured limits. Alarm only works in periodic measure mode
+		    configured limits. Alarm only works in periodic measure mode
 humidity1_alarm:    alarm flag is set to 1 if the humidity is outside the
-                    configured limits. Alarm only works in periodic measure mode
+		    configured limits. Alarm only works in periodic measure mode
 heater_enable:      heater enable, heating element removes excess humidity from
-                    sensor
-                        0: turned off
-                        1: turned on
+		    sensor:
+
+			- 0: turned off
+			- 1: turned on
 update_interval:    update interval, 0 for single shot, interval in msec
-                    for periodic measurement. If the interval is not supported
-                    by the sensor, the next faster interval is chosen
+		    for periodic measurement. If the interval is not supported
+		    by the sensor, the next faster interval is chosen
+=================== ============================================================
diff --git a/Documentation/hwmon/shtc1 b/Documentation/hwmon/shtc1
index 6b1e05458f0f..aa116332ba26 100644
--- a/Documentation/hwmon/shtc1
+++ b/Documentation/hwmon/shtc1
@@ -2,17 +2,29 @@ Kernel driver shtc1
 ===================
 
 Supported chips:
+
   * Sensirion SHTC1
+
     Prefix: 'shtc1'
+
     Addresses scanned: none
+
     Datasheet: http://www.sensirion.com/file/datasheet_shtc1
 
+
+
   * Sensirion SHTW1
+
     Prefix: 'shtw1'
+
     Addresses scanned: none
+
     Datasheet: Not publicly available
 
+
+
 Author:
+
   Johannes Winkelmann <johannes.winkelmann@sensirion.com>
 
 Description
@@ -28,6 +40,7 @@ address 0x70. See Documentation/i2c/instantiating-devices for methods to
 instantiate the device.
 
 There are two options configurable by means of shtc1_platform_data:
+
 1. blocking (pull the I2C clock line down while performing the measurement) or
    non-blocking mode. Blocking mode will guarantee the fastest result but
    the I2C bus will be busy during that time. By default, non-blocking mode
@@ -39,5 +52,7 @@ There are two options configurable by means of shtc1_platform_data:
 sysfs-Interface
 ---------------
 
-temp1_input - temperature input
-humidity1_input - humidity input
+temp1_input
+	- temperature input
+humidity1_input
+	- humidity input
diff --git a/Documentation/hwmon/sis5595 b/Documentation/hwmon/sis5595
index 4f8877a34f37..5acba6b0c0db 100644
--- a/Documentation/hwmon/sis5595
+++ b/Documentation/hwmon/sis5595
@@ -2,49 +2,67 @@ Kernel driver sis5595
 =====================
 
 Supported chips:
+
   * Silicon Integrated Systems Corp. SiS5595 Southbridge Hardware Monitor
+
     Prefix: 'sis5595'
+
     Addresses scanned: ISA in PCI-space encoded address
+
     Datasheet: Publicly available at the Silicon Integrated Systems Corp. site.
 
+
+
 Authors:
-        Kyösti Mälkki <kmalkki@cc.hut.fi>,
-        Mark D. Studebaker <mdsxyz123@yahoo.com>,
-        Aurelien Jarno <aurelien@aurel32.net> 2.6 port
+
+      - Kyösti Mälkki <kmalkki@cc.hut.fi>,
+      - Mark D. Studebaker <mdsxyz123@yahoo.com>,
+      - Aurelien Jarno <aurelien@aurel32.net> 2.6 port
 
    SiS southbridge has a LM78-like chip integrated on the same IC.
    This driver is a customized copy of lm78.c
 
    Supports following revisions:
+
+       =============== =============== ==============
        Version         PCI ID          PCI Revision
+       =============== =============== ==============
        1               1039/0008       AF or less
        2               1039/0008       B0 or greater
+       =============== =============== ==============
 
    Note: these chips contain a 0008 device which is incompatible with the
-        5595. We recognize these by the presence of the listed
-        "blacklist" PCI ID and refuse to load.
+	5595. We recognize these by the presence of the listed
+	"blacklist" PCI ID and refuse to load.
 
+   =================== =============== ================
    NOT SUPPORTED       PCI ID          BLACKLIST PCI ID
-        540            0008            0540
-        550            0008            0550
+   =================== =============== ================
+	540            0008            0540
+	550            0008            0550
        5513            0008            5511
        5581            0008            5597
        5582            0008            5597
        5597            0008            5597
-        630            0008            0630
-        645            0008            0645
-        730            0008            0730
-        735            0008            0735
+	630            0008            0630
+	645            0008            0645
+	730            0008            0730
+	735            0008            0735
+   =================== =============== ================
 
 
 Module Parameters
 -----------------
+
+======================= =====================================================
 force_addr=0xaddr	Set the I/O base address. Useful for boards
 			that don't set the address in the BIOS. Does not do a
 			PCI force; the device must still be present in lspci.
 			Don't use this unless the driver complains that the
 			base address is not set.
+
 			Example: 'modprobe sis5595 force_addr=0x290'
+======================= =====================================================
 
 
 Description
diff --git a/Documentation/hwmon/smsc47b397 b/Documentation/hwmon/smsc47b397
index 3a43b6948924..600194cf1804 100644
--- a/Documentation/hwmon/smsc47b397
+++ b/Documentation/hwmon/smsc47b397
@@ -2,29 +2,38 @@ Kernel driver smsc47b397
 ========================
 
 Supported chips:
+
   * SMSC LPC47B397-NC
+
   * SMSC SCH5307-NS
+
   * SMSC SCH5317
+
     Prefix: 'smsc47b397'
+
     Addresses scanned: none, address read from Super I/O config space
+
     Datasheet: In this file
 
-Authors: Mark M. Hoffman <mhoffman@lightlink.com>
-         Utilitek Systems, Inc.
+Authors:
+
+       - Mark M. Hoffman <mhoffman@lightlink.com>
+       - Utilitek Systems, Inc.
 
 November 23, 2004
 
-The following specification describes the SMSC LPC47B397-NC[1] sensor chip
+The following specification describes the SMSC LPC47B397-NC [1]_ sensor chip
 (for which there is no public datasheet available). This document was
 provided by Craig Kelly (In-Store Broadcast Network) and edited/corrected
 by Mark M. Hoffman <mhoffman@lightlink.com>.
 
-[1] And SMSC SCH5307-NS and SCH5317, which have different device IDs but are
-otherwise compatible.
+.. [1] And SMSC SCH5307-NS and SCH5317, which have different device IDs but are
+       otherwise compatible.
 
-* * * * *
+-------------------------------------------------------------------------
 
-Methods for detecting the HP SIO and reading the thermal data on a dc7100.
+Methods for detecting the HP SIO and reading the thermal data on a dc7100
+-------------------------------------------------------------------------
 
 The thermal information on the dc7100 is contained in the SIO Hardware Monitor
 (HWM). The information is accessed through an index/data pair. The index/data
@@ -35,18 +44,22 @@ and 0x61 (LSB). Currently we are using 0x480 for the HWM Base Address and
 
 Reading temperature information.
 The temperature information is located in the following registers:
+
+=============== ======= =======================================================
 Temp1		0x25	(Currently, this reflects the CPU temp on all systems).
 Temp2		0x26
 Temp3		0x27
 Temp4		0x80
+=============== ======= =======================================================
 
 Programming Example
-The following is an example of how to read the HWM temperature registers:
-MOV	DX,480H
-MOV	AX,25H
-OUT	DX,AL
-MOV	DX,481H
-IN	AL,DX
+The following is an example of how to read the HWM temperature registers::
+
+	MOV	DX,480H
+	MOV	AX,25H
+	OUT	DX,AL
+	MOV	DX,481H
+	IN	AL,DX
 
 AL contains the data in hex, the temperature in Celsius is the decimal
 equivalent.
@@ -55,25 +68,32 @@ Ex: If AL contains 0x2A, the temperature is 42 degrees C.
 
 Reading tach information.
 The fan speed information is located in the following registers:
+
+=============== ======= ======= =================================
 		LSB	MSB
 Tach1		0x28	0x29	(Currently, this reflects the CPU
 				fan speed on all systems).
 Tach2		0x2A	0x2B
 Tach3		0x2C	0x2D
 Tach4		0x2E	0x2F
+=============== ======= ======= =================================
 
-Important!!!
-Reading the tach LSB locks the tach MSB.
-The LSB Must be read first.
+.. Important::
+
+	Reading the tach LSB locks the tach MSB.
+	The LSB Must be read first.
+
+How to convert the tach reading to RPM
+--------------------------------------
 
-How to convert the tach reading to RPM.
 The tach reading (TCount) is given by: (Tach MSB * 256) + (Tach LSB)
 The SIO counts the number of 90kHz (11.111us) pulses per revolution.
 RPM = 60/(TCount * 11.111us)
 
-Example:
-Reg 0x28 = 0x9B
-Reg 0x29 = 0x08
+Example::
+
+	Reg 0x28 = 0x9B
+	Reg 0x29 = 0x08
 
 TCount = 0x89B = 2203
 
@@ -81,21 +101,28 @@ RPM = 60 / (2203 * 11.11111 E-6) = 2451 RPM
 
 Obtaining the SIO version.
 
-CONFIGURATION SEQUENCE
+Configuration Sequence
+----------------------
+
 To program the configuration registers, the following sequence must be followed:
 1. Enter Configuration Mode
 2. Configure the Configuration Registers
 3. Exit Configuration Mode.
 
 Enter Configuration Mode
+^^^^^^^^^^^^^^^^^^^^^^^^
+
 To place the chip into the Configuration State The config key (0x55) is written
 to the CONFIG PORT (0x2E).
 
 Configuration Mode
+^^^^^^^^^^^^^^^^^^
+
 In configuration mode, the INDEX PORT is located at the CONFIG PORT address and
 the DATA PORT is at INDEX PORT address + 1.
 
 The desired configuration registers are accessed in two steps:
+
 a.	Write the index of the Logical Device Number Configuration Register
 	(i.e., 0x07) to the INDEX PORT and then write the number of the
 	desired logical device to the DATA PORT.
@@ -104,30 +131,35 @@ b.	Write the address of the desired configuration register within the
 	logical device to the INDEX PORT and then write or read the config-
 	uration register through the DATA PORT.
 
-Note: If accessing the Global Configuration Registers, step (a) is not required.
+Note:
+	If accessing the Global Configuration Registers, step (a) is not required.
 
 Exit Configuration Mode
+^^^^^^^^^^^^^^^^^^^^^^^
+
 To exit the Configuration State the write 0xAA to the CONFIG PORT (0x2E).
 The chip returns to the RUN State.  (This is important).
 
 Programming Example
-The following is an example of how to read the SIO Device ID located at 0x20
+^^^^^^^^^^^^^^^^^^^
 
-; ENTER CONFIGURATION MODE
-MOV	DX,02EH
-MOV	AX,055H
-OUT	DX,AL
-; GLOBAL CONFIGURATION  REGISTER
-MOV	DX,02EH
-MOV	AL,20H
-OUT	DX,AL
-; READ THE DATA
-MOV	DX,02FH
-IN	AL,DX
-; EXIT CONFIGURATION MODE
-MOV	DX,02EH
-MOV	AX,0AAH
-OUT	DX,AL
+The following is an example of how to read the SIO Device ID located at 0x20:
+
+	; ENTER CONFIGURATION MODE
+	MOV	DX,02EH
+	MOV	AX,055H
+	OUT	DX,AL
+	; GLOBAL CONFIGURATION  REGISTER
+	MOV	DX,02EH
+	MOV	AL,20H
+	OUT	DX,AL
+	; READ THE DATA
+	MOV	DX,02FH
+	IN	AL,DX
+	; EXIT CONFIGURATION MODE
+	MOV	DX,02EH
+	MOV	AX,0AAH
+	OUT	DX,AL
 
 The registers of interest for identifying the SIO on the dc7100 are Device ID
 (0x20) and Device Rev  (0x21).
@@ -135,29 +167,31 @@ The registers of interest for identifying the SIO on the dc7100 are Device ID
 The Device ID will read 0x6F (0x81 for SCH5307-NS, and 0x85 for SCH5317)
 The Device Rev currently reads 0x01
 
-Obtaining the HWM Base Address.
+Obtaining the HWM Base Address
+------------------------------
+
 The following is an example of how to read the HWM Base Address located in
-Logical Device 8.
+Logical Device 8::
 
-; ENTER CONFIGURATION MODE
-MOV	DX,02EH
-MOV	AX,055H
-OUT	DX,AL
-; CONFIGURE REGISTER CRE0,
-; LOGICAL DEVICE 8
-MOV	DX,02EH
-MOV	AL,07H
-OUT	DX,AL ;Point to LD# Config Reg
-MOV	DX,02FH
-MOV	AL, 08H
-OUT	DX,AL;Point to Logical Device 8
-;
-MOV	DX,02EH
-MOV	AL,60H
-OUT	DX,AL	; Point to HWM Base Addr MSB
-MOV	DX,02FH
-IN	AL,DX	; Get MSB of HWM Base Addr
-; EXIT CONFIGURATION MODE
-MOV	DX,02EH
-MOV	AX,0AAH
-OUT	DX,AL
+	; ENTER CONFIGURATION MODE
+	MOV	DX,02EH
+	MOV	AX,055H
+	OUT	DX,AL
+	; CONFIGURE REGISTER CRE0,
+	; LOGICAL DEVICE 8
+	MOV	DX,02EH
+	MOV	AL,07H
+	OUT	DX,AL ;Point to LD# Config Reg
+	MOV	DX,02FH
+	MOV	AL, 08H
+	OUT	DX,AL;Point to Logical Device 8
+	;
+	MOV	DX,02EH
+	MOV	AL,60H
+	OUT	DX,AL	; Point to HWM Base Addr MSB
+	MOV	DX,02FH
+	IN	AL,DX	; Get MSB of HWM Base Addr
+	; EXIT CONFIGURATION MODE
+	MOV	DX,02EH
+	MOV	AX,0AAH
+	OUT	DX,AL
diff --git a/Documentation/hwmon/smsc47m1 b/Documentation/hwmon/smsc47m1
index 10a24b420686..c54eabd5eb57 100644
--- a/Documentation/hwmon/smsc47m1
+++ b/Documentation/hwmon/smsc47m1
@@ -2,30 +2,53 @@ Kernel driver smsc47m1
 ======================
 
 Supported chips:
+
   * SMSC LPC47B27x, LPC47M112, LPC47M10x, LPC47M13x, LPC47M14x,
+
     LPC47M15x and LPC47M192
+
     Addresses scanned: none, address read from Super I/O config space
+
     Prefix: 'smsc47m1'
+
     Datasheets:
-        http://www.smsc.com/media/Downloads_Public/Data_Sheets/47b272.pdf
-        http://www.smsc.com/media/Downloads_Public/Data_Sheets/47m10x.pdf
-        http://www.smsc.com/media/Downloads_Public/Data_Sheets/47m112.pdf
-        http://www.smsc.com/
+
+	http://www.smsc.com/media/Downloads_Public/Data_Sheets/47b272.pdf
+
+	http://www.smsc.com/media/Downloads_Public/Data_Sheets/47m10x.pdf
+
+	http://www.smsc.com/media/Downloads_Public/Data_Sheets/47m112.pdf
+
+	http://www.smsc.com/
+
   * SMSC LPC47M292
+
     Addresses scanned: none, address read from Super I/O config space
+
     Prefix: 'smsc47m2'
+
     Datasheet: Not public
+
   * SMSC LPC47M997
+
     Addresses scanned: none, address read from Super I/O config space
+
     Prefix: 'smsc47m1'
+
     Datasheet: none
 
+
+
 Authors:
-        Mark D. Studebaker <mdsxyz123@yahoo.com>,
-        With assistance from Bruce Allen <ballen@uwm.edu>, and his
-        fan.c program: http://www.lsc-group.phys.uwm.edu/%7Eballen/driver/
-        Gabriele Gorla <gorlik@yahoo.com>,
-        Jean Delvare <jdelvare@suse.de>
+
+     - Mark D. Studebaker <mdsxyz123@yahoo.com>,
+     - With assistance from Bruce Allen <ballen@uwm.edu>, and his
+       fan.c program:
+
+       - http://www.lsc-group.phys.uwm.edu/%7Eballen/driver/
+
+     - Gabriele Gorla <gorlik@yahoo.com>,
+     - Jean Delvare <jdelvare@suse.de>
 
 Description
 -----------
@@ -57,7 +80,7 @@ hardware registers are read whenever any data is read (unless it is less
 than 1.5 seconds since the last update). This means that you can easily
 miss once-only alarms.
 
+------------------------------------------------------------------
 
-**********************
 The lm_sensors project gratefully acknowledges the support of
 Intel in the development of this driver.
diff --git a/Documentation/hwmon/smsc47m192 b/Documentation/hwmon/smsc47m192
index 6d54ecb7b3f8..a2e86ab67918 100644
--- a/Documentation/hwmon/smsc47m192
+++ b/Documentation/hwmon/smsc47m192
@@ -2,17 +2,28 @@ Kernel driver smsc47m192
 ========================
 
 Supported chips:
+
   * SMSC LPC47M192, LPC47M15x, LPC47M292 and LPC47M997
+
     Prefix: 'smsc47m192'
+
     Addresses scanned: I2C 0x2c - 0x2d
+
     Datasheet: The datasheet for LPC47M192 is publicly available from
-               http://www.smsc.com/
-               The LPC47M15x, LPC47M292 and LPC47M997 are compatible for
-               hardware monitoring.
 
-Author: Hartmut Rick <linux@rick.claranet.de>
-        Special thanks to Jean Delvare for careful checking
-        of the code and many helpful comments and suggestions.
+	       http://www.smsc.com/
+
+	       The LPC47M15x, LPC47M292 and LPC47M997 are compatible for
+
+	       hardware monitoring.
+
+
+
+Author:
+      - Hartmut Rick <linux@rick.claranet.de>
+
+      - Special thanks to Jean Delvare for careful checking
+	of the code and many helpful comments and suggestions.
 
 
 Description
@@ -52,52 +63,54 @@ Reading them more often repeats the same values.
 sysfs interface
 ---------------
 
-in0_input	- +2.5V voltage input
-in1_input	- CPU voltage input (nominal 2.25V)
-in2_input	- +3.3V voltage input
-in3_input	- +5V voltage input
-in4_input	- +12V voltage input (may be missing if used as VID4)
-in5_input	- Vcc voltage input (nominal 3.3V)
-		  This is the supply voltage of the sensor chip itself.
-in6_input	- +1.5V voltage input
-in7_input	- +1.8V voltage input
+===================== ==========================================================
+in0_input	      +2.5V voltage input
+in1_input	      CPU voltage input (nominal 2.25V)
+in2_input	      +3.3V voltage input
+in3_input	      +5V voltage input
+in4_input	      +12V voltage input (may be missing if used as VID4)
+in5_input	      Vcc voltage input (nominal 3.3V)
+		      This is the supply voltage of the sensor chip itself.
+in6_input	      +1.5V voltage input
+in7_input	      +1.8V voltage input
 
 in[0-7]_min,
-in[0-7]_max	- lower and upper alarm thresholds for in[0-7]_input reading
+in[0-7]_max	      lower and upper alarm thresholds for in[0-7]_input reading
 
-		  All voltages are read and written in mV.
+		      All voltages are read and written in mV.
 
-in[0-7]_alarm	- alarm flags for voltage inputs
-		  These files read '1' in case of alarm, '0' otherwise.
+in[0-7]_alarm	      alarm flags for voltage inputs
+		      These files read '1' in case of alarm, '0' otherwise.
 
-temp1_input	- chip temperature measured by on-chip diode
-temp[2-3]_input	- temperature measured by external diodes (one of these would
-		  typically be wired to the diode inside the CPU)
+temp1_input	      chip temperature measured by on-chip diode
+temp[2-3]_input	      temperature measured by external diodes (one of these
+		      would typically be wired to the diode inside the CPU)
 
 temp[1-3]_min,
-temp[1-3]_max	- lower and upper alarm thresholds for temperatures
+temp[1-3]_max	      lower and upper alarm thresholds for temperatures
 
-temp[1-3]_offset - temperature offset registers
-		  The chip adds the offsets stored in these registers to
-		  the corresponding temperature readings.
-		  Note that temp1 and temp2 offsets share the same register,
-		  they cannot both be different from zero at the same time.
-		  Writing a non-zero number to one of them will reset the other
-		  offset to zero.
+temp[1-3]_offset      temperature offset registers
+		      The chip adds the offsets stored in these registers to
+		      the corresponding temperature readings.
+		      Note that temp1 and temp2 offsets share the same register,
+		      they cannot both be different from zero at the same time.
+		      Writing a non-zero number to one of them will reset the other
+		      offset to zero.
 
-		  All temperatures and offsets are read and written in
-		  units of 0.001 degC.
+		      All temperatures and offsets are read and written in
+		      units of 0.001 degC.
 
-temp[1-3]_alarm - alarm flags for temperature inputs, '1' in case of alarm,
-		  '0' otherwise.
-temp[2-3]_input_fault - diode fault flags for temperature inputs 2 and 3.
-		  A fault is detected if the two pins for the corresponding
-		  sensor are open or shorted, or any of the two is shorted
-		  to ground or Vcc. '1' indicates a diode fault.
+temp[1-3]_alarm       alarm flags for temperature inputs, '1' in case of alarm,
+		      '0' otherwise.
+temp[2-3]_input_fault diode fault flags for temperature inputs 2 and 3.
+		      A fault is detected if the two pins for the corresponding
+		      sensor are open or shorted, or any of the two is shorted
+		      to ground or Vcc. '1' indicates a diode fault.
 
-cpu0_vid	- CPU voltage as received from the CPU
+cpu0_vid	      CPU voltage as received from the CPU
 
-vrm		- CPU VID standard used for decoding CPU voltage
+vrm		      CPU VID standard used for decoding CPU voltage
+===================== ==========================================================
 
-		  The *_min, *_max, *_offset and vrm files can be read and
-		  written, all others are read-only.
+The `*_min`, `*_max`, `*_offset` and `vrm` files can be read and written,
+all others are read-only.
diff --git a/Documentation/hwmon/submitting-patches b/Documentation/hwmon/submitting-patches
index f88221b46153..12540b7d9b50 100644
--- a/Documentation/hwmon/submitting-patches
+++ b/Documentation/hwmon/submitting-patches
@@ -1,5 +1,5 @@
-	How to Get Your Patch Accepted Into the Hwmon Subsystem
-	-------------------------------------------------------
+How to Get Your Patch Accepted Into the Hwmon Subsystem
+=======================================================
 
 This text is a collection of suggestions for people writing patches or
 drivers for the hwmon subsystem. Following these suggestions will greatly
@@ -9,11 +9,12 @@ increase the chances of your change being accepted.
 1. General
 ----------
 
-* It should be unnecessary to mention, but please read and follow
-    Documentation/process/submit-checklist.rst
-    Documentation/process/submitting-drivers.rst
-    Documentation/process/submitting-patches.rst
-    Documentation/process/coding-style.rst
+* It should be unnecessary to mention, but please read and follow:
+
+    - Documentation/process/submit-checklist.rst
+    - Documentation/process/submitting-drivers.rst
+    - Documentation/process/submitting-patches.rst
+    - Documentation/process/coding-style.rst
 
 * Please run your patch through 'checkpatch --strict'. There should be no
   errors, no warnings, and few if any check messages. If there are any
diff --git a/Documentation/hwmon/sysfs-interface b/Documentation/hwmon/sysfs-interface
index 2b9e1005d88b..2aa9d9272966 100644
--- a/Documentation/hwmon/sysfs-interface
+++ b/Documentation/hwmon/sysfs-interface
@@ -1,5 +1,5 @@
 Naming and data format standards for sysfs files
-------------------------------------------------
+================================================
 
 The libsensors library offers an interface to the raw sensors data
 through the sysfs interface. Since lm-sensors 3.0.0, libsensors is
@@ -32,7 +32,7 @@ this reason, it is still not recommended to bypass the library.
 
 Each chip gets its own directory in the sysfs /sys/devices tree.  To
 find all sensor chips, it is easier to follow the device symlinks from
-/sys/class/hwmon/hwmon*.
+`/sys/class/hwmon/hwmon*`.
 
 Up to lm-sensors 3.0.0, libsensors looks for hardware monitoring attributes
 in the "physical" device directory. Since lm-sensors 3.0.1, attributes found
@@ -67,11 +67,13 @@ are interpreted as 0! For more on how written strings are interpreted see the
 
 -------------------------------------------------------------------------
 
-[0-*]	denotes any positive number starting from 0
-[1-*]	denotes any positive number starting from 1
+======= ===========================================
+`[0-*]`	denotes any positive number starting from 0
+`[1-*]`	denotes any positive number starting from 1
 RO	read only value
 WO	write only value
 RW	read/write value
+======= ===========================================
 
 Read/write values may be read-only for some chips, depending on the
 hardware implementation.
@@ -80,57 +82,82 @@ All entries (except name) are optional, and should only be created in a
 given driver if the chip has the feature.
 
 
-*********************
-* Global attributes *
-*********************
+*****************
+Global attributes
+*****************
 
-name		The chip name.
+`name`
+		The chip name.
 		This should be a short, lowercase string, not containing
 		whitespace, dashes, or the wildcard character '*'.
 		This attribute represents the chip name. It is the only
 		mandatory attribute.
 		I2C devices get this attribute created automatically.
+
 		RO
 
-update_interval	The interval at which the chip will update readings.
+`update_interval`
+		The interval at which the chip will update readings.
 		Unit: millisecond
+
 		RW
+
 		Some devices have a variable update rate or interval.
 		This attribute can be used to change it to the desired value.
 
 
-************
-* Voltages *
-************
+********
+Voltages
+********
+
+`in[0-*]_min`
+		Voltage min value.
 
-in[0-*]_min	Voltage min value.
 		Unit: millivolt
+
 		RW
-		
-in[0-*]_lcrit	Voltage critical min value.
+
+`in[0-*]_lcrit`
+		Voltage critical min value.
+
 		Unit: millivolt
+
 		RW
+
 		If voltage drops to or below this limit, the system may
 		take drastic action such as power down or reset. At the very
 		least, it should report a fault.
 
-in[0-*]_max	Voltage max value.
+`in[0-*]_max`
+		Voltage max value.
+
 		Unit: millivolt
+
 		RW
-		
-in[0-*]_crit	Voltage critical max value.
+
+`in[0-*]_crit`
+		Voltage critical max value.
+
 		Unit: millivolt
+
 		RW
+
 		If voltage reaches or exceeds this limit, the system may
 		take drastic action such as power down or reset. At the very
 		least, it should report a fault.
 
-in[0-*]_input	Voltage input value.
+`in[0-*]_input`
+		Voltage input value.
+
 		Unit: millivolt
+
 		RO
+
 		Voltage measured on the chip pin.
+
 		Actual voltage depends on the scaling resistors on the
 		motherboard, as recommended in the chip datasheet.
+
 		This varies by chip and by motherboard.
 		Because of this variation, values are generally NOT scaled
 		by the chip driver, and must be done by the application.
@@ -140,166 +167,232 @@ in[0-*]_input	Voltage input value.
 		thumb: drivers should report the voltage values at the
 		"pins" of the chip.
 
-in[0-*]_average
+`in[0-*]_average`
 		Average voltage
+
 		Unit: millivolt
+
 		RO
 
-in[0-*]_lowest
+`in[0-*]_lowest`
 		Historical minimum voltage
+
 		Unit: millivolt
+
 		RO
 
-in[0-*]_highest
+`in[0-*]_highest`
 		Historical maximum voltage
+
 		Unit: millivolt
+
 		RO
 
-in[0-*]_reset_history
+`in[0-*]_reset_history`
 		Reset inX_lowest and inX_highest
+
 		WO
 
-in_reset_history
+`in_reset_history`
 		Reset inX_lowest and inX_highest for all sensors
+
 		WO
 
-in[0-*]_label	Suggested voltage channel label.
+`in[0-*]_label`
+		Suggested voltage channel label.
+
 		Text string
+
 		Should only be created if the driver has hints about what
 		this voltage channel is being used for, and user-space
 		doesn't. In all other cases, the label is provided by
 		user-space.
+
 		RO
 
-in[0-*]_enable
+`in[0-*]_enable`
 		Enable or disable the sensors.
+
 		When disabled the sensor read will return -ENODATA.
-		1: Enable
-		0: Disable
+
+		- 1: Enable
+		- 0: Disable
+
 		RW
 
-cpu[0-*]_vid	CPU core reference voltage.
+`cpu[0-*]_vid`
+		CPU core reference voltage.
+
 		Unit: millivolt
+
 		RO
+
 		Not always correct.
 
-vrm		Voltage Regulator Module version number. 
+`vrm`
+		Voltage Regulator Module version number.
+
 		RW (but changing it should no more be necessary)
+
 		Originally the VRM standard version multiplied by 10, but now
 		an arbitrary number, as not all standards have a version
 		number.
+
 		Affects the way the driver calculates the CPU core reference
 		voltage from the vid pins.
 
 Also see the Alarms section for status flags associated with voltages.
 
 
-********
-* Fans *
-********
+****
+Fans
+****
+
+`fan[1-*]_min`
+		Fan minimum value
 
-fan[1-*]_min	Fan minimum value
 		Unit: revolution/min (RPM)
+
 		RW
 
-fan[1-*]_max	Fan maximum value
+`fan[1-*]_max`
+		Fan maximum value
+
 		Unit: revolution/min (RPM)
+
 		Only rarely supported by the hardware.
 		RW
 
-fan[1-*]_input	Fan input value.
+`fan[1-*]_input`
+		Fan input value.
+
 		Unit: revolution/min (RPM)
+
 		RO
 
-fan[1-*]_div	Fan divisor.
+`fan[1-*]_div`
+		Fan divisor.
+
 		Integer value in powers of two (1, 2, 4, 8, 16, 32, 64, 128).
+
 		RW
+
 		Some chips only support values 1, 2, 4 and 8.
 		Note that this is actually an internal clock divisor, which
 		affects the measurable speed range, not the read value.
 
-fan[1-*]_pulses	Number of tachometer pulses per fan revolution.
+`fan[1-*]_pulses`
+		Number of tachometer pulses per fan revolution.
+
 		Integer value, typically between 1 and 4.
+
 		RW
+
 		This value is a characteristic of the fan connected to the
 		device's input, so it has to be set in accordance with the fan
 		model.
+
 		Should only be created if the chip has a register to configure
 		the number of pulses. In the absence of such a register (and
 		thus attribute) the value assumed by all devices is 2 pulses
 		per fan revolution.
 
-fan[1-*]_target
+`fan[1-*]_target`
 		Desired fan speed
+
 		Unit: revolution/min (RPM)
+
 		RW
+
 		Only makes sense if the chip supports closed-loop fan speed
 		control based on the measured fan speed.
 
-fan[1-*]_label	Suggested fan channel label.
+`fan[1-*]_label`
+		Suggested fan channel label.
+
 		Text string
+
 		Should only be created if the driver has hints about what
 		this fan channel is being used for, and user-space doesn't.
 		In all other cases, the label is provided by user-space.
+
 		RO
 
-fan[1-*]_enable
+`fan[1-*]_enable`
 		Enable or disable the sensors.
+
 		When disabled the sensor read will return -ENODATA.
-		1: Enable
-		0: Disable
+
+		- 1: Enable
+		- 0: Disable
+
 		RW
 
 Also see the Alarms section for status flags associated with fans.
 
 
-*******
-* PWM *
-*******
+***
+PWM
+***
+
+`pwm[1-*]`
+		Pulse width modulation fan control.
 
-pwm[1-*]	Pulse width modulation fan control.
 		Integer value in the range 0 to 255
+
 		RW
+
 		255 is max or 100%.
 
-pwm[1-*]_enable
+`pwm[1-*]_enable`
 		Fan speed control method:
-		0: no fan speed control (i.e. fan at full speed)
-		1: manual fan speed control enabled (using pwm[1-*])
-		2+: automatic fan speed control enabled
+
+		- 0: no fan speed control (i.e. fan at full speed)
+		- 1: manual fan speed control enabled (using `pwm[1-*]`)
+		- 2+: automatic fan speed control enabled
+
 		Check individual chip documentation files for automatic mode
 		details.
+
 		RW
 
-pwm[1-*]_mode	0: DC mode (direct current)
-		1: PWM mode (pulse-width modulation)
+`pwm[1-*]_mode`
+		- 0: DC mode (direct current)
+		- 1: PWM mode (pulse-width modulation)
+
 		RW
 
-pwm[1-*]_freq	Base PWM frequency in Hz.
+`pwm[1-*]_freq`
+		Base PWM frequency in Hz.
+
 		Only possibly available when pwmN_mode is PWM, but not always
 		present even then.
+
 		RW
 
-pwm[1-*]_auto_channels_temp
+`pwm[1-*]_auto_channels_temp`
 		Select which temperature channels affect this PWM output in
-		auto mode. Bitfield, 1 is temp1, 2 is temp2, 4 is temp3 etc...
+		auto mode.
+
+		Bitfield, 1 is temp1, 2 is temp2, 4 is temp3 etc...
 		Which values are possible depend on the chip used.
+
 		RW
 
-pwm[1-*]_auto_point[1-*]_pwm
-pwm[1-*]_auto_point[1-*]_temp
-pwm[1-*]_auto_point[1-*]_temp_hyst
-		Define the PWM vs temperature curve. Number of trip points is
-		chip-dependent. Use this for chips which associate trip points
-		to PWM output channels.
+`pwm[1-*]_auto_point[1-*]_pwm` / `pwm[1-*]_auto_point[1-*]_temp` / `pwm[1-*]_auto_point[1-*]_temp_hyst`
+		Define the PWM vs temperature curve.
+
+		Number of trip points is chip-dependent. Use this for chips
+		which associate trip points to PWM output channels.
+
 		RW
 
-temp[1-*]_auto_point[1-*]_pwm
-temp[1-*]_auto_point[1-*]_temp
-temp[1-*]_auto_point[1-*]_temp_hyst
-		Define the PWM vs temperature curve. Number of trip points is
-		chip-dependent. Use this for chips which associate trip points
-		to temperature channels.
+`temp[1-*]_auto_point[1-*]_pwm` / `temp[1-*]_auto_point[1-*]_temp` / `temp[1-*]_auto_point[1-*]_temp_hyst`
+		Define the PWM vs temperature curve.
+
+		Number of trip points is chip-dependent. Use this for chips
+		which associate trip points to temperature channels.
+
 		RW
 
 There is a third case where trip points are associated to both PWM output
@@ -312,122 +405,173 @@ The actual result is up to the chip, but in general the highest candidate
 value (fastest fan speed) wins.
 
 
-****************
-* Temperatures *
-****************
+************
+Temperatures
+************
+
+`temp[1-*]_type`
+		Sensor type selection.
 
-temp[1-*]_type	Sensor type selection.
 		Integers 1 to 6
+
 		RW
-		1: CPU embedded diode
-		2: 3904 transistor
-		3: thermal diode
-		4: thermistor
-		5: AMD AMDSI
-		6: Intel PECI
+
+		- 1: CPU embedded diode
+		- 2: 3904 transistor
+		- 3: thermal diode
+		- 4: thermistor
+		- 5: AMD AMDSI
+		- 6: Intel PECI
+
 		Not all types are supported by all chips
 
-temp[1-*]_max	Temperature max value.
+`temp[1-*]_max`
+		Temperature max value.
+
 		Unit: millidegree Celsius (or millivolt, see below)
+
 		RW
 
-temp[1-*]_min	Temperature min value.
+`temp[1-*]_min`
+		Temperature min value.
+
 		Unit: millidegree Celsius
+
 		RW
 
-temp[1-*]_max_hyst
+`temp[1-*]_max_hyst`
 		Temperature hysteresis value for max limit.
+
 		Unit: millidegree Celsius
+
 		Must be reported as an absolute temperature, NOT a delta
 		from the max value.
+
 		RW
 
-temp[1-*]_min_hyst
+`temp[1-*]_min_hyst`
 		Temperature hysteresis value for min limit.
 		Unit: millidegree Celsius
+
 		Must be reported as an absolute temperature, NOT a delta
 		from the min value.
+
 		RW
 
-temp[1-*]_input Temperature input value.
+`temp[1-*]_input`
+	 Temperature input value.
+
 		Unit: millidegree Celsius
+
 		RO
 
-temp[1-*]_crit	Temperature critical max value, typically greater than
+`temp[1-*]_crit`
+		Temperature critical max value, typically greater than
 		corresponding temp_max values.
+
 		Unit: millidegree Celsius
+
 		RW
 
-temp[1-*]_crit_hyst
+`temp[1-*]_crit_hyst`
 		Temperature hysteresis value for critical limit.
+
 		Unit: millidegree Celsius
+
 		Must be reported as an absolute temperature, NOT a delta
 		from the critical value.
+
 		RW
 
-temp[1-*]_emergency
+`temp[1-*]_emergency`
 		Temperature emergency max value, for chips supporting more than
 		two upper temperature limits. Must be equal or greater than
 		corresponding temp_crit values.
+
 		Unit: millidegree Celsius
+
 		RW
 
-temp[1-*]_emergency_hyst
+`temp[1-*]_emergency_hyst`
 		Temperature hysteresis value for emergency limit.
+
 		Unit: millidegree Celsius
+
 		Must be reported as an absolute temperature, NOT a delta
 		from the emergency value.
+
 		RW
 
-temp[1-*]_lcrit	Temperature critical min value, typically lower than
+`temp[1-*]_lcrit`
+		Temperature critical min value, typically lower than
 		corresponding temp_min values.
+
 		Unit: millidegree Celsius
+
 		RW
 
-temp[1-*]_lcrit_hyst
+`temp[1-*]_lcrit_hyst`
 		Temperature hysteresis value for critical min limit.
+
 		Unit: millidegree Celsius
+
 		Must be reported as an absolute temperature, NOT a delta
 		from the critical min value.
+
 		RW
 
-temp[1-*]_offset
+`temp[1-*]_offset`
 		Temperature offset which is added to the temperature reading
 		by the chip.
+
 		Unit: millidegree Celsius
+
 		Read/Write value.
 
-temp[1-*]_label	Suggested temperature channel label.
+`temp[1-*]_label`
+		Suggested temperature channel label.
+
 		Text string
+
 		Should only be created if the driver has hints about what
 		this temperature channel is being used for, and user-space
 		doesn't. In all other cases, the label is provided by
 		user-space.
+
 		RO
 
-temp[1-*]_lowest
+`temp[1-*]_lowest`
 		Historical minimum temperature
+
 		Unit: millidegree Celsius
+
 		RO
 
-temp[1-*]_highest
+`temp[1-*]_highest`
 		Historical maximum temperature
+
 		Unit: millidegree Celsius
+
 		RO
 
-temp[1-*]_reset_history
+`temp[1-*]_reset_history`
 		Reset temp_lowest and temp_highest
+
 		WO
 
-temp_reset_history
+`temp_reset_history`
 		Reset temp_lowest and temp_highest for all sensors
+
 		WO
 
-temp[1-*]_enable
+`temp[1-*]_enable`
 		Enable or disable the sensors.
+
 		When disabled the sensor read will return -ENODATA.
-		1: Enable
-		0: Disable
+
+		- 1: Enable
+		- 0: Disable
+
 		RW
 
 Some chips measure temperature using external thermistors and an ADC, and
@@ -442,201 +586,300 @@ channels by the driver.
 Also see the Alarms section for status flags associated with temperatures.
 
 
-************
-* Currents *
-************
+********
+Currents
+********
+
+`curr[1-*]_max`
+		Current max value
 
-curr[1-*]_max	Current max value
 		Unit: milliampere
+
 		RW
 
-curr[1-*]_min	Current min value.
+`curr[1-*]_min`
+		Current min value.
+
 		Unit: milliampere
+
 		RW
 
-curr[1-*]_lcrit	Current critical low value
+`curr[1-*]_lcrit`
+		Current critical low value
+
 		Unit: milliampere
+
 		RW
 
-curr[1-*]_crit	Current critical high value.
+`curr[1-*]_crit`
+		Current critical high value.
+
 		Unit: milliampere
+
 		RW
 
-curr[1-*]_input	Current input value
+`curr[1-*]_input`
+		Current input value
+
 		Unit: milliampere
+
 		RO
 
-curr[1-*]_average
+`curr[1-*]_average`
 		Average current use
+
 		Unit: milliampere
+
 		RO
 
-curr[1-*]_lowest
+`curr[1-*]_lowest`
 		Historical minimum current
+
 		Unit: milliampere
+
 		RO
 
-curr[1-*]_highest
+`curr[1-*]_highest`
 		Historical maximum current
 		Unit: milliampere
 		RO
 
-curr[1-*]_reset_history
+`curr[1-*]_reset_history`
 		Reset currX_lowest and currX_highest
+
 		WO
 
-curr_reset_history
+`curr_reset_history`
 		Reset currX_lowest and currX_highest for all sensors
+
 		WO
 
-curr[1-*]_enable
+`curr[1-*]_enable`
 		Enable or disable the sensors.
+
 		When disabled the sensor read will return -ENODATA.
-		1: Enable
-		0: Disable
+
+		- 1: Enable
+		- 0: Disable
+
 		RW
 
 Also see the Alarms section for status flags associated with currents.
 
-*********
-* Power *
-*********
+*****
+Power
+*****
+
+`power[1-*]_average`
+				Average power use
 
-power[1-*]_average		Average power use
 				Unit: microWatt
+
 				RO
 
-power[1-*]_average_interval	Power use averaging interval.  A poll
+`power[1-*]_average_interval`
+				Power use averaging interval.  A poll
 				notification is sent to this file if the
 				hardware changes the averaging interval.
+
 				Unit: milliseconds
+
 				RW
 
-power[1-*]_average_interval_max	Maximum power use averaging interval
+`power[1-*]_average_interval_max`
+				Maximum power use averaging interval
+
 				Unit: milliseconds
+
 				RO
 
-power[1-*]_average_interval_min	Minimum power use averaging interval
+`power[1-*]_average_interval_min`
+				Minimum power use averaging interval
+
 				Unit: milliseconds
+
 				RO
 
-power[1-*]_average_highest	Historical average maximum power use
+`power[1-*]_average_highest`
+				Historical average maximum power use
+
 				Unit: microWatt
+
 				RO
 
-power[1-*]_average_lowest	Historical average minimum power use
+`power[1-*]_average_lowest`
+				Historical average minimum power use
+
 				Unit: microWatt
+
 				RO
 
-power[1-*]_average_max		A poll notification is sent to
-				power[1-*]_average when power use
+`power[1-*]_average_max`
+				A poll notification is sent to
+				`power[1-*]_average` when power use
 				rises above this value.
+
 				Unit: microWatt
+
 				RW
 
-power[1-*]_average_min		A poll notification is sent to
-				power[1-*]_average when power use
+`power[1-*]_average_min`
+				A poll notification is sent to
+				`power[1-*]_average` when power use
 				sinks below this value.
+
 				Unit: microWatt
+
 				RW
 
-power[1-*]_input		Instantaneous power use
+`power[1-*]_input`
+				Instantaneous power use
+
 				Unit: microWatt
+
 				RO
 
-power[1-*]_input_highest	Historical maximum power use
+`power[1-*]_input_highest`
+				Historical maximum power use
+
 				Unit: microWatt
+
 				RO
 
-power[1-*]_input_lowest		Historical minimum power use
+`power[1-*]_input_lowest`
+				Historical minimum power use
+
 				Unit: microWatt
+
 				RO
 
-power[1-*]_reset_history	Reset input_highest, input_lowest,
+`power[1-*]_reset_history`
+				Reset input_highest, input_lowest,
 				average_highest and average_lowest.
+
 				WO
 
-power[1-*]_accuracy		Accuracy of the power meter.
+`power[1-*]_accuracy`
+				Accuracy of the power meter.
+
 				Unit: Percent
+
 				RO
 
-power[1-*]_cap			If power use rises above this limit, the
+`power[1-*]_cap`
+				If power use rises above this limit, the
 				system should take action to reduce power use.
 				A poll notification is sent to this file if the
-				cap is changed by the hardware.  The *_cap
+				cap is changed by the hardware.  The `*_cap`
 				files only appear if the cap is known to be
 				enforced by hardware.
+
 				Unit: microWatt
+
 				RW
 
-power[1-*]_cap_hyst		Margin of hysteresis built around capping and
+`power[1-*]_cap_hyst`
+				Margin of hysteresis built around capping and
 				notification.
+
 				Unit: microWatt
+
 				RW
 
-power[1-*]_cap_max		Maximum cap that can be set.
+`power[1-*]_cap_max`
+				Maximum cap that can be set.
+
 				Unit: microWatt
+
 				RO
 
-power[1-*]_cap_min		Minimum cap that can be set.
+`power[1-*]_cap_min`
+				Minimum cap that can be set.
+
 				Unit: microWatt
+
 				RO
 
-power[1-*]_max			Maximum power.
+`power[1-*]_max`
+				Maximum power.
+
 				Unit: microWatt
+
 				RW
 
-power[1-*]_crit			Critical maximum power.
+`power[1-*]_crit`
+				Critical maximum power.
+
 				If power rises to or above this limit, the
 				system is expected take drastic action to reduce
 				power consumption, such as a system shutdown or
 				a forced powerdown of some devices.
+
 				Unit: microWatt
+
 				RW
 
-power[1-*]_enable		Enable or disable the sensors.
+`power[1-*]_enable`
+				Enable or disable the sensors.
+
 				When disabled the sensor read will return
 				-ENODATA.
-				1: Enable
-				0: Disable
+
+				- 1: Enable
+				- 0: Disable
+
 				RW
 
 Also see the Alarms section for status flags associated with power readings.
 
-**********
-* Energy *
-**********
+******
+Energy
+******
+
+`energy[1-*]_input`
+				Cumulative energy use
 
-energy[1-*]_input		Cumulative energy use
 				Unit: microJoule
+
 				RO
 
-energy[1-*]_enable		Enable or disable the sensors.
+`energy[1-*]_enable`
+				Enable or disable the sensors.
+
 				When disabled the sensor read will return
 				-ENODATA.
-				1: Enable
-				0: Disable
+
+				- 1: Enable
+				- 0: Disable
+
 				RW
 
-************
-* Humidity *
-************
+********
+Humidity
+********
+
+`humidity[1-*]_input`
+				Humidity
 
-humidity[1-*]_input		Humidity
 				Unit: milli-percent (per cent mille, pcm)
+
 				RO
 
 
-humidity[1-*]_enable		Enable or disable the sensors
+`humidity[1-*]_enable`
+				Enable or disable the sensors
+
 				When disabled the sensor read will return
 				-ENODATA.
-				1: Enable
-				0: Disable
+
+				- 1: Enable
+				- 0: Disable
+
 				RW
 
-**********
-* Alarms *
-**********
+******
+Alarms
+******
 
 Each channel or limit may have an associated alarm file, containing a
 boolean value. 1 means than an alarm condition exists, 0 means no alarm.
@@ -645,67 +888,67 @@ Usually a given chip will either use channel-related alarms, or
 limit-related alarms, not both. The driver should just reflect the hardware
 implementation.
 
-in[0-*]_alarm
-curr[1-*]_alarm
-power[1-*]_alarm
-fan[1-*]_alarm
-temp[1-*]_alarm
-		Channel alarm
-		0: no alarm
-		1: alarm
-		RO
++-------------------------------+-----------------------+
+| **`in[0-*]_alarm`,		| Channel alarm		|
+| `curr[1-*]_alarm`,		|			|
+| `power[1-*]_alarm`,		|   - 0: no alarm	|
+| `fan[1-*]_alarm`,		|   - 1: alarm		|
+| `temp[1-*]_alarm`**		|			|
+|				|   RO			|
++-------------------------------+-----------------------+
 
-OR
+**OR**
 
-in[0-*]_min_alarm
-in[0-*]_max_alarm
-in[0-*]_lcrit_alarm
-in[0-*]_crit_alarm
-curr[1-*]_min_alarm
-curr[1-*]_max_alarm
-curr[1-*]_lcrit_alarm
-curr[1-*]_crit_alarm
-power[1-*]_cap_alarm
-power[1-*]_max_alarm
-power[1-*]_crit_alarm
-fan[1-*]_min_alarm
-fan[1-*]_max_alarm
-temp[1-*]_min_alarm
-temp[1-*]_max_alarm
-temp[1-*]_lcrit_alarm
-temp[1-*]_crit_alarm
-temp[1-*]_emergency_alarm
-		Limit alarm
-		0: no alarm
-		1: alarm
-		RO
++-------------------------------+-----------------------+
+| **`in[0-*]_min_alarm`,	| Limit alarm		|
+| `in[0-*]_max_alarm`,		|			|
+| `in[0-*]_lcrit_alarm`,	|   - 0: no alarm	|
+| `in[0-*]_crit_alarm`,		|   - 1: alarm		|
+| `curr[1-*]_min_alarm`,	|			|
+| `curr[1-*]_max_alarm`,	| RO			|
+| `curr[1-*]_lcrit_alarm`,	|			|
+| `curr[1-*]_crit_alarm`,	|			|
+| `power[1-*]_cap_alarm`,	|			|
+| `power[1-*]_max_alarm`,	|			|
+| `power[1-*]_crit_alarm`,	|			|
+| `fan[1-*]_min_alarm`,		|			|
+| `fan[1-*]_max_alarm`,		|			|
+| `temp[1-*]_min_alarm`,	|			|
+| `temp[1-*]_max_alarm`,	|			|
+| `temp[1-*]_lcrit_alarm`,	|			|
+| `temp[1-*]_crit_alarm`,	|			|
+| `temp[1-*]_emergency_alarm`**	|			|
++-------------------------------+-----------------------+
 
 Each input channel may have an associated fault file. This can be used
 to notify open diodes, unconnected fans etc. where the hardware
 supports it. When this boolean has value 1, the measurement for that
 channel should not be trusted.
 
-fan[1-*]_fault
-temp[1-*]_fault
+`fan[1-*]_fault` / `temp[1-*]_fault`
 		Input fault condition
-		0: no fault occurred
-		1: fault condition
+
+		- 0: no fault occurred
+		- 1: fault condition
+
 		RO
 
 Some chips also offer the possibility to get beeped when an alarm occurs:
 
-beep_enable	Master beep enable
-		0: no beeps
-		1: beeps
+`beep_enable`
+		Master beep enable
+
+		- 0: no beeps
+		- 1: beeps
+
 		RW
 
-in[0-*]_beep
-curr[1-*]_beep
-fan[1-*]_beep
-temp[1-*]_beep
+`in[0-*]_beep`, `curr[1-*]_beep`, `fan[1-*]_beep`, `temp[1-*]_beep`,
 		Channel beep
-		0: disable
-		1: enable
+
+		- 0: disable
+		- 1: enable
+
 		RW
 
 In theory, a chip could provide per-limit beep masking, but no such chip
@@ -715,45 +958,57 @@ Old drivers provided a different, non-standard interface to alarms and
 beeps. These interface files are deprecated, but will be kept around
 for compatibility reasons:
 
-alarms		Alarm bitmask.
+`alarms`
+		Alarm bitmask.
+
 		RO
+
 		Integer representation of one to four 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. For this reason, the use of this
 		interface file for new drivers is discouraged. Use
-		individual *_alarm and *_fault files instead.
+		`individual *_alarm` and `*_fault` files instead.
 		Bits are defined in kernel/include/sensors.h.
 
-beep_mask	Bitmask for beep.
+`beep_mask`
+		Bitmask for beep.
 		Same format as 'alarms' with the same bit locations,
 		use discouraged for the same reason. Use individual
-		*_beep files instead.
+		`*_beep` files instead.
 		RW
 
 
-***********************
-* Intrusion detection *
-***********************
+*******************
+Intrusion detection
+*******************
 
-intrusion[0-*]_alarm
+`intrusion[0-*]_alarm`
 		Chassis intrusion detection
-		0: OK
-		1: intrusion detected
+
+		- 0: OK
+		- 1: intrusion detected
+
 		RW
+
 		Contrary to regular alarm flags which clear themselves
 		automatically when read, this one sticks until cleared by
 		the user. This is done by writing 0 to the file. Writing
 		other values is unsupported.
 
-intrusion[0-*]_beep
+`intrusion[0-*]_beep`
 		Chassis intrusion beep
+
 		0: disable
 		1: enable
+
 		RW
 
 
@@ -762,9 +1017,10 @@ sysfs attribute writes interpretation
 
 hwmon sysfs attributes always contain numbers, so the first thing to do is to
 convert the input to a number, there are 2 ways todo this depending whether
-the number can be negative or not:
-unsigned long u = simple_strtoul(buf, NULL, 10);
-long s = simple_strtol(buf, NULL, 10);
+the number can be negative or not::
+
+	unsigned long u = simple_strtoul(buf, NULL, 10);
+	long s = simple_strtol(buf, NULL, 10);
 
 With buf being the buffer with the user input being passed by the kernel.
 Notice that we do not use the second argument of strto[u]l, and thus cannot
@@ -789,13 +1045,13 @@ limits using clamp_val(value, min_limit, max_limit). If it is not continuous
 like for example a tempX_type, then when an invalid value is written,
 -EINVAL should be returned.
 
-Example1, temp1_max, register is a signed 8 bit value (-128 - 127 degrees):
+Example1, temp1_max, register is a signed 8 bit value (-128 - 127 degrees)::
 
 	long v = simple_strtol(buf, NULL, 10) / 1000;
 	v = clamp_val(v, -128, 127);
 	/* write v to register */
 
-Example2, fan divider setting, valid values 2, 4 and 8:
+Example2, fan divider setting, valid values 2, 4 and 8::
 
 	unsigned long v = simple_strtoul(buf, NULL, 10);
 
diff --git a/Documentation/hwmon/tc654 b/Documentation/hwmon/tc654
index 47636a8077b4..ce546ee6dfed 100644
--- a/Documentation/hwmon/tc654
+++ b/Documentation/hwmon/tc654
@@ -2,13 +2,16 @@ Kernel driver tc654
 ===================
 
 Supported chips:
+
   * Microchip TC654 and TC655
+
     Prefix: 'tc654'
-    Datasheet: http://ww1.microchip.com/downloads/en/DeviceDoc/20001734C.pdf
+    Datasheet: http://ww1.m
+    icrochip.com/downloads/en/DeviceDoc/20001734C.pdf
 
 Authors:
-        Chris Packham <chris.packham@alliedtelesis.co.nz>
-        Masahiko Iwamoto <iwamoto@allied-telesis.co.jp>
+      - Chris Packham <chris.packham@alliedtelesis.co.nz>
+      - Masahiko Iwamoto <iwamoto@allied-telesis.co.jp>
 
 Description
 -----------
diff --git a/Documentation/hwmon/tc74 b/Documentation/hwmon/tc74
index 43027aad5f8e..f1764211c129 100644
--- a/Documentation/hwmon/tc74
+++ b/Documentation/hwmon/tc74
@@ -2,8 +2,11 @@ Kernel driver tc74
 ====================
 
 Supported chips:
+
    * Microchip TC74
+
      Prefix: 'tc74'
+
      Datasheet: Publicly available at Microchip website.
 
 Description
diff --git a/Documentation/hwmon/thmc50 b/Documentation/hwmon/thmc50
index 8a7772ade8d0..6dba1b59b20c 100644
--- a/Documentation/hwmon/thmc50
+++ b/Documentation/hwmon/thmc50
@@ -2,30 +2,41 @@ Kernel driver thmc50
 =====================
 
 Supported chips:
+
   * Analog Devices ADM1022
+
     Prefix: 'adm1022'
+
     Addresses scanned: I2C 0x2c - 0x2e
+
     Datasheet: http://www.analog.com/en/prod/0,2877,ADM1022,00.html
+
   * Texas Instruments THMC50
+
     Prefix: 'thmc50'
+
     Addresses scanned: I2C 0x2c - 0x2e
-    Datasheet: http://www.ti.com/ 
+
+    Datasheet: http://www.ti.com/
+
 
 Author: Krzysztof Helt <krzysztof.h1@wp.pl>
 
 This driver was derived from the 2.4 kernel thmc50.c source file.
 
 Credits:
+
   thmc50.c (2.4 kernel):
-	Frodo Looijaard <frodol@dds.nl>
-	Philip Edelbrock <phil@netroedge.com>
+
+	- Frodo Looijaard <frodol@dds.nl>
+	- Philip Edelbrock <phil@netroedge.com>
 
 Module Parameters
 -----------------
 
 * adm1022_temp3: short array
-  List of adapter,address pairs to force chips into ADM1022 mode with
-  second remote temperature. This does not work for original THMC50 chips.
+    List of adapter,address pairs to force chips into ADM1022 mode with
+    second remote temperature. This does not work for original THMC50 chips.
 
 Description
 -----------
@@ -59,12 +70,17 @@ Driver Features
 
 The driver provides up to three temperatures:
 
-temp1		-- internal
-temp2		-- remote
-temp3		-- 2nd remote only for ADM1022
+temp1
+	- internal
+temp2
+	- remote
+temp3
+	- 2nd remote only for ADM1022
 
-pwm1		-- fan speed (0 = stop, 255 = full)
-pwm1_mode	-- always 0 (DC mode)
+pwm1
+	- fan speed (0 = stop, 255 = full)
+pwm1_mode
+	- always 0 (DC mode)
 
 The value of 0 for pwm1 also forces FAN_OFF signal from the chip,
 so it stops fans even if the value 0 into the ANALOG_OUT register does not.
diff --git a/Documentation/hwmon/tmp102 b/Documentation/hwmon/tmp102
index 8454a7763122..5e34821df4ab 100644
--- a/Documentation/hwmon/tmp102
+++ b/Documentation/hwmon/tmp102
@@ -2,12 +2,17 @@ Kernel driver tmp102
 ====================
 
 Supported chips:
+
   * Texas Instruments TMP102
+
     Prefix: 'tmp102'
+
     Addresses scanned: none
+
     Datasheet: http://focus.ti.com/docs/prod/folders/print/tmp102.html
 
 Author:
+
 	Steven King <sfking@fdwdc.com>
 
 Description
diff --git a/Documentation/hwmon/tmp103 b/Documentation/hwmon/tmp103
index ec00a15645ba..7682a795e38c 100644
--- a/Documentation/hwmon/tmp103
+++ b/Documentation/hwmon/tmp103
@@ -2,12 +2,17 @@ Kernel driver tmp103
 ====================
 
 Supported chips:
+
   * Texas Instruments TMP103
+
     Prefix: 'tmp103'
+
     Addresses scanned: none
+
     Product info and datasheet: http://www.ti.com/product/tmp103
 
 Author:
+
 	Heiko Schocher <hs@denx.de>
 
 Description
diff --git a/Documentation/hwmon/tmp108 b/Documentation/hwmon/tmp108
index 25802df23010..7e08b7ef1e2f 100644
--- a/Documentation/hwmon/tmp108
+++ b/Documentation/hwmon/tmp108
@@ -2,12 +2,17 @@ Kernel driver tmp108
 ====================
 
 Supported chips:
+
   * Texas Instruments TMP108
+
     Prefix: 'tmp108'
+
     Addresses scanned: none
+
     Datasheet: http://www.ti.com/product/tmp108
 
 Author:
+
 	John Muir <john@jmuir.com>
 
 Description
diff --git a/Documentation/hwmon/tmp421 b/Documentation/hwmon/tmp421
index 9e6fe5549ca1..1ba926a3605c 100644
--- a/Documentation/hwmon/tmp421
+++ b/Documentation/hwmon/tmp421
@@ -2,28 +2,49 @@ Kernel driver tmp421
 ====================
 
 Supported chips:
+
   * Texas Instruments TMP421
+
     Prefix: 'tmp421'
+
     Addresses scanned: I2C 0x2a, 0x4c, 0x4d, 0x4e and 0x4f
+
     Datasheet: http://focus.ti.com/docs/prod/folders/print/tmp421.html
+
   * Texas Instruments TMP422
+
     Prefix: 'tmp422'
+
     Addresses scanned: I2C 0x4c, 0x4d, 0x4e and 0x4f
+
     Datasheet: http://focus.ti.com/docs/prod/folders/print/tmp421.html
+
   * Texas Instruments TMP423
+
     Prefix: 'tmp423'
+
     Addresses scanned: I2C 0x4c and 0x4d
+
     Datasheet: http://focus.ti.com/docs/prod/folders/print/tmp421.html
+
   * Texas Instruments TMP441
+
     Prefix: 'tmp441'
+
     Addresses scanned: I2C 0x2a, 0x4c, 0x4d, 0x4e and 0x4f
+
     Datasheet: http://www.ti.com/product/tmp441
+
   * Texas Instruments TMP442
+
     Prefix: 'tmp442'
+
     Addresses scanned: I2C 0x4c and 0x4d
+
     Datasheet: http://www.ti.com/product/tmp442
 
 Authors:
+
 	Andre Prendel <andre.prendel@gmx.de>
 
 Description
@@ -40,5 +61,6 @@ for both the local and remote channels is 0.0625 degree C.
 The chips support only temperature measurement. The driver exports
 the temperature values via the following sysfs files:
 
-temp[1-4]_input
-temp[2-4]_fault
+**temp[1-4]_input**
+
+**temp[2-4]_fault**
diff --git a/Documentation/hwmon/twl4030-madc-hwmon b/Documentation/hwmon/twl4030-madc-hwmon
index c3a3a5be10ad..22c885383b11 100644
--- a/Documentation/hwmon/twl4030-madc-hwmon
+++ b/Documentation/hwmon/twl4030-madc-hwmon
@@ -1,8 +1,10 @@
 Kernel driver twl4030-madc
-=========================
+==========================
 
 Supported chips:
+
 	* Texas Instruments TWL4030
+
 	Prefix: 'twl4030-madc'
 
 
@@ -19,8 +21,9 @@ channels which can be used in different modes.
 
 See this table for the meaning of the different channels
 
+======= ==========================================================
 Channel Signal
-------------------------------------------
+======= ==========================================================
 0	Battery type(BTYPE)
 1	BCI: Battery temperature (BTEMP)
 2	GP analog input
@@ -37,6 +40,7 @@ Channel Signal
 13	Reserved
 14	Reserved
 15	VRUSB Supply/Speaker left/Speaker right polarization level
+======= ==========================================================
 
 
 The Sysfs nodes will represent the voltage in the units of mV,
diff --git a/Documentation/hwmon/userspace-tools b/Documentation/hwmon/userspace-tools
index 9865aeedc58f..bf3797c8e734 100644
--- a/Documentation/hwmon/userspace-tools
+++ b/Documentation/hwmon/userspace-tools
@@ -1,3 +1,6 @@
+Userspace tools
+===============
+
 Introduction
 ------------
 
diff --git a/Documentation/hwmon/via686a b/Documentation/hwmon/via686a
index e5f90ab5c48d..a343c35df740 100644
--- a/Documentation/hwmon/via686a
+++ b/Documentation/hwmon/via686a
@@ -2,29 +2,35 @@ Kernel driver via686a
 =====================
 
 Supported chips:
+
   * Via VT82C686A, VT82C686B  Southbridge Integrated Hardware Monitor
+
     Prefix: 'via686a'
+
     Addresses scanned: ISA in PCI-space encoded address
+
     Datasheet: On request through web form (http://www.via.com.tw/en/resources/download-center/)
 
 Authors:
-        Kyösti Mälkki <kmalkki@cc.hut.fi>,
-        Mark D. Studebaker <mdsxyz123@yahoo.com>
-        Bob Dougherty <bobd@stanford.edu>
-        (Some conversion-factor data were contributed by
-        Jonathan Teh Soon Yew <j.teh@iname.com>
-        and Alex van Kaam <darkside@chello.nl>.)
+	- Kyösti Mälkki <kmalkki@cc.hut.fi>,
+	- Mark D. Studebaker <mdsxyz123@yahoo.com>
+	- Bob Dougherty <bobd@stanford.edu>
+	- (Some conversion-factor data were contributed by
+	- Jonathan Teh Soon Yew <j.teh@iname.com>
+	- and Alex van Kaam <darkside@chello.nl>.)
 
 Module Parameters
 -----------------
 
+======================= =======================================================
 force_addr=0xaddr       Set the I/O base address. Useful for boards that
-                        don't set the address in the BIOS. Look for a BIOS
-                        upgrade before resorting to this. Does not do a
-                        PCI force; the via686a must still be present in lspci.
-                        Don't use this unless the driver complains that the
-                        base address is not set.
-                        Example: 'modprobe via686a force_addr=0x6000'
+			don't set the address in the BIOS. Look for a BIOS
+			upgrade before resorting to this. Does not do a
+			PCI force; the via686a must still be present in lspci.
+			Don't use this unless the driver complains that the
+			base address is not set.
+			Example: 'modprobe via686a force_addr=0x6000'
+======================= =======================================================
 
 Description
 -----------
diff --git a/Documentation/hwmon/w83627ehf b/Documentation/hwmon/w83627ehf
index 735c42a85ead..74d19ef11e1f 100644
--- a/Documentation/hwmon/w83627ehf
+++ b/Documentation/hwmon/w83627ehf
@@ -2,45 +2,79 @@ Kernel driver w83627ehf
 =======================
 
 Supported chips:
+
   * Winbond W83627EHF/EHG (ISA access ONLY)
+
     Prefix: 'w83627ehf'
+
     Addresses scanned: ISA address retrieved from Super I/O registers
+
     Datasheet: not available
+
   * Winbond W83627DHG
+
     Prefix: 'w83627dhg'
+
     Addresses scanned: ISA address retrieved from Super I/O registers
+
     Datasheet: not available
+
   * Winbond W83627DHG-P
+
     Prefix: 'w83627dhg'
+
     Addresses scanned: ISA address retrieved from Super I/O registers
+
     Datasheet: not available
+
   * Winbond W83627UHG
+
     Prefix: 'w83627uhg'
+
     Addresses scanned: ISA address retrieved from Super I/O registers
+
     Datasheet: available from www.nuvoton.com
+
   * Winbond W83667HG
+
     Prefix: 'w83667hg'
+
     Addresses scanned: ISA address retrieved from Super I/O registers
+
     Datasheet: not available
+
   * Winbond W83667HG-B
+
     Prefix: 'w83667hg'
+
     Addresses scanned: ISA address retrieved from Super I/O registers
+
     Datasheet: Available from Nuvoton upon request
+
   * Nuvoton NCT6775F/W83667HG-I
+
     Prefix: 'nct6775'
+
     Addresses scanned: ISA address retrieved from Super I/O registers
+
     Datasheet: Available from Nuvoton upon request
+
   * Nuvoton NCT6776F
+
     Prefix: 'nct6776'
+
     Addresses scanned: ISA address retrieved from Super I/O registers
+
     Datasheet: Available from Nuvoton upon request
 
+
 Authors:
-        Jean Delvare <jdelvare@suse.de>
-        Yuan Mu (Winbond)
-        Rudolf Marek <r.marek@assembler.cz>
-        David Hubbard <david.c.hubbard@gmail.com>
-        Gong Jun <JGong@nuvoton.com>
+
+	- Jean Delvare <jdelvare@suse.de>
+	- Yuan Mu (Winbond)
+	- Rudolf Marek <r.marek@assembler.cz>
+	- David Hubbard <david.c.hubbard@gmail.com>
+	- Gong Jun <JGong@nuvoton.com>
 
 Description
 -----------
@@ -85,25 +119,30 @@ predefined temperature range. If the temperature goes out of range, fan
 is driven slower/faster to reach the predefined range again.
 
 The mode works for fan1-fan4. Mapping of temperatures to pwm outputs is as
-follows:
+follows::
 
-temp1 -> pwm1
-temp2 -> pwm2
-temp3 -> pwm3 (not on 627UHG)
-prog  -> pwm4 (not on 667HG and 667HG-B; the programmable setting is not
-	       supported by the driver)
+  temp1 -> pwm1
+  temp2 -> pwm2
+  temp3 -> pwm3 (not on 627UHG)
+  prog  -> pwm4 (not on 667HG and 667HG-B; the programmable setting is not
+		 supported by the driver)
 
 /sys files
 ----------
 
-name - this is a standard hwmon device entry, it contains the name of
-       the device (see the prefix in the list of supported devices at
-       the top of this file)
+name
+	this is a standard hwmon device entry, it contains the name of
+	the device (see the prefix in the list of supported devices at
+	the top of this file)
+
+pwm[1-4]
+	this file stores PWM duty cycle or DC value (fan speed) in range:
 
-pwm[1-4] - this file stores PWM duty cycle or DC value (fan speed) in range:
 	   0 (stop) to 255 (full)
 
-pwm[1-4]_enable - this file controls mode of fan/temperature control:
+pwm[1-4]_enable
+	this file controls mode of fan/temperature control:
+
 	* 1 Manual mode, write to pwm file any value 0-255 (full speed)
 	* 2 "Thermal Cruise" mode
 	* 3 "Fan Speed Cruise" mode
@@ -121,33 +160,43 @@ pwm[1-4]_enable - this file controls mode of fan/temperature control:
 	returned when reading pwm attributes is unrelated to SmartFan IV
 	operation.
 
-pwm[1-4]_mode - controls if output is PWM or DC level
-        * 0 DC output (0 - 12v)
-        * 1 PWM output
+pwm[1-4]_mode
+	controls if output is PWM or DC level
+
+	* 0 DC output (0 - 12v)
+	* 1 PWM output
 
 Thermal Cruise mode
 -------------------
 
 If the temperature is in the range defined by:
 
-pwm[1-4]_target    - set target temperature, unit millidegree Celsius
-		     (range 0 - 127000)
-pwm[1-4]_tolerance - tolerance, unit millidegree Celsius (range 0 - 15000)
+pwm[1-4]_target
+		   set target temperature, unit millidegree Celsius
+		   (range 0 - 127000)
+pwm[1-4]_tolerance
+		   tolerance, unit millidegree Celsius (range 0 - 15000)
 
 there are no changes to fan speed. Once the temperature leaves the interval,
 fan speed increases (temp is higher) or decreases if lower than desired.
 There are defined steps and times, but not exported by the driver yet.
 
-pwm[1-4]_min_output - minimum fan speed (range 1 - 255), when the temperature
-                      is below defined range.
-pwm[1-4]_stop_time  - how many milliseconds [ms] must elapse to switch
-                      corresponding fan off. (when the temperature was below
-                      defined range).
-pwm[1-4]_start_output-minimum fan speed (range 1 - 255) when spinning up
-pwm[1-4]_step_output- rate of fan speed change (1 - 255)
-pwm[1-4]_stop_output- minimum fan speed (range 1 - 255) when spinning down
-pwm[1-4]_max_output - maximum fan speed (range 1 - 255), when the temperature
-                      is above defined range.
+pwm[1-4]_min_output
+		   minimum fan speed (range 1 - 255), when the temperature
+		   is below defined range.
+pwm[1-4]_stop_time
+		   how many milliseconds [ms] must elapse to switch
+		   corresponding fan off. (when the temperature was below
+		   defined range).
+pwm[1-4]_start_output
+		   minimum fan speed (range 1 - 255) when spinning up
+pwm[1-4]_step_output
+		   rate of fan speed change (1 - 255)
+pwm[1-4]_stop_output
+		   minimum fan speed (range 1 - 255) when spinning down
+pwm[1-4]_max_output
+		   maximum fan speed (range 1 - 255), when the temperature
+		   is above defined range.
 
 Note: last six functions are influenced by other control bits, not yet exported
       by the driver, so a change might not have any effect.
@@ -161,26 +210,35 @@ different power-on default values, but BIOS should already be loading
 appropriate defaults. Note that bank selection must be performed as is currently
 done in the driver for all register addresses.
 
-0x49:  only on DHG, selects temperature source for AUX fan, CPU fan0
-0x4a:  not completely documented for the EHF and the DHG documentation assigns
-       different behavior to bits 7 and 6, including extending the temperature
-       input selection to SmartFan I, not just SmartFan III. Testing on the EHF
-       will reveal whether they are compatible or not.
+========================= =====================================================
+Register(s)		  Meaning
+========================= =====================================================
+0x49                      only on DHG, selects temperature source for AUX fan,
+			  CPU fan0
+0x4a                      not completely documented for the EHF and the DHG
+			  documentation assigns different behavior to bits 7
+			  and 6, including extending the temperature input
+			  selection to SmartFan I, not just SmartFan III.
+			  Testing on the EHF will reveal whether they are
+			  compatible or not.
+0x58                      Chip ID: 0xa1=EHF 0xc1=DHG
+0x5e                      only on DHG, has bits to enable "current mode"
+			  temperature detection and critical temperature
+			  protection
+0x45b                     only on EHF, bit 3, vin4 alarm (EHF supports 10
+			  inputs, only 9 on DHG)
+0x552                     only on EHF, vin4
+0x558                     only on EHF, vin4 high limit
+0x559                     only on EHF, vin4 low limit
+0x6b                      only on DHG, SYS fan critical temperature
+0x6c                      only on DHG, CPU fan0 critical temperature
+0x6d                      only on DHG, AUX fan critical temperature
+0x6e                      only on DHG, CPU fan1 critical temperature
+0x50-0x55 and 0x650-0x657 marked as:
 
-0x58:  Chip ID: 0xa1=EHF 0xc1=DHG
-0x5e:  only on DHG, has bits to enable "current mode" temperature detection and
-       critical temperature protection
-0x45b: only on EHF, bit 3, vin4 alarm (EHF supports 10 inputs, only 9 on DHG)
-0x552: only on EHF, vin4
-0x558: only on EHF, vin4 high limit
-0x559: only on EHF, vin4 low limit
-0x6b:  only on DHG, SYS fan critical temperature
-0x6c:  only on DHG, CPU fan0 critical temperature
-0x6d:  only on DHG, AUX fan critical temperature
-0x6e:  only on DHG, CPU fan1 critical temperature
-
-0x50-0x55 and 0x650-0x657 are marked "Test Register" for the EHF, but "Reserved
-       Register" for the DHG
+			    - "Test Register" for the EHF
+			    - "Reserved Register" for the DHG
+========================= =====================================================
 
 The DHG also supports PECI, where the DHG queries Intel CPU temperatures, and
 the ICH8 southbridge gets that data via PECI from the DHG, so that the
diff --git a/Documentation/hwmon/w83627hf b/Documentation/hwmon/w83627hf
index 8432e1118173..d1406c28dee7 100644
--- a/Documentation/hwmon/w83627hf
+++ b/Documentation/hwmon/w83627hf
@@ -20,10 +20,10 @@ Supported chips:
     Datasheet: Provided by Winbond on request(http://www.winbond.com/hq/enu)
 
 Authors:
-        Frodo Looijaard <frodol@dds.nl>,
-        Philip Edelbrock <phil@netroedge.com>,
-        Mark Studebaker <mdsxyz123@yahoo.com>,
-        Bernhard C. Schrenk <clemy@clemy.org>
+	Frodo Looijaard <frodol@dds.nl>,
+	Philip Edelbrock <phil@netroedge.com>,
+	Mark Studebaker <mdsxyz123@yahoo.com>,
+	Bernhard C. Schrenk <clemy@clemy.org>
 
 Module Parameters
 -----------------
@@ -52,8 +52,8 @@ If you really want i2c accesses for these Super I/O chips,
 use the w83781d driver. However this is not the preferred method
 now that this ISA driver has been developed.
 
-The w83627_HF_ uses pins 110-106 as VID0-VID4. The w83627_THF_ uses the
-same pins as GPIO[0:4]. Technically, the w83627_THF_ does not support a
+The `w83627_HF_` uses pins 110-106 as VID0-VID4. The `w83627_THF_` uses the
+same pins as GPIO[0:4]. Technically, the `w83627_THF_` does not support a
 VID reading. However the two chips have the identical 128 pin package. So,
 it is possible or even likely for a w83627thf to have the VID signals routed
 to these pins despite their not being labeled for that purpose. Therefore,
@@ -75,19 +75,23 @@ module parameter is gone for technical reasons. If you need this feature,
 you can obtain the same result by using the isaset tool (part of
 lm-sensors) before loading the driver:
 
-# Enter the Super I/O config space
-isaset -y -f 0x2e 0x87
-isaset -y -f 0x2e 0x87
+# Enter the Super I/O config space::
 
-# Select the hwmon logical device
-isaset -y 0x2e 0x2f 0x07 0x0b
+	isaset -y -f 0x2e 0x87
+	isaset -y -f 0x2e 0x87
 
-# Set the base I/O address (to 0x290 in this example)
-isaset -y 0x2e 0x2f 0x60 0x02
-isaset -y 0x2e 0x2f 0x61 0x90
+# Select the hwmon logical device::
 
-# Exit the Super-I/O config space
-isaset -y -f 0x2e 0xaa
+	isaset -y 0x2e 0x2f 0x07 0x0b
+
+# Set the base I/O address (to 0x290 in this example)::
+
+	isaset -y 0x2e 0x2f 0x60 0x02
+	isaset -y 0x2e 0x2f 0x61 0x90
+
+# Exit the Super-I/O config space::
+
+	isaset -y -f 0x2e 0xaa
 
 The above sequence assumes a Super-I/O config space at 0x2e/0x2f, but
 0x4e/0x4f is also possible.
@@ -97,18 +101,23 @@ Voltage pin mapping
 
 Here is a summary of the voltage pin mapping for the W83627THF. This
 can be useful to convert data provided by board manufacturers into
-working libsensors configuration statements.
-
-    W83627THF		|
-  Pin	| Name		| Register	| Sysfs attribute
------------------------------------------------------
-  100	| CPUVCORE	| 20h		| in0
-   99	| VIN0		| 21h		| in1
-   98	| VIN1		| 22h		| in2
-   97	| VIN2		| 24h		| in4
-  114	| AVCC		| 23h		| in3
-   61	| 5VSB		| 50h (bank 5)	| in7
-   74	| VBAT		| 51h (bank 5)	| in8
+working libsensors configuration statements:
+
+
+- W83627THF
+
+
+  ======== =============== =============== ===============
+  Pin	   Name		   Register	   Sysfs attribute
+  ======== =============== =============== ===============
+    100	   CPUVCORE	   20h		   in0
+     99	   VIN0		   21h		   in1
+     98	   VIN1		   22h		   in2
+     97	   VIN2		   24h		   in4
+    114	   AVCC		   23h		   in3
+     61	   5VSB		   50h (bank 5)	   in7
+     74	   VBAT		   51h (bank 5)	   in8
+  ======== =============== =============== ===============
 
 For other supported devices, you'll have to take the hard path and
 look up the information in the datasheet yourself (and then add it
diff --git a/Documentation/hwmon/w83773g b/Documentation/hwmon/w83773g
index 4cc6c0b8257f..cabaed391414 100644
--- a/Documentation/hwmon/w83773g
+++ b/Documentation/hwmon/w83773g
@@ -1,13 +1,18 @@
 Kernel driver w83773g
-====================
+=====================
 
 Supported chips:
+
   * Nuvoton W83773G
+
     Prefix: 'w83773g'
+
     Addresses scanned: I2C 0x4c and 0x4d
+
     Datasheet: https://www.nuvoton.com/resource-files/W83773G_SG_DatasheetV1_2.pdf
 
 Authors:
+
 	Lei YU <mine260309@gmail.com>
 
 Description
@@ -27,7 +32,4 @@ Resolution for both the local and remote channels is 0.125 degree C.
 The chip supports only temperature measurement. The driver exports
 the temperature values via the following sysfs files:
 
-temp[1-3]_input
-temp[2-3]_fault
-temp[2-3]_offset
-update_interval
+**temp[1-3]_input, temp[2-3]_fault, temp[2-3]_offset, update_interval**
diff --git a/Documentation/hwmon/w83781d b/Documentation/hwmon/w83781d
index 129b0a3b555b..f36d33dfb704 100644
--- a/Documentation/hwmon/w83781d
+++ b/Documentation/hwmon/w83781d
@@ -2,44 +2,64 @@ Kernel driver w83781d
 =====================
 
 Supported chips:
+
   * Winbond W83781D
+
     Prefix: 'w83781d'
+
     Addresses scanned: I2C 0x28 - 0x2f, ISA 0x290 (8 I/O ports)
+
     Datasheet: http://www.winbond-usa.com/products/winbond_products/pdfs/PCIC/w83781d.pdf
+
   * Winbond W83782D
+
     Prefix: 'w83782d'
+
     Addresses scanned: I2C 0x28 - 0x2f, ISA 0x290 (8 I/O ports)
+
     Datasheet: http://www.winbond.com
+
   * Winbond W83783S
+
     Prefix: 'w83783s'
+
     Addresses scanned: I2C 0x2d
+
     Datasheet: http://www.winbond-usa.com/products/winbond_products/pdfs/PCIC/w83783s.pdf
+
   * Asus AS99127F
+
     Prefix: 'as99127f'
+
     Addresses scanned: I2C 0x28 - 0x2f
+
     Datasheet: Unavailable from Asus
 
+
+
 Authors:
-        Frodo Looijaard <frodol@dds.nl>,
-        Philip Edelbrock <phil@netroedge.com>,
-        Mark Studebaker <mdsxyz123@yahoo.com>
+
+      - Frodo Looijaard <frodol@dds.nl>,
+      - Philip Edelbrock <phil@netroedge.com>,
+      - Mark Studebaker <mdsxyz123@yahoo.com>
 
 Module parameters
 -----------------
 
 * init int
-  (default 1)
-  Use 'init=0' to bypass initializing the chip.
-  Try this if your computer crashes when you load the module.
+    (default 1)
+
+    Use 'init=0' to bypass initializing the chip.
+    Try this if your computer crashes when you load the module.
 
 * reset int
-  (default 0)
-  The driver used to reset the chip on load, but does no more. Use
-  'reset=1' to restore the old behavior. Report if you need to do this.
+    (default 0)
+    The driver used to reset the chip on load, but does no more. Use
+    'reset=1' to restore the old behavior. Report if you need to do this.
 
 force_subclients=bus,caddr,saddr,saddr
   This is used to force the i2c addresses for subclients of
-  a certain chip. Typical usage is `force_subclients=0,0x2d,0x4a,0x4b'
+  a certain chip. Typical usage is `force_subclients=0,0x2d,0x4a,0x4b`
   to force the subclients of chip 0x2d on bus 0 to i2c addresses
   0x4a and 0x4b. This parameter is useful for certain Tyan boards.
 
@@ -54,12 +74,19 @@ There is quite some difference between these chips, but they are similar
 enough that it was sensible to put them together in one driver.
 The Asus chips are similar to an I2C-only W83782D.
 
-Chip        #vin    #fanin  #pwm    #temp   wchipid vendid  i2c     ISA
-as99127f    7       3       0       3       0x31    0x12c3  yes     no
-as99127f rev.2 (type_name = as99127f)       0x31    0x5ca3  yes     no
-w83781d     7       3       0       3       0x10-1  0x5ca3  yes     yes
-w83782d     9       3       2-4     3       0x30    0x5ca3  yes     yes
-w83783s     5-6     3       2       1-2     0x40    0x5ca3  yes     no
++----------+---------+--------+-------+-------+---------+--------+------+-----+
+| Chip     | #vin    | #fanin | #pwm  | #temp | wchipid | vendid | i2c  | ISA |
++----------+---------+--------+-------+-------+---------+--------+------+-----+
+| as99127f | 7       | 3      | 0     | 3     | 0x31    | 0x12c3 | yes  |  no |
++----------+---------+--------+-------+-------+---------+--------+------+-----+
+| as99127f rev.2 (type_name = as99127f)       | 0x31    | 0x5ca3 | yes  |  no |
++----------+---------+--------+-------+-------+---------+--------+------+-----+
+| w83781d  | 7       | 3      | 0     | 3     | 0x10-1  | 0x5ca3 | yes  | yes |
++----------+---------+--------+-------+-------+---------+--------+------+-----+
+| w83782d  | 9       | 3      | 2-4   | 3     | 0x30    | 0x5ca3 | yes  | yes |
++----------+---------+--------+-------+-------+---------+--------+------+-----+
+| w83783s  | 5-6     | 3      | 2     |  1-2  | 0x40    | 0x5ca3 | yes  |  no |
++----------+---------+--------+-------+-------+---------+--------+------+-----+
 
 Detection of these chips can sometimes be foiled because they can be in
 an internal state that allows no clean access. If you know the address
@@ -124,22 +151,24 @@ or only the beeping for some alarms.
 
 Individual alarm and beep bits:
 
-0x000001: in0
-0x000002: in1
-0x000004: in2
-0x000008: in3
-0x000010: temp1
-0x000020: temp2 (+temp3 on W83781D)
-0x000040: fan1
-0x000080: fan2
-0x000100: in4
-0x000200: in5
-0x000400: in6
-0x000800: fan3
-0x001000: chassis
-0x002000: temp3 (W83782D only)
-0x010000: in7 (W83782D only)
-0x020000: in8 (W83782D only)
+======== ==========================
+0x000001 in0
+0x000002 in1
+0x000004 in2
+0x000008 in3
+0x000010 temp1
+0x000020 temp2 (+temp3 on W83781D)
+0x000040 fan1
+0x000080 fan2
+0x000100 in4
+0x000200 in5
+0x000400 in6
+0x000800 fan3
+0x001000 chassis
+0x002000 temp3 (W83782D only)
+0x010000 in7 (W83782D only)
+0x020000 in8 (W83782D only)
+======== ==========================
 
 If an alarm triggers, it will remain triggered until the hardware register
 is read at least once. This means that the cause for the alarm may
@@ -179,68 +208,74 @@ Please do not send mail to the author or the sensors group asking for
 a datasheet or ideas on how to convince Asus. We can't help.
 
 
-NOTES:
+NOTES
 -----
   783s has no in1 so that in[2-6] are compatible with the 781d/782d.
 
   783s pin is programmable for -5V or temp1; defaults to -5V,
-       no control in driver so temp1 doesn't work.
+  no control in driver so temp1 doesn't work.
 
   782d and 783s datasheets differ on which is pwm1 and which is pwm2.
-       We chose to follow 782d.
+  We chose to follow 782d.
 
   782d and 783s pin is programmable for fan3 input or pwm2 output;
-       defaults to fan3 input.
-       If pwm2 is enabled (with echo 255 1 > pwm2), then
-       fan3 will report 0.
+  defaults to fan3 input.
+  If pwm2 is enabled (with echo 255 1 > pwm2), then
+  fan3 will report 0.
 
   782d has pwm1-2 for ISA, pwm1-4 for i2c. (pwm3-4 share pins with
-       the ISA pins)
+  the ISA pins)
 
-Data sheet updates:
+Data sheet updates
 ------------------
 	- PWM clock registers:
-
-		000: master /  512
-		001: master / 1024
-		010: master / 2048
-		011: master / 4096
-		100: master / 8192
+		* 000: master /  512
+		* 001: master / 1024
+		* 010: master / 2048
+		* 011: master / 4096
+		* 100: master / 8192
 
 
 Answers from Winbond tech support
 ---------------------------------
->
-> 1) In the W83781D data sheet section 7.2 last paragraph, it talks about
->    reprogramming the R-T table if the Beta of the thermistor is not
->    3435K. The R-T table is described briefly in section 8.20.
->    What formulas do I use to program a new R-T table for a given Beta?
->
-	We are sorry that the calculation for R-T table value is
-confidential. If you have another Beta value of thermistor, we can help
-to calculate the R-T table for you. But you should give us real R-T
-Table which can be gotten by thermistor vendor. Therefore we will calculate
-them and obtain 32-byte data, and you can fill the 32-byte data to the
-register in Bank0.CR51 of W83781D.
 
+::
 
-> 2) In the W83782D data sheet, it mentions that pins 38, 39, and 40 are
->    programmable to be either thermistor or Pentium II diode inputs.
->    How do I program them for diode inputs? I can't find any register
->    to program these to be diode inputs.
- --> You may program Bank0 CR[5Dh] and CR[59h] registers.
+  >
+  > 1) In the W83781D data sheet section 7.2 last paragraph, it talks about
+  >    reprogramming the R-T table if the Beta of the thermistor is not
+  >    3435K. The R-T table is described briefly in section 8.20.
+  >    What formulas do I use to program a new R-T table for a given Beta?
+  >
 
- 	CR[5Dh]    		bit 1(VTIN1)    bit 2(VTIN2)   bit 3(VTIN3)
+  We are sorry that the calculation for R-T table value is
+  confidential. If you have another Beta value of thermistor, we can help
+  to calculate the R-T table for you. But you should give us real R-T
+  Table which can be gotten by thermistor vendor. Therefore we will calculate
+  them and obtain 32-byte data, and you can fill the 32-byte data to the
+  register in Bank0.CR51 of W83781D.
 
-      	thermistor                0		 0		0
- 	diode 		          1		 1		1
 
+  > 2) In the W83782D data sheet, it mentions that pins 38, 39, and 40 are
+  >    programmable to be either thermistor or Pentium II diode inputs.
+  >    How do I program them for diode inputs? I can't find any register
+  >    to program these to be diode inputs.
 
-(error) CR[59h] 		bit 4(VTIN1)	bit 2(VTIN2)   bit 3(VTIN3)
-(right) CR[59h] 		bit 4(VTIN1)	bit 5(VTIN2)   bit 6(VTIN3)
+  You may program Bank0 CR[5Dh] and CR[59h] registers.
 
- 	PII thermal diode         1		 1		1
- 	2N3904	diode	          0		 0		0
+  =============================== =============== ============== ============
+	CR[5Dh]    		bit 1(VTIN1)    bit 2(VTIN2)   bit 3(VTIN3)
+
+		thermistor                0		 0		0
+	diode 			  1		 1		1
+
+
+  (error) CR[59h] 		bit 4(VTIN1)	bit 2(VTIN2)   bit 3(VTIN3)
+  (right) CR[59h] 		bit 4(VTIN1)	bit 5(VTIN2)   bit 6(VTIN3)
+
+	PII thermal diode         1		 1		1
+	2N3904	diode		  0		 0		0
+  =============================== =============== ============== ============
 
 
 Asus Clones
@@ -251,18 +286,21 @@ Here are some very useful information that were given to us by Alex Van
 Kaam about how to detect these chips, and how to read their values. He
 also gives advice for another Asus chipset, the Mozart-2 (which we
 don't support yet). Thanks Alex!
+
 I reworded some parts and added personal comments.
 
-# Detection:
+Detection
+^^^^^^^^^
 
 AS99127F rev.1, AS99127F rev.2 and ASB100:
 - I2C address range: 0x29 - 0x2F
-- If register 0x58 holds 0x31 then we have an Asus (either ASB100 or
-  AS99127F)
+- If register 0x58 holds 0x31 then we have an Asus (either ASB100 or AS99127F)
 - Which one depends on register 0x4F (manufacturer ID):
-  0x06 or 0x94: ASB100
-  0x12 or 0xC3: AS99127F rev.1
-  0x5C or 0xA3: AS99127F rev.2
+
+  - 0x06 or 0x94: ASB100
+  - 0x12 or 0xC3: AS99127F rev.1
+  - 0x5C or 0xA3: AS99127F rev.2
+
   Note that 0x5CA3 is Winbond's ID (WEC), which let us think Asus get their
   AS99127F rev.2 direct from Winbond. The other codes mean ATT and DVC,
   respectively. ATT could stand for Asustek something (although it would be
@@ -273,88 +311,103 @@ Mozart-2:
 - I2C address: 0x77
 - If register 0x58 holds 0x56 or 0x10 then we have a Mozart-2
 - Of the Mozart there are 3 types:
-  0x58=0x56, 0x4E=0x94, 0x4F=0x36: Asus ASM58 Mozart-2
-  0x58=0x56, 0x4E=0x94, 0x4F=0x06: Asus AS2K129R Mozart-2
-  0x58=0x10, 0x4E=0x5C, 0x4F=0xA3: Asus ??? Mozart-2
+
+  - 0x58=0x56, 0x4E=0x94, 0x4F=0x36: Asus ASM58 Mozart-2
+  - 0x58=0x56, 0x4E=0x94, 0x4F=0x06: Asus AS2K129R Mozart-2
+  - 0x58=0x10, 0x4E=0x5C, 0x4F=0xA3: Asus ??? Mozart-2
+
   You can handle all 3 the exact same way :)
 
-# Temperature sensors:
+Temperature sensors
+^^^^^^^^^^^^^^^^^^^
 
 ASB100:
-- sensor 1: register 0x27
-- sensor 2 & 3 are the 2 LM75's on the SMBus
-- sensor 4: register 0x17
-Remark: I noticed that on Intel boards sensor 2 is used for the CPU
+  - sensor 1: register 0x27
+  - sensor 2 & 3 are the 2 LM75's on the SMBus
+  - sensor 4: register 0x17
+
+Remark:
+
+  I noticed that on Intel boards sensor 2 is used for the CPU
   and 4 is ignored/stuck, on AMD boards sensor 4 is the CPU and sensor 2 is
   either ignored or a socket temperature.
 
 AS99127F (rev.1 and 2 alike):
-- sensor 1: register 0x27
-- sensor 2 & 3 are the 2 LM75's on the SMBus
-Remark: Register 0x5b is suspected to be temperature type selector. Bit 1
+  - sensor 1: register 0x27
+  - sensor 2 & 3 are the 2 LM75's on the SMBus
+
+Remark:
+
+  Register 0x5b is suspected to be temperature type selector. Bit 1
   would control temp1, bit 3 temp2 and bit 5 temp3.
 
 Mozart-2:
-- sensor 1: register 0x27
-- sensor 2: register 0x13
+  - sensor 1: register 0x27
+  - sensor 2: register 0x13
 
-# Fan sensors:
+Fan sensors
+^^^^^^^^^^^
 
 ASB100, AS99127F (rev.1 and 2 alike):
-- 3 fans, identical to the W83781D
+  - 3 fans, identical to the W83781D
 
 Mozart-2:
-- 2 fans only, 1350000/RPM/div
-- fan 1: register 0x28,  divisor on register 0xA1 (bits 4-5)
-- fan 2: register 0x29,  divisor on register 0xA1 (bits 6-7)
+  - 2 fans only, 1350000/RPM/div
+  - fan 1: register 0x28,  divisor on register 0xA1 (bits 4-5)
+  - fan 2: register 0x29,  divisor on register 0xA1 (bits 6-7)
 
-# Voltages:
+Voltages
+^^^^^^^^
 
 This is where there is a difference between AS99127F rev.1 and 2.
-Remark: The difference is similar to the difference between
+
+Remark:
+
+  The difference is similar to the difference between
   W83781D and W83782D.
 
 ASB100:
-in0=r(0x20)*0.016
-in1=r(0x21)*0.016
-in2=r(0x22)*0.016
-in3=r(0x23)*0.016*1.68
-in4=r(0x24)*0.016*3.8
-in5=r(0x25)*(-0.016)*3.97
-in6=r(0x26)*(-0.016)*1.666
+  - in0=r(0x20)*0.016
+  - in1=r(0x21)*0.016
+  - in2=r(0x22)*0.016
+  - in3=r(0x23)*0.016*1.68
+  - in4=r(0x24)*0.016*3.8
+  - in5=r(0x25)*(-0.016)*3.97
+  - in6=r(0x26)*(-0.016)*1.666
 
 AS99127F rev.1:
-in0=r(0x20)*0.016
-in1=r(0x21)*0.016
-in2=r(0x22)*0.016
-in3=r(0x23)*0.016*1.68
-in4=r(0x24)*0.016*3.8
-in5=r(0x25)*(-0.016)*3.97
-in6=r(0x26)*(-0.016)*1.503
+  - in0=r(0x20)*0.016
+  - in1=r(0x21)*0.016
+  - in2=r(0x22)*0.016
+  - in3=r(0x23)*0.016*1.68
+  - in4=r(0x24)*0.016*3.8
+  - in5=r(0x25)*(-0.016)*3.97
+  - in6=r(0x26)*(-0.016)*1.503
 
 AS99127F rev.2:
-in0=r(0x20)*0.016
-in1=r(0x21)*0.016
-in2=r(0x22)*0.016
-in3=r(0x23)*0.016*1.68
-in4=r(0x24)*0.016*3.8
-in5=(r(0x25)*0.016-3.6)*5.14+3.6
-in6=(r(0x26)*0.016-3.6)*3.14+3.6
+  - in0=r(0x20)*0.016
+  - in1=r(0x21)*0.016
+  - in2=r(0x22)*0.016
+  - in3=r(0x23)*0.016*1.68
+  - in4=r(0x24)*0.016*3.8
+  - in5=(r(0x25)*0.016-3.6)*5.14+3.6
+  - in6=(r(0x26)*0.016-3.6)*3.14+3.6
 
 Mozart-2:
-in0=r(0x20)*0.016
-in1=255
-in2=r(0x22)*0.016
-in3=r(0x23)*0.016*1.68
-in4=r(0x24)*0.016*4
-in5=255
-in6=255
+  - in0=r(0x20)*0.016
+  - in1=255
+  - in2=r(0x22)*0.016
+  - in3=r(0x23)*0.016*1.68
+  - in4=r(0x24)*0.016*4
+  - in5=255
+  - in6=255
 
 
-# PWM
+PWM
+^^^
 
 * Additional info about PWM on the AS99127F (may apply to other Asus
-chips as well) by Jean Delvare as of 2004-04-09:
+  chips as well) by Jean Delvare as of 2004-04-09:
 
 AS99127F revision 2 seems to have two PWM registers at 0x59 and 0x5A,
 and a temperature sensor type selector at 0x5B (which basically means
@@ -401,15 +454,20 @@ AS99127F chips at all.
 I've been fiddling around with the (in)famous 0x59 register and
 found out the following values do work as a form of coarse pwm:
 
-0x80 - seems to turn fans off after some time(1-2 minutes)... might be
-some form of auto-fan-control based on temp? hmm (Qfan? this mobo is an
-old ASUS, it isn't marketed as Qfan. Maybe some beta pre-attempt at Qfan
-that was dropped at the BIOS)
-0x81 - off
-0x82 - slightly "on-ner" than off, but my fans do not get to move. I can
-hear the high-pitched PWM sound that motors give off at too-low-pwm.
-0x83 - now they do move. Estimate about 70% speed or so.
-0x84-0x8f - full on
+0x80
+ - seems to turn fans off after some time(1-2 minutes)... might be
+   some form of auto-fan-control based on temp? hmm (Qfan? this mobo is an
+   old ASUS, it isn't marketed as Qfan. Maybe some beta pre-attempt at Qfan
+   that was dropped at the BIOS)
+0x81
+ - off
+0x82
+ - slightly "on-ner" than off, but my fans do not get to move. I can
+   hear the high-pitched PWM sound that motors give off at too-low-pwm.
+0x83
+ - now they do move. Estimate about 70% speed or so.
+0x84-0x8f
+ - full on
 
 Changing the high nibble doesn't seem to do much except the high bit
 (0x80) must be set for PWM to work, else the current pwm doesn't seem to
@@ -435,6 +493,7 @@ looks like PWM is filtered on this motherboard.
 
 Here are some of measurements:
 
+==== =========
 0x80     20 mV
 0x81     20 mV
 0x82    232 mV
@@ -451,3 +510,4 @@ Here are some of measurements:
 0x8d  12.4  V
 0x8e  12.4  V
 0x8f  12.4  V
+==== =========
diff --git a/Documentation/hwmon/w83792d b/Documentation/hwmon/w83792d
index f2ffc402ea45..92c4bfe4968c 100644
--- a/Documentation/hwmon/w83792d
+++ b/Documentation/hwmon/w83792d
@@ -2,9 +2,13 @@ Kernel driver w83792d
 =====================
 
 Supported chips:
+
   * Winbond W83792D
+
     Prefix: 'w83792d'
+
     Addresses scanned: I2C 0x2c - 0x2f
+
     Datasheet: http://www.winbond.com.tw
 
 Author: Shane Huang (Winbond)
@@ -15,15 +19,16 @@ Module Parameters
 -----------------
 
 * init int
-  (default 1)
-  Use 'init=0' to bypass initializing the chip.
-  Try this if your computer crashes when you load the module.
+    (default 1)
+
+    Use 'init=0' to bypass initializing the chip.
+    Try this if your computer crashes when you load the module.
 
 * force_subclients=bus,caddr,saddr,saddr
-  This is used to force the i2c addresses for subclients of
-  a certain chip. Example usage is `force_subclients=0,0x2f,0x4a,0x4b'
-  to force the subclients of chip 0x2f on bus 0 to i2c addresses
-  0x4a and 0x4b.
+    This is used to force the i2c addresses for subclients of
+    a certain chip. Example usage is `force_subclients=0,0x2f,0x4a,0x4b`
+    to force the subclients of chip 0x2f on bus 0 to i2c addresses
+    0x4a and 0x4b.
 
 
 Description
@@ -67,31 +72,34 @@ or maximum limit.
 Alarms are provided as output from "realtime status register". Following bits
 are defined:
 
-bit - alarm on:
-0  - in0
-1  - in1
-2  - temp1
-3  - temp2
-4  - temp3
-5  - fan1
-6  - fan2
-7  - fan3
-8  - in2
-9  - in3
-10 - in4
-11 - in5
-12 - in6
-13 - VID change
-14 - chassis
-15 - fan7
-16 - tart1
-17 - tart2
-18 - tart3
-19 - in7
-20 - in8
-21 - fan4
-22 - fan5
-23 - fan6
+==== ==========
+bit   alarm on
+==== ==========
+0    in0
+1    in1
+2    temp1
+3    temp2
+4    temp3
+5    fan1
+6    fan2
+7    fan3
+8    in2
+9    in3
+10   in4
+11   in5
+12   in6
+13   VID change
+14   chassis
+15   fan7
+16   tart1
+17   tart2
+18   tart3
+19   in7
+20   in8
+21   fan4
+22   fan5
+23   fan6
+==== ==========
 
 Tart will be asserted while target temperature cannot be achieved after 3 minutes
 of full speed rotation of corresponding fan.
@@ -114,7 +122,7 @@ Known problems:
 	  by CR[0x49h].
 	- The function of vid and vrm has not been finished, because I'm NOT
 	  very familiar with them. Adding support is welcome.
- 	- The function of chassis open detection needs more tests.
+	- The function of chassis open detection needs more tests.
 	- If you have ASUS server board and chip was not found: Then you will
 	  need to upgrade to latest (or beta) BIOS. If it does not help please
 	  contact us.
@@ -165,17 +173,27 @@ for each fan.
 /sys files
 ----------
 
-pwm[1-7] - this file stores PWM duty cycle or DC value (fan speed) in range:
-	0 (stop) to 255 (full)
-pwm[1-3]_enable - this file controls mode of fan/temperature control:
-            * 0 Disabled
-            * 1 Manual mode
-            * 2 Smart Fan II
-            * 3 Thermal Cruise
-pwm[1-7]_mode - Select PWM or DC mode
-            * 0 DC
-            * 1 PWM
-thermal_cruise[1-3] - Selects the desired temperature for cruise (degC)
-tolerance[1-3] - Value in degrees of Celsius (degC) for +- T
-sf2_point[1-4]_fan[1-3] - four temperature points for each fan for Smart Fan II
-sf2_level[1-3]_fan[1-3] - three PWM/DC levels for each fan for Smart Fan II
+pwm[1-7]
+	- this file stores PWM duty cycle or DC value (fan speed) in range:
+
+	    0 (stop) to 255 (full)
+pwm[1-3]_enable
+	- this file controls mode of fan/temperature control:
+
+	    * 0 Disabled
+	    * 1 Manual mode
+	    * 2 Smart Fan II
+	    * 3 Thermal Cruise
+pwm[1-7]_mode
+	- Select PWM or DC mode
+
+	    * 0 DC
+	    * 1 PWM
+thermal_cruise[1-3]
+	- Selects the desired temperature for cruise (degC)
+tolerance[1-3]
+	- Value in degrees of Celsius (degC) for +- T
+sf2_point[1-4]_fan[1-3]
+	- four temperature points for each fan for Smart Fan II
+sf2_level[1-3]_fan[1-3]
+	- three PWM/DC levels for each fan for Smart Fan II
diff --git a/Documentation/hwmon/w83795 b/Documentation/hwmon/w83795
index d3e678216b9a..d0615e2fabb9 100644
--- a/Documentation/hwmon/w83795
+++ b/Documentation/hwmon/w83795
@@ -2,18 +2,26 @@ Kernel driver w83795
 ====================
 
 Supported chips:
+
   * Winbond/Nuvoton W83795G
+
     Prefix: 'w83795g'
+
     Addresses scanned: I2C 0x2c - 0x2f
+
     Datasheet: Available for download on nuvoton.com
+
   * Winbond/Nuvoton W83795ADG
+
     Prefix: 'w83795adg'
+
     Addresses scanned: I2C 0x2c - 0x2f
+
     Datasheet: Available for download on nuvoton.com
 
 Authors:
-    Wei Song (Nuvoton)
-    Jean Delvare <jdelvare@suse.de>
+    - Wei Song (Nuvoton)
+    - Jean Delvare <jdelvare@suse.de>
 
 
 Pin mapping
@@ -23,105 +31,112 @@ Here is a summary of the pin mapping for the W83795G and W83795ADG.
 This can be useful to convert data provided by board manufacturers
 into working libsensors configuration statements.
 
-    W83795G			|
-  Pin	| Name			| Register	| Sysfs attribute
-------------------------------------------------------------------
-   13	| VSEN1 (VCORE1)	| 10h		| in0
-   14	| VSEN2 (VCORE2)	| 11h		| in1
-   15	| VSEN3 (VCORE3)	| 12h		| in2
-   16	| VSEN4			| 13h		| in3
-   17	| VSEN5			| 14h		| in4
-   18	| VSEN6			| 15h		| in5
-   19	| VSEN7			| 16h		| in6
-   20	| VSEN8			| 17h		| in7
-   21	| VSEN9			| 18h		| in8
-   22	| VSEN10		| 19h		| in9
-   23	| VSEN11		| 1Ah		| in10
-   28	| VTT			| 1Bh		| in11
-   24	| 3VDD			| 1Ch		| in12
-   25	| 3VSB			| 1Dh		| in13
-   26	| VBAT			| 1Eh		| in14
-    3	| VSEN12/TR5		| 1Fh		| in15/temp5
-    4	| VSEN13/TR5		| 20h		| in16/temp6
-  5/  6	| VDSEN14/TR1/TD1	| 21h		| in17/temp1
-  7/  8	| VDSEN15/TR2/TD2	| 22h		| in18/temp2
-  9/ 10	| VDSEN16/TR3/TD3	| 23h		| in19/temp3
- 11/ 12	| VDSEN17/TR4/TD4	| 24h		| in20/temp4
-   40	| FANIN1		| 2Eh		| fan1
-   42	| FANIN2		| 2Fh		| fan2
-   44	| FANIN3		| 30h		| fan3
-   46	| FANIN4		| 31h		| fan4
-   48	| FANIN5		| 32h		| fan5
-   50	| FANIN6		| 33h		| fan6
-   52	| FANIN7		| 34h		| fan7
-   54	| FANIN8		| 35h		| fan8
-   57	| FANIN9		| 36h		| fan9
-   58	| FANIN10		| 37h		| fan10
-   59	| FANIN11		| 38h		| fan11
-   60	| FANIN12		| 39h		| fan12
-   31	| FANIN13		| 3Ah		| fan13
-   35	| FANIN14		| 3Bh		| fan14
-   41	| FANCTL1		| 10h (bank 2)	| pwm1
-   43	| FANCTL2		| 11h (bank 2)	| pwm2
-   45	| FANCTL3		| 12h (bank 2)	| pwm3
-   47	| FANCTL4		| 13h (bank 2)	| pwm4
-   49	| FANCTL5		| 14h (bank 2)	| pwm5
-   51	| FANCTL6		| 15h (bank 2)	| pwm6
-   53	| FANCTL7		| 16h (bank 2)	| pwm7
-   55	| FANCTL8		| 17h (bank 2)	| pwm8
- 29/ 30	| PECI/TSI (DTS1)	| 26h		| temp7
- 29/ 30	| PECI/TSI (DTS2)	| 27h		| temp8
- 29/ 30	| PECI/TSI (DTS3)	| 28h		| temp9
- 29/ 30	| PECI/TSI (DTS4)	| 29h		| temp10
- 29/ 30	| PECI/TSI (DTS5)	| 2Ah		| temp11
- 29/ 30	| PECI/TSI (DTS6)	| 2Bh		| temp12
- 29/ 30	| PECI/TSI (DTS7)	| 2Ch		| temp13
- 29/ 30	| PECI/TSI (DTS8)	| 2Dh		| temp14
-   27	| CASEOPEN#		| 46h		| intrusion0
 
-    W83795ADG			|
-  Pin	| Name			| Register	| Sysfs attribute
-------------------------------------------------------------------
-   10	| VSEN1 (VCORE1)	| 10h		| in0
-   11	| VSEN2 (VCORE2)	| 11h		| in1
-   12	| VSEN3 (VCORE3)	| 12h		| in2
-   13	| VSEN4			| 13h		| in3
-   14	| VSEN5			| 14h		| in4
-   15	| VSEN6			| 15h		| in5
-   16	| VSEN7			| 16h		| in6
-   17	| VSEN8			| 17h		| in7
-   22	| VTT			| 1Bh		| in11
-   18	| 3VDD			| 1Ch		| in12
-   19	| 3VSB			| 1Dh		| in13
-   20	| VBAT			| 1Eh		| in14
-   48	| VSEN12/TR5		| 1Fh		| in15/temp5
-    1	| VSEN13/TR5		| 20h		| in16/temp6
-  2/  3	| VDSEN14/TR1/TD1	| 21h		| in17/temp1
-  4/  5	| VDSEN15/TR2/TD2	| 22h		| in18/temp2
-  6/  7	| VDSEN16/TR3/TD3	| 23h		| in19/temp3
-  8/  9	| VDSEN17/TR4/TD4	| 24h		| in20/temp4
-   32	| FANIN1		| 2Eh		| fan1
-   34	| FANIN2		| 2Fh		| fan2
-   36	| FANIN3		| 30h		| fan3
-   37	| FANIN4		| 31h		| fan4
-   38	| FANIN5		| 32h		| fan5
-   39	| FANIN6		| 33h		| fan6
-   40	| FANIN7		| 34h		| fan7
-   41	| FANIN8		| 35h		| fan8
-   43	| FANIN9		| 36h		| fan9
-   44	| FANIN10		| 37h		| fan10
-   45	| FANIN11		| 38h		| fan11
-   46	| FANIN12		| 39h		| fan12
-   24	| FANIN13		| 3Ah		| fan13
-   28	| FANIN14		| 3Bh		| fan14
-   33	| FANCTL1		| 10h (bank 2)	| pwm1
-   35	| FANCTL2		| 11h (bank 2)	| pwm2
-   23	| PECI (DTS1)		| 26h		| temp7
-   23	| PECI (DTS2)		| 27h		| temp8
-   23	| PECI (DTS3)		| 28h		| temp9
-   23	| PECI (DTS4)		| 29h		| temp10
-   23	| PECI (DTS5)		| 2Ah		| temp11
-   23	| PECI (DTS6)		| 2Bh		| temp12
-   23	| PECI (DTS7)		| 2Ch		| temp13
-   23	| PECI (DTS8)		| 2Dh		| temp14
-   21	| CASEOPEN#		| 46h		| intrusion0
+- W83795G
+
+========= ======================= =============== ================
+Pin	  Name			  Register	  Sysfs attribute
+========= ======================= =============== ================
+   13	  VSEN1 (VCORE1)	  10h		  in0
+   14	  VSEN2 (VCORE2)	  11h		  in1
+   15	  VSEN3 (VCORE3)	  12h		  in2
+   16	  VSEN4			  13h		  in3
+   17	  VSEN5			  14h		  in4
+   18	  VSEN6			  15h		  in5
+   19	  VSEN7			  16h		  in6
+   20	  VSEN8			  17h		  in7
+   21	  VSEN9			  18h		  in8
+   22	  VSEN10		  19h		  in9
+   23	  VSEN11		  1Ah		  in10
+   28	  VTT			  1Bh		  in11
+   24	  3VDD			  1Ch		  in12
+   25	  3VSB			  1Dh		  in13
+   26	  VBAT			  1Eh		  in14
+    3	  VSEN12/TR5		  1Fh		  in15/temp5
+    4	  VSEN13/TR5		  20h		  in16/temp6
+  5/  6	  VDSEN14/TR1/TD1	  21h		  in17/temp1
+  7/  8	  VDSEN15/TR2/TD2	  22h		  in18/temp2
+  9/ 10	  VDSEN16/TR3/TD3	  23h		  in19/temp3
+ 11/ 12	  VDSEN17/TR4/TD4	  24h		  in20/temp4
+   40	  FANIN1		  2Eh		  fan1
+   42	  FANIN2		  2Fh		  fan2
+   44	  FANIN3		  30h		  fan3
+   46	  FANIN4		  31h		  fan4
+   48	  FANIN5		  32h		  fan5
+   50	  FANIN6		  33h		  fan6
+   52	  FANIN7		  34h		  fan7
+   54	  FANIN8		  35h		  fan8
+   57	  FANIN9		  36h		  fan9
+   58	  FANIN10		  37h		  fan10
+   59	  FANIN11		  38h		  fan11
+   60	  FANIN12		  39h		  fan12
+   31	  FANIN13		  3Ah		  fan13
+   35	  FANIN14		  3Bh		  fan14
+   41	  FANCTL1		  10h (bank 2)	  pwm1
+   43	  FANCTL2		  11h (bank 2)	  pwm2
+   45	  FANCTL3		  12h (bank 2)	  pwm3
+   47	  FANCTL4		  13h (bank 2)	  pwm4
+   49	  FANCTL5		  14h (bank 2)	  pwm5
+   51	  FANCTL6		  15h (bank 2)	  pwm6
+   53	  FANCTL7		  16h (bank 2)	  pwm7
+   55	  FANCTL8		  17h (bank 2)	  pwm8
+ 29/ 30	  PECI/TSI (DTS1)	  26h		  temp7
+ 29/ 30	  PECI/TSI (DTS2)	  27h		  temp8
+ 29/ 30	  PECI/TSI (DTS3)	  28h		  temp9
+ 29/ 30	  PECI/TSI (DTS4)	  29h		  temp10
+ 29/ 30	  PECI/TSI (DTS5)	  2Ah		  temp11
+ 29/ 30	  PECI/TSI (DTS6)	  2Bh		  temp12
+ 29/ 30	  PECI/TSI (DTS7)	  2Ch		  temp13
+ 29/ 30	  PECI/TSI (DTS8)	  2Dh		  temp14
+   27	  CASEOPEN#		  46h		  intrusion0
+========= ======================= =============== ================
+
+- W83795ADG
+
+========= ======================= =============== ================
+Pin	  Name			  Register	  Sysfs attribute
+========= ======================= =============== ================
+   10	  VSEN1 (VCORE1)	  10h		  in0
+   11	  VSEN2 (VCORE2)	  11h		  in1
+   12	  VSEN3 (VCORE3)	  12h		  in2
+   13	  VSEN4			  13h		  in3
+   14	  VSEN5			  14h		  in4
+   15	  VSEN6			  15h		  in5
+   16	  VSEN7			  16h		  in6
+   17	  VSEN8			  17h		  in7
+   22	  VTT			  1Bh		  in11
+   18	  3VDD			  1Ch		  in12
+   19	  3VSB			  1Dh		  in13
+   20	  VBAT			  1Eh		  in14
+   48	  VSEN12/TR5		  1Fh		  in15/temp5
+    1	  VSEN13/TR5		  20h		  in16/temp6
+  2/  3	  VDSEN14/TR1/TD1	  21h		  in17/temp1
+  4/  5	  VDSEN15/TR2/TD2	  22h		  in18/temp2
+  6/  7	  VDSEN16/TR3/TD3	  23h		  in19/temp3
+  8/  9	  VDSEN17/TR4/TD4	  24h		  in20/temp4
+   32	  FANIN1		  2Eh		  fan1
+   34	  FANIN2		  2Fh		  fan2
+   36	  FANIN3		  30h		  fan3
+   37	  FANIN4		  31h		  fan4
+   38	  FANIN5		  32h		  fan5
+   39	  FANIN6		  33h		  fan6
+   40	  FANIN7		  34h		  fan7
+   41	  FANIN8		  35h		  fan8
+   43	  FANIN9		  36h		  fan9
+   44	  FANIN10		  37h		  fan10
+   45	  FANIN11		  38h		  fan11
+   46	  FANIN12		  39h		  fan12
+   24	  FANIN13		  3Ah		  fan13
+   28	  FANIN14		  3Bh		  fan14
+   33	  FANCTL1		  10h (bank 2)	  pwm1
+   35	  FANCTL2		  11h (bank 2)	  pwm2
+   23	  PECI (DTS1)		  26h		  temp7
+   23	  PECI (DTS2)		  27h		  temp8
+   23	  PECI (DTS3)		  28h		  temp9
+   23	  PECI (DTS4)		  29h		  temp10
+   23	  PECI (DTS5)		  2Ah		  temp11
+   23	  PECI (DTS6)		  2Bh		  temp12
+   23	  PECI (DTS7)		  2Ch		  temp13
+   23	  PECI (DTS8)		  2Dh		  temp14
+   21	  CASEOPEN#		  46h		  intrusion0
+========= ======================= =============== ================
diff --git a/Documentation/hwmon/w83l785ts b/Documentation/hwmon/w83l785ts
index c8978478871f..7fa5418fed11 100644
--- a/Documentation/hwmon/w83l785ts
+++ b/Documentation/hwmon/w83l785ts
@@ -2,14 +2,19 @@ Kernel driver w83l785ts
 =======================
 
 Supported chips:
+
   * Winbond W83L785TS-S
+
     Prefix: 'w83l785ts'
+
     Addresses scanned: I2C 0x2e
+
     Datasheet: Publicly available at the Winbond USA website
-               http://www.winbond-usa.com/products/winbond_products/pdfs/PCIC/W83L785TS-S.pdf
+
+	       http://www.winbond-usa.com/products/winbond_products/pdfs/PCIC/W83L785TS-S.pdf
 
 Authors:
-        Jean Delvare <jdelvare@suse.de>
+	Jean Delvare <jdelvare@suse.de>
 
 Description
 -----------
diff --git a/Documentation/hwmon/w83l786ng b/Documentation/hwmon/w83l786ng
index d8f55d7fff10..2b7776190de3 100644
--- a/Documentation/hwmon/w83l786ng
+++ b/Documentation/hwmon/w83l786ng
@@ -1,10 +1,14 @@
 Kernel driver w83l786ng
-=====================
+=======================
 
 Supported chips:
+
   * Winbond W83L786NG/W83L786NR
+
     Prefix: 'w83l786ng'
+
     Addresses scanned: I2C 0x2e - 0x2f
+
     Datasheet: http://www.winbond-usa.com/products/winbond_products/pdfs/PCIC/W83L786NRNG09.pdf
 
 Author: Kevin Lo <kevlo@kevlo.org>
@@ -14,9 +18,10 @@ Module Parameters
 -----------------
 
 * reset boolean
-  (default 0)
-  Use 'reset=1' to reset the chip (via index 0x40, bit 7). The default
-  behavior is no chip reset to preserve BIOS settings
+    (default 0)
+
+    Use 'reset=1' to reset the chip (via index 0x40, bit 7). The default
+    behavior is no chip reset to preserve BIOS settings
 
 
 Description
@@ -41,14 +46,21 @@ or maximum limit.
 /sys files
 ----------
 
-pwm[1-2] - this file stores PWM duty cycle or DC value (fan speed) in range:
-	    0 (stop) to 255 (full)
-pwm[1-2]_enable - this file controls mode of fan/temperature control:
-            * 0 Manual Mode
-            * 1 Thermal Cruise
-            * 2 Smart Fan II
-            * 4 FAN_SET
-pwm[1-2]_mode - Select PWM of DC mode
-            * 0 DC
-            * 1 PWM
-tolerance[1-2] - Value in degrees of Celsius (degC) for +- T
+pwm[1-2]
+	    - this file stores PWM duty cycle or DC value (fan speed) in range:
+
+	      0 (stop) to 255 (full)
+pwm[1-2]_enable
+	    - this file controls mode of fan/temperature control:
+
+	    * 0 Manual Mode
+	    * 1 Thermal Cruise
+	    * 2 Smart Fan II
+	    * 4 FAN_SET
+pwm[1-2]_mode
+	    - Select PWM of DC mode
+
+	    * 0 DC
+	    * 1 PWM
+tolerance[1-2]
+	    - Value in degrees of Celsius (degC) for +- T
diff --git a/Documentation/hwmon/xgene-hwmon b/Documentation/hwmon/xgene-hwmon
index 6ec50ed7cc8f..439b30b881b6 100644
--- a/Documentation/hwmon/xgene-hwmon
+++ b/Documentation/hwmon/xgene-hwmon
@@ -1,7 +1,8 @@
 Kernel driver xgene-hwmon
-========================
+=========================
 
 Supported chips:
+
  * APM X-Gene SoC
 
 Description
@@ -15,16 +16,21 @@ For ACPI, it is the PCC mailbox.
 The following sensors are supported
 
   * Temperature
-    - SoC on-die temperature in milli-degree C
-    - Alarm when high/over temperature occurs
+      - SoC on-die temperature in milli-degree C
+      - Alarm when high/over temperature occurs
+
   * Power
-    - CPU power in uW
-    - IO power in uW
+      - CPU power in uW
+      - IO power in uW
 
 sysfs-Interface
 ---------------
 
-temp0_input - SoC on-die temperature (milli-degree C)
-temp0_critical_alarm - An 1 would indicates on-die temperature exceeded threshold
-power0_input - CPU power in (uW)
-power1_input - IO power in (uW)
+temp0_input
+	- SoC on-die temperature (milli-degree C)
+temp0_critical_alarm
+	- An 1 would indicates on-die temperature exceeded threshold
+power0_input
+	- CPU power in (uW)
+power1_input
+	- IO power in (uW)
-- 
2.20.1


^ permalink raw reply related	[flat|nested] 73+ messages in thread

* [PATCH v2 21/21] docs: hwmon: Add an index file and rename docs to *.rst
  2019-04-10 19:22 [PATCH v2 00/21] Convert hwmon documentation to ReST Mauro Carvalho Chehab
                   ` (19 preceding siblings ...)
  2019-04-10 19:22 ` [PATCH v2 20/21] docs: hwmon: convert remaining files " Mauro Carvalho Chehab
@ 2019-04-10 19:22 ` Mauro Carvalho Chehab
  2019-04-11 13:07   ` Liviu Dudau
  2019-04-11 18:43 ` [PATCH v2 00/21] Convert hwmon documentation to ReST Jonathan Corbet
  21 siblings, 1 reply; 73+ messages in thread
From: Mauro Carvalho Chehab @ 2019-04-10 19:22 UTC (permalink / raw)
  To: Linux Doc Mailing List
  Cc: Mauro Carvalho Chehab, Mauro Carvalho Chehab, linux-kernel,
	Jonathan Corbet, Jean Delvare, Guenter Roeck, Rob Herring,
	Mark Rutland, Dirk Eibach, George Joseph, Joel Stanley,
	Andrew Jeffery, Fenghua Yu, Support Opensource, Juerg Haefliger,
	Steve Glendinning, Huang Rui, Benjamin Herrenschmidt,
	Paul Mackerras, Michael Ellerman, Clemens Ladisch, Rudolf Marek,
	Andreas Werner, Jim Cromie, Kamil Debski,
	Bartlomiej Zolnierkiewicz, Hans de Goede, Liviu Dudau,
	Sudeep Holla, Lorenzo Pieralisi, Marc Hulsman, linux-hwmon,
	devicetree, linux-arm-kernel, linux-aspeed, linuxppc-dev,
	patches

Now that all files were converted to ReST format, rename them
and add an index.

Signed-off-by: Mauro Carvalho Chehab <mchehab+samsung@kernel.org>
---
 .../devicetree/bindings/hwmon/g762.txt        |   2 +-
 Documentation/hwmon/{ab8500 => ab8500.rst}    |   2 +-
 ...guru-datasheet => abituguru-datasheet.rst} |   0
 .../hwmon/{abituguru => abituguru.rst}        |   0
 .../hwmon/{abituguru3 => abituguru3.rst}      |   0
 Documentation/hwmon/{abx500 => abx500.rst}    |   0
 ...{acpi_power_meter => acpi_power_meter.rst} |   2 +-
 Documentation/hwmon/{ad7314 => ad7314.rst}    |   0
 .../hwmon/{adc128d818 => adc128d818.rst}      |   0
 Documentation/hwmon/{adm1021 => adm1021.rst}  |   0
 Documentation/hwmon/{adm1025 => adm1025.rst}  |   0
 Documentation/hwmon/{adm1026 => adm1026.rst}  |   0
 Documentation/hwmon/{adm1031 => adm1031.rst}  |   0
 Documentation/hwmon/{adm1275 => adm1275.rst}  |   4 +-
 Documentation/hwmon/{adm9240 => adm9240.rst}  |   0
 Documentation/hwmon/{ads1015 => ads1015.rst}  |   0
 Documentation/hwmon/{ads7828 => ads7828.rst}  |   0
 Documentation/hwmon/{adt7410 => adt7410.rst}  |   0
 Documentation/hwmon/{adt7411 => adt7411.rst}  |   0
 Documentation/hwmon/{adt7462 => adt7462.rst}  |   0
 Documentation/hwmon/{adt7470 => adt7470.rst}  |   0
 Documentation/hwmon/{adt7475 => adt7475.rst}  |   0
 Documentation/hwmon/{amc6821 => amc6821.rst}  |   0
 Documentation/hwmon/{asb100 => asb100.rst}    |   0
 Documentation/hwmon/{asc7621 => asc7621.rst}  |   0
 ...{aspeed-pwm-tacho => aspeed-pwm-tacho.rst} |   0
 .../hwmon/{coretemp => coretemp.rst}          |   0
 Documentation/hwmon/{da9052 => da9052.rst}    |   0
 Documentation/hwmon/{da9055 => da9055.rst}    |   0
 Documentation/hwmon/{dme1737 => dme1737.rst}  |   0
 Documentation/hwmon/{ds1621 => ds1621.rst}    |   0
 Documentation/hwmon/{ds620 => ds620.rst}      |   0
 Documentation/hwmon/{emc1403 => emc1403.rst}  |   0
 Documentation/hwmon/{emc2103 => emc2103.rst}  |   0
 .../hwmon/{emc6w201 => emc6w201.rst}          |   0
 Documentation/hwmon/{f71805f => f71805f.rst}  |   0
 .../hwmon/{f71882fg => f71882fg.rst}          |   0
 .../hwmon/{fam15h_power => fam15h_power.rst}  |   0
 .../hwmon/{ftsteutates => ftsteutates.rst}    |   0
 Documentation/hwmon/{g760a => g760a.rst}      |   0
 Documentation/hwmon/{g762 => g762.rst}        |   2 +-
 Documentation/hwmon/{gl518sm => gl518sm.rst}  |   0
 Documentation/hwmon/{hih6130 => hih6130.rst}  |   0
 ...on-kernel-api.txt => hwmon-kernel-api.rst} |   4 +-
 .../hwmon/{ibm-cffps => ibm-cffps.rst}        |   0
 Documentation/hwmon/{ibmaem => ibmaem.rst}    |   0
 .../hwmon/{ibmpowernv => ibmpowernv.rst}      |   0
 Documentation/hwmon/{ina209 => ina209.rst}    |   0
 Documentation/hwmon/{ina2xx => ina2xx.rst}    |   2 +-
 Documentation/hwmon/{ina3221 => ina3221.rst}  |   0
 Documentation/hwmon/index.rst                 | 179 ++++++++++++++++++
 Documentation/hwmon/{ir35221 => ir35221.rst}  |   0
 Documentation/hwmon/{it87 => it87.rst}        |   0
 Documentation/hwmon/{jc42 => jc42.rst}        |   0
 Documentation/hwmon/{k10temp => k10temp.rst}  |   0
 Documentation/hwmon/{k8temp => k8temp.rst}    |   0
 .../hwmon/{lineage-pem => lineage-pem.rst}    |   0
 Documentation/hwmon/{lm25066 => lm25066.rst}  |   2 +-
 Documentation/hwmon/{lm63 => lm63.rst}        |   0
 Documentation/hwmon/{lm70 => lm70.rst}        |   0
 Documentation/hwmon/{lm73 => lm73.rst}        |   0
 Documentation/hwmon/{lm75 => lm75.rst}        |   0
 Documentation/hwmon/{lm77 => lm77.rst}        |   0
 Documentation/hwmon/{lm78 => lm78.rst}        |   0
 Documentation/hwmon/{lm80 => lm80.rst}        |   0
 Documentation/hwmon/{lm83 => lm83.rst}        |   0
 Documentation/hwmon/{lm85 => lm85.rst}        |   0
 Documentation/hwmon/{lm87 => lm87.rst}        |   0
 Documentation/hwmon/{lm90 => lm90.rst}        |   0
 Documentation/hwmon/{lm92 => lm92.rst}        |   0
 Documentation/hwmon/{lm93 => lm93.rst}        |   0
 Documentation/hwmon/{lm95234 => lm95234.rst}  |   0
 Documentation/hwmon/{lm95245 => lm95245.rst}  |   0
 Documentation/hwmon/{ltc2945 => ltc2945.rst}  |   0
 Documentation/hwmon/{ltc2978 => ltc2978.rst}  |   0
 Documentation/hwmon/{ltc2990 => ltc2990.rst}  |   0
 Documentation/hwmon/{ltc3815 => ltc3815.rst}  |   0
 Documentation/hwmon/{ltc4151 => ltc4151.rst}  |   0
 Documentation/hwmon/{ltc4215 => ltc4215.rst}  |   0
 Documentation/hwmon/{ltc4245 => ltc4245.rst}  |   0
 Documentation/hwmon/{ltc4260 => ltc4260.rst}  |   0
 Documentation/hwmon/{ltc4261 => ltc4261.rst}  |   0
 .../hwmon/{max16064 => max16064.rst}          |   2 +-
 .../hwmon/{max16065 => max16065.rst}          |   0
 Documentation/hwmon/{max1619 => max1619.rst}  |   0
 Documentation/hwmon/{max1668 => max1668.rst}  |   0
 Documentation/hwmon/{max197 => max197.rst}    |   0
 .../hwmon/{max20751 => max20751.rst}          |   2 +-
 .../hwmon/{max31722 => max31722.rst}          |   0
 .../hwmon/{max31785 => max31785.rst}          |   0
 .../hwmon/{max31790 => max31790.rst}          |   0
 .../hwmon/{max34440 => max34440.rst}          |   2 +-
 Documentation/hwmon/{max6639 => max6639.rst}  |   0
 Documentation/hwmon/{max6642 => max6642.rst}  |   0
 Documentation/hwmon/{max6650 => max6650.rst}  |   0
 Documentation/hwmon/{max6697 => max6697.rst}  |   0
 Documentation/hwmon/{max8688 => max8688.rst}  |   2 +-
 .../hwmon/{mc13783-adc => mc13783-adc.rst}    |   0
 Documentation/hwmon/{mcp3021 => mcp3021.rst}  |   0
 .../hwmon/{menf21bmc => menf21bmc.rst}        |   0
 .../hwmon/{mlxreg-fan => mlxreg-fan.rst}      |   0
 Documentation/hwmon/{nct6683 => nct6683.rst}  |   0
 Documentation/hwmon/{nct6775 => nct6775.rst}  |   0
 Documentation/hwmon/{nct7802 => nct7802.rst}  |   0
 Documentation/hwmon/{nct7904 => nct7904.rst}  |   0
 .../{npcm750-pwm-fan => npcm750-pwm-fan.rst}  |   0
 Documentation/hwmon/{nsa320 => nsa320.rst}    |   0
 .../{ntc_thermistor => ntc_thermistor.rst}    |   0
 Documentation/hwmon/{occ => occ.rst}          |   0
 Documentation/hwmon/{pc87360 => pc87360.rst}  |   0
 Documentation/hwmon/{pc87427 => pc87427.rst}  |   0
 Documentation/hwmon/{pcf8591 => pcf8591.rst}  |   0
 .../hwmon/{pmbus-core => pmbus-core.rst}      |   0
 Documentation/hwmon/{pmbus => pmbus.rst}      |   0
 .../hwmon/{powr1220 => powr1220.rst}          |   0
 Documentation/hwmon/{pwm-fan => pwm-fan.rst}  |   0
 ...aspberrypi-hwmon => raspberrypi-hwmon.rst} |   0
 Documentation/hwmon/{sch5627 => sch5627.rst}  |   0
 Documentation/hwmon/{sch5636 => sch5636.rst}  |   0
 .../hwmon/{scpi-hwmon => scpi-hwmon.rst}      |   0
 Documentation/hwmon/{sht15 => sht15.rst}      |   0
 Documentation/hwmon/{sht21 => sht21.rst}      |   0
 Documentation/hwmon/{sht3x => sht3x.rst}      |   0
 Documentation/hwmon/{shtc1 => shtc1.rst}      |   0
 Documentation/hwmon/{sis5595 => sis5595.rst}  |   0
 Documentation/hwmon/{smm665 => smm665.rst}    |   0
 .../hwmon/{smsc47b397 => smsc47b397.rst}      |   0
 .../hwmon/{smsc47m1 => smsc47m1.rst}          |   0
 .../hwmon/{smsc47m192 => smsc47m192.rst}      |   0
 ...mitting-patches => submitting-patches.rst} |   6 +-
 .../{sysfs-interface => sysfs-interface.rst}  |   0
 Documentation/hwmon/{tc654 => tc654.rst}      |   0
 Documentation/hwmon/{tc74 => tc74.rst}        |   0
 Documentation/hwmon/{thmc50 => thmc50.rst}    |   0
 Documentation/hwmon/{tmp102 => tmp102.rst}    |   2 +-
 Documentation/hwmon/{tmp103 => tmp103.rst}    |   2 +-
 Documentation/hwmon/{tmp108 => tmp108.rst}    |   2 +-
 Documentation/hwmon/{tmp401 => tmp401.rst}    |   2 +-
 Documentation/hwmon/{tmp421 => tmp421.rst}    |   0
 .../hwmon/{tps40422 => tps40422.rst}          |   2 +-
 ...4030-madc-hwmon => twl4030-madc-hwmon.rst} |   0
 Documentation/hwmon/{ucd9000 => ucd9000.rst}  |   4 +-
 Documentation/hwmon/{ucd9200 => ucd9200.rst}  |   4 +-
 .../{userspace-tools => userspace-tools.rst}  |   0
 .../hwmon/{vexpress => vexpress.rst}          |   0
 Documentation/hwmon/{via686a => via686a.rst}  |   0
 Documentation/hwmon/{vt1211 => vt1211.rst}    |   0
 .../hwmon/{w83627ehf => w83627ehf.rst}        |   0
 .../hwmon/{w83627hf => w83627hf.rst}          |   0
 Documentation/hwmon/{w83773g => w83773g.rst}  |   0
 Documentation/hwmon/{w83781d => w83781d.rst}  |   0
 Documentation/hwmon/{w83791d => w83791d.rst}  |   2 +-
 Documentation/hwmon/{w83792d => w83792d.rst}  |   0
 Documentation/hwmon/{w83793 => w83793.rst}    |   0
 Documentation/hwmon/{w83795 => w83795.rst}    |   0
 .../hwmon/{w83l785ts => w83l785ts.rst}        |   0
 .../hwmon/{w83l786ng => w83l786ng.rst}        |   0
 Documentation/hwmon/{wm831x => wm831x.rst}    |   0
 Documentation/hwmon/{wm8350 => wm8350.rst}    |   0
 .../hwmon/{xgene-hwmon => xgene-hwmon.rst}    |   0
 Documentation/hwmon/{zl6100 => zl6100.rst}    |   2 +-
 Documentation/index.rst                       |   1 +
 Documentation/thermal/sysfs-api.txt           |   2 +-
 MAINTAINERS                                   | 108 +++++------
 drivers/hwmon/Kconfig                         |   8 +-
 drivers/hwmon/ads7828.c                       |   2 +-
 drivers/hwmon/max197.c                        |   2 +-
 drivers/hwmon/sht15.c                         |   2 +-
 include/linux/platform_data/ads7828.h         |   2 +-
 include/linux/platform_data/ds620.h           |   2 +-
 include/linux/platform_data/ina2xx.h          |   2 +-
 include/linux/platform_data/max197.h          |   2 +-
 include/linux/platform_data/ntc_thermistor.h  |   2 +-
 173 files changed, 275 insertions(+), 95 deletions(-)
 rename Documentation/hwmon/{ab8500 => ab8500.rst} (86%)
 rename Documentation/hwmon/{abituguru-datasheet => abituguru-datasheet.rst} (100%)
 rename Documentation/hwmon/{abituguru => abituguru.rst} (100%)
 rename Documentation/hwmon/{abituguru3 => abituguru3.rst} (100%)
 rename Documentation/hwmon/{abx500 => abx500.rst} (100%)
 rename Documentation/hwmon/{acpi_power_meter => acpi_power_meter.rst} (97%)
 rename Documentation/hwmon/{ad7314 => ad7314.rst} (100%)
 rename Documentation/hwmon/{adc128d818 => adc128d818.rst} (100%)
 rename Documentation/hwmon/{adm1021 => adm1021.rst} (100%)
 rename Documentation/hwmon/{adm1025 => adm1025.rst} (100%)
 rename Documentation/hwmon/{adm1026 => adm1026.rst} (100%)
 rename Documentation/hwmon/{adm1031 => adm1031.rst} (100%)
 rename Documentation/hwmon/{adm1275 => adm1275.rst} (97%)
 rename Documentation/hwmon/{adm9240 => adm9240.rst} (100%)
 rename Documentation/hwmon/{ads1015 => ads1015.rst} (100%)
 rename Documentation/hwmon/{ads7828 => ads7828.rst} (100%)
 rename Documentation/hwmon/{adt7410 => adt7410.rst} (100%)
 rename Documentation/hwmon/{adt7411 => adt7411.rst} (100%)
 rename Documentation/hwmon/{adt7462 => adt7462.rst} (100%)
 rename Documentation/hwmon/{adt7470 => adt7470.rst} (100%)
 rename Documentation/hwmon/{adt7475 => adt7475.rst} (100%)
 rename Documentation/hwmon/{amc6821 => amc6821.rst} (100%)
 rename Documentation/hwmon/{asb100 => asb100.rst} (100%)
 rename Documentation/hwmon/{asc7621 => asc7621.rst} (100%)
 rename Documentation/hwmon/{aspeed-pwm-tacho => aspeed-pwm-tacho.rst} (100%)
 rename Documentation/hwmon/{coretemp => coretemp.rst} (100%)
 rename Documentation/hwmon/{da9052 => da9052.rst} (100%)
 rename Documentation/hwmon/{da9055 => da9055.rst} (100%)
 rename Documentation/hwmon/{dme1737 => dme1737.rst} (100%)
 rename Documentation/hwmon/{ds1621 => ds1621.rst} (100%)
 rename Documentation/hwmon/{ds620 => ds620.rst} (100%)
 rename Documentation/hwmon/{emc1403 => emc1403.rst} (100%)
 rename Documentation/hwmon/{emc2103 => emc2103.rst} (100%)
 rename Documentation/hwmon/{emc6w201 => emc6w201.rst} (100%)
 rename Documentation/hwmon/{f71805f => f71805f.rst} (100%)
 rename Documentation/hwmon/{f71882fg => f71882fg.rst} (100%)
 rename Documentation/hwmon/{fam15h_power => fam15h_power.rst} (100%)
 rename Documentation/hwmon/{ftsteutates => ftsteutates.rst} (100%)
 rename Documentation/hwmon/{g760a => g760a.rst} (100%)
 rename Documentation/hwmon/{g762 => g762.rst} (97%)
 rename Documentation/hwmon/{gl518sm => gl518sm.rst} (100%)
 rename Documentation/hwmon/{hih6130 => hih6130.rst} (100%)
 rename Documentation/hwmon/{hwmon-kernel-api.txt => hwmon-kernel-api.rst} (99%)
 rename Documentation/hwmon/{ibm-cffps => ibm-cffps.rst} (100%)
 rename Documentation/hwmon/{ibmaem => ibmaem.rst} (100%)
 rename Documentation/hwmon/{ibmpowernv => ibmpowernv.rst} (100%)
 rename Documentation/hwmon/{ina209 => ina209.rst} (100%)
 rename Documentation/hwmon/{ina2xx => ina2xx.rst} (97%)
 rename Documentation/hwmon/{ina3221 => ina3221.rst} (100%)
 create mode 100644 Documentation/hwmon/index.rst
 rename Documentation/hwmon/{ir35221 => ir35221.rst} (100%)
 rename Documentation/hwmon/{it87 => it87.rst} (100%)
 rename Documentation/hwmon/{jc42 => jc42.rst} (100%)
 rename Documentation/hwmon/{k10temp => k10temp.rst} (100%)
 rename Documentation/hwmon/{k8temp => k8temp.rst} (100%)
 rename Documentation/hwmon/{lineage-pem => lineage-pem.rst} (100%)
 rename Documentation/hwmon/{lm25066 => lm25066.rst} (97%)
 rename Documentation/hwmon/{lm63 => lm63.rst} (100%)
 rename Documentation/hwmon/{lm70 => lm70.rst} (100%)
 rename Documentation/hwmon/{lm73 => lm73.rst} (100%)
 rename Documentation/hwmon/{lm75 => lm75.rst} (100%)
 rename Documentation/hwmon/{lm77 => lm77.rst} (100%)
 rename Documentation/hwmon/{lm78 => lm78.rst} (100%)
 rename Documentation/hwmon/{lm80 => lm80.rst} (100%)
 rename Documentation/hwmon/{lm83 => lm83.rst} (100%)
 rename Documentation/hwmon/{lm85 => lm85.rst} (100%)
 rename Documentation/hwmon/{lm87 => lm87.rst} (100%)
 rename Documentation/hwmon/{lm90 => lm90.rst} (100%)
 rename Documentation/hwmon/{lm92 => lm92.rst} (100%)
 rename Documentation/hwmon/{lm93 => lm93.rst} (100%)
 rename Documentation/hwmon/{lm95234 => lm95234.rst} (100%)
 rename Documentation/hwmon/{lm95245 => lm95245.rst} (100%)
 rename Documentation/hwmon/{ltc2945 => ltc2945.rst} (100%)
 rename Documentation/hwmon/{ltc2978 => ltc2978.rst} (100%)
 rename Documentation/hwmon/{ltc2990 => ltc2990.rst} (100%)
 rename Documentation/hwmon/{ltc3815 => ltc3815.rst} (100%)
 rename Documentation/hwmon/{ltc4151 => ltc4151.rst} (100%)
 rename Documentation/hwmon/{ltc4215 => ltc4215.rst} (100%)
 rename Documentation/hwmon/{ltc4245 => ltc4245.rst} (100%)
 rename Documentation/hwmon/{ltc4260 => ltc4260.rst} (100%)
 rename Documentation/hwmon/{ltc4261 => ltc4261.rst} (100%)
 rename Documentation/hwmon/{max16064 => max16064.rst} (96%)
 rename Documentation/hwmon/{max16065 => max16065.rst} (100%)
 rename Documentation/hwmon/{max1619 => max1619.rst} (100%)
 rename Documentation/hwmon/{max1668 => max1668.rst} (100%)
 rename Documentation/hwmon/{max197 => max197.rst} (100%)
 rename Documentation/hwmon/{max20751 => max20751.rst} (96%)
 rename Documentation/hwmon/{max31722 => max31722.rst} (100%)
 rename Documentation/hwmon/{max31785 => max31785.rst} (100%)
 rename Documentation/hwmon/{max31790 => max31790.rst} (100%)
 rename Documentation/hwmon/{max34440 => max34440.rst} (98%)
 rename Documentation/hwmon/{max6639 => max6639.rst} (100%)
 rename Documentation/hwmon/{max6642 => max6642.rst} (100%)
 rename Documentation/hwmon/{max6650 => max6650.rst} (100%)
 rename Documentation/hwmon/{max6697 => max6697.rst} (100%)
 rename Documentation/hwmon/{max8688 => max8688.rst} (97%)
 rename Documentation/hwmon/{mc13783-adc => mc13783-adc.rst} (100%)
 rename Documentation/hwmon/{mcp3021 => mcp3021.rst} (100%)
 rename Documentation/hwmon/{menf21bmc => menf21bmc.rst} (100%)
 rename Documentation/hwmon/{mlxreg-fan => mlxreg-fan.rst} (100%)
 rename Documentation/hwmon/{nct6683 => nct6683.rst} (100%)
 rename Documentation/hwmon/{nct6775 => nct6775.rst} (100%)
 rename Documentation/hwmon/{nct7802 => nct7802.rst} (100%)
 rename Documentation/hwmon/{nct7904 => nct7904.rst} (100%)
 rename Documentation/hwmon/{npcm750-pwm-fan => npcm750-pwm-fan.rst} (100%)
 rename Documentation/hwmon/{nsa320 => nsa320.rst} (100%)
 rename Documentation/hwmon/{ntc_thermistor => ntc_thermistor.rst} (100%)
 rename Documentation/hwmon/{occ => occ.rst} (100%)
 rename Documentation/hwmon/{pc87360 => pc87360.rst} (100%)
 rename Documentation/hwmon/{pc87427 => pc87427.rst} (100%)
 rename Documentation/hwmon/{pcf8591 => pcf8591.rst} (100%)
 rename Documentation/hwmon/{pmbus-core => pmbus-core.rst} (100%)
 rename Documentation/hwmon/{pmbus => pmbus.rst} (100%)
 rename Documentation/hwmon/{powr1220 => powr1220.rst} (100%)
 rename Documentation/hwmon/{pwm-fan => pwm-fan.rst} (100%)
 rename Documentation/hwmon/{raspberrypi-hwmon => raspberrypi-hwmon.rst} (100%)
 rename Documentation/hwmon/{sch5627 => sch5627.rst} (100%)
 rename Documentation/hwmon/{sch5636 => sch5636.rst} (100%)
 rename Documentation/hwmon/{scpi-hwmon => scpi-hwmon.rst} (100%)
 rename Documentation/hwmon/{sht15 => sht15.rst} (100%)
 rename Documentation/hwmon/{sht21 => sht21.rst} (100%)
 rename Documentation/hwmon/{sht3x => sht3x.rst} (100%)
 rename Documentation/hwmon/{shtc1 => shtc1.rst} (100%)
 rename Documentation/hwmon/{sis5595 => sis5595.rst} (100%)
 rename Documentation/hwmon/{smm665 => smm665.rst} (100%)
 rename Documentation/hwmon/{smsc47b397 => smsc47b397.rst} (100%)
 rename Documentation/hwmon/{smsc47m1 => smsc47m1.rst} (100%)
 rename Documentation/hwmon/{smsc47m192 => smsc47m192.rst} (100%)
 rename Documentation/hwmon/{submitting-patches => submitting-patches.rst} (98%)
 rename Documentation/hwmon/{sysfs-interface => sysfs-interface.rst} (100%)
 rename Documentation/hwmon/{tc654 => tc654.rst} (100%)
 rename Documentation/hwmon/{tc74 => tc74.rst} (100%)
 rename Documentation/hwmon/{thmc50 => thmc50.rst} (100%)
 rename Documentation/hwmon/{tmp102 => tmp102.rst} (93%)
 rename Documentation/hwmon/{tmp103 => tmp103.rst} (92%)
 rename Documentation/hwmon/{tmp108 => tmp108.rst} (95%)
 rename Documentation/hwmon/{tmp401 => tmp401.rst} (97%)
 rename Documentation/hwmon/{tmp421 => tmp421.rst} (100%)
 rename Documentation/hwmon/{tps40422 => tps40422.rst} (96%)
 rename Documentation/hwmon/{twl4030-madc-hwmon => twl4030-madc-hwmon.rst} (100%)
 rename Documentation/hwmon/{ucd9000 => ucd9000.rst} (97%)
 rename Documentation/hwmon/{ucd9200 => ucd9200.rst} (97%)
 rename Documentation/hwmon/{userspace-tools => userspace-tools.rst} (100%)
 rename Documentation/hwmon/{vexpress => vexpress.rst} (100%)
 rename Documentation/hwmon/{via686a => via686a.rst} (100%)
 rename Documentation/hwmon/{vt1211 => vt1211.rst} (100%)
 rename Documentation/hwmon/{w83627ehf => w83627ehf.rst} (100%)
 rename Documentation/hwmon/{w83627hf => w83627hf.rst} (100%)
 rename Documentation/hwmon/{w83773g => w83773g.rst} (100%)
 rename Documentation/hwmon/{w83781d => w83781d.rst} (100%)
 rename Documentation/hwmon/{w83791d => w83791d.rst} (99%)
 rename Documentation/hwmon/{w83792d => w83792d.rst} (100%)
 rename Documentation/hwmon/{w83793 => w83793.rst} (100%)
 rename Documentation/hwmon/{w83795 => w83795.rst} (100%)
 rename Documentation/hwmon/{w83l785ts => w83l785ts.rst} (100%)
 rename Documentation/hwmon/{w83l786ng => w83l786ng.rst} (100%)
 rename Documentation/hwmon/{wm831x => wm831x.rst} (100%)
 rename Documentation/hwmon/{wm8350 => wm8350.rst} (100%)
 rename Documentation/hwmon/{xgene-hwmon => xgene-hwmon.rst} (100%)
 rename Documentation/hwmon/{zl6100 => zl6100.rst} (98%)

diff --git a/Documentation/devicetree/bindings/hwmon/g762.txt b/Documentation/devicetree/bindings/hwmon/g762.txt
index 25cc6d8ee575..6d154c4923de 100644
--- a/Documentation/devicetree/bindings/hwmon/g762.txt
+++ b/Documentation/devicetree/bindings/hwmon/g762.txt
@@ -21,7 +21,7 @@ If an optional property is not set in .dts file, then current value is kept
 unmodified (e.g. u-boot installed value).
 
 Additional information on operational parameters for the device is available
-in Documentation/hwmon/g762. A detailed datasheet for the device is available
+in Documentation/hwmon/g762.rst. A detailed datasheet for the device is available
 at http://natisbad.org/NAS/refs/GMT_EDS-762_763-080710-0.2.pdf.
 
 Example g762 node:
diff --git a/Documentation/hwmon/ab8500 b/Documentation/hwmon/ab8500.rst
similarity index 86%
rename from Documentation/hwmon/ab8500
rename to Documentation/hwmon/ab8500.rst
index d87c61151239..33f93a9cec04 100644
--- a/Documentation/hwmon/ab8500
+++ b/Documentation/hwmon/ab8500.rst
@@ -18,7 +18,7 @@ Authors:
 Description
 -----------
 
-See also Documentation/hwmon/abx500. This is the ST-Ericsson AB8500 specific
+See also Documentation/hwmon/abx500.rst. This is the ST-Ericsson AB8500 specific
 driver.
 
 Currently only the AB8500 internal sensor and one external sensor for battery
diff --git a/Documentation/hwmon/abituguru-datasheet b/Documentation/hwmon/abituguru-datasheet.rst
similarity index 100%
rename from Documentation/hwmon/abituguru-datasheet
rename to Documentation/hwmon/abituguru-datasheet.rst
diff --git a/Documentation/hwmon/abituguru b/Documentation/hwmon/abituguru.rst
similarity index 100%
rename from Documentation/hwmon/abituguru
rename to Documentation/hwmon/abituguru.rst
diff --git a/Documentation/hwmon/abituguru3 b/Documentation/hwmon/abituguru3.rst
similarity index 100%
rename from Documentation/hwmon/abituguru3
rename to Documentation/hwmon/abituguru3.rst
diff --git a/Documentation/hwmon/abx500 b/Documentation/hwmon/abx500.rst
similarity index 100%
rename from Documentation/hwmon/abx500
rename to Documentation/hwmon/abx500.rst
diff --git a/Documentation/hwmon/acpi_power_meter b/Documentation/hwmon/acpi_power_meter.rst
similarity index 97%
rename from Documentation/hwmon/acpi_power_meter
rename to Documentation/hwmon/acpi_power_meter.rst
index 7665ca6ba957..4a0941ade0ca 100644
--- a/Documentation/hwmon/acpi_power_meter
+++ b/Documentation/hwmon/acpi_power_meter.rst
@@ -21,7 +21,7 @@ the ACPI 4.0 spec (Chapter 10.4).  These devices have a simple set of
 features--a power meter that returns average power use over a configurable
 interval, an optional capping mechanism, and a couple of trip points.  The
 sysfs interface conforms with the specification outlined in the "Power" section
-of Documentation/hwmon/sysfs-interface.
+of Documentation/hwmon/sysfs-interface.rst.
 
 Special Features
 ----------------
diff --git a/Documentation/hwmon/ad7314 b/Documentation/hwmon/ad7314.rst
similarity index 100%
rename from Documentation/hwmon/ad7314
rename to Documentation/hwmon/ad7314.rst
diff --git a/Documentation/hwmon/adc128d818 b/Documentation/hwmon/adc128d818.rst
similarity index 100%
rename from Documentation/hwmon/adc128d818
rename to Documentation/hwmon/adc128d818.rst
diff --git a/Documentation/hwmon/adm1021 b/Documentation/hwmon/adm1021.rst
similarity index 100%
rename from Documentation/hwmon/adm1021
rename to Documentation/hwmon/adm1021.rst
diff --git a/Documentation/hwmon/adm1025 b/Documentation/hwmon/adm1025.rst
similarity index 100%
rename from Documentation/hwmon/adm1025
rename to Documentation/hwmon/adm1025.rst
diff --git a/Documentation/hwmon/adm1026 b/Documentation/hwmon/adm1026.rst
similarity index 100%
rename from Documentation/hwmon/adm1026
rename to Documentation/hwmon/adm1026.rst
diff --git a/Documentation/hwmon/adm1031 b/Documentation/hwmon/adm1031.rst
similarity index 100%
rename from Documentation/hwmon/adm1031
rename to Documentation/hwmon/adm1031.rst
diff --git a/Documentation/hwmon/adm1275 b/Documentation/hwmon/adm1275.rst
similarity index 97%
rename from Documentation/hwmon/adm1275
rename to Documentation/hwmon/adm1275.rst
index 5c5860011d6e..9a1913e5b4d9 100644
--- a/Documentation/hwmon/adm1275
+++ b/Documentation/hwmon/adm1275.rst
@@ -68,7 +68,7 @@ integrated 12 bit analog-to-digital converter (ADC), accessed using a
 PMBus interface.
 
 The driver is a client driver to the core PMBus driver. Please see
-Documentation/hwmon/pmbus for details on PMBus client drivers.
+Documentation/hwmon/pmbus.rst for details on PMBus client drivers.
 
 
 Usage Notes
@@ -90,7 +90,7 @@ Platform data support
 ---------------------
 
 The driver supports standard PMBus driver platform data. Please see
-Documentation/hwmon/pmbus for details.
+Documentation/hwmon/pmbus.rst for details.
 
 
 Sysfs entries
diff --git a/Documentation/hwmon/adm9240 b/Documentation/hwmon/adm9240.rst
similarity index 100%
rename from Documentation/hwmon/adm9240
rename to Documentation/hwmon/adm9240.rst
diff --git a/Documentation/hwmon/ads1015 b/Documentation/hwmon/ads1015.rst
similarity index 100%
rename from Documentation/hwmon/ads1015
rename to Documentation/hwmon/ads1015.rst
diff --git a/Documentation/hwmon/ads7828 b/Documentation/hwmon/ads7828.rst
similarity index 100%
rename from Documentation/hwmon/ads7828
rename to Documentation/hwmon/ads7828.rst
diff --git a/Documentation/hwmon/adt7410 b/Documentation/hwmon/adt7410.rst
similarity index 100%
rename from Documentation/hwmon/adt7410
rename to Documentation/hwmon/adt7410.rst
diff --git a/Documentation/hwmon/adt7411 b/Documentation/hwmon/adt7411.rst
similarity index 100%
rename from Documentation/hwmon/adt7411
rename to Documentation/hwmon/adt7411.rst
diff --git a/Documentation/hwmon/adt7462 b/Documentation/hwmon/adt7462.rst
similarity index 100%
rename from Documentation/hwmon/adt7462
rename to Documentation/hwmon/adt7462.rst
diff --git a/Documentation/hwmon/adt7470 b/Documentation/hwmon/adt7470.rst
similarity index 100%
rename from Documentation/hwmon/adt7470
rename to Documentation/hwmon/adt7470.rst
diff --git a/Documentation/hwmon/adt7475 b/Documentation/hwmon/adt7475.rst
similarity index 100%
rename from Documentation/hwmon/adt7475
rename to Documentation/hwmon/adt7475.rst
diff --git a/Documentation/hwmon/amc6821 b/Documentation/hwmon/amc6821.rst
similarity index 100%
rename from Documentation/hwmon/amc6821
rename to Documentation/hwmon/amc6821.rst
diff --git a/Documentation/hwmon/asb100 b/Documentation/hwmon/asb100.rst
similarity index 100%
rename from Documentation/hwmon/asb100
rename to Documentation/hwmon/asb100.rst
diff --git a/Documentation/hwmon/asc7621 b/Documentation/hwmon/asc7621.rst
similarity index 100%
rename from Documentation/hwmon/asc7621
rename to Documentation/hwmon/asc7621.rst
diff --git a/Documentation/hwmon/aspeed-pwm-tacho b/Documentation/hwmon/aspeed-pwm-tacho.rst
similarity index 100%
rename from Documentation/hwmon/aspeed-pwm-tacho
rename to Documentation/hwmon/aspeed-pwm-tacho.rst
diff --git a/Documentation/hwmon/coretemp b/Documentation/hwmon/coretemp.rst
similarity index 100%
rename from Documentation/hwmon/coretemp
rename to Documentation/hwmon/coretemp.rst
diff --git a/Documentation/hwmon/da9052 b/Documentation/hwmon/da9052.rst
similarity index 100%
rename from Documentation/hwmon/da9052
rename to Documentation/hwmon/da9052.rst
diff --git a/Documentation/hwmon/da9055 b/Documentation/hwmon/da9055.rst
similarity index 100%
rename from Documentation/hwmon/da9055
rename to Documentation/hwmon/da9055.rst
diff --git a/Documentation/hwmon/dme1737 b/Documentation/hwmon/dme1737.rst
similarity index 100%
rename from Documentation/hwmon/dme1737
rename to Documentation/hwmon/dme1737.rst
diff --git a/Documentation/hwmon/ds1621 b/Documentation/hwmon/ds1621.rst
similarity index 100%
rename from Documentation/hwmon/ds1621
rename to Documentation/hwmon/ds1621.rst
diff --git a/Documentation/hwmon/ds620 b/Documentation/hwmon/ds620.rst
similarity index 100%
rename from Documentation/hwmon/ds620
rename to Documentation/hwmon/ds620.rst
diff --git a/Documentation/hwmon/emc1403 b/Documentation/hwmon/emc1403.rst
similarity index 100%
rename from Documentation/hwmon/emc1403
rename to Documentation/hwmon/emc1403.rst
diff --git a/Documentation/hwmon/emc2103 b/Documentation/hwmon/emc2103.rst
similarity index 100%
rename from Documentation/hwmon/emc2103
rename to Documentation/hwmon/emc2103.rst
diff --git a/Documentation/hwmon/emc6w201 b/Documentation/hwmon/emc6w201.rst
similarity index 100%
rename from Documentation/hwmon/emc6w201
rename to Documentation/hwmon/emc6w201.rst
diff --git a/Documentation/hwmon/f71805f b/Documentation/hwmon/f71805f.rst
similarity index 100%
rename from Documentation/hwmon/f71805f
rename to Documentation/hwmon/f71805f.rst
diff --git a/Documentation/hwmon/f71882fg b/Documentation/hwmon/f71882fg.rst
similarity index 100%
rename from Documentation/hwmon/f71882fg
rename to Documentation/hwmon/f71882fg.rst
diff --git a/Documentation/hwmon/fam15h_power b/Documentation/hwmon/fam15h_power.rst
similarity index 100%
rename from Documentation/hwmon/fam15h_power
rename to Documentation/hwmon/fam15h_power.rst
diff --git a/Documentation/hwmon/ftsteutates b/Documentation/hwmon/ftsteutates.rst
similarity index 100%
rename from Documentation/hwmon/ftsteutates
rename to Documentation/hwmon/ftsteutates.rst
diff --git a/Documentation/hwmon/g760a b/Documentation/hwmon/g760a.rst
similarity index 100%
rename from Documentation/hwmon/g760a
rename to Documentation/hwmon/g760a.rst
diff --git a/Documentation/hwmon/g762 b/Documentation/hwmon/g762.rst
similarity index 97%
rename from Documentation/hwmon/g762
rename to Documentation/hwmon/g762.rst
index 54574e26df21..0371b3365c48 100644
--- a/Documentation/hwmon/g762
+++ b/Documentation/hwmon/g762.rst
@@ -7,7 +7,7 @@ modes - PWM or DC - are supported by the device.
 
 For additional information, a detailed datasheet is available at
 http://natisbad.org/NAS/ref/GMT_EDS-762_763-080710-0.2.pdf. sysfs
-bindings are described in Documentation/hwmon/sysfs-interface.
+bindings are described in Documentation/hwmon/sysfs-interface.rst.
 
 The following entries are available to the user in a subdirectory of
 /sys/bus/i2c/drivers/g762/ to control the operation of the device.
diff --git a/Documentation/hwmon/gl518sm b/Documentation/hwmon/gl518sm.rst
similarity index 100%
rename from Documentation/hwmon/gl518sm
rename to Documentation/hwmon/gl518sm.rst
diff --git a/Documentation/hwmon/hih6130 b/Documentation/hwmon/hih6130.rst
similarity index 100%
rename from Documentation/hwmon/hih6130
rename to Documentation/hwmon/hih6130.rst
diff --git a/Documentation/hwmon/hwmon-kernel-api.txt b/Documentation/hwmon/hwmon-kernel-api.rst
similarity index 99%
rename from Documentation/hwmon/hwmon-kernel-api.txt
rename to Documentation/hwmon/hwmon-kernel-api.rst
index b56343f5c2c4..5766bee64153 100644
--- a/Documentation/hwmon/hwmon-kernel-api.txt
+++ b/Documentation/hwmon/hwmon-kernel-api.rst
@@ -12,10 +12,10 @@ drivers that want to use the hardware monitoring framework.
 This document does not describe what a hardware monitoring (hwmon) Driver or
 Device is. It also does not describe the API which can be used by user space
 to communicate with a hardware monitoring device. If you want to know this
-then please read the following file: Documentation/hwmon/sysfs-interface.
+then please read the following file: Documentation/hwmon/sysfs-interface.rst.
 
 For additional guidelines on how to write and improve hwmon drivers, please
-also read Documentation/hwmon/submitting-patches.
+also read Documentation/hwmon/submitting-patches.rst.
 
 The API
 -------
diff --git a/Documentation/hwmon/ibm-cffps b/Documentation/hwmon/ibm-cffps.rst
similarity index 100%
rename from Documentation/hwmon/ibm-cffps
rename to Documentation/hwmon/ibm-cffps.rst
diff --git a/Documentation/hwmon/ibmaem b/Documentation/hwmon/ibmaem.rst
similarity index 100%
rename from Documentation/hwmon/ibmaem
rename to Documentation/hwmon/ibmaem.rst
diff --git a/Documentation/hwmon/ibmpowernv b/Documentation/hwmon/ibmpowernv.rst
similarity index 100%
rename from Documentation/hwmon/ibmpowernv
rename to Documentation/hwmon/ibmpowernv.rst
diff --git a/Documentation/hwmon/ina209 b/Documentation/hwmon/ina209.rst
similarity index 100%
rename from Documentation/hwmon/ina209
rename to Documentation/hwmon/ina209.rst
diff --git a/Documentation/hwmon/ina2xx b/Documentation/hwmon/ina2xx.rst
similarity index 97%
rename from Documentation/hwmon/ina2xx
rename to Documentation/hwmon/ina2xx.rst
index 95badf9c396f..94b9a260c518 100644
--- a/Documentation/hwmon/ina2xx
+++ b/Documentation/hwmon/ina2xx.rst
@@ -78,7 +78,7 @@ refer to the Documentation/devicetree/bindings/hwmon/ina2xx.txt for bindings
 if the device tree is used.
 
 Additionally ina226 supports update_interval attribute as described in
-Documentation/hwmon/sysfs-interface. Internally the interval is the sum of
+Documentation/hwmon/sysfs-interface.rst. Internally the interval is the sum of
 bus and shunt voltage conversion times multiplied by the averaging rate. We
 don't touch the conversion times and only modify the number of averages. The
 lower limit of the update_interval is 2 ms, the upper limit is 2253 ms.
diff --git a/Documentation/hwmon/ina3221 b/Documentation/hwmon/ina3221.rst
similarity index 100%
rename from Documentation/hwmon/ina3221
rename to Documentation/hwmon/ina3221.rst
diff --git a/Documentation/hwmon/index.rst b/Documentation/hwmon/index.rst
new file mode 100644
index 000000000000..893804414510
--- /dev/null
+++ b/Documentation/hwmon/index.rst
@@ -0,0 +1,179 @@
+=========================
+Linux Hardware Monitoring
+=========================
+
+.. toctree::
+   :maxdepth: 1
+
+   hwmon-kernel-api.rst
+   pmbus-core.rst
+   submitting-patches.rst
+   sysfs-interface.rst
+   userspace-tools.rst
+
+Hardware Monitoring Kernel Drivers
+==================================
+
+.. toctree::
+   :maxdepth: 1
+
+   ab8500.rst
+   abituguru.rst
+   abituguru3.rst
+   abx500.rst
+   acpi_power_meter.rst
+   ad7314.rst
+   adc128d818.rst
+   adm1021.rst
+   adm1025.rst
+   adm1026.rst
+   adm1031.rst
+   adm1275.rst
+   adm9240.rst
+   ads1015.rst
+   ads7828.rst
+   adt7410.rst
+   adt7411.rst
+   adt7462.rst
+   adt7470.rst
+   adt7475.rst
+   amc6821.rst
+   asb100.rst
+   asc7621.rst
+   aspeed-pwm-tacho.rst
+   coretemp.rst
+   da9052.rst
+   da9055.rst
+   dme1737.rst
+   ds1621.rst
+   ds620.rst
+   emc1403.rst
+   emc2103.rst
+   emc6w201.rst
+   f71805f.rst
+   f71882fg.rst
+   fam15h_power.rst
+   ftsteutates.rst
+   g760a.rst
+   g762.rst
+   gl518sm.rst
+   hih6130.rst
+   ibmaem.rst
+   ibm-cffps.rst
+   ibmpowernv.rst
+   ina209.rst
+   ina2xx.rst
+   ina3221.rst
+   ir35221.rst
+   it87.rst
+   jc42.rst
+   k10temp.rst
+   k8temp.rst
+   lineage-pem.rst
+   lm25066.rst
+   lm63.rst
+   lm70.rst
+   lm73.rst
+   lm75.rst
+   lm77.rst
+   lm78.rst
+   lm80.rst
+   lm83.rst
+   lm85.rst
+   lm87.rst
+   lm90.rst
+   lm92.rst
+   lm93.rst
+   lm95234.rst
+   lm95245.rst
+   ltc2945.rst
+   ltc2978.rst
+   ltc2990.rst
+   ltc3815.rst
+   ltc4151.rst
+   ltc4215.rst
+   ltc4245.rst
+   ltc4260.rst
+   ltc4261.rst
+   max16064.rst
+   max16065.rst
+   max1619.rst
+   max1668.rst
+   max197.rst
+   max20751.rst
+   max31722.rst
+   max31785.rst
+   max31790.rst
+   max34440.rst
+   max6639.rst
+   max6642.rst
+   max6650.rst
+   max6697.rst
+   max8688.rst
+   mc13783-adc.rst
+   mcp3021.rst
+   menf21bmc.rst
+   mlxreg-fan.rst
+   nct6683.rst
+   nct6775.rst
+   nct7802.rst
+   nct7904.rst
+   npcm750-pwm-fan.rst
+   nsa320.rst
+   ntc_thermistor.rst
+   occ.rst
+   pc87360.rst
+   pc87427.rst
+   pcf8591.rst
+   pmbus.rst
+   powr1220.rst
+   pwm-fan.rst
+   raspberrypi-hwmon.rst
+   sch5627.rst
+   sch5636.rst
+   scpi-hwmon.rst
+   sht15.rst
+   sht21.rst
+   sht3x.rst
+   shtc1.rst
+   sis5595.rst
+   smm665.rst
+   smsc47b397.rst
+   smsc47m192.rst
+   smsc47m1.rst
+   tc654.rst
+   tc74.rst
+   thmc50.rst
+   tmp102.rst
+   tmp103.rst
+   tmp108.rst
+   tmp401.rst
+   tmp421.rst
+   tps40422.rst
+   twl4030-madc-hwmon.rst
+   ucd9000.rst
+   ucd9200.rst
+   vexpress.rst
+   via686a.rst
+   vt1211.rst
+   w83627ehf.rst
+   w83627hf.rst
+   w83773g.rst
+   w83781d.rst
+   w83791d.rst
+   w83792d.rst
+   w83793.rst
+   w83795.rst
+   w83l785ts.rst
+   w83l786ng.rst
+   wm831x.rst
+   wm8350.rst
+   xgene-hwmon.rst
+   zl6100.rst
+
+.. only::  subproject and html
+
+   Indices
+   =======
+
+   * :ref:`genindex`
diff --git a/Documentation/hwmon/ir35221 b/Documentation/hwmon/ir35221.rst
similarity index 100%
rename from Documentation/hwmon/ir35221
rename to Documentation/hwmon/ir35221.rst
diff --git a/Documentation/hwmon/it87 b/Documentation/hwmon/it87.rst
similarity index 100%
rename from Documentation/hwmon/it87
rename to Documentation/hwmon/it87.rst
diff --git a/Documentation/hwmon/jc42 b/Documentation/hwmon/jc42.rst
similarity index 100%
rename from Documentation/hwmon/jc42
rename to Documentation/hwmon/jc42.rst
diff --git a/Documentation/hwmon/k10temp b/Documentation/hwmon/k10temp.rst
similarity index 100%
rename from Documentation/hwmon/k10temp
rename to Documentation/hwmon/k10temp.rst
diff --git a/Documentation/hwmon/k8temp b/Documentation/hwmon/k8temp.rst
similarity index 100%
rename from Documentation/hwmon/k8temp
rename to Documentation/hwmon/k8temp.rst
diff --git a/Documentation/hwmon/lineage-pem b/Documentation/hwmon/lineage-pem.rst
similarity index 100%
rename from Documentation/hwmon/lineage-pem
rename to Documentation/hwmon/lineage-pem.rst
diff --git a/Documentation/hwmon/lm25066 b/Documentation/hwmon/lm25066.rst
similarity index 97%
rename from Documentation/hwmon/lm25066
rename to Documentation/hwmon/lm25066.rst
index 60b7f2722931..da15e3094c8c 100644
--- a/Documentation/hwmon/lm25066
+++ b/Documentation/hwmon/lm25066.rst
@@ -69,7 +69,7 @@ LM25066, LM5064, and LM5066/LM5066I Power Management, Monitoring,
 Control, and Protection ICs.
 
 The driver is a client driver to the core PMBus driver. Please see
-Documentation/hwmon/pmbus for details on PMBus client drivers.
+Documentation/hwmon/pmbus.rst for details on PMBus client drivers.
 
 
 Usage Notes
diff --git a/Documentation/hwmon/lm63 b/Documentation/hwmon/lm63.rst
similarity index 100%
rename from Documentation/hwmon/lm63
rename to Documentation/hwmon/lm63.rst
diff --git a/Documentation/hwmon/lm70 b/Documentation/hwmon/lm70.rst
similarity index 100%
rename from Documentation/hwmon/lm70
rename to Documentation/hwmon/lm70.rst
diff --git a/Documentation/hwmon/lm73 b/Documentation/hwmon/lm73.rst
similarity index 100%
rename from Documentation/hwmon/lm73
rename to Documentation/hwmon/lm73.rst
diff --git a/Documentation/hwmon/lm75 b/Documentation/hwmon/lm75.rst
similarity index 100%
rename from Documentation/hwmon/lm75
rename to Documentation/hwmon/lm75.rst
diff --git a/Documentation/hwmon/lm77 b/Documentation/hwmon/lm77.rst
similarity index 100%
rename from Documentation/hwmon/lm77
rename to Documentation/hwmon/lm77.rst
diff --git a/Documentation/hwmon/lm78 b/Documentation/hwmon/lm78.rst
similarity index 100%
rename from Documentation/hwmon/lm78
rename to Documentation/hwmon/lm78.rst
diff --git a/Documentation/hwmon/lm80 b/Documentation/hwmon/lm80.rst
similarity index 100%
rename from Documentation/hwmon/lm80
rename to Documentation/hwmon/lm80.rst
diff --git a/Documentation/hwmon/lm83 b/Documentation/hwmon/lm83.rst
similarity index 100%
rename from Documentation/hwmon/lm83
rename to Documentation/hwmon/lm83.rst
diff --git a/Documentation/hwmon/lm85 b/Documentation/hwmon/lm85.rst
similarity index 100%
rename from Documentation/hwmon/lm85
rename to Documentation/hwmon/lm85.rst
diff --git a/Documentation/hwmon/lm87 b/Documentation/hwmon/lm87.rst
similarity index 100%
rename from Documentation/hwmon/lm87
rename to Documentation/hwmon/lm87.rst
diff --git a/Documentation/hwmon/lm90 b/Documentation/hwmon/lm90.rst
similarity index 100%
rename from Documentation/hwmon/lm90
rename to Documentation/hwmon/lm90.rst
diff --git a/Documentation/hwmon/lm92 b/Documentation/hwmon/lm92.rst
similarity index 100%
rename from Documentation/hwmon/lm92
rename to Documentation/hwmon/lm92.rst
diff --git a/Documentation/hwmon/lm93 b/Documentation/hwmon/lm93.rst
similarity index 100%
rename from Documentation/hwmon/lm93
rename to Documentation/hwmon/lm93.rst
diff --git a/Documentation/hwmon/lm95234 b/Documentation/hwmon/lm95234.rst
similarity index 100%
rename from Documentation/hwmon/lm95234
rename to Documentation/hwmon/lm95234.rst
diff --git a/Documentation/hwmon/lm95245 b/Documentation/hwmon/lm95245.rst
similarity index 100%
rename from Documentation/hwmon/lm95245
rename to Documentation/hwmon/lm95245.rst
diff --git a/Documentation/hwmon/ltc2945 b/Documentation/hwmon/ltc2945.rst
similarity index 100%
rename from Documentation/hwmon/ltc2945
rename to Documentation/hwmon/ltc2945.rst
diff --git a/Documentation/hwmon/ltc2978 b/Documentation/hwmon/ltc2978.rst
similarity index 100%
rename from Documentation/hwmon/ltc2978
rename to Documentation/hwmon/ltc2978.rst
diff --git a/Documentation/hwmon/ltc2990 b/Documentation/hwmon/ltc2990.rst
similarity index 100%
rename from Documentation/hwmon/ltc2990
rename to Documentation/hwmon/ltc2990.rst
diff --git a/Documentation/hwmon/ltc3815 b/Documentation/hwmon/ltc3815.rst
similarity index 100%
rename from Documentation/hwmon/ltc3815
rename to Documentation/hwmon/ltc3815.rst
diff --git a/Documentation/hwmon/ltc4151 b/Documentation/hwmon/ltc4151.rst
similarity index 100%
rename from Documentation/hwmon/ltc4151
rename to Documentation/hwmon/ltc4151.rst
diff --git a/Documentation/hwmon/ltc4215 b/Documentation/hwmon/ltc4215.rst
similarity index 100%
rename from Documentation/hwmon/ltc4215
rename to Documentation/hwmon/ltc4215.rst
diff --git a/Documentation/hwmon/ltc4245 b/Documentation/hwmon/ltc4245.rst
similarity index 100%
rename from Documentation/hwmon/ltc4245
rename to Documentation/hwmon/ltc4245.rst
diff --git a/Documentation/hwmon/ltc4260 b/Documentation/hwmon/ltc4260.rst
similarity index 100%
rename from Documentation/hwmon/ltc4260
rename to Documentation/hwmon/ltc4260.rst
diff --git a/Documentation/hwmon/ltc4261 b/Documentation/hwmon/ltc4261.rst
similarity index 100%
rename from Documentation/hwmon/ltc4261
rename to Documentation/hwmon/ltc4261.rst
diff --git a/Documentation/hwmon/max16064 b/Documentation/hwmon/max16064.rst
similarity index 96%
rename from Documentation/hwmon/max16064
rename to Documentation/hwmon/max16064.rst
index 61ec679dc477..6d5e9538991f 100644
--- a/Documentation/hwmon/max16064
+++ b/Documentation/hwmon/max16064.rst
@@ -21,7 +21,7 @@ This driver supports hardware monitoring for Maxim MAX16064 Quad Power-Supply
 Controller with Active-Voltage Output Control and PMBus Interface.
 
 The driver is a client driver to the core PMBus driver.
-Please see Documentation/hwmon/pmbus for details on PMBus client drivers.
+Please see Documentation/hwmon/pmbus.rst for details on PMBus client drivers.
 
 
 Usage Notes
diff --git a/Documentation/hwmon/max16065 b/Documentation/hwmon/max16065.rst
similarity index 100%
rename from Documentation/hwmon/max16065
rename to Documentation/hwmon/max16065.rst
diff --git a/Documentation/hwmon/max1619 b/Documentation/hwmon/max1619.rst
similarity index 100%
rename from Documentation/hwmon/max1619
rename to Documentation/hwmon/max1619.rst
diff --git a/Documentation/hwmon/max1668 b/Documentation/hwmon/max1668.rst
similarity index 100%
rename from Documentation/hwmon/max1668
rename to Documentation/hwmon/max1668.rst
diff --git a/Documentation/hwmon/max197 b/Documentation/hwmon/max197.rst
similarity index 100%
rename from Documentation/hwmon/max197
rename to Documentation/hwmon/max197.rst
diff --git a/Documentation/hwmon/max20751 b/Documentation/hwmon/max20751.rst
similarity index 96%
rename from Documentation/hwmon/max20751
rename to Documentation/hwmon/max20751.rst
index d546695900ef..aa4469be6674 100644
--- a/Documentation/hwmon/max20751
+++ b/Documentation/hwmon/max20751.rst
@@ -23,7 +23,7 @@ This driver supports MAX20751 Multiphase Master with PMBus Interface
 and Internal Buck Converter.
 
 The driver is a client driver to the core PMBus driver.
-Please see Documentation/hwmon/pmbus for details on PMBus client drivers.
+Please see Documentation/hwmon/pmbus.rst for details on PMBus client drivers.
 
 
 Usage Notes
diff --git a/Documentation/hwmon/max31722 b/Documentation/hwmon/max31722.rst
similarity index 100%
rename from Documentation/hwmon/max31722
rename to Documentation/hwmon/max31722.rst
diff --git a/Documentation/hwmon/max31785 b/Documentation/hwmon/max31785.rst
similarity index 100%
rename from Documentation/hwmon/max31785
rename to Documentation/hwmon/max31785.rst
diff --git a/Documentation/hwmon/max31790 b/Documentation/hwmon/max31790.rst
similarity index 100%
rename from Documentation/hwmon/max31790
rename to Documentation/hwmon/max31790.rst
diff --git a/Documentation/hwmon/max34440 b/Documentation/hwmon/max34440.rst
similarity index 98%
rename from Documentation/hwmon/max34440
rename to Documentation/hwmon/max34440.rst
index 639838ef29fd..939138e12b02 100644
--- a/Documentation/hwmon/max34440
+++ b/Documentation/hwmon/max34440.rst
@@ -76,7 +76,7 @@ based on GIN pins. The MAX34460 supports 12 voltage channels, and the MAX34461
 supports 16 voltage channels.
 
 The driver is a client driver to the core PMBus driver. Please see
-Documentation/hwmon/pmbus for details on PMBus client drivers.
+Documentation/hwmon/pmbus.rst for details on PMBus client drivers.
 
 
 Usage Notes
diff --git a/Documentation/hwmon/max6639 b/Documentation/hwmon/max6639.rst
similarity index 100%
rename from Documentation/hwmon/max6639
rename to Documentation/hwmon/max6639.rst
diff --git a/Documentation/hwmon/max6642 b/Documentation/hwmon/max6642.rst
similarity index 100%
rename from Documentation/hwmon/max6642
rename to Documentation/hwmon/max6642.rst
diff --git a/Documentation/hwmon/max6650 b/Documentation/hwmon/max6650.rst
similarity index 100%
rename from Documentation/hwmon/max6650
rename to Documentation/hwmon/max6650.rst
diff --git a/Documentation/hwmon/max6697 b/Documentation/hwmon/max6697.rst
similarity index 100%
rename from Documentation/hwmon/max6697
rename to Documentation/hwmon/max6697.rst
diff --git a/Documentation/hwmon/max8688 b/Documentation/hwmon/max8688.rst
similarity index 97%
rename from Documentation/hwmon/max8688
rename to Documentation/hwmon/max8688.rst
index 43da139234c1..009487759c61 100644
--- a/Documentation/hwmon/max8688
+++ b/Documentation/hwmon/max8688.rst
@@ -21,7 +21,7 @@ This driver supports hardware monitoring for Maxim MAX8688 Digital Power-Supply
 Controller/Monitor with PMBus Interface.
 
 The driver is a client driver to the core PMBus driver. Please see
-Documentation/hwmon/pmbus for details on PMBus client drivers.
+Documentation/hwmon/pmbus.rst for details on PMBus client drivers.
 
 
 Usage Notes
diff --git a/Documentation/hwmon/mc13783-adc b/Documentation/hwmon/mc13783-adc.rst
similarity index 100%
rename from Documentation/hwmon/mc13783-adc
rename to Documentation/hwmon/mc13783-adc.rst
diff --git a/Documentation/hwmon/mcp3021 b/Documentation/hwmon/mcp3021.rst
similarity index 100%
rename from Documentation/hwmon/mcp3021
rename to Documentation/hwmon/mcp3021.rst
diff --git a/Documentation/hwmon/menf21bmc b/Documentation/hwmon/menf21bmc.rst
similarity index 100%
rename from Documentation/hwmon/menf21bmc
rename to Documentation/hwmon/menf21bmc.rst
diff --git a/Documentation/hwmon/mlxreg-fan b/Documentation/hwmon/mlxreg-fan.rst
similarity index 100%
rename from Documentation/hwmon/mlxreg-fan
rename to Documentation/hwmon/mlxreg-fan.rst
diff --git a/Documentation/hwmon/nct6683 b/Documentation/hwmon/nct6683.rst
similarity index 100%
rename from Documentation/hwmon/nct6683
rename to Documentation/hwmon/nct6683.rst
diff --git a/Documentation/hwmon/nct6775 b/Documentation/hwmon/nct6775.rst
similarity index 100%
rename from Documentation/hwmon/nct6775
rename to Documentation/hwmon/nct6775.rst
diff --git a/Documentation/hwmon/nct7802 b/Documentation/hwmon/nct7802.rst
similarity index 100%
rename from Documentation/hwmon/nct7802
rename to Documentation/hwmon/nct7802.rst
diff --git a/Documentation/hwmon/nct7904 b/Documentation/hwmon/nct7904.rst
similarity index 100%
rename from Documentation/hwmon/nct7904
rename to Documentation/hwmon/nct7904.rst
diff --git a/Documentation/hwmon/npcm750-pwm-fan b/Documentation/hwmon/npcm750-pwm-fan.rst
similarity index 100%
rename from Documentation/hwmon/npcm750-pwm-fan
rename to Documentation/hwmon/npcm750-pwm-fan.rst
diff --git a/Documentation/hwmon/nsa320 b/Documentation/hwmon/nsa320.rst
similarity index 100%
rename from Documentation/hwmon/nsa320
rename to Documentation/hwmon/nsa320.rst
diff --git a/Documentation/hwmon/ntc_thermistor b/Documentation/hwmon/ntc_thermistor.rst
similarity index 100%
rename from Documentation/hwmon/ntc_thermistor
rename to Documentation/hwmon/ntc_thermistor.rst
diff --git a/Documentation/hwmon/occ b/Documentation/hwmon/occ.rst
similarity index 100%
rename from Documentation/hwmon/occ
rename to Documentation/hwmon/occ.rst
diff --git a/Documentation/hwmon/pc87360 b/Documentation/hwmon/pc87360.rst
similarity index 100%
rename from Documentation/hwmon/pc87360
rename to Documentation/hwmon/pc87360.rst
diff --git a/Documentation/hwmon/pc87427 b/Documentation/hwmon/pc87427.rst
similarity index 100%
rename from Documentation/hwmon/pc87427
rename to Documentation/hwmon/pc87427.rst
diff --git a/Documentation/hwmon/pcf8591 b/Documentation/hwmon/pcf8591.rst
similarity index 100%
rename from Documentation/hwmon/pcf8591
rename to Documentation/hwmon/pcf8591.rst
diff --git a/Documentation/hwmon/pmbus-core b/Documentation/hwmon/pmbus-core.rst
similarity index 100%
rename from Documentation/hwmon/pmbus-core
rename to Documentation/hwmon/pmbus-core.rst
diff --git a/Documentation/hwmon/pmbus b/Documentation/hwmon/pmbus.rst
similarity index 100%
rename from Documentation/hwmon/pmbus
rename to Documentation/hwmon/pmbus.rst
diff --git a/Documentation/hwmon/powr1220 b/Documentation/hwmon/powr1220.rst
similarity index 100%
rename from Documentation/hwmon/powr1220
rename to Documentation/hwmon/powr1220.rst
diff --git a/Documentation/hwmon/pwm-fan b/Documentation/hwmon/pwm-fan.rst
similarity index 100%
rename from Documentation/hwmon/pwm-fan
rename to Documentation/hwmon/pwm-fan.rst
diff --git a/Documentation/hwmon/raspberrypi-hwmon b/Documentation/hwmon/raspberrypi-hwmon.rst
similarity index 100%
rename from Documentation/hwmon/raspberrypi-hwmon
rename to Documentation/hwmon/raspberrypi-hwmon.rst
diff --git a/Documentation/hwmon/sch5627 b/Documentation/hwmon/sch5627.rst
similarity index 100%
rename from Documentation/hwmon/sch5627
rename to Documentation/hwmon/sch5627.rst
diff --git a/Documentation/hwmon/sch5636 b/Documentation/hwmon/sch5636.rst
similarity index 100%
rename from Documentation/hwmon/sch5636
rename to Documentation/hwmon/sch5636.rst
diff --git a/Documentation/hwmon/scpi-hwmon b/Documentation/hwmon/scpi-hwmon.rst
similarity index 100%
rename from Documentation/hwmon/scpi-hwmon
rename to Documentation/hwmon/scpi-hwmon.rst
diff --git a/Documentation/hwmon/sht15 b/Documentation/hwmon/sht15.rst
similarity index 100%
rename from Documentation/hwmon/sht15
rename to Documentation/hwmon/sht15.rst
diff --git a/Documentation/hwmon/sht21 b/Documentation/hwmon/sht21.rst
similarity index 100%
rename from Documentation/hwmon/sht21
rename to Documentation/hwmon/sht21.rst
diff --git a/Documentation/hwmon/sht3x b/Documentation/hwmon/sht3x.rst
similarity index 100%
rename from Documentation/hwmon/sht3x
rename to Documentation/hwmon/sht3x.rst
diff --git a/Documentation/hwmon/shtc1 b/Documentation/hwmon/shtc1.rst
similarity index 100%
rename from Documentation/hwmon/shtc1
rename to Documentation/hwmon/shtc1.rst
diff --git a/Documentation/hwmon/sis5595 b/Documentation/hwmon/sis5595.rst
similarity index 100%
rename from Documentation/hwmon/sis5595
rename to Documentation/hwmon/sis5595.rst
diff --git a/Documentation/hwmon/smm665 b/Documentation/hwmon/smm665.rst
similarity index 100%
rename from Documentation/hwmon/smm665
rename to Documentation/hwmon/smm665.rst
diff --git a/Documentation/hwmon/smsc47b397 b/Documentation/hwmon/smsc47b397.rst
similarity index 100%
rename from Documentation/hwmon/smsc47b397
rename to Documentation/hwmon/smsc47b397.rst
diff --git a/Documentation/hwmon/smsc47m1 b/Documentation/hwmon/smsc47m1.rst
similarity index 100%
rename from Documentation/hwmon/smsc47m1
rename to Documentation/hwmon/smsc47m1.rst
diff --git a/Documentation/hwmon/smsc47m192 b/Documentation/hwmon/smsc47m192.rst
similarity index 100%
rename from Documentation/hwmon/smsc47m192
rename to Documentation/hwmon/smsc47m192.rst
diff --git a/Documentation/hwmon/submitting-patches b/Documentation/hwmon/submitting-patches.rst
similarity index 98%
rename from Documentation/hwmon/submitting-patches
rename to Documentation/hwmon/submitting-patches.rst
index 12540b7d9b50..f9796b9d9db6 100644
--- a/Documentation/hwmon/submitting-patches
+++ b/Documentation/hwmon/submitting-patches.rst
@@ -39,7 +39,7 @@ increase the chances of your change being accepted.
 2. Adding functionality to existing drivers
 -------------------------------------------
 
-* Make sure the documentation in Documentation/hwmon/<driver_name> is up to
+* Make sure the documentation in Documentation/hwmon/<driver_name>.rst is up to
   date.
 
 * Make sure the information in Kconfig is up to date.
@@ -61,7 +61,7 @@ increase the chances of your change being accepted.
 
 * Consider adding yourself to MAINTAINERS.
 
-* Document the driver in Documentation/hwmon/<driver_name>.
+* Document the driver in Documentation/hwmon/<driver_name>.rst.
 
 * Add the driver to Kconfig and Makefile in alphabetical order.
 
@@ -134,7 +134,7 @@ increase the chances of your change being accepted.
   non-standard attributes, or you believe you do, discuss it on the mailing list
   first. Either case, provide a detailed explanation why you need the
   non-standard attribute(s).
-  Standard attributes are specified in Documentation/hwmon/sysfs-interface.
+  Standard attributes are specified in Documentation/hwmon/sysfs-interface.rst.
 
 * When deciding which sysfs attributes to support, look at the chip's
   capabilities. While we do not expect your driver to support everything the
diff --git a/Documentation/hwmon/sysfs-interface b/Documentation/hwmon/sysfs-interface.rst
similarity index 100%
rename from Documentation/hwmon/sysfs-interface
rename to Documentation/hwmon/sysfs-interface.rst
diff --git a/Documentation/hwmon/tc654 b/Documentation/hwmon/tc654.rst
similarity index 100%
rename from Documentation/hwmon/tc654
rename to Documentation/hwmon/tc654.rst
diff --git a/Documentation/hwmon/tc74 b/Documentation/hwmon/tc74.rst
similarity index 100%
rename from Documentation/hwmon/tc74
rename to Documentation/hwmon/tc74.rst
diff --git a/Documentation/hwmon/thmc50 b/Documentation/hwmon/thmc50.rst
similarity index 100%
rename from Documentation/hwmon/thmc50
rename to Documentation/hwmon/thmc50.rst
diff --git a/Documentation/hwmon/tmp102 b/Documentation/hwmon/tmp102.rst
similarity index 93%
rename from Documentation/hwmon/tmp102
rename to Documentation/hwmon/tmp102.rst
index 5e34821df4ab..b1f585531a88 100644
--- a/Documentation/hwmon/tmp102
+++ b/Documentation/hwmon/tmp102.rst
@@ -28,4 +28,4 @@ The TMP102 has a programmable update rate that can select between 8, 4, 1, and
 0.5 Hz. (Currently the driver only supports the default of 4 Hz).
 
 The driver provides the common sysfs-interface for temperatures (see
-Documentation/hwmon/sysfs-interface under Temperatures).
+Documentation/hwmon/sysfs-interface.rst under Temperatures).
diff --git a/Documentation/hwmon/tmp103 b/Documentation/hwmon/tmp103.rst
similarity index 92%
rename from Documentation/hwmon/tmp103
rename to Documentation/hwmon/tmp103.rst
index 7682a795e38c..15d25806d585 100644
--- a/Documentation/hwmon/tmp103
+++ b/Documentation/hwmon/tmp103.rst
@@ -27,7 +27,7 @@ Resolution: 8 Bits
 Accuracy: ±1°C Typ (–10°C to +100°C)
 
 The driver provides the common sysfs-interface for temperatures (see
-Documentation/hwmon/sysfs-interface under Temperatures).
+Documentation/hwmon/sysfs-interface.rst under Temperatures).
 
 Please refer how to instantiate this driver:
 Documentation/i2c/instantiating-devices
diff --git a/Documentation/hwmon/tmp108 b/Documentation/hwmon/tmp108.rst
similarity index 95%
rename from Documentation/hwmon/tmp108
rename to Documentation/hwmon/tmp108.rst
index 7e08b7ef1e2f..5f4266a16cb2 100644
--- a/Documentation/hwmon/tmp108
+++ b/Documentation/hwmon/tmp108.rst
@@ -38,4 +38,4 @@ and then the device is shut down automatically. (This driver only supports
 continuous mode.)
 
 The driver provides the common sysfs-interface for temperatures (see
-Documentation/hwmon/sysfs-interface under Temperatures).
+Documentation/hwmon/sysfs-interface.rst under Temperatures).
diff --git a/Documentation/hwmon/tmp401 b/Documentation/hwmon/tmp401.rst
similarity index 97%
rename from Documentation/hwmon/tmp401
rename to Documentation/hwmon/tmp401.rst
index bd865bbdb38d..6a05a0719bc7 100644
--- a/Documentation/hwmon/tmp401
+++ b/Documentation/hwmon/tmp401.rst
@@ -68,7 +68,7 @@ supported by the driver so far, so using the default resolution of 0.5
 degree).
 
 The driver provides the common sysfs-interface for temperatures (see
-Documentation/hwmon/sysfs-interface under Temperatures).
+Documentation/hwmon/sysfs-interface.rst under Temperatures).
 
 The TMP411 and TMP431 chips are compatible with TMP401. TMP411 provides
 some additional features.
diff --git a/Documentation/hwmon/tmp421 b/Documentation/hwmon/tmp421.rst
similarity index 100%
rename from Documentation/hwmon/tmp421
rename to Documentation/hwmon/tmp421.rst
diff --git a/Documentation/hwmon/tps40422 b/Documentation/hwmon/tps40422.rst
similarity index 96%
rename from Documentation/hwmon/tps40422
rename to Documentation/hwmon/tps40422.rst
index 359751eb5ed4..b691e30479dd 100644
--- a/Documentation/hwmon/tps40422
+++ b/Documentation/hwmon/tps40422.rst
@@ -21,7 +21,7 @@ This driver supports TI TPS40422 Dual-Output or Two-Phase Synchronous Buck
 Controller with PMBus
 
 The driver is a client driver to the core PMBus driver.
-Please see Documentation/hwmon/pmbus for details on PMBus client drivers.
+Please see Documentation/hwmon/pmbus.rst for details on PMBus client drivers.
 
 
 Usage Notes
diff --git a/Documentation/hwmon/twl4030-madc-hwmon b/Documentation/hwmon/twl4030-madc-hwmon.rst
similarity index 100%
rename from Documentation/hwmon/twl4030-madc-hwmon
rename to Documentation/hwmon/twl4030-madc-hwmon.rst
diff --git a/Documentation/hwmon/ucd9000 b/Documentation/hwmon/ucd9000.rst
similarity index 97%
rename from Documentation/hwmon/ucd9000
rename to Documentation/hwmon/ucd9000.rst
index d69061b7312c..ebc4f2b3bfea 100644
--- a/Documentation/hwmon/ucd9000
+++ b/Documentation/hwmon/ucd9000.rst
@@ -57,7 +57,7 @@ system-health monitor. The device integrates a 12-bit ADC for monitoring up to
 13 power-supply voltage, current, or temperature inputs.
 
 This driver is a client driver to the core PMBus driver. Please see
-Documentation/hwmon/pmbus for details on PMBus client drivers.
+Documentation/hwmon/pmbus.rst for details on PMBus client drivers.
 
 
 Usage Notes
@@ -72,7 +72,7 @@ Platform data support
 ---------------------
 
 The driver supports standard PMBus driver platform data. Please see
-Documentation/hwmon/pmbus for details.
+Documentation/hwmon/pmbus.rst for details.
 
 
 Sysfs entries
diff --git a/Documentation/hwmon/ucd9200 b/Documentation/hwmon/ucd9200.rst
similarity index 97%
rename from Documentation/hwmon/ucd9200
rename to Documentation/hwmon/ucd9200.rst
index 44eda4a579b6..b819dfd75f71 100644
--- a/Documentation/hwmon/ucd9200
+++ b/Documentation/hwmon/ucd9200.rst
@@ -33,7 +33,7 @@ dedicated circuitry for DC/DC loop management with flash memory and a serial
 interface to support configuration, monitoring and management.
 
 This driver is a client driver to the core PMBus driver. Please see
-Documentation/hwmon/pmbus for details on PMBus client drivers.
+Documentation/hwmon/pmbus.rst for details on PMBus client drivers.
 
 
 Usage Notes
@@ -48,7 +48,7 @@ Platform data support
 ---------------------
 
 The driver supports standard PMBus driver platform data. Please see
-Documentation/hwmon/pmbus for details.
+Documentation/hwmon/pmbus.rst for details.
 
 
 Sysfs entries
diff --git a/Documentation/hwmon/userspace-tools b/Documentation/hwmon/userspace-tools.rst
similarity index 100%
rename from Documentation/hwmon/userspace-tools
rename to Documentation/hwmon/userspace-tools.rst
diff --git a/Documentation/hwmon/vexpress b/Documentation/hwmon/vexpress.rst
similarity index 100%
rename from Documentation/hwmon/vexpress
rename to Documentation/hwmon/vexpress.rst
diff --git a/Documentation/hwmon/via686a b/Documentation/hwmon/via686a.rst
similarity index 100%
rename from Documentation/hwmon/via686a
rename to Documentation/hwmon/via686a.rst
diff --git a/Documentation/hwmon/vt1211 b/Documentation/hwmon/vt1211.rst
similarity index 100%
rename from Documentation/hwmon/vt1211
rename to Documentation/hwmon/vt1211.rst
diff --git a/Documentation/hwmon/w83627ehf b/Documentation/hwmon/w83627ehf.rst
similarity index 100%
rename from Documentation/hwmon/w83627ehf
rename to Documentation/hwmon/w83627ehf.rst
diff --git a/Documentation/hwmon/w83627hf b/Documentation/hwmon/w83627hf.rst
similarity index 100%
rename from Documentation/hwmon/w83627hf
rename to Documentation/hwmon/w83627hf.rst
diff --git a/Documentation/hwmon/w83773g b/Documentation/hwmon/w83773g.rst
similarity index 100%
rename from Documentation/hwmon/w83773g
rename to Documentation/hwmon/w83773g.rst
diff --git a/Documentation/hwmon/w83781d b/Documentation/hwmon/w83781d.rst
similarity index 100%
rename from Documentation/hwmon/w83781d
rename to Documentation/hwmon/w83781d.rst
diff --git a/Documentation/hwmon/w83791d b/Documentation/hwmon/w83791d.rst
similarity index 99%
rename from Documentation/hwmon/w83791d
rename to Documentation/hwmon/w83791d.rst
index a91f9e5fb0c6..3adaed39b157 100644
--- a/Documentation/hwmon/w83791d
+++ b/Documentation/hwmon/w83791d.rst
@@ -102,7 +102,7 @@ This file is used for both legacy and new code.
 
 The sysfs interface to the beep bitmask has migrated from the original legacy
 method of a single sysfs beep_mask file to a newer method using multiple
-`*_beep` files as described in `Documentation/hwmon/sysfs-interface`.
+`*_beep` files as described in `Documentation/hwmon/sysfs-interface.rst`.
 
 A similar change has occurred for the bitmap corresponding to the alarms. The
 original legacy method used a single sysfs alarms file containing a bitmap
diff --git a/Documentation/hwmon/w83792d b/Documentation/hwmon/w83792d.rst
similarity index 100%
rename from Documentation/hwmon/w83792d
rename to Documentation/hwmon/w83792d.rst
diff --git a/Documentation/hwmon/w83793 b/Documentation/hwmon/w83793.rst
similarity index 100%
rename from Documentation/hwmon/w83793
rename to Documentation/hwmon/w83793.rst
diff --git a/Documentation/hwmon/w83795 b/Documentation/hwmon/w83795.rst
similarity index 100%
rename from Documentation/hwmon/w83795
rename to Documentation/hwmon/w83795.rst
diff --git a/Documentation/hwmon/w83l785ts b/Documentation/hwmon/w83l785ts.rst
similarity index 100%
rename from Documentation/hwmon/w83l785ts
rename to Documentation/hwmon/w83l785ts.rst
diff --git a/Documentation/hwmon/w83l786ng b/Documentation/hwmon/w83l786ng.rst
similarity index 100%
rename from Documentation/hwmon/w83l786ng
rename to Documentation/hwmon/w83l786ng.rst
diff --git a/Documentation/hwmon/wm831x b/Documentation/hwmon/wm831x.rst
similarity index 100%
rename from Documentation/hwmon/wm831x
rename to Documentation/hwmon/wm831x.rst
diff --git a/Documentation/hwmon/wm8350 b/Documentation/hwmon/wm8350.rst
similarity index 100%
rename from Documentation/hwmon/wm8350
rename to Documentation/hwmon/wm8350.rst
diff --git a/Documentation/hwmon/xgene-hwmon b/Documentation/hwmon/xgene-hwmon.rst
similarity index 100%
rename from Documentation/hwmon/xgene-hwmon
rename to Documentation/hwmon/xgene-hwmon.rst
diff --git a/Documentation/hwmon/zl6100 b/Documentation/hwmon/zl6100.rst
similarity index 98%
rename from Documentation/hwmon/zl6100
rename to Documentation/hwmon/zl6100.rst
index 4029970bace4..41513bb7fe51 100644
--- a/Documentation/hwmon/zl6100
+++ b/Documentation/hwmon/zl6100.rst
@@ -113,7 +113,7 @@ This driver supports hardware monitoring for Intersil / Zilker Labs ZL6100 and
 compatible digital DC-DC controllers.
 
 The driver is a client driver to the core PMBus driver. Please see
-Documentation/hwmon/pmbus and Documentation.hwmon/pmbus-core for details
+Documentation/hwmon/pmbus.rst and Documentation.hwmon/pmbus-core for details
 on PMBus client drivers.
 
 
diff --git a/Documentation/index.rst b/Documentation/index.rst
index 80a421cb935e..3a710dc24fc8 100644
--- a/Documentation/index.rst
+++ b/Documentation/index.rst
@@ -83,6 +83,7 @@ needed).
    media/index
    networking/index
    input/index
+   hwmon/index
    gpu/index
    security/index
    sound/index
diff --git a/Documentation/thermal/sysfs-api.txt b/Documentation/thermal/sysfs-api.txt
index 911399730c1c..c3fa500df92c 100644
--- a/Documentation/thermal/sysfs-api.txt
+++ b/Documentation/thermal/sysfs-api.txt
@@ -316,7 +316,7 @@ ACPI thermal zones.
     |---temp[1-*]_input:	The current temperature of thermal zone [1-*]
     |---temp[1-*]_critical:	The critical trip point of thermal zone [1-*]
 
-Please read Documentation/hwmon/sysfs-interface for additional information.
+Please read Documentation/hwmon/sysfs-interface.rst for additional information.
 
 ***************************
 * Thermal zone attributes *
diff --git a/MAINTAINERS b/MAINTAINERS
index dc615cb76455..d258fb8e7e8e 100644
--- a/MAINTAINERS
+++ b/MAINTAINERS
@@ -468,7 +468,7 @@ ADM1025 HARDWARE MONITOR DRIVER
 M:	Jean Delvare <jdelvare@suse.com>
 L:	linux-hwmon@vger.kernel.org
 S:	Maintained
-F:	Documentation/hwmon/adm1025
+F:	Documentation/hwmon/adm1025.rst
 F:	drivers/hwmon/adm1025.c
 
 ADM1029 HARDWARE MONITOR DRIVER
@@ -520,7 +520,7 @@ ADS1015 HARDWARE MONITOR DRIVER
 M:	Dirk Eibach <eibach@gdsys.de>
 L:	linux-hwmon@vger.kernel.org
 S:	Maintained
-F:	Documentation/hwmon/ads1015
+F:	Documentation/hwmon/ads1015.rst
 F:	drivers/hwmon/ads1015.c
 F:	include/linux/platform_data/ads1015.h
 
@@ -533,7 +533,7 @@ ADT7475 HARDWARE MONITOR DRIVER
 M:	Jean Delvare <jdelvare@suse.com>
 L:	linux-hwmon@vger.kernel.org
 S:	Maintained
-F:	Documentation/hwmon/adt7475
+F:	Documentation/hwmon/adt7475.rst
 F:	drivers/hwmon/adt7475.c
 
 ADVANSYS SCSI DRIVER
@@ -764,7 +764,7 @@ AMD FAM15H PROCESSOR POWER MONITORING DRIVER
 M:	Huang Rui <ray.huang@amd.com>
 L:	linux-hwmon@vger.kernel.org
 S:	Supported
-F:	Documentation/hwmon/fam15h_power
+F:	Documentation/hwmon/fam15h_power.rst
 F:	drivers/hwmon/fam15h_power.c
 
 AMD FCH GPIO DRIVER
@@ -2512,7 +2512,7 @@ ASC7621 HARDWARE MONITOR DRIVER
 M:	George Joseph <george.joseph@fairview5.com>
 L:	linux-hwmon@vger.kernel.org
 S:	Maintained
-F:	Documentation/hwmon/asc7621
+F:	Documentation/hwmon/asc7621.rst
 F:	drivers/hwmon/asc7621.c
 
 ASPEED VIDEO ENGINE DRIVER
@@ -4043,7 +4043,7 @@ CORETEMP HARDWARE MONITORING DRIVER
 M:	Fenghua Yu <fenghua.yu@intel.com>
 L:	linux-hwmon@vger.kernel.org
 S:	Maintained
-F:	Documentation/hwmon/coretemp
+F:	Documentation/hwmon/coretemp.rst
 F:	drivers/hwmon/coretemp.c
 
 COSA/SRP SYNC SERIAL DRIVER
@@ -4598,7 +4598,7 @@ DIALOG SEMICONDUCTOR DRIVERS
 M:	Support Opensource <support.opensource@diasemi.com>
 W:	http://www.dialog-semiconductor.com/products
 S:	Supported
-F:	Documentation/hwmon/da90??
+F:	Documentation/hwmon/da90??.rst
 F:	Documentation/devicetree/bindings/mfd/da90*.txt
 F:	Documentation/devicetree/bindings/input/da90??-onkey.txt
 F:	Documentation/devicetree/bindings/thermal/da90??-thermal.txt
@@ -4749,7 +4749,7 @@ DME1737 HARDWARE MONITOR DRIVER
 M:	Juerg Haefliger <juergh@gmail.com>
 L:	linux-hwmon@vger.kernel.org
 S:	Maintained
-F:	Documentation/hwmon/dme1737
+F:	Documentation/hwmon/dme1737.rst
 F:	drivers/hwmon/dme1737.c
 
 DMI/SMBIOS SUPPORT
@@ -5935,7 +5935,7 @@ F71805F HARDWARE MONITORING DRIVER
 M:	Jean Delvare <jdelvare@suse.com>
 L:	linux-hwmon@vger.kernel.org
 S:	Maintained
-F:	Documentation/hwmon/f71805f
+F:	Documentation/hwmon/f71805f.rst
 F:	drivers/hwmon/f71805f.c
 
 FADDR2LINE
@@ -7618,7 +7618,7 @@ INA209 HARDWARE MONITOR DRIVER
 M:	Guenter Roeck <linux@roeck-us.net>
 L:	linux-hwmon@vger.kernel.org
 S:	Maintained
-F:	Documentation/hwmon/ina209
+F:	Documentation/hwmon/ina209.rst
 F:	Documentation/devicetree/bindings/hwmon/ina2xx.txt
 F:	drivers/hwmon/ina209.c
 
@@ -7626,7 +7626,7 @@ INA2XX HARDWARE MONITOR DRIVER
 M:	Guenter Roeck <linux@roeck-us.net>
 L:	linux-hwmon@vger.kernel.org
 S:	Maintained
-F:	Documentation/hwmon/ina2xx
+F:	Documentation/hwmon/ina2xx.rst
 F:	drivers/hwmon/ina2xx.c
 F:	include/linux/platform_data/ina2xx.h
 
@@ -8244,7 +8244,7 @@ IT87 HARDWARE MONITORING DRIVER
 M:	Jean Delvare <jdelvare@suse.com>
 L:	linux-hwmon@vger.kernel.org
 S:	Maintained
-F:	Documentation/hwmon/it87
+F:	Documentation/hwmon/it87.rst
 F:	drivers/hwmon/it87.c
 
 IT913X MEDIA DRIVER
@@ -8288,7 +8288,7 @@ M:	Guenter Roeck <linux@roeck-us.net>
 L:	linux-hwmon@vger.kernel.org
 S:	Maintained
 F:	drivers/hwmon/jc42.c
-F:	Documentation/hwmon/jc42
+F:	Documentation/hwmon/jc42.rst
 
 JFS FILESYSTEM
 M:	Dave Kleikamp <shaggy@kernel.org>
@@ -8336,14 +8336,14 @@ K10TEMP HARDWARE MONITORING DRIVER
 M:	Clemens Ladisch <clemens@ladisch.de>
 L:	linux-hwmon@vger.kernel.org
 S:	Maintained
-F:	Documentation/hwmon/k10temp
+F:	Documentation/hwmon/k10temp.rst
 F:	drivers/hwmon/k10temp.c
 
 K8TEMP HARDWARE MONITORING DRIVER
 M:	Rudolf Marek <r.marek@assembler.cz>
 L:	linux-hwmon@vger.kernel.org
 S:	Maintained
-F:	Documentation/hwmon/k8temp
+F:	Documentation/hwmon/k8temp.rst
 F:	drivers/hwmon/k8temp.c
 
 KASAN
@@ -9034,21 +9034,21 @@ LM78 HARDWARE MONITOR DRIVER
 M:	Jean Delvare <jdelvare@suse.com>
 L:	linux-hwmon@vger.kernel.org
 S:	Maintained
-F:	Documentation/hwmon/lm78
+F:	Documentation/hwmon/lm78.rst
 F:	drivers/hwmon/lm78.c
 
 LM83 HARDWARE MONITOR DRIVER
 M:	Jean Delvare <jdelvare@suse.com>
 L:	linux-hwmon@vger.kernel.org
 S:	Maintained
-F:	Documentation/hwmon/lm83
+F:	Documentation/hwmon/lm83.rst
 F:	drivers/hwmon/lm83.c
 
 LM90 HARDWARE MONITOR DRIVER
 M:	Jean Delvare <jdelvare@suse.com>
 L:	linux-hwmon@vger.kernel.org
 S:	Maintained
-F:	Documentation/hwmon/lm90
+F:	Documentation/hwmon/lm90.rst
 F:	Documentation/devicetree/bindings/hwmon/lm90.txt
 F:	drivers/hwmon/lm90.c
 F:	include/dt-bindings/thermal/lm90.h
@@ -9057,7 +9057,7 @@ LM95234 HARDWARE MONITOR DRIVER
 M:	Guenter Roeck <linux@roeck-us.net>
 L:	linux-hwmon@vger.kernel.org
 S:	Maintained
-F:	Documentation/hwmon/lm95234
+F:	Documentation/hwmon/lm95234.rst
 F:	drivers/hwmon/lm95234.c
 
 LME2510 MEDIA DRIVER
@@ -9131,7 +9131,7 @@ LTC4261 HARDWARE MONITOR DRIVER
 M:	Guenter Roeck <linux@roeck-us.net>
 L:	linux-hwmon@vger.kernel.org
 S:	Maintained
-F:	Documentation/hwmon/ltc4261
+F:	Documentation/hwmon/ltc4261.rst
 F:	drivers/hwmon/ltc4261.c
 
 LTC4306 I2C MULTIPLEXER DRIVER
@@ -9362,7 +9362,7 @@ MAX16065 HARDWARE MONITOR DRIVER
 M:	Guenter Roeck <linux@roeck-us.net>
 L:	linux-hwmon@vger.kernel.org
 S:	Maintained
-F:	Documentation/hwmon/max16065
+F:	Documentation/hwmon/max16065.rst
 F:	drivers/hwmon/max16065.c
 
 MAX2175 SDR TUNER DRIVER
@@ -9378,14 +9378,14 @@ F:	include/uapi/linux/max2175.h
 MAX6650 HARDWARE MONITOR AND FAN CONTROLLER DRIVER
 L:	linux-hwmon@vger.kernel.org
 S:	Orphan
-F:	Documentation/hwmon/max6650
+F:	Documentation/hwmon/max6650.rst
 F:	drivers/hwmon/max6650.c
 
 MAX6697 HARDWARE MONITOR DRIVER
 M:	Guenter Roeck <linux@roeck-us.net>
 L:	linux-hwmon@vger.kernel.org
 S:	Maintained
-F:	Documentation/hwmon/max6697
+F:	Documentation/hwmon/max6697.rst
 F:	Documentation/devicetree/bindings/hwmon/max6697.txt
 F:	drivers/hwmon/max6697.c
 F:	include/linux/platform_data/max6697.h
@@ -10031,7 +10031,7 @@ F:	drivers/mfd/menf21bmc.c
 F:	drivers/watchdog/menf21bmc_wdt.c
 F:	drivers/leds/leds-menf21bmc.c
 F:	drivers/hwmon/menf21bmc_hwmon.c
-F:	Documentation/hwmon/menf21bmc
+F:	Documentation/hwmon/menf21bmc.rst
 
 MEN Z069 WATCHDOG DRIVER
 M:	Johannes Thumshirn <jth@kernel.org>
@@ -10659,7 +10659,7 @@ NCT6775 HARDWARE MONITOR DRIVER
 M:	Guenter Roeck <linux@roeck-us.net>
 L:	linux-hwmon@vger.kernel.org
 S:	Maintained
-F:	Documentation/hwmon/nct6775
+F:	Documentation/hwmon/nct6775.rst
 F:	drivers/hwmon/nct6775.c
 
 NET_FAILOVER MODULE
@@ -11753,7 +11753,7 @@ PC87360 HARDWARE MONITORING DRIVER
 M:	Jim Cromie <jim.cromie@gmail.com>
 L:	linux-hwmon@vger.kernel.org
 S:	Maintained
-F:	Documentation/hwmon/pc87360
+F:	Documentation/hwmon/pc87360.rst
 F:	drivers/hwmon/pc87360.c
 
 PC8736x GPIO DRIVER
@@ -11765,7 +11765,7 @@ PC87427 HARDWARE MONITORING DRIVER
 M:	Jean Delvare <jdelvare@suse.com>
 L:	linux-hwmon@vger.kernel.org
 S:	Maintained
-F:	Documentation/hwmon/pc87427
+F:	Documentation/hwmon/pc87427.rst
 F:	drivers/hwmon/pc87427.c
 
 PCA9532 LED DRIVER
@@ -12333,23 +12333,23 @@ S:	Maintained
 F:	Documentation/devicetree/bindings/hwmon/ibm,cffps1.txt
 F:	Documentation/devicetree/bindings/hwmon/max31785.txt
 F:	Documentation/devicetree/bindings/hwmon/ltc2978.txt
-F:	Documentation/hwmon/adm1275
-F:	Documentation/hwmon/ibm-cffps
-F:	Documentation/hwmon/ir35221
-F:	Documentation/hwmon/lm25066
-F:	Documentation/hwmon/ltc2978
-F:	Documentation/hwmon/ltc3815
-F:	Documentation/hwmon/max16064
-F:	Documentation/hwmon/max20751
-F:	Documentation/hwmon/max31785
-F:	Documentation/hwmon/max34440
-F:	Documentation/hwmon/max8688
-F:	Documentation/hwmon/pmbus
-F:	Documentation/hwmon/pmbus-core
-F:	Documentation/hwmon/tps40422
-F:	Documentation/hwmon/ucd9000
-F:	Documentation/hwmon/ucd9200
-F:	Documentation/hwmon/zl6100
+F:	Documentation/hwmon/adm1275.rst
+F:	Documentation/hwmon/ibm-cffps.rst
+F:	Documentation/hwmon/ir35221.rst
+F:	Documentation/hwmon/lm25066.rst
+F:	Documentation/hwmon/ltc2978.rst
+F:	Documentation/hwmon/ltc3815.rst
+F:	Documentation/hwmon/max16064.rst
+F:	Documentation/hwmon/max20751.rst
+F:	Documentation/hwmon/max31785.rst
+F:	Documentation/hwmon/max34440.rst
+F:	Documentation/hwmon/max8688.rst
+F:	Documentation/hwmon/pmbus.rst
+F:	Documentation/hwmon/pmbus-core.rst
+F:	Documentation/hwmon/tps40422.rst
+F:	Documentation/hwmon/ucd9000.rst
+F:	Documentation/hwmon/ucd9200.rst
+F:	Documentation/hwmon/zl6100.rst
 F:	drivers/hwmon/pmbus/
 F:	include/linux/pmbus.h
 
@@ -12613,7 +12613,7 @@ M:	Bartlomiej Zolnierkiewicz <b.zolnierkie@samsung.com>
 L:	linux-hwmon@vger.kernel.org
 S:	Supported
 F:	Documentation/devicetree/bindings/hwmon/pwm-fan.txt
-F:	Documentation/hwmon/pwm-fan
+F:	Documentation/hwmon/pwm-fan.rst
 F:	drivers/hwmon/pwm-fan.c
 
 PWM IR Transmitter
@@ -14278,21 +14278,21 @@ SMM665 HARDWARE MONITOR DRIVER
 M:	Guenter Roeck <linux@roeck-us.net>
 L:	linux-hwmon@vger.kernel.org
 S:	Maintained
-F:	Documentation/hwmon/smm665
+F:	Documentation/hwmon/smm665.rst
 F:	drivers/hwmon/smm665.c
 
 SMSC EMC2103 HARDWARE MONITOR DRIVER
 M:	Steve Glendinning <steve.glendinning@shawell.net>
 L:	linux-hwmon@vger.kernel.org
 S:	Maintained
-F:	Documentation/hwmon/emc2103
+F:	Documentation/hwmon/emc2103.rst
 F:	drivers/hwmon/emc2103.c
 
 SMSC SCH5627 HARDWARE MONITOR DRIVER
 M:	Hans de Goede <hdegoede@redhat.com>
 L:	linux-hwmon@vger.kernel.org
 S:	Supported
-F:	Documentation/hwmon/sch5627
+F:	Documentation/hwmon/sch5627.rst
 F:	drivers/hwmon/sch5627.c
 
 SMSC UFX6000 and UFX7000 USB to VGA DRIVER
@@ -14305,7 +14305,7 @@ SMSC47B397 HARDWARE MONITOR DRIVER
 M:	Jean Delvare <jdelvare@suse.com>
 L:	linux-hwmon@vger.kernel.org
 S:	Maintained
-F:	Documentation/hwmon/smsc47b397
+F:	Documentation/hwmon/smsc47b397.rst
 F:	drivers/hwmon/smsc47b397.c
 
 SMSC911x ETHERNET DRIVER
@@ -15650,7 +15650,7 @@ TMP401 HARDWARE MONITOR DRIVER
 M:	Guenter Roeck <linux@roeck-us.net>
 L:	linux-hwmon@vger.kernel.org
 S:	Maintained
-F:	Documentation/hwmon/tmp401
+F:	Documentation/hwmon/tmp401.rst
 F:	drivers/hwmon/tmp401.c
 
 TMPFS (SHMEM FILESYSTEM)
@@ -16675,7 +16675,7 @@ VT1211 HARDWARE MONITOR DRIVER
 M:	Juerg Haefliger <juergh@gmail.com>
 L:	linux-hwmon@vger.kernel.org
 S:	Maintained
-F:	Documentation/hwmon/vt1211
+F:	Documentation/hwmon/vt1211.rst
 F:	drivers/hwmon/vt1211.c
 
 VT8231 HARDWARE MONITOR DRIVER
@@ -16703,14 +16703,14 @@ W83791D HARDWARE MONITORING DRIVER
 M:	Marc Hulsman <m.hulsman@tudelft.nl>
 L:	linux-hwmon@vger.kernel.org
 S:	Maintained
-F:	Documentation/hwmon/w83791d
+F:	Documentation/hwmon/w83791d.rst
 F:	drivers/hwmon/w83791d.c
 
 W83793 HARDWARE MONITORING DRIVER
 M:	Rudolf Marek <r.marek@assembler.cz>
 L:	linux-hwmon@vger.kernel.org
 S:	Maintained
-F:	Documentation/hwmon/w83793
+F:	Documentation/hwmon/w83793.rst
 F:	drivers/hwmon/w83793.c
 
 W83795 HARDWARE MONITORING DRIVER
@@ -16819,7 +16819,7 @@ L:	patches@opensource.cirrus.com
 T:	git https://github.com/CirrusLogic/linux-drivers.git
 W:	https://github.com/CirrusLogic/linux-drivers/wiki
 S:	Supported
-F:	Documentation/hwmon/wm83??
+F:	Documentation/hwmon/wm83??.rst
 F:	Documentation/devicetree/bindings/extcon/extcon-arizona.txt
 F:	Documentation/devicetree/bindings/regulator/arizona-regulator.txt
 F:	Documentation/devicetree/bindings/mfd/arizona.txt
diff --git a/drivers/hwmon/Kconfig b/drivers/hwmon/Kconfig
index 6f929bfa9fcd..74c6c95cb657 100644
--- a/drivers/hwmon/Kconfig
+++ b/drivers/hwmon/Kconfig
@@ -17,7 +17,7 @@ menuconfig HWMON
 
 	  To find out which specific driver(s) you need, use the
 	  sensors-detect script from the lm_sensors package.  Read
-	  <file:Documentation/hwmon/userspace-tools> for details.
+	  <file:Documentation/hwmon/userspace-tools.rst> for details.
 
 	  This support can also be built as a module. If so, the module
 	  will be called hwmon.
@@ -59,7 +59,7 @@ config SENSORS_ABITUGURU
 	  chip can be found on Abit uGuru featuring motherboards (most modern
 	  Abit motherboards from before end 2005). For more info and a list
 	  of which motherboards have which revision see
-	  Documentation/hwmon/abituguru
+	  Documentation/hwmon/abituguru.rst
 
 	  This driver can also be built as a module. If so, the module
 	  will be called abituguru.
@@ -73,7 +73,7 @@ config SENSORS_ABITUGURU3
 	  and their settings is supported. The third revision of the Abit
 	  uGuru chip can be found on recent Abit motherboards (since end
 	  2005). For more info and a list of which motherboards have which
-	  revision see Documentation/hwmon/abituguru3
+	  revision see Documentation/hwmon/abituguru3.rst
 
 	  This driver can also be built as a module. If so, the module
 	  will be called abituguru3.
@@ -643,7 +643,7 @@ config SENSORS_CORETEMP
 	help
 	  If you say yes here you get support for the temperature
 	  sensor inside your CPU. Most of the family 6 CPUs
-	  are supported. Check Documentation/hwmon/coretemp for details.
+	  are supported. Check Documentation/hwmon/coretemp.rst for details.
 
 config SENSORS_IT87
 	tristate "ITE IT87xx and compatibles"
diff --git a/drivers/hwmon/ads7828.c b/drivers/hwmon/ads7828.c
index 12c56d3783ed..545b635a104e 100644
--- a/drivers/hwmon/ads7828.c
+++ b/drivers/hwmon/ads7828.c
@@ -8,7 +8,7 @@
  *
  * ADS7830 support, by Guillaume Roguez <guillaume.roguez@savoirfairelinux.com>
  *
- * For further information, see the Documentation/hwmon/ads7828 file.
+ * For further information, see the Documentation/hwmon/ads7828.rst file.
  *
  * This program is free software; you can redistribute it and/or modify
  * it under the terms of the GNU General Public License as published by
diff --git a/drivers/hwmon/max197.c b/drivers/hwmon/max197.c
index 3d9e210beedf..dd6a35219a18 100644
--- a/drivers/hwmon/max197.c
+++ b/drivers/hwmon/max197.c
@@ -8,7 +8,7 @@
  * it under the terms of the GNU General Public License version 2 as
  * published by the Free Software Foundation.
  *
- * For further information, see the Documentation/hwmon/max197 file.
+ * For further information, see the Documentation/hwmon/max197.rst file.
  */
 
 #include <linux/kernel.h>
diff --git a/drivers/hwmon/sht15.c b/drivers/hwmon/sht15.c
index 39b41e35c2bf..7f4a63959730 100644
--- a/drivers/hwmon/sht15.c
+++ b/drivers/hwmon/sht15.c
@@ -10,7 +10,7 @@
  *
  * Copyright (c) 2007 Wouter Horre
  *
- * For further information, see the Documentation/hwmon/sht15 file.
+ * For further information, see the Documentation/hwmon/sht15.rst file.
  */
 
 #include <linux/interrupt.h>
diff --git a/include/linux/platform_data/ads7828.h b/include/linux/platform_data/ads7828.h
index 3245f45f9d77..a3370a007702 100644
--- a/include/linux/platform_data/ads7828.h
+++ b/include/linux/platform_data/ads7828.h
@@ -4,7 +4,7 @@
  * Copyright (c) 2012 Savoir-faire Linux Inc.
  *          Vivien Didelot <vivien.didelot@savoirfairelinux.com>
  *
- * For further information, see the Documentation/hwmon/ads7828 file.
+ * For further information, see the Documentation/hwmon/ads7828.rst file.
  *
  * This program is free software; you can redistribute it and/or modify
  * it under the terms of the GNU General Public License version 2 as
diff --git a/include/linux/platform_data/ds620.h b/include/linux/platform_data/ds620.h
index 6ef58bb77e46..f0ce22a78bb8 100644
--- a/include/linux/platform_data/ds620.h
+++ b/include/linux/platform_data/ds620.h
@@ -14,7 +14,7 @@ struct ds620_platform_data {
 	 *  1 = PO_LOW
 	 *  2 = PO_HIGH
 	 *
-	 * (see Documentation/hwmon/ds620)
+	 * (see Documentation/hwmon/ds620.rst)
 	 */
 	int pomode;
 };
diff --git a/include/linux/platform_data/ina2xx.h b/include/linux/platform_data/ina2xx.h
index 9f0aa1b48c78..dde59fd3590f 100644
--- a/include/linux/platform_data/ina2xx.h
+++ b/include/linux/platform_data/ina2xx.h
@@ -7,7 +7,7 @@
  * it under the terms of the GNU General Public License version 2 as
  * published by the Free Software Foundation.
  *
- * For further information, see the Documentation/hwmon/ina2xx file.
+ * For further information, see the Documentation/hwmon/ina2xx.rst file.
  */
 
 /**
diff --git a/include/linux/platform_data/max197.h b/include/linux/platform_data/max197.h
index 8da8f94ee15c..2bbd0919bc89 100644
--- a/include/linux/platform_data/max197.h
+++ b/include/linux/platform_data/max197.h
@@ -8,7 +8,7 @@
  * it under the terms of the GNU General Public License version 2 as
  * published by the Free Software Foundation.
  *
- * For further information, see the Documentation/hwmon/max197 file.
+ * For further information, see the Documentation/hwmon/max197.rst file.
  */
 
 #ifndef _PDATA_MAX197_H
diff --git a/include/linux/platform_data/ntc_thermistor.h b/include/linux/platform_data/ntc_thermistor.h
index ee03d429742b..5fa115d3ea4b 100644
--- a/include/linux/platform_data/ntc_thermistor.h
+++ b/include/linux/platform_data/ntc_thermistor.h
@@ -42,7 +42,7 @@ struct ntc_thermistor_platform_data {
 	 * read_uV()
 	 *
 	 * How to setup pullup_ohm, pulldown_ohm, and connect is
-	 * described at Documentation/hwmon/ntc_thermistor
+	 * described at Documentation/hwmon/ntc_thermistor.rst
 	 *
 	 * pullup/down_ohm: 0 for infinite / not-connected
 	 *
-- 
2.20.1


^ permalink raw reply related	[flat|nested] 73+ messages in thread

* Re: [PATCH v2 10/21] docs: hwmon: aspeed-pwm-tacho: convert to ReST format
  2019-04-10 19:22 ` [PATCH v2 10/21] docs: hwmon: aspeed-pwm-tacho: " Mauro Carvalho Chehab
@ 2019-04-11  0:27   ` Andrew Jeffery
  0 siblings, 0 replies; 73+ messages in thread
From: Andrew Jeffery @ 2019-04-11  0:27 UTC (permalink / raw)
  To: Mauro Carvalho Chehab, Linux Doc Mailing List
  Cc: Mauro Carvalho Chehab, linux-kernel, Jonathan Corbet,
	Jean Delvare, Guenter Roeck, Joel Stanley, linux-hwmon,
	linux-arm-kernel, linux-aspeed



On Thu, 11 Apr 2019, at 04:54, Mauro Carvalho Chehab wrote:
> Convert aspeed-pwm-tacho to ReST format, in order to allow it to
> be parsed by Sphinx.
> 
> Signed-off-by: Mauro Carvalho Chehab <mchehab+samsung@kernel.org>

Acked-by: Andrew Jeffery <andrew@aj.id.au>

> ---
>  Documentation/hwmon/aspeed-pwm-tacho | 2 ++
>  1 file changed, 2 insertions(+)
> 
> diff --git a/Documentation/hwmon/aspeed-pwm-tacho 
> b/Documentation/hwmon/aspeed-pwm-tacho
> index 7cfb34977460..6dcec845fbc7 100644
> --- a/Documentation/hwmon/aspeed-pwm-tacho
> +++ b/Documentation/hwmon/aspeed-pwm-tacho
> @@ -15,8 +15,10 @@ controller supports up to 16 tachometer inputs.
>  
>  The driver provides the following sensor accesses in sysfs:
>  
> +=============== ======= =====================================================
>  fanX_input	ro	provide current fan rotation value in RPM as reported
>  			by the fan to the device.
>  
>  pwmX		rw	get or set PWM fan control value. This is an integer
>  			value between 0(off) and 255(full speed).
> +=============== ======= =====================================================
> -- 
> 2.20.1
> 
>

^ permalink raw reply	[flat|nested] 73+ messages in thread

* Re: [PATCH v2 02/21] docs: hwmon: vexpress: convert to ReST format
  2019-04-10 19:22 ` [PATCH v2 02/21] docs: hwmon: vexpress: " Mauro Carvalho Chehab
@ 2019-04-11 13:05   ` Liviu Dudau
  0 siblings, 0 replies; 73+ messages in thread
From: Liviu Dudau @ 2019-04-11 13:05 UTC (permalink / raw)
  To: Mauro Carvalho Chehab
  Cc: Linux Doc Mailing List, Mauro Carvalho Chehab, linux-kernel,
	Jonathan Corbet, Jean Delvare, Guenter Roeck, Sudeep Holla,
	Lorenzo Pieralisi, linux-hwmon, linux-arm-kernel

On Wed, Apr 10, 2019 at 04:22:39PM -0300, Mauro Carvalho Chehab wrote:
> Convert vexpress to ReST format, in order to allow it to
> be parsed by Sphinx.
> 
> Signed-off-by: Mauro Carvalho Chehab <mchehab+samsung@kernel.org>

Acked-by: Liviu Dudau <liviu.dudau@arm.com>

Best regards,
Liviu

> ---
>  Documentation/hwmon/vexpress | 13 ++++++++++---
>  1 file changed, 10 insertions(+), 3 deletions(-)
> 
> diff --git a/Documentation/hwmon/vexpress b/Documentation/hwmon/vexpress
> index 557d6d5ad90d..8c861c8151ac 100644
> --- a/Documentation/hwmon/vexpress
> +++ b/Documentation/hwmon/vexpress
> @@ -2,14 +2,21 @@ Kernel driver vexpress
>  ======================
>  
>  Supported systems:
> +
>    * ARM Ltd. Versatile Express platform
> +
>      Prefix: 'vexpress'
> +
>      Datasheets:
> +
>        * "Hardware Description" sections of the Technical Reference Manuals
> -        for the Versatile Express boards:
> -        http://infocenter.arm.com/help/topic/com.arm.doc.subset.boards.express/index.html
> +	for the Versatile Express boards:
> +
> +	- http://infocenter.arm.com/help/topic/com.arm.doc.subset.boards.express/index.html
> +
>        * Section "4.4.14. System Configuration registers" of the V2M-P1 TRM:
> -        http://infocenter.arm.com/help/index.jsp?topic=/com.arm.doc.dui0447-/index.html
> +
> +	- http://infocenter.arm.com/help/index.jsp?topic=/com.arm.doc.dui0447-/index.html
>  
>  Author: Pawel Moll
>  
> -- 
> 2.20.1
> 

-- 
====================
| I would like to |
| fix the world,  |
| but they're not |
| giving me the   |
 \ source code!  /
  ---------------
    ¯\_(ツ)_/¯

^ permalink raw reply	[flat|nested] 73+ messages in thread

* Re: [PATCH v2 21/21] docs: hwmon: Add an index file and rename docs to *.rst
  2019-04-10 19:22 ` [PATCH v2 21/21] docs: hwmon: Add an index file and rename docs to *.rst Mauro Carvalho Chehab
@ 2019-04-11 13:07   ` Liviu Dudau
  0 siblings, 0 replies; 73+ messages in thread
From: Liviu Dudau @ 2019-04-11 13:07 UTC (permalink / raw)
  To: Mauro Carvalho Chehab
  Cc: Linux Doc Mailing List, Mauro Carvalho Chehab, linux-kernel,
	Jonathan Corbet, Jean Delvare, Guenter Roeck, Rob Herring,
	Mark Rutland, Dirk Eibach, George Joseph, Joel Stanley,
	Andrew Jeffery, Fenghua Yu, Support Opensource, Juerg Haefliger,
	Steve Glendinning, Huang Rui, Benjamin Herrenschmidt,
	Paul Mackerras, Michael Ellerman, Clemens Ladisch, Rudolf Marek,
	Andreas Werner, Jim Cromie, Kamil Debski,
	Bartlomiej Zolnierkiewicz, Hans de Goede, Sudeep Holla,
	Lorenzo Pieralisi, Marc Hulsman, linux-hwmon, devicetree,
	linux-arm-kernel, linux-aspeed, linuxppc-dev, patches

On Wed, Apr 10, 2019 at 04:22:58PM -0300, Mauro Carvalho Chehab wrote:
> Now that all files were converted to ReST format, rename them
> and add an index.
> 
> Signed-off-by: Mauro Carvalho Chehab <mchehab+samsung@kernel.org>
> ---
>  .../devicetree/bindings/hwmon/g762.txt        |   2 +-
>  Documentation/hwmon/{ab8500 => ab8500.rst}    |   2 +-
>  ...guru-datasheet => abituguru-datasheet.rst} |   0
>  .../hwmon/{abituguru => abituguru.rst}        |   0
>  .../hwmon/{abituguru3 => abituguru3.rst}      |   0
>  Documentation/hwmon/{abx500 => abx500.rst}    |   0
>  ...{acpi_power_meter => acpi_power_meter.rst} |   2 +-
>  Documentation/hwmon/{ad7314 => ad7314.rst}    |   0
>  .../hwmon/{adc128d818 => adc128d818.rst}      |   0
>  Documentation/hwmon/{adm1021 => adm1021.rst}  |   0
>  Documentation/hwmon/{adm1025 => adm1025.rst}  |   0
>  Documentation/hwmon/{adm1026 => adm1026.rst}  |   0
>  Documentation/hwmon/{adm1031 => adm1031.rst}  |   0
>  Documentation/hwmon/{adm1275 => adm1275.rst}  |   4 +-
>  Documentation/hwmon/{adm9240 => adm9240.rst}  |   0
>  Documentation/hwmon/{ads1015 => ads1015.rst}  |   0
>  Documentation/hwmon/{ads7828 => ads7828.rst}  |   0
>  Documentation/hwmon/{adt7410 => adt7410.rst}  |   0
>  Documentation/hwmon/{adt7411 => adt7411.rst}  |   0
>  Documentation/hwmon/{adt7462 => adt7462.rst}  |   0
>  Documentation/hwmon/{adt7470 => adt7470.rst}  |   0
>  Documentation/hwmon/{adt7475 => adt7475.rst}  |   0
>  Documentation/hwmon/{amc6821 => amc6821.rst}  |   0
>  Documentation/hwmon/{asb100 => asb100.rst}    |   0
>  Documentation/hwmon/{asc7621 => asc7621.rst}  |   0
>  ...{aspeed-pwm-tacho => aspeed-pwm-tacho.rst} |   0
>  .../hwmon/{coretemp => coretemp.rst}          |   0
>  Documentation/hwmon/{da9052 => da9052.rst}    |   0
>  Documentation/hwmon/{da9055 => da9055.rst}    |   0
>  Documentation/hwmon/{dme1737 => dme1737.rst}  |   0
>  Documentation/hwmon/{ds1621 => ds1621.rst}    |   0
>  Documentation/hwmon/{ds620 => ds620.rst}      |   0
>  Documentation/hwmon/{emc1403 => emc1403.rst}  |   0
>  Documentation/hwmon/{emc2103 => emc2103.rst}  |   0
>  .../hwmon/{emc6w201 => emc6w201.rst}          |   0
>  Documentation/hwmon/{f71805f => f71805f.rst}  |   0
>  .../hwmon/{f71882fg => f71882fg.rst}          |   0
>  .../hwmon/{fam15h_power => fam15h_power.rst}  |   0
>  .../hwmon/{ftsteutates => ftsteutates.rst}    |   0
>  Documentation/hwmon/{g760a => g760a.rst}      |   0
>  Documentation/hwmon/{g762 => g762.rst}        |   2 +-
>  Documentation/hwmon/{gl518sm => gl518sm.rst}  |   0
>  Documentation/hwmon/{hih6130 => hih6130.rst}  |   0
>  ...on-kernel-api.txt => hwmon-kernel-api.rst} |   4 +-
>  .../hwmon/{ibm-cffps => ibm-cffps.rst}        |   0
>  Documentation/hwmon/{ibmaem => ibmaem.rst}    |   0
>  .../hwmon/{ibmpowernv => ibmpowernv.rst}      |   0
>  Documentation/hwmon/{ina209 => ina209.rst}    |   0
>  Documentation/hwmon/{ina2xx => ina2xx.rst}    |   2 +-
>  Documentation/hwmon/{ina3221 => ina3221.rst}  |   0
>  Documentation/hwmon/index.rst                 | 179 ++++++++++++++++++
>  Documentation/hwmon/{ir35221 => ir35221.rst}  |   0
>  Documentation/hwmon/{it87 => it87.rst}        |   0
>  Documentation/hwmon/{jc42 => jc42.rst}        |   0
>  Documentation/hwmon/{k10temp => k10temp.rst}  |   0
>  Documentation/hwmon/{k8temp => k8temp.rst}    |   0
>  .../hwmon/{lineage-pem => lineage-pem.rst}    |   0
>  Documentation/hwmon/{lm25066 => lm25066.rst}  |   2 +-
>  Documentation/hwmon/{lm63 => lm63.rst}        |   0
>  Documentation/hwmon/{lm70 => lm70.rst}        |   0
>  Documentation/hwmon/{lm73 => lm73.rst}        |   0
>  Documentation/hwmon/{lm75 => lm75.rst}        |   0
>  Documentation/hwmon/{lm77 => lm77.rst}        |   0
>  Documentation/hwmon/{lm78 => lm78.rst}        |   0
>  Documentation/hwmon/{lm80 => lm80.rst}        |   0
>  Documentation/hwmon/{lm83 => lm83.rst}        |   0
>  Documentation/hwmon/{lm85 => lm85.rst}        |   0
>  Documentation/hwmon/{lm87 => lm87.rst}        |   0
>  Documentation/hwmon/{lm90 => lm90.rst}        |   0
>  Documentation/hwmon/{lm92 => lm92.rst}        |   0
>  Documentation/hwmon/{lm93 => lm93.rst}        |   0
>  Documentation/hwmon/{lm95234 => lm95234.rst}  |   0
>  Documentation/hwmon/{lm95245 => lm95245.rst}  |   0
>  Documentation/hwmon/{ltc2945 => ltc2945.rst}  |   0
>  Documentation/hwmon/{ltc2978 => ltc2978.rst}  |   0
>  Documentation/hwmon/{ltc2990 => ltc2990.rst}  |   0
>  Documentation/hwmon/{ltc3815 => ltc3815.rst}  |   0
>  Documentation/hwmon/{ltc4151 => ltc4151.rst}  |   0
>  Documentation/hwmon/{ltc4215 => ltc4215.rst}  |   0
>  Documentation/hwmon/{ltc4245 => ltc4245.rst}  |   0
>  Documentation/hwmon/{ltc4260 => ltc4260.rst}  |   0
>  Documentation/hwmon/{ltc4261 => ltc4261.rst}  |   0
>  .../hwmon/{max16064 => max16064.rst}          |   2 +-
>  .../hwmon/{max16065 => max16065.rst}          |   0
>  Documentation/hwmon/{max1619 => max1619.rst}  |   0
>  Documentation/hwmon/{max1668 => max1668.rst}  |   0
>  Documentation/hwmon/{max197 => max197.rst}    |   0
>  .../hwmon/{max20751 => max20751.rst}          |   2 +-
>  .../hwmon/{max31722 => max31722.rst}          |   0
>  .../hwmon/{max31785 => max31785.rst}          |   0
>  .../hwmon/{max31790 => max31790.rst}          |   0
>  .../hwmon/{max34440 => max34440.rst}          |   2 +-
>  Documentation/hwmon/{max6639 => max6639.rst}  |   0
>  Documentation/hwmon/{max6642 => max6642.rst}  |   0
>  Documentation/hwmon/{max6650 => max6650.rst}  |   0
>  Documentation/hwmon/{max6697 => max6697.rst}  |   0
>  Documentation/hwmon/{max8688 => max8688.rst}  |   2 +-
>  .../hwmon/{mc13783-adc => mc13783-adc.rst}    |   0
>  Documentation/hwmon/{mcp3021 => mcp3021.rst}  |   0
>  .../hwmon/{menf21bmc => menf21bmc.rst}        |   0
>  .../hwmon/{mlxreg-fan => mlxreg-fan.rst}      |   0
>  Documentation/hwmon/{nct6683 => nct6683.rst}  |   0
>  Documentation/hwmon/{nct6775 => nct6775.rst}  |   0
>  Documentation/hwmon/{nct7802 => nct7802.rst}  |   0
>  Documentation/hwmon/{nct7904 => nct7904.rst}  |   0
>  .../{npcm750-pwm-fan => npcm750-pwm-fan.rst}  |   0
>  Documentation/hwmon/{nsa320 => nsa320.rst}    |   0
>  .../{ntc_thermistor => ntc_thermistor.rst}    |   0
>  Documentation/hwmon/{occ => occ.rst}          |   0
>  Documentation/hwmon/{pc87360 => pc87360.rst}  |   0
>  Documentation/hwmon/{pc87427 => pc87427.rst}  |   0
>  Documentation/hwmon/{pcf8591 => pcf8591.rst}  |   0
>  .../hwmon/{pmbus-core => pmbus-core.rst}      |   0
>  Documentation/hwmon/{pmbus => pmbus.rst}      |   0
>  .../hwmon/{powr1220 => powr1220.rst}          |   0
>  Documentation/hwmon/{pwm-fan => pwm-fan.rst}  |   0
>  ...aspberrypi-hwmon => raspberrypi-hwmon.rst} |   0
>  Documentation/hwmon/{sch5627 => sch5627.rst}  |   0
>  Documentation/hwmon/{sch5636 => sch5636.rst}  |   0
>  .../hwmon/{scpi-hwmon => scpi-hwmon.rst}      |   0
>  Documentation/hwmon/{sht15 => sht15.rst}      |   0
>  Documentation/hwmon/{sht21 => sht21.rst}      |   0
>  Documentation/hwmon/{sht3x => sht3x.rst}      |   0
>  Documentation/hwmon/{shtc1 => shtc1.rst}      |   0
>  Documentation/hwmon/{sis5595 => sis5595.rst}  |   0
>  Documentation/hwmon/{smm665 => smm665.rst}    |   0
>  .../hwmon/{smsc47b397 => smsc47b397.rst}      |   0
>  .../hwmon/{smsc47m1 => smsc47m1.rst}          |   0
>  .../hwmon/{smsc47m192 => smsc47m192.rst}      |   0
>  ...mitting-patches => submitting-patches.rst} |   6 +-
>  .../{sysfs-interface => sysfs-interface.rst}  |   0
>  Documentation/hwmon/{tc654 => tc654.rst}      |   0
>  Documentation/hwmon/{tc74 => tc74.rst}        |   0
>  Documentation/hwmon/{thmc50 => thmc50.rst}    |   0
>  Documentation/hwmon/{tmp102 => tmp102.rst}    |   2 +-
>  Documentation/hwmon/{tmp103 => tmp103.rst}    |   2 +-
>  Documentation/hwmon/{tmp108 => tmp108.rst}    |   2 +-
>  Documentation/hwmon/{tmp401 => tmp401.rst}    |   2 +-
>  Documentation/hwmon/{tmp421 => tmp421.rst}    |   0
>  .../hwmon/{tps40422 => tps40422.rst}          |   2 +-
>  ...4030-madc-hwmon => twl4030-madc-hwmon.rst} |   0
>  Documentation/hwmon/{ucd9000 => ucd9000.rst}  |   4 +-
>  Documentation/hwmon/{ucd9200 => ucd9200.rst}  |   4 +-
>  .../{userspace-tools => userspace-tools.rst}  |   0
>  .../hwmon/{vexpress => vexpress.rst}          |   0
>  Documentation/hwmon/{via686a => via686a.rst}  |   0
>  Documentation/hwmon/{vt1211 => vt1211.rst}    |   0
>  .../hwmon/{w83627ehf => w83627ehf.rst}        |   0
>  .../hwmon/{w83627hf => w83627hf.rst}          |   0
>  Documentation/hwmon/{w83773g => w83773g.rst}  |   0
>  Documentation/hwmon/{w83781d => w83781d.rst}  |   0
>  Documentation/hwmon/{w83791d => w83791d.rst}  |   2 +-
>  Documentation/hwmon/{w83792d => w83792d.rst}  |   0
>  Documentation/hwmon/{w83793 => w83793.rst}    |   0
>  Documentation/hwmon/{w83795 => w83795.rst}    |   0
>  .../hwmon/{w83l785ts => w83l785ts.rst}        |   0
>  .../hwmon/{w83l786ng => w83l786ng.rst}        |   0
>  Documentation/hwmon/{wm831x => wm831x.rst}    |   0
>  Documentation/hwmon/{wm8350 => wm8350.rst}    |   0
>  .../hwmon/{xgene-hwmon => xgene-hwmon.rst}    |   0
>  Documentation/hwmon/{zl6100 => zl6100.rst}    |   2 +-
>  Documentation/index.rst                       |   1 +
>  Documentation/thermal/sysfs-api.txt           |   2 +-
>  MAINTAINERS                                   | 108 +++++------
>  drivers/hwmon/Kconfig                         |   8 +-
>  drivers/hwmon/ads7828.c                       |   2 +-
>  drivers/hwmon/max197.c                        |   2 +-
>  drivers/hwmon/sht15.c                         |   2 +-
>  include/linux/platform_data/ads7828.h         |   2 +-
>  include/linux/platform_data/ds620.h           |   2 +-
>  include/linux/platform_data/ina2xx.h          |   2 +-
>  include/linux/platform_data/max197.h          |   2 +-
>  include/linux/platform_data/ntc_thermistor.h  |   2 +-
>  173 files changed, 275 insertions(+), 95 deletions(-)
>  rename Documentation/hwmon/{ab8500 => ab8500.rst} (86%)
>  rename Documentation/hwmon/{abituguru-datasheet => abituguru-datasheet.rst} (100%)
>  rename Documentation/hwmon/{abituguru => abituguru.rst} (100%)
>  rename Documentation/hwmon/{abituguru3 => abituguru3.rst} (100%)
>  rename Documentation/hwmon/{abx500 => abx500.rst} (100%)
>  rename Documentation/hwmon/{acpi_power_meter => acpi_power_meter.rst} (97%)
>  rename Documentation/hwmon/{ad7314 => ad7314.rst} (100%)
>  rename Documentation/hwmon/{adc128d818 => adc128d818.rst} (100%)
>  rename Documentation/hwmon/{adm1021 => adm1021.rst} (100%)
>  rename Documentation/hwmon/{adm1025 => adm1025.rst} (100%)
>  rename Documentation/hwmon/{adm1026 => adm1026.rst} (100%)
>  rename Documentation/hwmon/{adm1031 => adm1031.rst} (100%)
>  rename Documentation/hwmon/{adm1275 => adm1275.rst} (97%)
>  rename Documentation/hwmon/{adm9240 => adm9240.rst} (100%)
>  rename Documentation/hwmon/{ads1015 => ads1015.rst} (100%)
>  rename Documentation/hwmon/{ads7828 => ads7828.rst} (100%)
>  rename Documentation/hwmon/{adt7410 => adt7410.rst} (100%)
>  rename Documentation/hwmon/{adt7411 => adt7411.rst} (100%)
>  rename Documentation/hwmon/{adt7462 => adt7462.rst} (100%)
>  rename Documentation/hwmon/{adt7470 => adt7470.rst} (100%)
>  rename Documentation/hwmon/{adt7475 => adt7475.rst} (100%)
>  rename Documentation/hwmon/{amc6821 => amc6821.rst} (100%)
>  rename Documentation/hwmon/{asb100 => asb100.rst} (100%)
>  rename Documentation/hwmon/{asc7621 => asc7621.rst} (100%)
>  rename Documentation/hwmon/{aspeed-pwm-tacho => aspeed-pwm-tacho.rst} (100%)
>  rename Documentation/hwmon/{coretemp => coretemp.rst} (100%)
>  rename Documentation/hwmon/{da9052 => da9052.rst} (100%)
>  rename Documentation/hwmon/{da9055 => da9055.rst} (100%)
>  rename Documentation/hwmon/{dme1737 => dme1737.rst} (100%)
>  rename Documentation/hwmon/{ds1621 => ds1621.rst} (100%)
>  rename Documentation/hwmon/{ds620 => ds620.rst} (100%)
>  rename Documentation/hwmon/{emc1403 => emc1403.rst} (100%)
>  rename Documentation/hwmon/{emc2103 => emc2103.rst} (100%)
>  rename Documentation/hwmon/{emc6w201 => emc6w201.rst} (100%)
>  rename Documentation/hwmon/{f71805f => f71805f.rst} (100%)
>  rename Documentation/hwmon/{f71882fg => f71882fg.rst} (100%)
>  rename Documentation/hwmon/{fam15h_power => fam15h_power.rst} (100%)
>  rename Documentation/hwmon/{ftsteutates => ftsteutates.rst} (100%)
>  rename Documentation/hwmon/{g760a => g760a.rst} (100%)
>  rename Documentation/hwmon/{g762 => g762.rst} (97%)
>  rename Documentation/hwmon/{gl518sm => gl518sm.rst} (100%)
>  rename Documentation/hwmon/{hih6130 => hih6130.rst} (100%)
>  rename Documentation/hwmon/{hwmon-kernel-api.txt => hwmon-kernel-api.rst} (99%)
>  rename Documentation/hwmon/{ibm-cffps => ibm-cffps.rst} (100%)
>  rename Documentation/hwmon/{ibmaem => ibmaem.rst} (100%)
>  rename Documentation/hwmon/{ibmpowernv => ibmpowernv.rst} (100%)
>  rename Documentation/hwmon/{ina209 => ina209.rst} (100%)
>  rename Documentation/hwmon/{ina2xx => ina2xx.rst} (97%)
>  rename Documentation/hwmon/{ina3221 => ina3221.rst} (100%)
>  create mode 100644 Documentation/hwmon/index.rst
>  rename Documentation/hwmon/{ir35221 => ir35221.rst} (100%)
>  rename Documentation/hwmon/{it87 => it87.rst} (100%)
>  rename Documentation/hwmon/{jc42 => jc42.rst} (100%)
>  rename Documentation/hwmon/{k10temp => k10temp.rst} (100%)
>  rename Documentation/hwmon/{k8temp => k8temp.rst} (100%)
>  rename Documentation/hwmon/{lineage-pem => lineage-pem.rst} (100%)
>  rename Documentation/hwmon/{lm25066 => lm25066.rst} (97%)
>  rename Documentation/hwmon/{lm63 => lm63.rst} (100%)
>  rename Documentation/hwmon/{lm70 => lm70.rst} (100%)
>  rename Documentation/hwmon/{lm73 => lm73.rst} (100%)
>  rename Documentation/hwmon/{lm75 => lm75.rst} (100%)
>  rename Documentation/hwmon/{lm77 => lm77.rst} (100%)
>  rename Documentation/hwmon/{lm78 => lm78.rst} (100%)
>  rename Documentation/hwmon/{lm80 => lm80.rst} (100%)
>  rename Documentation/hwmon/{lm83 => lm83.rst} (100%)
>  rename Documentation/hwmon/{lm85 => lm85.rst} (100%)
>  rename Documentation/hwmon/{lm87 => lm87.rst} (100%)
>  rename Documentation/hwmon/{lm90 => lm90.rst} (100%)
>  rename Documentation/hwmon/{lm92 => lm92.rst} (100%)
>  rename Documentation/hwmon/{lm93 => lm93.rst} (100%)
>  rename Documentation/hwmon/{lm95234 => lm95234.rst} (100%)
>  rename Documentation/hwmon/{lm95245 => lm95245.rst} (100%)
>  rename Documentation/hwmon/{ltc2945 => ltc2945.rst} (100%)
>  rename Documentation/hwmon/{ltc2978 => ltc2978.rst} (100%)
>  rename Documentation/hwmon/{ltc2990 => ltc2990.rst} (100%)
>  rename Documentation/hwmon/{ltc3815 => ltc3815.rst} (100%)
>  rename Documentation/hwmon/{ltc4151 => ltc4151.rst} (100%)
>  rename Documentation/hwmon/{ltc4215 => ltc4215.rst} (100%)
>  rename Documentation/hwmon/{ltc4245 => ltc4245.rst} (100%)
>  rename Documentation/hwmon/{ltc4260 => ltc4260.rst} (100%)
>  rename Documentation/hwmon/{ltc4261 => ltc4261.rst} (100%)
>  rename Documentation/hwmon/{max16064 => max16064.rst} (96%)
>  rename Documentation/hwmon/{max16065 => max16065.rst} (100%)
>  rename Documentation/hwmon/{max1619 => max1619.rst} (100%)
>  rename Documentation/hwmon/{max1668 => max1668.rst} (100%)
>  rename Documentation/hwmon/{max197 => max197.rst} (100%)
>  rename Documentation/hwmon/{max20751 => max20751.rst} (96%)
>  rename Documentation/hwmon/{max31722 => max31722.rst} (100%)
>  rename Documentation/hwmon/{max31785 => max31785.rst} (100%)
>  rename Documentation/hwmon/{max31790 => max31790.rst} (100%)
>  rename Documentation/hwmon/{max34440 => max34440.rst} (98%)
>  rename Documentation/hwmon/{max6639 => max6639.rst} (100%)
>  rename Documentation/hwmon/{max6642 => max6642.rst} (100%)
>  rename Documentation/hwmon/{max6650 => max6650.rst} (100%)
>  rename Documentation/hwmon/{max6697 => max6697.rst} (100%)
>  rename Documentation/hwmon/{max8688 => max8688.rst} (97%)
>  rename Documentation/hwmon/{mc13783-adc => mc13783-adc.rst} (100%)
>  rename Documentation/hwmon/{mcp3021 => mcp3021.rst} (100%)
>  rename Documentation/hwmon/{menf21bmc => menf21bmc.rst} (100%)
>  rename Documentation/hwmon/{mlxreg-fan => mlxreg-fan.rst} (100%)
>  rename Documentation/hwmon/{nct6683 => nct6683.rst} (100%)
>  rename Documentation/hwmon/{nct6775 => nct6775.rst} (100%)
>  rename Documentation/hwmon/{nct7802 => nct7802.rst} (100%)
>  rename Documentation/hwmon/{nct7904 => nct7904.rst} (100%)
>  rename Documentation/hwmon/{npcm750-pwm-fan => npcm750-pwm-fan.rst} (100%)
>  rename Documentation/hwmon/{nsa320 => nsa320.rst} (100%)
>  rename Documentation/hwmon/{ntc_thermistor => ntc_thermistor.rst} (100%)
>  rename Documentation/hwmon/{occ => occ.rst} (100%)
>  rename Documentation/hwmon/{pc87360 => pc87360.rst} (100%)
>  rename Documentation/hwmon/{pc87427 => pc87427.rst} (100%)
>  rename Documentation/hwmon/{pcf8591 => pcf8591.rst} (100%)
>  rename Documentation/hwmon/{pmbus-core => pmbus-core.rst} (100%)
>  rename Documentation/hwmon/{pmbus => pmbus.rst} (100%)
>  rename Documentation/hwmon/{powr1220 => powr1220.rst} (100%)
>  rename Documentation/hwmon/{pwm-fan => pwm-fan.rst} (100%)
>  rename Documentation/hwmon/{raspberrypi-hwmon => raspberrypi-hwmon.rst} (100%)
>  rename Documentation/hwmon/{sch5627 => sch5627.rst} (100%)
>  rename Documentation/hwmon/{sch5636 => sch5636.rst} (100%)
>  rename Documentation/hwmon/{scpi-hwmon => scpi-hwmon.rst} (100%)
>  rename Documentation/hwmon/{sht15 => sht15.rst} (100%)
>  rename Documentation/hwmon/{sht21 => sht21.rst} (100%)
>  rename Documentation/hwmon/{sht3x => sht3x.rst} (100%)
>  rename Documentation/hwmon/{shtc1 => shtc1.rst} (100%)
>  rename Documentation/hwmon/{sis5595 => sis5595.rst} (100%)
>  rename Documentation/hwmon/{smm665 => smm665.rst} (100%)
>  rename Documentation/hwmon/{smsc47b397 => smsc47b397.rst} (100%)
>  rename Documentation/hwmon/{smsc47m1 => smsc47m1.rst} (100%)
>  rename Documentation/hwmon/{smsc47m192 => smsc47m192.rst} (100%)
>  rename Documentation/hwmon/{submitting-patches => submitting-patches.rst} (98%)
>  rename Documentation/hwmon/{sysfs-interface => sysfs-interface.rst} (100%)
>  rename Documentation/hwmon/{tc654 => tc654.rst} (100%)
>  rename Documentation/hwmon/{tc74 => tc74.rst} (100%)
>  rename Documentation/hwmon/{thmc50 => thmc50.rst} (100%)
>  rename Documentation/hwmon/{tmp102 => tmp102.rst} (93%)
>  rename Documentation/hwmon/{tmp103 => tmp103.rst} (92%)
>  rename Documentation/hwmon/{tmp108 => tmp108.rst} (95%)
>  rename Documentation/hwmon/{tmp401 => tmp401.rst} (97%)
>  rename Documentation/hwmon/{tmp421 => tmp421.rst} (100%)
>  rename Documentation/hwmon/{tps40422 => tps40422.rst} (96%)
>  rename Documentation/hwmon/{twl4030-madc-hwmon => twl4030-madc-hwmon.rst} (100%)
>  rename Documentation/hwmon/{ucd9000 => ucd9000.rst} (97%)
>  rename Documentation/hwmon/{ucd9200 => ucd9200.rst} (97%)
>  rename Documentation/hwmon/{userspace-tools => userspace-tools.rst} (100%)
>  rename Documentation/hwmon/{vexpress => vexpress.rst} (100%)

For the vexpress part:

Acked-by: Liviu Dudau <liviu.dudau@arm.com>

Best regards,
Liviu


>  rename Documentation/hwmon/{via686a => via686a.rst} (100%)
>  rename Documentation/hwmon/{vt1211 => vt1211.rst} (100%)
>  rename Documentation/hwmon/{w83627ehf => w83627ehf.rst} (100%)
>  rename Documentation/hwmon/{w83627hf => w83627hf.rst} (100%)
>  rename Documentation/hwmon/{w83773g => w83773g.rst} (100%)
>  rename Documentation/hwmon/{w83781d => w83781d.rst} (100%)
>  rename Documentation/hwmon/{w83791d => w83791d.rst} (99%)
>  rename Documentation/hwmon/{w83792d => w83792d.rst} (100%)
>  rename Documentation/hwmon/{w83793 => w83793.rst} (100%)
>  rename Documentation/hwmon/{w83795 => w83795.rst} (100%)
>  rename Documentation/hwmon/{w83l785ts => w83l785ts.rst} (100%)
>  rename Documentation/hwmon/{w83l786ng => w83l786ng.rst} (100%)
>  rename Documentation/hwmon/{wm831x => wm831x.rst} (100%)
>  rename Documentation/hwmon/{wm8350 => wm8350.rst} (100%)
>  rename Documentation/hwmon/{xgene-hwmon => xgene-hwmon.rst} (100%)
>  rename Documentation/hwmon/{zl6100 => zl6100.rst} (98%)
> 
> diff --git a/Documentation/devicetree/bindings/hwmon/g762.txt b/Documentation/devicetree/bindings/hwmon/g762.txt
> index 25cc6d8ee575..6d154c4923de 100644
> --- a/Documentation/devicetree/bindings/hwmon/g762.txt
> +++ b/Documentation/devicetree/bindings/hwmon/g762.txt
> @@ -21,7 +21,7 @@ If an optional property is not set in .dts file, then current value is kept
>  unmodified (e.g. u-boot installed value).
>  
>  Additional information on operational parameters for the device is available
> -in Documentation/hwmon/g762. A detailed datasheet for the device is available
> +in Documentation/hwmon/g762.rst. A detailed datasheet for the device is available
>  at http://natisbad.org/NAS/refs/GMT_EDS-762_763-080710-0.2.pdf.
>  
>  Example g762 node:
> diff --git a/Documentation/hwmon/ab8500 b/Documentation/hwmon/ab8500.rst
> similarity index 86%
> rename from Documentation/hwmon/ab8500
> rename to Documentation/hwmon/ab8500.rst
> index d87c61151239..33f93a9cec04 100644
> --- a/Documentation/hwmon/ab8500
> +++ b/Documentation/hwmon/ab8500.rst
> @@ -18,7 +18,7 @@ Authors:
>  Description
>  -----------
>  
> -See also Documentation/hwmon/abx500. This is the ST-Ericsson AB8500 specific
> +See also Documentation/hwmon/abx500.rst. This is the ST-Ericsson AB8500 specific
>  driver.
>  
>  Currently only the AB8500 internal sensor and one external sensor for battery
> diff --git a/Documentation/hwmon/abituguru-datasheet b/Documentation/hwmon/abituguru-datasheet.rst
> similarity index 100%
> rename from Documentation/hwmon/abituguru-datasheet
> rename to Documentation/hwmon/abituguru-datasheet.rst
> diff --git a/Documentation/hwmon/abituguru b/Documentation/hwmon/abituguru.rst
> similarity index 100%
> rename from Documentation/hwmon/abituguru
> rename to Documentation/hwmon/abituguru.rst
> diff --git a/Documentation/hwmon/abituguru3 b/Documentation/hwmon/abituguru3.rst
> similarity index 100%
> rename from Documentation/hwmon/abituguru3
> rename to Documentation/hwmon/abituguru3.rst
> diff --git a/Documentation/hwmon/abx500 b/Documentation/hwmon/abx500.rst
> similarity index 100%
> rename from Documentation/hwmon/abx500
> rename to Documentation/hwmon/abx500.rst
> diff --git a/Documentation/hwmon/acpi_power_meter b/Documentation/hwmon/acpi_power_meter.rst
> similarity index 97%
> rename from Documentation/hwmon/acpi_power_meter
> rename to Documentation/hwmon/acpi_power_meter.rst
> index 7665ca6ba957..4a0941ade0ca 100644
> --- a/Documentation/hwmon/acpi_power_meter
> +++ b/Documentation/hwmon/acpi_power_meter.rst
> @@ -21,7 +21,7 @@ the ACPI 4.0 spec (Chapter 10.4).  These devices have a simple set of
>  features--a power meter that returns average power use over a configurable
>  interval, an optional capping mechanism, and a couple of trip points.  The
>  sysfs interface conforms with the specification outlined in the "Power" section
> -of Documentation/hwmon/sysfs-interface.
> +of Documentation/hwmon/sysfs-interface.rst.
>  
>  Special Features
>  ----------------
> diff --git a/Documentation/hwmon/ad7314 b/Documentation/hwmon/ad7314.rst
> similarity index 100%
> rename from Documentation/hwmon/ad7314
> rename to Documentation/hwmon/ad7314.rst
> diff --git a/Documentation/hwmon/adc128d818 b/Documentation/hwmon/adc128d818.rst
> similarity index 100%
> rename from Documentation/hwmon/adc128d818
> rename to Documentation/hwmon/adc128d818.rst
> diff --git a/Documentation/hwmon/adm1021 b/Documentation/hwmon/adm1021.rst
> similarity index 100%
> rename from Documentation/hwmon/adm1021
> rename to Documentation/hwmon/adm1021.rst
> diff --git a/Documentation/hwmon/adm1025 b/Documentation/hwmon/adm1025.rst
> similarity index 100%
> rename from Documentation/hwmon/adm1025
> rename to Documentation/hwmon/adm1025.rst
> diff --git a/Documentation/hwmon/adm1026 b/Documentation/hwmon/adm1026.rst
> similarity index 100%
> rename from Documentation/hwmon/adm1026
> rename to Documentation/hwmon/adm1026.rst
> diff --git a/Documentation/hwmon/adm1031 b/Documentation/hwmon/adm1031.rst
> similarity index 100%
> rename from Documentation/hwmon/adm1031
> rename to Documentation/hwmon/adm1031.rst
> diff --git a/Documentation/hwmon/adm1275 b/Documentation/hwmon/adm1275.rst
> similarity index 97%
> rename from Documentation/hwmon/adm1275
> rename to Documentation/hwmon/adm1275.rst
> index 5c5860011d6e..9a1913e5b4d9 100644
> --- a/Documentation/hwmon/adm1275
> +++ b/Documentation/hwmon/adm1275.rst
> @@ -68,7 +68,7 @@ integrated 12 bit analog-to-digital converter (ADC), accessed using a
>  PMBus interface.
>  
>  The driver is a client driver to the core PMBus driver. Please see
> -Documentation/hwmon/pmbus for details on PMBus client drivers.
> +Documentation/hwmon/pmbus.rst for details on PMBus client drivers.
>  
>  
>  Usage Notes
> @@ -90,7 +90,7 @@ Platform data support
>  ---------------------
>  
>  The driver supports standard PMBus driver platform data. Please see
> -Documentation/hwmon/pmbus for details.
> +Documentation/hwmon/pmbus.rst for details.
>  
>  
>  Sysfs entries
> diff --git a/Documentation/hwmon/adm9240 b/Documentation/hwmon/adm9240.rst
> similarity index 100%
> rename from Documentation/hwmon/adm9240
> rename to Documentation/hwmon/adm9240.rst
> diff --git a/Documentation/hwmon/ads1015 b/Documentation/hwmon/ads1015.rst
> similarity index 100%
> rename from Documentation/hwmon/ads1015
> rename to Documentation/hwmon/ads1015.rst
> diff --git a/Documentation/hwmon/ads7828 b/Documentation/hwmon/ads7828.rst
> similarity index 100%
> rename from Documentation/hwmon/ads7828
> rename to Documentation/hwmon/ads7828.rst
> diff --git a/Documentation/hwmon/adt7410 b/Documentation/hwmon/adt7410.rst
> similarity index 100%
> rename from Documentation/hwmon/adt7410
> rename to Documentation/hwmon/adt7410.rst
> diff --git a/Documentation/hwmon/adt7411 b/Documentation/hwmon/adt7411.rst
> similarity index 100%
> rename from Documentation/hwmon/adt7411
> rename to Documentation/hwmon/adt7411.rst
> diff --git a/Documentation/hwmon/adt7462 b/Documentation/hwmon/adt7462.rst
> similarity index 100%
> rename from Documentation/hwmon/adt7462
> rename to Documentation/hwmon/adt7462.rst
> diff --git a/Documentation/hwmon/adt7470 b/Documentation/hwmon/adt7470.rst
> similarity index 100%
> rename from Documentation/hwmon/adt7470
> rename to Documentation/hwmon/adt7470.rst
> diff --git a/Documentation/hwmon/adt7475 b/Documentation/hwmon/adt7475.rst
> similarity index 100%
> rename from Documentation/hwmon/adt7475
> rename to Documentation/hwmon/adt7475.rst
> diff --git a/Documentation/hwmon/amc6821 b/Documentation/hwmon/amc6821.rst
> similarity index 100%
> rename from Documentation/hwmon/amc6821
> rename to Documentation/hwmon/amc6821.rst
> diff --git a/Documentation/hwmon/asb100 b/Documentation/hwmon/asb100.rst
> similarity index 100%
> rename from Documentation/hwmon/asb100
> rename to Documentation/hwmon/asb100.rst
> diff --git a/Documentation/hwmon/asc7621 b/Documentation/hwmon/asc7621.rst
> similarity index 100%
> rename from Documentation/hwmon/asc7621
> rename to Documentation/hwmon/asc7621.rst
> diff --git a/Documentation/hwmon/aspeed-pwm-tacho b/Documentation/hwmon/aspeed-pwm-tacho.rst
> similarity index 100%
> rename from Documentation/hwmon/aspeed-pwm-tacho
> rename to Documentation/hwmon/aspeed-pwm-tacho.rst
> diff --git a/Documentation/hwmon/coretemp b/Documentation/hwmon/coretemp.rst
> similarity index 100%
> rename from Documentation/hwmon/coretemp
> rename to Documentation/hwmon/coretemp.rst
> diff --git a/Documentation/hwmon/da9052 b/Documentation/hwmon/da9052.rst
> similarity index 100%
> rename from Documentation/hwmon/da9052
> rename to Documentation/hwmon/da9052.rst
> diff --git a/Documentation/hwmon/da9055 b/Documentation/hwmon/da9055.rst
> similarity index 100%
> rename from Documentation/hwmon/da9055
> rename to Documentation/hwmon/da9055.rst
> diff --git a/Documentation/hwmon/dme1737 b/Documentation/hwmon/dme1737.rst
> similarity index 100%
> rename from Documentation/hwmon/dme1737
> rename to Documentation/hwmon/dme1737.rst
> diff --git a/Documentation/hwmon/ds1621 b/Documentation/hwmon/ds1621.rst
> similarity index 100%
> rename from Documentation/hwmon/ds1621
> rename to Documentation/hwmon/ds1621.rst
> diff --git a/Documentation/hwmon/ds620 b/Documentation/hwmon/ds620.rst
> similarity index 100%
> rename from Documentation/hwmon/ds620
> rename to Documentation/hwmon/ds620.rst
> diff --git a/Documentation/hwmon/emc1403 b/Documentation/hwmon/emc1403.rst
> similarity index 100%
> rename from Documentation/hwmon/emc1403
> rename to Documentation/hwmon/emc1403.rst
> diff --git a/Documentation/hwmon/emc2103 b/Documentation/hwmon/emc2103.rst
> similarity index 100%
> rename from Documentation/hwmon/emc2103
> rename to Documentation/hwmon/emc2103.rst
> diff --git a/Documentation/hwmon/emc6w201 b/Documentation/hwmon/emc6w201.rst
> similarity index 100%
> rename from Documentation/hwmon/emc6w201
> rename to Documentation/hwmon/emc6w201.rst
> diff --git a/Documentation/hwmon/f71805f b/Documentation/hwmon/f71805f.rst
> similarity index 100%
> rename from Documentation/hwmon/f71805f
> rename to Documentation/hwmon/f71805f.rst
> diff --git a/Documentation/hwmon/f71882fg b/Documentation/hwmon/f71882fg.rst
> similarity index 100%
> rename from Documentation/hwmon/f71882fg
> rename to Documentation/hwmon/f71882fg.rst
> diff --git a/Documentation/hwmon/fam15h_power b/Documentation/hwmon/fam15h_power.rst
> similarity index 100%
> rename from Documentation/hwmon/fam15h_power
> rename to Documentation/hwmon/fam15h_power.rst
> diff --git a/Documentation/hwmon/ftsteutates b/Documentation/hwmon/ftsteutates.rst
> similarity index 100%
> rename from Documentation/hwmon/ftsteutates
> rename to Documentation/hwmon/ftsteutates.rst
> diff --git a/Documentation/hwmon/g760a b/Documentation/hwmon/g760a.rst
> similarity index 100%
> rename from Documentation/hwmon/g760a
> rename to Documentation/hwmon/g760a.rst
> diff --git a/Documentation/hwmon/g762 b/Documentation/hwmon/g762.rst
> similarity index 97%
> rename from Documentation/hwmon/g762
> rename to Documentation/hwmon/g762.rst
> index 54574e26df21..0371b3365c48 100644
> --- a/Documentation/hwmon/g762
> +++ b/Documentation/hwmon/g762.rst
> @@ -7,7 +7,7 @@ modes - PWM or DC - are supported by the device.
>  
>  For additional information, a detailed datasheet is available at
>  http://natisbad.org/NAS/ref/GMT_EDS-762_763-080710-0.2.pdf. sysfs
> -bindings are described in Documentation/hwmon/sysfs-interface.
> +bindings are described in Documentation/hwmon/sysfs-interface.rst.
>  
>  The following entries are available to the user in a subdirectory of
>  /sys/bus/i2c/drivers/g762/ to control the operation of the device.
> diff --git a/Documentation/hwmon/gl518sm b/Documentation/hwmon/gl518sm.rst
> similarity index 100%
> rename from Documentation/hwmon/gl518sm
> rename to Documentation/hwmon/gl518sm.rst
> diff --git a/Documentation/hwmon/hih6130 b/Documentation/hwmon/hih6130.rst
> similarity index 100%
> rename from Documentation/hwmon/hih6130
> rename to Documentation/hwmon/hih6130.rst
> diff --git a/Documentation/hwmon/hwmon-kernel-api.txt b/Documentation/hwmon/hwmon-kernel-api.rst
> similarity index 99%
> rename from Documentation/hwmon/hwmon-kernel-api.txt
> rename to Documentation/hwmon/hwmon-kernel-api.rst
> index b56343f5c2c4..5766bee64153 100644
> --- a/Documentation/hwmon/hwmon-kernel-api.txt
> +++ b/Documentation/hwmon/hwmon-kernel-api.rst
> @@ -12,10 +12,10 @@ drivers that want to use the hardware monitoring framework.
>  This document does not describe what a hardware monitoring (hwmon) Driver or
>  Device is. It also does not describe the API which can be used by user space
>  to communicate with a hardware monitoring device. If you want to know this
> -then please read the following file: Documentation/hwmon/sysfs-interface.
> +then please read the following file: Documentation/hwmon/sysfs-interface.rst.
>  
>  For additional guidelines on how to write and improve hwmon drivers, please
> -also read Documentation/hwmon/submitting-patches.
> +also read Documentation/hwmon/submitting-patches.rst.
>  
>  The API
>  -------
> diff --git a/Documentation/hwmon/ibm-cffps b/Documentation/hwmon/ibm-cffps.rst
> similarity index 100%
> rename from Documentation/hwmon/ibm-cffps
> rename to Documentation/hwmon/ibm-cffps.rst
> diff --git a/Documentation/hwmon/ibmaem b/Documentation/hwmon/ibmaem.rst
> similarity index 100%
> rename from Documentation/hwmon/ibmaem
> rename to Documentation/hwmon/ibmaem.rst
> diff --git a/Documentation/hwmon/ibmpowernv b/Documentation/hwmon/ibmpowernv.rst
> similarity index 100%
> rename from Documentation/hwmon/ibmpowernv
> rename to Documentation/hwmon/ibmpowernv.rst
> diff --git a/Documentation/hwmon/ina209 b/Documentation/hwmon/ina209.rst
> similarity index 100%
> rename from Documentation/hwmon/ina209
> rename to Documentation/hwmon/ina209.rst
> diff --git a/Documentation/hwmon/ina2xx b/Documentation/hwmon/ina2xx.rst
> similarity index 97%
> rename from Documentation/hwmon/ina2xx
> rename to Documentation/hwmon/ina2xx.rst
> index 95badf9c396f..94b9a260c518 100644
> --- a/Documentation/hwmon/ina2xx
> +++ b/Documentation/hwmon/ina2xx.rst
> @@ -78,7 +78,7 @@ refer to the Documentation/devicetree/bindings/hwmon/ina2xx.txt for bindings
>  if the device tree is used.
>  
>  Additionally ina226 supports update_interval attribute as described in
> -Documentation/hwmon/sysfs-interface. Internally the interval is the sum of
> +Documentation/hwmon/sysfs-interface.rst. Internally the interval is the sum of
>  bus and shunt voltage conversion times multiplied by the averaging rate. We
>  don't touch the conversion times and only modify the number of averages. The
>  lower limit of the update_interval is 2 ms, the upper limit is 2253 ms.
> diff --git a/Documentation/hwmon/ina3221 b/Documentation/hwmon/ina3221.rst
> similarity index 100%
> rename from Documentation/hwmon/ina3221
> rename to Documentation/hwmon/ina3221.rst
> diff --git a/Documentation/hwmon/index.rst b/Documentation/hwmon/index.rst
> new file mode 100644
> index 000000000000..893804414510
> --- /dev/null
> +++ b/Documentation/hwmon/index.rst
> @@ -0,0 +1,179 @@
> +=========================
> +Linux Hardware Monitoring
> +=========================
> +
> +.. toctree::
> +   :maxdepth: 1
> +
> +   hwmon-kernel-api.rst
> +   pmbus-core.rst
> +   submitting-patches.rst
> +   sysfs-interface.rst
> +   userspace-tools.rst
> +
> +Hardware Monitoring Kernel Drivers
> +==================================
> +
> +.. toctree::
> +   :maxdepth: 1
> +
> +   ab8500.rst
> +   abituguru.rst
> +   abituguru3.rst
> +   abx500.rst
> +   acpi_power_meter.rst
> +   ad7314.rst
> +   adc128d818.rst
> +   adm1021.rst
> +   adm1025.rst
> +   adm1026.rst
> +   adm1031.rst
> +   adm1275.rst
> +   adm9240.rst
> +   ads1015.rst
> +   ads7828.rst
> +   adt7410.rst
> +   adt7411.rst
> +   adt7462.rst
> +   adt7470.rst
> +   adt7475.rst
> +   amc6821.rst
> +   asb100.rst
> +   asc7621.rst
> +   aspeed-pwm-tacho.rst
> +   coretemp.rst
> +   da9052.rst
> +   da9055.rst
> +   dme1737.rst
> +   ds1621.rst
> +   ds620.rst
> +   emc1403.rst
> +   emc2103.rst
> +   emc6w201.rst
> +   f71805f.rst
> +   f71882fg.rst
> +   fam15h_power.rst
> +   ftsteutates.rst
> +   g760a.rst
> +   g762.rst
> +   gl518sm.rst
> +   hih6130.rst
> +   ibmaem.rst
> +   ibm-cffps.rst
> +   ibmpowernv.rst
> +   ina209.rst
> +   ina2xx.rst
> +   ina3221.rst
> +   ir35221.rst
> +   it87.rst
> +   jc42.rst
> +   k10temp.rst
> +   k8temp.rst
> +   lineage-pem.rst
> +   lm25066.rst
> +   lm63.rst
> +   lm70.rst
> +   lm73.rst
> +   lm75.rst
> +   lm77.rst
> +   lm78.rst
> +   lm80.rst
> +   lm83.rst
> +   lm85.rst
> +   lm87.rst
> +   lm90.rst
> +   lm92.rst
> +   lm93.rst
> +   lm95234.rst
> +   lm95245.rst
> +   ltc2945.rst
> +   ltc2978.rst
> +   ltc2990.rst
> +   ltc3815.rst
> +   ltc4151.rst
> +   ltc4215.rst
> +   ltc4245.rst
> +   ltc4260.rst
> +   ltc4261.rst
> +   max16064.rst
> +   max16065.rst
> +   max1619.rst
> +   max1668.rst
> +   max197.rst
> +   max20751.rst
> +   max31722.rst
> +   max31785.rst
> +   max31790.rst
> +   max34440.rst
> +   max6639.rst
> +   max6642.rst
> +   max6650.rst
> +   max6697.rst
> +   max8688.rst
> +   mc13783-adc.rst
> +   mcp3021.rst
> +   menf21bmc.rst
> +   mlxreg-fan.rst
> +   nct6683.rst
> +   nct6775.rst
> +   nct7802.rst
> +   nct7904.rst
> +   npcm750-pwm-fan.rst
> +   nsa320.rst
> +   ntc_thermistor.rst
> +   occ.rst
> +   pc87360.rst
> +   pc87427.rst
> +   pcf8591.rst
> +   pmbus.rst
> +   powr1220.rst
> +   pwm-fan.rst
> +   raspberrypi-hwmon.rst
> +   sch5627.rst
> +   sch5636.rst
> +   scpi-hwmon.rst
> +   sht15.rst
> +   sht21.rst
> +   sht3x.rst
> +   shtc1.rst
> +   sis5595.rst
> +   smm665.rst
> +   smsc47b397.rst
> +   smsc47m192.rst
> +   smsc47m1.rst
> +   tc654.rst
> +   tc74.rst
> +   thmc50.rst
> +   tmp102.rst
> +   tmp103.rst
> +   tmp108.rst
> +   tmp401.rst
> +   tmp421.rst
> +   tps40422.rst
> +   twl4030-madc-hwmon.rst
> +   ucd9000.rst
> +   ucd9200.rst
> +   vexpress.rst
> +   via686a.rst
> +   vt1211.rst
> +   w83627ehf.rst
> +   w83627hf.rst
> +   w83773g.rst
> +   w83781d.rst
> +   w83791d.rst
> +   w83792d.rst
> +   w83793.rst
> +   w83795.rst
> +   w83l785ts.rst
> +   w83l786ng.rst
> +   wm831x.rst
> +   wm8350.rst
> +   xgene-hwmon.rst
> +   zl6100.rst
> +
> +.. only::  subproject and html
> +
> +   Indices
> +   =======
> +
> +   * :ref:`genindex`
> diff --git a/Documentation/hwmon/ir35221 b/Documentation/hwmon/ir35221.rst
> similarity index 100%
> rename from Documentation/hwmon/ir35221
> rename to Documentation/hwmon/ir35221.rst
> diff --git a/Documentation/hwmon/it87 b/Documentation/hwmon/it87.rst
> similarity index 100%
> rename from Documentation/hwmon/it87
> rename to Documentation/hwmon/it87.rst
> diff --git a/Documentation/hwmon/jc42 b/Documentation/hwmon/jc42.rst
> similarity index 100%
> rename from Documentation/hwmon/jc42
> rename to Documentation/hwmon/jc42.rst
> diff --git a/Documentation/hwmon/k10temp b/Documentation/hwmon/k10temp.rst
> similarity index 100%
> rename from Documentation/hwmon/k10temp
> rename to Documentation/hwmon/k10temp.rst
> diff --git a/Documentation/hwmon/k8temp b/Documentation/hwmon/k8temp.rst
> similarity index 100%
> rename from Documentation/hwmon/k8temp
> rename to Documentation/hwmon/k8temp.rst
> diff --git a/Documentation/hwmon/lineage-pem b/Documentation/hwmon/lineage-pem.rst
> similarity index 100%
> rename from Documentation/hwmon/lineage-pem
> rename to Documentation/hwmon/lineage-pem.rst
> diff --git a/Documentation/hwmon/lm25066 b/Documentation/hwmon/lm25066.rst
> similarity index 97%
> rename from Documentation/hwmon/lm25066
> rename to Documentation/hwmon/lm25066.rst
> index 60b7f2722931..da15e3094c8c 100644
> --- a/Documentation/hwmon/lm25066
> +++ b/Documentation/hwmon/lm25066.rst
> @@ -69,7 +69,7 @@ LM25066, LM5064, and LM5066/LM5066I Power Management, Monitoring,
>  Control, and Protection ICs.
>  
>  The driver is a client driver to the core PMBus driver. Please see
> -Documentation/hwmon/pmbus for details on PMBus client drivers.
> +Documentation/hwmon/pmbus.rst for details on PMBus client drivers.
>  
>  
>  Usage Notes
> diff --git a/Documentation/hwmon/lm63 b/Documentation/hwmon/lm63.rst
> similarity index 100%
> rename from Documentation/hwmon/lm63
> rename to Documentation/hwmon/lm63.rst
> diff --git a/Documentation/hwmon/lm70 b/Documentation/hwmon/lm70.rst
> similarity index 100%
> rename from Documentation/hwmon/lm70
> rename to Documentation/hwmon/lm70.rst
> diff --git a/Documentation/hwmon/lm73 b/Documentation/hwmon/lm73.rst
> similarity index 100%
> rename from Documentation/hwmon/lm73
> rename to Documentation/hwmon/lm73.rst
> diff --git a/Documentation/hwmon/lm75 b/Documentation/hwmon/lm75.rst
> similarity index 100%
> rename from Documentation/hwmon/lm75
> rename to Documentation/hwmon/lm75.rst
> diff --git a/Documentation/hwmon/lm77 b/Documentation/hwmon/lm77.rst
> similarity index 100%
> rename from Documentation/hwmon/lm77
> rename to Documentation/hwmon/lm77.rst
> diff --git a/Documentation/hwmon/lm78 b/Documentation/hwmon/lm78.rst
> similarity index 100%
> rename from Documentation/hwmon/lm78
> rename to Documentation/hwmon/lm78.rst
> diff --git a/Documentation/hwmon/lm80 b/Documentation/hwmon/lm80.rst
> similarity index 100%
> rename from Documentation/hwmon/lm80
> rename to Documentation/hwmon/lm80.rst
> diff --git a/Documentation/hwmon/lm83 b/Documentation/hwmon/lm83.rst
> similarity index 100%
> rename from Documentation/hwmon/lm83
> rename to Documentation/hwmon/lm83.rst
> diff --git a/Documentation/hwmon/lm85 b/Documentation/hwmon/lm85.rst
> similarity index 100%
> rename from Documentation/hwmon/lm85
> rename to Documentation/hwmon/lm85.rst
> diff --git a/Documentation/hwmon/lm87 b/Documentation/hwmon/lm87.rst
> similarity index 100%
> rename from Documentation/hwmon/lm87
> rename to Documentation/hwmon/lm87.rst
> diff --git a/Documentation/hwmon/lm90 b/Documentation/hwmon/lm90.rst
> similarity index 100%
> rename from Documentation/hwmon/lm90
> rename to Documentation/hwmon/lm90.rst
> diff --git a/Documentation/hwmon/lm92 b/Documentation/hwmon/lm92.rst
> similarity index 100%
> rename from Documentation/hwmon/lm92
> rename to Documentation/hwmon/lm92.rst
> diff --git a/Documentation/hwmon/lm93 b/Documentation/hwmon/lm93.rst
> similarity index 100%
> rename from Documentation/hwmon/lm93
> rename to Documentation/hwmon/lm93.rst
> diff --git a/Documentation/hwmon/lm95234 b/Documentation/hwmon/lm95234.rst
> similarity index 100%
> rename from Documentation/hwmon/lm95234
> rename to Documentation/hwmon/lm95234.rst
> diff --git a/Documentation/hwmon/lm95245 b/Documentation/hwmon/lm95245.rst
> similarity index 100%
> rename from Documentation/hwmon/lm95245
> rename to Documentation/hwmon/lm95245.rst
> diff --git a/Documentation/hwmon/ltc2945 b/Documentation/hwmon/ltc2945.rst
> similarity index 100%
> rename from Documentation/hwmon/ltc2945
> rename to Documentation/hwmon/ltc2945.rst
> diff --git a/Documentation/hwmon/ltc2978 b/Documentation/hwmon/ltc2978.rst
> similarity index 100%
> rename from Documentation/hwmon/ltc2978
> rename to Documentation/hwmon/ltc2978.rst
> diff --git a/Documentation/hwmon/ltc2990 b/Documentation/hwmon/ltc2990.rst
> similarity index 100%
> rename from Documentation/hwmon/ltc2990
> rename to Documentation/hwmon/ltc2990.rst
> diff --git a/Documentation/hwmon/ltc3815 b/Documentation/hwmon/ltc3815.rst
> similarity index 100%
> rename from Documentation/hwmon/ltc3815
> rename to Documentation/hwmon/ltc3815.rst
> diff --git a/Documentation/hwmon/ltc4151 b/Documentation/hwmon/ltc4151.rst
> similarity index 100%
> rename from Documentation/hwmon/ltc4151
> rename to Documentation/hwmon/ltc4151.rst
> diff --git a/Documentation/hwmon/ltc4215 b/Documentation/hwmon/ltc4215.rst
> similarity index 100%
> rename from Documentation/hwmon/ltc4215
> rename to Documentation/hwmon/ltc4215.rst
> diff --git a/Documentation/hwmon/ltc4245 b/Documentation/hwmon/ltc4245.rst
> similarity index 100%
> rename from Documentation/hwmon/ltc4245
> rename to Documentation/hwmon/ltc4245.rst
> diff --git a/Documentation/hwmon/ltc4260 b/Documentation/hwmon/ltc4260.rst
> similarity index 100%
> rename from Documentation/hwmon/ltc4260
> rename to Documentation/hwmon/ltc4260.rst
> diff --git a/Documentation/hwmon/ltc4261 b/Documentation/hwmon/ltc4261.rst
> similarity index 100%
> rename from Documentation/hwmon/ltc4261
> rename to Documentation/hwmon/ltc4261.rst
> diff --git a/Documentation/hwmon/max16064 b/Documentation/hwmon/max16064.rst
> similarity index 96%
> rename from Documentation/hwmon/max16064
> rename to Documentation/hwmon/max16064.rst
> index 61ec679dc477..6d5e9538991f 100644
> --- a/Documentation/hwmon/max16064
> +++ b/Documentation/hwmon/max16064.rst
> @@ -21,7 +21,7 @@ This driver supports hardware monitoring for Maxim MAX16064 Quad Power-Supply
>  Controller with Active-Voltage Output Control and PMBus Interface.
>  
>  The driver is a client driver to the core PMBus driver.
> -Please see Documentation/hwmon/pmbus for details on PMBus client drivers.
> +Please see Documentation/hwmon/pmbus.rst for details on PMBus client drivers.
>  
>  
>  Usage Notes
> diff --git a/Documentation/hwmon/max16065 b/Documentation/hwmon/max16065.rst
> similarity index 100%
> rename from Documentation/hwmon/max16065
> rename to Documentation/hwmon/max16065.rst
> diff --git a/Documentation/hwmon/max1619 b/Documentation/hwmon/max1619.rst
> similarity index 100%
> rename from Documentation/hwmon/max1619
> rename to Documentation/hwmon/max1619.rst
> diff --git a/Documentation/hwmon/max1668 b/Documentation/hwmon/max1668.rst
> similarity index 100%
> rename from Documentation/hwmon/max1668
> rename to Documentation/hwmon/max1668.rst
> diff --git a/Documentation/hwmon/max197 b/Documentation/hwmon/max197.rst
> similarity index 100%
> rename from Documentation/hwmon/max197
> rename to Documentation/hwmon/max197.rst
> diff --git a/Documentation/hwmon/max20751 b/Documentation/hwmon/max20751.rst
> similarity index 96%
> rename from Documentation/hwmon/max20751
> rename to Documentation/hwmon/max20751.rst
> index d546695900ef..aa4469be6674 100644
> --- a/Documentation/hwmon/max20751
> +++ b/Documentation/hwmon/max20751.rst
> @@ -23,7 +23,7 @@ This driver supports MAX20751 Multiphase Master with PMBus Interface
>  and Internal Buck Converter.
>  
>  The driver is a client driver to the core PMBus driver.
> -Please see Documentation/hwmon/pmbus for details on PMBus client drivers.
> +Please see Documentation/hwmon/pmbus.rst for details on PMBus client drivers.
>  
>  
>  Usage Notes
> diff --git a/Documentation/hwmon/max31722 b/Documentation/hwmon/max31722.rst
> similarity index 100%
> rename from Documentation/hwmon/max31722
> rename to Documentation/hwmon/max31722.rst
> diff --git a/Documentation/hwmon/max31785 b/Documentation/hwmon/max31785.rst
> similarity index 100%
> rename from Documentation/hwmon/max31785
> rename to Documentation/hwmon/max31785.rst
> diff --git a/Documentation/hwmon/max31790 b/Documentation/hwmon/max31790.rst
> similarity index 100%
> rename from Documentation/hwmon/max31790
> rename to Documentation/hwmon/max31790.rst
> diff --git a/Documentation/hwmon/max34440 b/Documentation/hwmon/max34440.rst
> similarity index 98%
> rename from Documentation/hwmon/max34440
> rename to Documentation/hwmon/max34440.rst
> index 639838ef29fd..939138e12b02 100644
> --- a/Documentation/hwmon/max34440
> +++ b/Documentation/hwmon/max34440.rst
> @@ -76,7 +76,7 @@ based on GIN pins. The MAX34460 supports 12 voltage channels, and the MAX34461
>  supports 16 voltage channels.
>  
>  The driver is a client driver to the core PMBus driver. Please see
> -Documentation/hwmon/pmbus for details on PMBus client drivers.
> +Documentation/hwmon/pmbus.rst for details on PMBus client drivers.
>  
>  
>  Usage Notes
> diff --git a/Documentation/hwmon/max6639 b/Documentation/hwmon/max6639.rst
> similarity index 100%
> rename from Documentation/hwmon/max6639
> rename to Documentation/hwmon/max6639.rst
> diff --git a/Documentation/hwmon/max6642 b/Documentation/hwmon/max6642.rst
> similarity index 100%
> rename from Documentation/hwmon/max6642
> rename to Documentation/hwmon/max6642.rst
> diff --git a/Documentation/hwmon/max6650 b/Documentation/hwmon/max6650.rst
> similarity index 100%
> rename from Documentation/hwmon/max6650
> rename to Documentation/hwmon/max6650.rst
> diff --git a/Documentation/hwmon/max6697 b/Documentation/hwmon/max6697.rst
> similarity index 100%
> rename from Documentation/hwmon/max6697
> rename to Documentation/hwmon/max6697.rst
> diff --git a/Documentation/hwmon/max8688 b/Documentation/hwmon/max8688.rst
> similarity index 97%
> rename from Documentation/hwmon/max8688
> rename to Documentation/hwmon/max8688.rst
> index 43da139234c1..009487759c61 100644
> --- a/Documentation/hwmon/max8688
> +++ b/Documentation/hwmon/max8688.rst
> @@ -21,7 +21,7 @@ This driver supports hardware monitoring for Maxim MAX8688 Digital Power-Supply
>  Controller/Monitor with PMBus Interface.
>  
>  The driver is a client driver to the core PMBus driver. Please see
> -Documentation/hwmon/pmbus for details on PMBus client drivers.
> +Documentation/hwmon/pmbus.rst for details on PMBus client drivers.
>  
>  
>  Usage Notes
> diff --git a/Documentation/hwmon/mc13783-adc b/Documentation/hwmon/mc13783-adc.rst
> similarity index 100%
> rename from Documentation/hwmon/mc13783-adc
> rename to Documentation/hwmon/mc13783-adc.rst
> diff --git a/Documentation/hwmon/mcp3021 b/Documentation/hwmon/mcp3021.rst
> similarity index 100%
> rename from Documentation/hwmon/mcp3021
> rename to Documentation/hwmon/mcp3021.rst
> diff --git a/Documentation/hwmon/menf21bmc b/Documentation/hwmon/menf21bmc.rst
> similarity index 100%
> rename from Documentation/hwmon/menf21bmc
> rename to Documentation/hwmon/menf21bmc.rst
> diff --git a/Documentation/hwmon/mlxreg-fan b/Documentation/hwmon/mlxreg-fan.rst
> similarity index 100%
> rename from Documentation/hwmon/mlxreg-fan
> rename to Documentation/hwmon/mlxreg-fan.rst
> diff --git a/Documentation/hwmon/nct6683 b/Documentation/hwmon/nct6683.rst
> similarity index 100%
> rename from Documentation/hwmon/nct6683
> rename to Documentation/hwmon/nct6683.rst
> diff --git a/Documentation/hwmon/nct6775 b/Documentation/hwmon/nct6775.rst
> similarity index 100%
> rename from Documentation/hwmon/nct6775
> rename to Documentation/hwmon/nct6775.rst
> diff --git a/Documentation/hwmon/nct7802 b/Documentation/hwmon/nct7802.rst
> similarity index 100%
> rename from Documentation/hwmon/nct7802
> rename to Documentation/hwmon/nct7802.rst
> diff --git a/Documentation/hwmon/nct7904 b/Documentation/hwmon/nct7904.rst
> similarity index 100%
> rename from Documentation/hwmon/nct7904
> rename to Documentation/hwmon/nct7904.rst
> diff --git a/Documentation/hwmon/npcm750-pwm-fan b/Documentation/hwmon/npcm750-pwm-fan.rst
> similarity index 100%
> rename from Documentation/hwmon/npcm750-pwm-fan
> rename to Documentation/hwmon/npcm750-pwm-fan.rst
> diff --git a/Documentation/hwmon/nsa320 b/Documentation/hwmon/nsa320.rst
> similarity index 100%
> rename from Documentation/hwmon/nsa320
> rename to Documentation/hwmon/nsa320.rst
> diff --git a/Documentation/hwmon/ntc_thermistor b/Documentation/hwmon/ntc_thermistor.rst
> similarity index 100%
> rename from Documentation/hwmon/ntc_thermistor
> rename to Documentation/hwmon/ntc_thermistor.rst
> diff --git a/Documentation/hwmon/occ b/Documentation/hwmon/occ.rst
> similarity index 100%
> rename from Documentation/hwmon/occ
> rename to Documentation/hwmon/occ.rst
> diff --git a/Documentation/hwmon/pc87360 b/Documentation/hwmon/pc87360.rst
> similarity index 100%
> rename from Documentation/hwmon/pc87360
> rename to Documentation/hwmon/pc87360.rst
> diff --git a/Documentation/hwmon/pc87427 b/Documentation/hwmon/pc87427.rst
> similarity index 100%
> rename from Documentation/hwmon/pc87427
> rename to Documentation/hwmon/pc87427.rst
> diff --git a/Documentation/hwmon/pcf8591 b/Documentation/hwmon/pcf8591.rst
> similarity index 100%
> rename from Documentation/hwmon/pcf8591
> rename to Documentation/hwmon/pcf8591.rst
> diff --git a/Documentation/hwmon/pmbus-core b/Documentation/hwmon/pmbus-core.rst
> similarity index 100%
> rename from Documentation/hwmon/pmbus-core
> rename to Documentation/hwmon/pmbus-core.rst
> diff --git a/Documentation/hwmon/pmbus b/Documentation/hwmon/pmbus.rst
> similarity index 100%
> rename from Documentation/hwmon/pmbus
> rename to Documentation/hwmon/pmbus.rst
> diff --git a/Documentation/hwmon/powr1220 b/Documentation/hwmon/powr1220.rst
> similarity index 100%
> rename from Documentation/hwmon/powr1220
> rename to Documentation/hwmon/powr1220.rst
> diff --git a/Documentation/hwmon/pwm-fan b/Documentation/hwmon/pwm-fan.rst
> similarity index 100%
> rename from Documentation/hwmon/pwm-fan
> rename to Documentation/hwmon/pwm-fan.rst
> diff --git a/Documentation/hwmon/raspberrypi-hwmon b/Documentation/hwmon/raspberrypi-hwmon.rst
> similarity index 100%
> rename from Documentation/hwmon/raspberrypi-hwmon
> rename to Documentation/hwmon/raspberrypi-hwmon.rst
> diff --git a/Documentation/hwmon/sch5627 b/Documentation/hwmon/sch5627.rst
> similarity index 100%
> rename from Documentation/hwmon/sch5627
> rename to Documentation/hwmon/sch5627.rst
> diff --git a/Documentation/hwmon/sch5636 b/Documentation/hwmon/sch5636.rst
> similarity index 100%
> rename from Documentation/hwmon/sch5636
> rename to Documentation/hwmon/sch5636.rst
> diff --git a/Documentation/hwmon/scpi-hwmon b/Documentation/hwmon/scpi-hwmon.rst
> similarity index 100%
> rename from Documentation/hwmon/scpi-hwmon
> rename to Documentation/hwmon/scpi-hwmon.rst
> diff --git a/Documentation/hwmon/sht15 b/Documentation/hwmon/sht15.rst
> similarity index 100%
> rename from Documentation/hwmon/sht15
> rename to Documentation/hwmon/sht15.rst
> diff --git a/Documentation/hwmon/sht21 b/Documentation/hwmon/sht21.rst
> similarity index 100%
> rename from Documentation/hwmon/sht21
> rename to Documentation/hwmon/sht21.rst
> diff --git a/Documentation/hwmon/sht3x b/Documentation/hwmon/sht3x.rst
> similarity index 100%
> rename from Documentation/hwmon/sht3x
> rename to Documentation/hwmon/sht3x.rst
> diff --git a/Documentation/hwmon/shtc1 b/Documentation/hwmon/shtc1.rst
> similarity index 100%
> rename from Documentation/hwmon/shtc1
> rename to Documentation/hwmon/shtc1.rst
> diff --git a/Documentation/hwmon/sis5595 b/Documentation/hwmon/sis5595.rst
> similarity index 100%
> rename from Documentation/hwmon/sis5595
> rename to Documentation/hwmon/sis5595.rst
> diff --git a/Documentation/hwmon/smm665 b/Documentation/hwmon/smm665.rst
> similarity index 100%
> rename from Documentation/hwmon/smm665
> rename to Documentation/hwmon/smm665.rst
> diff --git a/Documentation/hwmon/smsc47b397 b/Documentation/hwmon/smsc47b397.rst
> similarity index 100%
> rename from Documentation/hwmon/smsc47b397
> rename to Documentation/hwmon/smsc47b397.rst
> diff --git a/Documentation/hwmon/smsc47m1 b/Documentation/hwmon/smsc47m1.rst
> similarity index 100%
> rename from Documentation/hwmon/smsc47m1
> rename to Documentation/hwmon/smsc47m1.rst
> diff --git a/Documentation/hwmon/smsc47m192 b/Documentation/hwmon/smsc47m192.rst
> similarity index 100%
> rename from Documentation/hwmon/smsc47m192
> rename to Documentation/hwmon/smsc47m192.rst
> diff --git a/Documentation/hwmon/submitting-patches b/Documentation/hwmon/submitting-patches.rst
> similarity index 98%
> rename from Documentation/hwmon/submitting-patches
> rename to Documentation/hwmon/submitting-patches.rst
> index 12540b7d9b50..f9796b9d9db6 100644
> --- a/Documentation/hwmon/submitting-patches
> +++ b/Documentation/hwmon/submitting-patches.rst
> @@ -39,7 +39,7 @@ increase the chances of your change being accepted.
>  2. Adding functionality to existing drivers
>  -------------------------------------------
>  
> -* Make sure the documentation in Documentation/hwmon/<driver_name> is up to
> +* Make sure the documentation in Documentation/hwmon/<driver_name>.rst is up to
>    date.
>  
>  * Make sure the information in Kconfig is up to date.
> @@ -61,7 +61,7 @@ increase the chances of your change being accepted.
>  
>  * Consider adding yourself to MAINTAINERS.
>  
> -* Document the driver in Documentation/hwmon/<driver_name>.
> +* Document the driver in Documentation/hwmon/<driver_name>.rst.
>  
>  * Add the driver to Kconfig and Makefile in alphabetical order.
>  
> @@ -134,7 +134,7 @@ increase the chances of your change being accepted.
>    non-standard attributes, or you believe you do, discuss it on the mailing list
>    first. Either case, provide a detailed explanation why you need the
>    non-standard attribute(s).
> -  Standard attributes are specified in Documentation/hwmon/sysfs-interface.
> +  Standard attributes are specified in Documentation/hwmon/sysfs-interface.rst.
>  
>  * When deciding which sysfs attributes to support, look at the chip's
>    capabilities. While we do not expect your driver to support everything the
> diff --git a/Documentation/hwmon/sysfs-interface b/Documentation/hwmon/sysfs-interface.rst
> similarity index 100%
> rename from Documentation/hwmon/sysfs-interface
> rename to Documentation/hwmon/sysfs-interface.rst
> diff --git a/Documentation/hwmon/tc654 b/Documentation/hwmon/tc654.rst
> similarity index 100%
> rename from Documentation/hwmon/tc654
> rename to Documentation/hwmon/tc654.rst
> diff --git a/Documentation/hwmon/tc74 b/Documentation/hwmon/tc74.rst
> similarity index 100%
> rename from Documentation/hwmon/tc74
> rename to Documentation/hwmon/tc74.rst
> diff --git a/Documentation/hwmon/thmc50 b/Documentation/hwmon/thmc50.rst
> similarity index 100%
> rename from Documentation/hwmon/thmc50
> rename to Documentation/hwmon/thmc50.rst
> diff --git a/Documentation/hwmon/tmp102 b/Documentation/hwmon/tmp102.rst
> similarity index 93%
> rename from Documentation/hwmon/tmp102
> rename to Documentation/hwmon/tmp102.rst
> index 5e34821df4ab..b1f585531a88 100644
> --- a/Documentation/hwmon/tmp102
> +++ b/Documentation/hwmon/tmp102.rst
> @@ -28,4 +28,4 @@ The TMP102 has a programmable update rate that can select between 8, 4, 1, and
>  0.5 Hz. (Currently the driver only supports the default of 4 Hz).
>  
>  The driver provides the common sysfs-interface for temperatures (see
> -Documentation/hwmon/sysfs-interface under Temperatures).
> +Documentation/hwmon/sysfs-interface.rst under Temperatures).
> diff --git a/Documentation/hwmon/tmp103 b/Documentation/hwmon/tmp103.rst
> similarity index 92%
> rename from Documentation/hwmon/tmp103
> rename to Documentation/hwmon/tmp103.rst
> index 7682a795e38c..15d25806d585 100644
> --- a/Documentation/hwmon/tmp103
> +++ b/Documentation/hwmon/tmp103.rst
> @@ -27,7 +27,7 @@ Resolution: 8 Bits
>  Accuracy: ±1°C Typ (–10°C to +100°C)
>  
>  The driver provides the common sysfs-interface for temperatures (see
> -Documentation/hwmon/sysfs-interface under Temperatures).
> +Documentation/hwmon/sysfs-interface.rst under Temperatures).
>  
>  Please refer how to instantiate this driver:
>  Documentation/i2c/instantiating-devices
> diff --git a/Documentation/hwmon/tmp108 b/Documentation/hwmon/tmp108.rst
> similarity index 95%
> rename from Documentation/hwmon/tmp108
> rename to Documentation/hwmon/tmp108.rst
> index 7e08b7ef1e2f..5f4266a16cb2 100644
> --- a/Documentation/hwmon/tmp108
> +++ b/Documentation/hwmon/tmp108.rst
> @@ -38,4 +38,4 @@ and then the device is shut down automatically. (This driver only supports
>  continuous mode.)
>  
>  The driver provides the common sysfs-interface for temperatures (see
> -Documentation/hwmon/sysfs-interface under Temperatures).
> +Documentation/hwmon/sysfs-interface.rst under Temperatures).
> diff --git a/Documentation/hwmon/tmp401 b/Documentation/hwmon/tmp401.rst
> similarity index 97%
> rename from Documentation/hwmon/tmp401
> rename to Documentation/hwmon/tmp401.rst
> index bd865bbdb38d..6a05a0719bc7 100644
> --- a/Documentation/hwmon/tmp401
> +++ b/Documentation/hwmon/tmp401.rst
> @@ -68,7 +68,7 @@ supported by the driver so far, so using the default resolution of 0.5
>  degree).
>  
>  The driver provides the common sysfs-interface for temperatures (see
> -Documentation/hwmon/sysfs-interface under Temperatures).
> +Documentation/hwmon/sysfs-interface.rst under Temperatures).
>  
>  The TMP411 and TMP431 chips are compatible with TMP401. TMP411 provides
>  some additional features.
> diff --git a/Documentation/hwmon/tmp421 b/Documentation/hwmon/tmp421.rst
> similarity index 100%
> rename from Documentation/hwmon/tmp421
> rename to Documentation/hwmon/tmp421.rst
> diff --git a/Documentation/hwmon/tps40422 b/Documentation/hwmon/tps40422.rst
> similarity index 96%
> rename from Documentation/hwmon/tps40422
> rename to Documentation/hwmon/tps40422.rst
> index 359751eb5ed4..b691e30479dd 100644
> --- a/Documentation/hwmon/tps40422
> +++ b/Documentation/hwmon/tps40422.rst
> @@ -21,7 +21,7 @@ This driver supports TI TPS40422 Dual-Output or Two-Phase Synchronous Buck
>  Controller with PMBus
>  
>  The driver is a client driver to the core PMBus driver.
> -Please see Documentation/hwmon/pmbus for details on PMBus client drivers.
> +Please see Documentation/hwmon/pmbus.rst for details on PMBus client drivers.
>  
>  
>  Usage Notes
> diff --git a/Documentation/hwmon/twl4030-madc-hwmon b/Documentation/hwmon/twl4030-madc-hwmon.rst
> similarity index 100%
> rename from Documentation/hwmon/twl4030-madc-hwmon
> rename to Documentation/hwmon/twl4030-madc-hwmon.rst
> diff --git a/Documentation/hwmon/ucd9000 b/Documentation/hwmon/ucd9000.rst
> similarity index 97%
> rename from Documentation/hwmon/ucd9000
> rename to Documentation/hwmon/ucd9000.rst
> index d69061b7312c..ebc4f2b3bfea 100644
> --- a/Documentation/hwmon/ucd9000
> +++ b/Documentation/hwmon/ucd9000.rst
> @@ -57,7 +57,7 @@ system-health monitor. The device integrates a 12-bit ADC for monitoring up to
>  13 power-supply voltage, current, or temperature inputs.
>  
>  This driver is a client driver to the core PMBus driver. Please see
> -Documentation/hwmon/pmbus for details on PMBus client drivers.
> +Documentation/hwmon/pmbus.rst for details on PMBus client drivers.
>  
>  
>  Usage Notes
> @@ -72,7 +72,7 @@ Platform data support
>  ---------------------
>  
>  The driver supports standard PMBus driver platform data. Please see
> -Documentation/hwmon/pmbus for details.
> +Documentation/hwmon/pmbus.rst for details.
>  
>  
>  Sysfs entries
> diff --git a/Documentation/hwmon/ucd9200 b/Documentation/hwmon/ucd9200.rst
> similarity index 97%
> rename from Documentation/hwmon/ucd9200
> rename to Documentation/hwmon/ucd9200.rst
> index 44eda4a579b6..b819dfd75f71 100644
> --- a/Documentation/hwmon/ucd9200
> +++ b/Documentation/hwmon/ucd9200.rst
> @@ -33,7 +33,7 @@ dedicated circuitry for DC/DC loop management with flash memory and a serial
>  interface to support configuration, monitoring and management.
>  
>  This driver is a client driver to the core PMBus driver. Please see
> -Documentation/hwmon/pmbus for details on PMBus client drivers.
> +Documentation/hwmon/pmbus.rst for details on PMBus client drivers.
>  
>  
>  Usage Notes
> @@ -48,7 +48,7 @@ Platform data support
>  ---------------------
>  
>  The driver supports standard PMBus driver platform data. Please see
> -Documentation/hwmon/pmbus for details.
> +Documentation/hwmon/pmbus.rst for details.
>  
>  
>  Sysfs entries
> diff --git a/Documentation/hwmon/userspace-tools b/Documentation/hwmon/userspace-tools.rst
> similarity index 100%
> rename from Documentation/hwmon/userspace-tools
> rename to Documentation/hwmon/userspace-tools.rst
> diff --git a/Documentation/hwmon/vexpress b/Documentation/hwmon/vexpress.rst
> similarity index 100%
> rename from Documentation/hwmon/vexpress
> rename to Documentation/hwmon/vexpress.rst
> diff --git a/Documentation/hwmon/via686a b/Documentation/hwmon/via686a.rst
> similarity index 100%
> rename from Documentation/hwmon/via686a
> rename to Documentation/hwmon/via686a.rst
> diff --git a/Documentation/hwmon/vt1211 b/Documentation/hwmon/vt1211.rst
> similarity index 100%
> rename from Documentation/hwmon/vt1211
> rename to Documentation/hwmon/vt1211.rst
> diff --git a/Documentation/hwmon/w83627ehf b/Documentation/hwmon/w83627ehf.rst
> similarity index 100%
> rename from Documentation/hwmon/w83627ehf
> rename to Documentation/hwmon/w83627ehf.rst
> diff --git a/Documentation/hwmon/w83627hf b/Documentation/hwmon/w83627hf.rst
> similarity index 100%
> rename from Documentation/hwmon/w83627hf
> rename to Documentation/hwmon/w83627hf.rst
> diff --git a/Documentation/hwmon/w83773g b/Documentation/hwmon/w83773g.rst
> similarity index 100%
> rename from Documentation/hwmon/w83773g
> rename to Documentation/hwmon/w83773g.rst
> diff --git a/Documentation/hwmon/w83781d b/Documentation/hwmon/w83781d.rst
> similarity index 100%
> rename from Documentation/hwmon/w83781d
> rename to Documentation/hwmon/w83781d.rst
> diff --git a/Documentation/hwmon/w83791d b/Documentation/hwmon/w83791d.rst
> similarity index 99%
> rename from Documentation/hwmon/w83791d
> rename to Documentation/hwmon/w83791d.rst
> index a91f9e5fb0c6..3adaed39b157 100644
> --- a/Documentation/hwmon/w83791d
> +++ b/Documentation/hwmon/w83791d.rst
> @@ -102,7 +102,7 @@ This file is used for both legacy and new code.
>  
>  The sysfs interface to the beep bitmask has migrated from the original legacy
>  method of a single sysfs beep_mask file to a newer method using multiple
> -`*_beep` files as described in `Documentation/hwmon/sysfs-interface`.
> +`*_beep` files as described in `Documentation/hwmon/sysfs-interface.rst`.
>  
>  A similar change has occurred for the bitmap corresponding to the alarms. The
>  original legacy method used a single sysfs alarms file containing a bitmap
> diff --git a/Documentation/hwmon/w83792d b/Documentation/hwmon/w83792d.rst
> similarity index 100%
> rename from Documentation/hwmon/w83792d
> rename to Documentation/hwmon/w83792d.rst
> diff --git a/Documentation/hwmon/w83793 b/Documentation/hwmon/w83793.rst
> similarity index 100%
> rename from Documentation/hwmon/w83793
> rename to Documentation/hwmon/w83793.rst
> diff --git a/Documentation/hwmon/w83795 b/Documentation/hwmon/w83795.rst
> similarity index 100%
> rename from Documentation/hwmon/w83795
> rename to Documentation/hwmon/w83795.rst
> diff --git a/Documentation/hwmon/w83l785ts b/Documentation/hwmon/w83l785ts.rst
> similarity index 100%
> rename from Documentation/hwmon/w83l785ts
> rename to Documentation/hwmon/w83l785ts.rst
> diff --git a/Documentation/hwmon/w83l786ng b/Documentation/hwmon/w83l786ng.rst
> similarity index 100%
> rename from Documentation/hwmon/w83l786ng
> rename to Documentation/hwmon/w83l786ng.rst
> diff --git a/Documentation/hwmon/wm831x b/Documentation/hwmon/wm831x.rst
> similarity index 100%
> rename from Documentation/hwmon/wm831x
> rename to Documentation/hwmon/wm831x.rst
> diff --git a/Documentation/hwmon/wm8350 b/Documentation/hwmon/wm8350.rst
> similarity index 100%
> rename from Documentation/hwmon/wm8350
> rename to Documentation/hwmon/wm8350.rst
> diff --git a/Documentation/hwmon/xgene-hwmon b/Documentation/hwmon/xgene-hwmon.rst
> similarity index 100%
> rename from Documentation/hwmon/xgene-hwmon
> rename to Documentation/hwmon/xgene-hwmon.rst
> diff --git a/Documentation/hwmon/zl6100 b/Documentation/hwmon/zl6100.rst
> similarity index 98%
> rename from Documentation/hwmon/zl6100
> rename to Documentation/hwmon/zl6100.rst
> index 4029970bace4..41513bb7fe51 100644
> --- a/Documentation/hwmon/zl6100
> +++ b/Documentation/hwmon/zl6100.rst
> @@ -113,7 +113,7 @@ This driver supports hardware monitoring for Intersil / Zilker Labs ZL6100 and
>  compatible digital DC-DC controllers.
>  
>  The driver is a client driver to the core PMBus driver. Please see
> -Documentation/hwmon/pmbus and Documentation.hwmon/pmbus-core for details
> +Documentation/hwmon/pmbus.rst and Documentation.hwmon/pmbus-core for details
>  on PMBus client drivers.
>  
>  
> diff --git a/Documentation/index.rst b/Documentation/index.rst
> index 80a421cb935e..3a710dc24fc8 100644
> --- a/Documentation/index.rst
> +++ b/Documentation/index.rst
> @@ -83,6 +83,7 @@ needed).
>     media/index
>     networking/index
>     input/index
> +   hwmon/index
>     gpu/index
>     security/index
>     sound/index
> diff --git a/Documentation/thermal/sysfs-api.txt b/Documentation/thermal/sysfs-api.txt
> index 911399730c1c..c3fa500df92c 100644
> --- a/Documentation/thermal/sysfs-api.txt
> +++ b/Documentation/thermal/sysfs-api.txt
> @@ -316,7 +316,7 @@ ACPI thermal zones.
>      |---temp[1-*]_input:	The current temperature of thermal zone [1-*]
>      |---temp[1-*]_critical:	The critical trip point of thermal zone [1-*]
>  
> -Please read Documentation/hwmon/sysfs-interface for additional information.
> +Please read Documentation/hwmon/sysfs-interface.rst for additional information.
>  
>  ***************************
>  * Thermal zone attributes *
> diff --git a/MAINTAINERS b/MAINTAINERS
> index dc615cb76455..d258fb8e7e8e 100644
> --- a/MAINTAINERS
> +++ b/MAINTAINERS
> @@ -468,7 +468,7 @@ ADM1025 HARDWARE MONITOR DRIVER
>  M:	Jean Delvare <jdelvare@suse.com>
>  L:	linux-hwmon@vger.kernel.org
>  S:	Maintained
> -F:	Documentation/hwmon/adm1025
> +F:	Documentation/hwmon/adm1025.rst
>  F:	drivers/hwmon/adm1025.c
>  
>  ADM1029 HARDWARE MONITOR DRIVER
> @@ -520,7 +520,7 @@ ADS1015 HARDWARE MONITOR DRIVER
>  M:	Dirk Eibach <eibach@gdsys.de>
>  L:	linux-hwmon@vger.kernel.org
>  S:	Maintained
> -F:	Documentation/hwmon/ads1015
> +F:	Documentation/hwmon/ads1015.rst
>  F:	drivers/hwmon/ads1015.c
>  F:	include/linux/platform_data/ads1015.h
>  
> @@ -533,7 +533,7 @@ ADT7475 HARDWARE MONITOR DRIVER
>  M:	Jean Delvare <jdelvare@suse.com>
>  L:	linux-hwmon@vger.kernel.org
>  S:	Maintained
> -F:	Documentation/hwmon/adt7475
> +F:	Documentation/hwmon/adt7475.rst
>  F:	drivers/hwmon/adt7475.c
>  
>  ADVANSYS SCSI DRIVER
> @@ -764,7 +764,7 @@ AMD FAM15H PROCESSOR POWER MONITORING DRIVER
>  M:	Huang Rui <ray.huang@amd.com>
>  L:	linux-hwmon@vger.kernel.org
>  S:	Supported
> -F:	Documentation/hwmon/fam15h_power
> +F:	Documentation/hwmon/fam15h_power.rst
>  F:	drivers/hwmon/fam15h_power.c
>  
>  AMD FCH GPIO DRIVER
> @@ -2512,7 +2512,7 @@ ASC7621 HARDWARE MONITOR DRIVER
>  M:	George Joseph <george.joseph@fairview5.com>
>  L:	linux-hwmon@vger.kernel.org
>  S:	Maintained
> -F:	Documentation/hwmon/asc7621
> +F:	Documentation/hwmon/asc7621.rst
>  F:	drivers/hwmon/asc7621.c
>  
>  ASPEED VIDEO ENGINE DRIVER
> @@ -4043,7 +4043,7 @@ CORETEMP HARDWARE MONITORING DRIVER
>  M:	Fenghua Yu <fenghua.yu@intel.com>
>  L:	linux-hwmon@vger.kernel.org
>  S:	Maintained
> -F:	Documentation/hwmon/coretemp
> +F:	Documentation/hwmon/coretemp.rst
>  F:	drivers/hwmon/coretemp.c
>  
>  COSA/SRP SYNC SERIAL DRIVER
> @@ -4598,7 +4598,7 @@ DIALOG SEMICONDUCTOR DRIVERS
>  M:	Support Opensource <support.opensource@diasemi.com>
>  W:	http://www.dialog-semiconductor.com/products
>  S:	Supported
> -F:	Documentation/hwmon/da90??
> +F:	Documentation/hwmon/da90??.rst
>  F:	Documentation/devicetree/bindings/mfd/da90*.txt
>  F:	Documentation/devicetree/bindings/input/da90??-onkey.txt
>  F:	Documentation/devicetree/bindings/thermal/da90??-thermal.txt
> @@ -4749,7 +4749,7 @@ DME1737 HARDWARE MONITOR DRIVER
>  M:	Juerg Haefliger <juergh@gmail.com>
>  L:	linux-hwmon@vger.kernel.org
>  S:	Maintained
> -F:	Documentation/hwmon/dme1737
> +F:	Documentation/hwmon/dme1737.rst
>  F:	drivers/hwmon/dme1737.c
>  
>  DMI/SMBIOS SUPPORT
> @@ -5935,7 +5935,7 @@ F71805F HARDWARE MONITORING DRIVER
>  M:	Jean Delvare <jdelvare@suse.com>
>  L:	linux-hwmon@vger.kernel.org
>  S:	Maintained
> -F:	Documentation/hwmon/f71805f
> +F:	Documentation/hwmon/f71805f.rst
>  F:	drivers/hwmon/f71805f.c
>  
>  FADDR2LINE
> @@ -7618,7 +7618,7 @@ INA209 HARDWARE MONITOR DRIVER
>  M:	Guenter Roeck <linux@roeck-us.net>
>  L:	linux-hwmon@vger.kernel.org
>  S:	Maintained
> -F:	Documentation/hwmon/ina209
> +F:	Documentation/hwmon/ina209.rst
>  F:	Documentation/devicetree/bindings/hwmon/ina2xx.txt
>  F:	drivers/hwmon/ina209.c
>  
> @@ -7626,7 +7626,7 @@ INA2XX HARDWARE MONITOR DRIVER
>  M:	Guenter Roeck <linux@roeck-us.net>
>  L:	linux-hwmon@vger.kernel.org
>  S:	Maintained
> -F:	Documentation/hwmon/ina2xx
> +F:	Documentation/hwmon/ina2xx.rst
>  F:	drivers/hwmon/ina2xx.c
>  F:	include/linux/platform_data/ina2xx.h
>  
> @@ -8244,7 +8244,7 @@ IT87 HARDWARE MONITORING DRIVER
>  M:	Jean Delvare <jdelvare@suse.com>
>  L:	linux-hwmon@vger.kernel.org
>  S:	Maintained
> -F:	Documentation/hwmon/it87
> +F:	Documentation/hwmon/it87.rst
>  F:	drivers/hwmon/it87.c
>  
>  IT913X MEDIA DRIVER
> @@ -8288,7 +8288,7 @@ M:	Guenter Roeck <linux@roeck-us.net>
>  L:	linux-hwmon@vger.kernel.org
>  S:	Maintained
>  F:	drivers/hwmon/jc42.c
> -F:	Documentation/hwmon/jc42
> +F:	Documentation/hwmon/jc42.rst
>  
>  JFS FILESYSTEM
>  M:	Dave Kleikamp <shaggy@kernel.org>
> @@ -8336,14 +8336,14 @@ K10TEMP HARDWARE MONITORING DRIVER
>  M:	Clemens Ladisch <clemens@ladisch.de>
>  L:	linux-hwmon@vger.kernel.org
>  S:	Maintained
> -F:	Documentation/hwmon/k10temp
> +F:	Documentation/hwmon/k10temp.rst
>  F:	drivers/hwmon/k10temp.c
>  
>  K8TEMP HARDWARE MONITORING DRIVER
>  M:	Rudolf Marek <r.marek@assembler.cz>
>  L:	linux-hwmon@vger.kernel.org
>  S:	Maintained
> -F:	Documentation/hwmon/k8temp
> +F:	Documentation/hwmon/k8temp.rst
>  F:	drivers/hwmon/k8temp.c
>  
>  KASAN
> @@ -9034,21 +9034,21 @@ LM78 HARDWARE MONITOR DRIVER
>  M:	Jean Delvare <jdelvare@suse.com>
>  L:	linux-hwmon@vger.kernel.org
>  S:	Maintained
> -F:	Documentation/hwmon/lm78
> +F:	Documentation/hwmon/lm78.rst
>  F:	drivers/hwmon/lm78.c
>  
>  LM83 HARDWARE MONITOR DRIVER
>  M:	Jean Delvare <jdelvare@suse.com>
>  L:	linux-hwmon@vger.kernel.org
>  S:	Maintained
> -F:	Documentation/hwmon/lm83
> +F:	Documentation/hwmon/lm83.rst
>  F:	drivers/hwmon/lm83.c
>  
>  LM90 HARDWARE MONITOR DRIVER
>  M:	Jean Delvare <jdelvare@suse.com>
>  L:	linux-hwmon@vger.kernel.org
>  S:	Maintained
> -F:	Documentation/hwmon/lm90
> +F:	Documentation/hwmon/lm90.rst
>  F:	Documentation/devicetree/bindings/hwmon/lm90.txt
>  F:	drivers/hwmon/lm90.c
>  F:	include/dt-bindings/thermal/lm90.h
> @@ -9057,7 +9057,7 @@ LM95234 HARDWARE MONITOR DRIVER
>  M:	Guenter Roeck <linux@roeck-us.net>
>  L:	linux-hwmon@vger.kernel.org
>  S:	Maintained
> -F:	Documentation/hwmon/lm95234
> +F:	Documentation/hwmon/lm95234.rst
>  F:	drivers/hwmon/lm95234.c
>  
>  LME2510 MEDIA DRIVER
> @@ -9131,7 +9131,7 @@ LTC4261 HARDWARE MONITOR DRIVER
>  M:	Guenter Roeck <linux@roeck-us.net>
>  L:	linux-hwmon@vger.kernel.org
>  S:	Maintained
> -F:	Documentation/hwmon/ltc4261
> +F:	Documentation/hwmon/ltc4261.rst
>  F:	drivers/hwmon/ltc4261.c
>  
>  LTC4306 I2C MULTIPLEXER DRIVER
> @@ -9362,7 +9362,7 @@ MAX16065 HARDWARE MONITOR DRIVER
>  M:	Guenter Roeck <linux@roeck-us.net>
>  L:	linux-hwmon@vger.kernel.org
>  S:	Maintained
> -F:	Documentation/hwmon/max16065
> +F:	Documentation/hwmon/max16065.rst
>  F:	drivers/hwmon/max16065.c
>  
>  MAX2175 SDR TUNER DRIVER
> @@ -9378,14 +9378,14 @@ F:	include/uapi/linux/max2175.h
>  MAX6650 HARDWARE MONITOR AND FAN CONTROLLER DRIVER
>  L:	linux-hwmon@vger.kernel.org
>  S:	Orphan
> -F:	Documentation/hwmon/max6650
> +F:	Documentation/hwmon/max6650.rst
>  F:	drivers/hwmon/max6650.c
>  
>  MAX6697 HARDWARE MONITOR DRIVER
>  M:	Guenter Roeck <linux@roeck-us.net>
>  L:	linux-hwmon@vger.kernel.org
>  S:	Maintained
> -F:	Documentation/hwmon/max6697
> +F:	Documentation/hwmon/max6697.rst
>  F:	Documentation/devicetree/bindings/hwmon/max6697.txt
>  F:	drivers/hwmon/max6697.c
>  F:	include/linux/platform_data/max6697.h
> @@ -10031,7 +10031,7 @@ F:	drivers/mfd/menf21bmc.c
>  F:	drivers/watchdog/menf21bmc_wdt.c
>  F:	drivers/leds/leds-menf21bmc.c
>  F:	drivers/hwmon/menf21bmc_hwmon.c
> -F:	Documentation/hwmon/menf21bmc
> +F:	Documentation/hwmon/menf21bmc.rst
>  
>  MEN Z069 WATCHDOG DRIVER
>  M:	Johannes Thumshirn <jth@kernel.org>
> @@ -10659,7 +10659,7 @@ NCT6775 HARDWARE MONITOR DRIVER
>  M:	Guenter Roeck <linux@roeck-us.net>
>  L:	linux-hwmon@vger.kernel.org
>  S:	Maintained
> -F:	Documentation/hwmon/nct6775
> +F:	Documentation/hwmon/nct6775.rst
>  F:	drivers/hwmon/nct6775.c
>  
>  NET_FAILOVER MODULE
> @@ -11753,7 +11753,7 @@ PC87360 HARDWARE MONITORING DRIVER
>  M:	Jim Cromie <jim.cromie@gmail.com>
>  L:	linux-hwmon@vger.kernel.org
>  S:	Maintained
> -F:	Documentation/hwmon/pc87360
> +F:	Documentation/hwmon/pc87360.rst
>  F:	drivers/hwmon/pc87360.c
>  
>  PC8736x GPIO DRIVER
> @@ -11765,7 +11765,7 @@ PC87427 HARDWARE MONITORING DRIVER
>  M:	Jean Delvare <jdelvare@suse.com>
>  L:	linux-hwmon@vger.kernel.org
>  S:	Maintained
> -F:	Documentation/hwmon/pc87427
> +F:	Documentation/hwmon/pc87427.rst
>  F:	drivers/hwmon/pc87427.c
>  
>  PCA9532 LED DRIVER
> @@ -12333,23 +12333,23 @@ S:	Maintained
>  F:	Documentation/devicetree/bindings/hwmon/ibm,cffps1.txt
>  F:	Documentation/devicetree/bindings/hwmon/max31785.txt
>  F:	Documentation/devicetree/bindings/hwmon/ltc2978.txt
> -F:	Documentation/hwmon/adm1275
> -F:	Documentation/hwmon/ibm-cffps
> -F:	Documentation/hwmon/ir35221
> -F:	Documentation/hwmon/lm25066
> -F:	Documentation/hwmon/ltc2978
> -F:	Documentation/hwmon/ltc3815
> -F:	Documentation/hwmon/max16064
> -F:	Documentation/hwmon/max20751
> -F:	Documentation/hwmon/max31785
> -F:	Documentation/hwmon/max34440
> -F:	Documentation/hwmon/max8688
> -F:	Documentation/hwmon/pmbus
> -F:	Documentation/hwmon/pmbus-core
> -F:	Documentation/hwmon/tps40422
> -F:	Documentation/hwmon/ucd9000
> -F:	Documentation/hwmon/ucd9200
> -F:	Documentation/hwmon/zl6100
> +F:	Documentation/hwmon/adm1275.rst
> +F:	Documentation/hwmon/ibm-cffps.rst
> +F:	Documentation/hwmon/ir35221.rst
> +F:	Documentation/hwmon/lm25066.rst
> +F:	Documentation/hwmon/ltc2978.rst
> +F:	Documentation/hwmon/ltc3815.rst
> +F:	Documentation/hwmon/max16064.rst
> +F:	Documentation/hwmon/max20751.rst
> +F:	Documentation/hwmon/max31785.rst
> +F:	Documentation/hwmon/max34440.rst
> +F:	Documentation/hwmon/max8688.rst
> +F:	Documentation/hwmon/pmbus.rst
> +F:	Documentation/hwmon/pmbus-core.rst
> +F:	Documentation/hwmon/tps40422.rst
> +F:	Documentation/hwmon/ucd9000.rst
> +F:	Documentation/hwmon/ucd9200.rst
> +F:	Documentation/hwmon/zl6100.rst
>  F:	drivers/hwmon/pmbus/
>  F:	include/linux/pmbus.h
>  
> @@ -12613,7 +12613,7 @@ M:	Bartlomiej Zolnierkiewicz <b.zolnierkie@samsung.com>
>  L:	linux-hwmon@vger.kernel.org
>  S:	Supported
>  F:	Documentation/devicetree/bindings/hwmon/pwm-fan.txt
> -F:	Documentation/hwmon/pwm-fan
> +F:	Documentation/hwmon/pwm-fan.rst
>  F:	drivers/hwmon/pwm-fan.c
>  
>  PWM IR Transmitter
> @@ -14278,21 +14278,21 @@ SMM665 HARDWARE MONITOR DRIVER
>  M:	Guenter Roeck <linux@roeck-us.net>
>  L:	linux-hwmon@vger.kernel.org
>  S:	Maintained
> -F:	Documentation/hwmon/smm665
> +F:	Documentation/hwmon/smm665.rst
>  F:	drivers/hwmon/smm665.c
>  
>  SMSC EMC2103 HARDWARE MONITOR DRIVER
>  M:	Steve Glendinning <steve.glendinning@shawell.net>
>  L:	linux-hwmon@vger.kernel.org
>  S:	Maintained
> -F:	Documentation/hwmon/emc2103
> +F:	Documentation/hwmon/emc2103.rst
>  F:	drivers/hwmon/emc2103.c
>  
>  SMSC SCH5627 HARDWARE MONITOR DRIVER
>  M:	Hans de Goede <hdegoede@redhat.com>
>  L:	linux-hwmon@vger.kernel.org
>  S:	Supported
> -F:	Documentation/hwmon/sch5627
> +F:	Documentation/hwmon/sch5627.rst
>  F:	drivers/hwmon/sch5627.c
>  
>  SMSC UFX6000 and UFX7000 USB to VGA DRIVER
> @@ -14305,7 +14305,7 @@ SMSC47B397 HARDWARE MONITOR DRIVER
>  M:	Jean Delvare <jdelvare@suse.com>
>  L:	linux-hwmon@vger.kernel.org
>  S:	Maintained
> -F:	Documentation/hwmon/smsc47b397
> +F:	Documentation/hwmon/smsc47b397.rst
>  F:	drivers/hwmon/smsc47b397.c
>  
>  SMSC911x ETHERNET DRIVER
> @@ -15650,7 +15650,7 @@ TMP401 HARDWARE MONITOR DRIVER
>  M:	Guenter Roeck <linux@roeck-us.net>
>  L:	linux-hwmon@vger.kernel.org
>  S:	Maintained
> -F:	Documentation/hwmon/tmp401
> +F:	Documentation/hwmon/tmp401.rst
>  F:	drivers/hwmon/tmp401.c
>  
>  TMPFS (SHMEM FILESYSTEM)
> @@ -16675,7 +16675,7 @@ VT1211 HARDWARE MONITOR DRIVER
>  M:	Juerg Haefliger <juergh@gmail.com>
>  L:	linux-hwmon@vger.kernel.org
>  S:	Maintained
> -F:	Documentation/hwmon/vt1211
> +F:	Documentation/hwmon/vt1211.rst
>  F:	drivers/hwmon/vt1211.c
>  
>  VT8231 HARDWARE MONITOR DRIVER
> @@ -16703,14 +16703,14 @@ W83791D HARDWARE MONITORING DRIVER
>  M:	Marc Hulsman <m.hulsman@tudelft.nl>
>  L:	linux-hwmon@vger.kernel.org
>  S:	Maintained
> -F:	Documentation/hwmon/w83791d
> +F:	Documentation/hwmon/w83791d.rst
>  F:	drivers/hwmon/w83791d.c
>  
>  W83793 HARDWARE MONITORING DRIVER
>  M:	Rudolf Marek <r.marek@assembler.cz>
>  L:	linux-hwmon@vger.kernel.org
>  S:	Maintained
> -F:	Documentation/hwmon/w83793
> +F:	Documentation/hwmon/w83793.rst
>  F:	drivers/hwmon/w83793.c
>  
>  W83795 HARDWARE MONITORING DRIVER
> @@ -16819,7 +16819,7 @@ L:	patches@opensource.cirrus.com
>  T:	git https://github.com/CirrusLogic/linux-drivers.git
>  W:	https://github.com/CirrusLogic/linux-drivers/wiki
>  S:	Supported
> -F:	Documentation/hwmon/wm83??
> +F:	Documentation/hwmon/wm83??.rst
>  F:	Documentation/devicetree/bindings/extcon/extcon-arizona.txt
>  F:	Documentation/devicetree/bindings/regulator/arizona-regulator.txt
>  F:	Documentation/devicetree/bindings/mfd/arizona.txt
> diff --git a/drivers/hwmon/Kconfig b/drivers/hwmon/Kconfig
> index 6f929bfa9fcd..74c6c95cb657 100644
> --- a/drivers/hwmon/Kconfig
> +++ b/drivers/hwmon/Kconfig
> @@ -17,7 +17,7 @@ menuconfig HWMON
>  
>  	  To find out which specific driver(s) you need, use the
>  	  sensors-detect script from the lm_sensors package.  Read
> -	  <file:Documentation/hwmon/userspace-tools> for details.
> +	  <file:Documentation/hwmon/userspace-tools.rst> for details.
>  
>  	  This support can also be built as a module. If so, the module
>  	  will be called hwmon.
> @@ -59,7 +59,7 @@ config SENSORS_ABITUGURU
>  	  chip can be found on Abit uGuru featuring motherboards (most modern
>  	  Abit motherboards from before end 2005). For more info and a list
>  	  of which motherboards have which revision see
> -	  Documentation/hwmon/abituguru
> +	  Documentation/hwmon/abituguru.rst
>  
>  	  This driver can also be built as a module. If so, the module
>  	  will be called abituguru.
> @@ -73,7 +73,7 @@ config SENSORS_ABITUGURU3
>  	  and their settings is supported. The third revision of the Abit
>  	  uGuru chip can be found on recent Abit motherboards (since end
>  	  2005). For more info and a list of which motherboards have which
> -	  revision see Documentation/hwmon/abituguru3
> +	  revision see Documentation/hwmon/abituguru3.rst
>  
>  	  This driver can also be built as a module. If so, the module
>  	  will be called abituguru3.
> @@ -643,7 +643,7 @@ config SENSORS_CORETEMP
>  	help
>  	  If you say yes here you get support for the temperature
>  	  sensor inside your CPU. Most of the family 6 CPUs
> -	  are supported. Check Documentation/hwmon/coretemp for details.
> +	  are supported. Check Documentation/hwmon/coretemp.rst for details.
>  
>  config SENSORS_IT87
>  	tristate "ITE IT87xx and compatibles"
> diff --git a/drivers/hwmon/ads7828.c b/drivers/hwmon/ads7828.c
> index 12c56d3783ed..545b635a104e 100644
> --- a/drivers/hwmon/ads7828.c
> +++ b/drivers/hwmon/ads7828.c
> @@ -8,7 +8,7 @@
>   *
>   * ADS7830 support, by Guillaume Roguez <guillaume.roguez@savoirfairelinux.com>
>   *
> - * For further information, see the Documentation/hwmon/ads7828 file.
> + * For further information, see the Documentation/hwmon/ads7828.rst file.
>   *
>   * This program is free software; you can redistribute it and/or modify
>   * it under the terms of the GNU General Public License as published by
> diff --git a/drivers/hwmon/max197.c b/drivers/hwmon/max197.c
> index 3d9e210beedf..dd6a35219a18 100644
> --- a/drivers/hwmon/max197.c
> +++ b/drivers/hwmon/max197.c
> @@ -8,7 +8,7 @@
>   * it under the terms of the GNU General Public License version 2 as
>   * published by the Free Software Foundation.
>   *
> - * For further information, see the Documentation/hwmon/max197 file.
> + * For further information, see the Documentation/hwmon/max197.rst file.
>   */
>  
>  #include <linux/kernel.h>
> diff --git a/drivers/hwmon/sht15.c b/drivers/hwmon/sht15.c
> index 39b41e35c2bf..7f4a63959730 100644
> --- a/drivers/hwmon/sht15.c
> +++ b/drivers/hwmon/sht15.c
> @@ -10,7 +10,7 @@
>   *
>   * Copyright (c) 2007 Wouter Horre
>   *
> - * For further information, see the Documentation/hwmon/sht15 file.
> + * For further information, see the Documentation/hwmon/sht15.rst file.
>   */
>  
>  #include <linux/interrupt.h>
> diff --git a/include/linux/platform_data/ads7828.h b/include/linux/platform_data/ads7828.h
> index 3245f45f9d77..a3370a007702 100644
> --- a/include/linux/platform_data/ads7828.h
> +++ b/include/linux/platform_data/ads7828.h
> @@ -4,7 +4,7 @@
>   * Copyright (c) 2012 Savoir-faire Linux Inc.
>   *          Vivien Didelot <vivien.didelot@savoirfairelinux.com>
>   *
> - * For further information, see the Documentation/hwmon/ads7828 file.
> + * For further information, see the Documentation/hwmon/ads7828.rst file.
>   *
>   * This program is free software; you can redistribute it and/or modify
>   * it under the terms of the GNU General Public License version 2 as
> diff --git a/include/linux/platform_data/ds620.h b/include/linux/platform_data/ds620.h
> index 6ef58bb77e46..f0ce22a78bb8 100644
> --- a/include/linux/platform_data/ds620.h
> +++ b/include/linux/platform_data/ds620.h
> @@ -14,7 +14,7 @@ struct ds620_platform_data {
>  	 *  1 = PO_LOW
>  	 *  2 = PO_HIGH
>  	 *
> -	 * (see Documentation/hwmon/ds620)
> +	 * (see Documentation/hwmon/ds620.rst)
>  	 */
>  	int pomode;
>  };
> diff --git a/include/linux/platform_data/ina2xx.h b/include/linux/platform_data/ina2xx.h
> index 9f0aa1b48c78..dde59fd3590f 100644
> --- a/include/linux/platform_data/ina2xx.h
> +++ b/include/linux/platform_data/ina2xx.h
> @@ -7,7 +7,7 @@
>   * it under the terms of the GNU General Public License version 2 as
>   * published by the Free Software Foundation.
>   *
> - * For further information, see the Documentation/hwmon/ina2xx file.
> + * For further information, see the Documentation/hwmon/ina2xx.rst file.
>   */
>  
>  /**
> diff --git a/include/linux/platform_data/max197.h b/include/linux/platform_data/max197.h
> index 8da8f94ee15c..2bbd0919bc89 100644
> --- a/include/linux/platform_data/max197.h
> +++ b/include/linux/platform_data/max197.h
> @@ -8,7 +8,7 @@
>   * it under the terms of the GNU General Public License version 2 as
>   * published by the Free Software Foundation.
>   *
> - * For further information, see the Documentation/hwmon/max197 file.
> + * For further information, see the Documentation/hwmon/max197.rst file.
>   */
>  
>  #ifndef _PDATA_MAX197_H
> diff --git a/include/linux/platform_data/ntc_thermistor.h b/include/linux/platform_data/ntc_thermistor.h
> index ee03d429742b..5fa115d3ea4b 100644
> --- a/include/linux/platform_data/ntc_thermistor.h
> +++ b/include/linux/platform_data/ntc_thermistor.h
> @@ -42,7 +42,7 @@ struct ntc_thermistor_platform_data {
>  	 * read_uV()
>  	 *
>  	 * How to setup pullup_ohm, pulldown_ohm, and connect is
> -	 * described at Documentation/hwmon/ntc_thermistor
> +	 * described at Documentation/hwmon/ntc_thermistor.rst
>  	 *
>  	 * pullup/down_ohm: 0 for infinite / not-connected
>  	 *
> -- 
> 2.20.1
> 

-- 
====================
| I would like to |
| fix the world,  |
| but they're not |
| giving me the   |
 \ source code!  /
  ---------------
    ¯\_(ツ)_/¯

^ permalink raw reply	[flat|nested] 73+ messages in thread

* Re: [PATCH v2 00/21] Convert hwmon documentation to ReST
  2019-04-10 19:22 [PATCH v2 00/21] Convert hwmon documentation to ReST Mauro Carvalho Chehab
                   ` (20 preceding siblings ...)
  2019-04-10 19:22 ` [PATCH v2 21/21] docs: hwmon: Add an index file and rename docs to *.rst Mauro Carvalho Chehab
@ 2019-04-11 18:43 ` Jonathan Corbet
  2019-04-11 20:43   ` Mauro Carvalho Chehab
  21 siblings, 1 reply; 73+ messages in thread
From: Jonathan Corbet @ 2019-04-11 18:43 UTC (permalink / raw)
  To: Mauro Carvalho Chehab
  Cc: Linux Doc Mailing List, Mauro Carvalho Chehab, linux-kernel,
	Andrew Jeffery, Benjamin Herrenschmidt, Guenter Roeck,
	Jean Delvare, Joel Stanley, linux-arm-kernel, linux-aspeed,
	linux-hwmon, linuxppc-dev, Liviu Dudau, Lorenzo Pieralisi,
	Michael Ellerman, Paul Mackerras, Sudeep Holla

On Wed, 10 Apr 2019 16:22:37 -0300
Mauro Carvalho Chehab <mchehab+samsung@kernel.org> wrote:

> This series converts the contents of Documentation/hwmon to ReST
> format.
> 
> PS.: I opted to group the conversion files per groups of maintainer
> set, as, if I were to generate one patch per file, it would give around
> 160 patches.
> 
> I also added those patches to my development tree at:
> 	https://git.linuxtv.org/mchehab/experimental.git/log/?h=hwmon
> 
> If you want to see the results, they're at:
> 	https://www.infradead.org/~mchehab/hwmon/

This set seems generally good and could probably be applied as-is.  But I
have to ask...is there a reason to not take the last step and actually
bring this stuff into the Sphinx doc tree?

We seem to be mostly documenting sysfs files and such.  I am *guessing*
that perhaps the set should move to Documentation/admin-guide/hwmon?  Or
have I misunderstood the intended audience here?

Thanks,

jon

^ permalink raw reply	[flat|nested] 73+ messages in thread

* Re: [PATCH v2 00/21] Convert hwmon documentation to ReST
  2019-04-11 18:43 ` [PATCH v2 00/21] Convert hwmon documentation to ReST Jonathan Corbet
@ 2019-04-11 20:43   ` Mauro Carvalho Chehab
  2019-04-11 21:07     ` Guenter Roeck
  0 siblings, 1 reply; 73+ messages in thread
From: Mauro Carvalho Chehab @ 2019-04-11 20:43 UTC (permalink / raw)
  To: Jonathan Corbet
  Cc: Linux Doc Mailing List, Mauro Carvalho Chehab, linux-kernel,
	Andrew Jeffery, Benjamin Herrenschmidt, Guenter Roeck,
	Jean Delvare, Joel Stanley, linux-arm-kernel, linux-aspeed,
	linux-hwmon, linuxppc-dev, Liviu Dudau, Lorenzo Pieralisi,
	Michael Ellerman, Paul Mackerras, Sudeep Holla

Em Thu, 11 Apr 2019 12:43:24 -0600
Jonathan Corbet <corbet@lwn.net> escreveu:

> On Wed, 10 Apr 2019 16:22:37 -0300
> Mauro Carvalho Chehab <mchehab+samsung@kernel.org> wrote:
> 
> > This series converts the contents of Documentation/hwmon to ReST
> > format.
> > 
> > PS.: I opted to group the conversion files per groups of maintainer
> > set, as, if I were to generate one patch per file, it would give around
> > 160 patches.
> > 
> > I also added those patches to my development tree at:
> > 	https://git.linuxtv.org/mchehab/experimental.git/log/?h=hwmon
> > 
> > If you want to see the results, they're at:
> > 	https://www.infradead.org/~mchehab/hwmon/  
> 
> This set seems generally good and could probably be applied as-is.  But I
> have to ask...is there a reason to not take the last step and actually
> bring this stuff into the Sphinx doc tree?
> 
> We seem to be mostly documenting sysfs files and such.  I am *guessing*
> that perhaps the set should move to Documentation/admin-guide/hwmon?  Or
> have I misunderstood the intended audience here?

:-)

Yeah, I'd say that 80% of the contents there are user-faced.

Yet, the main issue with this (and other driver subsystems) is that there's
a mix of userspace and Kernelspace stuff. One somewhat simple case is
the abituguru: it has a "datasheet" file:

	abituguru-datasheet

This contains programming information for the corresponding drivers,
while abituguru and abituguru3 contains mostly userspace
stuff (still, it also contains the I2C address, with shouldn't mean
anything for the user).

However, if you take a look at w83781d, you'll see a mix of both
userspace and driver developer info there... it has a chapter called
"Data sheet updates", for example, with is probably meaningless for
anyone but the hwmon driver developers.

That's, btw, a pattern that happens a lot inside device driver
documents on almost all subsystems I checked: driver-specific
documentation is usually not split into user-facing/kernel-facing.

While nobody does such split, IMHO, the best would be to keep the
information outside Documentation/admin-guide. But hey! You're
the Doc maintainer. If you prefer to move, I'm perfectly fine
with that.


Thanks,
Mauro

^ permalink raw reply	[flat|nested] 73+ messages in thread

* Re: [PATCH v2 00/21] Convert hwmon documentation to ReST
  2019-04-11 20:43   ` Mauro Carvalho Chehab
@ 2019-04-11 21:07     ` Guenter Roeck
  2019-04-11 23:54       ` Mauro Carvalho Chehab
  2019-04-12 16:04       ` Jonathan Corbet
  0 siblings, 2 replies; 73+ messages in thread
From: Guenter Roeck @ 2019-04-11 21:07 UTC (permalink / raw)
  To: Mauro Carvalho Chehab
  Cc: Jonathan Corbet, Linux Doc Mailing List, Mauro Carvalho Chehab,
	linux-kernel, Andrew Jeffery, Benjamin Herrenschmidt,
	Jean Delvare, Joel Stanley, linux-arm-kernel, linux-aspeed,
	linux-hwmon, linuxppc-dev, Liviu Dudau, Lorenzo Pieralisi,
	Michael Ellerman, Paul Mackerras, Sudeep Holla

On Thu, Apr 11, 2019 at 05:43:57PM -0300, Mauro Carvalho Chehab wrote:
> Em Thu, 11 Apr 2019 12:43:24 -0600
> Jonathan Corbet <corbet@lwn.net> escreveu:
> 
> > On Wed, 10 Apr 2019 16:22:37 -0300
> > Mauro Carvalho Chehab <mchehab+samsung@kernel.org> wrote:
> > 
> > > This series converts the contents of Documentation/hwmon to ReST
> > > format.
> > > 
> > > PS.: I opted to group the conversion files per groups of maintainer
> > > set, as, if I were to generate one patch per file, it would give around
> > > 160 patches.
> > > 
> > > I also added those patches to my development tree at:
> > > 	https://git.linuxtv.org/mchehab/experimental.git/log/?h=hwmon
> > > 
> > > If you want to see the results, they're at:
> > > 	https://www.infradead.org/~mchehab/hwmon/  
> > 
> > This set seems generally good and could probably be applied as-is.  But I
> > have to ask...is there a reason to not take the last step and actually
> > bring this stuff into the Sphinx doc tree?
> > 
> > We seem to be mostly documenting sysfs files and such.  I am *guessing*
> > that perhaps the set should move to Documentation/admin-guide/hwmon?  Or
> > have I misunderstood the intended audience here?
> 
> :-)
> 
> Yeah, I'd say that 80% of the contents there are user-faced.
> 
> Yet, the main issue with this (and other driver subsystems) is that there's
> a mix of userspace and Kernelspace stuff. One somewhat simple case is
> the abituguru: it has a "datasheet" file:
> 
> 	abituguru-datasheet
> 
> This contains programming information for the corresponding drivers,
> while abituguru and abituguru3 contains mostly userspace
> stuff (still, it also contains the I2C address, with shouldn't mean
> anything for the user).
> 
> However, if you take a look at w83781d, you'll see a mix of both
> userspace and driver developer info there... it has a chapter called
> "Data sheet updates", for example, with is probably meaningless for
> anyone but the hwmon driver developers.
> 
> That's, btw, a pattern that happens a lot inside device driver
> documents on almost all subsystems I checked: driver-specific
> documentation is usually not split into user-facing/kernel-facing.
> 
> While nobody does such split, IMHO, the best would be to keep the
> information outside Documentation/admin-guide. But hey! You're
> the Doc maintainer. If you prefer to move, I'm perfectly fine
> with that.
> 

Same here, but please don't move the files which are kernel facing only.

How do you want to handle this series ? Do you expect it to be pushed
through hwmon, or through Documentation, or do you plan to push yourself ?

If the series isn't pushed through hwmon, we'll likely have a couple of
conflicts against hwmon-next.

Thanks,
Guenter

^ permalink raw reply	[flat|nested] 73+ messages in thread

* Re: [PATCH v2 00/21] Convert hwmon documentation to ReST
  2019-04-11 21:07     ` Guenter Roeck
@ 2019-04-11 23:54       ` Mauro Carvalho Chehab
  2019-04-12 16:04       ` Jonathan Corbet
  1 sibling, 0 replies; 73+ messages in thread
From: Mauro Carvalho Chehab @ 2019-04-11 23:54 UTC (permalink / raw)
  To: Guenter Roeck
  Cc: Jonathan Corbet, Linux Doc Mailing List, Mauro Carvalho Chehab,
	linux-kernel, Andrew Jeffery, Benjamin Herrenschmidt,
	Jean Delvare, Joel Stanley, linux-arm-kernel, linux-aspeed,
	linux-hwmon, linuxppc-dev, Liviu Dudau, Lorenzo Pieralisi,
	Michael Ellerman, Paul Mackerras, Sudeep Holla

Em Thu, 11 Apr 2019 14:07:31 -0700
Guenter Roeck <linux@roeck-us.net> escreveu:

> On Thu, Apr 11, 2019 at 05:43:57PM -0300, Mauro Carvalho Chehab wrote:
> > Em Thu, 11 Apr 2019 12:43:24 -0600
> > Jonathan Corbet <corbet@lwn.net> escreveu:
> >   
> > > On Wed, 10 Apr 2019 16:22:37 -0300
> > > Mauro Carvalho Chehab <mchehab+samsung@kernel.org> wrote:
> > >   
> > > > This series converts the contents of Documentation/hwmon to ReST
> > > > format.
> > > > 
> > > > PS.: I opted to group the conversion files per groups of maintainer
> > > > set, as, if I were to generate one patch per file, it would give around
> > > > 160 patches.
> > > > 
> > > > I also added those patches to my development tree at:
> > > > 	https://git.linuxtv.org/mchehab/experimental.git/log/?h=hwmon
> > > > 
> > > > If you want to see the results, they're at:
> > > > 	https://www.infradead.org/~mchehab/hwmon/    
> > > 
> > > This set seems generally good and could probably be applied as-is.  But I
> > > have to ask...is there a reason to not take the last step and actually
> > > bring this stuff into the Sphinx doc tree?
> > > 
> > > We seem to be mostly documenting sysfs files and such.  I am *guessing*
> > > that perhaps the set should move to Documentation/admin-guide/hwmon?  Or
> > > have I misunderstood the intended audience here?  
> > 
> > :-)
> > 
> > Yeah, I'd say that 80% of the contents there are user-faced.
> > 
> > Yet, the main issue with this (and other driver subsystems) is that there's
> > a mix of userspace and Kernelspace stuff. One somewhat simple case is
> > the abituguru: it has a "datasheet" file:
> > 
> > 	abituguru-datasheet
> > 
> > This contains programming information for the corresponding drivers,
> > while abituguru and abituguru3 contains mostly userspace
> > stuff (still, it also contains the I2C address, with shouldn't mean
> > anything for the user).
> > 
> > However, if you take a look at w83781d, you'll see a mix of both
> > userspace and driver developer info there... it has a chapter called
> > "Data sheet updates", for example, with is probably meaningless for
> > anyone but the hwmon driver developers.
> > 
> > That's, btw, a pattern that happens a lot inside device driver
> > documents on almost all subsystems I checked: driver-specific
> > documentation is usually not split into user-facing/kernel-facing.
> > 
> > While nobody does such split, IMHO, the best would be to keep the
> > information outside Documentation/admin-guide. But hey! You're
> > the Doc maintainer. If you prefer to move, I'm perfectly fine
> > with that.
> >   
> 
> Same here, but please don't move the files which are kernel facing only.
> 
> How do you want to handle this series ? Do you expect it to be pushed
> through hwmon, or through Documentation, or do you plan to push yourself ?
> 
> If the series isn't pushed through hwmon, we'll likely have a couple of
> conflicts against hwmon-next.

Guenter,

I won't be pushing it myself. IMO, it makes more sense to apply it at
hwmon-next, except if it would cause some conflicts against docs-next.

Regards,
Mauro

^ permalink raw reply	[flat|nested] 73+ messages in thread

* Re: [PATCH v2 00/21] Convert hwmon documentation to ReST
  2019-04-11 21:07     ` Guenter Roeck
  2019-04-11 23:54       ` Mauro Carvalho Chehab
@ 2019-04-12 16:04       ` Jonathan Corbet
  2019-04-12 16:12         ` Guenter Roeck
  2019-04-13  3:09         ` Guenter Roeck
  1 sibling, 2 replies; 73+ messages in thread
From: Jonathan Corbet @ 2019-04-12 16:04 UTC (permalink / raw)
  To: Guenter Roeck
  Cc: Mauro Carvalho Chehab, Linux Doc Mailing List,
	Mauro Carvalho Chehab, linux-kernel, Andrew Jeffery,
	Benjamin Herrenschmidt, Jean Delvare, Joel Stanley,
	linux-arm-kernel, linux-aspeed, linux-hwmon, linuxppc-dev,
	Liviu Dudau, Lorenzo Pieralisi, Michael Ellerman, Paul Mackerras,
	Sudeep Holla

On Thu, 11 Apr 2019 14:07:31 -0700
Guenter Roeck <linux@roeck-us.net> wrote:

> > While nobody does such split, IMHO, the best would be to keep the
> > information outside Documentation/admin-guide. But hey! You're
> > the Doc maintainer. If you prefer to move, I'm perfectly fine
> > with that.
> >   
> 
> Same here, but please don't move the files which are kernel facing only.

Well, let's step back and think about this.  Who is the audience for
these documents?  That will tell us a lot about where they should really
be.  

What I would prefer to avoid is the status quo where *everything* is in
the top-level directory, and where documents are organized for the
convenience of their maintainers rather than of their readers.  But
sometimes I feel like I'm alone in that desire...:)

Thanks,

jon

^ permalink raw reply	[flat|nested] 73+ messages in thread

* Re: [PATCH v2 00/21] Convert hwmon documentation to ReST
  2019-04-12 16:04       ` Jonathan Corbet
@ 2019-04-12 16:12         ` Guenter Roeck
  2019-04-13  0:25           ` Mauro Carvalho Chehab
  2019-04-13  3:09         ` Guenter Roeck
  1 sibling, 1 reply; 73+ messages in thread
From: Guenter Roeck @ 2019-04-12 16:12 UTC (permalink / raw)
  To: Jonathan Corbet
  Cc: Mauro Carvalho Chehab, Linux Doc Mailing List,
	Mauro Carvalho Chehab, linux-kernel, Andrew Jeffery,
	Benjamin Herrenschmidt, Jean Delvare, Joel Stanley,
	linux-arm-kernel, linux-aspeed, linux-hwmon, linuxppc-dev,
	Liviu Dudau, Lorenzo Pieralisi, Michael Ellerman, Paul Mackerras,
	Sudeep Holla

On 4/12/19 9:04 AM, Jonathan Corbet wrote:
> On Thu, 11 Apr 2019 14:07:31 -0700
> Guenter Roeck <linux@roeck-us.net> wrote:
> 
>>> While nobody does such split, IMHO, the best would be to keep the
>>> information outside Documentation/admin-guide. But hey! You're
>>> the Doc maintainer. If you prefer to move, I'm perfectly fine
>>> with that.
>>>    
>>
>> Same here, but please don't move the files which are kernel facing only.
> 
> Well, let's step back and think about this.  Who is the audience for
> these documents?  That will tell us a lot about where they should really
> be.
> 

Most of them are for users, some of them are for driver developers. A few
are for both, though that is generally not the intention (and one may argue
that driver internal documentation should be moved into the respective
driver source).

> What I would prefer to avoid is the status quo where *everything* is in
> the top-level directory, and where documents are organized for the
> convenience of their maintainers rather than of their readers.  But
> sometimes I feel like I'm alone in that desire...:)
> 
I am fine with separating user pointing from kernel API/driver developer
guides, and I agree that it would make a lot of sense. As I said, please
just make sure that kernel facing files don't end up in the wrong directory.

Thanks,
Guenter

^ permalink raw reply	[flat|nested] 73+ messages in thread

* Re: [PATCH v2 00/21] Convert hwmon documentation to ReST
  2019-04-12 16:12         ` Guenter Roeck
@ 2019-04-13  0:25           ` Mauro Carvalho Chehab
  2019-04-13  0:52             ` Guenter Roeck
  0 siblings, 1 reply; 73+ messages in thread
From: Mauro Carvalho Chehab @ 2019-04-13  0:25 UTC (permalink / raw)
  To: Guenter Roeck
  Cc: Jonathan Corbet, Linux Doc Mailing List, Mauro Carvalho Chehab,
	linux-kernel, Andrew Jeffery, Benjamin Herrenschmidt,
	Jean Delvare, Joel Stanley, linux-arm-kernel, linux-aspeed,
	linux-hwmon, linuxppc-dev, Liviu Dudau, Lorenzo Pieralisi,
	Michael Ellerman, Paul Mackerras, Sudeep Holla

Em Fri, 12 Apr 2019 09:12:52 -0700
Guenter Roeck <linux@roeck-us.net> escreveu:

> On 4/12/19 9:04 AM, Jonathan Corbet wrote:
> > On Thu, 11 Apr 2019 14:07:31 -0700
> > Guenter Roeck <linux@roeck-us.net> wrote:
> >   
> >>> While nobody does such split, IMHO, the best would be to keep the
> >>> information outside Documentation/admin-guide. But hey! You're
> >>> the Doc maintainer. If you prefer to move, I'm perfectly fine
> >>> with that.
> >>>      
> >>
> >> Same here, but please don't move the files which are kernel facing only.  
> > 
> > Well, let's step back and think about this.  Who is the audience for
> > these documents?  That will tell us a lot about where they should really
> > be.
> >   
> 
> Most of them are for users, some of them are for driver developers. A few
> are for both, though that is generally not the intention (and one may argue
> that driver internal documentation should be moved into the respective
> driver source).

The big issue is really those files that contain both kernel internals
and userspace stuff.

This is a common pattern. I just finishing converting a lot more
documents to ReST and I found the same thing on almost all document
directories I touched.

> > What I would prefer to avoid is the status quo where *everything* is in
> > the top-level directory, and where documents are organized for the
> > convenience of their maintainers rather than of their readers.  But
> > sometimes I feel like I'm alone in that desire...:)
> >   
> I am fine with separating user pointing from kernel API/driver developer
> guides, and I agree that it would make a lot of sense. As I said, please
> just make sure that kernel facing files don't end up in the wrong directory.

I like the idea of splitting user faced documents from the rest, but
this is not an easy task. On several cases, there are just a couple
of paragraphs with things like sysfs entries in the middle of a big
file with Kernel internals.

Thanks,
Mauro

^ permalink raw reply	[flat|nested] 73+ messages in thread

* Re: [PATCH v2 00/21] Convert hwmon documentation to ReST
  2019-04-13  0:25           ` Mauro Carvalho Chehab
@ 2019-04-13  0:52             ` Guenter Roeck
  0 siblings, 0 replies; 73+ messages in thread
From: Guenter Roeck @ 2019-04-13  0:52 UTC (permalink / raw)
  To: Mauro Carvalho Chehab
  Cc: Jonathan Corbet, Linux Doc Mailing List, Mauro Carvalho Chehab,
	linux-kernel, Andrew Jeffery, Benjamin Herrenschmidt,
	Jean Delvare, Joel Stanley, linux-arm-kernel, linux-aspeed,
	linux-hwmon, linuxppc-dev, Liviu Dudau, Lorenzo Pieralisi,
	Michael Ellerman, Paul Mackerras, Sudeep Holla

On 4/12/19 5:25 PM, Mauro Carvalho Chehab wrote:
> Em Fri, 12 Apr 2019 09:12:52 -0700
> Guenter Roeck <linux@roeck-us.net> escreveu:
> 
>> On 4/12/19 9:04 AM, Jonathan Corbet wrote:
>>> On Thu, 11 Apr 2019 14:07:31 -0700
>>> Guenter Roeck <linux@roeck-us.net> wrote:
>>>    
>>>>> While nobody does such split, IMHO, the best would be to keep the
>>>>> information outside Documentation/admin-guide. But hey! You're
>>>>> the Doc maintainer. If you prefer to move, I'm perfectly fine
>>>>> with that.
>>>>>       
>>>>
>>>> Same here, but please don't move the files which are kernel facing only.
>>>
>>> Well, let's step back and think about this.  Who is the audience for
>>> these documents?  That will tell us a lot about where they should really
>>> be.
>>>    
>>
>> Most of them are for users, some of them are for driver developers. A few
>> are for both, though that is generally not the intention (and one may argue
>> that driver internal documentation should be moved into the respective
>> driver source).
> 
> The big issue is really those files that contain both kernel internals
> and userspace stuff.
> 
> This is a common pattern. I just finishing converting a lot more
> documents to ReST and I found the same thing on almost all document
> directories I touched.
> 
>>> What I would prefer to avoid is the status quo where *everything* is in
>>> the top-level directory, and where documents are organized for the
>>> convenience of their maintainers rather than of their readers.  But
>>> sometimes I feel like I'm alone in that desire...:)
>>>    
>> I am fine with separating user pointing from kernel API/driver developer
>> guides, and I agree that it would make a lot of sense. As I said, please
>> just make sure that kernel facing files don't end up in the wrong directory.
> 
> I like the idea of splitting user faced documents from the rest, but
> this is not an easy task. On several cases, there are just a couple
> of paragraphs with things like sysfs entries in the middle of a big
> file with Kernel internals.
> 

Yes, I know. I don't think that cleanup is going to happen anytime soon.

Guenter


^ permalink raw reply	[flat|nested] 73+ messages in thread

* Re: [PATCH v2 00/21] Convert hwmon documentation to ReST
  2019-04-12 16:04       ` Jonathan Corbet
  2019-04-12 16:12         ` Guenter Roeck
@ 2019-04-13  3:09         ` Guenter Roeck
  2019-04-16 20:19           ` Jonathan Corbet
  1 sibling, 1 reply; 73+ messages in thread
From: Guenter Roeck @ 2019-04-13  3:09 UTC (permalink / raw)
  To: Jonathan Corbet
  Cc: Mauro Carvalho Chehab, Linux Doc Mailing List,
	Mauro Carvalho Chehab, linux-kernel, Andrew Jeffery,
	Benjamin Herrenschmidt, Jean Delvare, Joel Stanley,
	linux-arm-kernel, linux-aspeed, linux-hwmon, linuxppc-dev,
	Liviu Dudau, Lorenzo Pieralisi, Michael Ellerman, Paul Mackerras,
	Sudeep Holla

On 4/12/19 9:04 AM, Jonathan Corbet wrote:
> On Thu, 11 Apr 2019 14:07:31 -0700
> Guenter Roeck <linux@roeck-us.net> wrote:
> 
>>> While nobody does such split, IMHO, the best would be to keep the
>>> information outside Documentation/admin-guide. But hey! You're
>>> the Doc maintainer. If you prefer to move, I'm perfectly fine
>>> with that.
>>>    
>>
>> Same here, but please don't move the files which are kernel facing only.
> 
> Well, let's step back and think about this.  Who is the audience for
> these documents?  That will tell us a lot about where they should really
> be.
> 
> What I would prefer to avoid is the status quo where *everything* is in
> the top-level directory, and where documents are organized for the
> convenience of their maintainers rather than of their readers.  But
> sometimes I feel like I'm alone in that desire...:)
> 

The big real-world question is: Is the series good enough for you to accept,
or do you expect some level of user/kernel separation ?

Guenter

^ permalink raw reply	[flat|nested] 73+ messages in thread

* Re: [PATCH v2 00/21] Convert hwmon documentation to ReST
  2019-04-13  3:09         ` Guenter Roeck
@ 2019-04-16 20:19           ` Jonathan Corbet
  2019-04-16 20:31             ` Guenter Roeck
  0 siblings, 1 reply; 73+ messages in thread
From: Jonathan Corbet @ 2019-04-16 20:19 UTC (permalink / raw)
  To: Guenter Roeck
  Cc: Mauro Carvalho Chehab, Linux Doc Mailing List,
	Mauro Carvalho Chehab, linux-kernel, Andrew Jeffery,
	Benjamin Herrenschmidt, Jean Delvare, Joel Stanley,
	linux-arm-kernel, linux-aspeed, linux-hwmon, linuxppc-dev,
	Liviu Dudau, Lorenzo Pieralisi, Michael Ellerman, Paul Mackerras,
	Sudeep Holla

On Fri, 12 Apr 2019 20:09:16 -0700
Guenter Roeck <linux@roeck-us.net> wrote:

> The big real-world question is: Is the series good enough for you to accept,
> or do you expect some level of user/kernel separation ?

I guess it can go in; it's forward progress, even if it doesn't make the
improvements I would like to see.

The real question, I guess, is who should take it.  I've been seeing a
fair amount of activity on hwmon, so I suspect that the potential for
conflicts is real.  Perhaps things would go smoother if it went through
your tree?

Thanks,

jon

^ permalink raw reply	[flat|nested] 73+ messages in thread

* Re: [PATCH v2 00/21] Convert hwmon documentation to ReST
  2019-04-16 20:19           ` Jonathan Corbet
@ 2019-04-16 20:31             ` Guenter Roeck
  2019-04-17  1:58               ` Mauro Carvalho Chehab
  0 siblings, 1 reply; 73+ messages in thread
From: Guenter Roeck @ 2019-04-16 20:31 UTC (permalink / raw)
  To: Jonathan Corbet
  Cc: Mauro Carvalho Chehab, Linux Doc Mailing List,
	Mauro Carvalho Chehab, linux-kernel, Andrew Jeffery,
	Benjamin Herrenschmidt, Jean Delvare, Joel Stanley,
	linux-arm-kernel, linux-aspeed, linux-hwmon, linuxppc-dev,
	Liviu Dudau, Lorenzo Pieralisi, Michael Ellerman, Paul Mackerras,
	Sudeep Holla

On Tue, Apr 16, 2019 at 02:19:49PM -0600, Jonathan Corbet wrote:
> On Fri, 12 Apr 2019 20:09:16 -0700
> Guenter Roeck <linux@roeck-us.net> wrote:
> 
> > The big real-world question is: Is the series good enough for you to accept,
> > or do you expect some level of user/kernel separation ?
> 
> I guess it can go in; it's forward progress, even if it doesn't make the
> improvements I would like to see.
> 
> The real question, I guess, is who should take it.  I've been seeing a
> fair amount of activity on hwmon, so I suspect that the potential for
> conflicts is real.  Perhaps things would go smoother if it went through
> your tree?
> 
We'll see a number of conflicts, yes. In terms of timing, this is probably
the worst release in the last few years to make such a change. I currently
have 9 patches queued in hwmon-next which touch Documentation/hwmon.
Of course the changes made in those are all not ReST compatible, and I have
no idea what to look out for to make it compatible. So this is going to be
fun (in a negative sense) either way.

I don't really have a recommendation at this point; I think the best I could
do to take the patches which don't generate conflicts and leave the rest
alone. But that would also be bad, since the new index file would not match
reality. No idea, really, what the best or even a useful approach would be.

Maybe automated changes like this (assuming they are indeed automated)
can be generated and pushed right after a commit window closes. Would
that by any chance be possible ?

Guenter

^ permalink raw reply	[flat|nested] 73+ messages in thread

* Re: [PATCH v2 00/21] Convert hwmon documentation to ReST
  2019-04-16 20:31             ` Guenter Roeck
@ 2019-04-17  1:58               ` Mauro Carvalho Chehab
  2019-04-17  3:49                 ` Guenter Roeck
  0 siblings, 1 reply; 73+ messages in thread
From: Mauro Carvalho Chehab @ 2019-04-17  1:58 UTC (permalink / raw)
  To: Guenter Roeck
  Cc: Jonathan Corbet, Linux Doc Mailing List, Mauro Carvalho Chehab,
	linux-kernel, Andrew Jeffery, Benjamin Herrenschmidt,
	Jean Delvare, Joel Stanley, linux-arm-kernel, linux-aspeed,
	linux-hwmon, linuxppc-dev, Liviu Dudau, Lorenzo Pieralisi,
	Michael Ellerman, Paul Mackerras, Sudeep Holla

Em Tue, 16 Apr 2019 13:31:14 -0700
Guenter Roeck <linux@roeck-us.net> escreveu:

> On Tue, Apr 16, 2019 at 02:19:49PM -0600, Jonathan Corbet wrote:
> > On Fri, 12 Apr 2019 20:09:16 -0700
> > Guenter Roeck <linux@roeck-us.net> wrote:
> >   
> > > The big real-world question is: Is the series good enough for you to accept,
> > > or do you expect some level of user/kernel separation ?  
> > 
> > I guess it can go in; it's forward progress, even if it doesn't make the
> > improvements I would like to see.
> > 
> > The real question, I guess, is who should take it.  I've been seeing a
> > fair amount of activity on hwmon, so I suspect that the potential for
> > conflicts is real.  Perhaps things would go smoother if it went through
> > your tree?
> >   
> We'll see a number of conflicts, yes. In terms of timing, this is probably
> the worst release in the last few years to make such a change. I currently
> have 9 patches queued in hwmon-next which touch Documentation/hwmon.
> Of course the changes made in those are all not ReST compatible, and I have
> no idea what to look out for to make it compatible. So this is going to be
> fun (in a negative sense) either way.
> 
> I don't really have a recommendation at this point; I think the best I could
> do to take the patches which don't generate conflicts and leave the rest
> alone. But that would also be bad, since the new index file would not match
> reality. No idea, really, what the best or even a useful approach would be.
> 
> Maybe automated changes like this (assuming they are indeed automated)
> can be generated and pushed right after a commit window closes. Would
> that by any chance be possible ?

No, those patches are hand-maid, but I can surely rebase it on the top of
your tree. Is your tree already merged at linux-next, or should I use some
other branch/tree for rebase?

Thanks,
Mauro

^ permalink raw reply	[flat|nested] 73+ messages in thread

* Re: [PATCH v2 00/21] Convert hwmon documentation to ReST
  2019-04-17  1:58               ` Mauro Carvalho Chehab
@ 2019-04-17  3:49                 ` Guenter Roeck
  2019-04-17  9:46                   ` [PATCH v3 00/21]Convert " Mauro Carvalho Chehab
  2019-04-17  9:47                   ` [PATCH v2 00/21] Convert hwmon documentation to ReST Mauro Carvalho Chehab
  0 siblings, 2 replies; 73+ messages in thread
From: Guenter Roeck @ 2019-04-17  3:49 UTC (permalink / raw)
  To: Mauro Carvalho Chehab
  Cc: Jonathan Corbet, Linux Doc Mailing List, Mauro Carvalho Chehab,
	linux-kernel, Andrew Jeffery, Benjamin Herrenschmidt,
	Jean Delvare, Joel Stanley, linux-arm-kernel, linux-aspeed,
	linux-hwmon, linuxppc-dev, Liviu Dudau, Lorenzo Pieralisi,
	Michael Ellerman, Paul Mackerras, Sudeep Holla

On 4/16/19 6:58 PM, Mauro Carvalho Chehab wrote:
> Em Tue, 16 Apr 2019 13:31:14 -0700
> Guenter Roeck <linux@roeck-us.net> escreveu:
> 
>> On Tue, Apr 16, 2019 at 02:19:49PM -0600, Jonathan Corbet wrote:
>>> On Fri, 12 Apr 2019 20:09:16 -0700
>>> Guenter Roeck <linux@roeck-us.net> wrote:
>>>    
>>>> The big real-world question is: Is the series good enough for you to accept,
>>>> or do you expect some level of user/kernel separation ?
>>>
>>> I guess it can go in; it's forward progress, even if it doesn't make the
>>> improvements I would like to see.
>>>
>>> The real question, I guess, is who should take it.  I've been seeing a
>>> fair amount of activity on hwmon, so I suspect that the potential for
>>> conflicts is real.  Perhaps things would go smoother if it went through
>>> your tree?
>>>    
>> We'll see a number of conflicts, yes. In terms of timing, this is probably
>> the worst release in the last few years to make such a change. I currently
>> have 9 patches queued in hwmon-next which touch Documentation/hwmon.
>> Of course the changes made in those are all not ReST compatible, and I have
>> no idea what to look out for to make it compatible. So this is going to be
>> fun (in a negative sense) either way.
>>
>> I don't really have a recommendation at this point; I think the best I could
>> do to take the patches which don't generate conflicts and leave the rest
>> alone. But that would also be bad, since the new index file would not match
>> reality. No idea, really, what the best or even a useful approach would be.
>>
>> Maybe automated changes like this (assuming they are indeed automated)
>> can be generated and pushed right after a commit window closes. Would
>> that by any chance be possible ?
> 
> No, those patches are hand-maid, but I can surely rebase it on the top of
> your tree. Is your tree already merged at linux-next, or should I use some
> other branch/tree for rebase?
> 

linux-next merges hwmon-next. next-20190416 is missing one patch which touches
Documentation/hwmon, but that should be easy to deal with.

Thanks,
Guenter

^ permalink raw reply	[flat|nested] 73+ messages in thread

* [PATCH v3 00/21]Convert hwmon documentation to ReST
  2019-04-17  3:49                 ` Guenter Roeck
@ 2019-04-17  9:46                   ` Mauro Carvalho Chehab
  2019-04-17  9:46                     ` [PATCH v3 01/21] docs: hwmon: k10temp: convert to ReST format Mauro Carvalho Chehab
                                       ` (20 more replies)
  2019-04-17  9:47                   ` [PATCH v2 00/21] Convert hwmon documentation to ReST Mauro Carvalho Chehab
  1 sibling, 21 replies; 73+ messages in thread
From: Mauro Carvalho Chehab @ 2019-04-17  9:46 UTC (permalink / raw)
  To: Linux Doc Mailing List
  Cc: Mauro Carvalho Chehab, Mauro Carvalho Chehab, linux-kernel,
	Jonathan Corbet

This series converts the contents of Documentation/hwmon to ReST
format.

PS.: I opted to group the conversion files per groups of maintainer
set, as, if I were to generate one patch per file, it would give around
160 patches.

I also added those patches to my development tree at:
	https://git.linuxtv.org/mchehab/experimental.git/log/?h=hwmon

If you want to see the results, they're at:
	https://www.infradead.org/~mchehab/hwmon/

-
Version 3:
- Rebased on the top of next-20190417
- Fixed one build warning at sysfs-interface.rst by converting 
  a list into a table;
- some minor adjustments at da9052 and ibmpowernv in order
  to add extra blank lines to split some fields at htm output.

Version 2:

- Fixed broken SOB lines;
- changed submitting-patches.rst to mention that drivers should be
  documented as Documentation/hwmon/<driver_name>.rst,
  as suggested by Jonathan Neusch_fer.



Mauro Carvalho Chehab (21):
  docs: hwmon: k10temp: convert to ReST format
  docs: hwmon: vexpress: convert to ReST format
  docs: hwmon: menf21bmc: convert to ReST format
  docs: hwmon: sch5627: convert to ReST format
  docs: hwmon: emc2103: convert to ReST format
  docs: hwmon: pc87360: convert to ReST format
  docs: hwmon: fam15h_power: convert to ReST format
  docs: hwmon: w83791d: convert to ReST format
  docs: hwmon: coretemp: convert to ReST format
  docs: hwmon: aspeed-pwm-tacho: convert to ReST format
  docs: hwmon: ibmpowernv: convert to ReST format
  docs: hwmon: asc7621: convert to ReST format
  docs: hwmon: ads1015: convert to ReST format
  docs: hwmon: dme1737, vt1211: convert to ReST format
  docs: hwmon: wm831x, wm8350: convert to ReST format
  docs: hwmon: da9052, da9055: convert to ReST format
  docs: hwmon: k8temp, w83793: convert to ReST format
  docs: hwmon: pmbus files: convert to ReST format
  docs: hwmon: misc files: convert to ReST format
  docs: hwmon: convert remaining files to ReST format
  docs: hwmon: Add an index file and rename docs to *.rst

 .../devicetree/bindings/hwmon/g762.txt        |   2 +-
 Documentation/hwmon/{ab8500 => ab8500.rst}    |  10 +-
 Documentation/hwmon/abituguru                 |  92 ---
 ...guru-datasheet => abituguru-datasheet.rst} | 160 ++--
 Documentation/hwmon/abituguru.rst             | 113 +++
 .../hwmon/{abituguru3 => abituguru3.rst}      |  36 +-
 Documentation/hwmon/{abx500 => abx500.rst}    |   8 +-
 ...{acpi_power_meter => acpi_power_meter.rst} |  25 +-
 Documentation/hwmon/{ad7314 => ad7314.rst}    |   9 +
 .../hwmon/{adc128d818 => adc128d818.rst}      |   7 +-
 Documentation/hwmon/{adm1021 => adm1021.rst}  |  44 +-
 Documentation/hwmon/{adm1025 => adm1025.rst}  |  13 +-
 Documentation/hwmon/{adm1026 => adm1026.rst}  |  24 +-
 Documentation/hwmon/{adm1031 => adm1031.rst}  |  16 +-
 Documentation/hwmon/{adm1275 => adm1275.rst}  |  30 +-
 Documentation/hwmon/{adm9240 => adm9240.rst}  |  50 +-
 Documentation/hwmon/{ads1015 => ads1015.rst}  |  72 +-
 Documentation/hwmon/{ads7828 => ads7828.rst}  |  29 +-
 Documentation/hwmon/{adt7410 => adt7410.rst}  |  49 +-
 Documentation/hwmon/{adt7411 => adt7411.rst}  |  20 +-
 Documentation/hwmon/{adt7462 => adt7462.rst}  |  11 +-
 Documentation/hwmon/{adt7470 => adt7470.rst}  |   8 +-
 Documentation/hwmon/{adt7475 => adt7475.rst}  |  38 +-
 Documentation/hwmon/{amc6821 => amc6821.rst}  |  18 +-
 Documentation/hwmon/{asb100 => asb100.rst}    |  51 +-
 Documentation/hwmon/{asc7621 => asc7621.rst}  | 146 ++--
 ...{aspeed-pwm-tacho => aspeed-pwm-tacho.rst} |   2 +
 .../hwmon/{coretemp => coretemp.rst}          |  46 +-
 Documentation/hwmon/{da9052 => da9052.rst}    |  41 +-
 Documentation/hwmon/{da9055 => da9055.rst}    |  20 +-
 Documentation/hwmon/{dme1737 => dme1737.rst}  |  88 ++-
 Documentation/hwmon/{ds1621 => ds1621.rst}    | 154 ++--
 Documentation/hwmon/{ds620 => ds620.rst}      |  12 +-
 Documentation/hwmon/{emc1403 => emc1403.rst}  |  33 +-
 Documentation/hwmon/{emc2103 => emc2103.rst}  |   6 +-
 .../hwmon/{emc6w201 => emc6w201.rst}          |   5 +
 Documentation/hwmon/{f71805f => f71805f.rst}  |  36 +-
 .../hwmon/{f71882fg => f71882fg.rst}          |  56 +-
 .../hwmon/{fam15h_power => fam15h_power.rst}  |  85 +-
 .../hwmon/{ftsteutates => ftsteutates.rst}    |  14 +-
 Documentation/hwmon/{g760a => g760a.rst}      |   4 +
 Documentation/hwmon/{g762 => g762.rst}        |  67 +-
 Documentation/hwmon/{gl518sm => gl518sm.rst}  |  21 +-
 Documentation/hwmon/{hih6130 => hih6130.rst}  |  14 +-
 ...on-kernel-api.txt => hwmon-kernel-api.rst} | 338 ++++----
 .../hwmon/{ibm-cffps => ibm-cffps.rst}        |   3 +
 Documentation/hwmon/{ibmaem => ibmaem.rst}    |  10 +-
 .../hwmon/{ibmpowernv => ibmpowernv.rst}      |  31 +-
 Documentation/hwmon/{ina209 => ina209.rst}    |  18 +-
 Documentation/hwmon/{ina2xx => ina2xx.rst}    |  41 +-
 Documentation/hwmon/{ina3221 => ina3221.rst}  |  21 +-
 Documentation/hwmon/index.rst                 | 179 +++++
 Documentation/hwmon/{ir35221 => ir35221.rst}  |  11 +-
 Documentation/hwmon/{it87 => it87.rst}        | 102 ++-
 Documentation/hwmon/{jc42 => jc42.rst}        |  55 +-
 Documentation/hwmon/{k10temp => k10temp.rst}  |  37 +-
 Documentation/hwmon/{k8temp => k8temp.rst}    |  17 +-
 .../hwmon/{lineage-pem => lineage-pem.rst}    |  16 +-
 Documentation/hwmon/{lm25066 => lm25066.rst}  |  32 +-
 Documentation/hwmon/{lm63 => lm63.rst}        |  24 +-
 Documentation/hwmon/{lm70 => lm70.rst}        |  13 +-
 Documentation/hwmon/{lm73 => lm73.rst}        |  16 +-
 Documentation/hwmon/{lm75 => lm75.rst}        |  96 ++-
 Documentation/hwmon/{lm77 => lm77.rst}        |   9 +-
 Documentation/hwmon/{lm78 => lm78.rst}        |  20 +-
 Documentation/hwmon/{lm80 => lm80.rst}        |  19 +-
 Documentation/hwmon/{lm83 => lm83.rst}        |  16 +-
 Documentation/hwmon/{lm85 => lm85.rst}        |  97 ++-
 Documentation/hwmon/{lm87 => lm87.rst}        |  23 +-
 Documentation/hwmon/{lm90 => lm90.rst}        | 174 ++++-
 Documentation/hwmon/{lm92 => lm92.rst}        |  17 +-
 Documentation/hwmon/{lm93 => lm93.rst}        | 157 ++--
 Documentation/hwmon/{lm95234 => lm95234.rst}  |  11 +-
 Documentation/hwmon/{lm95245 => lm95245.rst}  |  13 +-
 Documentation/hwmon/{ltc2945 => ltc2945.rst}  |  16 +-
 Documentation/hwmon/{ltc2978 => ltc2978.rst}  | 267 +++++--
 Documentation/hwmon/{ltc2990 => ltc2990.rst}  |  23 +-
 Documentation/hwmon/{ltc3815 => ltc3815.rst}  |  12 +-
 Documentation/hwmon/{ltc4151 => ltc4151.rst}  |  16 +-
 Documentation/hwmon/{ltc4215 => ltc4215.rst}  |  16 +-
 Documentation/hwmon/{ltc4245 => ltc4245.rst}  |  17 +-
 Documentation/hwmon/{ltc4260 => ltc4260.rst}  |  16 +-
 Documentation/hwmon/{ltc4261 => ltc4261.rst}  |  16 +-
 .../hwmon/{max16064 => max16064.rst}          |  17 +-
 .../hwmon/{max16065 => max16065.rst}          |  24 +-
 Documentation/hwmon/{max1619 => max1619.rst}  |  12 +-
 Documentation/hwmon/{max1668 => max1668.rst}  |  14 +-
 Documentation/hwmon/{max197 => max197.rst}    |  36 +-
 .../hwmon/{max20751 => max20751.rst}          |   9 +-
 .../hwmon/{max31722 => max31722.rst}          |  12 +
 .../hwmon/{max31785 => max31785.rst}          |   6 +
 .../hwmon/{max31790 => max31790.rst}          |   6 +
 .../hwmon/{max34440 => max34440.rst}          |  90 ++-
 Documentation/hwmon/{max6639 => max6639.rst}  |  16 +-
 Documentation/hwmon/{max6642 => max6642.rst}  |  10 +-
 Documentation/hwmon/{max6650 => max6650.rst}  |  17 +-
 Documentation/hwmon/{max6697 => max6697.rst}  |  33 +
 Documentation/hwmon/{max8688 => max8688.rst}  |  20 +-
 .../hwmon/{mc13783-adc => mc13783-adc.rst}    |  27 +-
 Documentation/hwmon/{mcp3021 => mcp3021.rst}  |  15 +-
 .../hwmon/{menf21bmc => menf21bmc.rst}        |   5 +
 .../hwmon/{mlxreg-fan => mlxreg-fan.rst}      |  60 +-
 Documentation/hwmon/{nct6683 => nct6683.rst}  |  11 +-
 Documentation/hwmon/{nct6775 => nct6775.rst}  | 114 ++-
 Documentation/hwmon/{nct7802 => nct7802.rst}  |  11 +-
 Documentation/hwmon/{nct7904 => nct7904.rst}  |   9 +-
 .../{npcm750-pwm-fan => npcm750-pwm-fan.rst}  |   4 +
 Documentation/hwmon/{nsa320 => nsa320.rst}    |  15 +-
 .../{ntc_thermistor => ntc_thermistor.rst}    | 123 +--
 Documentation/hwmon/{occ => occ.rst}          |  93 ++-
 Documentation/hwmon/{pc87360 => pc87360.rst}  |  38 +-
 Documentation/hwmon/{pc87427 => pc87427.rst}  |   4 +
 Documentation/hwmon/{pcf8591 => pcf8591.rst}  |  52 +-
 .../hwmon/{pmbus-core => pmbus-core.rst}      | 173 +++--
 Documentation/hwmon/{pmbus => pmbus.rst}      |  90 ++-
 .../hwmon/{powr1220 => powr1220.rst}          |  12 +-
 Documentation/hwmon/{pwm-fan => pwm-fan.rst}  |   0
 ...aspberrypi-hwmon => raspberrypi-hwmon.rst} |   3 +
 Documentation/hwmon/{sch5627 => sch5627.rst}  |   4 +
 Documentation/hwmon/{sch5636 => sch5636.rst}  |   3 +
 .../hwmon/{scpi-hwmon => scpi-hwmon.rst}      |   7 +-
 Documentation/hwmon/{sht15 => sht15.rst}      |  28 +-
 Documentation/hwmon/{sht21 => sht21.rst}      |  24 +-
 Documentation/hwmon/{sht3x => sht3x.rst}      |  42 +-
 Documentation/hwmon/{shtc1 => shtc1.rst}      |  19 +-
 Documentation/hwmon/{sis5595 => sis5595.rst}  |  41 +-
 Documentation/hwmon/{smm665 => smm665.rst}    |  42 +-
 .../hwmon/{smsc47b397 => smsc47b397.rst}      | 158 ++--
 .../hwmon/{smsc47m1 => smsc47m1.rst}          |  43 +-
 Documentation/hwmon/smsc47m192                | 103 ---
 Documentation/hwmon/smsc47m192.rst            | 116 +++
 ...mitting-patches => submitting-patches.rst} |  21 +-
 .../{sysfs-interface => sysfs-interface.rst}  | 727 ++++++++++++------
 Documentation/hwmon/{tc654 => tc654.rst}      |   9 +-
 Documentation/hwmon/{tc74 => tc74.rst}        |   3 +
 Documentation/hwmon/{thmc50 => thmc50.rst}    |  37 +-
 Documentation/hwmon/{tmp102 => tmp102.rst}    |   7 +-
 Documentation/hwmon/{tmp103 => tmp103.rst}    |   7 +-
 Documentation/hwmon/{tmp108 => tmp108.rst}    |   7 +-
 Documentation/hwmon/{tmp401 => tmp401.rst}    |  32 +-
 Documentation/hwmon/{tmp421 => tmp421.rst}    |  26 +-
 .../hwmon/{tps40422 => tps40422.rst}          |  25 +-
 ...4030-madc-hwmon => twl4030-madc-hwmon.rst} |   8 +-
 Documentation/hwmon/{ucd9000 => ucd9000.rst}  |  35 +-
 Documentation/hwmon/{ucd9200 => ucd9200.rst}  |  46 +-
 .../{userspace-tools => userspace-tools.rst}  |   3 +
 .../hwmon/{vexpress => vexpress.rst}          |  13 +-
 Documentation/hwmon/{via686a => via686a.rst}  |  30 +-
 Documentation/hwmon/{vt1211 => vt1211.rst}    |  84 +-
 .../hwmon/{w83627ehf => w83627ehf.rst}        | 160 ++--
 .../hwmon/{w83627hf => w83627hf.rst}          |  65 +-
 Documentation/hwmon/{w83773g => w83773g.rst}  |  12 +-
 Documentation/hwmon/{w83781d => w83781d.rst}  | 330 ++++----
 Documentation/hwmon/{w83791d => w83791d.rst}  | 123 +--
 Documentation/hwmon/{w83792d => w83792d.rst}  | 112 +--
 Documentation/hwmon/w83793                    | 106 ---
 Documentation/hwmon/w83793.rst                | 113 +++
 Documentation/hwmon/w83795                    | 127 ---
 Documentation/hwmon/w83795.rst                | 142 ++++
 .../hwmon/{w83l785ts => w83l785ts.rst}        |   9 +-
 .../hwmon/{w83l786ng => w83l786ng.rst}        |  42 +-
 Documentation/hwmon/{wm831x => wm831x.rst}    |   9 +-
 Documentation/hwmon/{wm8350 => wm8350.rst}    |  10 +-
 .../hwmon/{xgene-hwmon => xgene-hwmon.rst}    |  24 +-
 Documentation/hwmon/{zl6100 => zl6100.rst}    |  71 +-
 Documentation/index.rst                       |   1 +
 Documentation/thermal/sysfs-api.txt           |   2 +-
 MAINTAINERS                                   | 108 +--
 drivers/hwmon/Kconfig                         |   8 +-
 drivers/hwmon/ads7828.c                       |   2 +-
 drivers/hwmon/max197.c                        |   2 +-
 drivers/hwmon/sht15.c                         |   2 +-
 include/linux/platform_data/ads7828.h         |   2 +-
 include/linux/platform_data/ds620.h           |   2 +-
 include/linux/platform_data/ina2xx.h          |   2 +-
 include/linux/platform_data/max197.h          |   2 +-
 include/linux/platform_data/ntc_thermistor.h  |   2 +-
 177 files changed, 5659 insertions(+), 2662 deletions(-)
 rename Documentation/hwmon/{ab8500 => ab8500.rst} (69%)
 delete mode 100644 Documentation/hwmon/abituguru
 rename Documentation/hwmon/{abituguru-datasheet => abituguru-datasheet.rst} (69%)
 create mode 100644 Documentation/hwmon/abituguru.rst
 rename Documentation/hwmon/{abituguru3 => abituguru3.rst} (75%)
 rename Documentation/hwmon/{abx500 => abx500.rst} (89%)
 rename Documentation/hwmon/{acpi_power_meter => acpi_power_meter.rst} (65%)
 rename Documentation/hwmon/{ad7314 => ad7314.rst} (98%)
 rename Documentation/hwmon/{adc128d818 => adc128d818.rst} (95%)
 rename Documentation/hwmon/{adm1021 => adm1021.rst} (97%)
 rename Documentation/hwmon/{adm1025 => adm1025.rst} (96%)
 rename Documentation/hwmon/{adm1026 => adm1026.rst} (89%)
 rename Documentation/hwmon/{adm1031 => adm1031.rst} (80%)
 rename Documentation/hwmon/{adm1275 => adm1275.rst} (93%)
 rename Documentation/hwmon/{adm9240 => adm9240.rst} (85%)
 rename Documentation/hwmon/{ads1015 => ads1015.rst} (64%)
 rename Documentation/hwmon/{ads7828 => ads7828.rst} (68%)
 rename Documentation/hwmon/{adt7410 => adt7410.rst} (70%)
 rename Documentation/hwmon/{adt7411 => adt7411.rst} (67%)
 rename Documentation/hwmon/{adt7462 => adt7462.rst} (94%)
 rename Documentation/hwmon/{adt7470 => adt7470.rst} (95%)
 rename Documentation/hwmon/{adt7475 => adt7475.rst} (89%)
 rename Documentation/hwmon/{amc6821 => amc6821.rst} (90%)
 rename Documentation/hwmon/{asb100 => asb100.rst} (69%)
 rename Documentation/hwmon/{asc7621 => asc7621.rst} (80%)
 rename Documentation/hwmon/{aspeed-pwm-tacho => aspeed-pwm-tacho.rst} (79%)
 rename Documentation/hwmon/{coretemp => coretemp.rst} (78%)
 rename Documentation/hwmon/{da9052 => da9052.rst} (66%)
 rename Documentation/hwmon/{da9055 => da9055.rst} (80%)
 rename Documentation/hwmon/{dme1737 => dme1737.rst} (89%)
 rename Documentation/hwmon/{ds1621 => ds1621.rst} (68%)
 rename Documentation/hwmon/{ds620 => ds620.rst} (88%)
 rename Documentation/hwmon/{emc1403 => emc1403.rst} (83%)
 rename Documentation/hwmon/{emc2103 => emc2103.rst} (95%)
 rename Documentation/hwmon/{emc6w201 => emc6w201.rst} (99%)
 rename Documentation/hwmon/{f71805f => f71805f.rst} (88%)
 rename Documentation/hwmon/{f71882fg => f71882fg.rst} (97%)
 rename Documentation/hwmon/{fam15h_power => fam15h_power.rst} (63%)
 rename Documentation/hwmon/{ftsteutates => ftsteutates.rst} (65%)
 rename Documentation/hwmon/{g760a => g760a.rst} (99%)
 rename Documentation/hwmon/{g762 => g762.rst} (59%)
 rename Documentation/hwmon/{gl518sm => gl518sm.rst} (89%)
 rename Documentation/hwmon/{hih6130 => hih6130.rst} (85%)
 rename Documentation/hwmon/{hwmon-kernel-api.txt => hwmon-kernel-api.rst} (58%)
 rename Documentation/hwmon/{ibm-cffps => ibm-cffps.rst} (90%)
 rename Documentation/hwmon/{ibmaem => ibmaem.rst} (92%)
 rename Documentation/hwmon/{ibmpowernv => ibmpowernv.rst} (86%)
 rename Documentation/hwmon/{ina209 => ina209.rst} (90%)
 rename Documentation/hwmon/{ina2xx => ina2xx.rst} (81%)
 rename Documentation/hwmon/{ina3221 => ina3221.rst} (76%)
 create mode 100644 Documentation/hwmon/index.rst
 rename Documentation/hwmon/{ir35221 => ir35221.rst} (89%)
 rename Documentation/hwmon/{it87 => it87.rst} (92%)
 rename Documentation/hwmon/{jc42 => jc42.rst} (92%)
 rename Documentation/hwmon/{k10temp => k10temp.rst} (98%)
 rename Documentation/hwmon/{k8temp => k8temp.rst} (83%)
 rename Documentation/hwmon/{lineage-pem => lineage-pem.rst} (88%)
 rename Documentation/hwmon/{lm25066 => lm25066.rst} (91%)
 rename Documentation/hwmon/{lm63 => lm63.rst} (95%)
 rename Documentation/hwmon/{lm70 => lm70.rst} (96%)
 rename Documentation/hwmon/{lm73 => lm73.rst} (92%)
 rename Documentation/hwmon/{lm75 => lm75.rst} (80%)
 rename Documentation/hwmon/{lm77 => lm77.rst} (97%)
 rename Documentation/hwmon/{lm78 => lm78.rst} (95%)
 rename Documentation/hwmon/{lm80 => lm80.rst} (94%)
 rename Documentation/hwmon/{lm83 => lm83.rst} (95%)
 rename Documentation/hwmon/{lm85 => lm85.rst} (86%)
 rename Documentation/hwmon/{lm87 => lm87.rst} (89%)
 rename Documentation/hwmon/{lm90 => lm90.rst} (85%)
 rename Documentation/hwmon/{lm92 => lm92.rst} (90%)
 rename Documentation/hwmon/{lm93 => lm93.rst} (80%)
 rename Documentation/hwmon/{lm95234 => lm95234.rst} (94%)
 rename Documentation/hwmon/{lm95245 => lm95245.rst} (91%)
 rename Documentation/hwmon/{ltc2945 => ltc2945.rst} (89%)
 rename Documentation/hwmon/{ltc2978 => ltc2978.rst} (58%)
 rename Documentation/hwmon/{ltc2990 => ltc2990.rst} (76%)
 rename Documentation/hwmon/{ltc3815 => ltc3815.rst} (83%)
 rename Documentation/hwmon/{ltc4151 => ltc4151.rst} (80%)
 rename Documentation/hwmon/{ltc4215 => ltc4215.rst} (78%)
 rename Documentation/hwmon/{ltc4245 => ltc4245.rst} (89%)
 rename Documentation/hwmon/{ltc4260 => ltc4260.rst} (85%)
 rename Documentation/hwmon/{ltc4261 => ltc4261.rst} (88%)
 rename Documentation/hwmon/{max16064 => max16064.rst} (88%)
 rename Documentation/hwmon/{max16065 => max16065.rst} (95%)
 rename Documentation/hwmon/{max1619 => max1619.rst} (82%)
 rename Documentation/hwmon/{max1668 => max1668.rst} (85%)
 rename Documentation/hwmon/{max197 => max197.rst} (59%)
 rename Documentation/hwmon/{max20751 => max20751.rst} (89%)
 rename Documentation/hwmon/{max31722 => max31722.rst} (83%)
 rename Documentation/hwmon/{max31785 => max31785.rst} (92%)
 rename Documentation/hwmon/{max31790 => max31790.rst} (88%)
 rename Documentation/hwmon/{max34440 => max34440.rst} (77%)
 rename Documentation/hwmon/{max6639 => max6639.rst} (83%)
 rename Documentation/hwmon/{max6642 => max6642.rst} (82%)
 rename Documentation/hwmon/{max6650 => max6650.rst} (86%)
 rename Documentation/hwmon/{max6697 => max6697.rst} (91%)
 rename Documentation/hwmon/{max8688 => max8688.rst} (85%)
 rename Documentation/hwmon/{mc13783-adc => mc13783-adc.rst} (82%)
 rename Documentation/hwmon/{mcp3021 => mcp3021.rst} (90%)
 rename Documentation/hwmon/{menf21bmc => menf21bmc.rst} (93%)
 rename Documentation/hwmon/{mlxreg-fan => mlxreg-fan.rst} (53%)
 rename Documentation/hwmon/{nct6683 => nct6683.rst} (89%)
 rename Documentation/hwmon/{nct6775 => nct6775.rst} (86%)
 rename Documentation/hwmon/{nct7802 => nct7802.rst} (73%)
 rename Documentation/hwmon/{nct7904 => nct7904.rst} (88%)
 rename Documentation/hwmon/{npcm750-pwm-fan => npcm750-pwm-fan.rst} (79%)
 rename Documentation/hwmon/{nsa320 => nsa320.rst} (93%)
 rename Documentation/hwmon/{ntc_thermistor => ntc_thermistor.rst} (52%)
 rename Documentation/hwmon/{occ => occ.rst} (67%)
 rename Documentation/hwmon/{pc87360 => pc87360.rst} (88%)
 rename Documentation/hwmon/{pc87427 => pc87427.rst} (99%)
 rename Documentation/hwmon/{pcf8591 => pcf8591.rst} (62%)
 rename Documentation/hwmon/{pmbus-core => pmbus-core.rst} (68%)
 rename Documentation/hwmon/{pmbus => pmbus.rst} (88%)
 rename Documentation/hwmon/{powr1220 => powr1220.rst} (90%)
 rename Documentation/hwmon/{pwm-fan => pwm-fan.rst} (100%)
 rename Documentation/hwmon/{raspberrypi-hwmon => raspberrypi-hwmon.rst} (85%)
 rename Documentation/hwmon/{sch5627 => sch5627.rst} (99%)
 rename Documentation/hwmon/{sch5636 => sch5636.rst} (99%)
 rename Documentation/hwmon/{scpi-hwmon => scpi-hwmon.rst} (96%)
 rename Documentation/hwmon/{sht15 => sht15.rst} (74%)
 rename Documentation/hwmon/{sht21 => sht21.rst} (92%)
 rename Documentation/hwmon/{sht3x => sht3x.rst} (75%)
 rename Documentation/hwmon/{shtc1 => shtc1.rst} (94%)
 rename Documentation/hwmon/{sis5595 => sis5595.rst} (80%)
 rename Documentation/hwmon/{smm665 => smm665.rst} (92%)
 rename Documentation/hwmon/{smsc47b397 => smsc47b397.rst} (62%)
 rename Documentation/hwmon/{smsc47m1 => smsc47m1.rst} (77%)
 delete mode 100644 Documentation/hwmon/smsc47m192
 create mode 100644 Documentation/hwmon/smsc47m192.rst
 rename Documentation/hwmon/{submitting-patches => submitting-patches.rst} (93%)
 rename Documentation/hwmon/{sysfs-interface => sysfs-interface.rst} (68%)
 rename Documentation/hwmon/{tc654 => tc654.rst} (81%)
 rename Documentation/hwmon/{tc74 => tc74.rst} (99%)
 rename Documentation/hwmon/{thmc50 => thmc50.rst} (84%)
 rename Documentation/hwmon/{tmp102 => tmp102.rst} (92%)
 rename Documentation/hwmon/{tmp103 => tmp103.rst} (91%)
 rename Documentation/hwmon/{tmp108 => tmp108.rst} (95%)
 rename Documentation/hwmon/{tmp401 => tmp401.rst} (92%)
 rename Documentation/hwmon/{tmp421 => tmp421.rst} (96%)
 rename Documentation/hwmon/{tps40422 => tps40422.rst} (75%)
 rename Documentation/hwmon/{twl4030-madc-hwmon => twl4030-madc-hwmon.rst} (82%)
 rename Documentation/hwmon/{ucd9000 => ucd9000.rst} (87%)
 rename Documentation/hwmon/{ucd9200 => ucd9200.rst} (80%)
 rename Documentation/hwmon/{userspace-tools => userspace-tools.rst} (97%)
 rename Documentation/hwmon/{vexpress => vexpress.rst} (85%)
 rename Documentation/hwmon/{via686a => via686a.rst} (79%)
 rename Documentation/hwmon/{vt1211 => vt1211.rst} (73%)
 rename Documentation/hwmon/{w83627ehf => w83627ehf.rst} (64%)
 rename Documentation/hwmon/{w83627hf => w83627hf.rst} (73%)
 rename Documentation/hwmon/{w83773g => w83773g.rst} (91%)
 rename Documentation/hwmon/{w83781d => w83781d.rst} (66%)
 rename Documentation/hwmon/{w83791d => w83791d.rst} (59%)
 rename Documentation/hwmon/{w83792d => w83792d.rst} (78%)
 delete mode 100644 Documentation/hwmon/w83793
 create mode 100644 Documentation/hwmon/w83793.rst
 delete mode 100644 Documentation/hwmon/w83795
 create mode 100644 Documentation/hwmon/w83795.rst
 rename Documentation/hwmon/{w83l785ts => w83l785ts.rst} (91%)
 rename Documentation/hwmon/{w83l786ng => w83l786ng.rst} (64%)
 rename Documentation/hwmon/{wm831x => wm831x.rst} (86%)
 rename Documentation/hwmon/{wm8350 => wm8350.rst} (81%)
 rename Documentation/hwmon/{xgene-hwmon => xgene-hwmon.rst} (51%)
 rename Documentation/hwmon/{zl6100 => zl6100.rst} (83%)

-- 
2.20.1



^ permalink raw reply	[flat|nested] 73+ messages in thread

* [PATCH v3 01/21] docs: hwmon: k10temp: convert to ReST format
  2019-04-17  9:46                   ` [PATCH v3 00/21]Convert " Mauro Carvalho Chehab
@ 2019-04-17  9:46                     ` Mauro Carvalho Chehab
  2019-04-17  9:46                     ` [PATCH v3 02/21] docs: hwmon: vexpress: " Mauro Carvalho Chehab
                                       ` (19 subsequent siblings)
  20 siblings, 0 replies; 73+ messages in thread
From: Mauro Carvalho Chehab @ 2019-04-17  9:46 UTC (permalink / raw)
  To: Linux Doc Mailing List
  Cc: Mauro Carvalho Chehab, Mauro Carvalho Chehab, linux-kernel,
	Jonathan Corbet, Jean Delvare, Guenter Roeck, linux-hwmon

Convert k10temp to ReST format, in order to allow it to
be parsed by Sphinx.

Signed-off-by: Mauro Carvalho Chehab <mchehab+samsung@kernel.org>
---
 Documentation/hwmon/k10temp | 37 ++++++++++++++++++++++++++++++++++++-
 1 file changed, 36 insertions(+), 1 deletion(-)

diff --git a/Documentation/hwmon/k10temp b/Documentation/hwmon/k10temp
index 254d2f55345a..12a86ba17de9 100644
--- a/Documentation/hwmon/k10temp
+++ b/Documentation/hwmon/k10temp
@@ -2,42 +2,77 @@ Kernel driver k10temp
 =====================
 
 Supported chips:
+
 * AMD Family 10h processors:
+
   Socket F: Quad-Core/Six-Core/Embedded Opteron (but see below)
+
   Socket AM2+: Quad-Core Opteron, Phenom (II) X3/X4, Athlon X2 (but see below)
+
   Socket AM3: Quad-Core Opteron, Athlon/Phenom II X2/X3/X4, Sempron II
+
   Socket S1G3: Athlon II, Sempron, Turion II
+
 * AMD Family 11h processors:
+
   Socket S1G2: Athlon (X2), Sempron (X2), Turion X2 (Ultra)
+
 * AMD Family 12h processors: "Llano" (E2/A4/A6/A8-Series)
+
 * AMD Family 14h processors: "Brazos" (C/E/G/Z-Series)
+
 * AMD Family 15h processors: "Bulldozer" (FX-Series), "Trinity", "Kaveri", "Carrizo"
+
 * AMD Family 16h processors: "Kabini", "Mullins"
 
   Prefix: 'k10temp'
+
   Addresses scanned: PCI space
+
   Datasheets:
+
   BIOS and Kernel Developer's Guide (BKDG) For AMD Family 10h Processors:
+
     http://support.amd.com/us/Processor_TechDocs/31116.pdf
+
   BIOS and Kernel Developer's Guide (BKDG) for AMD Family 11h Processors:
+
     http://support.amd.com/us/Processor_TechDocs/41256.pdf
+
   BIOS and Kernel Developer's Guide (BKDG) for AMD Family 12h Processors:
+
     http://support.amd.com/us/Processor_TechDocs/41131.pdf
+
   BIOS and Kernel Developer's Guide (BKDG) for AMD Family 14h Models 00h-0Fh Processors:
+
     http://support.amd.com/us/Processor_TechDocs/43170.pdf
+
   Revision Guide for AMD Family 10h Processors:
+
     http://support.amd.com/us/Processor_TechDocs/41322.pdf
+
   Revision Guide for AMD Family 11h Processors:
+
     http://support.amd.com/us/Processor_TechDocs/41788.pdf
+
   Revision Guide for AMD Family 12h Processors:
+
     http://support.amd.com/us/Processor_TechDocs/44739.pdf
+
   Revision Guide for AMD Family 14h Models 00h-0Fh Processors:
+
     http://support.amd.com/us/Processor_TechDocs/47534.pdf
+
   AMD Family 11h Processor Power and Thermal Data Sheet for Notebooks:
+
     http://support.amd.com/us/Processor_TechDocs/43373.pdf
+
   AMD Family 10h Server and Workstation Processor Power and Thermal Data Sheet:
+
     http://support.amd.com/us/Processor_TechDocs/43374.pdf
+
   AMD Family 10h Desktop Processor Power and Thermal Data Sheet:
+
     http://support.amd.com/us/Processor_TechDocs/43375.pdf
 
 Author: Clemens Ladisch <clemens@ladisch.de>
@@ -60,7 +95,7 @@ are using an AM3 processor on an AM2+ mainboard, you can safely use the
 
 There is one temperature measurement value, available as temp1_input in
 sysfs. It is measured in degrees Celsius with a resolution of 1/8th degree.
-Please note that it is defined as a relative value; to quote the AMD manual:
+Please note that it is defined as a relative value; to quote the AMD manual::
 
   Tctl is the processor temperature control value, used by the platform to
   control cooling systems. Tctl is a non-physical temperature on an
-- 
2.20.1


^ permalink raw reply related	[flat|nested] 73+ messages in thread

* [PATCH v3 02/21] docs: hwmon: vexpress: convert to ReST format
  2019-04-17  9:46                   ` [PATCH v3 00/21]Convert " Mauro Carvalho Chehab
  2019-04-17  9:46                     ` [PATCH v3 01/21] docs: hwmon: k10temp: convert to ReST format Mauro Carvalho Chehab
@ 2019-04-17  9:46                     ` Mauro Carvalho Chehab
  2019-04-17 10:24                       ` Liviu Dudau
  2019-04-17 11:29                       ` Liviu Dudau
  2019-04-17  9:46                     ` [PATCH v3 03/21] docs: hwmon: menf21bmc: " Mauro Carvalho Chehab
                                       ` (18 subsequent siblings)
  20 siblings, 2 replies; 73+ messages in thread
From: Mauro Carvalho Chehab @ 2019-04-17  9:46 UTC (permalink / raw)
  To: Linux Doc Mailing List
  Cc: Mauro Carvalho Chehab, Mauro Carvalho Chehab, linux-kernel,
	Jonathan Corbet, Jean Delvare, Guenter Roeck, Liviu Dudau,
	Sudeep Holla, Lorenzo Pieralisi, linux-hwmon, linux-arm-kernel

Convert vexpress to ReST format, in order to allow it to
be parsed by Sphinx.

Signed-off-by: Mauro Carvalho Chehab <mchehab+samsung@kernel.org>
---
 Documentation/hwmon/vexpress | 13 ++++++++++---
 1 file changed, 10 insertions(+), 3 deletions(-)

diff --git a/Documentation/hwmon/vexpress b/Documentation/hwmon/vexpress
index 557d6d5ad90d..8c861c8151ac 100644
--- a/Documentation/hwmon/vexpress
+++ b/Documentation/hwmon/vexpress
@@ -2,14 +2,21 @@ Kernel driver vexpress
 ======================
 
 Supported systems:
+
   * ARM Ltd. Versatile Express platform
+
     Prefix: 'vexpress'
+
     Datasheets:
+
       * "Hardware Description" sections of the Technical Reference Manuals
-        for the Versatile Express boards:
-        http://infocenter.arm.com/help/topic/com.arm.doc.subset.boards.express/index.html
+	for the Versatile Express boards:
+
+	- http://infocenter.arm.com/help/topic/com.arm.doc.subset.boards.express/index.html
+
       * Section "4.4.14. System Configuration registers" of the V2M-P1 TRM:
-        http://infocenter.arm.com/help/index.jsp?topic=/com.arm.doc.dui0447-/index.html
+
+	- http://infocenter.arm.com/help/index.jsp?topic=/com.arm.doc.dui0447-/index.html
 
 Author: Pawel Moll
 
-- 
2.20.1


^ permalink raw reply related	[flat|nested] 73+ messages in thread

* [PATCH v3 03/21] docs: hwmon: menf21bmc: convert to ReST format
  2019-04-17  9:46                   ` [PATCH v3 00/21]Convert " Mauro Carvalho Chehab
  2019-04-17  9:46                     ` [PATCH v3 01/21] docs: hwmon: k10temp: convert to ReST format Mauro Carvalho Chehab
  2019-04-17  9:46                     ` [PATCH v3 02/21] docs: hwmon: vexpress: " Mauro Carvalho Chehab
@ 2019-04-17  9:46                     ` Mauro Carvalho Chehab
  2019-04-17  9:46                     ` [PATCH v3 04/21] docs: hwmon: sch5627: " Mauro Carvalho Chehab
                                       ` (17 subsequent siblings)
  20 siblings, 0 replies; 73+ messages in thread
From: Mauro Carvalho Chehab @ 2019-04-17  9:46 UTC (permalink / raw)
  To: Linux Doc Mailing List
  Cc: Mauro Carvalho Chehab, Mauro Carvalho Chehab, linux-kernel,
	Jonathan Corbet, Jean Delvare, Guenter Roeck, linux-hwmon

Convert menf21bmc to ReST format, in order to allow it to
be parsed by Sphinx.

Signed-off-by: Mauro Carvalho Chehab <mchehab+samsung@kernel.org>
---
 Documentation/hwmon/menf21bmc | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/Documentation/hwmon/menf21bmc b/Documentation/hwmon/menf21bmc
index 2a273a065c5e..1f0c6b2235ab 100644
--- a/Documentation/hwmon/menf21bmc
+++ b/Documentation/hwmon/menf21bmc
@@ -2,8 +2,11 @@ Kernel driver menf21bmc_hwmon
 =============================
 
 Supported chips:
+
 	* MEN 14F021P00
+
 	  Prefix: 'menf21bmc_hwmon'
+
 	  Adresses scanned: -
 
 Author: Andreas Werner <andreas.werner@men.de>
@@ -34,6 +37,7 @@ Sysfs entries
 The following attributes are supported. All attributes are read only
 The Limits are read once by the driver.
 
+=============== ==========================
 in0_input	+3.3V input voltage
 in1_input	+5.0V input voltage
 in2_input	+12.0V input voltage
@@ -48,3 +52,4 @@ in1_label	"MON_5V"
 in2_label	"MON_12V"
 in3_label	"5V_STANDBY"
 in4_label	"VBAT"
+=============== ==========================
-- 
2.20.1


^ permalink raw reply related	[flat|nested] 73+ messages in thread

* [PATCH v3 04/21] docs: hwmon: sch5627: convert to ReST format
  2019-04-17  9:46                   ` [PATCH v3 00/21]Convert " Mauro Carvalho Chehab
                                       ` (2 preceding siblings ...)
  2019-04-17  9:46                     ` [PATCH v3 03/21] docs: hwmon: menf21bmc: " Mauro Carvalho Chehab
@ 2019-04-17  9:46                     ` Mauro Carvalho Chehab
  2019-04-17  9:46                     ` [PATCH v3 05/21] docs: hwmon: emc2103: " Mauro Carvalho Chehab
                                       ` (16 subsequent siblings)
  20 siblings, 0 replies; 73+ messages in thread
From: Mauro Carvalho Chehab @ 2019-04-17  9:46 UTC (permalink / raw)
  To: Linux Doc Mailing List
  Cc: Mauro Carvalho Chehab, Mauro Carvalho Chehab, linux-kernel,
	Jonathan Corbet, Jean Delvare, Guenter Roeck, linux-hwmon

Convert sch5627 to ReST format, in order to allow it to
be parsed by Sphinx.

Signed-off-by: Mauro Carvalho Chehab <mchehab+samsung@kernel.org>
---
 Documentation/hwmon/sch5627 | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/Documentation/hwmon/sch5627 b/Documentation/hwmon/sch5627
index 0551d266c51c..187682e99114 100644
--- a/Documentation/hwmon/sch5627
+++ b/Documentation/hwmon/sch5627
@@ -2,9 +2,13 @@ Kernel driver sch5627
 =====================
 
 Supported chips:
+
   * SMSC SCH5627
+
     Prefix: 'sch5627'
+
     Addresses scanned: none, address read from Super I/O config space
+
     Datasheet: Application Note available upon request
 
 Author: Hans de Goede <hdegoede@redhat.com>
-- 
2.20.1


^ permalink raw reply related	[flat|nested] 73+ messages in thread

* [PATCH v3 05/21] docs: hwmon: emc2103: convert to ReST format
  2019-04-17  9:46                   ` [PATCH v3 00/21]Convert " Mauro Carvalho Chehab
                                       ` (3 preceding siblings ...)
  2019-04-17  9:46                     ` [PATCH v3 04/21] docs: hwmon: sch5627: " Mauro Carvalho Chehab
@ 2019-04-17  9:46                     ` Mauro Carvalho Chehab
  2019-04-17  9:46                     ` [PATCH v3 06/21] docs: hwmon: pc87360: " Mauro Carvalho Chehab
                                       ` (15 subsequent siblings)
  20 siblings, 0 replies; 73+ messages in thread
From: Mauro Carvalho Chehab @ 2019-04-17  9:46 UTC (permalink / raw)
  To: Linux Doc Mailing List
  Cc: Mauro Carvalho Chehab, Mauro Carvalho Chehab, linux-kernel,
	Jonathan Corbet, Jean Delvare, Guenter Roeck, linux-hwmon

Convert emc2103 to ReST format, in order to allow it to
be parsed by Sphinx.

Signed-off-by: Mauro Carvalho Chehab <mchehab+samsung@kernel.org>
---
 Documentation/hwmon/emc2103 | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/Documentation/hwmon/emc2103 b/Documentation/hwmon/emc2103
index a12b2c127140..6a6ca6d1b34e 100644
--- a/Documentation/hwmon/emc2103
+++ b/Documentation/hwmon/emc2103
@@ -2,13 +2,17 @@ Kernel driver emc2103
 ======================
 
 Supported chips:
+
   * SMSC EMC2103
+
     Addresses scanned: I2C 0x2e
+
     Prefix: 'emc2103'
+
     Datasheet: Not public
 
 Authors:
-        Steve Glendinning <steve.glendinning@smsc.com>
+	Steve Glendinning <steve.glendinning@smsc.com>
 
 Description
 -----------
-- 
2.20.1


^ permalink raw reply related	[flat|nested] 73+ messages in thread

* [PATCH v3 06/21] docs: hwmon: pc87360: convert to ReST format
  2019-04-17  9:46                   ` [PATCH v3 00/21]Convert " Mauro Carvalho Chehab
                                       ` (4 preceding siblings ...)
  2019-04-17  9:46                     ` [PATCH v3 05/21] docs: hwmon: emc2103: " Mauro Carvalho Chehab
@ 2019-04-17  9:46                     ` Mauro Carvalho Chehab
  2019-04-17  9:46                     ` [PATCH v3 07/21] docs: hwmon: fam15h_power: " Mauro Carvalho Chehab
                                       ` (14 subsequent siblings)
  20 siblings, 0 replies; 73+ messages in thread
From: Mauro Carvalho Chehab @ 2019-04-17  9:46 UTC (permalink / raw)
  To: Linux Doc Mailing List
  Cc: Mauro Carvalho Chehab, Mauro Carvalho Chehab, linux-kernel,
	Jonathan Corbet, Jean Delvare, Guenter Roeck, linux-hwmon

Convert pc87360 to ReST format, in order to allow it to
be parsed by Sphinx.

Signed-off-by: Mauro Carvalho Chehab <mchehab+samsung@kernel.org>
---
 Documentation/hwmon/pc87360 | 38 +++++++++++++++++++++++++------------
 1 file changed, 26 insertions(+), 12 deletions(-)

diff --git a/Documentation/hwmon/pc87360 b/Documentation/hwmon/pc87360
index d5f5cf16ce59..4bad07bce54b 100644
--- a/Documentation/hwmon/pc87360
+++ b/Documentation/hwmon/pc87360
@@ -2,14 +2,19 @@ Kernel driver pc87360
 =====================
 
 Supported chips:
+
   * National Semiconductor PC87360, PC87363, PC87364, PC87365 and PC87366
+
     Prefixes: 'pc87360', 'pc87363', 'pc87364', 'pc87365', 'pc87366'
+
     Addresses scanned: none, address read from Super I/O config space
+
     Datasheets: No longer available
 
 Authors: Jean Delvare <jdelvare@suse.de>
 
 Thanks to Sandeep Mehta, Tonko de Rooy and Daniel Ceregatti for testing.
+
 Thanks to Rudolf Marek for helping me investigate conversion issues.
 
 
@@ -17,11 +22,13 @@ Module Parameters
 -----------------
 
 * init int
-  Chip initialization level:
-   0: None
-  *1: Forcibly enable internal voltage and temperature channels, except in9
-   2: Forcibly enable all voltage and temperature channels, except in9
-   3: Forcibly enable all voltage and temperature channels, including in9
+    Chip initialization level:
+
+    - 0: None
+    - **1**: Forcibly enable internal voltage and temperature channels,
+      except in9
+    - 2: Forcibly enable all voltage and temperature channels, except in9
+    - 3: Forcibly enable all voltage and temperature channels, including in9
 
 Note that this parameter has no effect for the PC87360, PC87363 and PC87364
 chips.
@@ -43,13 +50,15 @@ hardware monitoring chipsets, not only controlling and monitoring three fans,
 but also monitoring eleven voltage inputs and two (PC87365) or up to four
 (PC87366) temperatures.
 
+  =========== ======= ======= ======= ======= =====
   Chip        #vin    #fan    #pwm    #temp   devid
-
+  =========== ======= ======= ======= ======= =====
   PC87360     -       2       2       -       0xE1
   PC87363     -       2       2       -       0xE8
   PC87364     -       3       3       -       0xE4
   PC87365     11      3       3       2       0xE5
   PC87366     11      3       3       3-4     0xE9
+  =========== ======= ======= ======= ======= =====
 
 The driver assumes that no more than one chip is present, and one of the
 standard Super I/O addresses is used (0x2E/0x2F or 0x4E/0x4F)
@@ -68,18 +77,23 @@ have to care no more.
 
 For reference, here are a few values about clock dividers:
 
-                slowest         accuracy        highest
-                measurable      around 3000     accurate
+    =========== =============== =============== ===========
+		slowest         accuracy        highest
+		measurable      around 3000     accurate
     divider     speed (RPM)     RPM (RPM)       speed (RPM)
-         1        1882              18           6928
-         2         941              37           4898
-         4         470              74           3464
-         8         235             150           2449
+    =========== =============== =============== ===========
+	 1        1882              18           6928
+	 2         941              37           4898
+	 4         470              74           3464
+	 8         235             150           2449
+    =========== =============== =============== ===========
 
 For the curious, here is how the values above were computed:
+
  * slowest measurable speed: clock/(255*divider)
  * accuracy around 3000 RPM: 3000^2/clock
  * highest accurate speed: sqrt(clock*100)
+
 The clock speed for the PC87360 family is 480 kHz. I arbitrarily chose 100
 RPM as the lowest acceptable accuracy.
 
-- 
2.20.1


^ permalink raw reply related	[flat|nested] 73+ messages in thread

* [PATCH v3 07/21] docs: hwmon: fam15h_power: convert to ReST format
  2019-04-17  9:46                   ` [PATCH v3 00/21]Convert " Mauro Carvalho Chehab
                                       ` (5 preceding siblings ...)
  2019-04-17  9:46                     ` [PATCH v3 06/21] docs: hwmon: pc87360: " Mauro Carvalho Chehab
@ 2019-04-17  9:46                     ` Mauro Carvalho Chehab
  2019-04-17  9:46                     ` [PATCH v3 08/21] docs: hwmon: w83791d: " Mauro Carvalho Chehab
                                       ` (13 subsequent siblings)
  20 siblings, 0 replies; 73+ messages in thread
From: Mauro Carvalho Chehab @ 2019-04-17  9:46 UTC (permalink / raw)
  To: Linux Doc Mailing List
  Cc: Mauro Carvalho Chehab, Mauro Carvalho Chehab, linux-kernel,
	Jonathan Corbet, Jean Delvare, Guenter Roeck, linux-hwmon

Convert fam15h_power to ReST format, in order to allow it to
be parsed by Sphinx.

Signed-off-by: Mauro Carvalho Chehab <mchehab+samsung@kernel.org>
---
 Documentation/hwmon/fam15h_power | 85 +++++++++++++++++++++-----------
 1 file changed, 57 insertions(+), 28 deletions(-)

diff --git a/Documentation/hwmon/fam15h_power b/Documentation/hwmon/fam15h_power
index fb594c281c46..fdde632c93a3 100644
--- a/Documentation/hwmon/fam15h_power
+++ b/Documentation/hwmon/fam15h_power
@@ -2,15 +2,20 @@ Kernel driver fam15h_power
 ==========================
 
 Supported chips:
+
 * AMD Family 15h Processors
+
 * AMD Family 16h Processors
 
   Prefix: 'fam15h_power'
+
   Addresses scanned: PCI space
+
   Datasheets:
-  BIOS and Kernel Developer's Guide (BKDG) For AMD Family 15h Processors
-  BIOS and Kernel Developer's Guide (BKDG) For AMD Family 16h Processors
-  AMD64 Architecture Programmer's Manual Volume 2: System Programming
+
+  - BIOS and Kernel Developer's Guide (BKDG) For AMD Family 15h Processors
+  - BIOS and Kernel Developer's Guide (BKDG) For AMD Family 16h Processors
+  - AMD64 Architecture Programmer's Manual Volume 2: System Programming
 
 Author: Andreas Herrmann <herrmann.der.user@googlemail.com>
 
@@ -31,14 +36,19 @@ For AMD Family 15h and 16h processors the following power values can
 be calculated using different processor northbridge function
 registers:
 
-* BasePwrWatts: Specifies in watts the maximum amount of power
-  consumed by the processor for NB and logic external to the core.
-* ProcessorPwrWatts: Specifies in watts the maximum amount of power
-  the processor can support.
-* CurrPwrWatts: Specifies in watts the current amount of power being
-  consumed by the processor.
+* BasePwrWatts:
+    Specifies in watts the maximum amount of power
+    consumed by the processor for NB and logic external to the core.
+
+* ProcessorPwrWatts:
+    Specifies in watts the maximum amount of power
+    the processor can support.
+* CurrPwrWatts:
+    Specifies in watts the current amount of power being
+    consumed by the processor.
 
 This driver provides ProcessorPwrWatts and CurrPwrWatts:
+
 * power1_crit (ProcessorPwrWatts)
 * power1_input (CurrPwrWatts)
 
@@ -53,35 +63,53 @@ calculate the average power consumed by a processor during a
 measurement interval Tm. The feature of accumulated power mechanism is
 indicated by CPUID Fn8000_0007_EDX[12].
 
-* Tsample: compute unit power accumulator sample period
-* Tref: the PTSC counter period
-* PTSC: performance timestamp counter
-* N: the ratio of compute unit power accumulator sample period to the
-  PTSC period
-* Jmax: max compute unit accumulated power which is indicated by
-  MaxCpuSwPwrAcc MSR C001007b
-* Jx/Jy: compute unit accumulated power which is indicated by
-  CpuSwPwrAcc MSR C001007a
-* Tx/Ty: the value of performance timestamp counter which is indicated
-  by CU_PTSC MSR C0010280
-* PwrCPUave: CPU average power
+* Tsample:
+	compute unit power accumulator sample period
+
+* Tref:
+	the PTSC counter period
+
+* PTSC:
+	performance timestamp counter
+
+* N:
+	the ratio of compute unit power accumulator sample period to the
+	PTSC period
+
+* Jmax:
+	max compute unit accumulated power which is indicated by
+	MaxCpuSwPwrAcc MSR C001007b
+
+* Jx/Jy:
+	compute unit accumulated power which is indicated by
+	CpuSwPwrAcc MSR C001007a
+* Tx/Ty:
+	the value of performance timestamp counter which is indicated
+	by CU_PTSC MSR C0010280
+
+* PwrCPUave:
+	CPU average power
 
 i. Determine the ratio of Tsample to Tref by executing CPUID Fn8000_0007.
+
 	N = value of CPUID Fn8000_0007_ECX[CpuPwrSampleTimeRatio[15:0]].
 
 ii. Read the full range of the cumulative energy value from the new
-MSR MaxCpuSwPwrAcc.
+    MSR MaxCpuSwPwrAcc.
+
 	Jmax = value returned.
+
 iii. At time x, SW reads CpuSwPwrAcc MSR and samples the PTSC.
-	Jx = value read from CpuSwPwrAcc and Tx = value read from
-PTSC.
+
+	Jx = value read from CpuSwPwrAcc and Tx = value read from PTSC.
 
 iv. At time y, SW reads CpuSwPwrAcc MSR and samples the PTSC.
-	Jy = value read from CpuSwPwrAcc and Ty = value read from
-PTSC.
+
+	Jy = value read from CpuSwPwrAcc and Ty = value read from PTSC.
 
 v. Calculate the average power consumption for a compute unit over
-time period (y-x). Unit of result is uWatt.
+   time period (y-x). Unit of result is uWatt::
+
 	if (Jy < Jx) // Rollover has occurred
 		Jdelta = (Jy + Jmax) - Jx
 	else
@@ -90,13 +118,14 @@ time period (y-x). Unit of result is uWatt.
 
 This driver provides PwrCPUave and interval(default is 10 millisecond
 and maximum is 1 second):
+
 * power1_average (PwrCPUave)
 * power1_average_interval (Interval)
 
 The power1_average_interval can be updated at /etc/sensors3.conf file
 as below:
 
-chip "fam15h_power-*"
+chip `fam15h_power-*`
 	set power1_average_interval 0.01
 
 Then save it with "sensors -s".
-- 
2.20.1


^ permalink raw reply related	[flat|nested] 73+ messages in thread

* [PATCH v3 08/21] docs: hwmon: w83791d: convert to ReST format
  2019-04-17  9:46                   ` [PATCH v3 00/21]Convert " Mauro Carvalho Chehab
                                       ` (6 preceding siblings ...)
  2019-04-17  9:46                     ` [PATCH v3 07/21] docs: hwmon: fam15h_power: " Mauro Carvalho Chehab
@ 2019-04-17  9:46                     ` Mauro Carvalho Chehab
  2019-04-17  9:46                     ` [PATCH v3 09/21] docs: hwmon: coretemp: " Mauro Carvalho Chehab
                                       ` (12 subsequent siblings)
  20 siblings, 0 replies; 73+ messages in thread
From: Mauro Carvalho Chehab @ 2019-04-17  9:46 UTC (permalink / raw)
  To: Linux Doc Mailing List
  Cc: Mauro Carvalho Chehab, Mauro Carvalho Chehab, linux-kernel,
	Jonathan Corbet, Jean Delvare, Guenter Roeck, linux-hwmon

Convert w83791d to ReST format, in order to allow it to
be parsed by Sphinx.

Signed-off-by: Mauro Carvalho Chehab <mchehab+samsung@kernel.org>
---
 Documentation/hwmon/w83791d | 123 +++++++++++++++++++++---------------
 1 file changed, 71 insertions(+), 52 deletions(-)

diff --git a/Documentation/hwmon/w83791d b/Documentation/hwmon/w83791d
index f4021a285460..a91f9e5fb0c6 100644
--- a/Documentation/hwmon/w83791d
+++ b/Documentation/hwmon/w83791d
@@ -2,9 +2,13 @@ Kernel driver w83791d
 =====================
 
 Supported chips:
+
   * Winbond W83791D
+
     Prefix: 'w83791d'
+
     Addresses scanned: I2C 0x2c - 0x2f
+
     Datasheet: http://www.winbond-usa.com/products/winbond_products/pdfs/PCIC/W83791D_W83791Gb.pdf
 
 Author: Charles Spirakis <bezaur@gmail.com>
@@ -12,39 +16,46 @@ Author: Charles Spirakis <bezaur@gmail.com>
 This driver was derived from the w83781d.c and w83792d.c source files.
 
 Credits:
+
   w83781d.c:
-    Frodo Looijaard <frodol@dds.nl>,
-    Philip Edelbrock <phil@netroedge.com>,
-    and Mark Studebaker <mdsxyz123@yahoo.com>
+
+    - Frodo Looijaard <frodol@dds.nl>,
+    - Philip Edelbrock <phil@netroedge.com>,
+    - Mark Studebaker <mdsxyz123@yahoo.com>
+
   w83792d.c:
-    Shane Huang (Winbond),
-    Rudolf Marek <r.marek@assembler.cz>
+
+    - Shane Huang (Winbond),
+    - Rudolf Marek <r.marek@assembler.cz>
 
 Additional contributors:
-    Sven Anders <anders@anduras.de>
-    Marc Hulsman <m.hulsman@tudelft.nl>
+
+    - Sven Anders <anders@anduras.de>
+    - Marc Hulsman <m.hulsman@tudelft.nl>
 
 Module Parameters
 -----------------
 
 * init boolean
-  (default 0)
-  Use 'init=1' to have the driver do extra software initializations.
-  The default behavior is to do the minimum initialization possible
-  and depend on the BIOS to properly setup the chip. If you know you
-  have a w83791d and you're having problems, try init=1 before trying
-  reset=1.
+    (default 0)
+
+    Use 'init=1' to have the driver do extra software initializations.
+    The default behavior is to do the minimum initialization possible
+    and depend on the BIOS to properly setup the chip. If you know you
+    have a w83791d and you're having problems, try init=1 before trying
+    reset=1.
 
 * reset boolean
-  (default 0)
-  Use 'reset=1' to reset the chip (via index 0x40, bit 7). The default
-  behavior is no chip reset to preserve BIOS settings.
+    (default 0)
+
+    Use 'reset=1' to reset the chip (via index 0x40, bit 7). The default
+    behavior is no chip reset to preserve BIOS settings.
 
 * force_subclients=bus,caddr,saddr,saddr
-  This is used to force the i2c addresses for subclients of
-  a certain chip. Example usage is `force_subclients=0,0x2f,0x4a,0x4b'
-  to force the subclients of chip 0x2f on bus 0 to i2c addresses
-  0x4a and 0x4b.
+    This is used to force the i2c addresses for subclients of
+    a certain chip. Example usage is `force_subclients=0,0x2f,0x4a,0x4b`
+    to force the subclients of chip 0x2f on bus 0 to i2c addresses
+    0x4a and 0x4b.
 
 
 Description
@@ -91,11 +102,11 @@ This file is used for both legacy and new code.
 
 The sysfs interface to the beep bitmask has migrated from the original legacy
 method of a single sysfs beep_mask file to a newer method using multiple
-*_beep files as described in .../Documentation/hwmon/sysfs-interface.
+`*_beep` files as described in `Documentation/hwmon/sysfs-interface`.
 
 A similar change has occurred for the bitmap corresponding to the alarms. The
 original legacy method used a single sysfs alarms file containing a bitmap
-of triggered alarms. The newer method uses multiple sysfs *_alarm files
+of triggered alarms. The newer method uses multiple sysfs `*_alarm` files
 (again following the pattern described in sysfs-interface).
 
 Since both methods read and write the underlying hardware, they can be used
@@ -116,46 +127,54 @@ User mode code requesting values more often will receive cached values.
 The sysfs-interface is documented in the 'sysfs-interface' file. Only
 chip-specific options are documented here.
 
-pwm[1-3]_enable -	this file controls mode of fan/temperature control for
+======================= =======================================================
+pwm[1-3]_enable		this file controls mode of fan/temperature control for
 			fan 1-3. Fan/PWM 4-5 only support manual mode.
-		            * 1 Manual mode
-		            * 2 Thermal Cruise mode
-		            * 3 Fan Speed Cruise mode (no further support)
 
-temp[1-3]_target -	defines the target temperature for Thermal Cruise mode.
+			    * 1 Manual mode
+			    * 2 Thermal Cruise mode
+			    * 3 Fan Speed Cruise mode (no further support)
+
+temp[1-3]_target	defines the target temperature for Thermal Cruise mode.
 			Unit: millidegree Celsius
 			RW
 
-temp[1-3]_tolerance -	temperature tolerance for Thermal Cruise mode.
+temp[1-3]_tolerance	temperature tolerance for Thermal Cruise mode.
 			Specifies an interval around the target temperature
 			in which the fan speed is not changed.
 			Unit: millidegree Celsius
 			RW
+======================= =======================================================
 
 Alarms bitmap vs. beep_mask bitmask
-------------------------------------
+-----------------------------------
+
 For legacy code using the alarms and beep_mask files:
 
-in0 (VCORE)  :  alarms: 0x000001 beep_mask: 0x000001
-in1 (VINR0)  :  alarms: 0x000002 beep_mask: 0x002000 <== mismatch
-in2 (+3.3VIN):  alarms: 0x000004 beep_mask: 0x000004
-in3 (5VDD)   :  alarms: 0x000008 beep_mask: 0x000008
-in4 (+12VIN) :  alarms: 0x000100 beep_mask: 0x000100
-in5 (-12VIN) :  alarms: 0x000200 beep_mask: 0x000200
-in6 (-5VIN)  :  alarms: 0x000400 beep_mask: 0x000400
-in7 (VSB)    :  alarms: 0x080000 beep_mask: 0x010000 <== mismatch
-in8 (VBAT)   :  alarms: 0x100000 beep_mask: 0x020000 <== mismatch
-in9 (VINR1)  :  alarms: 0x004000 beep_mask: 0x004000
-temp1        :  alarms: 0x000010 beep_mask: 0x000010
-temp2        :  alarms: 0x000020 beep_mask: 0x000020
-temp3        :  alarms: 0x002000 beep_mask: 0x000002 <== mismatch
-fan1         :  alarms: 0x000040 beep_mask: 0x000040
-fan2         :  alarms: 0x000080 beep_mask: 0x000080
-fan3         :  alarms: 0x000800 beep_mask: 0x000800
-fan4         :  alarms: 0x200000 beep_mask: 0x200000
-fan5         :  alarms: 0x400000 beep_mask: 0x400000
-tart1        :  alarms: 0x010000 beep_mask: 0x040000 <== mismatch
-tart2        :  alarms: 0x020000 beep_mask: 0x080000 <== mismatch
-tart3        :  alarms: 0x040000 beep_mask: 0x100000 <== mismatch
-case_open    :  alarms: 0x001000 beep_mask: 0x001000
-global_enable:  alarms: -------- beep_mask: 0x800000 (modified via beep_enable)
+=============  ========  ========= ==========================
+Signal         Alarms    beep_mask Obs
+=============  ========  ========= ==========================
+in0 (VCORE)    0x000001  0x000001
+in1 (VINR0)    0x000002  0x002000  <== mismatch
+in2 (+3.3VIN)  0x000004  0x000004
+in3 (5VDD)     0x000008  0x000008
+in4 (+12VIN)   0x000100  0x000100
+in5 (-12VIN)   0x000200  0x000200
+in6 (-5VIN)    0x000400  0x000400
+in7 (VSB)      0x080000  0x010000  <== mismatch
+in8 (VBAT)     0x100000  0x020000  <== mismatch
+in9 (VINR1)    0x004000  0x004000
+temp1          0x000010  0x000010
+temp2          0x000020  0x000020
+temp3          0x002000  0x000002  <== mismatch
+fan1           0x000040  0x000040
+fan2           0x000080  0x000080
+fan3           0x000800  0x000800
+fan4           0x200000  0x200000
+fan5           0x400000  0x400000
+tart1          0x010000  0x040000  <== mismatch
+tart2          0x020000  0x080000  <== mismatch
+tart3          0x040000  0x100000  <== mismatch
+case_open      0x001000  0x001000
+global_enable  -         0x800000  (modified via beep_enable)
+=============  ========  ========= ==========================
-- 
2.20.1


^ permalink raw reply related	[flat|nested] 73+ messages in thread

* [PATCH v3 09/21] docs: hwmon: coretemp: convert to ReST format
  2019-04-17  9:46                   ` [PATCH v3 00/21]Convert " Mauro Carvalho Chehab
                                       ` (7 preceding siblings ...)
  2019-04-17  9:46                     ` [PATCH v3 08/21] docs: hwmon: w83791d: " Mauro Carvalho Chehab
@ 2019-04-17  9:46                     ` Mauro Carvalho Chehab
  2019-04-17  9:46                     ` [PATCH v3 10/21] docs: hwmon: aspeed-pwm-tacho: " Mauro Carvalho Chehab
                                       ` (11 subsequent siblings)
  20 siblings, 0 replies; 73+ messages in thread
From: Mauro Carvalho Chehab @ 2019-04-17  9:46 UTC (permalink / raw)
  To: Linux Doc Mailing List
  Cc: Mauro Carvalho Chehab, Mauro Carvalho Chehab, linux-kernel,
	Jonathan Corbet, Jean Delvare, Guenter Roeck, linux-hwmon

Convert coretemp to ReST format, in order to allow it to
be parsed by Sphinx.

Signed-off-by: Mauro Carvalho Chehab <mchehab+samsung@kernel.org>
---
 Documentation/hwmon/coretemp | 46 +++++++++++++++++++++++-------------
 1 file changed, 30 insertions(+), 16 deletions(-)

diff --git a/Documentation/hwmon/coretemp b/Documentation/hwmon/coretemp
index fec5a9bf755f..c609329e3bc4 100644
--- a/Documentation/hwmon/coretemp
+++ b/Documentation/hwmon/coretemp
@@ -3,20 +3,29 @@ Kernel driver coretemp
 
 Supported chips:
   * All Intel Core family
+
     Prefix: 'coretemp'
-    CPUID: family 0x6, models 0xe (Pentium M DC), 0xf (Core 2 DC 65nm),
-                              0x16 (Core 2 SC 65nm), 0x17 (Penryn 45nm),
-                              0x1a (Nehalem), 0x1c (Atom), 0x1e (Lynnfield),
-                              0x26 (Tunnel Creek Atom), 0x27 (Medfield Atom),
-                              0x36 (Cedar Trail Atom)
-    Datasheet: Intel 64 and IA-32 Architectures Software Developer's Manual
-               Volume 3A: System Programming Guide
-               http://softwarecommunity.intel.com/Wiki/Mobility/720.htm
+
+    CPUID: family 0x6, models
+
+			    - 0xe (Pentium M DC), 0xf (Core 2 DC 65nm),
+			    - 0x16 (Core 2 SC 65nm), 0x17 (Penryn 45nm),
+			    - 0x1a (Nehalem), 0x1c (Atom), 0x1e (Lynnfield),
+			    - 0x26 (Tunnel Creek Atom), 0x27 (Medfield Atom),
+			    - 0x36 (Cedar Trail Atom)
+
+    Datasheet:
+
+	       Intel 64 and IA-32 Architectures Software Developer's Manual
+	       Volume 3A: System Programming Guide
+
+	       http://softwarecommunity.intel.com/Wiki/Mobility/720.htm
 
 Author: Rudolf Marek
 
 Description
 -----------
+
 This driver permits reading the DTS (Digital Temperature Sensor) embedded
 inside Intel CPUs. This driver can read both the per-core and per-package
 temperature using the appropriate sensors. The per-package sensor is new;
@@ -35,14 +44,17 @@ may be raised, if the temperature grows enough (more than TjMax) to trigger
 the Out-Of-Spec bit. Following table summarizes the exported sysfs files:
 
 All Sysfs entries are named with their core_id (represented here by 'X').
-tempX_input	 - Core temperature (in millidegrees Celsius).
-tempX_max	 - All cooling devices should be turned on (on Core2).
-tempX_crit	 - Maximum junction temperature (in millidegrees Celsius).
-tempX_crit_alarm - Set when Out-of-spec bit is set, never clears.
-		   Correct CPU operation is no longer guaranteed.
-tempX_label	 - Contains string "Core X", where X is processor
-		   number. For Package temp, this will be "Physical id Y",
-		   where Y is the package number.
+
+================= ========================================================
+tempX_input	  Core temperature (in millidegrees Celsius).
+tempX_max	  All cooling devices should be turned on (on Core2).
+tempX_crit	  Maximum junction temperature (in millidegrees Celsius).
+tempX_crit_alarm  Set when Out-of-spec bit is set, never clears.
+		  Correct CPU operation is no longer guaranteed.
+tempX_label	  Contains string "Core X", where X is processor
+		  number. For Package temp, this will be "Physical id Y",
+		  where Y is the package number.
+================= ========================================================
 
 On CPU models which support it, TjMax is read from a model-specific register.
 On other models, it is set to an arbitrary value based on weak heuristics.
@@ -52,6 +64,7 @@ as a module parameter (tjmax).
 Appendix A. Known TjMax lists (TBD):
 Some information comes from ark.intel.com
 
+=============== =============================================== ================
 Process		Processor					TjMax(C)
 
 22nm		Core i5/i7 Processors
@@ -179,3 +192,4 @@ Process		Processor					TjMax(C)
 65nm		Celeron Processors
 		T1700/1600					100
 		560/550/540/530					100
+=============== =============================================== ================
-- 
2.20.1


^ permalink raw reply related	[flat|nested] 73+ messages in thread

* [PATCH v3 10/21] docs: hwmon: aspeed-pwm-tacho: convert to ReST format
  2019-04-17  9:46                   ` [PATCH v3 00/21]Convert " Mauro Carvalho Chehab
                                       ` (8 preceding siblings ...)
  2019-04-17  9:46                     ` [PATCH v3 09/21] docs: hwmon: coretemp: " Mauro Carvalho Chehab
@ 2019-04-17  9:46                     ` Mauro Carvalho Chehab
  2019-04-17  9:46                     ` [PATCH v3 11/21] docs: hwmon: ibmpowernv: " Mauro Carvalho Chehab
                                       ` (10 subsequent siblings)
  20 siblings, 0 replies; 73+ messages in thread
From: Mauro Carvalho Chehab @ 2019-04-17  9:46 UTC (permalink / raw)
  To: Linux Doc Mailing List
  Cc: Mauro Carvalho Chehab, Mauro Carvalho Chehab, linux-kernel,
	Jonathan Corbet, Jean Delvare, Guenter Roeck, Joel Stanley,
	Andrew Jeffery, linux-hwmon, linux-arm-kernel, linux-aspeed

Convert aspeed-pwm-tacho to ReST format, in order to allow it to
be parsed by Sphinx.

Signed-off-by: Mauro Carvalho Chehab <mchehab+samsung@kernel.org>
---
 Documentation/hwmon/aspeed-pwm-tacho | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/Documentation/hwmon/aspeed-pwm-tacho b/Documentation/hwmon/aspeed-pwm-tacho
index 7cfb34977460..6dcec845fbc7 100644
--- a/Documentation/hwmon/aspeed-pwm-tacho
+++ b/Documentation/hwmon/aspeed-pwm-tacho
@@ -15,8 +15,10 @@ controller supports up to 16 tachometer inputs.
 
 The driver provides the following sensor accesses in sysfs:
 
+=============== ======= =====================================================
 fanX_input	ro	provide current fan rotation value in RPM as reported
 			by the fan to the device.
 
 pwmX		rw	get or set PWM fan control value. This is an integer
 			value between 0(off) and 255(full speed).
+=============== ======= =====================================================
-- 
2.20.1


^ permalink raw reply related	[flat|nested] 73+ messages in thread

* [PATCH v3 11/21] docs: hwmon: ibmpowernv: convert to ReST format
  2019-04-17  9:46                   ` [PATCH v3 00/21]Convert " Mauro Carvalho Chehab
                                       ` (9 preceding siblings ...)
  2019-04-17  9:46                     ` [PATCH v3 10/21] docs: hwmon: aspeed-pwm-tacho: " Mauro Carvalho Chehab
@ 2019-04-17  9:46                     ` Mauro Carvalho Chehab
  2019-04-17  9:46                     ` [PATCH v3 12/21] docs: hwmon: asc7621: " Mauro Carvalho Chehab
                                       ` (9 subsequent siblings)
  20 siblings, 0 replies; 73+ messages in thread
From: Mauro Carvalho Chehab @ 2019-04-17  9:46 UTC (permalink / raw)
  To: Linux Doc Mailing List
  Cc: Mauro Carvalho Chehab, Mauro Carvalho Chehab, linux-kernel,
	Jonathan Corbet, Jean Delvare, Guenter Roeck,
	Benjamin Herrenschmidt, Paul Mackerras, Michael Ellerman,
	linux-hwmon, linuxppc-dev

Convert ibmpowernv to ReST format, in order to allow it to
be parsed by Sphinx.

Signed-off-by: Mauro Carvalho Chehab <mchehab+samsung@kernel.org>
---
 Documentation/hwmon/ibmpowernv | 31 +++++++++++++++++++------------
 1 file changed, 19 insertions(+), 12 deletions(-)

diff --git a/Documentation/hwmon/ibmpowernv b/Documentation/hwmon/ibmpowernv
index 56468258711f..5d642bc3dec0 100644
--- a/Documentation/hwmon/ibmpowernv
+++ b/Documentation/hwmon/ibmpowernv
@@ -2,6 +2,7 @@ Kernel Driver IBMPOWERNV
 ========================
 
 Supported systems:
+
   * Any recent IBM P servers based on POWERNV platform
 
 Author: Neelesh Gupta
@@ -29,10 +30,11 @@ CONFIG_SENSORS_IBMPOWERNV. It can also be built as module 'ibmpowernv'.
 Sysfs attributes
 ----------------
 
+======================= =======================================================
 fanX_input		Measured RPM value.
 fanX_min		Threshold RPM for alert generation.
-fanX_fault		0: No fail condition
-			1: Failing fan
+fanX_fault		- 0: No fail condition
+			- 1: Failing fan
 
 tempX_input		Measured ambient temperature.
 tempX_max		Threshold ambient temperature for alert generation.
@@ -42,20 +44,22 @@ tempX_enable		Enable/disable all temperature sensors belonging to the
 			sub-group. In POWER9, this attribute corresponds to
 			each OCC. Using this attribute each OCC can be asked to
 			disable/enable all of its temperature sensors.
-			1: Enable
-			0: Disable
+
+			- 1: Enable
+			- 0: Disable
 
 inX_input		Measured power supply voltage (millivolt)
-inX_fault		0: No fail condition.
-			1: Failing power supply.
+inX_fault		- 0: No fail condition.
+			- 1: Failing power supply.
 inX_highest		Historical maximum voltage
 inX_lowest		Historical minimum voltage
 inX_enable		Enable/disable all voltage sensors belonging to the
 			sub-group. In POWER9, this attribute corresponds to
 			each OCC. Using this attribute each OCC can be asked to
 			disable/enable all of its voltage sensors.
-			1: Enable
-			0: Disable
+
+			- 1: Enable
+			- 0: Disable
 
 powerX_input		Power consumption (microWatt)
 powerX_input_highest	Historical maximum power
@@ -64,8 +68,9 @@ powerX_enable		Enable/disable all power sensors belonging to the
 			sub-group. In POWER9, this attribute corresponds to
 			each OCC. Using this attribute each OCC can be asked to
 			disable/enable all of its power sensors.
-			1: Enable
-			0: Disable
+
+			- 1: Enable
+			- 0: Disable
 
 currX_input		Measured current (milliampere)
 currX_highest		Historical maximum current
@@ -74,7 +79,9 @@ currX_enable		Enable/disable all current sensors belonging to the
 			sub-group. In POWER9, this attribute corresponds to
 			each OCC. Using this attribute each OCC can be asked to
 			disable/enable all of its current sensors.
-			1: Enable
-			0: Disable
+
+			- 1: Enable
+			- 0: Disable
 
 energyX_input		Cumulative energy (microJoule)
+======================= =======================================================
-- 
2.20.1


^ permalink raw reply related	[flat|nested] 73+ messages in thread

* [PATCH v3 12/21] docs: hwmon: asc7621: convert to ReST format
  2019-04-17  9:46                   ` [PATCH v3 00/21]Convert " Mauro Carvalho Chehab
                                       ` (10 preceding siblings ...)
  2019-04-17  9:46                     ` [PATCH v3 11/21] docs: hwmon: ibmpowernv: " Mauro Carvalho Chehab
@ 2019-04-17  9:46                     ` Mauro Carvalho Chehab
  2019-04-17  9:46                     ` [PATCH v3 13/21] docs: hwmon: ads1015: " Mauro Carvalho Chehab
                                       ` (8 subsequent siblings)
  20 siblings, 0 replies; 73+ messages in thread
From: Mauro Carvalho Chehab @ 2019-04-17  9:46 UTC (permalink / raw)
  To: Linux Doc Mailing List
  Cc: Mauro Carvalho Chehab, Mauro Carvalho Chehab, linux-kernel,
	Jonathan Corbet, Jean Delvare, Guenter Roeck, linux-hwmon

Convert asc7621 to ReST format, in order to allow it to
be parsed by Sphinx.

Signed-off-by: Mauro Carvalho Chehab <mchehab+samsung@kernel.org>
---
 Documentation/hwmon/asc7621 | 146 ++++++++++++++++++++++--------------
 1 file changed, 88 insertions(+), 58 deletions(-)

diff --git a/Documentation/hwmon/asc7621 b/Documentation/hwmon/asc7621
index 7287be7e1f21..b5a9fad0f172 100644
--- a/Documentation/hwmon/asc7621
+++ b/Documentation/hwmon/asc7621
@@ -1,10 +1,15 @@
+=====================
 Kernel driver asc7621
-==================
+=====================
 
 Supported chips:
+
     Andigilog aSC7621 and aSC7621a
+
     Prefix: 'asc7621'
+
     Addresses scanned: I2C 0x2c, 0x2d, 0x2e
+
     Datasheet: http://www.fairview5.com/linux/asc7621/asc7621.pdf
 
 Author:
@@ -73,8 +78,10 @@ Finally, we have added a tach disable function that turns off the tach
 measurement system for individual tachs in order to save power. That is
 in register 75h.
 
---
+--------------------------------------------------------------------------
+
 aSC7621 Product Description
+===========================
 
 The aSC7621 has a two wire digital interface compatible with SMBus 2.0.
 Using a 10-bit ADC, the aSC7621 measures the temperature of two remote diode
@@ -102,6 +109,8 @@ System voltages of VCCP, 2.5V, 3.3V, 5.0V, and 12V motherboard power are
 monitored efficiently with internal scaling resistors.
 
 Features
+--------
+
 - Supports PECI interface and monitors internal and remote thermal diodes
 - 2-wire, SMBus 2.0 compliant, serial interface
 - 10-bit ADC
@@ -110,7 +119,7 @@ Features
 - Noise filtering of temperature reading for fan speed control
 - 0.25C digital temperature sensor resolution
 - 3 PWM fan speed control outputs for 2-, 3- or 4-wire fans and up to 4 fan
-	tachometer inputs
+  tachometer inputs
 - Enhanced measured temperature to Temperature Zone assignment.
 - Provides high and low PWM frequency ranges
 - 3 GPIO pins for custom use
@@ -123,17 +132,20 @@ Except where noted below, the sysfs entries created by this driver follow
 the standards defined in "sysfs-interface".
 
 temp1_source
+	=	===============================================
 	0 	(default) peci_legacy = 0, Remote 1 Temperature
-			peci_legacy = 1, PECI Processor Temperature 0
+		peci_legacy = 1, PECI Processor Temperature 0
 	1 	Remote 1 Temperature
 	2 	Remote 2 Temperature
 	3 	Internal Temperature
 	4 	PECI Processor Temperature 0
 	5 	PECI Processor Temperature 1
 	6 	PECI Processor Temperature 2
-	7  PECI Processor Temperature 3
+	7	PECI Processor Temperature 3
+	=	===============================================
 
 temp2_source
+	=	===============================================
 	0 	(default) Internal Temperature
 	1 	Remote 1 Temperature
 	2 	Remote 2 Temperature
@@ -142,8 +154,10 @@ temp2_source
 	5 	PECI Processor Temperature 1
 	6 	PECI Processor Temperature 2
 	7 	PECI Processor Temperature 3
+	=	===============================================
 
 temp3_source
+	=	===============================================
 	0 	(default) Remote 2 Temperature
 	1 	Remote 1 Temperature
 	2 	Remote 2 Temperature
@@ -152,10 +166,12 @@ temp3_source
 	5 	PECI Processor Temperature 1
 	6 	PECI Processor Temperature 2
 	7 	PECI Processor Temperature 3
+	=	===============================================
 
 temp4_source
+	=	===============================================
 	0 	(default) peci_legacy = 0, PECI Processor Temperature 0
-			peci_legacy = 1, Remote 1 Temperature
+		peci_legacy = 1, Remote 1 Temperature
 	1 	Remote 1 Temperature
 	2 	Remote 2 Temperature
 	3 	Internal Temperature
@@ -163,58 +179,65 @@ temp4_source
 	5 	PECI Processor Temperature 1
 	6 	PECI Processor Temperature 2
 	7 	PECI Processor Temperature 3
+	=	===============================================
 
-temp[1-4]_smoothing_enable
-temp[1-4]_smoothing_time
+temp[1-4]_smoothing_enable / temp[1-4]_smoothing_time
 	Smooths spikes in temp readings caused by noise.
 	Valid values in milliseconds are:
-	35000
-	17600
-	11800
-	 7000
-	 4400
-	 3000
-	 1600
-	  800
+
+	* 35000
+	* 17600
+	* 11800
+	*  7000
+	*  4400
+	*  3000
+	*  1600
+	*   800
 
 temp[1-4]_crit
 	When the corresponding zone temperature reaches this value,
 	ALL pwm outputs will got to 100%.
 
-temp[5-8]_input
-temp[5-8]_enable
+temp[5-8]_input / temp[5-8]_enable
 	The aSC7621 can also read temperatures provided by the processor
 	via the PECI bus.  Usually these are "core" temps and are relative
 	to the point where the automatic thermal control circuit starts
 	throttling.  This means that these are usually negative numbers.
 
 pwm[1-3]_enable
+	=============== ========================================================
 	0		Fan off.
 	1		Fan on manual control.
 	2		Fan on automatic control and will run at the minimum pwm
-				if the temperature for the zone is below the minimum.
-	3		Fan on automatic control but will be off if the temperature
-				for the zone is below the minimum.
-	4-254	Ignored.
+			if the temperature for the zone is below the minimum.
+	3		Fan on automatic control but will be off if the
+			temperature for the zone is below the minimum.
+	4-254		Ignored.
 	255		Fan on full.
+	=============== ========================================================
 
 pwm[1-3]_auto_channels
 	Bitmap as described in sysctl-interface with the following
 	exceptions...
+
 	Only the following combination of zones (and their corresponding masks)
 	are valid:
-	1
-	2
-	3
-	2,3
-	1,2,3
-	4
-	1,2,3,4
 
-	Special values:
-	0			Disabled.
-	16		Fan on manual control.
-	31		Fan on full.
+	* 1
+	* 2
+	* 3
+	* 2,3
+	* 1,2,3
+	* 4
+	* 1,2,3,4
+
+	* Special values:
+
+	  ==		======================
+	  0		Disabled.
+	  16		Fan on manual control.
+	  31		Fan on full.
+	  ==		======================
 
 
 pwm[1-3]_invert
@@ -226,22 +249,22 @@ pwm[1-3]_freq
 	PWM frequency in Hz
 	Valid values in Hz are:
 
-	10
-	15
-	23
-	30  (default)
-	38
-	47
-	62
-	94
-	23000
-	24000
-	25000
-	26000
-	27000
-	28000
-	29000
-	30000
+	* 10
+	* 15
+	* 23
+	* 30  (default)
+	* 38
+	* 47
+	* 62
+	* 94
+	* 23000
+	* 24000
+	* 25000
+	* 26000
+	* 27000
+	* 28000
+	* 29000
+	* 30000
 
 	Setting any other value will be ignored.
 
@@ -251,17 +274,17 @@ peci_enable
 peci_avg
 	Input filter average time.
 
-	0 	0 Sec. (no Smoothing) (default)
-	1 	0.25 Sec.
-	2 	0.5 Sec.
-	3 	1.0 Sec.
-	4 	2.0 Sec.
-	5 	4.0 Sec.
-	6 	8.0 Sec.
-	7 	0.0 Sec.
+	* 0 	0 Sec. (no Smoothing) (default)
+	* 1 	0.25 Sec.
+	* 2 	0.5 Sec.
+	* 3 	1.0 Sec.
+	* 4 	2.0 Sec.
+	* 5 	4.0 Sec.
+	* 6 	8.0 Sec.
+	* 7 	0.0 Sec.
 
 peci_legacy
-
+	=	============================================
 	0	Standard Mode (default)
 		Remote Diode 1 reading is associated with
 		Temperature Zone 1, PECI is associated with
@@ -270,10 +293,12 @@ peci_legacy
 	1	Legacy Mode
 		PECI is associated with Temperature Zone 1,
 		Remote Diode 1 is associated with Zone 4
+	=	============================================
 
 peci_diode
 	Diode filter
 
+	=	====================
 	0	0.25 Sec.
 	1 	1.1 Sec.
 	2 	2.4 Sec.  (default)
@@ -282,15 +307,20 @@ peci_diode
 	5 	6.8 Sec.
 	6 	10.2 Sec.
 	7 	16.4 Sec.
+	=	====================
 
 peci_4domain
 	Four domain enable
 
+	=	===============================================
 	0 	1 or 2 Domains for enabled processors (default)
 	1 	3 or 4 Domains for enabled processors
+	=	===============================================
 
 peci_domain
 	Domain
 
+	=	==================================================
 	0 	Processor contains a single domain (0) 	 (default)
 	1 	Processor contains two domains (0,1)
+	=	==================================================
-- 
2.20.1


^ permalink raw reply related	[flat|nested] 73+ messages in thread

* [PATCH v3 13/21] docs: hwmon: ads1015: convert to ReST format
  2019-04-17  9:46                   ` [PATCH v3 00/21]Convert " Mauro Carvalho Chehab
                                       ` (11 preceding siblings ...)
  2019-04-17  9:46                     ` [PATCH v3 12/21] docs: hwmon: asc7621: " Mauro Carvalho Chehab
@ 2019-04-17  9:46                     ` Mauro Carvalho Chehab
  2019-04-17  9:46                     ` [PATCH v3 14/21] docs: hwmon: dme1737, vt1211: " Mauro Carvalho Chehab
                                       ` (7 subsequent siblings)
  20 siblings, 0 replies; 73+ messages in thread
From: Mauro Carvalho Chehab @ 2019-04-17  9:46 UTC (permalink / raw)
  To: Linux Doc Mailing List
  Cc: Mauro Carvalho Chehab, Mauro Carvalho Chehab, linux-kernel,
	Jonathan Corbet, Jean Delvare, Guenter Roeck, linux-hwmon

Convert ads1015 to ReST format, in order to allow it to
be parsed by Sphinx.

Signed-off-by: Mauro Carvalho Chehab <mchehab+samsung@kernel.org>
---
 Documentation/hwmon/ads1015 | 72 ++++++++++++++++++++++---------------
 1 file changed, 43 insertions(+), 29 deletions(-)

diff --git a/Documentation/hwmon/ads1015 b/Documentation/hwmon/ads1015
index 02d2a459385f..e0951c4e57bb 100644
--- a/Documentation/hwmon/ads1015
+++ b/Documentation/hwmon/ads1015
@@ -2,17 +2,25 @@ Kernel driver ads1015
 =====================
 
 Supported chips:
+
   * Texas Instruments ADS1015
+
     Prefix: 'ads1015'
-    Datasheet: Publicly available at the Texas Instruments website :
-               http://focus.ti.com/lit/ds/symlink/ads1015.pdf
+
+    Datasheet: Publicly available at the Texas Instruments website:
+
+	       http://focus.ti.com/lit/ds/symlink/ads1015.pdf
+
   * Texas Instruments ADS1115
+
     Prefix: 'ads1115'
-    Datasheet: Publicly available at the Texas Instruments website :
-               http://focus.ti.com/lit/ds/symlink/ads1115.pdf
+
+    Datasheet: Publicly available at the Texas Instruments website:
+
+	       http://focus.ti.com/lit/ds/symlink/ads1115.pdf
 
 Authors:
-        Dirk Eibach, Guntermann & Drunck GmbH <eibach@gdsys.de>
+	Dirk Eibach, Guntermann & Drunck GmbH <eibach@gdsys.de>
 
 Description
 -----------
@@ -24,14 +32,15 @@ This device is a 12/16-bit A-D converter with 4 inputs.
 The inputs can be used single ended or in certain differential combinations.
 
 The inputs can be made available by 8 sysfs input files in0_input - in7_input:
-in0: Voltage over AIN0 and AIN1.
-in1: Voltage over AIN0 and AIN3.
-in2: Voltage over AIN1 and AIN3.
-in3: Voltage over AIN2 and AIN3.
-in4: Voltage over AIN0 and GND.
-in5: Voltage over AIN1 and GND.
-in6: Voltage over AIN2 and GND.
-in7: Voltage over AIN3 and GND.
+
+  - in0: Voltage over AIN0 and AIN1.
+  - in1: Voltage over AIN0 and AIN3.
+  - in2: Voltage over AIN1 and AIN3.
+  - in3: Voltage over AIN2 and AIN3.
+  - in4: Voltage over AIN0 and GND.
+  - in5: Voltage over AIN1 and GND.
+  - in6: Voltage over AIN2 and GND.
+  - in7: Voltage over AIN3 and GND.
 
 Which inputs are available can be configured using platform data or devicetree.
 
@@ -42,29 +51,34 @@ Platform Data
 
 In linux/platform_data/ads1015.h platform data is defined, channel_data contains
 configuration data for the used input combinations:
+
 - pga is the programmable gain amplifier (values are full scale)
-  0: +/- 6.144 V
-  1: +/- 4.096 V
-  2: +/- 2.048 V
-  3: +/- 1.024 V
-  4: +/- 0.512 V
-  5: +/- 0.256 V
+
+    - 0: +/- 6.144 V
+    - 1: +/- 4.096 V
+    - 2: +/- 2.048 V
+    - 3: +/- 1.024 V
+    - 4: +/- 0.512 V
+    - 5: +/- 0.256 V
+
 - data_rate in samples per second
-  0: 128
-  1: 250
-  2: 490
-  3: 920
-  4: 1600
-  5: 2400
-  6: 3300
 
-Example:
-struct ads1015_platform_data data = {
+    - 0: 128
+    - 1: 250
+    - 2: 490
+    - 3: 920
+    - 4: 1600
+    - 5: 2400
+    - 6: 3300
+
+Example::
+
+  struct ads1015_platform_data data = {
 	.channel_data = {
 		[2] = { .enabled = true, .pga = 1, .data_rate = 0 },
 		[4] = { .enabled = true, .pga = 4, .data_rate = 5 },
 	}
-};
+  };
 
 In this case only in2_input (FS +/- 4.096 V, 128 SPS) and in4_input
 (FS +/- 0.512 V, 2400 SPS) would be created.
-- 
2.20.1


^ permalink raw reply related	[flat|nested] 73+ messages in thread

* [PATCH v3 14/21] docs: hwmon: dme1737, vt1211: convert to ReST format
  2019-04-17  9:46                   ` [PATCH v3 00/21]Convert " Mauro Carvalho Chehab
                                       ` (12 preceding siblings ...)
  2019-04-17  9:46                     ` [PATCH v3 13/21] docs: hwmon: ads1015: " Mauro Carvalho Chehab
@ 2019-04-17  9:46                     ` Mauro Carvalho Chehab
  2019-04-17  9:46                     ` [PATCH v3 15/21] docs: hwmon: wm831x, wm8350: " Mauro Carvalho Chehab
                                       ` (6 subsequent siblings)
  20 siblings, 0 replies; 73+ messages in thread
From: Mauro Carvalho Chehab @ 2019-04-17  9:46 UTC (permalink / raw)
  To: Linux Doc Mailing List
  Cc: Mauro Carvalho Chehab, Mauro Carvalho Chehab, linux-kernel,
	Jonathan Corbet, Jean Delvare, Guenter Roeck, linux-hwmon

Convert dme1737 and vt1211 to ReST format, in order to allow
them to be parsed by Sphinx.

Signed-off-by: Mauro Carvalho Chehab <mchehab+samsung@kernel.org>
---
 Documentation/hwmon/dme1737 | 88 ++++++++++++++++++++++++++-----------
 Documentation/hwmon/vt1211  | 84 +++++++++++++++++++++--------------
 2 files changed, 114 insertions(+), 58 deletions(-)

diff --git a/Documentation/hwmon/dme1737 b/Documentation/hwmon/dme1737
index 4d2935145a1c..82fcbc6b2b43 100644
--- a/Documentation/hwmon/dme1737
+++ b/Documentation/hwmon/dme1737
@@ -2,21 +2,37 @@ Kernel driver dme1737
 =====================
 
 Supported chips:
+
   * SMSC DME1737 and compatibles (like Asus A8000)
+
     Prefix: 'dme1737'
+
     Addresses scanned: I2C 0x2c, 0x2d, 0x2e
+
     Datasheet: Provided by SMSC upon request and under NDA
+
   * SMSC SCH3112, SCH3114, SCH3116
+
     Prefix: 'sch311x'
+
     Addresses scanned: none, address read from Super-I/O config space
+
     Datasheet: Available on the Internet
+
   * SMSC SCH5027
+
     Prefix: 'sch5027'
+
     Addresses scanned: I2C 0x2c, 0x2d, 0x2e
+
     Datasheet: Provided by SMSC upon request and under NDA
+
   * SMSC SCH5127
+
     Prefix: 'sch5127'
+
     Addresses scanned: none, address read from Super-I/O config space
+
     Datasheet: Provided by SMSC upon request and under NDA
 
 Authors:
@@ -26,11 +42,14 @@ Authors:
 Module Parameters
 -----------------
 
-* force_start: bool	Enables the monitoring of voltage, fan and temp inputs
+* force_start: bool
+			Enables the monitoring of voltage, fan and temp inputs
 			and PWM output control functions. Using this parameter
 			shouldn't be required since the BIOS usually takes care
 			of this.
-* probe_all_addr: bool	Include non-standard LPC addresses 0x162e and 0x164e
+
+* probe_all_addr: bool
+			Include non-standard LPC addresses 0x162e and 0x164e
 			when probing for ISA devices. This is required for the
 			following boards:
 			- VIA EPIA SN18000
@@ -70,7 +89,8 @@ scaling resistors. The values returned by the driver therefore reflect true
 millivolts and don't need scaling. The voltage inputs are mapped as follows
 (the last column indicates the input ranges):
 
-DME1737, A8000:
+DME1737, A8000::
+
 	in0: +5VTR	(+5V standby)		0V - 6.64V
 	in1: Vccp	(processor core)	0V - 3V
 	in2: VCC	(internal +3.3V)	0V - 4.38V
@@ -79,7 +99,8 @@ DME1737, A8000:
 	in5: VTR	(+3.3V standby)		0V - 4.38V
 	in6: Vbat	(+3.0V)			0V - 4.38V
 
-SCH311x:
+SCH311x::
+
 	in0: +2.5V				0V - 3.32V
 	in1: Vccp	(processor core)	0V - 2V
 	in2: VCC	(internal +3.3V)	0V - 4.38V
@@ -88,7 +109,8 @@ SCH311x:
 	in5: VTR	(+3.3V standby)		0V - 4.38V
 	in6: Vbat	(+3.0V)			0V - 4.38V
 
-SCH5027:
+SCH5027::
+
 	in0: +5VTR	(+5V standby)		0V - 6.64V
 	in1: Vccp	(processor core)	0V - 3V
 	in2: VCC	(internal +3.3V)	0V - 4.38V
@@ -97,7 +119,8 @@ SCH5027:
 	in5: VTR	(+3.3V standby)		0V - 4.38V
 	in6: Vbat	(+3.0V)			0V - 4.38V
 
-SCH5127:
+SCH5127::
+
 	in0: +2.5				0V - 3.32V
 	in1: Vccp	(processor core)	0V - 3V
 	in2: VCC	(internal +3.3V)	0V - 4.38V
@@ -119,7 +142,7 @@ Celsius. The chip also features offsets for all 3 temperature inputs which -
 when programmed - get added to the input readings. The chip does all the
 scaling by itself and the driver therefore reports true temperatures that don't
 need any user-space adjustments. The temperature inputs are mapped as follows
-(the last column indicates the input ranges):
+(the last column indicates the input ranges)::
 
 	temp1: Remote diode 1 (3904 type) temperature	-127C - +127C
 	temp2: DME1737 internal temperature		-127C - +127C
@@ -171,6 +194,7 @@ pwm[1-3]_auto_pwm_min, respectively. The thermal thresholds of the zones are
 programmed via zone[1-3]_auto_point[1-3]_temp and
 zone[1-3]_auto_point1_temp_hyst:
 
+	=============================== =======================================
 	pwm[1-3]_auto_point2_pwm	full-speed duty-cycle (255, i.e., 100%)
 	pwm[1-3]_auto_point1_pwm	low-speed duty-cycle
 	pwm[1-3]_auto_pwm_min		min-speed duty-cycle
@@ -179,6 +203,7 @@ zone[1-3]_auto_point1_temp_hyst:
 	zone[1-3]_auto_point2_temp	full-speed temp
 	zone[1-3]_auto_point1_temp	low-speed temp
 	zone[1-3]_auto_point1_temp_hyst	min-speed temp
+	=============================== =======================================
 
 The chip adjusts the output duty-cycle linearly in the range of auto_point1_pwm
 to auto_point2_pwm if the temperature of the associated zone is between
@@ -192,17 +217,21 @@ all PWM outputs are set to 100% duty-cycle.
 Following is another representation of how the chip sets the output duty-cycle
 based on the temperature of the associated thermal zone:
 
-			Duty-Cycle	Duty-Cycle
-	Temperature	Rising Temp	Falling Temp
-	-----------	-----------	------------
+	=============== =============== =================
+	Temperature	Duty-Cycle	Duty-Cycle
+			Rising Temp	Falling Temp
+	=============== =============== =================
 	full-speed	full-speed	full-speed
 
-			< linearly adjusted duty-cycle >
+	-		< linearly	-
+			adjusted
+			duty-cycle >
 
 	low-speed	low-speed	low-speed
-			min-speed	low-speed
+	-		min-speed	low-speed
 	min-speed	min-speed	min-speed
-			min-speed	min-speed
+	-		min-speed	min-speed
+	=============== =============== =================
 
 
 Sysfs Attributes
@@ -211,8 +240,9 @@ Sysfs Attributes
 Following is a list of all sysfs attributes that the driver provides, their
 permissions and a short description:
 
+=============================== ======= =======================================
 Name				Perm	Description
-----				----	-----------
+=============================== ======= =======================================
 cpu0_vid			RO	CPU core reference voltage in
 					millivolts.
 vrm				RW	Voltage regulator module version
@@ -242,9 +272,10 @@ temp[1-3]_fault			RO	Temp input fault. Returns 1 if the chip
 zone[1-3]_auto_channels_temp	RO	Temperature zone to temperature input
 					mapping. This attribute is a bitfield
 					and supports the following values:
-						1: temp1
-						2: temp2
-						4: temp3
+
+						- 1: temp1
+						- 2: temp2
+						- 4: temp3
 zone[1-3]_auto_point1_temp_hyst	RW	Auto PWM temp point1 hysteresis. The
 					output of the corresponding PWM is set
 					to the pwm_auto_min value if the temp
@@ -275,9 +306,10 @@ pmw[1-3,5-6]			RO/RW	Duty-cycle of PWM output. Supported
 					manual mode.
 pwm[1-3]_enable			RW	Enable of PWM outputs 1-3. Supported
 					values are:
-						 0: turned off (output @ 100%)
-						 1: manual mode
-						 2: automatic mode
+
+						- 0: turned off (output @ 100%)
+						- 1: manual mode
+						- 2: automatic mode
 pwm[5-6]_enable			RO	Enable of PWM outputs 5-6. Always
 					returns 1 since these 2 outputs are
 					hard-wired to manual mode.
@@ -294,11 +326,12 @@ pmw[1-3]_ramp_rate		RW	Ramp rate of PWM output. Determines how
 pwm[1-3]_auto_channels_zone	RW	PWM output to temperature zone mapping.
 					This attribute is a bitfield and
 					supports the following values:
-						1: zone1
-						2: zone2
-						4: zone3
-						6: highest of zone[2-3]
-						7: highest of zone[1-3]
+
+						- 1: zone1
+						- 2: zone2
+						- 4: zone3
+						- 6: highest of zone[2-3]
+						- 7: highest of zone[1-3]
 pwm[1-3]_auto_pwm_min		RW	Auto PWM min pwm. Minimum PWM duty-
 					cycle. Supported values are 0 or
 					auto_point1_pwm.
@@ -307,12 +340,14 @@ pwm[1-3]_auto_point1_pwm	RW	Auto PWM pwm point. Auto_point1 is the
 pwm[1-3]_auto_point2_pwm	RO	Auto PWM pwm point. Auto_point2 is the
 					full-speed duty-cycle which is hard-
 					wired to 255 (100% duty-cycle).
+=============================== ======= =======================================
 
 Chip Differences
 ----------------
 
+======================= ======= ======= ======= =======
 Feature			dme1737	sch311x	sch5027	sch5127
--------------------------------------------------------
+======================= ======= ======= ======= =======
 temp[1-3]_offset	yes	yes
 vid			yes
 zone3			yes	yes	yes
@@ -326,3 +361,4 @@ pwm5			opt		opt
 fan6			opt		opt
 pwm6			opt		opt
 in7						yes
+======================= ======= ======= ======= =======
diff --git a/Documentation/hwmon/vt1211 b/Documentation/hwmon/vt1211
index 77fa633b97a8..ddbcde7dd642 100644
--- a/Documentation/hwmon/vt1211
+++ b/Documentation/hwmon/vt1211
@@ -2,9 +2,13 @@ Kernel driver vt1211
 ====================
 
 Supported chips:
+
   * VIA VT1211
+
     Prefix: 'vt1211'
+
     Addresses scanned: none, address read from Super-I/O config space
+
     Datasheet: Provided by VIA upon request and under NDA
 
 Authors: Juerg Haefliger <juergh@gmail.com>
@@ -19,14 +23,17 @@ technical support.
 Module Parameters
 -----------------
 
-* uch_config: int	Override the BIOS default universal channel (UCH)
+
+* uch_config: int
+			Override the BIOS default universal channel (UCH)
 			configuration for channels 1-5.
 			Legal values are in the range of 0-31. Bit 0 maps to
 			UCH1, bit 1 maps to UCH2 and so on. Setting a bit to 1
 			enables the thermal input of that particular UCH and
 			setting a bit to 0 enables the voltage input.
 
-* int_mode: int		Override the BIOS default temperature interrupt mode.
+* int_mode: int
+			Override the BIOS default temperature interrupt mode.
 			The only possible value is 0 which forces interrupt
 			mode 0. In this mode, any pending interrupt is cleared
 			when the status register is read but is regenerated as
@@ -55,8 +62,9 @@ connected to the PWM outputs of the VT1211 :-().
 The following table shows the relationship between the vt1211 inputs and the
 sysfs nodes.
 
+=============== ============== =========== ================================
 Sensor          Voltage Mode   Temp Mode   Default Use (from the datasheet)
-------          ------------   ---------   --------------------------------
+=============== ============== =========== ================================
 Reading 1                      temp1       Intel thermal diode
 Reading 3                      temp2       Internal thermal diode
 UCH1/Reading2   in0            temp3       NTC type thermistor
@@ -65,6 +73,7 @@ UCH3            in2            temp5       VccP (processor core)
 UCH4            in3            temp6       +5V
 UCH5            in4            temp7       +12V
 +3.3V           in5                        Internal VCC (+3.3V)
+=============== ============== =========== ================================
 
 
 Voltage Monitoring
@@ -82,19 +91,22 @@ follows. And this is of course totally dependent on the actual board
 implementation :-) You will have to find documentation for your own
 motherboard and edit sensors.conf accordingly.
 
-                                      Expected
+============= ====== ====== ========= ============
+				      Expected
 Voltage       R1     R2     Divider   Raw Value
------------------------------------------------
+============= ====== ====== ========= ============
 +2.5V         2K     10K    1.2       2083 mV
-VccP          ---    ---    1.0       1400 mV (1)
+VccP          ---    ---    1.0       1400 mV [1]_
 +5V           14K    10K    2.4       2083 mV
 +12V          47K    10K    5.7       2105 mV
-+3.3V (int)   2K     3.4K   1.588     3300 mV (2)
++3.3V (int)   2K     3.4K   1.588     3300 mV [2]_
 +3.3V (ext)   6.8K   10K    1.68      1964 mV
+============= ====== ====== ========= ============
 
-(1) Depending on the CPU (1.4V is for a VIA C3 Nehemiah).
-(2) R1 and R2 for 3.3V (int) are internal to the VT1211 chip and the driver
-    performs the scaling and returns the properly scaled voltage value.
+.. [1] Depending on the CPU (1.4V is for a VIA C3 Nehemiah).
+
+.. [2] R1 and R2 for 3.3V (int) are internal to the VT1211 chip and the driver
+       performs the scaling and returns the properly scaled voltage value.
 
 Each measured voltage has an associated low and high limit which triggers an
 alarm when crossed.
@@ -124,35 +136,37 @@ compute temp1 (@-Offset)/Gain, (@*Gain)+Offset
 According to the VIA VT1211 BIOS porting guide, the following gain and offset
 values should be used:
 
+=============== ======== ===========
 Diode Type      Offset   Gain
-----------      ------   ----
+=============== ======== ===========
 Intel CPU       88.638   0.9528
-                65.000   0.9686   *)
+		65.000   0.9686 [3]_
 VIA C3 Ezra     83.869   0.9528
 VIA C3 Ezra-T   73.869   0.9528
+=============== ======== ===========
 
-*) This is the formula from the lm_sensors 2.10.0 sensors.conf file. I don't
-know where it comes from or how it was derived, it's just listed here for
-completeness.
+.. [3] This is the formula from the lm_sensors 2.10.0 sensors.conf file. I don't
+       know where it comes from or how it was derived, it's just listed here for
+       completeness.
 
 Temp3-temp7 support NTC thermistors. For these channels, the driver returns
 the voltages as seen at the individual pins of UCH1-UCH5. The voltage at the
 pin (Vpin) is formed by a voltage divider made of the thermistor (Rth) and a
-scaling resistor (Rs):
+scaling resistor (Rs)::
 
-Vpin = 2200 * Rth / (Rs + Rth)   (2200 is the ADC max limit of 2200 mV)
+  Vpin = 2200 * Rth / (Rs + Rth)   (2200 is the ADC max limit of 2200 mV)
 
 The equation for the thermistor is as follows (google it if you want to know
-more about it):
+more about it)::
 
-Rth = Ro * exp(B * (1 / T - 1 / To))   (To is 298.15K (25C) and Ro is the
-                                        nominal resistance at 25C)
+  Rth = Ro * exp(B * (1 / T - 1 / To))   (To is 298.15K (25C) and Ro is the
+					  nominal resistance at 25C)
 
 Mingling the above two equations and assuming Rs = Ro and B = 3435 yields the
-following formula for sensors.conf:
+following formula for sensors.conf::
 
-compute tempx 1 / (1 / 298.15 - (` (2200 / @ - 1)) / 3435) - 273.15,
-              2200 / (1 + (^ (3435 / 298.15 - 3435 / (273.15 + @))))
+  compute tempx 1 / (1 / 298.15 - (` (2200 / @ - 1)) / 3435) - 273.15,
+		2200 / (1 + (^ (3435 / 298.15 - 3435 / (273.15 + @))))
 
 
 Fan Speed Control
@@ -176,31 +190,37 @@ registers in the VT1211 and programming one set is sufficient (actually only
 the first set pwm1_auto_point[1-4]_temp is writable, the second set is
 read-only).
 
+========================== =========================================
 PWM Auto Point             PWM Output Duty-Cycle
-------------------------------------------------
+========================== =========================================
 pwm[1-2]_auto_point4_pwm   full speed duty-cycle (hard-wired to 255)
 pwm[1-2]_auto_point3_pwm   high speed duty-cycle
 pwm[1-2]_auto_point2_pwm   low speed duty-cycle
 pwm[1-2]_auto_point1_pwm   off duty-cycle (hard-wired to 0)
+========================== =========================================
 
+==========================  =================
 Temp Auto Point             Thermal Threshold
----------------------------------------------
+==========================  =================
 pwm[1-2]_auto_point4_temp   full speed temp
 pwm[1-2]_auto_point3_temp   high speed temp
 pwm[1-2]_auto_point2_temp   low speed temp
 pwm[1-2]_auto_point1_temp   off temp
+==========================  =================
 
 Long story short, the controller implements the following algorithm to set the
 PWM output duty-cycle based on the input temperature:
 
-Thermal Threshold             Output Duty-Cycle
-                    (Rising Temp)           (Falling Temp)
-----------------------------------------------------------
-                    full speed duty-cycle   full speed duty-cycle
+=================== ======================= ========================
+Thermal Threshold   Output Duty-Cycle       Output Duty-Cycle
+		    (Rising Temp)           (Falling Temp)
+=================== ======================= ========================
+-                   full speed duty-cycle   full speed duty-cycle
 full speed temp
-                    high speed duty-cycle   full speed duty-cycle
+-		    high speed duty-cycle   full speed duty-cycle
 high speed temp
-                    low speed duty-cycle    high speed duty-cycle
+-		    low speed duty-cycle    high speed duty-cycle
 low speed temp
-                    off duty-cycle          low speed duty-cycle
+-		    off duty-cycle          low speed duty-cycle
 off temp
+=================== ======================= ========================
-- 
2.20.1


^ permalink raw reply related	[flat|nested] 73+ messages in thread

* [PATCH v3 15/21] docs: hwmon: wm831x, wm8350: convert to ReST format
  2019-04-17  9:46                   ` [PATCH v3 00/21]Convert " Mauro Carvalho Chehab
                                       ` (13 preceding siblings ...)
  2019-04-17  9:46                     ` [PATCH v3 14/21] docs: hwmon: dme1737, vt1211: " Mauro Carvalho Chehab
@ 2019-04-17  9:46                     ` Mauro Carvalho Chehab
  2019-04-17  9:46                     ` [PATCH v3 16/21] docs: hwmon: da9052, da9055: " Mauro Carvalho Chehab
                                       ` (5 subsequent siblings)
  20 siblings, 0 replies; 73+ messages in thread
From: Mauro Carvalho Chehab @ 2019-04-17  9:46 UTC (permalink / raw)
  To: Linux Doc Mailing List
  Cc: Mauro Carvalho Chehab, Mauro Carvalho Chehab, linux-kernel,
	Jonathan Corbet, Jean Delvare, Guenter Roeck, linux-hwmon

Convert wm831x and wm8350 to ReST format, in order to allow
them to be parsed by Sphinx.

Signed-off-by: Mauro Carvalho Chehab <mchehab+samsung@kernel.org>
---
 Documentation/hwmon/wm831x |  9 ++++++---
 Documentation/hwmon/wm8350 | 10 +++++++---
 2 files changed, 13 insertions(+), 6 deletions(-)

diff --git a/Documentation/hwmon/wm831x b/Documentation/hwmon/wm831x
index 11446757c8c8..c56fb35a2fb3 100644
--- a/Documentation/hwmon/wm831x
+++ b/Documentation/hwmon/wm831x
@@ -3,11 +3,14 @@ Kernel driver wm831x-hwmon
 
 Supported chips:
   * Wolfson Microelectronics WM831x PMICs
+
     Prefix: 'wm831x'
+
     Datasheet:
-	http://www.wolfsonmicro.com/products/WM8310
-	http://www.wolfsonmicro.com/products/WM8311
-	http://www.wolfsonmicro.com/products/WM8312
+
+	- http://www.wolfsonmicro.com/products/WM8310
+	- http://www.wolfsonmicro.com/products/WM8311
+	- http://www.wolfsonmicro.com/products/WM8312
 
 Authors: Mark Brown <broonie@opensource.wolfsonmicro.com>
 
diff --git a/Documentation/hwmon/wm8350 b/Documentation/hwmon/wm8350
index 98f923bd2e92..cec044ca5900 100644
--- a/Documentation/hwmon/wm8350
+++ b/Documentation/hwmon/wm8350
@@ -2,12 +2,16 @@ Kernel driver wm8350-hwmon
 ==========================
 
 Supported chips:
+
   * Wolfson Microelectronics WM835x PMICs
+
     Prefix: 'wm8350'
+
     Datasheet:
-	http://www.wolfsonmicro.com/products/WM8350
-	http://www.wolfsonmicro.com/products/WM8351
-	http://www.wolfsonmicro.com/products/WM8352
+
+	- http://www.wolfsonmicro.com/products/WM8350
+	- http://www.wolfsonmicro.com/products/WM8351
+	- http://www.wolfsonmicro.com/products/WM8352
 
 Authors: Mark Brown <broonie@opensource.wolfsonmicro.com>
 
-- 
2.20.1


^ permalink raw reply related	[flat|nested] 73+ messages in thread

* [PATCH v3 16/21] docs: hwmon: da9052, da9055: convert to ReST format
  2019-04-17  9:46                   ` [PATCH v3 00/21]Convert " Mauro Carvalho Chehab
                                       ` (14 preceding siblings ...)
  2019-04-17  9:46                     ` [PATCH v3 15/21] docs: hwmon: wm831x, wm8350: " Mauro Carvalho Chehab
@ 2019-04-17  9:46                     ` Mauro Carvalho Chehab
  2019-04-17  9:46                     ` [PATCH v3 17/21] docs: hwmon: k8temp, w83793: " Mauro Carvalho Chehab
                                       ` (4 subsequent siblings)
  20 siblings, 0 replies; 73+ messages in thread
From: Mauro Carvalho Chehab @ 2019-04-17  9:46 UTC (permalink / raw)
  To: Linux Doc Mailing List
  Cc: Mauro Carvalho Chehab, Mauro Carvalho Chehab, linux-kernel,
	Jonathan Corbet, Jean Delvare, Guenter Roeck, linux-hwmon

Convert da9052 and da9055 to ReST format, in order to allow
them to be parsed by Sphinx.

Signed-off-by: Mauro Carvalho Chehab <mchehab+samsung@kernel.org>
---
 Documentation/hwmon/da9052 | 41 +++++++++++++++++++++++++++-----------
 Documentation/hwmon/da9055 | 20 ++++++++++++++-----
 2 files changed, 44 insertions(+), 17 deletions(-)

diff --git a/Documentation/hwmon/da9052 b/Documentation/hwmon/da9052
index 5bc51346b689..c1c0f1f08904 100644
--- a/Documentation/hwmon/da9052
+++ b/Documentation/hwmon/da9052
@@ -1,6 +1,12 @@
+Kernel driver da9052
+====================
+
 Supported chips:
+
   * Dialog Semiconductors DA9052-BC and DA9053-AA/Bx PMICs
+
     Prefix: 'da9052'
+
     Datasheet: Datasheet is not publicly available.
 
 Authors: David Dajun Chen <dchen@diasemi.com>
@@ -15,17 +21,20 @@ different inputs. The track and hold circuit ensures stable input voltages at
 the input of the ADC during the conversion.
 
 The ADC is used to measure the following inputs:
-Channel 0: VDDOUT - measurement of the system voltage
-Channel 1: ICH - internal battery charger current measurement
-Channel 2: TBAT - output from the battery NTC
-Channel 3: VBAT - measurement of the battery voltage
-Channel 4: ADC_IN4 - high impedance input (0 - 2.5V)
-Channel 5: ADC_IN5 - high impedance input (0 - 2.5V)
-Channel 6: ADC_IN6 - high impedance input (0 - 2.5V)
-Channel 7: XY - TSI interface to measure the X and Y voltage of the touch
-	   screen resistive potentiometers
-Channel 8: Internal Tjunc. - sense (internal temp. sensor)
-Channel 9: VBBAT - measurement of the backup battery voltage
+
+========= ===================================================================
+Channel 0 VDDOUT - measurement of the system voltage
+Channel 1 ICH - internal battery charger current measurement
+Channel 2 TBAT - output from the battery NTC
+Channel 3 VBAT - measurement of the battery voltage
+Channel 4 ADC_IN4 - high impedance input (0 - 2.5V)
+Channel 5 ADC_IN5 - high impedance input (0 - 2.5V)
+Channel 6 ADC_IN6 - high impedance input (0 - 2.5V)
+Channel 7 XY - TSI interface to measure the X and Y voltage of the touch
+	  screen resistive potentiometers
+Channel 8 Internal Tjunc. - sense (internal temp. sensor)
+Channel 9 VBBAT - measurement of the backup battery voltage
+========= ===================================================================
 
 By using sysfs attributes we can measure the system voltage VDDOUT, the battery
 charging current ICH, battery temperature TBAT, battery junction temperature
@@ -37,12 +46,15 @@ Voltage Monitoring
 Voltages are sampled by a 10 bit ADC.
 
 The battery voltage is calculated as:
+
 	Milli volt = ((ADC value * 1000) / 512) + 2500
 
 The backup battery voltage is calculated as:
+
 	Milli volt = (ADC value * 2500) / 512;
 
 The voltages on ADC channels 4, 5 and 6 are calculated as:
+
 	Milli volt = (ADC value * 2500) / 1023
 
 Temperature Monitoring
@@ -52,10 +64,15 @@ Temperatures are sampled by a 10 bit ADC.  Junction and battery temperatures
 are monitored by the ADC channels.
 
 The junction temperature is calculated:
+
 	Degrees celsius = 1.708 * (TJUNC_RES - T_OFFSET) - 108.8
+
 The junction temperature attribute is supported by the driver.
 
 The battery temperature is calculated:
-	Degree Celsius = 1 / (t1 + 1/298)- 273
+
+	Degree Celsius = 1 / (t1 + 1/298) - 273
+
 where t1 = (1/B)* ln(( ADCval * 2.5)/(R25*ITBAT*255))
+
 Default values of R25, B, ITBAT are 10e3, 3380 and 50e-6 respectively.
diff --git a/Documentation/hwmon/da9055 b/Documentation/hwmon/da9055
index 855c3f536e00..beae271a3312 100644
--- a/Documentation/hwmon/da9055
+++ b/Documentation/hwmon/da9055
@@ -1,6 +1,11 @@
+Kernel driver da9055
+====================
+
 Supported chips:
   * Dialog Semiconductors DA9055 PMIC
+
     Prefix: 'da9055'
+
     Datasheet: Datasheet is not publicly available.
 
 Authors: David Dajun Chen <dchen@diasemi.com>
@@ -15,11 +20,12 @@ different inputs. The track and hold circuit ensures stable input voltages at
 the input of the ADC during the conversion.
 
 The ADC is used to measure the following inputs:
-Channel 0: VDDOUT - measurement of the system voltage
-Channel 1: ADC_IN1 - high impedance input (0 - 2.5V)
-Channel 2: ADC_IN2 - high impedance input (0 - 2.5V)
-Channel 3: ADC_IN3 - high impedance input (0 - 2.5V)
-Channel 4: Internal Tjunc. - sense (internal temp. sensor)
+
+- Channel 0: VDDOUT - measurement of the system voltage
+- Channel 1: ADC_IN1 - high impedance input (0 - 2.5V)
+- Channel 2: ADC_IN2 - high impedance input (0 - 2.5V)
+- Channel 3: ADC_IN3 - high impedance input (0 - 2.5V)
+- Channel 4: Internal Tjunc. - sense (internal temp. sensor)
 
 By using sysfs attributes we can measure the system voltage VDDOUT,
 chip junction temperature and auxiliary channels voltages.
@@ -31,9 +37,11 @@ Voltages are sampled in a AUTO mode it can be manually sampled too and results
 are stored in a 10 bit ADC.
 
 The system voltage is calculated as:
+
 	Milli volt = ((ADC value * 1000) / 85) + 2500
 
 The voltages on ADC channels 1, 2 and 3 are calculated as:
+
 	Milli volt = (ADC value * 1000) / 102
 
 Temperature Monitoring
@@ -43,5 +51,7 @@ Temperatures are sampled by a 10 bit ADC.  Junction temperatures
 are monitored by the ADC channels.
 
 The junction temperature is calculated:
+
 	Degrees celsius = -0.4084 * (ADC_RES - T_OFFSET) + 307.6332
+
 The junction temperature attribute is supported by the driver.
-- 
2.20.1


^ permalink raw reply related	[flat|nested] 73+ messages in thread

* [PATCH v3 17/21] docs: hwmon: k8temp, w83793: convert to ReST format
  2019-04-17  9:46                   ` [PATCH v3 00/21]Convert " Mauro Carvalho Chehab
                                       ` (15 preceding siblings ...)
  2019-04-17  9:46                     ` [PATCH v3 16/21] docs: hwmon: da9052, da9055: " Mauro Carvalho Chehab
@ 2019-04-17  9:46                     ` Mauro Carvalho Chehab
  2019-04-17  9:46                     ` [PATCH v3 18/21] docs: hwmon: pmbus files: " Mauro Carvalho Chehab
                                       ` (3 subsequent siblings)
  20 siblings, 0 replies; 73+ messages in thread
From: Mauro Carvalho Chehab @ 2019-04-17  9:46 UTC (permalink / raw)
  To: Linux Doc Mailing List
  Cc: Mauro Carvalho Chehab, Mauro Carvalho Chehab, linux-kernel,
	Jonathan Corbet, Jean Delvare, Guenter Roeck, linux-hwmon

Convert k8temp and w83793 to ReST format, in order to allow them
to be parsed by Sphinx.

Signed-off-by: Mauro Carvalho Chehab <mchehab+samsung@kernel.org>
---
 Documentation/hwmon/k8temp |  17 +++--
 Documentation/hwmon/w83793 | 123 ++++++++++++++++++++-----------------
 2 files changed, 77 insertions(+), 63 deletions(-)

diff --git a/Documentation/hwmon/k8temp b/Documentation/hwmon/k8temp
index 716dc24c7237..72da12aa17e5 100644
--- a/Documentation/hwmon/k8temp
+++ b/Documentation/hwmon/k8temp
@@ -2,12 +2,17 @@ Kernel driver k8temp
 ====================
 
 Supported chips:
+
   * AMD Athlon64/FX or Opteron CPUs
+
     Prefix: 'k8temp'
+
     Addresses scanned: PCI space
+
     Datasheet: http://support.amd.com/us/Processor_TechDocs/32559.pdf
 
 Author: Rudolf Marek
+
 Contact: Rudolf Marek <r.marek@assembler.cz>
 
 Description
@@ -27,10 +32,12 @@ implemented sensors.
 
 Mapping of /sys files is as follows:
 
-temp1_input - temperature of Core 0 and "place" 0
-temp2_input - temperature of Core 0 and "place" 1
-temp3_input - temperature of Core 1 and "place" 0
-temp4_input - temperature of Core 1 and "place" 1
+============= ===================================
+temp1_input   temperature of Core 0 and "place" 0
+temp2_input   temperature of Core 0 and "place" 1
+temp3_input   temperature of Core 1 and "place" 0
+temp4_input   temperature of Core 1 and "place" 1
+============= ===================================
 
 Temperatures are measured in degrees Celsius and measurement resolution is
 1 degree C. It is expected that future CPU will have better resolution. The
@@ -48,7 +55,7 @@ computed temperature called TControl, which must be lower than TControlMax.
 
 The relationship is following:
 
-temp1_input - TjOffset*2 < TControlMax,
+	temp1_input - TjOffset*2 < TControlMax,
 
 TjOffset is not yet exported by the driver, TControlMax is usually
 70 degrees C. The rule of the thumb -> CPU temperature should not cross
diff --git a/Documentation/hwmon/w83793 b/Documentation/hwmon/w83793
index 6cc5f639b721..83bb40c48645 100644
--- a/Documentation/hwmon/w83793
+++ b/Documentation/hwmon/w83793
@@ -2,29 +2,34 @@ Kernel driver w83793
 ====================
 
 Supported chips:
+
   * Winbond W83793G/W83793R
+
     Prefix: 'w83793'
+
     Addresses scanned: I2C 0x2c - 0x2f
+
     Datasheet: Still not published
 
 Authors:
-    Yuan Mu (Winbond Electronics)
-    Rudolf Marek <r.marek@assembler.cz>
+    - Yuan Mu (Winbond Electronics)
+    - Rudolf Marek <r.marek@assembler.cz>
 
 
 Module parameters
 -----------------
 
 * reset int
-  (default 0)
-  This parameter is not recommended, it will lose motherboard specific
-  settings. Use 'reset=1' to reset the chip when loading this module.
+    (default 0)
+
+    This parameter is not recommended, it will lose motherboard specific
+    settings. Use 'reset=1' to reset the chip when loading this module.
 
 * force_subclients=bus,caddr,saddr1,saddr2
-  This is used to force the i2c addresses for subclients of
-  a certain chip. Typical usage is `force_subclients=0,0x2f,0x4a,0x4b'
-  to force the subclients of chip 0x2f on bus 0 to i2c addresses
-  0x4a and 0x4b.
+    This is used to force the i2c addresses for subclients of
+    a certain chip. Typical usage is `force_subclients=0,0x2f,0x4a,0x4b`
+    to force the subclients of chip 0x2f on bus 0 to i2c addresses
+    0x4a and 0x4b.
 
 
 Description
@@ -33,70 +38,72 @@ Description
 This driver implements support for Winbond W83793G/W83793R chips.
 
 * Exported features
-  This driver exports 10 voltage sensors, up to 12 fan tachometer inputs,
-  6 remote temperatures, up to 8 sets of PWM fan controls, SmartFan
-  (automatic fan speed control) on all temperature/PWM combinations, 2
-  sets of 6-pin CPU VID input.
+    This driver exports 10 voltage sensors, up to 12 fan tachometer inputs,
+    6 remote temperatures, up to 8 sets of PWM fan controls, SmartFan
+    (automatic fan speed control) on all temperature/PWM combinations, 2
+    sets of 6-pin CPU VID input.
 
 * Sensor resolutions
-  If your motherboard maker used the reference design, the resolution of
-  voltage0-2 is 2mV, resolution of voltage3/4/5 is 16mV, 8mV for voltage6,
-  24mV for voltage7/8. Temp1-4 have a 0.25 degree Celsius resolution,
-  temp5-6 have a 1 degree Celsiis resolution.
+    If your motherboard maker used the reference design, the resolution of
+    voltage0-2 is 2mV, resolution of voltage3/4/5 is 16mV, 8mV for voltage6,
+    24mV for voltage7/8. Temp1-4 have a 0.25 degree Celsius resolution,
+    temp5-6 have a 1 degree Celsiis resolution.
 
 * Temperature sensor types
-  Temp1-4 have 2 possible types. It can be read from (and written to)
-  temp[1-4]_type.
-  - If the value is 3, it starts monitoring using a remote termal diode
-    (default).
-  - If the value is 6, it starts monitoring using the temperature sensor
-    in Intel CPU and get result by PECI.
-  Temp5-6 can be connected to external thermistors (value of
-  temp[5-6]_type is 4).
+    Temp1-4 have 2 possible types. It can be read from (and written to)
+    temp[1-4]_type.
+
+    - If the value is 3, it starts monitoring using a remote termal diode
+      (default).
+    - If the value is 6, it starts monitoring using the temperature sensor
+      in Intel CPU and get result by PECI.
+
+    Temp5-6 can be connected to external thermistors (value of
+    temp[5-6]_type is 4).
 
 * Alarm mechanism
-  For voltage sensors, an alarm triggers if the measured value is below
-  the low voltage limit or over the high voltage limit.
-  For temperature sensors, an alarm triggers if the measured value goes
-  above the high temperature limit, and wears off only after the measured
-  value drops below the hysteresis value.
-  For fan sensors, an alarm triggers if the measured value is below the
-  low speed limit.
+    For voltage sensors, an alarm triggers if the measured value is below
+    the low voltage limit or over the high voltage limit.
+    For temperature sensors, an alarm triggers if the measured value goes
+    above the high temperature limit, and wears off only after the measured
+    value drops below the hysteresis value.
+    For fan sensors, an alarm triggers if the measured value is below the
+    low speed limit.
 
 * SmartFan/PWM control
-  If you want to set a pwm fan to manual mode, you just need to make sure it
-  is not controlled by any temp channel, for example, you want to set fan1
-  to manual mode, you need to check the value of temp[1-6]_fan_map, make
-  sure bit 0 is cleared in the 6 values. And then set the pwm1 value to
-  control the fan.
+    If you want to set a pwm fan to manual mode, you just need to make sure it
+    is not controlled by any temp channel, for example, you want to set fan1
+    to manual mode, you need to check the value of temp[1-6]_fan_map, make
+    sure bit 0 is cleared in the 6 values. And then set the pwm1 value to
+    control the fan.
 
-  Each temperature channel can control all the 8 PWM outputs (by setting the
-  corresponding bit in tempX_fan_map), you can set the temperature channel
-  mode using temp[1-6]_pwm_enable, 2 is Thermal Cruise mode and 3
-  is the SmartFanII mode. Temperature channels will try to speed up or
-  slow down all controlled fans, this means one fan can receive different
-  PWM value requests from different temperature channels, but the chip
-  will always pick the safest (max) PWM value for each fan.
+    Each temperature channel can control all the 8 PWM outputs (by setting the
+    corresponding bit in tempX_fan_map), you can set the temperature channel
+    mode using temp[1-6]_pwm_enable, 2 is Thermal Cruise mode and 3
+    is the SmartFanII mode. Temperature channels will try to speed up or
+    slow down all controlled fans, this means one fan can receive different
+    PWM value requests from different temperature channels, but the chip
+    will always pick the safest (max) PWM value for each fan.
 
-  In Thermal Cruise mode, the chip attempts to keep the temperature at a
-  predefined value, within a tolerance margin. So if tempX_input >
-  thermal_cruiseX + toleranceX, the chip will increase the PWM value,
-  if tempX_input < thermal_cruiseX - toleranceX, the chip will decrease
-  the PWM value. If the temperature is within the tolerance range, the PWM
-  value is left unchanged.
+    In Thermal Cruise mode, the chip attempts to keep the temperature at a
+    predefined value, within a tolerance margin. So if tempX_input >
+    thermal_cruiseX + toleranceX, the chip will increase the PWM value,
+    if tempX_input < thermal_cruiseX - toleranceX, the chip will decrease
+    the PWM value. If the temperature is within the tolerance range, the PWM
+    value is left unchanged.
 
-  SmartFanII works differently, you have to define up to 7 PWM, temperature
-  trip points, defining a PWM/temperature curve which the chip will follow.
-  While not fundamentally different from the Thermal Cruise mode, the
-  implementation is quite different, giving you a finer-grained control.
+    SmartFanII works differently, you have to define up to 7 PWM, temperature
+    trip points, defining a PWM/temperature curve which the chip will follow.
+    While not fundamentally different from the Thermal Cruise mode, the
+    implementation is quite different, giving you a finer-grained control.
 
 * Chassis
-  If the case open alarm triggers, it will stay in this state unless cleared
-  by writing 0 to the sysfs file "intrusion0_alarm".
+    If the case open alarm triggers, it will stay in this state unless cleared
+    by writing 0 to the sysfs file "intrusion0_alarm".
 
 * VID and VRM
-  The VRM version is detected automatically, don't modify the it unless you
-  *do* know the cpu VRM version and it's not properly detected.
+    The VRM version is detected automatically, don't modify the it unless you
+    *do* know the cpu VRM version and it's not properly detected.
 
 
 Notes
-- 
2.20.1


^ permalink raw reply related	[flat|nested] 73+ messages in thread

* [PATCH v3 18/21] docs: hwmon: pmbus files: convert to ReST format
  2019-04-17  9:46                   ` [PATCH v3 00/21]Convert " Mauro Carvalho Chehab
                                       ` (16 preceding siblings ...)
  2019-04-17  9:46                     ` [PATCH v3 17/21] docs: hwmon: k8temp, w83793: " Mauro Carvalho Chehab
@ 2019-04-17  9:46                     ` Mauro Carvalho Chehab
  2019-04-17  9:46                     ` [PATCH v3 19/21] docs: hwmon: misc " Mauro Carvalho Chehab
                                       ` (2 subsequent siblings)
  20 siblings, 0 replies; 73+ messages in thread
From: Mauro Carvalho Chehab @ 2019-04-17  9:46 UTC (permalink / raw)
  To: Linux Doc Mailing List
  Cc: Mauro Carvalho Chehab, Mauro Carvalho Chehab, linux-kernel,
	Jonathan Corbet, Jean Delvare, Guenter Roeck, linux-hwmon

Convert pmbus files to ReST format, in order to allow them to
be parsed by Sphinx.

Signed-off-by: Mauro Carvalho Chehab <mchehab+samsung@kernel.org>
---
 Documentation/hwmon/adm1275    |  26 ++++
 Documentation/hwmon/ibm-cffps  |   3 +
 Documentation/hwmon/ir35221    |  11 +-
 Documentation/hwmon/lm25066    |  30 ++++
 Documentation/hwmon/ltc2978    | 267 +++++++++++++++++++++++++--------
 Documentation/hwmon/ltc3815    |  12 +-
 Documentation/hwmon/max16064   |  15 +-
 Documentation/hwmon/max20751   |   7 +
 Documentation/hwmon/max31785   |   6 +
 Documentation/hwmon/max34440   |  88 +++++++++--
 Documentation/hwmon/max8688    |  18 ++-
 Documentation/hwmon/pmbus      |  90 +++++++----
 Documentation/hwmon/pmbus-core | 173 ++++++++++++---------
 Documentation/hwmon/tps40422   |  23 ++-
 Documentation/hwmon/ucd9000    |  31 ++--
 Documentation/hwmon/ucd9200    |  42 ++++--
 Documentation/hwmon/zl6100     |  69 ++++++++-
 17 files changed, 684 insertions(+), 227 deletions(-)

diff --git a/Documentation/hwmon/adm1275 b/Documentation/hwmon/adm1275
index 5e277b0d91ce..5c5860011d6e 100644
--- a/Documentation/hwmon/adm1275
+++ b/Documentation/hwmon/adm1275
@@ -2,29 +2,53 @@ Kernel driver adm1275
 =====================
 
 Supported chips:
+
   * Analog Devices ADM1075
+
     Prefix: 'adm1075'
+
     Addresses scanned: -
+
     Datasheet: www.analog.com/static/imported-files/data_sheets/ADM1075.pdf
+
   * Analog Devices ADM1272
+
     Prefix: 'adm1272'
+
     Addresses scanned: -
+
     Datasheet: www.analog.com/static/imported-files/data_sheets/ADM1272.pdf
+
   * Analog Devices ADM1275
+
     Prefix: 'adm1275'
+
     Addresses scanned: -
+
     Datasheet: www.analog.com/static/imported-files/data_sheets/ADM1275.pdf
+
   * Analog Devices ADM1276
+
     Prefix: 'adm1276'
+
     Addresses scanned: -
+
     Datasheet: www.analog.com/static/imported-files/data_sheets/ADM1276.pdf
+
   * Analog Devices ADM1278
+
     Prefix: 'adm1278'
+
     Addresses scanned: -
+
     Datasheet: www.analog.com/static/imported-files/data_sheets/ADM1278.pdf
+
   * Analog Devices ADM1293/ADM1294
+
     Prefix: 'adm1293', 'adm1294'
+
     Addresses scanned: -
+
     Datasheet: http://www.analog.com/media/en/technical-documentation/data-sheets/ADM1293_1294.pdf
 
 Author: Guenter Roeck <linux@roeck-us.net>
@@ -75,6 +99,7 @@ Sysfs entries
 The following attributes are supported. Limits are read-write, history reset
 attributes are write-only, all other attributes are read-only.
 
+======================= =======================================================
 inX_label		"vin1" or "vout1" depending on chip variant and
 			configuration. On ADM1075, ADM1293, and ADM1294,
 			vout1 reports the voltage on the VAUX pin.
@@ -120,3 +145,4 @@ temp1_reset_history	Write any value to reset history.
 
 			Temperature attributes are supported on ADM1272 and
 			ADM1278.
+======================= =======================================================
diff --git a/Documentation/hwmon/ibm-cffps b/Documentation/hwmon/ibm-cffps
index e05ecd8ecfcf..52e74e39463a 100644
--- a/Documentation/hwmon/ibm-cffps
+++ b/Documentation/hwmon/ibm-cffps
@@ -2,6 +2,7 @@ Kernel driver ibm-cffps
 =======================
 
 Supported chips:
+
   * IBM Common Form Factor power supply
 
 Author: Eddie James <eajames@us.ibm.com>
@@ -24,6 +25,7 @@ Sysfs entries
 
 The following attributes are supported:
 
+======================= ======================================================
 curr1_alarm		Output current over-current alarm.
 curr1_input		Measured output current in mA.
 curr1_label		"iout1"
@@ -52,3 +54,4 @@ temp2_alarm		Secondary rectifier temp over-temperature alarm.
 temp2_input		Measured secondary rectifier temp in millidegrees C.
 temp3_alarm		ORing FET temperature over-temperature alarm.
 temp3_input		Measured ORing FET temperature in millidegrees C.
+======================= ======================================================
diff --git a/Documentation/hwmon/ir35221 b/Documentation/hwmon/ir35221
index 3e82f3d93f44..a83922e5ccb5 100644
--- a/Documentation/hwmon/ir35221
+++ b/Documentation/hwmon/ir35221
@@ -3,8 +3,11 @@ Kernel driver ir35221
 
 Supported chips:
   * Infineon IR35221
+
     Prefix: 'ir35221'
+
     Addresses scanned: -
+
     Datasheet: Datasheet is not publicly available.
 
 Author: Samuel Mendoza-Jonas <sam@mendozajonas.com>
@@ -23,15 +26,16 @@ This driver does not probe for PMBus devices. You will have to instantiate
 devices explicitly.
 
 Example: the following commands will load the driver for an IR35221
-at address 0x70 on I2C bus #4:
+at address 0x70 on I2C bus #4::
 
-# modprobe ir35221
-# echo ir35221 0x70 > /sys/bus/i2c/devices/i2c-4/new_device
+	# modprobe ir35221
+	# echo ir35221 0x70 > /sys/bus/i2c/devices/i2c-4/new_device
 
 
 Sysfs attributes
 ----------------
 
+======================= =======================================================
 curr1_label		"iin"
 curr1_input		Measured input current
 curr1_max		Maximum current
@@ -85,3 +89,4 @@ temp[1-2]_highest	Highest temperature
 temp[1-2]_lowest	Lowest temperature
 temp[1-2]_max		Maximum temperature
 temp[1-2]_max_alarm	Chip temperature high alarm
+======================= =======================================================
diff --git a/Documentation/hwmon/lm25066 b/Documentation/hwmon/lm25066
index 51b32aa203a8..60b7f2722931 100644
--- a/Documentation/hwmon/lm25066
+++ b/Documentation/hwmon/lm25066
@@ -2,34 +2,62 @@ Kernel driver lm25066
 =====================
 
 Supported chips:
+
   * TI LM25056
+
     Prefix: 'lm25056'
+
     Addresses scanned: -
+
     Datasheets:
+
 	http://www.ti.com/lit/gpn/lm25056
+
 	http://www.ti.com/lit/gpn/lm25056a
+
   * National Semiconductor LM25066
+
     Prefix: 'lm25066'
+
     Addresses scanned: -
+
     Datasheets:
+
 	http://www.national.com/pf/LM/LM25066.html
+
 	http://www.national.com/pf/LM/LM25066A.html
+
   * National Semiconductor LM5064
+
     Prefix: 'lm5064'
+
     Addresses scanned: -
+
     Datasheet:
+
 	http://www.national.com/pf/LM/LM5064.html
+
   * National Semiconductor LM5066
+
     Prefix: 'lm5066'
+
     Addresses scanned: -
+
     Datasheet:
+
 	http://www.national.com/pf/LM/LM5066.html
+
   * Texas Instruments LM5066I
+
     Prefix: 'lm5066i'
+
     Addresses scanned: -
+
 	Datasheet:
+
     http://www.ti.com/product/LM5066I
 
+
 Author: Guenter Roeck <linux@roeck-us.net>
 
 
@@ -64,6 +92,7 @@ Sysfs entries
 The following attributes are supported. Limits are read-write; all other
 attributes are read-only.
 
+======================= =======================================================
 in1_label		"vin"
 in1_input		Measured input voltage.
 in1_average		Average measured input voltage.
@@ -105,3 +134,4 @@ temp1_max		Maximum temperature.
 temp1_crit		Critical high temperature.
 temp1_max_alarm		Chip temperature high alarm.
 temp1_crit_alarm	Chip temperature critical high alarm.
+======================= =======================================================
diff --git a/Documentation/hwmon/ltc2978 b/Documentation/hwmon/ltc2978
index dfb2caa401d9..01a24fd6d5fe 100644
--- a/Documentation/hwmon/ltc2978
+++ b/Documentation/hwmon/ltc2978
@@ -2,85 +2,143 @@ Kernel driver ltc2978
 =====================
 
 Supported chips:
+
   * Linear Technology LTC2974
+
     Prefix: 'ltc2974'
+
     Addresses scanned: -
+
     Datasheet: http://www.linear.com/product/ltc2974
+
   * Linear Technology LTC2975
+
     Prefix: 'ltc2975'
+
     Addresses scanned: -
+
     Datasheet: http://www.linear.com/product/ltc2975
+
   * Linear Technology LTC2977
+
     Prefix: 'ltc2977'
+
     Addresses scanned: -
+
     Datasheet: http://www.linear.com/product/ltc2977
+
   * Linear Technology LTC2978, LTC2978A
+
     Prefix: 'ltc2978'
+
     Addresses scanned: -
+
     Datasheet: http://www.linear.com/product/ltc2978
-    	       http://www.linear.com/product/ltc2978a
+
+	       http://www.linear.com/product/ltc2978a
+
   * Linear Technology LTC2980
+
     Prefix: 'ltc2980'
+
     Addresses scanned: -
+
     Datasheet: http://www.linear.com/product/ltc2980
+
   * Linear Technology LTC3880
+
     Prefix: 'ltc3880'
+
     Addresses scanned: -
+
     Datasheet: http://www.linear.com/product/ltc3880
+
   * Linear Technology LTC3882
+
     Prefix: 'ltc3882'
+
     Addresses scanned: -
+
     Datasheet: http://www.linear.com/product/ltc3882
+
   * Linear Technology LTC3883
+
     Prefix: 'ltc3883'
+
     Addresses scanned: -
+
     Datasheet: http://www.linear.com/product/ltc3883
+
   * Linear Technology LTC3886
+
     Prefix: 'ltc3886'
+
     Addresses scanned: -
+
     Datasheet: http://www.linear.com/product/ltc3886
+
   * Linear Technology LTC3887
+
     Prefix: 'ltc3887'
+
     Addresses scanned: -
+
     Datasheet: http://www.linear.com/product/ltc3887
+
   * Linear Technology LTM2987
+
     Prefix: 'ltm2987'
+
     Addresses scanned: -
+
     Datasheet: http://www.linear.com/product/ltm2987
+
   * Linear Technology LTM4675
+
     Prefix: 'ltm4675'
+
     Addresses scanned: -
+
     Datasheet: http://www.linear.com/product/ltm4675
+
   * Linear Technology LTM4676
+
     Prefix: 'ltm4676'
+
     Addresses scanned: -
+
     Datasheet: http://www.linear.com/product/ltm4676
+
   * Analog Devices LTM4686
+
     Prefix: 'ltm4686'
+
     Addresses scanned: -
+
     Datasheet: http://www.analog.com/ltm4686
 
+
 Author: Guenter Roeck <linux@roeck-us.net>
 
 
 Description
 -----------
 
-LTC2974 and LTC2975 are quad digital power supply managers.
-LTC2978 is an octal power supply monitor.
-LTC2977 is a pin compatible replacement for LTC2978.
-LTC2980 is a 16-channel Power System Manager, consisting of two LTC2977
-in a single die. The chip is instantiated and reported as two separate chips
-on two different I2C bus addresses.
-LTC3880, LTC3882, LTC3886, and LTC3887 are dual output poly-phase step-down
-DC/DC controllers.
-LTC3883 is a single phase step-down DC/DC controller.
-LTM2987 is a 16-channel Power System Manager with two LTC2977 plus
-additional components on a single die. The chip is instantiated and reported
-as two separate chips on two different I2C bus addresses.
-LTM4675 is a dual 9A or single 18A μModule regulator
-LTM4676 is a dual 13A or single 26A uModule regulator.
-LTM4686 is a dual 10A or single 20A uModule regulator.
+- LTC2974 and LTC2975 are quad digital power supply managers.
+- LTC2978 is an octal power supply monitor.
+- LTC2977 is a pin compatible replacement for LTC2978.
+- LTC2980 is a 16-channel Power System Manager, consisting of two LTC2977
+- in a single die. The chip is instantiated and reported as two separate chips
+- on two different I2C bus addresses.
+- LTC3880, LTC3882, LTC3886, and LTC3887 are dual output poly-phase step-down
+- DC/DC controllers.
+- LTC3883 is a single phase step-down DC/DC controller.
+- LTM2987 is a 16-channel Power System Manager with two LTC2977 plus
+- additional components on a single die. The chip is instantiated and reported
+- as two separate chips on two different I2C bus addresses.
+- LTM4675 is a dual 9A or single 18A μModule regulator
+- LTM4676 is a dual 13A or single 26A uModule regulator.
+- LTM4686 is a dual 10A or single 20A uModule regulator.
 
 
 Usage Notes
@@ -90,127 +148,208 @@ This driver does not probe for PMBus devices. You will have to instantiate
 devices explicitly.
 
 Example: the following commands will load the driver for an LTC2978 at address
-0x60 on I2C bus #1:
+0x60 on I2C bus #1::
 
-# modprobe ltc2978
-# echo ltc2978 0x60 > /sys/bus/i2c/devices/i2c-1/new_device
+	# modprobe ltc2978
+	# echo ltc2978 0x60 > /sys/bus/i2c/devices/i2c-1/new_device
 
 
 Sysfs attributes
 ----------------
 
+======================= ========================================================
 in1_label		"vin"
+
 in1_input		Measured input voltage.
+
 in1_min			Minimum input voltage.
+
 in1_max			Maximum input voltage.
+
 			LTC2974, LTC2975, LTC2977, LTC2980, LTC2978, and
 			LTM2987 only.
+
 in1_lcrit		Critical minimum input voltage.
+
 			LTC2974, LTC2975, LTC2977, LTC2980, LTC2978, and
 			LTM2987 only.
+
 in1_crit		Critical maximum input voltage.
+
 in1_min_alarm		Input voltage low alarm.
+
 in1_max_alarm		Input voltage high alarm.
+
 			LTC2974, LTC2975, LTC2977, LTC2980, LTC2978, and
 			LTM2987 only.
 in1_lcrit_alarm		Input voltage critical low alarm.
+
 			LTC2974, LTC2975, LTC2977, LTC2980, LTC2978, and
 			LTM2987 only.
 in1_crit_alarm		Input voltage critical high alarm.
+
 in1_lowest		Lowest input voltage.
+
 			LTC2974, LTC2975, LTC2977, LTC2980, LTC2978, and
 			LTM2987 only.
 in1_highest		Highest input voltage.
+
 in1_reset_history	Reset input voltage history.
 
 in[N]_label		"vout[1-8]".
-			LTC2974, LTC2975: N=2-5
-			LTC2977, LTC2980, LTM2987: N=2-9
-			LTC2978: N=2-9
-			LTC3880, LTC3882, LTC23886 LTC3887, LTM4675, LTM4676:
-				N=2-3
-			LTC3883: N=2
+
+			- LTC2974, LTC2975: N=2-5
+			- LTC2977, LTC2980, LTM2987: N=2-9
+			- LTC2978: N=2-9
+			- LTC3880, LTC3882, LTC23886 LTC3887, LTM4675, LTM4676:
+			  N=2-3
+			- LTC3883: N=2
+
 in[N]_input		Measured output voltage.
+
 in[N]_min		Minimum output voltage.
+
 in[N]_max		Maximum output voltage.
+
 in[N]_lcrit		Critical minimum output voltage.
+
 in[N]_crit		Critical maximum output voltage.
+
 in[N]_min_alarm		Output voltage low alarm.
+
 in[N]_max_alarm		Output voltage high alarm.
+
 in[N]_lcrit_alarm	Output voltage critical low alarm.
+
 in[N]_crit_alarm	Output voltage critical high alarm.
-in[N]_lowest		Lowest output voltage. LTC2974, LTC2975,
-			and LTC2978 only.
+
+in[N]_lowest		Lowest output voltage.
+
+
+			LTC2974, LTC2975,and LTC2978 only.
+
 in[N]_highest		Highest output voltage.
+
 in[N]_reset_history	Reset output voltage history.
 
 temp[N]_input		Measured temperature.
-			On LTC2974 and LTC2975, temp[1-4] report external
-			temperatures, and temp5 reports the chip temperature.
-			On LTC2977, LTC2980, LTC2978, and LTM2987, only one
-			temperature measurement is supported and reports
-			the chip temperature.
-			On LTC3880, LTC3882, LTC3887, LTM4675, and LTM4676,
-			temp1 and temp2 report external temperatures, and temp3
-			reports the chip temperature.
-			On LTC3883, temp1 reports an external temperature,
-			and temp2 reports the chip temperature.
-temp[N]_min		Mimimum temperature. LTC2974, LCT2977, LTM2980, LTC2978,
-			and LTM2987 only.
+
+			- On LTC2974 and LTC2975, temp[1-4] report external
+			  temperatures, and temp5 reports the chip temperature.
+			- On LTC2977, LTC2980, LTC2978, and LTM2987, only one
+			  temperature measurement is supported and reports
+			  the chip temperature.
+			- On LTC3880, LTC3882, LTC3887, LTM4675, and LTM4676,
+			  temp1 and temp2 report external temperatures, and
+			  temp3 reports the chip temperature.
+			- On LTC3883, temp1 reports an external temperature,
+			  and temp2 reports the chip temperature.
+
+temp[N]_min		Mimimum temperature.
+
+			LTC2974, LCT2977, LTM2980, LTC2978, and LTM2987 only.
+
 temp[N]_max		Maximum temperature.
+
 temp[N]_lcrit		Critical low temperature.
+
 temp[N]_crit		Critical high temperature.
+
 temp[N]_min_alarm	Temperature low alarm.
+
 			LTC2974, LTC2975, LTC2977, LTM2980, LTC2978, and
 			LTM2987 only.
+
 temp[N]_max_alarm	Temperature high alarm.
+
+
 temp[N]_lcrit_alarm	Temperature critical low alarm.
+
 temp[N]_crit_alarm	Temperature critical high alarm.
+
 temp[N]_lowest		Lowest measured temperature.
-			LTC2974, LTC2975, LTC2977, LTM2980, LTC2978, and
-			LTM2987 only.
-			Not supported for chip temperature sensor on LTC2974 and
-			LTC2975.
-temp[N]_highest		Highest measured temperature. Not supported for chip
-			temperature sensor on LTC2974 and LTC2975.
-temp[N]_reset_history	Reset temperature history. Not supported for chip
-			temperature sensor on LTC2974 and LTC2975.
+
+			- LTC2974, LTC2975, LTC2977, LTM2980, LTC2978, and
+			  LTM2987 only.
+			- Not supported for chip temperature sensor on LTC2974
+			  and LTC2975.
+
+temp[N]_highest		Highest measured temperature.
+
+			Not supported for chip temperature sensor on
+			LTC2974 and LTC2975.
+
+temp[N]_reset_history	Reset temperature history.
+
+			Not supported for chip temperature sensor on
+			LTC2974 and LTC2975.
 
 power1_label		"pin". LTC3883 and LTC3886 only.
+
 power1_input		Measured input power.
 
 power[N]_label		"pout[1-4]".
-			LTC2974, LTC2975: N=1-4
-			LTC2977, LTC2980, LTM2987: Not supported
-			LTC2978: Not supported
-			LTC3880, LTC3882, LTC3886, LTC3887, LTM4675, LTM4676:
-				N=1-2
-			LTC3883: N=2
+
+			- LTC2974, LTC2975: N=1-4
+			- LTC2977, LTC2980, LTM2987: Not supported
+			- LTC2978: Not supported
+			- LTC3880, LTC3882, LTC3886, LTC3887, LTM4675, LTM4676:
+			  N=1-2
+			- LTC3883: N=2
+
 power[N]_input		Measured output power.
 
-curr1_label		"iin". LTC3880, LTC3883, LTC3886, LTC3887, LTM4675,
+curr1_label		"iin".
+
+			LTC3880, LTC3883, LTC3886, LTC3887, LTM4675,
 			and LTM4676 only.
+
 curr1_input		Measured input current.
+
 curr1_max		Maximum input current.
+
 curr1_max_alarm		Input current high alarm.
-curr1_highest		Highest input current. LTC3883 and LTC3886 only.
-curr1_reset_history	Reset input current history. LTC3883 and LTC3886 only.
+
+curr1_highest		Highest input current.
+
+			LTC3883 and LTC3886 only.
+
+curr1_reset_history	Reset input current history.
+
+			LTC3883 and LTC3886 only.
 
 curr[N]_label		"iout[1-4]".
-			LTC2974, LTC2975: N=1-4
-			LTC2977, LTC2980, LTM2987: not supported
-			LTC2978: not supported
-			LTC3880, LTC3882, LTC3886, LTC3887, LTM4675, LTM4676:
-				N=2-3
-			LTC3883: N=2
+
+			- LTC2974, LTC2975: N=1-4
+			- LTC2977, LTC2980, LTM2987: not supported
+			- LTC2978: not supported
+			- LTC3880, LTC3882, LTC3886, LTC3887, LTM4675, LTM4676:
+			  N=2-3
+			- LTC3883: N=2
+
 curr[N]_input		Measured output current.
+
 curr[N]_max		Maximum output current.
+
 curr[N]_crit		Critical high output current.
-curr[N]_lcrit		Critical low output current. LTC2974 and LTC2975 only.
+
+curr[N]_lcrit		Critical low output current.
+
+			LTC2974 and LTC2975 only.
+
 curr[N]_max_alarm	Output current high alarm.
+
 curr[N]_crit_alarm	Output current critical high alarm.
+
 curr[N]_lcrit_alarm	Output current critical low alarm.
+
 			LTC2974 and LTC2975 only.
-curr[N]_lowest		Lowest output current. LTC2974 and LTC2975 only.
+
+curr[N]_lowest		Lowest output current.
+
+			LTC2974 and LTC2975 only.
+
 curr[N]_highest		Highest output current.
+
 curr[N]_reset_history	Reset output current history.
+======================= ========================================================
diff --git a/Documentation/hwmon/ltc3815 b/Documentation/hwmon/ltc3815
index eb7db2d13587..fb0135fc1925 100644
--- a/Documentation/hwmon/ltc3815
+++ b/Documentation/hwmon/ltc3815
@@ -2,9 +2,13 @@ Kernel driver ltc3815
 =====================
 
 Supported chips:
+
   * Linear Technology LTC3815
+
     Prefix: 'ltc3815'
+
     Addresses scanned: -
+
     Datasheet: http://www.linear.com/product/ltc3815
 
 Author: Guenter Roeck <linux@roeck-us.net>
@@ -23,15 +27,16 @@ This driver does not probe for PMBus devices. You will have to instantiate
 devices explicitly.
 
 Example: the following commands will load the driver for an LTC3815
-at address 0x20 on I2C bus #1:
+at address 0x20 on I2C bus #1::
 
-# modprobe ltc3815
-# echo ltc3815 0x20 > /sys/bus/i2c/devices/i2c-1/new_device
+	# modprobe ltc3815
+	# echo ltc3815 0x20 > /sys/bus/i2c/devices/i2c-1/new_device
 
 
 Sysfs attributes
 ----------------
 
+======================= =======================================================
 in1_label		"vin"
 in1_input		Measured input voltage.
 in1_alarm		Input voltage alarm.
@@ -59,3 +64,4 @@ curr2_input		Measured output current.
 curr2_alarm		Output current alarm.
 curr2_highest		Highest output current.
 curr2_reset_history	Reset output current history.
+======================= =======================================================
diff --git a/Documentation/hwmon/max16064 b/Documentation/hwmon/max16064
index 265370f5cb82..61ec679dc477 100644
--- a/Documentation/hwmon/max16064
+++ b/Documentation/hwmon/max16064
@@ -2,9 +2,13 @@ Kernel driver max16064
 ======================
 
 Supported chips:
+
   * Maxim MAX16064
+
     Prefix: 'max16064'
+
     Addresses scanned: -
+
     Datasheet: http://datasheets.maxim-ic.com/en/ds/MAX16064.pdf
 
 Author: Guenter Roeck <linux@roeck-us.net>
@@ -40,16 +44,20 @@ Sysfs entries
 The following attributes are supported. Limits are read-write; all other
 attributes are read-only.
 
+======================= ========================================================
 in[1-4]_label		"vout[1-4]"
 in[1-4]_input		Measured voltage. From READ_VOUT register.
 in[1-4]_min		Minimum Voltage. From VOUT_UV_WARN_LIMIT register.
 in[1-4]_max		Maximum voltage. From VOUT_OV_WARN_LIMIT register.
 in[1-4]_lcrit		Critical minimum Voltage. VOUT_UV_FAULT_LIMIT register.
-in[1-4]_crit		Critical maximum voltage. From VOUT_OV_FAULT_LIMIT register.
+in[1-4]_crit		Critical maximum voltage. From VOUT_OV_FAULT_LIMIT
+			register.
 in[1-4]_min_alarm	Voltage low alarm. From VOLTAGE_UV_WARNING status.
 in[1-4]_max_alarm	Voltage high alarm. From VOLTAGE_OV_WARNING status.
-in[1-4]_lcrit_alarm	Voltage critical low alarm. From VOLTAGE_UV_FAULT status.
-in[1-4]_crit_alarm	Voltage critical high alarm. From VOLTAGE_OV_FAULT status.
+in[1-4]_lcrit_alarm	Voltage critical low alarm. From VOLTAGE_UV_FAULT
+			status.
+in[1-4]_crit_alarm	Voltage critical high alarm. From VOLTAGE_OV_FAULT
+			status.
 in[1-4]_highest		Historical maximum voltage.
 in[1-4]_reset_history	Write any value to reset history.
 
@@ -64,3 +72,4 @@ temp1_crit_alarm	Chip temperature critical high alarm. Set by comparing
 			status is set.
 temp1_highest		Historical maximum temperature.
 temp1_reset_history	Write any value to reset history.
+======================= ========================================================
diff --git a/Documentation/hwmon/max20751 b/Documentation/hwmon/max20751
index f9fa25ebb521..d546695900ef 100644
--- a/Documentation/hwmon/max20751
+++ b/Documentation/hwmon/max20751
@@ -2,10 +2,15 @@ Kernel driver max20751
 ======================
 
 Supported chips:
+
   * maxim MAX20751
+
     Prefix: 'max20751'
+
     Addresses scanned: -
+
     Datasheet: http://datasheets.maximintegrated.com/en/ds/MAX20751.pdf
+
     Application note: http://pdfserv.maximintegrated.com/en/an/AN5941.pdf
 
 Author: Guenter Roeck <linux@roeck-us.net>
@@ -40,6 +45,7 @@ Sysfs entries
 
 The following attributes are supported.
 
+======================= =======================================================
 in1_label		"vin1"
 in1_input		Measured voltage.
 in1_min			Minimum input voltage.
@@ -75,3 +81,4 @@ temp1_crit_alarm	Chip temperature critical high alarm.
 
 power1_input		Output power.
 power1_label		"pout1"
+======================= =======================================================
diff --git a/Documentation/hwmon/max31785 b/Documentation/hwmon/max31785
index 270c5f865261..c8c6756d0ee1 100644
--- a/Documentation/hwmon/max31785
+++ b/Documentation/hwmon/max31785
@@ -2,9 +2,13 @@ Kernel driver max31785
 ======================
 
 Supported chips:
+
   * Maxim MAX31785, MAX31785A
+
     Prefix: 'max31785' or 'max31785a'
+
     Addresses scanned: -
+
     Datasheet: https://datasheets.maximintegrated.com/en/ds/MAX31785.pdf
 
 Author: Andrew Jeffery <andrew@aj.id.au>
@@ -30,6 +34,7 @@ devices explicitly.
 Sysfs attributes
 ----------------
 
+======================= =======================================================
 fan[1-4]_alarm		Fan alarm.
 fan[1-4]_fault		Fan fault.
 fan[1-8]_input		Fan RPM. On the MAX31785A, inputs 5-8 correspond to the
@@ -58,3 +63,4 @@ temp[1-11]_crit_alarm	Chip temperature critical high alarm
 temp[1-11]_input	Measured temperature
 temp[1-11]_max		Maximum temperature
 temp[1-11]_max_alarm	Chip temperature high alarm
+======================= =======================================================
diff --git a/Documentation/hwmon/max34440 b/Documentation/hwmon/max34440
index b2de8fa49273..639838ef29fd 100644
--- a/Documentation/hwmon/max34440
+++ b/Documentation/hwmon/max34440
@@ -2,34 +2,63 @@ Kernel driver max34440
 ======================
 
 Supported chips:
+
   * Maxim MAX34440
+
     Prefixes: 'max34440'
+
     Addresses scanned: -
+
     Datasheet: http://datasheets.maximintegrated.com/en/ds/MAX34440.pdf
+
   * Maxim MAX34441
+
     PMBus 5-Channel Power-Supply Manager and Intelligent Fan Controller
+
     Prefixes: 'max34441'
+
     Addresses scanned: -
+
     Datasheet: http://datasheets.maximintegrated.com/en/ds/MAX34441.pdf
+
   * Maxim MAX34446
+
     PMBus Power-Supply Data Logger
+
     Prefixes: 'max34446'
+
     Addresses scanned: -
+
     Datasheet: http://datasheets.maximintegrated.com/en/ds/MAX34446.pdf
+
   * Maxim MAX34451
+
     PMBus 16-Channel V/I Monitor and 12-Channel Sequencer/Marginer
+
     Prefixes: 'max34451'
+
     Addresses scanned: -
+
     Datasheet: http://datasheets.maximintegrated.com/en/ds/MAX34451.pdf
+
   * Maxim MAX34460
+
     PMBus 12-Channel Voltage Monitor & Sequencer
+
     Prefix: 'max34460'
+
     Addresses scanned: -
+
     Datasheet: http://datasheets.maximintegrated.com/en/ds/MAX34460.pdf
+
   * Maxim MAX34461
+
     PMBus 16-Channel Voltage Monitor & Sequencer
+
     Prefix: 'max34461'
+
     Addresses scanned: -
+
     Datasheet: http://datasheets.maximintegrated.com/en/ds/MAX34461.pdf
 
 Author: Guenter Roeck <linux@roeck-us.net>
@@ -77,42 +106,67 @@ Sysfs entries
 The following attributes are supported. Limits are read-write; all other
 attributes are read-only.
 
+In
+~~
+
+======================= =======================================================
 in[1-6]_label		"vout[1-6]".
 in[1-6]_input		Measured voltage. From READ_VOUT register.
 in[1-6]_min		Minimum Voltage. From VOUT_UV_WARN_LIMIT register.
 in[1-6]_max		Maximum voltage. From VOUT_OV_WARN_LIMIT register.
 in[1-6]_lcrit		Critical minimum Voltage. VOUT_UV_FAULT_LIMIT register.
-in[1-6]_crit		Critical maximum voltage. From VOUT_OV_FAULT_LIMIT register.
+in[1-6]_crit		Critical maximum voltage. From VOUT_OV_FAULT_LIMIT
+			register.
 in[1-6]_min_alarm	Voltage low alarm. From VOLTAGE_UV_WARNING status.
 in[1-6]_max_alarm	Voltage high alarm. From VOLTAGE_OV_WARNING status.
-in[1-6]_lcrit_alarm	Voltage critical low alarm. From VOLTAGE_UV_FAULT status.
-in[1-6]_crit_alarm	Voltage critical high alarm. From VOLTAGE_OV_FAULT status.
+in[1-6]_lcrit_alarm	Voltage critical low alarm. From VOLTAGE_UV_FAULT
+			status.
+in[1-6]_crit_alarm	Voltage critical high alarm. From VOLTAGE_OV_FAULT
+			status.
 in[1-6]_lowest		Historical minimum voltage.
 in[1-6]_highest		Historical maximum voltage.
 in[1-6]_reset_history	Write any value to reset history.
+======================= =======================================================
 
-			MAX34446 only supports in[1-4].
+.. note:: MAX34446 only supports in[1-4].
 
+Curr
+~~~~
+
+======================= ========================================================
 curr[1-6]_label		"iout[1-6]".
 curr[1-6]_input		Measured current. From READ_IOUT register.
 curr[1-6]_max		Maximum current. From IOUT_OC_WARN_LIMIT register.
-curr[1-6]_crit		Critical maximum current. From IOUT_OC_FAULT_LIMIT register.
+curr[1-6]_crit		Critical maximum current. From IOUT_OC_FAULT_LIMIT
+			register.
 curr[1-6]_max_alarm	Current high alarm. From IOUT_OC_WARNING status.
 curr[1-6]_crit_alarm	Current critical high alarm. From IOUT_OC_FAULT status.
 curr[1-4]_average	Historical average current (MAX34446/34451 only).
 curr[1-6]_highest	Historical maximum current.
 curr[1-6]_reset_history	Write any value to reset history.
+======================= ========================================================
 
-			in6 and curr6 attributes only exist for MAX34440.
-			MAX34446 only supports curr[1-4].
+.. note::
 
+    - in6 and curr6 attributes only exist for MAX34440.
+    - MAX34446 only supports curr[1-4].
+
+Power
+~~~~~
+
+======================= ========================================================
 power[1,3]_label	"pout[1,3]"
 power[1,3]_input	Measured power.
 power[1,3]_average	Historical average power.
 power[1,3]_highest	Historical maximum power.
+======================= ========================================================
 
-			Power attributes only exist for MAX34446.
+.. note:: Power attributes only exist for MAX34446.
 
+Temp
+~~~~
+
+======================= ========================================================
 temp[1-8]_input		Measured temperatures. From READ_TEMPERATURE_1 register.
 			temp1 is the chip's internal temperature. temp2..temp5
 			are remote I2C temperature sensors. For MAX34441, temp6
@@ -125,11 +179,17 @@ temp[1-8]_crit_alarm	Temperature critical high alarm.
 temp[1-8]_average	Historical average temperature (MAX34446 only).
 temp[1-8]_highest	Historical maximum temperature.
 temp[1-8]_reset_history	Write any value to reset history.
+======================= ========================================================
 
-			temp7 and temp8 attributes only exist for MAX34440.
-			MAX34446 only supports temp[1-3].
 
-MAX34451 supports attribute groups in[1-16] (or curr[1-16] based on input pins)
-and temp[1-5].
-MAX34460 supports attribute groups in[1-12] and temp[1-5].
-MAX34461 supports attribute groups in[1-16] and temp[1-5].
+.. note::
+   - temp7 and temp8 attributes only exist for MAX34440.
+   - MAX34446 only supports temp[1-3].
+
+
+.. note::
+
+   - MAX34451 supports attribute groups in[1-16] (or curr[1-16] based on
+     input pins) and temp[1-5].
+   - MAX34460 supports attribute groups in[1-12] and temp[1-5].
+   - MAX34461 supports attribute groups in[1-16] and temp[1-5].
diff --git a/Documentation/hwmon/max8688 b/Documentation/hwmon/max8688
index ca233bec7a8a..43da139234c1 100644
--- a/Documentation/hwmon/max8688
+++ b/Documentation/hwmon/max8688
@@ -2,9 +2,13 @@ Kernel driver max8688
 =====================
 
 Supported chips:
+
   * Maxim MAX8688
+
     Prefix: 'max8688'
+
     Addresses scanned: -
+
     Datasheet: http://datasheets.maxim-ic.com/en/ds/MAX8688.pdf
 
 Author: Guenter Roeck <linux@roeck-us.net>
@@ -40,23 +44,28 @@ Sysfs entries
 The following attributes are supported. Limits are read-write; all other
 attributes are read-only.
 
+======================= ========================================================
 in1_label		"vout1"
 in1_input		Measured voltage. From READ_VOUT register.
 in1_min			Minimum Voltage. From VOUT_UV_WARN_LIMIT register.
 in1_max			Maximum voltage. From VOUT_OV_WARN_LIMIT register.
 in1_lcrit		Critical minimum Voltage. VOUT_UV_FAULT_LIMIT register.
-in1_crit		Critical maximum voltage. From VOUT_OV_FAULT_LIMIT register.
+in1_crit		Critical maximum voltage. From VOUT_OV_FAULT_LIMIT
+			register.
 in1_min_alarm		Voltage low alarm. From VOLTAGE_UV_WARNING status.
 in1_max_alarm		Voltage high alarm. From VOLTAGE_OV_WARNING status.
-in1_lcrit_alarm		Voltage critical low alarm. From VOLTAGE_UV_FAULT status.
-in1_crit_alarm		Voltage critical high alarm. From VOLTAGE_OV_FAULT status.
+in1_lcrit_alarm		Voltage critical low alarm. From VOLTAGE_UV_FAULT
+			status.
+in1_crit_alarm		Voltage critical high alarm. From VOLTAGE_OV_FAULT
+			status.
 in1_highest		Historical maximum voltage.
 in1_reset_history	Write any value to reset history.
 
 curr1_label		"iout1"
 curr1_input		Measured current. From READ_IOUT register.
 curr1_max		Maximum current. From IOUT_OC_WARN_LIMIT register.
-curr1_crit		Critical maximum current. From IOUT_OC_FAULT_LIMIT register.
+curr1_crit		Critical maximum current. From IOUT_OC_FAULT_LIMIT
+			register.
 curr1_max_alarm		Current high alarm. From IOUT_OC_WARN_LIMIT register.
 curr1_crit_alarm	Current critical high alarm. From IOUT_OC_FAULT status.
 curr1_highest		Historical maximum current.
@@ -73,3 +82,4 @@ temp1_crit_alarm	Chip temperature critical high alarm. Set by comparing
 			status is set.
 temp1_highest		Historical maximum temperature.
 temp1_reset_history	Write any value to reset history.
+======================= ========================================================
diff --git a/Documentation/hwmon/pmbus b/Documentation/hwmon/pmbus
index dfd9c65996c0..abfb9dd4857d 100644
--- a/Documentation/hwmon/pmbus
+++ b/Documentation/hwmon/pmbus
@@ -1,42 +1,77 @@
 Kernel driver pmbus
-====================
+===================
 
 Supported chips:
+
   * Ericsson BMR453, BMR454
+
     Prefixes: 'bmr453', 'bmr454'
+
     Addresses scanned: -
+
     Datasheet:
+
  http://archive.ericsson.net/service/internet/picov/get?DocNo=28701-EN/LZT146395
+
   * ON Semiconductor ADP4000, NCP4200, NCP4208
+
     Prefixes: 'adp4000', 'ncp4200', 'ncp4208'
+
     Addresses scanned: -
+
     Datasheets:
+
 	http://www.onsemi.com/pub_link/Collateral/ADP4000-D.PDF
+
 	http://www.onsemi.com/pub_link/Collateral/NCP4200-D.PDF
+
 	http://www.onsemi.com/pub_link/Collateral/JUNE%202009-%20REV.%200.PDF
+
   * Lineage Power
+
     Prefixes: 'mdt040', 'pdt003', 'pdt006', 'pdt012', 'udt020'
+
     Addresses scanned: -
+
     Datasheets:
+
 	http://www.lineagepower.com/oem/pdf/PDT003A0X.pdf
+
 	http://www.lineagepower.com/oem/pdf/PDT006A0X.pdf
+
 	http://www.lineagepower.com/oem/pdf/PDT012A0X.pdf
+
 	http://www.lineagepower.com/oem/pdf/UDT020A0X.pdf
+
 	http://www.lineagepower.com/oem/pdf/MDT040A0X.pdf
+
   * Texas Instruments TPS40400, TPS544B20, TPS544B25, TPS544C20, TPS544C25
+
     Prefixes: 'tps40400', 'tps544b20', 'tps544b25', 'tps544c20', 'tps544c25'
+
     Addresses scanned: -
+
     Datasheets:
+
 	http://www.ti.com/lit/gpn/tps40400
+
 	http://www.ti.com/lit/gpn/tps544b20
+
 	http://www.ti.com/lit/gpn/tps544b25
+
 	http://www.ti.com/lit/gpn/tps544c20
+
 	http://www.ti.com/lit/gpn/tps544c25
+
   * Generic PMBus devices
+
     Prefix: 'pmbus'
+
     Addresses scanned: -
+
     Datasheet: n.a.
 
+
 Author: Guenter Roeck <linux@roeck-us.net>
 
 
@@ -62,9 +97,10 @@ supported by all chips), and since there is no well defined address range for
 PMBus devices. You will have to instantiate the devices explicitly.
 
 Example: the following will load the driver for an LTC2978 at address 0x60
-on I2C bus #1:
-$ modprobe pmbus
-$ echo ltc2978 0x60 > /sys/bus/i2c/devices/i2c-1/new_device
+on I2C bus #1::
+
+	$ modprobe pmbus
+	$ echo ltc2978 0x60 > /sys/bus/i2c/devices/i2c-1/new_device
 
 
 Platform data support
@@ -72,9 +108,9 @@ Platform data support
 
 Support for additional PMBus chips can be added by defining chip parameters in
 a new chip specific driver file. For example, (untested) code to add support for
-Emerson DS1200 power modules might look as follows.
+Emerson DS1200 power modules might look as follows::
 
-static struct pmbus_driver_info ds1200_info = {
+  static struct pmbus_driver_info ds1200_info = {
 	.pages = 1,
 	/* Note: All other sensors are in linear mode */
 	.direct[PSC_VOLTAGE_OUT] = true,
@@ -95,45 +131,45 @@ static struct pmbus_driver_info ds1200_info = {
 		   | PMBUS_HAVE_PIN | PMBUS_HAVE_POUT
 		   | PMBUS_HAVE_TEMP | PMBUS_HAVE_STATUS_TEMP
 		   | PMBUS_HAVE_FAN12 | PMBUS_HAVE_STATUS_FAN12,
-};
+  };
 
-static int ds1200_probe(struct i2c_client *client,
-			const struct i2c_device_id *id)
-{
+  static int ds1200_probe(struct i2c_client *client,
+			  const struct i2c_device_id *id)
+  {
 	return pmbus_do_probe(client, id, &ds1200_info);
-}
+  }
 
-static int ds1200_remove(struct i2c_client *client)
-{
+  static int ds1200_remove(struct i2c_client *client)
+  {
 	return pmbus_do_remove(client);
-}
+  }
 
-static const struct i2c_device_id ds1200_id[] = {
+  static const struct i2c_device_id ds1200_id[] = {
 	{"ds1200", 0},
 	{}
-};
+  };
 
-MODULE_DEVICE_TABLE(i2c, ds1200_id);
+  MODULE_DEVICE_TABLE(i2c, ds1200_id);
 
-/* This is the driver that will be inserted */
-static struct i2c_driver ds1200_driver = {
+  /* This is the driver that will be inserted */
+  static struct i2c_driver ds1200_driver = {
 	.driver = {
 		   .name = "ds1200",
 		   },
 	.probe = ds1200_probe,
 	.remove = ds1200_remove,
 	.id_table = ds1200_id,
-};
+  };
 
-static int __init ds1200_init(void)
-{
+  static int __init ds1200_init(void)
+  {
 	return i2c_add_driver(&ds1200_driver);
-}
+  }
 
-static void __exit ds1200_exit(void)
-{
+  static void __exit ds1200_exit(void)
+  {
 	i2c_del_driver(&ds1200_driver);
-}
+  }
 
 
 Sysfs entries
@@ -148,6 +184,7 @@ a given sysfs entry.
 The following attributes are supported. Limits are read-write; all other
 attributes are read-only.
 
+======================= ========================================================
 inX_input		Measured voltage. From READ_VIN or READ_VOUT register.
 inX_min			Minimum Voltage.
 			From VIN_UV_WARN_LIMIT or VOUT_UV_WARN_LIMIT register.
@@ -214,3 +251,4 @@ tempX_lcrit_alarm	Chip temperature critical low alarm. Set by comparing
 tempX_crit_alarm	Chip temperature critical high alarm. Set by comparing
 			READ_TEMPERATURE_X with OT_FAULT_LIMIT if
 			TEMP_OT_FAULT status is set.
+======================= ========================================================
diff --git a/Documentation/hwmon/pmbus-core b/Documentation/hwmon/pmbus-core
index 8ed10e9ddfb5..92515c446fe3 100644
--- a/Documentation/hwmon/pmbus-core
+++ b/Documentation/hwmon/pmbus-core
@@ -1,3 +1,4 @@
+==================================
 PMBus core driver and internal API
 ==================================
 
@@ -120,24 +121,24 @@ Specifically, it provides the following information.
   non-standard PMBus commands to standard commands, or to augment standard
   command return values with device specific information.
 
-  API functions
-  -------------
+API functions
+=============
 
-  Functions provided by chip driver
-  ---------------------------------
+Functions provided by chip driver
+---------------------------------
 
-  All functions return the command return value (read) or zero (write) if
-  successful. A return value of -ENODATA indicates that there is no manufacturer
-  specific command, but that a standard PMBus command may exist. Any other
-  negative return value indicates that the commands does not exist for this
-  chip, and that no attempt should be made to read or write the standard
-  command.
+All functions return the command return value (read) or zero (write) if
+successful. A return value of -ENODATA indicates that there is no manufacturer
+specific command, but that a standard PMBus command may exist. Any other
+negative return value indicates that the commands does not exist for this
+chip, and that no attempt should be made to read or write the standard
+command.
 
-  As mentioned above, an exception to this rule applies to virtual commands,
-  which  _must_ be handled in driver specific code. See "Virtual PMBus Commands"
-  above for more details.
+As mentioned above, an exception to this rule applies to virtual commands,
+which *must* be handled in driver specific code. See "Virtual PMBus Commands"
+above for more details.
 
-  Command execution in the core PMBus driver code is as follows.
+Command execution in the core PMBus driver code is as follows::
 
 	if (chip_access_function) {
 		status = chip_access_function();
@@ -148,128 +149,160 @@ Specifically, it provides the following information.
 		return -EINVAL;
 	return generic_access();
 
-  Chip drivers may provide pointers to the following functions in struct
-  pmbus_driver_info. All functions are optional.
+Chip drivers may provide pointers to the following functions in struct
+pmbus_driver_info. All functions are optional.
+
+::
 
   int (*read_byte_data)(struct i2c_client *client, int page, int reg);
 
-  Read byte from page <page>, register <reg>.
-  <page> may be -1, which means "current page".
+Read byte from page <page>, register <reg>.
+<page> may be -1, which means "current page".
+
+
+::
 
   int (*read_word_data)(struct i2c_client *client, int page, int reg);
 
-  Read word from page <page>, register <reg>.
+Read word from page <page>, register <reg>.
+
+::
 
   int (*write_word_data)(struct i2c_client *client, int page, int reg,
-		         u16 word);
+			 u16 word);
 
-  Write word to page <page>, register <reg>.
+Write word to page <page>, register <reg>.
+
+::
 
   int (*write_byte)(struct i2c_client *client, int page, u8 value);
 
-  Write byte to page <page>, register <reg>.
-  <page> may be -1, which means "current page".
+Write byte to page <page>, register <reg>.
+<page> may be -1, which means "current page".
+
+::
 
   int (*identify)(struct i2c_client *client, struct pmbus_driver_info *info);
 
-  Determine supported PMBus functionality. This function is only necessary
-  if a chip driver supports multiple chips, and the chip functionality is not
-  pre-determined. It is currently only used by the generic pmbus driver
-  (pmbus.c).
+Determine supported PMBus functionality. This function is only necessary
+if a chip driver supports multiple chips, and the chip functionality is not
+pre-determined. It is currently only used by the generic pmbus driver
+(pmbus.c).
 
-  Functions exported by core driver
-  ---------------------------------
+Functions exported by core driver
+---------------------------------
 
-  Chip drivers are expected to use the following functions to read or write
-  PMBus registers. Chip drivers may also use direct I2C commands. If direct I2C
-  commands are used, the chip driver code must not directly modify the current
-  page, since the selected page is cached in the core driver and the core driver
-  will assume that it is selected. Using pmbus_set_page() to select a new page
-  is mandatory.
+Chip drivers are expected to use the following functions to read or write
+PMBus registers. Chip drivers may also use direct I2C commands. If direct I2C
+commands are used, the chip driver code must not directly modify the current
+page, since the selected page is cached in the core driver and the core driver
+will assume that it is selected. Using pmbus_set_page() to select a new page
+is mandatory.
+
+::
 
   int pmbus_set_page(struct i2c_client *client, u8 page);
 
-  Set PMBus page register to <page> for subsequent commands.
+Set PMBus page register to <page> for subsequent commands.
+
+::
 
   int pmbus_read_word_data(struct i2c_client *client, u8 page, u8 reg);
 
-  Read word data from <page>, <reg>. Similar to i2c_smbus_read_word_data(), but
-  selects page first.
+Read word data from <page>, <reg>. Similar to i2c_smbus_read_word_data(), but
+selects page first.
+
+::
 
   int pmbus_write_word_data(struct i2c_client *client, u8 page, u8 reg,
 			    u16 word);
 
-  Write word data to <page>, <reg>. Similar to i2c_smbus_write_word_data(), but
-  selects page first.
+Write word data to <page>, <reg>. Similar to i2c_smbus_write_word_data(), but
+selects page first.
+
+::
 
   int pmbus_read_byte_data(struct i2c_client *client, int page, u8 reg);
 
-  Read byte data from <page>, <reg>. Similar to i2c_smbus_read_byte_data(), but
-  selects page first. <page> may be -1, which means "current page".
+Read byte data from <page>, <reg>. Similar to i2c_smbus_read_byte_data(), but
+selects page first. <page> may be -1, which means "current page".
+
+::
 
   int pmbus_write_byte(struct i2c_client *client, int page, u8 value);
 
-  Write byte data to <page>, <reg>. Similar to i2c_smbus_write_byte(), but
-  selects page first. <page> may be -1, which means "current page".
+Write byte data to <page>, <reg>. Similar to i2c_smbus_write_byte(), but
+selects page first. <page> may be -1, which means "current page".
+
+::
 
   void pmbus_clear_faults(struct i2c_client *client);
 
-  Execute PMBus "Clear Fault" command on all chip pages.
-  This function calls the device specific write_byte function if defined.
-  Therefore, it must _not_ be called from that function.
+Execute PMBus "Clear Fault" command on all chip pages.
+This function calls the device specific write_byte function if defined.
+Therefore, it must _not_ be called from that function.
+
+::
 
   bool pmbus_check_byte_register(struct i2c_client *client, int page, int reg);
 
-  Check if byte register exists. Return true if the register exists, false
-  otherwise.
-  This function calls the device specific write_byte function if defined to
-  obtain the chip status. Therefore, it must _not_ be called from that function.
+Check if byte register exists. Return true if the register exists, false
+otherwise.
+This function calls the device specific write_byte function if defined to
+obtain the chip status. Therefore, it must _not_ be called from that function.
+
+::
 
   bool pmbus_check_word_register(struct i2c_client *client, int page, int reg);
 
-  Check if word register exists. Return true if the register exists, false
-  otherwise.
-  This function calls the device specific write_byte function if defined to
-  obtain the chip status. Therefore, it must _not_ be called from that function.
+Check if word register exists. Return true if the register exists, false
+otherwise.
+This function calls the device specific write_byte function if defined to
+obtain the chip status. Therefore, it must _not_ be called from that function.
+
+::
 
   int pmbus_do_probe(struct i2c_client *client, const struct i2c_device_id *id,
-                     struct pmbus_driver_info *info);
+		     struct pmbus_driver_info *info);
 
-  Execute probe function. Similar to standard probe function for other drivers,
-  with the pointer to struct pmbus_driver_info as additional argument. Calls
-  identify function if supported. Must only be called from device probe
-  function.
+Execute probe function. Similar to standard probe function for other drivers,
+with the pointer to struct pmbus_driver_info as additional argument. Calls
+identify function if supported. Must only be called from device probe
+function.
+
+::
 
   void pmbus_do_remove(struct i2c_client *client);
 
-  Execute driver remove function. Similar to standard driver remove function.
+Execute driver remove function. Similar to standard driver remove function.
+
+::
 
   const struct pmbus_driver_info
 	*pmbus_get_driver_info(struct i2c_client *client);
 
-  Return pointer to struct pmbus_driver_info as passed to pmbus_do_probe().
+Return pointer to struct pmbus_driver_info as passed to pmbus_do_probe().
 
 
 PMBus driver platform data
 ==========================
 
 PMBus platform data is defined in include/linux/pmbus.h. Platform data
-currently only provides a flag field with a single bit used.
+currently only provides a flag field with a single bit used::
 
-#define PMBUS_SKIP_STATUS_CHECK (1 << 0)
+	#define PMBUS_SKIP_STATUS_CHECK (1 << 0)
 
-struct pmbus_platform_data {
-        u32 flags;              /* Device specific flags */
-};
+	struct pmbus_platform_data {
+		u32 flags;              /* Device specific flags */
+	};
 
 
 Flags
 -----
 
 PMBUS_SKIP_STATUS_CHECK
-
-During register detection, skip checking the status register for
-communication or command errors.
+	During register detection, skip checking the status register for
+	communication or command errors.
 
 Some PMBus chips respond with valid data when trying to read an unsupported
 register. For such chips, checking the status register is mandatory when
diff --git a/Documentation/hwmon/tps40422 b/Documentation/hwmon/tps40422
index 24bb0688d515..359751eb5ed4 100644
--- a/Documentation/hwmon/tps40422
+++ b/Documentation/hwmon/tps40422
@@ -2,9 +2,13 @@ Kernel driver tps40422
 ======================
 
 Supported chips:
+
   * TI TPS40422
+
     Prefix: 'tps40422'
+
     Addresses scanned: -
+
     Datasheet: http://www.ti.com/lit/gpn/tps40422
 
 Author: Zhu Laiwen <richard.zhu@nsn.com>
@@ -39,6 +43,7 @@ Sysfs entries
 
 The following attributes are supported.
 
+======================= =======================================================
 in[1-2]_label		"vout[1-2]"
 in[1-2]_input		Measured voltage. From READ_VOUT register.
 in[1-2]_alarm		voltage alarm.
@@ -46,19 +51,23 @@ in[1-2]_alarm		voltage alarm.
 curr[1-2]_input		Measured current. From READ_IOUT register.
 curr[1-2]_label		"iout[1-2]"
 curr1_max		Maximum current. From IOUT_OC_WARN_LIMIT register.
-curr1_crit		Critical maximum current. From IOUT_OC_FAULT_LIMIT register.
+curr1_crit		Critical maximum current. From IOUT_OC_FAULT_LIMIT
+			register.
 curr1_max_alarm		Current high alarm. From IOUT_OC_WARN_LIMIT status.
 curr1_crit_alarm	Current critical high alarm. From IOUT_OC_FAULT status.
 curr2_alarm		Current high alarm. From IOUT_OC_WARNING status.
 
-temp1_input		Measured temperature. From READ_TEMPERATURE_2 register on page 0.
+temp1_input		Measured temperature. From READ_TEMPERATURE_2 register
+			on page 0.
 temp1_max		Maximum temperature. From OT_WARN_LIMIT register.
 temp1_crit		Critical high temperature. From OT_FAULT_LIMIT register.
 temp1_max_alarm		Chip temperature high alarm. Set by comparing
-			READ_TEMPERATURE_2 on page 0 with OT_WARN_LIMIT if TEMP_OT_WARNING
-			status is set.
+			READ_TEMPERATURE_2 on page 0 with OT_WARN_LIMIT if
+			TEMP_OT_WARNING status is set.
 temp1_crit_alarm	Chip temperature critical high alarm. Set by comparing
-			READ_TEMPERATURE_2 on page 0 with OT_FAULT_LIMIT if TEMP_OT_FAULT
-			status is set.
-temp2_input		Measured temperature. From READ_TEMPERATURE_2 register on page 1.
+			READ_TEMPERATURE_2 on page 0 with OT_FAULT_LIMIT if
+			TEMP_OT_FAULT status is set.
+temp2_input		Measured temperature. From READ_TEMPERATURE_2 register
+			on page 1.
 temp2_alarm		Chip temperature alarm on page 1.
+======================= =======================================================
diff --git a/Documentation/hwmon/ucd9000 b/Documentation/hwmon/ucd9000
index 262e713e60ff..d69061b7312c 100644
--- a/Documentation/hwmon/ucd9000
+++ b/Documentation/hwmon/ucd9000
@@ -2,15 +2,20 @@ Kernel driver ucd9000
 =====================
 
 Supported chips:
+
   * TI UCD90120, UCD90124, UCD90160, UCD9090, and UCD90910
+
     Prefixes: 'ucd90120', 'ucd90124', 'ucd90160', 'ucd9090', 'ucd90910'
+
     Addresses scanned: -
+
     Datasheets:
-	http://focus.ti.com/lit/ds/symlink/ucd90120.pdf
-	http://focus.ti.com/lit/ds/symlink/ucd90124.pdf
-	http://focus.ti.com/lit/ds/symlink/ucd90160.pdf
-	http://focus.ti.com/lit/ds/symlink/ucd9090.pdf
-	http://focus.ti.com/lit/ds/symlink/ucd90910.pdf
+
+	- http://focus.ti.com/lit/ds/symlink/ucd90120.pdf
+	- http://focus.ti.com/lit/ds/symlink/ucd90124.pdf
+	- http://focus.ti.com/lit/ds/symlink/ucd90160.pdf
+	- http://focus.ti.com/lit/ds/symlink/ucd9090.pdf
+	- http://focus.ti.com/lit/ds/symlink/ucd90910.pdf
 
 Author: Guenter Roeck <linux@roeck-us.net>
 
@@ -76,23 +81,28 @@ Sysfs entries
 The following attributes are supported. Limits are read-write; all other
 attributes are read-only.
 
+======================= ========================================================
 in[1-12]_label		"vout[1-12]".
 in[1-12]_input		Measured voltage. From READ_VOUT register.
 in[1-12]_min		Minimum Voltage. From VOUT_UV_WARN_LIMIT register.
 in[1-12]_max		Maximum voltage. From VOUT_OV_WARN_LIMIT register.
 in[1-12]_lcrit		Critical minimum Voltage. VOUT_UV_FAULT_LIMIT register.
-in[1-12]_crit		Critical maximum voltage. From VOUT_OV_FAULT_LIMIT register.
+in[1-12]_crit		Critical maximum voltage. From VOUT_OV_FAULT_LIMIT
+			register.
 in[1-12]_min_alarm	Voltage low alarm. From VOLTAGE_UV_WARNING status.
 in[1-12]_max_alarm	Voltage high alarm. From VOLTAGE_OV_WARNING status.
-in[1-12]_lcrit_alarm	Voltage critical low alarm. From VOLTAGE_UV_FAULT status.
-in[1-12]_crit_alarm	Voltage critical high alarm. From VOLTAGE_OV_FAULT status.
+in[1-12]_lcrit_alarm	Voltage critical low alarm. From VOLTAGE_UV_FAULT
+			status.
+in[1-12]_crit_alarm	Voltage critical high alarm. From VOLTAGE_OV_FAULT
+			status.
 
 curr[1-12]_label	"iout[1-12]".
 curr[1-12]_input	Measured current. From READ_IOUT register.
 curr[1-12]_max		Maximum current. From IOUT_OC_WARN_LIMIT register.
-curr[1-12]_lcrit	Critical minimum output current. From IOUT_UC_FAULT_LIMIT
+curr[1-12]_lcrit	Critical minimum output current. From
+			IOUT_UC_FAULT_LIMIT register.
+curr[1-12]_crit		Critical maximum current. From IOUT_OC_FAULT_LIMIT
 			register.
-curr[1-12]_crit		Critical maximum current. From IOUT_OC_FAULT_LIMIT register.
 curr[1-12]_max_alarm	Current high alarm. From IOUT_OC_WARNING status.
 curr[1-12]_crit_alarm	Current critical high alarm. From IOUT_OC_FAULT status.
 
@@ -116,3 +126,4 @@ fan[1-4]_fault		Fan fault.
 			created only for enabled fans.
 			Note that even though UCD90910 supports up to 10 fans,
 			only up to four fans are currently supported.
+======================= ========================================================
diff --git a/Documentation/hwmon/ucd9200 b/Documentation/hwmon/ucd9200
index 1e8060e631bd..44eda4a579b6 100644
--- a/Documentation/hwmon/ucd9200
+++ b/Documentation/hwmon/ucd9200
@@ -2,18 +2,23 @@ Kernel driver ucd9200
 =====================
 
 Supported chips:
+
   * TI UCD9220, UCD9222, UCD9224, UCD9240, UCD9244, UCD9246, and UCD9248
+
     Prefixes: 'ucd9220', 'ucd9222', 'ucd9224', 'ucd9240', 'ucd9244', 'ucd9246',
-	'ucd9248'
+    'ucd9248'
+
     Addresses scanned: -
+
     Datasheets:
-	http://focus.ti.com/lit/ds/symlink/ucd9220.pdf
-	http://focus.ti.com/lit/ds/symlink/ucd9222.pdf
-	http://focus.ti.com/lit/ds/symlink/ucd9224.pdf
-	http://focus.ti.com/lit/ds/symlink/ucd9240.pdf
-	http://focus.ti.com/lit/ds/symlink/ucd9244.pdf
-	http://focus.ti.com/lit/ds/symlink/ucd9246.pdf
-	http://focus.ti.com/lit/ds/symlink/ucd9248.pdf
+
+	- http://focus.ti.com/lit/ds/symlink/ucd9220.pdf
+	- http://focus.ti.com/lit/ds/symlink/ucd9222.pdf
+	- http://focus.ti.com/lit/ds/symlink/ucd9224.pdf
+	- http://focus.ti.com/lit/ds/symlink/ucd9240.pdf
+	- http://focus.ti.com/lit/ds/symlink/ucd9244.pdf
+	- http://focus.ti.com/lit/ds/symlink/ucd9246.pdf
+	- http://focus.ti.com/lit/ds/symlink/ucd9248.pdf
 
 Author: Guenter Roeck <linux@roeck-us.net>
 
@@ -52,12 +57,14 @@ Sysfs entries
 The following attributes are supported. Limits are read-write; all other
 attributes are read-only.
 
+======================= ========================================================
 in1_label		"vin".
 in1_input		Measured voltage. From READ_VIN register.
 in1_min			Minimum Voltage. From VIN_UV_WARN_LIMIT register.
 in1_max			Maximum voltage. From VIN_OV_WARN_LIMIT register.
 in1_lcrit		Critical minimum Voltage. VIN_UV_FAULT_LIMIT register.
-in1_crit		Critical maximum voltage. From VIN_OV_FAULT_LIMIT register.
+in1_crit		Critical maximum voltage. From VIN_OV_FAULT_LIMIT
+			register.
 in1_min_alarm		Voltage low alarm. From VIN_UV_WARNING status.
 in1_max_alarm		Voltage high alarm. From VIN_OV_WARNING status.
 in1_lcrit_alarm		Voltage critical low alarm. From VIN_UV_FAULT status.
@@ -68,11 +75,14 @@ in[2-5]_input		Measured voltage. From READ_VOUT register.
 in[2-5]_min		Minimum Voltage. From VOUT_UV_WARN_LIMIT register.
 in[2-5]_max		Maximum voltage. From VOUT_OV_WARN_LIMIT register.
 in[2-5]_lcrit		Critical minimum Voltage. VOUT_UV_FAULT_LIMIT register.
-in[2-5]_crit		Critical maximum voltage. From VOUT_OV_FAULT_LIMIT register.
+in[2-5]_crit		Critical maximum voltage. From VOUT_OV_FAULT_LIMIT
+			register.
 in[2-5]_min_alarm	Voltage low alarm. From VOLTAGE_UV_WARNING status.
 in[2-5]_max_alarm	Voltage high alarm. From VOLTAGE_OV_WARNING status.
-in[2-5]_lcrit_alarm	Voltage critical low alarm. From VOLTAGE_UV_FAULT status.
-in[2-5]_crit_alarm	Voltage critical high alarm. From VOLTAGE_OV_FAULT status.
+in[2-5]_lcrit_alarm	Voltage critical low alarm. From VOLTAGE_UV_FAULT
+			status.
+in[2-5]_crit_alarm	Voltage critical high alarm. From VOLTAGE_OV_FAULT
+			status.
 
 curr1_label		"iin".
 curr1_input		Measured current. From READ_IIN register.
@@ -80,9 +90,10 @@ curr1_input		Measured current. From READ_IIN register.
 curr[2-5]_label		"iout[1-4]".
 curr[2-5]_input		Measured current. From READ_IOUT register.
 curr[2-5]_max		Maximum current. From IOUT_OC_WARN_LIMIT register.
-curr[2-5]_lcrit		Critical minimum output current. From IOUT_UC_FAULT_LIMIT
+curr[2-5]_lcrit		Critical minimum output current. From
+			IOUT_UC_FAULT_LIMIT register.
+curr[2-5]_crit		Critical maximum current. From IOUT_OC_FAULT_LIMIT
 			register.
-curr[2-5]_crit		Critical maximum current. From IOUT_OC_FAULT_LIMIT register.
 curr[2-5]_max_alarm	Current high alarm. From IOUT_OC_WARNING status.
 curr[2-5]_crit_alarm	Current critical high alarm. From IOUT_OC_FAULT status.
 
@@ -97,7 +108,7 @@ power[2-5]_label	"pout[1-4]"
 			rails. See chip datasheets for details.
 
 temp[1-5]_input		Measured temperatures. From READ_TEMPERATURE_1 and
-		        READ_TEMPERATURE_2 registers.
+			READ_TEMPERATURE_2 registers.
 			temp1 is the chip internal temperature. temp[2-5] are
 			rail temperatures.  temp[2-5] attributes are only
 			created for enabled rails. See chip datasheets for
@@ -110,3 +121,4 @@ temp[1-5]_crit_alarm	Temperature critical high alarm.
 fan1_input		Fan RPM. ucd9240 only.
 fan1_alarm		Fan alarm. ucd9240 only.
 fan1_fault		Fan fault. ucd9240 only.
+======================= ========================================================
diff --git a/Documentation/hwmon/zl6100 b/Documentation/hwmon/zl6100
index 477a94b131ae..4029970bace4 100644
--- a/Documentation/hwmon/zl6100
+++ b/Documentation/hwmon/zl6100
@@ -2,57 +2,106 @@ Kernel driver zl6100
 ====================
 
 Supported chips:
+
   * Intersil / Zilker Labs ZL2004
+
     Prefix: 'zl2004'
+
     Addresses scanned: -
+
     Datasheet: http://www.intersil.com/data/fn/fn6847.pdf
+
   * Intersil / Zilker Labs ZL2005
+
     Prefix: 'zl2005'
+
     Addresses scanned: -
+
     Datasheet: http://www.intersil.com/data/fn/fn6848.pdf
+
   * Intersil / Zilker Labs ZL2006
+
     Prefix: 'zl2006'
+
     Addresses scanned: -
+
     Datasheet: http://www.intersil.com/data/fn/fn6850.pdf
+
   * Intersil / Zilker Labs ZL2008
+
     Prefix: 'zl2008'
+
     Addresses scanned: -
+
     Datasheet: http://www.intersil.com/data/fn/fn6859.pdf
+
   * Intersil / Zilker Labs ZL2105
+
     Prefix: 'zl2105'
+
     Addresses scanned: -
+
     Datasheet: http://www.intersil.com/data/fn/fn6851.pdf
+
   * Intersil / Zilker Labs ZL2106
+
     Prefix: 'zl2106'
+
     Addresses scanned: -
+
     Datasheet: http://www.intersil.com/data/fn/fn6852.pdf
+
   * Intersil / Zilker Labs ZL6100
+
     Prefix: 'zl6100'
+
     Addresses scanned: -
+
     Datasheet: http://www.intersil.com/data/fn/fn6876.pdf
+
   * Intersil / Zilker Labs ZL6105
+
     Prefix: 'zl6105'
+
     Addresses scanned: -
+
     Datasheet: http://www.intersil.com/data/fn/fn6906.pdf
+
   * Intersil / Zilker Labs ZL9101M
+
     Prefix: 'zl9101'
+
     Addresses scanned: -
+
     Datasheet: http://www.intersil.com/data/fn/fn7669.pdf
+
   * Intersil / Zilker Labs ZL9117M
+
     Prefix: 'zl9117'
+
     Addresses scanned: -
+
     Datasheet: http://www.intersil.com/data/fn/fn7914.pdf
+
   * Ericsson BMR450, BMR451
+
     Prefix: 'bmr450', 'bmr451'
+
     Addresses scanned: -
+
     Datasheet:
+
 http://archive.ericsson.net/service/internet/picov/get?DocNo=28701-EN/LZT146401
+
   * Ericsson BMR462, BMR463, BMR464
+
     Prefixes: 'bmr462', 'bmr463', 'bmr464'
+
     Addresses scanned: -
+
     Datasheet:
-http://archive.ericsson.net/service/internet/picov/get?DocNo=28701-EN/LZT146256
 
+	http://archive.ericsson.net/service/internet/picov/get?DocNo=28701-EN/LZT146256
 
 Author: Guenter Roeck <linux@roeck-us.net>
 
@@ -75,13 +124,15 @@ This driver does not auto-detect devices. You will have to instantiate the
 devices explicitly. Please see Documentation/i2c/instantiating-devices for
 details.
 
-WARNING: Do not access chip registers using the i2cdump command, and do not use
-any of the i2ctools commands on a command register used to save and restore
-configuration data (0x11, 0x12, 0x15, 0x16, and 0xf4). The chips supported by
-this driver interpret any access to those command registers (including read
-commands) as request to execute the command in question. Unless write accesses
-to those registers are protected, this may result in power loss, board resets,
-and/or Flash corruption. Worst case, your board may turn into a brick.
+.. warning::
+
+  Do not access chip registers using the i2cdump command, and do not use
+  any of the i2ctools commands on a command register used to save and restore
+  configuration data (0x11, 0x12, 0x15, 0x16, and 0xf4). The chips supported by
+  this driver interpret any access to those command registers (including read
+  commands) as request to execute the command in question. Unless write accesses
+  to those registers are protected, this may result in power loss, board resets,
+  and/or Flash corruption. Worst case, your board may turn into a brick.
 
 
 Platform data support
@@ -110,6 +161,7 @@ Sysfs entries
 The following attributes are supported. Limits are read-write; all other
 attributes are read-only.
 
+======================= ========================================================
 in1_label		"vin"
 in1_input		Measured input voltage.
 in1_min			Minimum input voltage.
@@ -158,3 +210,4 @@ temp[12]_min_alarm	Chip temperature low alarm.
 temp[12]_max_alarm	Chip temperature high alarm.
 temp[12]_lcrit_alarm	Chip temperature critical low alarm.
 temp[12]_crit_alarm	Chip temperature critical high alarm.
+======================= ========================================================
-- 
2.20.1


^ permalink raw reply related	[flat|nested] 73+ messages in thread

* [PATCH v3 19/21] docs: hwmon: misc files: convert to ReST format
  2019-04-17  9:46                   ` [PATCH v3 00/21]Convert " Mauro Carvalho Chehab
                                       ` (17 preceding siblings ...)
  2019-04-17  9:46                     ` [PATCH v3 18/21] docs: hwmon: pmbus files: " Mauro Carvalho Chehab
@ 2019-04-17  9:46                     ` Mauro Carvalho Chehab
  2019-04-17  9:46                     ` [PATCH v3 20/21] docs: hwmon: convert remaining files " Mauro Carvalho Chehab
  2019-04-17  9:46                     ` [PATCH v3 21/21] docs: hwmon: Add an index file and rename docs to *.rst Mauro Carvalho Chehab
  20 siblings, 0 replies; 73+ messages in thread
From: Mauro Carvalho Chehab @ 2019-04-17  9:46 UTC (permalink / raw)
  To: Linux Doc Mailing List
  Cc: Mauro Carvalho Chehab, Mauro Carvalho Chehab, linux-kernel,
	Jonathan Corbet, Jean Delvare, Guenter Roeck, linux-hwmon

Convert other files maintained by Guenter to ReST format, in order
to allow them to be parsed by Sphinx.

Signed-off-by: Mauro Carvalho Chehab <mchehab+samsung@kernel.org>
---
 Documentation/hwmon/ina209   |  18 ++++--
 Documentation/hwmon/ina2xx   |  39 +++++++++---
 Documentation/hwmon/jc42     |  55 ++++++++++++++++-
 Documentation/hwmon/lm95234  |  11 +++-
 Documentation/hwmon/ltc4261  |  16 +++--
 Documentation/hwmon/max16065 |  24 +++++++-
 Documentation/hwmon/max6697  |  33 ++++++++++
 Documentation/hwmon/nct6775  | 114 ++++++++++++++++++++++++++++-------
 Documentation/hwmon/smm665   |  42 +++++++++++--
 Documentation/hwmon/tmp401   |  30 ++++++++-
 10 files changed, 328 insertions(+), 54 deletions(-)

diff --git a/Documentation/hwmon/ina209 b/Documentation/hwmon/ina209
index 672501de4509..64322075a145 100644
--- a/Documentation/hwmon/ina209
+++ b/Documentation/hwmon/ina209
@@ -1,16 +1,21 @@
 Kernel driver ina209
-=====================
+====================
 
 Supported chips:
+
   * Burr-Brown / Texas Instruments INA209
+
     Prefix: 'ina209'
+
     Addresses scanned: -
+
     Datasheet:
-        http://www.ti.com/lit/gpn/ina209
+	http://www.ti.com/lit/gpn/ina209
 
-Author: Paul Hays <Paul.Hays@cattail.ca>
-Author: Ira W. Snyder <iws@ovro.caltech.edu>
-Author: Guenter Roeck <linux@roeck-us.net>
+Author:
+	- Paul Hays <Paul.Hays@cattail.ca>
+	- Ira W. Snyder <iws@ovro.caltech.edu>
+	- Guenter Roeck <linux@roeck-us.net>
 
 
 Description
@@ -31,7 +36,7 @@ the I2C bus. See the datasheet for details.
 This tries to expose most monitoring features of the hardware via
 sysfs. It does not support every feature of this chip.
 
-
+======================= =======================================================
 in0_input		shunt voltage (mV)
 in0_input_highest	shunt voltage historical maximum reading (mV)
 in0_input_lowest	shunt voltage historical minimum reading (mV)
@@ -70,6 +75,7 @@ curr1_input		current measurement (mA)
 
 update_interval		data conversion time; affects number of samples used
 			to average results for shunt and bus voltages.
+======================= =======================================================
 
 General Remarks
 ---------------
diff --git a/Documentation/hwmon/ina2xx b/Documentation/hwmon/ina2xx
index 0f36c021192d..95badf9c396f 100644
--- a/Documentation/hwmon/ina2xx
+++ b/Documentation/hwmon/ina2xx
@@ -2,35 +2,56 @@ Kernel driver ina2xx
 ====================
 
 Supported chips:
+
   * Texas Instruments INA219
+
+
     Prefix: 'ina219'
     Addresses: I2C 0x40 - 0x4f
+
     Datasheet: Publicly available at the Texas Instruments website
-               http://www.ti.com/
+
+	       http://www.ti.com/
 
   * Texas Instruments INA220
+
     Prefix: 'ina220'
+
     Addresses: I2C 0x40 - 0x4f
+
     Datasheet: Publicly available at the Texas Instruments website
-               http://www.ti.com/
+
+	       http://www.ti.com/
 
   * Texas Instruments INA226
+
     Prefix: 'ina226'
+
     Addresses: I2C 0x40 - 0x4f
+
     Datasheet: Publicly available at the Texas Instruments website
-               http://www.ti.com/
+
+	       http://www.ti.com/
 
   * Texas Instruments INA230
+
     Prefix: 'ina230'
+
     Addresses: I2C 0x40 - 0x4f
+
     Datasheet: Publicly available at the Texas Instruments website
-               http://www.ti.com/
+
+	       http://www.ti.com/
 
   * Texas Instruments INA231
+
     Prefix: 'ina231'
+
     Addresses: I2C 0x40 - 0x4f
+
     Datasheet: Publicly available at the Texas Instruments website
-               http://www.ti.com/
+
+	       http://www.ti.com/
 
 Author: Lothar Felten <lothar.felten@gmail.com>
 
@@ -64,16 +85,20 @@ lower limit of the update_interval is 2 ms, the upper limit is 2253 ms.
 The actual programmed interval may vary from the desired value.
 
 General sysfs entries
--------------
+---------------------
 
+======================= ===============================
 in0_input		Shunt voltage(mV) channel
 in1_input		Bus voltage(mV) channel
 curr1_input		Current(mA) measurement channel
 power1_input		Power(uW) measurement channel
 shunt_resistor		Shunt resistance(uOhm) channel
+======================= ===============================
 
 Sysfs entries for ina226, ina230 and ina231 only
--------------
+------------------------------------------------
 
+======================= ====================================================
 update_interval		data conversion time; affects number of samples used
 			to average results for shunt and bus voltages.
+======================= ====================================================
diff --git a/Documentation/hwmon/jc42 b/Documentation/hwmon/jc42
index b4b671f22453..5b14b49bb6f7 100644
--- a/Documentation/hwmon/jc42
+++ b/Documentation/hwmon/jc42
@@ -2,53 +2,100 @@ Kernel driver jc42
 ==================
 
 Supported chips:
+
   * Analog Devices ADT7408
+
     Datasheets:
+
 	http://www.analog.com/static/imported-files/data_sheets/ADT7408.pdf
+
   * Atmel AT30TS00, AT30TS002A/B, AT30TSE004A
+
     Datasheets:
+
 	http://www.atmel.com/Images/doc8585.pdf
+
 	http://www.atmel.com/Images/doc8711.pdf
+
 	http://www.atmel.com/Images/Atmel-8852-SEEPROM-AT30TSE002A-Datasheet.pdf
+
 	http://www.atmel.com/Images/Atmel-8868-DTS-AT30TSE004A-Datasheet.pdf
+
   * IDT TSE2002B3, TSE2002GB2, TSE2004GB2, TS3000B3, TS3000GB0, TS3000GB2,
+
 	TS3001GB2
+
     Datasheets:
+
 	Available from IDT web site
+
   * Maxim MAX6604
+
     Datasheets:
+
 	http://datasheets.maxim-ic.com/en/ds/MAX6604.pdf
+
   * Microchip MCP9804, MCP9805, MCP9808, MCP98242, MCP98243, MCP98244, MCP9843
+
     Datasheets:
+
 	http://ww1.microchip.com/downloads/en/DeviceDoc/22203C.pdf
+
 	http://ww1.microchip.com/downloads/en/DeviceDoc/21977b.pdf
+
 	http://ww1.microchip.com/downloads/en/DeviceDoc/25095A.pdf
+
 	http://ww1.microchip.com/downloads/en/DeviceDoc/21996a.pdf
+
 	http://ww1.microchip.com/downloads/en/DeviceDoc/22153c.pdf
+
 	http://ww1.microchip.com/downloads/en/DeviceDoc/22327A.pdf
+
   * NXP Semiconductors SE97, SE97B, SE98, SE98A
+
     Datasheets:
+
 	http://www.nxp.com/documents/data_sheet/SE97.pdf
+
 	http://www.nxp.com/documents/data_sheet/SE97B.pdf
+
 	http://www.nxp.com/documents/data_sheet/SE98.pdf
+
 	http://www.nxp.com/documents/data_sheet/SE98A.pdf
+
   * ON Semiconductor CAT34TS02, CAT6095
+
     Datasheet:
+
 	http://www.onsemi.com/pub_link/Collateral/CAT34TS02-D.PDF
+
 	http://www.onsemi.com/pub/Collateral/CAT6095-D.PDF
+
   * ST Microelectronics STTS424, STTS424E02, STTS2002, STTS2004, STTS3000
+
     Datasheets:
+
 	http://www.st.com/web/en/resource/technical/document/datasheet/CD00157556.pdf
+
 	http://www.st.com/web/en/resource/technical/document/datasheet/CD00157558.pdf
+
 	http://www.st.com/web/en/resource/technical/document/datasheet/CD00266638.pdf
+
 	http://www.st.com/web/en/resource/technical/document/datasheet/CD00225278.pdf
+
 	http://www.st.com/web/en/resource/technical/document/datasheet/DM00076709.pdf
+
   * JEDEC JC 42.4 compliant temperature sensor chips
+
     Datasheet:
+
 	http://www.jedec.org/sites/default/files/docs/4_01_04R19.pdf
 
+
   Common for all chips:
+
     Prefix: 'jc42'
+
     Addresses scanned: I2C 0x18 - 0x1f
 
 Author:
@@ -67,10 +114,10 @@ The driver auto-detects the chips listed above, but can be manually instantiated
 to support other JC 42.4 compliant chips.
 
 Example: the following will load the driver for a generic JC 42.4 compliant
-temperature sensor at address 0x18 on I2C bus #1:
+temperature sensor at address 0x18 on I2C bus #1::
 
-# modprobe jc42
-# echo jc42 0x18 > /sys/bus/i2c/devices/i2c-1/new_device
+	# modprobe jc42
+	# echo jc42 0x18 > /sys/bus/i2c/devices/i2c-1/new_device
 
 A JC 42.4 compliant chip supports a single temperature sensor. Minimum, maximum,
 and critical temperature can be configured. There are alarms for high, low,
@@ -90,6 +137,7 @@ cannot be changed.
 Sysfs entries
 -------------
 
+======================= ===========================================
 temp1_input		Temperature (RO)
 temp1_min		Minimum temperature (RO or RW)
 temp1_max		Maximum temperature (RO or RW)
@@ -101,3 +149,4 @@ temp1_max_hyst		Maximum hysteresis temperature (RO)
 temp1_min_alarm		Temperature low alarm
 temp1_max_alarm		Temperature high alarm
 temp1_crit_alarm	Temperature critical alarm
+======================= ===========================================
diff --git a/Documentation/hwmon/lm95234 b/Documentation/hwmon/lm95234
index 32b777ef224c..e4c14bea5efd 100644
--- a/Documentation/hwmon/lm95234
+++ b/Documentation/hwmon/lm95234
@@ -2,15 +2,22 @@ Kernel driver lm95234
 =====================
 
 Supported chips:
+
   * National Semiconductor / Texas Instruments LM95233
+
     Addresses scanned: I2C 0x18, 0x2a, 0x2b
+
     Datasheet: Publicly available at the Texas Instruments website
-               http://www.ti.com/product/lm95233
+
+	       http://www.ti.com/product/lm95233
+
   * National Semiconductor / Texas Instruments LM95234
+
     Addresses scanned: I2C 0x18, 0x4d, 0x4e
+
     Datasheet: Publicly available at the Texas Instruments website
-               http://www.ti.com/product/lm95234
 
+	       http://www.ti.com/product/lm95234
 
 Author: Guenter Roeck <linux@roeck-us.net>
 
diff --git a/Documentation/hwmon/ltc4261 b/Documentation/hwmon/ltc4261
index 9378a75c6134..c80233f8082e 100644
--- a/Documentation/hwmon/ltc4261
+++ b/Documentation/hwmon/ltc4261
@@ -2,11 +2,16 @@ Kernel driver ltc4261
 =====================
 
 Supported chips:
+
   * Linear Technology LTC4261
+
     Prefix: 'ltc4261'
+
     Addresses scanned: -
+
     Datasheet:
-        http://cds.linear.com/docs/Datasheet/42612fb.pdf
+
+	http://cds.linear.com/docs/Datasheet/42612fb.pdf
 
 Author: Guenter Roeck <linux@roeck-us.net>
 
@@ -26,9 +31,10 @@ which can be safely used to identify the chip. You will have to instantiate
 the devices explicitly.
 
 Example: the following will load the driver for an LTC4261 at address 0x10
-on I2C bus #1:
-$ modprobe ltc4261
-$ echo ltc4261 0x10 > /sys/bus/i2c/devices/i2c-1/new_device
+on I2C bus #1::
+
+	$ modprobe ltc4261
+	$ echo ltc4261 0x10 > /sys/bus/i2c/devices/i2c-1/new_device
 
 
 Sysfs entries
@@ -51,6 +57,7 @@ the proximity of the ADIN2 pin to the OV pin. ADIN2 is, however, not available
 on all chip variants. To ensure that the alarm condition is reported to the user,
 report it with both voltage sensors.
 
+======================= =============================
 in1_input		ADIN2 voltage (mV)
 in1_min_alarm		ADIN/ADIN2 Undervoltage alarm
 in1_max_alarm		ADIN/ADIN2 Overvoltage alarm
@@ -61,3 +68,4 @@ in2_max_alarm		ADIN/ADIN2 Overvoltage alarm
 
 curr1_input		SENSE current (mA)
 curr1_alarm		SENSE overcurrent alarm
+======================= =============================
diff --git a/Documentation/hwmon/max16065 b/Documentation/hwmon/max16065
index 208a29e43010..fa5c852a178c 100644
--- a/Documentation/hwmon/max16065
+++ b/Documentation/hwmon/max16065
@@ -1,29 +1,49 @@
 Kernel driver max16065
 ======================
 
+
 Supported chips:
+
   * Maxim MAX16065, MAX16066
+
     Prefixes: 'max16065', 'max16066'
+
     Addresses scanned: -
+
     Datasheet:
+
 	http://datasheets.maxim-ic.com/en/ds/MAX16065-MAX16066.pdf
+
  *  Maxim MAX16067
+
     Prefix: 'max16067'
+
     Addresses scanned: -
+
     Datasheet:
+
 	http://datasheets.maxim-ic.com/en/ds/MAX16067.pdf
+
  *  Maxim MAX16068
+
     Prefix: 'max16068'
+
     Addresses scanned: -
+
     Datasheet:
+
 	http://datasheets.maxim-ic.com/en/ds/MAX16068.pdf
+
  *  Maxim MAX16070/MAX16071
+
     Prefixes: 'max16070', 'max16071'
+
     Addresses scanned: -
+
     Datasheet:
+
 	http://datasheets.maxim-ic.com/en/ds/MAX16070-MAX16071.pdf
 
-
 Author: Guenter Roeck <linux@roeck-us.net>
 
 
@@ -73,6 +93,7 @@ turn into a brick.
 Sysfs entries
 -------------
 
+======================= ========================================================
 in[0-11]_input		Input voltage measurements.
 
 in12_input		Voltage on CSP (Current Sense Positive) pin.
@@ -103,3 +124,4 @@ curr1_input		Current sense input; only if the chip supports current
 
 curr1_alarm		Overcurrent alarm; only if the chip supports current
 			sensing and if current sensing is enabled.
+======================= ========================================================
diff --git a/Documentation/hwmon/max6697 b/Documentation/hwmon/max6697
index 6594177ededa..ffc5a7d8d33b 100644
--- a/Documentation/hwmon/max6697
+++ b/Documentation/hwmon/max6697
@@ -2,38 +2,69 @@ Kernel driver max6697
 =====================
 
 Supported chips:
+
   * Maxim MAX6581
+
     Prefix: 'max6581'
+
     Datasheet: http://datasheets.maximintegrated.com/en/ds/MAX6581.pdf
+
   * Maxim MAX6602
+
     Prefix: 'max6602'
+
     Datasheet: http://datasheets.maximintegrated.com/en/ds/MAX6602.pdf
+
   * Maxim MAX6622
+
     Prefix: 'max6622'
+
     Datasheet: http://datasheets.maximintegrated.com/en/ds/MAX6622.pdf
+
   * Maxim MAX6636
+
     Prefix: 'max6636'
+
     Datasheet: http://datasheets.maximintegrated.com/en/ds/MAX6636.pdf
+
   * Maxim MAX6689
+
     Prefix: 'max6689'
+
     Datasheet: http://datasheets.maximintegrated.com/en/ds/MAX6689.pdf
+
   * Maxim MAX6693
+
     Prefix: 'max6693'
+
     Datasheet: http://datasheets.maximintegrated.com/en/ds/MAX6693.pdf
+
   * Maxim MAX6694
+
     Prefix: 'max6694'
+
     Datasheet: http://datasheets.maximintegrated.com/en/ds/MAX6694.pdf
+
   * Maxim MAX6697
+
     Prefix: 'max6697'
+
     Datasheet: http://datasheets.maximintegrated.com/en/ds/MAX6697.pdf
+
   * Maxim MAX6698
+
     Prefix: 'max6698'
+
     Datasheet: http://datasheets.maximintegrated.com/en/ds/MAX6698.pdf
+
   * Maxim MAX6699
+
     Prefix: 'max6699'
+
     Datasheet: http://datasheets.maximintegrated.com/en/ds/MAX6699.pdf
 
 Author:
+
     Guenter Roeck <linux@roeck-us.net>
 
 Description
@@ -50,9 +81,11 @@ The driver provides the following sysfs attributes. temp1 is the local (chip)
 temperature, temp[2..n] are remote temperatures. The actually supported
 per-channel attributes are chip type and channel dependent.
 
+================ == ==========================================================
 tempX_input      RO temperature
 tempX_max        RW temperature maximum threshold
 tempX_max_alarm  RO temperature maximum threshold alarm
 tempX_crit       RW temperature critical threshold
 tempX_crit_alarm RO temperature critical threshold alarm
 tempX_fault      RO temperature diode fault (remote sensors only)
+================ == ==========================================================
diff --git a/Documentation/hwmon/nct6775 b/Documentation/hwmon/nct6775
index bd59834d310f..1d0315c40952 100644
--- a/Documentation/hwmon/nct6775
+++ b/Documentation/hwmon/nct6775
@@ -1,52 +1,90 @@
-Note
-====
-
-This driver supersedes the NCT6775F and NCT6776F support in the W83627EHF
-driver.
-
 Kernel driver NCT6775
 =====================
 
+.. note::
+
+    This driver supersedes the NCT6775F and NCT6776F support in the W83627EHF
+    driver.
+
 Supported chips:
+
   * Nuvoton NCT6102D/NCT6104D/NCT6106D
+
     Prefix: 'nct6106'
+
     Addresses scanned: ISA address retrieved from Super I/O registers
+
     Datasheet: Available from the Nuvoton web site
+
   * Nuvoton NCT5572D/NCT6771F/NCT6772F/NCT6775F/W83677HG-I
+
     Prefix: 'nct6775'
+
     Addresses scanned: ISA address retrieved from Super I/O registers
+
     Datasheet: Available from Nuvoton upon request
+
   * Nuvoton NCT5573D/NCT5577D/NCT6776D/NCT6776F
+
     Prefix: 'nct6776'
+
     Addresses scanned: ISA address retrieved from Super I/O registers
+
     Datasheet: Available from Nuvoton upon request
+
   * Nuvoton NCT5532D/NCT6779D
+
     Prefix: 'nct6779'
+
     Addresses scanned: ISA address retrieved from Super I/O registers
+
     Datasheet: Available from Nuvoton upon request
+
   * Nuvoton NCT6791D
+
     Prefix: 'nct6791'
+
     Addresses scanned: ISA address retrieved from Super I/O registers
+
     Datasheet: Available from Nuvoton upon request
+
   * Nuvoton NCT6792D
+
     Prefix: 'nct6792'
+
     Addresses scanned: ISA address retrieved from Super I/O registers
+
     Datasheet: Available from Nuvoton upon request
+
   * Nuvoton NCT6793D
+
     Prefix: 'nct6793'
+
     Addresses scanned: ISA address retrieved from Super I/O registers
+
     Datasheet: Available from Nuvoton upon request
+
   * Nuvoton NCT6795D
+
     Prefix: 'nct6795'
+
     Addresses scanned: ISA address retrieved from Super I/O registers
+
     Datasheet: Available from Nuvoton upon request
+
   * Nuvoton NCT6796D
+
     Prefix: 'nct6796'
+
     Addresses scanned: ISA address retrieved from Super I/O registers
+
     Datasheet: Available from Nuvoton upon request
 
+
+
 Authors:
-        Guenter Roeck <linux@roeck-us.net>
+
+	Guenter Roeck <linux@roeck-us.net>
 
 Description
 -----------
@@ -96,10 +134,14 @@ The mode works for fan1-fan5.
 sysfs attributes
 ----------------
 
-pwm[1-7] - this file stores PWM duty cycle or DC value (fan speed) in range:
+pwm[1-7]
+    - this file stores PWM duty cycle or DC value (fan speed) in range:
+
 	   0 (lowest speed) to 255 (full)
 
-pwm[1-7]_enable - this file controls mode of fan/temperature control:
+pwm[1-7]_enable
+    - this file controls mode of fan/temperature control:
+
 	* 0 Fan control disabled (fans set to maximum speed)
 	* 1 Manual mode, write to pwm[0-5] any value 0-255
 	* 2 "Thermal Cruise" mode
@@ -107,15 +149,19 @@ pwm[1-7]_enable - this file controls mode of fan/temperature control:
 	* 4 "Smart Fan III" mode (NCT6775F only)
 	* 5 "Smart Fan IV" mode
 
-pwm[1-7]_mode - controls if output is PWM or DC level
-        * 0 DC output
-        * 1 PWM output
+pwm[1-7]_mode
+    - controls if output is PWM or DC level
+
+	* 0 DC output
+	* 1 PWM output
 
 Common fan control attributes
 -----------------------------
 
-pwm[1-7]_temp_sel	Temperature source. Value is temperature sensor index.
+pwm[1-7]_temp_sel
+			Temperature source. Value is temperature sensor index.
 			For example, select '1' for temp1_input.
+
 pwm[1-7]_weight_temp_sel
 			Secondary temperature source. Value is temperature
 			sensor index. For example, select '1' for temp1_input.
@@ -126,13 +172,16 @@ following attributes.
 
 pwm[1-7]_weight_duty_step
 			Duty step size.
+
 pwm[1-7]_weight_temp_step
 			Temperature step size. With each step over
 			temp_step_base, the value of weight_duty_step is added
 			to the current pwm value.
+
 pwm[1-7]_weight_temp_step_base
 			Temperature at which secondary temperature control kicks
 			in.
+
 pwm[1-7]_weight_temp_step_tol
 			Temperature step tolerance.
 
@@ -141,24 +190,35 @@ Thermal Cruise mode (2)
 
 If the temperature is in the range defined by:
 
-pwm[1-7]_target_temp	Target temperature, unit millidegree Celsius
+pwm[1-7]_target_temp
+			Target temperature, unit millidegree Celsius
 			(range 0 - 127000)
+
 pwm[1-7]_temp_tolerance
 			Target temperature tolerance, unit millidegree Celsius
 
-there are no changes to fan speed. Once the temperature leaves the interval, fan
+There are no changes to fan speed. Once the temperature leaves the interval, fan
 speed increases (if temperature is higher that desired) or decreases (if
 temperature is lower than desired), using the following limits and time
 intervals.
 
-pwm[1-7]_start		fan pwm start value (range 1 - 255), to start fan
+pwm[1-7]_start
+			fan pwm start value (range 1 - 255), to start fan
 			when the temperature is above defined range.
-pwm[1-7]_floor		lowest fan pwm (range 0 - 255) if temperature is below
+
+pwm[1-7]_floor
+			lowest fan pwm (range 0 - 255) if temperature is below
 			the defined range. If set to 0, the fan is expected to
 			stop if the temperature is below the defined range.
-pwm[1-7]_step_up_time	milliseconds before fan speed is increased
-pwm[1-7]_step_down_time	milliseconds before fan speed is decreased
-pwm[1-7]_stop_time	how many milliseconds must elapse to switch
+
+pwm[1-7]_step_up_time
+			milliseconds before fan speed is increased
+
+pwm[1-7]_step_down_time
+			milliseconds before fan speed is decreased
+
+pwm[1-7]_stop_time
+			how many milliseconds must elapse to switch
 			corresponding fan off (when the temperature was below
 			defined range).
 
@@ -167,7 +227,9 @@ Speed Cruise mode (3)
 
 This modes tries to keep the fan speed constant.
 
-fan[1-7]_target		Target fan speed
+fan[1-7]_target
+			Target fan speed
+
 fan[1-7]_tolerance
 			Target speed tolerance
 
@@ -188,16 +250,22 @@ critical temperature mode, in which the fans should run at full speed.
 pwm[1-7]_auto_point[1-7]_pwm
 			pwm value to be set if temperature reaches matching
 			temperature range.
+
 pwm[1-7]_auto_point[1-7]_temp
 			Temperature over which the matching pwm is enabled.
+
 pwm[1-7]_temp_tolerance
 			Temperature tolerance, unit millidegree Celsius
+
 pwm[1-7]_crit_temp_tolerance
 			Temperature tolerance for critical temperature,
 			unit millidegree Celsius
 
-pwm[1-7]_step_up_time	milliseconds before fan speed is increased
-pwm[1-7]_step_down_time	milliseconds before fan speed is decreased
+pwm[1-7]_step_up_time
+			milliseconds before fan speed is increased
+
+pwm[1-7]_step_down_time
+			milliseconds before fan speed is decreased
 
 Usage Notes
 -----------
diff --git a/Documentation/hwmon/smm665 b/Documentation/hwmon/smm665
index a341eeedab75..a0e27f62b57b 100644
--- a/Documentation/hwmon/smm665
+++ b/Documentation/hwmon/smm665
@@ -2,31 +2,57 @@ Kernel driver smm665
 ====================
 
 Supported chips:
+
   * Summit Microelectronics SMM465
+
     Prefix: 'smm465'
+
     Addresses scanned: -
+
     Datasheet:
+
       http://www.summitmicro.com/prod_select/summary/SMM465/SMM465DS.pdf
+
   * Summit Microelectronics SMM665, SMM665B
+
     Prefix: 'smm665'
+
     Addresses scanned: -
+
     Datasheet:
+
       http://www.summitmicro.com/prod_select/summary/SMM665/SMM665B_2089_20.pdf
+
   * Summit Microelectronics SMM665C
+
     Prefix: 'smm665c'
+
     Addresses scanned: -
+
     Datasheet:
+
       http://www.summitmicro.com/prod_select/summary/SMM665C/SMM665C_2125.pdf
+
   * Summit Microelectronics SMM764
+
     Prefix: 'smm764'
+
     Addresses scanned: -
+
     Datasheet:
+
       http://www.summitmicro.com/prod_select/summary/SMM764/SMM764_2098.pdf
+
   * Summit Microelectronics SMM766, SMM766B
+
     Prefix: 'smm766'
+
     Addresses scanned: -
+
     Datasheets:
+
       http://www.summitmicro.com/prod_select/summary/SMM766/SMM766_2086.pdf
+
       http://www.summitmicro.com/prod_select/summary/SMM766B/SMM766B_2122.pdf
 
 Author: Guenter Roeck <linux@roeck-us.net>
@@ -36,9 +62,10 @@ Module Parameters
 -----------------
 
 * vref: int
-  Default: 1250 (mV)
-  Reference voltage on VREF_ADC pin in mV. It should not be necessary to set
-  this parameter unless a non-default reference voltage is used.
+    Default: 1250 (mV)
+
+    Reference voltage on VREF_ADC pin in mV. It should not be necessary to set
+    this parameter unless a non-default reference voltage is used.
 
 
 Description
@@ -64,9 +91,10 @@ the devices explicitly. When instantiating the device, you have to specify
 its configuration register address.
 
 Example: the following will load the driver for an SMM665 at address 0x57
-on I2C bus #1:
-$ modprobe smm665
-$ echo smm665 0x57 > /sys/bus/i2c/devices/i2c-1/new_device
+on I2C bus #1::
+
+	$ modprobe smm665
+	$ echo smm665 0x57 > /sys/bus/i2c/devices/i2c-1/new_device
 
 
 Sysfs entries
@@ -84,6 +112,7 @@ max otherwise. For details please see the SMM665 datasheet.
 
 For SMM465 and SMM764, values for Channel E and F are reported but undefined.
 
+======================= =======================================================
 in1_input		12V input voltage (mV)
 in2_input		3.3V (VDD) input voltage (mV)
 in3_input		Channel A voltage (mV)
@@ -155,3 +184,4 @@ temp1_min		Mimimum chip temperature
 temp1_max		Maximum chip temperature
 temp1_crit		Critical chip temperature
 temp1_crit_alarm	Temperature critical alarm
+======================= =======================================================
diff --git a/Documentation/hwmon/tmp401 b/Documentation/hwmon/tmp401
index 2d9ca42213cf..bd865bbdb38d 100644
--- a/Documentation/hwmon/tmp401
+++ b/Documentation/hwmon/tmp401
@@ -2,33 +2,59 @@ Kernel driver tmp401
 ====================
 
 Supported chips:
+
   * Texas Instruments TMP401
+
     Prefix: 'tmp401'
+
     Addresses scanned: I2C 0x4c
+
     Datasheet: http://focus.ti.com/docs/prod/folders/print/tmp401.html
+
   * Texas Instruments TMP411
+
     Prefix: 'tmp411'
+
     Addresses scanned: I2C 0x4c, 0x4d, 0x4e
+
     Datasheet: http://focus.ti.com/docs/prod/folders/print/tmp411.html
+
   * Texas Instruments TMP431
+
     Prefix: 'tmp431'
+
     Addresses scanned: I2C 0x4c, 0x4d
+
     Datasheet: http://focus.ti.com/docs/prod/folders/print/tmp431.html
+
   * Texas Instruments TMP432
+
     Prefix: 'tmp432'
+
     Addresses scanned: I2C 0x4c, 0x4d
+
     Datasheet: http://focus.ti.com/docs/prod/folders/print/tmp432.html
+
   * Texas Instruments TMP435
+
     Prefix: 'tmp435'
+
     Addresses scanned: I2C 0x48 - 0x4f
+
     Datasheet: http://focus.ti.com/docs/prod/folders/print/tmp435.html
+
   * Texas Instruments TMP461
+
     Prefix: 'tmp461'
+
     Datasheet: http://www.ti.com/product/tmp461
 
+
+
 Authors:
-         Hans de Goede <hdegoede@redhat.com>
-	 Andre Prendel <andre.prendel@gmx.de>
+
+	- Hans de Goede <hdegoede@redhat.com>
+	- Andre Prendel <andre.prendel@gmx.de>
 
 Description
 -----------
-- 
2.20.1


^ permalink raw reply related	[flat|nested] 73+ messages in thread

* [PATCH v3 20/21] docs: hwmon: convert remaining files to ReST format
  2019-04-17  9:46                   ` [PATCH v3 00/21]Convert " Mauro Carvalho Chehab
                                       ` (18 preceding siblings ...)
  2019-04-17  9:46                     ` [PATCH v3 19/21] docs: hwmon: misc " Mauro Carvalho Chehab
@ 2019-04-17  9:46                     ` Mauro Carvalho Chehab
  2019-04-17  9:46                     ` [PATCH v3 21/21] docs: hwmon: Add an index file and rename docs to *.rst Mauro Carvalho Chehab
  20 siblings, 0 replies; 73+ messages in thread
From: Mauro Carvalho Chehab @ 2019-04-17  9:46 UTC (permalink / raw)
  To: Linux Doc Mailing List
  Cc: Mauro Carvalho Chehab, Mauro Carvalho Chehab, linux-kernel,
	Jonathan Corbet, Jean Delvare, Guenter Roeck, linux-hwmon

Convert all other hwmon files to ReST format, in order to allow
them to be parsed by Sphinx.

Signed-off-by: Mauro Carvalho Chehab <mchehab+samsung@kernel.org>
---
 Documentation/hwmon/ab8500               |   8 +-
 Documentation/hwmon/abituguru            |  97 +--
 Documentation/hwmon/abituguru-datasheet  | 160 ++---
 Documentation/hwmon/abituguru3           |  36 +-
 Documentation/hwmon/abx500               |   8 +-
 Documentation/hwmon/acpi_power_meter     |  23 +-
 Documentation/hwmon/ad7314               |   9 +
 Documentation/hwmon/adc128d818           |   7 +-
 Documentation/hwmon/adm1021              |  44 +-
 Documentation/hwmon/adm1025              |  13 +-
 Documentation/hwmon/adm1026              |  24 +-
 Documentation/hwmon/adm1031              |  16 +-
 Documentation/hwmon/adm9240              |  50 +-
 Documentation/hwmon/ads7828              |  29 +-
 Documentation/hwmon/adt7410              |  49 +-
 Documentation/hwmon/adt7411              |  20 +-
 Documentation/hwmon/adt7462              |  10 +-
 Documentation/hwmon/adt7470              |   8 +-
 Documentation/hwmon/adt7475              |  38 +-
 Documentation/hwmon/amc6821              |  19 +-
 Documentation/hwmon/asb100               |  50 +-
 Documentation/hwmon/ds1621               | 154 +++--
 Documentation/hwmon/ds620                |  12 +-
 Documentation/hwmon/emc1403              |  33 +-
 Documentation/hwmon/emc6w201             |   5 +
 Documentation/hwmon/f71805f              |  36 +-
 Documentation/hwmon/f71882fg             |  56 +-
 Documentation/hwmon/ftsteutates          |  14 +-
 Documentation/hwmon/g760a                |   4 +
 Documentation/hwmon/g762                 |  65 +-
 Documentation/hwmon/gl518sm              |  21 +-
 Documentation/hwmon/hih6130              |  14 +-
 Documentation/hwmon/hwmon-kernel-api.txt | 334 ++++++-----
 Documentation/hwmon/ibmaem               |  10 +-
 Documentation/hwmon/ina3221              |  21 +-
 Documentation/hwmon/it87                 | 102 +++-
 Documentation/hwmon/lineage-pem          |  16 +-
 Documentation/hwmon/lm63                 |  24 +-
 Documentation/hwmon/lm70                 |  13 +-
 Documentation/hwmon/lm73                 |  16 +-
 Documentation/hwmon/lm75                 |  96 ++-
 Documentation/hwmon/lm77                 |   9 +-
 Documentation/hwmon/lm78                 |  20 +-
 Documentation/hwmon/lm80                 |  19 +-
 Documentation/hwmon/lm83                 |  16 +-
 Documentation/hwmon/lm85                 |  97 ++-
 Documentation/hwmon/lm87                 |  23 +-
 Documentation/hwmon/lm90                 | 174 +++++-
 Documentation/hwmon/lm92                 |  17 +-
 Documentation/hwmon/lm93                 | 157 ++---
 Documentation/hwmon/lm95245              |  13 +-
 Documentation/hwmon/ltc2945              |  16 +-
 Documentation/hwmon/ltc2990              |  23 +-
 Documentation/hwmon/ltc4151              |  16 +-
 Documentation/hwmon/ltc4215              |  16 +-
 Documentation/hwmon/ltc4245              |  17 +-
 Documentation/hwmon/ltc4260              |  16 +-
 Documentation/hwmon/max1619              |  11 +-
 Documentation/hwmon/max1668              |  14 +-
 Documentation/hwmon/max197               |  36 +-
 Documentation/hwmon/max31722             |  12 +
 Documentation/hwmon/max31790             |   6 +
 Documentation/hwmon/max6639              |  16 +-
 Documentation/hwmon/max6642              |  10 +-
 Documentation/hwmon/max6650              |  16 +-
 Documentation/hwmon/mc13783-adc          |  27 +-
 Documentation/hwmon/mcp3021              |  15 +-
 Documentation/hwmon/mlxreg-fan           |  60 +-
 Documentation/hwmon/nct6683              |  11 +-
 Documentation/hwmon/nct7802              |  11 +-
 Documentation/hwmon/nct7904              |   9 +-
 Documentation/hwmon/npcm750-pwm-fan      |   4 +
 Documentation/hwmon/nsa320               |  15 +-
 Documentation/hwmon/ntc_thermistor       | 123 ++--
 Documentation/hwmon/occ                  |  93 ++-
 Documentation/hwmon/pc87427              |   4 +
 Documentation/hwmon/pcf8591              |  52 +-
 Documentation/hwmon/powr1220             |  12 +-
 Documentation/hwmon/raspberrypi-hwmon    |   3 +
 Documentation/hwmon/sch5636              |   3 +
 Documentation/hwmon/scpi-hwmon           |   7 +-
 Documentation/hwmon/sht15                |  28 +-
 Documentation/hwmon/sht21                |  24 +-
 Documentation/hwmon/sht3x                |  42 +-
 Documentation/hwmon/shtc1                |  19 +-
 Documentation/hwmon/sis5595              |  40 +-
 Documentation/hwmon/smsc47b397           | 158 +++--
 Documentation/hwmon/smsc47m1             |  43 +-
 Documentation/hwmon/smsc47m192           |  97 +--
 Documentation/hwmon/submitting-patches   |  15 +-
 Documentation/hwmon/sysfs-interface      | 727 +++++++++++++++--------
 Documentation/hwmon/tc654                |   9 +-
 Documentation/hwmon/tc74                 |   3 +
 Documentation/hwmon/thmc50               |  36 +-
 Documentation/hwmon/tmp102               |   5 +
 Documentation/hwmon/tmp103               |   5 +
 Documentation/hwmon/tmp108               |   5 +
 Documentation/hwmon/tmp421               |  26 +-
 Documentation/hwmon/twl4030-madc-hwmon   |   8 +-
 Documentation/hwmon/userspace-tools      |   3 +
 Documentation/hwmon/via686a              |  30 +-
 Documentation/hwmon/w83627ehf            | 160 +++--
 Documentation/hwmon/w83627hf             |  65 +-
 Documentation/hwmon/w83773g              |  12 +-
 Documentation/hwmon/w83781d              | 330 +++++-----
 Documentation/hwmon/w83792d              | 112 ++--
 Documentation/hwmon/w83795               | 221 +++----
 Documentation/hwmon/w83l785ts            |   9 +-
 Documentation/hwmon/w83l786ng            |  42 +-
 Documentation/hwmon/xgene-hwmon          |  24 +-
 110 files changed, 3543 insertions(+), 1738 deletions(-)

diff --git a/Documentation/hwmon/ab8500 b/Documentation/hwmon/ab8500
index cf169c8ef4e3..d87c61151239 100644
--- a/Documentation/hwmon/ab8500
+++ b/Documentation/hwmon/ab8500
@@ -2,14 +2,18 @@ Kernel driver ab8500
 ====================
 
 Supported chips:
+
   * ST-Ericsson AB8500
+
     Prefix: 'ab8500'
+
     Addresses scanned: -
+
     Datasheet: http://www.stericsson.com/developers/documentation.jsp
 
 Authors:
-        Martin Persson <martin.persson@stericsson.com>
-        Hongbo Zhang <hongbo.zhang@linaro.org>
+	- Martin Persson <martin.persson@stericsson.com>
+	- Hongbo Zhang <hongbo.zhang@linaro.org>
 
 Description
 -----------
diff --git a/Documentation/hwmon/abituguru b/Documentation/hwmon/abituguru
index 44013d23b3f0..d8243c827de9 100644
--- a/Documentation/hwmon/abituguru
+++ b/Documentation/hwmon/abituguru
@@ -2,69 +2,85 @@ Kernel driver abituguru
 =======================
 
 Supported chips:
+
   * Abit uGuru revision 1 & 2 (Hardware Monitor part only)
+
     Prefix: 'abituguru'
+
     Addresses scanned: ISA 0x0E0
+
     Datasheet: Not available, this driver is based on reverse engineering.
-	A "Datasheet" has been written based on the reverse engineering it
-	should be available in the same dir as this file under the name
-	abituguru-datasheet.
+    A "Datasheet" has been written based on the reverse engineering it
+    should be available in the same dir as this file under the name
+    abituguru-datasheet.
+
     Note:
 	The uGuru is a microcontroller with onboard firmware which programs
 	it to behave as a hwmon IC. There are many different revisions of the
 	firmware and thus effectivly many different revisions of the uGuru.
 	Below is an incomplete list with which revisions are used for which
 	Motherboards:
-	uGuru 1.00    ~ 1.24    (AI7, KV8-MAX3, AN7) (1)
-	uGuru 2.0.0.0 ~ 2.0.4.2 (KV8-PRO)
-	uGuru 2.1.0.0 ~ 2.1.2.8 (AS8, AV8, AA8, AG8, AA8XE, AX8)
-	uGuru 2.2.0.0 ~ 2.2.0.6 (AA8 Fatal1ty)
-	uGuru 2.3.0.0 ~ 2.3.0.9 (AN8)
-	uGuru 3.0.0.0 ~ 3.0.x.x (AW8, AL8, AT8, NI8 SLI, AT8 32X, AN8 32X,
-				 AW9D-MAX) (2)
-	1) For revisions 2 and 3 uGuru's the driver can autodetect the
-	   sensortype (Volt or Temp) for bank1 sensors, for revision 1 uGuru's
-	   this does not always work. For these uGuru's the autodetection can
-	   be overridden with the bank1_types module param. For all 3 known
-	   revison 1 motherboards the correct use of this param is:
-	   bank1_types=1,1,0,0,0,0,0,2,0,0,0,0,2,0,0,1
-	   You may also need to specify the fan_sensors option for these boards
-	   fan_sensors=5
-	2) There is a separate abituguru3 driver for these motherboards,
-	   the abituguru (without the 3 !) driver will not work on these
-	   motherboards (and visa versa)!
+
+	- uGuru 1.00    ~ 1.24    (AI7, KV8-MAX3, AN7) [1]_
+	- uGuru 2.0.0.0 ~ 2.0.4.2 (KV8-PRO)
+	- uGuru 2.1.0.0 ~ 2.1.2.8 (AS8, AV8, AA8, AG8, AA8XE, AX8)
+	- uGuru 2.2.0.0 ~ 2.2.0.6 (AA8 Fatal1ty)
+	- uGuru 2.3.0.0 ~ 2.3.0.9 (AN8)
+	- uGuru 3.0.0.0 ~ 3.0.x.x (AW8, AL8, AT8, NI8 SLI, AT8 32X, AN8 32X,
+	  AW9D-MAX) [2]_
+
+.. [1]  For revisions 2 and 3 uGuru's the driver can autodetect the
+	sensortype (Volt or Temp) for bank1 sensors, for revision 1 uGuru's
+	this does not always work. For these uGuru's the autodetection can
+	be overridden with the bank1_types module param. For all 3 known
+	revison 1 motherboards the correct use of this param is:
+	bank1_types=1,1,0,0,0,0,0,2,0,0,0,0,2,0,0,1
+	You may also need to specify the fan_sensors option for these boards
+	fan_sensors=5
+
+.. [2]  There is a separate abituguru3 driver for these motherboards,
+	the abituguru (without the 3 !) driver will not work on these
+	motherboards (and visa versa)!
 
 Authors:
-	Hans de Goede <j.w.r.degoede@hhs.nl>,
-	(Initial reverse engineering done by Olle Sandberg
-	 <ollebull@gmail.com>)
+	- Hans de Goede <j.w.r.degoede@hhs.nl>,
+	- (Initial reverse engineering done by Olle Sandberg
+	  <ollebull@gmail.com>)
 
 
 Module Parameters
 -----------------
 
-* force: bool		Force detection. Note this parameter only causes the
+* force: bool
+			Force detection. Note this parameter only causes the
 			detection to be skipped, and thus the insmod to
 			succeed. If the uGuru can't be read the actual hwmon
 			driver will not load and thus no hwmon device will get
 			registered.
-* bank1_types: int[]	Bank1 sensortype autodetection override:
-			  -1 autodetect (default)
-			   0 volt sensor
-			   1 temp sensor
-			   2 not connected
-* fan_sensors: int	Tell the driver how many fan speed sensors there are
+* bank1_types: int[]
+			Bank1 sensortype autodetection override:
+
+			  * -1 autodetect (default)
+			  *  0 volt sensor
+			  *  1 temp sensor
+			  *  2 not connected
+* fan_sensors: int
+			Tell the driver how many fan speed sensors there are
 			on your motherboard. Default: 0 (autodetect).
-* pwms: int		Tell the driver how many fan speed controls (fan
+* pwms: int
+			Tell the driver how many fan speed controls (fan
 			pwms) your motherboard has. Default: 0 (autodetect).
-* verbose: int		How verbose should the driver be? (0-3):
-			   0 normal output
-			   1 + verbose error reporting
-			   2 + sensors type probing info (default)
-			   3 + retryable error reporting
+* verbose: int
+			How verbose should the driver be? (0-3):
+
+			   * 0 normal output
+			   * 1 + verbose error reporting
+			   * 2 + sensors type probing info (default)
+			   * 3 + retryable error reporting
+
 			Default: 2 (the driver is still in the testing phase)
 
-Notice if you need any of the first three options above please insmod the
+Notice: if you need any of the first three options above please insmod the
 driver with verbose set to 3 and mail me <j.w.r.degoede@hhs.nl> the output of:
 dmesg | grep abituguru
 
@@ -90,3 +106,8 @@ Known Issues
 ------------
 
 The voltage and frequency control parts of the Abit uGuru are not supported.
+
+.. toctree::
+   :maxdepth: 1
+
+   abituguru-datasheet.rst
diff --git a/Documentation/hwmon/abituguru-datasheet b/Documentation/hwmon/abituguru-datasheet
index 86c0b1251c81..6d5253e2223b 100644
--- a/Documentation/hwmon/abituguru-datasheet
+++ b/Documentation/hwmon/abituguru-datasheet
@@ -1,3 +1,4 @@
+===============
 uGuru datasheet
 ===============
 
@@ -168,34 +169,35 @@ This bank contains 0 sensors, iow the sensor address is ignored (but must be
 written) just use 0. Bank 0x20 contains 3 bytes:
 
 Byte 0:
-This byte holds the alarm flags for sensor 0-7 of Sensor Bank1, with bit 0
-corresponding to sensor 0, 1 to 1, etc.
+  This byte holds the alarm flags for sensor 0-7 of Sensor Bank1, with bit 0
+  corresponding to sensor 0, 1 to 1, etc.
 
 Byte 1:
-This byte holds the alarm flags for sensor 8-15 of Sensor Bank1, with bit 0
-corresponding to sensor 8, 1 to 9, etc.
+  This byte holds the alarm flags for sensor 8-15 of Sensor Bank1, with bit 0
+  corresponding to sensor 8, 1 to 9, etc.
 
 Byte 2:
-This byte holds the alarm flags for sensor 0-5 of Sensor Bank2, with bit 0
-corresponding to sensor 0, 1 to 1, etc.
+  This byte holds the alarm flags for sensor 0-5 of Sensor Bank2, with bit 0
+  corresponding to sensor 0, 1 to 1, etc.
 
 
 Bank 0x21 Sensor Bank1 Values / Readings (R)
 --------------------------------------------
 This bank contains 16 sensors, for each sensor it contains 1 byte.
 So far the following sensors are known to be available on all motherboards:
-Sensor  0 CPU temp
-Sensor  1 SYS temp
-Sensor  3 CPU core volt
-Sensor  4 DDR volt
-Sensor 10 DDR Vtt volt
-Sensor 15 PWM temp
+
+- Sensor  0 CPU temp
+- Sensor  1 SYS temp
+- Sensor  3 CPU core volt
+- Sensor  4 DDR volt
+- Sensor 10 DDR Vtt volt
+- Sensor 15 PWM temp
 
 Byte 0:
-This byte holds the reading from the sensor. Sensors in Bank1 can be both
-volt and temp sensors, this is motherboard specific. The uGuru however does
-seem to know (be programmed with) what kindoff sensor is attached see Sensor
-Bank1 Settings description.
+  This byte holds the reading from the sensor. Sensors in Bank1 can be both
+  volt and temp sensors, this is motherboard specific. The uGuru however does
+  seem to know (be programmed with) what kindoff sensor is attached see Sensor
+  Bank1 Settings description.
 
 Volt sensors use a linear scale, a reading 0 corresponds with 0 volt and a
 reading of 255 with 3494 mV. The sensors for higher voltages however are
@@ -207,96 +209,118 @@ Temp sensors also use a linear scale, a reading of 0 corresponds with 0 degree
 Celsius and a reading of 255 with a reading of 255 degrees Celsius.
 
 
-Bank 0x22 Sensor Bank1 Settings (R)
-Bank 0x23 Sensor Bank1 Settings (W)
------------------------------------
+Bank 0x22 Sensor Bank1 Settings (R) and Bank 0x23 Sensor Bank1 Settings (W)
+---------------------------------------------------------------------------
 
-This bank contains 16 sensors, for each sensor it contains 3 bytes. Each
+Those banks contain 16 sensors, for each sensor it contains 3 bytes. Each
 set of 3 bytes contains the settings for the sensor with the same sensor
 address in Bank 0x21 .
 
 Byte 0:
-Alarm behaviour for the selected sensor. A 1 enables the described behaviour.
-Bit 0: Give an alarm if measured temp is over the warning threshold	(RW) *
-Bit 1: Give an alarm if measured volt is over the max threshold		(RW) **
-Bit 2: Give an alarm if measured volt is under the min threshold	(RW) **
-Bit 3: Beep if alarm							(RW)
-Bit 4: 1 if alarm cause measured temp is over the warning threshold	(R)
-Bit 5: 1 if alarm cause measured volt is over the max threshold		(R)
-Bit 6: 1 if alarm cause measured volt is under the min threshold	(R)
-Bit 7: Volt sensor: Shutdown if alarm persist for more than 4 seconds	(RW)
-       Temp sensor: Shutdown if temp is over the shutdown threshold	(RW)
-
-*  This bit is only honored/used by the uGuru if a temp sensor is connected
-** This bit is only honored/used by the uGuru if a volt sensor is connected
-Note with some trickery this can be used to find out what kinda sensor is
-detected see the Linux kernel driver for an example with many comments on
-how todo this.
+  Alarm behaviour for the selected sensor. A 1 enables the described
+  behaviour.
+
+Bit 0:
+  Give an alarm if measured temp is over the warning threshold		(RW) [1]_
+
+Bit 1:
+  Give an alarm if measured volt is over the max threshold		(RW) [2]_
+
+Bit 2:
+  Give an alarm if measured volt is under the min threshold		(RW) [2]_
+
+Bit 3:
+  Beep if alarm								(RW)
+
+Bit 4:
+  1 if alarm cause measured temp is over the warning threshold		(R)
+
+Bit 5:
+  1 if alarm cause measured volt is over the max threshold		(R)
+
+Bit 6:
+  1 if alarm cause measured volt is under the min threshold		(R)
+
+Bit 7:
+  - Volt sensor: Shutdown if alarm persist for more than 4 seconds	(RW)
+  - Temp sensor: Shutdown if temp is over the shutdown threshold	(RW)
+
+.. [1] This bit is only honored/used by the uGuru if a temp sensor is connected
+
+.. [2] This bit is only honored/used by the uGuru if a volt sensor is connected
+       Note with some trickery this can be used to find out what kinda sensor
+       is detected see the Linux kernel driver for an example with many
+       comments on how todo this.
 
 Byte 1:
-Temp sensor: warning threshold  (scale as bank 0x21)
-Volt sensor: min threshold      (scale as bank 0x21)
+  - Temp sensor: warning threshold  (scale as bank 0x21)
+  - Volt sensor: min threshold      (scale as bank 0x21)
 
 Byte 2:
-Temp sensor: shutdown threshold (scale as bank 0x21)
-Volt sensor: max threshold      (scale as bank 0x21)
+  - Temp sensor: shutdown threshold (scale as bank 0x21)
+  - Volt sensor: max threshold      (scale as bank 0x21)
 
 
-Bank 0x24 PWM outputs for FAN's (R)
-Bank 0x25 PWM outputs for FAN's (W)
------------------------------------
+Bank 0x24 PWM outputs for FAN's (R) and Bank 0x25 PWM outputs for FAN's (W)
+---------------------------------------------------------------------------
 
-This bank contains 3 "sensors", for each sensor it contains 5 bytes.
-Sensor 0 usually controls the CPU fan
-Sensor 1 usually controls the NB (or chipset for single chip) fan
-Sensor 2 usually controls the System fan
+Those banks contain 3 "sensors", for each sensor it contains 5 bytes.
+  - Sensor 0 usually controls the CPU fan
+  - Sensor 1 usually controls the NB (or chipset for single chip) fan
+  - Sensor 2 usually controls the System fan
 
 Byte 0:
-Flag 0x80 to enable control, Fan runs at 100% when disabled.
-low nibble (temp)sensor address at bank 0x21 used for control.
+  Flag 0x80 to enable control, Fan runs at 100% when disabled.
+  low nibble (temp)sensor address at bank 0x21 used for control.
 
 Byte 1:
-0-255 = 0-12v (linear), specify voltage at which fan will rotate when under
-low threshold temp (specified in byte 3)
+  0-255 = 0-12v (linear), specify voltage at which fan will rotate when under
+  low threshold temp (specified in byte 3)
 
 Byte 2:
-0-255 = 0-12v (linear), specify voltage at which fan will rotate when above
-high threshold temp (specified in byte 4)
+  0-255 = 0-12v (linear), specify voltage at which fan will rotate when above
+  high threshold temp (specified in byte 4)
 
 Byte 3:
-Low threshold temp  (scale as bank 0x21)
+  Low threshold temp  (scale as bank 0x21)
 
 byte 4:
-High threshold temp (scale as bank 0x21)
+  High threshold temp (scale as bank 0x21)
 
 
 Bank 0x26 Sensors Bank2 Values / Readings (R)
 ---------------------------------------------
 
 This bank contains 6 sensors (AFAIK), for each sensor it contains 1 byte.
+
 So far the following sensors are known to be available on all motherboards:
-Sensor 0: CPU fan speed
-Sensor 1: NB (or chipset for single chip) fan speed
-Sensor 2: SYS fan speed
+  - Sensor 0: CPU fan speed
+  - Sensor 1: NB (or chipset for single chip) fan speed
+  - Sensor 2: SYS fan speed
 
 Byte 0:
-This byte holds the reading from the sensor. 0-255 = 0-15300 (linear)
+  This byte holds the reading from the sensor. 0-255 = 0-15300 (linear)
 
 
-Bank 0x27 Sensors Bank2 Settings (R)
-Bank 0x28 Sensors Bank2 Settings (W)
-------------------------------------
+Bank 0x27 Sensors Bank2 Settings (R) and Bank 0x28 Sensors Bank2 Settings (W)
+-----------------------------------------------------------------------------
 
-This bank contains 6 sensors (AFAIK), for each sensor it contains 2 bytes.
+Those banks contain 6 sensors (AFAIK), for each sensor it contains 2 bytes.
 
 Byte 0:
-Alarm behaviour for the selected sensor. A 1 enables the described behaviour.
-Bit 0: Give an alarm if measured rpm is under the min threshold	(RW)
-Bit 3: Beep if alarm						(RW)
-Bit 7: Shutdown if alarm persist for more than 4 seconds	(RW)
+  Alarm behaviour for the selected sensor. A 1 enables the described behaviour.
+
+Bit 0:
+  Give an alarm if measured rpm is under the min threshold	(RW)
+
+Bit 3:
+  Beep if alarm							(RW)
+
+Bit 7:
+  Shutdown if alarm persist for more than 4 seconds		(RW)
 
 Byte 1:
-min threshold (scale as bank 0x26)
+  min threshold (scale as bank 0x26)
 
 
 Warning for the adventurous
diff --git a/Documentation/hwmon/abituguru3 b/Documentation/hwmon/abituguru3
index a6ccfe4bb6aa..514f11f41e8b 100644
--- a/Documentation/hwmon/abituguru3
+++ b/Documentation/hwmon/abituguru3
@@ -3,41 +3,51 @@ Kernel driver abituguru3
 
 Supported chips:
   * Abit uGuru revision 3 (Hardware Monitor part, reading only)
+
     Prefix: 'abituguru3'
+
     Addresses scanned: ISA 0x0E0
+
     Datasheet: Not available, this driver is based on reverse engineering.
+
     Note:
 	The uGuru is a microcontroller with onboard firmware which programs
 	it to behave as a hwmon IC. There are many different revisions of the
 	firmware and thus effectivly many different revisions of the uGuru.
 	Below is an incomplete list with which revisions are used for which
 	Motherboards:
-	uGuru 1.00    ~ 1.24    (AI7, KV8-MAX3, AN7)
-	uGuru 2.0.0.0 ~ 2.0.4.2 (KV8-PRO)
-	uGuru 2.1.0.0 ~ 2.1.2.8 (AS8, AV8, AA8, AG8, AA8XE, AX8)
-	uGuru 2.3.0.0 ~ 2.3.0.9 (AN8)
-	uGuru 3.0.0.0 ~ 3.0.x.x (AW8, AL8, AT8, NI8 SLI, AT8 32X, AN8 32X,
-				 AW9D-MAX)
+
+	- uGuru 1.00    ~ 1.24    (AI7, KV8-MAX3, AN7)
+	- uGuru 2.0.0.0 ~ 2.0.4.2 (KV8-PRO)
+	- uGuru 2.1.0.0 ~ 2.1.2.8 (AS8, AV8, AA8, AG8, AA8XE, AX8)
+	- uGuru 2.3.0.0 ~ 2.3.0.9 (AN8)
+	- uGuru 3.0.0.0 ~ 3.0.x.x (AW8, AL8, AT8, NI8 SLI, AT8 32X, AN8 32X,
+	  AW9D-MAX)
+
 	The abituguru3 driver is only for revison 3.0.x.x motherboards,
 	this driver will not work on older motherboards. For older
 	motherboards use the abituguru (without the 3 !) driver.
 
 Authors:
-	Hans de Goede <j.w.r.degoede@hhs.nl>,
-	(Initial reverse engineering done by Louis Kruger)
+	- Hans de Goede <j.w.r.degoede@hhs.nl>,
+	- (Initial reverse engineering done by Louis Kruger)
 
 
 Module Parameters
 -----------------
 
-* force: bool		Force detection. Note this parameter only causes the
+* force: bool
+			Force detection. Note this parameter only causes the
 			detection to be skipped, and thus the insmod to
 			succeed. If the uGuru can't be read the actual hwmon
 			driver will not load and thus no hwmon device will get
 			registered.
-* verbose: bool		Should the driver be verbose?
-			0/off/false  normal output
-			1/on/true    + verbose error reporting (default)
+* verbose: bool
+			Should the driver be verbose?
+
+			* 0/off/false  normal output
+			* 1/on/true    + verbose error reporting (default)
+
 			Default: 1 (the driver is still in the testing phase)
 
 Description
@@ -62,4 +72,4 @@ neither is writing any of the sensor settings and writing / reading the
 fanspeed control registers (FanEQ)
 
 If you encounter any problems please mail me <j.w.r.degoede@hhs.nl> and
-include the output of: "dmesg | grep abituguru"
+include the output of: `dmesg | grep abituguru`
diff --git a/Documentation/hwmon/abx500 b/Documentation/hwmon/abx500
index 319a058cec7c..3d88b2ce0f00 100644
--- a/Documentation/hwmon/abx500
+++ b/Documentation/hwmon/abx500
@@ -2,14 +2,18 @@ Kernel driver abx500
 ====================
 
 Supported chips:
+
   * ST-Ericsson ABx500 series
+
     Prefix: 'abx500'
+
     Addresses scanned: -
+
     Datasheet: http://www.stericsson.com/developers/documentation.jsp
 
 Authors:
-        Martin Persson <martin.persson@stericsson.com>
-        Hongbo Zhang <hongbo.zhang@linaro.org>
+	Martin Persson <martin.persson@stericsson.com>
+	Hongbo Zhang <hongbo.zhang@linaro.org>
 
 Description
 -----------
diff --git a/Documentation/hwmon/acpi_power_meter b/Documentation/hwmon/acpi_power_meter
index c80399a00c50..7665ca6ba957 100644
--- a/Documentation/hwmon/acpi_power_meter
+++ b/Documentation/hwmon/acpi_power_meter
@@ -4,8 +4,11 @@ Kernel driver power_meter
 This driver talks to ACPI 4.0 power meters.
 
 Supported systems:
+
   * Any recent system with ACPI 4.0.
+
     Prefix: 'power_meter'
+
     Datasheet: http://acpi.info/, section 10.4.
 
 Author: Darrick J. Wong
@@ -23,21 +26,21 @@ of Documentation/hwmon/sysfs-interface.
 Special Features
 ----------------
 
-The power[1-*]_is_battery knob indicates if the power supply is a battery.
-Both power[1-*]_average_{min,max} must be set before the trip points will work.
+The `power[1-*]_is_battery` knob indicates if the power supply is a battery.
+Both `power[1-*]_average_{min,max}` must be set before the trip points will work.
 When both of them are set, an ACPI event will be broadcast on the ACPI netlink
 socket and a poll notification will be sent to the appropriate
-power[1-*]_average sysfs file.
+`power[1-*]_average` sysfs file.
 
-The power[1-*]_{model_number, serial_number, oem_info} fields display arbitrary
-strings that ACPI provides with the meter.  The measures/ directory contains
-symlinks to the devices that this meter measures.
+The `power[1-*]_{model_number, serial_number, oem_info}` fields display
+arbitrary strings that ACPI provides with the meter.  The measures/ directory
+contains symlinks to the devices that this meter measures.
 
 Some computers have the ability to enforce a power cap in hardware.  If this is
-the case, the power[1-*]_cap and related sysfs files will appear.  When the
+the case, the `power[1-*]_cap` and related sysfs files will appear.  When the
 average power consumption exceeds the cap, an ACPI event will be broadcast on
 the netlink event socket and a poll notification will be sent to the
-appropriate power[1-*]_alarm file to indicate that capping has begun, and the
+appropriate `power[1-*]_alarm` file to indicate that capping has begun, and the
 hardware has taken action to reduce power consumption.  Most likely this will
 result in reduced performance.
 
@@ -46,6 +49,6 @@ all cases the ACPI event will be broadcast on the ACPI netlink event socket as
 well as sent as a poll notification to a sysfs file.  The events are as
 follows:
 
-power[1-*]_cap will be notified if the firmware changes the power cap.
-power[1-*]_interval will be notified if the firmware changes the averaging
+`power[1-*]_cap` will be notified if the firmware changes the power cap.
+`power[1-*]_interval` will be notified if the firmware changes the averaging
 interval.
diff --git a/Documentation/hwmon/ad7314 b/Documentation/hwmon/ad7314
index 1912549c7467..bf389736bcd1 100644
--- a/Documentation/hwmon/ad7314
+++ b/Documentation/hwmon/ad7314
@@ -2,14 +2,23 @@ Kernel driver ad7314
 ====================
 
 Supported chips:
+
    * Analog Devices AD7314
+
      Prefix: 'ad7314'
+
      Datasheet: Publicly available at Analog Devices website.
+
    * Analog Devices ADT7301
+
      Prefix: 'adt7301'
+
      Datasheet: Publicly available at Analog Devices website.
+
    * Analog Devices ADT7302
+
      Prefix: 'adt7302'
+
      Datasheet: Publicly available at Analog Devices website.
 
 Description
diff --git a/Documentation/hwmon/adc128d818 b/Documentation/hwmon/adc128d818
index 39c95004dabc..6753468932ab 100644
--- a/Documentation/hwmon/adc128d818
+++ b/Documentation/hwmon/adc128d818
@@ -2,11 +2,14 @@ Kernel driver adc128d818
 ========================
 
 Supported chips:
+
   * Texas Instruments ADC818D818
+
     Prefix: 'adc818d818'
+
     Addresses scanned: I2C 0x1d, 0x1e, 0x1f, 0x2d, 0x2e, 0x2f
-    Datasheet: Publicly available at the TI website
-               http://www.ti.com/
+
+    Datasheet: Publicly available at the TI website http://www.ti.com/
 
 Author: Guenter Roeck
 
diff --git a/Documentation/hwmon/adm1021 b/Documentation/hwmon/adm1021
index 02ad96cf9b2b..6cbb0f75fe00 100644
--- a/Documentation/hwmon/adm1021
+++ b/Documentation/hwmon/adm1021
@@ -2,51 +2,91 @@ Kernel driver adm1021
 =====================
 
 Supported chips:
+
   * Analog Devices ADM1021
+
     Prefix: 'adm1021'
+
     Addresses scanned: I2C 0x18 - 0x1a, 0x29 - 0x2b, 0x4c - 0x4e
+
     Datasheet: Publicly available at the Analog Devices website
+
   * Analog Devices ADM1021A/ADM1023
+
     Prefix: 'adm1023'
+
     Addresses scanned: I2C 0x18 - 0x1a, 0x29 - 0x2b, 0x4c - 0x4e
+
     Datasheet: Publicly available at the Analog Devices website
+
   * Genesys Logic GL523SM
+
     Prefix: 'gl523sm'
+
     Addresses scanned: I2C 0x18 - 0x1a, 0x29 - 0x2b, 0x4c - 0x4e
+
     Datasheet:
+
   * Maxim MAX1617
+
     Prefix: 'max1617'
+
     Addresses scanned: I2C 0x18 - 0x1a, 0x29 - 0x2b, 0x4c - 0x4e
+
     Datasheet: Publicly available at the Maxim website
+
   * Maxim MAX1617A
+
     Prefix: 'max1617a'
+
     Addresses scanned: I2C 0x18 - 0x1a, 0x29 - 0x2b, 0x4c - 0x4e
+
     Datasheet: Publicly available at the Maxim website
+
   * National Semiconductor LM84
+
     Prefix: 'lm84'
+
     Addresses scanned: I2C 0x18 - 0x1a, 0x29 - 0x2b, 0x4c - 0x4e
+
     Datasheet: Publicly available at the National Semiconductor website
+
   * Philips NE1617
+
     Prefix: 'max1617' (probably detected as a max1617)
+
     Addresses scanned: I2C 0x18 - 0x1a, 0x29 - 0x2b, 0x4c - 0x4e
+
     Datasheet: Publicly available at the Philips website
+
   * Philips NE1617A
+
     Prefix: 'max1617' (probably detected as a max1617)
+
     Addresses scanned: I2C 0x18 - 0x1a, 0x29 - 0x2b, 0x4c - 0x4e
+
     Datasheet: Publicly available at the Philips website
+
   * TI THMC10
+
     Prefix: 'thmc10'
+
     Addresses scanned: I2C 0x18 - 0x1a, 0x29 - 0x2b, 0x4c - 0x4e
+
     Datasheet: Publicly available at the TI website
+
   * Onsemi MC1066
+
     Prefix: 'mc1066'
+
     Addresses scanned: I2C 0x18 - 0x1a, 0x29 - 0x2b, 0x4c - 0x4e
+
     Datasheet: Publicly available at the Onsemi website
 
 
 Authors:
-        Frodo Looijaard <frodol@dds.nl>,
-        Philip Edelbrock <phil@netroedge.com>
+	- Frodo Looijaard <frodol@dds.nl>,
+	- Philip Edelbrock <phil@netroedge.com>
 
 Module Parameters
 -----------------
diff --git a/Documentation/hwmon/adm1025 b/Documentation/hwmon/adm1025
index 99f05049c68a..283e65e348a5 100644
--- a/Documentation/hwmon/adm1025
+++ b/Documentation/hwmon/adm1025
@@ -2,23 +2,32 @@ Kernel driver adm1025
 =====================
 
 Supported chips:
+
   * Analog Devices ADM1025, ADM1025A
+
     Prefix: 'adm1025'
+
     Addresses scanned: I2C 0x2c - 0x2e
+
     Datasheet: Publicly available at the Analog Devices website
+
   * Philips NE1619
+
     Prefix: 'ne1619'
+
     Addresses scanned: I2C 0x2c - 0x2d
+
     Datasheet: Publicly available at the Philips website
 
 The NE1619 presents some differences with the original ADM1025:
+
   * Only two possible addresses (0x2c - 0x2d).
   * No temperature offset register, but we don't use it anyway.
   * No INT mode for pin 16. We don't play with it anyway.
 
 Authors:
-        Chen-Yuan Wu <gwu@esoft.com>,
-        Jean Delvare <jdelvare@suse.de>
+	- Chen-Yuan Wu <gwu@esoft.com>,
+	- Jean Delvare <jdelvare@suse.de>
 
 Description
 -----------
diff --git a/Documentation/hwmon/adm1026 b/Documentation/hwmon/adm1026
index d8fabe0c23ac..35d63e6498a3 100644
--- a/Documentation/hwmon/adm1026
+++ b/Documentation/hwmon/adm1026
@@ -3,28 +3,36 @@ Kernel driver adm1026
 
 Supported chips:
   * Analog Devices ADM1026
+
     Prefix: 'adm1026'
+
     Addresses scanned: I2C 0x2c, 0x2d, 0x2e
+
     Datasheet: Publicly available at the Analog Devices website
-               http://www.onsemi.com/PowerSolutions/product.do?id=ADM1026
+
+	       http://www.onsemi.com/PowerSolutions/product.do?id=ADM1026
 
 Authors:
-        Philip Pokorny <ppokorny@penguincomputing.com> for Penguin Computing
-        Justin Thiessen <jthiessen@penguincomputing.com>
+	- Philip Pokorny <ppokorny@penguincomputing.com> for Penguin Computing
+	- Justin Thiessen <jthiessen@penguincomputing.com>
 
 Module Parameters
 -----------------
 
 * gpio_input: int array (min = 1, max = 17)
-  List of GPIO pins (0-16) to program as inputs
+    List of GPIO pins (0-16) to program as inputs
+
 * gpio_output: int array (min = 1, max = 17)
-  List of GPIO pins (0-16) to program as outputs
+    List of GPIO pins (0-16) to program as outputs
+
 * gpio_inverted: int array (min = 1, max = 17)
-  List of GPIO pins (0-16) to program as inverted
+    List of GPIO pins (0-16) to program as inverted
+
 * gpio_normal: int array (min = 1, max = 17)
-  List of GPIO pins (0-16) to program as normal/non-inverted
+    List of GPIO pins (0-16) to program as normal/non-inverted
+
 * gpio_fan: int array (min = 1, max = 8)
-  List of GPIO pins (0-7) to program as fan tachs
+    List of GPIO pins (0-7) to program as fan tachs
 
 
 Description
diff --git a/Documentation/hwmon/adm1031 b/Documentation/hwmon/adm1031
index a143117c99cb..a677c3ab5574 100644
--- a/Documentation/hwmon/adm1031
+++ b/Documentation/hwmon/adm1031
@@ -3,20 +3,28 @@ Kernel driver adm1031
 
 Supported chips:
   * Analog Devices ADM1030
+
     Prefix: 'adm1030'
+
     Addresses scanned: I2C 0x2c to 0x2e
+
     Datasheet: Publicly available at the Analog Devices website
-               http://www.analog.com/en/prod/0%2C2877%2CADM1030%2C00.html
+
+	       http://www.analog.com/en/prod/0%2C2877%2CADM1030%2C00.html
 
   * Analog Devices ADM1031
+
     Prefix: 'adm1031'
+
     Addresses scanned: I2C 0x2c to 0x2e
+
     Datasheet: Publicly available at the Analog Devices website
-               http://www.analog.com/en/prod/0%2C2877%2CADM1031%2C00.html
+
+	       http://www.analog.com/en/prod/0%2C2877%2CADM1031%2C00.html
 
 Authors:
-        Alexandre d'Alton <alex@alexdalton.org>
-        Jean Delvare <jdelvare@suse.de>
+	- Alexandre d'Alton <alex@alexdalton.org>
+	- Jean Delvare <jdelvare@suse.de>
 
 Description
 -----------
diff --git a/Documentation/hwmon/adm9240 b/Documentation/hwmon/adm9240
index 9b174fc700cc..91063b0f4c6f 100644
--- a/Documentation/hwmon/adm9240
+++ b/Documentation/hwmon/adm9240
@@ -2,30 +2,43 @@ Kernel driver adm9240
 =====================
 
 Supported chips:
+
   * Analog Devices ADM9240
+
     Prefix: 'adm9240'
+
     Addresses scanned: I2C 0x2c - 0x2f
+
     Datasheet: Publicly available at the Analog Devices website
-    http://www.analog.com/UploadedFiles/Data_Sheets/79857778ADM9240_0.pdf
+
+	http://www.analog.com/UploadedFiles/Data_Sheets/79857778ADM9240_0.pdf
 
   * Dallas Semiconductor DS1780
+
     Prefix: 'ds1780'
+
     Addresses scanned: I2C 0x2c - 0x2f
+
     Datasheet: Publicly available at the Dallas Semiconductor (Maxim) website
-    http://pdfserv.maxim-ic.com/en/ds/DS1780.pdf
+
+	http://pdfserv.maxim-ic.com/en/ds/DS1780.pdf
 
   * National Semiconductor LM81
+
     Prefix: 'lm81'
+
     Addresses scanned: I2C 0x2c - 0x2f
+
     Datasheet: Publicly available at the National Semiconductor website
-    http://www.national.com/ds.cgi/LM/LM81.pdf
+
+	http://www.national.com/ds.cgi/LM/LM81.pdf
 
 Authors:
-    Frodo Looijaard <frodol@dds.nl>,
-    Philip Edelbrock <phil@netroedge.com>,
-    Michiel Rook <michiel@grendelproject.nl>,
-    Grant Coady <gcoady.lk@gmail.com> with guidance
-        from Jean Delvare <jdelvare@suse.de>
+    - Frodo Looijaard <frodol@dds.nl>,
+    - Philip Edelbrock <phil@netroedge.com>,
+    - Michiel Rook <michiel@grendelproject.nl>,
+    - Grant Coady <gcoady.lk@gmail.com> with guidance
+      from Jean Delvare <jdelvare@suse.de>
 
 Interface
 ---------
@@ -87,11 +100,13 @@ rpm = (22500 * 60) / (count * divider)
 Automatic fan clock divider
 
   * User sets 0 to fan_min limit
+
     - low speed alarm is disabled
     - fan clock divider not changed
     - auto fan clock adjuster enabled for valid fan speed reading
 
   * User sets fan_min limit too low
+
     - low speed alarm is enabled
     - fan clock divider set to max
     - fan_min set to register value 254 which corresponds
@@ -101,18 +116,20 @@ Automatic fan clock divider
     - auto fan clock adjuster disabled
 
   * User sets reasonable fan speed
+
     - low speed alarm is enabled
     - fan clock divider set to suit fan_min
     - auto fan clock adjuster enabled: adjusts fan_min
 
   * User sets unreasonably high low fan speed limit
+
     - resolution of the low speed limit may be reduced
     - alarm will be asserted
     - auto fan clock adjuster enabled: adjusts fan_min
 
-    * fan speed may be displayed as zero until the auto fan clock divider
-      adjuster brings fan speed clock divider back into chip measurement
-      range, this will occur within a few measurement cycles.
+  * fan speed may be displayed as zero until the auto fan clock divider
+    adjuster brings fan speed clock divider back into chip measurement
+    range, this will occur within a few measurement cycles.
 
 Analog Output
 -------------
@@ -122,16 +139,21 @@ power up or reset. This doesn't do much on the test Intel SE440BX-2.
 
 Voltage Monitor
 
+^^^^^^^^^^^^^^^
+
 Voltage (IN) measurement is internally scaled:
 
+    === =========== =========== ========= ==========
     nr  label       nominal     maximum   resolution
-                      mV          mV         mV
+		      mV          mV         mV
+    === =========== =========== ========= ==========
     0   +2.5V        2500        3320       13.0
     1   Vccp1        2700        3600       14.1
     2   +3.3V        3300        4380       17.2
     3     +5V        5000        6640       26.0
     4    +12V       12000       15940       62.5
     5   Vccp2        2700        3600       14.1
+    === =========== =========== ========= ==========
 
 The reading is an unsigned 8-bit value, nominal voltage measurement is
 represented by a reading of 192, being 3/4 of the measurement range.
@@ -159,8 +181,9 @@ Clear the CI latch by writing value 0 to the sysfs intrusion0_alarm file.
 
 Alarm flags reported as 16-bit word
 
+    ===     =============       ==========================
     bit     label               comment
-    ---     -------------       --------------------------
+    ===     =============       ==========================
      0      +2.5 V_Error        high or low limit exceeded
      1      VCCP_Error          high or low limit exceeded
      2      +3.3 V_Error        high or low limit exceeded
@@ -171,6 +194,7 @@ Alarm flags reported as 16-bit word
      8      +12 V_Error         high or low limit exceeded
      9      VCCP2_Error         high or low limit exceeded
     12      Chassis_Error       CI pin went high
+    ===     =============       ==========================
 
 Remaining bits are reserved and thus undefined. It is important to note
 that alarm bits may be cleared on read, user-space may latch alarms and
diff --git a/Documentation/hwmon/ads7828 b/Documentation/hwmon/ads7828
index f6e263e0f607..b830b490cfe4 100644
--- a/Documentation/hwmon/ads7828
+++ b/Documentation/hwmon/ads7828
@@ -2,20 +2,27 @@ Kernel driver ads7828
 =====================
 
 Supported chips:
+
   * Texas Instruments/Burr-Brown ADS7828
+
     Prefix: 'ads7828'
+
     Datasheet: Publicly available at the Texas Instruments website:
-               http://focus.ti.com/lit/ds/symlink/ads7828.pdf
+
+	       http://focus.ti.com/lit/ds/symlink/ads7828.pdf
 
   * Texas Instruments ADS7830
+
     Prefix: 'ads7830'
+
     Datasheet: Publicly available at the Texas Instruments website:
-               http://focus.ti.com/lit/ds/symlink/ads7830.pdf
+
+	       http://focus.ti.com/lit/ds/symlink/ads7830.pdf
 
 Authors:
-        Steve Hardy <shardy@redhat.com>
-        Vivien Didelot <vivien.didelot@savoirfairelinux.com>
-        Guillaume Roguez <guillaume.roguez@savoirfairelinux.com>
+	- Steve Hardy <shardy@redhat.com>
+	- Vivien Didelot <vivien.didelot@savoirfairelinux.com>
+	- Guillaume Roguez <guillaume.roguez@savoirfairelinux.com>
 
 Platform data
 -------------
@@ -24,16 +31,16 @@ The ads7828 driver accepts an optional ads7828_platform_data structure (defined
 in include/linux/platform_data/ads7828.h). The structure fields are:
 
 * diff_input: (bool) Differential operation
-  set to true for differential mode, false for default single ended mode.
+    set to true for differential mode, false for default single ended mode.
 
 * ext_vref: (bool) External reference
-  set to true if it operates with an external reference, false for default
-  internal reference.
+    set to true if it operates with an external reference, false for default
+    internal reference.
 
 * vref_mv: (unsigned int) Voltage reference
-  if using an external reference, set this to the reference voltage in mV,
-  otherwise it will default to the internal value (2500mV). This value will be
-  bounded with limits accepted by the chip, described in the datasheet.
+    if using an external reference, set this to the reference voltage in mV,
+    otherwise it will default to the internal value (2500mV). This value will be
+    bounded with limits accepted by the chip, described in the datasheet.
 
  If no structure is provided, the configuration defaults to single ended
  operation and internal voltage reference (2.5V).
diff --git a/Documentation/hwmon/adt7410 b/Documentation/hwmon/adt7410
index 9817941e5f19..24caaa83c8ec 100644
--- a/Documentation/hwmon/adt7410
+++ b/Documentation/hwmon/adt7410
@@ -2,26 +2,45 @@ Kernel driver adt7410
 =====================
 
 Supported chips:
+
   * Analog Devices ADT7410
+
     Prefix: 'adt7410'
+
     Addresses scanned: None
+
     Datasheet: Publicly available at the Analog Devices website
-               http://www.analog.com/static/imported-files/data_sheets/ADT7410.pdf
+
+	       http://www.analog.com/static/imported-files/data_sheets/ADT7410.pdf
   * Analog Devices ADT7420
+
     Prefix: 'adt7420'
+
     Addresses scanned: None
+
     Datasheet: Publicly available at the Analog Devices website
-               http://www.analog.com/static/imported-files/data_sheets/ADT7420.pdf
+
+	       http://www.analog.com/static/imported-files/data_sheets/ADT7420.pdf
+
   * Analog Devices ADT7310
+
     Prefix: 'adt7310'
+
     Addresses scanned: None
+
     Datasheet: Publicly available at the Analog Devices website
-               http://www.analog.com/static/imported-files/data_sheets/ADT7310.pdf
+
+	       http://www.analog.com/static/imported-files/data_sheets/ADT7310.pdf
+
   * Analog Devices ADT7320
+
     Prefix: 'adt7320'
+
     Addresses scanned: None
+
     Datasheet: Publicly available at the Analog Devices website
-               http://www.analog.com/static/imported-files/data_sheets/ADT7320.pdf
+
+	       http://www.analog.com/static/imported-files/data_sheets/ADT7320.pdf
 
 Author: Hartmut Knaack <knaack.h@gmx.de>
 
@@ -61,13 +80,15 @@ The device is set to 16 bit resolution and comparator mode.
 sysfs-Interface
 ---------------
 
-temp#_input		- temperature input
-temp#_min		- temperature minimum setpoint
-temp#_max		- temperature maximum setpoint
-temp#_crit		- critical temperature setpoint
-temp#_min_hyst		- hysteresis for temperature minimum (read-only)
-temp#_max_hyst		- hysteresis for temperature maximum (read/write)
-temp#_crit_hyst		- hysteresis for critical temperature (read-only)
-temp#_min_alarm		- temperature minimum alarm flag
-temp#_max_alarm		- temperature maximum alarm flag
-temp#_crit_alarm	- critical temperature alarm flag
+======================== ====================================================
+temp#_input		 temperature input
+temp#_min		 temperature minimum setpoint
+temp#_max		 temperature maximum setpoint
+temp#_crit		 critical temperature setpoint
+temp#_min_hyst		 hysteresis for temperature minimum (read-only)
+temp#_max_hyst		 hysteresis for temperature maximum (read/write)
+temp#_crit_hyst		 hysteresis for critical temperature (read-only)
+temp#_min_alarm		 temperature minimum alarm flag
+temp#_max_alarm		 temperature maximum alarm flag
+temp#_crit_alarm	 critical temperature alarm flag
+======================== ====================================================
diff --git a/Documentation/hwmon/adt7411 b/Documentation/hwmon/adt7411
index 1632960f9745..57ad16fb216a 100644
--- a/Documentation/hwmon/adt7411
+++ b/Documentation/hwmon/adt7411
@@ -2,9 +2,13 @@ Kernel driver adt7411
 =====================
 
 Supported chips:
+
   * Analog Devices ADT7411
+
     Prefix: 'adt7411'
+
     Addresses scanned: 0x48, 0x4a, 0x4b
+
     Datasheet: Publicly available at the Analog Devices website
 
 Author: Wolfram Sang (based on adt7470 by Darrick J. Wong)
@@ -26,15 +30,19 @@ Check the datasheet for details.
 sysfs-Interface
 ---------------
 
-in0_input	- vdd voltage input
-in[1-8]_input	- analog 1-8 input
-temp1_input	- temperature input
+================ =================
+in0_input	 vdd voltage input
+in[1-8]_input	 analog 1-8 input
+temp1_input	 temperature input
+================ =================
 
 Besides standard interfaces, this driver adds (0 = off, 1 = on):
 
-  adc_ref_vdd	- Use vdd as reference instead of 2.25 V
-  fast_sampling	- Sample at 22.5 kHz instead of 1.4 kHz, but drop filters
-  no_average	- Turn off averaging over 16 samples
+  ============== =======================================================
+  adc_ref_vdd	 Use vdd as reference instead of 2.25 V
+  fast_sampling	 Sample at 22.5 kHz instead of 1.4 kHz, but drop filters
+  no_average	 Turn off averaging over 16 samples
+  ============== =======================================================
 
 Notes
 -----
diff --git a/Documentation/hwmon/adt7462 b/Documentation/hwmon/adt7462
index ec660b328275..a7a831118d32 100644
--- a/Documentation/hwmon/adt7462
+++ b/Documentation/hwmon/adt7462
@@ -1,10 +1,14 @@
 Kernel driver adt7462
-======================
+=====================
 
 Supported chips:
+
   * Analog Devices ADT7462
+
     Prefix: 'adt7462'
+
     Addresses scanned: I2C 0x58, 0x5C
+
     Datasheet: Publicly available at the Analog Devices website
 
 Author: Darrick J. Wong
@@ -57,8 +61,8 @@ Besides standard interfaces driver adds the following:
 * pwm#_auto_point1_pwm and temp#_auto_point1_temp and
 * pwm#_auto_point2_pwm and temp#_auto_point2_temp -
 
-point1: Set the pwm speed at a lower temperature bound.
-point2: Set the pwm speed at a higher temperature bound.
+  - point1: Set the pwm speed at a lower temperature bound.
+  - point2: Set the pwm speed at a higher temperature bound.
 
 The ADT7462 will scale the pwm between the lower and higher pwm speed when
 the temperature is between the two temperature boundaries.  PWM values range
diff --git a/Documentation/hwmon/adt7470 b/Documentation/hwmon/adt7470
index fe68e18a0c8d..d225f816e992 100644
--- a/Documentation/hwmon/adt7470
+++ b/Documentation/hwmon/adt7470
@@ -2,9 +2,13 @@ Kernel driver adt7470
 =====================
 
 Supported chips:
+
   * Analog Devices ADT7470
+
     Prefix: 'adt7470'
+
     Addresses scanned: I2C 0x2C, 0x2E, 0x2F
+
     Datasheet: Publicly available at the Analog Devices website
 
 Author: Darrick J. Wong
@@ -56,8 +60,8 @@ Besides standard interfaces driver adds the following:
 * pwm#_auto_point1_pwm and pwm#_auto_point1_temp and
 * pwm#_auto_point2_pwm and pwm#_auto_point2_temp -
 
-point1: Set the pwm speed at a lower temperature bound.
-point2: Set the pwm speed at a higher temperature bound.
+  - point1: Set the pwm speed at a lower temperature bound.
+  - point2: Set the pwm speed at a higher temperature bound.
 
 The ADT7470 will scale the pwm between the lower and higher pwm speed when
 the temperature is between the two temperature boundaries.  PWM values range
diff --git a/Documentation/hwmon/adt7475 b/Documentation/hwmon/adt7475
index 01b46b290532..ef3ea1ea9bc1 100644
--- a/Documentation/hwmon/adt7475
+++ b/Documentation/hwmon/adt7475
@@ -2,28 +2,44 @@ Kernel driver adt7475
 =====================
 
 Supported chips:
+
   * Analog Devices ADT7473
+
     Prefix: 'adt7473'
+
     Addresses scanned: I2C 0x2C, 0x2D, 0x2E
+
     Datasheet: Publicly available at the On Semiconductors website
+
   * Analog Devices ADT7475
+
     Prefix: 'adt7475'
+
     Addresses scanned: I2C 0x2E
+
     Datasheet: Publicly available at the On Semiconductors website
+
   * Analog Devices ADT7476
+
     Prefix: 'adt7476'
+
     Addresses scanned: I2C 0x2C, 0x2D, 0x2E
+
     Datasheet: Publicly available at the On Semiconductors website
+
   * Analog Devices ADT7490
+
     Prefix: 'adt7490'
+
     Addresses scanned: I2C 0x2C, 0x2D, 0x2E
+
     Datasheet: Publicly available at the On Semiconductors website
 
 Authors:
-	Jordan Crouse
-	Hans de Goede
-	Darrick J. Wong (documentation)
-	Jean Delvare
+	- Jordan Crouse
+	- Hans de Goede
+	- Darrick J. Wong (documentation)
+	- Jean Delvare
 
 
 Description
@@ -82,14 +98,16 @@ ADT7490:
 Sysfs Mapping
 -------------
 
-     ADT7490     ADT7476     ADT7475   ADT7473
-     -------     -------     -------   -------
+==== =========== =========== ========= ==========
+in   ADT7490     ADT7476     ADT7475   ADT7473
+==== =========== =========== ========= ==========
 in0  2.5VIN (22) 2.5VIN (22) -         -
 in1  VCCP   (23) VCCP   (23) VCCP (14) VCCP (14)
 in2  VCC    (4)  VCC    (4)  VCC  (4)  VCC  (3)
 in3  5VIN   (20) 5VIN   (20)
 in4  12VIN  (21) 12VIN  (21)
 in5  VTT    (8)
+==== =========== =========== ========= ==========
 
 Special Features
 ----------------
@@ -107,8 +125,8 @@ Fan Speed Control
 
 The driver exposes two trip points per PWM channel.
 
-point1: Set the PWM speed at the lower temperature bound
-point2: Set the PWM speed at the higher temperature bound
+- point1: Set the PWM speed at the lower temperature bound
+- point2: Set the PWM speed at the higher temperature bound
 
 The ADT747x will scale the PWM linearly between the lower and higher PWM
 speed when the temperature is between the two temperature boundaries.
@@ -123,12 +141,12 @@ the PWM control exceeds temp#_max.
 
 At Tmin - hysteresis the PWM output can either be off (0% duty cycle) or at the
 minimum (i.e. auto_point1_pwm). This behaviour can be configured using the
-pwm[1-*]_stall_disable sysfs attribute. A value of 0 means the fans will shut
+`pwm[1-*]_stall_disable sysfs attribute`. A value of 0 means the fans will shut
 off. A value of 1 means the fans will run at auto_point1_pwm.
 
 The responsiveness of the ADT747x to temperature changes can be configured.
 This allows smoothing of the fan speed transition. To set the transition time
-set the value in ms in the temp[1-*]_smoothing sysfs attribute.
+set the value in ms in the `temp[1-*]_smoothing` sysfs attribute.
 
 Notes
 -----
diff --git a/Documentation/hwmon/amc6821 b/Documentation/hwmon/amc6821
index ced8359c50f8..d10eabcbc0f3 100644
--- a/Documentation/hwmon/amc6821
+++ b/Documentation/hwmon/amc6821
@@ -2,9 +2,13 @@ Kernel driver amc6821
 =====================
 
 Supported chips:
+
 	Texas Instruments AMC6821
+
 	Prefix: 'amc6821'
+
 	Addresses scanned: 0x18, 0x19, 0x1a, 0x2c, 0x2d, 0x2e, 0x4c, 0x4d, 0x4e
+
 	Datasheet: http://focus.ti.com/docs/prod/folders/print/amc6821.html
 
 Authors:
@@ -21,10 +25,11 @@ The pwm can be controlled either from software or automatically.
 
 The driver provides the following sensor accesses in sysfs:
 
+======================= ==      ===============================================
 temp1_input		ro	on-chip temperature
 temp1_min		rw	"
 temp1_max		rw	"
-temp1_crit	 	rw	"
+temp1_crit		rw	"
 temp1_min_alarm		ro	"
 temp1_max_alarm		ro	"
 temp1_crit_alarm	ro	"
@@ -32,16 +37,16 @@ temp1_crit_alarm	ro	"
 temp2_input		ro	remote temperature
 temp2_min		rw	"
 temp2_max		rw	"
-temp2_crit	 	rw	"
+temp2_crit		rw	"
 temp2_min_alarm		ro	"
 temp2_max_alarm		ro	"
 temp2_crit_alarm	ro	"
 temp2_fault		ro	"
 
-fan1_input	 	ro	tachometer speed
+fan1_input		ro	tachometer speed
 fan1_min		rw	"
 fan1_max		rw	"
-fan1_fault	 	ro	"
+fan1_fault		ro	"
 fan1_div		rw	Fan divisor can be either 2 or 4.
 
 pwm1			rw	pwm1
@@ -87,6 +92,7 @@ temp2_auto_point3_temp	rw	Above this temperature fan runs at maximum
 				values which depend on temp2_auto_point2_temp
 				and pwm1_auto_point2_pwm. Read it out after
 				writing to get actual value.
+======================= ==      ===============================================
 
 
 Module parameters
@@ -97,6 +103,7 @@ load the module with: init=0.
 
 If your board BIOS doesn't initialize the chip, or you want
 different settings, you can set the following parameters:
-init=1,
-pwminv: 0 default pwm output, 1 inverts pwm output.
+
+- init=1,
+- pwminv: 0 default pwm output, 1 inverts pwm output.
 
diff --git a/Documentation/hwmon/asb100 b/Documentation/hwmon/asb100
index ab7365e139be..311d9f7b6926 100644
--- a/Documentation/hwmon/asb100
+++ b/Documentation/hwmon/asb100
@@ -2,9 +2,13 @@ Kernel driver asb100
 ====================
 
 Supported Chips:
+
   * Asus ASB100 and ASB100-A "Bach"
+
     Prefix: 'asb100'
+
     Addresses scanned: I2C 0x2d
+
     Datasheet: none released
 
 Author: Mark M. Hoffman <mhoffman@lightlink.com>
@@ -41,32 +45,30 @@ processor itself. It is a value in volts.
 
 Alarms: (TODO question marks indicate may or may not work)
 
-0x0001 => in0 (?)
-0x0002 => in1 (?)
-0x0004 => in2
-0x0008 => in3
-0x0010 => temp1 (1)
-0x0020 => temp2
-0x0040 => fan1
-0x0080 => fan2
-0x0100 => in4
-0x0200 => in5 (?) (2)
-0x0400 => in6 (?) (2)
-0x0800 => fan3
-0x1000 => chassis switch
-0x2000 => temp3
+- 0x0001 => in0 (?)
+- 0x0002 => in1 (?)
+- 0x0004 => in2
+- 0x0008 => in3
+- 0x0010 => temp1 [1]_
+- 0x0020 => temp2
+- 0x0040 => fan1
+- 0x0080 => fan2
+- 0x0100 => in4
+- 0x0200 => in5 (?) [2]_
+- 0x0400 => in6 (?) [2]_
+- 0x0800 => fan3
+- 0x1000 => chassis switch
+- 0x2000 => temp3
 
-Alarm Notes:
+.. [1]	This alarm will only trigger if the hysteresis value is 127C.
+	I.e. it behaves the same as w83781d.
 
-(1) This alarm will only trigger if the hysteresis value is 127C.
-I.e. it behaves the same as w83781d.
-
-(2) The min and max registers for these values appear to
-be read-only or otherwise stuck at 0x00.
+.. [2]	The min and max registers for these values appear to
+	be read-only or otherwise stuck at 0x00.
 
 TODO:
-* Experiment with fan divisors > 8.
-* Experiment with temp. sensor types.
-* Are there really 13 voltage inputs? Probably not...
-* Cleanups, no doubt...
+  * Experiment with fan divisors > 8.
+  * Experiment with temp. sensor types.
+  * Are there really 13 voltage inputs? Probably not...
+  * Cleanups, no doubt...
 
diff --git a/Documentation/hwmon/ds1621 b/Documentation/hwmon/ds1621
index fa3407997795..552b37e9dd34 100644
--- a/Documentation/hwmon/ds1621
+++ b/Documentation/hwmon/ds1621
@@ -2,42 +2,61 @@ Kernel driver ds1621
 ====================
 
 Supported chips:
+
   * Dallas Semiconductor / Maxim Integrated DS1621
+
     Prefix: 'ds1621'
+
     Addresses scanned: none
+
     Datasheet: Publicly available from www.maximintegrated.com
 
   * Dallas Semiconductor DS1625
+
     Prefix: 'ds1625'
+
     Addresses scanned: none
+
     Datasheet: Publicly available from www.datasheetarchive.com
 
   * Maxim Integrated DS1631
+
     Prefix: 'ds1631'
+
     Addresses scanned: none
+
     Datasheet: Publicly available from www.maximintegrated.com
 
   * Maxim Integrated DS1721
+
     Prefix: 'ds1721'
+
     Addresses scanned: none
+
     Datasheet: Publicly available from www.maximintegrated.com
 
   * Maxim Integrated DS1731
+
     Prefix: 'ds1731'
+
     Addresses scanned: none
+
     Datasheet: Publicly available from www.maximintegrated.com
 
 Authors:
-        Christian W. Zuckschwerdt <zany@triq.net>
-        valuable contributions by Jan M. Sendler <sendler@sendler.de>
-        ported to 2.6 by Aurelien Jarno <aurelien@aurel32.net>
-        with the help of Jean Delvare <jdelvare@suse.de>
+      - Christian W. Zuckschwerdt <zany@triq.net>
+      - valuable contributions by Jan M. Sendler <sendler@sendler.de>
+      - ported to 2.6 by Aurelien Jarno <aurelien@aurel32.net>
+	with the help of Jean Delvare <jdelvare@suse.de>
 
 Module Parameters
 ------------------
 
 * polarity int
-  Output's polarity: 0 = active high, 1 = active low
+  Output's polarity:
+
+  * 0 = active high,
+  * 1 = active low
 
 Description
 -----------
@@ -87,28 +106,31 @@ are used internally, however, these flags do get set and cleared as the actual
 temperature crosses the min or max settings (which by default are set to 75
 and 80 degrees respectively).
 
-Temperature Conversion:
------------------------
-DS1621 - 750ms (older devices may take up to 1000ms)
-DS1625 - 500ms
-DS1631 - 93ms..750ms for 9..12 bits resolution, respectively.
-DS1721 - 93ms..750ms for 9..12 bits resolution, respectively.
-DS1731 - 93ms..750ms for 9..12 bits resolution, respectively.
+Temperature Conversion
+----------------------
+
+- DS1621 - 750ms (older devices may take up to 1000ms)
+- DS1625 - 500ms
+- DS1631 - 93ms..750ms for 9..12 bits resolution, respectively.
+- DS1721 - 93ms..750ms for 9..12 bits resolution, respectively.
+- DS1731 - 93ms..750ms for 9..12 bits resolution, respectively.
 
 Note:
 On the DS1621, internal access to non-volatile registers may last for 10ms
 or less (unverified on the other devices).
 
-Temperature Accuracy:
----------------------
-DS1621: +/- 0.5 degree Celsius (from 0 to +70 degrees)
-DS1625: +/- 0.5 degree Celsius (from 0 to +70 degrees)
-DS1631: +/- 0.5 degree Celsius (from 0 to +70 degrees)
-DS1721: +/- 1.0 degree Celsius (from -10 to +85 degrees)
-DS1731: +/- 1.0 degree Celsius (from -10 to +85 degrees)
+Temperature Accuracy
+--------------------
 
-Note:
-Please refer to the device datasheets for accuracy at other temperatures.
+- DS1621: +/- 0.5 degree Celsius (from 0 to +70 degrees)
+- DS1625: +/- 0.5 degree Celsius (from 0 to +70 degrees)
+- DS1631: +/- 0.5 degree Celsius (from 0 to +70 degrees)
+- DS1721: +/- 1.0 degree Celsius (from -10 to +85 degrees)
+- DS1731: +/- 1.0 degree Celsius (from -10 to +85 degrees)
+
+.. Note::
+
+   Please refer to the device datasheets for accuracy at other temperatures.
 
 Temperature Resolution:
 -----------------------
@@ -117,60 +139,67 @@ support, which is achieved via the R0 and R1 config register bits, where:
 
 R0..R1
 ------
- 0  0 => 9 bits, 0.5 degrees Celsius
- 1  0 => 10 bits, 0.25 degrees Celsius
- 0  1 => 11 bits, 0.125 degrees Celsius
- 1  1 => 12 bits, 0.0625 degrees Celsius
 
-Note:
-At initial device power-on, the default resolution is set to 12-bits.
+== ==  ===============================
+R0 R1
+== ==  ===============================
+ 0  0  9 bits, 0.5 degrees Celsius
+ 1  0  10 bits, 0.25 degrees Celsius
+ 0  1  11 bits, 0.125 degrees Celsius
+ 1  1  12 bits, 0.0625 degrees Celsius
+== ==  ===============================
+
+.. Note::
+
+   At initial device power-on, the default resolution is set to 12-bits.
 
 The resolution mode for the DS1631, DS1721, or DS1731 can be changed from
 userspace, via the device 'update_interval' sysfs attribute. This attribute
 will normalize the range of input values to the device maximum resolution
 values defined in the datasheet as follows:
 
+============= ================== ===============
 Resolution    Conversion Time    Input Range
  (C/LSB)       (msec)             (msec)
-------------------------------------------------
+============= ================== ===============
 0.5             93.75              0....94
 0.25            187.5              95...187
 0.125           375                188..375
 0.0625          750                376..infinity
-------------------------------------------------
+============= ================== ===============
 
 The following examples show how the 'update_interval' attribute can be
-used to change the conversion time:
+used to change the conversion time::
 
-$ cat update_interval
-750
-$ cat temp1_input
-22062
-$
-$ echo 300 > update_interval
-$ cat update_interval
-375
-$ cat temp1_input
-22125
-$
-$ echo 150 > update_interval
-$ cat update_interval
-188
-$ cat temp1_input
-22250
-$
-$ echo 1 > update_interval
-$ cat update_interval
-94
-$ cat temp1_input
-22000
-$
-$ echo 1000 > update_interval
-$ cat update_interval
-750
-$ cat temp1_input
-22062
-$
+  $ cat update_interval
+  750
+  $ cat temp1_input
+  22062
+  $
+  $ echo 300 > update_interval
+  $ cat update_interval
+  375
+  $ cat temp1_input
+  22125
+  $
+  $ echo 150 > update_interval
+  $ cat update_interval
+  188
+  $ cat temp1_input
+  22250
+  $
+  $ echo 1 > update_interval
+  $ cat update_interval
+  94
+  $ cat temp1_input
+  22000
+  $
+  $ echo 1000 > update_interval
+  $ cat update_interval
+  750
+  $ cat temp1_input
+  22062
+  $
 
 As shown, the ds1621 driver automatically adjusts the 'update_interval'
 user input, via a step function. Reading back the 'update_interval' value
@@ -182,6 +211,7 @@ via the following function:
    g(x) = 0.5 * [minimum_conversion_time/x]
 
 where:
- -> 'x' = the output from 'update_interval'
- -> 'g(x)' = the resolution in degrees C per LSB.
- -> 93.75ms = minimum conversion time
+
+ - 'x' = the output from 'update_interval'
+ - 'g(x)' = the resolution in degrees C per LSB.
+ - 93.75ms = minimum conversion time
diff --git a/Documentation/hwmon/ds620 b/Documentation/hwmon/ds620
index 1fbe3cd916cc..2d686b17b547 100644
--- a/Documentation/hwmon/ds620
+++ b/Documentation/hwmon/ds620
@@ -2,15 +2,19 @@ Kernel driver ds620
 ===================
 
 Supported chips:
+
   * Dallas Semiconductor DS620
+
     Prefix: 'ds620'
+
     Datasheet: Publicly available at the Dallas Semiconductor website
-               http://www.dalsemi.com/
+
+	       http://www.dalsemi.com/
 
 Authors:
-        Roland Stigge <stigge@antcom.de>
-        based on ds1621.c by
-        Christian W. Zuckschwerdt <zany@triq.net>
+	Roland Stigge <stigge@antcom.de>
+	based on ds1621.c by
+	Christian W. Zuckschwerdt <zany@triq.net>
 
 Description
 -----------
diff --git a/Documentation/hwmon/emc1403 b/Documentation/hwmon/emc1403
index a869b0ef6a9d..3a4913b63ef3 100644
--- a/Documentation/hwmon/emc1403
+++ b/Documentation/hwmon/emc1403
@@ -2,28 +2,48 @@ Kernel driver emc1403
 =====================
 
 Supported chips:
+
   * SMSC / Microchip EMC1402, EMC1412
+
     Addresses scanned: I2C 0x18, 0x1c, 0x29, 0x4c, 0x4d, 0x5c
+
     Prefix: 'emc1402'
+
     Datasheets:
-	http://ww1.microchip.com/downloads/en/DeviceDoc/1412.pdf
-	http://ww1.microchip.com/downloads/en/DeviceDoc/1402.pdf
+
+	- http://ww1.microchip.com/downloads/en/DeviceDoc/1412.pdf
+	- http://ww1.microchip.com/downloads/en/DeviceDoc/1402.pdf
+
   * SMSC / Microchip EMC1403, EMC1404, EMC1413, EMC1414
+
     Addresses scanned: I2C 0x18, 0x29, 0x4c, 0x4d
+
     Prefix: 'emc1403', 'emc1404'
+
     Datasheets:
-	http://ww1.microchip.com/downloads/en/DeviceDoc/1403_1404.pdf
-	http://ww1.microchip.com/downloads/en/DeviceDoc/1413_1414.pdf
+
+	- http://ww1.microchip.com/downloads/en/DeviceDoc/1403_1404.pdf
+	- http://ww1.microchip.com/downloads/en/DeviceDoc/1413_1414.pdf
+
   * SMSC / Microchip EMC1422
+
     Addresses scanned: I2C 0x4c
+
     Prefix: 'emc1422'
+
     Datasheet:
-	http://ww1.microchip.com/downloads/en/DeviceDoc/1422.pdf
+
+	- http://ww1.microchip.com/downloads/en/DeviceDoc/1422.pdf
+
   * SMSC / Microchip EMC1423, EMC1424
+
     Addresses scanned: I2C 0x4c
+
     Prefix: 'emc1423', 'emc1424'
+
     Datasheet:
-	http://ww1.microchip.com/downloads/en/DeviceDoc/1423_1424.pdf
+
+	- http://ww1.microchip.com/downloads/en/DeviceDoc/1423_1424.pdf
 
 Author:
     Kalhan Trisal <kalhan.trisal@intel.com
@@ -46,6 +66,7 @@ difference between the limit and its hysteresis is always the same for
 all three limits.
 
 This implementation detail implies the following:
+
 * When setting a limit, its hysteresis will automatically follow, the
   difference staying unchanged. For example, if the old critical limit
   was 80 degrees C, and the hysteresis was 75 degrees C, and you change
diff --git a/Documentation/hwmon/emc6w201 b/Documentation/hwmon/emc6w201
index 757629b12897..a8e1185b9bb6 100644
--- a/Documentation/hwmon/emc6w201
+++ b/Documentation/hwmon/emc6w201
@@ -2,9 +2,13 @@ Kernel driver emc6w201
 ======================
 
 Supported chips:
+
   * SMSC EMC6W201
+
     Prefix: 'emc6w201'
+
     Addresses scanned: I2C 0x2c, 0x2d, 0x2e
+
     Datasheet: Not public
 
 Author: Jean Delvare <jdelvare@suse.de>
@@ -38,5 +42,6 @@ Known Systems With EMC6W201
 
 The EMC6W201 is a rare device, only found on a few systems, made in
 2005 and 2006. Known systems with this device:
+
 * Dell Precision 670 workstation
 * Gigabyte 2CEWH mainboard
diff --git a/Documentation/hwmon/f71805f b/Documentation/hwmon/f71805f
index 48a356084bc6..1efe5e5d337c 100644
--- a/Documentation/hwmon/f71805f
+++ b/Documentation/hwmon/f71805f
@@ -2,17 +2,29 @@ Kernel driver f71805f
 =====================
 
 Supported chips:
+
   * Fintek F71805F/FG
+
     Prefix: 'f71805f'
+
     Addresses scanned: none, address read from Super I/O config space
+
     Datasheet: Available from the Fintek website
+
   * Fintek F71806F/FG
+
     Prefix: 'f71872f'
+
     Addresses scanned: none, address read from Super I/O config space
+
     Datasheet: Available from the Fintek website
+
   * Fintek F71872F/FG
+
     Prefix: 'f71872f'
+
     Addresses scanned: none, address read from Super I/O config space
+
     Datasheet: Available from the Fintek website
 
 Author: Jean Delvare <jdelvare@suse.de>
@@ -64,24 +76,26 @@ you can only set the limits in steps of 32 mV (before scaling).
 
 The wirings and resistor values suggested by Fintek are as follow:
 
-        pin                                           expected
-        name    use           R1      R2     divider  raw val.
-
+======= ======= =========== ==== ======= ============ ==============
+in      pin                                           expected
+	name    use           R1      R2     divider  raw val.
+======= ======= =========== ==== ======= ============ ==============
 in0     VCC     VCC3.3V     int.    int.        2.00    1.65 V
 in1     VIN1    VTT1.2V      10K       -        1.00    1.20 V
-in2     VIN2    VRAM        100K    100K        2.00   ~1.25 V (1)
-in3     VIN3    VCHIPSET     47K    100K        1.47    2.24 V (2)
+in2     VIN2    VRAM        100K    100K        2.00   ~1.25 V [1]_
+in3     VIN3    VCHIPSET     47K    100K        1.47    2.24 V [2]_
 in4     VIN4    VCC5V       200K     47K        5.25    0.95 V
 in5     VIN5    +12V        200K     20K       11.00    1.05 V
 in6     VIN6    VCC1.5V      10K       -        1.00    1.50 V
-in7     VIN7    VCORE        10K       -        1.00   ~1.40 V (1)
+in7     VIN7    VCORE        10K       -        1.00   ~1.40 V [1]_
 in8     VIN8    VSB5V       200K     47K        1.00    0.95 V
-in10    VSB     VSB3.3V     int.    int.        2.00    1.65 V (3)
-in9     VBAT    VBATTERY    int.    int.        2.00    1.50 V (3)
+in10    VSB     VSB3.3V     int.    int.        2.00    1.65 V [3]_
+in9     VBAT    VBATTERY    int.    int.        2.00    1.50 V [3]_
+======= ======= =========== ==== ======= ============ ==============
 
-(1) Depends on your hardware setup.
-(2) Obviously not correct, swapping R1 and R2 would make more sense.
-(3) F71872F/FG only.
+.. [1] Depends on your hardware setup.
+.. [2] Obviously not correct, swapping R1 and R2 would make more sense.
+.. [3] F71872F/FG only.
 
 These values can be used as hints at best, as motherboard manufacturers
 are free to use a completely different setup. As a matter of fact, the
diff --git a/Documentation/hwmon/f71882fg b/Documentation/hwmon/f71882fg
index 4c3cb8377d74..5c0b7b0db150 100644
--- a/Documentation/hwmon/f71882fg
+++ b/Documentation/hwmon/f71882fg
@@ -2,60 +2,114 @@ Kernel driver f71882fg
 ======================
 
 Supported chips:
+
   * Fintek F71808E
+
     Prefix: 'f71808e'
+
     Addresses scanned: none, address read from Super I/O config space
+
     Datasheet: Not public
+
   * Fintek F71808A
+
     Prefix: 'f71808a'
+
     Addresses scanned: none, address read from Super I/O config space
+
     Datasheet: Not public
+
   * Fintek F71858FG
+
     Prefix: 'f71858fg'
+
     Addresses scanned: none, address read from Super I/O config space
+
     Datasheet: Available from the Fintek website
+
   * Fintek F71862FG and F71863FG
+
     Prefix: 'f71862fg'
+
     Addresses scanned: none, address read from Super I/O config space
+
     Datasheet: Available from the Fintek website
+
   * Fintek F71869F and F71869E
+
     Prefix: 'f71869'
+
     Addresses scanned: none, address read from Super I/O config space
+
     Datasheet: Available from the Fintek website
+
   * Fintek F71869A
+
     Prefix: 'f71869a'
+
     Addresses scanned: none, address read from Super I/O config space
+
     Datasheet: Not public
+
   * Fintek F71882FG and F71883FG
+
     Prefix: 'f71882fg'
+
     Addresses scanned: none, address read from Super I/O config space
+
     Datasheet: Available from the Fintek website
+
   * Fintek F71889FG
+
     Prefix: 'f71889fg'
+
     Addresses scanned: none, address read from Super I/O config space
+
     Datasheet: Available from the Fintek website
+
   * Fintek F71889ED
+
     Prefix: 'f71889ed'
+
     Addresses scanned: none, address read from Super I/O config space
+
     Datasheet: Should become available on the Fintek website soon
+
   * Fintek F71889A
+
     Prefix: 'f71889a'
+
     Addresses scanned: none, address read from Super I/O config space
+
     Datasheet: Should become available on the Fintek website soon
+
   * Fintek F8000
+
     Prefix: 'f8000'
+
     Addresses scanned: none, address read from Super I/O config space
+
     Datasheet: Not public
+
   * Fintek F81801U
+
     Prefix: 'f71889fg'
+
     Addresses scanned: none, address read from Super I/O config space
+
     Datasheet: Not public
-    Note: This is the 64-pin variant of the F71889FG, they have the
+
+    Note:
+	  This is the 64-pin variant of the F71889FG, they have the
 	  same device ID and are fully compatible as far as hardware
 	  monitoring is concerned.
+
   * Fintek F81865F
+
     Prefix: 'f81865f'
+
     Addresses scanned: none, address read from Super I/O config space
+
     Datasheet: Available from the Fintek website
 
 Author: Hans de Goede <hdegoede@redhat.com>
diff --git a/Documentation/hwmon/ftsteutates b/Documentation/hwmon/ftsteutates
index af54db92391b..58a2483d8d0d 100644
--- a/Documentation/hwmon/ftsteutates
+++ b/Documentation/hwmon/ftsteutates
@@ -1,9 +1,12 @@
 Kernel driver ftsteutates
-=====================
+=========================
 
 Supported chips:
+
   * FTS Teutates
+
     Prefix: 'ftsteutates'
+
     Addresses scanned: I2C 0x73 (7-Bit)
 
 Author: Thilo Cestonaro <thilo.cestonaro@ts.fujitsu.com>
@@ -11,6 +14,7 @@ Author: Thilo Cestonaro <thilo.cestonaro@ts.fujitsu.com>
 
 Description
 -----------
+
 The BMC Teutates is the Eleventh generation of Superior System
 monitoring and thermal management solution. It is builds on the basic
 functionality of the BMC Theseus and contains several new features and
@@ -19,9 +23,11 @@ enhancements. It can monitor up to 4 voltages, 16 temperatures and
 implemented in this driver.
 
 To clear a temperature or fan alarm, execute the following command with the
-correct path to the alarm file:
+correct path to the alarm file::
+
 	echo 0 >XXXX_alarm
 
 Specification of the chip can be found here:
-ftp://ftp.ts.fujitsu.com/pub/Mainboard-OEM-Sales/Services/Software&Tools/Linux_SystemMonitoring&Watchdog&GPIO/BMC-Teutates_Specification_V1.21.pdf
-ftp://ftp.ts.fujitsu.com/pub/Mainboard-OEM-Sales/Services/Software&Tools/Linux_SystemMonitoring&Watchdog&GPIO/Fujitsu_mainboards-1-Sensors_HowTo-en-US.pdf
+
+- ftp://ftp.ts.fujitsu.com/pub/Mainboard-OEM-Sales/Services/Software&Tools/Linux_SystemMonitoring&Watchdog&GPIO/BMC-Teutates_Specification_V1.21.pdf
+- ftp://ftp.ts.fujitsu.com/pub/Mainboard-OEM-Sales/Services/Software&Tools/Linux_SystemMonitoring&Watchdog&GPIO/Fujitsu_mainboards-1-Sensors_HowTo-en-US.pdf
diff --git a/Documentation/hwmon/g760a b/Documentation/hwmon/g760a
index cfc894537061..d82952cc8319 100644
--- a/Documentation/hwmon/g760a
+++ b/Documentation/hwmon/g760a
@@ -2,9 +2,13 @@ Kernel driver g760a
 ===================
 
 Supported chips:
+
   * Global Mixed-mode Technology Inc. G760A
+
     Prefix: 'g760a'
+
     Datasheet: Publicly available at the GMT website
+
       http://www.gmt.com.tw/product/datasheet/EDS-760A.pdf
 
 Author: Herbert Valerio Riedel <hvr@gnu.org>
diff --git a/Documentation/hwmon/g762 b/Documentation/hwmon/g762
index 923db9c5b5bc..54574e26df21 100644
--- a/Documentation/hwmon/g762
+++ b/Documentation/hwmon/g762
@@ -21,34 +21,43 @@ documented in Documentation/devicetree/bindings/hwmon/g762.txt or
 using a specific platform_data structure in board initialization
 file (see include/linux/platform_data/g762.h).
 
-  fan1_target: set desired fan speed. This only makes sense in closed-loop
-            fan speed control (i.e. when pwm1_enable is set to 2).
-
-  fan1_input: provide current fan rotation value in RPM as reported by
-            the fan to the device.
-
-  fan1_div: fan clock divisor. Supported value are 1, 2, 4 and 8.
-
-  fan1_pulses: number of pulses per fan revolution. Supported values
-            are 2 and 4.
-
-  fan1_fault: reports fan failure, i.e. no transition on fan gear pin for
-            about 0.7s (if the fan is not voluntarily set off).
-
-  fan1_alarm: in closed-loop control mode, if fan RPM value is 25% out
-            of the programmed value for over 6 seconds 'fan1_alarm' is
-            set to 1.
-
-  pwm1_enable: set current fan speed control mode i.e. 1 for manual fan
-            speed control (open-loop) via pwm1 described below, 2 for
-            automatic fan speed control (closed-loop) via fan1_target
-            above.
-
-  pwm1_mode: set or get fan driving mode: 1 for PWM mode, 0 for DC mode.
-
-  pwm1: get or set PWM fan control value in open-loop mode. This is an
-            integer value between 0 and 255. 0 stops the fan, 255 makes
-            it run at full speed.
+  fan1_target:
+	    set desired fan speed. This only makes sense in closed-loop
+	    fan speed control (i.e. when pwm1_enable is set to 2).
+
+  fan1_input:
+	    provide current fan rotation value in RPM as reported by
+	    the fan to the device.
+
+  fan1_div:
+	    fan clock divisor. Supported value are 1, 2, 4 and 8.
+
+  fan1_pulses:
+	    number of pulses per fan revolution. Supported values
+	    are 2 and 4.
+
+  fan1_fault:
+	    reports fan failure, i.e. no transition on fan gear pin for
+	    about 0.7s (if the fan is not voluntarily set off).
+
+  fan1_alarm:
+	    in closed-loop control mode, if fan RPM value is 25% out
+	    of the programmed value for over 6 seconds 'fan1_alarm' is
+	    set to 1.
+
+  pwm1_enable:
+	    set current fan speed control mode i.e. 1 for manual fan
+	    speed control (open-loop) via pwm1 described below, 2 for
+	    automatic fan speed control (closed-loop) via fan1_target
+	    above.
+
+  pwm1_mode:
+	    set or get fan driving mode: 1 for PWM mode, 0 for DC mode.
+
+  pwm1:
+	    get or set PWM fan control value in open-loop mode. This is an
+	    integer value between 0 and 255. 0 stops the fan, 255 makes
+	    it run at full speed.
 
 Both in PWM mode ('pwm1_mode' set to 1) and DC mode ('pwm1_mode' set to 0),
 when current fan speed control mode is open-loop ('pwm1_enable' set to 1),
diff --git a/Documentation/hwmon/gl518sm b/Documentation/hwmon/gl518sm
index 494bb55b6e72..bf1e0b5e824b 100644
--- a/Documentation/hwmon/gl518sm
+++ b/Documentation/hwmon/gl518sm
@@ -2,27 +2,34 @@ Kernel driver gl518sm
 =====================
 
 Supported chips:
+
   * Genesys Logic GL518SM release 0x00
+
     Prefix: 'gl518sm'
+
     Addresses scanned: I2C 0x2c and 0x2d
+
   * Genesys Logic GL518SM release 0x80
+
     Prefix: 'gl518sm'
+
     Addresses scanned: I2C 0x2c and 0x2d
+
     Datasheet: http://www.genesyslogic.com/
 
 Authors:
-        Frodo Looijaard <frodol@dds.nl>,
-        Kyösti Mälkki <kmalkki@cc.hut.fi>
-        Hong-Gunn Chew <hglinux@gunnet.org>
-        Jean Delvare <jdelvare@suse.de>
+       - Frodo Looijaard <frodol@dds.nl>,
+       - Kyösti Mälkki <kmalkki@cc.hut.fi>
+       - Hong-Gunn Chew <hglinux@gunnet.org>
+       - Jean Delvare <jdelvare@suse.de>
 
 Description
 -----------
 
-IMPORTANT:
+.. important::
 
-For the revision 0x00 chip, the in0, in1, and in2  values (+5V, +3V,
-and +12V) CANNOT be read. This is a limitation of the chip, not the driver.
+   For the revision 0x00 chip, the in0, in1, and in2  values (+5V, +3V,
+   and +12V) CANNOT be read. This is a limitation of the chip, not the driver.
 
 This driver supports the Genesys Logic GL518SM chip. There are at least
 two revision of this chip, which we call revision 0x00 and 0x80. Revision
diff --git a/Documentation/hwmon/hih6130 b/Documentation/hwmon/hih6130
index 73dae918ea7b..649bd4be4fc2 100644
--- a/Documentation/hwmon/hih6130
+++ b/Documentation/hwmon/hih6130
@@ -2,11 +2,16 @@ Kernel driver hih6130
 =====================
 
 Supported chips:
+
   * Honeywell HIH-6130 / HIH-6131
+
     Prefix: 'hih6130'
+
     Addresses scanned: none
+
     Datasheet: Publicly available at the Honeywell website
-    http://sensing.honeywell.com/index.php?ci_id=3106&la_id=1&defId=44872
+
+	http://sensing.honeywell.com/index.php?ci_id=3106&la_id=1&defId=44872
 
 Author:
   Iain Paton <ipaton0@gmail.com>
@@ -28,8 +33,11 @@ instantiate I2C devices.
 sysfs-Interface
 ---------------
 
-temp1_input - temperature input
-humidity1_input - humidity input
+temp1_input
+	temperature input
+
+humidity1_input
+	humidity input
 
 Notes
 -----
diff --git a/Documentation/hwmon/hwmon-kernel-api.txt b/Documentation/hwmon/hwmon-kernel-api.txt
index f8e2ab5c21b9..b347b959fcda 100644
--- a/Documentation/hwmon/hwmon-kernel-api.txt
+++ b/Documentation/hwmon/hwmon-kernel-api.txt
@@ -1,5 +1,5 @@
-The Linux Hardware Monitoring kernel API.
-=========================================
+The Linux Hardware Monitoring kernel API
+========================================
 
 Guenter Roeck
 
@@ -21,33 +21,34 @@ The API
 -------
 Each hardware monitoring driver must #include <linux/hwmon.h> and, in most
 cases, <linux/hwmon-sysfs.h>. linux/hwmon.h declares the following
-register/unregister functions:
+register/unregister functions::
 
-struct device *
-hwmon_device_register_with_groups(struct device *dev, const char *name,
-				  void *drvdata,
-				  const struct attribute_group **groups);
+  struct device *
+  hwmon_device_register_with_groups(struct device *dev, const char *name,
+				    void *drvdata,
+				    const struct attribute_group **groups);
 
-struct device *
-devm_hwmon_device_register_with_groups(struct device *dev,
-				       const char *name, void *drvdata,
-				       const struct attribute_group **groups);
+  struct device *
+  devm_hwmon_device_register_with_groups(struct device *dev,
+					 const char *name, void *drvdata,
+					 const struct attribute_group **groups);
 
-struct device *
-hwmon_device_register_with_info(struct device *dev,
-				const char *name, void *drvdata,
-				const struct hwmon_chip_info *info,
-				const struct attribute_group **extra_groups);
+  struct device *
+  hwmon_device_register_with_info(struct device *dev,
+				  const char *name, void *drvdata,
+				  const struct hwmon_chip_info *info,
+				  const struct attribute_group **extra_groups);
 
-struct device *
-devm_hwmon_device_register_with_info(struct device *dev,
-				const char *name,
-				void *drvdata,
-				const struct hwmon_chip_info *info,
-				const struct attribute_group **extra_groups);
+  struct device *
+  devm_hwmon_device_register_with_info(struct device *dev,
+				       const char *name,
+				       void *drvdata,
+				       const struct hwmon_chip_info *info,
+				       const struct attribute_group **extra_groups);
 
-void hwmon_device_unregister(struct device *dev);
-void devm_hwmon_device_unregister(struct device *dev);
+  void hwmon_device_unregister(struct device *dev);
+
+  void devm_hwmon_device_unregister(struct device *dev);
 
 hwmon_device_register_with_groups registers a hardware monitoring device.
 The first parameter of this function is a pointer to the parent device.
@@ -100,78 +101,89 @@ Using devm_hwmon_device_register_with_info()
 hwmon_device_register_with_info() registers a hardware monitoring device.
 The parameters to this function are
 
-struct device *dev	Pointer to parent device
-const char *name	Device name
-void *drvdata		Driver private data
-const struct hwmon_chip_info *info
-			Pointer to chip description.
-const struct attribute_group **extra_groups
-			Null-terminated list of additional non-standard
-			sysfs attribute groups.
+=============================================== ===============================================
+`struct device *dev`				Pointer to parent device
+`const char *name`				Device name
+`void *drvdata`					Driver private data
+`const struct hwmon_chip_info *info`		Pointer to chip description.
+`const struct attribute_group **extra_groups` 	Null-terminated list of additional non-standard
+						sysfs attribute groups.
+=============================================== ===============================================
 
 This function returns a pointer to the created hardware monitoring device
 on success and a negative error code for failure.
 
-The hwmon_chip_info structure looks as follows.
+The hwmon_chip_info structure looks as follows::
 
-struct hwmon_chip_info {
-	const struct hwmon_ops *ops;
-	const struct hwmon_channel_info **info;
-};
+	struct hwmon_chip_info {
+		const struct hwmon_ops *ops;
+		const struct hwmon_channel_info **info;
+	};
 
 It contains the following fields:
 
-* ops:	Pointer to device operations.
-* info: NULL-terminated list of device channel descriptors.
+* ops:
+	Pointer to device operations.
+* info:
+	NULL-terminated list of device channel descriptors.
 
-The list of hwmon operations is defined as:
+The list of hwmon operations is defined as::
 
-struct hwmon_ops {
+  struct hwmon_ops {
 	umode_t (*is_visible)(const void *, enum hwmon_sensor_types type,
 			      u32 attr, int);
 	int (*read)(struct device *, enum hwmon_sensor_types type,
 		    u32 attr, int, long *);
 	int (*write)(struct device *, enum hwmon_sensor_types type,
 		     u32 attr, int, long);
-};
+  };
 
 It defines the following operations.
 
-* is_visible: Pointer to a function to return the file mode for each supported
-  attribute. This function is mandatory.
+* is_visible:
+    Pointer to a function to return the file mode for each supported
+    attribute. This function is mandatory.
 
-* read: Pointer to a function for reading a value from the chip. This function
-  is optional, but must be provided if any readable attributes exist.
+* read:
+    Pointer to a function for reading a value from the chip. This function
+    is optional, but must be provided if any readable attributes exist.
 
-* write: Pointer to a function for writing a value to the chip. This function is
-  optional, but must be provided if any writeable attributes exist.
+* write:
+    Pointer to a function for writing a value to the chip. This function is
+    optional, but must be provided if any writeable attributes exist.
 
 Each sensor channel is described with struct hwmon_channel_info, which is
-defined as follows.
+defined as follows::
 
-struct hwmon_channel_info {
-	enum hwmon_sensor_types type;
-	u32 *config;
-};
+	struct hwmon_channel_info {
+		enum hwmon_sensor_types type;
+		u32 *config;
+	};
 
 It contains following fields:
 
-* type: The hardware monitoring sensor type.
-  Supported sensor types are
-  * hwmon_chip		A virtual sensor type, used to describe attributes
-  *			which are not bound to a specific input or output
-  * hwmon_temp		Temperature sensor
-  * hwmon_in		Voltage sensor
-  * hwmon_curr		Current sensor
-  * hwmon_power		Power sensor
-  * hwmon_energy	Energy sensor
-  * hwmon_humidity	Humidity sensor
-  * hwmon_fan		Fan speed sensor
-  * hwmon_pwm		PWM control
+* type:
+    The hardware monitoring sensor type.
 
-* config: Pointer to a 0-terminated list of configuration values for each
-  sensor of the given type. Each value is a combination of bit values
-  describing the attributes supposed by a single sensor.
+    Supported sensor types are
+
+     ================== ==================================================
+     hwmon_chip		A virtual sensor type, used to describe attributes
+			which are not bound to a specific input or output
+     hwmon_temp		Temperature sensor
+     hwmon_in		Voltage sensor
+     hwmon_curr		Current sensor
+     hwmon_power		Power sensor
+     hwmon_energy	Energy sensor
+     hwmon_humidity	Humidity sensor
+     hwmon_fan		Fan speed sensor
+     hwmon_pwm		PWM control
+     ================== ==================================================
+
+* config:
+    Pointer to a 0-terminated list of configuration values for each
+    sensor of the given type. Each value is a combination of bit values
+    describing the attributes supposed by a single sensor.
 
 As an example, here is the complete description file for a LM75 compatible
 sensor chip. The chip has a single temperature sensor. The driver wants to
@@ -179,61 +191,62 @@ register with the thermal subsystem (HWMON_C_REGISTER_TZ), and it supports
 the update_interval attribute (HWMON_C_UPDATE_INTERVAL). The chip supports
 reading the temperature (HWMON_T_INPUT), it has a maximum temperature
 register (HWMON_T_MAX) as well as a maximum temperature hysteresis register
-(HWMON_T_MAX_HYST).
-
-static const u32 lm75_chip_config[] = {
-	HWMON_C_REGISTER_TZ | HWMON_C_UPDATE_INTERVAL,
-	0
-};
-
-static const struct hwmon_channel_info lm75_chip = {
-	.type = hwmon_chip,
-	.config = lm75_chip_config,
-};
-
-static const u32 lm75_temp_config[] = {
-	HWMON_T_INPUT | HWMON_T_MAX | HWMON_T_MAX_HYST,
-	0
-};
-
-static const struct hwmon_channel_info lm75_temp = {
-	.type = hwmon_temp,
-	.config = lm75_temp_config,
-};
-
-static const struct hwmon_channel_info *lm75_info[] = {
-	&lm75_chip,
-	&lm75_temp,
-	NULL
-};
-
-The HWMON_CHANNEL_INFO() macro can and should be used when possible.
-With this macro, the above example can be simplified to
-
-static const struct hwmon_channel_info *lm75_info[] = {
-	HWMON_CHANNEL_INFO(chip,
-			   HWMON_C_REGISTER_TZ | HWMON_C_UPDATE_INTERVAL),
-	HWMON_CHANNEL_INFO(temp,
-			   HWMON_T_INPUT | HWMON_T_MAX | HWMON_T_MAX_HYST),
-	NULL
-};
-
-The remaining declarations are as follows.
-
-static const struct hwmon_ops lm75_hwmon_ops = {
-	.is_visible = lm75_is_visible,
-	.read = lm75_read,
-	.write = lm75_write,
-};
-
-static const struct hwmon_chip_info lm75_chip_info = {
-	.ops = &lm75_hwmon_ops,
-	.info = lm75_info,
-};
+(HWMON_T_MAX_HYST)::
+
+	static const u32 lm75_chip_config[] = {
+		HWMON_C_REGISTER_TZ | HWMON_C_UPDATE_INTERVAL,
+		0
+	};
+
+	static const struct hwmon_channel_info lm75_chip = {
+		.type = hwmon_chip,
+		.config = lm75_chip_config,
+	};
+
+	static const u32 lm75_temp_config[] = {
+		HWMON_T_INPUT | HWMON_T_MAX | HWMON_T_MAX_HYST,
+		0
+	};
+
+	static const struct hwmon_channel_info lm75_temp = {
+		.type = hwmon_temp,
+		.config = lm75_temp_config,
+	};
+
+	static const struct hwmon_channel_info *lm75_info[] = {
+		&lm75_chip,
+		&lm75_temp,
+		NULL
+	};
+
+	The HWMON_CHANNEL_INFO() macro can and should be used when possible.
+	With this macro, the above example can be simplified to
+
+	static const struct hwmon_channel_info *lm75_info[] = {
+		HWMON_CHANNEL_INFO(chip,
+				HWMON_C_REGISTER_TZ | HWMON_C_UPDATE_INTERVAL),
+		HWMON_CHANNEL_INFO(temp,
+				HWMON_T_INPUT | HWMON_T_MAX | HWMON_T_MAX_HYST),
+		NULL
+	};
+
+	The remaining declarations are as follows.
+
+	static const struct hwmon_ops lm75_hwmon_ops = {
+		.is_visible = lm75_is_visible,
+		.read = lm75_read,
+		.write = lm75_write,
+	};
+
+	static const struct hwmon_chip_info lm75_chip_info = {
+		.ops = &lm75_hwmon_ops,
+		.info = lm75_info,
+	};
 
 A complete list of bit values indicating individual attribute support
 is defined in include/linux/hwmon.h. Definition prefixes are as follows.
 
+=============== =================================================
 HWMON_C_xxxx	Chip attributes, for use with hwmon_chip.
 HWMON_T_xxxx	Temperature attributes, for use with hwmon_temp.
 HWMON_I_xxxx	Voltage attributes, for use with hwmon_in.
@@ -244,57 +257,76 @@ HWMON_E_xxxx	Energy attributes, for use with hwmon_energy.
 HWMON_H_xxxx	Humidity attributes, for use with hwmon_humidity.
 HWMON_F_xxxx	Fan speed attributes, for use with hwmon_fan.
 HWMON_PWM_xxxx	PWM control attributes, for use with hwmon_pwm.
+=============== =================================================
 
 Driver callback functions
 -------------------------
 
 Each driver provides is_visible, read, and write functions. Parameters
-and return values for those functions are as follows.
+and return values for those functions are as follows::
 
-umode_t is_visible_func(const void *data, enum hwmon_sensor_types type,
-			u32 attr, int channel)
+  umode_t is_visible_func(const void *data, enum hwmon_sensor_types type,
+			  u32 attr, int channel)
 
 Parameters:
-	data:	Pointer to device private data structure.
-	type:	The sensor type.
-	attr:	Attribute identifier associated with a specific attribute.
+	data:
+		Pointer to device private data structure.
+	type:
+		The sensor type.
+	attr:
+		Attribute identifier associated with a specific attribute.
 		For example, the attribute value for HWMON_T_INPUT would be
 		hwmon_temp_input. For complete mappings of bit fields to
 		attribute values please see include/linux/hwmon.h.
-	channel:The sensor channel number.
+	channel:
+		The sensor channel number.
 
 Return value:
 	The file mode for this attribute. Typically, this will be 0 (the
 	attribute will not be created), S_IRUGO, or 'S_IRUGO | S_IWUSR'.
 
-int read_func(struct device *dev, enum hwmon_sensor_types type,
-	      u32 attr, int channel, long *val)
+::
+
+	int read_func(struct device *dev, enum hwmon_sensor_types type,
+		      u32 attr, int channel, long *val)
 
 Parameters:
-	dev:	Pointer to the hardware monitoring device.
-	type:	The sensor type.
-	attr:	Attribute identifier associated with a specific attribute.
+	dev:
+		Pointer to the hardware monitoring device.
+	type:
+		The sensor type.
+	attr:
+		Attribute identifier associated with a specific attribute.
 		For example, the attribute value for HWMON_T_INPUT would be
 		hwmon_temp_input. For complete mappings please see
 		include/linux/hwmon.h.
-	channel:The sensor channel number.
-	val:	Pointer to attribute value.
+	channel:
+		The sensor channel number.
+	val:
+		Pointer to attribute value.
 
 Return value:
 	0 on success, a negative error number otherwise.
 
-int write_func(struct device *dev, enum hwmon_sensor_types type,
-	       u32 attr, int channel, long val)
+::
+
+	int write_func(struct device *dev, enum hwmon_sensor_types type,
+		       u32 attr, int channel, long val)
 
 Parameters:
-	dev:	Pointer to the hardware monitoring device.
-	type:	The sensor type.
-	attr:	Attribute identifier associated with a specific attribute.
+	dev:
+		Pointer to the hardware monitoring device.
+	type:
+		The sensor type.
+	attr:
+		Attribute identifier associated with a specific attribute.
 		For example, the attribute value for HWMON_T_INPUT would be
 		hwmon_temp_input. For complete mappings please see
 		include/linux/hwmon.h.
-	channel:The sensor channel number.
-	val:	The value to write to the chip.
+	channel:
+		The sensor channel number.
+	val:
+		The value to write to the chip.
 
 Return value:
 	0 on success, a negative error number otherwise.
@@ -330,25 +362,25 @@ Standard functions, similar to DEVICE_ATTR_{RW,RO,WO}, have _show and _store
 appended to the provided function name.
 
 SENSOR_DEVICE_ATTR and its variants define a struct sensor_device_attribute
-variable. This structure has the following fields.
+variable. This structure has the following fields::
 
-struct sensor_device_attribute {
-	struct device_attribute dev_attr;
-	int index;
-};
+	struct sensor_device_attribute {
+		struct device_attribute dev_attr;
+		int index;
+	};
 
 You can use to_sensor_dev_attr to get the pointer to this structure from the
 attribute read or write function. Its parameter is the device to which the
 attribute is attached.
 
 SENSOR_DEVICE_ATTR_2 and its variants define a struct sensor_device_attribute_2
-variable, which is defined as follows.
+variable, which is defined as follows::
 
-struct sensor_device_attribute_2 {
-	struct device_attribute dev_attr;
-	u8 index;
-	u8 nr;
-};
+	struct sensor_device_attribute_2 {
+		struct device_attribute dev_attr;
+		u8 index;
+		u8 nr;
+	};
 
 Use to_sensor_dev_attr_2 to get the pointer to this structure. Its parameter
 is the device to which the attribute is attached.
diff --git a/Documentation/hwmon/ibmaem b/Documentation/hwmon/ibmaem
index 1e0d59e000b4..f07a14a1c2f5 100644
--- a/Documentation/hwmon/ibmaem
+++ b/Documentation/hwmon/ibmaem
@@ -1,15 +1,21 @@
 Kernel driver ibmaem
-======================
+====================
 
 This driver talks to the IBM Systems Director Active Energy Manager, known
 henceforth as AEM.
 
 Supported systems:
+
   * Any recent IBM System X server with AEM support.
+
     This includes the x3350, x3550, x3650, x3655, x3755, x3850 M2,
-    x3950 M2, and certain HC10/HS2x/LS2x/QS2x blades.  The IPMI host interface
+    x3950 M2, and certain HC10/HS2x/LS2x/QS2x blades.
+
+    The IPMI host interface
     driver ("ipmi-si") needs to be loaded for this driver to do anything.
+
     Prefix: 'ibmaem'
+
     Datasheet: Not available
 
 Author: Darrick J. Wong
diff --git a/Documentation/hwmon/ina3221 b/Documentation/hwmon/ina3221
index ed3f22769d4b..1e34abb38b59 100644
--- a/Documentation/hwmon/ina3221
+++ b/Documentation/hwmon/ina3221
@@ -2,11 +2,16 @@ Kernel driver ina3221
 =====================
 
 Supported chips:
+
   * Texas Instruments INA3221
+
     Prefix: 'ina3221'
+
     Addresses: I2C 0x40 - 0x43
+
     Datasheet: Publicly available at the Texas Instruments website
-               http://www.ti.com/
+
+	       http://www.ti.com/
 
 Author: Andrew F. Davis <afd@ti.com>
 
@@ -21,20 +26,24 @@ and power are calculated host-side from these.
 Sysfs entries
 -------------
 
+======================= =======================================================
 in[123]_label           Voltage channel labels
 in[123]_enable          Voltage channel enable controls
 in[123]_input           Bus voltage(mV) channels
 curr[123]_input         Current(mA) measurement channels
 shunt[123]_resistor     Shunt resistance(uOhm) channels
 curr[123]_crit          Critical alert current(mA) setting, activates the
-                          corresponding alarm when the respective current
-                          is above this value
+			corresponding alarm when the respective current
+			is above this value
 curr[123]_crit_alarm    Critical alert current limit exceeded
 curr[123]_max           Warning alert current(mA) setting, activates the
-                          corresponding alarm when the respective current
-                          average is above this value.
+			corresponding alarm when the respective current
+			average is above this value.
 curr[123]_max_alarm     Warning alert current limit exceeded
 in[456]_input           Shunt voltage(uV) for channels 1, 2, and 3 respectively
 samples                 Number of samples using in the averaging mode.
-                          Supports the list of number of samples:
+
+                        Supports the list of number of samples:
+
                           1, 4, 16, 64, 128, 256, 512, 1024
+======================= =======================================================
diff --git a/Documentation/hwmon/it87 b/Documentation/hwmon/it87
index fff6f6bf55bc..2d83f23bee93 100644
--- a/Documentation/hwmon/it87
+++ b/Documentation/hwmon/it87
@@ -2,105 +2,179 @@ Kernel driver it87
 ==================
 
 Supported chips:
+
   * IT8603E/IT8623E
+
     Prefix: 'it8603'
+
     Addresses scanned: from Super I/O config space (8 I/O ports)
+
     Datasheet: Not publicly available
+
   * IT8620E
+
     Prefix: 'it8620'
+
     Addresses scanned: from Super I/O config space (8 I/O ports)
+
   * IT8628E
+
     Prefix: 'it8628'
+
     Addresses scanned: from Super I/O config space (8 I/O ports)
+
     Datasheet: Not publicly available
+
   * IT8705F
+
     Prefix: 'it87'
+
     Addresses scanned: from Super I/O config space (8 I/O ports)
+
     Datasheet: Once publicly available at the ITE website, but no longer
+
   * IT8712F
+
     Prefix: 'it8712'
+
     Addresses scanned: from Super I/O config space (8 I/O ports)
+
     Datasheet: Once publicly available at the ITE website, but no longer
+
   * IT8716F/IT8726F
+
     Prefix: 'it8716'
+
     Addresses scanned: from Super I/O config space (8 I/O ports)
+
     Datasheet: Once publicly available at the ITE website, but no longer
+
   * IT8718F
+
     Prefix: 'it8718'
+
     Addresses scanned: from Super I/O config space (8 I/O ports)
+
     Datasheet: Once publicly available at the ITE website, but no longer
+
   * IT8720F
+
     Prefix: 'it8720'
+
     Addresses scanned: from Super I/O config space (8 I/O ports)
+
     Datasheet: Not publicly available
+
   * IT8721F/IT8758E
+
     Prefix: 'it8721'
+
     Addresses scanned: from Super I/O config space (8 I/O ports)
+
     Datasheet: Not publicly available
+
   * IT8728F
+
     Prefix: 'it8728'
+
     Addresses scanned: from Super I/O config space (8 I/O ports)
+
     Datasheet: Not publicly available
+
   * IT8732F
+
     Prefix: 'it8732'
+
     Addresses scanned: from Super I/O config space (8 I/O ports)
+
     Datasheet: Not publicly available
+
   * IT8771E
+
     Prefix: 'it8771'
+
     Addresses scanned: from Super I/O config space (8 I/O ports)
+
     Datasheet: Not publicly available
+
   * IT8772E
+
     Prefix: 'it8772'
+
     Addresses scanned: from Super I/O config space (8 I/O ports)
+
     Datasheet: Not publicly available
+
   * IT8781F
+
     Prefix: 'it8781'
+
     Addresses scanned: from Super I/O config space (8 I/O ports)
+
     Datasheet: Not publicly available
+
   * IT8782F
+
     Prefix: 'it8782'
+
     Addresses scanned: from Super I/O config space (8 I/O ports)
+
     Datasheet: Not publicly available
+
   * IT8783E/F
+
     Prefix: 'it8783'
+
     Addresses scanned: from Super I/O config space (8 I/O ports)
+
     Datasheet: Not publicly available
+
   * IT8786E
+
     Prefix: 'it8786'
+
     Addresses scanned: from Super I/O config space (8 I/O ports)
+
     Datasheet: Not publicly available
+
   * IT8790E
+
     Prefix: 'it8790'
+
     Addresses scanned: from Super I/O config space (8 I/O ports)
+
     Datasheet: Not publicly available
+
   * SiS950   [clone of IT8705F]
+
     Prefix: 'it87'
+
     Addresses scanned: from Super I/O config space (8 I/O ports)
+
     Datasheet: No longer be available
 
+
 Authors:
-    Christophe Gauthron
-    Jean Delvare <jdelvare@suse.de>
+    - Christophe Gauthron
+    - Jean Delvare <jdelvare@suse.de>
 
 
 Module Parameters
 -----------------
 
 * update_vbat: int
-
-  0 if vbat should report power on value, 1 if vbat should be updated after
-  each read. Default is 0. On some boards the battery voltage is provided
-  by either the battery or the onboard power supply. Only the first reading
-  at power on will be the actual battery voltage (which the chip does
-  automatically). On other boards the battery voltage is always fed to
-  the chip so can be read at any time. Excessive reading may decrease
-  battery life but no information is given in the datasheet.
+    0 if vbat should report power on value, 1 if vbat should be updated after
+    each read. Default is 0. On some boards the battery voltage is provided
+    by either the battery or the onboard power supply. Only the first reading
+    at power on will be the actual battery voltage (which the chip does
+    automatically). On other boards the battery voltage is always fed to
+    the chip so can be read at any time. Excessive reading may decrease
+    battery life but no information is given in the datasheet.
 
 * fix_pwm_polarity int
-
-  Force PWM polarity to active high (DANGEROUS). Some chips are
-  misconfigured by BIOS - PWM values would be inverted. This option tries
-  to fix this. Please contact your BIOS manufacturer and ask him for fix.
+    Force PWM polarity to active high (DANGEROUS). Some chips are
+    misconfigured by BIOS - PWM values would be inverted. This option tries
+    to fix this. Please contact your BIOS manufacturer and ask him for fix.
 
 
 Hardware Interfaces
diff --git a/Documentation/hwmon/lineage-pem b/Documentation/hwmon/lineage-pem
index 83b2ddc160c8..10c271dc20e8 100644
--- a/Documentation/hwmon/lineage-pem
+++ b/Documentation/hwmon/lineage-pem
@@ -2,11 +2,16 @@ Kernel driver lineage-pem
 =========================
 
 Supported devices:
+
   * Lineage Compact Power Line Power Entry Modules
+
     Prefix: 'lineage-pem'
+
     Addresses scanned: -
+
     Documentation:
-        http://www.lineagepower.com/oem/pdf/CPLI2C.pdf
+
+	http://www.lineagepower.com/oem/pdf/CPLI2C.pdf
 
 Author: Guenter Roeck <linux@roeck-us.net>
 
@@ -31,9 +36,10 @@ which can be safely used to identify the chip. You will have to instantiate
 the devices explicitly.
 
 Example: the following will load the driver for a Lineage PEM at address 0x40
-on I2C bus #1:
-$ modprobe lineage-pem
-$ echo lineage-pem 0x40 > /sys/bus/i2c/devices/i2c-1/new_device
+on I2C bus #1::
+
+	$ modprobe lineage-pem
+	$ echo lineage-pem 0x40 > /sys/bus/i2c/devices/i2c-1/new_device
 
 All Lineage CPL power entry modules have a built-in I2C bus master selector
 (PCA9541). To ensure device access, this driver should only be used as client
@@ -51,6 +57,7 @@ Input voltage, input current, input power, and fan speed measurement is only
 supported on newer devices. The driver detects if those attributes are supported,
 and only creates respective sysfs entries if they are.
 
+======================= ===============================
 in1_input		Output voltage (mV)
 in1_min_alarm		Output undervoltage alarm
 in1_max_alarm		Output overvoltage alarm
@@ -75,3 +82,4 @@ temp1_crit
 temp1_alarm
 temp1_crit_alarm
 temp1_fault
+======================= ===============================
diff --git a/Documentation/hwmon/lm63 b/Documentation/hwmon/lm63
index 4a00461512a6..f478132b0408 100644
--- a/Documentation/hwmon/lm63
+++ b/Documentation/hwmon/lm63
@@ -2,26 +2,43 @@ Kernel driver lm63
 ==================
 
 Supported chips:
+
   * National Semiconductor LM63
+
     Prefix: 'lm63'
+
     Addresses scanned: I2C 0x4c
+
     Datasheet: Publicly available at the National Semiconductor website
-               http://www.national.com/pf/LM/LM63.html
+
+	       http://www.national.com/pf/LM/LM63.html
+
   * National Semiconductor LM64
+
     Prefix: 'lm64'
+
     Addresses scanned: I2C 0x18 and 0x4e
+
     Datasheet: Publicly available at the National Semiconductor website
-               http://www.national.com/pf/LM/LM64.html
+
+	       http://www.national.com/pf/LM/LM64.html
+
   * National Semiconductor LM96163
+
     Prefix: 'lm96163'
+
     Addresses scanned: I2C 0x4c
+
     Datasheet: Publicly available at the National Semiconductor website
-               http://www.national.com/pf/LM/LM96163.html
+
+	       http://www.national.com/pf/LM/LM96163.html
+
 
 Author: Jean Delvare <jdelvare@suse.de>
 
 Thanks go to Tyan and especially Alex Buckingham for setting up a remote
 access to their S4882 test platform for this driver.
+
   http://www.tyan.com/
 
 Description
@@ -32,6 +49,7 @@ and control.
 
 The LM63 is basically an LM86 with fan speed monitoring and control
 capabilities added. It misses some of the LM86 features though:
+
  - No low limit for local temperature.
  - No critical limit for local temperature.
  - Critical limit for remote temperature can be changed only once. We
diff --git a/Documentation/hwmon/lm70 b/Documentation/hwmon/lm70
index c3a1f2ea017d..f259bc1fcd91 100644
--- a/Documentation/hwmon/lm70
+++ b/Documentation/hwmon/lm70
@@ -2,19 +2,30 @@ Kernel driver lm70
 ==================
 
 Supported chips:
+
   * National Semiconductor LM70
+
     Datasheet: http://www.national.com/pf/LM/LM70.html
+
   * Texas Instruments TMP121/TMP123
+
     Information: http://focus.ti.com/docs/prod/folders/print/tmp121.html
+
   * Texas Instruments TMP122/TMP124
+
     Information: http://www.ti.com/product/tmp122
+
   * National Semiconductor LM71
+
     Datasheet: http://www.ti.com/product/LM71
+
   * National Semiconductor LM74
+
     Datasheet: http://www.ti.com/product/LM74
 
+
 Author:
-        Kaiwan N Billimoria <kaiwan@designergraphix.com>
+	Kaiwan N Billimoria <kaiwan@designergraphix.com>
 
 Description
 -----------
diff --git a/Documentation/hwmon/lm73 b/Documentation/hwmon/lm73
index 8af059dcb642..1d6a46844e85 100644
--- a/Documentation/hwmon/lm73
+++ b/Documentation/hwmon/lm73
@@ -2,13 +2,20 @@ Kernel driver lm73
 ==================
 
 Supported chips:
+
   * Texas Instruments LM73
+
     Prefix: 'lm73'
+
     Addresses scanned: I2C 0x48, 0x49, 0x4a, 0x4c, 0x4d, and 0x4e
+
     Datasheet: Publicly available at the Texas Instruments website
-               http://www.ti.com/product/lm73
+
+	       http://www.ti.com/product/lm73
+
 
 Author: Guillaume Ligneul <guillaume.ligneul@gmail.com>
+
 Documentation: Chris Verges <kg4ysn@gmail.com>
 
 
@@ -29,17 +36,18 @@ conversion time via the 'update_interval' sysfs attribute for the
 device.  This attribute will normalize ranges of input values to the
 maximum times defined for the resolution in the datasheet.
 
+    ============= ============= ============
     Resolution    Conv. Time    Input Range
     (C/LSB)       (msec)        (msec)
-    --------------------------------------
+    ============= ============= ============
     0.25          14             0..14
     0.125         28            15..28
     0.0625        56            29..56
     0.03125       112           57..infinity
-    --------------------------------------
+    ============= ============= ============
 
 The following examples show how the 'update_interval' attribute can be
-used to change the conversion time:
+used to change the conversion time::
 
     $ echo 0 > update_interval
     $ cat update_interval
diff --git a/Documentation/hwmon/lm75 b/Documentation/hwmon/lm75
index 010583608f12..6fd4d2df5420 100644
--- a/Documentation/hwmon/lm75
+++ b/Documentation/hwmon/lm75
@@ -2,68 +2,130 @@ Kernel driver lm75
 ==================
 
 Supported chips:
+
   * National Semiconductor LM75
+
     Prefix: 'lm75'
+
     Addresses scanned: I2C 0x48 - 0x4f
+
     Datasheet: Publicly available at the National Semiconductor website
-               http://www.national.com/
+
+	       http://www.national.com/
+
   * National Semiconductor LM75A
+
     Prefix: 'lm75a'
+
     Addresses scanned: I2C 0x48 - 0x4f
+
     Datasheet: Publicly available at the National Semiconductor website
-               http://www.national.com/
+
+	       http://www.national.com/
+
   * Dallas Semiconductor (now Maxim) DS75, DS1775, DS7505
+
     Prefixes: 'ds75', 'ds1775', 'ds7505'
+
     Addresses scanned: none
+
     Datasheet: Publicly available at the Maxim website
-               http://www.maximintegrated.com/
+
+	       http://www.maximintegrated.com/
+
   * Maxim MAX6625, MAX6626, MAX31725, MAX31726
+
     Prefixes: 'max6625', 'max6626', 'max31725', 'max31726'
+
     Addresses scanned: none
+
     Datasheet: Publicly available at the Maxim website
-               http://www.maxim-ic.com/
+
+	       http://www.maxim-ic.com/
+
   * Microchip (TelCom) TCN75
+
     Prefix: 'tcn75'
+
     Addresses scanned: none
+
     Datasheet: Publicly available at the Microchip website
-               http://www.microchip.com/
+
+	       http://www.microchip.com/
+
   * Microchip MCP9800, MCP9801, MCP9802, MCP9803
+
     Prefix: 'mcp980x'
+
     Addresses scanned: none
+
     Datasheet: Publicly available at the Microchip website
-               http://www.microchip.com/
+
+	       http://www.microchip.com/
+
   * Analog Devices ADT75
+
     Prefix: 'adt75'
+
     Addresses scanned: none
+
     Datasheet: Publicly available at the Analog Devices website
-               http://www.analog.com/adt75
+
+	       http://www.analog.com/adt75
+
   * ST Microelectronics STDS75
+
     Prefix: 'stds75'
+
     Addresses scanned: none
+
     Datasheet: Publicly available at the ST website
-               http://www.st.com/internet/analog/product/121769.jsp
+
+	       http://www.st.com/internet/analog/product/121769.jsp
+
   * ST Microelectronics STLM75
+
     Prefix: 'stlm75'
+
     Addresses scanned: none
+
     Datasheet: Publicly available at the ST website
+
 	       https://www.st.com/resource/en/datasheet/stlm75.pdf
+
   * Texas Instruments TMP100, TMP101, TMP105, TMP112, TMP75, TMP75C, TMP175, TMP275
+
     Prefixes: 'tmp100', 'tmp101', 'tmp105', 'tmp112', 'tmp175', 'tmp75', 'tmp75c', 'tmp275'
+
     Addresses scanned: none
+
     Datasheet: Publicly available at the Texas Instruments website
-               http://www.ti.com/product/tmp100
-               http://www.ti.com/product/tmp101
-               http://www.ti.com/product/tmp105
-               http://www.ti.com/product/tmp112
-               http://www.ti.com/product/tmp75
-               http://www.ti.com/product/tmp75c
-               http://www.ti.com/product/tmp175
-               http://www.ti.com/product/tmp275
+
+	       http://www.ti.com/product/tmp100
+
+	       http://www.ti.com/product/tmp101
+
+	       http://www.ti.com/product/tmp105
+
+	       http://www.ti.com/product/tmp112
+
+	       http://www.ti.com/product/tmp75
+
+	       http://www.ti.com/product/tmp75c
+
+	       http://www.ti.com/product/tmp175
+
+	       http://www.ti.com/product/tmp275
+
   * NXP LM75B
+
     Prefix: 'lm75b'
+
     Addresses scanned: none
+
     Datasheet: Publicly available at the NXP website
-               http://www.nxp.com/documents/data_sheet/LM75B.pdf
+
+	       http://www.nxp.com/documents/data_sheet/LM75B.pdf
 
 Author: Frodo Looijaard <frodol@dds.nl>
 
diff --git a/Documentation/hwmon/lm77 b/Documentation/hwmon/lm77
index bfc915fe3639..4ed3fe6b999a 100644
--- a/Documentation/hwmon/lm77
+++ b/Documentation/hwmon/lm77
@@ -2,11 +2,17 @@ Kernel driver lm77
 ==================
 
 Supported chips:
+
   * National Semiconductor LM77
+
     Prefix: 'lm77'
+
     Addresses scanned: I2C 0x48 - 0x4b
+
     Datasheet: Publicly available at the National Semiconductor website
-               http://www.national.com/
+
+	       http://www.national.com/
+
 
 Author: Andras BALI <drewie@freemail.hu>
 
@@ -25,6 +31,7 @@ register on the chip, which means that the relative difference between
 the limit and its hysteresis is always the same for all 3 limits.
 
 This implementation detail implies the following:
+
 * When setting a limit, its hysteresis will automatically follow, the
   difference staying unchanged. For example, if the old critical limit
   was 80 degrees C, and the hysteresis was 75 degrees C, and you change
diff --git a/Documentation/hwmon/lm78 b/Documentation/hwmon/lm78
index 4dd47731789f..cb7a4832f35e 100644
--- a/Documentation/hwmon/lm78
+++ b/Documentation/hwmon/lm78
@@ -2,19 +2,31 @@ Kernel driver lm78
 ==================
 
 Supported chips:
+
   * National Semiconductor LM78 / LM78-J
+
     Prefix: 'lm78'
+
     Addresses scanned: I2C 0x28 - 0x2f, ISA 0x290 (8 I/O ports)
+
     Datasheet: Publicly available at the National Semiconductor website
-               http://www.national.com/
+
+	       http://www.national.com/
+
   * National Semiconductor LM79
+
     Prefix: 'lm79'
+
     Addresses scanned: I2C 0x28 - 0x2f, ISA 0x290 (8 I/O ports)
+
     Datasheet: Publicly available at the National Semiconductor website
-               http://www.national.com/
 
-Authors: Frodo Looijaard <frodol@dds.nl>
-         Jean Delvare <jdelvare@suse.de>
+	       http://www.national.com/
+
+
+Authors:
+	- Frodo Looijaard <frodol@dds.nl>
+	- Jean Delvare <jdelvare@suse.de>
 
 Description
 -----------
diff --git a/Documentation/hwmon/lm80 b/Documentation/hwmon/lm80
index a60b43efc32b..c53186abd82e 100644
--- a/Documentation/hwmon/lm80
+++ b/Documentation/hwmon/lm80
@@ -2,20 +2,31 @@ Kernel driver lm80
 ==================
 
 Supported chips:
+
   * National Semiconductor LM80
+
     Prefix: 'lm80'
+
     Addresses scanned: I2C 0x28 - 0x2f
+
     Datasheet: Publicly available at the National Semiconductor website
-               http://www.national.com/
+
+	       http://www.national.com/
+
   * National Semiconductor LM96080
+
     Prefix: 'lm96080'
+
     Addresses scanned: I2C 0x28 - 0x2f
+
     Datasheet: Publicly available at the National Semiconductor website
-               http://www.national.com/
+
+	       http://www.national.com/
+
 
 Authors:
-        Frodo Looijaard <frodol@dds.nl>,
-        Philip Edelbrock <phil@netroedge.com>
+       - Frodo Looijaard <frodol@dds.nl>,
+       - Philip Edelbrock <phil@netroedge.com>
 
 Description
 -----------
diff --git a/Documentation/hwmon/lm83 b/Documentation/hwmon/lm83
index 50be5cb26de9..ecf83819960e 100644
--- a/Documentation/hwmon/lm83
+++ b/Documentation/hwmon/lm83
@@ -2,16 +2,24 @@ Kernel driver lm83
 ==================
 
 Supported chips:
+
   * National Semiconductor LM83
+
     Prefix: 'lm83'
+
     Addresses scanned: I2C 0x18 - 0x1a, 0x29 - 0x2b, 0x4c - 0x4e
+
     Datasheet: Publicly available at the National Semiconductor website
-               http://www.national.com/pf/LM/LM83.html
+
+	       http://www.national.com/pf/LM/LM83.html
+
   * National Semiconductor LM82
+
     Addresses scanned: I2C 0x18 - 0x1a, 0x29 - 0x2b, 0x4c - 0x4e
+
     Datasheet: Publicly available at the National Semiconductor website
-               http://www.national.com/pf/LM/LM82.html
 
+	       http://www.national.com/pf/LM/LM82.html
 
 Author: Jean Delvare <jdelvare@suse.de>
 
@@ -34,13 +42,17 @@ fact that any of these motherboards do actually have an LM83, please
 contact us. Note that the LM90 can easily be misdetected as a LM83.
 
 Confirmed motherboards:
+    ===		=====
     SBS         P014
     SBS         PSL09
+    ===		=====
 
 Unconfirmed motherboards:
+    =========== ==========
     Gigabyte    GA-8IK1100
     Iwill       MPX2
     Soltek      SL-75DRV5
+    =========== ==========
 
 The LM82 is confirmed to have been found on most AMD Geode reference
 designs and test platforms.
diff --git a/Documentation/hwmon/lm85 b/Documentation/hwmon/lm85
index 2329c383efe4..faa92f54431c 100644
--- a/Documentation/hwmon/lm85
+++ b/Documentation/hwmon/lm85
@@ -2,49 +2,85 @@ Kernel driver lm85
 ==================
 
 Supported chips:
+
   * National Semiconductor LM85 (B and C versions)
+
     Prefix: 'lm85b' or 'lm85c'
+
     Addresses scanned: I2C 0x2c, 0x2d, 0x2e
+
     Datasheet: http://www.national.com/pf/LM/LM85.html
+
   * Texas Instruments LM96000
+
     Prefix: 'lm9600'
+
     Addresses scanned: I2C 0x2c, 0x2d, 0x2e
+
     Datasheet: http://www.ti.com/lit/ds/symlink/lm96000.pdf
+
   * Analog Devices ADM1027
+
     Prefix: 'adm1027'
+
     Addresses scanned: I2C 0x2c, 0x2d, 0x2e
+
     Datasheet: http://www.onsemi.com/PowerSolutions/product.do?id=ADM1027
+
   * Analog Devices ADT7463
+
     Prefix: 'adt7463'
+
     Addresses scanned: I2C 0x2c, 0x2d, 0x2e
+
     Datasheet: http://www.onsemi.com/PowerSolutions/product.do?id=ADT7463
+
   * Analog Devices ADT7468
+
     Prefix: 'adt7468'
+
     Addresses scanned: I2C 0x2c, 0x2d, 0x2e
+
     Datasheet: http://www.onsemi.com/PowerSolutions/product.do?id=ADT7468
+
   * SMSC EMC6D100, SMSC EMC6D101
+
     Prefix: 'emc6d100'
+
     Addresses scanned: I2C 0x2c, 0x2d, 0x2e
-    Datasheet: http://www.smsc.com/media/Downloads_Public/discontinued/6d100.pdf 
+
+    Datasheet: http://www.smsc.com/media/Downloads_Public/discontinued/6d100.pdf
+
   * SMSC EMC6D102
+
     Prefix: 'emc6d102'
+
     Addresses scanned: I2C 0x2c, 0x2d, 0x2e
+
     Datasheet: http://www.smsc.com/main/catalog/emc6d102.html
+
   * SMSC EMC6D103
+
     Prefix: 'emc6d103'
+
     Addresses scanned: I2C 0x2c, 0x2d, 0x2e
+
     Datasheet: http://www.smsc.com/main/catalog/emc6d103.html
+
   * SMSC EMC6D103S
+
     Prefix: 'emc6d103s'
+
     Addresses scanned: I2C 0x2c, 0x2d, 0x2e
+
     Datasheet: http://www.smsc.com/main/catalog/emc6d103s.html
 
 Authors:
-        Philip Pokorny <ppokorny@penguincomputing.com>,
-        Frodo Looijaard <frodol@dds.nl>,
-        Richard Barrington <rich_b_nz@clear.net.nz>,
-        Margit Schubert-While <margitsw@t-online.de>,
-        Justin Thiessen <jthiessen@penguincomputing.com>
+       - Philip Pokorny <ppokorny@penguincomputing.com>,
+       - Frodo Looijaard <frodol@dds.nl>,
+       - Richard Barrington <rich_b_nz@clear.net.nz>,
+       - Margit Schubert-While <margitsw@t-online.de>,
+       - Justin Thiessen <jthiessen@penguincomputing.com>
 
 Description
 -----------
@@ -177,38 +213,50 @@ Each temperature sensor is associated with a Zone. There are three
 sensors and therefore three zones (# 1, 2 and 3). Each zone has the following
 temperature configuration points:
 
-* temp#_auto_temp_off - temperature below which fans should be off or spinning very low.
-* temp#_auto_temp_min - temperature over which fans start to spin.
-* temp#_auto_temp_max - temperature when fans spin at full speed.
-* temp#_auto_temp_crit - temperature when all fans will run full speed.
+* temp#_auto_temp_off
+	- temperature below which fans should be off or spinning very low.
+* temp#_auto_temp_min
+	- temperature over which fans start to spin.
+* temp#_auto_temp_max
+	- temperature when fans spin at full speed.
+* temp#_auto_temp_crit
+	- temperature when all fans will run full speed.
 
-* PWM Control
+PWM Control
+^^^^^^^^^^^
 
 There are three PWM outputs. The LM85 datasheet suggests that the
 pwm3 output control both fan3 and fan4. Each PWM can be individually
 configured and assigned to a zone for its control value. Each PWM can be
 configured individually according to the following options.
 
-* pwm#_auto_pwm_min - this specifies the PWM value for temp#_auto_temp_off
-                      temperature. (PWM value from 0 to 255)
+* pwm#_auto_pwm_min
+	- this specifies the PWM value for temp#_auto_temp_off
+	  temperature. (PWM value from 0 to 255)
 
-* pwm#_auto_pwm_minctl - this flags selects for temp#_auto_temp_off temperature
-                         the behaviour of fans. Write 1 to let fans spinning at
-			 pwm#_auto_pwm_min or write 0 to let them off.
+* pwm#_auto_pwm_minctl
+	- this flags selects for temp#_auto_temp_off temperature
+	  the behaviour of fans. Write 1 to let fans spinning at
+	  pwm#_auto_pwm_min or write 0 to let them off.
 
-NOTE: It has been reported that there is a bug in the LM85 that causes the flag
-to be associated with the zones not the PWMs. This contradicts all the
-published documentation. Setting pwm#_min_ctl in this case actually affects all
-PWMs controlled by zone '#'.
+.. note::
 
-* PWM Controlling Zone selection
+	It has been reported that there is a bug in the LM85 that causes
+	the flag to be associated with the zones not the PWMs. This
+	contradicts all the published documentation. Setting pwm#_min_ctl
+	in this case actually affects all PWMs controlled by zone '#'.
 
-* pwm#_auto_channels - controls zone that is associated with PWM
+PWM Controlling Zone selection
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+* pwm#_auto_channels
+	- controls zone that is associated with PWM
 
 Configuration choices:
 
-   Value     Meaning
-  ------  ------------------------------------------------
+========== =============================================
+Value      Meaning
+========== =============================================
       1    Controlled by Zone 1
       2    Controlled by Zone 2
       3    Controlled by Zone 3
@@ -217,6 +265,7 @@ Configuration choices:
       0    PWM always 0%  (off)
      -1    PWM always 100%  (full on)
      -2    Manual control (write to 'pwm#' to set)
+========== =============================================
 
 The National LM85's have two vendor specific configuration
 features. Tach. mode and Spinup Control. For more details on these,
diff --git a/Documentation/hwmon/lm87 b/Documentation/hwmon/lm87
index a2339fd9acb9..72fcb577ef2a 100644
--- a/Documentation/hwmon/lm87
+++ b/Documentation/hwmon/lm87
@@ -2,23 +2,32 @@ Kernel driver lm87
 ==================
 
 Supported chips:
+
   * National Semiconductor LM87
+
     Prefix: 'lm87'
+
     Addresses scanned: I2C 0x2c - 0x2e
+
     Datasheet: http://www.national.com/pf/LM/LM87.html
+
   * Analog Devices ADM1024
+
     Prefix: 'adm1024'
+
     Addresses scanned: I2C 0x2c - 0x2e
+
     Datasheet: http://www.analog.com/en/prod/0,2877,ADM1024,00.html
 
+
 Authors:
-        Frodo Looijaard <frodol@dds.nl>,
-        Philip Edelbrock <phil@netroedge.com>,
-        Mark Studebaker <mdsxyz123@yahoo.com>,
-        Stephen Rousset <stephen.rousset@rocketlogix.com>,
-        Dan Eaton <dan.eaton@rocketlogix.com>,
-        Jean Delvare <jdelvare@suse.de>,
-        Original 2.6 port Jeff Oliver
+	- Frodo Looijaard <frodol@dds.nl>,
+	- Philip Edelbrock <phil@netroedge.com>,
+	- Mark Studebaker <mdsxyz123@yahoo.com>,
+	- Stephen Rousset <stephen.rousset@rocketlogix.com>,
+	- Dan Eaton <dan.eaton@rocketlogix.com>,
+	- Jean Delvare <jdelvare@suse.de>,
+	- Original 2.6 port Jeff Oliver
 
 Description
 -----------
diff --git a/Documentation/hwmon/lm90 b/Documentation/hwmon/lm90
index 8122675d30f6..953315987c06 100644
--- a/Documentation/hwmon/lm90
+++ b/Documentation/hwmon/lm90
@@ -2,132 +2,256 @@ Kernel driver lm90
 ==================
 
 Supported chips:
+
   * National Semiconductor LM90
+
     Prefix: 'lm90'
+
     Addresses scanned: I2C 0x4c
+
     Datasheet: Publicly available at the National Semiconductor website
-               http://www.national.com/pf/LM/LM90.html
+
+	       http://www.national.com/pf/LM/LM90.html
+
   * National Semiconductor LM89
+
     Prefix: 'lm89' (no auto-detection)
+
     Addresses scanned: I2C 0x4c and 0x4d
+
     Datasheet: Publicly available at the National Semiconductor website
-               http://www.national.com/mpf/LM/LM89.html
+
+	       http://www.national.com/mpf/LM/LM89.html
+
   * National Semiconductor LM99
+
     Prefix: 'lm99'
+
     Addresses scanned: I2C 0x4c and 0x4d
+
     Datasheet: Publicly available at the National Semiconductor website
-               http://www.national.com/pf/LM/LM99.html
+
+	       http://www.national.com/pf/LM/LM99.html
+
   * National Semiconductor LM86
+
     Prefix: 'lm86'
+
     Addresses scanned: I2C 0x4c
+
     Datasheet: Publicly available at the National Semiconductor website
-               http://www.national.com/mpf/LM/LM86.html
+
+	       http://www.national.com/mpf/LM/LM86.html
+
   * Analog Devices ADM1032
+
     Prefix: 'adm1032'
+
     Addresses scanned: I2C 0x4c and 0x4d
+
     Datasheet: Publicly available at the ON Semiconductor website
-               http://www.onsemi.com/PowerSolutions/product.do?id=ADM1032
+
+	       http://www.onsemi.com/PowerSolutions/product.do?id=ADM1032
+
   * Analog Devices ADT7461
+
     Prefix: 'adt7461'
+
     Addresses scanned: I2C 0x4c and 0x4d
+
     Datasheet: Publicly available at the ON Semiconductor website
-               http://www.onsemi.com/PowerSolutions/product.do?id=ADT7461
+
+	       http://www.onsemi.com/PowerSolutions/product.do?id=ADT7461
+
   * Analog Devices ADT7461A
+
     Prefix: 'adt7461a'
+
     Addresses scanned: I2C 0x4c and 0x4d
+
     Datasheet: Publicly available at the ON Semiconductor website
-               http://www.onsemi.com/PowerSolutions/product.do?id=ADT7461A
+
+	       http://www.onsemi.com/PowerSolutions/product.do?id=ADT7461A
+
   * ON Semiconductor NCT1008
+
     Prefix: 'nct1008'
+
     Addresses scanned: I2C 0x4c and 0x4d
+
     Datasheet: Publicly available at the ON Semiconductor website
-               http://www.onsemi.com/PowerSolutions/product.do?id=NCT1008
+
+	       http://www.onsemi.com/PowerSolutions/product.do?id=NCT1008
+
   * Maxim MAX6646
+
     Prefix: 'max6646'
+
     Addresses scanned: I2C 0x4d
+
     Datasheet: Publicly available at the Maxim website
-               http://www.maxim-ic.com/quick_view2.cfm/qv_pk/3497
+
+	       http://www.maxim-ic.com/quick_view2.cfm/qv_pk/3497
+
   * Maxim MAX6647
+
     Prefix: 'max6646'
+
     Addresses scanned: I2C 0x4e
+
     Datasheet: Publicly available at the Maxim website
-               http://www.maxim-ic.com/quick_view2.cfm/qv_pk/3497
+
+	       http://www.maxim-ic.com/quick_view2.cfm/qv_pk/3497
+
   * Maxim MAX6648
+
     Prefix: 'max6646'
+
     Addresses scanned: I2C 0x4c
+
     Datasheet: Publicly available at the Maxim website
-               http://www.maxim-ic.com/quick_view2.cfm/qv_pk/3500
+
+	       http://www.maxim-ic.com/quick_view2.cfm/qv_pk/3500
+
   * Maxim MAX6649
+
     Prefix: 'max6646'
+
     Addresses scanned: I2C 0x4c
+
     Datasheet: Publicly available at the Maxim website
-               http://www.maxim-ic.com/quick_view2.cfm/qv_pk/3497
+
+	       http://www.maxim-ic.com/quick_view2.cfm/qv_pk/3497
+
   * Maxim MAX6657
+
     Prefix: 'max6657'
+
     Addresses scanned: I2C 0x4c
+
     Datasheet: Publicly available at the Maxim website
-               http://www.maxim-ic.com/quick_view2.cfm/qv_pk/2578
+
+	       http://www.maxim-ic.com/quick_view2.cfm/qv_pk/2578
+
   * Maxim MAX6658
+
     Prefix: 'max6657'
+
     Addresses scanned: I2C 0x4c
+
     Datasheet: Publicly available at the Maxim website
-               http://www.maxim-ic.com/quick_view2.cfm/qv_pk/2578
+
+	       http://www.maxim-ic.com/quick_view2.cfm/qv_pk/2578
+
   * Maxim MAX6659
+
     Prefix: 'max6659'
+
     Addresses scanned: I2C 0x4c, 0x4d, 0x4e
+
     Datasheet: Publicly available at the Maxim website
-               http://www.maxim-ic.com/quick_view2.cfm/qv_pk/2578
+
+	       http://www.maxim-ic.com/quick_view2.cfm/qv_pk/2578
+
   * Maxim MAX6680
+
     Prefix: 'max6680'
+
     Addresses scanned: I2C 0x18, 0x19, 0x1a, 0x29, 0x2a, 0x2b,
-                           0x4c, 0x4d and 0x4e
+
+			   0x4c, 0x4d and 0x4e
+
     Datasheet: Publicly available at the Maxim website
-               http://www.maxim-ic.com/quick_view2.cfm/qv_pk/3370
+
+	       http://www.maxim-ic.com/quick_view2.cfm/qv_pk/3370
+
   * Maxim MAX6681
+
     Prefix: 'max6680'
+
     Addresses scanned: I2C 0x18, 0x19, 0x1a, 0x29, 0x2a, 0x2b,
-                           0x4c, 0x4d and 0x4e
+
+			   0x4c, 0x4d and 0x4e
+
     Datasheet: Publicly available at the Maxim website
-               http://www.maxim-ic.com/quick_view2.cfm/qv_pk/3370
+
+	       http://www.maxim-ic.com/quick_view2.cfm/qv_pk/3370
+
   * Maxim MAX6692
+
     Prefix: 'max6646'
+
     Addresses scanned: I2C 0x4c
+
     Datasheet: Publicly available at the Maxim website
-               http://www.maxim-ic.com/quick_view2.cfm/qv_pk/3500
+
+	       http://www.maxim-ic.com/quick_view2.cfm/qv_pk/3500
+
   * Maxim MAX6695
+
     Prefix: 'max6695'
+
     Addresses scanned: I2C 0x18
+
     Datasheet: Publicly available at the Maxim website
-               http://www.maxim-ic.com/datasheet/index.mvp/id/4199
+
+	       http://www.maxim-ic.com/datasheet/index.mvp/id/4199
+
   * Maxim MAX6696
+
     Prefix: 'max6695'
+
     Addresses scanned: I2C 0x18, 0x19, 0x1a, 0x29, 0x2a, 0x2b,
-                           0x4c, 0x4d and 0x4e
+
+			   0x4c, 0x4d and 0x4e
+
     Datasheet: Publicly available at the Maxim website
-               http://www.maxim-ic.com/datasheet/index.mvp/id/4199
+
+	       http://www.maxim-ic.com/datasheet/index.mvp/id/4199
+
   * Winbond/Nuvoton W83L771W/G
+
     Prefix: 'w83l771'
+
     Addresses scanned: I2C 0x4c
+
     Datasheet: No longer available
+
   * Winbond/Nuvoton W83L771AWG/ASG
+
     Prefix: 'w83l771'
+
     Addresses scanned: I2C 0x4c
+
     Datasheet: Not publicly available, can be requested from Nuvoton
+
   * Philips/NXP SA56004X
+
     Prefix: 'sa56004'
+
     Addresses scanned: I2C 0x48 through 0x4F
+
     Datasheet: Publicly available at NXP website
-               http://ics.nxp.com/products/interface/datasheet/sa56004x.pdf
+
+	       http://ics.nxp.com/products/interface/datasheet/sa56004x.pdf
+
   * GMT G781
+
     Prefix: 'g781'
+
     Addresses scanned: I2C 0x4c, 0x4d
+
     Datasheet: Not publicly available from GMT
+
   * Texas Instruments TMP451
+
     Prefix: 'tmp451'
+
     Addresses scanned: I2C 0x4c
+
     Datasheet: Publicly available at TI website
-               http://www.ti.com/litv/pdf/sbos686
 
+	       http://www.ti.com/litv/pdf/sbos686
 
 Author: Jean Delvare <jdelvare@suse.de>
 
diff --git a/Documentation/hwmon/lm92 b/Documentation/hwmon/lm92
index cfa99a353b8c..c131b923ed36 100644
--- a/Documentation/hwmon/lm92
+++ b/Documentation/hwmon/lm92
@@ -2,22 +2,35 @@ Kernel driver lm92
 ==================
 
 Supported chips:
+
   * National Semiconductor LM92
+
     Prefix: 'lm92'
+
     Addresses scanned: I2C 0x48 - 0x4b
+
     Datasheet: http://www.national.com/pf/LM/LM92.html
+
   * National Semiconductor LM76
+
     Prefix: 'lm92'
+
     Addresses scanned: none, force parameter needed
+
     Datasheet: http://www.national.com/pf/LM/LM76.html
+
   * Maxim MAX6633/MAX6634/MAX6635
+
     Prefix: 'max6635'
+
     Addresses scanned: none, force parameter needed
+
     Datasheet: http://www.maxim-ic.com/quick_view2.cfm/qv_pk/3074
 
+
 Authors:
-        Abraham van der Merwe <abraham@2d3d.co.za>
-        Jean Delvare <jdelvare@suse.de>
+       - Abraham van der Merwe <abraham@2d3d.co.za>
+       - Jean Delvare <jdelvare@suse.de>
 
 
 Description
diff --git a/Documentation/hwmon/lm93 b/Documentation/hwmon/lm93
index f3b2ad2ceb01..49d199b45b67 100644
--- a/Documentation/hwmon/lm93
+++ b/Documentation/hwmon/lm93
@@ -2,20 +2,29 @@ Kernel driver lm93
 ==================
 
 Supported chips:
+
   * National Semiconductor LM93
+
     Prefix 'lm93'
+
     Addresses scanned: I2C 0x2c-0x2e
+
     Datasheet: http://www.national.com/ds.cgi/LM/LM93.pdf
+
   * National Semiconductor LM94
+
     Prefix 'lm94'
+
     Addresses scanned: I2C 0x2c-0x2e
+
     Datasheet: http://www.national.com/ds.cgi/LM/LM94.pdf
 
+
 Authors:
-	Mark M. Hoffman <mhoffman@lightlink.com>
-	Ported to 2.6 by Eric J. Bowersox <ericb@aspsys.com>
-	Adapted to 2.6.20 by Carsten Emde <ce@osadl.org>
-	Modified for mainline integration by Hans J. Koch <hjk@hansjkoch.de>
+	- Mark M. Hoffman <mhoffman@lightlink.com>
+	- Ported to 2.6 by Eric J. Bowersox <ericb@aspsys.com>
+	- Adapted to 2.6.20 by Carsten Emde <ce@osadl.org>
+	- Modified for mainline integration by Hans J. Koch <hjk@hansjkoch.de>
 
 Module Parameters
 -----------------
@@ -67,7 +76,8 @@ LM94 are not supported.
 User Interface
 --------------
 
-#PROCHOT:
+#PROCHOT
+^^^^^^^^
 
 The LM93 can monitor two #PROCHOT signals.  The results are found in the
 sysfs files prochot1, prochot2, prochot1_avg, prochot2_avg, prochot1_max,
@@ -86,7 +96,8 @@ prochot2_interval.  The values in these files specify the intervals for
 list will cause the driver to use the next largest interval.  The available
 intervals are (in seconds):
 
-#PROCHOT intervals: 0.73, 1.46, 2.9, 5.8, 11.7, 23.3, 46.6, 93.2, 186, 372
+#PROCHOT intervals:
+	0.73, 1.46, 2.9, 5.8, 11.7, 23.3, 46.6, 93.2, 186, 372
 
 It is possible to configure the LM93 to logically short the two #PROCHOT
 signals.  I.e. when #P1_PROCHOT is asserted, the LM93 will automatically
@@ -105,16 +116,15 @@ contains a value controlling the duty cycle for the PWM signal used when
 the override function is enabled.  This value ranges from 0 to 15, with 0
 indicating minimum duty cycle and 15 indicating maximum.
 
-#VRD_HOT:
+#VRD_HOT
+^^^^^^^^
 
 The LM93 can monitor two #VRD_HOT signals. The results are found in the
 sysfs files vrdhot1 and vrdhot2. There is one value per file: a boolean for
 which 1 indicates #VRD_HOT is asserted and 0 indicates it is negated. These
 files are read-only.
 
-Smart Tach Mode:
-
-(from the datasheet)
+Smart Tach Mode (from the datasheet)::
 
 	If a fan is driven using a low-side drive PWM, the tachometer
 	output of the fan is corrupted. The LM93 includes smart tachometer
@@ -127,7 +137,8 @@ the fan tachometer with a pwm) to the sysfs file fan<n>_smart_tach.  A zero
 will disable the function for that fan.  Note that Smart tach mode cannot be
 enabled if the PWM output frequency is 22500 Hz (see below).
 
-Manual PWM:
+Manual PWM
+^^^^^^^^^^
 
 The LM93 has a fixed or override mode for the two PWM outputs (although, there
 are still some conditions that will override even this mode - see section
@@ -141,7 +152,8 @@ will cause the driver to use the next largest value.  Also note: when manual
 PWM mode is disabled, the value of pwm1 and pwm2 indicates the current duty
 cycle chosen by the h/w.
 
-PWM Output Frequency:
+PWM Output Frequency
+^^^^^^^^^^^^^^^^^^^^
 
 The LM93 supports several different frequencies for the PWM output channels.
 The sysfs files pwm1_freq and pwm2_freq are used to select the frequency. The
@@ -149,9 +161,11 @@ frequency values are constrained by the hardware.  Selecting a value which is
 not available will cause the driver to use the next largest value.  Also note
 that this parameter has implications for the Smart Tach Mode (see above).
 
-PWM Output Frequencies (in Hz): 12, 36, 48, 60, 72, 84, 96, 22500 (default)
+PWM Output Frequencies (in Hz):
+	12, 36, 48, 60, 72, 84, 96, 22500 (default)
 
-Automatic PWM:
+Automatic PWM
+^^^^^^^^^^^^^
 
 The LM93 is capable of complex automatic fan control, with many different
 points of configuration.  To start, each PWM output can be bound to any
@@ -163,14 +177,16 @@ The eight control sources are: temp1-temp4 (aka "zones" in the datasheet),
 in the sysfs files pwm<n>_auto_channels, where a "1" enables the binding, and
 a "0" disables it. The h/w default is 0x0f (all temperatures bound).
 
-	0x01 - Temp 1
-	0x02 - Temp 2
-	0x04 - Temp 3
-	0x08 - Temp 4
-	0x10 - #PROCHOT 1
-	0x20 - #PROCHOT 2
-	0x40 - #VRDHOT 1
-	0x80 - #VRDHOT 2
+	====== ===========
+	0x01   Temp 1
+	0x02   Temp 2
+	0x04   Temp 3
+	0x08   Temp 4
+	0x10   #PROCHOT 1
+	0x20   #PROCHOT 2
+	0x40   #VRDHOT 1
+	0x80   #VRDHOT 2
+	====== ===========
 
 The function y = f(x) takes a source temperature x to a PWM output y.  This
 function of the LM93 is derived from a base temperature and a table of 12
@@ -180,7 +196,9 @@ degrees C, with the value of offset <i> for temperature value <n> being
 contained in the file temp<n>_auto_offset<i>.  E.g. if the base temperature
 is 40C:
 
+     ========== ======================= =============== =======
      offset #	temp<n>_auto_offset<i>	range		pwm
+     ========== ======================= =============== =======
 	 1		0		-		 25.00%
 	 2		0		-		 28.57%
 	 3		1		40C - 41C	 32.14%
@@ -193,7 +211,8 @@ is 40C:
 	10		2		54C - 56C	 57.14%
 	11		2		56C - 58C	 71.43%
 	12		2		58C - 60C	 85.71%
-					> 60C		100.00%
+	-		-		> 60C		100.00%
+     ========== ======================= =============== =======
 
 Valid offsets are in the range 0C <= x <= 7.5C in 0.5C increments.
 
@@ -213,7 +232,8 @@ temp<n>_auto_pwm_min.  Note, there are only two minimums: one each for temp[12]
 and temp[34].  Therefore, any change to e.g. temp1_auto_pwm_min will also
 affect temp2_auto_pwm_min.
 
-PWM Spin-Up Cycle:
+PWM Spin-Up Cycle
+^^^^^^^^^^^^^^^^^
 
 A spin-up cycle occurs when a PWM output is commanded from 0% duty cycle to
 some value > 0%.  The LM93 supports a minimum duty cycle during spin-up.  These
@@ -225,10 +245,11 @@ the spin-up time in seconds.  The available spin-up times are constrained by
 the hardware.  Selecting a value which is not available will cause the driver
 to use the next largest value.
 
-Spin-up Durations: 0 (disabled, h/w default), 0.1, 0.25, 0.4, 0.7, 1.0,
-		   2.0, 4.0
+Spin-up Durations:
+	0 (disabled, h/w default), 0.1, 0.25, 0.4, 0.7, 1.0, 2.0, 4.0
 
-#PROCHOT and #VRDHOT PWM Ramping:
+#PROCHOT and #VRDHOT PWM Ramping
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 If the #PROCHOT or #VRDHOT signals are asserted while bound to a PWM output
 channel, the LM93 will ramp the PWM output up to 100% duty cycle in discrete
@@ -237,9 +258,11 @@ one value each in seconds: pwm_auto_prochot_ramp and pwm_auto_vrdhot_ramp.
 The available ramp times are constrained by the hardware.  Selecting a value
 which is not available will cause the driver to use the next largest value.
 
-Ramp Times: 0 (disabled, h/w default) to 0.75 in 0.05 second intervals
+Ramp Times:
+	0 (disabled, h/w default) to 0.75 in 0.05 second intervals
 
-Fan Boost:
+Fan Boost
+^^^^^^^^^
 
 For each temperature channel, there is a boost temperature: if the channel
 exceeds this limit, the LM93 will immediately drive both PWM outputs to 100%.
@@ -249,7 +272,8 @@ limit is reached, the temperature channel must drop below this value before
 the boost function is disabled.  This temperature is also expressed in degrees
 C in the sysfs files temp<n>_auto_boost_hyst.
 
-GPIO Pins:
+GPIO Pins
+^^^^^^^^^
 
 The LM93 can monitor the logic level of four dedicated GPIO pins as well as the
 four tach input pins.  GPIO0-GPIO3 correspond to (fan) tach 1-4, respectively.
@@ -260,50 +284,29 @@ LSB is GPIO0, and the MSB is GPIO7.
 LM93 Unique sysfs Files
 -----------------------
 
-	file			description
-	-------------------------------------------------------------
-
-	prochot<n>		current #PROCHOT %
-
-	prochot<n>_avg		moving average #PROCHOT %
-
-	prochot<n>_max		limit #PROCHOT %
-
-	prochot_short		enable or disable logical #PROCHOT pin short
-
-	prochot<n>_override	force #PROCHOT assertion as PWM
-
-	prochot_override_duty_cycle
-				duty cycle for the PWM signal used when
-				#PROCHOT is overridden
-
-	prochot<n>_interval	#PROCHOT PWM sampling interval
-
-	vrdhot<n>		0 means negated, 1 means asserted
-
-	fan<n>_smart_tach	enable or disable smart tach mode
-
-	pwm<n>_auto_channels	select control sources for PWM outputs
-
-	pwm<n>_auto_spinup_min	minimum duty cycle during spin-up
-
-	pwm<n>_auto_spinup_time	duration of spin-up
-
-	pwm_auto_prochot_ramp	ramp time per step when #PROCHOT asserted
-
-	pwm_auto_vrdhot_ramp	ramp time per step when #VRDHOT asserted
-
-	temp<n>_auto_base	temperature channel base
-
-	temp<n>_auto_offset[1-12]
-				temperature channel offsets
-
-	temp<n>_auto_offset_hyst
-				temperature channel offset hysteresis
-
-	temp<n>_auto_boost	temperature channel boost (PWMs to 100%) limit
-
-	temp<n>_auto_boost_hyst	temperature channel boost hysteresis
-
-	gpio			input state of 8 GPIO pins; read-only
-
+=========================== ===============================================
+file			    description
+=========================== ===============================================
+prochot<n>		    current #PROCHOT %
+prochot<n>_avg		    moving average #PROCHOT %
+prochot<n>_max		    limit #PROCHOT %
+prochot_short		    enable or disable logical #PROCHOT pin short
+prochot<n>_override	    force #PROCHOT assertion as PWM
+prochot_override_duty_cycle duty cycle for the PWM signal used when
+			    #PROCHOT is overridden
+prochot<n>_interval	    #PROCHOT PWM sampling interval
+vrdhot<n>		    0 means negated, 1 means asserted
+fan<n>_smart_tach	    enable or disable smart tach mode
+pwm<n>_auto_channels	    select control sources for PWM outputs
+pwm<n>_auto_spinup_min	    minimum duty cycle during spin-up
+pwm<n>_auto_spinup_time	    duration of spin-up
+pwm_auto_prochot_ramp	    ramp time per step when #PROCHOT asserted
+pwm_auto_vrdhot_ramp	    ramp time per step when #VRDHOT asserted
+temp<n>_auto_base	    temperature channel base
+temp<n>_auto_offset[1-12]   temperature channel offsets
+temp<n>_auto_offset_hyst    temperature channel offset hysteresis
+temp<n>_auto_boost	    temperature channel boost (PWMs to 100%)
+			    limit
+temp<n>_auto_boost_hyst     temperature channel boost hysteresis
+gpio			    input state of 8 GPIO pins; read-only
+=========================== ===============================================
diff --git a/Documentation/hwmon/lm95245 b/Documentation/hwmon/lm95245
index d755901f58c4..566d1dc8c5a6 100644
--- a/Documentation/hwmon/lm95245
+++ b/Documentation/hwmon/lm95245
@@ -1,16 +1,23 @@
 Kernel driver lm95245
-==================
+=====================
 
 Supported chips:
+
   * TI LM95235
+
     Addresses scanned: I2C 0x18, 0x29, 0x4c
+
     Datasheet: Publicly available at the TI website
-               http://www.ti.com/lit/ds/symlink/lm95235.pdf
+
+	       http://www.ti.com/lit/ds/symlink/lm95235.pdf
+
   * TI / National Semiconductor LM95245
+
     Addresses scanned: I2C 0x18, 0x19, 0x29, 0x4c, 0x4d
+
     Datasheet: Publicly available at the TI website
-               http://www.ti.com/lit/ds/symlink/lm95245.pdf
 
+	       http://www.ti.com/lit/ds/symlink/lm95245.pdf
 
 Author: Alexander Stein <alexander.stein@systec-electronic.com>
 
diff --git a/Documentation/hwmon/ltc2945 b/Documentation/hwmon/ltc2945
index f8d0f7f19adb..20c884985367 100644
--- a/Documentation/hwmon/ltc2945
+++ b/Documentation/hwmon/ltc2945
@@ -2,11 +2,16 @@ Kernel driver ltc2945
 =====================
 
 Supported chips:
+
   * Linear Technology LTC2945
+
     Prefix: 'ltc2945'
+
     Addresses scanned: -
+
     Datasheet:
-        http://cds.linear.com/docs/en/datasheet/2945fa.pdf
+
+	http://cds.linear.com/docs/en/datasheet/2945fa.pdf
 
 Author: Guenter Roeck <linux@roeck-us.net>
 
@@ -26,9 +31,10 @@ which can be safely used to identify the chip. You will have to instantiate
 the devices explicitly.
 
 Example: the following will load the driver for an LTC2945 at address 0x10
-on I2C bus #1:
-$ modprobe ltc2945
-$ echo ltc2945 0x10 > /sys/bus/i2c/devices/i2c-1/new_device
+on I2C bus #1::
+
+	$ modprobe ltc2945
+	$ echo ltc2945 0x10 > /sys/bus/i2c/devices/i2c-1/new_device
 
 
 Sysfs entries
@@ -45,6 +51,7 @@ Current Sense register. The reported value assumes that a 1 mOhm sense resistor
 is installed. If a different sense resistor is installed, calculate the real
 current by dividing the reported value by the sense resistor value in mOhm.
 
+======================= ========================================================
 in1_input		VIN voltage (mV). Voltage is measured either at
 			SENSE+ or VDD pin depending on chip configuration.
 in1_min			Undervoltage threshold
@@ -82,3 +89,4 @@ power1_input_highest	Historical maximum power use
 power1_reset_history	Write 1 to reset power1 history
 power1_min_alarm	Low power alarm
 power1_max_alarm	High power alarm
+======================= ========================================================
diff --git a/Documentation/hwmon/ltc2990 b/Documentation/hwmon/ltc2990
index 3ed68f676c0f..e0a369e679d3 100644
--- a/Documentation/hwmon/ltc2990
+++ b/Documentation/hwmon/ltc2990
@@ -1,14 +1,23 @@
 Kernel driver ltc2990
 =====================
 
+
 Supported chips:
+
   * Linear Technology LTC2990
+
     Prefix: 'ltc2990'
+
     Addresses scanned: -
+
     Datasheet: http://www.linear.com/product/ltc2990
 
-Author: Mike Looijmans <mike.looijmans@topic.nl>
-        Tom Levens <tom.levens@cern.ch>
+
+
+Author:
+
+	- Mike Looijmans <mike.looijmans@topic.nl>
+	- Tom Levens <tom.levens@cern.ch>
 
 
 Description
@@ -31,17 +40,21 @@ devices explicitly.
 Sysfs attributes
 ----------------
 
+============= ==================================================
 in0_input     Voltage at Vcc pin in millivolt (range 2.5V to 5V)
-temp1_input   Internal chip temperature in millidegrees Celcius
+temp1_input   Internal chip temperature in millidegrees Celsius
+============= ==================================================
 
 A subset of the following attributes are visible, depending on the measurement
 mode of the chip.
 
+============= ==========================================================
 in[1-4]_input Voltage at V[1-4] pin in millivolt
-temp2_input   External temperature sensor TR1 in millidegrees Celcius
-temp3_input   External temperature sensor TR2 in millidegrees Celcius
+temp2_input   External temperature sensor TR1 in millidegrees Celsius
+temp3_input   External temperature sensor TR2 in millidegrees Celsius
 curr1_input   Current in mA across V1-V2 assuming a 1mOhm sense resistor
 curr2_input   Current in mA across V3-V4 assuming a 1mOhm sense resistor
+============= ==========================================================
 
 The "curr*_input" measurements actually report the voltage drop across the
 input pins in microvolts. This is equivalent to the current through a 1mOhm
diff --git a/Documentation/hwmon/ltc4151 b/Documentation/hwmon/ltc4151
index 43c667e6677a..c39229b19624 100644
--- a/Documentation/hwmon/ltc4151
+++ b/Documentation/hwmon/ltc4151
@@ -2,11 +2,16 @@ Kernel driver ltc4151
 =====================
 
 Supported chips:
+
   * Linear Technology LTC4151
+
     Prefix: 'ltc4151'
+
     Addresses scanned: -
+
     Datasheet:
-        http://www.linear.com/docs/Datasheet/4151fc.pdf
+
+	http://www.linear.com/docs/Datasheet/4151fc.pdf
 
 Author: Per Dalen <per.dalen@appeartv.com>
 
@@ -25,9 +30,10 @@ which can be safely used to identify the chip. You will have to instantiate
 the devices explicitly.
 
 Example: the following will load the driver for an LTC4151 at address 0x6f
-on I2C bus #0:
-# modprobe ltc4151
-# echo ltc4151 0x6f > /sys/bus/i2c/devices/i2c-0/new_device
+on I2C bus #0::
+
+	# modprobe ltc4151
+	# echo ltc4151 0x6f > /sys/bus/i2c/devices/i2c-0/new_device
 
 
 Sysfs entries
@@ -40,8 +46,10 @@ Current reading provided by this driver is reported as obtained from the Current
 Sense register. The reported value assumes that a 1 mOhm sense resistor is
 installed.
 
+======================= ==================
 in1_input		VDIN voltage (mV)
 
 in2_input		ADIN voltage (mV)
 
 curr1_input		SENSE current (mA)
+======================= ==================
diff --git a/Documentation/hwmon/ltc4215 b/Documentation/hwmon/ltc4215
index c196a1846259..8d5044d99bab 100644
--- a/Documentation/hwmon/ltc4215
+++ b/Documentation/hwmon/ltc4215
@@ -2,11 +2,16 @@ Kernel driver ltc4215
 =====================
 
 Supported chips:
+
   * Linear Technology LTC4215
+
     Prefix: 'ltc4215'
+
     Addresses scanned: 0x44
+
     Datasheet:
-        http://www.linear.com/pc/downloadDocument.do?navId=H0,C1,C1003,C1006,C1163,P17572,D12697
+
+	http://www.linear.com/pc/downloadDocument.do?navId=H0,C1,C1003,C1006,C1163,P17572,D12697
 
 Author: Ira W. Snyder <iws@ovro.caltech.edu>
 
@@ -26,9 +31,10 @@ of the possible addresses are unfriendly to probing. You will have to
 instantiate the devices explicitly.
 
 Example: the following will load the driver for an LTC4215 at address 0x44
-on I2C bus #0:
-$ modprobe ltc4215
-$ echo ltc4215 0x44 > /sys/bus/i2c/devices/i2c-0/new_device
+on I2C bus #0::
+
+	$ modprobe ltc4215
+	$ echo ltc4215 0x44 > /sys/bus/i2c/devices/i2c-0/new_device
 
 
 Sysfs entries
@@ -38,6 +44,7 @@ The LTC4215 has built-in limits for overvoltage, undervoltage, and
 undercurrent warnings. This makes it very likely that the reference
 circuit will be used.
 
+======================= =========================
 in1_input		input voltage
 in2_input		output voltage
 
@@ -49,3 +56,4 @@ curr1_max_alarm		overcurrent alarm
 
 power1_input		power usage
 power1_alarm		power bad alarm
+======================= =========================
diff --git a/Documentation/hwmon/ltc4245 b/Documentation/hwmon/ltc4245
index 4ca7a9da09f9..3dafd08a4e87 100644
--- a/Documentation/hwmon/ltc4245
+++ b/Documentation/hwmon/ltc4245
@@ -2,11 +2,16 @@ Kernel driver ltc4245
 =====================
 
 Supported chips:
+
   * Linear Technology LTC4245
+
     Prefix: 'ltc4245'
+
     Addresses scanned: 0x20-0x3f
+
     Datasheet:
-        http://www.linear.com/pc/downloadDocument.do?navId=H0,C1,C1003,C1006,C1140,P19392,D13517
+
+	http://www.linear.com/pc/downloadDocument.do?navId=H0,C1,C1003,C1006,C1140,P19392,D13517
 
 Author: Ira W. Snyder <iws@ovro.caltech.edu>
 
@@ -27,9 +32,10 @@ of the possible addresses are unfriendly to probing. You will have to
 instantiate the devices explicitly.
 
 Example: the following will load the driver for an LTC4245 at address 0x23
-on I2C bus #1:
-$ modprobe ltc4245
-$ echo ltc4245 0x23 > /sys/bus/i2c/devices/i2c-1/new_device
+on I2C bus #1::
+
+	$ modprobe ltc4245
+	$ echo ltc4245 0x23 > /sys/bus/i2c/devices/i2c-1/new_device
 
 
 Sysfs entries
@@ -42,6 +48,7 @@ This driver uses the values in the datasheet to change the register values
 into the values specified in the sysfs-interface document. The current readings
 rely on the sense resistors listed in Table 2: "Sense Resistor Values".
 
+======================= =======================================================
 in1_input		12v input voltage (mV)
 in2_input		5v  input voltage (mV)
 in3_input		3v  input voltage (mV)
@@ -80,6 +87,7 @@ power1_input		12v power usage (mW)
 power2_input		5v  power usage (mW)
 power3_input		3v  power usage (mW)
 power4_input		Vee (-12v) power usage (mW)
+======================= =======================================================
 
 
 Note 1
@@ -96,6 +104,7 @@ slowly, -EAGAIN will be returned when you read the sysfs attribute containing
 the sensor reading.
 
 The LTC4245 chip can be configured to sample all GPIO pins with two methods:
+
 1) platform data -- see include/linux/platform_data/ltc4245.h
 2) OF device tree -- add the "ltc4245,use-extra-gpios" property to each chip
 
diff --git a/Documentation/hwmon/ltc4260 b/Documentation/hwmon/ltc4260
index c4ff4ad998b2..4c335b6a51d1 100644
--- a/Documentation/hwmon/ltc4260
+++ b/Documentation/hwmon/ltc4260
@@ -2,11 +2,16 @@ Kernel driver ltc4260
 =====================
 
 Supported chips:
+
   * Linear Technology LTC4260
+
     Prefix: 'ltc4260'
+
     Addresses scanned: -
+
     Datasheet:
-        http://cds.linear.com/docs/en/datasheet/4260fc.pdf
+
+	http://cds.linear.com/docs/en/datasheet/4260fc.pdf
 
 Author: Guenter Roeck <linux@roeck-us.net>
 
@@ -26,9 +31,10 @@ which can be safely used to identify the chip. You will have to instantiate
 the devices explicitly.
 
 Example: the following will load the driver for an LTC4260 at address 0x10
-on I2C bus #1:
-$ modprobe ltc4260
-$ echo ltc4260 0x10 > /sys/bus/i2c/devices/i2c-1/new_device
+on I2C bus #1::
+
+	$ modprobe ltc4260
+	$ echo ltc4260 0x10 > /sys/bus/i2c/devices/i2c-1/new_device
 
 
 Sysfs entries
@@ -45,6 +51,7 @@ Current Sense register. The reported value assumes that a 1 mOhm sense resistor
 is installed. If a different sense resistor is installed, calculate the real
 current by dividing the reported value by the sense resistor value in mOhm.
 
+======================= =======================
 in1_input		SOURCE voltage (mV)
 in1_min_alarm		Undervoltage alarm
 in1_max_alarm		Overvoltage alarm
@@ -54,3 +61,4 @@ in2_alarm		Power bad alarm
 
 curr1_input		SENSE current (mA)
 curr1_alarm		SENSE overcurrent alarm
+======================= =======================
diff --git a/Documentation/hwmon/max1619 b/Documentation/hwmon/max1619
index 518bae3a80c4..4b3762c4eceb 100644
--- a/Documentation/hwmon/max1619
+++ b/Documentation/hwmon/max1619
@@ -2,15 +2,20 @@ Kernel driver max1619
 =====================
 
 Supported chips:
+
   * Maxim MAX1619
+
     Prefix: 'max1619'
+
     Addresses scanned: I2C 0x18-0x1a, 0x29-0x2b, 0x4c-0x4e
+
     Datasheet: Publicly available at the Maxim website
-               http://pdfserv.maxim-ic.com/en/ds/MAX1619.pdf
+
+	       http://pdfserv.maxim-ic.com/en/ds/MAX1619.pdf
 
 Authors:
-        Oleksij Rempel <bug-track@fisher-privat.net>,
-        Jean Delvare <jdelvare@suse.de>
+       - Oleksij Rempel <bug-track@fisher-privat.net>,
+       - Jean Delvare <jdelvare@suse.de>
 
 Description
 -----------
diff --git a/Documentation/hwmon/max1668 b/Documentation/hwmon/max1668
index 8f9d570dbfec..417f17d750e6 100644
--- a/Documentation/hwmon/max1668
+++ b/Documentation/hwmon/max1668
@@ -2,12 +2,17 @@ Kernel driver max1668
 =====================
 
 Supported chips:
+
   * Maxim MAX1668, MAX1805 and MAX1989
+
     Prefix: 'max1668'
+
     Addresses scanned: I2C 0x18, 0x19, 0x1a, 0x29, 0x2a, 0x2b, 0x4c, 0x4d, 0x4e
+
     Datasheet: http://datasheets.maxim-ic.com/en/ds/MAX1668-MAX1989.pdf
 
 Author:
+
     David George <david.george@ska.ac.za>
 
 Description
@@ -23,8 +28,9 @@ two ICs.
 The driver is able to distinguish between the devices and creates sysfs
 entries as follows:
 
-MAX1805, MAX1668 and MAX1989:
+- MAX1805, MAX1668 and MAX1989:
 
+=============== == ============================================================
 temp1_input     ro local (ambient) temperature
 temp1_max       rw local temperature maximum threshold for alarm
 temp1_max_alarm ro local temperature maximum threshold alarm
@@ -40,8 +46,11 @@ temp3_max       rw remote temperature 2 maximum threshold for alarm
 temp3_max_alarm ro remote temperature 2 maximum threshold alarm
 temp3_min       rw remote temperature 2 minimum threshold for alarm
 temp3_min_alarm ro remote temperature 2 minimum threshold alarm
+=============== == ============================================================
 
-MAX1668 and MAX1989 only:
+- MAX1668 and MAX1989 only:
+
+=============== == ============================================================
 temp4_input     ro remote temperature 3
 temp4_max       rw remote temperature 3 maximum threshold for alarm
 temp4_max_alarm ro remote temperature 3 maximum threshold alarm
@@ -52,6 +61,7 @@ temp5_max       rw remote temperature 4 maximum threshold for alarm
 temp5_max_alarm ro remote temperature 4 maximum threshold alarm
 temp5_min       rw remote temperature 4 minimum threshold for alarm
 temp5_min_alarm ro remote temperature 4 minimum threshold alarm
+=============== == ============================================================
 
 Module Parameters
 -----------------
diff --git a/Documentation/hwmon/max197 b/Documentation/hwmon/max197
index 8d89b9009df8..02fe19bc3428 100644
--- a/Documentation/hwmon/max197
+++ b/Documentation/hwmon/max197
@@ -1,16 +1,22 @@
-Maxim MAX197 driver
-===================
+Kernel driver max197
+====================
 
 Author:
+
   * Vivien Didelot <vivien.didelot@savoirfairelinux.com>
 
 Supported chips:
+
   * Maxim MAX197
+
     Prefix: 'max197'
+
     Datasheet: http://datasheets.maxim-ic.com/en/ds/MAX197.pdf
 
   * Maxim MAX199
+
     Prefix: 'max199'
+
     Datasheet: http://datasheets.maxim-ic.com/en/ds/MAX199.pdf
 
 Description
@@ -26,7 +32,7 @@ Platform data
 -------------
 
 The MAX197 platform data (defined in linux/platform_data/max197.h) should be
-filled with a pointer to a conversion function, defined like:
+filled with a pointer to a conversion function, defined like::
 
     int convert(u8 ctrl);
 
@@ -36,25 +42,29 @@ or a negative error code otherwise.
 
 Control byte format:
 
+======= ========== ============================================
 Bit     Name       Description
 7,6     PD1,PD0    Clock and Power-Down modes
 5       ACQMOD     Internal or External Controlled Acquisition
 4       RNG        Full-scale voltage magnitude at the input
 3       BIP        Unipolar or Bipolar conversion mode
 2,1,0   A2,A1,A0   Channel
+======= ========== ============================================
 
 Sysfs interface
 ---------------
 
-* in[0-7]_input: The conversion value for the corresponding channel.
-                 RO
+  ============== ==============================================================
+  in[0-7]_input  The conversion value for the corresponding channel.
+		 RO
 
-* in[0-7]_min:   The lower limit (in mV) for the corresponding channel.
-                 For the MAX197, it will be adjusted to -10000, -5000, or 0.
-                 For the MAX199, it will be adjusted to -4000, -2000, or 0.
-                 RW
+  in[0-7]_min    The lower limit (in mV) for the corresponding channel.
+		 For the MAX197, it will be adjusted to -10000, -5000, or 0.
+		 For the MAX199, it will be adjusted to -4000, -2000, or 0.
+		 RW
 
-* in[0-7]_max:   The higher limit (in mV) for the corresponding channel.
-                 For the MAX197, it will be adjusted to 0, 5000, or 10000.
-                 For the MAX199, it will be adjusted to 0, 2000, or 4000.
-                 RW
+  in[0-7]_max    The higher limit (in mV) for the corresponding channel.
+		 For the MAX197, it will be adjusted to 0, 5000, or 10000.
+		 For the MAX199, it will be adjusted to 0, 2000, or 4000.
+		 RW
+  ============== ==============================================================
diff --git a/Documentation/hwmon/max31722 b/Documentation/hwmon/max31722
index 090da84538c8..0ab15c00b226 100644
--- a/Documentation/hwmon/max31722
+++ b/Documentation/hwmon/max31722
@@ -2,15 +2,25 @@ Kernel driver max31722
 ======================
 
 Supported chips:
+
   * Maxim Integrated MAX31722
+
     Prefix: 'max31722'
+
     ACPI ID: MAX31722
+
     Addresses scanned: -
+
     Datasheet: https://datasheets.maximintegrated.com/en/ds/MAX31722-MAX31723.pdf
+
   * Maxim Integrated MAX31723
+
     Prefix: 'max31723'
+
     ACPI ID: MAX31723
+
     Addresses scanned: -
+
     Datasheet: https://datasheets.maximintegrated.com/en/ds/MAX31722-MAX31723.pdf
 
 Author: Tiberiu Breana <tiberiu.a.breana@intel.com>
@@ -31,4 +41,6 @@ Sysfs entries
 
 The following attribute is supported:
 
+======================= =======================================================
 temp1_input		Measured temperature. Read-only.
+======================= =======================================================
diff --git a/Documentation/hwmon/max31790 b/Documentation/hwmon/max31790
index 855e62430da9..84c62a12ef3a 100644
--- a/Documentation/hwmon/max31790
+++ b/Documentation/hwmon/max31790
@@ -2,9 +2,13 @@ Kernel driver max31790
 ======================
 
 Supported chips:
+
   * Maxim MAX31790
+
     Prefix: 'max31790'
+
     Addresses scanned: -
+
     Datasheet: http://pdfserv.maximintegrated.com/en/ds/MAX31790.pdf
 
 Author: Il Han <corone.il.han@gmail.com>
@@ -30,8 +34,10 @@ also be configured to serve as tachometer inputs.
 Sysfs entries
 -------------
 
+================== === =======================================================
 fan[1-12]_input    RO  fan tachometer speed in RPM
 fan[1-12]_fault    RO  fan experienced fault
 fan[1-6]_target    RW  desired fan speed in RPM
 pwm[1-6]_enable    RW  regulator mode, 0=disabled, 1=manual mode, 2=rpm mode
 pwm[1-6]           RW  fan target duty cycle (0-255)
+================== === =======================================================
diff --git a/Documentation/hwmon/max6639 b/Documentation/hwmon/max6639
index dc49f8be7167..3da54225f83c 100644
--- a/Documentation/hwmon/max6639
+++ b/Documentation/hwmon/max6639
@@ -2,14 +2,18 @@ Kernel driver max6639
 =====================
 
 Supported chips:
+
   * Maxim MAX6639
+
     Prefix: 'max6639'
+
     Addresses scanned: I2C 0x2c, 0x2e, 0x2f
+
     Datasheet: http://pdfserv.maxim-ic.com/en/ds/MAX6639.pdf
 
 Authors:
-    He Changqing <hechangqing@semptian.com>
-    Roland Stigge <stigge@antcom.de>
+    - He Changqing <hechangqing@semptian.com>
+    - Roland Stigge <stigge@antcom.de>
 
 Description
 -----------
@@ -21,19 +25,20 @@ diode-connected transistors.
 
 The following device attributes are implemented via sysfs:
 
+====================== ==== ===================================================
 Attribute              R/W  Contents
-----------------------------------------------------------------------------
+====================== ==== ===================================================
 temp1_input            R    Temperature channel 1 input (0..150 C)
 temp2_input            R    Temperature channel 2 input (0..150 C)
 temp1_fault            R    Temperature channel 1 diode fault
 temp2_fault            R    Temperature channel 2 diode fault
 temp1_max              RW   Set THERM temperature for input 1
-                            (in C, see datasheet)
+			    (in C, see datasheet)
 temp2_max              RW   Set THERM temperature for input 2
 temp1_crit             RW   Set ALERT temperature for input 1
 temp2_crit             RW   Set ALERT temperature for input 2
 temp1_emergency        RW   Set OT temperature for input 1
-                            (in C, see datasheet)
+			    (in C, see datasheet)
 temp2_emergency        RW   Set OT temperature for input 2
 pwm1                   RW   Fan 1 target duty cycle (0..255)
 pwm2                   RW   Fan 2 target duty cycle (0..255)
@@ -47,3 +52,4 @@ temp1_crit_alarm       R    Alarm on ALERT temperature on channel 1
 temp2_crit_alarm       R    Alarm on ALERT temperature on channel 2
 temp1_emergency_alarm  R    Alarm on OT temperature on channel 1
 temp2_emergency_alarm  R    Alarm on OT temperature on channel 2
+====================== ==== ===================================================
diff --git a/Documentation/hwmon/max6642 b/Documentation/hwmon/max6642
index afbd3e4942e2..7e5b7d4f9492 100644
--- a/Documentation/hwmon/max6642
+++ b/Documentation/hwmon/max6642
@@ -2,14 +2,20 @@ Kernel driver max6642
 =====================
 
 Supported chips:
+
   * Maxim MAX6642
+
     Prefix: 'max6642'
+
     Addresses scanned: I2C 0x48-0x4f
+
     Datasheet: Publicly available at the Maxim website
-               http://datasheets.maxim-ic.com/en/ds/MAX6642.pdf
+
+	       http://datasheets.maxim-ic.com/en/ds/MAX6642.pdf
 
 Authors:
-        Per Dalen <per.dalen@appeartv.com>
+
+	Per Dalen <per.dalen@appeartv.com>
 
 Description
 -----------
diff --git a/Documentation/hwmon/max6650 b/Documentation/hwmon/max6650
index dff1d296a48b..74dc3f0caaa2 100644
--- a/Documentation/hwmon/max6650
+++ b/Documentation/hwmon/max6650
@@ -2,19 +2,27 @@ Kernel driver max6650
 =====================
 
 Supported chips:
+
   * Maxim MAX6650
+
     Prefix: 'max6650'
+
     Addresses scanned: none
+
     Datasheet: http://pdfserv.maxim-ic.com/en/ds/MAX6650-MAX6651.pdf
+
   * Maxim MAX6651
+
     Prefix: 'max6651'
+
     Addresses scanned: none
+
     Datasheet: http://pdfserv.maxim-ic.com/en/ds/MAX6650-MAX6651.pdf
 
 Authors:
-    Hans J. Koch <hjk@hansjkoch.de>
-    John Morris <john.morris@spirentcom.com>
-    Claus Gindhart <claus.gindhart@kontron.com>
+    - Hans J. Koch <hjk@hansjkoch.de>
+    - John Morris <john.morris@spirentcom.com>
+    - Claus Gindhart <claus.gindhart@kontron.com>
 
 Description
 -----------
@@ -28,6 +36,7 @@ The driver is not able to distinguish between the 2 devices.
 
 The driver provides the following sensor accesses in sysfs:
 
+=============== ======= =======================================================
 fan1_input	ro	fan tachometer speed in RPM
 fan2_input	ro	"
 fan3_input	ro	"
@@ -40,6 +49,7 @@ pwm1		rw	relative speed (0-255), 255=max. speed.
 fan1_div	rw	sets the speed range the inputs can handle. Legal
 			values are 1, 2, 4, and 8. Use lower values for
 			faster fans.
+=============== ======= =======================================================
 
 Usage notes
 -----------
diff --git a/Documentation/hwmon/mc13783-adc b/Documentation/hwmon/mc13783-adc
index 05ccc9f159f1..cae70350ba2f 100644
--- a/Documentation/hwmon/mc13783-adc
+++ b/Documentation/hwmon/mc13783-adc
@@ -2,16 +2,25 @@ Kernel driver mc13783-adc
 =========================
 
 Supported chips:
+
   * Freescale MC13783
+
     Prefix: 'mc13783'
+
     Datasheet: https://www.nxp.com/docs/en/data-sheet/MC13783.pdf
+
   * Freescale MC13892
+
     Prefix: 'mc13892'
+
     Datasheet: https://www.nxp.com/docs/en/data-sheet/MC13892.pdf
 
+
+
 Authors:
-    Sascha Hauer <s.hauer@pengutronix.de>
-    Luotao Fu <l.fu@pengutronix.de>
+
+   - Sascha Hauer <s.hauer@pengutronix.de>
+   - Luotao Fu <l.fu@pengutronix.de>
 
 Description
 -----------
@@ -30,9 +39,11 @@ the General Purpose inputs and touchscreen.
 See the following tables for the meaning of the different channels and their
 chip internal scaling:
 
-MC13783:
+- MC13783:
+
+======= =============================================== =============== =======
 Channel	Signal						Input Range	Scaling
--------------------------------------------------------------------------------
+======= =============================================== =============== =======
 0	Battery Voltage (BATT)				2.50 - 4.65V	-2.40V
 1	Battery Current (BATT - BATTISNS)		-50 - 50 mV	x20
 2	Application Supply (BP)				2.50 - 4.65V	-2.40V
@@ -52,10 +63,13 @@ Channel	Signal						Input Range	Scaling
 13	General Purpose TSX2 / Touchscreen X-plate 2	0 - 2.30V	No
 14	General Purpose TSY1 / Touchscreen Y-plate 1	0 - 2.30V	No
 15	General Purpose TSY2 / Touchscreen Y-plate 2	0 - 2.30V	No
+======= =============================================== =============== =======
 
-MC13892:
+- MC13892:
+
+======= =============================================== =============== =======
 Channel	Signal						Input Range	Scaling
--------------------------------------------------------------------------------
+======= =============================================== =============== =======
 0	Battery Voltage (BATT)				0 - 4.8V	/2
 1	Battery Current (BATT - BATTISNSCC)		-60 - 60 mV	x20
 2	Application Supply (BPSNS)			0 - 4.8V	/2
@@ -72,3 +86,4 @@ Channel	Signal						Input Range	Scaling
 13	General Purpose TSX2 / Touchscreen X-plate 2	0 - 2.4V	No
 14	General Purpose TSY1 / Touchscreen Y-plate 1	0 - 2.4V	No
 15	General Purpose TSY2 / Touchscreen Y-plate 2	0 - 2.4V	No
+======= =============================================== =============== =======
diff --git a/Documentation/hwmon/mcp3021 b/Documentation/hwmon/mcp3021
index 74a6b72adf5f..83f4bda2f269 100644
--- a/Documentation/hwmon/mcp3021
+++ b/Documentation/hwmon/mcp3021
@@ -1,17 +1,26 @@
 Kernel driver MCP3021
-======================
+=====================
 
 Supported chips:
+
   * Microchip Technology MCP3021
+
     Prefix: 'mcp3021'
+
     Datasheet: http://ww1.microchip.com/downloads/en/DeviceDoc/21805a.pdf
+
   * Microchip Technology MCP3221
+
     Prefix: 'mcp3221'
+
     Datasheet: http://ww1.microchip.com/downloads/en/DeviceDoc/21732c.pdf
 
+
+
 Authors:
-   Mingkai Hu
-   Sven Schuchmann <schuchmann@schleissheimer.de>
+
+   - Mingkai Hu
+   - Sven Schuchmann <schuchmann@schleissheimer.de>
 
 Description
 -----------
diff --git a/Documentation/hwmon/mlxreg-fan b/Documentation/hwmon/mlxreg-fan
index fc531c6978d4..c92b8e885f7e 100644
--- a/Documentation/hwmon/mlxreg-fan
+++ b/Documentation/hwmon/mlxreg-fan
@@ -2,33 +2,39 @@ Kernel driver mlxreg-fan
 ========================
 
 Provides FAN control for the next Mellanox systems:
-QMB700, equipped with 40x200GbE InfiniBand ports;
-MSN3700, equipped with 32x200GbE or 16x400GbE Ethernet ports;
-MSN3410, equipped with 6x400GbE plus 48x50GbE Ethernet ports;
-MSN3800, equipped with 64x1000GbE Ethernet ports;
+
+- QMB700, equipped with 40x200GbE InfiniBand ports;
+- MSN3700, equipped with 32x200GbE or 16x400GbE Ethernet ports;
+- MSN3410, equipped with 6x400GbE plus 48x50GbE Ethernet ports;
+- MSN3800, equipped with 64x1000GbE Ethernet ports;
+
+Author: Vadim Pasternak <vadimp@mellanox.com>
+
 These are the Top of the Rack systems, equipped with Mellanox switch
 board with Mellanox Quantum or Spectrume-2 devices.
 FAN controller is implemented by the programmable device logic.
 
 The default registers offsets set within the programmable device is as
 following:
-- pwm1			0xe3
-- fan1 (tacho1)		0xe4
-- fan2 (tacho2)		0xe5
-- fan3 (tacho3)		0xe6
-- fan4 (tacho4)		0xe7
-- fan5 (tacho5)		0xe8
-- fan6 (tacho6)		0xe9
-- fan7 (tacho7)		0xea
-- fan8 (tacho8)		0xeb
-- fan9 (tacho9)		0xec
-- fan10 (tacho10)	0xed
-- fan11 (tacho11)	0xee
-- fan12 (tacho12)	0xef
+
+======================= ====
+pwm1			0xe3
+fan1 (tacho1)		0xe4
+fan2 (tacho2)		0xe5
+fan3 (tacho3)		0xe6
+fan4 (tacho4)		0xe7
+fan5 (tacho5)		0xe8
+fan6 (tacho6)		0xe9
+fan7 (tacho7)		0xea
+fan8 (tacho8)		0xeb
+fan9 (tacho9)		0xec
+fan10 (tacho10)		0xed
+fan11 (tacho11)		0xee
+fan12 (tacho12)		0xef
+======================= ====
+
 This setup can be re-programmed with other registers.
 
-Author: Vadim Pasternak <vadimp@mellanox.com>
-
 Description
 -----------
 
@@ -48,13 +54,17 @@ thermal's sysfs interfaces.
 /sys files in hwmon subsystem
 -----------------------------
 
-fan[1-12]_fault - RO files for tachometers TACH1-TACH12 fault indication
-fan[1-12]_input - RO files for tachometers TACH1-TACH12 input (in RPM)
-pwm1		- RW file for fan[1-12] target duty cycle (0..255)
+================= == ===================================================
+fan[1-12]_fault   RO files for tachometers TACH1-TACH12 fault indication
+fan[1-12]_input   RO files for tachometers TACH1-TACH12 input (in RPM)
+pwm1		  RW file for fan[1-12] target duty cycle (0..255)
+================= == ===================================================
 
 /sys files in thermal subsystem
 -------------------------------
 
-cur_state	- RW file for current cooling state of the cooling device
-		  (0..max_state)
-max_state	- RO file for maximum cooling state of the cooling device
+================= == ====================================================
+cur_state	  RW file for current cooling state of the cooling device
+		     (0..max_state)
+max_state	  RO file for maximum cooling state of the cooling device
+================= == ====================================================
diff --git a/Documentation/hwmon/nct6683 b/Documentation/hwmon/nct6683
index c1301d4300cd..efbf7e9703ec 100644
--- a/Documentation/hwmon/nct6683
+++ b/Documentation/hwmon/nct6683
@@ -2,13 +2,18 @@ Kernel driver nct6683
 =====================
 
 Supported chips:
+
   * Nuvoton NCT6683D
+
     Prefix: 'nct6683'
+
     Addresses scanned: ISA address retrieved from Super I/O registers
+
     Datasheet: Available from Nuvoton upon request
 
 Authors:
-        Guenter Roeck <linux@roeck-us.net>
+
+	Guenter Roeck <linux@roeck-us.net>
 
 Description
 -----------
@@ -50,8 +55,10 @@ Tested Boards and Firmware Versions
 The driver has been reported to work with the following boards and
 firmware versions.
 
+=============== ===============================================
 Board		Firmware version
----------------------------------------------------------------
+=============== ===============================================
 Intel DH87RL	NCT6683D EC firmware version 1.0 build 04/03/13
 Intel DH87MC	NCT6683D EC firmware version 1.0 build 04/03/13
 Intel DB85FL	NCT6683D EC firmware version 1.0 build 04/03/13
+=============== ===============================================
diff --git a/Documentation/hwmon/nct7802 b/Documentation/hwmon/nct7802
index 5438deb6be02..8b7365a7cb32 100644
--- a/Documentation/hwmon/nct7802
+++ b/Documentation/hwmon/nct7802
@@ -2,13 +2,18 @@ Kernel driver nct7802
 =====================
 
 Supported chips:
+
   * Nuvoton NCT7802Y
+
     Prefix: 'nct7802'
+
     Addresses scanned: I2C 0x28..0x2f
+
     Datasheet: Available from Nuvoton web site
 
 Authors:
-        Guenter Roeck <linux@roeck-us.net>
+
+	Guenter Roeck <linux@roeck-us.net>
 
 Description
 -----------
@@ -25,7 +30,9 @@ Tested Boards and BIOS Versions
 The driver has been reported to work with the following boards and
 BIOS versions.
 
+======================= ===============================================
 Board			BIOS version
----------------------------------------------------------------
+======================= ===============================================
 Kontron COMe-bSC2	CHR2E934.001.GGO
 Kontron COMe-bIP2	CCR2E212
+======================= ===============================================
diff --git a/Documentation/hwmon/nct7904 b/Documentation/hwmon/nct7904
index 57fffe33ebfc..5b2f111582ff 100644
--- a/Documentation/hwmon/nct7904
+++ b/Documentation/hwmon/nct7904
@@ -1,11 +1,16 @@
 Kernel driver nct7904
-====================
+=====================
 
 Supported chip:
+
   * Nuvoton NCT7904D
+
     Prefix: nct7904
+
     Addresses: I2C 0x2d, 0x2e
+
     Datasheet: Publicly available at Nuvoton website
+
 	http://www.nuvoton.com/
 
 Author: Vadim V. Vlasov <vvlasov@dev.rtsoft.ru>
@@ -25,6 +30,7 @@ Sysfs entries
 
 Currently, the driver supports only the following features:
 
+======================= =======================================================
 in[1-20]_input		Input voltage measurements (mV)
 
 fan[1-12]_input		Fan tachometer measurements (rpm)
@@ -40,6 +46,7 @@ pwm[1-4]_enable		R/W, 1/2 for manual or SmartFan mode
 			previously configured by BIOS (or configuration EEPROM)
 
 pwm[1-4]		R/O in SmartFan mode, R/W in manual control mode
+======================= =======================================================
 
 The driver checks sensor control registers and does not export the sensors
 that are not enabled. Anyway, a sensor that is enabled may actually be not
diff --git a/Documentation/hwmon/npcm750-pwm-fan b/Documentation/hwmon/npcm750-pwm-fan
index 6156ef7398e6..c67af08b6773 100644
--- a/Documentation/hwmon/npcm750-pwm-fan
+++ b/Documentation/hwmon/npcm750-pwm-fan
@@ -2,9 +2,11 @@ Kernel driver npcm750-pwm-fan
 =============================
 
 Supported chips:
+
 	NUVOTON NPCM750/730/715/705
 
 Authors:
+
 	<tomer.maimon@nuvoton.com>
 
 Description:
@@ -15,8 +17,10 @@ controller supports up to 16 tachometer inputs.
 
 The driver provides the following sensor accesses in sysfs:
 
+=============== ======= =====================================================
 fanX_input	ro	provide current fan rotation value in RPM as reported
 			by the fan to the device.
 
 pwmX		rw	get or set PWM fan control value. This is an integer
 			value between 0(off) and 255(full speed).
+=============== ======= =====================================================
diff --git a/Documentation/hwmon/nsa320 b/Documentation/hwmon/nsa320
index fdbd6947799b..4fe75fd2f937 100644
--- a/Documentation/hwmon/nsa320
+++ b/Documentation/hwmon/nsa320
@@ -2,14 +2,23 @@ Kernel driver nsa320_hwmon
 ==========================
 
 Supported chips:
+
   * Holtek HT46R065 microcontroller with onboard firmware that configures
+
 	it to act as a hardware monitor.
+
     Prefix: 'nsa320'
+
     Addresses scanned: none
+
     Datasheet: Not available, driver was reverse engineered based upon the
+
 	Zyxel kernel source
 
+
+
 Author:
+
   Adam Baker <linux@baker-net.org.uk>
 
 Description
@@ -31,8 +40,10 @@ tenths of a degree.
 sysfs-Interface
 ---------------
 
-temp1_input - temperature input
-fan1_input - fan speed
+============= =================
+temp1_input   temperature input
+fan1_input    fan speed
+============= =================
 
 Notes
 -----
diff --git a/Documentation/hwmon/ntc_thermistor b/Documentation/hwmon/ntc_thermistor
index 8b9ff23edc32..d0e7f91726b9 100644
--- a/Documentation/hwmon/ntc_thermistor
+++ b/Documentation/hwmon/ntc_thermistor
@@ -1,22 +1,29 @@
 Kernel driver ntc_thermistor
-=================
+============================
 
 Supported thermistors from Murata:
+
 * Murata NTC Thermistors NCP15WB473, NCP18WB473, NCP21WB473, NCP03WB473,
   NCP15WL333, NCP03WF104, NCP15XH103
+
   Prefixes: 'ncp15wb473', 'ncp18wb473', 'ncp21wb473', 'ncp03wb473',
   'ncp15wl333', 'ncp03wf104', 'ncp15xh103'
+
   Datasheet: Publicly available at Murata
 
 Supported thermistors from EPCOS:
+
 * EPCOS NTC Thermistors B57330V2103
+
   Prefixes: b57330v2103
+
   Datasheet: Publicly available at EPCOS
 
 Other NTC thermistors can be supported simply by adding compensation
 tables; e.g., NCP15WL333 support is added by the table ncpXXwl333.
 
 Authors:
+
 	MyungJoo Ham <myungjoo.ham@samsung.com>
 
 Description
@@ -29,57 +36,60 @@ compensation table to get the temperature input.
 The NTC driver provides lookup tables with a linear approximation function
 and four circuit models with an option not to use any of the four models.
 
+Using the following convention::
+
+   $	resistor
+   [TH]	the thermistor
+
 The four circuit models provided are:
 
-	$: resister, [TH]: the thermistor
-
- 1. connect = NTC_CONNECTED_POSITIVE, pullup_ohm > 0
-
-   [pullup_uV]
-       |    |
-      [TH]  $ (pullup_ohm)
-       |    |
-       +----+-----------------------[read_uV]
-       |
-       $ (pulldown_ohm)
-       |
-      --- (ground)
-
- 2. connect = NTC_CONNECTED_POSITIVE, pullup_ohm = 0 (not-connected)
-
-   [pullup_uV]
-       |
-      [TH]
-       |
-       +----------------------------[read_uV]
-       |
-       $ (pulldown_ohm)
-       |
-      --- (ground)
-
- 3. connect = NTC_CONNECTED_GROUND, pulldown_ohm > 0
-
-   [pullup_uV]
-       |
-       $ (pullup_ohm)
-       |
-       +----+-----------------------[read_uV]
-       |    |
-      [TH]  $ (pulldown_ohm)
-       |    |
-      -------- (ground)
-
- 4. connect = NTC_CONNECTED_GROUND, pulldown_ohm = 0 (not-connected)
-
-   [pullup_uV]
-       |
-       $ (pullup_ohm)
-       |
-       +----------------------------[read_uV]
-       |
-      [TH]
-       |
-      --- (ground)
+1. connect = NTC_CONNECTED_POSITIVE, pullup_ohm > 0::
+
+     [pullup_uV]
+	 |    |
+	[TH]  $ (pullup_ohm)
+	 |    |
+	 +----+-----------------------[read_uV]
+	 |
+	 $ (pulldown_ohm)
+	 |
+	-+- (ground)
+
+2. connect = NTC_CONNECTED_POSITIVE, pullup_ohm = 0 (not-connected)::
+
+     [pullup_uV]
+	 |
+	[TH]
+	 |
+	 +----------------------------[read_uV]
+	 |
+	 $ (pulldown_ohm)
+	 |
+	-+- (ground)
+
+3. connect = NTC_CONNECTED_GROUND, pulldown_ohm > 0::
+
+     [pullup_uV]
+	 |
+	 $ (pullup_ohm)
+	 |
+	 +----+-----------------------[read_uV]
+	 |    |
+	[TH]  $ (pulldown_ohm)
+	 |    |
+	-+----+- (ground)
+
+4. connect = NTC_CONNECTED_GROUND, pulldown_ohm = 0 (not-connected)::
+
+     [pullup_uV]
+	 |
+	 $ (pullup_ohm)
+	 |
+	 +----------------------------[read_uV]
+	 |
+	[TH]
+	 |
+	-+- (ground)
 
 When one of the four circuit models is used, read_uV, pullup_uV, pullup_ohm,
 pulldown_ohm, and connect should be provided. When none of the four models
@@ -88,13 +98,14 @@ provide read_ohm and _not_ provide the others.
 
 Sysfs Interface
 ---------------
-name		the mandatory global attribute, the thermistor name.
 
-temp1_type	always 4 (thermistor)
-		RO
+=============== == =============================================================
+name		   the mandatory global attribute, the thermistor name.
+=============== == =============================================================
+temp1_type	RO always 4 (thermistor)
 
-temp1_input	measure the temperature and provide the measured value.
-		(reading this file initiates the reading procedure.)
-		RO
+temp1_input	RO measure the temperature and provide the measured value.
+		   (reading this file initiates the reading procedure.)
+=============== == =============================================================
 
 Note that each NTC thermistor has only _one_ thermistor; thus, only temp1 exists.
diff --git a/Documentation/hwmon/occ b/Documentation/hwmon/occ
index e787596e03fe..bf41c162d70e 100644
--- a/Documentation/hwmon/occ
+++ b/Documentation/hwmon/occ
@@ -2,6 +2,7 @@ Kernel driver occ-hwmon
 =======================
 
 Supported chips:
+
   * POWER8
   * POWER9
 
@@ -37,53 +38,87 @@ Some entries are only present with certain OCC sensor versions or only on
 certain OCCs in the system. The version number is not exported to the user
 but can be inferred.
 
-temp[1-n]_label		OCC sensor ID.
+temp[1-n]_label
+	OCC sensor ID.
+
 [with temperature sensor version 1]
-    temp[1-n]_input	Measured temperature of the component in millidegrees
+
+    temp[1-n]_input
+			Measured temperature of the component in millidegrees
 			Celsius.
+
 [with temperature sensor version >= 2]
-    temp[1-n]_type		The FRU (Field Replaceable Unit) type
+
+    temp[1-n]_type
+				The FRU (Field Replaceable Unit) type
 				(represented by an integer) for the component
 				that this sensor measures.
-    temp[1-n]_fault		Temperature sensor fault boolean; 1 to indicate
+    temp[1-n]_fault
+				Temperature sensor fault boolean; 1 to indicate
 				that a fault is present or 0 to indicate that
 				no fault is present.
+
     [with type == 3 (FRU type is VRM)]
-        temp[1-n]_alarm		VRM temperature alarm boolean; 1 to indicate
+
+	temp[1-n]_alarm
+				VRM temperature alarm boolean; 1 to indicate
 				alarm, 0 to indicate no alarm
+
     [else]
-        temp[1-n]_input		Measured temperature of the component in
+
+	temp[1-n]_input
+				Measured temperature of the component in
 				millidegrees Celsius.
 
-freq[1-n]_label		OCC sensor ID.
-freq[1-n]_input		Measured frequency of the component in MHz.
-
-power[1-n]_input	Latest measured power reading of the component in
+freq[1-n]_label
+			OCC sensor ID.
+freq[1-n]_input
+			Measured frequency of the component in MHz.
+power[1-n]_input
+			Latest measured power reading of the component in
 			microwatts.
-power[1-n]_average	Average power of the component in microwatts.
-power[1-n]_average_interval	The amount of time over which the power average
+power[1-n]_average
+			Average power of the component in microwatts.
+power[1-n]_average_interval
+				The amount of time over which the power average
 				was taken in microseconds.
+
 [with power sensor version < 2]
-    power[1-n]_label	OCC sensor ID.
+
+    power[1-n]_label
+			OCC sensor ID.
+
 [with power sensor version >= 2]
-    power[1-n]_label	OCC sensor ID + function ID + channel in the form
+
+    power[1-n]_label
+			OCC sensor ID + function ID + channel in the form
 			of a string, delimited by underscores, i.e. "0_15_1".
 			Both the function ID and channel are integers that
 			further identify the power sensor.
+
 [with power sensor version 0xa0]
-    power[1-n]_label	OCC sensor ID + sensor type in the form of a string,
+
+    power[1-n]_label
+			OCC sensor ID + sensor type in the form of a string,
 			delimited by an underscore, i.e. "0_system". Sensor
 			type will be one of "system", "proc", "vdd" or "vdn".
 			For this sensor version, OCC sensor ID will be the same
 			for all power sensors.
+
 [present only on "master" OCC; represents the whole system power; only one of
- this type of power sensor will be present]
-    power[1-n]_label		"system"
-    power[1-n]_input		Latest system output power in microwatts.
-    power[1-n]_cap		Current system power cap in microwatts.
-    power[1-n]_cap_not_redundant	System power cap in microwatts when
-					there is not redundant power.
-    power[1-n]_cap_max		Maximum power cap that the OCC can enforce in
+this type of power sensor will be present]
+
+    power[1-n]_label
+				"system"
+    power[1-n]_input
+				Latest system output power in microwatts.
+    power[1-n]_cap
+				Current system power cap in microwatts.
+    power[1-n]_cap_not_redundant
+				System power cap in microwatts when
+				there is not redundant power.
+    power[1-n]_cap_max
+				Maximum power cap that the OCC can enforce in
 				microwatts.
     power[1-n]_cap_min		Minimum power cap that the OCC can enforce in
 				microwatts.
@@ -94,8 +129,11 @@ power[1-n]_average_interval	The amount of time over which the power average
 				ignored, i.e. requesting a power cap of
 				500900000 microwatts will result in a power cap
 				request of 500 watts.
+
     [with caps sensor version > 1]
-        power[1-n]_cap_user_source	Indicates how the user power cap was
+
+	power[1-n]_cap_user_source
+					Indicates how the user power cap was
 					set. This is an integer that maps to
 					system or firmware components that can
 					set the user power cap.
@@ -104,9 +142,12 @@ The following "extn" sensors are exported as a way for the OCC to provide data
 that doesn't fit anywhere else. The meaning of these sensors is entirely
 dependent on their data, and cannot be statically defined.
 
-extn[1-n]_label		ASCII ID or OCC sensor ID.
-extn[1-n]_flags		This is one byte hexadecimal value. Bit 7 indicates the
+extn[1-n]_label
+			ASCII ID or OCC sensor ID.
+extn[1-n]_flags
+			This is one byte hexadecimal value. Bit 7 indicates the
 			type of the label attribute; 1 for sensor ID, 0 for
 			ASCII ID. Other bits are reserved.
-extn[1-n]_input		6 bytes of hexadecimal data, with a meaning defined by
+extn[1-n]_input
+			6 bytes of hexadecimal data, with a meaning defined by
 			the sensor ID.
diff --git a/Documentation/hwmon/pc87427 b/Documentation/hwmon/pc87427
index c313eb66e08a..22d8f62d851f 100644
--- a/Documentation/hwmon/pc87427
+++ b/Documentation/hwmon/pc87427
@@ -2,9 +2,13 @@ Kernel driver pc87427
 =====================
 
 Supported chips:
+
   * National Semiconductor PC87427
+
     Prefix: 'pc87427'
+
     Addresses scanned: none, address read from Super I/O config space
+
     Datasheet: No longer available
 
 Author: Jean Delvare <jdelvare@suse.de>
diff --git a/Documentation/hwmon/pcf8591 b/Documentation/hwmon/pcf8591
index 447c0702c0ec..e98bd542a441 100644
--- a/Documentation/hwmon/pcf8591
+++ b/Documentation/hwmon/pcf8591
@@ -2,16 +2,21 @@ Kernel driver pcf8591
 =====================
 
 Supported chips:
+
   * Philips/NXP PCF8591
+
     Prefix: 'pcf8591'
+
     Addresses scanned: none
+
     Datasheet: Publicly available at the NXP website
-               http://www.nxp.com/pip/PCF8591_6.html
+
+	       http://www.nxp.com/pip/PCF8591_6.html
 
 Authors:
-        Aurelien Jarno <aurelien@aurel32.net>
-        valuable contributions by Jan M. Sendler <sendler@sendler.de>,
-        Jean Delvare <jdelvare@suse.de>
+      - Aurelien Jarno <aurelien@aurel32.net>
+      - valuable contributions by Jan M. Sendler <sendler@sendler.de>,
+      - Jean Delvare <jdelvare@suse.de>
 
 
 Description
@@ -22,24 +27,25 @@ analog output) for the I2C bus produced by Philips Semiconductors (now NXP).
 It is designed to provide a byte I2C interface to up to 4 separate devices.
 
 The PCF8591 has 4 analog inputs programmable as single-ended or
-differential inputs :
+differential inputs:
+
 - mode 0 : four single ended inputs
-        Pins AIN0 to AIN3 are single ended inputs for channels 0 to 3
+	Pins AIN0 to AIN3 are single ended inputs for channels 0 to 3
 
 - mode 1 : three differential inputs
-        Pins AIN3 is the common negative differential input
-        Pins AIN0 to AIN2 are positive differential inputs for channels 0 to 2
+	Pins AIN3 is the common negative differential input
+	Pins AIN0 to AIN2 are positive differential inputs for channels 0 to 2
 
 - mode 2 : single ended and differential mixed
-        Pins AIN0 and AIN1 are single ended inputs for channels 0 and 1
-        Pins AIN2 is the positive differential input for channel 3
-        Pins AIN3 is the negative differential input for channel 3
+	Pins AIN0 and AIN1 are single ended inputs for channels 0 and 1
+	Pins AIN2 is the positive differential input for channel 3
+	Pins AIN3 is the negative differential input for channel 3
 
 - mode 3 : two differential inputs
-        Pins AIN0 is the positive differential input for channel 0
-        Pins AIN1 is the negative differential input for channel 0
-        Pins AIN2 is the positive differential input for channel 1
-        Pins AIN3 is the negative differential input for channel 1
+	Pins AIN0 is the positive differential input for channel 0
+	Pins AIN1 is the negative differential input for channel 0
+	Pins AIN2 is the positive differential input for channel 1
+	Pins AIN3 is the negative differential input for channel 1
 
 See the datasheet for details.
 
@@ -49,10 +55,11 @@ Module parameters
 * input_mode int
 
     Analog input mode:
-         0 = four single ended inputs
-         1 = three differential inputs
-         2 = single ended and differential mixed
-         3 = two differential inputs
+
+	 - 0 = four single ended inputs
+	 - 1 = three differential inputs
+	 - 2 = single ended and differential mixed
+	 - 3 = two differential inputs
 
 
 Accessing PCF8591 via /sys interface
@@ -67,11 +74,12 @@ for details.
 Directories are being created for each instantiated PCF8591:
 
 /sys/bus/i2c/devices/<0>-<1>/
-where <0> is the bus the chip is connected to (e. g. i2c-0)
-and <1> the chip address ([48..4f])
+   where <0> is the bus the chip is connected to (e. g. i2c-0)
+   and <1> the chip address ([48..4f])
 
 Inside these directories, there are such files:
-in0_input, in1_input, in2_input, in3_input, out0_enable, out0_output, name
+
+   in0_input, in1_input, in2_input, in3_input, out0_enable, out0_output, name
 
 Name contains chip name.
 
diff --git a/Documentation/hwmon/powr1220 b/Documentation/hwmon/powr1220
index 21e44f71ae6e..a7fc258da0a8 100644
--- a/Documentation/hwmon/powr1220
+++ b/Documentation/hwmon/powr1220
@@ -1,12 +1,17 @@
 Kernel driver powr1220
-==================
+======================
 
 Supported chips:
+
   * Lattice POWR1220AT8
+
     Prefix: 'powr1220'
+
     Addresses scanned: none
+
     Datasheet: Publicly available at the Lattice website
-               http://www.latticesemi.com/
+
+	       http://www.latticesemi.com/
 
 Author: Scott Kanowitz <scott.kanowitz@gmail.com>
 
@@ -26,7 +31,9 @@ value over the low measurement range maximum of 2 V.
 
 The input naming convention is as follows:
 
+============== ========
 driver name    pin name
+============== ========
 in0            VMON1
 in1            VMON2
 in2            VMON3
@@ -41,5 +48,6 @@ in10           VMON11
 in11           VMON12
 in12           VCCA
 in13           VCCINP
+============== ========
 
 The ADC readings are updated on request with a minimum period of 1s.
diff --git a/Documentation/hwmon/raspberrypi-hwmon b/Documentation/hwmon/raspberrypi-hwmon
index 3c92e2cb52d6..8038ade36490 100644
--- a/Documentation/hwmon/raspberrypi-hwmon
+++ b/Documentation/hwmon/raspberrypi-hwmon
@@ -2,6 +2,7 @@ Kernel driver raspberrypi-hwmon
 ===============================
 
 Supported boards:
+
   * Raspberry Pi A+ (via GPIO on SoC)
   * Raspberry Pi B+ (via GPIO on SoC)
   * Raspberry Pi 2 B (via GPIO on SoC)
@@ -19,4 +20,6 @@ undervoltage conditions.
 Sysfs entries
 -------------
 
+======================= ==================
 in0_lcrit_alarm		Undervoltage alarm
+======================= ==================
diff --git a/Documentation/hwmon/sch5636 b/Documentation/hwmon/sch5636
index 7b0a01da0717..4aaee3672f13 100644
--- a/Documentation/hwmon/sch5636
+++ b/Documentation/hwmon/sch5636
@@ -2,8 +2,11 @@ Kernel driver sch5636
 =====================
 
 Supported chips:
+
   * SMSC SCH5636
+
     Prefix: 'sch5636'
+
     Addresses scanned: none, address read from Super I/O config space
 
 Author: Hans de Goede <hdegoede@redhat.com>
diff --git a/Documentation/hwmon/scpi-hwmon b/Documentation/hwmon/scpi-hwmon
index 4cfcdf2d5eab..eee7022b44db 100644
--- a/Documentation/hwmon/scpi-hwmon
+++ b/Documentation/hwmon/scpi-hwmon
@@ -2,8 +2,11 @@ Kernel driver scpi-hwmon
 ========================
 
 Supported chips:
+
  * Chips based on ARM System Control Processor Interface
+
    Addresses scanned: -
+
    Datasheet: http://infocenter.arm.com/help/index.jsp?topic=/com.arm.doc.dui0922b/index.html
 
 Author: Punit Agrawal <punit.agrawal@arm.com>
@@ -14,7 +17,7 @@ Description
 This driver supports hardware monitoring for SoC's based on the ARM
 System Control Processor (SCP) implementing the System Control
 Processor Interface (SCPI). The following sensor types are supported
-by the SCP -
+by the SCP:
 
   * temperature
   * voltage
@@ -30,4 +33,4 @@ Usage Notes
 The driver relies on device tree node to indicate the presence of SCPI
 support in the kernel. See
 Documentation/devicetree/bindings/arm/arm,scpi.txt for details of the
-devicetree node.
\ No newline at end of file
+devicetree node.
diff --git a/Documentation/hwmon/sht15 b/Documentation/hwmon/sht15
index 5e3207c3b177..485abe037f6c 100644
--- a/Documentation/hwmon/sht15
+++ b/Documentation/hwmon/sht15
@@ -2,29 +2,37 @@ Kernel driver sht15
 ===================
 
 Authors:
+
   * Wouter Horre
   * Jonathan Cameron
   * Vivien Didelot <vivien.didelot@savoirfairelinux.com>
   * Jerome Oufella <jerome.oufella@savoirfairelinux.com>
 
 Supported chips:
+
   * Sensirion SHT10
+
     Prefix: 'sht10'
 
   * Sensirion SHT11
+
     Prefix: 'sht11'
 
   * Sensirion SHT15
+
     Prefix: 'sht15'
 
   * Sensirion SHT71
+
     Prefix: 'sht71'
 
   * Sensirion SHT75
+
     Prefix: 'sht75'
 
 Datasheet: Publicly available at the Sensirion website
-http://www.sensirion.ch/en/pdf/product_information/Datasheet-humidity-sensor-SHT1x.pdf
+
+	http://www.sensirion.ch/en/pdf/product_information/Datasheet-humidity-sensor-SHT1x.pdf
 
 Description
 -----------
@@ -63,11 +71,13 @@ Platform data
 Sysfs interface
 ---------------
 
-* temp1_input:     temperature input
-* humidity1_input: humidity input
-* heater_enable:   write 1 in this attribute to enable the on-chip heater,
-                   0 to disable it. Be careful not to enable the heater
-                   for too long.
-* temp1_fault:     if 1, this means that the voltage is low (below 2.47V) and
-                   measurement may be invalid.
-* humidity1_fault: same as temp1_fault.
+================== ==========================================================
+temp1_input        temperature input
+humidity1_input    humidity input
+heater_enable      write 1 in this attribute to enable the on-chip heater,
+		   0 to disable it. Be careful not to enable the heater
+		   for too long.
+temp1_fault        if 1, this means that the voltage is low (below 2.47V) and
+		   measurement may be invalid.
+humidity1_fault    same as temp1_fault.
+================== ==========================================================
diff --git a/Documentation/hwmon/sht21 b/Documentation/hwmon/sht21
index 8b3cdda541c1..f1f5da030108 100644
--- a/Documentation/hwmon/sht21
+++ b/Documentation/hwmon/sht21
@@ -2,19 +2,33 @@ Kernel driver sht21
 ===================
 
 Supported chips:
+
   * Sensirion SHT21
+
     Prefix: 'sht21'
+
     Addresses scanned: none
+
     Datasheet: Publicly available at the Sensirion website
+
     http://www.sensirion.com/file/datasheet_sht21
 
+
+
   * Sensirion SHT25
+
     Prefix: 'sht25'
+
     Addresses scanned: none
+
     Datasheet: Publicly available at the Sensirion website
+
     http://www.sensirion.com/file/datasheet_sht25
 
+
+
 Author:
+
   Urs Fleisch <urs.fleisch@sensirion.com>
 
 Description
@@ -33,9 +47,13 @@ in the board setup code.
 sysfs-Interface
 ---------------
 
-temp1_input - temperature input
-humidity1_input - humidity input
-eic - Electronic Identification Code
+temp1_input
+	- temperature input
+
+humidity1_input
+	- humidity input
+eic
+	- Electronic Identification Code
 
 Notes
 -----
diff --git a/Documentation/hwmon/sht3x b/Documentation/hwmon/sht3x
index d9daa6ab1e8e..978a7117e4b2 100644
--- a/Documentation/hwmon/sht3x
+++ b/Documentation/hwmon/sht3x
@@ -2,14 +2,19 @@ Kernel driver sht3x
 ===================
 
 Supported chips:
+
   * Sensirion SHT3x-DIS
+
     Prefix: 'sht3x'
+
     Addresses scanned: none
+
     Datasheet: https://www.sensirion.com/file/datasheet_sht3x_digital
 
 Author:
-  David Frey <david.frey@sensirion.com>
-  Pascal Sachs <pascal.sachs@sensirion.com>
+
+  - David Frey <david.frey@sensirion.com>
+  - Pascal Sachs <pascal.sachs@sensirion.com>
 
 Description
 -----------
@@ -24,6 +29,7 @@ addresses 0x44 or 0x45, depending on the wiring. See
 Documentation/i2c/instantiating-devices for methods to instantiate the device.
 
 There are two options configurable by means of sht3x_platform_data:
+
 1. blocking (pull the I2C clock line down while performing the measurement) or
    non-blocking mode. Blocking mode will guarantee the fastest result but
    the I2C bus will be busy during that time. By default, non-blocking mode
@@ -35,12 +41,15 @@ There are two options configurable by means of sht3x_platform_data:
 The sht3x sensor supports a single shot mode as well as 5 periodic measure
 modes, which can be controlled with the update_interval sysfs interface.
 The allowed update_interval in milliseconds are as follows:
-  *     0   single shot mode
-  *  2000   0.5 Hz periodic measurement
-  *  1000   1   Hz periodic measurement
-  *   500   2   Hz periodic measurement
-  *   250   4   Hz periodic measurement
-  *   100  10   Hz periodic measurement
+
+    ===== ======= ====================
+       0          single shot mode
+    2000   0.5 Hz periodic measurement
+    1000   1   Hz periodic measurement
+     500   2   Hz periodic measurement
+     250   4   Hz periodic measurement
+     100  10   Hz periodic measurement
+    ===== ======= ====================
 
 In the periodic measure mode, the sensor automatically triggers a measurement
 with the configured update interval on the chip. When a temperature or humidity
@@ -53,6 +62,7 @@ low.
 sysfs-Interface
 ---------------
 
+=================== ============================================================
 temp1_input:        temperature input
 humidity1_input:    humidity input
 temp1_max:          temperature max value
@@ -64,13 +74,15 @@ temp1_min_hyst:     temperature hysteresis value for min limit
 humidity1_min:      humidity min value
 humidity1_min_hyst: humidity hysteresis value for min limit
 temp1_alarm:        alarm flag is set to 1 if the temperature is outside the
-                    configured limits. Alarm only works in periodic measure mode
+		    configured limits. Alarm only works in periodic measure mode
 humidity1_alarm:    alarm flag is set to 1 if the humidity is outside the
-                    configured limits. Alarm only works in periodic measure mode
+		    configured limits. Alarm only works in periodic measure mode
 heater_enable:      heater enable, heating element removes excess humidity from
-                    sensor
-                        0: turned off
-                        1: turned on
+		    sensor:
+
+			- 0: turned off
+			- 1: turned on
 update_interval:    update interval, 0 for single shot, interval in msec
-                    for periodic measurement. If the interval is not supported
-                    by the sensor, the next faster interval is chosen
+		    for periodic measurement. If the interval is not supported
+		    by the sensor, the next faster interval is chosen
+=================== ============================================================
diff --git a/Documentation/hwmon/shtc1 b/Documentation/hwmon/shtc1
index 6b1e05458f0f..aa116332ba26 100644
--- a/Documentation/hwmon/shtc1
+++ b/Documentation/hwmon/shtc1
@@ -2,17 +2,29 @@ Kernel driver shtc1
 ===================
 
 Supported chips:
+
   * Sensirion SHTC1
+
     Prefix: 'shtc1'
+
     Addresses scanned: none
+
     Datasheet: http://www.sensirion.com/file/datasheet_shtc1
 
+
+
   * Sensirion SHTW1
+
     Prefix: 'shtw1'
+
     Addresses scanned: none
+
     Datasheet: Not publicly available
 
+
+
 Author:
+
   Johannes Winkelmann <johannes.winkelmann@sensirion.com>
 
 Description
@@ -28,6 +40,7 @@ address 0x70. See Documentation/i2c/instantiating-devices for methods to
 instantiate the device.
 
 There are two options configurable by means of shtc1_platform_data:
+
 1. blocking (pull the I2C clock line down while performing the measurement) or
    non-blocking mode. Blocking mode will guarantee the fastest result but
    the I2C bus will be busy during that time. By default, non-blocking mode
@@ -39,5 +52,7 @@ There are two options configurable by means of shtc1_platform_data:
 sysfs-Interface
 ---------------
 
-temp1_input - temperature input
-humidity1_input - humidity input
+temp1_input
+	- temperature input
+humidity1_input
+	- humidity input
diff --git a/Documentation/hwmon/sis5595 b/Documentation/hwmon/sis5595
index 4f8877a34f37..5acba6b0c0db 100644
--- a/Documentation/hwmon/sis5595
+++ b/Documentation/hwmon/sis5595
@@ -2,49 +2,67 @@ Kernel driver sis5595
 =====================
 
 Supported chips:
+
   * Silicon Integrated Systems Corp. SiS5595 Southbridge Hardware Monitor
+
     Prefix: 'sis5595'
+
     Addresses scanned: ISA in PCI-space encoded address
+
     Datasheet: Publicly available at the Silicon Integrated Systems Corp. site.
 
+
+
 Authors:
-        Kyösti Mälkki <kmalkki@cc.hut.fi>,
-        Mark D. Studebaker <mdsxyz123@yahoo.com>,
-        Aurelien Jarno <aurelien@aurel32.net> 2.6 port
+
+      - Kyösti Mälkki <kmalkki@cc.hut.fi>,
+      - Mark D. Studebaker <mdsxyz123@yahoo.com>,
+      - Aurelien Jarno <aurelien@aurel32.net> 2.6 port
 
    SiS southbridge has a LM78-like chip integrated on the same IC.
    This driver is a customized copy of lm78.c
 
    Supports following revisions:
+
+       =============== =============== ==============
        Version         PCI ID          PCI Revision
+       =============== =============== ==============
        1               1039/0008       AF or less
        2               1039/0008       B0 or greater
+       =============== =============== ==============
 
    Note: these chips contain a 0008 device which is incompatible with the
-        5595. We recognize these by the presence of the listed
-        "blacklist" PCI ID and refuse to load.
+	5595. We recognize these by the presence of the listed
+	"blacklist" PCI ID and refuse to load.
 
+   =================== =============== ================
    NOT SUPPORTED       PCI ID          BLACKLIST PCI ID
-        540            0008            0540
-        550            0008            0550
+   =================== =============== ================
+	540            0008            0540
+	550            0008            0550
        5513            0008            5511
        5581            0008            5597
        5582            0008            5597
        5597            0008            5597
-        630            0008            0630
-        645            0008            0645
-        730            0008            0730
-        735            0008            0735
+	630            0008            0630
+	645            0008            0645
+	730            0008            0730
+	735            0008            0735
+   =================== =============== ================
 
 
 Module Parameters
 -----------------
+
+======================= =====================================================
 force_addr=0xaddr	Set the I/O base address. Useful for boards
 			that don't set the address in the BIOS. Does not do a
 			PCI force; the device must still be present in lspci.
 			Don't use this unless the driver complains that the
 			base address is not set.
+
 			Example: 'modprobe sis5595 force_addr=0x290'
+======================= =====================================================
 
 
 Description
diff --git a/Documentation/hwmon/smsc47b397 b/Documentation/hwmon/smsc47b397
index 3a43b6948924..600194cf1804 100644
--- a/Documentation/hwmon/smsc47b397
+++ b/Documentation/hwmon/smsc47b397
@@ -2,29 +2,38 @@ Kernel driver smsc47b397
 ========================
 
 Supported chips:
+
   * SMSC LPC47B397-NC
+
   * SMSC SCH5307-NS
+
   * SMSC SCH5317
+
     Prefix: 'smsc47b397'
+
     Addresses scanned: none, address read from Super I/O config space
+
     Datasheet: In this file
 
-Authors: Mark M. Hoffman <mhoffman@lightlink.com>
-         Utilitek Systems, Inc.
+Authors:
+
+       - Mark M. Hoffman <mhoffman@lightlink.com>
+       - Utilitek Systems, Inc.
 
 November 23, 2004
 
-The following specification describes the SMSC LPC47B397-NC[1] sensor chip
+The following specification describes the SMSC LPC47B397-NC [1]_ sensor chip
 (for which there is no public datasheet available). This document was
 provided by Craig Kelly (In-Store Broadcast Network) and edited/corrected
 by Mark M. Hoffman <mhoffman@lightlink.com>.
 
-[1] And SMSC SCH5307-NS and SCH5317, which have different device IDs but are
-otherwise compatible.
+.. [1] And SMSC SCH5307-NS and SCH5317, which have different device IDs but are
+       otherwise compatible.
 
-* * * * *
+-------------------------------------------------------------------------
 
-Methods for detecting the HP SIO and reading the thermal data on a dc7100.
+Methods for detecting the HP SIO and reading the thermal data on a dc7100
+-------------------------------------------------------------------------
 
 The thermal information on the dc7100 is contained in the SIO Hardware Monitor
 (HWM). The information is accessed through an index/data pair. The index/data
@@ -35,18 +44,22 @@ and 0x61 (LSB). Currently we are using 0x480 for the HWM Base Address and
 
 Reading temperature information.
 The temperature information is located in the following registers:
+
+=============== ======= =======================================================
 Temp1		0x25	(Currently, this reflects the CPU temp on all systems).
 Temp2		0x26
 Temp3		0x27
 Temp4		0x80
+=============== ======= =======================================================
 
 Programming Example
-The following is an example of how to read the HWM temperature registers:
-MOV	DX,480H
-MOV	AX,25H
-OUT	DX,AL
-MOV	DX,481H
-IN	AL,DX
+The following is an example of how to read the HWM temperature registers::
+
+	MOV	DX,480H
+	MOV	AX,25H
+	OUT	DX,AL
+	MOV	DX,481H
+	IN	AL,DX
 
 AL contains the data in hex, the temperature in Celsius is the decimal
 equivalent.
@@ -55,25 +68,32 @@ Ex: If AL contains 0x2A, the temperature is 42 degrees C.
 
 Reading tach information.
 The fan speed information is located in the following registers:
+
+=============== ======= ======= =================================
 		LSB	MSB
 Tach1		0x28	0x29	(Currently, this reflects the CPU
 				fan speed on all systems).
 Tach2		0x2A	0x2B
 Tach3		0x2C	0x2D
 Tach4		0x2E	0x2F
+=============== ======= ======= =================================
 
-Important!!!
-Reading the tach LSB locks the tach MSB.
-The LSB Must be read first.
+.. Important::
+
+	Reading the tach LSB locks the tach MSB.
+	The LSB Must be read first.
+
+How to convert the tach reading to RPM
+--------------------------------------
 
-How to convert the tach reading to RPM.
 The tach reading (TCount) is given by: (Tach MSB * 256) + (Tach LSB)
 The SIO counts the number of 90kHz (11.111us) pulses per revolution.
 RPM = 60/(TCount * 11.111us)
 
-Example:
-Reg 0x28 = 0x9B
-Reg 0x29 = 0x08
+Example::
+
+	Reg 0x28 = 0x9B
+	Reg 0x29 = 0x08
 
 TCount = 0x89B = 2203
 
@@ -81,21 +101,28 @@ RPM = 60 / (2203 * 11.11111 E-6) = 2451 RPM
 
 Obtaining the SIO version.
 
-CONFIGURATION SEQUENCE
+Configuration Sequence
+----------------------
+
 To program the configuration registers, the following sequence must be followed:
 1. Enter Configuration Mode
 2. Configure the Configuration Registers
 3. Exit Configuration Mode.
 
 Enter Configuration Mode
+^^^^^^^^^^^^^^^^^^^^^^^^
+
 To place the chip into the Configuration State The config key (0x55) is written
 to the CONFIG PORT (0x2E).
 
 Configuration Mode
+^^^^^^^^^^^^^^^^^^
+
 In configuration mode, the INDEX PORT is located at the CONFIG PORT address and
 the DATA PORT is at INDEX PORT address + 1.
 
 The desired configuration registers are accessed in two steps:
+
 a.	Write the index of the Logical Device Number Configuration Register
 	(i.e., 0x07) to the INDEX PORT and then write the number of the
 	desired logical device to the DATA PORT.
@@ -104,30 +131,35 @@ b.	Write the address of the desired configuration register within the
 	logical device to the INDEX PORT and then write or read the config-
 	uration register through the DATA PORT.
 
-Note: If accessing the Global Configuration Registers, step (a) is not required.
+Note:
+	If accessing the Global Configuration Registers, step (a) is not required.
 
 Exit Configuration Mode
+^^^^^^^^^^^^^^^^^^^^^^^
+
 To exit the Configuration State the write 0xAA to the CONFIG PORT (0x2E).
 The chip returns to the RUN State.  (This is important).
 
 Programming Example
-The following is an example of how to read the SIO Device ID located at 0x20
+^^^^^^^^^^^^^^^^^^^
 
-; ENTER CONFIGURATION MODE
-MOV	DX,02EH
-MOV	AX,055H
-OUT	DX,AL
-; GLOBAL CONFIGURATION  REGISTER
-MOV	DX,02EH
-MOV	AL,20H
-OUT	DX,AL
-; READ THE DATA
-MOV	DX,02FH
-IN	AL,DX
-; EXIT CONFIGURATION MODE
-MOV	DX,02EH
-MOV	AX,0AAH
-OUT	DX,AL
+The following is an example of how to read the SIO Device ID located at 0x20:
+
+	; ENTER CONFIGURATION MODE
+	MOV	DX,02EH
+	MOV	AX,055H
+	OUT	DX,AL
+	; GLOBAL CONFIGURATION  REGISTER
+	MOV	DX,02EH
+	MOV	AL,20H
+	OUT	DX,AL
+	; READ THE DATA
+	MOV	DX,02FH
+	IN	AL,DX
+	; EXIT CONFIGURATION MODE
+	MOV	DX,02EH
+	MOV	AX,0AAH
+	OUT	DX,AL
 
 The registers of interest for identifying the SIO on the dc7100 are Device ID
 (0x20) and Device Rev  (0x21).
@@ -135,29 +167,31 @@ The registers of interest for identifying the SIO on the dc7100 are Device ID
 The Device ID will read 0x6F (0x81 for SCH5307-NS, and 0x85 for SCH5317)
 The Device Rev currently reads 0x01
 
-Obtaining the HWM Base Address.
+Obtaining the HWM Base Address
+------------------------------
+
 The following is an example of how to read the HWM Base Address located in
-Logical Device 8.
+Logical Device 8::
 
-; ENTER CONFIGURATION MODE
-MOV	DX,02EH
-MOV	AX,055H
-OUT	DX,AL
-; CONFIGURE REGISTER CRE0,
-; LOGICAL DEVICE 8
-MOV	DX,02EH
-MOV	AL,07H
-OUT	DX,AL ;Point to LD# Config Reg
-MOV	DX,02FH
-MOV	AL, 08H
-OUT	DX,AL;Point to Logical Device 8
-;
-MOV	DX,02EH
-MOV	AL,60H
-OUT	DX,AL	; Point to HWM Base Addr MSB
-MOV	DX,02FH
-IN	AL,DX	; Get MSB of HWM Base Addr
-; EXIT CONFIGURATION MODE
-MOV	DX,02EH
-MOV	AX,0AAH
-OUT	DX,AL
+	; ENTER CONFIGURATION MODE
+	MOV	DX,02EH
+	MOV	AX,055H
+	OUT	DX,AL
+	; CONFIGURE REGISTER CRE0,
+	; LOGICAL DEVICE 8
+	MOV	DX,02EH
+	MOV	AL,07H
+	OUT	DX,AL ;Point to LD# Config Reg
+	MOV	DX,02FH
+	MOV	AL, 08H
+	OUT	DX,AL;Point to Logical Device 8
+	;
+	MOV	DX,02EH
+	MOV	AL,60H
+	OUT	DX,AL	; Point to HWM Base Addr MSB
+	MOV	DX,02FH
+	IN	AL,DX	; Get MSB of HWM Base Addr
+	; EXIT CONFIGURATION MODE
+	MOV	DX,02EH
+	MOV	AX,0AAH
+	OUT	DX,AL
diff --git a/Documentation/hwmon/smsc47m1 b/Documentation/hwmon/smsc47m1
index 10a24b420686..c54eabd5eb57 100644
--- a/Documentation/hwmon/smsc47m1
+++ b/Documentation/hwmon/smsc47m1
@@ -2,30 +2,53 @@ Kernel driver smsc47m1
 ======================
 
 Supported chips:
+
   * SMSC LPC47B27x, LPC47M112, LPC47M10x, LPC47M13x, LPC47M14x,
+
     LPC47M15x and LPC47M192
+
     Addresses scanned: none, address read from Super I/O config space
+
     Prefix: 'smsc47m1'
+
     Datasheets:
-        http://www.smsc.com/media/Downloads_Public/Data_Sheets/47b272.pdf
-        http://www.smsc.com/media/Downloads_Public/Data_Sheets/47m10x.pdf
-        http://www.smsc.com/media/Downloads_Public/Data_Sheets/47m112.pdf
-        http://www.smsc.com/
+
+	http://www.smsc.com/media/Downloads_Public/Data_Sheets/47b272.pdf
+
+	http://www.smsc.com/media/Downloads_Public/Data_Sheets/47m10x.pdf
+
+	http://www.smsc.com/media/Downloads_Public/Data_Sheets/47m112.pdf
+
+	http://www.smsc.com/
+
   * SMSC LPC47M292
+
     Addresses scanned: none, address read from Super I/O config space
+
     Prefix: 'smsc47m2'
+
     Datasheet: Not public
+
   * SMSC LPC47M997
+
     Addresses scanned: none, address read from Super I/O config space
+
     Prefix: 'smsc47m1'
+
     Datasheet: none
 
+
+
 Authors:
-        Mark D. Studebaker <mdsxyz123@yahoo.com>,
-        With assistance from Bruce Allen <ballen@uwm.edu>, and his
-        fan.c program: http://www.lsc-group.phys.uwm.edu/%7Eballen/driver/
-        Gabriele Gorla <gorlik@yahoo.com>,
-        Jean Delvare <jdelvare@suse.de>
+
+     - Mark D. Studebaker <mdsxyz123@yahoo.com>,
+     - With assistance from Bruce Allen <ballen@uwm.edu>, and his
+       fan.c program:
+
+       - http://www.lsc-group.phys.uwm.edu/%7Eballen/driver/
+
+     - Gabriele Gorla <gorlik@yahoo.com>,
+     - Jean Delvare <jdelvare@suse.de>
 
 Description
 -----------
@@ -57,7 +80,7 @@ hardware registers are read whenever any data is read (unless it is less
 than 1.5 seconds since the last update). This means that you can easily
 miss once-only alarms.
 
+------------------------------------------------------------------
 
-**********************
 The lm_sensors project gratefully acknowledges the support of
 Intel in the development of this driver.
diff --git a/Documentation/hwmon/smsc47m192 b/Documentation/hwmon/smsc47m192
index 6d54ecb7b3f8..a2e86ab67918 100644
--- a/Documentation/hwmon/smsc47m192
+++ b/Documentation/hwmon/smsc47m192
@@ -2,17 +2,28 @@ Kernel driver smsc47m192
 ========================
 
 Supported chips:
+
   * SMSC LPC47M192, LPC47M15x, LPC47M292 and LPC47M997
+
     Prefix: 'smsc47m192'
+
     Addresses scanned: I2C 0x2c - 0x2d
+
     Datasheet: The datasheet for LPC47M192 is publicly available from
-               http://www.smsc.com/
-               The LPC47M15x, LPC47M292 and LPC47M997 are compatible for
-               hardware monitoring.
 
-Author: Hartmut Rick <linux@rick.claranet.de>
-        Special thanks to Jean Delvare for careful checking
-        of the code and many helpful comments and suggestions.
+	       http://www.smsc.com/
+
+	       The LPC47M15x, LPC47M292 and LPC47M997 are compatible for
+
+	       hardware monitoring.
+
+
+
+Author:
+      - Hartmut Rick <linux@rick.claranet.de>
+
+      - Special thanks to Jean Delvare for careful checking
+	of the code and many helpful comments and suggestions.
 
 
 Description
@@ -52,52 +63,54 @@ Reading them more often repeats the same values.
 sysfs interface
 ---------------
 
-in0_input	- +2.5V voltage input
-in1_input	- CPU voltage input (nominal 2.25V)
-in2_input	- +3.3V voltage input
-in3_input	- +5V voltage input
-in4_input	- +12V voltage input (may be missing if used as VID4)
-in5_input	- Vcc voltage input (nominal 3.3V)
-		  This is the supply voltage of the sensor chip itself.
-in6_input	- +1.5V voltage input
-in7_input	- +1.8V voltage input
+===================== ==========================================================
+in0_input	      +2.5V voltage input
+in1_input	      CPU voltage input (nominal 2.25V)
+in2_input	      +3.3V voltage input
+in3_input	      +5V voltage input
+in4_input	      +12V voltage input (may be missing if used as VID4)
+in5_input	      Vcc voltage input (nominal 3.3V)
+		      This is the supply voltage of the sensor chip itself.
+in6_input	      +1.5V voltage input
+in7_input	      +1.8V voltage input
 
 in[0-7]_min,
-in[0-7]_max	- lower and upper alarm thresholds for in[0-7]_input reading
+in[0-7]_max	      lower and upper alarm thresholds for in[0-7]_input reading
 
-		  All voltages are read and written in mV.
+		      All voltages are read and written in mV.
 
-in[0-7]_alarm	- alarm flags for voltage inputs
-		  These files read '1' in case of alarm, '0' otherwise.
+in[0-7]_alarm	      alarm flags for voltage inputs
+		      These files read '1' in case of alarm, '0' otherwise.
 
-temp1_input	- chip temperature measured by on-chip diode
-temp[2-3]_input	- temperature measured by external diodes (one of these would
-		  typically be wired to the diode inside the CPU)
+temp1_input	      chip temperature measured by on-chip diode
+temp[2-3]_input	      temperature measured by external diodes (one of these
+		      would typically be wired to the diode inside the CPU)
 
 temp[1-3]_min,
-temp[1-3]_max	- lower and upper alarm thresholds for temperatures
+temp[1-3]_max	      lower and upper alarm thresholds for temperatures
 
-temp[1-3]_offset - temperature offset registers
-		  The chip adds the offsets stored in these registers to
-		  the corresponding temperature readings.
-		  Note that temp1 and temp2 offsets share the same register,
-		  they cannot both be different from zero at the same time.
-		  Writing a non-zero number to one of them will reset the other
-		  offset to zero.
+temp[1-3]_offset      temperature offset registers
+		      The chip adds the offsets stored in these registers to
+		      the corresponding temperature readings.
+		      Note that temp1 and temp2 offsets share the same register,
+		      they cannot both be different from zero at the same time.
+		      Writing a non-zero number to one of them will reset the other
+		      offset to zero.
 
-		  All temperatures and offsets are read and written in
-		  units of 0.001 degC.
+		      All temperatures and offsets are read and written in
+		      units of 0.001 degC.
 
-temp[1-3]_alarm - alarm flags for temperature inputs, '1' in case of alarm,
-		  '0' otherwise.
-temp[2-3]_input_fault - diode fault flags for temperature inputs 2 and 3.
-		  A fault is detected if the two pins for the corresponding
-		  sensor are open or shorted, or any of the two is shorted
-		  to ground or Vcc. '1' indicates a diode fault.
+temp[1-3]_alarm       alarm flags for temperature inputs, '1' in case of alarm,
+		      '0' otherwise.
+temp[2-3]_input_fault diode fault flags for temperature inputs 2 and 3.
+		      A fault is detected if the two pins for the corresponding
+		      sensor are open or shorted, or any of the two is shorted
+		      to ground or Vcc. '1' indicates a diode fault.
 
-cpu0_vid	- CPU voltage as received from the CPU
+cpu0_vid	      CPU voltage as received from the CPU
 
-vrm		- CPU VID standard used for decoding CPU voltage
+vrm		      CPU VID standard used for decoding CPU voltage
+===================== ==========================================================
 
-		  The *_min, *_max, *_offset and vrm files can be read and
-		  written, all others are read-only.
+The `*_min`, `*_max`, `*_offset` and `vrm` files can be read and written,
+all others are read-only.
diff --git a/Documentation/hwmon/submitting-patches b/Documentation/hwmon/submitting-patches
index f88221b46153..12540b7d9b50 100644
--- a/Documentation/hwmon/submitting-patches
+++ b/Documentation/hwmon/submitting-patches
@@ -1,5 +1,5 @@
-	How to Get Your Patch Accepted Into the Hwmon Subsystem
-	-------------------------------------------------------
+How to Get Your Patch Accepted Into the Hwmon Subsystem
+=======================================================
 
 This text is a collection of suggestions for people writing patches or
 drivers for the hwmon subsystem. Following these suggestions will greatly
@@ -9,11 +9,12 @@ increase the chances of your change being accepted.
 1. General
 ----------
 
-* It should be unnecessary to mention, but please read and follow
-    Documentation/process/submit-checklist.rst
-    Documentation/process/submitting-drivers.rst
-    Documentation/process/submitting-patches.rst
-    Documentation/process/coding-style.rst
+* It should be unnecessary to mention, but please read and follow:
+
+    - Documentation/process/submit-checklist.rst
+    - Documentation/process/submitting-drivers.rst
+    - Documentation/process/submitting-patches.rst
+    - Documentation/process/coding-style.rst
 
 * Please run your patch through 'checkpatch --strict'. There should be no
   errors, no warnings, and few if any check messages. If there are any
diff --git a/Documentation/hwmon/sysfs-interface b/Documentation/hwmon/sysfs-interface
index 7b91706d01c8..fd590633bb14 100644
--- a/Documentation/hwmon/sysfs-interface
+++ b/Documentation/hwmon/sysfs-interface
@@ -1,5 +1,5 @@
 Naming and data format standards for sysfs files
-------------------------------------------------
+================================================
 
 The libsensors library offers an interface to the raw sensors data
 through the sysfs interface. Since lm-sensors 3.0.0, libsensors is
@@ -32,7 +32,7 @@ this reason, it is still not recommended to bypass the library.
 
 Each chip gets its own directory in the sysfs /sys/devices tree.  To
 find all sensor chips, it is easier to follow the device symlinks from
-/sys/class/hwmon/hwmon*.
+`/sys/class/hwmon/hwmon*`.
 
 Up to lm-sensors 3.0.0, libsensors looks for hardware monitoring attributes
 in the "physical" device directory. Since lm-sensors 3.0.1, attributes found
@@ -67,11 +67,13 @@ are interpreted as 0! For more on how written strings are interpreted see the
 
 -------------------------------------------------------------------------
 
-[0-*]	denotes any positive number starting from 0
-[1-*]	denotes any positive number starting from 1
+======= ===========================================
+`[0-*]`	denotes any positive number starting from 0
+`[1-*]`	denotes any positive number starting from 1
 RO	read only value
 WO	write only value
 RW	read/write value
+======= ===========================================
 
 Read/write values may be read-only for some chips, depending on the
 hardware implementation.
@@ -80,57 +82,82 @@ All entries (except name) are optional, and should only be created in a
 given driver if the chip has the feature.
 
 
-*********************
-* Global attributes *
-*********************
+*****************
+Global attributes
+*****************
 
-name		The chip name.
+`name`
+		The chip name.
 		This should be a short, lowercase string, not containing
 		whitespace, dashes, or the wildcard character '*'.
 		This attribute represents the chip name. It is the only
 		mandatory attribute.
 		I2C devices get this attribute created automatically.
+
 		RO
 
-update_interval	The interval at which the chip will update readings.
+`update_interval`
+		The interval at which the chip will update readings.
 		Unit: millisecond
+
 		RW
+
 		Some devices have a variable update rate or interval.
 		This attribute can be used to change it to the desired value.
 
 
-************
-* Voltages *
-************
+********
+Voltages
+********
+
+`in[0-*]_min`
+		Voltage min value.
 
-in[0-*]_min	Voltage min value.
 		Unit: millivolt
+
 		RW
-		
-in[0-*]_lcrit	Voltage critical min value.
+
+`in[0-*]_lcrit`
+		Voltage critical min value.
+
 		Unit: millivolt
+
 		RW
+
 		If voltage drops to or below this limit, the system may
 		take drastic action such as power down or reset. At the very
 		least, it should report a fault.
 
-in[0-*]_max	Voltage max value.
+`in[0-*]_max`
+		Voltage max value.
+
 		Unit: millivolt
+
 		RW
-		
-in[0-*]_crit	Voltage critical max value.
+
+`in[0-*]_crit`
+		Voltage critical max value.
+
 		Unit: millivolt
+
 		RW
+
 		If voltage reaches or exceeds this limit, the system may
 		take drastic action such as power down or reset. At the very
 		least, it should report a fault.
 
-in[0-*]_input	Voltage input value.
+`in[0-*]_input`
+		Voltage input value.
+
 		Unit: millivolt
+
 		RO
+
 		Voltage measured on the chip pin.
+
 		Actual voltage depends on the scaling resistors on the
 		motherboard, as recommended in the chip datasheet.
+
 		This varies by chip and by motherboard.
 		Because of this variation, values are generally NOT scaled
 		by the chip driver, and must be done by the application.
@@ -140,166 +167,232 @@ in[0-*]_input	Voltage input value.
 		thumb: drivers should report the voltage values at the
 		"pins" of the chip.
 
-in[0-*]_average
+`in[0-*]_average`
 		Average voltage
+
 		Unit: millivolt
+
 		RO
 
-in[0-*]_lowest
+`in[0-*]_lowest`
 		Historical minimum voltage
+
 		Unit: millivolt
+
 		RO
 
-in[0-*]_highest
+`in[0-*]_highest`
 		Historical maximum voltage
+
 		Unit: millivolt
+
 		RO
 
-in[0-*]_reset_history
+`in[0-*]_reset_history`
 		Reset inX_lowest and inX_highest
+
 		WO
 
-in_reset_history
+`in_reset_history`
 		Reset inX_lowest and inX_highest for all sensors
+
 		WO
 
-in[0-*]_label	Suggested voltage channel label.
+`in[0-*]_label`
+		Suggested voltage channel label.
+
 		Text string
+
 		Should only be created if the driver has hints about what
 		this voltage channel is being used for, and user-space
 		doesn't. In all other cases, the label is provided by
 		user-space.
+
 		RO
 
-in[0-*]_enable
+`in[0-*]_enable`
 		Enable or disable the sensors.
+
 		When disabled the sensor read will return -ENODATA.
-		1: Enable
-		0: Disable
+
+		- 1: Enable
+		- 0: Disable
+
 		RW
 
-cpu[0-*]_vid	CPU core reference voltage.
+`cpu[0-*]_vid`
+		CPU core reference voltage.
+
 		Unit: millivolt
+
 		RO
+
 		Not always correct.
 
-vrm		Voltage Regulator Module version number. 
+`vrm`
+		Voltage Regulator Module version number.
+
 		RW (but changing it should no more be necessary)
+
 		Originally the VRM standard version multiplied by 10, but now
 		an arbitrary number, as not all standards have a version
 		number.
+
 		Affects the way the driver calculates the CPU core reference
 		voltage from the vid pins.
 
 Also see the Alarms section for status flags associated with voltages.
 
 
-********
-* Fans *
-********
+****
+Fans
+****
+
+`fan[1-*]_min`
+		Fan minimum value
 
-fan[1-*]_min	Fan minimum value
 		Unit: revolution/min (RPM)
+
 		RW
 
-fan[1-*]_max	Fan maximum value
+`fan[1-*]_max`
+		Fan maximum value
+
 		Unit: revolution/min (RPM)
+
 		Only rarely supported by the hardware.
 		RW
 
-fan[1-*]_input	Fan input value.
+`fan[1-*]_input`
+		Fan input value.
+
 		Unit: revolution/min (RPM)
+
 		RO
 
-fan[1-*]_div	Fan divisor.
+`fan[1-*]_div`
+		Fan divisor.
+
 		Integer value in powers of two (1, 2, 4, 8, 16, 32, 64, 128).
+
 		RW
+
 		Some chips only support values 1, 2, 4 and 8.
 		Note that this is actually an internal clock divisor, which
 		affects the measurable speed range, not the read value.
 
-fan[1-*]_pulses	Number of tachometer pulses per fan revolution.
+`fan[1-*]_pulses`
+		Number of tachometer pulses per fan revolution.
+
 		Integer value, typically between 1 and 4.
+
 		RW
+
 		This value is a characteristic of the fan connected to the
 		device's input, so it has to be set in accordance with the fan
 		model.
+
 		Should only be created if the chip has a register to configure
 		the number of pulses. In the absence of such a register (and
 		thus attribute) the value assumed by all devices is 2 pulses
 		per fan revolution.
 
-fan[1-*]_target
+`fan[1-*]_target`
 		Desired fan speed
+
 		Unit: revolution/min (RPM)
+
 		RW
+
 		Only makes sense if the chip supports closed-loop fan speed
 		control based on the measured fan speed.
 
-fan[1-*]_label	Suggested fan channel label.
+`fan[1-*]_label`
+		Suggested fan channel label.
+
 		Text string
+
 		Should only be created if the driver has hints about what
 		this fan channel is being used for, and user-space doesn't.
 		In all other cases, the label is provided by user-space.
+
 		RO
 
-fan[1-*]_enable
+`fan[1-*]_enable`
 		Enable or disable the sensors.
+
 		When disabled the sensor read will return -ENODATA.
-		1: Enable
-		0: Disable
+
+		- 1: Enable
+		- 0: Disable
+
 		RW
 
 Also see the Alarms section for status flags associated with fans.
 
 
-*******
-* PWM *
-*******
+***
+PWM
+***
+
+`pwm[1-*]`
+		Pulse width modulation fan control.
 
-pwm[1-*]	Pulse width modulation fan control.
 		Integer value in the range 0 to 255
+
 		RW
+
 		255 is max or 100%.
 
-pwm[1-*]_enable
+`pwm[1-*]_enable`
 		Fan speed control method:
-		0: no fan speed control (i.e. fan at full speed)
-		1: manual fan speed control enabled (using pwm[1-*])
-		2+: automatic fan speed control enabled
+
+		- 0: no fan speed control (i.e. fan at full speed)
+		- 1: manual fan speed control enabled (using `pwm[1-*]`)
+		- 2+: automatic fan speed control enabled
+
 		Check individual chip documentation files for automatic mode
 		details.
+
 		RW
 
-pwm[1-*]_mode	0: DC mode (direct current)
-		1: PWM mode (pulse-width modulation)
+`pwm[1-*]_mode`
+		- 0: DC mode (direct current)
+		- 1: PWM mode (pulse-width modulation)
+
 		RW
 
-pwm[1-*]_freq	Base PWM frequency in Hz.
+`pwm[1-*]_freq`
+		Base PWM frequency in Hz.
+
 		Only possibly available when pwmN_mode is PWM, but not always
 		present even then.
+
 		RW
 
-pwm[1-*]_auto_channels_temp
+`pwm[1-*]_auto_channels_temp`
 		Select which temperature channels affect this PWM output in
-		auto mode. Bitfield, 1 is temp1, 2 is temp2, 4 is temp3 etc...
+		auto mode.
+
+		Bitfield, 1 is temp1, 2 is temp2, 4 is temp3 etc...
 		Which values are possible depend on the chip used.
+
 		RW
 
-pwm[1-*]_auto_point[1-*]_pwm
-pwm[1-*]_auto_point[1-*]_temp
-pwm[1-*]_auto_point[1-*]_temp_hyst
-		Define the PWM vs temperature curve. Number of trip points is
-		chip-dependent. Use this for chips which associate trip points
-		to PWM output channels.
+`pwm[1-*]_auto_point[1-*]_pwm` / `pwm[1-*]_auto_point[1-*]_temp` / `pwm[1-*]_auto_point[1-*]_temp_hyst`
+		Define the PWM vs temperature curve.
+
+		Number of trip points is chip-dependent. Use this for chips
+		which associate trip points to PWM output channels.
+
 		RW
 
-temp[1-*]_auto_point[1-*]_pwm
-temp[1-*]_auto_point[1-*]_temp
-temp[1-*]_auto_point[1-*]_temp_hyst
-		Define the PWM vs temperature curve. Number of trip points is
-		chip-dependent. Use this for chips which associate trip points
-		to temperature channels.
+`temp[1-*]_auto_point[1-*]_pwm` / `temp[1-*]_auto_point[1-*]_temp` / `temp[1-*]_auto_point[1-*]_temp_hyst`
+		Define the PWM vs temperature curve.
+
+		Number of trip points is chip-dependent. Use this for chips
+		which associate trip points to temperature channels.
+
 		RW
 
 There is a third case where trip points are associated to both PWM output
@@ -312,122 +405,173 @@ The actual result is up to the chip, but in general the highest candidate
 value (fastest fan speed) wins.
 
 
-****************
-* Temperatures *
-****************
+************
+Temperatures
+************
+
+`temp[1-*]_type`
+		Sensor type selection.
 
-temp[1-*]_type	Sensor type selection.
 		Integers 1 to 6
+
 		RW
-		1: CPU embedded diode
-		2: 3904 transistor
-		3: thermal diode
-		4: thermistor
-		5: AMD AMDSI
-		6: Intel PECI
+
+		- 1: CPU embedded diode
+		- 2: 3904 transistor
+		- 3: thermal diode
+		- 4: thermistor
+		- 5: AMD AMDSI
+		- 6: Intel PECI
+
 		Not all types are supported by all chips
 
-temp[1-*]_max	Temperature max value.
+`temp[1-*]_max`
+		Temperature max value.
+
 		Unit: millidegree Celsius (or millivolt, see below)
+
 		RW
 
-temp[1-*]_min	Temperature min value.
+`temp[1-*]_min`
+		Temperature min value.
+
 		Unit: millidegree Celsius
+
 		RW
 
-temp[1-*]_max_hyst
+`temp[1-*]_max_hyst`
 		Temperature hysteresis value for max limit.
+
 		Unit: millidegree Celsius
+
 		Must be reported as an absolute temperature, NOT a delta
 		from the max value.
+
 		RW
 
-temp[1-*]_min_hyst
+`temp[1-*]_min_hyst`
 		Temperature hysteresis value for min limit.
 		Unit: millidegree Celsius
+
 		Must be reported as an absolute temperature, NOT a delta
 		from the min value.
+
 		RW
 
-temp[1-*]_input Temperature input value.
+`temp[1-*]_input`
+	 Temperature input value.
+
 		Unit: millidegree Celsius
+
 		RO
 
-temp[1-*]_crit	Temperature critical max value, typically greater than
+`temp[1-*]_crit`
+		Temperature critical max value, typically greater than
 		corresponding temp_max values.
+
 		Unit: millidegree Celsius
+
 		RW
 
-temp[1-*]_crit_hyst
+`temp[1-*]_crit_hyst`
 		Temperature hysteresis value for critical limit.
+
 		Unit: millidegree Celsius
+
 		Must be reported as an absolute temperature, NOT a delta
 		from the critical value.
+
 		RW
 
-temp[1-*]_emergency
+`temp[1-*]_emergency`
 		Temperature emergency max value, for chips supporting more than
 		two upper temperature limits. Must be equal or greater than
 		corresponding temp_crit values.
+
 		Unit: millidegree Celsius
+
 		RW
 
-temp[1-*]_emergency_hyst
+`temp[1-*]_emergency_hyst`
 		Temperature hysteresis value for emergency limit.
+
 		Unit: millidegree Celsius
+
 		Must be reported as an absolute temperature, NOT a delta
 		from the emergency value.
+
 		RW
 
-temp[1-*]_lcrit	Temperature critical min value, typically lower than
+`temp[1-*]_lcrit`
+		Temperature critical min value, typically lower than
 		corresponding temp_min values.
+
 		Unit: millidegree Celsius
+
 		RW
 
-temp[1-*]_lcrit_hyst
+`temp[1-*]_lcrit_hyst`
 		Temperature hysteresis value for critical min limit.
+
 		Unit: millidegree Celsius
+
 		Must be reported as an absolute temperature, NOT a delta
 		from the critical min value.
+
 		RW
 
-temp[1-*]_offset
+`temp[1-*]_offset`
 		Temperature offset which is added to the temperature reading
 		by the chip.
+
 		Unit: millidegree Celsius
+
 		Read/Write value.
 
-temp[1-*]_label	Suggested temperature channel label.
+`temp[1-*]_label`
+		Suggested temperature channel label.
+
 		Text string
+
 		Should only be created if the driver has hints about what
 		this temperature channel is being used for, and user-space
 		doesn't. In all other cases, the label is provided by
 		user-space.
+
 		RO
 
-temp[1-*]_lowest
+`temp[1-*]_lowest`
 		Historical minimum temperature
+
 		Unit: millidegree Celsius
+
 		RO
 
-temp[1-*]_highest
+`temp[1-*]_highest`
 		Historical maximum temperature
+
 		Unit: millidegree Celsius
+
 		RO
 
-temp[1-*]_reset_history
+`temp[1-*]_reset_history`
 		Reset temp_lowest and temp_highest
+
 		WO
 
-temp_reset_history
+`temp_reset_history`
 		Reset temp_lowest and temp_highest for all sensors
+
 		WO
 
-temp[1-*]_enable
+`temp[1-*]_enable`
 		Enable or disable the sensors.
+
 		When disabled the sensor read will return -ENODATA.
-		1: Enable
-		0: Disable
+
+		- 1: Enable
+		- 0: Disable
+
 		RW
 
 Some chips measure temperature using external thermistors and an ADC, and
@@ -442,201 +586,300 @@ channels by the driver.
 Also see the Alarms section for status flags associated with temperatures.
 
 
-************
-* Currents *
-************
+********
+Currents
+********
+
+`curr[1-*]_max`
+		Current max value
 
-curr[1-*]_max	Current max value
 		Unit: milliampere
+
 		RW
 
-curr[1-*]_min	Current min value.
+`curr[1-*]_min`
+		Current min value.
+
 		Unit: milliampere
+
 		RW
 
-curr[1-*]_lcrit	Current critical low value
+`curr[1-*]_lcrit`
+		Current critical low value
+
 		Unit: milliampere
+
 		RW
 
-curr[1-*]_crit	Current critical high value.
+`curr[1-*]_crit`
+		Current critical high value.
+
 		Unit: milliampere
+
 		RW
 
-curr[1-*]_input	Current input value
+`curr[1-*]_input`
+		Current input value
+
 		Unit: milliampere
+
 		RO
 
-curr[1-*]_average
+`curr[1-*]_average`
 		Average current use
+
 		Unit: milliampere
+
 		RO
 
-curr[1-*]_lowest
+`curr[1-*]_lowest`
 		Historical minimum current
+
 		Unit: milliampere
+
 		RO
 
-curr[1-*]_highest
+`curr[1-*]_highest`
 		Historical maximum current
 		Unit: milliampere
 		RO
 
-curr[1-*]_reset_history
+`curr[1-*]_reset_history`
 		Reset currX_lowest and currX_highest
+
 		WO
 
-curr_reset_history
+`curr_reset_history`
 		Reset currX_lowest and currX_highest for all sensors
+
 		WO
 
-curr[1-*]_enable
+`curr[1-*]_enable`
 		Enable or disable the sensors.
+
 		When disabled the sensor read will return -ENODATA.
-		1: Enable
-		0: Disable
+
+		- 1: Enable
+		- 0: Disable
+
 		RW
 
 Also see the Alarms section for status flags associated with currents.
 
-*********
-* Power *
-*********
+*****
+Power
+*****
+
+`power[1-*]_average`
+				Average power use
 
-power[1-*]_average		Average power use
 				Unit: microWatt
+
 				RO
 
-power[1-*]_average_interval	Power use averaging interval.  A poll
+`power[1-*]_average_interval`
+				Power use averaging interval.  A poll
 				notification is sent to this file if the
 				hardware changes the averaging interval.
+
 				Unit: milliseconds
+
 				RW
 
-power[1-*]_average_interval_max	Maximum power use averaging interval
+`power[1-*]_average_interval_max`
+				Maximum power use averaging interval
+
 				Unit: milliseconds
+
 				RO
 
-power[1-*]_average_interval_min	Minimum power use averaging interval
+`power[1-*]_average_interval_min`
+				Minimum power use averaging interval
+
 				Unit: milliseconds
+
 				RO
 
-power[1-*]_average_highest	Historical average maximum power use
+`power[1-*]_average_highest`
+				Historical average maximum power use
+
 				Unit: microWatt
+
 				RO
 
-power[1-*]_average_lowest	Historical average minimum power use
+`power[1-*]_average_lowest`
+				Historical average minimum power use
+
 				Unit: microWatt
+
 				RO
 
-power[1-*]_average_max		A poll notification is sent to
-				power[1-*]_average when power use
+`power[1-*]_average_max`
+				A poll notification is sent to
+				`power[1-*]_average` when power use
 				rises above this value.
+
 				Unit: microWatt
+
 				RW
 
-power[1-*]_average_min		A poll notification is sent to
-				power[1-*]_average when power use
+`power[1-*]_average_min`
+				A poll notification is sent to
+				`power[1-*]_average` when power use
 				sinks below this value.
+
 				Unit: microWatt
+
 				RW
 
-power[1-*]_input		Instantaneous power use
+`power[1-*]_input`
+				Instantaneous power use
+
 				Unit: microWatt
+
 				RO
 
-power[1-*]_input_highest	Historical maximum power use
+`power[1-*]_input_highest`
+				Historical maximum power use
+
 				Unit: microWatt
+
 				RO
 
-power[1-*]_input_lowest		Historical minimum power use
+`power[1-*]_input_lowest`
+				Historical minimum power use
+
 				Unit: microWatt
+
 				RO
 
-power[1-*]_reset_history	Reset input_highest, input_lowest,
+`power[1-*]_reset_history`
+				Reset input_highest, input_lowest,
 				average_highest and average_lowest.
+
 				WO
 
-power[1-*]_accuracy		Accuracy of the power meter.
+`power[1-*]_accuracy`
+				Accuracy of the power meter.
+
 				Unit: Percent
+
 				RO
 
-power[1-*]_cap			If power use rises above this limit, the
+`power[1-*]_cap`
+				If power use rises above this limit, the
 				system should take action to reduce power use.
 				A poll notification is sent to this file if the
-				cap is changed by the hardware.  The *_cap
+				cap is changed by the hardware.  The `*_cap`
 				files only appear if the cap is known to be
 				enforced by hardware.
+
 				Unit: microWatt
+
 				RW
 
-power[1-*]_cap_hyst		Margin of hysteresis built around capping and
+`power[1-*]_cap_hyst`
+				Margin of hysteresis built around capping and
 				notification.
+
 				Unit: microWatt
+
 				RW
 
-power[1-*]_cap_max		Maximum cap that can be set.
+`power[1-*]_cap_max`
+				Maximum cap that can be set.
+
 				Unit: microWatt
+
 				RO
 
-power[1-*]_cap_min		Minimum cap that can be set.
+`power[1-*]_cap_min`
+				Minimum cap that can be set.
+
 				Unit: microWatt
+
 				RO
 
-power[1-*]_max			Maximum power.
+`power[1-*]_max`
+				Maximum power.
+
 				Unit: microWatt
+
 				RW
 
-power[1-*]_crit			Critical maximum power.
+`power[1-*]_crit`
+				Critical maximum power.
+
 				If power rises to or above this limit, the
 				system is expected take drastic action to reduce
 				power consumption, such as a system shutdown or
 				a forced powerdown of some devices.
+
 				Unit: microWatt
+
 				RW
 
-power[1-*]_enable		Enable or disable the sensors.
+`power[1-*]_enable`
+				Enable or disable the sensors.
+
 				When disabled the sensor read will return
 				-ENODATA.
-				1: Enable
-				0: Disable
+
+				- 1: Enable
+				- 0: Disable
+
 				RW
 
 Also see the Alarms section for status flags associated with power readings.
 
-**********
-* Energy *
-**********
+******
+Energy
+******
+
+`energy[1-*]_input`
+				Cumulative energy use
 
-energy[1-*]_input		Cumulative energy use
 				Unit: microJoule
+
 				RO
 
-energy[1-*]_enable		Enable or disable the sensors.
+`energy[1-*]_enable`
+				Enable or disable the sensors.
+
 				When disabled the sensor read will return
 				-ENODATA.
-				1: Enable
-				0: Disable
+
+				- 1: Enable
+				- 0: Disable
+
 				RW
 
-************
-* Humidity *
-************
+********
+Humidity
+********
+
+`humidity[1-*]_input`
+				Humidity
 
-humidity[1-*]_input		Humidity
 				Unit: milli-percent (per cent mille, pcm)
+
 				RO
 
 
-humidity[1-*]_enable		Enable or disable the sensors
+`humidity[1-*]_enable`
+				Enable or disable the sensors
+
 				When disabled the sensor read will return
 				-ENODATA.
-				1: Enable
-				0: Disable
+
+				- 1: Enable
+				- 0: Disable
+
 				RW
 
-**********
-* Alarms *
-**********
+******
+Alarms
+******
 
 Each channel or limit may have an associated alarm file, containing a
 boolean value. 1 means than an alarm condition exists, 0 means no alarm.
@@ -645,67 +888,67 @@ Usually a given chip will either use channel-related alarms, or
 limit-related alarms, not both. The driver should just reflect the hardware
 implementation.
 
-in[0-*]_alarm
-curr[1-*]_alarm
-power[1-*]_alarm
-fan[1-*]_alarm
-temp[1-*]_alarm
-		Channel alarm
-		0: no alarm
-		1: alarm
-		RO
++-------------------------------+-----------------------+
+| **`in[0-*]_alarm`,		| Channel alarm		|
+| `curr[1-*]_alarm`,		|			|
+| `power[1-*]_alarm`,		|   - 0: no alarm	|
+| `fan[1-*]_alarm`,		|   - 1: alarm		|
+| `temp[1-*]_alarm`**		|			|
+|				|   RO			|
++-------------------------------+-----------------------+
 
-OR
+**OR**
 
-in[0-*]_min_alarm
-in[0-*]_max_alarm
-in[0-*]_lcrit_alarm
-in[0-*]_crit_alarm
-curr[1-*]_min_alarm
-curr[1-*]_max_alarm
-curr[1-*]_lcrit_alarm
-curr[1-*]_crit_alarm
-power[1-*]_cap_alarm
-power[1-*]_max_alarm
-power[1-*]_crit_alarm
-fan[1-*]_min_alarm
-fan[1-*]_max_alarm
-temp[1-*]_min_alarm
-temp[1-*]_max_alarm
-temp[1-*]_lcrit_alarm
-temp[1-*]_crit_alarm
-temp[1-*]_emergency_alarm
-		Limit alarm
-		0: no alarm
-		1: alarm
-		RO
++-------------------------------+-----------------------+
+| **`in[0-*]_min_alarm`,	| Limit alarm		|
+| `in[0-*]_max_alarm`,		|			|
+| `in[0-*]_lcrit_alarm`,	|   - 0: no alarm	|
+| `in[0-*]_crit_alarm`,		|   - 1: alarm		|
+| `curr[1-*]_min_alarm`,	|			|
+| `curr[1-*]_max_alarm`,	| RO			|
+| `curr[1-*]_lcrit_alarm`,	|			|
+| `curr[1-*]_crit_alarm`,	|			|
+| `power[1-*]_cap_alarm`,	|			|
+| `power[1-*]_max_alarm`,	|			|
+| `power[1-*]_crit_alarm`,	|			|
+| `fan[1-*]_min_alarm`,		|			|
+| `fan[1-*]_max_alarm`,		|			|
+| `temp[1-*]_min_alarm`,	|			|
+| `temp[1-*]_max_alarm`,	|			|
+| `temp[1-*]_lcrit_alarm`,	|			|
+| `temp[1-*]_crit_alarm`,	|			|
+| `temp[1-*]_emergency_alarm`**	|			|
++-------------------------------+-----------------------+
 
 Each input channel may have an associated fault file. This can be used
 to notify open diodes, unconnected fans etc. where the hardware
 supports it. When this boolean has value 1, the measurement for that
 channel should not be trusted.
 
-fan[1-*]_fault
-temp[1-*]_fault
+`fan[1-*]_fault` / `temp[1-*]_fault`
 		Input fault condition
-		0: no fault occurred
-		1: fault condition
+
+		- 0: no fault occurred
+		- 1: fault condition
+
 		RO
 
 Some chips also offer the possibility to get beeped when an alarm occurs:
 
-beep_enable	Master beep enable
-		0: no beeps
-		1: beeps
+`beep_enable`
+		Master beep enable
+
+		- 0: no beeps
+		- 1: beeps
+
 		RW
 
-in[0-*]_beep
-curr[1-*]_beep
-fan[1-*]_beep
-temp[1-*]_beep
+`in[0-*]_beep`, `curr[1-*]_beep`, `fan[1-*]_beep`, `temp[1-*]_beep`,
 		Channel beep
-		0: disable
-		1: enable
+
+		- 0: disable
+		- 1: enable
+
 		RW
 
 In theory, a chip could provide per-limit beep masking, but no such chip
@@ -715,74 +958,90 @@ Old drivers provided a different, non-standard interface to alarms and
 beeps. These interface files are deprecated, but will be kept around
 for compatibility reasons:
 
-alarms		Alarm bitmask.
+`alarms`
+		Alarm bitmask.
+
 		RO
+
 		Integer representation of one to four 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. For this reason, the use of this
 		interface file for new drivers is discouraged. Use
-		individual *_alarm and *_fault files instead.
+		`individual *_alarm` and `*_fault` files instead.
 		Bits are defined in kernel/include/sensors.h.
 
-beep_mask	Bitmask for beep.
+`beep_mask`
+		Bitmask for beep.
 		Same format as 'alarms' with the same bit locations,
 		use discouraged for the same reason. Use individual
-		*_beep files instead.
+		`*_beep` files instead.
 		RW
 
 
-***********************
-* Intrusion detection *
-***********************
+*******************
+Intrusion detection
+*******************
 
-intrusion[0-*]_alarm
+`intrusion[0-*]_alarm`
 		Chassis intrusion detection
-		0: OK
-		1: intrusion detected
+
+		- 0: OK
+		- 1: intrusion detected
+
 		RW
+
 		Contrary to regular alarm flags which clear themselves
 		automatically when read, this one sticks until cleared by
 		the user. This is done by writing 0 to the file. Writing
 		other values is unsupported.
 
-intrusion[0-*]_beep
+`intrusion[0-*]_beep`
 		Chassis intrusion beep
+
 		0: disable
 		1: enable
+
 		RW
 
-********************************
-* Average sample configuration *
-********************************
+****************************
+Average sample configuration
+****************************
 
 Devices allowing for reading {in,power,curr,temp}_average values may export
 attributes for controlling number of samples used to compute average.
 
-samples		Sets number of average samples for all types of measurements.
-		RW
-
-in_samples
-power_samples
-curr_samples
-temp_samples    Sets number of average samples for specific type of measurements.
-		Note that on some devices it won't be possible to set all of them
-		to different values so changing one might also change some others.
-		RW
-
++--------------+---------------------------------------------------------------+
+| samples      | Sets number of average samples for all types of measurements. |
+|	       |							       |
+|	       | RW							       |
++--------------+---------------------------------------------------------------+
+| in_samples   | Sets number of average samples for specific type of	       |
+| power_samples| measurements.						       |
+| curr_samples |							       |
+| temp_samples | Note that on some devices it won't be possible to set all of  |
+|	       | them to different values so changing one might also change    |
+|	       | some others.						       |
+|	       |							       |
+|	       | RW							       |
++--------------+---------------------------------------------------------------+
 
 sysfs attribute writes interpretation
 -------------------------------------
 
 hwmon sysfs attributes always contain numbers, so the first thing to do is to
 convert the input to a number, there are 2 ways todo this depending whether
-the number can be negative or not:
-unsigned long u = simple_strtoul(buf, NULL, 10);
-long s = simple_strtol(buf, NULL, 10);
+the number can be negative or not::
+
+	unsigned long u = simple_strtoul(buf, NULL, 10);
+	long s = simple_strtol(buf, NULL, 10);
 
 With buf being the buffer with the user input being passed by the kernel.
 Notice that we do not use the second argument of strto[u]l, and thus cannot
@@ -807,13 +1066,13 @@ limits using clamp_val(value, min_limit, max_limit). If it is not continuous
 like for example a tempX_type, then when an invalid value is written,
 -EINVAL should be returned.
 
-Example1, temp1_max, register is a signed 8 bit value (-128 - 127 degrees):
+Example1, temp1_max, register is a signed 8 bit value (-128 - 127 degrees)::
 
 	long v = simple_strtol(buf, NULL, 10) / 1000;
 	v = clamp_val(v, -128, 127);
 	/* write v to register */
 
-Example2, fan divider setting, valid values 2, 4 and 8:
+Example2, fan divider setting, valid values 2, 4 and 8::
 
 	unsigned long v = simple_strtoul(buf, NULL, 10);
 
diff --git a/Documentation/hwmon/tc654 b/Documentation/hwmon/tc654
index 47636a8077b4..ce546ee6dfed 100644
--- a/Documentation/hwmon/tc654
+++ b/Documentation/hwmon/tc654
@@ -2,13 +2,16 @@ Kernel driver tc654
 ===================
 
 Supported chips:
+
   * Microchip TC654 and TC655
+
     Prefix: 'tc654'
-    Datasheet: http://ww1.microchip.com/downloads/en/DeviceDoc/20001734C.pdf
+    Datasheet: http://ww1.m
+    icrochip.com/downloads/en/DeviceDoc/20001734C.pdf
 
 Authors:
-        Chris Packham <chris.packham@alliedtelesis.co.nz>
-        Masahiko Iwamoto <iwamoto@allied-telesis.co.jp>
+      - Chris Packham <chris.packham@alliedtelesis.co.nz>
+      - Masahiko Iwamoto <iwamoto@allied-telesis.co.jp>
 
 Description
 -----------
diff --git a/Documentation/hwmon/tc74 b/Documentation/hwmon/tc74
index 43027aad5f8e..f1764211c129 100644
--- a/Documentation/hwmon/tc74
+++ b/Documentation/hwmon/tc74
@@ -2,8 +2,11 @@ Kernel driver tc74
 ====================
 
 Supported chips:
+
    * Microchip TC74
+
      Prefix: 'tc74'
+
      Datasheet: Publicly available at Microchip website.
 
 Description
diff --git a/Documentation/hwmon/thmc50 b/Documentation/hwmon/thmc50
index 8a7772ade8d0..6dba1b59b20c 100644
--- a/Documentation/hwmon/thmc50
+++ b/Documentation/hwmon/thmc50
@@ -2,30 +2,41 @@ Kernel driver thmc50
 =====================
 
 Supported chips:
+
   * Analog Devices ADM1022
+
     Prefix: 'adm1022'
+
     Addresses scanned: I2C 0x2c - 0x2e
+
     Datasheet: http://www.analog.com/en/prod/0,2877,ADM1022,00.html
+
   * Texas Instruments THMC50
+
     Prefix: 'thmc50'
+
     Addresses scanned: I2C 0x2c - 0x2e
-    Datasheet: http://www.ti.com/ 
+
+    Datasheet: http://www.ti.com/
+
 
 Author: Krzysztof Helt <krzysztof.h1@wp.pl>
 
 This driver was derived from the 2.4 kernel thmc50.c source file.
 
 Credits:
+
   thmc50.c (2.4 kernel):
-	Frodo Looijaard <frodol@dds.nl>
-	Philip Edelbrock <phil@netroedge.com>
+
+	- Frodo Looijaard <frodol@dds.nl>
+	- Philip Edelbrock <phil@netroedge.com>
 
 Module Parameters
 -----------------
 
 * adm1022_temp3: short array
-  List of adapter,address pairs to force chips into ADM1022 mode with
-  second remote temperature. This does not work for original THMC50 chips.
+    List of adapter,address pairs to force chips into ADM1022 mode with
+    second remote temperature. This does not work for original THMC50 chips.
 
 Description
 -----------
@@ -59,12 +70,17 @@ Driver Features
 
 The driver provides up to three temperatures:
 
-temp1		-- internal
-temp2		-- remote
-temp3		-- 2nd remote only for ADM1022
+temp1
+	- internal
+temp2
+	- remote
+temp3
+	- 2nd remote only for ADM1022
 
-pwm1		-- fan speed (0 = stop, 255 = full)
-pwm1_mode	-- always 0 (DC mode)
+pwm1
+	- fan speed (0 = stop, 255 = full)
+pwm1_mode
+	- always 0 (DC mode)
 
 The value of 0 for pwm1 also forces FAN_OFF signal from the chip,
 so it stops fans even if the value 0 into the ANALOG_OUT register does not.
diff --git a/Documentation/hwmon/tmp102 b/Documentation/hwmon/tmp102
index 8454a7763122..5e34821df4ab 100644
--- a/Documentation/hwmon/tmp102
+++ b/Documentation/hwmon/tmp102
@@ -2,12 +2,17 @@ Kernel driver tmp102
 ====================
 
 Supported chips:
+
   * Texas Instruments TMP102
+
     Prefix: 'tmp102'
+
     Addresses scanned: none
+
     Datasheet: http://focus.ti.com/docs/prod/folders/print/tmp102.html
 
 Author:
+
 	Steven King <sfking@fdwdc.com>
 
 Description
diff --git a/Documentation/hwmon/tmp103 b/Documentation/hwmon/tmp103
index ec00a15645ba..7682a795e38c 100644
--- a/Documentation/hwmon/tmp103
+++ b/Documentation/hwmon/tmp103
@@ -2,12 +2,17 @@ Kernel driver tmp103
 ====================
 
 Supported chips:
+
   * Texas Instruments TMP103
+
     Prefix: 'tmp103'
+
     Addresses scanned: none
+
     Product info and datasheet: http://www.ti.com/product/tmp103
 
 Author:
+
 	Heiko Schocher <hs@denx.de>
 
 Description
diff --git a/Documentation/hwmon/tmp108 b/Documentation/hwmon/tmp108
index 25802df23010..7e08b7ef1e2f 100644
--- a/Documentation/hwmon/tmp108
+++ b/Documentation/hwmon/tmp108
@@ -2,12 +2,17 @@ Kernel driver tmp108
 ====================
 
 Supported chips:
+
   * Texas Instruments TMP108
+
     Prefix: 'tmp108'
+
     Addresses scanned: none
+
     Datasheet: http://www.ti.com/product/tmp108
 
 Author:
+
 	John Muir <john@jmuir.com>
 
 Description
diff --git a/Documentation/hwmon/tmp421 b/Documentation/hwmon/tmp421
index 9e6fe5549ca1..1ba926a3605c 100644
--- a/Documentation/hwmon/tmp421
+++ b/Documentation/hwmon/tmp421
@@ -2,28 +2,49 @@ Kernel driver tmp421
 ====================
 
 Supported chips:
+
   * Texas Instruments TMP421
+
     Prefix: 'tmp421'
+
     Addresses scanned: I2C 0x2a, 0x4c, 0x4d, 0x4e and 0x4f
+
     Datasheet: http://focus.ti.com/docs/prod/folders/print/tmp421.html
+
   * Texas Instruments TMP422
+
     Prefix: 'tmp422'
+
     Addresses scanned: I2C 0x4c, 0x4d, 0x4e and 0x4f
+
     Datasheet: http://focus.ti.com/docs/prod/folders/print/tmp421.html
+
   * Texas Instruments TMP423
+
     Prefix: 'tmp423'
+
     Addresses scanned: I2C 0x4c and 0x4d
+
     Datasheet: http://focus.ti.com/docs/prod/folders/print/tmp421.html
+
   * Texas Instruments TMP441
+
     Prefix: 'tmp441'
+
     Addresses scanned: I2C 0x2a, 0x4c, 0x4d, 0x4e and 0x4f
+
     Datasheet: http://www.ti.com/product/tmp441
+
   * Texas Instruments TMP442
+
     Prefix: 'tmp442'
+
     Addresses scanned: I2C 0x4c and 0x4d
+
     Datasheet: http://www.ti.com/product/tmp442
 
 Authors:
+
 	Andre Prendel <andre.prendel@gmx.de>
 
 Description
@@ -40,5 +61,6 @@ for both the local and remote channels is 0.0625 degree C.
 The chips support only temperature measurement. The driver exports
 the temperature values via the following sysfs files:
 
-temp[1-4]_input
-temp[2-4]_fault
+**temp[1-4]_input**
+
+**temp[2-4]_fault**
diff --git a/Documentation/hwmon/twl4030-madc-hwmon b/Documentation/hwmon/twl4030-madc-hwmon
index c3a3a5be10ad..22c885383b11 100644
--- a/Documentation/hwmon/twl4030-madc-hwmon
+++ b/Documentation/hwmon/twl4030-madc-hwmon
@@ -1,8 +1,10 @@
 Kernel driver twl4030-madc
-=========================
+==========================
 
 Supported chips:
+
 	* Texas Instruments TWL4030
+
 	Prefix: 'twl4030-madc'
 
 
@@ -19,8 +21,9 @@ channels which can be used in different modes.
 
 See this table for the meaning of the different channels
 
+======= ==========================================================
 Channel Signal
-------------------------------------------
+======= ==========================================================
 0	Battery type(BTYPE)
 1	BCI: Battery temperature (BTEMP)
 2	GP analog input
@@ -37,6 +40,7 @@ Channel Signal
 13	Reserved
 14	Reserved
 15	VRUSB Supply/Speaker left/Speaker right polarization level
+======= ==========================================================
 
 
 The Sysfs nodes will represent the voltage in the units of mV,
diff --git a/Documentation/hwmon/userspace-tools b/Documentation/hwmon/userspace-tools
index 9865aeedc58f..bf3797c8e734 100644
--- a/Documentation/hwmon/userspace-tools
+++ b/Documentation/hwmon/userspace-tools
@@ -1,3 +1,6 @@
+Userspace tools
+===============
+
 Introduction
 ------------
 
diff --git a/Documentation/hwmon/via686a b/Documentation/hwmon/via686a
index e5f90ab5c48d..a343c35df740 100644
--- a/Documentation/hwmon/via686a
+++ b/Documentation/hwmon/via686a
@@ -2,29 +2,35 @@ Kernel driver via686a
 =====================
 
 Supported chips:
+
   * Via VT82C686A, VT82C686B  Southbridge Integrated Hardware Monitor
+
     Prefix: 'via686a'
+
     Addresses scanned: ISA in PCI-space encoded address
+
     Datasheet: On request through web form (http://www.via.com.tw/en/resources/download-center/)
 
 Authors:
-        Kyösti Mälkki <kmalkki@cc.hut.fi>,
-        Mark D. Studebaker <mdsxyz123@yahoo.com>
-        Bob Dougherty <bobd@stanford.edu>
-        (Some conversion-factor data were contributed by
-        Jonathan Teh Soon Yew <j.teh@iname.com>
-        and Alex van Kaam <darkside@chello.nl>.)
+	- Kyösti Mälkki <kmalkki@cc.hut.fi>,
+	- Mark D. Studebaker <mdsxyz123@yahoo.com>
+	- Bob Dougherty <bobd@stanford.edu>
+	- (Some conversion-factor data were contributed by
+	- Jonathan Teh Soon Yew <j.teh@iname.com>
+	- and Alex van Kaam <darkside@chello.nl>.)
 
 Module Parameters
 -----------------
 
+======================= =======================================================
 force_addr=0xaddr       Set the I/O base address. Useful for boards that
-                        don't set the address in the BIOS. Look for a BIOS
-                        upgrade before resorting to this. Does not do a
-                        PCI force; the via686a must still be present in lspci.
-                        Don't use this unless the driver complains that the
-                        base address is not set.
-                        Example: 'modprobe via686a force_addr=0x6000'
+			don't set the address in the BIOS. Look for a BIOS
+			upgrade before resorting to this. Does not do a
+			PCI force; the via686a must still be present in lspci.
+			Don't use this unless the driver complains that the
+			base address is not set.
+			Example: 'modprobe via686a force_addr=0x6000'
+======================= =======================================================
 
 Description
 -----------
diff --git a/Documentation/hwmon/w83627ehf b/Documentation/hwmon/w83627ehf
index 735c42a85ead..74d19ef11e1f 100644
--- a/Documentation/hwmon/w83627ehf
+++ b/Documentation/hwmon/w83627ehf
@@ -2,45 +2,79 @@ Kernel driver w83627ehf
 =======================
 
 Supported chips:
+
   * Winbond W83627EHF/EHG (ISA access ONLY)
+
     Prefix: 'w83627ehf'
+
     Addresses scanned: ISA address retrieved from Super I/O registers
+
     Datasheet: not available
+
   * Winbond W83627DHG
+
     Prefix: 'w83627dhg'
+
     Addresses scanned: ISA address retrieved from Super I/O registers
+
     Datasheet: not available
+
   * Winbond W83627DHG-P
+
     Prefix: 'w83627dhg'
+
     Addresses scanned: ISA address retrieved from Super I/O registers
+
     Datasheet: not available
+
   * Winbond W83627UHG
+
     Prefix: 'w83627uhg'
+
     Addresses scanned: ISA address retrieved from Super I/O registers
+
     Datasheet: available from www.nuvoton.com
+
   * Winbond W83667HG
+
     Prefix: 'w83667hg'
+
     Addresses scanned: ISA address retrieved from Super I/O registers
+
     Datasheet: not available
+
   * Winbond W83667HG-B
+
     Prefix: 'w83667hg'
+
     Addresses scanned: ISA address retrieved from Super I/O registers
+
     Datasheet: Available from Nuvoton upon request
+
   * Nuvoton NCT6775F/W83667HG-I
+
     Prefix: 'nct6775'
+
     Addresses scanned: ISA address retrieved from Super I/O registers
+
     Datasheet: Available from Nuvoton upon request
+
   * Nuvoton NCT6776F
+
     Prefix: 'nct6776'
+
     Addresses scanned: ISA address retrieved from Super I/O registers
+
     Datasheet: Available from Nuvoton upon request
 
+
 Authors:
-        Jean Delvare <jdelvare@suse.de>
-        Yuan Mu (Winbond)
-        Rudolf Marek <r.marek@assembler.cz>
-        David Hubbard <david.c.hubbard@gmail.com>
-        Gong Jun <JGong@nuvoton.com>
+
+	- Jean Delvare <jdelvare@suse.de>
+	- Yuan Mu (Winbond)
+	- Rudolf Marek <r.marek@assembler.cz>
+	- David Hubbard <david.c.hubbard@gmail.com>
+	- Gong Jun <JGong@nuvoton.com>
 
 Description
 -----------
@@ -85,25 +119,30 @@ predefined temperature range. If the temperature goes out of range, fan
 is driven slower/faster to reach the predefined range again.
 
 The mode works for fan1-fan4. Mapping of temperatures to pwm outputs is as
-follows:
+follows::
 
-temp1 -> pwm1
-temp2 -> pwm2
-temp3 -> pwm3 (not on 627UHG)
-prog  -> pwm4 (not on 667HG and 667HG-B; the programmable setting is not
-	       supported by the driver)
+  temp1 -> pwm1
+  temp2 -> pwm2
+  temp3 -> pwm3 (not on 627UHG)
+  prog  -> pwm4 (not on 667HG and 667HG-B; the programmable setting is not
+		 supported by the driver)
 
 /sys files
 ----------
 
-name - this is a standard hwmon device entry, it contains the name of
-       the device (see the prefix in the list of supported devices at
-       the top of this file)
+name
+	this is a standard hwmon device entry, it contains the name of
+	the device (see the prefix in the list of supported devices at
+	the top of this file)
+
+pwm[1-4]
+	this file stores PWM duty cycle or DC value (fan speed) in range:
 
-pwm[1-4] - this file stores PWM duty cycle or DC value (fan speed) in range:
 	   0 (stop) to 255 (full)
 
-pwm[1-4]_enable - this file controls mode of fan/temperature control:
+pwm[1-4]_enable
+	this file controls mode of fan/temperature control:
+
 	* 1 Manual mode, write to pwm file any value 0-255 (full speed)
 	* 2 "Thermal Cruise" mode
 	* 3 "Fan Speed Cruise" mode
@@ -121,33 +160,43 @@ pwm[1-4]_enable - this file controls mode of fan/temperature control:
 	returned when reading pwm attributes is unrelated to SmartFan IV
 	operation.
 
-pwm[1-4]_mode - controls if output is PWM or DC level
-        * 0 DC output (0 - 12v)
-        * 1 PWM output
+pwm[1-4]_mode
+	controls if output is PWM or DC level
+
+	* 0 DC output (0 - 12v)
+	* 1 PWM output
 
 Thermal Cruise mode
 -------------------
 
 If the temperature is in the range defined by:
 
-pwm[1-4]_target    - set target temperature, unit millidegree Celsius
-		     (range 0 - 127000)
-pwm[1-4]_tolerance - tolerance, unit millidegree Celsius (range 0 - 15000)
+pwm[1-4]_target
+		   set target temperature, unit millidegree Celsius
+		   (range 0 - 127000)
+pwm[1-4]_tolerance
+		   tolerance, unit millidegree Celsius (range 0 - 15000)
 
 there are no changes to fan speed. Once the temperature leaves the interval,
 fan speed increases (temp is higher) or decreases if lower than desired.
 There are defined steps and times, but not exported by the driver yet.
 
-pwm[1-4]_min_output - minimum fan speed (range 1 - 255), when the temperature
-                      is below defined range.
-pwm[1-4]_stop_time  - how many milliseconds [ms] must elapse to switch
-                      corresponding fan off. (when the temperature was below
-                      defined range).
-pwm[1-4]_start_output-minimum fan speed (range 1 - 255) when spinning up
-pwm[1-4]_step_output- rate of fan speed change (1 - 255)
-pwm[1-4]_stop_output- minimum fan speed (range 1 - 255) when spinning down
-pwm[1-4]_max_output - maximum fan speed (range 1 - 255), when the temperature
-                      is above defined range.
+pwm[1-4]_min_output
+		   minimum fan speed (range 1 - 255), when the temperature
+		   is below defined range.
+pwm[1-4]_stop_time
+		   how many milliseconds [ms] must elapse to switch
+		   corresponding fan off. (when the temperature was below
+		   defined range).
+pwm[1-4]_start_output
+		   minimum fan speed (range 1 - 255) when spinning up
+pwm[1-4]_step_output
+		   rate of fan speed change (1 - 255)
+pwm[1-4]_stop_output
+		   minimum fan speed (range 1 - 255) when spinning down
+pwm[1-4]_max_output
+		   maximum fan speed (range 1 - 255), when the temperature
+		   is above defined range.
 
 Note: last six functions are influenced by other control bits, not yet exported
       by the driver, so a change might not have any effect.
@@ -161,26 +210,35 @@ different power-on default values, but BIOS should already be loading
 appropriate defaults. Note that bank selection must be performed as is currently
 done in the driver for all register addresses.
 
-0x49:  only on DHG, selects temperature source for AUX fan, CPU fan0
-0x4a:  not completely documented for the EHF and the DHG documentation assigns
-       different behavior to bits 7 and 6, including extending the temperature
-       input selection to SmartFan I, not just SmartFan III. Testing on the EHF
-       will reveal whether they are compatible or not.
+========================= =====================================================
+Register(s)		  Meaning
+========================= =====================================================
+0x49                      only on DHG, selects temperature source for AUX fan,
+			  CPU fan0
+0x4a                      not completely documented for the EHF and the DHG
+			  documentation assigns different behavior to bits 7
+			  and 6, including extending the temperature input
+			  selection to SmartFan I, not just SmartFan III.
+			  Testing on the EHF will reveal whether they are
+			  compatible or not.
+0x58                      Chip ID: 0xa1=EHF 0xc1=DHG
+0x5e                      only on DHG, has bits to enable "current mode"
+			  temperature detection and critical temperature
+			  protection
+0x45b                     only on EHF, bit 3, vin4 alarm (EHF supports 10
+			  inputs, only 9 on DHG)
+0x552                     only on EHF, vin4
+0x558                     only on EHF, vin4 high limit
+0x559                     only on EHF, vin4 low limit
+0x6b                      only on DHG, SYS fan critical temperature
+0x6c                      only on DHG, CPU fan0 critical temperature
+0x6d                      only on DHG, AUX fan critical temperature
+0x6e                      only on DHG, CPU fan1 critical temperature
+0x50-0x55 and 0x650-0x657 marked as:
 
-0x58:  Chip ID: 0xa1=EHF 0xc1=DHG
-0x5e:  only on DHG, has bits to enable "current mode" temperature detection and
-       critical temperature protection
-0x45b: only on EHF, bit 3, vin4 alarm (EHF supports 10 inputs, only 9 on DHG)
-0x552: only on EHF, vin4
-0x558: only on EHF, vin4 high limit
-0x559: only on EHF, vin4 low limit
-0x6b:  only on DHG, SYS fan critical temperature
-0x6c:  only on DHG, CPU fan0 critical temperature
-0x6d:  only on DHG, AUX fan critical temperature
-0x6e:  only on DHG, CPU fan1 critical temperature
-
-0x50-0x55 and 0x650-0x657 are marked "Test Register" for the EHF, but "Reserved
-       Register" for the DHG
+			    - "Test Register" for the EHF
+			    - "Reserved Register" for the DHG
+========================= =====================================================
 
 The DHG also supports PECI, where the DHG queries Intel CPU temperatures, and
 the ICH8 southbridge gets that data via PECI from the DHG, so that the
diff --git a/Documentation/hwmon/w83627hf b/Documentation/hwmon/w83627hf
index 8432e1118173..d1406c28dee7 100644
--- a/Documentation/hwmon/w83627hf
+++ b/Documentation/hwmon/w83627hf
@@ -20,10 +20,10 @@ Supported chips:
     Datasheet: Provided by Winbond on request(http://www.winbond.com/hq/enu)
 
 Authors:
-        Frodo Looijaard <frodol@dds.nl>,
-        Philip Edelbrock <phil@netroedge.com>,
-        Mark Studebaker <mdsxyz123@yahoo.com>,
-        Bernhard C. Schrenk <clemy@clemy.org>
+	Frodo Looijaard <frodol@dds.nl>,
+	Philip Edelbrock <phil@netroedge.com>,
+	Mark Studebaker <mdsxyz123@yahoo.com>,
+	Bernhard C. Schrenk <clemy@clemy.org>
 
 Module Parameters
 -----------------
@@ -52,8 +52,8 @@ If you really want i2c accesses for these Super I/O chips,
 use the w83781d driver. However this is not the preferred method
 now that this ISA driver has been developed.
 
-The w83627_HF_ uses pins 110-106 as VID0-VID4. The w83627_THF_ uses the
-same pins as GPIO[0:4]. Technically, the w83627_THF_ does not support a
+The `w83627_HF_` uses pins 110-106 as VID0-VID4. The `w83627_THF_` uses the
+same pins as GPIO[0:4]. Technically, the `w83627_THF_` does not support a
 VID reading. However the two chips have the identical 128 pin package. So,
 it is possible or even likely for a w83627thf to have the VID signals routed
 to these pins despite their not being labeled for that purpose. Therefore,
@@ -75,19 +75,23 @@ module parameter is gone for technical reasons. If you need this feature,
 you can obtain the same result by using the isaset tool (part of
 lm-sensors) before loading the driver:
 
-# Enter the Super I/O config space
-isaset -y -f 0x2e 0x87
-isaset -y -f 0x2e 0x87
+# Enter the Super I/O config space::
 
-# Select the hwmon logical device
-isaset -y 0x2e 0x2f 0x07 0x0b
+	isaset -y -f 0x2e 0x87
+	isaset -y -f 0x2e 0x87
 
-# Set the base I/O address (to 0x290 in this example)
-isaset -y 0x2e 0x2f 0x60 0x02
-isaset -y 0x2e 0x2f 0x61 0x90
+# Select the hwmon logical device::
 
-# Exit the Super-I/O config space
-isaset -y -f 0x2e 0xaa
+	isaset -y 0x2e 0x2f 0x07 0x0b
+
+# Set the base I/O address (to 0x290 in this example)::
+
+	isaset -y 0x2e 0x2f 0x60 0x02
+	isaset -y 0x2e 0x2f 0x61 0x90
+
+# Exit the Super-I/O config space::
+
+	isaset -y -f 0x2e 0xaa
 
 The above sequence assumes a Super-I/O config space at 0x2e/0x2f, but
 0x4e/0x4f is also possible.
@@ -97,18 +101,23 @@ Voltage pin mapping
 
 Here is a summary of the voltage pin mapping for the W83627THF. This
 can be useful to convert data provided by board manufacturers into
-working libsensors configuration statements.
-
-    W83627THF		|
-  Pin	| Name		| Register	| Sysfs attribute
------------------------------------------------------
-  100	| CPUVCORE	| 20h		| in0
-   99	| VIN0		| 21h		| in1
-   98	| VIN1		| 22h		| in2
-   97	| VIN2		| 24h		| in4
-  114	| AVCC		| 23h		| in3
-   61	| 5VSB		| 50h (bank 5)	| in7
-   74	| VBAT		| 51h (bank 5)	| in8
+working libsensors configuration statements:
+
+
+- W83627THF
+
+
+  ======== =============== =============== ===============
+  Pin	   Name		   Register	   Sysfs attribute
+  ======== =============== =============== ===============
+    100	   CPUVCORE	   20h		   in0
+     99	   VIN0		   21h		   in1
+     98	   VIN1		   22h		   in2
+     97	   VIN2		   24h		   in4
+    114	   AVCC		   23h		   in3
+     61	   5VSB		   50h (bank 5)	   in7
+     74	   VBAT		   51h (bank 5)	   in8
+  ======== =============== =============== ===============
 
 For other supported devices, you'll have to take the hard path and
 look up the information in the datasheet yourself (and then add it
diff --git a/Documentation/hwmon/w83773g b/Documentation/hwmon/w83773g
index 4cc6c0b8257f..cabaed391414 100644
--- a/Documentation/hwmon/w83773g
+++ b/Documentation/hwmon/w83773g
@@ -1,13 +1,18 @@
 Kernel driver w83773g
-====================
+=====================
 
 Supported chips:
+
   * Nuvoton W83773G
+
     Prefix: 'w83773g'
+
     Addresses scanned: I2C 0x4c and 0x4d
+
     Datasheet: https://www.nuvoton.com/resource-files/W83773G_SG_DatasheetV1_2.pdf
 
 Authors:
+
 	Lei YU <mine260309@gmail.com>
 
 Description
@@ -27,7 +32,4 @@ Resolution for both the local and remote channels is 0.125 degree C.
 The chip supports only temperature measurement. The driver exports
 the temperature values via the following sysfs files:
 
-temp[1-3]_input
-temp[2-3]_fault
-temp[2-3]_offset
-update_interval
+**temp[1-3]_input, temp[2-3]_fault, temp[2-3]_offset, update_interval**
diff --git a/Documentation/hwmon/w83781d b/Documentation/hwmon/w83781d
index 129b0a3b555b..f36d33dfb704 100644
--- a/Documentation/hwmon/w83781d
+++ b/Documentation/hwmon/w83781d
@@ -2,44 +2,64 @@ Kernel driver w83781d
 =====================
 
 Supported chips:
+
   * Winbond W83781D
+
     Prefix: 'w83781d'
+
     Addresses scanned: I2C 0x28 - 0x2f, ISA 0x290 (8 I/O ports)
+
     Datasheet: http://www.winbond-usa.com/products/winbond_products/pdfs/PCIC/w83781d.pdf
+
   * Winbond W83782D
+
     Prefix: 'w83782d'
+
     Addresses scanned: I2C 0x28 - 0x2f, ISA 0x290 (8 I/O ports)
+
     Datasheet: http://www.winbond.com
+
   * Winbond W83783S
+
     Prefix: 'w83783s'
+
     Addresses scanned: I2C 0x2d
+
     Datasheet: http://www.winbond-usa.com/products/winbond_products/pdfs/PCIC/w83783s.pdf
+
   * Asus AS99127F
+
     Prefix: 'as99127f'
+
     Addresses scanned: I2C 0x28 - 0x2f
+
     Datasheet: Unavailable from Asus
 
+
+
 Authors:
-        Frodo Looijaard <frodol@dds.nl>,
-        Philip Edelbrock <phil@netroedge.com>,
-        Mark Studebaker <mdsxyz123@yahoo.com>
+
+      - Frodo Looijaard <frodol@dds.nl>,
+      - Philip Edelbrock <phil@netroedge.com>,
+      - Mark Studebaker <mdsxyz123@yahoo.com>
 
 Module parameters
 -----------------
 
 * init int
-  (default 1)
-  Use 'init=0' to bypass initializing the chip.
-  Try this if your computer crashes when you load the module.
+    (default 1)
+
+    Use 'init=0' to bypass initializing the chip.
+    Try this if your computer crashes when you load the module.
 
 * reset int
-  (default 0)
-  The driver used to reset the chip on load, but does no more. Use
-  'reset=1' to restore the old behavior. Report if you need to do this.
+    (default 0)
+    The driver used to reset the chip on load, but does no more. Use
+    'reset=1' to restore the old behavior. Report if you need to do this.
 
 force_subclients=bus,caddr,saddr,saddr
   This is used to force the i2c addresses for subclients of
-  a certain chip. Typical usage is `force_subclients=0,0x2d,0x4a,0x4b'
+  a certain chip. Typical usage is `force_subclients=0,0x2d,0x4a,0x4b`
   to force the subclients of chip 0x2d on bus 0 to i2c addresses
   0x4a and 0x4b. This parameter is useful for certain Tyan boards.
 
@@ -54,12 +74,19 @@ There is quite some difference between these chips, but they are similar
 enough that it was sensible to put them together in one driver.
 The Asus chips are similar to an I2C-only W83782D.
 
-Chip        #vin    #fanin  #pwm    #temp   wchipid vendid  i2c     ISA
-as99127f    7       3       0       3       0x31    0x12c3  yes     no
-as99127f rev.2 (type_name = as99127f)       0x31    0x5ca3  yes     no
-w83781d     7       3       0       3       0x10-1  0x5ca3  yes     yes
-w83782d     9       3       2-4     3       0x30    0x5ca3  yes     yes
-w83783s     5-6     3       2       1-2     0x40    0x5ca3  yes     no
++----------+---------+--------+-------+-------+---------+--------+------+-----+
+| Chip     | #vin    | #fanin | #pwm  | #temp | wchipid | vendid | i2c  | ISA |
++----------+---------+--------+-------+-------+---------+--------+------+-----+
+| as99127f | 7       | 3      | 0     | 3     | 0x31    | 0x12c3 | yes  |  no |
++----------+---------+--------+-------+-------+---------+--------+------+-----+
+| as99127f rev.2 (type_name = as99127f)       | 0x31    | 0x5ca3 | yes  |  no |
++----------+---------+--------+-------+-------+---------+--------+------+-----+
+| w83781d  | 7       | 3      | 0     | 3     | 0x10-1  | 0x5ca3 | yes  | yes |
++----------+---------+--------+-------+-------+---------+--------+------+-----+
+| w83782d  | 9       | 3      | 2-4   | 3     | 0x30    | 0x5ca3 | yes  | yes |
++----------+---------+--------+-------+-------+---------+--------+------+-----+
+| w83783s  | 5-6     | 3      | 2     |  1-2  | 0x40    | 0x5ca3 | yes  |  no |
++----------+---------+--------+-------+-------+---------+--------+------+-----+
 
 Detection of these chips can sometimes be foiled because they can be in
 an internal state that allows no clean access. If you know the address
@@ -124,22 +151,24 @@ or only the beeping for some alarms.
 
 Individual alarm and beep bits:
 
-0x000001: in0
-0x000002: in1
-0x000004: in2
-0x000008: in3
-0x000010: temp1
-0x000020: temp2 (+temp3 on W83781D)
-0x000040: fan1
-0x000080: fan2
-0x000100: in4
-0x000200: in5
-0x000400: in6
-0x000800: fan3
-0x001000: chassis
-0x002000: temp3 (W83782D only)
-0x010000: in7 (W83782D only)
-0x020000: in8 (W83782D only)
+======== ==========================
+0x000001 in0
+0x000002 in1
+0x000004 in2
+0x000008 in3
+0x000010 temp1
+0x000020 temp2 (+temp3 on W83781D)
+0x000040 fan1
+0x000080 fan2
+0x000100 in4
+0x000200 in5
+0x000400 in6
+0x000800 fan3
+0x001000 chassis
+0x002000 temp3 (W83782D only)
+0x010000 in7 (W83782D only)
+0x020000 in8 (W83782D only)
+======== ==========================
 
 If an alarm triggers, it will remain triggered until the hardware register
 is read at least once. This means that the cause for the alarm may
@@ -179,68 +208,74 @@ Please do not send mail to the author or the sensors group asking for
 a datasheet or ideas on how to convince Asus. We can't help.
 
 
-NOTES:
+NOTES
 -----
   783s has no in1 so that in[2-6] are compatible with the 781d/782d.
 
   783s pin is programmable for -5V or temp1; defaults to -5V,
-       no control in driver so temp1 doesn't work.
+  no control in driver so temp1 doesn't work.
 
   782d and 783s datasheets differ on which is pwm1 and which is pwm2.
-       We chose to follow 782d.
+  We chose to follow 782d.
 
   782d and 783s pin is programmable for fan3 input or pwm2 output;
-       defaults to fan3 input.
-       If pwm2 is enabled (with echo 255 1 > pwm2), then
-       fan3 will report 0.
+  defaults to fan3 input.
+  If pwm2 is enabled (with echo 255 1 > pwm2), then
+  fan3 will report 0.
 
   782d has pwm1-2 for ISA, pwm1-4 for i2c. (pwm3-4 share pins with
-       the ISA pins)
+  the ISA pins)
 
-Data sheet updates:
+Data sheet updates
 ------------------
 	- PWM clock registers:
-
-		000: master /  512
-		001: master / 1024
-		010: master / 2048
-		011: master / 4096
-		100: master / 8192
+		* 000: master /  512
+		* 001: master / 1024
+		* 010: master / 2048
+		* 011: master / 4096
+		* 100: master / 8192
 
 
 Answers from Winbond tech support
 ---------------------------------
->
-> 1) In the W83781D data sheet section 7.2 last paragraph, it talks about
->    reprogramming the R-T table if the Beta of the thermistor is not
->    3435K. The R-T table is described briefly in section 8.20.
->    What formulas do I use to program a new R-T table for a given Beta?
->
-	We are sorry that the calculation for R-T table value is
-confidential. If you have another Beta value of thermistor, we can help
-to calculate the R-T table for you. But you should give us real R-T
-Table which can be gotten by thermistor vendor. Therefore we will calculate
-them and obtain 32-byte data, and you can fill the 32-byte data to the
-register in Bank0.CR51 of W83781D.
 
+::
 
-> 2) In the W83782D data sheet, it mentions that pins 38, 39, and 40 are
->    programmable to be either thermistor or Pentium II diode inputs.
->    How do I program them for diode inputs? I can't find any register
->    to program these to be diode inputs.
- --> You may program Bank0 CR[5Dh] and CR[59h] registers.
+  >
+  > 1) In the W83781D data sheet section 7.2 last paragraph, it talks about
+  >    reprogramming the R-T table if the Beta of the thermistor is not
+  >    3435K. The R-T table is described briefly in section 8.20.
+  >    What formulas do I use to program a new R-T table for a given Beta?
+  >
 
- 	CR[5Dh]    		bit 1(VTIN1)    bit 2(VTIN2)   bit 3(VTIN3)
+  We are sorry that the calculation for R-T table value is
+  confidential. If you have another Beta value of thermistor, we can help
+  to calculate the R-T table for you. But you should give us real R-T
+  Table which can be gotten by thermistor vendor. Therefore we will calculate
+  them and obtain 32-byte data, and you can fill the 32-byte data to the
+  register in Bank0.CR51 of W83781D.
 
-      	thermistor                0		 0		0
- 	diode 		          1		 1		1
 
+  > 2) In the W83782D data sheet, it mentions that pins 38, 39, and 40 are
+  >    programmable to be either thermistor or Pentium II diode inputs.
+  >    How do I program them for diode inputs? I can't find any register
+  >    to program these to be diode inputs.
 
-(error) CR[59h] 		bit 4(VTIN1)	bit 2(VTIN2)   bit 3(VTIN3)
-(right) CR[59h] 		bit 4(VTIN1)	bit 5(VTIN2)   bit 6(VTIN3)
+  You may program Bank0 CR[5Dh] and CR[59h] registers.
 
- 	PII thermal diode         1		 1		1
- 	2N3904	diode	          0		 0		0
+  =============================== =============== ============== ============
+	CR[5Dh]    		bit 1(VTIN1)    bit 2(VTIN2)   bit 3(VTIN3)
+
+		thermistor                0		 0		0
+	diode 			  1		 1		1
+
+
+  (error) CR[59h] 		bit 4(VTIN1)	bit 2(VTIN2)   bit 3(VTIN3)
+  (right) CR[59h] 		bit 4(VTIN1)	bit 5(VTIN2)   bit 6(VTIN3)
+
+	PII thermal diode         1		 1		1
+	2N3904	diode		  0		 0		0
+  =============================== =============== ============== ============
 
 
 Asus Clones
@@ -251,18 +286,21 @@ Here are some very useful information that were given to us by Alex Van
 Kaam about how to detect these chips, and how to read their values. He
 also gives advice for another Asus chipset, the Mozart-2 (which we
 don't support yet). Thanks Alex!
+
 I reworded some parts and added personal comments.
 
-# Detection:
+Detection
+^^^^^^^^^
 
 AS99127F rev.1, AS99127F rev.2 and ASB100:
 - I2C address range: 0x29 - 0x2F
-- If register 0x58 holds 0x31 then we have an Asus (either ASB100 or
-  AS99127F)
+- If register 0x58 holds 0x31 then we have an Asus (either ASB100 or AS99127F)
 - Which one depends on register 0x4F (manufacturer ID):
-  0x06 or 0x94: ASB100
-  0x12 or 0xC3: AS99127F rev.1
-  0x5C or 0xA3: AS99127F rev.2
+
+  - 0x06 or 0x94: ASB100
+  - 0x12 or 0xC3: AS99127F rev.1
+  - 0x5C or 0xA3: AS99127F rev.2
+
   Note that 0x5CA3 is Winbond's ID (WEC), which let us think Asus get their
   AS99127F rev.2 direct from Winbond. The other codes mean ATT and DVC,
   respectively. ATT could stand for Asustek something (although it would be
@@ -273,88 +311,103 @@ Mozart-2:
 - I2C address: 0x77
 - If register 0x58 holds 0x56 or 0x10 then we have a Mozart-2
 - Of the Mozart there are 3 types:
-  0x58=0x56, 0x4E=0x94, 0x4F=0x36: Asus ASM58 Mozart-2
-  0x58=0x56, 0x4E=0x94, 0x4F=0x06: Asus AS2K129R Mozart-2
-  0x58=0x10, 0x4E=0x5C, 0x4F=0xA3: Asus ??? Mozart-2
+
+  - 0x58=0x56, 0x4E=0x94, 0x4F=0x36: Asus ASM58 Mozart-2
+  - 0x58=0x56, 0x4E=0x94, 0x4F=0x06: Asus AS2K129R Mozart-2
+  - 0x58=0x10, 0x4E=0x5C, 0x4F=0xA3: Asus ??? Mozart-2
+
   You can handle all 3 the exact same way :)
 
-# Temperature sensors:
+Temperature sensors
+^^^^^^^^^^^^^^^^^^^
 
 ASB100:
-- sensor 1: register 0x27
-- sensor 2 & 3 are the 2 LM75's on the SMBus
-- sensor 4: register 0x17
-Remark: I noticed that on Intel boards sensor 2 is used for the CPU
+  - sensor 1: register 0x27
+  - sensor 2 & 3 are the 2 LM75's on the SMBus
+  - sensor 4: register 0x17
+
+Remark:
+
+  I noticed that on Intel boards sensor 2 is used for the CPU
   and 4 is ignored/stuck, on AMD boards sensor 4 is the CPU and sensor 2 is
   either ignored or a socket temperature.
 
 AS99127F (rev.1 and 2 alike):
-- sensor 1: register 0x27
-- sensor 2 & 3 are the 2 LM75's on the SMBus
-Remark: Register 0x5b is suspected to be temperature type selector. Bit 1
+  - sensor 1: register 0x27
+  - sensor 2 & 3 are the 2 LM75's on the SMBus
+
+Remark:
+
+  Register 0x5b is suspected to be temperature type selector. Bit 1
   would control temp1, bit 3 temp2 and bit 5 temp3.
 
 Mozart-2:
-- sensor 1: register 0x27
-- sensor 2: register 0x13
+  - sensor 1: register 0x27
+  - sensor 2: register 0x13
 
-# Fan sensors:
+Fan sensors
+^^^^^^^^^^^
 
 ASB100, AS99127F (rev.1 and 2 alike):
-- 3 fans, identical to the W83781D
+  - 3 fans, identical to the W83781D
 
 Mozart-2:
-- 2 fans only, 1350000/RPM/div
-- fan 1: register 0x28,  divisor on register 0xA1 (bits 4-5)
-- fan 2: register 0x29,  divisor on register 0xA1 (bits 6-7)
+  - 2 fans only, 1350000/RPM/div
+  - fan 1: register 0x28,  divisor on register 0xA1 (bits 4-5)
+  - fan 2: register 0x29,  divisor on register 0xA1 (bits 6-7)
 
-# Voltages:
+Voltages
+^^^^^^^^
 
 This is where there is a difference between AS99127F rev.1 and 2.
-Remark: The difference is similar to the difference between
+
+Remark:
+
+  The difference is similar to the difference between
   W83781D and W83782D.
 
 ASB100:
-in0=r(0x20)*0.016
-in1=r(0x21)*0.016
-in2=r(0x22)*0.016
-in3=r(0x23)*0.016*1.68
-in4=r(0x24)*0.016*3.8
-in5=r(0x25)*(-0.016)*3.97
-in6=r(0x26)*(-0.016)*1.666
+  - in0=r(0x20)*0.016
+  - in1=r(0x21)*0.016
+  - in2=r(0x22)*0.016
+  - in3=r(0x23)*0.016*1.68
+  - in4=r(0x24)*0.016*3.8
+  - in5=r(0x25)*(-0.016)*3.97
+  - in6=r(0x26)*(-0.016)*1.666
 
 AS99127F rev.1:
-in0=r(0x20)*0.016
-in1=r(0x21)*0.016
-in2=r(0x22)*0.016
-in3=r(0x23)*0.016*1.68
-in4=r(0x24)*0.016*3.8
-in5=r(0x25)*(-0.016)*3.97
-in6=r(0x26)*(-0.016)*1.503
+  - in0=r(0x20)*0.016
+  - in1=r(0x21)*0.016
+  - in2=r(0x22)*0.016
+  - in3=r(0x23)*0.016*1.68
+  - in4=r(0x24)*0.016*3.8
+  - in5=r(0x25)*(-0.016)*3.97
+  - in6=r(0x26)*(-0.016)*1.503
 
 AS99127F rev.2:
-in0=r(0x20)*0.016
-in1=r(0x21)*0.016
-in2=r(0x22)*0.016
-in3=r(0x23)*0.016*1.68
-in4=r(0x24)*0.016*3.8
-in5=(r(0x25)*0.016-3.6)*5.14+3.6
-in6=(r(0x26)*0.016-3.6)*3.14+3.6
+  - in0=r(0x20)*0.016
+  - in1=r(0x21)*0.016
+  - in2=r(0x22)*0.016
+  - in3=r(0x23)*0.016*1.68
+  - in4=r(0x24)*0.016*3.8
+  - in5=(r(0x25)*0.016-3.6)*5.14+3.6
+  - in6=(r(0x26)*0.016-3.6)*3.14+3.6
 
 Mozart-2:
-in0=r(0x20)*0.016
-in1=255
-in2=r(0x22)*0.016
-in3=r(0x23)*0.016*1.68
-in4=r(0x24)*0.016*4
-in5=255
-in6=255
+  - in0=r(0x20)*0.016
+  - in1=255
+  - in2=r(0x22)*0.016
+  - in3=r(0x23)*0.016*1.68
+  - in4=r(0x24)*0.016*4
+  - in5=255
+  - in6=255
 
 
-# PWM
+PWM
+^^^
 
 * Additional info about PWM on the AS99127F (may apply to other Asus
-chips as well) by Jean Delvare as of 2004-04-09:
+  chips as well) by Jean Delvare as of 2004-04-09:
 
 AS99127F revision 2 seems to have two PWM registers at 0x59 and 0x5A,
 and a temperature sensor type selector at 0x5B (which basically means
@@ -401,15 +454,20 @@ AS99127F chips at all.
 I've been fiddling around with the (in)famous 0x59 register and
 found out the following values do work as a form of coarse pwm:
 
-0x80 - seems to turn fans off after some time(1-2 minutes)... might be
-some form of auto-fan-control based on temp? hmm (Qfan? this mobo is an
-old ASUS, it isn't marketed as Qfan. Maybe some beta pre-attempt at Qfan
-that was dropped at the BIOS)
-0x81 - off
-0x82 - slightly "on-ner" than off, but my fans do not get to move. I can
-hear the high-pitched PWM sound that motors give off at too-low-pwm.
-0x83 - now they do move. Estimate about 70% speed or so.
-0x84-0x8f - full on
+0x80
+ - seems to turn fans off after some time(1-2 minutes)... might be
+   some form of auto-fan-control based on temp? hmm (Qfan? this mobo is an
+   old ASUS, it isn't marketed as Qfan. Maybe some beta pre-attempt at Qfan
+   that was dropped at the BIOS)
+0x81
+ - off
+0x82
+ - slightly "on-ner" than off, but my fans do not get to move. I can
+   hear the high-pitched PWM sound that motors give off at too-low-pwm.
+0x83
+ - now they do move. Estimate about 70% speed or so.
+0x84-0x8f
+ - full on
 
 Changing the high nibble doesn't seem to do much except the high bit
 (0x80) must be set for PWM to work, else the current pwm doesn't seem to
@@ -435,6 +493,7 @@ looks like PWM is filtered on this motherboard.
 
 Here are some of measurements:
 
+==== =========
 0x80     20 mV
 0x81     20 mV
 0x82    232 mV
@@ -451,3 +510,4 @@ Here are some of measurements:
 0x8d  12.4  V
 0x8e  12.4  V
 0x8f  12.4  V
+==== =========
diff --git a/Documentation/hwmon/w83792d b/Documentation/hwmon/w83792d
index f2ffc402ea45..92c4bfe4968c 100644
--- a/Documentation/hwmon/w83792d
+++ b/Documentation/hwmon/w83792d
@@ -2,9 +2,13 @@ Kernel driver w83792d
 =====================
 
 Supported chips:
+
   * Winbond W83792D
+
     Prefix: 'w83792d'
+
     Addresses scanned: I2C 0x2c - 0x2f
+
     Datasheet: http://www.winbond.com.tw
 
 Author: Shane Huang (Winbond)
@@ -15,15 +19,16 @@ Module Parameters
 -----------------
 
 * init int
-  (default 1)
-  Use 'init=0' to bypass initializing the chip.
-  Try this if your computer crashes when you load the module.
+    (default 1)
+
+    Use 'init=0' to bypass initializing the chip.
+    Try this if your computer crashes when you load the module.
 
 * force_subclients=bus,caddr,saddr,saddr
-  This is used to force the i2c addresses for subclients of
-  a certain chip. Example usage is `force_subclients=0,0x2f,0x4a,0x4b'
-  to force the subclients of chip 0x2f on bus 0 to i2c addresses
-  0x4a and 0x4b.
+    This is used to force the i2c addresses for subclients of
+    a certain chip. Example usage is `force_subclients=0,0x2f,0x4a,0x4b`
+    to force the subclients of chip 0x2f on bus 0 to i2c addresses
+    0x4a and 0x4b.
 
 
 Description
@@ -67,31 +72,34 @@ or maximum limit.
 Alarms are provided as output from "realtime status register". Following bits
 are defined:
 
-bit - alarm on:
-0  - in0
-1  - in1
-2  - temp1
-3  - temp2
-4  - temp3
-5  - fan1
-6  - fan2
-7  - fan3
-8  - in2
-9  - in3
-10 - in4
-11 - in5
-12 - in6
-13 - VID change
-14 - chassis
-15 - fan7
-16 - tart1
-17 - tart2
-18 - tart3
-19 - in7
-20 - in8
-21 - fan4
-22 - fan5
-23 - fan6
+==== ==========
+bit   alarm on
+==== ==========
+0    in0
+1    in1
+2    temp1
+3    temp2
+4    temp3
+5    fan1
+6    fan2
+7    fan3
+8    in2
+9    in3
+10   in4
+11   in5
+12   in6
+13   VID change
+14   chassis
+15   fan7
+16   tart1
+17   tart2
+18   tart3
+19   in7
+20   in8
+21   fan4
+22   fan5
+23   fan6
+==== ==========
 
 Tart will be asserted while target temperature cannot be achieved after 3 minutes
 of full speed rotation of corresponding fan.
@@ -114,7 +122,7 @@ Known problems:
 	  by CR[0x49h].
 	- The function of vid and vrm has not been finished, because I'm NOT
 	  very familiar with them. Adding support is welcome.
- 	- The function of chassis open detection needs more tests.
+	- The function of chassis open detection needs more tests.
 	- If you have ASUS server board and chip was not found: Then you will
 	  need to upgrade to latest (or beta) BIOS. If it does not help please
 	  contact us.
@@ -165,17 +173,27 @@ for each fan.
 /sys files
 ----------
 
-pwm[1-7] - this file stores PWM duty cycle or DC value (fan speed) in range:
-	0 (stop) to 255 (full)
-pwm[1-3]_enable - this file controls mode of fan/temperature control:
-            * 0 Disabled
-            * 1 Manual mode
-            * 2 Smart Fan II
-            * 3 Thermal Cruise
-pwm[1-7]_mode - Select PWM or DC mode
-            * 0 DC
-            * 1 PWM
-thermal_cruise[1-3] - Selects the desired temperature for cruise (degC)
-tolerance[1-3] - Value in degrees of Celsius (degC) for +- T
-sf2_point[1-4]_fan[1-3] - four temperature points for each fan for Smart Fan II
-sf2_level[1-3]_fan[1-3] - three PWM/DC levels for each fan for Smart Fan II
+pwm[1-7]
+	- this file stores PWM duty cycle or DC value (fan speed) in range:
+
+	    0 (stop) to 255 (full)
+pwm[1-3]_enable
+	- this file controls mode of fan/temperature control:
+
+	    * 0 Disabled
+	    * 1 Manual mode
+	    * 2 Smart Fan II
+	    * 3 Thermal Cruise
+pwm[1-7]_mode
+	- Select PWM or DC mode
+
+	    * 0 DC
+	    * 1 PWM
+thermal_cruise[1-3]
+	- Selects the desired temperature for cruise (degC)
+tolerance[1-3]
+	- Value in degrees of Celsius (degC) for +- T
+sf2_point[1-4]_fan[1-3]
+	- four temperature points for each fan for Smart Fan II
+sf2_level[1-3]_fan[1-3]
+	- three PWM/DC levels for each fan for Smart Fan II
diff --git a/Documentation/hwmon/w83795 b/Documentation/hwmon/w83795
index d3e678216b9a..d0615e2fabb9 100644
--- a/Documentation/hwmon/w83795
+++ b/Documentation/hwmon/w83795
@@ -2,18 +2,26 @@ Kernel driver w83795
 ====================
 
 Supported chips:
+
   * Winbond/Nuvoton W83795G
+
     Prefix: 'w83795g'
+
     Addresses scanned: I2C 0x2c - 0x2f
+
     Datasheet: Available for download on nuvoton.com
+
   * Winbond/Nuvoton W83795ADG
+
     Prefix: 'w83795adg'
+
     Addresses scanned: I2C 0x2c - 0x2f
+
     Datasheet: Available for download on nuvoton.com
 
 Authors:
-    Wei Song (Nuvoton)
-    Jean Delvare <jdelvare@suse.de>
+    - Wei Song (Nuvoton)
+    - Jean Delvare <jdelvare@suse.de>
 
 
 Pin mapping
@@ -23,105 +31,112 @@ Here is a summary of the pin mapping for the W83795G and W83795ADG.
 This can be useful to convert data provided by board manufacturers
 into working libsensors configuration statements.
 
-    W83795G			|
-  Pin	| Name			| Register	| Sysfs attribute
-------------------------------------------------------------------
-   13	| VSEN1 (VCORE1)	| 10h		| in0
-   14	| VSEN2 (VCORE2)	| 11h		| in1
-   15	| VSEN3 (VCORE3)	| 12h		| in2
-   16	| VSEN4			| 13h		| in3
-   17	| VSEN5			| 14h		| in4
-   18	| VSEN6			| 15h		| in5
-   19	| VSEN7			| 16h		| in6
-   20	| VSEN8			| 17h		| in7
-   21	| VSEN9			| 18h		| in8
-   22	| VSEN10		| 19h		| in9
-   23	| VSEN11		| 1Ah		| in10
-   28	| VTT			| 1Bh		| in11
-   24	| 3VDD			| 1Ch		| in12
-   25	| 3VSB			| 1Dh		| in13
-   26	| VBAT			| 1Eh		| in14
-    3	| VSEN12/TR5		| 1Fh		| in15/temp5
-    4	| VSEN13/TR5		| 20h		| in16/temp6
-  5/  6	| VDSEN14/TR1/TD1	| 21h		| in17/temp1
-  7/  8	| VDSEN15/TR2/TD2	| 22h		| in18/temp2
-  9/ 10	| VDSEN16/TR3/TD3	| 23h		| in19/temp3
- 11/ 12	| VDSEN17/TR4/TD4	| 24h		| in20/temp4
-   40	| FANIN1		| 2Eh		| fan1
-   42	| FANIN2		| 2Fh		| fan2
-   44	| FANIN3		| 30h		| fan3
-   46	| FANIN4		| 31h		| fan4
-   48	| FANIN5		| 32h		| fan5
-   50	| FANIN6		| 33h		| fan6
-   52	| FANIN7		| 34h		| fan7
-   54	| FANIN8		| 35h		| fan8
-   57	| FANIN9		| 36h		| fan9
-   58	| FANIN10		| 37h		| fan10
-   59	| FANIN11		| 38h		| fan11
-   60	| FANIN12		| 39h		| fan12
-   31	| FANIN13		| 3Ah		| fan13
-   35	| FANIN14		| 3Bh		| fan14
-   41	| FANCTL1		| 10h (bank 2)	| pwm1
-   43	| FANCTL2		| 11h (bank 2)	| pwm2
-   45	| FANCTL3		| 12h (bank 2)	| pwm3
-   47	| FANCTL4		| 13h (bank 2)	| pwm4
-   49	| FANCTL5		| 14h (bank 2)	| pwm5
-   51	| FANCTL6		| 15h (bank 2)	| pwm6
-   53	| FANCTL7		| 16h (bank 2)	| pwm7
-   55	| FANCTL8		| 17h (bank 2)	| pwm8
- 29/ 30	| PECI/TSI (DTS1)	| 26h		| temp7
- 29/ 30	| PECI/TSI (DTS2)	| 27h		| temp8
- 29/ 30	| PECI/TSI (DTS3)	| 28h		| temp9
- 29/ 30	| PECI/TSI (DTS4)	| 29h		| temp10
- 29/ 30	| PECI/TSI (DTS5)	| 2Ah		| temp11
- 29/ 30	| PECI/TSI (DTS6)	| 2Bh		| temp12
- 29/ 30	| PECI/TSI (DTS7)	| 2Ch		| temp13
- 29/ 30	| PECI/TSI (DTS8)	| 2Dh		| temp14
-   27	| CASEOPEN#		| 46h		| intrusion0
 
-    W83795ADG			|
-  Pin	| Name			| Register	| Sysfs attribute
-------------------------------------------------------------------
-   10	| VSEN1 (VCORE1)	| 10h		| in0
-   11	| VSEN2 (VCORE2)	| 11h		| in1
-   12	| VSEN3 (VCORE3)	| 12h		| in2
-   13	| VSEN4			| 13h		| in3
-   14	| VSEN5			| 14h		| in4
-   15	| VSEN6			| 15h		| in5
-   16	| VSEN7			| 16h		| in6
-   17	| VSEN8			| 17h		| in7
-   22	| VTT			| 1Bh		| in11
-   18	| 3VDD			| 1Ch		| in12
-   19	| 3VSB			| 1Dh		| in13
-   20	| VBAT			| 1Eh		| in14
-   48	| VSEN12/TR5		| 1Fh		| in15/temp5
-    1	| VSEN13/TR5		| 20h		| in16/temp6
-  2/  3	| VDSEN14/TR1/TD1	| 21h		| in17/temp1
-  4/  5	| VDSEN15/TR2/TD2	| 22h		| in18/temp2
-  6/  7	| VDSEN16/TR3/TD3	| 23h		| in19/temp3
-  8/  9	| VDSEN17/TR4/TD4	| 24h		| in20/temp4
-   32	| FANIN1		| 2Eh		| fan1
-   34	| FANIN2		| 2Fh		| fan2
-   36	| FANIN3		| 30h		| fan3
-   37	| FANIN4		| 31h		| fan4
-   38	| FANIN5		| 32h		| fan5
-   39	| FANIN6		| 33h		| fan6
-   40	| FANIN7		| 34h		| fan7
-   41	| FANIN8		| 35h		| fan8
-   43	| FANIN9		| 36h		| fan9
-   44	| FANIN10		| 37h		| fan10
-   45	| FANIN11		| 38h		| fan11
-   46	| FANIN12		| 39h		| fan12
-   24	| FANIN13		| 3Ah		| fan13
-   28	| FANIN14		| 3Bh		| fan14
-   33	| FANCTL1		| 10h (bank 2)	| pwm1
-   35	| FANCTL2		| 11h (bank 2)	| pwm2
-   23	| PECI (DTS1)		| 26h		| temp7
-   23	| PECI (DTS2)		| 27h		| temp8
-   23	| PECI (DTS3)		| 28h		| temp9
-   23	| PECI (DTS4)		| 29h		| temp10
-   23	| PECI (DTS5)		| 2Ah		| temp11
-   23	| PECI (DTS6)		| 2Bh		| temp12
-   23	| PECI (DTS7)		| 2Ch		| temp13
-   23	| PECI (DTS8)		| 2Dh		| temp14
-   21	| CASEOPEN#		| 46h		| intrusion0
+- W83795G
+
+========= ======================= =============== ================
+Pin	  Name			  Register	  Sysfs attribute
+========= ======================= =============== ================
+   13	  VSEN1 (VCORE1)	  10h		  in0
+   14	  VSEN2 (VCORE2)	  11h		  in1
+   15	  VSEN3 (VCORE3)	  12h		  in2
+   16	  VSEN4			  13h		  in3
+   17	  VSEN5			  14h		  in4
+   18	  VSEN6			  15h		  in5
+   19	  VSEN7			  16h		  in6
+   20	  VSEN8			  17h		  in7
+   21	  VSEN9			  18h		  in8
+   22	  VSEN10		  19h		  in9
+   23	  VSEN11		  1Ah		  in10
+   28	  VTT			  1Bh		  in11
+   24	  3VDD			  1Ch		  in12
+   25	  3VSB			  1Dh		  in13
+   26	  VBAT			  1Eh		  in14
+    3	  VSEN12/TR5		  1Fh		  in15/temp5
+    4	  VSEN13/TR5		  20h		  in16/temp6
+  5/  6	  VDSEN14/TR1/TD1	  21h		  in17/temp1
+  7/  8	  VDSEN15/TR2/TD2	  22h		  in18/temp2
+  9/ 10	  VDSEN16/TR3/TD3	  23h		  in19/temp3
+ 11/ 12	  VDSEN17/TR4/TD4	  24h		  in20/temp4
+   40	  FANIN1		  2Eh		  fan1
+   42	  FANIN2		  2Fh		  fan2
+   44	  FANIN3		  30h		  fan3
+   46	  FANIN4		  31h		  fan4
+   48	  FANIN5		  32h		  fan5
+   50	  FANIN6		  33h		  fan6
+   52	  FANIN7		  34h		  fan7
+   54	  FANIN8		  35h		  fan8
+   57	  FANIN9		  36h		  fan9
+   58	  FANIN10		  37h		  fan10
+   59	  FANIN11		  38h		  fan11
+   60	  FANIN12		  39h		  fan12
+   31	  FANIN13		  3Ah		  fan13
+   35	  FANIN14		  3Bh		  fan14
+   41	  FANCTL1		  10h (bank 2)	  pwm1
+   43	  FANCTL2		  11h (bank 2)	  pwm2
+   45	  FANCTL3		  12h (bank 2)	  pwm3
+   47	  FANCTL4		  13h (bank 2)	  pwm4
+   49	  FANCTL5		  14h (bank 2)	  pwm5
+   51	  FANCTL6		  15h (bank 2)	  pwm6
+   53	  FANCTL7		  16h (bank 2)	  pwm7
+   55	  FANCTL8		  17h (bank 2)	  pwm8
+ 29/ 30	  PECI/TSI (DTS1)	  26h		  temp7
+ 29/ 30	  PECI/TSI (DTS2)	  27h		  temp8
+ 29/ 30	  PECI/TSI (DTS3)	  28h		  temp9
+ 29/ 30	  PECI/TSI (DTS4)	  29h		  temp10
+ 29/ 30	  PECI/TSI (DTS5)	  2Ah		  temp11
+ 29/ 30	  PECI/TSI (DTS6)	  2Bh		  temp12
+ 29/ 30	  PECI/TSI (DTS7)	  2Ch		  temp13
+ 29/ 30	  PECI/TSI (DTS8)	  2Dh		  temp14
+   27	  CASEOPEN#		  46h		  intrusion0
+========= ======================= =============== ================
+
+- W83795ADG
+
+========= ======================= =============== ================
+Pin	  Name			  Register	  Sysfs attribute
+========= ======================= =============== ================
+   10	  VSEN1 (VCORE1)	  10h		  in0
+   11	  VSEN2 (VCORE2)	  11h		  in1
+   12	  VSEN3 (VCORE3)	  12h		  in2
+   13	  VSEN4			  13h		  in3
+   14	  VSEN5			  14h		  in4
+   15	  VSEN6			  15h		  in5
+   16	  VSEN7			  16h		  in6
+   17	  VSEN8			  17h		  in7
+   22	  VTT			  1Bh		  in11
+   18	  3VDD			  1Ch		  in12
+   19	  3VSB			  1Dh		  in13
+   20	  VBAT			  1Eh		  in14
+   48	  VSEN12/TR5		  1Fh		  in15/temp5
+    1	  VSEN13/TR5		  20h		  in16/temp6
+  2/  3	  VDSEN14/TR1/TD1	  21h		  in17/temp1
+  4/  5	  VDSEN15/TR2/TD2	  22h		  in18/temp2
+  6/  7	  VDSEN16/TR3/TD3	  23h		  in19/temp3
+  8/  9	  VDSEN17/TR4/TD4	  24h		  in20/temp4
+   32	  FANIN1		  2Eh		  fan1
+   34	  FANIN2		  2Fh		  fan2
+   36	  FANIN3		  30h		  fan3
+   37	  FANIN4		  31h		  fan4
+   38	  FANIN5		  32h		  fan5
+   39	  FANIN6		  33h		  fan6
+   40	  FANIN7		  34h		  fan7
+   41	  FANIN8		  35h		  fan8
+   43	  FANIN9		  36h		  fan9
+   44	  FANIN10		  37h		  fan10
+   45	  FANIN11		  38h		  fan11
+   46	  FANIN12		  39h		  fan12
+   24	  FANIN13		  3Ah		  fan13
+   28	  FANIN14		  3Bh		  fan14
+   33	  FANCTL1		  10h (bank 2)	  pwm1
+   35	  FANCTL2		  11h (bank 2)	  pwm2
+   23	  PECI (DTS1)		  26h		  temp7
+   23	  PECI (DTS2)		  27h		  temp8
+   23	  PECI (DTS3)		  28h		  temp9
+   23	  PECI (DTS4)		  29h		  temp10
+   23	  PECI (DTS5)		  2Ah		  temp11
+   23	  PECI (DTS6)		  2Bh		  temp12
+   23	  PECI (DTS7)		  2Ch		  temp13
+   23	  PECI (DTS8)		  2Dh		  temp14
+   21	  CASEOPEN#		  46h		  intrusion0
+========= ======================= =============== ================
diff --git a/Documentation/hwmon/w83l785ts b/Documentation/hwmon/w83l785ts
index c8978478871f..7fa5418fed11 100644
--- a/Documentation/hwmon/w83l785ts
+++ b/Documentation/hwmon/w83l785ts
@@ -2,14 +2,19 @@ Kernel driver w83l785ts
 =======================
 
 Supported chips:
+
   * Winbond W83L785TS-S
+
     Prefix: 'w83l785ts'
+
     Addresses scanned: I2C 0x2e
+
     Datasheet: Publicly available at the Winbond USA website
-               http://www.winbond-usa.com/products/winbond_products/pdfs/PCIC/W83L785TS-S.pdf
+
+	       http://www.winbond-usa.com/products/winbond_products/pdfs/PCIC/W83L785TS-S.pdf
 
 Authors:
-        Jean Delvare <jdelvare@suse.de>
+	Jean Delvare <jdelvare@suse.de>
 
 Description
 -----------
diff --git a/Documentation/hwmon/w83l786ng b/Documentation/hwmon/w83l786ng
index d8f55d7fff10..2b7776190de3 100644
--- a/Documentation/hwmon/w83l786ng
+++ b/Documentation/hwmon/w83l786ng
@@ -1,10 +1,14 @@
 Kernel driver w83l786ng
-=====================
+=======================
 
 Supported chips:
+
   * Winbond W83L786NG/W83L786NR
+
     Prefix: 'w83l786ng'
+
     Addresses scanned: I2C 0x2e - 0x2f
+
     Datasheet: http://www.winbond-usa.com/products/winbond_products/pdfs/PCIC/W83L786NRNG09.pdf
 
 Author: Kevin Lo <kevlo@kevlo.org>
@@ -14,9 +18,10 @@ Module Parameters
 -----------------
 
 * reset boolean
-  (default 0)
-  Use 'reset=1' to reset the chip (via index 0x40, bit 7). The default
-  behavior is no chip reset to preserve BIOS settings
+    (default 0)
+
+    Use 'reset=1' to reset the chip (via index 0x40, bit 7). The default
+    behavior is no chip reset to preserve BIOS settings
 
 
 Description
@@ -41,14 +46,21 @@ or maximum limit.
 /sys files
 ----------
 
-pwm[1-2] - this file stores PWM duty cycle or DC value (fan speed) in range:
-	    0 (stop) to 255 (full)
-pwm[1-2]_enable - this file controls mode of fan/temperature control:
-            * 0 Manual Mode
-            * 1 Thermal Cruise
-            * 2 Smart Fan II
-            * 4 FAN_SET
-pwm[1-2]_mode - Select PWM of DC mode
-            * 0 DC
-            * 1 PWM
-tolerance[1-2] - Value in degrees of Celsius (degC) for +- T
+pwm[1-2]
+	    - this file stores PWM duty cycle or DC value (fan speed) in range:
+
+	      0 (stop) to 255 (full)
+pwm[1-2]_enable
+	    - this file controls mode of fan/temperature control:
+
+	    * 0 Manual Mode
+	    * 1 Thermal Cruise
+	    * 2 Smart Fan II
+	    * 4 FAN_SET
+pwm[1-2]_mode
+	    - Select PWM of DC mode
+
+	    * 0 DC
+	    * 1 PWM
+tolerance[1-2]
+	    - Value in degrees of Celsius (degC) for +- T
diff --git a/Documentation/hwmon/xgene-hwmon b/Documentation/hwmon/xgene-hwmon
index 6ec50ed7cc8f..439b30b881b6 100644
--- a/Documentation/hwmon/xgene-hwmon
+++ b/Documentation/hwmon/xgene-hwmon
@@ -1,7 +1,8 @@
 Kernel driver xgene-hwmon
-========================
+=========================
 
 Supported chips:
+
  * APM X-Gene SoC
 
 Description
@@ -15,16 +16,21 @@ For ACPI, it is the PCC mailbox.
 The following sensors are supported
 
   * Temperature
-    - SoC on-die temperature in milli-degree C
-    - Alarm when high/over temperature occurs
+      - SoC on-die temperature in milli-degree C
+      - Alarm when high/over temperature occurs
+
   * Power
-    - CPU power in uW
-    - IO power in uW
+      - CPU power in uW
+      - IO power in uW
 
 sysfs-Interface
 ---------------
 
-temp0_input - SoC on-die temperature (milli-degree C)
-temp0_critical_alarm - An 1 would indicates on-die temperature exceeded threshold
-power0_input - CPU power in (uW)
-power1_input - IO power in (uW)
+temp0_input
+	- SoC on-die temperature (milli-degree C)
+temp0_critical_alarm
+	- An 1 would indicates on-die temperature exceeded threshold
+power0_input
+	- CPU power in (uW)
+power1_input
+	- IO power in (uW)
-- 
2.20.1


^ permalink raw reply related	[flat|nested] 73+ messages in thread

* [PATCH v3 21/21] docs: hwmon: Add an index file and rename docs to *.rst
  2019-04-17  9:46                   ` [PATCH v3 00/21]Convert " Mauro Carvalho Chehab
                                       ` (19 preceding siblings ...)
  2019-04-17  9:46                     ` [PATCH v3 20/21] docs: hwmon: convert remaining files " Mauro Carvalho Chehab
@ 2019-04-17  9:46                     ` Mauro Carvalho Chehab
  2019-04-17 11:31                       ` Liviu Dudau
  2019-04-17 16:47                       ` Guenter Roeck
  20 siblings, 2 replies; 73+ messages in thread
From: Mauro Carvalho Chehab @ 2019-04-17  9:46 UTC (permalink / raw)
  To: Linux Doc Mailing List
  Cc: Mauro Carvalho Chehab, Mauro Carvalho Chehab, linux-kernel,
	Jonathan Corbet, Jean Delvare, Guenter Roeck, Rob Herring,
	Mark Rutland, Dirk Eibach, George Joseph, Joel Stanley,
	Andrew Jeffery, Fenghua Yu, Support Opensource, Juerg Haefliger,
	Steve Glendinning, Huang Rui, Benjamin Herrenschmidt,
	Paul Mackerras, Michael Ellerman, Clemens Ladisch, Rudolf Marek,
	Andreas Werner, Jim Cromie, Kamil Debski,
	Bartlomiej Zolnierkiewicz, Hans de Goede, Liviu Dudau,
	Sudeep Holla, Lorenzo Pieralisi, Marc Hulsman, linux-hwmon,
	devicetree, linux-arm-kernel, linux-aspeed, linuxppc-dev,
	patches

Now that all files were converted to ReST format, rename them
and add an index.

Signed-off-by: Mauro Carvalho Chehab <mchehab+samsung@kernel.org>
---
 .../devicetree/bindings/hwmon/g762.txt        |   2 +-
 Documentation/hwmon/{ab8500 => ab8500.rst}    |   2 +-
 ...guru-datasheet => abituguru-datasheet.rst} |   0
 .../hwmon/{abituguru => abituguru.rst}        |   0
 .../hwmon/{abituguru3 => abituguru3.rst}      |   0
 Documentation/hwmon/{abx500 => abx500.rst}    |   0
 ...{acpi_power_meter => acpi_power_meter.rst} |   2 +-
 Documentation/hwmon/{ad7314 => ad7314.rst}    |   0
 .../hwmon/{adc128d818 => adc128d818.rst}      |   0
 Documentation/hwmon/{adm1021 => adm1021.rst}  |   0
 Documentation/hwmon/{adm1025 => adm1025.rst}  |   0
 Documentation/hwmon/{adm1026 => adm1026.rst}  |   0
 Documentation/hwmon/{adm1031 => adm1031.rst}  |   0
 Documentation/hwmon/{adm1275 => adm1275.rst}  |   4 +-
 Documentation/hwmon/{adm9240 => adm9240.rst}  |   0
 Documentation/hwmon/{ads1015 => ads1015.rst}  |   0
 Documentation/hwmon/{ads7828 => ads7828.rst}  |   0
 Documentation/hwmon/{adt7410 => adt7410.rst}  |   0
 Documentation/hwmon/{adt7411 => adt7411.rst}  |   0
 Documentation/hwmon/{adt7462 => adt7462.rst}  |   1 -
 Documentation/hwmon/{adt7470 => adt7470.rst}  |   0
 Documentation/hwmon/{adt7475 => adt7475.rst}  |   0
 Documentation/hwmon/{amc6821 => amc6821.rst}  |   1 -
 Documentation/hwmon/{asb100 => asb100.rst}    |   1 -
 Documentation/hwmon/{asc7621 => asc7621.rst}  |   0
 ...{aspeed-pwm-tacho => aspeed-pwm-tacho.rst} |   0
 .../hwmon/{coretemp => coretemp.rst}          |   0
 Documentation/hwmon/{da9052 => da9052.rst}    |   0
 Documentation/hwmon/{da9055 => da9055.rst}    |   0
 Documentation/hwmon/{dme1737 => dme1737.rst}  |   0
 Documentation/hwmon/{ds1621 => ds1621.rst}    |   0
 Documentation/hwmon/{ds620 => ds620.rst}      |   0
 Documentation/hwmon/{emc1403 => emc1403.rst}  |   0
 Documentation/hwmon/{emc2103 => emc2103.rst}  |   0
 .../hwmon/{emc6w201 => emc6w201.rst}          |   0
 Documentation/hwmon/{f71805f => f71805f.rst}  |   0
 .../hwmon/{f71882fg => f71882fg.rst}          |   0
 .../hwmon/{fam15h_power => fam15h_power.rst}  |   0
 .../hwmon/{ftsteutates => ftsteutates.rst}    |   0
 Documentation/hwmon/{g760a => g760a.rst}      |   0
 Documentation/hwmon/{g762 => g762.rst}        |   2 +-
 Documentation/hwmon/{gl518sm => gl518sm.rst}  |   0
 Documentation/hwmon/{hih6130 => hih6130.rst}  |   0
 ...on-kernel-api.txt => hwmon-kernel-api.rst} |   4 +-
 .../hwmon/{ibm-cffps => ibm-cffps.rst}        |   0
 Documentation/hwmon/{ibmaem => ibmaem.rst}    |   0
 .../hwmon/{ibmpowernv => ibmpowernv.rst}      |   0
 Documentation/hwmon/{ina209 => ina209.rst}    |   0
 Documentation/hwmon/{ina2xx => ina2xx.rst}    |   2 +-
 Documentation/hwmon/{ina3221 => ina3221.rst}  |   0
 Documentation/hwmon/index.rst                 | 179 ++++++++++++++++++
 Documentation/hwmon/{ir35221 => ir35221.rst}  |   0
 Documentation/hwmon/{it87 => it87.rst}        |   0
 Documentation/hwmon/{jc42 => jc42.rst}        |   0
 Documentation/hwmon/{k10temp => k10temp.rst}  |   0
 Documentation/hwmon/{k8temp => k8temp.rst}    |   0
 .../hwmon/{lineage-pem => lineage-pem.rst}    |   0
 Documentation/hwmon/{lm25066 => lm25066.rst}  |   2 +-
 Documentation/hwmon/{lm63 => lm63.rst}        |   0
 Documentation/hwmon/{lm70 => lm70.rst}        |   0
 Documentation/hwmon/{lm73 => lm73.rst}        |   0
 Documentation/hwmon/{lm75 => lm75.rst}        |   0
 Documentation/hwmon/{lm77 => lm77.rst}        |   0
 Documentation/hwmon/{lm78 => lm78.rst}        |   0
 Documentation/hwmon/{lm80 => lm80.rst}        |   0
 Documentation/hwmon/{lm83 => lm83.rst}        |   0
 Documentation/hwmon/{lm85 => lm85.rst}        |   0
 Documentation/hwmon/{lm87 => lm87.rst}        |   0
 Documentation/hwmon/{lm90 => lm90.rst}        |   0
 Documentation/hwmon/{lm92 => lm92.rst}        |   0
 Documentation/hwmon/{lm93 => lm93.rst}        |   0
 Documentation/hwmon/{lm95234 => lm95234.rst}  |   0
 Documentation/hwmon/{lm95245 => lm95245.rst}  |   0
 Documentation/hwmon/{ltc2945 => ltc2945.rst}  |   0
 Documentation/hwmon/{ltc2978 => ltc2978.rst}  |   0
 Documentation/hwmon/{ltc2990 => ltc2990.rst}  |   0
 Documentation/hwmon/{ltc3815 => ltc3815.rst}  |   0
 Documentation/hwmon/{ltc4151 => ltc4151.rst}  |   0
 Documentation/hwmon/{ltc4215 => ltc4215.rst}  |   0
 Documentation/hwmon/{ltc4245 => ltc4245.rst}  |   0
 Documentation/hwmon/{ltc4260 => ltc4260.rst}  |   0
 Documentation/hwmon/{ltc4261 => ltc4261.rst}  |   0
 .../hwmon/{max16064 => max16064.rst}          |   2 +-
 .../hwmon/{max16065 => max16065.rst}          |   0
 Documentation/hwmon/{max1619 => max1619.rst}  |   1 -
 Documentation/hwmon/{max1668 => max1668.rst}  |   0
 Documentation/hwmon/{max197 => max197.rst}    |   0
 .../hwmon/{max20751 => max20751.rst}          |   2 +-
 .../hwmon/{max31722 => max31722.rst}          |   0
 .../hwmon/{max31785 => max31785.rst}          |   0
 .../hwmon/{max31790 => max31790.rst}          |   0
 .../hwmon/{max34440 => max34440.rst}          |   2 +-
 Documentation/hwmon/{max6639 => max6639.rst}  |   0
 Documentation/hwmon/{max6642 => max6642.rst}  |   0
 Documentation/hwmon/{max6650 => max6650.rst}  |   1 -
 Documentation/hwmon/{max6697 => max6697.rst}  |   0
 Documentation/hwmon/{max8688 => max8688.rst}  |   2 +-
 .../hwmon/{mc13783-adc => mc13783-adc.rst}    |   0
 Documentation/hwmon/{mcp3021 => mcp3021.rst}  |   0
 .../hwmon/{menf21bmc => menf21bmc.rst}        |   0
 .../hwmon/{mlxreg-fan => mlxreg-fan.rst}      |   0
 Documentation/hwmon/{nct6683 => nct6683.rst}  |   0
 Documentation/hwmon/{nct6775 => nct6775.rst}  |   0
 Documentation/hwmon/{nct7802 => nct7802.rst}  |   0
 Documentation/hwmon/{nct7904 => nct7904.rst}  |   0
 .../{npcm750-pwm-fan => npcm750-pwm-fan.rst}  |   0
 Documentation/hwmon/{nsa320 => nsa320.rst}    |   0
 .../{ntc_thermistor => ntc_thermistor.rst}    |   0
 Documentation/hwmon/{occ => occ.rst}          |   0
 Documentation/hwmon/{pc87360 => pc87360.rst}  |   0
 Documentation/hwmon/{pc87427 => pc87427.rst}  |   0
 Documentation/hwmon/{pcf8591 => pcf8591.rst}  |   0
 .../hwmon/{pmbus-core => pmbus-core.rst}      |   0
 Documentation/hwmon/{pmbus => pmbus.rst}      |   0
 .../hwmon/{powr1220 => powr1220.rst}          |   0
 Documentation/hwmon/{pwm-fan => pwm-fan.rst}  |   0
 ...aspberrypi-hwmon => raspberrypi-hwmon.rst} |   0
 Documentation/hwmon/{sch5627 => sch5627.rst}  |   0
 Documentation/hwmon/{sch5636 => sch5636.rst}  |   0
 .../hwmon/{scpi-hwmon => scpi-hwmon.rst}      |   0
 Documentation/hwmon/{sht15 => sht15.rst}      |   0
 Documentation/hwmon/{sht21 => sht21.rst}      |   0
 Documentation/hwmon/{sht3x => sht3x.rst}      |   0
 Documentation/hwmon/{shtc1 => shtc1.rst}      |   0
 Documentation/hwmon/{sis5595 => sis5595.rst}  |   1 -
 Documentation/hwmon/{smm665 => smm665.rst}    |   0
 .../hwmon/{smsc47b397 => smsc47b397.rst}      |   0
 .../hwmon/{smsc47m1 => smsc47m1.rst}          |   0
 .../hwmon/{smsc47m192 => smsc47m192.rst}      |   0
 ...mitting-patches => submitting-patches.rst} |   6 +-
 .../{sysfs-interface => sysfs-interface.rst}  |   0
 Documentation/hwmon/{tc654 => tc654.rst}      |   0
 Documentation/hwmon/{tc74 => tc74.rst}        |   0
 Documentation/hwmon/{thmc50 => thmc50.rst}    |   1 -
 Documentation/hwmon/{tmp102 => tmp102.rst}    |   2 +-
 Documentation/hwmon/{tmp103 => tmp103.rst}    |   2 +-
 Documentation/hwmon/{tmp108 => tmp108.rst}    |   2 +-
 Documentation/hwmon/{tmp401 => tmp401.rst}    |   2 +-
 Documentation/hwmon/{tmp421 => tmp421.rst}    |   0
 .../hwmon/{tps40422 => tps40422.rst}          |   2 +-
 ...4030-madc-hwmon => twl4030-madc-hwmon.rst} |   0
 Documentation/hwmon/{ucd9000 => ucd9000.rst}  |   4 +-
 Documentation/hwmon/{ucd9200 => ucd9200.rst}  |   4 +-
 .../{userspace-tools => userspace-tools.rst}  |   0
 .../hwmon/{vexpress => vexpress.rst}          |   0
 Documentation/hwmon/{via686a => via686a.rst}  |   0
 Documentation/hwmon/{vt1211 => vt1211.rst}    |   0
 .../hwmon/{w83627ehf => w83627ehf.rst}        |   0
 .../hwmon/{w83627hf => w83627hf.rst}          |   0
 Documentation/hwmon/{w83773g => w83773g.rst}  |   0
 Documentation/hwmon/{w83781d => w83781d.rst}  |   0
 Documentation/hwmon/{w83791d => w83791d.rst}  |   2 +-
 Documentation/hwmon/{w83792d => w83792d.rst}  |   0
 Documentation/hwmon/{w83793 => w83793.rst}    |   0
 Documentation/hwmon/{w83795 => w83795.rst}    |   0
 .../hwmon/{w83l785ts => w83l785ts.rst}        |   0
 .../hwmon/{w83l786ng => w83l786ng.rst}        |   0
 Documentation/hwmon/{wm831x => wm831x.rst}    |   0
 Documentation/hwmon/{wm8350 => wm8350.rst}    |   0
 .../hwmon/{xgene-hwmon => xgene-hwmon.rst}    |   0
 Documentation/hwmon/{zl6100 => zl6100.rst}    |   2 +-
 Documentation/index.rst                       |   1 +
 Documentation/thermal/sysfs-api.txt           |   2 +-
 MAINTAINERS                                   | 108 +++++------
 drivers/hwmon/Kconfig                         |   8 +-
 drivers/hwmon/ads7828.c                       |   2 +-
 drivers/hwmon/max197.c                        |   2 +-
 drivers/hwmon/sht15.c                         |   2 +-
 include/linux/platform_data/ads7828.h         |   2 +-
 include/linux/platform_data/ds620.h           |   2 +-
 include/linux/platform_data/ina2xx.h          |   2 +-
 include/linux/platform_data/max197.h          |   2 +-
 include/linux/platform_data/ntc_thermistor.h  |   2 +-
 173 files changed, 275 insertions(+), 102 deletions(-)
 rename Documentation/hwmon/{ab8500 => ab8500.rst} (86%)
 rename Documentation/hwmon/{abituguru-datasheet => abituguru-datasheet.rst} (100%)
 rename Documentation/hwmon/{abituguru => abituguru.rst} (100%)
 rename Documentation/hwmon/{abituguru3 => abituguru3.rst} (100%)
 rename Documentation/hwmon/{abx500 => abx500.rst} (100%)
 rename Documentation/hwmon/{acpi_power_meter => acpi_power_meter.rst} (97%)
 rename Documentation/hwmon/{ad7314 => ad7314.rst} (100%)
 rename Documentation/hwmon/{adc128d818 => adc128d818.rst} (100%)
 rename Documentation/hwmon/{adm1021 => adm1021.rst} (100%)
 rename Documentation/hwmon/{adm1025 => adm1025.rst} (100%)
 rename Documentation/hwmon/{adm1026 => adm1026.rst} (100%)
 rename Documentation/hwmon/{adm1031 => adm1031.rst} (100%)
 rename Documentation/hwmon/{adm1275 => adm1275.rst} (97%)
 rename Documentation/hwmon/{adm9240 => adm9240.rst} (100%)
 rename Documentation/hwmon/{ads1015 => ads1015.rst} (100%)
 rename Documentation/hwmon/{ads7828 => ads7828.rst} (100%)
 rename Documentation/hwmon/{adt7410 => adt7410.rst} (100%)
 rename Documentation/hwmon/{adt7411 => adt7411.rst} (100%)
 rename Documentation/hwmon/{adt7462 => adt7462.rst} (99%)
 rename Documentation/hwmon/{adt7470 => adt7470.rst} (100%)
 rename Documentation/hwmon/{adt7475 => adt7475.rst} (100%)
 rename Documentation/hwmon/{amc6821 => amc6821.rst} (99%)
 rename Documentation/hwmon/{asb100 => asb100.rst} (99%)
 rename Documentation/hwmon/{asc7621 => asc7621.rst} (100%)
 rename Documentation/hwmon/{aspeed-pwm-tacho => aspeed-pwm-tacho.rst} (100%)
 rename Documentation/hwmon/{coretemp => coretemp.rst} (100%)
 rename Documentation/hwmon/{da9052 => da9052.rst} (100%)
 rename Documentation/hwmon/{da9055 => da9055.rst} (100%)
 rename Documentation/hwmon/{dme1737 => dme1737.rst} (100%)
 rename Documentation/hwmon/{ds1621 => ds1621.rst} (100%)
 rename Documentation/hwmon/{ds620 => ds620.rst} (100%)
 rename Documentation/hwmon/{emc1403 => emc1403.rst} (100%)
 rename Documentation/hwmon/{emc2103 => emc2103.rst} (100%)
 rename Documentation/hwmon/{emc6w201 => emc6w201.rst} (100%)
 rename Documentation/hwmon/{f71805f => f71805f.rst} (100%)
 rename Documentation/hwmon/{f71882fg => f71882fg.rst} (100%)
 rename Documentation/hwmon/{fam15h_power => fam15h_power.rst} (100%)
 rename Documentation/hwmon/{ftsteutates => ftsteutates.rst} (100%)
 rename Documentation/hwmon/{g760a => g760a.rst} (100%)
 rename Documentation/hwmon/{g762 => g762.rst} (97%)
 rename Documentation/hwmon/{gl518sm => gl518sm.rst} (100%)
 rename Documentation/hwmon/{hih6130 => hih6130.rst} (100%)
 rename Documentation/hwmon/{hwmon-kernel-api.txt => hwmon-kernel-api.rst} (99%)
 rename Documentation/hwmon/{ibm-cffps => ibm-cffps.rst} (100%)
 rename Documentation/hwmon/{ibmaem => ibmaem.rst} (100%)
 rename Documentation/hwmon/{ibmpowernv => ibmpowernv.rst} (100%)
 rename Documentation/hwmon/{ina209 => ina209.rst} (100%)
 rename Documentation/hwmon/{ina2xx => ina2xx.rst} (97%)
 rename Documentation/hwmon/{ina3221 => ina3221.rst} (100%)
 create mode 100644 Documentation/hwmon/index.rst
 rename Documentation/hwmon/{ir35221 => ir35221.rst} (100%)
 rename Documentation/hwmon/{it87 => it87.rst} (100%)
 rename Documentation/hwmon/{jc42 => jc42.rst} (100%)
 rename Documentation/hwmon/{k10temp => k10temp.rst} (100%)
 rename Documentation/hwmon/{k8temp => k8temp.rst} (100%)
 rename Documentation/hwmon/{lineage-pem => lineage-pem.rst} (100%)
 rename Documentation/hwmon/{lm25066 => lm25066.rst} (97%)
 rename Documentation/hwmon/{lm63 => lm63.rst} (100%)
 rename Documentation/hwmon/{lm70 => lm70.rst} (100%)
 rename Documentation/hwmon/{lm73 => lm73.rst} (100%)
 rename Documentation/hwmon/{lm75 => lm75.rst} (100%)
 rename Documentation/hwmon/{lm77 => lm77.rst} (100%)
 rename Documentation/hwmon/{lm78 => lm78.rst} (100%)
 rename Documentation/hwmon/{lm80 => lm80.rst} (100%)
 rename Documentation/hwmon/{lm83 => lm83.rst} (100%)
 rename Documentation/hwmon/{lm85 => lm85.rst} (100%)
 rename Documentation/hwmon/{lm87 => lm87.rst} (100%)
 rename Documentation/hwmon/{lm90 => lm90.rst} (100%)
 rename Documentation/hwmon/{lm92 => lm92.rst} (100%)
 rename Documentation/hwmon/{lm93 => lm93.rst} (100%)
 rename Documentation/hwmon/{lm95234 => lm95234.rst} (100%)
 rename Documentation/hwmon/{lm95245 => lm95245.rst} (100%)
 rename Documentation/hwmon/{ltc2945 => ltc2945.rst} (100%)
 rename Documentation/hwmon/{ltc2978 => ltc2978.rst} (100%)
 rename Documentation/hwmon/{ltc2990 => ltc2990.rst} (100%)
 rename Documentation/hwmon/{ltc3815 => ltc3815.rst} (100%)
 rename Documentation/hwmon/{ltc4151 => ltc4151.rst} (100%)
 rename Documentation/hwmon/{ltc4215 => ltc4215.rst} (100%)
 rename Documentation/hwmon/{ltc4245 => ltc4245.rst} (100%)
 rename Documentation/hwmon/{ltc4260 => ltc4260.rst} (100%)
 rename Documentation/hwmon/{ltc4261 => ltc4261.rst} (100%)
 rename Documentation/hwmon/{max16064 => max16064.rst} (96%)
 rename Documentation/hwmon/{max16065 => max16065.rst} (100%)
 rename Documentation/hwmon/{max1619 => max1619.rst} (99%)
 rename Documentation/hwmon/{max1668 => max1668.rst} (100%)
 rename Documentation/hwmon/{max197 => max197.rst} (100%)
 rename Documentation/hwmon/{max20751 => max20751.rst} (96%)
 rename Documentation/hwmon/{max31722 => max31722.rst} (100%)
 rename Documentation/hwmon/{max31785 => max31785.rst} (100%)
 rename Documentation/hwmon/{max31790 => max31790.rst} (100%)
 rename Documentation/hwmon/{max34440 => max34440.rst} (98%)
 rename Documentation/hwmon/{max6639 => max6639.rst} (100%)
 rename Documentation/hwmon/{max6642 => max6642.rst} (100%)
 rename Documentation/hwmon/{max6650 => max6650.rst} (99%)
 rename Documentation/hwmon/{max6697 => max6697.rst} (100%)
 rename Documentation/hwmon/{max8688 => max8688.rst} (97%)
 rename Documentation/hwmon/{mc13783-adc => mc13783-adc.rst} (100%)
 rename Documentation/hwmon/{mcp3021 => mcp3021.rst} (100%)
 rename Documentation/hwmon/{menf21bmc => menf21bmc.rst} (100%)
 rename Documentation/hwmon/{mlxreg-fan => mlxreg-fan.rst} (100%)
 rename Documentation/hwmon/{nct6683 => nct6683.rst} (100%)
 rename Documentation/hwmon/{nct6775 => nct6775.rst} (100%)
 rename Documentation/hwmon/{nct7802 => nct7802.rst} (100%)
 rename Documentation/hwmon/{nct7904 => nct7904.rst} (100%)
 rename Documentation/hwmon/{npcm750-pwm-fan => npcm750-pwm-fan.rst} (100%)
 rename Documentation/hwmon/{nsa320 => nsa320.rst} (100%)
 rename Documentation/hwmon/{ntc_thermistor => ntc_thermistor.rst} (100%)
 rename Documentation/hwmon/{occ => occ.rst} (100%)
 rename Documentation/hwmon/{pc87360 => pc87360.rst} (100%)
 rename Documentation/hwmon/{pc87427 => pc87427.rst} (100%)
 rename Documentation/hwmon/{pcf8591 => pcf8591.rst} (100%)
 rename Documentation/hwmon/{pmbus-core => pmbus-core.rst} (100%)
 rename Documentation/hwmon/{pmbus => pmbus.rst} (100%)
 rename Documentation/hwmon/{powr1220 => powr1220.rst} (100%)
 rename Documentation/hwmon/{pwm-fan => pwm-fan.rst} (100%)
 rename Documentation/hwmon/{raspberrypi-hwmon => raspberrypi-hwmon.rst} (100%)
 rename Documentation/hwmon/{sch5627 => sch5627.rst} (100%)
 rename Documentation/hwmon/{sch5636 => sch5636.rst} (100%)
 rename Documentation/hwmon/{scpi-hwmon => scpi-hwmon.rst} (100%)
 rename Documentation/hwmon/{sht15 => sht15.rst} (100%)
 rename Documentation/hwmon/{sht21 => sht21.rst} (100%)
 rename Documentation/hwmon/{sht3x => sht3x.rst} (100%)
 rename Documentation/hwmon/{shtc1 => shtc1.rst} (100%)
 rename Documentation/hwmon/{sis5595 => sis5595.rst} (99%)
 rename Documentation/hwmon/{smm665 => smm665.rst} (100%)
 rename Documentation/hwmon/{smsc47b397 => smsc47b397.rst} (100%)
 rename Documentation/hwmon/{smsc47m1 => smsc47m1.rst} (100%)
 rename Documentation/hwmon/{smsc47m192 => smsc47m192.rst} (100%)
 rename Documentation/hwmon/{submitting-patches => submitting-patches.rst} (98%)
 rename Documentation/hwmon/{sysfs-interface => sysfs-interface.rst} (100%)
 rename Documentation/hwmon/{tc654 => tc654.rst} (100%)
 rename Documentation/hwmon/{tc74 => tc74.rst} (100%)
 rename Documentation/hwmon/{thmc50 => thmc50.rst} (99%)
 rename Documentation/hwmon/{tmp102 => tmp102.rst} (93%)
 rename Documentation/hwmon/{tmp103 => tmp103.rst} (92%)
 rename Documentation/hwmon/{tmp108 => tmp108.rst} (95%)
 rename Documentation/hwmon/{tmp401 => tmp401.rst} (97%)
 rename Documentation/hwmon/{tmp421 => tmp421.rst} (100%)
 rename Documentation/hwmon/{tps40422 => tps40422.rst} (96%)
 rename Documentation/hwmon/{twl4030-madc-hwmon => twl4030-madc-hwmon.rst} (100%)
 rename Documentation/hwmon/{ucd9000 => ucd9000.rst} (97%)
 rename Documentation/hwmon/{ucd9200 => ucd9200.rst} (97%)
 rename Documentation/hwmon/{userspace-tools => userspace-tools.rst} (100%)
 rename Documentation/hwmon/{vexpress => vexpress.rst} (100%)
 rename Documentation/hwmon/{via686a => via686a.rst} (100%)
 rename Documentation/hwmon/{vt1211 => vt1211.rst} (100%)
 rename Documentation/hwmon/{w83627ehf => w83627ehf.rst} (100%)
 rename Documentation/hwmon/{w83627hf => w83627hf.rst} (100%)
 rename Documentation/hwmon/{w83773g => w83773g.rst} (100%)
 rename Documentation/hwmon/{w83781d => w83781d.rst} (100%)
 rename Documentation/hwmon/{w83791d => w83791d.rst} (99%)
 rename Documentation/hwmon/{w83792d => w83792d.rst} (100%)
 rename Documentation/hwmon/{w83793 => w83793.rst} (100%)
 rename Documentation/hwmon/{w83795 => w83795.rst} (100%)
 rename Documentation/hwmon/{w83l785ts => w83l785ts.rst} (100%)
 rename Documentation/hwmon/{w83l786ng => w83l786ng.rst} (100%)
 rename Documentation/hwmon/{wm831x => wm831x.rst} (100%)
 rename Documentation/hwmon/{wm8350 => wm8350.rst} (100%)
 rename Documentation/hwmon/{xgene-hwmon => xgene-hwmon.rst} (100%)
 rename Documentation/hwmon/{zl6100 => zl6100.rst} (98%)

diff --git a/Documentation/devicetree/bindings/hwmon/g762.txt b/Documentation/devicetree/bindings/hwmon/g762.txt
index 25cc6d8ee575..6d154c4923de 100644
--- a/Documentation/devicetree/bindings/hwmon/g762.txt
+++ b/Documentation/devicetree/bindings/hwmon/g762.txt
@@ -21,7 +21,7 @@ If an optional property is not set in .dts file, then current value is kept
 unmodified (e.g. u-boot installed value).
 
 Additional information on operational parameters for the device is available
-in Documentation/hwmon/g762. A detailed datasheet for the device is available
+in Documentation/hwmon/g762.rst. A detailed datasheet for the device is available
 at http://natisbad.org/NAS/refs/GMT_EDS-762_763-080710-0.2.pdf.
 
 Example g762 node:
diff --git a/Documentation/hwmon/ab8500 b/Documentation/hwmon/ab8500.rst
similarity index 86%
rename from Documentation/hwmon/ab8500
rename to Documentation/hwmon/ab8500.rst
index d87c61151239..33f93a9cec04 100644
--- a/Documentation/hwmon/ab8500
+++ b/Documentation/hwmon/ab8500.rst
@@ -18,7 +18,7 @@ Authors:
 Description
 -----------
 
-See also Documentation/hwmon/abx500. This is the ST-Ericsson AB8500 specific
+See also Documentation/hwmon/abx500.rst. This is the ST-Ericsson AB8500 specific
 driver.
 
 Currently only the AB8500 internal sensor and one external sensor for battery
diff --git a/Documentation/hwmon/abituguru-datasheet b/Documentation/hwmon/abituguru-datasheet.rst
similarity index 100%
rename from Documentation/hwmon/abituguru-datasheet
rename to Documentation/hwmon/abituguru-datasheet.rst
diff --git a/Documentation/hwmon/abituguru b/Documentation/hwmon/abituguru.rst
similarity index 100%
rename from Documentation/hwmon/abituguru
rename to Documentation/hwmon/abituguru.rst
diff --git a/Documentation/hwmon/abituguru3 b/Documentation/hwmon/abituguru3.rst
similarity index 100%
rename from Documentation/hwmon/abituguru3
rename to Documentation/hwmon/abituguru3.rst
diff --git a/Documentation/hwmon/abx500 b/Documentation/hwmon/abx500.rst
similarity index 100%
rename from Documentation/hwmon/abx500
rename to Documentation/hwmon/abx500.rst
diff --git a/Documentation/hwmon/acpi_power_meter b/Documentation/hwmon/acpi_power_meter.rst
similarity index 97%
rename from Documentation/hwmon/acpi_power_meter
rename to Documentation/hwmon/acpi_power_meter.rst
index 7665ca6ba957..4a0941ade0ca 100644
--- a/Documentation/hwmon/acpi_power_meter
+++ b/Documentation/hwmon/acpi_power_meter.rst
@@ -21,7 +21,7 @@ the ACPI 4.0 spec (Chapter 10.4).  These devices have a simple set of
 features--a power meter that returns average power use over a configurable
 interval, an optional capping mechanism, and a couple of trip points.  The
 sysfs interface conforms with the specification outlined in the "Power" section
-of Documentation/hwmon/sysfs-interface.
+of Documentation/hwmon/sysfs-interface.rst.
 
 Special Features
 ----------------
diff --git a/Documentation/hwmon/ad7314 b/Documentation/hwmon/ad7314.rst
similarity index 100%
rename from Documentation/hwmon/ad7314
rename to Documentation/hwmon/ad7314.rst
diff --git a/Documentation/hwmon/adc128d818 b/Documentation/hwmon/adc128d818.rst
similarity index 100%
rename from Documentation/hwmon/adc128d818
rename to Documentation/hwmon/adc128d818.rst
diff --git a/Documentation/hwmon/adm1021 b/Documentation/hwmon/adm1021.rst
similarity index 100%
rename from Documentation/hwmon/adm1021
rename to Documentation/hwmon/adm1021.rst
diff --git a/Documentation/hwmon/adm1025 b/Documentation/hwmon/adm1025.rst
similarity index 100%
rename from Documentation/hwmon/adm1025
rename to Documentation/hwmon/adm1025.rst
diff --git a/Documentation/hwmon/adm1026 b/Documentation/hwmon/adm1026.rst
similarity index 100%
rename from Documentation/hwmon/adm1026
rename to Documentation/hwmon/adm1026.rst
diff --git a/Documentation/hwmon/adm1031 b/Documentation/hwmon/adm1031.rst
similarity index 100%
rename from Documentation/hwmon/adm1031
rename to Documentation/hwmon/adm1031.rst
diff --git a/Documentation/hwmon/adm1275 b/Documentation/hwmon/adm1275.rst
similarity index 97%
rename from Documentation/hwmon/adm1275
rename to Documentation/hwmon/adm1275.rst
index 5c5860011d6e..9a1913e5b4d9 100644
--- a/Documentation/hwmon/adm1275
+++ b/Documentation/hwmon/adm1275.rst
@@ -68,7 +68,7 @@ integrated 12 bit analog-to-digital converter (ADC), accessed using a
 PMBus interface.
 
 The driver is a client driver to the core PMBus driver. Please see
-Documentation/hwmon/pmbus for details on PMBus client drivers.
+Documentation/hwmon/pmbus.rst for details on PMBus client drivers.
 
 
 Usage Notes
@@ -90,7 +90,7 @@ Platform data support
 ---------------------
 
 The driver supports standard PMBus driver platform data. Please see
-Documentation/hwmon/pmbus for details.
+Documentation/hwmon/pmbus.rst for details.
 
 
 Sysfs entries
diff --git a/Documentation/hwmon/adm9240 b/Documentation/hwmon/adm9240.rst
similarity index 100%
rename from Documentation/hwmon/adm9240
rename to Documentation/hwmon/adm9240.rst
diff --git a/Documentation/hwmon/ads1015 b/Documentation/hwmon/ads1015.rst
similarity index 100%
rename from Documentation/hwmon/ads1015
rename to Documentation/hwmon/ads1015.rst
diff --git a/Documentation/hwmon/ads7828 b/Documentation/hwmon/ads7828.rst
similarity index 100%
rename from Documentation/hwmon/ads7828
rename to Documentation/hwmon/ads7828.rst
diff --git a/Documentation/hwmon/adt7410 b/Documentation/hwmon/adt7410.rst
similarity index 100%
rename from Documentation/hwmon/adt7410
rename to Documentation/hwmon/adt7410.rst
diff --git a/Documentation/hwmon/adt7411 b/Documentation/hwmon/adt7411.rst
similarity index 100%
rename from Documentation/hwmon/adt7411
rename to Documentation/hwmon/adt7411.rst
diff --git a/Documentation/hwmon/adt7462 b/Documentation/hwmon/adt7462.rst
similarity index 99%
rename from Documentation/hwmon/adt7462
rename to Documentation/hwmon/adt7462.rst
index a7a831118d32..139e19696188 100644
--- a/Documentation/hwmon/adt7462
+++ b/Documentation/hwmon/adt7462.rst
@@ -68,4 +68,3 @@ The ADT7462 will scale the pwm between the lower and higher pwm speed when
 the temperature is between the two temperature boundaries.  PWM values range
 from 0 (off) to 255 (full speed).  Fan speed will be set to maximum when the
 temperature sensor associated with the PWM control exceeds temp#_max.
-
diff --git a/Documentation/hwmon/adt7470 b/Documentation/hwmon/adt7470.rst
similarity index 100%
rename from Documentation/hwmon/adt7470
rename to Documentation/hwmon/adt7470.rst
diff --git a/Documentation/hwmon/adt7475 b/Documentation/hwmon/adt7475.rst
similarity index 100%
rename from Documentation/hwmon/adt7475
rename to Documentation/hwmon/adt7475.rst
diff --git a/Documentation/hwmon/amc6821 b/Documentation/hwmon/amc6821.rst
similarity index 99%
rename from Documentation/hwmon/amc6821
rename to Documentation/hwmon/amc6821.rst
index d10eabcbc0f3..5ddb2849da90 100644
--- a/Documentation/hwmon/amc6821
+++ b/Documentation/hwmon/amc6821.rst
@@ -106,4 +106,3 @@ different settings, you can set the following parameters:
 
 - init=1,
 - pwminv: 0 default pwm output, 1 inverts pwm output.
-
diff --git a/Documentation/hwmon/asb100 b/Documentation/hwmon/asb100.rst
similarity index 99%
rename from Documentation/hwmon/asb100
rename to Documentation/hwmon/asb100.rst
index 311d9f7b6926..c2d5f97085fe 100644
--- a/Documentation/hwmon/asb100
+++ b/Documentation/hwmon/asb100.rst
@@ -71,4 +71,3 @@ TODO:
   * Experiment with temp. sensor types.
   * Are there really 13 voltage inputs? Probably not...
   * Cleanups, no doubt...
-
diff --git a/Documentation/hwmon/asc7621 b/Documentation/hwmon/asc7621.rst
similarity index 100%
rename from Documentation/hwmon/asc7621
rename to Documentation/hwmon/asc7621.rst
diff --git a/Documentation/hwmon/aspeed-pwm-tacho b/Documentation/hwmon/aspeed-pwm-tacho.rst
similarity index 100%
rename from Documentation/hwmon/aspeed-pwm-tacho
rename to Documentation/hwmon/aspeed-pwm-tacho.rst
diff --git a/Documentation/hwmon/coretemp b/Documentation/hwmon/coretemp.rst
similarity index 100%
rename from Documentation/hwmon/coretemp
rename to Documentation/hwmon/coretemp.rst
diff --git a/Documentation/hwmon/da9052 b/Documentation/hwmon/da9052.rst
similarity index 100%
rename from Documentation/hwmon/da9052
rename to Documentation/hwmon/da9052.rst
diff --git a/Documentation/hwmon/da9055 b/Documentation/hwmon/da9055.rst
similarity index 100%
rename from Documentation/hwmon/da9055
rename to Documentation/hwmon/da9055.rst
diff --git a/Documentation/hwmon/dme1737 b/Documentation/hwmon/dme1737.rst
similarity index 100%
rename from Documentation/hwmon/dme1737
rename to Documentation/hwmon/dme1737.rst
diff --git a/Documentation/hwmon/ds1621 b/Documentation/hwmon/ds1621.rst
similarity index 100%
rename from Documentation/hwmon/ds1621
rename to Documentation/hwmon/ds1621.rst
diff --git a/Documentation/hwmon/ds620 b/Documentation/hwmon/ds620.rst
similarity index 100%
rename from Documentation/hwmon/ds620
rename to Documentation/hwmon/ds620.rst
diff --git a/Documentation/hwmon/emc1403 b/Documentation/hwmon/emc1403.rst
similarity index 100%
rename from Documentation/hwmon/emc1403
rename to Documentation/hwmon/emc1403.rst
diff --git a/Documentation/hwmon/emc2103 b/Documentation/hwmon/emc2103.rst
similarity index 100%
rename from Documentation/hwmon/emc2103
rename to Documentation/hwmon/emc2103.rst
diff --git a/Documentation/hwmon/emc6w201 b/Documentation/hwmon/emc6w201.rst
similarity index 100%
rename from Documentation/hwmon/emc6w201
rename to Documentation/hwmon/emc6w201.rst
diff --git a/Documentation/hwmon/f71805f b/Documentation/hwmon/f71805f.rst
similarity index 100%
rename from Documentation/hwmon/f71805f
rename to Documentation/hwmon/f71805f.rst
diff --git a/Documentation/hwmon/f71882fg b/Documentation/hwmon/f71882fg.rst
similarity index 100%
rename from Documentation/hwmon/f71882fg
rename to Documentation/hwmon/f71882fg.rst
diff --git a/Documentation/hwmon/fam15h_power b/Documentation/hwmon/fam15h_power.rst
similarity index 100%
rename from Documentation/hwmon/fam15h_power
rename to Documentation/hwmon/fam15h_power.rst
diff --git a/Documentation/hwmon/ftsteutates b/Documentation/hwmon/ftsteutates.rst
similarity index 100%
rename from Documentation/hwmon/ftsteutates
rename to Documentation/hwmon/ftsteutates.rst
diff --git a/Documentation/hwmon/g760a b/Documentation/hwmon/g760a.rst
similarity index 100%
rename from Documentation/hwmon/g760a
rename to Documentation/hwmon/g760a.rst
diff --git a/Documentation/hwmon/g762 b/Documentation/hwmon/g762.rst
similarity index 97%
rename from Documentation/hwmon/g762
rename to Documentation/hwmon/g762.rst
index 54574e26df21..0371b3365c48 100644
--- a/Documentation/hwmon/g762
+++ b/Documentation/hwmon/g762.rst
@@ -7,7 +7,7 @@ modes - PWM or DC - are supported by the device.
 
 For additional information, a detailed datasheet is available at
 http://natisbad.org/NAS/ref/GMT_EDS-762_763-080710-0.2.pdf. sysfs
-bindings are described in Documentation/hwmon/sysfs-interface.
+bindings are described in Documentation/hwmon/sysfs-interface.rst.
 
 The following entries are available to the user in a subdirectory of
 /sys/bus/i2c/drivers/g762/ to control the operation of the device.
diff --git a/Documentation/hwmon/gl518sm b/Documentation/hwmon/gl518sm.rst
similarity index 100%
rename from Documentation/hwmon/gl518sm
rename to Documentation/hwmon/gl518sm.rst
diff --git a/Documentation/hwmon/hih6130 b/Documentation/hwmon/hih6130.rst
similarity index 100%
rename from Documentation/hwmon/hih6130
rename to Documentation/hwmon/hih6130.rst
diff --git a/Documentation/hwmon/hwmon-kernel-api.txt b/Documentation/hwmon/hwmon-kernel-api.rst
similarity index 99%
rename from Documentation/hwmon/hwmon-kernel-api.txt
rename to Documentation/hwmon/hwmon-kernel-api.rst
index b347b959fcda..c41eb6108103 100644
--- a/Documentation/hwmon/hwmon-kernel-api.txt
+++ b/Documentation/hwmon/hwmon-kernel-api.rst
@@ -12,10 +12,10 @@ drivers that want to use the hardware monitoring framework.
 This document does not describe what a hardware monitoring (hwmon) Driver or
 Device is. It also does not describe the API which can be used by user space
 to communicate with a hardware monitoring device. If you want to know this
-then please read the following file: Documentation/hwmon/sysfs-interface.
+then please read the following file: Documentation/hwmon/sysfs-interface.rst.
 
 For additional guidelines on how to write and improve hwmon drivers, please
-also read Documentation/hwmon/submitting-patches.
+also read Documentation/hwmon/submitting-patches.rst.
 
 The API
 -------
diff --git a/Documentation/hwmon/ibm-cffps b/Documentation/hwmon/ibm-cffps.rst
similarity index 100%
rename from Documentation/hwmon/ibm-cffps
rename to Documentation/hwmon/ibm-cffps.rst
diff --git a/Documentation/hwmon/ibmaem b/Documentation/hwmon/ibmaem.rst
similarity index 100%
rename from Documentation/hwmon/ibmaem
rename to Documentation/hwmon/ibmaem.rst
diff --git a/Documentation/hwmon/ibmpowernv b/Documentation/hwmon/ibmpowernv.rst
similarity index 100%
rename from Documentation/hwmon/ibmpowernv
rename to Documentation/hwmon/ibmpowernv.rst
diff --git a/Documentation/hwmon/ina209 b/Documentation/hwmon/ina209.rst
similarity index 100%
rename from Documentation/hwmon/ina209
rename to Documentation/hwmon/ina209.rst
diff --git a/Documentation/hwmon/ina2xx b/Documentation/hwmon/ina2xx.rst
similarity index 97%
rename from Documentation/hwmon/ina2xx
rename to Documentation/hwmon/ina2xx.rst
index 95badf9c396f..94b9a260c518 100644
--- a/Documentation/hwmon/ina2xx
+++ b/Documentation/hwmon/ina2xx.rst
@@ -78,7 +78,7 @@ refer to the Documentation/devicetree/bindings/hwmon/ina2xx.txt for bindings
 if the device tree is used.
 
 Additionally ina226 supports update_interval attribute as described in
-Documentation/hwmon/sysfs-interface. Internally the interval is the sum of
+Documentation/hwmon/sysfs-interface.rst. Internally the interval is the sum of
 bus and shunt voltage conversion times multiplied by the averaging rate. We
 don't touch the conversion times and only modify the number of averages. The
 lower limit of the update_interval is 2 ms, the upper limit is 2253 ms.
diff --git a/Documentation/hwmon/ina3221 b/Documentation/hwmon/ina3221.rst
similarity index 100%
rename from Documentation/hwmon/ina3221
rename to Documentation/hwmon/ina3221.rst
diff --git a/Documentation/hwmon/index.rst b/Documentation/hwmon/index.rst
new file mode 100644
index 000000000000..893804414510
--- /dev/null
+++ b/Documentation/hwmon/index.rst
@@ -0,0 +1,179 @@
+=========================
+Linux Hardware Monitoring
+=========================
+
+.. toctree::
+   :maxdepth: 1
+
+   hwmon-kernel-api.rst
+   pmbus-core.rst
+   submitting-patches.rst
+   sysfs-interface.rst
+   userspace-tools.rst
+
+Hardware Monitoring Kernel Drivers
+==================================
+
+.. toctree::
+   :maxdepth: 1
+
+   ab8500.rst
+   abituguru.rst
+   abituguru3.rst
+   abx500.rst
+   acpi_power_meter.rst
+   ad7314.rst
+   adc128d818.rst
+   adm1021.rst
+   adm1025.rst
+   adm1026.rst
+   adm1031.rst
+   adm1275.rst
+   adm9240.rst
+   ads1015.rst
+   ads7828.rst
+   adt7410.rst
+   adt7411.rst
+   adt7462.rst
+   adt7470.rst
+   adt7475.rst
+   amc6821.rst
+   asb100.rst
+   asc7621.rst
+   aspeed-pwm-tacho.rst
+   coretemp.rst
+   da9052.rst
+   da9055.rst
+   dme1737.rst
+   ds1621.rst
+   ds620.rst
+   emc1403.rst
+   emc2103.rst
+   emc6w201.rst
+   f71805f.rst
+   f71882fg.rst
+   fam15h_power.rst
+   ftsteutates.rst
+   g760a.rst
+   g762.rst
+   gl518sm.rst
+   hih6130.rst
+   ibmaem.rst
+   ibm-cffps.rst
+   ibmpowernv.rst
+   ina209.rst
+   ina2xx.rst
+   ina3221.rst
+   ir35221.rst
+   it87.rst
+   jc42.rst
+   k10temp.rst
+   k8temp.rst
+   lineage-pem.rst
+   lm25066.rst
+   lm63.rst
+   lm70.rst
+   lm73.rst
+   lm75.rst
+   lm77.rst
+   lm78.rst
+   lm80.rst
+   lm83.rst
+   lm85.rst
+   lm87.rst
+   lm90.rst
+   lm92.rst
+   lm93.rst
+   lm95234.rst
+   lm95245.rst
+   ltc2945.rst
+   ltc2978.rst
+   ltc2990.rst
+   ltc3815.rst
+   ltc4151.rst
+   ltc4215.rst
+   ltc4245.rst
+   ltc4260.rst
+   ltc4261.rst
+   max16064.rst
+   max16065.rst
+   max1619.rst
+   max1668.rst
+   max197.rst
+   max20751.rst
+   max31722.rst
+   max31785.rst
+   max31790.rst
+   max34440.rst
+   max6639.rst
+   max6642.rst
+   max6650.rst
+   max6697.rst
+   max8688.rst
+   mc13783-adc.rst
+   mcp3021.rst
+   menf21bmc.rst
+   mlxreg-fan.rst
+   nct6683.rst
+   nct6775.rst
+   nct7802.rst
+   nct7904.rst
+   npcm750-pwm-fan.rst
+   nsa320.rst
+   ntc_thermistor.rst
+   occ.rst
+   pc87360.rst
+   pc87427.rst
+   pcf8591.rst
+   pmbus.rst
+   powr1220.rst
+   pwm-fan.rst
+   raspberrypi-hwmon.rst
+   sch5627.rst
+   sch5636.rst
+   scpi-hwmon.rst
+   sht15.rst
+   sht21.rst
+   sht3x.rst
+   shtc1.rst
+   sis5595.rst
+   smm665.rst
+   smsc47b397.rst
+   smsc47m192.rst
+   smsc47m1.rst
+   tc654.rst
+   tc74.rst
+   thmc50.rst
+   tmp102.rst
+   tmp103.rst
+   tmp108.rst
+   tmp401.rst
+   tmp421.rst
+   tps40422.rst
+   twl4030-madc-hwmon.rst
+   ucd9000.rst
+   ucd9200.rst
+   vexpress.rst
+   via686a.rst
+   vt1211.rst
+   w83627ehf.rst
+   w83627hf.rst
+   w83773g.rst
+   w83781d.rst
+   w83791d.rst
+   w83792d.rst
+   w83793.rst
+   w83795.rst
+   w83l785ts.rst
+   w83l786ng.rst
+   wm831x.rst
+   wm8350.rst
+   xgene-hwmon.rst
+   zl6100.rst
+
+.. only::  subproject and html
+
+   Indices
+   =======
+
+   * :ref:`genindex`
diff --git a/Documentation/hwmon/ir35221 b/Documentation/hwmon/ir35221.rst
similarity index 100%
rename from Documentation/hwmon/ir35221
rename to Documentation/hwmon/ir35221.rst
diff --git a/Documentation/hwmon/it87 b/Documentation/hwmon/it87.rst
similarity index 100%
rename from Documentation/hwmon/it87
rename to Documentation/hwmon/it87.rst
diff --git a/Documentation/hwmon/jc42 b/Documentation/hwmon/jc42.rst
similarity index 100%
rename from Documentation/hwmon/jc42
rename to Documentation/hwmon/jc42.rst
diff --git a/Documentation/hwmon/k10temp b/Documentation/hwmon/k10temp.rst
similarity index 100%
rename from Documentation/hwmon/k10temp
rename to Documentation/hwmon/k10temp.rst
diff --git a/Documentation/hwmon/k8temp b/Documentation/hwmon/k8temp.rst
similarity index 100%
rename from Documentation/hwmon/k8temp
rename to Documentation/hwmon/k8temp.rst
diff --git a/Documentation/hwmon/lineage-pem b/Documentation/hwmon/lineage-pem.rst
similarity index 100%
rename from Documentation/hwmon/lineage-pem
rename to Documentation/hwmon/lineage-pem.rst
diff --git a/Documentation/hwmon/lm25066 b/Documentation/hwmon/lm25066.rst
similarity index 97%
rename from Documentation/hwmon/lm25066
rename to Documentation/hwmon/lm25066.rst
index 60b7f2722931..da15e3094c8c 100644
--- a/Documentation/hwmon/lm25066
+++ b/Documentation/hwmon/lm25066.rst
@@ -69,7 +69,7 @@ LM25066, LM5064, and LM5066/LM5066I Power Management, Monitoring,
 Control, and Protection ICs.
 
 The driver is a client driver to the core PMBus driver. Please see
-Documentation/hwmon/pmbus for details on PMBus client drivers.
+Documentation/hwmon/pmbus.rst for details on PMBus client drivers.
 
 
 Usage Notes
diff --git a/Documentation/hwmon/lm63 b/Documentation/hwmon/lm63.rst
similarity index 100%
rename from Documentation/hwmon/lm63
rename to Documentation/hwmon/lm63.rst
diff --git a/Documentation/hwmon/lm70 b/Documentation/hwmon/lm70.rst
similarity index 100%
rename from Documentation/hwmon/lm70
rename to Documentation/hwmon/lm70.rst
diff --git a/Documentation/hwmon/lm73 b/Documentation/hwmon/lm73.rst
similarity index 100%
rename from Documentation/hwmon/lm73
rename to Documentation/hwmon/lm73.rst
diff --git a/Documentation/hwmon/lm75 b/Documentation/hwmon/lm75.rst
similarity index 100%
rename from Documentation/hwmon/lm75
rename to Documentation/hwmon/lm75.rst
diff --git a/Documentation/hwmon/lm77 b/Documentation/hwmon/lm77.rst
similarity index 100%
rename from Documentation/hwmon/lm77
rename to Documentation/hwmon/lm77.rst
diff --git a/Documentation/hwmon/lm78 b/Documentation/hwmon/lm78.rst
similarity index 100%
rename from Documentation/hwmon/lm78
rename to Documentation/hwmon/lm78.rst
diff --git a/Documentation/hwmon/lm80 b/Documentation/hwmon/lm80.rst
similarity index 100%
rename from Documentation/hwmon/lm80
rename to Documentation/hwmon/lm80.rst
diff --git a/Documentation/hwmon/lm83 b/Documentation/hwmon/lm83.rst
similarity index 100%
rename from Documentation/hwmon/lm83
rename to Documentation/hwmon/lm83.rst
diff --git a/Documentation/hwmon/lm85 b/Documentation/hwmon/lm85.rst
similarity index 100%
rename from Documentation/hwmon/lm85
rename to Documentation/hwmon/lm85.rst
diff --git a/Documentation/hwmon/lm87 b/Documentation/hwmon/lm87.rst
similarity index 100%
rename from Documentation/hwmon/lm87
rename to Documentation/hwmon/lm87.rst
diff --git a/Documentation/hwmon/lm90 b/Documentation/hwmon/lm90.rst
similarity index 100%
rename from Documentation/hwmon/lm90
rename to Documentation/hwmon/lm90.rst
diff --git a/Documentation/hwmon/lm92 b/Documentation/hwmon/lm92.rst
similarity index 100%
rename from Documentation/hwmon/lm92
rename to Documentation/hwmon/lm92.rst
diff --git a/Documentation/hwmon/lm93 b/Documentation/hwmon/lm93.rst
similarity index 100%
rename from Documentation/hwmon/lm93
rename to Documentation/hwmon/lm93.rst
diff --git a/Documentation/hwmon/lm95234 b/Documentation/hwmon/lm95234.rst
similarity index 100%
rename from Documentation/hwmon/lm95234
rename to Documentation/hwmon/lm95234.rst
diff --git a/Documentation/hwmon/lm95245 b/Documentation/hwmon/lm95245.rst
similarity index 100%
rename from Documentation/hwmon/lm95245
rename to Documentation/hwmon/lm95245.rst
diff --git a/Documentation/hwmon/ltc2945 b/Documentation/hwmon/ltc2945.rst
similarity index 100%
rename from Documentation/hwmon/ltc2945
rename to Documentation/hwmon/ltc2945.rst
diff --git a/Documentation/hwmon/ltc2978 b/Documentation/hwmon/ltc2978.rst
similarity index 100%
rename from Documentation/hwmon/ltc2978
rename to Documentation/hwmon/ltc2978.rst
diff --git a/Documentation/hwmon/ltc2990 b/Documentation/hwmon/ltc2990.rst
similarity index 100%
rename from Documentation/hwmon/ltc2990
rename to Documentation/hwmon/ltc2990.rst
diff --git a/Documentation/hwmon/ltc3815 b/Documentation/hwmon/ltc3815.rst
similarity index 100%
rename from Documentation/hwmon/ltc3815
rename to Documentation/hwmon/ltc3815.rst
diff --git a/Documentation/hwmon/ltc4151 b/Documentation/hwmon/ltc4151.rst
similarity index 100%
rename from Documentation/hwmon/ltc4151
rename to Documentation/hwmon/ltc4151.rst
diff --git a/Documentation/hwmon/ltc4215 b/Documentation/hwmon/ltc4215.rst
similarity index 100%
rename from Documentation/hwmon/ltc4215
rename to Documentation/hwmon/ltc4215.rst
diff --git a/Documentation/hwmon/ltc4245 b/Documentation/hwmon/ltc4245.rst
similarity index 100%
rename from Documentation/hwmon/ltc4245
rename to Documentation/hwmon/ltc4245.rst
diff --git a/Documentation/hwmon/ltc4260 b/Documentation/hwmon/ltc4260.rst
similarity index 100%
rename from Documentation/hwmon/ltc4260
rename to Documentation/hwmon/ltc4260.rst
diff --git a/Documentation/hwmon/ltc4261 b/Documentation/hwmon/ltc4261.rst
similarity index 100%
rename from Documentation/hwmon/ltc4261
rename to Documentation/hwmon/ltc4261.rst
diff --git a/Documentation/hwmon/max16064 b/Documentation/hwmon/max16064.rst
similarity index 96%
rename from Documentation/hwmon/max16064
rename to Documentation/hwmon/max16064.rst
index 61ec679dc477..6d5e9538991f 100644
--- a/Documentation/hwmon/max16064
+++ b/Documentation/hwmon/max16064.rst
@@ -21,7 +21,7 @@ This driver supports hardware monitoring for Maxim MAX16064 Quad Power-Supply
 Controller with Active-Voltage Output Control and PMBus Interface.
 
 The driver is a client driver to the core PMBus driver.
-Please see Documentation/hwmon/pmbus for details on PMBus client drivers.
+Please see Documentation/hwmon/pmbus.rst for details on PMBus client drivers.
 
 
 Usage Notes
diff --git a/Documentation/hwmon/max16065 b/Documentation/hwmon/max16065.rst
similarity index 100%
rename from Documentation/hwmon/max16065
rename to Documentation/hwmon/max16065.rst
diff --git a/Documentation/hwmon/max1619 b/Documentation/hwmon/max1619.rst
similarity index 99%
rename from Documentation/hwmon/max1619
rename to Documentation/hwmon/max1619.rst
index 4b3762c4eceb..e25956e70f73 100644
--- a/Documentation/hwmon/max1619
+++ b/Documentation/hwmon/max1619.rst
@@ -31,4 +31,3 @@ Only the external sensor has high and low limits.
 The max1619 driver will not update its values more frequently than every
 other second; reading them more often will do no harm, but will return
 'old' values.
-
diff --git a/Documentation/hwmon/max1668 b/Documentation/hwmon/max1668.rst
similarity index 100%
rename from Documentation/hwmon/max1668
rename to Documentation/hwmon/max1668.rst
diff --git a/Documentation/hwmon/max197 b/Documentation/hwmon/max197.rst
similarity index 100%
rename from Documentation/hwmon/max197
rename to Documentation/hwmon/max197.rst
diff --git a/Documentation/hwmon/max20751 b/Documentation/hwmon/max20751.rst
similarity index 96%
rename from Documentation/hwmon/max20751
rename to Documentation/hwmon/max20751.rst
index d546695900ef..aa4469be6674 100644
--- a/Documentation/hwmon/max20751
+++ b/Documentation/hwmon/max20751.rst
@@ -23,7 +23,7 @@ This driver supports MAX20751 Multiphase Master with PMBus Interface
 and Internal Buck Converter.
 
 The driver is a client driver to the core PMBus driver.
-Please see Documentation/hwmon/pmbus for details on PMBus client drivers.
+Please see Documentation/hwmon/pmbus.rst for details on PMBus client drivers.
 
 
 Usage Notes
diff --git a/Documentation/hwmon/max31722 b/Documentation/hwmon/max31722.rst
similarity index 100%
rename from Documentation/hwmon/max31722
rename to Documentation/hwmon/max31722.rst
diff --git a/Documentation/hwmon/max31785 b/Documentation/hwmon/max31785.rst
similarity index 100%
rename from Documentation/hwmon/max31785
rename to Documentation/hwmon/max31785.rst
diff --git a/Documentation/hwmon/max31790 b/Documentation/hwmon/max31790.rst
similarity index 100%
rename from Documentation/hwmon/max31790
rename to Documentation/hwmon/max31790.rst
diff --git a/Documentation/hwmon/max34440 b/Documentation/hwmon/max34440.rst
similarity index 98%
rename from Documentation/hwmon/max34440
rename to Documentation/hwmon/max34440.rst
index 639838ef29fd..939138e12b02 100644
--- a/Documentation/hwmon/max34440
+++ b/Documentation/hwmon/max34440.rst
@@ -76,7 +76,7 @@ based on GIN pins. The MAX34460 supports 12 voltage channels, and the MAX34461
 supports 16 voltage channels.
 
 The driver is a client driver to the core PMBus driver. Please see
-Documentation/hwmon/pmbus for details on PMBus client drivers.
+Documentation/hwmon/pmbus.rst for details on PMBus client drivers.
 
 
 Usage Notes
diff --git a/Documentation/hwmon/max6639 b/Documentation/hwmon/max6639.rst
similarity index 100%
rename from Documentation/hwmon/max6639
rename to Documentation/hwmon/max6639.rst
diff --git a/Documentation/hwmon/max6642 b/Documentation/hwmon/max6642.rst
similarity index 100%
rename from Documentation/hwmon/max6642
rename to Documentation/hwmon/max6642.rst
diff --git a/Documentation/hwmon/max6650 b/Documentation/hwmon/max6650.rst
similarity index 99%
rename from Documentation/hwmon/max6650
rename to Documentation/hwmon/max6650.rst
index 74dc3f0caaa2..253482add082 100644
--- a/Documentation/hwmon/max6650
+++ b/Documentation/hwmon/max6650.rst
@@ -72,4 +72,3 @@ clock: The clock frequency in Hz of the chip the driver should assume [254000]
 
 Please have a look at the MAX6650/6651 data sheet and make sure that you fully
 understand the meaning of these parameters before you attempt to change them.
-
diff --git a/Documentation/hwmon/max6697 b/Documentation/hwmon/max6697.rst
similarity index 100%
rename from Documentation/hwmon/max6697
rename to Documentation/hwmon/max6697.rst
diff --git a/Documentation/hwmon/max8688 b/Documentation/hwmon/max8688.rst
similarity index 97%
rename from Documentation/hwmon/max8688
rename to Documentation/hwmon/max8688.rst
index 43da139234c1..009487759c61 100644
--- a/Documentation/hwmon/max8688
+++ b/Documentation/hwmon/max8688.rst
@@ -21,7 +21,7 @@ This driver supports hardware monitoring for Maxim MAX8688 Digital Power-Supply
 Controller/Monitor with PMBus Interface.
 
 The driver is a client driver to the core PMBus driver. Please see
-Documentation/hwmon/pmbus for details on PMBus client drivers.
+Documentation/hwmon/pmbus.rst for details on PMBus client drivers.
 
 
 Usage Notes
diff --git a/Documentation/hwmon/mc13783-adc b/Documentation/hwmon/mc13783-adc.rst
similarity index 100%
rename from Documentation/hwmon/mc13783-adc
rename to Documentation/hwmon/mc13783-adc.rst
diff --git a/Documentation/hwmon/mcp3021 b/Documentation/hwmon/mcp3021.rst
similarity index 100%
rename from Documentation/hwmon/mcp3021
rename to Documentation/hwmon/mcp3021.rst
diff --git a/Documentation/hwmon/menf21bmc b/Documentation/hwmon/menf21bmc.rst
similarity index 100%
rename from Documentation/hwmon/menf21bmc
rename to Documentation/hwmon/menf21bmc.rst
diff --git a/Documentation/hwmon/mlxreg-fan b/Documentation/hwmon/mlxreg-fan.rst
similarity index 100%
rename from Documentation/hwmon/mlxreg-fan
rename to Documentation/hwmon/mlxreg-fan.rst
diff --git a/Documentation/hwmon/nct6683 b/Documentation/hwmon/nct6683.rst
similarity index 100%
rename from Documentation/hwmon/nct6683
rename to Documentation/hwmon/nct6683.rst
diff --git a/Documentation/hwmon/nct6775 b/Documentation/hwmon/nct6775.rst
similarity index 100%
rename from Documentation/hwmon/nct6775
rename to Documentation/hwmon/nct6775.rst
diff --git a/Documentation/hwmon/nct7802 b/Documentation/hwmon/nct7802.rst
similarity index 100%
rename from Documentation/hwmon/nct7802
rename to Documentation/hwmon/nct7802.rst
diff --git a/Documentation/hwmon/nct7904 b/Documentation/hwmon/nct7904.rst
similarity index 100%
rename from Documentation/hwmon/nct7904
rename to Documentation/hwmon/nct7904.rst
diff --git a/Documentation/hwmon/npcm750-pwm-fan b/Documentation/hwmon/npcm750-pwm-fan.rst
similarity index 100%
rename from Documentation/hwmon/npcm750-pwm-fan
rename to Documentation/hwmon/npcm750-pwm-fan.rst
diff --git a/Documentation/hwmon/nsa320 b/Documentation/hwmon/nsa320.rst
similarity index 100%
rename from Documentation/hwmon/nsa320
rename to Documentation/hwmon/nsa320.rst
diff --git a/Documentation/hwmon/ntc_thermistor b/Documentation/hwmon/ntc_thermistor.rst
similarity index 100%
rename from Documentation/hwmon/ntc_thermistor
rename to Documentation/hwmon/ntc_thermistor.rst
diff --git a/Documentation/hwmon/occ b/Documentation/hwmon/occ.rst
similarity index 100%
rename from Documentation/hwmon/occ
rename to Documentation/hwmon/occ.rst
diff --git a/Documentation/hwmon/pc87360 b/Documentation/hwmon/pc87360.rst
similarity index 100%
rename from Documentation/hwmon/pc87360
rename to Documentation/hwmon/pc87360.rst
diff --git a/Documentation/hwmon/pc87427 b/Documentation/hwmon/pc87427.rst
similarity index 100%
rename from Documentation/hwmon/pc87427
rename to Documentation/hwmon/pc87427.rst
diff --git a/Documentation/hwmon/pcf8591 b/Documentation/hwmon/pcf8591.rst
similarity index 100%
rename from Documentation/hwmon/pcf8591
rename to Documentation/hwmon/pcf8591.rst
diff --git a/Documentation/hwmon/pmbus-core b/Documentation/hwmon/pmbus-core.rst
similarity index 100%
rename from Documentation/hwmon/pmbus-core
rename to Documentation/hwmon/pmbus-core.rst
diff --git a/Documentation/hwmon/pmbus b/Documentation/hwmon/pmbus.rst
similarity index 100%
rename from Documentation/hwmon/pmbus
rename to Documentation/hwmon/pmbus.rst
diff --git a/Documentation/hwmon/powr1220 b/Documentation/hwmon/powr1220.rst
similarity index 100%
rename from Documentation/hwmon/powr1220
rename to Documentation/hwmon/powr1220.rst
diff --git a/Documentation/hwmon/pwm-fan b/Documentation/hwmon/pwm-fan.rst
similarity index 100%
rename from Documentation/hwmon/pwm-fan
rename to Documentation/hwmon/pwm-fan.rst
diff --git a/Documentation/hwmon/raspberrypi-hwmon b/Documentation/hwmon/raspberrypi-hwmon.rst
similarity index 100%
rename from Documentation/hwmon/raspberrypi-hwmon
rename to Documentation/hwmon/raspberrypi-hwmon.rst
diff --git a/Documentation/hwmon/sch5627 b/Documentation/hwmon/sch5627.rst
similarity index 100%
rename from Documentation/hwmon/sch5627
rename to Documentation/hwmon/sch5627.rst
diff --git a/Documentation/hwmon/sch5636 b/Documentation/hwmon/sch5636.rst
similarity index 100%
rename from Documentation/hwmon/sch5636
rename to Documentation/hwmon/sch5636.rst
diff --git a/Documentation/hwmon/scpi-hwmon b/Documentation/hwmon/scpi-hwmon.rst
similarity index 100%
rename from Documentation/hwmon/scpi-hwmon
rename to Documentation/hwmon/scpi-hwmon.rst
diff --git a/Documentation/hwmon/sht15 b/Documentation/hwmon/sht15.rst
similarity index 100%
rename from Documentation/hwmon/sht15
rename to Documentation/hwmon/sht15.rst
diff --git a/Documentation/hwmon/sht21 b/Documentation/hwmon/sht21.rst
similarity index 100%
rename from Documentation/hwmon/sht21
rename to Documentation/hwmon/sht21.rst
diff --git a/Documentation/hwmon/sht3x b/Documentation/hwmon/sht3x.rst
similarity index 100%
rename from Documentation/hwmon/sht3x
rename to Documentation/hwmon/sht3x.rst
diff --git a/Documentation/hwmon/shtc1 b/Documentation/hwmon/shtc1.rst
similarity index 100%
rename from Documentation/hwmon/shtc1
rename to Documentation/hwmon/shtc1.rst
diff --git a/Documentation/hwmon/sis5595 b/Documentation/hwmon/sis5595.rst
similarity index 99%
rename from Documentation/hwmon/sis5595
rename to Documentation/hwmon/sis5595.rst
index 5acba6b0c0db..16123b3bfff9 100644
--- a/Documentation/hwmon/sis5595
+++ b/Documentation/hwmon/sis5595.rst
@@ -121,4 +121,3 @@ Problems
 --------
 Some chips refuse to be enabled. We don't know why.
 The driver will recognize this and print a message in dmesg.
-
diff --git a/Documentation/hwmon/smm665 b/Documentation/hwmon/smm665.rst
similarity index 100%
rename from Documentation/hwmon/smm665
rename to Documentation/hwmon/smm665.rst
diff --git a/Documentation/hwmon/smsc47b397 b/Documentation/hwmon/smsc47b397.rst
similarity index 100%
rename from Documentation/hwmon/smsc47b397
rename to Documentation/hwmon/smsc47b397.rst
diff --git a/Documentation/hwmon/smsc47m1 b/Documentation/hwmon/smsc47m1.rst
similarity index 100%
rename from Documentation/hwmon/smsc47m1
rename to Documentation/hwmon/smsc47m1.rst
diff --git a/Documentation/hwmon/smsc47m192 b/Documentation/hwmon/smsc47m192.rst
similarity index 100%
rename from Documentation/hwmon/smsc47m192
rename to Documentation/hwmon/smsc47m192.rst
diff --git a/Documentation/hwmon/submitting-patches b/Documentation/hwmon/submitting-patches.rst
similarity index 98%
rename from Documentation/hwmon/submitting-patches
rename to Documentation/hwmon/submitting-patches.rst
index 12540b7d9b50..f9796b9d9db6 100644
--- a/Documentation/hwmon/submitting-patches
+++ b/Documentation/hwmon/submitting-patches.rst
@@ -39,7 +39,7 @@ increase the chances of your change being accepted.
 2. Adding functionality to existing drivers
 -------------------------------------------
 
-* Make sure the documentation in Documentation/hwmon/<driver_name> is up to
+* Make sure the documentation in Documentation/hwmon/<driver_name>.rst is up to
   date.
 
 * Make sure the information in Kconfig is up to date.
@@ -61,7 +61,7 @@ increase the chances of your change being accepted.
 
 * Consider adding yourself to MAINTAINERS.
 
-* Document the driver in Documentation/hwmon/<driver_name>.
+* Document the driver in Documentation/hwmon/<driver_name>.rst.
 
 * Add the driver to Kconfig and Makefile in alphabetical order.
 
@@ -134,7 +134,7 @@ increase the chances of your change being accepted.
   non-standard attributes, or you believe you do, discuss it on the mailing list
   first. Either case, provide a detailed explanation why you need the
   non-standard attribute(s).
-  Standard attributes are specified in Documentation/hwmon/sysfs-interface.
+  Standard attributes are specified in Documentation/hwmon/sysfs-interface.rst.
 
 * When deciding which sysfs attributes to support, look at the chip's
   capabilities. While we do not expect your driver to support everything the
diff --git a/Documentation/hwmon/sysfs-interface b/Documentation/hwmon/sysfs-interface.rst
similarity index 100%
rename from Documentation/hwmon/sysfs-interface
rename to Documentation/hwmon/sysfs-interface.rst
diff --git a/Documentation/hwmon/tc654 b/Documentation/hwmon/tc654.rst
similarity index 100%
rename from Documentation/hwmon/tc654
rename to Documentation/hwmon/tc654.rst
diff --git a/Documentation/hwmon/tc74 b/Documentation/hwmon/tc74.rst
similarity index 100%
rename from Documentation/hwmon/tc74
rename to Documentation/hwmon/tc74.rst
diff --git a/Documentation/hwmon/thmc50 b/Documentation/hwmon/thmc50.rst
similarity index 99%
rename from Documentation/hwmon/thmc50
rename to Documentation/hwmon/thmc50.rst
index 6dba1b59b20c..cfff3885287d 100644
--- a/Documentation/hwmon/thmc50
+++ b/Documentation/hwmon/thmc50.rst
@@ -87,4 +87,3 @@ so it stops fans even if the value 0 into the ANALOG_OUT register does not.
 
 The driver was tested on Compaq AP550 with two ADM1022 chips (one works
 in the temp3 mode), five temperature readings and two fans.
-
diff --git a/Documentation/hwmon/tmp102 b/Documentation/hwmon/tmp102.rst
similarity index 93%
rename from Documentation/hwmon/tmp102
rename to Documentation/hwmon/tmp102.rst
index 5e34821df4ab..b1f585531a88 100644
--- a/Documentation/hwmon/tmp102
+++ b/Documentation/hwmon/tmp102.rst
@@ -28,4 +28,4 @@ The TMP102 has a programmable update rate that can select between 8, 4, 1, and
 0.5 Hz. (Currently the driver only supports the default of 4 Hz).
 
 The driver provides the common sysfs-interface for temperatures (see
-Documentation/hwmon/sysfs-interface under Temperatures).
+Documentation/hwmon/sysfs-interface.rst under Temperatures).
diff --git a/Documentation/hwmon/tmp103 b/Documentation/hwmon/tmp103.rst
similarity index 92%
rename from Documentation/hwmon/tmp103
rename to Documentation/hwmon/tmp103.rst
index 7682a795e38c..15d25806d585 100644
--- a/Documentation/hwmon/tmp103
+++ b/Documentation/hwmon/tmp103.rst
@@ -27,7 +27,7 @@ Resolution: 8 Bits
 Accuracy: ±1°C Typ (–10°C to +100°C)
 
 The driver provides the common sysfs-interface for temperatures (see
-Documentation/hwmon/sysfs-interface under Temperatures).
+Documentation/hwmon/sysfs-interface.rst under Temperatures).
 
 Please refer how to instantiate this driver:
 Documentation/i2c/instantiating-devices
diff --git a/Documentation/hwmon/tmp108 b/Documentation/hwmon/tmp108.rst
similarity index 95%
rename from Documentation/hwmon/tmp108
rename to Documentation/hwmon/tmp108.rst
index 7e08b7ef1e2f..5f4266a16cb2 100644
--- a/Documentation/hwmon/tmp108
+++ b/Documentation/hwmon/tmp108.rst
@@ -38,4 +38,4 @@ and then the device is shut down automatically. (This driver only supports
 continuous mode.)
 
 The driver provides the common sysfs-interface for temperatures (see
-Documentation/hwmon/sysfs-interface under Temperatures).
+Documentation/hwmon/sysfs-interface.rst under Temperatures).
diff --git a/Documentation/hwmon/tmp401 b/Documentation/hwmon/tmp401.rst
similarity index 97%
rename from Documentation/hwmon/tmp401
rename to Documentation/hwmon/tmp401.rst
index bd865bbdb38d..6a05a0719bc7 100644
--- a/Documentation/hwmon/tmp401
+++ b/Documentation/hwmon/tmp401.rst
@@ -68,7 +68,7 @@ supported by the driver so far, so using the default resolution of 0.5
 degree).
 
 The driver provides the common sysfs-interface for temperatures (see
-Documentation/hwmon/sysfs-interface under Temperatures).
+Documentation/hwmon/sysfs-interface.rst under Temperatures).
 
 The TMP411 and TMP431 chips are compatible with TMP401. TMP411 provides
 some additional features.
diff --git a/Documentation/hwmon/tmp421 b/Documentation/hwmon/tmp421.rst
similarity index 100%
rename from Documentation/hwmon/tmp421
rename to Documentation/hwmon/tmp421.rst
diff --git a/Documentation/hwmon/tps40422 b/Documentation/hwmon/tps40422.rst
similarity index 96%
rename from Documentation/hwmon/tps40422
rename to Documentation/hwmon/tps40422.rst
index 359751eb5ed4..b691e30479dd 100644
--- a/Documentation/hwmon/tps40422
+++ b/Documentation/hwmon/tps40422.rst
@@ -21,7 +21,7 @@ This driver supports TI TPS40422 Dual-Output or Two-Phase Synchronous Buck
 Controller with PMBus
 
 The driver is a client driver to the core PMBus driver.
-Please see Documentation/hwmon/pmbus for details on PMBus client drivers.
+Please see Documentation/hwmon/pmbus.rst for details on PMBus client drivers.
 
 
 Usage Notes
diff --git a/Documentation/hwmon/twl4030-madc-hwmon b/Documentation/hwmon/twl4030-madc-hwmon.rst
similarity index 100%
rename from Documentation/hwmon/twl4030-madc-hwmon
rename to Documentation/hwmon/twl4030-madc-hwmon.rst
diff --git a/Documentation/hwmon/ucd9000 b/Documentation/hwmon/ucd9000.rst
similarity index 97%
rename from Documentation/hwmon/ucd9000
rename to Documentation/hwmon/ucd9000.rst
index d69061b7312c..ebc4f2b3bfea 100644
--- a/Documentation/hwmon/ucd9000
+++ b/Documentation/hwmon/ucd9000.rst
@@ -57,7 +57,7 @@ system-health monitor. The device integrates a 12-bit ADC for monitoring up to
 13 power-supply voltage, current, or temperature inputs.
 
 This driver is a client driver to the core PMBus driver. Please see
-Documentation/hwmon/pmbus for details on PMBus client drivers.
+Documentation/hwmon/pmbus.rst for details on PMBus client drivers.
 
 
 Usage Notes
@@ -72,7 +72,7 @@ Platform data support
 ---------------------
 
 The driver supports standard PMBus driver platform data. Please see
-Documentation/hwmon/pmbus for details.
+Documentation/hwmon/pmbus.rst for details.
 
 
 Sysfs entries
diff --git a/Documentation/hwmon/ucd9200 b/Documentation/hwmon/ucd9200.rst
similarity index 97%
rename from Documentation/hwmon/ucd9200
rename to Documentation/hwmon/ucd9200.rst
index 44eda4a579b6..b819dfd75f71 100644
--- a/Documentation/hwmon/ucd9200
+++ b/Documentation/hwmon/ucd9200.rst
@@ -33,7 +33,7 @@ dedicated circuitry for DC/DC loop management with flash memory and a serial
 interface to support configuration, monitoring and management.
 
 This driver is a client driver to the core PMBus driver. Please see
-Documentation/hwmon/pmbus for details on PMBus client drivers.
+Documentation/hwmon/pmbus.rst for details on PMBus client drivers.
 
 
 Usage Notes
@@ -48,7 +48,7 @@ Platform data support
 ---------------------
 
 The driver supports standard PMBus driver platform data. Please see
-Documentation/hwmon/pmbus for details.
+Documentation/hwmon/pmbus.rst for details.
 
 
 Sysfs entries
diff --git a/Documentation/hwmon/userspace-tools b/Documentation/hwmon/userspace-tools.rst
similarity index 100%
rename from Documentation/hwmon/userspace-tools
rename to Documentation/hwmon/userspace-tools.rst
diff --git a/Documentation/hwmon/vexpress b/Documentation/hwmon/vexpress.rst
similarity index 100%
rename from Documentation/hwmon/vexpress
rename to Documentation/hwmon/vexpress.rst
diff --git a/Documentation/hwmon/via686a b/Documentation/hwmon/via686a.rst
similarity index 100%
rename from Documentation/hwmon/via686a
rename to Documentation/hwmon/via686a.rst
diff --git a/Documentation/hwmon/vt1211 b/Documentation/hwmon/vt1211.rst
similarity index 100%
rename from Documentation/hwmon/vt1211
rename to Documentation/hwmon/vt1211.rst
diff --git a/Documentation/hwmon/w83627ehf b/Documentation/hwmon/w83627ehf.rst
similarity index 100%
rename from Documentation/hwmon/w83627ehf
rename to Documentation/hwmon/w83627ehf.rst
diff --git a/Documentation/hwmon/w83627hf b/Documentation/hwmon/w83627hf.rst
similarity index 100%
rename from Documentation/hwmon/w83627hf
rename to Documentation/hwmon/w83627hf.rst
diff --git a/Documentation/hwmon/w83773g b/Documentation/hwmon/w83773g.rst
similarity index 100%
rename from Documentation/hwmon/w83773g
rename to Documentation/hwmon/w83773g.rst
diff --git a/Documentation/hwmon/w83781d b/Documentation/hwmon/w83781d.rst
similarity index 100%
rename from Documentation/hwmon/w83781d
rename to Documentation/hwmon/w83781d.rst
diff --git a/Documentation/hwmon/w83791d b/Documentation/hwmon/w83791d.rst
similarity index 99%
rename from Documentation/hwmon/w83791d
rename to Documentation/hwmon/w83791d.rst
index a91f9e5fb0c6..3adaed39b157 100644
--- a/Documentation/hwmon/w83791d
+++ b/Documentation/hwmon/w83791d.rst
@@ -102,7 +102,7 @@ This file is used for both legacy and new code.
 
 The sysfs interface to the beep bitmask has migrated from the original legacy
 method of a single sysfs beep_mask file to a newer method using multiple
-`*_beep` files as described in `Documentation/hwmon/sysfs-interface`.
+`*_beep` files as described in `Documentation/hwmon/sysfs-interface.rst`.
 
 A similar change has occurred for the bitmap corresponding to the alarms. The
 original legacy method used a single sysfs alarms file containing a bitmap
diff --git a/Documentation/hwmon/w83792d b/Documentation/hwmon/w83792d.rst
similarity index 100%
rename from Documentation/hwmon/w83792d
rename to Documentation/hwmon/w83792d.rst
diff --git a/Documentation/hwmon/w83793 b/Documentation/hwmon/w83793.rst
similarity index 100%
rename from Documentation/hwmon/w83793
rename to Documentation/hwmon/w83793.rst
diff --git a/Documentation/hwmon/w83795 b/Documentation/hwmon/w83795.rst
similarity index 100%
rename from Documentation/hwmon/w83795
rename to Documentation/hwmon/w83795.rst
diff --git a/Documentation/hwmon/w83l785ts b/Documentation/hwmon/w83l785ts.rst
similarity index 100%
rename from Documentation/hwmon/w83l785ts
rename to Documentation/hwmon/w83l785ts.rst
diff --git a/Documentation/hwmon/w83l786ng b/Documentation/hwmon/w83l786ng.rst
similarity index 100%
rename from Documentation/hwmon/w83l786ng
rename to Documentation/hwmon/w83l786ng.rst
diff --git a/Documentation/hwmon/wm831x b/Documentation/hwmon/wm831x.rst
similarity index 100%
rename from Documentation/hwmon/wm831x
rename to Documentation/hwmon/wm831x.rst
diff --git a/Documentation/hwmon/wm8350 b/Documentation/hwmon/wm8350.rst
similarity index 100%
rename from Documentation/hwmon/wm8350
rename to Documentation/hwmon/wm8350.rst
diff --git a/Documentation/hwmon/xgene-hwmon b/Documentation/hwmon/xgene-hwmon.rst
similarity index 100%
rename from Documentation/hwmon/xgene-hwmon
rename to Documentation/hwmon/xgene-hwmon.rst
diff --git a/Documentation/hwmon/zl6100 b/Documentation/hwmon/zl6100.rst
similarity index 98%
rename from Documentation/hwmon/zl6100
rename to Documentation/hwmon/zl6100.rst
index 4029970bace4..41513bb7fe51 100644
--- a/Documentation/hwmon/zl6100
+++ b/Documentation/hwmon/zl6100.rst
@@ -113,7 +113,7 @@ This driver supports hardware monitoring for Intersil / Zilker Labs ZL6100 and
 compatible digital DC-DC controllers.
 
 The driver is a client driver to the core PMBus driver. Please see
-Documentation/hwmon/pmbus and Documentation.hwmon/pmbus-core for details
+Documentation/hwmon/pmbus.rst and Documentation.hwmon/pmbus-core for details
 on PMBus client drivers.
 
 
diff --git a/Documentation/index.rst b/Documentation/index.rst
index 80a421cb935e..3a710dc24fc8 100644
--- a/Documentation/index.rst
+++ b/Documentation/index.rst
@@ -83,6 +83,7 @@ needed).
    media/index
    networking/index
    input/index
+   hwmon/index
    gpu/index
    security/index
    sound/index
diff --git a/Documentation/thermal/sysfs-api.txt b/Documentation/thermal/sysfs-api.txt
index 911399730c1c..c3fa500df92c 100644
--- a/Documentation/thermal/sysfs-api.txt
+++ b/Documentation/thermal/sysfs-api.txt
@@ -316,7 +316,7 @@ ACPI thermal zones.
     |---temp[1-*]_input:	The current temperature of thermal zone [1-*]
     |---temp[1-*]_critical:	The critical trip point of thermal zone [1-*]
 
-Please read Documentation/hwmon/sysfs-interface for additional information.
+Please read Documentation/hwmon/sysfs-interface.rst for additional information.
 
 ***************************
 * Thermal zone attributes *
diff --git a/MAINTAINERS b/MAINTAINERS
index 349e5d8c3f58..6269c9d671ca 100644
--- a/MAINTAINERS
+++ b/MAINTAINERS
@@ -468,7 +468,7 @@ ADM1025 HARDWARE MONITOR DRIVER
 M:	Jean Delvare <jdelvare@suse.com>
 L:	linux-hwmon@vger.kernel.org
 S:	Maintained
-F:	Documentation/hwmon/adm1025
+F:	Documentation/hwmon/adm1025.rst
 F:	drivers/hwmon/adm1025.c
 
 ADM1029 HARDWARE MONITOR DRIVER
@@ -520,7 +520,7 @@ ADS1015 HARDWARE MONITOR DRIVER
 M:	Dirk Eibach <eibach@gdsys.de>
 L:	linux-hwmon@vger.kernel.org
 S:	Maintained
-F:	Documentation/hwmon/ads1015
+F:	Documentation/hwmon/ads1015.rst
 F:	drivers/hwmon/ads1015.c
 F:	include/linux/platform_data/ads1015.h
 
@@ -533,7 +533,7 @@ ADT7475 HARDWARE MONITOR DRIVER
 M:	Jean Delvare <jdelvare@suse.com>
 L:	linux-hwmon@vger.kernel.org
 S:	Maintained
-F:	Documentation/hwmon/adt7475
+F:	Documentation/hwmon/adt7475.rst
 F:	drivers/hwmon/adt7475.c
 
 ADVANSYS SCSI DRIVER
@@ -764,7 +764,7 @@ AMD FAM15H PROCESSOR POWER MONITORING DRIVER
 M:	Huang Rui <ray.huang@amd.com>
 L:	linux-hwmon@vger.kernel.org
 S:	Supported
-F:	Documentation/hwmon/fam15h_power
+F:	Documentation/hwmon/fam15h_power.rst
 F:	drivers/hwmon/fam15h_power.c
 
 AMD FCH GPIO DRIVER
@@ -2531,7 +2531,7 @@ ASC7621 HARDWARE MONITOR DRIVER
 M:	George Joseph <george.joseph@fairview5.com>
 L:	linux-hwmon@vger.kernel.org
 S:	Maintained
-F:	Documentation/hwmon/asc7621
+F:	Documentation/hwmon/asc7621.rst
 F:	drivers/hwmon/asc7621.c
 
 ASPEED VIDEO ENGINE DRIVER
@@ -4071,7 +4071,7 @@ CORETEMP HARDWARE MONITORING DRIVER
 M:	Fenghua Yu <fenghua.yu@intel.com>
 L:	linux-hwmon@vger.kernel.org
 S:	Maintained
-F:	Documentation/hwmon/coretemp
+F:	Documentation/hwmon/coretemp.rst
 F:	drivers/hwmon/coretemp.c
 
 COSA/SRP SYNC SERIAL DRIVER
@@ -4627,7 +4627,7 @@ DIALOG SEMICONDUCTOR DRIVERS
 M:	Support Opensource <support.opensource@diasemi.com>
 W:	http://www.dialog-semiconductor.com/products
 S:	Supported
-F:	Documentation/hwmon/da90??
+F:	Documentation/hwmon/da90??.rst
 F:	Documentation/devicetree/bindings/mfd/da90*.txt
 F:	Documentation/devicetree/bindings/input/da90??-onkey.txt
 F:	Documentation/devicetree/bindings/thermal/da90??-thermal.txt
@@ -4778,7 +4778,7 @@ DME1737 HARDWARE MONITOR DRIVER
 M:	Juerg Haefliger <juergh@gmail.com>
 L:	linux-hwmon@vger.kernel.org
 S:	Maintained
-F:	Documentation/hwmon/dme1737
+F:	Documentation/hwmon/dme1737.rst
 F:	drivers/hwmon/dme1737.c
 
 DMI/SMBIOS SUPPORT
@@ -6006,7 +6006,7 @@ F71805F HARDWARE MONITORING DRIVER
 M:	Jean Delvare <jdelvare@suse.com>
 L:	linux-hwmon@vger.kernel.org
 S:	Maintained
-F:	Documentation/hwmon/f71805f
+F:	Documentation/hwmon/f71805f.rst
 F:	drivers/hwmon/f71805f.c
 
 FADDR2LINE
@@ -7687,7 +7687,7 @@ INA209 HARDWARE MONITOR DRIVER
 M:	Guenter Roeck <linux@roeck-us.net>
 L:	linux-hwmon@vger.kernel.org
 S:	Maintained
-F:	Documentation/hwmon/ina209
+F:	Documentation/hwmon/ina209.rst
 F:	Documentation/devicetree/bindings/hwmon/ina2xx.txt
 F:	drivers/hwmon/ina209.c
 
@@ -7695,7 +7695,7 @@ INA2XX HARDWARE MONITOR DRIVER
 M:	Guenter Roeck <linux@roeck-us.net>
 L:	linux-hwmon@vger.kernel.org
 S:	Maintained
-F:	Documentation/hwmon/ina2xx
+F:	Documentation/hwmon/ina2xx.rst
 F:	drivers/hwmon/ina2xx.c
 F:	include/linux/platform_data/ina2xx.h
 
@@ -8328,7 +8328,7 @@ IT87 HARDWARE MONITORING DRIVER
 M:	Jean Delvare <jdelvare@suse.com>
 L:	linux-hwmon@vger.kernel.org
 S:	Maintained
-F:	Documentation/hwmon/it87
+F:	Documentation/hwmon/it87.rst
 F:	drivers/hwmon/it87.c
 
 IT913X MEDIA DRIVER
@@ -8372,7 +8372,7 @@ M:	Guenter Roeck <linux@roeck-us.net>
 L:	linux-hwmon@vger.kernel.org
 S:	Maintained
 F:	drivers/hwmon/jc42.c
-F:	Documentation/hwmon/jc42
+F:	Documentation/hwmon/jc42.rst
 
 JFS FILESYSTEM
 M:	Dave Kleikamp <shaggy@kernel.org>
@@ -8420,14 +8420,14 @@ K10TEMP HARDWARE MONITORING DRIVER
 M:	Clemens Ladisch <clemens@ladisch.de>
 L:	linux-hwmon@vger.kernel.org
 S:	Maintained
-F:	Documentation/hwmon/k10temp
+F:	Documentation/hwmon/k10temp.rst
 F:	drivers/hwmon/k10temp.c
 
 K8TEMP HARDWARE MONITORING DRIVER
 M:	Rudolf Marek <r.marek@assembler.cz>
 L:	linux-hwmon@vger.kernel.org
 S:	Maintained
-F:	Documentation/hwmon/k8temp
+F:	Documentation/hwmon/k8temp.rst
 F:	drivers/hwmon/k8temp.c
 
 KASAN
@@ -9118,21 +9118,21 @@ LM78 HARDWARE MONITOR DRIVER
 M:	Jean Delvare <jdelvare@suse.com>
 L:	linux-hwmon@vger.kernel.org
 S:	Maintained
-F:	Documentation/hwmon/lm78
+F:	Documentation/hwmon/lm78.rst
 F:	drivers/hwmon/lm78.c
 
 LM83 HARDWARE MONITOR DRIVER
 M:	Jean Delvare <jdelvare@suse.com>
 L:	linux-hwmon@vger.kernel.org
 S:	Maintained
-F:	Documentation/hwmon/lm83
+F:	Documentation/hwmon/lm83.rst
 F:	drivers/hwmon/lm83.c
 
 LM90 HARDWARE MONITOR DRIVER
 M:	Jean Delvare <jdelvare@suse.com>
 L:	linux-hwmon@vger.kernel.org
 S:	Maintained
-F:	Documentation/hwmon/lm90
+F:	Documentation/hwmon/lm90.rst
 F:	Documentation/devicetree/bindings/hwmon/lm90.txt
 F:	drivers/hwmon/lm90.c
 F:	include/dt-bindings/thermal/lm90.h
@@ -9141,7 +9141,7 @@ LM95234 HARDWARE MONITOR DRIVER
 M:	Guenter Roeck <linux@roeck-us.net>
 L:	linux-hwmon@vger.kernel.org
 S:	Maintained
-F:	Documentation/hwmon/lm95234
+F:	Documentation/hwmon/lm95234.rst
 F:	drivers/hwmon/lm95234.c
 
 LME2510 MEDIA DRIVER
@@ -9214,7 +9214,7 @@ LTC4261 HARDWARE MONITOR DRIVER
 M:	Guenter Roeck <linux@roeck-us.net>
 L:	linux-hwmon@vger.kernel.org
 S:	Maintained
-F:	Documentation/hwmon/ltc4261
+F:	Documentation/hwmon/ltc4261.rst
 F:	drivers/hwmon/ltc4261.c
 
 LTC4306 I2C MULTIPLEXER DRIVER
@@ -9445,7 +9445,7 @@ MAX16065 HARDWARE MONITOR DRIVER
 M:	Guenter Roeck <linux@roeck-us.net>
 L:	linux-hwmon@vger.kernel.org
 S:	Maintained
-F:	Documentation/hwmon/max16065
+F:	Documentation/hwmon/max16065.rst
 F:	drivers/hwmon/max16065.c
 
 MAX2175 SDR TUNER DRIVER
@@ -9461,14 +9461,14 @@ F:	include/uapi/linux/max2175.h
 MAX6650 HARDWARE MONITOR AND FAN CONTROLLER DRIVER
 L:	linux-hwmon@vger.kernel.org
 S:	Orphan
-F:	Documentation/hwmon/max6650
+F:	Documentation/hwmon/max6650.rst
 F:	drivers/hwmon/max6650.c
 
 MAX6697 HARDWARE MONITOR DRIVER
 M:	Guenter Roeck <linux@roeck-us.net>
 L:	linux-hwmon@vger.kernel.org
 S:	Maintained
-F:	Documentation/hwmon/max6697
+F:	Documentation/hwmon/max6697.rst
 F:	Documentation/devicetree/bindings/hwmon/max6697.txt
 F:	drivers/hwmon/max6697.c
 F:	include/linux/platform_data/max6697.h
@@ -10118,7 +10118,7 @@ F:	drivers/mfd/menf21bmc.c
 F:	drivers/watchdog/menf21bmc_wdt.c
 F:	drivers/leds/leds-menf21bmc.c
 F:	drivers/hwmon/menf21bmc_hwmon.c
-F:	Documentation/hwmon/menf21bmc
+F:	Documentation/hwmon/menf21bmc.rst
 
 MEN Z069 WATCHDOG DRIVER
 M:	Johannes Thumshirn <jth@kernel.org>
@@ -10747,7 +10747,7 @@ NCT6775 HARDWARE MONITOR DRIVER
 M:	Guenter Roeck <linux@roeck-us.net>
 L:	linux-hwmon@vger.kernel.org
 S:	Maintained
-F:	Documentation/hwmon/nct6775
+F:	Documentation/hwmon/nct6775.rst
 F:	drivers/hwmon/nct6775.c
 
 NET_FAILOVER MODULE
@@ -11841,7 +11841,7 @@ PC87360 HARDWARE MONITORING DRIVER
 M:	Jim Cromie <jim.cromie@gmail.com>
 L:	linux-hwmon@vger.kernel.org
 S:	Maintained
-F:	Documentation/hwmon/pc87360
+F:	Documentation/hwmon/pc87360.rst
 F:	drivers/hwmon/pc87360.c
 
 PC8736x GPIO DRIVER
@@ -11853,7 +11853,7 @@ PC87427 HARDWARE MONITORING DRIVER
 M:	Jean Delvare <jdelvare@suse.com>
 L:	linux-hwmon@vger.kernel.org
 S:	Maintained
-F:	Documentation/hwmon/pc87427
+F:	Documentation/hwmon/pc87427.rst
 F:	drivers/hwmon/pc87427.c
 
 PCA9532 LED DRIVER
@@ -12421,23 +12421,23 @@ S:	Maintained
 F:	Documentation/devicetree/bindings/hwmon/ibm,cffps1.txt
 F:	Documentation/devicetree/bindings/hwmon/max31785.txt
 F:	Documentation/devicetree/bindings/hwmon/ltc2978.txt
-F:	Documentation/hwmon/adm1275
-F:	Documentation/hwmon/ibm-cffps
-F:	Documentation/hwmon/ir35221
-F:	Documentation/hwmon/lm25066
-F:	Documentation/hwmon/ltc2978
-F:	Documentation/hwmon/ltc3815
-F:	Documentation/hwmon/max16064
-F:	Documentation/hwmon/max20751
-F:	Documentation/hwmon/max31785
-F:	Documentation/hwmon/max34440
-F:	Documentation/hwmon/max8688
-F:	Documentation/hwmon/pmbus
-F:	Documentation/hwmon/pmbus-core
-F:	Documentation/hwmon/tps40422
-F:	Documentation/hwmon/ucd9000
-F:	Documentation/hwmon/ucd9200
-F:	Documentation/hwmon/zl6100
+F:	Documentation/hwmon/adm1275.rst
+F:	Documentation/hwmon/ibm-cffps.rst
+F:	Documentation/hwmon/ir35221.rst
+F:	Documentation/hwmon/lm25066.rst
+F:	Documentation/hwmon/ltc2978.rst
+F:	Documentation/hwmon/ltc3815.rst
+F:	Documentation/hwmon/max16064.rst
+F:	Documentation/hwmon/max20751.rst
+F:	Documentation/hwmon/max31785.rst
+F:	Documentation/hwmon/max34440.rst
+F:	Documentation/hwmon/max8688.rst
+F:	Documentation/hwmon/pmbus.rst
+F:	Documentation/hwmon/pmbus-core.rst
+F:	Documentation/hwmon/tps40422.rst
+F:	Documentation/hwmon/ucd9000.rst
+F:	Documentation/hwmon/ucd9200.rst
+F:	Documentation/hwmon/zl6100.rst
 F:	drivers/hwmon/pmbus/
 F:	include/linux/pmbus.h
 
@@ -12701,7 +12701,7 @@ M:	Bartlomiej Zolnierkiewicz <b.zolnierkie@samsung.com>
 L:	linux-hwmon@vger.kernel.org
 S:	Supported
 F:	Documentation/devicetree/bindings/hwmon/pwm-fan.txt
-F:	Documentation/hwmon/pwm-fan
+F:	Documentation/hwmon/pwm-fan.rst
 F:	drivers/hwmon/pwm-fan.c
 
 PWM IR Transmitter
@@ -14366,21 +14366,21 @@ SMM665 HARDWARE MONITOR DRIVER
 M:	Guenter Roeck <linux@roeck-us.net>
 L:	linux-hwmon@vger.kernel.org
 S:	Maintained
-F:	Documentation/hwmon/smm665
+F:	Documentation/hwmon/smm665.rst
 F:	drivers/hwmon/smm665.c
 
 SMSC EMC2103 HARDWARE MONITOR DRIVER
 M:	Steve Glendinning <steve.glendinning@shawell.net>
 L:	linux-hwmon@vger.kernel.org
 S:	Maintained
-F:	Documentation/hwmon/emc2103
+F:	Documentation/hwmon/emc2103.rst
 F:	drivers/hwmon/emc2103.c
 
 SMSC SCH5627 HARDWARE MONITOR DRIVER
 M:	Hans de Goede <hdegoede@redhat.com>
 L:	linux-hwmon@vger.kernel.org
 S:	Supported
-F:	Documentation/hwmon/sch5627
+F:	Documentation/hwmon/sch5627.rst
 F:	drivers/hwmon/sch5627.c
 
 SMSC UFX6000 and UFX7000 USB to VGA DRIVER
@@ -14393,7 +14393,7 @@ SMSC47B397 HARDWARE MONITOR DRIVER
 M:	Jean Delvare <jdelvare@suse.com>
 L:	linux-hwmon@vger.kernel.org
 S:	Maintained
-F:	Documentation/hwmon/smsc47b397
+F:	Documentation/hwmon/smsc47b397.rst
 F:	drivers/hwmon/smsc47b397.c
 
 SMSC911x ETHERNET DRIVER
@@ -15744,7 +15744,7 @@ TMP401 HARDWARE MONITOR DRIVER
 M:	Guenter Roeck <linux@roeck-us.net>
 L:	linux-hwmon@vger.kernel.org
 S:	Maintained
-F:	Documentation/hwmon/tmp401
+F:	Documentation/hwmon/tmp401.rst
 F:	drivers/hwmon/tmp401.c
 
 TMPFS (SHMEM FILESYSTEM)
@@ -16796,7 +16796,7 @@ VT1211 HARDWARE MONITOR DRIVER
 M:	Juerg Haefliger <juergh@gmail.com>
 L:	linux-hwmon@vger.kernel.org
 S:	Maintained
-F:	Documentation/hwmon/vt1211
+F:	Documentation/hwmon/vt1211.rst
 F:	drivers/hwmon/vt1211.c
 
 VT8231 HARDWARE MONITOR DRIVER
@@ -16824,14 +16824,14 @@ W83791D HARDWARE MONITORING DRIVER
 M:	Marc Hulsman <m.hulsman@tudelft.nl>
 L:	linux-hwmon@vger.kernel.org
 S:	Maintained
-F:	Documentation/hwmon/w83791d
+F:	Documentation/hwmon/w83791d.rst
 F:	drivers/hwmon/w83791d.c
 
 W83793 HARDWARE MONITORING DRIVER
 M:	Rudolf Marek <r.marek@assembler.cz>
 L:	linux-hwmon@vger.kernel.org
 S:	Maintained
-F:	Documentation/hwmon/w83793
+F:	Documentation/hwmon/w83793.rst
 F:	drivers/hwmon/w83793.c
 
 W83795 HARDWARE MONITORING DRIVER
@@ -16940,7 +16940,7 @@ L:	patches@opensource.cirrus.com
 T:	git https://github.com/CirrusLogic/linux-drivers.git
 W:	https://github.com/CirrusLogic/linux-drivers/wiki
 S:	Supported
-F:	Documentation/hwmon/wm83??
+F:	Documentation/hwmon/wm83??.rst
 F:	Documentation/devicetree/bindings/extcon/extcon-arizona.txt
 F:	Documentation/devicetree/bindings/regulator/arizona-regulator.txt
 F:	Documentation/devicetree/bindings/mfd/arizona.txt
diff --git a/drivers/hwmon/Kconfig b/drivers/hwmon/Kconfig
index dedd5febd3aa..470ba66b18b0 100644
--- a/drivers/hwmon/Kconfig
+++ b/drivers/hwmon/Kconfig
@@ -17,7 +17,7 @@ menuconfig HWMON
 
 	  To find out which specific driver(s) you need, use the
 	  sensors-detect script from the lm_sensors package.  Read
-	  <file:Documentation/hwmon/userspace-tools> for details.
+	  <file:Documentation/hwmon/userspace-tools.rst> for details.
 
 	  This support can also be built as a module. If so, the module
 	  will be called hwmon.
@@ -59,7 +59,7 @@ config SENSORS_ABITUGURU
 	  chip can be found on Abit uGuru featuring motherboards (most modern
 	  Abit motherboards from before end 2005). For more info and a list
 	  of which motherboards have which revision see
-	  Documentation/hwmon/abituguru
+	  Documentation/hwmon/abituguru.rst
 
 	  This driver can also be built as a module. If so, the module
 	  will be called abituguru.
@@ -73,7 +73,7 @@ config SENSORS_ABITUGURU3
 	  and their settings is supported. The third revision of the Abit
 	  uGuru chip can be found on recent Abit motherboards (since end
 	  2005). For more info and a list of which motherboards have which
-	  revision see Documentation/hwmon/abituguru3
+	  revision see Documentation/hwmon/abituguru3.rst
 
 	  This driver can also be built as a module. If so, the module
 	  will be called abituguru3.
@@ -643,7 +643,7 @@ config SENSORS_CORETEMP
 	help
 	  If you say yes here you get support for the temperature
 	  sensor inside your CPU. Most of the family 6 CPUs
-	  are supported. Check Documentation/hwmon/coretemp for details.
+	  are supported. Check Documentation/hwmon/coretemp.rst for details.
 
 config SENSORS_IT87
 	tristate "ITE IT87xx and compatibles"
diff --git a/drivers/hwmon/ads7828.c b/drivers/hwmon/ads7828.c
index e6be617e3fb2..03d6e782777a 100644
--- a/drivers/hwmon/ads7828.c
+++ b/drivers/hwmon/ads7828.c
@@ -8,7 +8,7 @@
  *
  * ADS7830 support, by Guillaume Roguez <guillaume.roguez@savoirfairelinux.com>
  *
- * For further information, see the Documentation/hwmon/ads7828 file.
+ * For further information, see the Documentation/hwmon/ads7828.rst file.
  *
  * This program is free software; you can redistribute it and/or modify
  * it under the terms of the GNU General Public License as published by
diff --git a/drivers/hwmon/max197.c b/drivers/hwmon/max197.c
index 3d9e210beedf..dd6a35219a18 100644
--- a/drivers/hwmon/max197.c
+++ b/drivers/hwmon/max197.c
@@ -8,7 +8,7 @@
  * it under the terms of the GNU General Public License version 2 as
  * published by the Free Software Foundation.
  *
- * For further information, see the Documentation/hwmon/max197 file.
+ * For further information, see the Documentation/hwmon/max197.rst file.
  */
 
 #include <linux/kernel.h>
diff --git a/drivers/hwmon/sht15.c b/drivers/hwmon/sht15.c
index 39b41e35c2bf..7f4a63959730 100644
--- a/drivers/hwmon/sht15.c
+++ b/drivers/hwmon/sht15.c
@@ -10,7 +10,7 @@
  *
  * Copyright (c) 2007 Wouter Horre
  *
- * For further information, see the Documentation/hwmon/sht15 file.
+ * For further information, see the Documentation/hwmon/sht15.rst file.
  */
 
 #include <linux/interrupt.h>
diff --git a/include/linux/platform_data/ads7828.h b/include/linux/platform_data/ads7828.h
index 3245f45f9d77..a3370a007702 100644
--- a/include/linux/platform_data/ads7828.h
+++ b/include/linux/platform_data/ads7828.h
@@ -4,7 +4,7 @@
  * Copyright (c) 2012 Savoir-faire Linux Inc.
  *          Vivien Didelot <vivien.didelot@savoirfairelinux.com>
  *
- * For further information, see the Documentation/hwmon/ads7828 file.
+ * For further information, see the Documentation/hwmon/ads7828.rst file.
  *
  * This program is free software; you can redistribute it and/or modify
  * it under the terms of the GNU General Public License version 2 as
diff --git a/include/linux/platform_data/ds620.h b/include/linux/platform_data/ds620.h
index 6ef58bb77e46..f0ce22a78bb8 100644
--- a/include/linux/platform_data/ds620.h
+++ b/include/linux/platform_data/ds620.h
@@ -14,7 +14,7 @@ struct ds620_platform_data {
 	 *  1 = PO_LOW
 	 *  2 = PO_HIGH
 	 *
-	 * (see Documentation/hwmon/ds620)
+	 * (see Documentation/hwmon/ds620.rst)
 	 */
 	int pomode;
 };
diff --git a/include/linux/platform_data/ina2xx.h b/include/linux/platform_data/ina2xx.h
index 9f0aa1b48c78..dde59fd3590f 100644
--- a/include/linux/platform_data/ina2xx.h
+++ b/include/linux/platform_data/ina2xx.h
@@ -7,7 +7,7 @@
  * it under the terms of the GNU General Public License version 2 as
  * published by the Free Software Foundation.
  *
- * For further information, see the Documentation/hwmon/ina2xx file.
+ * For further information, see the Documentation/hwmon/ina2xx.rst file.
  */
 
 /**
diff --git a/include/linux/platform_data/max197.h b/include/linux/platform_data/max197.h
index 8da8f94ee15c..2bbd0919bc89 100644
--- a/include/linux/platform_data/max197.h
+++ b/include/linux/platform_data/max197.h
@@ -8,7 +8,7 @@
  * it under the terms of the GNU General Public License version 2 as
  * published by the Free Software Foundation.
  *
- * For further information, see the Documentation/hwmon/max197 file.
+ * For further information, see the Documentation/hwmon/max197.rst file.
  */
 
 #ifndef _PDATA_MAX197_H
diff --git a/include/linux/platform_data/ntc_thermistor.h b/include/linux/platform_data/ntc_thermistor.h
index ee03d429742b..5fa115d3ea4b 100644
--- a/include/linux/platform_data/ntc_thermistor.h
+++ b/include/linux/platform_data/ntc_thermistor.h
@@ -42,7 +42,7 @@ struct ntc_thermistor_platform_data {
 	 * read_uV()
 	 *
 	 * How to setup pullup_ohm, pulldown_ohm, and connect is
-	 * described at Documentation/hwmon/ntc_thermistor
+	 * described at Documentation/hwmon/ntc_thermistor.rst
 	 *
 	 * pullup/down_ohm: 0 for infinite / not-connected
 	 *
-- 
2.20.1


^ permalink raw reply related	[flat|nested] 73+ messages in thread

* Re: [PATCH v2 00/21] Convert hwmon documentation to ReST
  2019-04-17  3:49                 ` Guenter Roeck
  2019-04-17  9:46                   ` [PATCH v3 00/21]Convert " Mauro Carvalho Chehab
@ 2019-04-17  9:47                   ` Mauro Carvalho Chehab
  1 sibling, 0 replies; 73+ messages in thread
From: Mauro Carvalho Chehab @ 2019-04-17  9:47 UTC (permalink / raw)
  To: Guenter Roeck
  Cc: Jonathan Corbet, Linux Doc Mailing List, Mauro Carvalho Chehab,
	linux-kernel, Andrew Jeffery, Benjamin Herrenschmidt,
	Jean Delvare, Joel Stanley, linux-arm-kernel, linux-aspeed,
	linux-hwmon, linuxppc-dev, Liviu Dudau, Lorenzo Pieralisi,
	Michael Ellerman, Paul Mackerras, Sudeep Holla

Em Tue, 16 Apr 2019 20:49:31 -0700
Guenter Roeck <linux@roeck-us.net> escreveu:

> On 4/16/19 6:58 PM, Mauro Carvalho Chehab wrote:
> > Em Tue, 16 Apr 2019 13:31:14 -0700
> > Guenter Roeck <linux@roeck-us.net> escreveu:
> >   
> >> On Tue, Apr 16, 2019 at 02:19:49PM -0600, Jonathan Corbet wrote:  
> >>> On Fri, 12 Apr 2019 20:09:16 -0700
> >>> Guenter Roeck <linux@roeck-us.net> wrote:
> >>>      
> >>>> The big real-world question is: Is the series good enough for you to accept,
> >>>> or do you expect some level of user/kernel separation ?  
> >>>
> >>> I guess it can go in; it's forward progress, even if it doesn't make the
> >>> improvements I would like to see.
> >>>
> >>> The real question, I guess, is who should take it.  I've been seeing a
> >>> fair amount of activity on hwmon, so I suspect that the potential for
> >>> conflicts is real.  Perhaps things would go smoother if it went through
> >>> your tree?
> >>>      
> >> We'll see a number of conflicts, yes. In terms of timing, this is probably
> >> the worst release in the last few years to make such a change. I currently
> >> have 9 patches queued in hwmon-next which touch Documentation/hwmon.
> >> Of course the changes made in those are all not ReST compatible, and I have
> >> no idea what to look out for to make it compatible. So this is going to be
> >> fun (in a negative sense) either way.
> >>
> >> I don't really have a recommendation at this point; I think the best I could
> >> do to take the patches which don't generate conflicts and leave the rest
> >> alone. But that would also be bad, since the new index file would not match
> >> reality. No idea, really, what the best or even a useful approach would be.
> >>
> >> Maybe automated changes like this (assuming they are indeed automated)
> >> can be generated and pushed right after a commit window closes. Would
> >> that by any chance be possible ?  
> > 
> > No, those patches are hand-maid, but I can surely rebase it on the top of
> > your tree. Is your tree already merged at linux-next, or should I use some
> > other branch/tree for rebase?
> >   
> 
> linux-next merges hwmon-next. next-20190416 is missing one patch which touches
> Documentation/hwmon, but that should be easy to deal with.

Ok, did a rebase on the top of next-20190417. While re-reading the output
of the html files, I noticed a few minor issues on some tables and fixed.

Thanks,
Mauro

^ permalink raw reply	[flat|nested] 73+ messages in thread

* Re: [PATCH v3 02/21] docs: hwmon: vexpress: convert to ReST format
  2019-04-17  9:46                     ` [PATCH v3 02/21] docs: hwmon: vexpress: " Mauro Carvalho Chehab
@ 2019-04-17 10:24                       ` Liviu Dudau
  2019-04-17 10:31                         ` Mauro Carvalho Chehab
  2019-04-17 11:29                       ` Liviu Dudau
  1 sibling, 1 reply; 73+ messages in thread
From: Liviu Dudau @ 2019-04-17 10:24 UTC (permalink / raw)
  To: Mauro Carvalho Chehab
  Cc: Linux Doc Mailing List, linux-hwmon, Jean Delvare,
	Jonathan Corbet, linux-kernel, Mauro Carvalho Chehab,
	Lorenzo Pieralisi, linux-arm-kernel, Sudeep Holla, Guenter Roeck

On Wed, Apr 17, 2019 at 06:46:10AM -0300, Mauro Carvalho Chehab wrote:
> Convert vexpress to ReST format, in order to allow it to
> be parsed by Sphinx.
> 
> Signed-off-by: Mauro Carvalho Chehab <mchehab+samsung@kernel.org>
> ---
>  Documentation/hwmon/vexpress | 13 ++++++++++---
>  1 file changed, 10 insertions(+), 3 deletions(-)
> 
> diff --git a/Documentation/hwmon/vexpress b/Documentation/hwmon/vexpress
> index 557d6d5ad90d..8c861c8151ac 100644
> --- a/Documentation/hwmon/vexpress
> +++ b/Documentation/hwmon/vexpress
> @@ -2,14 +2,21 @@ Kernel driver vexpress
>  ======================
>  
>  Supported systems:
> +
>    * ARM Ltd. Versatile Express platform
> +
>      Prefix: 'vexpress'
> +
>      Datasheets:
> +
>        * "Hardware Description" sections of the Technical Reference Manuals
> -        for the Versatile Express boards:
> -        http://infocenter.arm.com/help/topic/com.arm.doc.subset.boards.express/index.html
> +	for the Versatile Express boards:
> +
> +	- http://infocenter.arm.com/help/topic/com.arm.doc.subset.boards.express/index.html
> +
>        * Section "4.4.14. System Configuration registers" of the V2M-P1 TRM:
> -        http://infocenter.arm.com/help/index.jsp?topic=/com.arm.doc.dui0447-/index.html
> +
> +	- http://infocenter.arm.com/help/index.jsp?topic=/com.arm.doc.dui0447-/index.html
>  
>  Author: Pawel Moll

I've acked this at v2 and I can't see any differences. Do you now want
my Acks and prefer to get Pawel's?

Best regards,
Liviu

>  
> -- 
> 2.20.1
> 
> 
> _______________________________________________
> linux-arm-kernel mailing list
> linux-arm-kernel@lists.infradead.org
> http://lists.infradead.org/mailman/listinfo/linux-arm-kernel

-- 
====================
| I would like to |
| fix the world,  |
| but they're not |
| giving me the   |
 \ source code!  /
  ---------------
    ¯\_(ツ)_/¯

^ permalink raw reply	[flat|nested] 73+ messages in thread

* Re: [PATCH v3 02/21] docs: hwmon: vexpress: convert to ReST format
  2019-04-17 10:24                       ` Liviu Dudau
@ 2019-04-17 10:31                         ` Mauro Carvalho Chehab
  0 siblings, 0 replies; 73+ messages in thread
From: Mauro Carvalho Chehab @ 2019-04-17 10:31 UTC (permalink / raw)
  To: Liviu Dudau
  Cc: Linux Doc Mailing List, linux-hwmon, Jean Delvare,
	Jonathan Corbet, linux-kernel, Mauro Carvalho Chehab,
	Lorenzo Pieralisi, linux-arm-kernel, Sudeep Holla, Guenter Roeck

Em Wed, 17 Apr 2019 11:24:15 +0100
Liviu Dudau <liviu.dudau@arm.com> escreveu:

> On Wed, Apr 17, 2019 at 06:46:10AM -0300, Mauro Carvalho Chehab wrote:
> > Convert vexpress to ReST format, in order to allow it to
> > be parsed by Sphinx.
> > 
> > Signed-off-by: Mauro Carvalho Chehab <mchehab+samsung@kernel.org>
> > ---
> >  Documentation/hwmon/vexpress | 13 ++++++++++---
> >  1 file changed, 10 insertions(+), 3 deletions(-)
> > 
> > diff --git a/Documentation/hwmon/vexpress b/Documentation/hwmon/vexpress
> > index 557d6d5ad90d..8c861c8151ac 100644
> > --- a/Documentation/hwmon/vexpress
> > +++ b/Documentation/hwmon/vexpress
> > @@ -2,14 +2,21 @@ Kernel driver vexpress
> >  ======================
> >  
> >  Supported systems:
> > +
> >    * ARM Ltd. Versatile Express platform
> > +
> >      Prefix: 'vexpress'
> > +
> >      Datasheets:
> > +
> >        * "Hardware Description" sections of the Technical Reference Manuals
> > -        for the Versatile Express boards:
> > -        http://infocenter.arm.com/help/topic/com.arm.doc.subset.boards.express/index.html
> > +	for the Versatile Express boards:
> > +
> > +	- http://infocenter.arm.com/help/topic/com.arm.doc.subset.boards.express/index.html
> > +
> >        * Section "4.4.14. System Configuration registers" of the V2M-P1 TRM:
> > -        http://infocenter.arm.com/help/index.jsp?topic=/com.arm.doc.dui0447-/index.html
> > +
> > +	- http://infocenter.arm.com/help/index.jsp?topic=/com.arm.doc.dui0447-/index.html
> >  
> >  Author: Pawel Moll  
> 
> I've acked this at v2 and I can't see any differences. 

Sorry, I forgot to include the acks.

It shouldn't have any difference here (except for context
lines, if any). The main goal of this was to rebase, per
Guenter request, in order to apply over the top of linux-next.

The only non-context changes were on patches 11, 16 and 20.

The past version was based on docs-next.

> Do you now want
> my Acks and prefer to get Pawel's?

Yeah, please send your acks. 

> 
> Best regards,
> Liviu
> 
> >  
> > -- 
> > 2.20.1
> > 
> > 
> > _______________________________________________
> > linux-arm-kernel mailing list
> > linux-arm-kernel@lists.infradead.org
> > http://lists.infradead.org/mailman/listinfo/linux-arm-kernel  
> 



Thanks,
Mauro

^ permalink raw reply	[flat|nested] 73+ messages in thread

* Re: [PATCH v3 02/21] docs: hwmon: vexpress: convert to ReST format
  2019-04-17  9:46                     ` [PATCH v3 02/21] docs: hwmon: vexpress: " Mauro Carvalho Chehab
  2019-04-17 10:24                       ` Liviu Dudau
@ 2019-04-17 11:29                       ` Liviu Dudau
  1 sibling, 0 replies; 73+ messages in thread
From: Liviu Dudau @ 2019-04-17 11:29 UTC (permalink / raw)
  To: Mauro Carvalho Chehab
  Cc: Linux Doc Mailing List, linux-hwmon, Jean Delvare,
	Jonathan Corbet, linux-kernel, Mauro Carvalho Chehab,
	Lorenzo Pieralisi, linux-arm-kernel, Sudeep Holla, Guenter Roeck

On Wed, Apr 17, 2019 at 06:46:10AM -0300, Mauro Carvalho Chehab wrote:
> Convert vexpress to ReST format, in order to allow it to
> be parsed by Sphinx.
> 
> Signed-off-by: Mauro Carvalho Chehab <mchehab+samsung@kernel.org>

Acked-by: Liviu Dudau <liviu.dudau@arm.com>

Best regards,
Liviu

> ---
>  Documentation/hwmon/vexpress | 13 ++++++++++---
>  1 file changed, 10 insertions(+), 3 deletions(-)
> 
> diff --git a/Documentation/hwmon/vexpress b/Documentation/hwmon/vexpress
> index 557d6d5ad90d..8c861c8151ac 100644
> --- a/Documentation/hwmon/vexpress
> +++ b/Documentation/hwmon/vexpress
> @@ -2,14 +2,21 @@ Kernel driver vexpress
>  ======================
>  
>  Supported systems:
> +
>    * ARM Ltd. Versatile Express platform
> +
>      Prefix: 'vexpress'
> +
>      Datasheets:
> +
>        * "Hardware Description" sections of the Technical Reference Manuals
> -        for the Versatile Express boards:
> -        http://infocenter.arm.com/help/topic/com.arm.doc.subset.boards.express/index.html
> +	for the Versatile Express boards:
> +
> +	- http://infocenter.arm.com/help/topic/com.arm.doc.subset.boards.express/index.html
> +
>        * Section "4.4.14. System Configuration registers" of the V2M-P1 TRM:
> -        http://infocenter.arm.com/help/index.jsp?topic=/com.arm.doc.dui0447-/index.html
> +
> +	- http://infocenter.arm.com/help/index.jsp?topic=/com.arm.doc.dui0447-/index.html
>  
>  Author: Pawel Moll
>  
> -- 
> 2.20.1
> 
> 
> _______________________________________________
> linux-arm-kernel mailing list
> linux-arm-kernel@lists.infradead.org
> http://lists.infradead.org/mailman/listinfo/linux-arm-kernel

-- 
====================
| I would like to |
| fix the world,  |
| but they're not |
| giving me the   |
 \ source code!  /
  ---------------
    ¯\_(ツ)_/¯

^ permalink raw reply	[flat|nested] 73+ messages in thread

* Re: [PATCH v3 21/21] docs: hwmon: Add an index file and rename docs to *.rst
  2019-04-17  9:46                     ` [PATCH v3 21/21] docs: hwmon: Add an index file and rename docs to *.rst Mauro Carvalho Chehab
@ 2019-04-17 11:31                       ` Liviu Dudau
  2019-04-17 16:47                       ` Guenter Roeck
  1 sibling, 0 replies; 73+ messages in thread
From: Liviu Dudau @ 2019-04-17 11:31 UTC (permalink / raw)
  To: Mauro Carvalho Chehab
  Cc: Linux Doc Mailing List, Mark Rutland, Dirk Eibach, linux-aspeed,
	devicetree, Benjamin Herrenschmidt, Clemens Ladisch,
	Kamil Debski, Marc Hulsman, Huang Rui, Paul Mackerras,
	Jim Cromie, Lorenzo Pieralisi, Jonathan Corbet, Michael Ellerman,
	Joel Stanley, Guenter Roeck, Steve Glendinning, Fenghua Yu,
	Jean Delvare, Bartlomiej Zolnierkiewicz, Mauro Carvalho Chehab,
	Hans de Goede, Rob Herring, Rudolf Marek, linux-arm-kernel,
	linux-hwmon, Support Opensource, George Joseph, Andreas Werner,
	Andrew Jeffery, patches, linux-kernel, Juerg Haefliger,
	Sudeep Holla, linuxppc-dev

On Wed, Apr 17, 2019 at 06:46:29AM -0300, Mauro Carvalho Chehab wrote:
> Now that all files were converted to ReST format, rename them
> and add an index.
> 
> Signed-off-by: Mauro Carvalho Chehab <mchehab+samsung@kernel.org>
> ---
>  .../devicetree/bindings/hwmon/g762.txt        |   2 +-
>  Documentation/hwmon/{ab8500 => ab8500.rst}    |   2 +-
>  ...guru-datasheet => abituguru-datasheet.rst} |   0
>  .../hwmon/{abituguru => abituguru.rst}        |   0
>  .../hwmon/{abituguru3 => abituguru3.rst}      |   0
>  Documentation/hwmon/{abx500 => abx500.rst}    |   0
>  ...{acpi_power_meter => acpi_power_meter.rst} |   2 +-
>  Documentation/hwmon/{ad7314 => ad7314.rst}    |   0
>  .../hwmon/{adc128d818 => adc128d818.rst}      |   0
>  Documentation/hwmon/{adm1021 => adm1021.rst}  |   0
>  Documentation/hwmon/{adm1025 => adm1025.rst}  |   0
>  Documentation/hwmon/{adm1026 => adm1026.rst}  |   0
>  Documentation/hwmon/{adm1031 => adm1031.rst}  |   0
>  Documentation/hwmon/{adm1275 => adm1275.rst}  |   4 +-
>  Documentation/hwmon/{adm9240 => adm9240.rst}  |   0
>  Documentation/hwmon/{ads1015 => ads1015.rst}  |   0
>  Documentation/hwmon/{ads7828 => ads7828.rst}  |   0
>  Documentation/hwmon/{adt7410 => adt7410.rst}  |   0
>  Documentation/hwmon/{adt7411 => adt7411.rst}  |   0
>  Documentation/hwmon/{adt7462 => adt7462.rst}  |   1 -
>  Documentation/hwmon/{adt7470 => adt7470.rst}  |   0
>  Documentation/hwmon/{adt7475 => adt7475.rst}  |   0
>  Documentation/hwmon/{amc6821 => amc6821.rst}  |   1 -
>  Documentation/hwmon/{asb100 => asb100.rst}    |   1 -
>  Documentation/hwmon/{asc7621 => asc7621.rst}  |   0
>  ...{aspeed-pwm-tacho => aspeed-pwm-tacho.rst} |   0
>  .../hwmon/{coretemp => coretemp.rst}          |   0
>  Documentation/hwmon/{da9052 => da9052.rst}    |   0
>  Documentation/hwmon/{da9055 => da9055.rst}    |   0
>  Documentation/hwmon/{dme1737 => dme1737.rst}  |   0
>  Documentation/hwmon/{ds1621 => ds1621.rst}    |   0
>  Documentation/hwmon/{ds620 => ds620.rst}      |   0
>  Documentation/hwmon/{emc1403 => emc1403.rst}  |   0
>  Documentation/hwmon/{emc2103 => emc2103.rst}  |   0
>  .../hwmon/{emc6w201 => emc6w201.rst}          |   0
>  Documentation/hwmon/{f71805f => f71805f.rst}  |   0
>  .../hwmon/{f71882fg => f71882fg.rst}          |   0
>  .../hwmon/{fam15h_power => fam15h_power.rst}  |   0
>  .../hwmon/{ftsteutates => ftsteutates.rst}    |   0
>  Documentation/hwmon/{g760a => g760a.rst}      |   0
>  Documentation/hwmon/{g762 => g762.rst}        |   2 +-
>  Documentation/hwmon/{gl518sm => gl518sm.rst}  |   0
>  Documentation/hwmon/{hih6130 => hih6130.rst}  |   0
>  ...on-kernel-api.txt => hwmon-kernel-api.rst} |   4 +-
>  .../hwmon/{ibm-cffps => ibm-cffps.rst}        |   0
>  Documentation/hwmon/{ibmaem => ibmaem.rst}    |   0
>  .../hwmon/{ibmpowernv => ibmpowernv.rst}      |   0
>  Documentation/hwmon/{ina209 => ina209.rst}    |   0
>  Documentation/hwmon/{ina2xx => ina2xx.rst}    |   2 +-
>  Documentation/hwmon/{ina3221 => ina3221.rst}  |   0
>  Documentation/hwmon/index.rst                 | 179 ++++++++++++++++++
>  Documentation/hwmon/{ir35221 => ir35221.rst}  |   0
>  Documentation/hwmon/{it87 => it87.rst}        |   0
>  Documentation/hwmon/{jc42 => jc42.rst}        |   0
>  Documentation/hwmon/{k10temp => k10temp.rst}  |   0
>  Documentation/hwmon/{k8temp => k8temp.rst}    |   0
>  .../hwmon/{lineage-pem => lineage-pem.rst}    |   0
>  Documentation/hwmon/{lm25066 => lm25066.rst}  |   2 +-
>  Documentation/hwmon/{lm63 => lm63.rst}        |   0
>  Documentation/hwmon/{lm70 => lm70.rst}        |   0
>  Documentation/hwmon/{lm73 => lm73.rst}        |   0
>  Documentation/hwmon/{lm75 => lm75.rst}        |   0
>  Documentation/hwmon/{lm77 => lm77.rst}        |   0
>  Documentation/hwmon/{lm78 => lm78.rst}        |   0
>  Documentation/hwmon/{lm80 => lm80.rst}        |   0
>  Documentation/hwmon/{lm83 => lm83.rst}        |   0
>  Documentation/hwmon/{lm85 => lm85.rst}        |   0
>  Documentation/hwmon/{lm87 => lm87.rst}        |   0
>  Documentation/hwmon/{lm90 => lm90.rst}        |   0
>  Documentation/hwmon/{lm92 => lm92.rst}        |   0
>  Documentation/hwmon/{lm93 => lm93.rst}        |   0
>  Documentation/hwmon/{lm95234 => lm95234.rst}  |   0
>  Documentation/hwmon/{lm95245 => lm95245.rst}  |   0
>  Documentation/hwmon/{ltc2945 => ltc2945.rst}  |   0
>  Documentation/hwmon/{ltc2978 => ltc2978.rst}  |   0
>  Documentation/hwmon/{ltc2990 => ltc2990.rst}  |   0
>  Documentation/hwmon/{ltc3815 => ltc3815.rst}  |   0
>  Documentation/hwmon/{ltc4151 => ltc4151.rst}  |   0
>  Documentation/hwmon/{ltc4215 => ltc4215.rst}  |   0
>  Documentation/hwmon/{ltc4245 => ltc4245.rst}  |   0
>  Documentation/hwmon/{ltc4260 => ltc4260.rst}  |   0
>  Documentation/hwmon/{ltc4261 => ltc4261.rst}  |   0
>  .../hwmon/{max16064 => max16064.rst}          |   2 +-
>  .../hwmon/{max16065 => max16065.rst}          |   0
>  Documentation/hwmon/{max1619 => max1619.rst}  |   1 -
>  Documentation/hwmon/{max1668 => max1668.rst}  |   0
>  Documentation/hwmon/{max197 => max197.rst}    |   0
>  .../hwmon/{max20751 => max20751.rst}          |   2 +-
>  .../hwmon/{max31722 => max31722.rst}          |   0
>  .../hwmon/{max31785 => max31785.rst}          |   0
>  .../hwmon/{max31790 => max31790.rst}          |   0
>  .../hwmon/{max34440 => max34440.rst}          |   2 +-
>  Documentation/hwmon/{max6639 => max6639.rst}  |   0
>  Documentation/hwmon/{max6642 => max6642.rst}  |   0
>  Documentation/hwmon/{max6650 => max6650.rst}  |   1 -
>  Documentation/hwmon/{max6697 => max6697.rst}  |   0
>  Documentation/hwmon/{max8688 => max8688.rst}  |   2 +-
>  .../hwmon/{mc13783-adc => mc13783-adc.rst}    |   0
>  Documentation/hwmon/{mcp3021 => mcp3021.rst}  |   0
>  .../hwmon/{menf21bmc => menf21bmc.rst}        |   0
>  .../hwmon/{mlxreg-fan => mlxreg-fan.rst}      |   0
>  Documentation/hwmon/{nct6683 => nct6683.rst}  |   0
>  Documentation/hwmon/{nct6775 => nct6775.rst}  |   0
>  Documentation/hwmon/{nct7802 => nct7802.rst}  |   0
>  Documentation/hwmon/{nct7904 => nct7904.rst}  |   0
>  .../{npcm750-pwm-fan => npcm750-pwm-fan.rst}  |   0
>  Documentation/hwmon/{nsa320 => nsa320.rst}    |   0
>  .../{ntc_thermistor => ntc_thermistor.rst}    |   0
>  Documentation/hwmon/{occ => occ.rst}          |   0
>  Documentation/hwmon/{pc87360 => pc87360.rst}  |   0
>  Documentation/hwmon/{pc87427 => pc87427.rst}  |   0
>  Documentation/hwmon/{pcf8591 => pcf8591.rst}  |   0
>  .../hwmon/{pmbus-core => pmbus-core.rst}      |   0
>  Documentation/hwmon/{pmbus => pmbus.rst}      |   0
>  .../hwmon/{powr1220 => powr1220.rst}          |   0
>  Documentation/hwmon/{pwm-fan => pwm-fan.rst}  |   0
>  ...aspberrypi-hwmon => raspberrypi-hwmon.rst} |   0
>  Documentation/hwmon/{sch5627 => sch5627.rst}  |   0
>  Documentation/hwmon/{sch5636 => sch5636.rst}  |   0
>  .../hwmon/{scpi-hwmon => scpi-hwmon.rst}      |   0
>  Documentation/hwmon/{sht15 => sht15.rst}      |   0
>  Documentation/hwmon/{sht21 => sht21.rst}      |   0
>  Documentation/hwmon/{sht3x => sht3x.rst}      |   0
>  Documentation/hwmon/{shtc1 => shtc1.rst}      |   0
>  Documentation/hwmon/{sis5595 => sis5595.rst}  |   1 -
>  Documentation/hwmon/{smm665 => smm665.rst}    |   0
>  .../hwmon/{smsc47b397 => smsc47b397.rst}      |   0
>  .../hwmon/{smsc47m1 => smsc47m1.rst}          |   0
>  .../hwmon/{smsc47m192 => smsc47m192.rst}      |   0
>  ...mitting-patches => submitting-patches.rst} |   6 +-
>  .../{sysfs-interface => sysfs-interface.rst}  |   0
>  Documentation/hwmon/{tc654 => tc654.rst}      |   0
>  Documentation/hwmon/{tc74 => tc74.rst}        |   0
>  Documentation/hwmon/{thmc50 => thmc50.rst}    |   1 -
>  Documentation/hwmon/{tmp102 => tmp102.rst}    |   2 +-
>  Documentation/hwmon/{tmp103 => tmp103.rst}    |   2 +-
>  Documentation/hwmon/{tmp108 => tmp108.rst}    |   2 +-
>  Documentation/hwmon/{tmp401 => tmp401.rst}    |   2 +-
>  Documentation/hwmon/{tmp421 => tmp421.rst}    |   0
>  .../hwmon/{tps40422 => tps40422.rst}          |   2 +-
>  ...4030-madc-hwmon => twl4030-madc-hwmon.rst} |   0
>  Documentation/hwmon/{ucd9000 => ucd9000.rst}  |   4 +-
>  Documentation/hwmon/{ucd9200 => ucd9200.rst}  |   4 +-
>  .../{userspace-tools => userspace-tools.rst}  |   0
>  .../hwmon/{vexpress => vexpress.rst}          |   0

For the vexpress part:

Acked-by: Liviu Dudau <liviu.dudau@arm.com>

Best regards,
Liviu

>  Documentation/hwmon/{via686a => via686a.rst}  |   0
>  Documentation/hwmon/{vt1211 => vt1211.rst}    |   0
>  .../hwmon/{w83627ehf => w83627ehf.rst}        |   0
>  .../hwmon/{w83627hf => w83627hf.rst}          |   0
>  Documentation/hwmon/{w83773g => w83773g.rst}  |   0
>  Documentation/hwmon/{w83781d => w83781d.rst}  |   0
>  Documentation/hwmon/{w83791d => w83791d.rst}  |   2 +-
>  Documentation/hwmon/{w83792d => w83792d.rst}  |   0
>  Documentation/hwmon/{w83793 => w83793.rst}    |   0
>  Documentation/hwmon/{w83795 => w83795.rst}    |   0
>  .../hwmon/{w83l785ts => w83l785ts.rst}        |   0
>  .../hwmon/{w83l786ng => w83l786ng.rst}        |   0
>  Documentation/hwmon/{wm831x => wm831x.rst}    |   0
>  Documentation/hwmon/{wm8350 => wm8350.rst}    |   0
>  .../hwmon/{xgene-hwmon => xgene-hwmon.rst}    |   0
>  Documentation/hwmon/{zl6100 => zl6100.rst}    |   2 +-
>  Documentation/index.rst                       |   1 +
>  Documentation/thermal/sysfs-api.txt           |   2 +-
>  MAINTAINERS                                   | 108 +++++------
>  drivers/hwmon/Kconfig                         |   8 +-
>  drivers/hwmon/ads7828.c                       |   2 +-
>  drivers/hwmon/max197.c                        |   2 +-
>  drivers/hwmon/sht15.c                         |   2 +-
>  include/linux/platform_data/ads7828.h         |   2 +-
>  include/linux/platform_data/ds620.h           |   2 +-
>  include/linux/platform_data/ina2xx.h          |   2 +-
>  include/linux/platform_data/max197.h          |   2 +-
>  include/linux/platform_data/ntc_thermistor.h  |   2 +-
>  173 files changed, 275 insertions(+), 102 deletions(-)
>  rename Documentation/hwmon/{ab8500 => ab8500.rst} (86%)
>  rename Documentation/hwmon/{abituguru-datasheet => abituguru-datasheet.rst} (100%)
>  rename Documentation/hwmon/{abituguru => abituguru.rst} (100%)
>  rename Documentation/hwmon/{abituguru3 => abituguru3.rst} (100%)
>  rename Documentation/hwmon/{abx500 => abx500.rst} (100%)
>  rename Documentation/hwmon/{acpi_power_meter => acpi_power_meter.rst} (97%)
>  rename Documentation/hwmon/{ad7314 => ad7314.rst} (100%)
>  rename Documentation/hwmon/{adc128d818 => adc128d818.rst} (100%)
>  rename Documentation/hwmon/{adm1021 => adm1021.rst} (100%)
>  rename Documentation/hwmon/{adm1025 => adm1025.rst} (100%)
>  rename Documentation/hwmon/{adm1026 => adm1026.rst} (100%)
>  rename Documentation/hwmon/{adm1031 => adm1031.rst} (100%)
>  rename Documentation/hwmon/{adm1275 => adm1275.rst} (97%)
>  rename Documentation/hwmon/{adm9240 => adm9240.rst} (100%)
>  rename Documentation/hwmon/{ads1015 => ads1015.rst} (100%)
>  rename Documentation/hwmon/{ads7828 => ads7828.rst} (100%)
>  rename Documentation/hwmon/{adt7410 => adt7410.rst} (100%)
>  rename Documentation/hwmon/{adt7411 => adt7411.rst} (100%)
>  rename Documentation/hwmon/{adt7462 => adt7462.rst} (99%)
>  rename Documentation/hwmon/{adt7470 => adt7470.rst} (100%)
>  rename Documentation/hwmon/{adt7475 => adt7475.rst} (100%)
>  rename Documentation/hwmon/{amc6821 => amc6821.rst} (99%)
>  rename Documentation/hwmon/{asb100 => asb100.rst} (99%)
>  rename Documentation/hwmon/{asc7621 => asc7621.rst} (100%)
>  rename Documentation/hwmon/{aspeed-pwm-tacho => aspeed-pwm-tacho.rst} (100%)
>  rename Documentation/hwmon/{coretemp => coretemp.rst} (100%)
>  rename Documentation/hwmon/{da9052 => da9052.rst} (100%)
>  rename Documentation/hwmon/{da9055 => da9055.rst} (100%)
>  rename Documentation/hwmon/{dme1737 => dme1737.rst} (100%)
>  rename Documentation/hwmon/{ds1621 => ds1621.rst} (100%)
>  rename Documentation/hwmon/{ds620 => ds620.rst} (100%)
>  rename Documentation/hwmon/{emc1403 => emc1403.rst} (100%)
>  rename Documentation/hwmon/{emc2103 => emc2103.rst} (100%)
>  rename Documentation/hwmon/{emc6w201 => emc6w201.rst} (100%)
>  rename Documentation/hwmon/{f71805f => f71805f.rst} (100%)
>  rename Documentation/hwmon/{f71882fg => f71882fg.rst} (100%)
>  rename Documentation/hwmon/{fam15h_power => fam15h_power.rst} (100%)
>  rename Documentation/hwmon/{ftsteutates => ftsteutates.rst} (100%)
>  rename Documentation/hwmon/{g760a => g760a.rst} (100%)
>  rename Documentation/hwmon/{g762 => g762.rst} (97%)
>  rename Documentation/hwmon/{gl518sm => gl518sm.rst} (100%)
>  rename Documentation/hwmon/{hih6130 => hih6130.rst} (100%)
>  rename Documentation/hwmon/{hwmon-kernel-api.txt => hwmon-kernel-api.rst} (99%)
>  rename Documentation/hwmon/{ibm-cffps => ibm-cffps.rst} (100%)
>  rename Documentation/hwmon/{ibmaem => ibmaem.rst} (100%)
>  rename Documentation/hwmon/{ibmpowernv => ibmpowernv.rst} (100%)
>  rename Documentation/hwmon/{ina209 => ina209.rst} (100%)
>  rename Documentation/hwmon/{ina2xx => ina2xx.rst} (97%)
>  rename Documentation/hwmon/{ina3221 => ina3221.rst} (100%)
>  create mode 100644 Documentation/hwmon/index.rst
>  rename Documentation/hwmon/{ir35221 => ir35221.rst} (100%)
>  rename Documentation/hwmon/{it87 => it87.rst} (100%)
>  rename Documentation/hwmon/{jc42 => jc42.rst} (100%)
>  rename Documentation/hwmon/{k10temp => k10temp.rst} (100%)
>  rename Documentation/hwmon/{k8temp => k8temp.rst} (100%)
>  rename Documentation/hwmon/{lineage-pem => lineage-pem.rst} (100%)
>  rename Documentation/hwmon/{lm25066 => lm25066.rst} (97%)
>  rename Documentation/hwmon/{lm63 => lm63.rst} (100%)
>  rename Documentation/hwmon/{lm70 => lm70.rst} (100%)
>  rename Documentation/hwmon/{lm73 => lm73.rst} (100%)
>  rename Documentation/hwmon/{lm75 => lm75.rst} (100%)
>  rename Documentation/hwmon/{lm77 => lm77.rst} (100%)
>  rename Documentation/hwmon/{lm78 => lm78.rst} (100%)
>  rename Documentation/hwmon/{lm80 => lm80.rst} (100%)
>  rename Documentation/hwmon/{lm83 => lm83.rst} (100%)
>  rename Documentation/hwmon/{lm85 => lm85.rst} (100%)
>  rename Documentation/hwmon/{lm87 => lm87.rst} (100%)
>  rename Documentation/hwmon/{lm90 => lm90.rst} (100%)
>  rename Documentation/hwmon/{lm92 => lm92.rst} (100%)
>  rename Documentation/hwmon/{lm93 => lm93.rst} (100%)
>  rename Documentation/hwmon/{lm95234 => lm95234.rst} (100%)
>  rename Documentation/hwmon/{lm95245 => lm95245.rst} (100%)
>  rename Documentation/hwmon/{ltc2945 => ltc2945.rst} (100%)
>  rename Documentation/hwmon/{ltc2978 => ltc2978.rst} (100%)
>  rename Documentation/hwmon/{ltc2990 => ltc2990.rst} (100%)
>  rename Documentation/hwmon/{ltc3815 => ltc3815.rst} (100%)
>  rename Documentation/hwmon/{ltc4151 => ltc4151.rst} (100%)
>  rename Documentation/hwmon/{ltc4215 => ltc4215.rst} (100%)
>  rename Documentation/hwmon/{ltc4245 => ltc4245.rst} (100%)
>  rename Documentation/hwmon/{ltc4260 => ltc4260.rst} (100%)
>  rename Documentation/hwmon/{ltc4261 => ltc4261.rst} (100%)
>  rename Documentation/hwmon/{max16064 => max16064.rst} (96%)
>  rename Documentation/hwmon/{max16065 => max16065.rst} (100%)
>  rename Documentation/hwmon/{max1619 => max1619.rst} (99%)
>  rename Documentation/hwmon/{max1668 => max1668.rst} (100%)
>  rename Documentation/hwmon/{max197 => max197.rst} (100%)
>  rename Documentation/hwmon/{max20751 => max20751.rst} (96%)
>  rename Documentation/hwmon/{max31722 => max31722.rst} (100%)
>  rename Documentation/hwmon/{max31785 => max31785.rst} (100%)
>  rename Documentation/hwmon/{max31790 => max31790.rst} (100%)
>  rename Documentation/hwmon/{max34440 => max34440.rst} (98%)
>  rename Documentation/hwmon/{max6639 => max6639.rst} (100%)
>  rename Documentation/hwmon/{max6642 => max6642.rst} (100%)
>  rename Documentation/hwmon/{max6650 => max6650.rst} (99%)
>  rename Documentation/hwmon/{max6697 => max6697.rst} (100%)
>  rename Documentation/hwmon/{max8688 => max8688.rst} (97%)
>  rename Documentation/hwmon/{mc13783-adc => mc13783-adc.rst} (100%)
>  rename Documentation/hwmon/{mcp3021 => mcp3021.rst} (100%)
>  rename Documentation/hwmon/{menf21bmc => menf21bmc.rst} (100%)
>  rename Documentation/hwmon/{mlxreg-fan => mlxreg-fan.rst} (100%)
>  rename Documentation/hwmon/{nct6683 => nct6683.rst} (100%)
>  rename Documentation/hwmon/{nct6775 => nct6775.rst} (100%)
>  rename Documentation/hwmon/{nct7802 => nct7802.rst} (100%)
>  rename Documentation/hwmon/{nct7904 => nct7904.rst} (100%)
>  rename Documentation/hwmon/{npcm750-pwm-fan => npcm750-pwm-fan.rst} (100%)
>  rename Documentation/hwmon/{nsa320 => nsa320.rst} (100%)
>  rename Documentation/hwmon/{ntc_thermistor => ntc_thermistor.rst} (100%)
>  rename Documentation/hwmon/{occ => occ.rst} (100%)
>  rename Documentation/hwmon/{pc87360 => pc87360.rst} (100%)
>  rename Documentation/hwmon/{pc87427 => pc87427.rst} (100%)
>  rename Documentation/hwmon/{pcf8591 => pcf8591.rst} (100%)
>  rename Documentation/hwmon/{pmbus-core => pmbus-core.rst} (100%)
>  rename Documentation/hwmon/{pmbus => pmbus.rst} (100%)
>  rename Documentation/hwmon/{powr1220 => powr1220.rst} (100%)
>  rename Documentation/hwmon/{pwm-fan => pwm-fan.rst} (100%)
>  rename Documentation/hwmon/{raspberrypi-hwmon => raspberrypi-hwmon.rst} (100%)
>  rename Documentation/hwmon/{sch5627 => sch5627.rst} (100%)
>  rename Documentation/hwmon/{sch5636 => sch5636.rst} (100%)
>  rename Documentation/hwmon/{scpi-hwmon => scpi-hwmon.rst} (100%)
>  rename Documentation/hwmon/{sht15 => sht15.rst} (100%)
>  rename Documentation/hwmon/{sht21 => sht21.rst} (100%)
>  rename Documentation/hwmon/{sht3x => sht3x.rst} (100%)
>  rename Documentation/hwmon/{shtc1 => shtc1.rst} (100%)
>  rename Documentation/hwmon/{sis5595 => sis5595.rst} (99%)
>  rename Documentation/hwmon/{smm665 => smm665.rst} (100%)
>  rename Documentation/hwmon/{smsc47b397 => smsc47b397.rst} (100%)
>  rename Documentation/hwmon/{smsc47m1 => smsc47m1.rst} (100%)
>  rename Documentation/hwmon/{smsc47m192 => smsc47m192.rst} (100%)
>  rename Documentation/hwmon/{submitting-patches => submitting-patches.rst} (98%)
>  rename Documentation/hwmon/{sysfs-interface => sysfs-interface.rst} (100%)
>  rename Documentation/hwmon/{tc654 => tc654.rst} (100%)
>  rename Documentation/hwmon/{tc74 => tc74.rst} (100%)
>  rename Documentation/hwmon/{thmc50 => thmc50.rst} (99%)
>  rename Documentation/hwmon/{tmp102 => tmp102.rst} (93%)
>  rename Documentation/hwmon/{tmp103 => tmp103.rst} (92%)
>  rename Documentation/hwmon/{tmp108 => tmp108.rst} (95%)
>  rename Documentation/hwmon/{tmp401 => tmp401.rst} (97%)
>  rename Documentation/hwmon/{tmp421 => tmp421.rst} (100%)
>  rename Documentation/hwmon/{tps40422 => tps40422.rst} (96%)
>  rename Documentation/hwmon/{twl4030-madc-hwmon => twl4030-madc-hwmon.rst} (100%)
>  rename Documentation/hwmon/{ucd9000 => ucd9000.rst} (97%)
>  rename Documentation/hwmon/{ucd9200 => ucd9200.rst} (97%)
>  rename Documentation/hwmon/{userspace-tools => userspace-tools.rst} (100%)
>  rename Documentation/hwmon/{vexpress => vexpress.rst} (100%)
>  rename Documentation/hwmon/{via686a => via686a.rst} (100%)
>  rename Documentation/hwmon/{vt1211 => vt1211.rst} (100%)
>  rename Documentation/hwmon/{w83627ehf => w83627ehf.rst} (100%)
>  rename Documentation/hwmon/{w83627hf => w83627hf.rst} (100%)
>  rename Documentation/hwmon/{w83773g => w83773g.rst} (100%)
>  rename Documentation/hwmon/{w83781d => w83781d.rst} (100%)
>  rename Documentation/hwmon/{w83791d => w83791d.rst} (99%)
>  rename Documentation/hwmon/{w83792d => w83792d.rst} (100%)
>  rename Documentation/hwmon/{w83793 => w83793.rst} (100%)
>  rename Documentation/hwmon/{w83795 => w83795.rst} (100%)
>  rename Documentation/hwmon/{w83l785ts => w83l785ts.rst} (100%)
>  rename Documentation/hwmon/{w83l786ng => w83l786ng.rst} (100%)
>  rename Documentation/hwmon/{wm831x => wm831x.rst} (100%)
>  rename Documentation/hwmon/{wm8350 => wm8350.rst} (100%)
>  rename Documentation/hwmon/{xgene-hwmon => xgene-hwmon.rst} (100%)
>  rename Documentation/hwmon/{zl6100 => zl6100.rst} (98%)
> 
> diff --git a/Documentation/devicetree/bindings/hwmon/g762.txt b/Documentation/devicetree/bindings/hwmon/g762.txt
> index 25cc6d8ee575..6d154c4923de 100644
> --- a/Documentation/devicetree/bindings/hwmon/g762.txt
> +++ b/Documentation/devicetree/bindings/hwmon/g762.txt
> @@ -21,7 +21,7 @@ If an optional property is not set in .dts file, then current value is kept
>  unmodified (e.g. u-boot installed value).
>  
>  Additional information on operational parameters for the device is available
> -in Documentation/hwmon/g762. A detailed datasheet for the device is available
> +in Documentation/hwmon/g762.rst. A detailed datasheet for the device is available
>  at http://natisbad.org/NAS/refs/GMT_EDS-762_763-080710-0.2.pdf.
>  
>  Example g762 node:
> diff --git a/Documentation/hwmon/ab8500 b/Documentation/hwmon/ab8500.rst
> similarity index 86%
> rename from Documentation/hwmon/ab8500
> rename to Documentation/hwmon/ab8500.rst
> index d87c61151239..33f93a9cec04 100644
> --- a/Documentation/hwmon/ab8500
> +++ b/Documentation/hwmon/ab8500.rst
> @@ -18,7 +18,7 @@ Authors:
>  Description
>  -----------
>  
> -See also Documentation/hwmon/abx500. This is the ST-Ericsson AB8500 specific
> +See also Documentation/hwmon/abx500.rst. This is the ST-Ericsson AB8500 specific
>  driver.
>  
>  Currently only the AB8500 internal sensor and one external sensor for battery
> diff --git a/Documentation/hwmon/abituguru-datasheet b/Documentation/hwmon/abituguru-datasheet.rst
> similarity index 100%
> rename from Documentation/hwmon/abituguru-datasheet
> rename to Documentation/hwmon/abituguru-datasheet.rst
> diff --git a/Documentation/hwmon/abituguru b/Documentation/hwmon/abituguru.rst
> similarity index 100%
> rename from Documentation/hwmon/abituguru
> rename to Documentation/hwmon/abituguru.rst
> diff --git a/Documentation/hwmon/abituguru3 b/Documentation/hwmon/abituguru3.rst
> similarity index 100%
> rename from Documentation/hwmon/abituguru3
> rename to Documentation/hwmon/abituguru3.rst
> diff --git a/Documentation/hwmon/abx500 b/Documentation/hwmon/abx500.rst
> similarity index 100%
> rename from Documentation/hwmon/abx500
> rename to Documentation/hwmon/abx500.rst
> diff --git a/Documentation/hwmon/acpi_power_meter b/Documentation/hwmon/acpi_power_meter.rst
> similarity index 97%
> rename from Documentation/hwmon/acpi_power_meter
> rename to Documentation/hwmon/acpi_power_meter.rst
> index 7665ca6ba957..4a0941ade0ca 100644
> --- a/Documentation/hwmon/acpi_power_meter
> +++ b/Documentation/hwmon/acpi_power_meter.rst
> @@ -21,7 +21,7 @@ the ACPI 4.0 spec (Chapter 10.4).  These devices have a simple set of
>  features--a power meter that returns average power use over a configurable
>  interval, an optional capping mechanism, and a couple of trip points.  The
>  sysfs interface conforms with the specification outlined in the "Power" section
> -of Documentation/hwmon/sysfs-interface.
> +of Documentation/hwmon/sysfs-interface.rst.
>  
>  Special Features
>  ----------------
> diff --git a/Documentation/hwmon/ad7314 b/Documentation/hwmon/ad7314.rst
> similarity index 100%
> rename from Documentation/hwmon/ad7314
> rename to Documentation/hwmon/ad7314.rst
> diff --git a/Documentation/hwmon/adc128d818 b/Documentation/hwmon/adc128d818.rst
> similarity index 100%
> rename from Documentation/hwmon/adc128d818
> rename to Documentation/hwmon/adc128d818.rst
> diff --git a/Documentation/hwmon/adm1021 b/Documentation/hwmon/adm1021.rst
> similarity index 100%
> rename from Documentation/hwmon/adm1021
> rename to Documentation/hwmon/adm1021.rst
> diff --git a/Documentation/hwmon/adm1025 b/Documentation/hwmon/adm1025.rst
> similarity index 100%
> rename from Documentation/hwmon/adm1025
> rename to Documentation/hwmon/adm1025.rst
> diff --git a/Documentation/hwmon/adm1026 b/Documentation/hwmon/adm1026.rst
> similarity index 100%
> rename from Documentation/hwmon/adm1026
> rename to Documentation/hwmon/adm1026.rst
> diff --git a/Documentation/hwmon/adm1031 b/Documentation/hwmon/adm1031.rst
> similarity index 100%
> rename from Documentation/hwmon/adm1031
> rename to Documentation/hwmon/adm1031.rst
> diff --git a/Documentation/hwmon/adm1275 b/Documentation/hwmon/adm1275.rst
> similarity index 97%
> rename from Documentation/hwmon/adm1275
> rename to Documentation/hwmon/adm1275.rst
> index 5c5860011d6e..9a1913e5b4d9 100644
> --- a/Documentation/hwmon/adm1275
> +++ b/Documentation/hwmon/adm1275.rst
> @@ -68,7 +68,7 @@ integrated 12 bit analog-to-digital converter (ADC), accessed using a
>  PMBus interface.
>  
>  The driver is a client driver to the core PMBus driver. Please see
> -Documentation/hwmon/pmbus for details on PMBus client drivers.
> +Documentation/hwmon/pmbus.rst for details on PMBus client drivers.
>  
>  
>  Usage Notes
> @@ -90,7 +90,7 @@ Platform data support
>  ---------------------
>  
>  The driver supports standard PMBus driver platform data. Please see
> -Documentation/hwmon/pmbus for details.
> +Documentation/hwmon/pmbus.rst for details.
>  
>  
>  Sysfs entries
> diff --git a/Documentation/hwmon/adm9240 b/Documentation/hwmon/adm9240.rst
> similarity index 100%
> rename from Documentation/hwmon/adm9240
> rename to Documentation/hwmon/adm9240.rst
> diff --git a/Documentation/hwmon/ads1015 b/Documentation/hwmon/ads1015.rst
> similarity index 100%
> rename from Documentation/hwmon/ads1015
> rename to Documentation/hwmon/ads1015.rst
> diff --git a/Documentation/hwmon/ads7828 b/Documentation/hwmon/ads7828.rst
> similarity index 100%
> rename from Documentation/hwmon/ads7828
> rename to Documentation/hwmon/ads7828.rst
> diff --git a/Documentation/hwmon/adt7410 b/Documentation/hwmon/adt7410.rst
> similarity index 100%
> rename from Documentation/hwmon/adt7410
> rename to Documentation/hwmon/adt7410.rst
> diff --git a/Documentation/hwmon/adt7411 b/Documentation/hwmon/adt7411.rst
> similarity index 100%
> rename from Documentation/hwmon/adt7411
> rename to Documentation/hwmon/adt7411.rst
> diff --git a/Documentation/hwmon/adt7462 b/Documentation/hwmon/adt7462.rst
> similarity index 99%
> rename from Documentation/hwmon/adt7462
> rename to Documentation/hwmon/adt7462.rst
> index a7a831118d32..139e19696188 100644
> --- a/Documentation/hwmon/adt7462
> +++ b/Documentation/hwmon/adt7462.rst
> @@ -68,4 +68,3 @@ The ADT7462 will scale the pwm between the lower and higher pwm speed when
>  the temperature is between the two temperature boundaries.  PWM values range
>  from 0 (off) to 255 (full speed).  Fan speed will be set to maximum when the
>  temperature sensor associated with the PWM control exceeds temp#_max.
> -
> diff --git a/Documentation/hwmon/adt7470 b/Documentation/hwmon/adt7470.rst
> similarity index 100%
> rename from Documentation/hwmon/adt7470
> rename to Documentation/hwmon/adt7470.rst
> diff --git a/Documentation/hwmon/adt7475 b/Documentation/hwmon/adt7475.rst
> similarity index 100%
> rename from Documentation/hwmon/adt7475
> rename to Documentation/hwmon/adt7475.rst
> diff --git a/Documentation/hwmon/amc6821 b/Documentation/hwmon/amc6821.rst
> similarity index 99%
> rename from Documentation/hwmon/amc6821
> rename to Documentation/hwmon/amc6821.rst
> index d10eabcbc0f3..5ddb2849da90 100644
> --- a/Documentation/hwmon/amc6821
> +++ b/Documentation/hwmon/amc6821.rst
> @@ -106,4 +106,3 @@ different settings, you can set the following parameters:
>  
>  - init=1,
>  - pwminv: 0 default pwm output, 1 inverts pwm output.
> -
> diff --git a/Documentation/hwmon/asb100 b/Documentation/hwmon/asb100.rst
> similarity index 99%
> rename from Documentation/hwmon/asb100
> rename to Documentation/hwmon/asb100.rst
> index 311d9f7b6926..c2d5f97085fe 100644
> --- a/Documentation/hwmon/asb100
> +++ b/Documentation/hwmon/asb100.rst
> @@ -71,4 +71,3 @@ TODO:
>    * Experiment with temp. sensor types.
>    * Are there really 13 voltage inputs? Probably not...
>    * Cleanups, no doubt...
> -
> diff --git a/Documentation/hwmon/asc7621 b/Documentation/hwmon/asc7621.rst
> similarity index 100%
> rename from Documentation/hwmon/asc7621
> rename to Documentation/hwmon/asc7621.rst
> diff --git a/Documentation/hwmon/aspeed-pwm-tacho b/Documentation/hwmon/aspeed-pwm-tacho.rst
> similarity index 100%
> rename from Documentation/hwmon/aspeed-pwm-tacho
> rename to Documentation/hwmon/aspeed-pwm-tacho.rst
> diff --git a/Documentation/hwmon/coretemp b/Documentation/hwmon/coretemp.rst
> similarity index 100%
> rename from Documentation/hwmon/coretemp
> rename to Documentation/hwmon/coretemp.rst
> diff --git a/Documentation/hwmon/da9052 b/Documentation/hwmon/da9052.rst
> similarity index 100%
> rename from Documentation/hwmon/da9052
> rename to Documentation/hwmon/da9052.rst
> diff --git a/Documentation/hwmon/da9055 b/Documentation/hwmon/da9055.rst
> similarity index 100%
> rename from Documentation/hwmon/da9055
> rename to Documentation/hwmon/da9055.rst
> diff --git a/Documentation/hwmon/dme1737 b/Documentation/hwmon/dme1737.rst
> similarity index 100%
> rename from Documentation/hwmon/dme1737
> rename to Documentation/hwmon/dme1737.rst
> diff --git a/Documentation/hwmon/ds1621 b/Documentation/hwmon/ds1621.rst
> similarity index 100%
> rename from Documentation/hwmon/ds1621
> rename to Documentation/hwmon/ds1621.rst
> diff --git a/Documentation/hwmon/ds620 b/Documentation/hwmon/ds620.rst
> similarity index 100%
> rename from Documentation/hwmon/ds620
> rename to Documentation/hwmon/ds620.rst
> diff --git a/Documentation/hwmon/emc1403 b/Documentation/hwmon/emc1403.rst
> similarity index 100%
> rename from Documentation/hwmon/emc1403
> rename to Documentation/hwmon/emc1403.rst
> diff --git a/Documentation/hwmon/emc2103 b/Documentation/hwmon/emc2103.rst
> similarity index 100%
> rename from Documentation/hwmon/emc2103
> rename to Documentation/hwmon/emc2103.rst
> diff --git a/Documentation/hwmon/emc6w201 b/Documentation/hwmon/emc6w201.rst
> similarity index 100%
> rename from Documentation/hwmon/emc6w201
> rename to Documentation/hwmon/emc6w201.rst
> diff --git a/Documentation/hwmon/f71805f b/Documentation/hwmon/f71805f.rst
> similarity index 100%
> rename from Documentation/hwmon/f71805f
> rename to Documentation/hwmon/f71805f.rst
> diff --git a/Documentation/hwmon/f71882fg b/Documentation/hwmon/f71882fg.rst
> similarity index 100%
> rename from Documentation/hwmon/f71882fg
> rename to Documentation/hwmon/f71882fg.rst
> diff --git a/Documentation/hwmon/fam15h_power b/Documentation/hwmon/fam15h_power.rst
> similarity index 100%
> rename from Documentation/hwmon/fam15h_power
> rename to Documentation/hwmon/fam15h_power.rst
> diff --git a/Documentation/hwmon/ftsteutates b/Documentation/hwmon/ftsteutates.rst
> similarity index 100%
> rename from Documentation/hwmon/ftsteutates
> rename to Documentation/hwmon/ftsteutates.rst
> diff --git a/Documentation/hwmon/g760a b/Documentation/hwmon/g760a.rst
> similarity index 100%
> rename from Documentation/hwmon/g760a
> rename to Documentation/hwmon/g760a.rst
> diff --git a/Documentation/hwmon/g762 b/Documentation/hwmon/g762.rst
> similarity index 97%
> rename from Documentation/hwmon/g762
> rename to Documentation/hwmon/g762.rst
> index 54574e26df21..0371b3365c48 100644
> --- a/Documentation/hwmon/g762
> +++ b/Documentation/hwmon/g762.rst
> @@ -7,7 +7,7 @@ modes - PWM or DC - are supported by the device.
>  
>  For additional information, a detailed datasheet is available at
>  http://natisbad.org/NAS/ref/GMT_EDS-762_763-080710-0.2.pdf. sysfs
> -bindings are described in Documentation/hwmon/sysfs-interface.
> +bindings are described in Documentation/hwmon/sysfs-interface.rst.
>  
>  The following entries are available to the user in a subdirectory of
>  /sys/bus/i2c/drivers/g762/ to control the operation of the device.
> diff --git a/Documentation/hwmon/gl518sm b/Documentation/hwmon/gl518sm.rst
> similarity index 100%
> rename from Documentation/hwmon/gl518sm
> rename to Documentation/hwmon/gl518sm.rst
> diff --git a/Documentation/hwmon/hih6130 b/Documentation/hwmon/hih6130.rst
> similarity index 100%
> rename from Documentation/hwmon/hih6130
> rename to Documentation/hwmon/hih6130.rst
> diff --git a/Documentation/hwmon/hwmon-kernel-api.txt b/Documentation/hwmon/hwmon-kernel-api.rst
> similarity index 99%
> rename from Documentation/hwmon/hwmon-kernel-api.txt
> rename to Documentation/hwmon/hwmon-kernel-api.rst
> index b347b959fcda..c41eb6108103 100644
> --- a/Documentation/hwmon/hwmon-kernel-api.txt
> +++ b/Documentation/hwmon/hwmon-kernel-api.rst
> @@ -12,10 +12,10 @@ drivers that want to use the hardware monitoring framework.
>  This document does not describe what a hardware monitoring (hwmon) Driver or
>  Device is. It also does not describe the API which can be used by user space
>  to communicate with a hardware monitoring device. If you want to know this
> -then please read the following file: Documentation/hwmon/sysfs-interface.
> +then please read the following file: Documentation/hwmon/sysfs-interface.rst.
>  
>  For additional guidelines on how to write and improve hwmon drivers, please
> -also read Documentation/hwmon/submitting-patches.
> +also read Documentation/hwmon/submitting-patches.rst.
>  
>  The API
>  -------
> diff --git a/Documentation/hwmon/ibm-cffps b/Documentation/hwmon/ibm-cffps.rst
> similarity index 100%
> rename from Documentation/hwmon/ibm-cffps
> rename to Documentation/hwmon/ibm-cffps.rst
> diff --git a/Documentation/hwmon/ibmaem b/Documentation/hwmon/ibmaem.rst
> similarity index 100%
> rename from Documentation/hwmon/ibmaem
> rename to Documentation/hwmon/ibmaem.rst
> diff --git a/Documentation/hwmon/ibmpowernv b/Documentation/hwmon/ibmpowernv.rst
> similarity index 100%
> rename from Documentation/hwmon/ibmpowernv
> rename to Documentation/hwmon/ibmpowernv.rst
> diff --git a/Documentation/hwmon/ina209 b/Documentation/hwmon/ina209.rst
> similarity index 100%
> rename from Documentation/hwmon/ina209
> rename to Documentation/hwmon/ina209.rst
> diff --git a/Documentation/hwmon/ina2xx b/Documentation/hwmon/ina2xx.rst
> similarity index 97%
> rename from Documentation/hwmon/ina2xx
> rename to Documentation/hwmon/ina2xx.rst
> index 95badf9c396f..94b9a260c518 100644
> --- a/Documentation/hwmon/ina2xx
> +++ b/Documentation/hwmon/ina2xx.rst
> @@ -78,7 +78,7 @@ refer to the Documentation/devicetree/bindings/hwmon/ina2xx.txt for bindings
>  if the device tree is used.
>  
>  Additionally ina226 supports update_interval attribute as described in
> -Documentation/hwmon/sysfs-interface. Internally the interval is the sum of
> +Documentation/hwmon/sysfs-interface.rst. Internally the interval is the sum of
>  bus and shunt voltage conversion times multiplied by the averaging rate. We
>  don't touch the conversion times and only modify the number of averages. The
>  lower limit of the update_interval is 2 ms, the upper limit is 2253 ms.
> diff --git a/Documentation/hwmon/ina3221 b/Documentation/hwmon/ina3221.rst
> similarity index 100%
> rename from Documentation/hwmon/ina3221
> rename to Documentation/hwmon/ina3221.rst
> diff --git a/Documentation/hwmon/index.rst b/Documentation/hwmon/index.rst
> new file mode 100644
> index 000000000000..893804414510
> --- /dev/null
> +++ b/Documentation/hwmon/index.rst
> @@ -0,0 +1,179 @@
> +=========================
> +Linux Hardware Monitoring
> +=========================
> +
> +.. toctree::
> +   :maxdepth: 1
> +
> +   hwmon-kernel-api.rst
> +   pmbus-core.rst
> +   submitting-patches.rst
> +   sysfs-interface.rst
> +   userspace-tools.rst
> +
> +Hardware Monitoring Kernel Drivers
> +==================================
> +
> +.. toctree::
> +   :maxdepth: 1
> +
> +   ab8500.rst
> +   abituguru.rst
> +   abituguru3.rst
> +   abx500.rst
> +   acpi_power_meter.rst
> +   ad7314.rst
> +   adc128d818.rst
> +   adm1021.rst
> +   adm1025.rst
> +   adm1026.rst
> +   adm1031.rst
> +   adm1275.rst
> +   adm9240.rst
> +   ads1015.rst
> +   ads7828.rst
> +   adt7410.rst
> +   adt7411.rst
> +   adt7462.rst
> +   adt7470.rst
> +   adt7475.rst
> +   amc6821.rst
> +   asb100.rst
> +   asc7621.rst
> +   aspeed-pwm-tacho.rst
> +   coretemp.rst
> +   da9052.rst
> +   da9055.rst
> +   dme1737.rst
> +   ds1621.rst
> +   ds620.rst
> +   emc1403.rst
> +   emc2103.rst
> +   emc6w201.rst
> +   f71805f.rst
> +   f71882fg.rst
> +   fam15h_power.rst
> +   ftsteutates.rst
> +   g760a.rst
> +   g762.rst
> +   gl518sm.rst
> +   hih6130.rst
> +   ibmaem.rst
> +   ibm-cffps.rst
> +   ibmpowernv.rst
> +   ina209.rst
> +   ina2xx.rst
> +   ina3221.rst
> +   ir35221.rst
> +   it87.rst
> +   jc42.rst
> +   k10temp.rst
> +   k8temp.rst
> +   lineage-pem.rst
> +   lm25066.rst
> +   lm63.rst
> +   lm70.rst
> +   lm73.rst
> +   lm75.rst
> +   lm77.rst
> +   lm78.rst
> +   lm80.rst
> +   lm83.rst
> +   lm85.rst
> +   lm87.rst
> +   lm90.rst
> +   lm92.rst
> +   lm93.rst
> +   lm95234.rst
> +   lm95245.rst
> +   ltc2945.rst
> +   ltc2978.rst
> +   ltc2990.rst
> +   ltc3815.rst
> +   ltc4151.rst
> +   ltc4215.rst
> +   ltc4245.rst
> +   ltc4260.rst
> +   ltc4261.rst
> +   max16064.rst
> +   max16065.rst
> +   max1619.rst
> +   max1668.rst
> +   max197.rst
> +   max20751.rst
> +   max31722.rst
> +   max31785.rst
> +   max31790.rst
> +   max34440.rst
> +   max6639.rst
> +   max6642.rst
> +   max6650.rst
> +   max6697.rst
> +   max8688.rst
> +   mc13783-adc.rst
> +   mcp3021.rst
> +   menf21bmc.rst
> +   mlxreg-fan.rst
> +   nct6683.rst
> +   nct6775.rst
> +   nct7802.rst
> +   nct7904.rst
> +   npcm750-pwm-fan.rst
> +   nsa320.rst
> +   ntc_thermistor.rst
> +   occ.rst
> +   pc87360.rst
> +   pc87427.rst
> +   pcf8591.rst
> +   pmbus.rst
> +   powr1220.rst
> +   pwm-fan.rst
> +   raspberrypi-hwmon.rst
> +   sch5627.rst
> +   sch5636.rst
> +   scpi-hwmon.rst
> +   sht15.rst
> +   sht21.rst
> +   sht3x.rst
> +   shtc1.rst
> +   sis5595.rst
> +   smm665.rst
> +   smsc47b397.rst
> +   smsc47m192.rst
> +   smsc47m1.rst
> +   tc654.rst
> +   tc74.rst
> +   thmc50.rst
> +   tmp102.rst
> +   tmp103.rst
> +   tmp108.rst
> +   tmp401.rst
> +   tmp421.rst
> +   tps40422.rst
> +   twl4030-madc-hwmon.rst
> +   ucd9000.rst
> +   ucd9200.rst
> +   vexpress.rst
> +   via686a.rst
> +   vt1211.rst
> +   w83627ehf.rst
> +   w83627hf.rst
> +   w83773g.rst
> +   w83781d.rst
> +   w83791d.rst
> +   w83792d.rst
> +   w83793.rst
> +   w83795.rst
> +   w83l785ts.rst
> +   w83l786ng.rst
> +   wm831x.rst
> +   wm8350.rst
> +   xgene-hwmon.rst
> +   zl6100.rst
> +
> +.. only::  subproject and html
> +
> +   Indices
> +   =======
> +
> +   * :ref:`genindex`
> diff --git a/Documentation/hwmon/ir35221 b/Documentation/hwmon/ir35221.rst
> similarity index 100%
> rename from Documentation/hwmon/ir35221
> rename to Documentation/hwmon/ir35221.rst
> diff --git a/Documentation/hwmon/it87 b/Documentation/hwmon/it87.rst
> similarity index 100%
> rename from Documentation/hwmon/it87
> rename to Documentation/hwmon/it87.rst
> diff --git a/Documentation/hwmon/jc42 b/Documentation/hwmon/jc42.rst
> similarity index 100%
> rename from Documentation/hwmon/jc42
> rename to Documentation/hwmon/jc42.rst
> diff --git a/Documentation/hwmon/k10temp b/Documentation/hwmon/k10temp.rst
> similarity index 100%
> rename from Documentation/hwmon/k10temp
> rename to Documentation/hwmon/k10temp.rst
> diff --git a/Documentation/hwmon/k8temp b/Documentation/hwmon/k8temp.rst
> similarity index 100%
> rename from Documentation/hwmon/k8temp
> rename to Documentation/hwmon/k8temp.rst
> diff --git a/Documentation/hwmon/lineage-pem b/Documentation/hwmon/lineage-pem.rst
> similarity index 100%
> rename from Documentation/hwmon/lineage-pem
> rename to Documentation/hwmon/lineage-pem.rst
> diff --git a/Documentation/hwmon/lm25066 b/Documentation/hwmon/lm25066.rst
> similarity index 97%
> rename from Documentation/hwmon/lm25066
> rename to Documentation/hwmon/lm25066.rst
> index 60b7f2722931..da15e3094c8c 100644
> --- a/Documentation/hwmon/lm25066
> +++ b/Documentation/hwmon/lm25066.rst
> @@ -69,7 +69,7 @@ LM25066, LM5064, and LM5066/LM5066I Power Management, Monitoring,
>  Control, and Protection ICs.
>  
>  The driver is a client driver to the core PMBus driver. Please see
> -Documentation/hwmon/pmbus for details on PMBus client drivers.
> +Documentation/hwmon/pmbus.rst for details on PMBus client drivers.
>  
>  
>  Usage Notes
> diff --git a/Documentation/hwmon/lm63 b/Documentation/hwmon/lm63.rst
> similarity index 100%
> rename from Documentation/hwmon/lm63
> rename to Documentation/hwmon/lm63.rst
> diff --git a/Documentation/hwmon/lm70 b/Documentation/hwmon/lm70.rst
> similarity index 100%
> rename from Documentation/hwmon/lm70
> rename to Documentation/hwmon/lm70.rst
> diff --git a/Documentation/hwmon/lm73 b/Documentation/hwmon/lm73.rst
> similarity index 100%
> rename from Documentation/hwmon/lm73
> rename to Documentation/hwmon/lm73.rst
> diff --git a/Documentation/hwmon/lm75 b/Documentation/hwmon/lm75.rst
> similarity index 100%
> rename from Documentation/hwmon/lm75
> rename to Documentation/hwmon/lm75.rst
> diff --git a/Documentation/hwmon/lm77 b/Documentation/hwmon/lm77.rst
> similarity index 100%
> rename from Documentation/hwmon/lm77
> rename to Documentation/hwmon/lm77.rst
> diff --git a/Documentation/hwmon/lm78 b/Documentation/hwmon/lm78.rst
> similarity index 100%
> rename from Documentation/hwmon/lm78
> rename to Documentation/hwmon/lm78.rst
> diff --git a/Documentation/hwmon/lm80 b/Documentation/hwmon/lm80.rst
> similarity index 100%
> rename from Documentation/hwmon/lm80
> rename to Documentation/hwmon/lm80.rst
> diff --git a/Documentation/hwmon/lm83 b/Documentation/hwmon/lm83.rst
> similarity index 100%
> rename from Documentation/hwmon/lm83
> rename to Documentation/hwmon/lm83.rst
> diff --git a/Documentation/hwmon/lm85 b/Documentation/hwmon/lm85.rst
> similarity index 100%
> rename from Documentation/hwmon/lm85
> rename to Documentation/hwmon/lm85.rst
> diff --git a/Documentation/hwmon/lm87 b/Documentation/hwmon/lm87.rst
> similarity index 100%
> rename from Documentation/hwmon/lm87
> rename to Documentation/hwmon/lm87.rst
> diff --git a/Documentation/hwmon/lm90 b/Documentation/hwmon/lm90.rst
> similarity index 100%
> rename from Documentation/hwmon/lm90
> rename to Documentation/hwmon/lm90.rst
> diff --git a/Documentation/hwmon/lm92 b/Documentation/hwmon/lm92.rst
> similarity index 100%
> rename from Documentation/hwmon/lm92
> rename to Documentation/hwmon/lm92.rst
> diff --git a/Documentation/hwmon/lm93 b/Documentation/hwmon/lm93.rst
> similarity index 100%
> rename from Documentation/hwmon/lm93
> rename to Documentation/hwmon/lm93.rst
> diff --git a/Documentation/hwmon/lm95234 b/Documentation/hwmon/lm95234.rst
> similarity index 100%
> rename from Documentation/hwmon/lm95234
> rename to Documentation/hwmon/lm95234.rst
> diff --git a/Documentation/hwmon/lm95245 b/Documentation/hwmon/lm95245.rst
> similarity index 100%
> rename from Documentation/hwmon/lm95245
> rename to Documentation/hwmon/lm95245.rst
> diff --git a/Documentation/hwmon/ltc2945 b/Documentation/hwmon/ltc2945.rst
> similarity index 100%
> rename from Documentation/hwmon/ltc2945
> rename to Documentation/hwmon/ltc2945.rst
> diff --git a/Documentation/hwmon/ltc2978 b/Documentation/hwmon/ltc2978.rst
> similarity index 100%
> rename from Documentation/hwmon/ltc2978
> rename to Documentation/hwmon/ltc2978.rst
> diff --git a/Documentation/hwmon/ltc2990 b/Documentation/hwmon/ltc2990.rst
> similarity index 100%
> rename from Documentation/hwmon/ltc2990
> rename to Documentation/hwmon/ltc2990.rst
> diff --git a/Documentation/hwmon/ltc3815 b/Documentation/hwmon/ltc3815.rst
> similarity index 100%
> rename from Documentation/hwmon/ltc3815
> rename to Documentation/hwmon/ltc3815.rst
> diff --git a/Documentation/hwmon/ltc4151 b/Documentation/hwmon/ltc4151.rst
> similarity index 100%
> rename from Documentation/hwmon/ltc4151
> rename to Documentation/hwmon/ltc4151.rst
> diff --git a/Documentation/hwmon/ltc4215 b/Documentation/hwmon/ltc4215.rst
> similarity index 100%
> rename from Documentation/hwmon/ltc4215
> rename to Documentation/hwmon/ltc4215.rst
> diff --git a/Documentation/hwmon/ltc4245 b/Documentation/hwmon/ltc4245.rst
> similarity index 100%
> rename from Documentation/hwmon/ltc4245
> rename to Documentation/hwmon/ltc4245.rst
> diff --git a/Documentation/hwmon/ltc4260 b/Documentation/hwmon/ltc4260.rst
> similarity index 100%
> rename from Documentation/hwmon/ltc4260
> rename to Documentation/hwmon/ltc4260.rst
> diff --git a/Documentation/hwmon/ltc4261 b/Documentation/hwmon/ltc4261.rst
> similarity index 100%
> rename from Documentation/hwmon/ltc4261
> rename to Documentation/hwmon/ltc4261.rst
> diff --git a/Documentation/hwmon/max16064 b/Documentation/hwmon/max16064.rst
> similarity index 96%
> rename from Documentation/hwmon/max16064
> rename to Documentation/hwmon/max16064.rst
> index 61ec679dc477..6d5e9538991f 100644
> --- a/Documentation/hwmon/max16064
> +++ b/Documentation/hwmon/max16064.rst
> @@ -21,7 +21,7 @@ This driver supports hardware monitoring for Maxim MAX16064 Quad Power-Supply
>  Controller with Active-Voltage Output Control and PMBus Interface.
>  
>  The driver is a client driver to the core PMBus driver.
> -Please see Documentation/hwmon/pmbus for details on PMBus client drivers.
> +Please see Documentation/hwmon/pmbus.rst for details on PMBus client drivers.
>  
>  
>  Usage Notes
> diff --git a/Documentation/hwmon/max16065 b/Documentation/hwmon/max16065.rst
> similarity index 100%
> rename from Documentation/hwmon/max16065
> rename to Documentation/hwmon/max16065.rst
> diff --git a/Documentation/hwmon/max1619 b/Documentation/hwmon/max1619.rst
> similarity index 99%
> rename from Documentation/hwmon/max1619
> rename to Documentation/hwmon/max1619.rst
> index 4b3762c4eceb..e25956e70f73 100644
> --- a/Documentation/hwmon/max1619
> +++ b/Documentation/hwmon/max1619.rst
> @@ -31,4 +31,3 @@ Only the external sensor has high and low limits.
>  The max1619 driver will not update its values more frequently than every
>  other second; reading them more often will do no harm, but will return
>  'old' values.
> -
> diff --git a/Documentation/hwmon/max1668 b/Documentation/hwmon/max1668.rst
> similarity index 100%
> rename from Documentation/hwmon/max1668
> rename to Documentation/hwmon/max1668.rst
> diff --git a/Documentation/hwmon/max197 b/Documentation/hwmon/max197.rst
> similarity index 100%
> rename from Documentation/hwmon/max197
> rename to Documentation/hwmon/max197.rst
> diff --git a/Documentation/hwmon/max20751 b/Documentation/hwmon/max20751.rst
> similarity index 96%
> rename from Documentation/hwmon/max20751
> rename to Documentation/hwmon/max20751.rst
> index d546695900ef..aa4469be6674 100644
> --- a/Documentation/hwmon/max20751
> +++ b/Documentation/hwmon/max20751.rst
> @@ -23,7 +23,7 @@ This driver supports MAX20751 Multiphase Master with PMBus Interface
>  and Internal Buck Converter.
>  
>  The driver is a client driver to the core PMBus driver.
> -Please see Documentation/hwmon/pmbus for details on PMBus client drivers.
> +Please see Documentation/hwmon/pmbus.rst for details on PMBus client drivers.
>  
>  
>  Usage Notes
> diff --git a/Documentation/hwmon/max31722 b/Documentation/hwmon/max31722.rst
> similarity index 100%
> rename from Documentation/hwmon/max31722
> rename to Documentation/hwmon/max31722.rst
> diff --git a/Documentation/hwmon/max31785 b/Documentation/hwmon/max31785.rst
> similarity index 100%
> rename from Documentation/hwmon/max31785
> rename to Documentation/hwmon/max31785.rst
> diff --git a/Documentation/hwmon/max31790 b/Documentation/hwmon/max31790.rst
> similarity index 100%
> rename from Documentation/hwmon/max31790
> rename to Documentation/hwmon/max31790.rst
> diff --git a/Documentation/hwmon/max34440 b/Documentation/hwmon/max34440.rst
> similarity index 98%
> rename from Documentation/hwmon/max34440
> rename to Documentation/hwmon/max34440.rst
> index 639838ef29fd..939138e12b02 100644
> --- a/Documentation/hwmon/max34440
> +++ b/Documentation/hwmon/max34440.rst
> @@ -76,7 +76,7 @@ based on GIN pins. The MAX34460 supports 12 voltage channels, and the MAX34461
>  supports 16 voltage channels.
>  
>  The driver is a client driver to the core PMBus driver. Please see
> -Documentation/hwmon/pmbus for details on PMBus client drivers.
> +Documentation/hwmon/pmbus.rst for details on PMBus client drivers.
>  
>  
>  Usage Notes
> diff --git a/Documentation/hwmon/max6639 b/Documentation/hwmon/max6639.rst
> similarity index 100%
> rename from Documentation/hwmon/max6639
> rename to Documentation/hwmon/max6639.rst
> diff --git a/Documentation/hwmon/max6642 b/Documentation/hwmon/max6642.rst
> similarity index 100%
> rename from Documentation/hwmon/max6642
> rename to Documentation/hwmon/max6642.rst
> diff --git a/Documentation/hwmon/max6650 b/Documentation/hwmon/max6650.rst
> similarity index 99%
> rename from Documentation/hwmon/max6650
> rename to Documentation/hwmon/max6650.rst
> index 74dc3f0caaa2..253482add082 100644
> --- a/Documentation/hwmon/max6650
> +++ b/Documentation/hwmon/max6650.rst
> @@ -72,4 +72,3 @@ clock: The clock frequency in Hz of the chip the driver should assume [254000]
>  
>  Please have a look at the MAX6650/6651 data sheet and make sure that you fully
>  understand the meaning of these parameters before you attempt to change them.
> -
> diff --git a/Documentation/hwmon/max6697 b/Documentation/hwmon/max6697.rst
> similarity index 100%
> rename from Documentation/hwmon/max6697
> rename to Documentation/hwmon/max6697.rst
> diff --git a/Documentation/hwmon/max8688 b/Documentation/hwmon/max8688.rst
> similarity index 97%
> rename from Documentation/hwmon/max8688
> rename to Documentation/hwmon/max8688.rst
> index 43da139234c1..009487759c61 100644
> --- a/Documentation/hwmon/max8688
> +++ b/Documentation/hwmon/max8688.rst
> @@ -21,7 +21,7 @@ This driver supports hardware monitoring for Maxim MAX8688 Digital Power-Supply
>  Controller/Monitor with PMBus Interface.
>  
>  The driver is a client driver to the core PMBus driver. Please see
> -Documentation/hwmon/pmbus for details on PMBus client drivers.
> +Documentation/hwmon/pmbus.rst for details on PMBus client drivers.
>  
>  
>  Usage Notes
> diff --git a/Documentation/hwmon/mc13783-adc b/Documentation/hwmon/mc13783-adc.rst
> similarity index 100%
> rename from Documentation/hwmon/mc13783-adc
> rename to Documentation/hwmon/mc13783-adc.rst
> diff --git a/Documentation/hwmon/mcp3021 b/Documentation/hwmon/mcp3021.rst
> similarity index 100%
> rename from Documentation/hwmon/mcp3021
> rename to Documentation/hwmon/mcp3021.rst
> diff --git a/Documentation/hwmon/menf21bmc b/Documentation/hwmon/menf21bmc.rst
> similarity index 100%
> rename from Documentation/hwmon/menf21bmc
> rename to Documentation/hwmon/menf21bmc.rst
> diff --git a/Documentation/hwmon/mlxreg-fan b/Documentation/hwmon/mlxreg-fan.rst
> similarity index 100%
> rename from Documentation/hwmon/mlxreg-fan
> rename to Documentation/hwmon/mlxreg-fan.rst
> diff --git a/Documentation/hwmon/nct6683 b/Documentation/hwmon/nct6683.rst
> similarity index 100%
> rename from Documentation/hwmon/nct6683
> rename to Documentation/hwmon/nct6683.rst
> diff --git a/Documentation/hwmon/nct6775 b/Documentation/hwmon/nct6775.rst
> similarity index 100%
> rename from Documentation/hwmon/nct6775
> rename to Documentation/hwmon/nct6775.rst
> diff --git a/Documentation/hwmon/nct7802 b/Documentation/hwmon/nct7802.rst
> similarity index 100%
> rename from Documentation/hwmon/nct7802
> rename to Documentation/hwmon/nct7802.rst
> diff --git a/Documentation/hwmon/nct7904 b/Documentation/hwmon/nct7904.rst
> similarity index 100%
> rename from Documentation/hwmon/nct7904
> rename to Documentation/hwmon/nct7904.rst
> diff --git a/Documentation/hwmon/npcm750-pwm-fan b/Documentation/hwmon/npcm750-pwm-fan.rst
> similarity index 100%
> rename from Documentation/hwmon/npcm750-pwm-fan
> rename to Documentation/hwmon/npcm750-pwm-fan.rst
> diff --git a/Documentation/hwmon/nsa320 b/Documentation/hwmon/nsa320.rst
> similarity index 100%
> rename from Documentation/hwmon/nsa320
> rename to Documentation/hwmon/nsa320.rst
> diff --git a/Documentation/hwmon/ntc_thermistor b/Documentation/hwmon/ntc_thermistor.rst
> similarity index 100%
> rename from Documentation/hwmon/ntc_thermistor
> rename to Documentation/hwmon/ntc_thermistor.rst
> diff --git a/Documentation/hwmon/occ b/Documentation/hwmon/occ.rst
> similarity index 100%
> rename from Documentation/hwmon/occ
> rename to Documentation/hwmon/occ.rst
> diff --git a/Documentation/hwmon/pc87360 b/Documentation/hwmon/pc87360.rst
> similarity index 100%
> rename from Documentation/hwmon/pc87360
> rename to Documentation/hwmon/pc87360.rst
> diff --git a/Documentation/hwmon/pc87427 b/Documentation/hwmon/pc87427.rst
> similarity index 100%
> rename from Documentation/hwmon/pc87427
> rename to Documentation/hwmon/pc87427.rst
> diff --git a/Documentation/hwmon/pcf8591 b/Documentation/hwmon/pcf8591.rst
> similarity index 100%
> rename from Documentation/hwmon/pcf8591
> rename to Documentation/hwmon/pcf8591.rst
> diff --git a/Documentation/hwmon/pmbus-core b/Documentation/hwmon/pmbus-core.rst
> similarity index 100%
> rename from Documentation/hwmon/pmbus-core
> rename to Documentation/hwmon/pmbus-core.rst
> diff --git a/Documentation/hwmon/pmbus b/Documentation/hwmon/pmbus.rst
> similarity index 100%
> rename from Documentation/hwmon/pmbus
> rename to Documentation/hwmon/pmbus.rst
> diff --git a/Documentation/hwmon/powr1220 b/Documentation/hwmon/powr1220.rst
> similarity index 100%
> rename from Documentation/hwmon/powr1220
> rename to Documentation/hwmon/powr1220.rst
> diff --git a/Documentation/hwmon/pwm-fan b/Documentation/hwmon/pwm-fan.rst
> similarity index 100%
> rename from Documentation/hwmon/pwm-fan
> rename to Documentation/hwmon/pwm-fan.rst
> diff --git a/Documentation/hwmon/raspberrypi-hwmon b/Documentation/hwmon/raspberrypi-hwmon.rst
> similarity index 100%
> rename from Documentation/hwmon/raspberrypi-hwmon
> rename to Documentation/hwmon/raspberrypi-hwmon.rst
> diff --git a/Documentation/hwmon/sch5627 b/Documentation/hwmon/sch5627.rst
> similarity index 100%
> rename from Documentation/hwmon/sch5627
> rename to Documentation/hwmon/sch5627.rst
> diff --git a/Documentation/hwmon/sch5636 b/Documentation/hwmon/sch5636.rst
> similarity index 100%
> rename from Documentation/hwmon/sch5636
> rename to Documentation/hwmon/sch5636.rst
> diff --git a/Documentation/hwmon/scpi-hwmon b/Documentation/hwmon/scpi-hwmon.rst
> similarity index 100%
> rename from Documentation/hwmon/scpi-hwmon
> rename to Documentation/hwmon/scpi-hwmon.rst
> diff --git a/Documentation/hwmon/sht15 b/Documentation/hwmon/sht15.rst
> similarity index 100%
> rename from Documentation/hwmon/sht15
> rename to Documentation/hwmon/sht15.rst
> diff --git a/Documentation/hwmon/sht21 b/Documentation/hwmon/sht21.rst
> similarity index 100%
> rename from Documentation/hwmon/sht21
> rename to Documentation/hwmon/sht21.rst
> diff --git a/Documentation/hwmon/sht3x b/Documentation/hwmon/sht3x.rst
> similarity index 100%
> rename from Documentation/hwmon/sht3x
> rename to Documentation/hwmon/sht3x.rst
> diff --git a/Documentation/hwmon/shtc1 b/Documentation/hwmon/shtc1.rst
> similarity index 100%
> rename from Documentation/hwmon/shtc1
> rename to Documentation/hwmon/shtc1.rst
> diff --git a/Documentation/hwmon/sis5595 b/Documentation/hwmon/sis5595.rst
> similarity index 99%
> rename from Documentation/hwmon/sis5595
> rename to Documentation/hwmon/sis5595.rst
> index 5acba6b0c0db..16123b3bfff9 100644
> --- a/Documentation/hwmon/sis5595
> +++ b/Documentation/hwmon/sis5595.rst
> @@ -121,4 +121,3 @@ Problems
>  --------
>  Some chips refuse to be enabled. We don't know why.
>  The driver will recognize this and print a message in dmesg.
> -
> diff --git a/Documentation/hwmon/smm665 b/Documentation/hwmon/smm665.rst
> similarity index 100%
> rename from Documentation/hwmon/smm665
> rename to Documentation/hwmon/smm665.rst
> diff --git a/Documentation/hwmon/smsc47b397 b/Documentation/hwmon/smsc47b397.rst
> similarity index 100%
> rename from Documentation/hwmon/smsc47b397
> rename to Documentation/hwmon/smsc47b397.rst
> diff --git a/Documentation/hwmon/smsc47m1 b/Documentation/hwmon/smsc47m1.rst
> similarity index 100%
> rename from Documentation/hwmon/smsc47m1
> rename to Documentation/hwmon/smsc47m1.rst
> diff --git a/Documentation/hwmon/smsc47m192 b/Documentation/hwmon/smsc47m192.rst
> similarity index 100%
> rename from Documentation/hwmon/smsc47m192
> rename to Documentation/hwmon/smsc47m192.rst
> diff --git a/Documentation/hwmon/submitting-patches b/Documentation/hwmon/submitting-patches.rst
> similarity index 98%
> rename from Documentation/hwmon/submitting-patches
> rename to Documentation/hwmon/submitting-patches.rst
> index 12540b7d9b50..f9796b9d9db6 100644
> --- a/Documentation/hwmon/submitting-patches
> +++ b/Documentation/hwmon/submitting-patches.rst
> @@ -39,7 +39,7 @@ increase the chances of your change being accepted.
>  2. Adding functionality to existing drivers
>  -------------------------------------------
>  
> -* Make sure the documentation in Documentation/hwmon/<driver_name> is up to
> +* Make sure the documentation in Documentation/hwmon/<driver_name>.rst is up to
>    date.
>  
>  * Make sure the information in Kconfig is up to date.
> @@ -61,7 +61,7 @@ increase the chances of your change being accepted.
>  
>  * Consider adding yourself to MAINTAINERS.
>  
> -* Document the driver in Documentation/hwmon/<driver_name>.
> +* Document the driver in Documentation/hwmon/<driver_name>.rst.
>  
>  * Add the driver to Kconfig and Makefile in alphabetical order.
>  
> @@ -134,7 +134,7 @@ increase the chances of your change being accepted.
>    non-standard attributes, or you believe you do, discuss it on the mailing list
>    first. Either case, provide a detailed explanation why you need the
>    non-standard attribute(s).
> -  Standard attributes are specified in Documentation/hwmon/sysfs-interface.
> +  Standard attributes are specified in Documentation/hwmon/sysfs-interface.rst.
>  
>  * When deciding which sysfs attributes to support, look at the chip's
>    capabilities. While we do not expect your driver to support everything the
> diff --git a/Documentation/hwmon/sysfs-interface b/Documentation/hwmon/sysfs-interface.rst
> similarity index 100%
> rename from Documentation/hwmon/sysfs-interface
> rename to Documentation/hwmon/sysfs-interface.rst
> diff --git a/Documentation/hwmon/tc654 b/Documentation/hwmon/tc654.rst
> similarity index 100%
> rename from Documentation/hwmon/tc654
> rename to Documentation/hwmon/tc654.rst
> diff --git a/Documentation/hwmon/tc74 b/Documentation/hwmon/tc74.rst
> similarity index 100%
> rename from Documentation/hwmon/tc74
> rename to Documentation/hwmon/tc74.rst
> diff --git a/Documentation/hwmon/thmc50 b/Documentation/hwmon/thmc50.rst
> similarity index 99%
> rename from Documentation/hwmon/thmc50
> rename to Documentation/hwmon/thmc50.rst
> index 6dba1b59b20c..cfff3885287d 100644
> --- a/Documentation/hwmon/thmc50
> +++ b/Documentation/hwmon/thmc50.rst
> @@ -87,4 +87,3 @@ so it stops fans even if the value 0 into the ANALOG_OUT register does not.
>  
>  The driver was tested on Compaq AP550 with two ADM1022 chips (one works
>  in the temp3 mode), five temperature readings and two fans.
> -
> diff --git a/Documentation/hwmon/tmp102 b/Documentation/hwmon/tmp102.rst
> similarity index 93%
> rename from Documentation/hwmon/tmp102
> rename to Documentation/hwmon/tmp102.rst
> index 5e34821df4ab..b1f585531a88 100644
> --- a/Documentation/hwmon/tmp102
> +++ b/Documentation/hwmon/tmp102.rst
> @@ -28,4 +28,4 @@ The TMP102 has a programmable update rate that can select between 8, 4, 1, and
>  0.5 Hz. (Currently the driver only supports the default of 4 Hz).
>  
>  The driver provides the common sysfs-interface for temperatures (see
> -Documentation/hwmon/sysfs-interface under Temperatures).
> +Documentation/hwmon/sysfs-interface.rst under Temperatures).
> diff --git a/Documentation/hwmon/tmp103 b/Documentation/hwmon/tmp103.rst
> similarity index 92%
> rename from Documentation/hwmon/tmp103
> rename to Documentation/hwmon/tmp103.rst
> index 7682a795e38c..15d25806d585 100644
> --- a/Documentation/hwmon/tmp103
> +++ b/Documentation/hwmon/tmp103.rst
> @@ -27,7 +27,7 @@ Resolution: 8 Bits
>  Accuracy: ±1°C Typ (–10°C to +100°C)
>  
>  The driver provides the common sysfs-interface for temperatures (see
> -Documentation/hwmon/sysfs-interface under Temperatures).
> +Documentation/hwmon/sysfs-interface.rst under Temperatures).
>  
>  Please refer how to instantiate this driver:
>  Documentation/i2c/instantiating-devices
> diff --git a/Documentation/hwmon/tmp108 b/Documentation/hwmon/tmp108.rst
> similarity index 95%
> rename from Documentation/hwmon/tmp108
> rename to Documentation/hwmon/tmp108.rst
> index 7e08b7ef1e2f..5f4266a16cb2 100644
> --- a/Documentation/hwmon/tmp108
> +++ b/Documentation/hwmon/tmp108.rst
> @@ -38,4 +38,4 @@ and then the device is shut down automatically. (This driver only supports
>  continuous mode.)
>  
>  The driver provides the common sysfs-interface for temperatures (see
> -Documentation/hwmon/sysfs-interface under Temperatures).
> +Documentation/hwmon/sysfs-interface.rst under Temperatures).
> diff --git a/Documentation/hwmon/tmp401 b/Documentation/hwmon/tmp401.rst
> similarity index 97%
> rename from Documentation/hwmon/tmp401
> rename to Documentation/hwmon/tmp401.rst
> index bd865bbdb38d..6a05a0719bc7 100644
> --- a/Documentation/hwmon/tmp401
> +++ b/Documentation/hwmon/tmp401.rst
> @@ -68,7 +68,7 @@ supported by the driver so far, so using the default resolution of 0.5
>  degree).
>  
>  The driver provides the common sysfs-interface for temperatures (see
> -Documentation/hwmon/sysfs-interface under Temperatures).
> +Documentation/hwmon/sysfs-interface.rst under Temperatures).
>  
>  The TMP411 and TMP431 chips are compatible with TMP401. TMP411 provides
>  some additional features.
> diff --git a/Documentation/hwmon/tmp421 b/Documentation/hwmon/tmp421.rst
> similarity index 100%
> rename from Documentation/hwmon/tmp421
> rename to Documentation/hwmon/tmp421.rst
> diff --git a/Documentation/hwmon/tps40422 b/Documentation/hwmon/tps40422.rst
> similarity index 96%
> rename from Documentation/hwmon/tps40422
> rename to Documentation/hwmon/tps40422.rst
> index 359751eb5ed4..b691e30479dd 100644
> --- a/Documentation/hwmon/tps40422
> +++ b/Documentation/hwmon/tps40422.rst
> @@ -21,7 +21,7 @@ This driver supports TI TPS40422 Dual-Output or Two-Phase Synchronous Buck
>  Controller with PMBus
>  
>  The driver is a client driver to the core PMBus driver.
> -Please see Documentation/hwmon/pmbus for details on PMBus client drivers.
> +Please see Documentation/hwmon/pmbus.rst for details on PMBus client drivers.
>  
>  
>  Usage Notes
> diff --git a/Documentation/hwmon/twl4030-madc-hwmon b/Documentation/hwmon/twl4030-madc-hwmon.rst
> similarity index 100%
> rename from Documentation/hwmon/twl4030-madc-hwmon
> rename to Documentation/hwmon/twl4030-madc-hwmon.rst
> diff --git a/Documentation/hwmon/ucd9000 b/Documentation/hwmon/ucd9000.rst
> similarity index 97%
> rename from Documentation/hwmon/ucd9000
> rename to Documentation/hwmon/ucd9000.rst
> index d69061b7312c..ebc4f2b3bfea 100644
> --- a/Documentation/hwmon/ucd9000
> +++ b/Documentation/hwmon/ucd9000.rst
> @@ -57,7 +57,7 @@ system-health monitor. The device integrates a 12-bit ADC for monitoring up to
>  13 power-supply voltage, current, or temperature inputs.
>  
>  This driver is a client driver to the core PMBus driver. Please see
> -Documentation/hwmon/pmbus for details on PMBus client drivers.
> +Documentation/hwmon/pmbus.rst for details on PMBus client drivers.
>  
>  
>  Usage Notes
> @@ -72,7 +72,7 @@ Platform data support
>  ---------------------
>  
>  The driver supports standard PMBus driver platform data. Please see
> -Documentation/hwmon/pmbus for details.
> +Documentation/hwmon/pmbus.rst for details.
>  
>  
>  Sysfs entries
> diff --git a/Documentation/hwmon/ucd9200 b/Documentation/hwmon/ucd9200.rst
> similarity index 97%
> rename from Documentation/hwmon/ucd9200
> rename to Documentation/hwmon/ucd9200.rst
> index 44eda4a579b6..b819dfd75f71 100644
> --- a/Documentation/hwmon/ucd9200
> +++ b/Documentation/hwmon/ucd9200.rst
> @@ -33,7 +33,7 @@ dedicated circuitry for DC/DC loop management with flash memory and a serial
>  interface to support configuration, monitoring and management.
>  
>  This driver is a client driver to the core PMBus driver. Please see
> -Documentation/hwmon/pmbus for details on PMBus client drivers.
> +Documentation/hwmon/pmbus.rst for details on PMBus client drivers.
>  
>  
>  Usage Notes
> @@ -48,7 +48,7 @@ Platform data support
>  ---------------------
>  
>  The driver supports standard PMBus driver platform data. Please see
> -Documentation/hwmon/pmbus for details.
> +Documentation/hwmon/pmbus.rst for details.
>  
>  
>  Sysfs entries
> diff --git a/Documentation/hwmon/userspace-tools b/Documentation/hwmon/userspace-tools.rst
> similarity index 100%
> rename from Documentation/hwmon/userspace-tools
> rename to Documentation/hwmon/userspace-tools.rst
> diff --git a/Documentation/hwmon/vexpress b/Documentation/hwmon/vexpress.rst
> similarity index 100%
> rename from Documentation/hwmon/vexpress
> rename to Documentation/hwmon/vexpress.rst
> diff --git a/Documentation/hwmon/via686a b/Documentation/hwmon/via686a.rst
> similarity index 100%
> rename from Documentation/hwmon/via686a
> rename to Documentation/hwmon/via686a.rst
> diff --git a/Documentation/hwmon/vt1211 b/Documentation/hwmon/vt1211.rst
> similarity index 100%
> rename from Documentation/hwmon/vt1211
> rename to Documentation/hwmon/vt1211.rst
> diff --git a/Documentation/hwmon/w83627ehf b/Documentation/hwmon/w83627ehf.rst
> similarity index 100%
> rename from Documentation/hwmon/w83627ehf
> rename to Documentation/hwmon/w83627ehf.rst
> diff --git a/Documentation/hwmon/w83627hf b/Documentation/hwmon/w83627hf.rst
> similarity index 100%
> rename from Documentation/hwmon/w83627hf
> rename to Documentation/hwmon/w83627hf.rst
> diff --git a/Documentation/hwmon/w83773g b/Documentation/hwmon/w83773g.rst
> similarity index 100%
> rename from Documentation/hwmon/w83773g
> rename to Documentation/hwmon/w83773g.rst
> diff --git a/Documentation/hwmon/w83781d b/Documentation/hwmon/w83781d.rst
> similarity index 100%
> rename from Documentation/hwmon/w83781d
> rename to Documentation/hwmon/w83781d.rst
> diff --git a/Documentation/hwmon/w83791d b/Documentation/hwmon/w83791d.rst
> similarity index 99%
> rename from Documentation/hwmon/w83791d
> rename to Documentation/hwmon/w83791d.rst
> index a91f9e5fb0c6..3adaed39b157 100644
> --- a/Documentation/hwmon/w83791d
> +++ b/Documentation/hwmon/w83791d.rst
> @@ -102,7 +102,7 @@ This file is used for both legacy and new code.
>  
>  The sysfs interface to the beep bitmask has migrated from the original legacy
>  method of a single sysfs beep_mask file to a newer method using multiple
> -`*_beep` files as described in `Documentation/hwmon/sysfs-interface`.
> +`*_beep` files as described in `Documentation/hwmon/sysfs-interface.rst`.
>  
>  A similar change has occurred for the bitmap corresponding to the alarms. The
>  original legacy method used a single sysfs alarms file containing a bitmap
> diff --git a/Documentation/hwmon/w83792d b/Documentation/hwmon/w83792d.rst
> similarity index 100%
> rename from Documentation/hwmon/w83792d
> rename to Documentation/hwmon/w83792d.rst
> diff --git a/Documentation/hwmon/w83793 b/Documentation/hwmon/w83793.rst
> similarity index 100%
> rename from Documentation/hwmon/w83793
> rename to Documentation/hwmon/w83793.rst
> diff --git a/Documentation/hwmon/w83795 b/Documentation/hwmon/w83795.rst
> similarity index 100%
> rename from Documentation/hwmon/w83795
> rename to Documentation/hwmon/w83795.rst
> diff --git a/Documentation/hwmon/w83l785ts b/Documentation/hwmon/w83l785ts.rst
> similarity index 100%
> rename from Documentation/hwmon/w83l785ts
> rename to Documentation/hwmon/w83l785ts.rst
> diff --git a/Documentation/hwmon/w83l786ng b/Documentation/hwmon/w83l786ng.rst
> similarity index 100%
> rename from Documentation/hwmon/w83l786ng
> rename to Documentation/hwmon/w83l786ng.rst
> diff --git a/Documentation/hwmon/wm831x b/Documentation/hwmon/wm831x.rst
> similarity index 100%
> rename from Documentation/hwmon/wm831x
> rename to Documentation/hwmon/wm831x.rst
> diff --git a/Documentation/hwmon/wm8350 b/Documentation/hwmon/wm8350.rst
> similarity index 100%
> rename from Documentation/hwmon/wm8350
> rename to Documentation/hwmon/wm8350.rst
> diff --git a/Documentation/hwmon/xgene-hwmon b/Documentation/hwmon/xgene-hwmon.rst
> similarity index 100%
> rename from Documentation/hwmon/xgene-hwmon
> rename to Documentation/hwmon/xgene-hwmon.rst
> diff --git a/Documentation/hwmon/zl6100 b/Documentation/hwmon/zl6100.rst
> similarity index 98%
> rename from Documentation/hwmon/zl6100
> rename to Documentation/hwmon/zl6100.rst
> index 4029970bace4..41513bb7fe51 100644
> --- a/Documentation/hwmon/zl6100
> +++ b/Documentation/hwmon/zl6100.rst
> @@ -113,7 +113,7 @@ This driver supports hardware monitoring for Intersil / Zilker Labs ZL6100 and
>  compatible digital DC-DC controllers.
>  
>  The driver is a client driver to the core PMBus driver. Please see
> -Documentation/hwmon/pmbus and Documentation.hwmon/pmbus-core for details
> +Documentation/hwmon/pmbus.rst and Documentation.hwmon/pmbus-core for details
>  on PMBus client drivers.
>  
>  
> diff --git a/Documentation/index.rst b/Documentation/index.rst
> index 80a421cb935e..3a710dc24fc8 100644
> --- a/Documentation/index.rst
> +++ b/Documentation/index.rst
> @@ -83,6 +83,7 @@ needed).
>     media/index
>     networking/index
>     input/index
> +   hwmon/index
>     gpu/index
>     security/index
>     sound/index
> diff --git a/Documentation/thermal/sysfs-api.txt b/Documentation/thermal/sysfs-api.txt
> index 911399730c1c..c3fa500df92c 100644
> --- a/Documentation/thermal/sysfs-api.txt
> +++ b/Documentation/thermal/sysfs-api.txt
> @@ -316,7 +316,7 @@ ACPI thermal zones.
>      |---temp[1-*]_input:	The current temperature of thermal zone [1-*]
>      |---temp[1-*]_critical:	The critical trip point of thermal zone [1-*]
>  
> -Please read Documentation/hwmon/sysfs-interface for additional information.
> +Please read Documentation/hwmon/sysfs-interface.rst for additional information.
>  
>  ***************************
>  * Thermal zone attributes *
> diff --git a/MAINTAINERS b/MAINTAINERS
> index 349e5d8c3f58..6269c9d671ca 100644
> --- a/MAINTAINERS
> +++ b/MAINTAINERS
> @@ -468,7 +468,7 @@ ADM1025 HARDWARE MONITOR DRIVER
>  M:	Jean Delvare <jdelvare@suse.com>
>  L:	linux-hwmon@vger.kernel.org
>  S:	Maintained
> -F:	Documentation/hwmon/adm1025
> +F:	Documentation/hwmon/adm1025.rst
>  F:	drivers/hwmon/adm1025.c
>  
>  ADM1029 HARDWARE MONITOR DRIVER
> @@ -520,7 +520,7 @@ ADS1015 HARDWARE MONITOR DRIVER
>  M:	Dirk Eibach <eibach@gdsys.de>
>  L:	linux-hwmon@vger.kernel.org
>  S:	Maintained
> -F:	Documentation/hwmon/ads1015
> +F:	Documentation/hwmon/ads1015.rst
>  F:	drivers/hwmon/ads1015.c
>  F:	include/linux/platform_data/ads1015.h
>  
> @@ -533,7 +533,7 @@ ADT7475 HARDWARE MONITOR DRIVER
>  M:	Jean Delvare <jdelvare@suse.com>
>  L:	linux-hwmon@vger.kernel.org
>  S:	Maintained
> -F:	Documentation/hwmon/adt7475
> +F:	Documentation/hwmon/adt7475.rst
>  F:	drivers/hwmon/adt7475.c
>  
>  ADVANSYS SCSI DRIVER
> @@ -764,7 +764,7 @@ AMD FAM15H PROCESSOR POWER MONITORING DRIVER
>  M:	Huang Rui <ray.huang@amd.com>
>  L:	linux-hwmon@vger.kernel.org
>  S:	Supported
> -F:	Documentation/hwmon/fam15h_power
> +F:	Documentation/hwmon/fam15h_power.rst
>  F:	drivers/hwmon/fam15h_power.c
>  
>  AMD FCH GPIO DRIVER
> @@ -2531,7 +2531,7 @@ ASC7621 HARDWARE MONITOR DRIVER
>  M:	George Joseph <george.joseph@fairview5.com>
>  L:	linux-hwmon@vger.kernel.org
>  S:	Maintained
> -F:	Documentation/hwmon/asc7621
> +F:	Documentation/hwmon/asc7621.rst
>  F:	drivers/hwmon/asc7621.c
>  
>  ASPEED VIDEO ENGINE DRIVER
> @@ -4071,7 +4071,7 @@ CORETEMP HARDWARE MONITORING DRIVER
>  M:	Fenghua Yu <fenghua.yu@intel.com>
>  L:	linux-hwmon@vger.kernel.org
>  S:	Maintained
> -F:	Documentation/hwmon/coretemp
> +F:	Documentation/hwmon/coretemp.rst
>  F:	drivers/hwmon/coretemp.c
>  
>  COSA/SRP SYNC SERIAL DRIVER
> @@ -4627,7 +4627,7 @@ DIALOG SEMICONDUCTOR DRIVERS
>  M:	Support Opensource <support.opensource@diasemi.com>
>  W:	http://www.dialog-semiconductor.com/products
>  S:	Supported
> -F:	Documentation/hwmon/da90??
> +F:	Documentation/hwmon/da90??.rst
>  F:	Documentation/devicetree/bindings/mfd/da90*.txt
>  F:	Documentation/devicetree/bindings/input/da90??-onkey.txt
>  F:	Documentation/devicetree/bindings/thermal/da90??-thermal.txt
> @@ -4778,7 +4778,7 @@ DME1737 HARDWARE MONITOR DRIVER
>  M:	Juerg Haefliger <juergh@gmail.com>
>  L:	linux-hwmon@vger.kernel.org
>  S:	Maintained
> -F:	Documentation/hwmon/dme1737
> +F:	Documentation/hwmon/dme1737.rst
>  F:	drivers/hwmon/dme1737.c
>  
>  DMI/SMBIOS SUPPORT
> @@ -6006,7 +6006,7 @@ F71805F HARDWARE MONITORING DRIVER
>  M:	Jean Delvare <jdelvare@suse.com>
>  L:	linux-hwmon@vger.kernel.org
>  S:	Maintained
> -F:	Documentation/hwmon/f71805f
> +F:	Documentation/hwmon/f71805f.rst
>  F:	drivers/hwmon/f71805f.c
>  
>  FADDR2LINE
> @@ -7687,7 +7687,7 @@ INA209 HARDWARE MONITOR DRIVER
>  M:	Guenter Roeck <linux@roeck-us.net>
>  L:	linux-hwmon@vger.kernel.org
>  S:	Maintained
> -F:	Documentation/hwmon/ina209
> +F:	Documentation/hwmon/ina209.rst
>  F:	Documentation/devicetree/bindings/hwmon/ina2xx.txt
>  F:	drivers/hwmon/ina209.c
>  
> @@ -7695,7 +7695,7 @@ INA2XX HARDWARE MONITOR DRIVER
>  M:	Guenter Roeck <linux@roeck-us.net>
>  L:	linux-hwmon@vger.kernel.org
>  S:	Maintained
> -F:	Documentation/hwmon/ina2xx
> +F:	Documentation/hwmon/ina2xx.rst
>  F:	drivers/hwmon/ina2xx.c
>  F:	include/linux/platform_data/ina2xx.h
>  
> @@ -8328,7 +8328,7 @@ IT87 HARDWARE MONITORING DRIVER
>  M:	Jean Delvare <jdelvare@suse.com>
>  L:	linux-hwmon@vger.kernel.org
>  S:	Maintained
> -F:	Documentation/hwmon/it87
> +F:	Documentation/hwmon/it87.rst
>  F:	drivers/hwmon/it87.c
>  
>  IT913X MEDIA DRIVER
> @@ -8372,7 +8372,7 @@ M:	Guenter Roeck <linux@roeck-us.net>
>  L:	linux-hwmon@vger.kernel.org
>  S:	Maintained
>  F:	drivers/hwmon/jc42.c
> -F:	Documentation/hwmon/jc42
> +F:	Documentation/hwmon/jc42.rst
>  
>  JFS FILESYSTEM
>  M:	Dave Kleikamp <shaggy@kernel.org>
> @@ -8420,14 +8420,14 @@ K10TEMP HARDWARE MONITORING DRIVER
>  M:	Clemens Ladisch <clemens@ladisch.de>
>  L:	linux-hwmon@vger.kernel.org
>  S:	Maintained
> -F:	Documentation/hwmon/k10temp
> +F:	Documentation/hwmon/k10temp.rst
>  F:	drivers/hwmon/k10temp.c
>  
>  K8TEMP HARDWARE MONITORING DRIVER
>  M:	Rudolf Marek <r.marek@assembler.cz>
>  L:	linux-hwmon@vger.kernel.org
>  S:	Maintained
> -F:	Documentation/hwmon/k8temp
> +F:	Documentation/hwmon/k8temp.rst
>  F:	drivers/hwmon/k8temp.c
>  
>  KASAN
> @@ -9118,21 +9118,21 @@ LM78 HARDWARE MONITOR DRIVER
>  M:	Jean Delvare <jdelvare@suse.com>
>  L:	linux-hwmon@vger.kernel.org
>  S:	Maintained
> -F:	Documentation/hwmon/lm78
> +F:	Documentation/hwmon/lm78.rst
>  F:	drivers/hwmon/lm78.c
>  
>  LM83 HARDWARE MONITOR DRIVER
>  M:	Jean Delvare <jdelvare@suse.com>
>  L:	linux-hwmon@vger.kernel.org
>  S:	Maintained
> -F:	Documentation/hwmon/lm83
> +F:	Documentation/hwmon/lm83.rst
>  F:	drivers/hwmon/lm83.c
>  
>  LM90 HARDWARE MONITOR DRIVER
>  M:	Jean Delvare <jdelvare@suse.com>
>  L:	linux-hwmon@vger.kernel.org
>  S:	Maintained
> -F:	Documentation/hwmon/lm90
> +F:	Documentation/hwmon/lm90.rst
>  F:	Documentation/devicetree/bindings/hwmon/lm90.txt
>  F:	drivers/hwmon/lm90.c
>  F:	include/dt-bindings/thermal/lm90.h
> @@ -9141,7 +9141,7 @@ LM95234 HARDWARE MONITOR DRIVER
>  M:	Guenter Roeck <linux@roeck-us.net>
>  L:	linux-hwmon@vger.kernel.org
>  S:	Maintained
> -F:	Documentation/hwmon/lm95234
> +F:	Documentation/hwmon/lm95234.rst
>  F:	drivers/hwmon/lm95234.c
>  
>  LME2510 MEDIA DRIVER
> @@ -9214,7 +9214,7 @@ LTC4261 HARDWARE MONITOR DRIVER
>  M:	Guenter Roeck <linux@roeck-us.net>
>  L:	linux-hwmon@vger.kernel.org
>  S:	Maintained
> -F:	Documentation/hwmon/ltc4261
> +F:	Documentation/hwmon/ltc4261.rst
>  F:	drivers/hwmon/ltc4261.c
>  
>  LTC4306 I2C MULTIPLEXER DRIVER
> @@ -9445,7 +9445,7 @@ MAX16065 HARDWARE MONITOR DRIVER
>  M:	Guenter Roeck <linux@roeck-us.net>
>  L:	linux-hwmon@vger.kernel.org
>  S:	Maintained
> -F:	Documentation/hwmon/max16065
> +F:	Documentation/hwmon/max16065.rst
>  F:	drivers/hwmon/max16065.c
>  
>  MAX2175 SDR TUNER DRIVER
> @@ -9461,14 +9461,14 @@ F:	include/uapi/linux/max2175.h
>  MAX6650 HARDWARE MONITOR AND FAN CONTROLLER DRIVER
>  L:	linux-hwmon@vger.kernel.org
>  S:	Orphan
> -F:	Documentation/hwmon/max6650
> +F:	Documentation/hwmon/max6650.rst
>  F:	drivers/hwmon/max6650.c
>  
>  MAX6697 HARDWARE MONITOR DRIVER
>  M:	Guenter Roeck <linux@roeck-us.net>
>  L:	linux-hwmon@vger.kernel.org
>  S:	Maintained
> -F:	Documentation/hwmon/max6697
> +F:	Documentation/hwmon/max6697.rst
>  F:	Documentation/devicetree/bindings/hwmon/max6697.txt
>  F:	drivers/hwmon/max6697.c
>  F:	include/linux/platform_data/max6697.h
> @@ -10118,7 +10118,7 @@ F:	drivers/mfd/menf21bmc.c
>  F:	drivers/watchdog/menf21bmc_wdt.c
>  F:	drivers/leds/leds-menf21bmc.c
>  F:	drivers/hwmon/menf21bmc_hwmon.c
> -F:	Documentation/hwmon/menf21bmc
> +F:	Documentation/hwmon/menf21bmc.rst
>  
>  MEN Z069 WATCHDOG DRIVER
>  M:	Johannes Thumshirn <jth@kernel.org>
> @@ -10747,7 +10747,7 @@ NCT6775 HARDWARE MONITOR DRIVER
>  M:	Guenter Roeck <linux@roeck-us.net>
>  L:	linux-hwmon@vger.kernel.org
>  S:	Maintained
> -F:	Documentation/hwmon/nct6775
> +F:	Documentation/hwmon/nct6775.rst
>  F:	drivers/hwmon/nct6775.c
>  
>  NET_FAILOVER MODULE
> @@ -11841,7 +11841,7 @@ PC87360 HARDWARE MONITORING DRIVER
>  M:	Jim Cromie <jim.cromie@gmail.com>
>  L:	linux-hwmon@vger.kernel.org
>  S:	Maintained
> -F:	Documentation/hwmon/pc87360
> +F:	Documentation/hwmon/pc87360.rst
>  F:	drivers/hwmon/pc87360.c
>  
>  PC8736x GPIO DRIVER
> @@ -11853,7 +11853,7 @@ PC87427 HARDWARE MONITORING DRIVER
>  M:	Jean Delvare <jdelvare@suse.com>
>  L:	linux-hwmon@vger.kernel.org
>  S:	Maintained
> -F:	Documentation/hwmon/pc87427
> +F:	Documentation/hwmon/pc87427.rst
>  F:	drivers/hwmon/pc87427.c
>  
>  PCA9532 LED DRIVER
> @@ -12421,23 +12421,23 @@ S:	Maintained
>  F:	Documentation/devicetree/bindings/hwmon/ibm,cffps1.txt
>  F:	Documentation/devicetree/bindings/hwmon/max31785.txt
>  F:	Documentation/devicetree/bindings/hwmon/ltc2978.txt
> -F:	Documentation/hwmon/adm1275
> -F:	Documentation/hwmon/ibm-cffps
> -F:	Documentation/hwmon/ir35221
> -F:	Documentation/hwmon/lm25066
> -F:	Documentation/hwmon/ltc2978
> -F:	Documentation/hwmon/ltc3815
> -F:	Documentation/hwmon/max16064
> -F:	Documentation/hwmon/max20751
> -F:	Documentation/hwmon/max31785
> -F:	Documentation/hwmon/max34440
> -F:	Documentation/hwmon/max8688
> -F:	Documentation/hwmon/pmbus
> -F:	Documentation/hwmon/pmbus-core
> -F:	Documentation/hwmon/tps40422
> -F:	Documentation/hwmon/ucd9000
> -F:	Documentation/hwmon/ucd9200
> -F:	Documentation/hwmon/zl6100
> +F:	Documentation/hwmon/adm1275.rst
> +F:	Documentation/hwmon/ibm-cffps.rst
> +F:	Documentation/hwmon/ir35221.rst
> +F:	Documentation/hwmon/lm25066.rst
> +F:	Documentation/hwmon/ltc2978.rst
> +F:	Documentation/hwmon/ltc3815.rst
> +F:	Documentation/hwmon/max16064.rst
> +F:	Documentation/hwmon/max20751.rst
> +F:	Documentation/hwmon/max31785.rst
> +F:	Documentation/hwmon/max34440.rst
> +F:	Documentation/hwmon/max8688.rst
> +F:	Documentation/hwmon/pmbus.rst
> +F:	Documentation/hwmon/pmbus-core.rst
> +F:	Documentation/hwmon/tps40422.rst
> +F:	Documentation/hwmon/ucd9000.rst
> +F:	Documentation/hwmon/ucd9200.rst
> +F:	Documentation/hwmon/zl6100.rst
>  F:	drivers/hwmon/pmbus/
>  F:	include/linux/pmbus.h
>  
> @@ -12701,7 +12701,7 @@ M:	Bartlomiej Zolnierkiewicz <b.zolnierkie@samsung.com>
>  L:	linux-hwmon@vger.kernel.org
>  S:	Supported
>  F:	Documentation/devicetree/bindings/hwmon/pwm-fan.txt
> -F:	Documentation/hwmon/pwm-fan
> +F:	Documentation/hwmon/pwm-fan.rst
>  F:	drivers/hwmon/pwm-fan.c
>  
>  PWM IR Transmitter
> @@ -14366,21 +14366,21 @@ SMM665 HARDWARE MONITOR DRIVER
>  M:	Guenter Roeck <linux@roeck-us.net>
>  L:	linux-hwmon@vger.kernel.org
>  S:	Maintained
> -F:	Documentation/hwmon/smm665
> +F:	Documentation/hwmon/smm665.rst
>  F:	drivers/hwmon/smm665.c
>  
>  SMSC EMC2103 HARDWARE MONITOR DRIVER
>  M:	Steve Glendinning <steve.glendinning@shawell.net>
>  L:	linux-hwmon@vger.kernel.org
>  S:	Maintained
> -F:	Documentation/hwmon/emc2103
> +F:	Documentation/hwmon/emc2103.rst
>  F:	drivers/hwmon/emc2103.c
>  
>  SMSC SCH5627 HARDWARE MONITOR DRIVER
>  M:	Hans de Goede <hdegoede@redhat.com>
>  L:	linux-hwmon@vger.kernel.org
>  S:	Supported
> -F:	Documentation/hwmon/sch5627
> +F:	Documentation/hwmon/sch5627.rst
>  F:	drivers/hwmon/sch5627.c
>  
>  SMSC UFX6000 and UFX7000 USB to VGA DRIVER
> @@ -14393,7 +14393,7 @@ SMSC47B397 HARDWARE MONITOR DRIVER
>  M:	Jean Delvare <jdelvare@suse.com>
>  L:	linux-hwmon@vger.kernel.org
>  S:	Maintained
> -F:	Documentation/hwmon/smsc47b397
> +F:	Documentation/hwmon/smsc47b397.rst
>  F:	drivers/hwmon/smsc47b397.c
>  
>  SMSC911x ETHERNET DRIVER
> @@ -15744,7 +15744,7 @@ TMP401 HARDWARE MONITOR DRIVER
>  M:	Guenter Roeck <linux@roeck-us.net>
>  L:	linux-hwmon@vger.kernel.org
>  S:	Maintained
> -F:	Documentation/hwmon/tmp401
> +F:	Documentation/hwmon/tmp401.rst
>  F:	drivers/hwmon/tmp401.c
>  
>  TMPFS (SHMEM FILESYSTEM)
> @@ -16796,7 +16796,7 @@ VT1211 HARDWARE MONITOR DRIVER
>  M:	Juerg Haefliger <juergh@gmail.com>
>  L:	linux-hwmon@vger.kernel.org
>  S:	Maintained
> -F:	Documentation/hwmon/vt1211
> +F:	Documentation/hwmon/vt1211.rst
>  F:	drivers/hwmon/vt1211.c
>  
>  VT8231 HARDWARE MONITOR DRIVER
> @@ -16824,14 +16824,14 @@ W83791D HARDWARE MONITORING DRIVER
>  M:	Marc Hulsman <m.hulsman@tudelft.nl>
>  L:	linux-hwmon@vger.kernel.org
>  S:	Maintained
> -F:	Documentation/hwmon/w83791d
> +F:	Documentation/hwmon/w83791d.rst
>  F:	drivers/hwmon/w83791d.c
>  
>  W83793 HARDWARE MONITORING DRIVER
>  M:	Rudolf Marek <r.marek@assembler.cz>
>  L:	linux-hwmon@vger.kernel.org
>  S:	Maintained
> -F:	Documentation/hwmon/w83793
> +F:	Documentation/hwmon/w83793.rst
>  F:	drivers/hwmon/w83793.c
>  
>  W83795 HARDWARE MONITORING DRIVER
> @@ -16940,7 +16940,7 @@ L:	patches@opensource.cirrus.com
>  T:	git https://github.com/CirrusLogic/linux-drivers.git
>  W:	https://github.com/CirrusLogic/linux-drivers/wiki
>  S:	Supported
> -F:	Documentation/hwmon/wm83??
> +F:	Documentation/hwmon/wm83??.rst
>  F:	Documentation/devicetree/bindings/extcon/extcon-arizona.txt
>  F:	Documentation/devicetree/bindings/regulator/arizona-regulator.txt
>  F:	Documentation/devicetree/bindings/mfd/arizona.txt
> diff --git a/drivers/hwmon/Kconfig b/drivers/hwmon/Kconfig
> index dedd5febd3aa..470ba66b18b0 100644
> --- a/drivers/hwmon/Kconfig
> +++ b/drivers/hwmon/Kconfig
> @@ -17,7 +17,7 @@ menuconfig HWMON
>  
>  	  To find out which specific driver(s) you need, use the
>  	  sensors-detect script from the lm_sensors package.  Read
> -	  <file:Documentation/hwmon/userspace-tools> for details.
> +	  <file:Documentation/hwmon/userspace-tools.rst> for details.
>  
>  	  This support can also be built as a module. If so, the module
>  	  will be called hwmon.
> @@ -59,7 +59,7 @@ config SENSORS_ABITUGURU
>  	  chip can be found on Abit uGuru featuring motherboards (most modern
>  	  Abit motherboards from before end 2005). For more info and a list
>  	  of which motherboards have which revision see
> -	  Documentation/hwmon/abituguru
> +	  Documentation/hwmon/abituguru.rst
>  
>  	  This driver can also be built as a module. If so, the module
>  	  will be called abituguru.
> @@ -73,7 +73,7 @@ config SENSORS_ABITUGURU3
>  	  and their settings is supported. The third revision of the Abit
>  	  uGuru chip can be found on recent Abit motherboards (since end
>  	  2005). For more info and a list of which motherboards have which
> -	  revision see Documentation/hwmon/abituguru3
> +	  revision see Documentation/hwmon/abituguru3.rst
>  
>  	  This driver can also be built as a module. If so, the module
>  	  will be called abituguru3.
> @@ -643,7 +643,7 @@ config SENSORS_CORETEMP
>  	help
>  	  If you say yes here you get support for the temperature
>  	  sensor inside your CPU. Most of the family 6 CPUs
> -	  are supported. Check Documentation/hwmon/coretemp for details.
> +	  are supported. Check Documentation/hwmon/coretemp.rst for details.
>  
>  config SENSORS_IT87
>  	tristate "ITE IT87xx and compatibles"
> diff --git a/drivers/hwmon/ads7828.c b/drivers/hwmon/ads7828.c
> index e6be617e3fb2..03d6e782777a 100644
> --- a/drivers/hwmon/ads7828.c
> +++ b/drivers/hwmon/ads7828.c
> @@ -8,7 +8,7 @@
>   *
>   * ADS7830 support, by Guillaume Roguez <guillaume.roguez@savoirfairelinux.com>
>   *
> - * For further information, see the Documentation/hwmon/ads7828 file.
> + * For further information, see the Documentation/hwmon/ads7828.rst file.
>   *
>   * This program is free software; you can redistribute it and/or modify
>   * it under the terms of the GNU General Public License as published by
> diff --git a/drivers/hwmon/max197.c b/drivers/hwmon/max197.c
> index 3d9e210beedf..dd6a35219a18 100644
> --- a/drivers/hwmon/max197.c
> +++ b/drivers/hwmon/max197.c
> @@ -8,7 +8,7 @@
>   * it under the terms of the GNU General Public License version 2 as
>   * published by the Free Software Foundation.
>   *
> - * For further information, see the Documentation/hwmon/max197 file.
> + * For further information, see the Documentation/hwmon/max197.rst file.
>   */
>  
>  #include <linux/kernel.h>
> diff --git a/drivers/hwmon/sht15.c b/drivers/hwmon/sht15.c
> index 39b41e35c2bf..7f4a63959730 100644
> --- a/drivers/hwmon/sht15.c
> +++ b/drivers/hwmon/sht15.c
> @@ -10,7 +10,7 @@
>   *
>   * Copyright (c) 2007 Wouter Horre
>   *
> - * For further information, see the Documentation/hwmon/sht15 file.
> + * For further information, see the Documentation/hwmon/sht15.rst file.
>   */
>  
>  #include <linux/interrupt.h>
> diff --git a/include/linux/platform_data/ads7828.h b/include/linux/platform_data/ads7828.h
> index 3245f45f9d77..a3370a007702 100644
> --- a/include/linux/platform_data/ads7828.h
> +++ b/include/linux/platform_data/ads7828.h
> @@ -4,7 +4,7 @@
>   * Copyright (c) 2012 Savoir-faire Linux Inc.
>   *          Vivien Didelot <vivien.didelot@savoirfairelinux.com>
>   *
> - * For further information, see the Documentation/hwmon/ads7828 file.
> + * For further information, see the Documentation/hwmon/ads7828.rst file.
>   *
>   * This program is free software; you can redistribute it and/or modify
>   * it under the terms of the GNU General Public License version 2 as
> diff --git a/include/linux/platform_data/ds620.h b/include/linux/platform_data/ds620.h
> index 6ef58bb77e46..f0ce22a78bb8 100644
> --- a/include/linux/platform_data/ds620.h
> +++ b/include/linux/platform_data/ds620.h
> @@ -14,7 +14,7 @@ struct ds620_platform_data {
>  	 *  1 = PO_LOW
>  	 *  2 = PO_HIGH
>  	 *
> -	 * (see Documentation/hwmon/ds620)
> +	 * (see Documentation/hwmon/ds620.rst)
>  	 */
>  	int pomode;
>  };
> diff --git a/include/linux/platform_data/ina2xx.h b/include/linux/platform_data/ina2xx.h
> index 9f0aa1b48c78..dde59fd3590f 100644
> --- a/include/linux/platform_data/ina2xx.h
> +++ b/include/linux/platform_data/ina2xx.h
> @@ -7,7 +7,7 @@
>   * it under the terms of the GNU General Public License version 2 as
>   * published by the Free Software Foundation.
>   *
> - * For further information, see the Documentation/hwmon/ina2xx file.
> + * For further information, see the Documentation/hwmon/ina2xx.rst file.
>   */
>  
>  /**
> diff --git a/include/linux/platform_data/max197.h b/include/linux/platform_data/max197.h
> index 8da8f94ee15c..2bbd0919bc89 100644
> --- a/include/linux/platform_data/max197.h
> +++ b/include/linux/platform_data/max197.h
> @@ -8,7 +8,7 @@
>   * it under the terms of the GNU General Public License version 2 as
>   * published by the Free Software Foundation.
>   *
> - * For further information, see the Documentation/hwmon/max197 file.
> + * For further information, see the Documentation/hwmon/max197.rst file.
>   */
>  
>  #ifndef _PDATA_MAX197_H
> diff --git a/include/linux/platform_data/ntc_thermistor.h b/include/linux/platform_data/ntc_thermistor.h
> index ee03d429742b..5fa115d3ea4b 100644
> --- a/include/linux/platform_data/ntc_thermistor.h
> +++ b/include/linux/platform_data/ntc_thermistor.h
> @@ -42,7 +42,7 @@ struct ntc_thermistor_platform_data {
>  	 * read_uV()
>  	 *
>  	 * How to setup pullup_ohm, pulldown_ohm, and connect is
> -	 * described at Documentation/hwmon/ntc_thermistor
> +	 * described at Documentation/hwmon/ntc_thermistor.rst
>  	 *
>  	 * pullup/down_ohm: 0 for infinite / not-connected
>  	 *
> -- 
> 2.20.1
> 
> 
> _______________________________________________
> linux-arm-kernel mailing list
> linux-arm-kernel@lists.infradead.org
> http://lists.infradead.org/mailman/listinfo/linux-arm-kernel

-- 
====================
| I would like to |
| fix the world,  |
| but they're not |
| giving me the   |
 \ source code!  /
  ---------------
    ¯\_(ツ)_/¯

^ permalink raw reply	[flat|nested] 73+ messages in thread

* Re: [PATCH v3 21/21] docs: hwmon: Add an index file and rename docs to *.rst
  2019-04-17  9:46                     ` [PATCH v3 21/21] docs: hwmon: Add an index file and rename docs to *.rst Mauro Carvalho Chehab
  2019-04-17 11:31                       ` Liviu Dudau
@ 2019-04-17 16:47                       ` Guenter Roeck
  2019-04-17 16:54                         ` Guenter Roeck
  2019-04-17 17:13                         ` Mauro Carvalho Chehab
  1 sibling, 2 replies; 73+ messages in thread
From: Guenter Roeck @ 2019-04-17 16:47 UTC (permalink / raw)
  To: Mauro Carvalho Chehab
  Cc: Linux Doc Mailing List, Mauro Carvalho Chehab, linux-kernel,
	Jonathan Corbet, Jean Delvare, Rob Herring, Mark Rutland,
	Dirk Eibach, George Joseph, Joel Stanley, Andrew Jeffery,
	Fenghua Yu, Support Opensource, Juerg Haefliger,
	Steve Glendinning, Huang Rui, Benjamin Herrenschmidt,
	Paul Mackerras, Michael Ellerman, Clemens Ladisch, Rudolf Marek,
	Andreas Werner, Jim Cromie, Kamil Debski,
	Bartlomiej Zolnierkiewicz, Hans de Goede, Liviu Dudau,
	Sudeep Holla, Lorenzo Pieralisi, Marc Hulsman, linux-hwmon,
	devicetree, linux-arm-kernel, linux-aspeed, linuxppc-dev,
	patches

On Wed, Apr 17, 2019 at 06:46:29AM -0300, Mauro Carvalho Chehab wrote:
> Now that all files were converted to ReST format, rename them
> and add an index.
> 
> Signed-off-by: Mauro Carvalho Chehab <mchehab+samsung@kernel.org>
> Acked-by: Liviu Dudau <liviu.dudau@arm.com>

I applied all patches except this one, which fails due to a conflict in
ab8500. I also notice that this file has not been touched by your series,
which is odd. At the same time, patch 20/21 is missing from your series,
and has been missing all along. Does the missing patch possibly touch
Documentation/hwmon/ab8500 ?

Thanks,
Guenter

> ---
>  .../devicetree/bindings/hwmon/g762.txt        |   2 +-
>  Documentation/hwmon/{ab8500 => ab8500.rst}    |   2 +-
>  ...guru-datasheet => abituguru-datasheet.rst} |   0
>  .../hwmon/{abituguru => abituguru.rst}        |   0
>  .../hwmon/{abituguru3 => abituguru3.rst}      |   0
>  Documentation/hwmon/{abx500 => abx500.rst}    |   0
>  ...{acpi_power_meter => acpi_power_meter.rst} |   2 +-
>  Documentation/hwmon/{ad7314 => ad7314.rst}    |   0
>  .../hwmon/{adc128d818 => adc128d818.rst}      |   0
>  Documentation/hwmon/{adm1021 => adm1021.rst}  |   0
>  Documentation/hwmon/{adm1025 => adm1025.rst}  |   0
>  Documentation/hwmon/{adm1026 => adm1026.rst}  |   0
>  Documentation/hwmon/{adm1031 => adm1031.rst}  |   0
>  Documentation/hwmon/{adm1275 => adm1275.rst}  |   4 +-
>  Documentation/hwmon/{adm9240 => adm9240.rst}  |   0
>  Documentation/hwmon/{ads1015 => ads1015.rst}  |   0
>  Documentation/hwmon/{ads7828 => ads7828.rst}  |   0
>  Documentation/hwmon/{adt7410 => adt7410.rst}  |   0
>  Documentation/hwmon/{adt7411 => adt7411.rst}  |   0
>  Documentation/hwmon/{adt7462 => adt7462.rst}  |   1 -
>  Documentation/hwmon/{adt7470 => adt7470.rst}  |   0
>  Documentation/hwmon/{adt7475 => adt7475.rst}  |   0
>  Documentation/hwmon/{amc6821 => amc6821.rst}  |   1 -
>  Documentation/hwmon/{asb100 => asb100.rst}    |   1 -
>  Documentation/hwmon/{asc7621 => asc7621.rst}  |   0
>  ...{aspeed-pwm-tacho => aspeed-pwm-tacho.rst} |   0
>  .../hwmon/{coretemp => coretemp.rst}          |   0
>  Documentation/hwmon/{da9052 => da9052.rst}    |   0
>  Documentation/hwmon/{da9055 => da9055.rst}    |   0
>  Documentation/hwmon/{dme1737 => dme1737.rst}  |   0
>  Documentation/hwmon/{ds1621 => ds1621.rst}    |   0
>  Documentation/hwmon/{ds620 => ds620.rst}      |   0
>  Documentation/hwmon/{emc1403 => emc1403.rst}  |   0
>  Documentation/hwmon/{emc2103 => emc2103.rst}  |   0
>  .../hwmon/{emc6w201 => emc6w201.rst}          |   0
>  Documentation/hwmon/{f71805f => f71805f.rst}  |   0
>  .../hwmon/{f71882fg => f71882fg.rst}          |   0
>  .../hwmon/{fam15h_power => fam15h_power.rst}  |   0
>  .../hwmon/{ftsteutates => ftsteutates.rst}    |   0
>  Documentation/hwmon/{g760a => g760a.rst}      |   0
>  Documentation/hwmon/{g762 => g762.rst}        |   2 +-
>  Documentation/hwmon/{gl518sm => gl518sm.rst}  |   0
>  Documentation/hwmon/{hih6130 => hih6130.rst}  |   0
>  ...on-kernel-api.txt => hwmon-kernel-api.rst} |   4 +-
>  .../hwmon/{ibm-cffps => ibm-cffps.rst}        |   0
>  Documentation/hwmon/{ibmaem => ibmaem.rst}    |   0
>  .../hwmon/{ibmpowernv => ibmpowernv.rst}      |   0
>  Documentation/hwmon/{ina209 => ina209.rst}    |   0
>  Documentation/hwmon/{ina2xx => ina2xx.rst}    |   2 +-
>  Documentation/hwmon/{ina3221 => ina3221.rst}  |   0
>  Documentation/hwmon/index.rst                 | 179 ++++++++++++++++++
>  Documentation/hwmon/{ir35221 => ir35221.rst}  |   0
>  Documentation/hwmon/{it87 => it87.rst}        |   0
>  Documentation/hwmon/{jc42 => jc42.rst}        |   0
>  Documentation/hwmon/{k10temp => k10temp.rst}  |   0
>  Documentation/hwmon/{k8temp => k8temp.rst}    |   0
>  .../hwmon/{lineage-pem => lineage-pem.rst}    |   0
>  Documentation/hwmon/{lm25066 => lm25066.rst}  |   2 +-
>  Documentation/hwmon/{lm63 => lm63.rst}        |   0
>  Documentation/hwmon/{lm70 => lm70.rst}        |   0
>  Documentation/hwmon/{lm73 => lm73.rst}        |   0
>  Documentation/hwmon/{lm75 => lm75.rst}        |   0
>  Documentation/hwmon/{lm77 => lm77.rst}        |   0
>  Documentation/hwmon/{lm78 => lm78.rst}        |   0
>  Documentation/hwmon/{lm80 => lm80.rst}        |   0
>  Documentation/hwmon/{lm83 => lm83.rst}        |   0
>  Documentation/hwmon/{lm85 => lm85.rst}        |   0
>  Documentation/hwmon/{lm87 => lm87.rst}        |   0
>  Documentation/hwmon/{lm90 => lm90.rst}        |   0
>  Documentation/hwmon/{lm92 => lm92.rst}        |   0
>  Documentation/hwmon/{lm93 => lm93.rst}        |   0
>  Documentation/hwmon/{lm95234 => lm95234.rst}  |   0
>  Documentation/hwmon/{lm95245 => lm95245.rst}  |   0
>  Documentation/hwmon/{ltc2945 => ltc2945.rst}  |   0
>  Documentation/hwmon/{ltc2978 => ltc2978.rst}  |   0
>  Documentation/hwmon/{ltc2990 => ltc2990.rst}  |   0
>  Documentation/hwmon/{ltc3815 => ltc3815.rst}  |   0
>  Documentation/hwmon/{ltc4151 => ltc4151.rst}  |   0
>  Documentation/hwmon/{ltc4215 => ltc4215.rst}  |   0
>  Documentation/hwmon/{ltc4245 => ltc4245.rst}  |   0
>  Documentation/hwmon/{ltc4260 => ltc4260.rst}  |   0
>  Documentation/hwmon/{ltc4261 => ltc4261.rst}  |   0
>  .../hwmon/{max16064 => max16064.rst}          |   2 +-
>  .../hwmon/{max16065 => max16065.rst}          |   0
>  Documentation/hwmon/{max1619 => max1619.rst}  |   1 -
>  Documentation/hwmon/{max1668 => max1668.rst}  |   0
>  Documentation/hwmon/{max197 => max197.rst}    |   0
>  .../hwmon/{max20751 => max20751.rst}          |   2 +-
>  .../hwmon/{max31722 => max31722.rst}          |   0
>  .../hwmon/{max31785 => max31785.rst}          |   0
>  .../hwmon/{max31790 => max31790.rst}          |   0
>  .../hwmon/{max34440 => max34440.rst}          |   2 +-
>  Documentation/hwmon/{max6639 => max6639.rst}  |   0
>  Documentation/hwmon/{max6642 => max6642.rst}  |   0
>  Documentation/hwmon/{max6650 => max6650.rst}  |   1 -
>  Documentation/hwmon/{max6697 => max6697.rst}  |   0
>  Documentation/hwmon/{max8688 => max8688.rst}  |   2 +-
>  .../hwmon/{mc13783-adc => mc13783-adc.rst}    |   0
>  Documentation/hwmon/{mcp3021 => mcp3021.rst}  |   0
>  .../hwmon/{menf21bmc => menf21bmc.rst}        |   0
>  .../hwmon/{mlxreg-fan => mlxreg-fan.rst}      |   0
>  Documentation/hwmon/{nct6683 => nct6683.rst}  |   0
>  Documentation/hwmon/{nct6775 => nct6775.rst}  |   0
>  Documentation/hwmon/{nct7802 => nct7802.rst}  |   0
>  Documentation/hwmon/{nct7904 => nct7904.rst}  |   0
>  .../{npcm750-pwm-fan => npcm750-pwm-fan.rst}  |   0
>  Documentation/hwmon/{nsa320 => nsa320.rst}    |   0
>  .../{ntc_thermistor => ntc_thermistor.rst}    |   0
>  Documentation/hwmon/{occ => occ.rst}          |   0
>  Documentation/hwmon/{pc87360 => pc87360.rst}  |   0
>  Documentation/hwmon/{pc87427 => pc87427.rst}  |   0
>  Documentation/hwmon/{pcf8591 => pcf8591.rst}  |   0
>  .../hwmon/{pmbus-core => pmbus-core.rst}      |   0
>  Documentation/hwmon/{pmbus => pmbus.rst}      |   0
>  .../hwmon/{powr1220 => powr1220.rst}          |   0
>  Documentation/hwmon/{pwm-fan => pwm-fan.rst}  |   0
>  ...aspberrypi-hwmon => raspberrypi-hwmon.rst} |   0
>  Documentation/hwmon/{sch5627 => sch5627.rst}  |   0
>  Documentation/hwmon/{sch5636 => sch5636.rst}  |   0
>  .../hwmon/{scpi-hwmon => scpi-hwmon.rst}      |   0
>  Documentation/hwmon/{sht15 => sht15.rst}      |   0
>  Documentation/hwmon/{sht21 => sht21.rst}      |   0
>  Documentation/hwmon/{sht3x => sht3x.rst}      |   0
>  Documentation/hwmon/{shtc1 => shtc1.rst}      |   0
>  Documentation/hwmon/{sis5595 => sis5595.rst}  |   1 -
>  Documentation/hwmon/{smm665 => smm665.rst}    |   0
>  .../hwmon/{smsc47b397 => smsc47b397.rst}      |   0
>  .../hwmon/{smsc47m1 => smsc47m1.rst}          |   0
>  .../hwmon/{smsc47m192 => smsc47m192.rst}      |   0
>  ...mitting-patches => submitting-patches.rst} |   6 +-
>  .../{sysfs-interface => sysfs-interface.rst}  |   0
>  Documentation/hwmon/{tc654 => tc654.rst}      |   0
>  Documentation/hwmon/{tc74 => tc74.rst}        |   0
>  Documentation/hwmon/{thmc50 => thmc50.rst}    |   1 -
>  Documentation/hwmon/{tmp102 => tmp102.rst}    |   2 +-
>  Documentation/hwmon/{tmp103 => tmp103.rst}    |   2 +-
>  Documentation/hwmon/{tmp108 => tmp108.rst}    |   2 +-
>  Documentation/hwmon/{tmp401 => tmp401.rst}    |   2 +-
>  Documentation/hwmon/{tmp421 => tmp421.rst}    |   0
>  .../hwmon/{tps40422 => tps40422.rst}          |   2 +-
>  ...4030-madc-hwmon => twl4030-madc-hwmon.rst} |   0
>  Documentation/hwmon/{ucd9000 => ucd9000.rst}  |   4 +-
>  Documentation/hwmon/{ucd9200 => ucd9200.rst}  |   4 +-
>  .../{userspace-tools => userspace-tools.rst}  |   0
>  .../hwmon/{vexpress => vexpress.rst}          |   0
>  Documentation/hwmon/{via686a => via686a.rst}  |   0
>  Documentation/hwmon/{vt1211 => vt1211.rst}    |   0
>  .../hwmon/{w83627ehf => w83627ehf.rst}        |   0
>  .../hwmon/{w83627hf => w83627hf.rst}          |   0
>  Documentation/hwmon/{w83773g => w83773g.rst}  |   0
>  Documentation/hwmon/{w83781d => w83781d.rst}  |   0
>  Documentation/hwmon/{w83791d => w83791d.rst}  |   2 +-
>  Documentation/hwmon/{w83792d => w83792d.rst}  |   0
>  Documentation/hwmon/{w83793 => w83793.rst}    |   0
>  Documentation/hwmon/{w83795 => w83795.rst}    |   0
>  .../hwmon/{w83l785ts => w83l785ts.rst}        |   0
>  .../hwmon/{w83l786ng => w83l786ng.rst}        |   0
>  Documentation/hwmon/{wm831x => wm831x.rst}    |   0
>  Documentation/hwmon/{wm8350 => wm8350.rst}    |   0
>  .../hwmon/{xgene-hwmon => xgene-hwmon.rst}    |   0
>  Documentation/hwmon/{zl6100 => zl6100.rst}    |   2 +-
>  Documentation/index.rst                       |   1 +
>  Documentation/thermal/sysfs-api.txt           |   2 +-
>  MAINTAINERS                                   | 108 +++++------
>  drivers/hwmon/Kconfig                         |   8 +-
>  drivers/hwmon/ads7828.c                       |   2 +-
>  drivers/hwmon/max197.c                        |   2 +-
>  drivers/hwmon/sht15.c                         |   2 +-
>  include/linux/platform_data/ads7828.h         |   2 +-
>  include/linux/platform_data/ds620.h           |   2 +-
>  include/linux/platform_data/ina2xx.h          |   2 +-
>  include/linux/platform_data/max197.h          |   2 +-
>  include/linux/platform_data/ntc_thermistor.h  |   2 +-
>  173 files changed, 275 insertions(+), 102 deletions(-)
>  rename Documentation/hwmon/{ab8500 => ab8500.rst} (86%)
>  rename Documentation/hwmon/{abituguru-datasheet => abituguru-datasheet.rst} (100%)
>  rename Documentation/hwmon/{abituguru => abituguru.rst} (100%)
>  rename Documentation/hwmon/{abituguru3 => abituguru3.rst} (100%)
>  rename Documentation/hwmon/{abx500 => abx500.rst} (100%)
>  rename Documentation/hwmon/{acpi_power_meter => acpi_power_meter.rst} (97%)
>  rename Documentation/hwmon/{ad7314 => ad7314.rst} (100%)
>  rename Documentation/hwmon/{adc128d818 => adc128d818.rst} (100%)
>  rename Documentation/hwmon/{adm1021 => adm1021.rst} (100%)
>  rename Documentation/hwmon/{adm1025 => adm1025.rst} (100%)
>  rename Documentation/hwmon/{adm1026 => adm1026.rst} (100%)
>  rename Documentation/hwmon/{adm1031 => adm1031.rst} (100%)
>  rename Documentation/hwmon/{adm1275 => adm1275.rst} (97%)
>  rename Documentation/hwmon/{adm9240 => adm9240.rst} (100%)
>  rename Documentation/hwmon/{ads1015 => ads1015.rst} (100%)
>  rename Documentation/hwmon/{ads7828 => ads7828.rst} (100%)
>  rename Documentation/hwmon/{adt7410 => adt7410.rst} (100%)
>  rename Documentation/hwmon/{adt7411 => adt7411.rst} (100%)
>  rename Documentation/hwmon/{adt7462 => adt7462.rst} (99%)
>  rename Documentation/hwmon/{adt7470 => adt7470.rst} (100%)
>  rename Documentation/hwmon/{adt7475 => adt7475.rst} (100%)
>  rename Documentation/hwmon/{amc6821 => amc6821.rst} (99%)
>  rename Documentation/hwmon/{asb100 => asb100.rst} (99%)
>  rename Documentation/hwmon/{asc7621 => asc7621.rst} (100%)
>  rename Documentation/hwmon/{aspeed-pwm-tacho => aspeed-pwm-tacho.rst} (100%)
>  rename Documentation/hwmon/{coretemp => coretemp.rst} (100%)
>  rename Documentation/hwmon/{da9052 => da9052.rst} (100%)
>  rename Documentation/hwmon/{da9055 => da9055.rst} (100%)
>  rename Documentation/hwmon/{dme1737 => dme1737.rst} (100%)
>  rename Documentation/hwmon/{ds1621 => ds1621.rst} (100%)
>  rename Documentation/hwmon/{ds620 => ds620.rst} (100%)
>  rename Documentation/hwmon/{emc1403 => emc1403.rst} (100%)
>  rename Documentation/hwmon/{emc2103 => emc2103.rst} (100%)
>  rename Documentation/hwmon/{emc6w201 => emc6w201.rst} (100%)
>  rename Documentation/hwmon/{f71805f => f71805f.rst} (100%)
>  rename Documentation/hwmon/{f71882fg => f71882fg.rst} (100%)
>  rename Documentation/hwmon/{fam15h_power => fam15h_power.rst} (100%)
>  rename Documentation/hwmon/{ftsteutates => ftsteutates.rst} (100%)
>  rename Documentation/hwmon/{g760a => g760a.rst} (100%)
>  rename Documentation/hwmon/{g762 => g762.rst} (97%)
>  rename Documentation/hwmon/{gl518sm => gl518sm.rst} (100%)
>  rename Documentation/hwmon/{hih6130 => hih6130.rst} (100%)
>  rename Documentation/hwmon/{hwmon-kernel-api.txt => hwmon-kernel-api.rst} (99%)
>  rename Documentation/hwmon/{ibm-cffps => ibm-cffps.rst} (100%)
>  rename Documentation/hwmon/{ibmaem => ibmaem.rst} (100%)
>  rename Documentation/hwmon/{ibmpowernv => ibmpowernv.rst} (100%)
>  rename Documentation/hwmon/{ina209 => ina209.rst} (100%)
>  rename Documentation/hwmon/{ina2xx => ina2xx.rst} (97%)
>  rename Documentation/hwmon/{ina3221 => ina3221.rst} (100%)
>  create mode 100644 Documentation/hwmon/index.rst
>  rename Documentation/hwmon/{ir35221 => ir35221.rst} (100%)
>  rename Documentation/hwmon/{it87 => it87.rst} (100%)
>  rename Documentation/hwmon/{jc42 => jc42.rst} (100%)
>  rename Documentation/hwmon/{k10temp => k10temp.rst} (100%)
>  rename Documentation/hwmon/{k8temp => k8temp.rst} (100%)
>  rename Documentation/hwmon/{lineage-pem => lineage-pem.rst} (100%)
>  rename Documentation/hwmon/{lm25066 => lm25066.rst} (97%)
>  rename Documentation/hwmon/{lm63 => lm63.rst} (100%)
>  rename Documentation/hwmon/{lm70 => lm70.rst} (100%)
>  rename Documentation/hwmon/{lm73 => lm73.rst} (100%)
>  rename Documentation/hwmon/{lm75 => lm75.rst} (100%)
>  rename Documentation/hwmon/{lm77 => lm77.rst} (100%)
>  rename Documentation/hwmon/{lm78 => lm78.rst} (100%)
>  rename Documentation/hwmon/{lm80 => lm80.rst} (100%)
>  rename Documentation/hwmon/{lm83 => lm83.rst} (100%)
>  rename Documentation/hwmon/{lm85 => lm85.rst} (100%)
>  rename Documentation/hwmon/{lm87 => lm87.rst} (100%)
>  rename Documentation/hwmon/{lm90 => lm90.rst} (100%)
>  rename Documentation/hwmon/{lm92 => lm92.rst} (100%)
>  rename Documentation/hwmon/{lm93 => lm93.rst} (100%)
>  rename Documentation/hwmon/{lm95234 => lm95234.rst} (100%)
>  rename Documentation/hwmon/{lm95245 => lm95245.rst} (100%)
>  rename Documentation/hwmon/{ltc2945 => ltc2945.rst} (100%)
>  rename Documentation/hwmon/{ltc2978 => ltc2978.rst} (100%)
>  rename Documentation/hwmon/{ltc2990 => ltc2990.rst} (100%)
>  rename Documentation/hwmon/{ltc3815 => ltc3815.rst} (100%)
>  rename Documentation/hwmon/{ltc4151 => ltc4151.rst} (100%)
>  rename Documentation/hwmon/{ltc4215 => ltc4215.rst} (100%)
>  rename Documentation/hwmon/{ltc4245 => ltc4245.rst} (100%)
>  rename Documentation/hwmon/{ltc4260 => ltc4260.rst} (100%)
>  rename Documentation/hwmon/{ltc4261 => ltc4261.rst} (100%)
>  rename Documentation/hwmon/{max16064 => max16064.rst} (96%)
>  rename Documentation/hwmon/{max16065 => max16065.rst} (100%)
>  rename Documentation/hwmon/{max1619 => max1619.rst} (99%)
>  rename Documentation/hwmon/{max1668 => max1668.rst} (100%)
>  rename Documentation/hwmon/{max197 => max197.rst} (100%)
>  rename Documentation/hwmon/{max20751 => max20751.rst} (96%)
>  rename Documentation/hwmon/{max31722 => max31722.rst} (100%)
>  rename Documentation/hwmon/{max31785 => max31785.rst} (100%)
>  rename Documentation/hwmon/{max31790 => max31790.rst} (100%)
>  rename Documentation/hwmon/{max34440 => max34440.rst} (98%)
>  rename Documentation/hwmon/{max6639 => max6639.rst} (100%)
>  rename Documentation/hwmon/{max6642 => max6642.rst} (100%)
>  rename Documentation/hwmon/{max6650 => max6650.rst} (99%)
>  rename Documentation/hwmon/{max6697 => max6697.rst} (100%)
>  rename Documentation/hwmon/{max8688 => max8688.rst} (97%)
>  rename Documentation/hwmon/{mc13783-adc => mc13783-adc.rst} (100%)
>  rename Documentation/hwmon/{mcp3021 => mcp3021.rst} (100%)
>  rename Documentation/hwmon/{menf21bmc => menf21bmc.rst} (100%)
>  rename Documentation/hwmon/{mlxreg-fan => mlxreg-fan.rst} (100%)
>  rename Documentation/hwmon/{nct6683 => nct6683.rst} (100%)
>  rename Documentation/hwmon/{nct6775 => nct6775.rst} (100%)
>  rename Documentation/hwmon/{nct7802 => nct7802.rst} (100%)
>  rename Documentation/hwmon/{nct7904 => nct7904.rst} (100%)
>  rename Documentation/hwmon/{npcm750-pwm-fan => npcm750-pwm-fan.rst} (100%)
>  rename Documentation/hwmon/{nsa320 => nsa320.rst} (100%)
>  rename Documentation/hwmon/{ntc_thermistor => ntc_thermistor.rst} (100%)
>  rename Documentation/hwmon/{occ => occ.rst} (100%)
>  rename Documentation/hwmon/{pc87360 => pc87360.rst} (100%)
>  rename Documentation/hwmon/{pc87427 => pc87427.rst} (100%)
>  rename Documentation/hwmon/{pcf8591 => pcf8591.rst} (100%)
>  rename Documentation/hwmon/{pmbus-core => pmbus-core.rst} (100%)
>  rename Documentation/hwmon/{pmbus => pmbus.rst} (100%)
>  rename Documentation/hwmon/{powr1220 => powr1220.rst} (100%)
>  rename Documentation/hwmon/{pwm-fan => pwm-fan.rst} (100%)
>  rename Documentation/hwmon/{raspberrypi-hwmon => raspberrypi-hwmon.rst} (100%)
>  rename Documentation/hwmon/{sch5627 => sch5627.rst} (100%)
>  rename Documentation/hwmon/{sch5636 => sch5636.rst} (100%)
>  rename Documentation/hwmon/{scpi-hwmon => scpi-hwmon.rst} (100%)
>  rename Documentation/hwmon/{sht15 => sht15.rst} (100%)
>  rename Documentation/hwmon/{sht21 => sht21.rst} (100%)
>  rename Documentation/hwmon/{sht3x => sht3x.rst} (100%)
>  rename Documentation/hwmon/{shtc1 => shtc1.rst} (100%)
>  rename Documentation/hwmon/{sis5595 => sis5595.rst} (99%)
>  rename Documentation/hwmon/{smm665 => smm665.rst} (100%)
>  rename Documentation/hwmon/{smsc47b397 => smsc47b397.rst} (100%)
>  rename Documentation/hwmon/{smsc47m1 => smsc47m1.rst} (100%)
>  rename Documentation/hwmon/{smsc47m192 => smsc47m192.rst} (100%)
>  rename Documentation/hwmon/{submitting-patches => submitting-patches.rst} (98%)
>  rename Documentation/hwmon/{sysfs-interface => sysfs-interface.rst} (100%)
>  rename Documentation/hwmon/{tc654 => tc654.rst} (100%)
>  rename Documentation/hwmon/{tc74 => tc74.rst} (100%)
>  rename Documentation/hwmon/{thmc50 => thmc50.rst} (99%)
>  rename Documentation/hwmon/{tmp102 => tmp102.rst} (93%)
>  rename Documentation/hwmon/{tmp103 => tmp103.rst} (92%)
>  rename Documentation/hwmon/{tmp108 => tmp108.rst} (95%)
>  rename Documentation/hwmon/{tmp401 => tmp401.rst} (97%)
>  rename Documentation/hwmon/{tmp421 => tmp421.rst} (100%)
>  rename Documentation/hwmon/{tps40422 => tps40422.rst} (96%)
>  rename Documentation/hwmon/{twl4030-madc-hwmon => twl4030-madc-hwmon.rst} (100%)
>  rename Documentation/hwmon/{ucd9000 => ucd9000.rst} (97%)
>  rename Documentation/hwmon/{ucd9200 => ucd9200.rst} (97%)
>  rename Documentation/hwmon/{userspace-tools => userspace-tools.rst} (100%)
>  rename Documentation/hwmon/{vexpress => vexpress.rst} (100%)
>  rename Documentation/hwmon/{via686a => via686a.rst} (100%)
>  rename Documentation/hwmon/{vt1211 => vt1211.rst} (100%)
>  rename Documentation/hwmon/{w83627ehf => w83627ehf.rst} (100%)
>  rename Documentation/hwmon/{w83627hf => w83627hf.rst} (100%)
>  rename Documentation/hwmon/{w83773g => w83773g.rst} (100%)
>  rename Documentation/hwmon/{w83781d => w83781d.rst} (100%)
>  rename Documentation/hwmon/{w83791d => w83791d.rst} (99%)
>  rename Documentation/hwmon/{w83792d => w83792d.rst} (100%)
>  rename Documentation/hwmon/{w83793 => w83793.rst} (100%)
>  rename Documentation/hwmon/{w83795 => w83795.rst} (100%)
>  rename Documentation/hwmon/{w83l785ts => w83l785ts.rst} (100%)
>  rename Documentation/hwmon/{w83l786ng => w83l786ng.rst} (100%)
>  rename Documentation/hwmon/{wm831x => wm831x.rst} (100%)
>  rename Documentation/hwmon/{wm8350 => wm8350.rst} (100%)
>  rename Documentation/hwmon/{xgene-hwmon => xgene-hwmon.rst} (100%)
>  rename Documentation/hwmon/{zl6100 => zl6100.rst} (98%)
> 
> diff --git a/Documentation/devicetree/bindings/hwmon/g762.txt b/Documentation/devicetree/bindings/hwmon/g762.txt
> index 25cc6d8ee575..6d154c4923de 100644
> --- a/Documentation/devicetree/bindings/hwmon/g762.txt
> +++ b/Documentation/devicetree/bindings/hwmon/g762.txt
> @@ -21,7 +21,7 @@ If an optional property is not set in .dts file, then current value is kept
>  unmodified (e.g. u-boot installed value).
>  
>  Additional information on operational parameters for the device is available
> -in Documentation/hwmon/g762. A detailed datasheet for the device is available
> +in Documentation/hwmon/g762.rst. A detailed datasheet for the device is available
>  at http://natisbad.org/NAS/refs/GMT_EDS-762_763-080710-0.2.pdf.
>  
>  Example g762 node:
> diff --git a/Documentation/hwmon/ab8500 b/Documentation/hwmon/ab8500.rst
> similarity index 86%
> rename from Documentation/hwmon/ab8500
> rename to Documentation/hwmon/ab8500.rst
> index d87c61151239..33f93a9cec04 100644
> --- a/Documentation/hwmon/ab8500
> +++ b/Documentation/hwmon/ab8500.rst
> @@ -18,7 +18,7 @@ Authors:
>  Description
>  -----------
>  
> -See also Documentation/hwmon/abx500. This is the ST-Ericsson AB8500 specific
> +See also Documentation/hwmon/abx500.rst. This is the ST-Ericsson AB8500 specific
>  driver.
>  
>  Currently only the AB8500 internal sensor and one external sensor for battery
> diff --git a/Documentation/hwmon/abituguru-datasheet b/Documentation/hwmon/abituguru-datasheet.rst
> similarity index 100%
> rename from Documentation/hwmon/abituguru-datasheet
> rename to Documentation/hwmon/abituguru-datasheet.rst
> diff --git a/Documentation/hwmon/abituguru b/Documentation/hwmon/abituguru.rst
> similarity index 100%
> rename from Documentation/hwmon/abituguru
> rename to Documentation/hwmon/abituguru.rst
> diff --git a/Documentation/hwmon/abituguru3 b/Documentation/hwmon/abituguru3.rst
> similarity index 100%
> rename from Documentation/hwmon/abituguru3
> rename to Documentation/hwmon/abituguru3.rst
> diff --git a/Documentation/hwmon/abx500 b/Documentation/hwmon/abx500.rst
> similarity index 100%
> rename from Documentation/hwmon/abx500
> rename to Documentation/hwmon/abx500.rst
> diff --git a/Documentation/hwmon/acpi_power_meter b/Documentation/hwmon/acpi_power_meter.rst
> similarity index 97%
> rename from Documentation/hwmon/acpi_power_meter
> rename to Documentation/hwmon/acpi_power_meter.rst
> index 7665ca6ba957..4a0941ade0ca 100644
> --- a/Documentation/hwmon/acpi_power_meter
> +++ b/Documentation/hwmon/acpi_power_meter.rst
> @@ -21,7 +21,7 @@ the ACPI 4.0 spec (Chapter 10.4).  These devices have a simple set of
>  features--a power meter that returns average power use over a configurable
>  interval, an optional capping mechanism, and a couple of trip points.  The
>  sysfs interface conforms with the specification outlined in the "Power" section
> -of Documentation/hwmon/sysfs-interface.
> +of Documentation/hwmon/sysfs-interface.rst.
>  
>  Special Features
>  ----------------
> diff --git a/Documentation/hwmon/ad7314 b/Documentation/hwmon/ad7314.rst
> similarity index 100%
> rename from Documentation/hwmon/ad7314
> rename to Documentation/hwmon/ad7314.rst
> diff --git a/Documentation/hwmon/adc128d818 b/Documentation/hwmon/adc128d818.rst
> similarity index 100%
> rename from Documentation/hwmon/adc128d818
> rename to Documentation/hwmon/adc128d818.rst
> diff --git a/Documentation/hwmon/adm1021 b/Documentation/hwmon/adm1021.rst
> similarity index 100%
> rename from Documentation/hwmon/adm1021
> rename to Documentation/hwmon/adm1021.rst
> diff --git a/Documentation/hwmon/adm1025 b/Documentation/hwmon/adm1025.rst
> similarity index 100%
> rename from Documentation/hwmon/adm1025
> rename to Documentation/hwmon/adm1025.rst
> diff --git a/Documentation/hwmon/adm1026 b/Documentation/hwmon/adm1026.rst
> similarity index 100%
> rename from Documentation/hwmon/adm1026
> rename to Documentation/hwmon/adm1026.rst
> diff --git a/Documentation/hwmon/adm1031 b/Documentation/hwmon/adm1031.rst
> similarity index 100%
> rename from Documentation/hwmon/adm1031
> rename to Documentation/hwmon/adm1031.rst
> diff --git a/Documentation/hwmon/adm1275 b/Documentation/hwmon/adm1275.rst
> similarity index 97%
> rename from Documentation/hwmon/adm1275
> rename to Documentation/hwmon/adm1275.rst
> index 5c5860011d6e..9a1913e5b4d9 100644
> --- a/Documentation/hwmon/adm1275
> +++ b/Documentation/hwmon/adm1275.rst
> @@ -68,7 +68,7 @@ integrated 12 bit analog-to-digital converter (ADC), accessed using a
>  PMBus interface.
>  
>  The driver is a client driver to the core PMBus driver. Please see
> -Documentation/hwmon/pmbus for details on PMBus client drivers.
> +Documentation/hwmon/pmbus.rst for details on PMBus client drivers.
>  
>  
>  Usage Notes
> @@ -90,7 +90,7 @@ Platform data support
>  ---------------------
>  
>  The driver supports standard PMBus driver platform data. Please see
> -Documentation/hwmon/pmbus for details.
> +Documentation/hwmon/pmbus.rst for details.
>  
>  
>  Sysfs entries
> diff --git a/Documentation/hwmon/adm9240 b/Documentation/hwmon/adm9240.rst
> similarity index 100%
> rename from Documentation/hwmon/adm9240
> rename to Documentation/hwmon/adm9240.rst
> diff --git a/Documentation/hwmon/ads1015 b/Documentation/hwmon/ads1015.rst
> similarity index 100%
> rename from Documentation/hwmon/ads1015
> rename to Documentation/hwmon/ads1015.rst
> diff --git a/Documentation/hwmon/ads7828 b/Documentation/hwmon/ads7828.rst
> similarity index 100%
> rename from Documentation/hwmon/ads7828
> rename to Documentation/hwmon/ads7828.rst
> diff --git a/Documentation/hwmon/adt7410 b/Documentation/hwmon/adt7410.rst
> similarity index 100%
> rename from Documentation/hwmon/adt7410
> rename to Documentation/hwmon/adt7410.rst
> diff --git a/Documentation/hwmon/adt7411 b/Documentation/hwmon/adt7411.rst
> similarity index 100%
> rename from Documentation/hwmon/adt7411
> rename to Documentation/hwmon/adt7411.rst
> diff --git a/Documentation/hwmon/adt7462 b/Documentation/hwmon/adt7462.rst
> similarity index 99%
> rename from Documentation/hwmon/adt7462
> rename to Documentation/hwmon/adt7462.rst
> index a7a831118d32..139e19696188 100644
> --- a/Documentation/hwmon/adt7462
> +++ b/Documentation/hwmon/adt7462.rst
> @@ -68,4 +68,3 @@ The ADT7462 will scale the pwm between the lower and higher pwm speed when
>  the temperature is between the two temperature boundaries.  PWM values range
>  from 0 (off) to 255 (full speed).  Fan speed will be set to maximum when the
>  temperature sensor associated with the PWM control exceeds temp#_max.
> -
> diff --git a/Documentation/hwmon/adt7470 b/Documentation/hwmon/adt7470.rst
> similarity index 100%
> rename from Documentation/hwmon/adt7470
> rename to Documentation/hwmon/adt7470.rst
> diff --git a/Documentation/hwmon/adt7475 b/Documentation/hwmon/adt7475.rst
> similarity index 100%
> rename from Documentation/hwmon/adt7475
> rename to Documentation/hwmon/adt7475.rst
> diff --git a/Documentation/hwmon/amc6821 b/Documentation/hwmon/amc6821.rst
> similarity index 99%
> rename from Documentation/hwmon/amc6821
> rename to Documentation/hwmon/amc6821.rst
> index d10eabcbc0f3..5ddb2849da90 100644
> --- a/Documentation/hwmon/amc6821
> +++ b/Documentation/hwmon/amc6821.rst
> @@ -106,4 +106,3 @@ different settings, you can set the following parameters:
>  
>  - init=1,
>  - pwminv: 0 default pwm output, 1 inverts pwm output.
> -
> diff --git a/Documentation/hwmon/asb100 b/Documentation/hwmon/asb100.rst
> similarity index 99%
> rename from Documentation/hwmon/asb100
> rename to Documentation/hwmon/asb100.rst
> index 311d9f7b6926..c2d5f97085fe 100644
> --- a/Documentation/hwmon/asb100
> +++ b/Documentation/hwmon/asb100.rst
> @@ -71,4 +71,3 @@ TODO:
>    * Experiment with temp. sensor types.
>    * Are there really 13 voltage inputs? Probably not...
>    * Cleanups, no doubt...
> -
> diff --git a/Documentation/hwmon/asc7621 b/Documentation/hwmon/asc7621.rst
> similarity index 100%
> rename from Documentation/hwmon/asc7621
> rename to Documentation/hwmon/asc7621.rst
> diff --git a/Documentation/hwmon/aspeed-pwm-tacho b/Documentation/hwmon/aspeed-pwm-tacho.rst
> similarity index 100%
> rename from Documentation/hwmon/aspeed-pwm-tacho
> rename to Documentation/hwmon/aspeed-pwm-tacho.rst
> diff --git a/Documentation/hwmon/coretemp b/Documentation/hwmon/coretemp.rst
> similarity index 100%
> rename from Documentation/hwmon/coretemp
> rename to Documentation/hwmon/coretemp.rst
> diff --git a/Documentation/hwmon/da9052 b/Documentation/hwmon/da9052.rst
> similarity index 100%
> rename from Documentation/hwmon/da9052
> rename to Documentation/hwmon/da9052.rst
> diff --git a/Documentation/hwmon/da9055 b/Documentation/hwmon/da9055.rst
> similarity index 100%
> rename from Documentation/hwmon/da9055
> rename to Documentation/hwmon/da9055.rst
> diff --git a/Documentation/hwmon/dme1737 b/Documentation/hwmon/dme1737.rst
> similarity index 100%
> rename from Documentation/hwmon/dme1737
> rename to Documentation/hwmon/dme1737.rst
> diff --git a/Documentation/hwmon/ds1621 b/Documentation/hwmon/ds1621.rst
> similarity index 100%
> rename from Documentation/hwmon/ds1621
> rename to Documentation/hwmon/ds1621.rst
> diff --git a/Documentation/hwmon/ds620 b/Documentation/hwmon/ds620.rst
> similarity index 100%
> rename from Documentation/hwmon/ds620
> rename to Documentation/hwmon/ds620.rst
> diff --git a/Documentation/hwmon/emc1403 b/Documentation/hwmon/emc1403.rst
> similarity index 100%
> rename from Documentation/hwmon/emc1403
> rename to Documentation/hwmon/emc1403.rst
> diff --git a/Documentation/hwmon/emc2103 b/Documentation/hwmon/emc2103.rst
> similarity index 100%
> rename from Documentation/hwmon/emc2103
> rename to Documentation/hwmon/emc2103.rst
> diff --git a/Documentation/hwmon/emc6w201 b/Documentation/hwmon/emc6w201.rst
> similarity index 100%
> rename from Documentation/hwmon/emc6w201
> rename to Documentation/hwmon/emc6w201.rst
> diff --git a/Documentation/hwmon/f71805f b/Documentation/hwmon/f71805f.rst
> similarity index 100%
> rename from Documentation/hwmon/f71805f
> rename to Documentation/hwmon/f71805f.rst
> diff --git a/Documentation/hwmon/f71882fg b/Documentation/hwmon/f71882fg.rst
> similarity index 100%
> rename from Documentation/hwmon/f71882fg
> rename to Documentation/hwmon/f71882fg.rst
> diff --git a/Documentation/hwmon/fam15h_power b/Documentation/hwmon/fam15h_power.rst
> similarity index 100%
> rename from Documentation/hwmon/fam15h_power
> rename to Documentation/hwmon/fam15h_power.rst
> diff --git a/Documentation/hwmon/ftsteutates b/Documentation/hwmon/ftsteutates.rst
> similarity index 100%
> rename from Documentation/hwmon/ftsteutates
> rename to Documentation/hwmon/ftsteutates.rst
> diff --git a/Documentation/hwmon/g760a b/Documentation/hwmon/g760a.rst
> similarity index 100%
> rename from Documentation/hwmon/g760a
> rename to Documentation/hwmon/g760a.rst
> diff --git a/Documentation/hwmon/g762 b/Documentation/hwmon/g762.rst
> similarity index 97%
> rename from Documentation/hwmon/g762
> rename to Documentation/hwmon/g762.rst
> index 54574e26df21..0371b3365c48 100644
> --- a/Documentation/hwmon/g762
> +++ b/Documentation/hwmon/g762.rst
> @@ -7,7 +7,7 @@ modes - PWM or DC - are supported by the device.
>  
>  For additional information, a detailed datasheet is available at
>  http://natisbad.org/NAS/ref/GMT_EDS-762_763-080710-0.2.pdf. sysfs
> -bindings are described in Documentation/hwmon/sysfs-interface.
> +bindings are described in Documentation/hwmon/sysfs-interface.rst.
>  
>  The following entries are available to the user in a subdirectory of
>  /sys/bus/i2c/drivers/g762/ to control the operation of the device.
> diff --git a/Documentation/hwmon/gl518sm b/Documentation/hwmon/gl518sm.rst
> similarity index 100%
> rename from Documentation/hwmon/gl518sm
> rename to Documentation/hwmon/gl518sm.rst
> diff --git a/Documentation/hwmon/hih6130 b/Documentation/hwmon/hih6130.rst
> similarity index 100%
> rename from Documentation/hwmon/hih6130
> rename to Documentation/hwmon/hih6130.rst
> diff --git a/Documentation/hwmon/hwmon-kernel-api.txt b/Documentation/hwmon/hwmon-kernel-api.rst
> similarity index 99%
> rename from Documentation/hwmon/hwmon-kernel-api.txt
> rename to Documentation/hwmon/hwmon-kernel-api.rst
> index b347b959fcda..c41eb6108103 100644
> --- a/Documentation/hwmon/hwmon-kernel-api.txt
> +++ b/Documentation/hwmon/hwmon-kernel-api.rst
> @@ -12,10 +12,10 @@ drivers that want to use the hardware monitoring framework.
>  This document does not describe what a hardware monitoring (hwmon) Driver or
>  Device is. It also does not describe the API which can be used by user space
>  to communicate with a hardware monitoring device. If you want to know this
> -then please read the following file: Documentation/hwmon/sysfs-interface.
> +then please read the following file: Documentation/hwmon/sysfs-interface.rst.
>  
>  For additional guidelines on how to write and improve hwmon drivers, please
> -also read Documentation/hwmon/submitting-patches.
> +also read Documentation/hwmon/submitting-patches.rst.
>  
>  The API
>  -------
> diff --git a/Documentation/hwmon/ibm-cffps b/Documentation/hwmon/ibm-cffps.rst
> similarity index 100%
> rename from Documentation/hwmon/ibm-cffps
> rename to Documentation/hwmon/ibm-cffps.rst
> diff --git a/Documentation/hwmon/ibmaem b/Documentation/hwmon/ibmaem.rst
> similarity index 100%
> rename from Documentation/hwmon/ibmaem
> rename to Documentation/hwmon/ibmaem.rst
> diff --git a/Documentation/hwmon/ibmpowernv b/Documentation/hwmon/ibmpowernv.rst
> similarity index 100%
> rename from Documentation/hwmon/ibmpowernv
> rename to Documentation/hwmon/ibmpowernv.rst
> diff --git a/Documentation/hwmon/ina209 b/Documentation/hwmon/ina209.rst
> similarity index 100%
> rename from Documentation/hwmon/ina209
> rename to Documentation/hwmon/ina209.rst
> diff --git a/Documentation/hwmon/ina2xx b/Documentation/hwmon/ina2xx.rst
> similarity index 97%
> rename from Documentation/hwmon/ina2xx
> rename to Documentation/hwmon/ina2xx.rst
> index 95badf9c396f..94b9a260c518 100644
> --- a/Documentation/hwmon/ina2xx
> +++ b/Documentation/hwmon/ina2xx.rst
> @@ -78,7 +78,7 @@ refer to the Documentation/devicetree/bindings/hwmon/ina2xx.txt for bindings
>  if the device tree is used.
>  
>  Additionally ina226 supports update_interval attribute as described in
> -Documentation/hwmon/sysfs-interface. Internally the interval is the sum of
> +Documentation/hwmon/sysfs-interface.rst. Internally the interval is the sum of
>  bus and shunt voltage conversion times multiplied by the averaging rate. We
>  don't touch the conversion times and only modify the number of averages. The
>  lower limit of the update_interval is 2 ms, the upper limit is 2253 ms.
> diff --git a/Documentation/hwmon/ina3221 b/Documentation/hwmon/ina3221.rst
> similarity index 100%
> rename from Documentation/hwmon/ina3221
> rename to Documentation/hwmon/ina3221.rst
> diff --git a/Documentation/hwmon/index.rst b/Documentation/hwmon/index.rst
> new file mode 100644
> index 000000000000..893804414510
> --- /dev/null
> +++ b/Documentation/hwmon/index.rst
> @@ -0,0 +1,179 @@
> +=========================
> +Linux Hardware Monitoring
> +=========================
> +
> +.. toctree::
> +   :maxdepth: 1
> +
> +   hwmon-kernel-api.rst
> +   pmbus-core.rst
> +   submitting-patches.rst
> +   sysfs-interface.rst
> +   userspace-tools.rst
> +
> +Hardware Monitoring Kernel Drivers
> +==================================
> +
> +.. toctree::
> +   :maxdepth: 1
> +
> +   ab8500.rst
> +   abituguru.rst
> +   abituguru3.rst
> +   abx500.rst
> +   acpi_power_meter.rst
> +   ad7314.rst
> +   adc128d818.rst
> +   adm1021.rst
> +   adm1025.rst
> +   adm1026.rst
> +   adm1031.rst
> +   adm1275.rst
> +   adm9240.rst
> +   ads1015.rst
> +   ads7828.rst
> +   adt7410.rst
> +   adt7411.rst
> +   adt7462.rst
> +   adt7470.rst
> +   adt7475.rst
> +   amc6821.rst
> +   asb100.rst
> +   asc7621.rst
> +   aspeed-pwm-tacho.rst
> +   coretemp.rst
> +   da9052.rst
> +   da9055.rst
> +   dme1737.rst
> +   ds1621.rst
> +   ds620.rst
> +   emc1403.rst
> +   emc2103.rst
> +   emc6w201.rst
> +   f71805f.rst
> +   f71882fg.rst
> +   fam15h_power.rst
> +   ftsteutates.rst
> +   g760a.rst
> +   g762.rst
> +   gl518sm.rst
> +   hih6130.rst
> +   ibmaem.rst
> +   ibm-cffps.rst
> +   ibmpowernv.rst
> +   ina209.rst
> +   ina2xx.rst
> +   ina3221.rst
> +   ir35221.rst
> +   it87.rst
> +   jc42.rst
> +   k10temp.rst
> +   k8temp.rst
> +   lineage-pem.rst
> +   lm25066.rst
> +   lm63.rst
> +   lm70.rst
> +   lm73.rst
> +   lm75.rst
> +   lm77.rst
> +   lm78.rst
> +   lm80.rst
> +   lm83.rst
> +   lm85.rst
> +   lm87.rst
> +   lm90.rst
> +   lm92.rst
> +   lm93.rst
> +   lm95234.rst
> +   lm95245.rst
> +   ltc2945.rst
> +   ltc2978.rst
> +   ltc2990.rst
> +   ltc3815.rst
> +   ltc4151.rst
> +   ltc4215.rst
> +   ltc4245.rst
> +   ltc4260.rst
> +   ltc4261.rst
> +   max16064.rst
> +   max16065.rst
> +   max1619.rst
> +   max1668.rst
> +   max197.rst
> +   max20751.rst
> +   max31722.rst
> +   max31785.rst
> +   max31790.rst
> +   max34440.rst
> +   max6639.rst
> +   max6642.rst
> +   max6650.rst
> +   max6697.rst
> +   max8688.rst
> +   mc13783-adc.rst
> +   mcp3021.rst
> +   menf21bmc.rst
> +   mlxreg-fan.rst
> +   nct6683.rst
> +   nct6775.rst
> +   nct7802.rst
> +   nct7904.rst
> +   npcm750-pwm-fan.rst
> +   nsa320.rst
> +   ntc_thermistor.rst
> +   occ.rst
> +   pc87360.rst
> +   pc87427.rst
> +   pcf8591.rst
> +   pmbus.rst
> +   powr1220.rst
> +   pwm-fan.rst
> +   raspberrypi-hwmon.rst
> +   sch5627.rst
> +   sch5636.rst
> +   scpi-hwmon.rst
> +   sht15.rst
> +   sht21.rst
> +   sht3x.rst
> +   shtc1.rst
> +   sis5595.rst
> +   smm665.rst
> +   smsc47b397.rst
> +   smsc47m192.rst
> +   smsc47m1.rst
> +   tc654.rst
> +   tc74.rst
> +   thmc50.rst
> +   tmp102.rst
> +   tmp103.rst
> +   tmp108.rst
> +   tmp401.rst
> +   tmp421.rst
> +   tps40422.rst
> +   twl4030-madc-hwmon.rst
> +   ucd9000.rst
> +   ucd9200.rst
> +   vexpress.rst
> +   via686a.rst
> +   vt1211.rst
> +   w83627ehf.rst
> +   w83627hf.rst
> +   w83773g.rst
> +   w83781d.rst
> +   w83791d.rst
> +   w83792d.rst
> +   w83793.rst
> +   w83795.rst
> +   w83l785ts.rst
> +   w83l786ng.rst
> +   wm831x.rst
> +   wm8350.rst
> +   xgene-hwmon.rst
> +   zl6100.rst
> +
> +.. only::  subproject and html
> +
> +   Indices
> +   =======
> +
> +   * :ref:`genindex`
> diff --git a/Documentation/hwmon/ir35221 b/Documentation/hwmon/ir35221.rst
> similarity index 100%
> rename from Documentation/hwmon/ir35221
> rename to Documentation/hwmon/ir35221.rst
> diff --git a/Documentation/hwmon/it87 b/Documentation/hwmon/it87.rst
> similarity index 100%
> rename from Documentation/hwmon/it87
> rename to Documentation/hwmon/it87.rst
> diff --git a/Documentation/hwmon/jc42 b/Documentation/hwmon/jc42.rst
> similarity index 100%
> rename from Documentation/hwmon/jc42
> rename to Documentation/hwmon/jc42.rst
> diff --git a/Documentation/hwmon/k10temp b/Documentation/hwmon/k10temp.rst
> similarity index 100%
> rename from Documentation/hwmon/k10temp
> rename to Documentation/hwmon/k10temp.rst
> diff --git a/Documentation/hwmon/k8temp b/Documentation/hwmon/k8temp.rst
> similarity index 100%
> rename from Documentation/hwmon/k8temp
> rename to Documentation/hwmon/k8temp.rst
> diff --git a/Documentation/hwmon/lineage-pem b/Documentation/hwmon/lineage-pem.rst
> similarity index 100%
> rename from Documentation/hwmon/lineage-pem
> rename to Documentation/hwmon/lineage-pem.rst
> diff --git a/Documentation/hwmon/lm25066 b/Documentation/hwmon/lm25066.rst
> similarity index 97%
> rename from Documentation/hwmon/lm25066
> rename to Documentation/hwmon/lm25066.rst
> index 60b7f2722931..da15e3094c8c 100644
> --- a/Documentation/hwmon/lm25066
> +++ b/Documentation/hwmon/lm25066.rst
> @@ -69,7 +69,7 @@ LM25066, LM5064, and LM5066/LM5066I Power Management, Monitoring,
>  Control, and Protection ICs.
>  
>  The driver is a client driver to the core PMBus driver. Please see
> -Documentation/hwmon/pmbus for details on PMBus client drivers.
> +Documentation/hwmon/pmbus.rst for details on PMBus client drivers.
>  
>  
>  Usage Notes
> diff --git a/Documentation/hwmon/lm63 b/Documentation/hwmon/lm63.rst
> similarity index 100%
> rename from Documentation/hwmon/lm63
> rename to Documentation/hwmon/lm63.rst
> diff --git a/Documentation/hwmon/lm70 b/Documentation/hwmon/lm70.rst
> similarity index 100%
> rename from Documentation/hwmon/lm70
> rename to Documentation/hwmon/lm70.rst
> diff --git a/Documentation/hwmon/lm73 b/Documentation/hwmon/lm73.rst
> similarity index 100%
> rename from Documentation/hwmon/lm73
> rename to Documentation/hwmon/lm73.rst
> diff --git a/Documentation/hwmon/lm75 b/Documentation/hwmon/lm75.rst
> similarity index 100%
> rename from Documentation/hwmon/lm75
> rename to Documentation/hwmon/lm75.rst
> diff --git a/Documentation/hwmon/lm77 b/Documentation/hwmon/lm77.rst
> similarity index 100%
> rename from Documentation/hwmon/lm77
> rename to Documentation/hwmon/lm77.rst
> diff --git a/Documentation/hwmon/lm78 b/Documentation/hwmon/lm78.rst
> similarity index 100%
> rename from Documentation/hwmon/lm78
> rename to Documentation/hwmon/lm78.rst
> diff --git a/Documentation/hwmon/lm80 b/Documentation/hwmon/lm80.rst
> similarity index 100%
> rename from Documentation/hwmon/lm80
> rename to Documentation/hwmon/lm80.rst
> diff --git a/Documentation/hwmon/lm83 b/Documentation/hwmon/lm83.rst
> similarity index 100%
> rename from Documentation/hwmon/lm83
> rename to Documentation/hwmon/lm83.rst
> diff --git a/Documentation/hwmon/lm85 b/Documentation/hwmon/lm85.rst
> similarity index 100%
> rename from Documentation/hwmon/lm85
> rename to Documentation/hwmon/lm85.rst
> diff --git a/Documentation/hwmon/lm87 b/Documentation/hwmon/lm87.rst
> similarity index 100%
> rename from Documentation/hwmon/lm87
> rename to Documentation/hwmon/lm87.rst
> diff --git a/Documentation/hwmon/lm90 b/Documentation/hwmon/lm90.rst
> similarity index 100%
> rename from Documentation/hwmon/lm90
> rename to Documentation/hwmon/lm90.rst
> diff --git a/Documentation/hwmon/lm92 b/Documentation/hwmon/lm92.rst
> similarity index 100%
> rename from Documentation/hwmon/lm92
> rename to Documentation/hwmon/lm92.rst
> diff --git a/Documentation/hwmon/lm93 b/Documentation/hwmon/lm93.rst
> similarity index 100%
> rename from Documentation/hwmon/lm93
> rename to Documentation/hwmon/lm93.rst
> diff --git a/Documentation/hwmon/lm95234 b/Documentation/hwmon/lm95234.rst
> similarity index 100%
> rename from Documentation/hwmon/lm95234
> rename to Documentation/hwmon/lm95234.rst
> diff --git a/Documentation/hwmon/lm95245 b/Documentation/hwmon/lm95245.rst
> similarity index 100%
> rename from Documentation/hwmon/lm95245
> rename to Documentation/hwmon/lm95245.rst
> diff --git a/Documentation/hwmon/ltc2945 b/Documentation/hwmon/ltc2945.rst
> similarity index 100%
> rename from Documentation/hwmon/ltc2945
> rename to Documentation/hwmon/ltc2945.rst
> diff --git a/Documentation/hwmon/ltc2978 b/Documentation/hwmon/ltc2978.rst
> similarity index 100%
> rename from Documentation/hwmon/ltc2978
> rename to Documentation/hwmon/ltc2978.rst
> diff --git a/Documentation/hwmon/ltc2990 b/Documentation/hwmon/ltc2990.rst
> similarity index 100%
> rename from Documentation/hwmon/ltc2990
> rename to Documentation/hwmon/ltc2990.rst
> diff --git a/Documentation/hwmon/ltc3815 b/Documentation/hwmon/ltc3815.rst
> similarity index 100%
> rename from Documentation/hwmon/ltc3815
> rename to Documentation/hwmon/ltc3815.rst
> diff --git a/Documentation/hwmon/ltc4151 b/Documentation/hwmon/ltc4151.rst
> similarity index 100%
> rename from Documentation/hwmon/ltc4151
> rename to Documentation/hwmon/ltc4151.rst
> diff --git a/Documentation/hwmon/ltc4215 b/Documentation/hwmon/ltc4215.rst
> similarity index 100%
> rename from Documentation/hwmon/ltc4215
> rename to Documentation/hwmon/ltc4215.rst
> diff --git a/Documentation/hwmon/ltc4245 b/Documentation/hwmon/ltc4245.rst
> similarity index 100%
> rename from Documentation/hwmon/ltc4245
> rename to Documentation/hwmon/ltc4245.rst
> diff --git a/Documentation/hwmon/ltc4260 b/Documentation/hwmon/ltc4260.rst
> similarity index 100%
> rename from Documentation/hwmon/ltc4260
> rename to Documentation/hwmon/ltc4260.rst
> diff --git a/Documentation/hwmon/ltc4261 b/Documentation/hwmon/ltc4261.rst
> similarity index 100%
> rename from Documentation/hwmon/ltc4261
> rename to Documentation/hwmon/ltc4261.rst
> diff --git a/Documentation/hwmon/max16064 b/Documentation/hwmon/max16064.rst
> similarity index 96%
> rename from Documentation/hwmon/max16064
> rename to Documentation/hwmon/max16064.rst
> index 61ec679dc477..6d5e9538991f 100644
> --- a/Documentation/hwmon/max16064
> +++ b/Documentation/hwmon/max16064.rst
> @@ -21,7 +21,7 @@ This driver supports hardware monitoring for Maxim MAX16064 Quad Power-Supply
>  Controller with Active-Voltage Output Control and PMBus Interface.
>  
>  The driver is a client driver to the core PMBus driver.
> -Please see Documentation/hwmon/pmbus for details on PMBus client drivers.
> +Please see Documentation/hwmon/pmbus.rst for details on PMBus client drivers.
>  
>  
>  Usage Notes
> diff --git a/Documentation/hwmon/max16065 b/Documentation/hwmon/max16065.rst
> similarity index 100%
> rename from Documentation/hwmon/max16065
> rename to Documentation/hwmon/max16065.rst
> diff --git a/Documentation/hwmon/max1619 b/Documentation/hwmon/max1619.rst
> similarity index 99%
> rename from Documentation/hwmon/max1619
> rename to Documentation/hwmon/max1619.rst
> index 4b3762c4eceb..e25956e70f73 100644
> --- a/Documentation/hwmon/max1619
> +++ b/Documentation/hwmon/max1619.rst
> @@ -31,4 +31,3 @@ Only the external sensor has high and low limits.
>  The max1619 driver will not update its values more frequently than every
>  other second; reading them more often will do no harm, but will return
>  'old' values.
> -
> diff --git a/Documentation/hwmon/max1668 b/Documentation/hwmon/max1668.rst
> similarity index 100%
> rename from Documentation/hwmon/max1668
> rename to Documentation/hwmon/max1668.rst
> diff --git a/Documentation/hwmon/max197 b/Documentation/hwmon/max197.rst
> similarity index 100%
> rename from Documentation/hwmon/max197
> rename to Documentation/hwmon/max197.rst
> diff --git a/Documentation/hwmon/max20751 b/Documentation/hwmon/max20751.rst
> similarity index 96%
> rename from Documentation/hwmon/max20751
> rename to Documentation/hwmon/max20751.rst
> index d546695900ef..aa4469be6674 100644
> --- a/Documentation/hwmon/max20751
> +++ b/Documentation/hwmon/max20751.rst
> @@ -23,7 +23,7 @@ This driver supports MAX20751 Multiphase Master with PMBus Interface
>  and Internal Buck Converter.
>  
>  The driver is a client driver to the core PMBus driver.
> -Please see Documentation/hwmon/pmbus for details on PMBus client drivers.
> +Please see Documentation/hwmon/pmbus.rst for details on PMBus client drivers.
>  
>  
>  Usage Notes
> diff --git a/Documentation/hwmon/max31722 b/Documentation/hwmon/max31722.rst
> similarity index 100%
> rename from Documentation/hwmon/max31722
> rename to Documentation/hwmon/max31722.rst
> diff --git a/Documentation/hwmon/max31785 b/Documentation/hwmon/max31785.rst
> similarity index 100%
> rename from Documentation/hwmon/max31785
> rename to Documentation/hwmon/max31785.rst
> diff --git a/Documentation/hwmon/max31790 b/Documentation/hwmon/max31790.rst
> similarity index 100%
> rename from Documentation/hwmon/max31790
> rename to Documentation/hwmon/max31790.rst
> diff --git a/Documentation/hwmon/max34440 b/Documentation/hwmon/max34440.rst
> similarity index 98%
> rename from Documentation/hwmon/max34440
> rename to Documentation/hwmon/max34440.rst
> index 639838ef29fd..939138e12b02 100644
> --- a/Documentation/hwmon/max34440
> +++ b/Documentation/hwmon/max34440.rst
> @@ -76,7 +76,7 @@ based on GIN pins. The MAX34460 supports 12 voltage channels, and the MAX34461
>  supports 16 voltage channels.
>  
>  The driver is a client driver to the core PMBus driver. Please see
> -Documentation/hwmon/pmbus for details on PMBus client drivers.
> +Documentation/hwmon/pmbus.rst for details on PMBus client drivers.
>  
>  
>  Usage Notes
> diff --git a/Documentation/hwmon/max6639 b/Documentation/hwmon/max6639.rst
> similarity index 100%
> rename from Documentation/hwmon/max6639
> rename to Documentation/hwmon/max6639.rst
> diff --git a/Documentation/hwmon/max6642 b/Documentation/hwmon/max6642.rst
> similarity index 100%
> rename from Documentation/hwmon/max6642
> rename to Documentation/hwmon/max6642.rst
> diff --git a/Documentation/hwmon/max6650 b/Documentation/hwmon/max6650.rst
> similarity index 99%
> rename from Documentation/hwmon/max6650
> rename to Documentation/hwmon/max6650.rst
> index 74dc3f0caaa2..253482add082 100644
> --- a/Documentation/hwmon/max6650
> +++ b/Documentation/hwmon/max6650.rst
> @@ -72,4 +72,3 @@ clock: The clock frequency in Hz of the chip the driver should assume [254000]
>  
>  Please have a look at the MAX6650/6651 data sheet and make sure that you fully
>  understand the meaning of these parameters before you attempt to change them.
> -
> diff --git a/Documentation/hwmon/max6697 b/Documentation/hwmon/max6697.rst
> similarity index 100%
> rename from Documentation/hwmon/max6697
> rename to Documentation/hwmon/max6697.rst
> diff --git a/Documentation/hwmon/max8688 b/Documentation/hwmon/max8688.rst
> similarity index 97%
> rename from Documentation/hwmon/max8688
> rename to Documentation/hwmon/max8688.rst
> index 43da139234c1..009487759c61 100644
> --- a/Documentation/hwmon/max8688
> +++ b/Documentation/hwmon/max8688.rst
> @@ -21,7 +21,7 @@ This driver supports hardware monitoring for Maxim MAX8688 Digital Power-Supply
>  Controller/Monitor with PMBus Interface.
>  
>  The driver is a client driver to the core PMBus driver. Please see
> -Documentation/hwmon/pmbus for details on PMBus client drivers.
> +Documentation/hwmon/pmbus.rst for details on PMBus client drivers.
>  
>  
>  Usage Notes
> diff --git a/Documentation/hwmon/mc13783-adc b/Documentation/hwmon/mc13783-adc.rst
> similarity index 100%
> rename from Documentation/hwmon/mc13783-adc
> rename to Documentation/hwmon/mc13783-adc.rst
> diff --git a/Documentation/hwmon/mcp3021 b/Documentation/hwmon/mcp3021.rst
> similarity index 100%
> rename from Documentation/hwmon/mcp3021
> rename to Documentation/hwmon/mcp3021.rst
> diff --git a/Documentation/hwmon/menf21bmc b/Documentation/hwmon/menf21bmc.rst
> similarity index 100%
> rename from Documentation/hwmon/menf21bmc
> rename to Documentation/hwmon/menf21bmc.rst
> diff --git a/Documentation/hwmon/mlxreg-fan b/Documentation/hwmon/mlxreg-fan.rst
> similarity index 100%
> rename from Documentation/hwmon/mlxreg-fan
> rename to Documentation/hwmon/mlxreg-fan.rst
> diff --git a/Documentation/hwmon/nct6683 b/Documentation/hwmon/nct6683.rst
> similarity index 100%
> rename from Documentation/hwmon/nct6683
> rename to Documentation/hwmon/nct6683.rst
> diff --git a/Documentation/hwmon/nct6775 b/Documentation/hwmon/nct6775.rst
> similarity index 100%
> rename from Documentation/hwmon/nct6775
> rename to Documentation/hwmon/nct6775.rst
> diff --git a/Documentation/hwmon/nct7802 b/Documentation/hwmon/nct7802.rst
> similarity index 100%
> rename from Documentation/hwmon/nct7802
> rename to Documentation/hwmon/nct7802.rst
> diff --git a/Documentation/hwmon/nct7904 b/Documentation/hwmon/nct7904.rst
> similarity index 100%
> rename from Documentation/hwmon/nct7904
> rename to Documentation/hwmon/nct7904.rst
> diff --git a/Documentation/hwmon/npcm750-pwm-fan b/Documentation/hwmon/npcm750-pwm-fan.rst
> similarity index 100%
> rename from Documentation/hwmon/npcm750-pwm-fan
> rename to Documentation/hwmon/npcm750-pwm-fan.rst
> diff --git a/Documentation/hwmon/nsa320 b/Documentation/hwmon/nsa320.rst
> similarity index 100%
> rename from Documentation/hwmon/nsa320
> rename to Documentation/hwmon/nsa320.rst
> diff --git a/Documentation/hwmon/ntc_thermistor b/Documentation/hwmon/ntc_thermistor.rst
> similarity index 100%
> rename from Documentation/hwmon/ntc_thermistor
> rename to Documentation/hwmon/ntc_thermistor.rst
> diff --git a/Documentation/hwmon/occ b/Documentation/hwmon/occ.rst
> similarity index 100%
> rename from Documentation/hwmon/occ
> rename to Documentation/hwmon/occ.rst
> diff --git a/Documentation/hwmon/pc87360 b/Documentation/hwmon/pc87360.rst
> similarity index 100%
> rename from Documentation/hwmon/pc87360
> rename to Documentation/hwmon/pc87360.rst
> diff --git a/Documentation/hwmon/pc87427 b/Documentation/hwmon/pc87427.rst
> similarity index 100%
> rename from Documentation/hwmon/pc87427
> rename to Documentation/hwmon/pc87427.rst
> diff --git a/Documentation/hwmon/pcf8591 b/Documentation/hwmon/pcf8591.rst
> similarity index 100%
> rename from Documentation/hwmon/pcf8591
> rename to Documentation/hwmon/pcf8591.rst
> diff --git a/Documentation/hwmon/pmbus-core b/Documentation/hwmon/pmbus-core.rst
> similarity index 100%
> rename from Documentation/hwmon/pmbus-core
> rename to Documentation/hwmon/pmbus-core.rst
> diff --git a/Documentation/hwmon/pmbus b/Documentation/hwmon/pmbus.rst
> similarity index 100%
> rename from Documentation/hwmon/pmbus
> rename to Documentation/hwmon/pmbus.rst
> diff --git a/Documentation/hwmon/powr1220 b/Documentation/hwmon/powr1220.rst
> similarity index 100%
> rename from Documentation/hwmon/powr1220
> rename to Documentation/hwmon/powr1220.rst
> diff --git a/Documentation/hwmon/pwm-fan b/Documentation/hwmon/pwm-fan.rst
> similarity index 100%
> rename from Documentation/hwmon/pwm-fan
> rename to Documentation/hwmon/pwm-fan.rst
> diff --git a/Documentation/hwmon/raspberrypi-hwmon b/Documentation/hwmon/raspberrypi-hwmon.rst
> similarity index 100%
> rename from Documentation/hwmon/raspberrypi-hwmon
> rename to Documentation/hwmon/raspberrypi-hwmon.rst
> diff --git a/Documentation/hwmon/sch5627 b/Documentation/hwmon/sch5627.rst
> similarity index 100%
> rename from Documentation/hwmon/sch5627
> rename to Documentation/hwmon/sch5627.rst
> diff --git a/Documentation/hwmon/sch5636 b/Documentation/hwmon/sch5636.rst
> similarity index 100%
> rename from Documentation/hwmon/sch5636
> rename to Documentation/hwmon/sch5636.rst
> diff --git a/Documentation/hwmon/scpi-hwmon b/Documentation/hwmon/scpi-hwmon.rst
> similarity index 100%
> rename from Documentation/hwmon/scpi-hwmon
> rename to Documentation/hwmon/scpi-hwmon.rst
> diff --git a/Documentation/hwmon/sht15 b/Documentation/hwmon/sht15.rst
> similarity index 100%
> rename from Documentation/hwmon/sht15
> rename to Documentation/hwmon/sht15.rst
> diff --git a/Documentation/hwmon/sht21 b/Documentation/hwmon/sht21.rst
> similarity index 100%
> rename from Documentation/hwmon/sht21
> rename to Documentation/hwmon/sht21.rst
> diff --git a/Documentation/hwmon/sht3x b/Documentation/hwmon/sht3x.rst
> similarity index 100%
> rename from Documentation/hwmon/sht3x
> rename to Documentation/hwmon/sht3x.rst
> diff --git a/Documentation/hwmon/shtc1 b/Documentation/hwmon/shtc1.rst
> similarity index 100%
> rename from Documentation/hwmon/shtc1
> rename to Documentation/hwmon/shtc1.rst
> diff --git a/Documentation/hwmon/sis5595 b/Documentation/hwmon/sis5595.rst
> similarity index 99%
> rename from Documentation/hwmon/sis5595
> rename to Documentation/hwmon/sis5595.rst
> index 5acba6b0c0db..16123b3bfff9 100644
> --- a/Documentation/hwmon/sis5595
> +++ b/Documentation/hwmon/sis5595.rst
> @@ -121,4 +121,3 @@ Problems
>  --------
>  Some chips refuse to be enabled. We don't know why.
>  The driver will recognize this and print a message in dmesg.
> -
> diff --git a/Documentation/hwmon/smm665 b/Documentation/hwmon/smm665.rst
> similarity index 100%
> rename from Documentation/hwmon/smm665
> rename to Documentation/hwmon/smm665.rst
> diff --git a/Documentation/hwmon/smsc47b397 b/Documentation/hwmon/smsc47b397.rst
> similarity index 100%
> rename from Documentation/hwmon/smsc47b397
> rename to Documentation/hwmon/smsc47b397.rst
> diff --git a/Documentation/hwmon/smsc47m1 b/Documentation/hwmon/smsc47m1.rst
> similarity index 100%
> rename from Documentation/hwmon/smsc47m1
> rename to Documentation/hwmon/smsc47m1.rst
> diff --git a/Documentation/hwmon/smsc47m192 b/Documentation/hwmon/smsc47m192.rst
> similarity index 100%
> rename from Documentation/hwmon/smsc47m192
> rename to Documentation/hwmon/smsc47m192.rst
> diff --git a/Documentation/hwmon/submitting-patches b/Documentation/hwmon/submitting-patches.rst
> similarity index 98%
> rename from Documentation/hwmon/submitting-patches
> rename to Documentation/hwmon/submitting-patches.rst
> index 12540b7d9b50..f9796b9d9db6 100644
> --- a/Documentation/hwmon/submitting-patches
> +++ b/Documentation/hwmon/submitting-patches.rst
> @@ -39,7 +39,7 @@ increase the chances of your change being accepted.
>  2. Adding functionality to existing drivers
>  -------------------------------------------
>  
> -* Make sure the documentation in Documentation/hwmon/<driver_name> is up to
> +* Make sure the documentation in Documentation/hwmon/<driver_name>.rst is up to
>    date.
>  
>  * Make sure the information in Kconfig is up to date.
> @@ -61,7 +61,7 @@ increase the chances of your change being accepted.
>  
>  * Consider adding yourself to MAINTAINERS.
>  
> -* Document the driver in Documentation/hwmon/<driver_name>.
> +* Document the driver in Documentation/hwmon/<driver_name>.rst.
>  
>  * Add the driver to Kconfig and Makefile in alphabetical order.
>  
> @@ -134,7 +134,7 @@ increase the chances of your change being accepted.
>    non-standard attributes, or you believe you do, discuss it on the mailing list
>    first. Either case, provide a detailed explanation why you need the
>    non-standard attribute(s).
> -  Standard attributes are specified in Documentation/hwmon/sysfs-interface.
> +  Standard attributes are specified in Documentation/hwmon/sysfs-interface.rst.
>  
>  * When deciding which sysfs attributes to support, look at the chip's
>    capabilities. While we do not expect your driver to support everything the
> diff --git a/Documentation/hwmon/sysfs-interface b/Documentation/hwmon/sysfs-interface.rst
> similarity index 100%
> rename from Documentation/hwmon/sysfs-interface
> rename to Documentation/hwmon/sysfs-interface.rst
> diff --git a/Documentation/hwmon/tc654 b/Documentation/hwmon/tc654.rst
> similarity index 100%
> rename from Documentation/hwmon/tc654
> rename to Documentation/hwmon/tc654.rst
> diff --git a/Documentation/hwmon/tc74 b/Documentation/hwmon/tc74.rst
> similarity index 100%
> rename from Documentation/hwmon/tc74
> rename to Documentation/hwmon/tc74.rst
> diff --git a/Documentation/hwmon/thmc50 b/Documentation/hwmon/thmc50.rst
> similarity index 99%
> rename from Documentation/hwmon/thmc50
> rename to Documentation/hwmon/thmc50.rst
> index 6dba1b59b20c..cfff3885287d 100644
> --- a/Documentation/hwmon/thmc50
> +++ b/Documentation/hwmon/thmc50.rst
> @@ -87,4 +87,3 @@ so it stops fans even if the value 0 into the ANALOG_OUT register does not.
>  
>  The driver was tested on Compaq AP550 with two ADM1022 chips (one works
>  in the temp3 mode), five temperature readings and two fans.
> -
> diff --git a/Documentation/hwmon/tmp102 b/Documentation/hwmon/tmp102.rst
> similarity index 93%
> rename from Documentation/hwmon/tmp102
> rename to Documentation/hwmon/tmp102.rst
> index 5e34821df4ab..b1f585531a88 100644
> --- a/Documentation/hwmon/tmp102
> +++ b/Documentation/hwmon/tmp102.rst
> @@ -28,4 +28,4 @@ The TMP102 has a programmable update rate that can select between 8, 4, 1, and
>  0.5 Hz. (Currently the driver only supports the default of 4 Hz).
>  
>  The driver provides the common sysfs-interface for temperatures (see
> -Documentation/hwmon/sysfs-interface under Temperatures).
> +Documentation/hwmon/sysfs-interface.rst under Temperatures).
> diff --git a/Documentation/hwmon/tmp103 b/Documentation/hwmon/tmp103.rst
> similarity index 92%
> rename from Documentation/hwmon/tmp103
> rename to Documentation/hwmon/tmp103.rst
> index 7682a795e38c..15d25806d585 100644
> --- a/Documentation/hwmon/tmp103
> +++ b/Documentation/hwmon/tmp103.rst
> @@ -27,7 +27,7 @@ Resolution: 8 Bits
>  Accuracy: ±1°C Typ (–10°C to +100°C)
>  
>  The driver provides the common sysfs-interface for temperatures (see
> -Documentation/hwmon/sysfs-interface under Temperatures).
> +Documentation/hwmon/sysfs-interface.rst under Temperatures).
>  
>  Please refer how to instantiate this driver:
>  Documentation/i2c/instantiating-devices
> diff --git a/Documentation/hwmon/tmp108 b/Documentation/hwmon/tmp108.rst
> similarity index 95%
> rename from Documentation/hwmon/tmp108
> rename to Documentation/hwmon/tmp108.rst
> index 7e08b7ef1e2f..5f4266a16cb2 100644
> --- a/Documentation/hwmon/tmp108
> +++ b/Documentation/hwmon/tmp108.rst
> @@ -38,4 +38,4 @@ and then the device is shut down automatically. (This driver only supports
>  continuous mode.)
>  
>  The driver provides the common sysfs-interface for temperatures (see
> -Documentation/hwmon/sysfs-interface under Temperatures).
> +Documentation/hwmon/sysfs-interface.rst under Temperatures).
> diff --git a/Documentation/hwmon/tmp401 b/Documentation/hwmon/tmp401.rst
> similarity index 97%
> rename from Documentation/hwmon/tmp401
> rename to Documentation/hwmon/tmp401.rst
> index bd865bbdb38d..6a05a0719bc7 100644
> --- a/Documentation/hwmon/tmp401
> +++ b/Documentation/hwmon/tmp401.rst
> @@ -68,7 +68,7 @@ supported by the driver so far, so using the default resolution of 0.5
>  degree).
>  
>  The driver provides the common sysfs-interface for temperatures (see
> -Documentation/hwmon/sysfs-interface under Temperatures).
> +Documentation/hwmon/sysfs-interface.rst under Temperatures).
>  
>  The TMP411 and TMP431 chips are compatible with TMP401. TMP411 provides
>  some additional features.
> diff --git a/Documentation/hwmon/tmp421 b/Documentation/hwmon/tmp421.rst
> similarity index 100%
> rename from Documentation/hwmon/tmp421
> rename to Documentation/hwmon/tmp421.rst
> diff --git a/Documentation/hwmon/tps40422 b/Documentation/hwmon/tps40422.rst
> similarity index 96%
> rename from Documentation/hwmon/tps40422
> rename to Documentation/hwmon/tps40422.rst
> index 359751eb5ed4..b691e30479dd 100644
> --- a/Documentation/hwmon/tps40422
> +++ b/Documentation/hwmon/tps40422.rst
> @@ -21,7 +21,7 @@ This driver supports TI TPS40422 Dual-Output or Two-Phase Synchronous Buck
>  Controller with PMBus
>  
>  The driver is a client driver to the core PMBus driver.
> -Please see Documentation/hwmon/pmbus for details on PMBus client drivers.
> +Please see Documentation/hwmon/pmbus.rst for details on PMBus client drivers.
>  
>  
>  Usage Notes
> diff --git a/Documentation/hwmon/twl4030-madc-hwmon b/Documentation/hwmon/twl4030-madc-hwmon.rst
> similarity index 100%
> rename from Documentation/hwmon/twl4030-madc-hwmon
> rename to Documentation/hwmon/twl4030-madc-hwmon.rst
> diff --git a/Documentation/hwmon/ucd9000 b/Documentation/hwmon/ucd9000.rst
> similarity index 97%
> rename from Documentation/hwmon/ucd9000
> rename to Documentation/hwmon/ucd9000.rst
> index d69061b7312c..ebc4f2b3bfea 100644
> --- a/Documentation/hwmon/ucd9000
> +++ b/Documentation/hwmon/ucd9000.rst
> @@ -57,7 +57,7 @@ system-health monitor. The device integrates a 12-bit ADC for monitoring up to
>  13 power-supply voltage, current, or temperature inputs.
>  
>  This driver is a client driver to the core PMBus driver. Please see
> -Documentation/hwmon/pmbus for details on PMBus client drivers.
> +Documentation/hwmon/pmbus.rst for details on PMBus client drivers.
>  
>  
>  Usage Notes
> @@ -72,7 +72,7 @@ Platform data support
>  ---------------------
>  
>  The driver supports standard PMBus driver platform data. Please see
> -Documentation/hwmon/pmbus for details.
> +Documentation/hwmon/pmbus.rst for details.
>  
>  
>  Sysfs entries
> diff --git a/Documentation/hwmon/ucd9200 b/Documentation/hwmon/ucd9200.rst
> similarity index 97%
> rename from Documentation/hwmon/ucd9200
> rename to Documentation/hwmon/ucd9200.rst
> index 44eda4a579b6..b819dfd75f71 100644
> --- a/Documentation/hwmon/ucd9200
> +++ b/Documentation/hwmon/ucd9200.rst
> @@ -33,7 +33,7 @@ dedicated circuitry for DC/DC loop management with flash memory and a serial
>  interface to support configuration, monitoring and management.
>  
>  This driver is a client driver to the core PMBus driver. Please see
> -Documentation/hwmon/pmbus for details on PMBus client drivers.
> +Documentation/hwmon/pmbus.rst for details on PMBus client drivers.
>  
>  
>  Usage Notes
> @@ -48,7 +48,7 @@ Platform data support
>  ---------------------
>  
>  The driver supports standard PMBus driver platform data. Please see
> -Documentation/hwmon/pmbus for details.
> +Documentation/hwmon/pmbus.rst for details.
>  
>  
>  Sysfs entries
> diff --git a/Documentation/hwmon/userspace-tools b/Documentation/hwmon/userspace-tools.rst
> similarity index 100%
> rename from Documentation/hwmon/userspace-tools
> rename to Documentation/hwmon/userspace-tools.rst
> diff --git a/Documentation/hwmon/vexpress b/Documentation/hwmon/vexpress.rst
> similarity index 100%
> rename from Documentation/hwmon/vexpress
> rename to Documentation/hwmon/vexpress.rst
> diff --git a/Documentation/hwmon/via686a b/Documentation/hwmon/via686a.rst
> similarity index 100%
> rename from Documentation/hwmon/via686a
> rename to Documentation/hwmon/via686a.rst
> diff --git a/Documentation/hwmon/vt1211 b/Documentation/hwmon/vt1211.rst
> similarity index 100%
> rename from Documentation/hwmon/vt1211
> rename to Documentation/hwmon/vt1211.rst
> diff --git a/Documentation/hwmon/w83627ehf b/Documentation/hwmon/w83627ehf.rst
> similarity index 100%
> rename from Documentation/hwmon/w83627ehf
> rename to Documentation/hwmon/w83627ehf.rst
> diff --git a/Documentation/hwmon/w83627hf b/Documentation/hwmon/w83627hf.rst
> similarity index 100%
> rename from Documentation/hwmon/w83627hf
> rename to Documentation/hwmon/w83627hf.rst
> diff --git a/Documentation/hwmon/w83773g b/Documentation/hwmon/w83773g.rst
> similarity index 100%
> rename from Documentation/hwmon/w83773g
> rename to Documentation/hwmon/w83773g.rst
> diff --git a/Documentation/hwmon/w83781d b/Documentation/hwmon/w83781d.rst
> similarity index 100%
> rename from Documentation/hwmon/w83781d
> rename to Documentation/hwmon/w83781d.rst
> diff --git a/Documentation/hwmon/w83791d b/Documentation/hwmon/w83791d.rst
> similarity index 99%
> rename from Documentation/hwmon/w83791d
> rename to Documentation/hwmon/w83791d.rst
> index a91f9e5fb0c6..3adaed39b157 100644
> --- a/Documentation/hwmon/w83791d
> +++ b/Documentation/hwmon/w83791d.rst
> @@ -102,7 +102,7 @@ This file is used for both legacy and new code.
>  
>  The sysfs interface to the beep bitmask has migrated from the original legacy
>  method of a single sysfs beep_mask file to a newer method using multiple
> -`*_beep` files as described in `Documentation/hwmon/sysfs-interface`.
> +`*_beep` files as described in `Documentation/hwmon/sysfs-interface.rst`.
>  
>  A similar change has occurred for the bitmap corresponding to the alarms. The
>  original legacy method used a single sysfs alarms file containing a bitmap
> diff --git a/Documentation/hwmon/w83792d b/Documentation/hwmon/w83792d.rst
> similarity index 100%
> rename from Documentation/hwmon/w83792d
> rename to Documentation/hwmon/w83792d.rst
> diff --git a/Documentation/hwmon/w83793 b/Documentation/hwmon/w83793.rst
> similarity index 100%
> rename from Documentation/hwmon/w83793
> rename to Documentation/hwmon/w83793.rst
> diff --git a/Documentation/hwmon/w83795 b/Documentation/hwmon/w83795.rst
> similarity index 100%
> rename from Documentation/hwmon/w83795
> rename to Documentation/hwmon/w83795.rst
> diff --git a/Documentation/hwmon/w83l785ts b/Documentation/hwmon/w83l785ts.rst
> similarity index 100%
> rename from Documentation/hwmon/w83l785ts
> rename to Documentation/hwmon/w83l785ts.rst
> diff --git a/Documentation/hwmon/w83l786ng b/Documentation/hwmon/w83l786ng.rst
> similarity index 100%
> rename from Documentation/hwmon/w83l786ng
> rename to Documentation/hwmon/w83l786ng.rst
> diff --git a/Documentation/hwmon/wm831x b/Documentation/hwmon/wm831x.rst
> similarity index 100%
> rename from Documentation/hwmon/wm831x
> rename to Documentation/hwmon/wm831x.rst
> diff --git a/Documentation/hwmon/wm8350 b/Documentation/hwmon/wm8350.rst
> similarity index 100%
> rename from Documentation/hwmon/wm8350
> rename to Documentation/hwmon/wm8350.rst
> diff --git a/Documentation/hwmon/xgene-hwmon b/Documentation/hwmon/xgene-hwmon.rst
> similarity index 100%
> rename from Documentation/hwmon/xgene-hwmon
> rename to Documentation/hwmon/xgene-hwmon.rst
> diff --git a/Documentation/hwmon/zl6100 b/Documentation/hwmon/zl6100.rst
> similarity index 98%
> rename from Documentation/hwmon/zl6100
> rename to Documentation/hwmon/zl6100.rst
> index 4029970bace4..41513bb7fe51 100644
> --- a/Documentation/hwmon/zl6100
> +++ b/Documentation/hwmon/zl6100.rst
> @@ -113,7 +113,7 @@ This driver supports hardware monitoring for Intersil / Zilker Labs ZL6100 and
>  compatible digital DC-DC controllers.
>  
>  The driver is a client driver to the core PMBus driver. Please see
> -Documentation/hwmon/pmbus and Documentation.hwmon/pmbus-core for details
> +Documentation/hwmon/pmbus.rst and Documentation.hwmon/pmbus-core for details
>  on PMBus client drivers.
>  
>  
> diff --git a/Documentation/index.rst b/Documentation/index.rst
> index 80a421cb935e..3a710dc24fc8 100644
> --- a/Documentation/index.rst
> +++ b/Documentation/index.rst
> @@ -83,6 +83,7 @@ needed).
>     media/index
>     networking/index
>     input/index
> +   hwmon/index
>     gpu/index
>     security/index
>     sound/index
> diff --git a/Documentation/thermal/sysfs-api.txt b/Documentation/thermal/sysfs-api.txt
> index 911399730c1c..c3fa500df92c 100644
> --- a/Documentation/thermal/sysfs-api.txt
> +++ b/Documentation/thermal/sysfs-api.txt
> @@ -316,7 +316,7 @@ ACPI thermal zones.
>      |---temp[1-*]_input:	The current temperature of thermal zone [1-*]
>      |---temp[1-*]_critical:	The critical trip point of thermal zone [1-*]
>  
> -Please read Documentation/hwmon/sysfs-interface for additional information.
> +Please read Documentation/hwmon/sysfs-interface.rst for additional information.
>  
>  ***************************
>  * Thermal zone attributes *
> diff --git a/MAINTAINERS b/MAINTAINERS
> index 349e5d8c3f58..6269c9d671ca 100644
> --- a/MAINTAINERS
> +++ b/MAINTAINERS
> @@ -468,7 +468,7 @@ ADM1025 HARDWARE MONITOR DRIVER
>  M:	Jean Delvare <jdelvare@suse.com>
>  L:	linux-hwmon@vger.kernel.org
>  S:	Maintained
> -F:	Documentation/hwmon/adm1025
> +F:	Documentation/hwmon/adm1025.rst
>  F:	drivers/hwmon/adm1025.c
>  
>  ADM1029 HARDWARE MONITOR DRIVER
> @@ -520,7 +520,7 @@ ADS1015 HARDWARE MONITOR DRIVER
>  M:	Dirk Eibach <eibach@gdsys.de>
>  L:	linux-hwmon@vger.kernel.org
>  S:	Maintained
> -F:	Documentation/hwmon/ads1015
> +F:	Documentation/hwmon/ads1015.rst
>  F:	drivers/hwmon/ads1015.c
>  F:	include/linux/platform_data/ads1015.h
>  
> @@ -533,7 +533,7 @@ ADT7475 HARDWARE MONITOR DRIVER
>  M:	Jean Delvare <jdelvare@suse.com>
>  L:	linux-hwmon@vger.kernel.org
>  S:	Maintained
> -F:	Documentation/hwmon/adt7475
> +F:	Documentation/hwmon/adt7475.rst
>  F:	drivers/hwmon/adt7475.c
>  
>  ADVANSYS SCSI DRIVER
> @@ -764,7 +764,7 @@ AMD FAM15H PROCESSOR POWER MONITORING DRIVER
>  M:	Huang Rui <ray.huang@amd.com>
>  L:	linux-hwmon@vger.kernel.org
>  S:	Supported
> -F:	Documentation/hwmon/fam15h_power
> +F:	Documentation/hwmon/fam15h_power.rst
>  F:	drivers/hwmon/fam15h_power.c
>  
>  AMD FCH GPIO DRIVER
> @@ -2531,7 +2531,7 @@ ASC7621 HARDWARE MONITOR DRIVER
>  M:	George Joseph <george.joseph@fairview5.com>
>  L:	linux-hwmon@vger.kernel.org
>  S:	Maintained
> -F:	Documentation/hwmon/asc7621
> +F:	Documentation/hwmon/asc7621.rst
>  F:	drivers/hwmon/asc7621.c
>  
>  ASPEED VIDEO ENGINE DRIVER
> @@ -4071,7 +4071,7 @@ CORETEMP HARDWARE MONITORING DRIVER
>  M:	Fenghua Yu <fenghua.yu@intel.com>
>  L:	linux-hwmon@vger.kernel.org
>  S:	Maintained
> -F:	Documentation/hwmon/coretemp
> +F:	Documentation/hwmon/coretemp.rst
>  F:	drivers/hwmon/coretemp.c
>  
>  COSA/SRP SYNC SERIAL DRIVER
> @@ -4627,7 +4627,7 @@ DIALOG SEMICONDUCTOR DRIVERS
>  M:	Support Opensource <support.opensource@diasemi.com>
>  W:	http://www.dialog-semiconductor.com/products
>  S:	Supported
> -F:	Documentation/hwmon/da90??
> +F:	Documentation/hwmon/da90??.rst
>  F:	Documentation/devicetree/bindings/mfd/da90*.txt
>  F:	Documentation/devicetree/bindings/input/da90??-onkey.txt
>  F:	Documentation/devicetree/bindings/thermal/da90??-thermal.txt
> @@ -4778,7 +4778,7 @@ DME1737 HARDWARE MONITOR DRIVER
>  M:	Juerg Haefliger <juergh@gmail.com>
>  L:	linux-hwmon@vger.kernel.org
>  S:	Maintained
> -F:	Documentation/hwmon/dme1737
> +F:	Documentation/hwmon/dme1737.rst
>  F:	drivers/hwmon/dme1737.c
>  
>  DMI/SMBIOS SUPPORT
> @@ -6006,7 +6006,7 @@ F71805F HARDWARE MONITORING DRIVER
>  M:	Jean Delvare <jdelvare@suse.com>
>  L:	linux-hwmon@vger.kernel.org
>  S:	Maintained
> -F:	Documentation/hwmon/f71805f
> +F:	Documentation/hwmon/f71805f.rst
>  F:	drivers/hwmon/f71805f.c
>  
>  FADDR2LINE
> @@ -7687,7 +7687,7 @@ INA209 HARDWARE MONITOR DRIVER
>  M:	Guenter Roeck <linux@roeck-us.net>
>  L:	linux-hwmon@vger.kernel.org
>  S:	Maintained
> -F:	Documentation/hwmon/ina209
> +F:	Documentation/hwmon/ina209.rst
>  F:	Documentation/devicetree/bindings/hwmon/ina2xx.txt
>  F:	drivers/hwmon/ina209.c
>  
> @@ -7695,7 +7695,7 @@ INA2XX HARDWARE MONITOR DRIVER
>  M:	Guenter Roeck <linux@roeck-us.net>
>  L:	linux-hwmon@vger.kernel.org
>  S:	Maintained
> -F:	Documentation/hwmon/ina2xx
> +F:	Documentation/hwmon/ina2xx.rst
>  F:	drivers/hwmon/ina2xx.c
>  F:	include/linux/platform_data/ina2xx.h
>  
> @@ -8328,7 +8328,7 @@ IT87 HARDWARE MONITORING DRIVER
>  M:	Jean Delvare <jdelvare@suse.com>
>  L:	linux-hwmon@vger.kernel.org
>  S:	Maintained
> -F:	Documentation/hwmon/it87
> +F:	Documentation/hwmon/it87.rst
>  F:	drivers/hwmon/it87.c
>  
>  IT913X MEDIA DRIVER
> @@ -8372,7 +8372,7 @@ M:	Guenter Roeck <linux@roeck-us.net>
>  L:	linux-hwmon@vger.kernel.org
>  S:	Maintained
>  F:	drivers/hwmon/jc42.c
> -F:	Documentation/hwmon/jc42
> +F:	Documentation/hwmon/jc42.rst
>  
>  JFS FILESYSTEM
>  M:	Dave Kleikamp <shaggy@kernel.org>
> @@ -8420,14 +8420,14 @@ K10TEMP HARDWARE MONITORING DRIVER
>  M:	Clemens Ladisch <clemens@ladisch.de>
>  L:	linux-hwmon@vger.kernel.org
>  S:	Maintained
> -F:	Documentation/hwmon/k10temp
> +F:	Documentation/hwmon/k10temp.rst
>  F:	drivers/hwmon/k10temp.c
>  
>  K8TEMP HARDWARE MONITORING DRIVER
>  M:	Rudolf Marek <r.marek@assembler.cz>
>  L:	linux-hwmon@vger.kernel.org
>  S:	Maintained
> -F:	Documentation/hwmon/k8temp
> +F:	Documentation/hwmon/k8temp.rst
>  F:	drivers/hwmon/k8temp.c
>  
>  KASAN
> @@ -9118,21 +9118,21 @@ LM78 HARDWARE MONITOR DRIVER
>  M:	Jean Delvare <jdelvare@suse.com>
>  L:	linux-hwmon@vger.kernel.org
>  S:	Maintained
> -F:	Documentation/hwmon/lm78
> +F:	Documentation/hwmon/lm78.rst
>  F:	drivers/hwmon/lm78.c
>  
>  LM83 HARDWARE MONITOR DRIVER
>  M:	Jean Delvare <jdelvare@suse.com>
>  L:	linux-hwmon@vger.kernel.org
>  S:	Maintained
> -F:	Documentation/hwmon/lm83
> +F:	Documentation/hwmon/lm83.rst
>  F:	drivers/hwmon/lm83.c
>  
>  LM90 HARDWARE MONITOR DRIVER
>  M:	Jean Delvare <jdelvare@suse.com>
>  L:	linux-hwmon@vger.kernel.org
>  S:	Maintained
> -F:	Documentation/hwmon/lm90
> +F:	Documentation/hwmon/lm90.rst
>  F:	Documentation/devicetree/bindings/hwmon/lm90.txt
>  F:	drivers/hwmon/lm90.c
>  F:	include/dt-bindings/thermal/lm90.h
> @@ -9141,7 +9141,7 @@ LM95234 HARDWARE MONITOR DRIVER
>  M:	Guenter Roeck <linux@roeck-us.net>
>  L:	linux-hwmon@vger.kernel.org
>  S:	Maintained
> -F:	Documentation/hwmon/lm95234
> +F:	Documentation/hwmon/lm95234.rst
>  F:	drivers/hwmon/lm95234.c
>  
>  LME2510 MEDIA DRIVER
> @@ -9214,7 +9214,7 @@ LTC4261 HARDWARE MONITOR DRIVER
>  M:	Guenter Roeck <linux@roeck-us.net>
>  L:	linux-hwmon@vger.kernel.org
>  S:	Maintained
> -F:	Documentation/hwmon/ltc4261
> +F:	Documentation/hwmon/ltc4261.rst
>  F:	drivers/hwmon/ltc4261.c
>  
>  LTC4306 I2C MULTIPLEXER DRIVER
> @@ -9445,7 +9445,7 @@ MAX16065 HARDWARE MONITOR DRIVER
>  M:	Guenter Roeck <linux@roeck-us.net>
>  L:	linux-hwmon@vger.kernel.org
>  S:	Maintained
> -F:	Documentation/hwmon/max16065
> +F:	Documentation/hwmon/max16065.rst
>  F:	drivers/hwmon/max16065.c
>  
>  MAX2175 SDR TUNER DRIVER
> @@ -9461,14 +9461,14 @@ F:	include/uapi/linux/max2175.h
>  MAX6650 HARDWARE MONITOR AND FAN CONTROLLER DRIVER
>  L:	linux-hwmon@vger.kernel.org
>  S:	Orphan
> -F:	Documentation/hwmon/max6650
> +F:	Documentation/hwmon/max6650.rst
>  F:	drivers/hwmon/max6650.c
>  
>  MAX6697 HARDWARE MONITOR DRIVER
>  M:	Guenter Roeck <linux@roeck-us.net>
>  L:	linux-hwmon@vger.kernel.org
>  S:	Maintained
> -F:	Documentation/hwmon/max6697
> +F:	Documentation/hwmon/max6697.rst
>  F:	Documentation/devicetree/bindings/hwmon/max6697.txt
>  F:	drivers/hwmon/max6697.c
>  F:	include/linux/platform_data/max6697.h
> @@ -10118,7 +10118,7 @@ F:	drivers/mfd/menf21bmc.c
>  F:	drivers/watchdog/menf21bmc_wdt.c
>  F:	drivers/leds/leds-menf21bmc.c
>  F:	drivers/hwmon/menf21bmc_hwmon.c
> -F:	Documentation/hwmon/menf21bmc
> +F:	Documentation/hwmon/menf21bmc.rst
>  
>  MEN Z069 WATCHDOG DRIVER
>  M:	Johannes Thumshirn <jth@kernel.org>
> @@ -10747,7 +10747,7 @@ NCT6775 HARDWARE MONITOR DRIVER
>  M:	Guenter Roeck <linux@roeck-us.net>
>  L:	linux-hwmon@vger.kernel.org
>  S:	Maintained
> -F:	Documentation/hwmon/nct6775
> +F:	Documentation/hwmon/nct6775.rst
>  F:	drivers/hwmon/nct6775.c
>  
>  NET_FAILOVER MODULE
> @@ -11841,7 +11841,7 @@ PC87360 HARDWARE MONITORING DRIVER
>  M:	Jim Cromie <jim.cromie@gmail.com>
>  L:	linux-hwmon@vger.kernel.org
>  S:	Maintained
> -F:	Documentation/hwmon/pc87360
> +F:	Documentation/hwmon/pc87360.rst
>  F:	drivers/hwmon/pc87360.c
>  
>  PC8736x GPIO DRIVER
> @@ -11853,7 +11853,7 @@ PC87427 HARDWARE MONITORING DRIVER
>  M:	Jean Delvare <jdelvare@suse.com>
>  L:	linux-hwmon@vger.kernel.org
>  S:	Maintained
> -F:	Documentation/hwmon/pc87427
> +F:	Documentation/hwmon/pc87427.rst
>  F:	drivers/hwmon/pc87427.c
>  
>  PCA9532 LED DRIVER
> @@ -12421,23 +12421,23 @@ S:	Maintained
>  F:	Documentation/devicetree/bindings/hwmon/ibm,cffps1.txt
>  F:	Documentation/devicetree/bindings/hwmon/max31785.txt
>  F:	Documentation/devicetree/bindings/hwmon/ltc2978.txt
> -F:	Documentation/hwmon/adm1275
> -F:	Documentation/hwmon/ibm-cffps
> -F:	Documentation/hwmon/ir35221
> -F:	Documentation/hwmon/lm25066
> -F:	Documentation/hwmon/ltc2978
> -F:	Documentation/hwmon/ltc3815
> -F:	Documentation/hwmon/max16064
> -F:	Documentation/hwmon/max20751
> -F:	Documentation/hwmon/max31785
> -F:	Documentation/hwmon/max34440
> -F:	Documentation/hwmon/max8688
> -F:	Documentation/hwmon/pmbus
> -F:	Documentation/hwmon/pmbus-core
> -F:	Documentation/hwmon/tps40422
> -F:	Documentation/hwmon/ucd9000
> -F:	Documentation/hwmon/ucd9200
> -F:	Documentation/hwmon/zl6100
> +F:	Documentation/hwmon/adm1275.rst
> +F:	Documentation/hwmon/ibm-cffps.rst
> +F:	Documentation/hwmon/ir35221.rst
> +F:	Documentation/hwmon/lm25066.rst
> +F:	Documentation/hwmon/ltc2978.rst
> +F:	Documentation/hwmon/ltc3815.rst
> +F:	Documentation/hwmon/max16064.rst
> +F:	Documentation/hwmon/max20751.rst
> +F:	Documentation/hwmon/max31785.rst
> +F:	Documentation/hwmon/max34440.rst
> +F:	Documentation/hwmon/max8688.rst
> +F:	Documentation/hwmon/pmbus.rst
> +F:	Documentation/hwmon/pmbus-core.rst
> +F:	Documentation/hwmon/tps40422.rst
> +F:	Documentation/hwmon/ucd9000.rst
> +F:	Documentation/hwmon/ucd9200.rst
> +F:	Documentation/hwmon/zl6100.rst
>  F:	drivers/hwmon/pmbus/
>  F:	include/linux/pmbus.h
>  
> @@ -12701,7 +12701,7 @@ M:	Bartlomiej Zolnierkiewicz <b.zolnierkie@samsung.com>
>  L:	linux-hwmon@vger.kernel.org
>  S:	Supported
>  F:	Documentation/devicetree/bindings/hwmon/pwm-fan.txt
> -F:	Documentation/hwmon/pwm-fan
> +F:	Documentation/hwmon/pwm-fan.rst
>  F:	drivers/hwmon/pwm-fan.c
>  
>  PWM IR Transmitter
> @@ -14366,21 +14366,21 @@ SMM665 HARDWARE MONITOR DRIVER
>  M:	Guenter Roeck <linux@roeck-us.net>
>  L:	linux-hwmon@vger.kernel.org
>  S:	Maintained
> -F:	Documentation/hwmon/smm665
> +F:	Documentation/hwmon/smm665.rst
>  F:	drivers/hwmon/smm665.c
>  
>  SMSC EMC2103 HARDWARE MONITOR DRIVER
>  M:	Steve Glendinning <steve.glendinning@shawell.net>
>  L:	linux-hwmon@vger.kernel.org
>  S:	Maintained
> -F:	Documentation/hwmon/emc2103
> +F:	Documentation/hwmon/emc2103.rst
>  F:	drivers/hwmon/emc2103.c
>  
>  SMSC SCH5627 HARDWARE MONITOR DRIVER
>  M:	Hans de Goede <hdegoede@redhat.com>
>  L:	linux-hwmon@vger.kernel.org
>  S:	Supported
> -F:	Documentation/hwmon/sch5627
> +F:	Documentation/hwmon/sch5627.rst
>  F:	drivers/hwmon/sch5627.c
>  
>  SMSC UFX6000 and UFX7000 USB to VGA DRIVER
> @@ -14393,7 +14393,7 @@ SMSC47B397 HARDWARE MONITOR DRIVER
>  M:	Jean Delvare <jdelvare@suse.com>
>  L:	linux-hwmon@vger.kernel.org
>  S:	Maintained
> -F:	Documentation/hwmon/smsc47b397
> +F:	Documentation/hwmon/smsc47b397.rst
>  F:	drivers/hwmon/smsc47b397.c
>  
>  SMSC911x ETHERNET DRIVER
> @@ -15744,7 +15744,7 @@ TMP401 HARDWARE MONITOR DRIVER
>  M:	Guenter Roeck <linux@roeck-us.net>
>  L:	linux-hwmon@vger.kernel.org
>  S:	Maintained
> -F:	Documentation/hwmon/tmp401
> +F:	Documentation/hwmon/tmp401.rst
>  F:	drivers/hwmon/tmp401.c
>  
>  TMPFS (SHMEM FILESYSTEM)
> @@ -16796,7 +16796,7 @@ VT1211 HARDWARE MONITOR DRIVER
>  M:	Juerg Haefliger <juergh@gmail.com>
>  L:	linux-hwmon@vger.kernel.org
>  S:	Maintained
> -F:	Documentation/hwmon/vt1211
> +F:	Documentation/hwmon/vt1211.rst
>  F:	drivers/hwmon/vt1211.c
>  
>  VT8231 HARDWARE MONITOR DRIVER
> @@ -16824,14 +16824,14 @@ W83791D HARDWARE MONITORING DRIVER
>  M:	Marc Hulsman <m.hulsman@tudelft.nl>
>  L:	linux-hwmon@vger.kernel.org
>  S:	Maintained
> -F:	Documentation/hwmon/w83791d
> +F:	Documentation/hwmon/w83791d.rst
>  F:	drivers/hwmon/w83791d.c
>  
>  W83793 HARDWARE MONITORING DRIVER
>  M:	Rudolf Marek <r.marek@assembler.cz>
>  L:	linux-hwmon@vger.kernel.org
>  S:	Maintained
> -F:	Documentation/hwmon/w83793
> +F:	Documentation/hwmon/w83793.rst
>  F:	drivers/hwmon/w83793.c
>  
>  W83795 HARDWARE MONITORING DRIVER
> @@ -16940,7 +16940,7 @@ L:	patches@opensource.cirrus.com
>  T:	git https://github.com/CirrusLogic/linux-drivers.git
>  W:	https://github.com/CirrusLogic/linux-drivers/wiki
>  S:	Supported
> -F:	Documentation/hwmon/wm83??
> +F:	Documentation/hwmon/wm83??.rst
>  F:	Documentation/devicetree/bindings/extcon/extcon-arizona.txt
>  F:	Documentation/devicetree/bindings/regulator/arizona-regulator.txt
>  F:	Documentation/devicetree/bindings/mfd/arizona.txt
> diff --git a/drivers/hwmon/Kconfig b/drivers/hwmon/Kconfig
> index dedd5febd3aa..470ba66b18b0 100644
> --- a/drivers/hwmon/Kconfig
> +++ b/drivers/hwmon/Kconfig
> @@ -17,7 +17,7 @@ menuconfig HWMON
>  
>  	  To find out which specific driver(s) you need, use the
>  	  sensors-detect script from the lm_sensors package.  Read
> -	  <file:Documentation/hwmon/userspace-tools> for details.
> +	  <file:Documentation/hwmon/userspace-tools.rst> for details.
>  
>  	  This support can also be built as a module. If so, the module
>  	  will be called hwmon.
> @@ -59,7 +59,7 @@ config SENSORS_ABITUGURU
>  	  chip can be found on Abit uGuru featuring motherboards (most modern
>  	  Abit motherboards from before end 2005). For more info and a list
>  	  of which motherboards have which revision see
> -	  Documentation/hwmon/abituguru
> +	  Documentation/hwmon/abituguru.rst
>  
>  	  This driver can also be built as a module. If so, the module
>  	  will be called abituguru.
> @@ -73,7 +73,7 @@ config SENSORS_ABITUGURU3
>  	  and their settings is supported. The third revision of the Abit
>  	  uGuru chip can be found on recent Abit motherboards (since end
>  	  2005). For more info and a list of which motherboards have which
> -	  revision see Documentation/hwmon/abituguru3
> +	  revision see Documentation/hwmon/abituguru3.rst
>  
>  	  This driver can also be built as a module. If so, the module
>  	  will be called abituguru3.
> @@ -643,7 +643,7 @@ config SENSORS_CORETEMP
>  	help
>  	  If you say yes here you get support for the temperature
>  	  sensor inside your CPU. Most of the family 6 CPUs
> -	  are supported. Check Documentation/hwmon/coretemp for details.
> +	  are supported. Check Documentation/hwmon/coretemp.rst for details.
>  
>  config SENSORS_IT87
>  	tristate "ITE IT87xx and compatibles"
> diff --git a/drivers/hwmon/ads7828.c b/drivers/hwmon/ads7828.c
> index e6be617e3fb2..03d6e782777a 100644
> --- a/drivers/hwmon/ads7828.c
> +++ b/drivers/hwmon/ads7828.c
> @@ -8,7 +8,7 @@
>   *
>   * ADS7830 support, by Guillaume Roguez <guillaume.roguez@savoirfairelinux.com>
>   *
> - * For further information, see the Documentation/hwmon/ads7828 file.
> + * For further information, see the Documentation/hwmon/ads7828.rst file.
>   *
>   * This program is free software; you can redistribute it and/or modify
>   * it under the terms of the GNU General Public License as published by
> diff --git a/drivers/hwmon/max197.c b/drivers/hwmon/max197.c
> index 3d9e210beedf..dd6a35219a18 100644
> --- a/drivers/hwmon/max197.c
> +++ b/drivers/hwmon/max197.c
> @@ -8,7 +8,7 @@
>   * it under the terms of the GNU General Public License version 2 as
>   * published by the Free Software Foundation.
>   *
> - * For further information, see the Documentation/hwmon/max197 file.
> + * For further information, see the Documentation/hwmon/max197.rst file.
>   */
>  
>  #include <linux/kernel.h>
> diff --git a/drivers/hwmon/sht15.c b/drivers/hwmon/sht15.c
> index 39b41e35c2bf..7f4a63959730 100644
> --- a/drivers/hwmon/sht15.c
> +++ b/drivers/hwmon/sht15.c
> @@ -10,7 +10,7 @@
>   *
>   * Copyright (c) 2007 Wouter Horre
>   *
> - * For further information, see the Documentation/hwmon/sht15 file.
> + * For further information, see the Documentation/hwmon/sht15.rst file.
>   */
>  
>  #include <linux/interrupt.h>
> diff --git a/include/linux/platform_data/ads7828.h b/include/linux/platform_data/ads7828.h
> index 3245f45f9d77..a3370a007702 100644
> --- a/include/linux/platform_data/ads7828.h
> +++ b/include/linux/platform_data/ads7828.h
> @@ -4,7 +4,7 @@
>   * Copyright (c) 2012 Savoir-faire Linux Inc.
>   *          Vivien Didelot <vivien.didelot@savoirfairelinux.com>
>   *
> - * For further information, see the Documentation/hwmon/ads7828 file.
> + * For further information, see the Documentation/hwmon/ads7828.rst file.
>   *
>   * This program is free software; you can redistribute it and/or modify
>   * it under the terms of the GNU General Public License version 2 as
> diff --git a/include/linux/platform_data/ds620.h b/include/linux/platform_data/ds620.h
> index 6ef58bb77e46..f0ce22a78bb8 100644
> --- a/include/linux/platform_data/ds620.h
> +++ b/include/linux/platform_data/ds620.h
> @@ -14,7 +14,7 @@ struct ds620_platform_data {
>  	 *  1 = PO_LOW
>  	 *  2 = PO_HIGH
>  	 *
> -	 * (see Documentation/hwmon/ds620)
> +	 * (see Documentation/hwmon/ds620.rst)
>  	 */
>  	int pomode;
>  };
> diff --git a/include/linux/platform_data/ina2xx.h b/include/linux/platform_data/ina2xx.h
> index 9f0aa1b48c78..dde59fd3590f 100644
> --- a/include/linux/platform_data/ina2xx.h
> +++ b/include/linux/platform_data/ina2xx.h
> @@ -7,7 +7,7 @@
>   * it under the terms of the GNU General Public License version 2 as
>   * published by the Free Software Foundation.
>   *
> - * For further information, see the Documentation/hwmon/ina2xx file.
> + * For further information, see the Documentation/hwmon/ina2xx.rst file.
>   */
>  
>  /**
> diff --git a/include/linux/platform_data/max197.h b/include/linux/platform_data/max197.h
> index 8da8f94ee15c..2bbd0919bc89 100644
> --- a/include/linux/platform_data/max197.h
> +++ b/include/linux/platform_data/max197.h
> @@ -8,7 +8,7 @@
>   * it under the terms of the GNU General Public License version 2 as
>   * published by the Free Software Foundation.
>   *
> - * For further information, see the Documentation/hwmon/max197 file.
> + * For further information, see the Documentation/hwmon/max197.rst file.
>   */
>  
>  #ifndef _PDATA_MAX197_H
> diff --git a/include/linux/platform_data/ntc_thermistor.h b/include/linux/platform_data/ntc_thermistor.h
> index ee03d429742b..5fa115d3ea4b 100644
> --- a/include/linux/platform_data/ntc_thermistor.h
> +++ b/include/linux/platform_data/ntc_thermistor.h
> @@ -42,7 +42,7 @@ struct ntc_thermistor_platform_data {
>  	 * read_uV()
>  	 *
>  	 * How to setup pullup_ohm, pulldown_ohm, and connect is
> -	 * described at Documentation/hwmon/ntc_thermistor
> +	 * described at Documentation/hwmon/ntc_thermistor.rst
>  	 *
>  	 * pullup/down_ohm: 0 for infinite / not-connected
>  	 *

^ permalink raw reply	[flat|nested] 73+ messages in thread

* Re: [PATCH v3 21/21] docs: hwmon: Add an index file and rename docs to *.rst
  2019-04-17 16:47                       ` Guenter Roeck
@ 2019-04-17 16:54                         ` Guenter Roeck
  2019-04-17 17:13                         ` Mauro Carvalho Chehab
  1 sibling, 0 replies; 73+ messages in thread
From: Guenter Roeck @ 2019-04-17 16:54 UTC (permalink / raw)
  To: Mauro Carvalho Chehab
  Cc: Linux Doc Mailing List, Mauro Carvalho Chehab, linux-kernel,
	Jonathan Corbet, Jean Delvare, Rob Herring, Mark Rutland,
	Dirk Eibach, George Joseph, Joel Stanley, Andrew Jeffery,
	Fenghua Yu, Support Opensource, Juerg Haefliger,
	Steve Glendinning, Huang Rui, Benjamin Herrenschmidt,
	Paul Mackerras, Michael Ellerman, Clemens Ladisch, Rudolf Marek,
	Andreas Werner, Jim Cromie, Kamil Debski,
	Bartlomiej Zolnierkiewicz, Hans de Goede, Liviu Dudau,
	Sudeep Holla, Lorenzo Pieralisi, Marc Hulsman, linux-hwmon,
	devicetree, linux-arm-kernel, linux-aspeed, linuxppc-dev,
	patches

On Wed, Apr 17, 2019 at 09:47:41AM -0700, Guenter Roeck wrote:
> On Wed, Apr 17, 2019 at 06:46:29AM -0300, Mauro Carvalho Chehab wrote:
> > Now that all files were converted to ReST format, rename them
> > and add an index.
> > 
> > Signed-off-by: Mauro Carvalho Chehab <mchehab+samsung@kernel.org>
> > Acked-by: Liviu Dudau <liviu.dudau@arm.com>
> 
> I applied all patches except this one, which fails due to a conflict in
> ab8500. I also notice that this file has not been touched by your series,
> which is odd. At the same time, patch 20/21 is missing from your series,
> and has been missing all along. Does the missing patch possibly touch
> Documentation/hwmon/ab8500 ?
> 
Actually, the conflicts are in those files:

patching file Documentation/hwmon/amc6821.rst (renamed from Documentation/hwmon/amc6821)
Hunk #1 FAILED at 106.
1 out of 1 hunk FAILED -- saving rejects to file Documentation/hwmon/amc6821.rst.rej
patching file Documentation/hwmon/asb100.rst (renamed from Documentation/hwmon/asb100)
Hunk #1 FAILED at 71.
1 out of 1 hunk FAILED -- saving rejects to file Documentation/hwmon/asb100.rst.rej

Both were not touched by your series.

Guenter

> Thanks,
> Guenter
> 
> > ---
> >  .../devicetree/bindings/hwmon/g762.txt        |   2 +-
> >  Documentation/hwmon/{ab8500 => ab8500.rst}    |   2 +-
> >  ...guru-datasheet => abituguru-datasheet.rst} |   0
> >  .../hwmon/{abituguru => abituguru.rst}        |   0
> >  .../hwmon/{abituguru3 => abituguru3.rst}      |   0
> >  Documentation/hwmon/{abx500 => abx500.rst}    |   0
> >  ...{acpi_power_meter => acpi_power_meter.rst} |   2 +-
> >  Documentation/hwmon/{ad7314 => ad7314.rst}    |   0
> >  .../hwmon/{adc128d818 => adc128d818.rst}      |   0
> >  Documentation/hwmon/{adm1021 => adm1021.rst}  |   0
> >  Documentation/hwmon/{adm1025 => adm1025.rst}  |   0
> >  Documentation/hwmon/{adm1026 => adm1026.rst}  |   0
> >  Documentation/hwmon/{adm1031 => adm1031.rst}  |   0
> >  Documentation/hwmon/{adm1275 => adm1275.rst}  |   4 +-
> >  Documentation/hwmon/{adm9240 => adm9240.rst}  |   0
> >  Documentation/hwmon/{ads1015 => ads1015.rst}  |   0
> >  Documentation/hwmon/{ads7828 => ads7828.rst}  |   0
> >  Documentation/hwmon/{adt7410 => adt7410.rst}  |   0
> >  Documentation/hwmon/{adt7411 => adt7411.rst}  |   0
> >  Documentation/hwmon/{adt7462 => adt7462.rst}  |   1 -
> >  Documentation/hwmon/{adt7470 => adt7470.rst}  |   0
> >  Documentation/hwmon/{adt7475 => adt7475.rst}  |   0
> >  Documentation/hwmon/{amc6821 => amc6821.rst}  |   1 -
> >  Documentation/hwmon/{asb100 => asb100.rst}    |   1 -
> >  Documentation/hwmon/{asc7621 => asc7621.rst}  |   0
> >  ...{aspeed-pwm-tacho => aspeed-pwm-tacho.rst} |   0
> >  .../hwmon/{coretemp => coretemp.rst}          |   0
> >  Documentation/hwmon/{da9052 => da9052.rst}    |   0
> >  Documentation/hwmon/{da9055 => da9055.rst}    |   0
> >  Documentation/hwmon/{dme1737 => dme1737.rst}  |   0
> >  Documentation/hwmon/{ds1621 => ds1621.rst}    |   0
> >  Documentation/hwmon/{ds620 => ds620.rst}      |   0
> >  Documentation/hwmon/{emc1403 => emc1403.rst}  |   0
> >  Documentation/hwmon/{emc2103 => emc2103.rst}  |   0
> >  .../hwmon/{emc6w201 => emc6w201.rst}          |   0
> >  Documentation/hwmon/{f71805f => f71805f.rst}  |   0
> >  .../hwmon/{f71882fg => f71882fg.rst}          |   0
> >  .../hwmon/{fam15h_power => fam15h_power.rst}  |   0
> >  .../hwmon/{ftsteutates => ftsteutates.rst}    |   0
> >  Documentation/hwmon/{g760a => g760a.rst}      |   0
> >  Documentation/hwmon/{g762 => g762.rst}        |   2 +-
> >  Documentation/hwmon/{gl518sm => gl518sm.rst}  |   0
> >  Documentation/hwmon/{hih6130 => hih6130.rst}  |   0
> >  ...on-kernel-api.txt => hwmon-kernel-api.rst} |   4 +-
> >  .../hwmon/{ibm-cffps => ibm-cffps.rst}        |   0
> >  Documentation/hwmon/{ibmaem => ibmaem.rst}    |   0
> >  .../hwmon/{ibmpowernv => ibmpowernv.rst}      |   0
> >  Documentation/hwmon/{ina209 => ina209.rst}    |   0
> >  Documentation/hwmon/{ina2xx => ina2xx.rst}    |   2 +-
> >  Documentation/hwmon/{ina3221 => ina3221.rst}  |   0
> >  Documentation/hwmon/index.rst                 | 179 ++++++++++++++++++
> >  Documentation/hwmon/{ir35221 => ir35221.rst}  |   0
> >  Documentation/hwmon/{it87 => it87.rst}        |   0
> >  Documentation/hwmon/{jc42 => jc42.rst}        |   0
> >  Documentation/hwmon/{k10temp => k10temp.rst}  |   0
> >  Documentation/hwmon/{k8temp => k8temp.rst}    |   0
> >  .../hwmon/{lineage-pem => lineage-pem.rst}    |   0
> >  Documentation/hwmon/{lm25066 => lm25066.rst}  |   2 +-
> >  Documentation/hwmon/{lm63 => lm63.rst}        |   0
> >  Documentation/hwmon/{lm70 => lm70.rst}        |   0
> >  Documentation/hwmon/{lm73 => lm73.rst}        |   0
> >  Documentation/hwmon/{lm75 => lm75.rst}        |   0
> >  Documentation/hwmon/{lm77 => lm77.rst}        |   0
> >  Documentation/hwmon/{lm78 => lm78.rst}        |   0
> >  Documentation/hwmon/{lm80 => lm80.rst}        |   0
> >  Documentation/hwmon/{lm83 => lm83.rst}        |   0
> >  Documentation/hwmon/{lm85 => lm85.rst}        |   0
> >  Documentation/hwmon/{lm87 => lm87.rst}        |   0
> >  Documentation/hwmon/{lm90 => lm90.rst}        |   0
> >  Documentation/hwmon/{lm92 => lm92.rst}        |   0
> >  Documentation/hwmon/{lm93 => lm93.rst}        |   0
> >  Documentation/hwmon/{lm95234 => lm95234.rst}  |   0
> >  Documentation/hwmon/{lm95245 => lm95245.rst}  |   0
> >  Documentation/hwmon/{ltc2945 => ltc2945.rst}  |   0
> >  Documentation/hwmon/{ltc2978 => ltc2978.rst}  |   0
> >  Documentation/hwmon/{ltc2990 => ltc2990.rst}  |   0
> >  Documentation/hwmon/{ltc3815 => ltc3815.rst}  |   0
> >  Documentation/hwmon/{ltc4151 => ltc4151.rst}  |   0
> >  Documentation/hwmon/{ltc4215 => ltc4215.rst}  |   0
> >  Documentation/hwmon/{ltc4245 => ltc4245.rst}  |   0
> >  Documentation/hwmon/{ltc4260 => ltc4260.rst}  |   0
> >  Documentation/hwmon/{ltc4261 => ltc4261.rst}  |   0
> >  .../hwmon/{max16064 => max16064.rst}          |   2 +-
> >  .../hwmon/{max16065 => max16065.rst}          |   0
> >  Documentation/hwmon/{max1619 => max1619.rst}  |   1 -
> >  Documentation/hwmon/{max1668 => max1668.rst}  |   0
> >  Documentation/hwmon/{max197 => max197.rst}    |   0
> >  .../hwmon/{max20751 => max20751.rst}          |   2 +-
> >  .../hwmon/{max31722 => max31722.rst}          |   0
> >  .../hwmon/{max31785 => max31785.rst}          |   0
> >  .../hwmon/{max31790 => max31790.rst}          |   0
> >  .../hwmon/{max34440 => max34440.rst}          |   2 +-
> >  Documentation/hwmon/{max6639 => max6639.rst}  |   0
> >  Documentation/hwmon/{max6642 => max6642.rst}  |   0
> >  Documentation/hwmon/{max6650 => max6650.rst}  |   1 -
> >  Documentation/hwmon/{max6697 => max6697.rst}  |   0
> >  Documentation/hwmon/{max8688 => max8688.rst}  |   2 +-
> >  .../hwmon/{mc13783-adc => mc13783-adc.rst}    |   0
> >  Documentation/hwmon/{mcp3021 => mcp3021.rst}  |   0
> >  .../hwmon/{menf21bmc => menf21bmc.rst}        |   0
> >  .../hwmon/{mlxreg-fan => mlxreg-fan.rst}      |   0
> >  Documentation/hwmon/{nct6683 => nct6683.rst}  |   0
> >  Documentation/hwmon/{nct6775 => nct6775.rst}  |   0
> >  Documentation/hwmon/{nct7802 => nct7802.rst}  |   0
> >  Documentation/hwmon/{nct7904 => nct7904.rst}  |   0
> >  .../{npcm750-pwm-fan => npcm750-pwm-fan.rst}  |   0
> >  Documentation/hwmon/{nsa320 => nsa320.rst}    |   0
> >  .../{ntc_thermistor => ntc_thermistor.rst}    |   0
> >  Documentation/hwmon/{occ => occ.rst}          |   0
> >  Documentation/hwmon/{pc87360 => pc87360.rst}  |   0
> >  Documentation/hwmon/{pc87427 => pc87427.rst}  |   0
> >  Documentation/hwmon/{pcf8591 => pcf8591.rst}  |   0
> >  .../hwmon/{pmbus-core => pmbus-core.rst}      |   0
> >  Documentation/hwmon/{pmbus => pmbus.rst}      |   0
> >  .../hwmon/{powr1220 => powr1220.rst}          |   0
> >  Documentation/hwmon/{pwm-fan => pwm-fan.rst}  |   0
> >  ...aspberrypi-hwmon => raspberrypi-hwmon.rst} |   0
> >  Documentation/hwmon/{sch5627 => sch5627.rst}  |   0
> >  Documentation/hwmon/{sch5636 => sch5636.rst}  |   0
> >  .../hwmon/{scpi-hwmon => scpi-hwmon.rst}      |   0
> >  Documentation/hwmon/{sht15 => sht15.rst}      |   0
> >  Documentation/hwmon/{sht21 => sht21.rst}      |   0
> >  Documentation/hwmon/{sht3x => sht3x.rst}      |   0
> >  Documentation/hwmon/{shtc1 => shtc1.rst}      |   0
> >  Documentation/hwmon/{sis5595 => sis5595.rst}  |   1 -
> >  Documentation/hwmon/{smm665 => smm665.rst}    |   0
> >  .../hwmon/{smsc47b397 => smsc47b397.rst}      |   0
> >  .../hwmon/{smsc47m1 => smsc47m1.rst}          |   0
> >  .../hwmon/{smsc47m192 => smsc47m192.rst}      |   0
> >  ...mitting-patches => submitting-patches.rst} |   6 +-
> >  .../{sysfs-interface => sysfs-interface.rst}  |   0
> >  Documentation/hwmon/{tc654 => tc654.rst}      |   0
> >  Documentation/hwmon/{tc74 => tc74.rst}        |   0
> >  Documentation/hwmon/{thmc50 => thmc50.rst}    |   1 -
> >  Documentation/hwmon/{tmp102 => tmp102.rst}    |   2 +-
> >  Documentation/hwmon/{tmp103 => tmp103.rst}    |   2 +-
> >  Documentation/hwmon/{tmp108 => tmp108.rst}    |   2 +-
> >  Documentation/hwmon/{tmp401 => tmp401.rst}    |   2 +-
> >  Documentation/hwmon/{tmp421 => tmp421.rst}    |   0
> >  .../hwmon/{tps40422 => tps40422.rst}          |   2 +-
> >  ...4030-madc-hwmon => twl4030-madc-hwmon.rst} |   0
> >  Documentation/hwmon/{ucd9000 => ucd9000.rst}  |   4 +-
> >  Documentation/hwmon/{ucd9200 => ucd9200.rst}  |   4 +-
> >  .../{userspace-tools => userspace-tools.rst}  |   0
> >  .../hwmon/{vexpress => vexpress.rst}          |   0
> >  Documentation/hwmon/{via686a => via686a.rst}  |   0
> >  Documentation/hwmon/{vt1211 => vt1211.rst}    |   0
> >  .../hwmon/{w83627ehf => w83627ehf.rst}        |   0
> >  .../hwmon/{w83627hf => w83627hf.rst}          |   0
> >  Documentation/hwmon/{w83773g => w83773g.rst}  |   0
> >  Documentation/hwmon/{w83781d => w83781d.rst}  |   0
> >  Documentation/hwmon/{w83791d => w83791d.rst}  |   2 +-
> >  Documentation/hwmon/{w83792d => w83792d.rst}  |   0
> >  Documentation/hwmon/{w83793 => w83793.rst}    |   0
> >  Documentation/hwmon/{w83795 => w83795.rst}    |   0
> >  .../hwmon/{w83l785ts => w83l785ts.rst}        |   0
> >  .../hwmon/{w83l786ng => w83l786ng.rst}        |   0
> >  Documentation/hwmon/{wm831x => wm831x.rst}    |   0
> >  Documentation/hwmon/{wm8350 => wm8350.rst}    |   0
> >  .../hwmon/{xgene-hwmon => xgene-hwmon.rst}    |   0
> >  Documentation/hwmon/{zl6100 => zl6100.rst}    |   2 +-
> >  Documentation/index.rst                       |   1 +
> >  Documentation/thermal/sysfs-api.txt           |   2 +-
> >  MAINTAINERS                                   | 108 +++++------
> >  drivers/hwmon/Kconfig                         |   8 +-
> >  drivers/hwmon/ads7828.c                       |   2 +-
> >  drivers/hwmon/max197.c                        |   2 +-
> >  drivers/hwmon/sht15.c                         |   2 +-
> >  include/linux/platform_data/ads7828.h         |   2 +-
> >  include/linux/platform_data/ds620.h           |   2 +-
> >  include/linux/platform_data/ina2xx.h          |   2 +-
> >  include/linux/platform_data/max197.h          |   2 +-
> >  include/linux/platform_data/ntc_thermistor.h  |   2 +-
> >  173 files changed, 275 insertions(+), 102 deletions(-)
> >  rename Documentation/hwmon/{ab8500 => ab8500.rst} (86%)
> >  rename Documentation/hwmon/{abituguru-datasheet => abituguru-datasheet.rst} (100%)
> >  rename Documentation/hwmon/{abituguru => abituguru.rst} (100%)
> >  rename Documentation/hwmon/{abituguru3 => abituguru3.rst} (100%)
> >  rename Documentation/hwmon/{abx500 => abx500.rst} (100%)
> >  rename Documentation/hwmon/{acpi_power_meter => acpi_power_meter.rst} (97%)
> >  rename Documentation/hwmon/{ad7314 => ad7314.rst} (100%)
> >  rename Documentation/hwmon/{adc128d818 => adc128d818.rst} (100%)
> >  rename Documentation/hwmon/{adm1021 => adm1021.rst} (100%)
> >  rename Documentation/hwmon/{adm1025 => adm1025.rst} (100%)
> >  rename Documentation/hwmon/{adm1026 => adm1026.rst} (100%)
> >  rename Documentation/hwmon/{adm1031 => adm1031.rst} (100%)
> >  rename Documentation/hwmon/{adm1275 => adm1275.rst} (97%)
> >  rename Documentation/hwmon/{adm9240 => adm9240.rst} (100%)
> >  rename Documentation/hwmon/{ads1015 => ads1015.rst} (100%)
> >  rename Documentation/hwmon/{ads7828 => ads7828.rst} (100%)
> >  rename Documentation/hwmon/{adt7410 => adt7410.rst} (100%)
> >  rename Documentation/hwmon/{adt7411 => adt7411.rst} (100%)
> >  rename Documentation/hwmon/{adt7462 => adt7462.rst} (99%)
> >  rename Documentation/hwmon/{adt7470 => adt7470.rst} (100%)
> >  rename Documentation/hwmon/{adt7475 => adt7475.rst} (100%)
> >  rename Documentation/hwmon/{amc6821 => amc6821.rst} (99%)
> >  rename Documentation/hwmon/{asb100 => asb100.rst} (99%)
> >  rename Documentation/hwmon/{asc7621 => asc7621.rst} (100%)
> >  rename Documentation/hwmon/{aspeed-pwm-tacho => aspeed-pwm-tacho.rst} (100%)
> >  rename Documentation/hwmon/{coretemp => coretemp.rst} (100%)
> >  rename Documentation/hwmon/{da9052 => da9052.rst} (100%)
> >  rename Documentation/hwmon/{da9055 => da9055.rst} (100%)
> >  rename Documentation/hwmon/{dme1737 => dme1737.rst} (100%)
> >  rename Documentation/hwmon/{ds1621 => ds1621.rst} (100%)
> >  rename Documentation/hwmon/{ds620 => ds620.rst} (100%)
> >  rename Documentation/hwmon/{emc1403 => emc1403.rst} (100%)
> >  rename Documentation/hwmon/{emc2103 => emc2103.rst} (100%)
> >  rename Documentation/hwmon/{emc6w201 => emc6w201.rst} (100%)
> >  rename Documentation/hwmon/{f71805f => f71805f.rst} (100%)
> >  rename Documentation/hwmon/{f71882fg => f71882fg.rst} (100%)
> >  rename Documentation/hwmon/{fam15h_power => fam15h_power.rst} (100%)
> >  rename Documentation/hwmon/{ftsteutates => ftsteutates.rst} (100%)
> >  rename Documentation/hwmon/{g760a => g760a.rst} (100%)
> >  rename Documentation/hwmon/{g762 => g762.rst} (97%)
> >  rename Documentation/hwmon/{gl518sm => gl518sm.rst} (100%)
> >  rename Documentation/hwmon/{hih6130 => hih6130.rst} (100%)
> >  rename Documentation/hwmon/{hwmon-kernel-api.txt => hwmon-kernel-api.rst} (99%)
> >  rename Documentation/hwmon/{ibm-cffps => ibm-cffps.rst} (100%)
> >  rename Documentation/hwmon/{ibmaem => ibmaem.rst} (100%)
> >  rename Documentation/hwmon/{ibmpowernv => ibmpowernv.rst} (100%)
> >  rename Documentation/hwmon/{ina209 => ina209.rst} (100%)
> >  rename Documentation/hwmon/{ina2xx => ina2xx.rst} (97%)
> >  rename Documentation/hwmon/{ina3221 => ina3221.rst} (100%)
> >  create mode 100644 Documentation/hwmon/index.rst
> >  rename Documentation/hwmon/{ir35221 => ir35221.rst} (100%)
> >  rename Documentation/hwmon/{it87 => it87.rst} (100%)
> >  rename Documentation/hwmon/{jc42 => jc42.rst} (100%)
> >  rename Documentation/hwmon/{k10temp => k10temp.rst} (100%)
> >  rename Documentation/hwmon/{k8temp => k8temp.rst} (100%)
> >  rename Documentation/hwmon/{lineage-pem => lineage-pem.rst} (100%)
> >  rename Documentation/hwmon/{lm25066 => lm25066.rst} (97%)
> >  rename Documentation/hwmon/{lm63 => lm63.rst} (100%)
> >  rename Documentation/hwmon/{lm70 => lm70.rst} (100%)
> >  rename Documentation/hwmon/{lm73 => lm73.rst} (100%)
> >  rename Documentation/hwmon/{lm75 => lm75.rst} (100%)
> >  rename Documentation/hwmon/{lm77 => lm77.rst} (100%)
> >  rename Documentation/hwmon/{lm78 => lm78.rst} (100%)
> >  rename Documentation/hwmon/{lm80 => lm80.rst} (100%)
> >  rename Documentation/hwmon/{lm83 => lm83.rst} (100%)
> >  rename Documentation/hwmon/{lm85 => lm85.rst} (100%)
> >  rename Documentation/hwmon/{lm87 => lm87.rst} (100%)
> >  rename Documentation/hwmon/{lm90 => lm90.rst} (100%)
> >  rename Documentation/hwmon/{lm92 => lm92.rst} (100%)
> >  rename Documentation/hwmon/{lm93 => lm93.rst} (100%)
> >  rename Documentation/hwmon/{lm95234 => lm95234.rst} (100%)
> >  rename Documentation/hwmon/{lm95245 => lm95245.rst} (100%)
> >  rename Documentation/hwmon/{ltc2945 => ltc2945.rst} (100%)
> >  rename Documentation/hwmon/{ltc2978 => ltc2978.rst} (100%)
> >  rename Documentation/hwmon/{ltc2990 => ltc2990.rst} (100%)
> >  rename Documentation/hwmon/{ltc3815 => ltc3815.rst} (100%)
> >  rename Documentation/hwmon/{ltc4151 => ltc4151.rst} (100%)
> >  rename Documentation/hwmon/{ltc4215 => ltc4215.rst} (100%)
> >  rename Documentation/hwmon/{ltc4245 => ltc4245.rst} (100%)
> >  rename Documentation/hwmon/{ltc4260 => ltc4260.rst} (100%)
> >  rename Documentation/hwmon/{ltc4261 => ltc4261.rst} (100%)
> >  rename Documentation/hwmon/{max16064 => max16064.rst} (96%)
> >  rename Documentation/hwmon/{max16065 => max16065.rst} (100%)
> >  rename Documentation/hwmon/{max1619 => max1619.rst} (99%)
> >  rename Documentation/hwmon/{max1668 => max1668.rst} (100%)
> >  rename Documentation/hwmon/{max197 => max197.rst} (100%)
> >  rename Documentation/hwmon/{max20751 => max20751.rst} (96%)
> >  rename Documentation/hwmon/{max31722 => max31722.rst} (100%)
> >  rename Documentation/hwmon/{max31785 => max31785.rst} (100%)
> >  rename Documentation/hwmon/{max31790 => max31790.rst} (100%)
> >  rename Documentation/hwmon/{max34440 => max34440.rst} (98%)
> >  rename Documentation/hwmon/{max6639 => max6639.rst} (100%)
> >  rename Documentation/hwmon/{max6642 => max6642.rst} (100%)
> >  rename Documentation/hwmon/{max6650 => max6650.rst} (99%)
> >  rename Documentation/hwmon/{max6697 => max6697.rst} (100%)
> >  rename Documentation/hwmon/{max8688 => max8688.rst} (97%)
> >  rename Documentation/hwmon/{mc13783-adc => mc13783-adc.rst} (100%)
> >  rename Documentation/hwmon/{mcp3021 => mcp3021.rst} (100%)
> >  rename Documentation/hwmon/{menf21bmc => menf21bmc.rst} (100%)
> >  rename Documentation/hwmon/{mlxreg-fan => mlxreg-fan.rst} (100%)
> >  rename Documentation/hwmon/{nct6683 => nct6683.rst} (100%)
> >  rename Documentation/hwmon/{nct6775 => nct6775.rst} (100%)
> >  rename Documentation/hwmon/{nct7802 => nct7802.rst} (100%)
> >  rename Documentation/hwmon/{nct7904 => nct7904.rst} (100%)
> >  rename Documentation/hwmon/{npcm750-pwm-fan => npcm750-pwm-fan.rst} (100%)
> >  rename Documentation/hwmon/{nsa320 => nsa320.rst} (100%)
> >  rename Documentation/hwmon/{ntc_thermistor => ntc_thermistor.rst} (100%)
> >  rename Documentation/hwmon/{occ => occ.rst} (100%)
> >  rename Documentation/hwmon/{pc87360 => pc87360.rst} (100%)
> >  rename Documentation/hwmon/{pc87427 => pc87427.rst} (100%)
> >  rename Documentation/hwmon/{pcf8591 => pcf8591.rst} (100%)
> >  rename Documentation/hwmon/{pmbus-core => pmbus-core.rst} (100%)
> >  rename Documentation/hwmon/{pmbus => pmbus.rst} (100%)
> >  rename Documentation/hwmon/{powr1220 => powr1220.rst} (100%)
> >  rename Documentation/hwmon/{pwm-fan => pwm-fan.rst} (100%)
> >  rename Documentation/hwmon/{raspberrypi-hwmon => raspberrypi-hwmon.rst} (100%)
> >  rename Documentation/hwmon/{sch5627 => sch5627.rst} (100%)
> >  rename Documentation/hwmon/{sch5636 => sch5636.rst} (100%)
> >  rename Documentation/hwmon/{scpi-hwmon => scpi-hwmon.rst} (100%)
> >  rename Documentation/hwmon/{sht15 => sht15.rst} (100%)
> >  rename Documentation/hwmon/{sht21 => sht21.rst} (100%)
> >  rename Documentation/hwmon/{sht3x => sht3x.rst} (100%)
> >  rename Documentation/hwmon/{shtc1 => shtc1.rst} (100%)
> >  rename Documentation/hwmon/{sis5595 => sis5595.rst} (99%)
> >  rename Documentation/hwmon/{smm665 => smm665.rst} (100%)
> >  rename Documentation/hwmon/{smsc47b397 => smsc47b397.rst} (100%)
> >  rename Documentation/hwmon/{smsc47m1 => smsc47m1.rst} (100%)
> >  rename Documentation/hwmon/{smsc47m192 => smsc47m192.rst} (100%)
> >  rename Documentation/hwmon/{submitting-patches => submitting-patches.rst} (98%)
> >  rename Documentation/hwmon/{sysfs-interface => sysfs-interface.rst} (100%)
> >  rename Documentation/hwmon/{tc654 => tc654.rst} (100%)
> >  rename Documentation/hwmon/{tc74 => tc74.rst} (100%)
> >  rename Documentation/hwmon/{thmc50 => thmc50.rst} (99%)
> >  rename Documentation/hwmon/{tmp102 => tmp102.rst} (93%)
> >  rename Documentation/hwmon/{tmp103 => tmp103.rst} (92%)
> >  rename Documentation/hwmon/{tmp108 => tmp108.rst} (95%)
> >  rename Documentation/hwmon/{tmp401 => tmp401.rst} (97%)
> >  rename Documentation/hwmon/{tmp421 => tmp421.rst} (100%)
> >  rename Documentation/hwmon/{tps40422 => tps40422.rst} (96%)
> >  rename Documentation/hwmon/{twl4030-madc-hwmon => twl4030-madc-hwmon.rst} (100%)
> >  rename Documentation/hwmon/{ucd9000 => ucd9000.rst} (97%)
> >  rename Documentation/hwmon/{ucd9200 => ucd9200.rst} (97%)
> >  rename Documentation/hwmon/{userspace-tools => userspace-tools.rst} (100%)
> >  rename Documentation/hwmon/{vexpress => vexpress.rst} (100%)
> >  rename Documentation/hwmon/{via686a => via686a.rst} (100%)
> >  rename Documentation/hwmon/{vt1211 => vt1211.rst} (100%)
> >  rename Documentation/hwmon/{w83627ehf => w83627ehf.rst} (100%)
> >  rename Documentation/hwmon/{w83627hf => w83627hf.rst} (100%)
> >  rename Documentation/hwmon/{w83773g => w83773g.rst} (100%)
> >  rename Documentation/hwmon/{w83781d => w83781d.rst} (100%)
> >  rename Documentation/hwmon/{w83791d => w83791d.rst} (99%)
> >  rename Documentation/hwmon/{w83792d => w83792d.rst} (100%)
> >  rename Documentation/hwmon/{w83793 => w83793.rst} (100%)
> >  rename Documentation/hwmon/{w83795 => w83795.rst} (100%)
> >  rename Documentation/hwmon/{w83l785ts => w83l785ts.rst} (100%)
> >  rename Documentation/hwmon/{w83l786ng => w83l786ng.rst} (100%)
> >  rename Documentation/hwmon/{wm831x => wm831x.rst} (100%)
> >  rename Documentation/hwmon/{wm8350 => wm8350.rst} (100%)
> >  rename Documentation/hwmon/{xgene-hwmon => xgene-hwmon.rst} (100%)
> >  rename Documentation/hwmon/{zl6100 => zl6100.rst} (98%)
> > 
> > diff --git a/Documentation/devicetree/bindings/hwmon/g762.txt b/Documentation/devicetree/bindings/hwmon/g762.txt
> > index 25cc6d8ee575..6d154c4923de 100644
> > --- a/Documentation/devicetree/bindings/hwmon/g762.txt
> > +++ b/Documentation/devicetree/bindings/hwmon/g762.txt
> > @@ -21,7 +21,7 @@ If an optional property is not set in .dts file, then current value is kept
> >  unmodified (e.g. u-boot installed value).
> >  
> >  Additional information on operational parameters for the device is available
> > -in Documentation/hwmon/g762. A detailed datasheet for the device is available
> > +in Documentation/hwmon/g762.rst. A detailed datasheet for the device is available
> >  at http://natisbad.org/NAS/refs/GMT_EDS-762_763-080710-0.2.pdf.
> >  
> >  Example g762 node:
> > diff --git a/Documentation/hwmon/ab8500 b/Documentation/hwmon/ab8500.rst
> > similarity index 86%
> > rename from Documentation/hwmon/ab8500
> > rename to Documentation/hwmon/ab8500.rst
> > index d87c61151239..33f93a9cec04 100644
> > --- a/Documentation/hwmon/ab8500
> > +++ b/Documentation/hwmon/ab8500.rst
> > @@ -18,7 +18,7 @@ Authors:
> >  Description
> >  -----------
> >  
> > -See also Documentation/hwmon/abx500. This is the ST-Ericsson AB8500 specific
> > +See also Documentation/hwmon/abx500.rst. This is the ST-Ericsson AB8500 specific
> >  driver.
> >  
> >  Currently only the AB8500 internal sensor and one external sensor for battery
> > diff --git a/Documentation/hwmon/abituguru-datasheet b/Documentation/hwmon/abituguru-datasheet.rst
> > similarity index 100%
> > rename from Documentation/hwmon/abituguru-datasheet
> > rename to Documentation/hwmon/abituguru-datasheet.rst
> > diff --git a/Documentation/hwmon/abituguru b/Documentation/hwmon/abituguru.rst
> > similarity index 100%
> > rename from Documentation/hwmon/abituguru
> > rename to Documentation/hwmon/abituguru.rst
> > diff --git a/Documentation/hwmon/abituguru3 b/Documentation/hwmon/abituguru3.rst
> > similarity index 100%
> > rename from Documentation/hwmon/abituguru3
> > rename to Documentation/hwmon/abituguru3.rst
> > diff --git a/Documentation/hwmon/abx500 b/Documentation/hwmon/abx500.rst
> > similarity index 100%
> > rename from Documentation/hwmon/abx500
> > rename to Documentation/hwmon/abx500.rst
> > diff --git a/Documentation/hwmon/acpi_power_meter b/Documentation/hwmon/acpi_power_meter.rst
> > similarity index 97%
> > rename from Documentation/hwmon/acpi_power_meter
> > rename to Documentation/hwmon/acpi_power_meter.rst
> > index 7665ca6ba957..4a0941ade0ca 100644
> > --- a/Documentation/hwmon/acpi_power_meter
> > +++ b/Documentation/hwmon/acpi_power_meter.rst
> > @@ -21,7 +21,7 @@ the ACPI 4.0 spec (Chapter 10.4).  These devices have a simple set of
> >  features--a power meter that returns average power use over a configurable
> >  interval, an optional capping mechanism, and a couple of trip points.  The
> >  sysfs interface conforms with the specification outlined in the "Power" section
> > -of Documentation/hwmon/sysfs-interface.
> > +of Documentation/hwmon/sysfs-interface.rst.
> >  
> >  Special Features
> >  ----------------
> > diff --git a/Documentation/hwmon/ad7314 b/Documentation/hwmon/ad7314.rst
> > similarity index 100%
> > rename from Documentation/hwmon/ad7314
> > rename to Documentation/hwmon/ad7314.rst
> > diff --git a/Documentation/hwmon/adc128d818 b/Documentation/hwmon/adc128d818.rst
> > similarity index 100%
> > rename from Documentation/hwmon/adc128d818
> > rename to Documentation/hwmon/adc128d818.rst
> > diff --git a/Documentation/hwmon/adm1021 b/Documentation/hwmon/adm1021.rst
> > similarity index 100%
> > rename from Documentation/hwmon/adm1021
> > rename to Documentation/hwmon/adm1021.rst
> > diff --git a/Documentation/hwmon/adm1025 b/Documentation/hwmon/adm1025.rst
> > similarity index 100%
> > rename from Documentation/hwmon/adm1025
> > rename to Documentation/hwmon/adm1025.rst
> > diff --git a/Documentation/hwmon/adm1026 b/Documentation/hwmon/adm1026.rst
> > similarity index 100%
> > rename from Documentation/hwmon/adm1026
> > rename to Documentation/hwmon/adm1026.rst
> > diff --git a/Documentation/hwmon/adm1031 b/Documentation/hwmon/adm1031.rst
> > similarity index 100%
> > rename from Documentation/hwmon/adm1031
> > rename to Documentation/hwmon/adm1031.rst
> > diff --git a/Documentation/hwmon/adm1275 b/Documentation/hwmon/adm1275.rst
> > similarity index 97%
> > rename from Documentation/hwmon/adm1275
> > rename to Documentation/hwmon/adm1275.rst
> > index 5c5860011d6e..9a1913e5b4d9 100644
> > --- a/Documentation/hwmon/adm1275
> > +++ b/Documentation/hwmon/adm1275.rst
> > @@ -68,7 +68,7 @@ integrated 12 bit analog-to-digital converter (ADC), accessed using a
> >  PMBus interface.
> >  
> >  The driver is a client driver to the core PMBus driver. Please see
> > -Documentation/hwmon/pmbus for details on PMBus client drivers.
> > +Documentation/hwmon/pmbus.rst for details on PMBus client drivers.
> >  
> >  
> >  Usage Notes
> > @@ -90,7 +90,7 @@ Platform data support
> >  ---------------------
> >  
> >  The driver supports standard PMBus driver platform data. Please see
> > -Documentation/hwmon/pmbus for details.
> > +Documentation/hwmon/pmbus.rst for details.
> >  
> >  
> >  Sysfs entries
> > diff --git a/Documentation/hwmon/adm9240 b/Documentation/hwmon/adm9240.rst
> > similarity index 100%
> > rename from Documentation/hwmon/adm9240
> > rename to Documentation/hwmon/adm9240.rst
> > diff --git a/Documentation/hwmon/ads1015 b/Documentation/hwmon/ads1015.rst
> > similarity index 100%
> > rename from Documentation/hwmon/ads1015
> > rename to Documentation/hwmon/ads1015.rst
> > diff --git a/Documentation/hwmon/ads7828 b/Documentation/hwmon/ads7828.rst
> > similarity index 100%
> > rename from Documentation/hwmon/ads7828
> > rename to Documentation/hwmon/ads7828.rst
> > diff --git a/Documentation/hwmon/adt7410 b/Documentation/hwmon/adt7410.rst
> > similarity index 100%
> > rename from Documentation/hwmon/adt7410
> > rename to Documentation/hwmon/adt7410.rst
> > diff --git a/Documentation/hwmon/adt7411 b/Documentation/hwmon/adt7411.rst
> > similarity index 100%
> > rename from Documentation/hwmon/adt7411
> > rename to Documentation/hwmon/adt7411.rst
> > diff --git a/Documentation/hwmon/adt7462 b/Documentation/hwmon/adt7462.rst
> > similarity index 99%
> > rename from Documentation/hwmon/adt7462
> > rename to Documentation/hwmon/adt7462.rst
> > index a7a831118d32..139e19696188 100644
> > --- a/Documentation/hwmon/adt7462
> > +++ b/Documentation/hwmon/adt7462.rst
> > @@ -68,4 +68,3 @@ The ADT7462 will scale the pwm between the lower and higher pwm speed when
> >  the temperature is between the two temperature boundaries.  PWM values range
> >  from 0 (off) to 255 (full speed).  Fan speed will be set to maximum when the
> >  temperature sensor associated with the PWM control exceeds temp#_max.
> > -
> > diff --git a/Documentation/hwmon/adt7470 b/Documentation/hwmon/adt7470.rst
> > similarity index 100%
> > rename from Documentation/hwmon/adt7470
> > rename to Documentation/hwmon/adt7470.rst
> > diff --git a/Documentation/hwmon/adt7475 b/Documentation/hwmon/adt7475.rst
> > similarity index 100%
> > rename from Documentation/hwmon/adt7475
> > rename to Documentation/hwmon/adt7475.rst
> > diff --git a/Documentation/hwmon/amc6821 b/Documentation/hwmon/amc6821.rst
> > similarity index 99%
> > rename from Documentation/hwmon/amc6821
> > rename to Documentation/hwmon/amc6821.rst
> > index d10eabcbc0f3..5ddb2849da90 100644
> > --- a/Documentation/hwmon/amc6821
> > +++ b/Documentation/hwmon/amc6821.rst
> > @@ -106,4 +106,3 @@ different settings, you can set the following parameters:
> >  
> >  - init=1,
> >  - pwminv: 0 default pwm output, 1 inverts pwm output.
> > -
> > diff --git a/Documentation/hwmon/asb100 b/Documentation/hwmon/asb100.rst
> > similarity index 99%
> > rename from Documentation/hwmon/asb100
> > rename to Documentation/hwmon/asb100.rst
> > index 311d9f7b6926..c2d5f97085fe 100644
> > --- a/Documentation/hwmon/asb100
> > +++ b/Documentation/hwmon/asb100.rst
> > @@ -71,4 +71,3 @@ TODO:
> >    * Experiment with temp. sensor types.
> >    * Are there really 13 voltage inputs? Probably not...
> >    * Cleanups, no doubt...
> > -
> > diff --git a/Documentation/hwmon/asc7621 b/Documentation/hwmon/asc7621.rst
> > similarity index 100%
> > rename from Documentation/hwmon/asc7621
> > rename to Documentation/hwmon/asc7621.rst
> > diff --git a/Documentation/hwmon/aspeed-pwm-tacho b/Documentation/hwmon/aspeed-pwm-tacho.rst
> > similarity index 100%
> > rename from Documentation/hwmon/aspeed-pwm-tacho
> > rename to Documentation/hwmon/aspeed-pwm-tacho.rst
> > diff --git a/Documentation/hwmon/coretemp b/Documentation/hwmon/coretemp.rst
> > similarity index 100%
> > rename from Documentation/hwmon/coretemp
> > rename to Documentation/hwmon/coretemp.rst
> > diff --git a/Documentation/hwmon/da9052 b/Documentation/hwmon/da9052.rst
> > similarity index 100%
> > rename from Documentation/hwmon/da9052
> > rename to Documentation/hwmon/da9052.rst
> > diff --git a/Documentation/hwmon/da9055 b/Documentation/hwmon/da9055.rst
> > similarity index 100%
> > rename from Documentation/hwmon/da9055
> > rename to Documentation/hwmon/da9055.rst
> > diff --git a/Documentation/hwmon/dme1737 b/Documentation/hwmon/dme1737.rst
> > similarity index 100%
> > rename from Documentation/hwmon/dme1737
> > rename to Documentation/hwmon/dme1737.rst
> > diff --git a/Documentation/hwmon/ds1621 b/Documentation/hwmon/ds1621.rst
> > similarity index 100%
> > rename from Documentation/hwmon/ds1621
> > rename to Documentation/hwmon/ds1621.rst
> > diff --git a/Documentation/hwmon/ds620 b/Documentation/hwmon/ds620.rst
> > similarity index 100%
> > rename from Documentation/hwmon/ds620
> > rename to Documentation/hwmon/ds620.rst
> > diff --git a/Documentation/hwmon/emc1403 b/Documentation/hwmon/emc1403.rst
> > similarity index 100%
> > rename from Documentation/hwmon/emc1403
> > rename to Documentation/hwmon/emc1403.rst
> > diff --git a/Documentation/hwmon/emc2103 b/Documentation/hwmon/emc2103.rst
> > similarity index 100%
> > rename from Documentation/hwmon/emc2103
> > rename to Documentation/hwmon/emc2103.rst
> > diff --git a/Documentation/hwmon/emc6w201 b/Documentation/hwmon/emc6w201.rst
> > similarity index 100%
> > rename from Documentation/hwmon/emc6w201
> > rename to Documentation/hwmon/emc6w201.rst
> > diff --git a/Documentation/hwmon/f71805f b/Documentation/hwmon/f71805f.rst
> > similarity index 100%
> > rename from Documentation/hwmon/f71805f
> > rename to Documentation/hwmon/f71805f.rst
> > diff --git a/Documentation/hwmon/f71882fg b/Documentation/hwmon/f71882fg.rst
> > similarity index 100%
> > rename from Documentation/hwmon/f71882fg
> > rename to Documentation/hwmon/f71882fg.rst
> > diff --git a/Documentation/hwmon/fam15h_power b/Documentation/hwmon/fam15h_power.rst
> > similarity index 100%
> > rename from Documentation/hwmon/fam15h_power
> > rename to Documentation/hwmon/fam15h_power.rst
> > diff --git a/Documentation/hwmon/ftsteutates b/Documentation/hwmon/ftsteutates.rst
> > similarity index 100%
> > rename from Documentation/hwmon/ftsteutates
> > rename to Documentation/hwmon/ftsteutates.rst
> > diff --git a/Documentation/hwmon/g760a b/Documentation/hwmon/g760a.rst
> > similarity index 100%
> > rename from Documentation/hwmon/g760a
> > rename to Documentation/hwmon/g760a.rst
> > diff --git a/Documentation/hwmon/g762 b/Documentation/hwmon/g762.rst
> > similarity index 97%
> > rename from Documentation/hwmon/g762
> > rename to Documentation/hwmon/g762.rst
> > index 54574e26df21..0371b3365c48 100644
> > --- a/Documentation/hwmon/g762
> > +++ b/Documentation/hwmon/g762.rst
> > @@ -7,7 +7,7 @@ modes - PWM or DC - are supported by the device.
> >  
> >  For additional information, a detailed datasheet is available at
> >  http://natisbad.org/NAS/ref/GMT_EDS-762_763-080710-0.2.pdf. sysfs
> > -bindings are described in Documentation/hwmon/sysfs-interface.
> > +bindings are described in Documentation/hwmon/sysfs-interface.rst.
> >  
> >  The following entries are available to the user in a subdirectory of
> >  /sys/bus/i2c/drivers/g762/ to control the operation of the device.
> > diff --git a/Documentation/hwmon/gl518sm b/Documentation/hwmon/gl518sm.rst
> > similarity index 100%
> > rename from Documentation/hwmon/gl518sm
> > rename to Documentation/hwmon/gl518sm.rst
> > diff --git a/Documentation/hwmon/hih6130 b/Documentation/hwmon/hih6130.rst
> > similarity index 100%
> > rename from Documentation/hwmon/hih6130
> > rename to Documentation/hwmon/hih6130.rst
> > diff --git a/Documentation/hwmon/hwmon-kernel-api.txt b/Documentation/hwmon/hwmon-kernel-api.rst
> > similarity index 99%
> > rename from Documentation/hwmon/hwmon-kernel-api.txt
> > rename to Documentation/hwmon/hwmon-kernel-api.rst
> > index b347b959fcda..c41eb6108103 100644
> > --- a/Documentation/hwmon/hwmon-kernel-api.txt
> > +++ b/Documentation/hwmon/hwmon-kernel-api.rst
> > @@ -12,10 +12,10 @@ drivers that want to use the hardware monitoring framework.
> >  This document does not describe what a hardware monitoring (hwmon) Driver or
> >  Device is. It also does not describe the API which can be used by user space
> >  to communicate with a hardware monitoring device. If you want to know this
> > -then please read the following file: Documentation/hwmon/sysfs-interface.
> > +then please read the following file: Documentation/hwmon/sysfs-interface.rst.
> >  
> >  For additional guidelines on how to write and improve hwmon drivers, please
> > -also read Documentation/hwmon/submitting-patches.
> > +also read Documentation/hwmon/submitting-patches.rst.
> >  
> >  The API
> >  -------
> > diff --git a/Documentation/hwmon/ibm-cffps b/Documentation/hwmon/ibm-cffps.rst
> > similarity index 100%
> > rename from Documentation/hwmon/ibm-cffps
> > rename to Documentation/hwmon/ibm-cffps.rst
> > diff --git a/Documentation/hwmon/ibmaem b/Documentation/hwmon/ibmaem.rst
> > similarity index 100%
> > rename from Documentation/hwmon/ibmaem
> > rename to Documentation/hwmon/ibmaem.rst
> > diff --git a/Documentation/hwmon/ibmpowernv b/Documentation/hwmon/ibmpowernv.rst
> > similarity index 100%
> > rename from Documentation/hwmon/ibmpowernv
> > rename to Documentation/hwmon/ibmpowernv.rst
> > diff --git a/Documentation/hwmon/ina209 b/Documentation/hwmon/ina209.rst
> > similarity index 100%
> > rename from Documentation/hwmon/ina209
> > rename to Documentation/hwmon/ina209.rst
> > diff --git a/Documentation/hwmon/ina2xx b/Documentation/hwmon/ina2xx.rst
> > similarity index 97%
> > rename from Documentation/hwmon/ina2xx
> > rename to Documentation/hwmon/ina2xx.rst
> > index 95badf9c396f..94b9a260c518 100644
> > --- a/Documentation/hwmon/ina2xx
> > +++ b/Documentation/hwmon/ina2xx.rst
> > @@ -78,7 +78,7 @@ refer to the Documentation/devicetree/bindings/hwmon/ina2xx.txt for bindings
> >  if the device tree is used.
> >  
> >  Additionally ina226 supports update_interval attribute as described in
> > -Documentation/hwmon/sysfs-interface. Internally the interval is the sum of
> > +Documentation/hwmon/sysfs-interface.rst. Internally the interval is the sum of
> >  bus and shunt voltage conversion times multiplied by the averaging rate. We
> >  don't touch the conversion times and only modify the number of averages. The
> >  lower limit of the update_interval is 2 ms, the upper limit is 2253 ms.
> > diff --git a/Documentation/hwmon/ina3221 b/Documentation/hwmon/ina3221.rst
> > similarity index 100%
> > rename from Documentation/hwmon/ina3221
> > rename to Documentation/hwmon/ina3221.rst
> > diff --git a/Documentation/hwmon/index.rst b/Documentation/hwmon/index.rst
> > new file mode 100644
> > index 000000000000..893804414510
> > --- /dev/null
> > +++ b/Documentation/hwmon/index.rst
> > @@ -0,0 +1,179 @@
> > +=========================
> > +Linux Hardware Monitoring
> > +=========================
> > +
> > +.. toctree::
> > +   :maxdepth: 1
> > +
> > +   hwmon-kernel-api.rst
> > +   pmbus-core.rst
> > +   submitting-patches.rst
> > +   sysfs-interface.rst
> > +   userspace-tools.rst
> > +
> > +Hardware Monitoring Kernel Drivers
> > +==================================
> > +
> > +.. toctree::
> > +   :maxdepth: 1
> > +
> > +   ab8500.rst
> > +   abituguru.rst
> > +   abituguru3.rst
> > +   abx500.rst
> > +   acpi_power_meter.rst
> > +   ad7314.rst
> > +   adc128d818.rst
> > +   adm1021.rst
> > +   adm1025.rst
> > +   adm1026.rst
> > +   adm1031.rst
> > +   adm1275.rst
> > +   adm9240.rst
> > +   ads1015.rst
> > +   ads7828.rst
> > +   adt7410.rst
> > +   adt7411.rst
> > +   adt7462.rst
> > +   adt7470.rst
> > +   adt7475.rst
> > +   amc6821.rst
> > +   asb100.rst
> > +   asc7621.rst
> > +   aspeed-pwm-tacho.rst
> > +   coretemp.rst
> > +   da9052.rst
> > +   da9055.rst
> > +   dme1737.rst
> > +   ds1621.rst
> > +   ds620.rst
> > +   emc1403.rst
> > +   emc2103.rst
> > +   emc6w201.rst
> > +   f71805f.rst
> > +   f71882fg.rst
> > +   fam15h_power.rst
> > +   ftsteutates.rst
> > +   g760a.rst
> > +   g762.rst
> > +   gl518sm.rst
> > +   hih6130.rst
> > +   ibmaem.rst
> > +   ibm-cffps.rst
> > +   ibmpowernv.rst
> > +   ina209.rst
> > +   ina2xx.rst
> > +   ina3221.rst
> > +   ir35221.rst
> > +   it87.rst
> > +   jc42.rst
> > +   k10temp.rst
> > +   k8temp.rst
> > +   lineage-pem.rst
> > +   lm25066.rst
> > +   lm63.rst
> > +   lm70.rst
> > +   lm73.rst
> > +   lm75.rst
> > +   lm77.rst
> > +   lm78.rst
> > +   lm80.rst
> > +   lm83.rst
> > +   lm85.rst
> > +   lm87.rst
> > +   lm90.rst
> > +   lm92.rst
> > +   lm93.rst
> > +   lm95234.rst
> > +   lm95245.rst
> > +   ltc2945.rst
> > +   ltc2978.rst
> > +   ltc2990.rst
> > +   ltc3815.rst
> > +   ltc4151.rst
> > +   ltc4215.rst
> > +   ltc4245.rst
> > +   ltc4260.rst
> > +   ltc4261.rst
> > +   max16064.rst
> > +   max16065.rst
> > +   max1619.rst
> > +   max1668.rst
> > +   max197.rst
> > +   max20751.rst
> > +   max31722.rst
> > +   max31785.rst
> > +   max31790.rst
> > +   max34440.rst
> > +   max6639.rst
> > +   max6642.rst
> > +   max6650.rst
> > +   max6697.rst
> > +   max8688.rst
> > +   mc13783-adc.rst
> > +   mcp3021.rst
> > +   menf21bmc.rst
> > +   mlxreg-fan.rst
> > +   nct6683.rst
> > +   nct6775.rst
> > +   nct7802.rst
> > +   nct7904.rst
> > +   npcm750-pwm-fan.rst
> > +   nsa320.rst
> > +   ntc_thermistor.rst
> > +   occ.rst
> > +   pc87360.rst
> > +   pc87427.rst
> > +   pcf8591.rst
> > +   pmbus.rst
> > +   powr1220.rst
> > +   pwm-fan.rst
> > +   raspberrypi-hwmon.rst
> > +   sch5627.rst
> > +   sch5636.rst
> > +   scpi-hwmon.rst
> > +   sht15.rst
> > +   sht21.rst
> > +   sht3x.rst
> > +   shtc1.rst
> > +   sis5595.rst
> > +   smm665.rst
> > +   smsc47b397.rst
> > +   smsc47m192.rst
> > +   smsc47m1.rst
> > +   tc654.rst
> > +   tc74.rst
> > +   thmc50.rst
> > +   tmp102.rst
> > +   tmp103.rst
> > +   tmp108.rst
> > +   tmp401.rst
> > +   tmp421.rst
> > +   tps40422.rst
> > +   twl4030-madc-hwmon.rst
> > +   ucd9000.rst
> > +   ucd9200.rst
> > +   vexpress.rst
> > +   via686a.rst
> > +   vt1211.rst
> > +   w83627ehf.rst
> > +   w83627hf.rst
> > +   w83773g.rst
> > +   w83781d.rst
> > +   w83791d.rst
> > +   w83792d.rst
> > +   w83793.rst
> > +   w83795.rst
> > +   w83l785ts.rst
> > +   w83l786ng.rst
> > +   wm831x.rst
> > +   wm8350.rst
> > +   xgene-hwmon.rst
> > +   zl6100.rst
> > +
> > +.. only::  subproject and html
> > +
> > +   Indices
> > +   =======
> > +
> > +   * :ref:`genindex`
> > diff --git a/Documentation/hwmon/ir35221 b/Documentation/hwmon/ir35221.rst
> > similarity index 100%
> > rename from Documentation/hwmon/ir35221
> > rename to Documentation/hwmon/ir35221.rst
> > diff --git a/Documentation/hwmon/it87 b/Documentation/hwmon/it87.rst
> > similarity index 100%
> > rename from Documentation/hwmon/it87
> > rename to Documentation/hwmon/it87.rst
> > diff --git a/Documentation/hwmon/jc42 b/Documentation/hwmon/jc42.rst
> > similarity index 100%
> > rename from Documentation/hwmon/jc42
> > rename to Documentation/hwmon/jc42.rst
> > diff --git a/Documentation/hwmon/k10temp b/Documentation/hwmon/k10temp.rst
> > similarity index 100%
> > rename from Documentation/hwmon/k10temp
> > rename to Documentation/hwmon/k10temp.rst
> > diff --git a/Documentation/hwmon/k8temp b/Documentation/hwmon/k8temp.rst
> > similarity index 100%
> > rename from Documentation/hwmon/k8temp
> > rename to Documentation/hwmon/k8temp.rst
> > diff --git a/Documentation/hwmon/lineage-pem b/Documentation/hwmon/lineage-pem.rst
> > similarity index 100%
> > rename from Documentation/hwmon/lineage-pem
> > rename to Documentation/hwmon/lineage-pem.rst
> > diff --git a/Documentation/hwmon/lm25066 b/Documentation/hwmon/lm25066.rst
> > similarity index 97%
> > rename from Documentation/hwmon/lm25066
> > rename to Documentation/hwmon/lm25066.rst
> > index 60b7f2722931..da15e3094c8c 100644
> > --- a/Documentation/hwmon/lm25066
> > +++ b/Documentation/hwmon/lm25066.rst
> > @@ -69,7 +69,7 @@ LM25066, LM5064, and LM5066/LM5066I Power Management, Monitoring,
> >  Control, and Protection ICs.
> >  
> >  The driver is a client driver to the core PMBus driver. Please see
> > -Documentation/hwmon/pmbus for details on PMBus client drivers.
> > +Documentation/hwmon/pmbus.rst for details on PMBus client drivers.
> >  
> >  
> >  Usage Notes
> > diff --git a/Documentation/hwmon/lm63 b/Documentation/hwmon/lm63.rst
> > similarity index 100%
> > rename from Documentation/hwmon/lm63
> > rename to Documentation/hwmon/lm63.rst
> > diff --git a/Documentation/hwmon/lm70 b/Documentation/hwmon/lm70.rst
> > similarity index 100%
> > rename from Documentation/hwmon/lm70
> > rename to Documentation/hwmon/lm70.rst
> > diff --git a/Documentation/hwmon/lm73 b/Documentation/hwmon/lm73.rst
> > similarity index 100%
> > rename from Documentation/hwmon/lm73
> > rename to Documentation/hwmon/lm73.rst
> > diff --git a/Documentation/hwmon/lm75 b/Documentation/hwmon/lm75.rst
> > similarity index 100%
> > rename from Documentation/hwmon/lm75
> > rename to Documentation/hwmon/lm75.rst
> > diff --git a/Documentation/hwmon/lm77 b/Documentation/hwmon/lm77.rst
> > similarity index 100%
> > rename from Documentation/hwmon/lm77
> > rename to Documentation/hwmon/lm77.rst
> > diff --git a/Documentation/hwmon/lm78 b/Documentation/hwmon/lm78.rst
> > similarity index 100%
> > rename from Documentation/hwmon/lm78
> > rename to Documentation/hwmon/lm78.rst
> > diff --git a/Documentation/hwmon/lm80 b/Documentation/hwmon/lm80.rst
> > similarity index 100%
> > rename from Documentation/hwmon/lm80
> > rename to Documentation/hwmon/lm80.rst
> > diff --git a/Documentation/hwmon/lm83 b/Documentation/hwmon/lm83.rst
> > similarity index 100%
> > rename from Documentation/hwmon/lm83
> > rename to Documentation/hwmon/lm83.rst
> > diff --git a/Documentation/hwmon/lm85 b/Documentation/hwmon/lm85.rst
> > similarity index 100%
> > rename from Documentation/hwmon/lm85
> > rename to Documentation/hwmon/lm85.rst
> > diff --git a/Documentation/hwmon/lm87 b/Documentation/hwmon/lm87.rst
> > similarity index 100%
> > rename from Documentation/hwmon/lm87
> > rename to Documentation/hwmon/lm87.rst
> > diff --git a/Documentation/hwmon/lm90 b/Documentation/hwmon/lm90.rst
> > similarity index 100%
> > rename from Documentation/hwmon/lm90
> > rename to Documentation/hwmon/lm90.rst
> > diff --git a/Documentation/hwmon/lm92 b/Documentation/hwmon/lm92.rst
> > similarity index 100%
> > rename from Documentation/hwmon/lm92
> > rename to Documentation/hwmon/lm92.rst
> > diff --git a/Documentation/hwmon/lm93 b/Documentation/hwmon/lm93.rst
> > similarity index 100%
> > rename from Documentation/hwmon/lm93
> > rename to Documentation/hwmon/lm93.rst
> > diff --git a/Documentation/hwmon/lm95234 b/Documentation/hwmon/lm95234.rst
> > similarity index 100%
> > rename from Documentation/hwmon/lm95234
> > rename to Documentation/hwmon/lm95234.rst
> > diff --git a/Documentation/hwmon/lm95245 b/Documentation/hwmon/lm95245.rst
> > similarity index 100%
> > rename from Documentation/hwmon/lm95245
> > rename to Documentation/hwmon/lm95245.rst
> > diff --git a/Documentation/hwmon/ltc2945 b/Documentation/hwmon/ltc2945.rst
> > similarity index 100%
> > rename from Documentation/hwmon/ltc2945
> > rename to Documentation/hwmon/ltc2945.rst
> > diff --git a/Documentation/hwmon/ltc2978 b/Documentation/hwmon/ltc2978.rst
> > similarity index 100%
> > rename from Documentation/hwmon/ltc2978
> > rename to Documentation/hwmon/ltc2978.rst
> > diff --git a/Documentation/hwmon/ltc2990 b/Documentation/hwmon/ltc2990.rst
> > similarity index 100%
> > rename from Documentation/hwmon/ltc2990
> > rename to Documentation/hwmon/ltc2990.rst
> > diff --git a/Documentation/hwmon/ltc3815 b/Documentation/hwmon/ltc3815.rst
> > similarity index 100%
> > rename from Documentation/hwmon/ltc3815
> > rename to Documentation/hwmon/ltc3815.rst
> > diff --git a/Documentation/hwmon/ltc4151 b/Documentation/hwmon/ltc4151.rst
> > similarity index 100%
> > rename from Documentation/hwmon/ltc4151
> > rename to Documentation/hwmon/ltc4151.rst
> > diff --git a/Documentation/hwmon/ltc4215 b/Documentation/hwmon/ltc4215.rst
> > similarity index 100%
> > rename from Documentation/hwmon/ltc4215
> > rename to Documentation/hwmon/ltc4215.rst
> > diff --git a/Documentation/hwmon/ltc4245 b/Documentation/hwmon/ltc4245.rst
> > similarity index 100%
> > rename from Documentation/hwmon/ltc4245
> > rename to Documentation/hwmon/ltc4245.rst
> > diff --git a/Documentation/hwmon/ltc4260 b/Documentation/hwmon/ltc4260.rst
> > similarity index 100%
> > rename from Documentation/hwmon/ltc4260
> > rename to Documentation/hwmon/ltc4260.rst
> > diff --git a/Documentation/hwmon/ltc4261 b/Documentation/hwmon/ltc4261.rst
> > similarity index 100%
> > rename from Documentation/hwmon/ltc4261
> > rename to Documentation/hwmon/ltc4261.rst
> > diff --git a/Documentation/hwmon/max16064 b/Documentation/hwmon/max16064.rst
> > similarity index 96%
> > rename from Documentation/hwmon/max16064
> > rename to Documentation/hwmon/max16064.rst
> > index 61ec679dc477..6d5e9538991f 100644
> > --- a/Documentation/hwmon/max16064
> > +++ b/Documentation/hwmon/max16064.rst
> > @@ -21,7 +21,7 @@ This driver supports hardware monitoring for Maxim MAX16064 Quad Power-Supply
> >  Controller with Active-Voltage Output Control and PMBus Interface.
> >  
> >  The driver is a client driver to the core PMBus driver.
> > -Please see Documentation/hwmon/pmbus for details on PMBus client drivers.
> > +Please see Documentation/hwmon/pmbus.rst for details on PMBus client drivers.
> >  
> >  
> >  Usage Notes
> > diff --git a/Documentation/hwmon/max16065 b/Documentation/hwmon/max16065.rst
> > similarity index 100%
> > rename from Documentation/hwmon/max16065
> > rename to Documentation/hwmon/max16065.rst
> > diff --git a/Documentation/hwmon/max1619 b/Documentation/hwmon/max1619.rst
> > similarity index 99%
> > rename from Documentation/hwmon/max1619
> > rename to Documentation/hwmon/max1619.rst
> > index 4b3762c4eceb..e25956e70f73 100644
> > --- a/Documentation/hwmon/max1619
> > +++ b/Documentation/hwmon/max1619.rst
> > @@ -31,4 +31,3 @@ Only the external sensor has high and low limits.
> >  The max1619 driver will not update its values more frequently than every
> >  other second; reading them more often will do no harm, but will return
> >  'old' values.
> > -
> > diff --git a/Documentation/hwmon/max1668 b/Documentation/hwmon/max1668.rst
> > similarity index 100%
> > rename from Documentation/hwmon/max1668
> > rename to Documentation/hwmon/max1668.rst
> > diff --git a/Documentation/hwmon/max197 b/Documentation/hwmon/max197.rst
> > similarity index 100%
> > rename from Documentation/hwmon/max197
> > rename to Documentation/hwmon/max197.rst
> > diff --git a/Documentation/hwmon/max20751 b/Documentation/hwmon/max20751.rst
> > similarity index 96%
> > rename from Documentation/hwmon/max20751
> > rename to Documentation/hwmon/max20751.rst
> > index d546695900ef..aa4469be6674 100644
> > --- a/Documentation/hwmon/max20751
> > +++ b/Documentation/hwmon/max20751.rst
> > @@ -23,7 +23,7 @@ This driver supports MAX20751 Multiphase Master with PMBus Interface
> >  and Internal Buck Converter.
> >  
> >  The driver is a client driver to the core PMBus driver.
> > -Please see Documentation/hwmon/pmbus for details on PMBus client drivers.
> > +Please see Documentation/hwmon/pmbus.rst for details on PMBus client drivers.
> >  
> >  
> >  Usage Notes
> > diff --git a/Documentation/hwmon/max31722 b/Documentation/hwmon/max31722.rst
> > similarity index 100%
> > rename from Documentation/hwmon/max31722
> > rename to Documentation/hwmon/max31722.rst
> > diff --git a/Documentation/hwmon/max31785 b/Documentation/hwmon/max31785.rst
> > similarity index 100%
> > rename from Documentation/hwmon/max31785
> > rename to Documentation/hwmon/max31785.rst
> > diff --git a/Documentation/hwmon/max31790 b/Documentation/hwmon/max31790.rst
> > similarity index 100%
> > rename from Documentation/hwmon/max31790
> > rename to Documentation/hwmon/max31790.rst
> > diff --git a/Documentation/hwmon/max34440 b/Documentation/hwmon/max34440.rst
> > similarity index 98%
> > rename from Documentation/hwmon/max34440
> > rename to Documentation/hwmon/max34440.rst
> > index 639838ef29fd..939138e12b02 100644
> > --- a/Documentation/hwmon/max34440
> > +++ b/Documentation/hwmon/max34440.rst
> > @@ -76,7 +76,7 @@ based on GIN pins. The MAX34460 supports 12 voltage channels, and the MAX34461
> >  supports 16 voltage channels.
> >  
> >  The driver is a client driver to the core PMBus driver. Please see
> > -Documentation/hwmon/pmbus for details on PMBus client drivers.
> > +Documentation/hwmon/pmbus.rst for details on PMBus client drivers.
> >  
> >  
> >  Usage Notes
> > diff --git a/Documentation/hwmon/max6639 b/Documentation/hwmon/max6639.rst
> > similarity index 100%
> > rename from Documentation/hwmon/max6639
> > rename to Documentation/hwmon/max6639.rst
> > diff --git a/Documentation/hwmon/max6642 b/Documentation/hwmon/max6642.rst
> > similarity index 100%
> > rename from Documentation/hwmon/max6642
> > rename to Documentation/hwmon/max6642.rst
> > diff --git a/Documentation/hwmon/max6650 b/Documentation/hwmon/max6650.rst
> > similarity index 99%
> > rename from Documentation/hwmon/max6650
> > rename to Documentation/hwmon/max6650.rst
> > index 74dc3f0caaa2..253482add082 100644
> > --- a/Documentation/hwmon/max6650
> > +++ b/Documentation/hwmon/max6650.rst
> > @@ -72,4 +72,3 @@ clock: The clock frequency in Hz of the chip the driver should assume [254000]
> >  
> >  Please have a look at the MAX6650/6651 data sheet and make sure that you fully
> >  understand the meaning of these parameters before you attempt to change them.
> > -
> > diff --git a/Documentation/hwmon/max6697 b/Documentation/hwmon/max6697.rst
> > similarity index 100%
> > rename from Documentation/hwmon/max6697
> > rename to Documentation/hwmon/max6697.rst
> > diff --git a/Documentation/hwmon/max8688 b/Documentation/hwmon/max8688.rst
> > similarity index 97%
> > rename from Documentation/hwmon/max8688
> > rename to Documentation/hwmon/max8688.rst
> > index 43da139234c1..009487759c61 100644
> > --- a/Documentation/hwmon/max8688
> > +++ b/Documentation/hwmon/max8688.rst
> > @@ -21,7 +21,7 @@ This driver supports hardware monitoring for Maxim MAX8688 Digital Power-Supply
> >  Controller/Monitor with PMBus Interface.
> >  
> >  The driver is a client driver to the core PMBus driver. Please see
> > -Documentation/hwmon/pmbus for details on PMBus client drivers.
> > +Documentation/hwmon/pmbus.rst for details on PMBus client drivers.
> >  
> >  
> >  Usage Notes
> > diff --git a/Documentation/hwmon/mc13783-adc b/Documentation/hwmon/mc13783-adc.rst
> > similarity index 100%
> > rename from Documentation/hwmon/mc13783-adc
> > rename to Documentation/hwmon/mc13783-adc.rst
> > diff --git a/Documentation/hwmon/mcp3021 b/Documentation/hwmon/mcp3021.rst
> > similarity index 100%
> > rename from Documentation/hwmon/mcp3021
> > rename to Documentation/hwmon/mcp3021.rst
> > diff --git a/Documentation/hwmon/menf21bmc b/Documentation/hwmon/menf21bmc.rst
> > similarity index 100%
> > rename from Documentation/hwmon/menf21bmc
> > rename to Documentation/hwmon/menf21bmc.rst
> > diff --git a/Documentation/hwmon/mlxreg-fan b/Documentation/hwmon/mlxreg-fan.rst
> > similarity index 100%
> > rename from Documentation/hwmon/mlxreg-fan
> > rename to Documentation/hwmon/mlxreg-fan.rst
> > diff --git a/Documentation/hwmon/nct6683 b/Documentation/hwmon/nct6683.rst
> > similarity index 100%
> > rename from Documentation/hwmon/nct6683
> > rename to Documentation/hwmon/nct6683.rst
> > diff --git a/Documentation/hwmon/nct6775 b/Documentation/hwmon/nct6775.rst
> > similarity index 100%
> > rename from Documentation/hwmon/nct6775
> > rename to Documentation/hwmon/nct6775.rst
> > diff --git a/Documentation/hwmon/nct7802 b/Documentation/hwmon/nct7802.rst
> > similarity index 100%
> > rename from Documentation/hwmon/nct7802
> > rename to Documentation/hwmon/nct7802.rst
> > diff --git a/Documentation/hwmon/nct7904 b/Documentation/hwmon/nct7904.rst
> > similarity index 100%
> > rename from Documentation/hwmon/nct7904
> > rename to Documentation/hwmon/nct7904.rst
> > diff --git a/Documentation/hwmon/npcm750-pwm-fan b/Documentation/hwmon/npcm750-pwm-fan.rst
> > similarity index 100%
> > rename from Documentation/hwmon/npcm750-pwm-fan
> > rename to Documentation/hwmon/npcm750-pwm-fan.rst
> > diff --git a/Documentation/hwmon/nsa320 b/Documentation/hwmon/nsa320.rst
> > similarity index 100%
> > rename from Documentation/hwmon/nsa320
> > rename to Documentation/hwmon/nsa320.rst
> > diff --git a/Documentation/hwmon/ntc_thermistor b/Documentation/hwmon/ntc_thermistor.rst
> > similarity index 100%
> > rename from Documentation/hwmon/ntc_thermistor
> > rename to Documentation/hwmon/ntc_thermistor.rst
> > diff --git a/Documentation/hwmon/occ b/Documentation/hwmon/occ.rst
> > similarity index 100%
> > rename from Documentation/hwmon/occ
> > rename to Documentation/hwmon/occ.rst
> > diff --git a/Documentation/hwmon/pc87360 b/Documentation/hwmon/pc87360.rst
> > similarity index 100%
> > rename from Documentation/hwmon/pc87360
> > rename to Documentation/hwmon/pc87360.rst
> > diff --git a/Documentation/hwmon/pc87427 b/Documentation/hwmon/pc87427.rst
> > similarity index 100%
> > rename from Documentation/hwmon/pc87427
> > rename to Documentation/hwmon/pc87427.rst
> > diff --git a/Documentation/hwmon/pcf8591 b/Documentation/hwmon/pcf8591.rst
> > similarity index 100%
> > rename from Documentation/hwmon/pcf8591
> > rename to Documentation/hwmon/pcf8591.rst
> > diff --git a/Documentation/hwmon/pmbus-core b/Documentation/hwmon/pmbus-core.rst
> > similarity index 100%
> > rename from Documentation/hwmon/pmbus-core
> > rename to Documentation/hwmon/pmbus-core.rst
> > diff --git a/Documentation/hwmon/pmbus b/Documentation/hwmon/pmbus.rst
> > similarity index 100%
> > rename from Documentation/hwmon/pmbus
> > rename to Documentation/hwmon/pmbus.rst
> > diff --git a/Documentation/hwmon/powr1220 b/Documentation/hwmon/powr1220.rst
> > similarity index 100%
> > rename from Documentation/hwmon/powr1220
> > rename to Documentation/hwmon/powr1220.rst
> > diff --git a/Documentation/hwmon/pwm-fan b/Documentation/hwmon/pwm-fan.rst
> > similarity index 100%
> > rename from Documentation/hwmon/pwm-fan
> > rename to Documentation/hwmon/pwm-fan.rst
> > diff --git a/Documentation/hwmon/raspberrypi-hwmon b/Documentation/hwmon/raspberrypi-hwmon.rst
> > similarity index 100%
> > rename from Documentation/hwmon/raspberrypi-hwmon
> > rename to Documentation/hwmon/raspberrypi-hwmon.rst
> > diff --git a/Documentation/hwmon/sch5627 b/Documentation/hwmon/sch5627.rst
> > similarity index 100%
> > rename from Documentation/hwmon/sch5627
> > rename to Documentation/hwmon/sch5627.rst
> > diff --git a/Documentation/hwmon/sch5636 b/Documentation/hwmon/sch5636.rst
> > similarity index 100%
> > rename from Documentation/hwmon/sch5636
> > rename to Documentation/hwmon/sch5636.rst
> > diff --git a/Documentation/hwmon/scpi-hwmon b/Documentation/hwmon/scpi-hwmon.rst
> > similarity index 100%
> > rename from Documentation/hwmon/scpi-hwmon
> > rename to Documentation/hwmon/scpi-hwmon.rst
> > diff --git a/Documentation/hwmon/sht15 b/Documentation/hwmon/sht15.rst
> > similarity index 100%
> > rename from Documentation/hwmon/sht15
> > rename to Documentation/hwmon/sht15.rst
> > diff --git a/Documentation/hwmon/sht21 b/Documentation/hwmon/sht21.rst
> > similarity index 100%
> > rename from Documentation/hwmon/sht21
> > rename to Documentation/hwmon/sht21.rst
> > diff --git a/Documentation/hwmon/sht3x b/Documentation/hwmon/sht3x.rst
> > similarity index 100%
> > rename from Documentation/hwmon/sht3x
> > rename to Documentation/hwmon/sht3x.rst
> > diff --git a/Documentation/hwmon/shtc1 b/Documentation/hwmon/shtc1.rst
> > similarity index 100%
> > rename from Documentation/hwmon/shtc1
> > rename to Documentation/hwmon/shtc1.rst
> > diff --git a/Documentation/hwmon/sis5595 b/Documentation/hwmon/sis5595.rst
> > similarity index 99%
> > rename from Documentation/hwmon/sis5595
> > rename to Documentation/hwmon/sis5595.rst
> > index 5acba6b0c0db..16123b3bfff9 100644
> > --- a/Documentation/hwmon/sis5595
> > +++ b/Documentation/hwmon/sis5595.rst
> > @@ -121,4 +121,3 @@ Problems
> >  --------
> >  Some chips refuse to be enabled. We don't know why.
> >  The driver will recognize this and print a message in dmesg.
> > -
> > diff --git a/Documentation/hwmon/smm665 b/Documentation/hwmon/smm665.rst
> > similarity index 100%
> > rename from Documentation/hwmon/smm665
> > rename to Documentation/hwmon/smm665.rst
> > diff --git a/Documentation/hwmon/smsc47b397 b/Documentation/hwmon/smsc47b397.rst
> > similarity index 100%
> > rename from Documentation/hwmon/smsc47b397
> > rename to Documentation/hwmon/smsc47b397.rst
> > diff --git a/Documentation/hwmon/smsc47m1 b/Documentation/hwmon/smsc47m1.rst
> > similarity index 100%
> > rename from Documentation/hwmon/smsc47m1
> > rename to Documentation/hwmon/smsc47m1.rst
> > diff --git a/Documentation/hwmon/smsc47m192 b/Documentation/hwmon/smsc47m192.rst
> > similarity index 100%
> > rename from Documentation/hwmon/smsc47m192
> > rename to Documentation/hwmon/smsc47m192.rst
> > diff --git a/Documentation/hwmon/submitting-patches b/Documentation/hwmon/submitting-patches.rst
> > similarity index 98%
> > rename from Documentation/hwmon/submitting-patches
> > rename to Documentation/hwmon/submitting-patches.rst
> > index 12540b7d9b50..f9796b9d9db6 100644
> > --- a/Documentation/hwmon/submitting-patches
> > +++ b/Documentation/hwmon/submitting-patches.rst
> > @@ -39,7 +39,7 @@ increase the chances of your change being accepted.
> >  2. Adding functionality to existing drivers
> >  -------------------------------------------
> >  
> > -* Make sure the documentation in Documentation/hwmon/<driver_name> is up to
> > +* Make sure the documentation in Documentation/hwmon/<driver_name>.rst is up to
> >    date.
> >  
> >  * Make sure the information in Kconfig is up to date.
> > @@ -61,7 +61,7 @@ increase the chances of your change being accepted.
> >  
> >  * Consider adding yourself to MAINTAINERS.
> >  
> > -* Document the driver in Documentation/hwmon/<driver_name>.
> > +* Document the driver in Documentation/hwmon/<driver_name>.rst.
> >  
> >  * Add the driver to Kconfig and Makefile in alphabetical order.
> >  
> > @@ -134,7 +134,7 @@ increase the chances of your change being accepted.
> >    non-standard attributes, or you believe you do, discuss it on the mailing list
> >    first. Either case, provide a detailed explanation why you need the
> >    non-standard attribute(s).
> > -  Standard attributes are specified in Documentation/hwmon/sysfs-interface.
> > +  Standard attributes are specified in Documentation/hwmon/sysfs-interface.rst.
> >  
> >  * When deciding which sysfs attributes to support, look at the chip's
> >    capabilities. While we do not expect your driver to support everything the
> > diff --git a/Documentation/hwmon/sysfs-interface b/Documentation/hwmon/sysfs-interface.rst
> > similarity index 100%
> > rename from Documentation/hwmon/sysfs-interface
> > rename to Documentation/hwmon/sysfs-interface.rst
> > diff --git a/Documentation/hwmon/tc654 b/Documentation/hwmon/tc654.rst
> > similarity index 100%
> > rename from Documentation/hwmon/tc654
> > rename to Documentation/hwmon/tc654.rst
> > diff --git a/Documentation/hwmon/tc74 b/Documentation/hwmon/tc74.rst
> > similarity index 100%
> > rename from Documentation/hwmon/tc74
> > rename to Documentation/hwmon/tc74.rst
> > diff --git a/Documentation/hwmon/thmc50 b/Documentation/hwmon/thmc50.rst
> > similarity index 99%
> > rename from Documentation/hwmon/thmc50
> > rename to Documentation/hwmon/thmc50.rst
> > index 6dba1b59b20c..cfff3885287d 100644
> > --- a/Documentation/hwmon/thmc50
> > +++ b/Documentation/hwmon/thmc50.rst
> > @@ -87,4 +87,3 @@ so it stops fans even if the value 0 into the ANALOG_OUT register does not.
> >  
> >  The driver was tested on Compaq AP550 with two ADM1022 chips (one works
> >  in the temp3 mode), five temperature readings and two fans.
> > -
> > diff --git a/Documentation/hwmon/tmp102 b/Documentation/hwmon/tmp102.rst
> > similarity index 93%
> > rename from Documentation/hwmon/tmp102
> > rename to Documentation/hwmon/tmp102.rst
> > index 5e34821df4ab..b1f585531a88 100644
> > --- a/Documentation/hwmon/tmp102
> > +++ b/Documentation/hwmon/tmp102.rst
> > @@ -28,4 +28,4 @@ The TMP102 has a programmable update rate that can select between 8, 4, 1, and
> >  0.5 Hz. (Currently the driver only supports the default of 4 Hz).
> >  
> >  The driver provides the common sysfs-interface for temperatures (see
> > -Documentation/hwmon/sysfs-interface under Temperatures).
> > +Documentation/hwmon/sysfs-interface.rst under Temperatures).
> > diff --git a/Documentation/hwmon/tmp103 b/Documentation/hwmon/tmp103.rst
> > similarity index 92%
> > rename from Documentation/hwmon/tmp103
> > rename to Documentation/hwmon/tmp103.rst
> > index 7682a795e38c..15d25806d585 100644
> > --- a/Documentation/hwmon/tmp103
> > +++ b/Documentation/hwmon/tmp103.rst
> > @@ -27,7 +27,7 @@ Resolution: 8 Bits
> >  Accuracy: ±1°C Typ (–10°C to +100°C)
> >  
> >  The driver provides the common sysfs-interface for temperatures (see
> > -Documentation/hwmon/sysfs-interface under Temperatures).
> > +Documentation/hwmon/sysfs-interface.rst under Temperatures).
> >  
> >  Please refer how to instantiate this driver:
> >  Documentation/i2c/instantiating-devices
> > diff --git a/Documentation/hwmon/tmp108 b/Documentation/hwmon/tmp108.rst
> > similarity index 95%
> > rename from Documentation/hwmon/tmp108
> > rename to Documentation/hwmon/tmp108.rst
> > index 7e08b7ef1e2f..5f4266a16cb2 100644
> > --- a/Documentation/hwmon/tmp108
> > +++ b/Documentation/hwmon/tmp108.rst
> > @@ -38,4 +38,4 @@ and then the device is shut down automatically. (This driver only supports
> >  continuous mode.)
> >  
> >  The driver provides the common sysfs-interface for temperatures (see
> > -Documentation/hwmon/sysfs-interface under Temperatures).
> > +Documentation/hwmon/sysfs-interface.rst under Temperatures).
> > diff --git a/Documentation/hwmon/tmp401 b/Documentation/hwmon/tmp401.rst
> > similarity index 97%
> > rename from Documentation/hwmon/tmp401
> > rename to Documentation/hwmon/tmp401.rst
> > index bd865bbdb38d..6a05a0719bc7 100644
> > --- a/Documentation/hwmon/tmp401
> > +++ b/Documentation/hwmon/tmp401.rst
> > @@ -68,7 +68,7 @@ supported by the driver so far, so using the default resolution of 0.5
> >  degree).
> >  
> >  The driver provides the common sysfs-interface for temperatures (see
> > -Documentation/hwmon/sysfs-interface under Temperatures).
> > +Documentation/hwmon/sysfs-interface.rst under Temperatures).
> >  
> >  The TMP411 and TMP431 chips are compatible with TMP401. TMP411 provides
> >  some additional features.
> > diff --git a/Documentation/hwmon/tmp421 b/Documentation/hwmon/tmp421.rst
> > similarity index 100%
> > rename from Documentation/hwmon/tmp421
> > rename to Documentation/hwmon/tmp421.rst
> > diff --git a/Documentation/hwmon/tps40422 b/Documentation/hwmon/tps40422.rst
> > similarity index 96%
> > rename from Documentation/hwmon/tps40422
> > rename to Documentation/hwmon/tps40422.rst
> > index 359751eb5ed4..b691e30479dd 100644
> > --- a/Documentation/hwmon/tps40422
> > +++ b/Documentation/hwmon/tps40422.rst
> > @@ -21,7 +21,7 @@ This driver supports TI TPS40422 Dual-Output or Two-Phase Synchronous Buck
> >  Controller with PMBus
> >  
> >  The driver is a client driver to the core PMBus driver.
> > -Please see Documentation/hwmon/pmbus for details on PMBus client drivers.
> > +Please see Documentation/hwmon/pmbus.rst for details on PMBus client drivers.
> >  
> >  
> >  Usage Notes
> > diff --git a/Documentation/hwmon/twl4030-madc-hwmon b/Documentation/hwmon/twl4030-madc-hwmon.rst
> > similarity index 100%
> > rename from Documentation/hwmon/twl4030-madc-hwmon
> > rename to Documentation/hwmon/twl4030-madc-hwmon.rst
> > diff --git a/Documentation/hwmon/ucd9000 b/Documentation/hwmon/ucd9000.rst
> > similarity index 97%
> > rename from Documentation/hwmon/ucd9000
> > rename to Documentation/hwmon/ucd9000.rst
> > index d69061b7312c..ebc4f2b3bfea 100644
> > --- a/Documentation/hwmon/ucd9000
> > +++ b/Documentation/hwmon/ucd9000.rst
> > @@ -57,7 +57,7 @@ system-health monitor. The device integrates a 12-bit ADC for monitoring up to
> >  13 power-supply voltage, current, or temperature inputs.
> >  
> >  This driver is a client driver to the core PMBus driver. Please see
> > -Documentation/hwmon/pmbus for details on PMBus client drivers.
> > +Documentation/hwmon/pmbus.rst for details on PMBus client drivers.
> >  
> >  
> >  Usage Notes
> > @@ -72,7 +72,7 @@ Platform data support
> >  ---------------------
> >  
> >  The driver supports standard PMBus driver platform data. Please see
> > -Documentation/hwmon/pmbus for details.
> > +Documentation/hwmon/pmbus.rst for details.
> >  
> >  
> >  Sysfs entries
> > diff --git a/Documentation/hwmon/ucd9200 b/Documentation/hwmon/ucd9200.rst
> > similarity index 97%
> > rename from Documentation/hwmon/ucd9200
> > rename to Documentation/hwmon/ucd9200.rst
> > index 44eda4a579b6..b819dfd75f71 100644
> > --- a/Documentation/hwmon/ucd9200
> > +++ b/Documentation/hwmon/ucd9200.rst
> > @@ -33,7 +33,7 @@ dedicated circuitry for DC/DC loop management with flash memory and a serial
> >  interface to support configuration, monitoring and management.
> >  
> >  This driver is a client driver to the core PMBus driver. Please see
> > -Documentation/hwmon/pmbus for details on PMBus client drivers.
> > +Documentation/hwmon/pmbus.rst for details on PMBus client drivers.
> >  
> >  
> >  Usage Notes
> > @@ -48,7 +48,7 @@ Platform data support
> >  ---------------------
> >  
> >  The driver supports standard PMBus driver platform data. Please see
> > -Documentation/hwmon/pmbus for details.
> > +Documentation/hwmon/pmbus.rst for details.
> >  
> >  
> >  Sysfs entries
> > diff --git a/Documentation/hwmon/userspace-tools b/Documentation/hwmon/userspace-tools.rst
> > similarity index 100%
> > rename from Documentation/hwmon/userspace-tools
> > rename to Documentation/hwmon/userspace-tools.rst
> > diff --git a/Documentation/hwmon/vexpress b/Documentation/hwmon/vexpress.rst
> > similarity index 100%
> > rename from Documentation/hwmon/vexpress
> > rename to Documentation/hwmon/vexpress.rst
> > diff --git a/Documentation/hwmon/via686a b/Documentation/hwmon/via686a.rst
> > similarity index 100%
> > rename from Documentation/hwmon/via686a
> > rename to Documentation/hwmon/via686a.rst
> > diff --git a/Documentation/hwmon/vt1211 b/Documentation/hwmon/vt1211.rst
> > similarity index 100%
> > rename from Documentation/hwmon/vt1211
> > rename to Documentation/hwmon/vt1211.rst
> > diff --git a/Documentation/hwmon/w83627ehf b/Documentation/hwmon/w83627ehf.rst
> > similarity index 100%
> > rename from Documentation/hwmon/w83627ehf
> > rename to Documentation/hwmon/w83627ehf.rst
> > diff --git a/Documentation/hwmon/w83627hf b/Documentation/hwmon/w83627hf.rst
> > similarity index 100%
> > rename from Documentation/hwmon/w83627hf
> > rename to Documentation/hwmon/w83627hf.rst
> > diff --git a/Documentation/hwmon/w83773g b/Documentation/hwmon/w83773g.rst
> > similarity index 100%
> > rename from Documentation/hwmon/w83773g
> > rename to Documentation/hwmon/w83773g.rst
> > diff --git a/Documentation/hwmon/w83781d b/Documentation/hwmon/w83781d.rst
> > similarity index 100%
> > rename from Documentation/hwmon/w83781d
> > rename to Documentation/hwmon/w83781d.rst
> > diff --git a/Documentation/hwmon/w83791d b/Documentation/hwmon/w83791d.rst
> > similarity index 99%
> > rename from Documentation/hwmon/w83791d
> > rename to Documentation/hwmon/w83791d.rst
> > index a91f9e5fb0c6..3adaed39b157 100644
> > --- a/Documentation/hwmon/w83791d
> > +++ b/Documentation/hwmon/w83791d.rst
> > @@ -102,7 +102,7 @@ This file is used for both legacy and new code.
> >  
> >  The sysfs interface to the beep bitmask has migrated from the original legacy
> >  method of a single sysfs beep_mask file to a newer method using multiple
> > -`*_beep` files as described in `Documentation/hwmon/sysfs-interface`.
> > +`*_beep` files as described in `Documentation/hwmon/sysfs-interface.rst`.
> >  
> >  A similar change has occurred for the bitmap corresponding to the alarms. The
> >  original legacy method used a single sysfs alarms file containing a bitmap
> > diff --git a/Documentation/hwmon/w83792d b/Documentation/hwmon/w83792d.rst
> > similarity index 100%
> > rename from Documentation/hwmon/w83792d
> > rename to Documentation/hwmon/w83792d.rst
> > diff --git a/Documentation/hwmon/w83793 b/Documentation/hwmon/w83793.rst
> > similarity index 100%
> > rename from Documentation/hwmon/w83793
> > rename to Documentation/hwmon/w83793.rst
> > diff --git a/Documentation/hwmon/w83795 b/Documentation/hwmon/w83795.rst
> > similarity index 100%
> > rename from Documentation/hwmon/w83795
> > rename to Documentation/hwmon/w83795.rst
> > diff --git a/Documentation/hwmon/w83l785ts b/Documentation/hwmon/w83l785ts.rst
> > similarity index 100%
> > rename from Documentation/hwmon/w83l785ts
> > rename to Documentation/hwmon/w83l785ts.rst
> > diff --git a/Documentation/hwmon/w83l786ng b/Documentation/hwmon/w83l786ng.rst
> > similarity index 100%
> > rename from Documentation/hwmon/w83l786ng
> > rename to Documentation/hwmon/w83l786ng.rst
> > diff --git a/Documentation/hwmon/wm831x b/Documentation/hwmon/wm831x.rst
> > similarity index 100%
> > rename from Documentation/hwmon/wm831x
> > rename to Documentation/hwmon/wm831x.rst
> > diff --git a/Documentation/hwmon/wm8350 b/Documentation/hwmon/wm8350.rst
> > similarity index 100%
> > rename from Documentation/hwmon/wm8350
> > rename to Documentation/hwmon/wm8350.rst
> > diff --git a/Documentation/hwmon/xgene-hwmon b/Documentation/hwmon/xgene-hwmon.rst
> > similarity index 100%
> > rename from Documentation/hwmon/xgene-hwmon
> > rename to Documentation/hwmon/xgene-hwmon.rst
> > diff --git a/Documentation/hwmon/zl6100 b/Documentation/hwmon/zl6100.rst
> > similarity index 98%
> > rename from Documentation/hwmon/zl6100
> > rename to Documentation/hwmon/zl6100.rst
> > index 4029970bace4..41513bb7fe51 100644
> > --- a/Documentation/hwmon/zl6100
> > +++ b/Documentation/hwmon/zl6100.rst
> > @@ -113,7 +113,7 @@ This driver supports hardware monitoring for Intersil / Zilker Labs ZL6100 and
> >  compatible digital DC-DC controllers.
> >  
> >  The driver is a client driver to the core PMBus driver. Please see
> > -Documentation/hwmon/pmbus and Documentation.hwmon/pmbus-core for details
> > +Documentation/hwmon/pmbus.rst and Documentation.hwmon/pmbus-core for details
> >  on PMBus client drivers.
> >  
> >  
> > diff --git a/Documentation/index.rst b/Documentation/index.rst
> > index 80a421cb935e..3a710dc24fc8 100644
> > --- a/Documentation/index.rst
> > +++ b/Documentation/index.rst
> > @@ -83,6 +83,7 @@ needed).
> >     media/index
> >     networking/index
> >     input/index
> > +   hwmon/index
> >     gpu/index
> >     security/index
> >     sound/index
> > diff --git a/Documentation/thermal/sysfs-api.txt b/Documentation/thermal/sysfs-api.txt
> > index 911399730c1c..c3fa500df92c 100644
> > --- a/Documentation/thermal/sysfs-api.txt
> > +++ b/Documentation/thermal/sysfs-api.txt
> > @@ -316,7 +316,7 @@ ACPI thermal zones.
> >      |---temp[1-*]_input:	The current temperature of thermal zone [1-*]
> >      |---temp[1-*]_critical:	The critical trip point of thermal zone [1-*]
> >  
> > -Please read Documentation/hwmon/sysfs-interface for additional information.
> > +Please read Documentation/hwmon/sysfs-interface.rst for additional information.
> >  
> >  ***************************
> >  * Thermal zone attributes *
> > diff --git a/MAINTAINERS b/MAINTAINERS
> > index 349e5d8c3f58..6269c9d671ca 100644
> > --- a/MAINTAINERS
> > +++ b/MAINTAINERS
> > @@ -468,7 +468,7 @@ ADM1025 HARDWARE MONITOR DRIVER
> >  M:	Jean Delvare <jdelvare@suse.com>
> >  L:	linux-hwmon@vger.kernel.org
> >  S:	Maintained
> > -F:	Documentation/hwmon/adm1025
> > +F:	Documentation/hwmon/adm1025.rst
> >  F:	drivers/hwmon/adm1025.c
> >  
> >  ADM1029 HARDWARE MONITOR DRIVER
> > @@ -520,7 +520,7 @@ ADS1015 HARDWARE MONITOR DRIVER
> >  M:	Dirk Eibach <eibach@gdsys.de>
> >  L:	linux-hwmon@vger.kernel.org
> >  S:	Maintained
> > -F:	Documentation/hwmon/ads1015
> > +F:	Documentation/hwmon/ads1015.rst
> >  F:	drivers/hwmon/ads1015.c
> >  F:	include/linux/platform_data/ads1015.h
> >  
> > @@ -533,7 +533,7 @@ ADT7475 HARDWARE MONITOR DRIVER
> >  M:	Jean Delvare <jdelvare@suse.com>
> >  L:	linux-hwmon@vger.kernel.org
> >  S:	Maintained
> > -F:	Documentation/hwmon/adt7475
> > +F:	Documentation/hwmon/adt7475.rst
> >  F:	drivers/hwmon/adt7475.c
> >  
> >  ADVANSYS SCSI DRIVER
> > @@ -764,7 +764,7 @@ AMD FAM15H PROCESSOR POWER MONITORING DRIVER
> >  M:	Huang Rui <ray.huang@amd.com>
> >  L:	linux-hwmon@vger.kernel.org
> >  S:	Supported
> > -F:	Documentation/hwmon/fam15h_power
> > +F:	Documentation/hwmon/fam15h_power.rst
> >  F:	drivers/hwmon/fam15h_power.c
> >  
> >  AMD FCH GPIO DRIVER
> > @@ -2531,7 +2531,7 @@ ASC7621 HARDWARE MONITOR DRIVER
> >  M:	George Joseph <george.joseph@fairview5.com>
> >  L:	linux-hwmon@vger.kernel.org
> >  S:	Maintained
> > -F:	Documentation/hwmon/asc7621
> > +F:	Documentation/hwmon/asc7621.rst
> >  F:	drivers/hwmon/asc7621.c
> >  
> >  ASPEED VIDEO ENGINE DRIVER
> > @@ -4071,7 +4071,7 @@ CORETEMP HARDWARE MONITORING DRIVER
> >  M:	Fenghua Yu <fenghua.yu@intel.com>
> >  L:	linux-hwmon@vger.kernel.org
> >  S:	Maintained
> > -F:	Documentation/hwmon/coretemp
> > +F:	Documentation/hwmon/coretemp.rst
> >  F:	drivers/hwmon/coretemp.c
> >  
> >  COSA/SRP SYNC SERIAL DRIVER
> > @@ -4627,7 +4627,7 @@ DIALOG SEMICONDUCTOR DRIVERS
> >  M:	Support Opensource <support.opensource@diasemi.com>
> >  W:	http://www.dialog-semiconductor.com/products
> >  S:	Supported
> > -F:	Documentation/hwmon/da90??
> > +F:	Documentation/hwmon/da90??.rst
> >  F:	Documentation/devicetree/bindings/mfd/da90*.txt
> >  F:	Documentation/devicetree/bindings/input/da90??-onkey.txt
> >  F:	Documentation/devicetree/bindings/thermal/da90??-thermal.txt
> > @@ -4778,7 +4778,7 @@ DME1737 HARDWARE MONITOR DRIVER
> >  M:	Juerg Haefliger <juergh@gmail.com>
> >  L:	linux-hwmon@vger.kernel.org
> >  S:	Maintained
> > -F:	Documentation/hwmon/dme1737
> > +F:	Documentation/hwmon/dme1737.rst
> >  F:	drivers/hwmon/dme1737.c
> >  
> >  DMI/SMBIOS SUPPORT
> > @@ -6006,7 +6006,7 @@ F71805F HARDWARE MONITORING DRIVER
> >  M:	Jean Delvare <jdelvare@suse.com>
> >  L:	linux-hwmon@vger.kernel.org
> >  S:	Maintained
> > -F:	Documentation/hwmon/f71805f
> > +F:	Documentation/hwmon/f71805f.rst
> >  F:	drivers/hwmon/f71805f.c
> >  
> >  FADDR2LINE
> > @@ -7687,7 +7687,7 @@ INA209 HARDWARE MONITOR DRIVER
> >  M:	Guenter Roeck <linux@roeck-us.net>
> >  L:	linux-hwmon@vger.kernel.org
> >  S:	Maintained
> > -F:	Documentation/hwmon/ina209
> > +F:	Documentation/hwmon/ina209.rst
> >  F:	Documentation/devicetree/bindings/hwmon/ina2xx.txt
> >  F:	drivers/hwmon/ina209.c
> >  
> > @@ -7695,7 +7695,7 @@ INA2XX HARDWARE MONITOR DRIVER
> >  M:	Guenter Roeck <linux@roeck-us.net>
> >  L:	linux-hwmon@vger.kernel.org
> >  S:	Maintained
> > -F:	Documentation/hwmon/ina2xx
> > +F:	Documentation/hwmon/ina2xx.rst
> >  F:	drivers/hwmon/ina2xx.c
> >  F:	include/linux/platform_data/ina2xx.h
> >  
> > @@ -8328,7 +8328,7 @@ IT87 HARDWARE MONITORING DRIVER
> >  M:	Jean Delvare <jdelvare@suse.com>
> >  L:	linux-hwmon@vger.kernel.org
> >  S:	Maintained
> > -F:	Documentation/hwmon/it87
> > +F:	Documentation/hwmon/it87.rst
> >  F:	drivers/hwmon/it87.c
> >  
> >  IT913X MEDIA DRIVER
> > @@ -8372,7 +8372,7 @@ M:	Guenter Roeck <linux@roeck-us.net>
> >  L:	linux-hwmon@vger.kernel.org
> >  S:	Maintained
> >  F:	drivers/hwmon/jc42.c
> > -F:	Documentation/hwmon/jc42
> > +F:	Documentation/hwmon/jc42.rst
> >  
> >  JFS FILESYSTEM
> >  M:	Dave Kleikamp <shaggy@kernel.org>
> > @@ -8420,14 +8420,14 @@ K10TEMP HARDWARE MONITORING DRIVER
> >  M:	Clemens Ladisch <clemens@ladisch.de>
> >  L:	linux-hwmon@vger.kernel.org
> >  S:	Maintained
> > -F:	Documentation/hwmon/k10temp
> > +F:	Documentation/hwmon/k10temp.rst
> >  F:	drivers/hwmon/k10temp.c
> >  
> >  K8TEMP HARDWARE MONITORING DRIVER
> >  M:	Rudolf Marek <r.marek@assembler.cz>
> >  L:	linux-hwmon@vger.kernel.org
> >  S:	Maintained
> > -F:	Documentation/hwmon/k8temp
> > +F:	Documentation/hwmon/k8temp.rst
> >  F:	drivers/hwmon/k8temp.c
> >  
> >  KASAN
> > @@ -9118,21 +9118,21 @@ LM78 HARDWARE MONITOR DRIVER
> >  M:	Jean Delvare <jdelvare@suse.com>
> >  L:	linux-hwmon@vger.kernel.org
> >  S:	Maintained
> > -F:	Documentation/hwmon/lm78
> > +F:	Documentation/hwmon/lm78.rst
> >  F:	drivers/hwmon/lm78.c
> >  
> >  LM83 HARDWARE MONITOR DRIVER
> >  M:	Jean Delvare <jdelvare@suse.com>
> >  L:	linux-hwmon@vger.kernel.org
> >  S:	Maintained
> > -F:	Documentation/hwmon/lm83
> > +F:	Documentation/hwmon/lm83.rst
> >  F:	drivers/hwmon/lm83.c
> >  
> >  LM90 HARDWARE MONITOR DRIVER
> >  M:	Jean Delvare <jdelvare@suse.com>
> >  L:	linux-hwmon@vger.kernel.org
> >  S:	Maintained
> > -F:	Documentation/hwmon/lm90
> > +F:	Documentation/hwmon/lm90.rst
> >  F:	Documentation/devicetree/bindings/hwmon/lm90.txt
> >  F:	drivers/hwmon/lm90.c
> >  F:	include/dt-bindings/thermal/lm90.h
> > @@ -9141,7 +9141,7 @@ LM95234 HARDWARE MONITOR DRIVER
> >  M:	Guenter Roeck <linux@roeck-us.net>
> >  L:	linux-hwmon@vger.kernel.org
> >  S:	Maintained
> > -F:	Documentation/hwmon/lm95234
> > +F:	Documentation/hwmon/lm95234.rst
> >  F:	drivers/hwmon/lm95234.c
> >  
> >  LME2510 MEDIA DRIVER
> > @@ -9214,7 +9214,7 @@ LTC4261 HARDWARE MONITOR DRIVER
> >  M:	Guenter Roeck <linux@roeck-us.net>
> >  L:	linux-hwmon@vger.kernel.org
> >  S:	Maintained
> > -F:	Documentation/hwmon/ltc4261
> > +F:	Documentation/hwmon/ltc4261.rst
> >  F:	drivers/hwmon/ltc4261.c
> >  
> >  LTC4306 I2C MULTIPLEXER DRIVER
> > @@ -9445,7 +9445,7 @@ MAX16065 HARDWARE MONITOR DRIVER
> >  M:	Guenter Roeck <linux@roeck-us.net>
> >  L:	linux-hwmon@vger.kernel.org
> >  S:	Maintained
> > -F:	Documentation/hwmon/max16065
> > +F:	Documentation/hwmon/max16065.rst
> >  F:	drivers/hwmon/max16065.c
> >  
> >  MAX2175 SDR TUNER DRIVER
> > @@ -9461,14 +9461,14 @@ F:	include/uapi/linux/max2175.h
> >  MAX6650 HARDWARE MONITOR AND FAN CONTROLLER DRIVER
> >  L:	linux-hwmon@vger.kernel.org
> >  S:	Orphan
> > -F:	Documentation/hwmon/max6650
> > +F:	Documentation/hwmon/max6650.rst
> >  F:	drivers/hwmon/max6650.c
> >  
> >  MAX6697 HARDWARE MONITOR DRIVER
> >  M:	Guenter Roeck <linux@roeck-us.net>
> >  L:	linux-hwmon@vger.kernel.org
> >  S:	Maintained
> > -F:	Documentation/hwmon/max6697
> > +F:	Documentation/hwmon/max6697.rst
> >  F:	Documentation/devicetree/bindings/hwmon/max6697.txt
> >  F:	drivers/hwmon/max6697.c
> >  F:	include/linux/platform_data/max6697.h
> > @@ -10118,7 +10118,7 @@ F:	drivers/mfd/menf21bmc.c
> >  F:	drivers/watchdog/menf21bmc_wdt.c
> >  F:	drivers/leds/leds-menf21bmc.c
> >  F:	drivers/hwmon/menf21bmc_hwmon.c
> > -F:	Documentation/hwmon/menf21bmc
> > +F:	Documentation/hwmon/menf21bmc.rst
> >  
> >  MEN Z069 WATCHDOG DRIVER
> >  M:	Johannes Thumshirn <jth@kernel.org>
> > @@ -10747,7 +10747,7 @@ NCT6775 HARDWARE MONITOR DRIVER
> >  M:	Guenter Roeck <linux@roeck-us.net>
> >  L:	linux-hwmon@vger.kernel.org
> >  S:	Maintained
> > -F:	Documentation/hwmon/nct6775
> > +F:	Documentation/hwmon/nct6775.rst
> >  F:	drivers/hwmon/nct6775.c
> >  
> >  NET_FAILOVER MODULE
> > @@ -11841,7 +11841,7 @@ PC87360 HARDWARE MONITORING DRIVER
> >  M:	Jim Cromie <jim.cromie@gmail.com>
> >  L:	linux-hwmon@vger.kernel.org
> >  S:	Maintained
> > -F:	Documentation/hwmon/pc87360
> > +F:	Documentation/hwmon/pc87360.rst
> >  F:	drivers/hwmon/pc87360.c
> >  
> >  PC8736x GPIO DRIVER
> > @@ -11853,7 +11853,7 @@ PC87427 HARDWARE MONITORING DRIVER
> >  M:	Jean Delvare <jdelvare@suse.com>
> >  L:	linux-hwmon@vger.kernel.org
> >  S:	Maintained
> > -F:	Documentation/hwmon/pc87427
> > +F:	Documentation/hwmon/pc87427.rst
> >  F:	drivers/hwmon/pc87427.c
> >  
> >  PCA9532 LED DRIVER
> > @@ -12421,23 +12421,23 @@ S:	Maintained
> >  F:	Documentation/devicetree/bindings/hwmon/ibm,cffps1.txt
> >  F:	Documentation/devicetree/bindings/hwmon/max31785.txt
> >  F:	Documentation/devicetree/bindings/hwmon/ltc2978.txt
> > -F:	Documentation/hwmon/adm1275
> > -F:	Documentation/hwmon/ibm-cffps
> > -F:	Documentation/hwmon/ir35221
> > -F:	Documentation/hwmon/lm25066
> > -F:	Documentation/hwmon/ltc2978
> > -F:	Documentation/hwmon/ltc3815
> > -F:	Documentation/hwmon/max16064
> > -F:	Documentation/hwmon/max20751
> > -F:	Documentation/hwmon/max31785
> > -F:	Documentation/hwmon/max34440
> > -F:	Documentation/hwmon/max8688
> > -F:	Documentation/hwmon/pmbus
> > -F:	Documentation/hwmon/pmbus-core
> > -F:	Documentation/hwmon/tps40422
> > -F:	Documentation/hwmon/ucd9000
> > -F:	Documentation/hwmon/ucd9200
> > -F:	Documentation/hwmon/zl6100
> > +F:	Documentation/hwmon/adm1275.rst
> > +F:	Documentation/hwmon/ibm-cffps.rst
> > +F:	Documentation/hwmon/ir35221.rst
> > +F:	Documentation/hwmon/lm25066.rst
> > +F:	Documentation/hwmon/ltc2978.rst
> > +F:	Documentation/hwmon/ltc3815.rst
> > +F:	Documentation/hwmon/max16064.rst
> > +F:	Documentation/hwmon/max20751.rst
> > +F:	Documentation/hwmon/max31785.rst
> > +F:	Documentation/hwmon/max34440.rst
> > +F:	Documentation/hwmon/max8688.rst
> > +F:	Documentation/hwmon/pmbus.rst
> > +F:	Documentation/hwmon/pmbus-core.rst
> > +F:	Documentation/hwmon/tps40422.rst
> > +F:	Documentation/hwmon/ucd9000.rst
> > +F:	Documentation/hwmon/ucd9200.rst
> > +F:	Documentation/hwmon/zl6100.rst
> >  F:	drivers/hwmon/pmbus/
> >  F:	include/linux/pmbus.h
> >  
> > @@ -12701,7 +12701,7 @@ M:	Bartlomiej Zolnierkiewicz <b.zolnierkie@samsung.com>
> >  L:	linux-hwmon@vger.kernel.org
> >  S:	Supported
> >  F:	Documentation/devicetree/bindings/hwmon/pwm-fan.txt
> > -F:	Documentation/hwmon/pwm-fan
> > +F:	Documentation/hwmon/pwm-fan.rst
> >  F:	drivers/hwmon/pwm-fan.c
> >  
> >  PWM IR Transmitter
> > @@ -14366,21 +14366,21 @@ SMM665 HARDWARE MONITOR DRIVER
> >  M:	Guenter Roeck <linux@roeck-us.net>
> >  L:	linux-hwmon@vger.kernel.org
> >  S:	Maintained
> > -F:	Documentation/hwmon/smm665
> > +F:	Documentation/hwmon/smm665.rst
> >  F:	drivers/hwmon/smm665.c
> >  
> >  SMSC EMC2103 HARDWARE MONITOR DRIVER
> >  M:	Steve Glendinning <steve.glendinning@shawell.net>
> >  L:	linux-hwmon@vger.kernel.org
> >  S:	Maintained
> > -F:	Documentation/hwmon/emc2103
> > +F:	Documentation/hwmon/emc2103.rst
> >  F:	drivers/hwmon/emc2103.c
> >  
> >  SMSC SCH5627 HARDWARE MONITOR DRIVER
> >  M:	Hans de Goede <hdegoede@redhat.com>
> >  L:	linux-hwmon@vger.kernel.org
> >  S:	Supported
> > -F:	Documentation/hwmon/sch5627
> > +F:	Documentation/hwmon/sch5627.rst
> >  F:	drivers/hwmon/sch5627.c
> >  
> >  SMSC UFX6000 and UFX7000 USB to VGA DRIVER
> > @@ -14393,7 +14393,7 @@ SMSC47B397 HARDWARE MONITOR DRIVER
> >  M:	Jean Delvare <jdelvare@suse.com>
> >  L:	linux-hwmon@vger.kernel.org
> >  S:	Maintained
> > -F:	Documentation/hwmon/smsc47b397
> > +F:	Documentation/hwmon/smsc47b397.rst
> >  F:	drivers/hwmon/smsc47b397.c
> >  
> >  SMSC911x ETHERNET DRIVER
> > @@ -15744,7 +15744,7 @@ TMP401 HARDWARE MONITOR DRIVER
> >  M:	Guenter Roeck <linux@roeck-us.net>
> >  L:	linux-hwmon@vger.kernel.org
> >  S:	Maintained
> > -F:	Documentation/hwmon/tmp401
> > +F:	Documentation/hwmon/tmp401.rst
> >  F:	drivers/hwmon/tmp401.c
> >  
> >  TMPFS (SHMEM FILESYSTEM)
> > @@ -16796,7 +16796,7 @@ VT1211 HARDWARE MONITOR DRIVER
> >  M:	Juerg Haefliger <juergh@gmail.com>
> >  L:	linux-hwmon@vger.kernel.org
> >  S:	Maintained
> > -F:	Documentation/hwmon/vt1211
> > +F:	Documentation/hwmon/vt1211.rst
> >  F:	drivers/hwmon/vt1211.c
> >  
> >  VT8231 HARDWARE MONITOR DRIVER
> > @@ -16824,14 +16824,14 @@ W83791D HARDWARE MONITORING DRIVER
> >  M:	Marc Hulsman <m.hulsman@tudelft.nl>
> >  L:	linux-hwmon@vger.kernel.org
> >  S:	Maintained
> > -F:	Documentation/hwmon/w83791d
> > +F:	Documentation/hwmon/w83791d.rst
> >  F:	drivers/hwmon/w83791d.c
> >  
> >  W83793 HARDWARE MONITORING DRIVER
> >  M:	Rudolf Marek <r.marek@assembler.cz>
> >  L:	linux-hwmon@vger.kernel.org
> >  S:	Maintained
> > -F:	Documentation/hwmon/w83793
> > +F:	Documentation/hwmon/w83793.rst
> >  F:	drivers/hwmon/w83793.c
> >  
> >  W83795 HARDWARE MONITORING DRIVER
> > @@ -16940,7 +16940,7 @@ L:	patches@opensource.cirrus.com
> >  T:	git https://github.com/CirrusLogic/linux-drivers.git
> >  W:	https://github.com/CirrusLogic/linux-drivers/wiki
> >  S:	Supported
> > -F:	Documentation/hwmon/wm83??
> > +F:	Documentation/hwmon/wm83??.rst
> >  F:	Documentation/devicetree/bindings/extcon/extcon-arizona.txt
> >  F:	Documentation/devicetree/bindings/regulator/arizona-regulator.txt
> >  F:	Documentation/devicetree/bindings/mfd/arizona.txt
> > diff --git a/drivers/hwmon/Kconfig b/drivers/hwmon/Kconfig
> > index dedd5febd3aa..470ba66b18b0 100644
> > --- a/drivers/hwmon/Kconfig
> > +++ b/drivers/hwmon/Kconfig
> > @@ -17,7 +17,7 @@ menuconfig HWMON
> >  
> >  	  To find out which specific driver(s) you need, use the
> >  	  sensors-detect script from the lm_sensors package.  Read
> > -	  <file:Documentation/hwmon/userspace-tools> for details.
> > +	  <file:Documentation/hwmon/userspace-tools.rst> for details.
> >  
> >  	  This support can also be built as a module. If so, the module
> >  	  will be called hwmon.
> > @@ -59,7 +59,7 @@ config SENSORS_ABITUGURU
> >  	  chip can be found on Abit uGuru featuring motherboards (most modern
> >  	  Abit motherboards from before end 2005). For more info and a list
> >  	  of which motherboards have which revision see
> > -	  Documentation/hwmon/abituguru
> > +	  Documentation/hwmon/abituguru.rst
> >  
> >  	  This driver can also be built as a module. If so, the module
> >  	  will be called abituguru.
> > @@ -73,7 +73,7 @@ config SENSORS_ABITUGURU3
> >  	  and their settings is supported. The third revision of the Abit
> >  	  uGuru chip can be found on recent Abit motherboards (since end
> >  	  2005). For more info and a list of which motherboards have which
> > -	  revision see Documentation/hwmon/abituguru3
> > +	  revision see Documentation/hwmon/abituguru3.rst
> >  
> >  	  This driver can also be built as a module. If so, the module
> >  	  will be called abituguru3.
> > @@ -643,7 +643,7 @@ config SENSORS_CORETEMP
> >  	help
> >  	  If you say yes here you get support for the temperature
> >  	  sensor inside your CPU. Most of the family 6 CPUs
> > -	  are supported. Check Documentation/hwmon/coretemp for details.
> > +	  are supported. Check Documentation/hwmon/coretemp.rst for details.
> >  
> >  config SENSORS_IT87
> >  	tristate "ITE IT87xx and compatibles"
> > diff --git a/drivers/hwmon/ads7828.c b/drivers/hwmon/ads7828.c
> > index e6be617e3fb2..03d6e782777a 100644
> > --- a/drivers/hwmon/ads7828.c
> > +++ b/drivers/hwmon/ads7828.c
> > @@ -8,7 +8,7 @@
> >   *
> >   * ADS7830 support, by Guillaume Roguez <guillaume.roguez@savoirfairelinux.com>
> >   *
> > - * For further information, see the Documentation/hwmon/ads7828 file.
> > + * For further information, see the Documentation/hwmon/ads7828.rst file.
> >   *
> >   * This program is free software; you can redistribute it and/or modify
> >   * it under the terms of the GNU General Public License as published by
> > diff --git a/drivers/hwmon/max197.c b/drivers/hwmon/max197.c
> > index 3d9e210beedf..dd6a35219a18 100644
> > --- a/drivers/hwmon/max197.c
> > +++ b/drivers/hwmon/max197.c
> > @@ -8,7 +8,7 @@
> >   * it under the terms of the GNU General Public License version 2 as
> >   * published by the Free Software Foundation.
> >   *
> > - * For further information, see the Documentation/hwmon/max197 file.
> > + * For further information, see the Documentation/hwmon/max197.rst file.
> >   */
> >  
> >  #include <linux/kernel.h>
> > diff --git a/drivers/hwmon/sht15.c b/drivers/hwmon/sht15.c
> > index 39b41e35c2bf..7f4a63959730 100644
> > --- a/drivers/hwmon/sht15.c
> > +++ b/drivers/hwmon/sht15.c
> > @@ -10,7 +10,7 @@
> >   *
> >   * Copyright (c) 2007 Wouter Horre
> >   *
> > - * For further information, see the Documentation/hwmon/sht15 file.
> > + * For further information, see the Documentation/hwmon/sht15.rst file.
> >   */
> >  
> >  #include <linux/interrupt.h>
> > diff --git a/include/linux/platform_data/ads7828.h b/include/linux/platform_data/ads7828.h
> > index 3245f45f9d77..a3370a007702 100644
> > --- a/include/linux/platform_data/ads7828.h
> > +++ b/include/linux/platform_data/ads7828.h
> > @@ -4,7 +4,7 @@
> >   * Copyright (c) 2012 Savoir-faire Linux Inc.
> >   *          Vivien Didelot <vivien.didelot@savoirfairelinux.com>
> >   *
> > - * For further information, see the Documentation/hwmon/ads7828 file.
> > + * For further information, see the Documentation/hwmon/ads7828.rst file.
> >   *
> >   * This program is free software; you can redistribute it and/or modify
> >   * it under the terms of the GNU General Public License version 2 as
> > diff --git a/include/linux/platform_data/ds620.h b/include/linux/platform_data/ds620.h
> > index 6ef58bb77e46..f0ce22a78bb8 100644
> > --- a/include/linux/platform_data/ds620.h
> > +++ b/include/linux/platform_data/ds620.h
> > @@ -14,7 +14,7 @@ struct ds620_platform_data {
> >  	 *  1 = PO_LOW
> >  	 *  2 = PO_HIGH
> >  	 *
> > -	 * (see Documentation/hwmon/ds620)
> > +	 * (see Documentation/hwmon/ds620.rst)
> >  	 */
> >  	int pomode;
> >  };
> > diff --git a/include/linux/platform_data/ina2xx.h b/include/linux/platform_data/ina2xx.h
> > index 9f0aa1b48c78..dde59fd3590f 100644
> > --- a/include/linux/platform_data/ina2xx.h
> > +++ b/include/linux/platform_data/ina2xx.h
> > @@ -7,7 +7,7 @@
> >   * it under the terms of the GNU General Public License version 2 as
> >   * published by the Free Software Foundation.
> >   *
> > - * For further information, see the Documentation/hwmon/ina2xx file.
> > + * For further information, see the Documentation/hwmon/ina2xx.rst file.
> >   */
> >  
> >  /**
> > diff --git a/include/linux/platform_data/max197.h b/include/linux/platform_data/max197.h
> > index 8da8f94ee15c..2bbd0919bc89 100644
> > --- a/include/linux/platform_data/max197.h
> > +++ b/include/linux/platform_data/max197.h
> > @@ -8,7 +8,7 @@
> >   * it under the terms of the GNU General Public License version 2 as
> >   * published by the Free Software Foundation.
> >   *
> > - * For further information, see the Documentation/hwmon/max197 file.
> > + * For further information, see the Documentation/hwmon/max197.rst file.
> >   */
> >  
> >  #ifndef _PDATA_MAX197_H
> > diff --git a/include/linux/platform_data/ntc_thermistor.h b/include/linux/platform_data/ntc_thermistor.h
> > index ee03d429742b..5fa115d3ea4b 100644
> > --- a/include/linux/platform_data/ntc_thermistor.h
> > +++ b/include/linux/platform_data/ntc_thermistor.h
> > @@ -42,7 +42,7 @@ struct ntc_thermistor_platform_data {
> >  	 * read_uV()
> >  	 *
> >  	 * How to setup pullup_ohm, pulldown_ohm, and connect is
> > -	 * described at Documentation/hwmon/ntc_thermistor
> > +	 * described at Documentation/hwmon/ntc_thermistor.rst
> >  	 *
> >  	 * pullup/down_ohm: 0 for infinite / not-connected
> >  	 *

^ permalink raw reply	[flat|nested] 73+ messages in thread

* Re: [PATCH v3 21/21] docs: hwmon: Add an index file and rename docs to *.rst
  2019-04-17 16:47                       ` Guenter Roeck
  2019-04-17 16:54                         ` Guenter Roeck
@ 2019-04-17 17:13                         ` Mauro Carvalho Chehab
  2019-04-17 17:22                           ` Mauro Carvalho Chehab
  1 sibling, 1 reply; 73+ messages in thread
From: Mauro Carvalho Chehab @ 2019-04-17 17:13 UTC (permalink / raw)
  To: Guenter Roeck
  Cc: Linux Doc Mailing List, Mauro Carvalho Chehab, linux-kernel,
	Jonathan Corbet, Jean Delvare, Rob Herring, Mark Rutland,
	Dirk Eibach, George Joseph, Joel Stanley, Andrew Jeffery,
	Fenghua Yu, Support Opensource, Juerg Haefliger,
	Steve Glendinning, Huang Rui, Benjamin Herrenschmidt,
	Paul Mackerras, Michael Ellerman, Clemens Ladisch, Rudolf Marek,
	Andreas Werner, Jim Cromie, Kamil Debski,
	Bartlomiej Zolnierkiewicz, Hans de Goede, Liviu Dudau,
	Sudeep Holla, Lorenzo Pieralisi, Marc Hulsman, linux-hwmon,
	devicetree, linux-arm-kernel, linux-aspeed, linuxppc-dev,
	patches

Em Wed, 17 Apr 2019 09:47:41 -0700
Guenter Roeck <linux@roeck-us.net> escreveu:

> On Wed, Apr 17, 2019 at 06:46:29AM -0300, Mauro Carvalho Chehab wrote:
> > Now that all files were converted to ReST format, rename them
> > and add an index.
> > 
> > Signed-off-by: Mauro Carvalho Chehab <mchehab+samsung@kernel.org>
> > Acked-by: Liviu Dudau <liviu.dudau@arm.com>  
> 
> I applied all patches except this one, which fails due to a conflict in
> ab8500. I also notice that this file has not been touched by your series,
> which is odd. At the same time, patch 20/21 is missing from your series,
> and has been missing all along. Does the missing patch possibly touch
> Documentation/hwmon/ab8500 ?

Patch 20/21 is the biggest one. Maybe vger rejected it either due to
its size or due to the number of c/c.

Just bounced it to you. Please let me know if you didn't receive it
yet.

Regards,
Mauro

> 
> Thanks,
> Guenter
> 
> > ---
> >  .../devicetree/bindings/hwmon/g762.txt        |   2 +-
> >  Documentation/hwmon/{ab8500 => ab8500.rst}    |   2 +-
> >  ...guru-datasheet => abituguru-datasheet.rst} |   0
> >  .../hwmon/{abituguru => abituguru.rst}        |   0
> >  .../hwmon/{abituguru3 => abituguru3.rst}      |   0
> >  Documentation/hwmon/{abx500 => abx500.rst}    |   0
> >  ...{acpi_power_meter => acpi_power_meter.rst} |   2 +-
> >  Documentation/hwmon/{ad7314 => ad7314.rst}    |   0
> >  .../hwmon/{adc128d818 => adc128d818.rst}      |   0
> >  Documentation/hwmon/{adm1021 => adm1021.rst}  |   0
> >  Documentation/hwmon/{adm1025 => adm1025.rst}  |   0
> >  Documentation/hwmon/{adm1026 => adm1026.rst}  |   0
> >  Documentation/hwmon/{adm1031 => adm1031.rst}  |   0
> >  Documentation/hwmon/{adm1275 => adm1275.rst}  |   4 +-
> >  Documentation/hwmon/{adm9240 => adm9240.rst}  |   0
> >  Documentation/hwmon/{ads1015 => ads1015.rst}  |   0
> >  Documentation/hwmon/{ads7828 => ads7828.rst}  |   0
> >  Documentation/hwmon/{adt7410 => adt7410.rst}  |   0
> >  Documentation/hwmon/{adt7411 => adt7411.rst}  |   0
> >  Documentation/hwmon/{adt7462 => adt7462.rst}  |   1 -
> >  Documentation/hwmon/{adt7470 => adt7470.rst}  |   0
> >  Documentation/hwmon/{adt7475 => adt7475.rst}  |   0
> >  Documentation/hwmon/{amc6821 => amc6821.rst}  |   1 -
> >  Documentation/hwmon/{asb100 => asb100.rst}    |   1 -
> >  Documentation/hwmon/{asc7621 => asc7621.rst}  |   0
> >  ...{aspeed-pwm-tacho => aspeed-pwm-tacho.rst} |   0
> >  .../hwmon/{coretemp => coretemp.rst}          |   0
> >  Documentation/hwmon/{da9052 => da9052.rst}    |   0
> >  Documentation/hwmon/{da9055 => da9055.rst}    |   0
> >  Documentation/hwmon/{dme1737 => dme1737.rst}  |   0
> >  Documentation/hwmon/{ds1621 => ds1621.rst}    |   0
> >  Documentation/hwmon/{ds620 => ds620.rst}      |   0
> >  Documentation/hwmon/{emc1403 => emc1403.rst}  |   0
> >  Documentation/hwmon/{emc2103 => emc2103.rst}  |   0
> >  .../hwmon/{emc6w201 => emc6w201.rst}          |   0
> >  Documentation/hwmon/{f71805f => f71805f.rst}  |   0
> >  .../hwmon/{f71882fg => f71882fg.rst}          |   0
> >  .../hwmon/{fam15h_power => fam15h_power.rst}  |   0
> >  .../hwmon/{ftsteutates => ftsteutates.rst}    |   0
> >  Documentation/hwmon/{g760a => g760a.rst}      |   0
> >  Documentation/hwmon/{g762 => g762.rst}        |   2 +-
> >  Documentation/hwmon/{gl518sm => gl518sm.rst}  |   0
> >  Documentation/hwmon/{hih6130 => hih6130.rst}  |   0
> >  ...on-kernel-api.txt => hwmon-kernel-api.rst} |   4 +-
> >  .../hwmon/{ibm-cffps => ibm-cffps.rst}        |   0
> >  Documentation/hwmon/{ibmaem => ibmaem.rst}    |   0
> >  .../hwmon/{ibmpowernv => ibmpowernv.rst}      |   0
> >  Documentation/hwmon/{ina209 => ina209.rst}    |   0
> >  Documentation/hwmon/{ina2xx => ina2xx.rst}    |   2 +-
> >  Documentation/hwmon/{ina3221 => ina3221.rst}  |   0
> >  Documentation/hwmon/index.rst                 | 179 ++++++++++++++++++
> >  Documentation/hwmon/{ir35221 => ir35221.rst}  |   0
> >  Documentation/hwmon/{it87 => it87.rst}        |   0
> >  Documentation/hwmon/{jc42 => jc42.rst}        |   0
> >  Documentation/hwmon/{k10temp => k10temp.rst}  |   0
> >  Documentation/hwmon/{k8temp => k8temp.rst}    |   0
> >  .../hwmon/{lineage-pem => lineage-pem.rst}    |   0
> >  Documentation/hwmon/{lm25066 => lm25066.rst}  |   2 +-
> >  Documentation/hwmon/{lm63 => lm63.rst}        |   0
> >  Documentation/hwmon/{lm70 => lm70.rst}        |   0
> >  Documentation/hwmon/{lm73 => lm73.rst}        |   0
> >  Documentation/hwmon/{lm75 => lm75.rst}        |   0
> >  Documentation/hwmon/{lm77 => lm77.rst}        |   0
> >  Documentation/hwmon/{lm78 => lm78.rst}        |   0
> >  Documentation/hwmon/{lm80 => lm80.rst}        |   0
> >  Documentation/hwmon/{lm83 => lm83.rst}        |   0
> >  Documentation/hwmon/{lm85 => lm85.rst}        |   0
> >  Documentation/hwmon/{lm87 => lm87.rst}        |   0
> >  Documentation/hwmon/{lm90 => lm90.rst}        |   0
> >  Documentation/hwmon/{lm92 => lm92.rst}        |   0
> >  Documentation/hwmon/{lm93 => lm93.rst}        |   0
> >  Documentation/hwmon/{lm95234 => lm95234.rst}  |   0
> >  Documentation/hwmon/{lm95245 => lm95245.rst}  |   0
> >  Documentation/hwmon/{ltc2945 => ltc2945.rst}  |   0
> >  Documentation/hwmon/{ltc2978 => ltc2978.rst}  |   0
> >  Documentation/hwmon/{ltc2990 => ltc2990.rst}  |   0
> >  Documentation/hwmon/{ltc3815 => ltc3815.rst}  |   0
> >  Documentation/hwmon/{ltc4151 => ltc4151.rst}  |   0
> >  Documentation/hwmon/{ltc4215 => ltc4215.rst}  |   0
> >  Documentation/hwmon/{ltc4245 => ltc4245.rst}  |   0
> >  Documentation/hwmon/{ltc4260 => ltc4260.rst}  |   0
> >  Documentation/hwmon/{ltc4261 => ltc4261.rst}  |   0
> >  .../hwmon/{max16064 => max16064.rst}          |   2 +-
> >  .../hwmon/{max16065 => max16065.rst}          |   0
> >  Documentation/hwmon/{max1619 => max1619.rst}  |   1 -
> >  Documentation/hwmon/{max1668 => max1668.rst}  |   0
> >  Documentation/hwmon/{max197 => max197.rst}    |   0
> >  .../hwmon/{max20751 => max20751.rst}          |   2 +-
> >  .../hwmon/{max31722 => max31722.rst}          |   0
> >  .../hwmon/{max31785 => max31785.rst}          |   0
> >  .../hwmon/{max31790 => max31790.rst}          |   0
> >  .../hwmon/{max34440 => max34440.rst}          |   2 +-
> >  Documentation/hwmon/{max6639 => max6639.rst}  |   0
> >  Documentation/hwmon/{max6642 => max6642.rst}  |   0
> >  Documentation/hwmon/{max6650 => max6650.rst}  |   1 -
> >  Documentation/hwmon/{max6697 => max6697.rst}  |   0
> >  Documentation/hwmon/{max8688 => max8688.rst}  |   2 +-
> >  .../hwmon/{mc13783-adc => mc13783-adc.rst}    |   0
> >  Documentation/hwmon/{mcp3021 => mcp3021.rst}  |   0
> >  .../hwmon/{menf21bmc => menf21bmc.rst}        |   0
> >  .../hwmon/{mlxreg-fan => mlxreg-fan.rst}      |   0
> >  Documentation/hwmon/{nct6683 => nct6683.rst}  |   0
> >  Documentation/hwmon/{nct6775 => nct6775.rst}  |   0
> >  Documentation/hwmon/{nct7802 => nct7802.rst}  |   0
> >  Documentation/hwmon/{nct7904 => nct7904.rst}  |   0
> >  .../{npcm750-pwm-fan => npcm750-pwm-fan.rst}  |   0
> >  Documentation/hwmon/{nsa320 => nsa320.rst}    |   0
> >  .../{ntc_thermistor => ntc_thermistor.rst}    |   0
> >  Documentation/hwmon/{occ => occ.rst}          |   0
> >  Documentation/hwmon/{pc87360 => pc87360.rst}  |   0
> >  Documentation/hwmon/{pc87427 => pc87427.rst}  |   0
> >  Documentation/hwmon/{pcf8591 => pcf8591.rst}  |   0
> >  .../hwmon/{pmbus-core => pmbus-core.rst}      |   0
> >  Documentation/hwmon/{pmbus => pmbus.rst}      |   0
> >  .../hwmon/{powr1220 => powr1220.rst}          |   0
> >  Documentation/hwmon/{pwm-fan => pwm-fan.rst}  |   0
> >  ...aspberrypi-hwmon => raspberrypi-hwmon.rst} |   0
> >  Documentation/hwmon/{sch5627 => sch5627.rst}  |   0
> >  Documentation/hwmon/{sch5636 => sch5636.rst}  |   0
> >  .../hwmon/{scpi-hwmon => scpi-hwmon.rst}      |   0
> >  Documentation/hwmon/{sht15 => sht15.rst}      |   0
> >  Documentation/hwmon/{sht21 => sht21.rst}      |   0
> >  Documentation/hwmon/{sht3x => sht3x.rst}      |   0
> >  Documentation/hwmon/{shtc1 => shtc1.rst}      |   0
> >  Documentation/hwmon/{sis5595 => sis5595.rst}  |   1 -
> >  Documentation/hwmon/{smm665 => smm665.rst}    |   0
> >  .../hwmon/{smsc47b397 => smsc47b397.rst}      |   0
> >  .../hwmon/{smsc47m1 => smsc47m1.rst}          |   0
> >  .../hwmon/{smsc47m192 => smsc47m192.rst}      |   0
> >  ...mitting-patches => submitting-patches.rst} |   6 +-
> >  .../{sysfs-interface => sysfs-interface.rst}  |   0
> >  Documentation/hwmon/{tc654 => tc654.rst}      |   0
> >  Documentation/hwmon/{tc74 => tc74.rst}        |   0
> >  Documentation/hwmon/{thmc50 => thmc50.rst}    |   1 -
> >  Documentation/hwmon/{tmp102 => tmp102.rst}    |   2 +-
> >  Documentation/hwmon/{tmp103 => tmp103.rst}    |   2 +-
> >  Documentation/hwmon/{tmp108 => tmp108.rst}    |   2 +-
> >  Documentation/hwmon/{tmp401 => tmp401.rst}    |   2 +-
> >  Documentation/hwmon/{tmp421 => tmp421.rst}    |   0
> >  .../hwmon/{tps40422 => tps40422.rst}          |   2 +-
> >  ...4030-madc-hwmon => twl4030-madc-hwmon.rst} |   0
> >  Documentation/hwmon/{ucd9000 => ucd9000.rst}  |   4 +-
> >  Documentation/hwmon/{ucd9200 => ucd9200.rst}  |   4 +-
> >  .../{userspace-tools => userspace-tools.rst}  |   0
> >  .../hwmon/{vexpress => vexpress.rst}          |   0
> >  Documentation/hwmon/{via686a => via686a.rst}  |   0
> >  Documentation/hwmon/{vt1211 => vt1211.rst}    |   0
> >  .../hwmon/{w83627ehf => w83627ehf.rst}        |   0
> >  .../hwmon/{w83627hf => w83627hf.rst}          |   0
> >  Documentation/hwmon/{w83773g => w83773g.rst}  |   0
> >  Documentation/hwmon/{w83781d => w83781d.rst}  |   0
> >  Documentation/hwmon/{w83791d => w83791d.rst}  |   2 +-
> >  Documentation/hwmon/{w83792d => w83792d.rst}  |   0
> >  Documentation/hwmon/{w83793 => w83793.rst}    |   0
> >  Documentation/hwmon/{w83795 => w83795.rst}    |   0
> >  .../hwmon/{w83l785ts => w83l785ts.rst}        |   0
> >  .../hwmon/{w83l786ng => w83l786ng.rst}        |   0
> >  Documentation/hwmon/{wm831x => wm831x.rst}    |   0
> >  Documentation/hwmon/{wm8350 => wm8350.rst}    |   0
> >  .../hwmon/{xgene-hwmon => xgene-hwmon.rst}    |   0
> >  Documentation/hwmon/{zl6100 => zl6100.rst}    |   2 +-
> >  Documentation/index.rst                       |   1 +
> >  Documentation/thermal/sysfs-api.txt           |   2 +-
> >  MAINTAINERS                                   | 108 +++++------
> >  drivers/hwmon/Kconfig                         |   8 +-
> >  drivers/hwmon/ads7828.c                       |   2 +-
> >  drivers/hwmon/max197.c                        |   2 +-
> >  drivers/hwmon/sht15.c                         |   2 +-
> >  include/linux/platform_data/ads7828.h         |   2 +-
> >  include/linux/platform_data/ds620.h           |   2 +-
> >  include/linux/platform_data/ina2xx.h          |   2 +-
> >  include/linux/platform_data/max197.h          |   2 +-
> >  include/linux/platform_data/ntc_thermistor.h  |   2 +-
> >  173 files changed, 275 insertions(+), 102 deletions(-)
> >  rename Documentation/hwmon/{ab8500 => ab8500.rst} (86%)
> >  rename Documentation/hwmon/{abituguru-datasheet => abituguru-datasheet.rst} (100%)
> >  rename Documentation/hwmon/{abituguru => abituguru.rst} (100%)
> >  rename Documentation/hwmon/{abituguru3 => abituguru3.rst} (100%)
> >  rename Documentation/hwmon/{abx500 => abx500.rst} (100%)
> >  rename Documentation/hwmon/{acpi_power_meter => acpi_power_meter.rst} (97%)
> >  rename Documentation/hwmon/{ad7314 => ad7314.rst} (100%)
> >  rename Documentation/hwmon/{adc128d818 => adc128d818.rst} (100%)
> >  rename Documentation/hwmon/{adm1021 => adm1021.rst} (100%)
> >  rename Documentation/hwmon/{adm1025 => adm1025.rst} (100%)
> >  rename Documentation/hwmon/{adm1026 => adm1026.rst} (100%)
> >  rename Documentation/hwmon/{adm1031 => adm1031.rst} (100%)
> >  rename Documentation/hwmon/{adm1275 => adm1275.rst} (97%)
> >  rename Documentation/hwmon/{adm9240 => adm9240.rst} (100%)
> >  rename Documentation/hwmon/{ads1015 => ads1015.rst} (100%)
> >  rename Documentation/hwmon/{ads7828 => ads7828.rst} (100%)
> >  rename Documentation/hwmon/{adt7410 => adt7410.rst} (100%)
> >  rename Documentation/hwmon/{adt7411 => adt7411.rst} (100%)
> >  rename Documentation/hwmon/{adt7462 => adt7462.rst} (99%)
> >  rename Documentation/hwmon/{adt7470 => adt7470.rst} (100%)
> >  rename Documentation/hwmon/{adt7475 => adt7475.rst} (100%)
> >  rename Documentation/hwmon/{amc6821 => amc6821.rst} (99%)
> >  rename Documentation/hwmon/{asb100 => asb100.rst} (99%)
> >  rename Documentation/hwmon/{asc7621 => asc7621.rst} (100%)
> >  rename Documentation/hwmon/{aspeed-pwm-tacho => aspeed-pwm-tacho.rst} (100%)
> >  rename Documentation/hwmon/{coretemp => coretemp.rst} (100%)
> >  rename Documentation/hwmon/{da9052 => da9052.rst} (100%)
> >  rename Documentation/hwmon/{da9055 => da9055.rst} (100%)
> >  rename Documentation/hwmon/{dme1737 => dme1737.rst} (100%)
> >  rename Documentation/hwmon/{ds1621 => ds1621.rst} (100%)
> >  rename Documentation/hwmon/{ds620 => ds620.rst} (100%)
> >  rename Documentation/hwmon/{emc1403 => emc1403.rst} (100%)
> >  rename Documentation/hwmon/{emc2103 => emc2103.rst} (100%)
> >  rename Documentation/hwmon/{emc6w201 => emc6w201.rst} (100%)
> >  rename Documentation/hwmon/{f71805f => f71805f.rst} (100%)
> >  rename Documentation/hwmon/{f71882fg => f71882fg.rst} (100%)
> >  rename Documentation/hwmon/{fam15h_power => fam15h_power.rst} (100%)
> >  rename Documentation/hwmon/{ftsteutates => ftsteutates.rst} (100%)
> >  rename Documentation/hwmon/{g760a => g760a.rst} (100%)
> >  rename Documentation/hwmon/{g762 => g762.rst} (97%)
> >  rename Documentation/hwmon/{gl518sm => gl518sm.rst} (100%)
> >  rename Documentation/hwmon/{hih6130 => hih6130.rst} (100%)
> >  rename Documentation/hwmon/{hwmon-kernel-api.txt => hwmon-kernel-api.rst} (99%)
> >  rename Documentation/hwmon/{ibm-cffps => ibm-cffps.rst} (100%)
> >  rename Documentation/hwmon/{ibmaem => ibmaem.rst} (100%)
> >  rename Documentation/hwmon/{ibmpowernv => ibmpowernv.rst} (100%)
> >  rename Documentation/hwmon/{ina209 => ina209.rst} (100%)
> >  rename Documentation/hwmon/{ina2xx => ina2xx.rst} (97%)
> >  rename Documentation/hwmon/{ina3221 => ina3221.rst} (100%)
> >  create mode 100644 Documentation/hwmon/index.rst
> >  rename Documentation/hwmon/{ir35221 => ir35221.rst} (100%)
> >  rename Documentation/hwmon/{it87 => it87.rst} (100%)
> >  rename Documentation/hwmon/{jc42 => jc42.rst} (100%)
> >  rename Documentation/hwmon/{k10temp => k10temp.rst} (100%)
> >  rename Documentation/hwmon/{k8temp => k8temp.rst} (100%)
> >  rename Documentation/hwmon/{lineage-pem => lineage-pem.rst} (100%)
> >  rename Documentation/hwmon/{lm25066 => lm25066.rst} (97%)
> >  rename Documentation/hwmon/{lm63 => lm63.rst} (100%)
> >  rename Documentation/hwmon/{lm70 => lm70.rst} (100%)
> >  rename Documentation/hwmon/{lm73 => lm73.rst} (100%)
> >  rename Documentation/hwmon/{lm75 => lm75.rst} (100%)
> >  rename Documentation/hwmon/{lm77 => lm77.rst} (100%)
> >  rename Documentation/hwmon/{lm78 => lm78.rst} (100%)
> >  rename Documentation/hwmon/{lm80 => lm80.rst} (100%)
> >  rename Documentation/hwmon/{lm83 => lm83.rst} (100%)
> >  rename Documentation/hwmon/{lm85 => lm85.rst} (100%)
> >  rename Documentation/hwmon/{lm87 => lm87.rst} (100%)
> >  rename Documentation/hwmon/{lm90 => lm90.rst} (100%)
> >  rename Documentation/hwmon/{lm92 => lm92.rst} (100%)
> >  rename Documentation/hwmon/{lm93 => lm93.rst} (100%)
> >  rename Documentation/hwmon/{lm95234 => lm95234.rst} (100%)
> >  rename Documentation/hwmon/{lm95245 => lm95245.rst} (100%)
> >  rename Documentation/hwmon/{ltc2945 => ltc2945.rst} (100%)
> >  rename Documentation/hwmon/{ltc2978 => ltc2978.rst} (100%)
> >  rename Documentation/hwmon/{ltc2990 => ltc2990.rst} (100%)
> >  rename Documentation/hwmon/{ltc3815 => ltc3815.rst} (100%)
> >  rename Documentation/hwmon/{ltc4151 => ltc4151.rst} (100%)
> >  rename Documentation/hwmon/{ltc4215 => ltc4215.rst} (100%)
> >  rename Documentation/hwmon/{ltc4245 => ltc4245.rst} (100%)
> >  rename Documentation/hwmon/{ltc4260 => ltc4260.rst} (100%)
> >  rename Documentation/hwmon/{ltc4261 => ltc4261.rst} (100%)
> >  rename Documentation/hwmon/{max16064 => max16064.rst} (96%)
> >  rename Documentation/hwmon/{max16065 => max16065.rst} (100%)
> >  rename Documentation/hwmon/{max1619 => max1619.rst} (99%)
> >  rename Documentation/hwmon/{max1668 => max1668.rst} (100%)
> >  rename Documentation/hwmon/{max197 => max197.rst} (100%)
> >  rename Documentation/hwmon/{max20751 => max20751.rst} (96%)
> >  rename Documentation/hwmon/{max31722 => max31722.rst} (100%)
> >  rename Documentation/hwmon/{max31785 => max31785.rst} (100%)
> >  rename Documentation/hwmon/{max31790 => max31790.rst} (100%)
> >  rename Documentation/hwmon/{max34440 => max34440.rst} (98%)
> >  rename Documentation/hwmon/{max6639 => max6639.rst} (100%)
> >  rename Documentation/hwmon/{max6642 => max6642.rst} (100%)
> >  rename Documentation/hwmon/{max6650 => max6650.rst} (99%)
> >  rename Documentation/hwmon/{max6697 => max6697.rst} (100%)
> >  rename Documentation/hwmon/{max8688 => max8688.rst} (97%)
> >  rename Documentation/hwmon/{mc13783-adc => mc13783-adc.rst} (100%)
> >  rename Documentation/hwmon/{mcp3021 => mcp3021.rst} (100%)
> >  rename Documentation/hwmon/{menf21bmc => menf21bmc.rst} (100%)
> >  rename Documentation/hwmon/{mlxreg-fan => mlxreg-fan.rst} (100%)
> >  rename Documentation/hwmon/{nct6683 => nct6683.rst} (100%)
> >  rename Documentation/hwmon/{nct6775 => nct6775.rst} (100%)
> >  rename Documentation/hwmon/{nct7802 => nct7802.rst} (100%)
> >  rename Documentation/hwmon/{nct7904 => nct7904.rst} (100%)
> >  rename Documentation/hwmon/{npcm750-pwm-fan => npcm750-pwm-fan.rst} (100%)
> >  rename Documentation/hwmon/{nsa320 => nsa320.rst} (100%)
> >  rename Documentation/hwmon/{ntc_thermistor => ntc_thermistor.rst} (100%)
> >  rename Documentation/hwmon/{occ => occ.rst} (100%)
> >  rename Documentation/hwmon/{pc87360 => pc87360.rst} (100%)
> >  rename Documentation/hwmon/{pc87427 => pc87427.rst} (100%)
> >  rename Documentation/hwmon/{pcf8591 => pcf8591.rst} (100%)
> >  rename Documentation/hwmon/{pmbus-core => pmbus-core.rst} (100%)
> >  rename Documentation/hwmon/{pmbus => pmbus.rst} (100%)
> >  rename Documentation/hwmon/{powr1220 => powr1220.rst} (100%)
> >  rename Documentation/hwmon/{pwm-fan => pwm-fan.rst} (100%)
> >  rename Documentation/hwmon/{raspberrypi-hwmon => raspberrypi-hwmon.rst} (100%)
> >  rename Documentation/hwmon/{sch5627 => sch5627.rst} (100%)
> >  rename Documentation/hwmon/{sch5636 => sch5636.rst} (100%)
> >  rename Documentation/hwmon/{scpi-hwmon => scpi-hwmon.rst} (100%)
> >  rename Documentation/hwmon/{sht15 => sht15.rst} (100%)
> >  rename Documentation/hwmon/{sht21 => sht21.rst} (100%)
> >  rename Documentation/hwmon/{sht3x => sht3x.rst} (100%)
> >  rename Documentation/hwmon/{shtc1 => shtc1.rst} (100%)
> >  rename Documentation/hwmon/{sis5595 => sis5595.rst} (99%)
> >  rename Documentation/hwmon/{smm665 => smm665.rst} (100%)
> >  rename Documentation/hwmon/{smsc47b397 => smsc47b397.rst} (100%)
> >  rename Documentation/hwmon/{smsc47m1 => smsc47m1.rst} (100%)
> >  rename Documentation/hwmon/{smsc47m192 => smsc47m192.rst} (100%)
> >  rename Documentation/hwmon/{submitting-patches => submitting-patches.rst} (98%)
> >  rename Documentation/hwmon/{sysfs-interface => sysfs-interface.rst} (100%)
> >  rename Documentation/hwmon/{tc654 => tc654.rst} (100%)
> >  rename Documentation/hwmon/{tc74 => tc74.rst} (100%)
> >  rename Documentation/hwmon/{thmc50 => thmc50.rst} (99%)
> >  rename Documentation/hwmon/{tmp102 => tmp102.rst} (93%)
> >  rename Documentation/hwmon/{tmp103 => tmp103.rst} (92%)
> >  rename Documentation/hwmon/{tmp108 => tmp108.rst} (95%)
> >  rename Documentation/hwmon/{tmp401 => tmp401.rst} (97%)
> >  rename Documentation/hwmon/{tmp421 => tmp421.rst} (100%)
> >  rename Documentation/hwmon/{tps40422 => tps40422.rst} (96%)
> >  rename Documentation/hwmon/{twl4030-madc-hwmon => twl4030-madc-hwmon.rst} (100%)
> >  rename Documentation/hwmon/{ucd9000 => ucd9000.rst} (97%)
> >  rename Documentation/hwmon/{ucd9200 => ucd9200.rst} (97%)
> >  rename Documentation/hwmon/{userspace-tools => userspace-tools.rst} (100%)
> >  rename Documentation/hwmon/{vexpress => vexpress.rst} (100%)
> >  rename Documentation/hwmon/{via686a => via686a.rst} (100%)
> >  rename Documentation/hwmon/{vt1211 => vt1211.rst} (100%)
> >  rename Documentation/hwmon/{w83627ehf => w83627ehf.rst} (100%)
> >  rename Documentation/hwmon/{w83627hf => w83627hf.rst} (100%)
> >  rename Documentation/hwmon/{w83773g => w83773g.rst} (100%)
> >  rename Documentation/hwmon/{w83781d => w83781d.rst} (100%)
> >  rename Documentation/hwmon/{w83791d => w83791d.rst} (99%)
> >  rename Documentation/hwmon/{w83792d => w83792d.rst} (100%)
> >  rename Documentation/hwmon/{w83793 => w83793.rst} (100%)
> >  rename Documentation/hwmon/{w83795 => w83795.rst} (100%)
> >  rename Documentation/hwmon/{w83l785ts => w83l785ts.rst} (100%)
> >  rename Documentation/hwmon/{w83l786ng => w83l786ng.rst} (100%)
> >  rename Documentation/hwmon/{wm831x => wm831x.rst} (100%)
> >  rename Documentation/hwmon/{wm8350 => wm8350.rst} (100%)
> >  rename Documentation/hwmon/{xgene-hwmon => xgene-hwmon.rst} (100%)
> >  rename Documentation/hwmon/{zl6100 => zl6100.rst} (98%)
> > 
> > diff --git a/Documentation/devicetree/bindings/hwmon/g762.txt b/Documentation/devicetree/bindings/hwmon/g762.txt
> > index 25cc6d8ee575..6d154c4923de 100644
> > --- a/Documentation/devicetree/bindings/hwmon/g762.txt
> > +++ b/Documentation/devicetree/bindings/hwmon/g762.txt
> > @@ -21,7 +21,7 @@ If an optional property is not set in .dts file, then current value is kept
> >  unmodified (e.g. u-boot installed value).
> >  
> >  Additional information on operational parameters for the device is available
> > -in Documentation/hwmon/g762. A detailed datasheet for the device is available
> > +in Documentation/hwmon/g762.rst. A detailed datasheet for the device is available
> >  at http://natisbad.org/NAS/refs/GMT_EDS-762_763-080710-0.2.pdf.
> >  
> >  Example g762 node:
> > diff --git a/Documentation/hwmon/ab8500 b/Documentation/hwmon/ab8500.rst
> > similarity index 86%
> > rename from Documentation/hwmon/ab8500
> > rename to Documentation/hwmon/ab8500.rst
> > index d87c61151239..33f93a9cec04 100644
> > --- a/Documentation/hwmon/ab8500
> > +++ b/Documentation/hwmon/ab8500.rst
> > @@ -18,7 +18,7 @@ Authors:
> >  Description
> >  -----------
> >  
> > -See also Documentation/hwmon/abx500. This is the ST-Ericsson AB8500 specific
> > +See also Documentation/hwmon/abx500.rst. This is the ST-Ericsson AB8500 specific
> >  driver.
> >  
> >  Currently only the AB8500 internal sensor and one external sensor for battery
> > diff --git a/Documentation/hwmon/abituguru-datasheet b/Documentation/hwmon/abituguru-datasheet.rst
> > similarity index 100%
> > rename from Documentation/hwmon/abituguru-datasheet
> > rename to Documentation/hwmon/abituguru-datasheet.rst
> > diff --git a/Documentation/hwmon/abituguru b/Documentation/hwmon/abituguru.rst
> > similarity index 100%
> > rename from Documentation/hwmon/abituguru
> > rename to Documentation/hwmon/abituguru.rst
> > diff --git a/Documentation/hwmon/abituguru3 b/Documentation/hwmon/abituguru3.rst
> > similarity index 100%
> > rename from Documentation/hwmon/abituguru3
> > rename to Documentation/hwmon/abituguru3.rst
> > diff --git a/Documentation/hwmon/abx500 b/Documentation/hwmon/abx500.rst
> > similarity index 100%
> > rename from Documentation/hwmon/abx500
> > rename to Documentation/hwmon/abx500.rst
> > diff --git a/Documentation/hwmon/acpi_power_meter b/Documentation/hwmon/acpi_power_meter.rst
> > similarity index 97%
> > rename from Documentation/hwmon/acpi_power_meter
> > rename to Documentation/hwmon/acpi_power_meter.rst
> > index 7665ca6ba957..4a0941ade0ca 100644
> > --- a/Documentation/hwmon/acpi_power_meter
> > +++ b/Documentation/hwmon/acpi_power_meter.rst
> > @@ -21,7 +21,7 @@ the ACPI 4.0 spec (Chapter 10.4).  These devices have a simple set of
> >  features--a power meter that returns average power use over a configurable
> >  interval, an optional capping mechanism, and a couple of trip points.  The
> >  sysfs interface conforms with the specification outlined in the "Power" section
> > -of Documentation/hwmon/sysfs-interface.
> > +of Documentation/hwmon/sysfs-interface.rst.
> >  
> >  Special Features
> >  ----------------
> > diff --git a/Documentation/hwmon/ad7314 b/Documentation/hwmon/ad7314.rst
> > similarity index 100%
> > rename from Documentation/hwmon/ad7314
> > rename to Documentation/hwmon/ad7314.rst
> > diff --git a/Documentation/hwmon/adc128d818 b/Documentation/hwmon/adc128d818.rst
> > similarity index 100%
> > rename from Documentation/hwmon/adc128d818
> > rename to Documentation/hwmon/adc128d818.rst
> > diff --git a/Documentation/hwmon/adm1021 b/Documentation/hwmon/adm1021.rst
> > similarity index 100%
> > rename from Documentation/hwmon/adm1021
> > rename to Documentation/hwmon/adm1021.rst
> > diff --git a/Documentation/hwmon/adm1025 b/Documentation/hwmon/adm1025.rst
> > similarity index 100%
> > rename from Documentation/hwmon/adm1025
> > rename to Documentation/hwmon/adm1025.rst
> > diff --git a/Documentation/hwmon/adm1026 b/Documentation/hwmon/adm1026.rst
> > similarity index 100%
> > rename from Documentation/hwmon/adm1026
> > rename to Documentation/hwmon/adm1026.rst
> > diff --git a/Documentation/hwmon/adm1031 b/Documentation/hwmon/adm1031.rst
> > similarity index 100%
> > rename from Documentation/hwmon/adm1031
> > rename to Documentation/hwmon/adm1031.rst
> > diff --git a/Documentation/hwmon/adm1275 b/Documentation/hwmon/adm1275.rst
> > similarity index 97%
> > rename from Documentation/hwmon/adm1275
> > rename to Documentation/hwmon/adm1275.rst
> > index 5c5860011d6e..9a1913e5b4d9 100644
> > --- a/Documentation/hwmon/adm1275
> > +++ b/Documentation/hwmon/adm1275.rst
> > @@ -68,7 +68,7 @@ integrated 12 bit analog-to-digital converter (ADC), accessed using a
> >  PMBus interface.
> >  
> >  The driver is a client driver to the core PMBus driver. Please see
> > -Documentation/hwmon/pmbus for details on PMBus client drivers.
> > +Documentation/hwmon/pmbus.rst for details on PMBus client drivers.
> >  
> >  
> >  Usage Notes
> > @@ -90,7 +90,7 @@ Platform data support
> >  ---------------------
> >  
> >  The driver supports standard PMBus driver platform data. Please see
> > -Documentation/hwmon/pmbus for details.
> > +Documentation/hwmon/pmbus.rst for details.
> >  
> >  
> >  Sysfs entries
> > diff --git a/Documentation/hwmon/adm9240 b/Documentation/hwmon/adm9240.rst
> > similarity index 100%
> > rename from Documentation/hwmon/adm9240
> > rename to Documentation/hwmon/adm9240.rst
> > diff --git a/Documentation/hwmon/ads1015 b/Documentation/hwmon/ads1015.rst
> > similarity index 100%
> > rename from Documentation/hwmon/ads1015
> > rename to Documentation/hwmon/ads1015.rst
> > diff --git a/Documentation/hwmon/ads7828 b/Documentation/hwmon/ads7828.rst
> > similarity index 100%
> > rename from Documentation/hwmon/ads7828
> > rename to Documentation/hwmon/ads7828.rst
> > diff --git a/Documentation/hwmon/adt7410 b/Documentation/hwmon/adt7410.rst
> > similarity index 100%
> > rename from Documentation/hwmon/adt7410
> > rename to Documentation/hwmon/adt7410.rst
> > diff --git a/Documentation/hwmon/adt7411 b/Documentation/hwmon/adt7411.rst
> > similarity index 100%
> > rename from Documentation/hwmon/adt7411
> > rename to Documentation/hwmon/adt7411.rst
> > diff --git a/Documentation/hwmon/adt7462 b/Documentation/hwmon/adt7462.rst
> > similarity index 99%
> > rename from Documentation/hwmon/adt7462
> > rename to Documentation/hwmon/adt7462.rst
> > index a7a831118d32..139e19696188 100644
> > --- a/Documentation/hwmon/adt7462
> > +++ b/Documentation/hwmon/adt7462.rst
> > @@ -68,4 +68,3 @@ The ADT7462 will scale the pwm between the lower and higher pwm speed when
> >  the temperature is between the two temperature boundaries.  PWM values range
> >  from 0 (off) to 255 (full speed).  Fan speed will be set to maximum when the
> >  temperature sensor associated with the PWM control exceeds temp#_max.
> > -
> > diff --git a/Documentation/hwmon/adt7470 b/Documentation/hwmon/adt7470.rst
> > similarity index 100%
> > rename from Documentation/hwmon/adt7470
> > rename to Documentation/hwmon/adt7470.rst
> > diff --git a/Documentation/hwmon/adt7475 b/Documentation/hwmon/adt7475.rst
> > similarity index 100%
> > rename from Documentation/hwmon/adt7475
> > rename to Documentation/hwmon/adt7475.rst
> > diff --git a/Documentation/hwmon/amc6821 b/Documentation/hwmon/amc6821.rst
> > similarity index 99%
> > rename from Documentation/hwmon/amc6821
> > rename to Documentation/hwmon/amc6821.rst
> > index d10eabcbc0f3..5ddb2849da90 100644
> > --- a/Documentation/hwmon/amc6821
> > +++ b/Documentation/hwmon/amc6821.rst
> > @@ -106,4 +106,3 @@ different settings, you can set the following parameters:
> >  
> >  - init=1,
> >  - pwminv: 0 default pwm output, 1 inverts pwm output.
> > -
> > diff --git a/Documentation/hwmon/asb100 b/Documentation/hwmon/asb100.rst
> > similarity index 99%
> > rename from Documentation/hwmon/asb100
> > rename to Documentation/hwmon/asb100.rst
> > index 311d9f7b6926..c2d5f97085fe 100644
> > --- a/Documentation/hwmon/asb100
> > +++ b/Documentation/hwmon/asb100.rst
> > @@ -71,4 +71,3 @@ TODO:
> >    * Experiment with temp. sensor types.
> >    * Are there really 13 voltage inputs? Probably not...
> >    * Cleanups, no doubt...
> > -
> > diff --git a/Documentation/hwmon/asc7621 b/Documentation/hwmon/asc7621.rst
> > similarity index 100%
> > rename from Documentation/hwmon/asc7621
> > rename to Documentation/hwmon/asc7621.rst
> > diff --git a/Documentation/hwmon/aspeed-pwm-tacho b/Documentation/hwmon/aspeed-pwm-tacho.rst
> > similarity index 100%
> > rename from Documentation/hwmon/aspeed-pwm-tacho
> > rename to Documentation/hwmon/aspeed-pwm-tacho.rst
> > diff --git a/Documentation/hwmon/coretemp b/Documentation/hwmon/coretemp.rst
> > similarity index 100%
> > rename from Documentation/hwmon/coretemp
> > rename to Documentation/hwmon/coretemp.rst
> > diff --git a/Documentation/hwmon/da9052 b/Documentation/hwmon/da9052.rst
> > similarity index 100%
> > rename from Documentation/hwmon/da9052
> > rename to Documentation/hwmon/da9052.rst
> > diff --git a/Documentation/hwmon/da9055 b/Documentation/hwmon/da9055.rst
> > similarity index 100%
> > rename from Documentation/hwmon/da9055
> > rename to Documentation/hwmon/da9055.rst
> > diff --git a/Documentation/hwmon/dme1737 b/Documentation/hwmon/dme1737.rst
> > similarity index 100%
> > rename from Documentation/hwmon/dme1737
> > rename to Documentation/hwmon/dme1737.rst
> > diff --git a/Documentation/hwmon/ds1621 b/Documentation/hwmon/ds1621.rst
> > similarity index 100%
> > rename from Documentation/hwmon/ds1621
> > rename to Documentation/hwmon/ds1621.rst
> > diff --git a/Documentation/hwmon/ds620 b/Documentation/hwmon/ds620.rst
> > similarity index 100%
> > rename from Documentation/hwmon/ds620
> > rename to Documentation/hwmon/ds620.rst
> > diff --git a/Documentation/hwmon/emc1403 b/Documentation/hwmon/emc1403.rst
> > similarity index 100%
> > rename from Documentation/hwmon/emc1403
> > rename to Documentation/hwmon/emc1403.rst
> > diff --git a/Documentation/hwmon/emc2103 b/Documentation/hwmon/emc2103.rst
> > similarity index 100%
> > rename from Documentation/hwmon/emc2103
> > rename to Documentation/hwmon/emc2103.rst
> > diff --git a/Documentation/hwmon/emc6w201 b/Documentation/hwmon/emc6w201.rst
> > similarity index 100%
> > rename from Documentation/hwmon/emc6w201
> > rename to Documentation/hwmon/emc6w201.rst
> > diff --git a/Documentation/hwmon/f71805f b/Documentation/hwmon/f71805f.rst
> > similarity index 100%
> > rename from Documentation/hwmon/f71805f
> > rename to Documentation/hwmon/f71805f.rst
> > diff --git a/Documentation/hwmon/f71882fg b/Documentation/hwmon/f71882fg.rst
> > similarity index 100%
> > rename from Documentation/hwmon/f71882fg
> > rename to Documentation/hwmon/f71882fg.rst
> > diff --git a/Documentation/hwmon/fam15h_power b/Documentation/hwmon/fam15h_power.rst
> > similarity index 100%
> > rename from Documentation/hwmon/fam15h_power
> > rename to Documentation/hwmon/fam15h_power.rst
> > diff --git a/Documentation/hwmon/ftsteutates b/Documentation/hwmon/ftsteutates.rst
> > similarity index 100%
> > rename from Documentation/hwmon/ftsteutates
> > rename to Documentation/hwmon/ftsteutates.rst
> > diff --git a/Documentation/hwmon/g760a b/Documentation/hwmon/g760a.rst
> > similarity index 100%
> > rename from Documentation/hwmon/g760a
> > rename to Documentation/hwmon/g760a.rst
> > diff --git a/Documentation/hwmon/g762 b/Documentation/hwmon/g762.rst
> > similarity index 97%
> > rename from Documentation/hwmon/g762
> > rename to Documentation/hwmon/g762.rst
> > index 54574e26df21..0371b3365c48 100644
> > --- a/Documentation/hwmon/g762
> > +++ b/Documentation/hwmon/g762.rst
> > @@ -7,7 +7,7 @@ modes - PWM or DC - are supported by the device.
> >  
> >  For additional information, a detailed datasheet is available at
> >  http://natisbad.org/NAS/ref/GMT_EDS-762_763-080710-0.2.pdf. sysfs
> > -bindings are described in Documentation/hwmon/sysfs-interface.
> > +bindings are described in Documentation/hwmon/sysfs-interface.rst.
> >  
> >  The following entries are available to the user in a subdirectory of
> >  /sys/bus/i2c/drivers/g762/ to control the operation of the device.
> > diff --git a/Documentation/hwmon/gl518sm b/Documentation/hwmon/gl518sm.rst
> > similarity index 100%
> > rename from Documentation/hwmon/gl518sm
> > rename to Documentation/hwmon/gl518sm.rst
> > diff --git a/Documentation/hwmon/hih6130 b/Documentation/hwmon/hih6130.rst
> > similarity index 100%
> > rename from Documentation/hwmon/hih6130
> > rename to Documentation/hwmon/hih6130.rst
> > diff --git a/Documentation/hwmon/hwmon-kernel-api.txt b/Documentation/hwmon/hwmon-kernel-api.rst
> > similarity index 99%
> > rename from Documentation/hwmon/hwmon-kernel-api.txt
> > rename to Documentation/hwmon/hwmon-kernel-api.rst
> > index b347b959fcda..c41eb6108103 100644
> > --- a/Documentation/hwmon/hwmon-kernel-api.txt
> > +++ b/Documentation/hwmon/hwmon-kernel-api.rst
> > @@ -12,10 +12,10 @@ drivers that want to use the hardware monitoring framework.
> >  This document does not describe what a hardware monitoring (hwmon) Driver or
> >  Device is. It also does not describe the API which can be used by user space
> >  to communicate with a hardware monitoring device. If you want to know this
> > -then please read the following file: Documentation/hwmon/sysfs-interface.
> > +then please read the following file: Documentation/hwmon/sysfs-interface.rst.
> >  
> >  For additional guidelines on how to write and improve hwmon drivers, please
> > -also read Documentation/hwmon/submitting-patches.
> > +also read Documentation/hwmon/submitting-patches.rst.
> >  
> >  The API
> >  -------
> > diff --git a/Documentation/hwmon/ibm-cffps b/Documentation/hwmon/ibm-cffps.rst
> > similarity index 100%
> > rename from Documentation/hwmon/ibm-cffps
> > rename to Documentation/hwmon/ibm-cffps.rst
> > diff --git a/Documentation/hwmon/ibmaem b/Documentation/hwmon/ibmaem.rst
> > similarity index 100%
> > rename from Documentation/hwmon/ibmaem
> > rename to Documentation/hwmon/ibmaem.rst
> > diff --git a/Documentation/hwmon/ibmpowernv b/Documentation/hwmon/ibmpowernv.rst
> > similarity index 100%
> > rename from Documentation/hwmon/ibmpowernv
> > rename to Documentation/hwmon/ibmpowernv.rst
> > diff --git a/Documentation/hwmon/ina209 b/Documentation/hwmon/ina209.rst
> > similarity index 100%
> > rename from Documentation/hwmon/ina209
> > rename to Documentation/hwmon/ina209.rst
> > diff --git a/Documentation/hwmon/ina2xx b/Documentation/hwmon/ina2xx.rst
> > similarity index 97%
> > rename from Documentation/hwmon/ina2xx
> > rename to Documentation/hwmon/ina2xx.rst
> > index 95badf9c396f..94b9a260c518 100644
> > --- a/Documentation/hwmon/ina2xx
> > +++ b/Documentation/hwmon/ina2xx.rst
> > @@ -78,7 +78,7 @@ refer to the Documentation/devicetree/bindings/hwmon/ina2xx.txt for bindings
> >  if the device tree is used.
> >  
> >  Additionally ina226 supports update_interval attribute as described in
> > -Documentation/hwmon/sysfs-interface. Internally the interval is the sum of
> > +Documentation/hwmon/sysfs-interface.rst. Internally the interval is the sum of
> >  bus and shunt voltage conversion times multiplied by the averaging rate. We
> >  don't touch the conversion times and only modify the number of averages. The
> >  lower limit of the update_interval is 2 ms, the upper limit is 2253 ms.
> > diff --git a/Documentation/hwmon/ina3221 b/Documentation/hwmon/ina3221.rst
> > similarity index 100%
> > rename from Documentation/hwmon/ina3221
> > rename to Documentation/hwmon/ina3221.rst
> > diff --git a/Documentation/hwmon/index.rst b/Documentation/hwmon/index.rst
> > new file mode 100644
> > index 000000000000..893804414510
> > --- /dev/null
> > +++ b/Documentation/hwmon/index.rst
> > @@ -0,0 +1,179 @@
> > +=========================
> > +Linux Hardware Monitoring
> > +=========================
> > +
> > +.. toctree::
> > +   :maxdepth: 1
> > +
> > +   hwmon-kernel-api.rst
> > +   pmbus-core.rst
> > +   submitting-patches.rst
> > +   sysfs-interface.rst
> > +   userspace-tools.rst
> > +
> > +Hardware Monitoring Kernel Drivers
> > +==================================
> > +
> > +.. toctree::
> > +   :maxdepth: 1
> > +
> > +   ab8500.rst
> > +   abituguru.rst
> > +   abituguru3.rst
> > +   abx500.rst
> > +   acpi_power_meter.rst
> > +   ad7314.rst
> > +   adc128d818.rst
> > +   adm1021.rst
> > +   adm1025.rst
> > +   adm1026.rst
> > +   adm1031.rst
> > +   adm1275.rst
> > +   adm9240.rst
> > +   ads1015.rst
> > +   ads7828.rst
> > +   adt7410.rst
> > +   adt7411.rst
> > +   adt7462.rst
> > +   adt7470.rst
> > +   adt7475.rst
> > +   amc6821.rst
> > +   asb100.rst
> > +   asc7621.rst
> > +   aspeed-pwm-tacho.rst
> > +   coretemp.rst
> > +   da9052.rst
> > +   da9055.rst
> > +   dme1737.rst
> > +   ds1621.rst
> > +   ds620.rst
> > +   emc1403.rst
> > +   emc2103.rst
> > +   emc6w201.rst
> > +   f71805f.rst
> > +   f71882fg.rst
> > +   fam15h_power.rst
> > +   ftsteutates.rst
> > +   g760a.rst
> > +   g762.rst
> > +   gl518sm.rst
> > +   hih6130.rst
> > +   ibmaem.rst
> > +   ibm-cffps.rst
> > +   ibmpowernv.rst
> > +   ina209.rst
> > +   ina2xx.rst
> > +   ina3221.rst
> > +   ir35221.rst
> > +   it87.rst
> > +   jc42.rst
> > +   k10temp.rst
> > +   k8temp.rst
> > +   lineage-pem.rst
> > +   lm25066.rst
> > +   lm63.rst
> > +   lm70.rst
> > +   lm73.rst
> > +   lm75.rst
> > +   lm77.rst
> > +   lm78.rst
> > +   lm80.rst
> > +   lm83.rst
> > +   lm85.rst
> > +   lm87.rst
> > +   lm90.rst
> > +   lm92.rst
> > +   lm93.rst
> > +   lm95234.rst
> > +   lm95245.rst
> > +   ltc2945.rst
> > +   ltc2978.rst
> > +   ltc2990.rst
> > +   ltc3815.rst
> > +   ltc4151.rst
> > +   ltc4215.rst
> > +   ltc4245.rst
> > +   ltc4260.rst
> > +   ltc4261.rst
> > +   max16064.rst
> > +   max16065.rst
> > +   max1619.rst
> > +   max1668.rst
> > +   max197.rst
> > +   max20751.rst
> > +   max31722.rst
> > +   max31785.rst
> > +   max31790.rst
> > +   max34440.rst
> > +   max6639.rst
> > +   max6642.rst
> > +   max6650.rst
> > +   max6697.rst
> > +   max8688.rst
> > +   mc13783-adc.rst
> > +   mcp3021.rst
> > +   menf21bmc.rst
> > +   mlxreg-fan.rst
> > +   nct6683.rst
> > +   nct6775.rst
> > +   nct7802.rst
> > +   nct7904.rst
> > +   npcm750-pwm-fan.rst
> > +   nsa320.rst
> > +   ntc_thermistor.rst
> > +   occ.rst
> > +   pc87360.rst
> > +   pc87427.rst
> > +   pcf8591.rst
> > +   pmbus.rst
> > +   powr1220.rst
> > +   pwm-fan.rst
> > +   raspberrypi-hwmon.rst
> > +   sch5627.rst
> > +   sch5636.rst
> > +   scpi-hwmon.rst
> > +   sht15.rst
> > +   sht21.rst
> > +   sht3x.rst
> > +   shtc1.rst
> > +   sis5595.rst
> > +   smm665.rst
> > +   smsc47b397.rst
> > +   smsc47m192.rst
> > +   smsc47m1.rst
> > +   tc654.rst
> > +   tc74.rst
> > +   thmc50.rst
> > +   tmp102.rst
> > +   tmp103.rst
> > +   tmp108.rst
> > +   tmp401.rst
> > +   tmp421.rst
> > +   tps40422.rst
> > +   twl4030-madc-hwmon.rst
> > +   ucd9000.rst
> > +   ucd9200.rst
> > +   vexpress.rst
> > +   via686a.rst
> > +   vt1211.rst
> > +   w83627ehf.rst
> > +   w83627hf.rst
> > +   w83773g.rst
> > +   w83781d.rst
> > +   w83791d.rst
> > +   w83792d.rst
> > +   w83793.rst
> > +   w83795.rst
> > +   w83l785ts.rst
> > +   w83l786ng.rst
> > +   wm831x.rst
> > +   wm8350.rst
> > +   xgene-hwmon.rst
> > +   zl6100.rst
> > +
> > +.. only::  subproject and html
> > +
> > +   Indices
> > +   =======
> > +
> > +   * :ref:`genindex`
> > diff --git a/Documentation/hwmon/ir35221 b/Documentation/hwmon/ir35221.rst
> > similarity index 100%
> > rename from Documentation/hwmon/ir35221
> > rename to Documentation/hwmon/ir35221.rst
> > diff --git a/Documentation/hwmon/it87 b/Documentation/hwmon/it87.rst
> > similarity index 100%
> > rename from Documentation/hwmon/it87
> > rename to Documentation/hwmon/it87.rst
> > diff --git a/Documentation/hwmon/jc42 b/Documentation/hwmon/jc42.rst
> > similarity index 100%
> > rename from Documentation/hwmon/jc42
> > rename to Documentation/hwmon/jc42.rst
> > diff --git a/Documentation/hwmon/k10temp b/Documentation/hwmon/k10temp.rst
> > similarity index 100%
> > rename from Documentation/hwmon/k10temp
> > rename to Documentation/hwmon/k10temp.rst
> > diff --git a/Documentation/hwmon/k8temp b/Documentation/hwmon/k8temp.rst
> > similarity index 100%
> > rename from Documentation/hwmon/k8temp
> > rename to Documentation/hwmon/k8temp.rst
> > diff --git a/Documentation/hwmon/lineage-pem b/Documentation/hwmon/lineage-pem.rst
> > similarity index 100%
> > rename from Documentation/hwmon/lineage-pem
> > rename to Documentation/hwmon/lineage-pem.rst
> > diff --git a/Documentation/hwmon/lm25066 b/Documentation/hwmon/lm25066.rst
> > similarity index 97%
> > rename from Documentation/hwmon/lm25066
> > rename to Documentation/hwmon/lm25066.rst
> > index 60b7f2722931..da15e3094c8c 100644
> > --- a/Documentation/hwmon/lm25066
> > +++ b/Documentation/hwmon/lm25066.rst
> > @@ -69,7 +69,7 @@ LM25066, LM5064, and LM5066/LM5066I Power Management, Monitoring,
> >  Control, and Protection ICs.
> >  
> >  The driver is a client driver to the core PMBus driver. Please see
> > -Documentation/hwmon/pmbus for details on PMBus client drivers.
> > +Documentation/hwmon/pmbus.rst for details on PMBus client drivers.
> >  
> >  
> >  Usage Notes
> > diff --git a/Documentation/hwmon/lm63 b/Documentation/hwmon/lm63.rst
> > similarity index 100%
> > rename from Documentation/hwmon/lm63
> > rename to Documentation/hwmon/lm63.rst
> > diff --git a/Documentation/hwmon/lm70 b/Documentation/hwmon/lm70.rst
> > similarity index 100%
> > rename from Documentation/hwmon/lm70
> > rename to Documentation/hwmon/lm70.rst
> > diff --git a/Documentation/hwmon/lm73 b/Documentation/hwmon/lm73.rst
> > similarity index 100%
> > rename from Documentation/hwmon/lm73
> > rename to Documentation/hwmon/lm73.rst
> > diff --git a/Documentation/hwmon/lm75 b/Documentation/hwmon/lm75.rst
> > similarity index 100%
> > rename from Documentation/hwmon/lm75
> > rename to Documentation/hwmon/lm75.rst
> > diff --git a/Documentation/hwmon/lm77 b/Documentation/hwmon/lm77.rst
> > similarity index 100%
> > rename from Documentation/hwmon/lm77
> > rename to Documentation/hwmon/lm77.rst
> > diff --git a/Documentation/hwmon/lm78 b/Documentation/hwmon/lm78.rst
> > similarity index 100%
> > rename from Documentation/hwmon/lm78
> > rename to Documentation/hwmon/lm78.rst
> > diff --git a/Documentation/hwmon/lm80 b/Documentation/hwmon/lm80.rst
> > similarity index 100%
> > rename from Documentation/hwmon/lm80
> > rename to Documentation/hwmon/lm80.rst
> > diff --git a/Documentation/hwmon/lm83 b/Documentation/hwmon/lm83.rst
> > similarity index 100%
> > rename from Documentation/hwmon/lm83
> > rename to Documentation/hwmon/lm83.rst
> > diff --git a/Documentation/hwmon/lm85 b/Documentation/hwmon/lm85.rst
> > similarity index 100%
> > rename from Documentation/hwmon/lm85
> > rename to Documentation/hwmon/lm85.rst
> > diff --git a/Documentation/hwmon/lm87 b/Documentation/hwmon/lm87.rst
> > similarity index 100%
> > rename from Documentation/hwmon/lm87
> > rename to Documentation/hwmon/lm87.rst
> > diff --git a/Documentation/hwmon/lm90 b/Documentation/hwmon/lm90.rst
> > similarity index 100%
> > rename from Documentation/hwmon/lm90
> > rename to Documentation/hwmon/lm90.rst
> > diff --git a/Documentation/hwmon/lm92 b/Documentation/hwmon/lm92.rst
> > similarity index 100%
> > rename from Documentation/hwmon/lm92
> > rename to Documentation/hwmon/lm92.rst
> > diff --git a/Documentation/hwmon/lm93 b/Documentation/hwmon/lm93.rst
> > similarity index 100%
> > rename from Documentation/hwmon/lm93
> > rename to Documentation/hwmon/lm93.rst
> > diff --git a/Documentation/hwmon/lm95234 b/Documentation/hwmon/lm95234.rst
> > similarity index 100%
> > rename from Documentation/hwmon/lm95234
> > rename to Documentation/hwmon/lm95234.rst
> > diff --git a/Documentation/hwmon/lm95245 b/Documentation/hwmon/lm95245.rst
> > similarity index 100%
> > rename from Documentation/hwmon/lm95245
> > rename to Documentation/hwmon/lm95245.rst
> > diff --git a/Documentation/hwmon/ltc2945 b/Documentation/hwmon/ltc2945.rst
> > similarity index 100%
> > rename from Documentation/hwmon/ltc2945
> > rename to Documentation/hwmon/ltc2945.rst
> > diff --git a/Documentation/hwmon/ltc2978 b/Documentation/hwmon/ltc2978.rst
> > similarity index 100%
> > rename from Documentation/hwmon/ltc2978
> > rename to Documentation/hwmon/ltc2978.rst
> > diff --git a/Documentation/hwmon/ltc2990 b/Documentation/hwmon/ltc2990.rst
> > similarity index 100%
> > rename from Documentation/hwmon/ltc2990
> > rename to Documentation/hwmon/ltc2990.rst
> > diff --git a/Documentation/hwmon/ltc3815 b/Documentation/hwmon/ltc3815.rst
> > similarity index 100%
> > rename from Documentation/hwmon/ltc3815
> > rename to Documentation/hwmon/ltc3815.rst
> > diff --git a/Documentation/hwmon/ltc4151 b/Documentation/hwmon/ltc4151.rst
> > similarity index 100%
> > rename from Documentation/hwmon/ltc4151
> > rename to Documentation/hwmon/ltc4151.rst
> > diff --git a/Documentation/hwmon/ltc4215 b/Documentation/hwmon/ltc4215.rst
> > similarity index 100%
> > rename from Documentation/hwmon/ltc4215
> > rename to Documentation/hwmon/ltc4215.rst
> > diff --git a/Documentation/hwmon/ltc4245 b/Documentation/hwmon/ltc4245.rst
> > similarity index 100%
> > rename from Documentation/hwmon/ltc4245
> > rename to Documentation/hwmon/ltc4245.rst
> > diff --git a/Documentation/hwmon/ltc4260 b/Documentation/hwmon/ltc4260.rst
> > similarity index 100%
> > rename from Documentation/hwmon/ltc4260
> > rename to Documentation/hwmon/ltc4260.rst
> > diff --git a/Documentation/hwmon/ltc4261 b/Documentation/hwmon/ltc4261.rst
> > similarity index 100%
> > rename from Documentation/hwmon/ltc4261
> > rename to Documentation/hwmon/ltc4261.rst
> > diff --git a/Documentation/hwmon/max16064 b/Documentation/hwmon/max16064.rst
> > similarity index 96%
> > rename from Documentation/hwmon/max16064
> > rename to Documentation/hwmon/max16064.rst
> > index 61ec679dc477..6d5e9538991f 100644
> > --- a/Documentation/hwmon/max16064
> > +++ b/Documentation/hwmon/max16064.rst
> > @@ -21,7 +21,7 @@ This driver supports hardware monitoring for Maxim MAX16064 Quad Power-Supply
> >  Controller with Active-Voltage Output Control and PMBus Interface.
> >  
> >  The driver is a client driver to the core PMBus driver.
> > -Please see Documentation/hwmon/pmbus for details on PMBus client drivers.
> > +Please see Documentation/hwmon/pmbus.rst for details on PMBus client drivers.
> >  
> >  
> >  Usage Notes
> > diff --git a/Documentation/hwmon/max16065 b/Documentation/hwmon/max16065.rst
> > similarity index 100%
> > rename from Documentation/hwmon/max16065
> > rename to Documentation/hwmon/max16065.rst
> > diff --git a/Documentation/hwmon/max1619 b/Documentation/hwmon/max1619.rst
> > similarity index 99%
> > rename from Documentation/hwmon/max1619
> > rename to Documentation/hwmon/max1619.rst
> > index 4b3762c4eceb..e25956e70f73 100644
> > --- a/Documentation/hwmon/max1619
> > +++ b/Documentation/hwmon/max1619.rst
> > @@ -31,4 +31,3 @@ Only the external sensor has high and low limits.
> >  The max1619 driver will not update its values more frequently than every
> >  other second; reading them more often will do no harm, but will return
> >  'old' values.
> > -
> > diff --git a/Documentation/hwmon/max1668 b/Documentation/hwmon/max1668.rst
> > similarity index 100%
> > rename from Documentation/hwmon/max1668
> > rename to Documentation/hwmon/max1668.rst
> > diff --git a/Documentation/hwmon/max197 b/Documentation/hwmon/max197.rst
> > similarity index 100%
> > rename from Documentation/hwmon/max197
> > rename to Documentation/hwmon/max197.rst
> > diff --git a/Documentation/hwmon/max20751 b/Documentation/hwmon/max20751.rst
> > similarity index 96%
> > rename from Documentation/hwmon/max20751
> > rename to Documentation/hwmon/max20751.rst
> > index d546695900ef..aa4469be6674 100644
> > --- a/Documentation/hwmon/max20751
> > +++ b/Documentation/hwmon/max20751.rst
> > @@ -23,7 +23,7 @@ This driver supports MAX20751 Multiphase Master with PMBus Interface
> >  and Internal Buck Converter.
> >  
> >  The driver is a client driver to the core PMBus driver.
> > -Please see Documentation/hwmon/pmbus for details on PMBus client drivers.
> > +Please see Documentation/hwmon/pmbus.rst for details on PMBus client drivers.
> >  
> >  
> >  Usage Notes
> > diff --git a/Documentation/hwmon/max31722 b/Documentation/hwmon/max31722.rst
> > similarity index 100%
> > rename from Documentation/hwmon/max31722
> > rename to Documentation/hwmon/max31722.rst
> > diff --git a/Documentation/hwmon/max31785 b/Documentation/hwmon/max31785.rst
> > similarity index 100%
> > rename from Documentation/hwmon/max31785
> > rename to Documentation/hwmon/max31785.rst
> > diff --git a/Documentation/hwmon/max31790 b/Documentation/hwmon/max31790.rst
> > similarity index 100%
> > rename from Documentation/hwmon/max31790
> > rename to Documentation/hwmon/max31790.rst
> > diff --git a/Documentation/hwmon/max34440 b/Documentation/hwmon/max34440.rst
> > similarity index 98%
> > rename from Documentation/hwmon/max34440
> > rename to Documentation/hwmon/max34440.rst
> > index 639838ef29fd..939138e12b02 100644
> > --- a/Documentation/hwmon/max34440
> > +++ b/Documentation/hwmon/max34440.rst
> > @@ -76,7 +76,7 @@ based on GIN pins. The MAX34460 supports 12 voltage channels, and the MAX34461
> >  supports 16 voltage channels.
> >  
> >  The driver is a client driver to the core PMBus driver. Please see
> > -Documentation/hwmon/pmbus for details on PMBus client drivers.
> > +Documentation/hwmon/pmbus.rst for details on PMBus client drivers.
> >  
> >  
> >  Usage Notes
> > diff --git a/Documentation/hwmon/max6639 b/Documentation/hwmon/max6639.rst
> > similarity index 100%
> > rename from Documentation/hwmon/max6639
> > rename to Documentation/hwmon/max6639.rst
> > diff --git a/Documentation/hwmon/max6642 b/Documentation/hwmon/max6642.rst
> > similarity index 100%
> > rename from Documentation/hwmon/max6642
> > rename to Documentation/hwmon/max6642.rst
> > diff --git a/Documentation/hwmon/max6650 b/Documentation/hwmon/max6650.rst
> > similarity index 99%
> > rename from Documentation/hwmon/max6650
> > rename to Documentation/hwmon/max6650.rst
> > index 74dc3f0caaa2..253482add082 100644
> > --- a/Documentation/hwmon/max6650
> > +++ b/Documentation/hwmon/max6650.rst
> > @@ -72,4 +72,3 @@ clock: The clock frequency in Hz of the chip the driver should assume [254000]
> >  
> >  Please have a look at the MAX6650/6651 data sheet and make sure that you fully
> >  understand the meaning of these parameters before you attempt to change them.
> > -
> > diff --git a/Documentation/hwmon/max6697 b/Documentation/hwmon/max6697.rst
> > similarity index 100%
> > rename from Documentation/hwmon/max6697
> > rename to Documentation/hwmon/max6697.rst
> > diff --git a/Documentation/hwmon/max8688 b/Documentation/hwmon/max8688.rst
> > similarity index 97%
> > rename from Documentation/hwmon/max8688
> > rename to Documentation/hwmon/max8688.rst
> > index 43da139234c1..009487759c61 100644
> > --- a/Documentation/hwmon/max8688
> > +++ b/Documentation/hwmon/max8688.rst
> > @@ -21,7 +21,7 @@ This driver supports hardware monitoring for Maxim MAX8688 Digital Power-Supply
> >  Controller/Monitor with PMBus Interface.
> >  
> >  The driver is a client driver to the core PMBus driver. Please see
> > -Documentation/hwmon/pmbus for details on PMBus client drivers.
> > +Documentation/hwmon/pmbus.rst for details on PMBus client drivers.
> >  
> >  
> >  Usage Notes
> > diff --git a/Documentation/hwmon/mc13783-adc b/Documentation/hwmon/mc13783-adc.rst
> > similarity index 100%
> > rename from Documentation/hwmon/mc13783-adc
> > rename to Documentation/hwmon/mc13783-adc.rst
> > diff --git a/Documentation/hwmon/mcp3021 b/Documentation/hwmon/mcp3021.rst
> > similarity index 100%
> > rename from Documentation/hwmon/mcp3021
> > rename to Documentation/hwmon/mcp3021.rst
> > diff --git a/Documentation/hwmon/menf21bmc b/Documentation/hwmon/menf21bmc.rst
> > similarity index 100%
> > rename from Documentation/hwmon/menf21bmc
> > rename to Documentation/hwmon/menf21bmc.rst
> > diff --git a/Documentation/hwmon/mlxreg-fan b/Documentation/hwmon/mlxreg-fan.rst
> > similarity index 100%
> > rename from Documentation/hwmon/mlxreg-fan
> > rename to Documentation/hwmon/mlxreg-fan.rst
> > diff --git a/Documentation/hwmon/nct6683 b/Documentation/hwmon/nct6683.rst
> > similarity index 100%
> > rename from Documentation/hwmon/nct6683
> > rename to Documentation/hwmon/nct6683.rst
> > diff --git a/Documentation/hwmon/nct6775 b/Documentation/hwmon/nct6775.rst
> > similarity index 100%
> > rename from Documentation/hwmon/nct6775
> > rename to Documentation/hwmon/nct6775.rst
> > diff --git a/Documentation/hwmon/nct7802 b/Documentation/hwmon/nct7802.rst
> > similarity index 100%
> > rename from Documentation/hwmon/nct7802
> > rename to Documentation/hwmon/nct7802.rst
> > diff --git a/Documentation/hwmon/nct7904 b/Documentation/hwmon/nct7904.rst
> > similarity index 100%
> > rename from Documentation/hwmon/nct7904
> > rename to Documentation/hwmon/nct7904.rst
> > diff --git a/Documentation/hwmon/npcm750-pwm-fan b/Documentation/hwmon/npcm750-pwm-fan.rst
> > similarity index 100%
> > rename from Documentation/hwmon/npcm750-pwm-fan
> > rename to Documentation/hwmon/npcm750-pwm-fan.rst
> > diff --git a/Documentation/hwmon/nsa320 b/Documentation/hwmon/nsa320.rst
> > similarity index 100%
> > rename from Documentation/hwmon/nsa320
> > rename to Documentation/hwmon/nsa320.rst
> > diff --git a/Documentation/hwmon/ntc_thermistor b/Documentation/hwmon/ntc_thermistor.rst
> > similarity index 100%
> > rename from Documentation/hwmon/ntc_thermistor
> > rename to Documentation/hwmon/ntc_thermistor.rst
> > diff --git a/Documentation/hwmon/occ b/Documentation/hwmon/occ.rst
> > similarity index 100%
> > rename from Documentation/hwmon/occ
> > rename to Documentation/hwmon/occ.rst
> > diff --git a/Documentation/hwmon/pc87360 b/Documentation/hwmon/pc87360.rst
> > similarity index 100%
> > rename from Documentation/hwmon/pc87360
> > rename to Documentation/hwmon/pc87360.rst
> > diff --git a/Documentation/hwmon/pc87427 b/Documentation/hwmon/pc87427.rst
> > similarity index 100%
> > rename from Documentation/hwmon/pc87427
> > rename to Documentation/hwmon/pc87427.rst
> > diff --git a/Documentation/hwmon/pcf8591 b/Documentation/hwmon/pcf8591.rst
> > similarity index 100%
> > rename from Documentation/hwmon/pcf8591
> > rename to Documentation/hwmon/pcf8591.rst
> > diff --git a/Documentation/hwmon/pmbus-core b/Documentation/hwmon/pmbus-core.rst
> > similarity index 100%
> > rename from Documentation/hwmon/pmbus-core
> > rename to Documentation/hwmon/pmbus-core.rst
> > diff --git a/Documentation/hwmon/pmbus b/Documentation/hwmon/pmbus.rst
> > similarity index 100%
> > rename from Documentation/hwmon/pmbus
> > rename to Documentation/hwmon/pmbus.rst
> > diff --git a/Documentation/hwmon/powr1220 b/Documentation/hwmon/powr1220.rst
> > similarity index 100%
> > rename from Documentation/hwmon/powr1220
> > rename to Documentation/hwmon/powr1220.rst
> > diff --git a/Documentation/hwmon/pwm-fan b/Documentation/hwmon/pwm-fan.rst
> > similarity index 100%
> > rename from Documentation/hwmon/pwm-fan
> > rename to Documentation/hwmon/pwm-fan.rst
> > diff --git a/Documentation/hwmon/raspberrypi-hwmon b/Documentation/hwmon/raspberrypi-hwmon.rst
> > similarity index 100%
> > rename from Documentation/hwmon/raspberrypi-hwmon
> > rename to Documentation/hwmon/raspberrypi-hwmon.rst
> > diff --git a/Documentation/hwmon/sch5627 b/Documentation/hwmon/sch5627.rst
> > similarity index 100%
> > rename from Documentation/hwmon/sch5627
> > rename to Documentation/hwmon/sch5627.rst
> > diff --git a/Documentation/hwmon/sch5636 b/Documentation/hwmon/sch5636.rst
> > similarity index 100%
> > rename from Documentation/hwmon/sch5636
> > rename to Documentation/hwmon/sch5636.rst
> > diff --git a/Documentation/hwmon/scpi-hwmon b/Documentation/hwmon/scpi-hwmon.rst
> > similarity index 100%
> > rename from Documentation/hwmon/scpi-hwmon
> > rename to Documentation/hwmon/scpi-hwmon.rst
> > diff --git a/Documentation/hwmon/sht15 b/Documentation/hwmon/sht15.rst
> > similarity index 100%
> > rename from Documentation/hwmon/sht15
> > rename to Documentation/hwmon/sht15.rst
> > diff --git a/Documentation/hwmon/sht21 b/Documentation/hwmon/sht21.rst
> > similarity index 100%
> > rename from Documentation/hwmon/sht21
> > rename to Documentation/hwmon/sht21.rst
> > diff --git a/Documentation/hwmon/sht3x b/Documentation/hwmon/sht3x.rst
> > similarity index 100%
> > rename from Documentation/hwmon/sht3x
> > rename to Documentation/hwmon/sht3x.rst
> > diff --git a/Documentation/hwmon/shtc1 b/Documentation/hwmon/shtc1.rst
> > similarity index 100%
> > rename from Documentation/hwmon/shtc1
> > rename to Documentation/hwmon/shtc1.rst
> > diff --git a/Documentation/hwmon/sis5595 b/Documentation/hwmon/sis5595.rst
> > similarity index 99%
> > rename from Documentation/hwmon/sis5595
> > rename to Documentation/hwmon/sis5595.rst
> > index 5acba6b0c0db..16123b3bfff9 100644
> > --- a/Documentation/hwmon/sis5595
> > +++ b/Documentation/hwmon/sis5595.rst
> > @@ -121,4 +121,3 @@ Problems
> >  --------
> >  Some chips refuse to be enabled. We don't know why.
> >  The driver will recognize this and print a message in dmesg.
> > -
> > diff --git a/Documentation/hwmon/smm665 b/Documentation/hwmon/smm665.rst
> > similarity index 100%
> > rename from Documentation/hwmon/smm665
> > rename to Documentation/hwmon/smm665.rst
> > diff --git a/Documentation/hwmon/smsc47b397 b/Documentation/hwmon/smsc47b397.rst
> > similarity index 100%
> > rename from Documentation/hwmon/smsc47b397
> > rename to Documentation/hwmon/smsc47b397.rst
> > diff --git a/Documentation/hwmon/smsc47m1 b/Documentation/hwmon/smsc47m1.rst
> > similarity index 100%
> > rename from Documentation/hwmon/smsc47m1
> > rename to Documentation/hwmon/smsc47m1.rst
> > diff --git a/Documentation/hwmon/smsc47m192 b/Documentation/hwmon/smsc47m192.rst
> > similarity index 100%
> > rename from Documentation/hwmon/smsc47m192
> > rename to Documentation/hwmon/smsc47m192.rst
> > diff --git a/Documentation/hwmon/submitting-patches b/Documentation/hwmon/submitting-patches.rst
> > similarity index 98%
> > rename from Documentation/hwmon/submitting-patches
> > rename to Documentation/hwmon/submitting-patches.rst
> > index 12540b7d9b50..f9796b9d9db6 100644
> > --- a/Documentation/hwmon/submitting-patches
> > +++ b/Documentation/hwmon/submitting-patches.rst
> > @@ -39,7 +39,7 @@ increase the chances of your change being accepted.
> >  2. Adding functionality to existing drivers
> >  -------------------------------------------
> >  
> > -* Make sure the documentation in Documentation/hwmon/<driver_name> is up to
> > +* Make sure the documentation in Documentation/hwmon/<driver_name>.rst is up to
> >    date.
> >  
> >  * Make sure the information in Kconfig is up to date.
> > @@ -61,7 +61,7 @@ increase the chances of your change being accepted.
> >  
> >  * Consider adding yourself to MAINTAINERS.
> >  
> > -* Document the driver in Documentation/hwmon/<driver_name>.
> > +* Document the driver in Documentation/hwmon/<driver_name>.rst.
> >  
> >  * Add the driver to Kconfig and Makefile in alphabetical order.
> >  
> > @@ -134,7 +134,7 @@ increase the chances of your change being accepted.
> >    non-standard attributes, or you believe you do, discuss it on the mailing list
> >    first. Either case, provide a detailed explanation why you need the
> >    non-standard attribute(s).
> > -  Standard attributes are specified in Documentation/hwmon/sysfs-interface.
> > +  Standard attributes are specified in Documentation/hwmon/sysfs-interface.rst.
> >  
> >  * When deciding which sysfs attributes to support, look at the chip's
> >    capabilities. While we do not expect your driver to support everything the
> > diff --git a/Documentation/hwmon/sysfs-interface b/Documentation/hwmon/sysfs-interface.rst
> > similarity index 100%
> > rename from Documentation/hwmon/sysfs-interface
> > rename to Documentation/hwmon/sysfs-interface.rst
> > diff --git a/Documentation/hwmon/tc654 b/Documentation/hwmon/tc654.rst
> > similarity index 100%
> > rename from Documentation/hwmon/tc654
> > rename to Documentation/hwmon/tc654.rst
> > diff --git a/Documentation/hwmon/tc74 b/Documentation/hwmon/tc74.rst
> > similarity index 100%
> > rename from Documentation/hwmon/tc74
> > rename to Documentation/hwmon/tc74.rst
> > diff --git a/Documentation/hwmon/thmc50 b/Documentation/hwmon/thmc50.rst
> > similarity index 99%
> > rename from Documentation/hwmon/thmc50
> > rename to Documentation/hwmon/thmc50.rst
> > index 6dba1b59b20c..cfff3885287d 100644
> > --- a/Documentation/hwmon/thmc50
> > +++ b/Documentation/hwmon/thmc50.rst
> > @@ -87,4 +87,3 @@ so it stops fans even if the value 0 into the ANALOG_OUT register does not.
> >  
> >  The driver was tested on Compaq AP550 with two ADM1022 chips (one works
> >  in the temp3 mode), five temperature readings and two fans.
> > -
> > diff --git a/Documentation/hwmon/tmp102 b/Documentation/hwmon/tmp102.rst
> > similarity index 93%
> > rename from Documentation/hwmon/tmp102
> > rename to Documentation/hwmon/tmp102.rst
> > index 5e34821df4ab..b1f585531a88 100644
> > --- a/Documentation/hwmon/tmp102
> > +++ b/Documentation/hwmon/tmp102.rst
> > @@ -28,4 +28,4 @@ The TMP102 has a programmable update rate that can select between 8, 4, 1, and
> >  0.5 Hz. (Currently the driver only supports the default of 4 Hz).
> >  
> >  The driver provides the common sysfs-interface for temperatures (see
> > -Documentation/hwmon/sysfs-interface under Temperatures).
> > +Documentation/hwmon/sysfs-interface.rst under Temperatures).
> > diff --git a/Documentation/hwmon/tmp103 b/Documentation/hwmon/tmp103.rst
> > similarity index 92%
> > rename from Documentation/hwmon/tmp103
> > rename to Documentation/hwmon/tmp103.rst
> > index 7682a795e38c..15d25806d585 100644
> > --- a/Documentation/hwmon/tmp103
> > +++ b/Documentation/hwmon/tmp103.rst
> > @@ -27,7 +27,7 @@ Resolution: 8 Bits
> >  Accuracy: ±1°C Typ (–10°C to +100°C)
> >  
> >  The driver provides the common sysfs-interface for temperatures (see
> > -Documentation/hwmon/sysfs-interface under Temperatures).
> > +Documentation/hwmon/sysfs-interface.rst under Temperatures).
> >  
> >  Please refer how to instantiate this driver:
> >  Documentation/i2c/instantiating-devices
> > diff --git a/Documentation/hwmon/tmp108 b/Documentation/hwmon/tmp108.rst
> > similarity index 95%
> > rename from Documentation/hwmon/tmp108
> > rename to Documentation/hwmon/tmp108.rst
> > index 7e08b7ef1e2f..5f4266a16cb2 100644
> > --- a/Documentation/hwmon/tmp108
> > +++ b/Documentation/hwmon/tmp108.rst
> > @@ -38,4 +38,4 @@ and then the device is shut down automatically. (This driver only supports
> >  continuous mode.)
> >  
> >  The driver provides the common sysfs-interface for temperatures (see
> > -Documentation/hwmon/sysfs-interface under Temperatures).
> > +Documentation/hwmon/sysfs-interface.rst under Temperatures).
> > diff --git a/Documentation/hwmon/tmp401 b/Documentation/hwmon/tmp401.rst
> > similarity index 97%
> > rename from Documentation/hwmon/tmp401
> > rename to Documentation/hwmon/tmp401.rst
> > index bd865bbdb38d..6a05a0719bc7 100644
> > --- a/Documentation/hwmon/tmp401
> > +++ b/Documentation/hwmon/tmp401.rst
> > @@ -68,7 +68,7 @@ supported by the driver so far, so using the default resolution of 0.5
> >  degree).
> >  
> >  The driver provides the common sysfs-interface for temperatures (see
> > -Documentation/hwmon/sysfs-interface under Temperatures).
> > +Documentation/hwmon/sysfs-interface.rst under Temperatures).
> >  
> >  The TMP411 and TMP431 chips are compatible with TMP401. TMP411 provides
> >  some additional features.
> > diff --git a/Documentation/hwmon/tmp421 b/Documentation/hwmon/tmp421.rst
> > similarity index 100%
> > rename from Documentation/hwmon/tmp421
> > rename to Documentation/hwmon/tmp421.rst
> > diff --git a/Documentation/hwmon/tps40422 b/Documentation/hwmon/tps40422.rst
> > similarity index 96%
> > rename from Documentation/hwmon/tps40422
> > rename to Documentation/hwmon/tps40422.rst
> > index 359751eb5ed4..b691e30479dd 100644
> > --- a/Documentation/hwmon/tps40422
> > +++ b/Documentation/hwmon/tps40422.rst
> > @@ -21,7 +21,7 @@ This driver supports TI TPS40422 Dual-Output or Two-Phase Synchronous Buck
> >  Controller with PMBus
> >  
> >  The driver is a client driver to the core PMBus driver.
> > -Please see Documentation/hwmon/pmbus for details on PMBus client drivers.
> > +Please see Documentation/hwmon/pmbus.rst for details on PMBus client drivers.
> >  
> >  
> >  Usage Notes
> > diff --git a/Documentation/hwmon/twl4030-madc-hwmon b/Documentation/hwmon/twl4030-madc-hwmon.rst
> > similarity index 100%
> > rename from Documentation/hwmon/twl4030-madc-hwmon
> > rename to Documentation/hwmon/twl4030-madc-hwmon.rst
> > diff --git a/Documentation/hwmon/ucd9000 b/Documentation/hwmon/ucd9000.rst
> > similarity index 97%
> > rename from Documentation/hwmon/ucd9000
> > rename to Documentation/hwmon/ucd9000.rst
> > index d69061b7312c..ebc4f2b3bfea 100644
> > --- a/Documentation/hwmon/ucd9000
> > +++ b/Documentation/hwmon/ucd9000.rst
> > @@ -57,7 +57,7 @@ system-health monitor. The device integrates a 12-bit ADC for monitoring up to
> >  13 power-supply voltage, current, or temperature inputs.
> >  
> >  This driver is a client driver to the core PMBus driver. Please see
> > -Documentation/hwmon/pmbus for details on PMBus client drivers.
> > +Documentation/hwmon/pmbus.rst for details on PMBus client drivers.
> >  
> >  
> >  Usage Notes
> > @@ -72,7 +72,7 @@ Platform data support
> >  ---------------------
> >  
> >  The driver supports standard PMBus driver platform data. Please see
> > -Documentation/hwmon/pmbus for details.
> > +Documentation/hwmon/pmbus.rst for details.
> >  
> >  
> >  Sysfs entries
> > diff --git a/Documentation/hwmon/ucd9200 b/Documentation/hwmon/ucd9200.rst
> > similarity index 97%
> > rename from Documentation/hwmon/ucd9200
> > rename to Documentation/hwmon/ucd9200.rst
> > index 44eda4a579b6..b819dfd75f71 100644
> > --- a/Documentation/hwmon/ucd9200
> > +++ b/Documentation/hwmon/ucd9200.rst
> > @@ -33,7 +33,7 @@ dedicated circuitry for DC/DC loop management with flash memory and a serial
> >  interface to support configuration, monitoring and management.
> >  
> >  This driver is a client driver to the core PMBus driver. Please see
> > -Documentation/hwmon/pmbus for details on PMBus client drivers.
> > +Documentation/hwmon/pmbus.rst for details on PMBus client drivers.
> >  
> >  
> >  Usage Notes
> > @@ -48,7 +48,7 @@ Platform data support
> >  ---------------------
> >  
> >  The driver supports standard PMBus driver platform data. Please see
> > -Documentation/hwmon/pmbus for details.
> > +Documentation/hwmon/pmbus.rst for details.
> >  
> >  
> >  Sysfs entries
> > diff --git a/Documentation/hwmon/userspace-tools b/Documentation/hwmon/userspace-tools.rst
> > similarity index 100%
> > rename from Documentation/hwmon/userspace-tools
> > rename to Documentation/hwmon/userspace-tools.rst
> > diff --git a/Documentation/hwmon/vexpress b/Documentation/hwmon/vexpress.rst
> > similarity index 100%
> > rename from Documentation/hwmon/vexpress
> > rename to Documentation/hwmon/vexpress.rst
> > diff --git a/Documentation/hwmon/via686a b/Documentation/hwmon/via686a.rst
> > similarity index 100%
> > rename from Documentation/hwmon/via686a
> > rename to Documentation/hwmon/via686a.rst
> > diff --git a/Documentation/hwmon/vt1211 b/Documentation/hwmon/vt1211.rst
> > similarity index 100%
> > rename from Documentation/hwmon/vt1211
> > rename to Documentation/hwmon/vt1211.rst
> > diff --git a/Documentation/hwmon/w83627ehf b/Documentation/hwmon/w83627ehf.rst
> > similarity index 100%
> > rename from Documentation/hwmon/w83627ehf
> > rename to Documentation/hwmon/w83627ehf.rst
> > diff --git a/Documentation/hwmon/w83627hf b/Documentation/hwmon/w83627hf.rst
> > similarity index 100%
> > rename from Documentation/hwmon/w83627hf
> > rename to Documentation/hwmon/w83627hf.rst
> > diff --git a/Documentation/hwmon/w83773g b/Documentation/hwmon/w83773g.rst
> > similarity index 100%
> > rename from Documentation/hwmon/w83773g
> > rename to Documentation/hwmon/w83773g.rst
> > diff --git a/Documentation/hwmon/w83781d b/Documentation/hwmon/w83781d.rst
> > similarity index 100%
> > rename from Documentation/hwmon/w83781d
> > rename to Documentation/hwmon/w83781d.rst
> > diff --git a/Documentation/hwmon/w83791d b/Documentation/hwmon/w83791d.rst
> > similarity index 99%
> > rename from Documentation/hwmon/w83791d
> > rename to Documentation/hwmon/w83791d.rst
> > index a91f9e5fb0c6..3adaed39b157 100644
> > --- a/Documentation/hwmon/w83791d
> > +++ b/Documentation/hwmon/w83791d.rst
> > @@ -102,7 +102,7 @@ This file is used for both legacy and new code.
> >  
> >  The sysfs interface to the beep bitmask has migrated from the original legacy
> >  method of a single sysfs beep_mask file to a newer method using multiple
> > -`*_beep` files as described in `Documentation/hwmon/sysfs-interface`.
> > +`*_beep` files as described in `Documentation/hwmon/sysfs-interface.rst`.
> >  
> >  A similar change has occurred for the bitmap corresponding to the alarms. The
> >  original legacy method used a single sysfs alarms file containing a bitmap
> > diff --git a/Documentation/hwmon/w83792d b/Documentation/hwmon/w83792d.rst
> > similarity index 100%
> > rename from Documentation/hwmon/w83792d
> > rename to Documentation/hwmon/w83792d.rst
> > diff --git a/Documentation/hwmon/w83793 b/Documentation/hwmon/w83793.rst
> > similarity index 100%
> > rename from Documentation/hwmon/w83793
> > rename to Documentation/hwmon/w83793.rst
> > diff --git a/Documentation/hwmon/w83795 b/Documentation/hwmon/w83795.rst
> > similarity index 100%
> > rename from Documentation/hwmon/w83795
> > rename to Documentation/hwmon/w83795.rst
> > diff --git a/Documentation/hwmon/w83l785ts b/Documentation/hwmon/w83l785ts.rst
> > similarity index 100%
> > rename from Documentation/hwmon/w83l785ts
> > rename to Documentation/hwmon/w83l785ts.rst
> > diff --git a/Documentation/hwmon/w83l786ng b/Documentation/hwmon/w83l786ng.rst
> > similarity index 100%
> > rename from Documentation/hwmon/w83l786ng
> > rename to Documentation/hwmon/w83l786ng.rst
> > diff --git a/Documentation/hwmon/wm831x b/Documentation/hwmon/wm831x.rst
> > similarity index 100%
> > rename from Documentation/hwmon/wm831x
> > rename to Documentation/hwmon/wm831x.rst
> > diff --git a/Documentation/hwmon/wm8350 b/Documentation/hwmon/wm8350.rst
> > similarity index 100%
> > rename from Documentation/hwmon/wm8350
> > rename to Documentation/hwmon/wm8350.rst
> > diff --git a/Documentation/hwmon/xgene-hwmon b/Documentation/hwmon/xgene-hwmon.rst
> > similarity index 100%
> > rename from Documentation/hwmon/xgene-hwmon
> > rename to Documentation/hwmon/xgene-hwmon.rst
> > diff --git a/Documentation/hwmon/zl6100 b/Documentation/hwmon/zl6100.rst
> > similarity index 98%
> > rename from Documentation/hwmon/zl6100
> > rename to Documentation/hwmon/zl6100.rst
> > index 4029970bace4..41513bb7fe51 100644
> > --- a/Documentation/hwmon/zl6100
> > +++ b/Documentation/hwmon/zl6100.rst
> > @@ -113,7 +113,7 @@ This driver supports hardware monitoring for Intersil / Zilker Labs ZL6100 and
> >  compatible digital DC-DC controllers.
> >  
> >  The driver is a client driver to the core PMBus driver. Please see
> > -Documentation/hwmon/pmbus and Documentation.hwmon/pmbus-core for details
> > +Documentation/hwmon/pmbus.rst and Documentation.hwmon/pmbus-core for details
> >  on PMBus client drivers.
> >  
> >  
> > diff --git a/Documentation/index.rst b/Documentation/index.rst
> > index 80a421cb935e..3a710dc24fc8 100644
> > --- a/Documentation/index.rst
> > +++ b/Documentation/index.rst
> > @@ -83,6 +83,7 @@ needed).
> >     media/index
> >     networking/index
> >     input/index
> > +   hwmon/index
> >     gpu/index
> >     security/index
> >     sound/index
> > diff --git a/Documentation/thermal/sysfs-api.txt b/Documentation/thermal/sysfs-api.txt
> > index 911399730c1c..c3fa500df92c 100644
> > --- a/Documentation/thermal/sysfs-api.txt
> > +++ b/Documentation/thermal/sysfs-api.txt
> > @@ -316,7 +316,7 @@ ACPI thermal zones.
> >      |---temp[1-*]_input:	The current temperature of thermal zone [1-*]
> >      |---temp[1-*]_critical:	The critical trip point of thermal zone [1-*]
> >  
> > -Please read Documentation/hwmon/sysfs-interface for additional information.
> > +Please read Documentation/hwmon/sysfs-interface.rst for additional information.
> >  
> >  ***************************
> >  * Thermal zone attributes *
> > diff --git a/MAINTAINERS b/MAINTAINERS
> > index 349e5d8c3f58..6269c9d671ca 100644
> > --- a/MAINTAINERS
> > +++ b/MAINTAINERS
> > @@ -468,7 +468,7 @@ ADM1025 HARDWARE MONITOR DRIVER
> >  M:	Jean Delvare <jdelvare@suse.com>
> >  L:	linux-hwmon@vger.kernel.org
> >  S:	Maintained
> > -F:	Documentation/hwmon/adm1025
> > +F:	Documentation/hwmon/adm1025.rst
> >  F:	drivers/hwmon/adm1025.c
> >  
> >  ADM1029 HARDWARE MONITOR DRIVER
> > @@ -520,7 +520,7 @@ ADS1015 HARDWARE MONITOR DRIVER
> >  M:	Dirk Eibach <eibach@gdsys.de>
> >  L:	linux-hwmon@vger.kernel.org
> >  S:	Maintained
> > -F:	Documentation/hwmon/ads1015
> > +F:	Documentation/hwmon/ads1015.rst
> >  F:	drivers/hwmon/ads1015.c
> >  F:	include/linux/platform_data/ads1015.h
> >  
> > @@ -533,7 +533,7 @@ ADT7475 HARDWARE MONITOR DRIVER
> >  M:	Jean Delvare <jdelvare@suse.com>
> >  L:	linux-hwmon@vger.kernel.org
> >  S:	Maintained
> > -F:	Documentation/hwmon/adt7475
> > +F:	Documentation/hwmon/adt7475.rst
> >  F:	drivers/hwmon/adt7475.c
> >  
> >  ADVANSYS SCSI DRIVER
> > @@ -764,7 +764,7 @@ AMD FAM15H PROCESSOR POWER MONITORING DRIVER
> >  M:	Huang Rui <ray.huang@amd.com>
> >  L:	linux-hwmon@vger.kernel.org
> >  S:	Supported
> > -F:	Documentation/hwmon/fam15h_power
> > +F:	Documentation/hwmon/fam15h_power.rst
> >  F:	drivers/hwmon/fam15h_power.c
> >  
> >  AMD FCH GPIO DRIVER
> > @@ -2531,7 +2531,7 @@ ASC7621 HARDWARE MONITOR DRIVER
> >  M:	George Joseph <george.joseph@fairview5.com>
> >  L:	linux-hwmon@vger.kernel.org
> >  S:	Maintained
> > -F:	Documentation/hwmon/asc7621
> > +F:	Documentation/hwmon/asc7621.rst
> >  F:	drivers/hwmon/asc7621.c
> >  
> >  ASPEED VIDEO ENGINE DRIVER
> > @@ -4071,7 +4071,7 @@ CORETEMP HARDWARE MONITORING DRIVER
> >  M:	Fenghua Yu <fenghua.yu@intel.com>
> >  L:	linux-hwmon@vger.kernel.org
> >  S:	Maintained
> > -F:	Documentation/hwmon/coretemp
> > +F:	Documentation/hwmon/coretemp.rst
> >  F:	drivers/hwmon/coretemp.c
> >  
> >  COSA/SRP SYNC SERIAL DRIVER
> > @@ -4627,7 +4627,7 @@ DIALOG SEMICONDUCTOR DRIVERS
> >  M:	Support Opensource <support.opensource@diasemi.com>
> >  W:	http://www.dialog-semiconductor.com/products
> >  S:	Supported
> > -F:	Documentation/hwmon/da90??
> > +F:	Documentation/hwmon/da90??.rst
> >  F:	Documentation/devicetree/bindings/mfd/da90*.txt
> >  F:	Documentation/devicetree/bindings/input/da90??-onkey.txt
> >  F:	Documentation/devicetree/bindings/thermal/da90??-thermal.txt
> > @@ -4778,7 +4778,7 @@ DME1737 HARDWARE MONITOR DRIVER
> >  M:	Juerg Haefliger <juergh@gmail.com>
> >  L:	linux-hwmon@vger.kernel.org
> >  S:	Maintained
> > -F:	Documentation/hwmon/dme1737
> > +F:	Documentation/hwmon/dme1737.rst
> >  F:	drivers/hwmon/dme1737.c
> >  
> >  DMI/SMBIOS SUPPORT
> > @@ -6006,7 +6006,7 @@ F71805F HARDWARE MONITORING DRIVER
> >  M:	Jean Delvare <jdelvare@suse.com>
> >  L:	linux-hwmon@vger.kernel.org
> >  S:	Maintained
> > -F:	Documentation/hwmon/f71805f
> > +F:	Documentation/hwmon/f71805f.rst
> >  F:	drivers/hwmon/f71805f.c
> >  
> >  FADDR2LINE
> > @@ -7687,7 +7687,7 @@ INA209 HARDWARE MONITOR DRIVER
> >  M:	Guenter Roeck <linux@roeck-us.net>
> >  L:	linux-hwmon@vger.kernel.org
> >  S:	Maintained
> > -F:	Documentation/hwmon/ina209
> > +F:	Documentation/hwmon/ina209.rst
> >  F:	Documentation/devicetree/bindings/hwmon/ina2xx.txt
> >  F:	drivers/hwmon/ina209.c
> >  
> > @@ -7695,7 +7695,7 @@ INA2XX HARDWARE MONITOR DRIVER
> >  M:	Guenter Roeck <linux@roeck-us.net>
> >  L:	linux-hwmon@vger.kernel.org
> >  S:	Maintained
> > -F:	Documentation/hwmon/ina2xx
> > +F:	Documentation/hwmon/ina2xx.rst
> >  F:	drivers/hwmon/ina2xx.c
> >  F:	include/linux/platform_data/ina2xx.h
> >  
> > @@ -8328,7 +8328,7 @@ IT87 HARDWARE MONITORING DRIVER
> >  M:	Jean Delvare <jdelvare@suse.com>
> >  L:	linux-hwmon@vger.kernel.org
> >  S:	Maintained
> > -F:	Documentation/hwmon/it87
> > +F:	Documentation/hwmon/it87.rst
> >  F:	drivers/hwmon/it87.c
> >  
> >  IT913X MEDIA DRIVER
> > @@ -8372,7 +8372,7 @@ M:	Guenter Roeck <linux@roeck-us.net>
> >  L:	linux-hwmon@vger.kernel.org
> >  S:	Maintained
> >  F:	drivers/hwmon/jc42.c
> > -F:	Documentation/hwmon/jc42
> > +F:	Documentation/hwmon/jc42.rst
> >  
> >  JFS FILESYSTEM
> >  M:	Dave Kleikamp <shaggy@kernel.org>
> > @@ -8420,14 +8420,14 @@ K10TEMP HARDWARE MONITORING DRIVER
> >  M:	Clemens Ladisch <clemens@ladisch.de>
> >  L:	linux-hwmon@vger.kernel.org
> >  S:	Maintained
> > -F:	Documentation/hwmon/k10temp
> > +F:	Documentation/hwmon/k10temp.rst
> >  F:	drivers/hwmon/k10temp.c
> >  
> >  K8TEMP HARDWARE MONITORING DRIVER
> >  M:	Rudolf Marek <r.marek@assembler.cz>
> >  L:	linux-hwmon@vger.kernel.org
> >  S:	Maintained
> > -F:	Documentation/hwmon/k8temp
> > +F:	Documentation/hwmon/k8temp.rst
> >  F:	drivers/hwmon/k8temp.c
> >  
> >  KASAN
> > @@ -9118,21 +9118,21 @@ LM78 HARDWARE MONITOR DRIVER
> >  M:	Jean Delvare <jdelvare@suse.com>
> >  L:	linux-hwmon@vger.kernel.org
> >  S:	Maintained
> > -F:	Documentation/hwmon/lm78
> > +F:	Documentation/hwmon/lm78.rst
> >  F:	drivers/hwmon/lm78.c
> >  
> >  LM83 HARDWARE MONITOR DRIVER
> >  M:	Jean Delvare <jdelvare@suse.com>
> >  L:	linux-hwmon@vger.kernel.org
> >  S:	Maintained
> > -F:	Documentation/hwmon/lm83
> > +F:	Documentation/hwmon/lm83.rst
> >  F:	drivers/hwmon/lm83.c
> >  
> >  LM90 HARDWARE MONITOR DRIVER
> >  M:	Jean Delvare <jdelvare@suse.com>
> >  L:	linux-hwmon@vger.kernel.org
> >  S:	Maintained
> > -F:	Documentation/hwmon/lm90
> > +F:	Documentation/hwmon/lm90.rst
> >  F:	Documentation/devicetree/bindings/hwmon/lm90.txt
> >  F:	drivers/hwmon/lm90.c
> >  F:	include/dt-bindings/thermal/lm90.h
> > @@ -9141,7 +9141,7 @@ LM95234 HARDWARE MONITOR DRIVER
> >  M:	Guenter Roeck <linux@roeck-us.net>
> >  L:	linux-hwmon@vger.kernel.org
> >  S:	Maintained
> > -F:	Documentation/hwmon/lm95234
> > +F:	Documentation/hwmon/lm95234.rst
> >  F:	drivers/hwmon/lm95234.c
> >  
> >  LME2510 MEDIA DRIVER
> > @@ -9214,7 +9214,7 @@ LTC4261 HARDWARE MONITOR DRIVER
> >  M:	Guenter Roeck <linux@roeck-us.net>
> >  L:	linux-hwmon@vger.kernel.org
> >  S:	Maintained
> > -F:	Documentation/hwmon/ltc4261
> > +F:	Documentation/hwmon/ltc4261.rst
> >  F:	drivers/hwmon/ltc4261.c
> >  
> >  LTC4306 I2C MULTIPLEXER DRIVER
> > @@ -9445,7 +9445,7 @@ MAX16065 HARDWARE MONITOR DRIVER
> >  M:	Guenter Roeck <linux@roeck-us.net>
> >  L:	linux-hwmon@vger.kernel.org
> >  S:	Maintained
> > -F:	Documentation/hwmon/max16065
> > +F:	Documentation/hwmon/max16065.rst
> >  F:	drivers/hwmon/max16065.c
> >  
> >  MAX2175 SDR TUNER DRIVER
> > @@ -9461,14 +9461,14 @@ F:	include/uapi/linux/max2175.h
> >  MAX6650 HARDWARE MONITOR AND FAN CONTROLLER DRIVER
> >  L:	linux-hwmon@vger.kernel.org
> >  S:	Orphan
> > -F:	Documentation/hwmon/max6650
> > +F:	Documentation/hwmon/max6650.rst
> >  F:	drivers/hwmon/max6650.c
> >  
> >  MAX6697 HARDWARE MONITOR DRIVER
> >  M:	Guenter Roeck <linux@roeck-us.net>
> >  L:	linux-hwmon@vger.kernel.org
> >  S:	Maintained
> > -F:	Documentation/hwmon/max6697
> > +F:	Documentation/hwmon/max6697.rst
> >  F:	Documentation/devicetree/bindings/hwmon/max6697.txt
> >  F:	drivers/hwmon/max6697.c
> >  F:	include/linux/platform_data/max6697.h
> > @@ -10118,7 +10118,7 @@ F:	drivers/mfd/menf21bmc.c
> >  F:	drivers/watchdog/menf21bmc_wdt.c
> >  F:	drivers/leds/leds-menf21bmc.c
> >  F:	drivers/hwmon/menf21bmc_hwmon.c
> > -F:	Documentation/hwmon/menf21bmc
> > +F:	Documentation/hwmon/menf21bmc.rst
> >  
> >  MEN Z069 WATCHDOG DRIVER
> >  M:	Johannes Thumshirn <jth@kernel.org>
> > @@ -10747,7 +10747,7 @@ NCT6775 HARDWARE MONITOR DRIVER
> >  M:	Guenter Roeck <linux@roeck-us.net>
> >  L:	linux-hwmon@vger.kernel.org
> >  S:	Maintained
> > -F:	Documentation/hwmon/nct6775
> > +F:	Documentation/hwmon/nct6775.rst
> >  F:	drivers/hwmon/nct6775.c
> >  
> >  NET_FAILOVER MODULE
> > @@ -11841,7 +11841,7 @@ PC87360 HARDWARE MONITORING DRIVER
> >  M:	Jim Cromie <jim.cromie@gmail.com>
> >  L:	linux-hwmon@vger.kernel.org
> >  S:	Maintained
> > -F:	Documentation/hwmon/pc87360
> > +F:	Documentation/hwmon/pc87360.rst
> >  F:	drivers/hwmon/pc87360.c
> >  
> >  PC8736x GPIO DRIVER
> > @@ -11853,7 +11853,7 @@ PC87427 HARDWARE MONITORING DRIVER
> >  M:	Jean Delvare <jdelvare@suse.com>
> >  L:	linux-hwmon@vger.kernel.org
> >  S:	Maintained
> > -F:	Documentation/hwmon/pc87427
> > +F:	Documentation/hwmon/pc87427.rst
> >  F:	drivers/hwmon/pc87427.c
> >  
> >  PCA9532 LED DRIVER
> > @@ -12421,23 +12421,23 @@ S:	Maintained
> >  F:	Documentation/devicetree/bindings/hwmon/ibm,cffps1.txt
> >  F:	Documentation/devicetree/bindings/hwmon/max31785.txt
> >  F:	Documentation/devicetree/bindings/hwmon/ltc2978.txt
> > -F:	Documentation/hwmon/adm1275
> > -F:	Documentation/hwmon/ibm-cffps
> > -F:	Documentation/hwmon/ir35221
> > -F:	Documentation/hwmon/lm25066
> > -F:	Documentation/hwmon/ltc2978
> > -F:	Documentation/hwmon/ltc3815
> > -F:	Documentation/hwmon/max16064
> > -F:	Documentation/hwmon/max20751
> > -F:	Documentation/hwmon/max31785
> > -F:	Documentation/hwmon/max34440
> > -F:	Documentation/hwmon/max8688
> > -F:	Documentation/hwmon/pmbus
> > -F:	Documentation/hwmon/pmbus-core
> > -F:	Documentation/hwmon/tps40422
> > -F:	Documentation/hwmon/ucd9000
> > -F:	Documentation/hwmon/ucd9200
> > -F:	Documentation/hwmon/zl6100
> > +F:	Documentation/hwmon/adm1275.rst
> > +F:	Documentation/hwmon/ibm-cffps.rst
> > +F:	Documentation/hwmon/ir35221.rst
> > +F:	Documentation/hwmon/lm25066.rst
> > +F:	Documentation/hwmon/ltc2978.rst
> > +F:	Documentation/hwmon/ltc3815.rst
> > +F:	Documentation/hwmon/max16064.rst
> > +F:	Documentation/hwmon/max20751.rst
> > +F:	Documentation/hwmon/max31785.rst
> > +F:	Documentation/hwmon/max34440.rst
> > +F:	Documentation/hwmon/max8688.rst
> > +F:	Documentation/hwmon/pmbus.rst
> > +F:	Documentation/hwmon/pmbus-core.rst
> > +F:	Documentation/hwmon/tps40422.rst
> > +F:	Documentation/hwmon/ucd9000.rst
> > +F:	Documentation/hwmon/ucd9200.rst
> > +F:	Documentation/hwmon/zl6100.rst
> >  F:	drivers/hwmon/pmbus/
> >  F:	include/linux/pmbus.h
> >  
> > @@ -12701,7 +12701,7 @@ M:	Bartlomiej Zolnierkiewicz <b.zolnierkie@samsung.com>
> >  L:	linux-hwmon@vger.kernel.org
> >  S:	Supported
> >  F:	Documentation/devicetree/bindings/hwmon/pwm-fan.txt
> > -F:	Documentation/hwmon/pwm-fan
> > +F:	Documentation/hwmon/pwm-fan.rst
> >  F:	drivers/hwmon/pwm-fan.c
> >  
> >  PWM IR Transmitter
> > @@ -14366,21 +14366,21 @@ SMM665 HARDWARE MONITOR DRIVER
> >  M:	Guenter Roeck <linux@roeck-us.net>
> >  L:	linux-hwmon@vger.kernel.org
> >  S:	Maintained
> > -F:	Documentation/hwmon/smm665
> > +F:	Documentation/hwmon/smm665.rst
> >  F:	drivers/hwmon/smm665.c
> >  
> >  SMSC EMC2103 HARDWARE MONITOR DRIVER
> >  M:	Steve Glendinning <steve.glendinning@shawell.net>
> >  L:	linux-hwmon@vger.kernel.org
> >  S:	Maintained
> > -F:	Documentation/hwmon/emc2103
> > +F:	Documentation/hwmon/emc2103.rst
> >  F:	drivers/hwmon/emc2103.c
> >  
> >  SMSC SCH5627 HARDWARE MONITOR DRIVER
> >  M:	Hans de Goede <hdegoede@redhat.com>
> >  L:	linux-hwmon@vger.kernel.org
> >  S:	Supported
> > -F:	Documentation/hwmon/sch5627
> > +F:	Documentation/hwmon/sch5627.rst
> >  F:	drivers/hwmon/sch5627.c
> >  
> >  SMSC UFX6000 and UFX7000 USB to VGA DRIVER
> > @@ -14393,7 +14393,7 @@ SMSC47B397 HARDWARE MONITOR DRIVER
> >  M:	Jean Delvare <jdelvare@suse.com>
> >  L:	linux-hwmon@vger.kernel.org
> >  S:	Maintained
> > -F:	Documentation/hwmon/smsc47b397
> > +F:	Documentation/hwmon/smsc47b397.rst
> >  F:	drivers/hwmon/smsc47b397.c
> >  
> >  SMSC911x ETHERNET DRIVER
> > @@ -15744,7 +15744,7 @@ TMP401 HARDWARE MONITOR DRIVER
> >  M:	Guenter Roeck <linux@roeck-us.net>
> >  L:	linux-hwmon@vger.kernel.org
> >  S:	Maintained
> > -F:	Documentation/hwmon/tmp401
> > +F:	Documentation/hwmon/tmp401.rst
> >  F:	drivers/hwmon/tmp401.c
> >  
> >  TMPFS (SHMEM FILESYSTEM)
> > @@ -16796,7 +16796,7 @@ VT1211 HARDWARE MONITOR DRIVER
> >  M:	Juerg Haefliger <juergh@gmail.com>
> >  L:	linux-hwmon@vger.kernel.org
> >  S:	Maintained
> > -F:	Documentation/hwmon/vt1211
> > +F:	Documentation/hwmon/vt1211.rst
> >  F:	drivers/hwmon/vt1211.c
> >  
> >  VT8231 HARDWARE MONITOR DRIVER
> > @@ -16824,14 +16824,14 @@ W83791D HARDWARE MONITORING DRIVER
> >  M:	Marc Hulsman <m.hulsman@tudelft.nl>
> >  L:	linux-hwmon@vger.kernel.org
> >  S:	Maintained
> > -F:	Documentation/hwmon/w83791d
> > +F:	Documentation/hwmon/w83791d.rst
> >  F:	drivers/hwmon/w83791d.c
> >  
> >  W83793 HARDWARE MONITORING DRIVER
> >  M:	Rudolf Marek <r.marek@assembler.cz>
> >  L:	linux-hwmon@vger.kernel.org
> >  S:	Maintained
> > -F:	Documentation/hwmon/w83793
> > +F:	Documentation/hwmon/w83793.rst
> >  F:	drivers/hwmon/w83793.c
> >  
> >  W83795 HARDWARE MONITORING DRIVER
> > @@ -16940,7 +16940,7 @@ L:	patches@opensource.cirrus.com
> >  T:	git https://github.com/CirrusLogic/linux-drivers.git
> >  W:	https://github.com/CirrusLogic/linux-drivers/wiki
> >  S:	Supported
> > -F:	Documentation/hwmon/wm83??
> > +F:	Documentation/hwmon/wm83??.rst
> >  F:	Documentation/devicetree/bindings/extcon/extcon-arizona.txt
> >  F:	Documentation/devicetree/bindings/regulator/arizona-regulator.txt
> >  F:	Documentation/devicetree/bindings/mfd/arizona.txt
> > diff --git a/drivers/hwmon/Kconfig b/drivers/hwmon/Kconfig
> > index dedd5febd3aa..470ba66b18b0 100644
> > --- a/drivers/hwmon/Kconfig
> > +++ b/drivers/hwmon/Kconfig
> > @@ -17,7 +17,7 @@ menuconfig HWMON
> >  
> >  	  To find out which specific driver(s) you need, use the
> >  	  sensors-detect script from the lm_sensors package.  Read
> > -	  <file:Documentation/hwmon/userspace-tools> for details.
> > +	  <file:Documentation/hwmon/userspace-tools.rst> for details.
> >  
> >  	  This support can also be built as a module. If so, the module
> >  	  will be called hwmon.
> > @@ -59,7 +59,7 @@ config SENSORS_ABITUGURU
> >  	  chip can be found on Abit uGuru featuring motherboards (most modern
> >  	  Abit motherboards from before end 2005). For more info and a list
> >  	  of which motherboards have which revision see
> > -	  Documentation/hwmon/abituguru
> > +	  Documentation/hwmon/abituguru.rst
> >  
> >  	  This driver can also be built as a module. If so, the module
> >  	  will be called abituguru.
> > @@ -73,7 +73,7 @@ config SENSORS_ABITUGURU3
> >  	  and their settings is supported. The third revision of the Abit
> >  	  uGuru chip can be found on recent Abit motherboards (since end
> >  	  2005). For more info and a list of which motherboards have which
> > -	  revision see Documentation/hwmon/abituguru3
> > +	  revision see Documentation/hwmon/abituguru3.rst
> >  
> >  	  This driver can also be built as a module. If so, the module
> >  	  will be called abituguru3.
> > @@ -643,7 +643,7 @@ config SENSORS_CORETEMP
> >  	help
> >  	  If you say yes here you get support for the temperature
> >  	  sensor inside your CPU. Most of the family 6 CPUs
> > -	  are supported. Check Documentation/hwmon/coretemp for details.
> > +	  are supported. Check Documentation/hwmon/coretemp.rst for details.
> >  
> >  config SENSORS_IT87
> >  	tristate "ITE IT87xx and compatibles"
> > diff --git a/drivers/hwmon/ads7828.c b/drivers/hwmon/ads7828.c
> > index e6be617e3fb2..03d6e782777a 100644
> > --- a/drivers/hwmon/ads7828.c
> > +++ b/drivers/hwmon/ads7828.c
> > @@ -8,7 +8,7 @@
> >   *
> >   * ADS7830 support, by Guillaume Roguez <guillaume.roguez@savoirfairelinux.com>
> >   *
> > - * For further information, see the Documentation/hwmon/ads7828 file.
> > + * For further information, see the Documentation/hwmon/ads7828.rst file.
> >   *
> >   * This program is free software; you can redistribute it and/or modify
> >   * it under the terms of the GNU General Public License as published by
> > diff --git a/drivers/hwmon/max197.c b/drivers/hwmon/max197.c
> > index 3d9e210beedf..dd6a35219a18 100644
> > --- a/drivers/hwmon/max197.c
> > +++ b/drivers/hwmon/max197.c
> > @@ -8,7 +8,7 @@
> >   * it under the terms of the GNU General Public License version 2 as
> >   * published by the Free Software Foundation.
> >   *
> > - * For further information, see the Documentation/hwmon/max197 file.
> > + * For further information, see the Documentation/hwmon/max197.rst file.
> >   */
> >  
> >  #include <linux/kernel.h>
> > diff --git a/drivers/hwmon/sht15.c b/drivers/hwmon/sht15.c
> > index 39b41e35c2bf..7f4a63959730 100644
> > --- a/drivers/hwmon/sht15.c
> > +++ b/drivers/hwmon/sht15.c
> > @@ -10,7 +10,7 @@
> >   *
> >   * Copyright (c) 2007 Wouter Horre
> >   *
> > - * For further information, see the Documentation/hwmon/sht15 file.
> > + * For further information, see the Documentation/hwmon/sht15.rst file.
> >   */
> >  
> >  #include <linux/interrupt.h>
> > diff --git a/include/linux/platform_data/ads7828.h b/include/linux/platform_data/ads7828.h
> > index 3245f45f9d77..a3370a007702 100644
> > --- a/include/linux/platform_data/ads7828.h
> > +++ b/include/linux/platform_data/ads7828.h
> > @@ -4,7 +4,7 @@
> >   * Copyright (c) 2012 Savoir-faire Linux Inc.
> >   *          Vivien Didelot <vivien.didelot@savoirfairelinux.com>
> >   *
> > - * For further information, see the Documentation/hwmon/ads7828 file.
> > + * For further information, see the Documentation/hwmon/ads7828.rst file.
> >   *
> >   * This program is free software; you can redistribute it and/or modify
> >   * it under the terms of the GNU General Public License version 2 as
> > diff --git a/include/linux/platform_data/ds620.h b/include/linux/platform_data/ds620.h
> > index 6ef58bb77e46..f0ce22a78bb8 100644
> > --- a/include/linux/platform_data/ds620.h
> > +++ b/include/linux/platform_data/ds620.h
> > @@ -14,7 +14,7 @@ struct ds620_platform_data {
> >  	 *  1 = PO_LOW
> >  	 *  2 = PO_HIGH
> >  	 *
> > -	 * (see Documentation/hwmon/ds620)
> > +	 * (see Documentation/hwmon/ds620.rst)
> >  	 */
> >  	int pomode;
> >  };
> > diff --git a/include/linux/platform_data/ina2xx.h b/include/linux/platform_data/ina2xx.h
> > index 9f0aa1b48c78..dde59fd3590f 100644
> > --- a/include/linux/platform_data/ina2xx.h
> > +++ b/include/linux/platform_data/ina2xx.h
> > @@ -7,7 +7,7 @@
> >   * it under the terms of the GNU General Public License version 2 as
> >   * published by the Free Software Foundation.
> >   *
> > - * For further information, see the Documentation/hwmon/ina2xx file.
> > + * For further information, see the Documentation/hwmon/ina2xx.rst file.
> >   */
> >  
> >  /**
> > diff --git a/include/linux/platform_data/max197.h b/include/linux/platform_data/max197.h
> > index 8da8f94ee15c..2bbd0919bc89 100644
> > --- a/include/linux/platform_data/max197.h
> > +++ b/include/linux/platform_data/max197.h
> > @@ -8,7 +8,7 @@
> >   * it under the terms of the GNU General Public License version 2 as
> >   * published by the Free Software Foundation.
> >   *
> > - * For further information, see the Documentation/hwmon/max197 file.
> > + * For further information, see the Documentation/hwmon/max197.rst file.
> >   */
> >  
> >  #ifndef _PDATA_MAX197_H
> > diff --git a/include/linux/platform_data/ntc_thermistor.h b/include/linux/platform_data/ntc_thermistor.h
> > index ee03d429742b..5fa115d3ea4b 100644
> > --- a/include/linux/platform_data/ntc_thermistor.h
> > +++ b/include/linux/platform_data/ntc_thermistor.h
> > @@ -42,7 +42,7 @@ struct ntc_thermistor_platform_data {
> >  	 * read_uV()
> >  	 *
> >  	 * How to setup pullup_ohm, pulldown_ohm, and connect is
> > -	 * described at Documentation/hwmon/ntc_thermistor
> > +	 * described at Documentation/hwmon/ntc_thermistor.rst
> >  	 *
> >  	 * pullup/down_ohm: 0 for infinite / not-connected
> >  	 *  



Thanks,
Mauro

^ permalink raw reply	[flat|nested] 73+ messages in thread

* Re: [PATCH v3 21/21] docs: hwmon: Add an index file and rename docs to *.rst
  2019-04-17 17:13                         ` Mauro Carvalho Chehab
@ 2019-04-17 17:22                           ` Mauro Carvalho Chehab
  2019-04-17 17:43                             ` Guenter Roeck
  0 siblings, 1 reply; 73+ messages in thread
From: Mauro Carvalho Chehab @ 2019-04-17 17:22 UTC (permalink / raw)
  To: Guenter Roeck
  Cc: Linux Doc Mailing List, linux-kernel, Jonathan Corbet,
	Jean Delvare, Rob Herring, Mark Rutland, Dirk Eibach,
	George Joseph, Joel Stanley, Andrew Jeffery, Fenghua Yu,
	Support Opensource, Juerg Haefliger, Steve Glendinning,
	Huang Rui, Benjamin Herrenschmidt, Paul Mackerras,
	Michael Ellerman, Clemens Ladisch, Rudolf Marek, Andreas Werner,
	Jim Cromie, Kamil Debski, Bartlomiej Zolnierkiewicz,
	Hans de Goede, Liviu Dudau, Sudeep Holla, Lorenzo Pieralisi,
	Marc Hulsman, linux-hwmon, devicetree, linux-arm-kernel,
	linux-aspeed, linuxppc-dev, patches

Em Wed, 17 Apr 2019 14:13:52 -0300
Mauro Carvalho Chehab <mchehab+samsung@kernel.org> escreveu:

> Em Wed, 17 Apr 2019 09:47:41 -0700
> Guenter Roeck <linux@roeck-us.net> escreveu:
> 
> > On Wed, Apr 17, 2019 at 06:46:29AM -0300, Mauro Carvalho Chehab wrote:  
> > > Now that all files were converted to ReST format, rename them
> > > and add an index.
> > > 
> > > Signed-off-by: Mauro Carvalho Chehab <mchehab+samsung@kernel.org>
> > > Acked-by: Liviu Dudau <liviu.dudau@arm.com>    
> > 
> > I applied all patches except this one, which fails due to a conflict in
> > ab8500. I also notice that this file has not been touched by your series,
> > which is odd. At the same time, patch 20/21 is missing from your series,
> > and has been missing all along. Does the missing patch possibly touch
> > Documentation/hwmon/ab8500 ?  
> 
> Patch 20/21 is the biggest one. Maybe vger rejected it either due to
> its size or due to the number of c/c.
> 
> Just bounced it to you. Please let me know if you didn't receive it
> yet.

Btw, LKML got it:

https://lore.kernel.org/lkml/cccc2a52363a5aaeea10e186ead8570503ea648e.1555494108.git.mchehab+samsung@kernel.org/

> 
> Regards,
> Mauro
> 
> > 
> > Thanks,
> > Guenter
> >   
> > > ---
> > >  .../devicetree/bindings/hwmon/g762.txt        |   2 +-
> > >  Documentation/hwmon/{ab8500 => ab8500.rst}    |   2 +-
> > >  ...guru-datasheet => abituguru-datasheet.rst} |   0
> > >  .../hwmon/{abituguru => abituguru.rst}        |   0
> > >  .../hwmon/{abituguru3 => abituguru3.rst}      |   0
> > >  Documentation/hwmon/{abx500 => abx500.rst}    |   0
> > >  ...{acpi_power_meter => acpi_power_meter.rst} |   2 +-
> > >  Documentation/hwmon/{ad7314 => ad7314.rst}    |   0
> > >  .../hwmon/{adc128d818 => adc128d818.rst}      |   0
> > >  Documentation/hwmon/{adm1021 => adm1021.rst}  |   0
> > >  Documentation/hwmon/{adm1025 => adm1025.rst}  |   0
> > >  Documentation/hwmon/{adm1026 => adm1026.rst}  |   0
> > >  Documentation/hwmon/{adm1031 => adm1031.rst}  |   0
> > >  Documentation/hwmon/{adm1275 => adm1275.rst}  |   4 +-
> > >  Documentation/hwmon/{adm9240 => adm9240.rst}  |   0
> > >  Documentation/hwmon/{ads1015 => ads1015.rst}  |   0
> > >  Documentation/hwmon/{ads7828 => ads7828.rst}  |   0
> > >  Documentation/hwmon/{adt7410 => adt7410.rst}  |   0
> > >  Documentation/hwmon/{adt7411 => adt7411.rst}  |   0
> > >  Documentation/hwmon/{adt7462 => adt7462.rst}  |   1 -
> > >  Documentation/hwmon/{adt7470 => adt7470.rst}  |   0
> > >  Documentation/hwmon/{adt7475 => adt7475.rst}  |   0
> > >  Documentation/hwmon/{amc6821 => amc6821.rst}  |   1 -
> > >  Documentation/hwmon/{asb100 => asb100.rst}    |   1 -
> > >  Documentation/hwmon/{asc7621 => asc7621.rst}  |   0
> > >  ...{aspeed-pwm-tacho => aspeed-pwm-tacho.rst} |   0
> > >  .../hwmon/{coretemp => coretemp.rst}          |   0
> > >  Documentation/hwmon/{da9052 => da9052.rst}    |   0
> > >  Documentation/hwmon/{da9055 => da9055.rst}    |   0
> > >  Documentation/hwmon/{dme1737 => dme1737.rst}  |   0
> > >  Documentation/hwmon/{ds1621 => ds1621.rst}    |   0
> > >  Documentation/hwmon/{ds620 => ds620.rst}      |   0
> > >  Documentation/hwmon/{emc1403 => emc1403.rst}  |   0
> > >  Documentation/hwmon/{emc2103 => emc2103.rst}  |   0
> > >  .../hwmon/{emc6w201 => emc6w201.rst}          |   0
> > >  Documentation/hwmon/{f71805f => f71805f.rst}  |   0
> > >  .../hwmon/{f71882fg => f71882fg.rst}          |   0
> > >  .../hwmon/{fam15h_power => fam15h_power.rst}  |   0
> > >  .../hwmon/{ftsteutates => ftsteutates.rst}    |   0
> > >  Documentation/hwmon/{g760a => g760a.rst}      |   0
> > >  Documentation/hwmon/{g762 => g762.rst}        |   2 +-
> > >  Documentation/hwmon/{gl518sm => gl518sm.rst}  |   0
> > >  Documentation/hwmon/{hih6130 => hih6130.rst}  |   0
> > >  ...on-kernel-api.txt => hwmon-kernel-api.rst} |   4 +-
> > >  .../hwmon/{ibm-cffps => ibm-cffps.rst}        |   0
> > >  Documentation/hwmon/{ibmaem => ibmaem.rst}    |   0
> > >  .../hwmon/{ibmpowernv => ibmpowernv.rst}      |   0
> > >  Documentation/hwmon/{ina209 => ina209.rst}    |   0
> > >  Documentation/hwmon/{ina2xx => ina2xx.rst}    |   2 +-
> > >  Documentation/hwmon/{ina3221 => ina3221.rst}  |   0
> > >  Documentation/hwmon/index.rst                 | 179 ++++++++++++++++++
> > >  Documentation/hwmon/{ir35221 => ir35221.rst}  |   0
> > >  Documentation/hwmon/{it87 => it87.rst}        |   0
> > >  Documentation/hwmon/{jc42 => jc42.rst}        |   0
> > >  Documentation/hwmon/{k10temp => k10temp.rst}  |   0
> > >  Documentation/hwmon/{k8temp => k8temp.rst}    |   0
> > >  .../hwmon/{lineage-pem => lineage-pem.rst}    |   0
> > >  Documentation/hwmon/{lm25066 => lm25066.rst}  |   2 +-
> > >  Documentation/hwmon/{lm63 => lm63.rst}        |   0
> > >  Documentation/hwmon/{lm70 => lm70.rst}        |   0
> > >  Documentation/hwmon/{lm73 => lm73.rst}        |   0
> > >  Documentation/hwmon/{lm75 => lm75.rst}        |   0
> > >  Documentation/hwmon/{lm77 => lm77.rst}        |   0
> > >  Documentation/hwmon/{lm78 => lm78.rst}        |   0
> > >  Documentation/hwmon/{lm80 => lm80.rst}        |   0
> > >  Documentation/hwmon/{lm83 => lm83.rst}        |   0
> > >  Documentation/hwmon/{lm85 => lm85.rst}        |   0
> > >  Documentation/hwmon/{lm87 => lm87.rst}        |   0
> > >  Documentation/hwmon/{lm90 => lm90.rst}        |   0
> > >  Documentation/hwmon/{lm92 => lm92.rst}        |   0
> > >  Documentation/hwmon/{lm93 => lm93.rst}        |   0
> > >  Documentation/hwmon/{lm95234 => lm95234.rst}  |   0
> > >  Documentation/hwmon/{lm95245 => lm95245.rst}  |   0
> > >  Documentation/hwmon/{ltc2945 => ltc2945.rst}  |   0
> > >  Documentation/hwmon/{ltc2978 => ltc2978.rst}  |   0
> > >  Documentation/hwmon/{ltc2990 => ltc2990.rst}  |   0
> > >  Documentation/hwmon/{ltc3815 => ltc3815.rst}  |   0
> > >  Documentation/hwmon/{ltc4151 => ltc4151.rst}  |   0
> > >  Documentation/hwmon/{ltc4215 => ltc4215.rst}  |   0
> > >  Documentation/hwmon/{ltc4245 => ltc4245.rst}  |   0
> > >  Documentation/hwmon/{ltc4260 => ltc4260.rst}  |   0
> > >  Documentation/hwmon/{ltc4261 => ltc4261.rst}  |   0
> > >  .../hwmon/{max16064 => max16064.rst}          |   2 +-
> > >  .../hwmon/{max16065 => max16065.rst}          |   0
> > >  Documentation/hwmon/{max1619 => max1619.rst}  |   1 -
> > >  Documentation/hwmon/{max1668 => max1668.rst}  |   0
> > >  Documentation/hwmon/{max197 => max197.rst}    |   0
> > >  .../hwmon/{max20751 => max20751.rst}          |   2 +-
> > >  .../hwmon/{max31722 => max31722.rst}          |   0
> > >  .../hwmon/{max31785 => max31785.rst}          |   0
> > >  .../hwmon/{max31790 => max31790.rst}          |   0
> > >  .../hwmon/{max34440 => max34440.rst}          |   2 +-
> > >  Documentation/hwmon/{max6639 => max6639.rst}  |   0
> > >  Documentation/hwmon/{max6642 => max6642.rst}  |   0
> > >  Documentation/hwmon/{max6650 => max6650.rst}  |   1 -
> > >  Documentation/hwmon/{max6697 => max6697.rst}  |   0
> > >  Documentation/hwmon/{max8688 => max8688.rst}  |   2 +-
> > >  .../hwmon/{mc13783-adc => mc13783-adc.rst}    |   0
> > >  Documentation/hwmon/{mcp3021 => mcp3021.rst}  |   0
> > >  .../hwmon/{menf21bmc => menf21bmc.rst}        |   0
> > >  .../hwmon/{mlxreg-fan => mlxreg-fan.rst}      |   0
> > >  Documentation/hwmon/{nct6683 => nct6683.rst}  |   0
> > >  Documentation/hwmon/{nct6775 => nct6775.rst}  |   0
> > >  Documentation/hwmon/{nct7802 => nct7802.rst}  |   0
> > >  Documentation/hwmon/{nct7904 => nct7904.rst}  |   0
> > >  .../{npcm750-pwm-fan => npcm750-pwm-fan.rst}  |   0
> > >  Documentation/hwmon/{nsa320 => nsa320.rst}    |   0
> > >  .../{ntc_thermistor => ntc_thermistor.rst}    |   0
> > >  Documentation/hwmon/{occ => occ.rst}          |   0
> > >  Documentation/hwmon/{pc87360 => pc87360.rst}  |   0
> > >  Documentation/hwmon/{pc87427 => pc87427.rst}  |   0
> > >  Documentation/hwmon/{pcf8591 => pcf8591.rst}  |   0
> > >  .../hwmon/{pmbus-core => pmbus-core.rst}      |   0
> > >  Documentation/hwmon/{pmbus => pmbus.rst}      |   0
> > >  .../hwmon/{powr1220 => powr1220.rst}          |   0
> > >  Documentation/hwmon/{pwm-fan => pwm-fan.rst}  |   0
> > >  ...aspberrypi-hwmon => raspberrypi-hwmon.rst} |   0
> > >  Documentation/hwmon/{sch5627 => sch5627.rst}  |   0
> > >  Documentation/hwmon/{sch5636 => sch5636.rst}  |   0
> > >  .../hwmon/{scpi-hwmon => scpi-hwmon.rst}      |   0
> > >  Documentation/hwmon/{sht15 => sht15.rst}      |   0
> > >  Documentation/hwmon/{sht21 => sht21.rst}      |   0
> > >  Documentation/hwmon/{sht3x => sht3x.rst}      |   0
> > >  Documentation/hwmon/{shtc1 => shtc1.rst}      |   0
> > >  Documentation/hwmon/{sis5595 => sis5595.rst}  |   1 -
> > >  Documentation/hwmon/{smm665 => smm665.rst}    |   0
> > >  .../hwmon/{smsc47b397 => smsc47b397.rst}      |   0
> > >  .../hwmon/{smsc47m1 => smsc47m1.rst}          |   0
> > >  .../hwmon/{smsc47m192 => smsc47m192.rst}      |   0
> > >  ...mitting-patches => submitting-patches.rst} |   6 +-
> > >  .../{sysfs-interface => sysfs-interface.rst}  |   0
> > >  Documentation/hwmon/{tc654 => tc654.rst}      |   0
> > >  Documentation/hwmon/{tc74 => tc74.rst}        |   0
> > >  Documentation/hwmon/{thmc50 => thmc50.rst}    |   1 -
> > >  Documentation/hwmon/{tmp102 => tmp102.rst}    |   2 +-
> > >  Documentation/hwmon/{tmp103 => tmp103.rst}    |   2 +-
> > >  Documentation/hwmon/{tmp108 => tmp108.rst}    |   2 +-
> > >  Documentation/hwmon/{tmp401 => tmp401.rst}    |   2 +-
> > >  Documentation/hwmon/{tmp421 => tmp421.rst}    |   0
> > >  .../hwmon/{tps40422 => tps40422.rst}          |   2 +-
> > >  ...4030-madc-hwmon => twl4030-madc-hwmon.rst} |   0
> > >  Documentation/hwmon/{ucd9000 => ucd9000.rst}  |   4 +-
> > >  Documentation/hwmon/{ucd9200 => ucd9200.rst}  |   4 +-
> > >  .../{userspace-tools => userspace-tools.rst}  |   0
> > >  .../hwmon/{vexpress => vexpress.rst}          |   0
> > >  Documentation/hwmon/{via686a => via686a.rst}  |   0
> > >  Documentation/hwmon/{vt1211 => vt1211.rst}    |   0
> > >  .../hwmon/{w83627ehf => w83627ehf.rst}        |   0
> > >  .../hwmon/{w83627hf => w83627hf.rst}          |   0
> > >  Documentation/hwmon/{w83773g => w83773g.rst}  |   0
> > >  Documentation/hwmon/{w83781d => w83781d.rst}  |   0
> > >  Documentation/hwmon/{w83791d => w83791d.rst}  |   2 +-
> > >  Documentation/hwmon/{w83792d => w83792d.rst}  |   0
> > >  Documentation/hwmon/{w83793 => w83793.rst}    |   0
> > >  Documentation/hwmon/{w83795 => w83795.rst}    |   0
> > >  .../hwmon/{w83l785ts => w83l785ts.rst}        |   0
> > >  .../hwmon/{w83l786ng => w83l786ng.rst}        |   0
> > >  Documentation/hwmon/{wm831x => wm831x.rst}    |   0
> > >  Documentation/hwmon/{wm8350 => wm8350.rst}    |   0
> > >  .../hwmon/{xgene-hwmon => xgene-hwmon.rst}    |   0
> > >  Documentation/hwmon/{zl6100 => zl6100.rst}    |   2 +-
> > >  Documentation/index.rst                       |   1 +
> > >  Documentation/thermal/sysfs-api.txt           |   2 +-
> > >  MAINTAINERS                                   | 108 +++++------
> > >  drivers/hwmon/Kconfig                         |   8 +-
> > >  drivers/hwmon/ads7828.c                       |   2 +-
> > >  drivers/hwmon/max197.c                        |   2 +-
> > >  drivers/hwmon/sht15.c                         |   2 +-
> > >  include/linux/platform_data/ads7828.h         |   2 +-
> > >  include/linux/platform_data/ds620.h           |   2 +-
> > >  include/linux/platform_data/ina2xx.h          |   2 +-
> > >  include/linux/platform_data/max197.h          |   2 +-
> > >  include/linux/platform_data/ntc_thermistor.h  |   2 +-
> > >  173 files changed, 275 insertions(+), 102 deletions(-)
> > >  rename Documentation/hwmon/{ab8500 => ab8500.rst} (86%)
> > >  rename Documentation/hwmon/{abituguru-datasheet => abituguru-datasheet.rst} (100%)
> > >  rename Documentation/hwmon/{abituguru => abituguru.rst} (100%)
> > >  rename Documentation/hwmon/{abituguru3 => abituguru3.rst} (100%)
> > >  rename Documentation/hwmon/{abx500 => abx500.rst} (100%)
> > >  rename Documentation/hwmon/{acpi_power_meter => acpi_power_meter.rst} (97%)
> > >  rename Documentation/hwmon/{ad7314 => ad7314.rst} (100%)
> > >  rename Documentation/hwmon/{adc128d818 => adc128d818.rst} (100%)
> > >  rename Documentation/hwmon/{adm1021 => adm1021.rst} (100%)
> > >  rename Documentation/hwmon/{adm1025 => adm1025.rst} (100%)
> > >  rename Documentation/hwmon/{adm1026 => adm1026.rst} (100%)
> > >  rename Documentation/hwmon/{adm1031 => adm1031.rst} (100%)
> > >  rename Documentation/hwmon/{adm1275 => adm1275.rst} (97%)
> > >  rename Documentation/hwmon/{adm9240 => adm9240.rst} (100%)
> > >  rename Documentation/hwmon/{ads1015 => ads1015.rst} (100%)
> > >  rename Documentation/hwmon/{ads7828 => ads7828.rst} (100%)
> > >  rename Documentation/hwmon/{adt7410 => adt7410.rst} (100%)
> > >  rename Documentation/hwmon/{adt7411 => adt7411.rst} (100%)
> > >  rename Documentation/hwmon/{adt7462 => adt7462.rst} (99%)
> > >  rename Documentation/hwmon/{adt7470 => adt7470.rst} (100%)
> > >  rename Documentation/hwmon/{adt7475 => adt7475.rst} (100%)
> > >  rename Documentation/hwmon/{amc6821 => amc6821.rst} (99%)
> > >  rename Documentation/hwmon/{asb100 => asb100.rst} (99%)
> > >  rename Documentation/hwmon/{asc7621 => asc7621.rst} (100%)
> > >  rename Documentation/hwmon/{aspeed-pwm-tacho => aspeed-pwm-tacho.rst} (100%)
> > >  rename Documentation/hwmon/{coretemp => coretemp.rst} (100%)
> > >  rename Documentation/hwmon/{da9052 => da9052.rst} (100%)
> > >  rename Documentation/hwmon/{da9055 => da9055.rst} (100%)
> > >  rename Documentation/hwmon/{dme1737 => dme1737.rst} (100%)
> > >  rename Documentation/hwmon/{ds1621 => ds1621.rst} (100%)
> > >  rename Documentation/hwmon/{ds620 => ds620.rst} (100%)
> > >  rename Documentation/hwmon/{emc1403 => emc1403.rst} (100%)
> > >  rename Documentation/hwmon/{emc2103 => emc2103.rst} (100%)
> > >  rename Documentation/hwmon/{emc6w201 => emc6w201.rst} (100%)
> > >  rename Documentation/hwmon/{f71805f => f71805f.rst} (100%)
> > >  rename Documentation/hwmon/{f71882fg => f71882fg.rst} (100%)
> > >  rename Documentation/hwmon/{fam15h_power => fam15h_power.rst} (100%)
> > >  rename Documentation/hwmon/{ftsteutates => ftsteutates.rst} (100%)
> > >  rename Documentation/hwmon/{g760a => g760a.rst} (100%)
> > >  rename Documentation/hwmon/{g762 => g762.rst} (97%)
> > >  rename Documentation/hwmon/{gl518sm => gl518sm.rst} (100%)
> > >  rename Documentation/hwmon/{hih6130 => hih6130.rst} (100%)
> > >  rename Documentation/hwmon/{hwmon-kernel-api.txt => hwmon-kernel-api.rst} (99%)
> > >  rename Documentation/hwmon/{ibm-cffps => ibm-cffps.rst} (100%)
> > >  rename Documentation/hwmon/{ibmaem => ibmaem.rst} (100%)
> > >  rename Documentation/hwmon/{ibmpowernv => ibmpowernv.rst} (100%)
> > >  rename Documentation/hwmon/{ina209 => ina209.rst} (100%)
> > >  rename Documentation/hwmon/{ina2xx => ina2xx.rst} (97%)
> > >  rename Documentation/hwmon/{ina3221 => ina3221.rst} (100%)
> > >  create mode 100644 Documentation/hwmon/index.rst
> > >  rename Documentation/hwmon/{ir35221 => ir35221.rst} (100%)
> > >  rename Documentation/hwmon/{it87 => it87.rst} (100%)
> > >  rename Documentation/hwmon/{jc42 => jc42.rst} (100%)
> > >  rename Documentation/hwmon/{k10temp => k10temp.rst} (100%)
> > >  rename Documentation/hwmon/{k8temp => k8temp.rst} (100%)
> > >  rename Documentation/hwmon/{lineage-pem => lineage-pem.rst} (100%)
> > >  rename Documentation/hwmon/{lm25066 => lm25066.rst} (97%)
> > >  rename Documentation/hwmon/{lm63 => lm63.rst} (100%)
> > >  rename Documentation/hwmon/{lm70 => lm70.rst} (100%)
> > >  rename Documentation/hwmon/{lm73 => lm73.rst} (100%)
> > >  rename Documentation/hwmon/{lm75 => lm75.rst} (100%)
> > >  rename Documentation/hwmon/{lm77 => lm77.rst} (100%)
> > >  rename Documentation/hwmon/{lm78 => lm78.rst} (100%)
> > >  rename Documentation/hwmon/{lm80 => lm80.rst} (100%)
> > >  rename Documentation/hwmon/{lm83 => lm83.rst} (100%)
> > >  rename Documentation/hwmon/{lm85 => lm85.rst} (100%)
> > >  rename Documentation/hwmon/{lm87 => lm87.rst} (100%)
> > >  rename Documentation/hwmon/{lm90 => lm90.rst} (100%)
> > >  rename Documentation/hwmon/{lm92 => lm92.rst} (100%)
> > >  rename Documentation/hwmon/{lm93 => lm93.rst} (100%)
> > >  rename Documentation/hwmon/{lm95234 => lm95234.rst} (100%)
> > >  rename Documentation/hwmon/{lm95245 => lm95245.rst} (100%)
> > >  rename Documentation/hwmon/{ltc2945 => ltc2945.rst} (100%)
> > >  rename Documentation/hwmon/{ltc2978 => ltc2978.rst} (100%)
> > >  rename Documentation/hwmon/{ltc2990 => ltc2990.rst} (100%)
> > >  rename Documentation/hwmon/{ltc3815 => ltc3815.rst} (100%)
> > >  rename Documentation/hwmon/{ltc4151 => ltc4151.rst} (100%)
> > >  rename Documentation/hwmon/{ltc4215 => ltc4215.rst} (100%)
> > >  rename Documentation/hwmon/{ltc4245 => ltc4245.rst} (100%)
> > >  rename Documentation/hwmon/{ltc4260 => ltc4260.rst} (100%)
> > >  rename Documentation/hwmon/{ltc4261 => ltc4261.rst} (100%)
> > >  rename Documentation/hwmon/{max16064 => max16064.rst} (96%)
> > >  rename Documentation/hwmon/{max16065 => max16065.rst} (100%)
> > >  rename Documentation/hwmon/{max1619 => max1619.rst} (99%)
> > >  rename Documentation/hwmon/{max1668 => max1668.rst} (100%)
> > >  rename Documentation/hwmon/{max197 => max197.rst} (100%)
> > >  rename Documentation/hwmon/{max20751 => max20751.rst} (96%)
> > >  rename Documentation/hwmon/{max31722 => max31722.rst} (100%)
> > >  rename Documentation/hwmon/{max31785 => max31785.rst} (100%)
> > >  rename Documentation/hwmon/{max31790 => max31790.rst} (100%)
> > >  rename Documentation/hwmon/{max34440 => max34440.rst} (98%)
> > >  rename Documentation/hwmon/{max6639 => max6639.rst} (100%)
> > >  rename Documentation/hwmon/{max6642 => max6642.rst} (100%)
> > >  rename Documentation/hwmon/{max6650 => max6650.rst} (99%)
> > >  rename Documentation/hwmon/{max6697 => max6697.rst} (100%)
> > >  rename Documentation/hwmon/{max8688 => max8688.rst} (97%)
> > >  rename Documentation/hwmon/{mc13783-adc => mc13783-adc.rst} (100%)
> > >  rename Documentation/hwmon/{mcp3021 => mcp3021.rst} (100%)
> > >  rename Documentation/hwmon/{menf21bmc => menf21bmc.rst} (100%)
> > >  rename Documentation/hwmon/{mlxreg-fan => mlxreg-fan.rst} (100%)
> > >  rename Documentation/hwmon/{nct6683 => nct6683.rst} (100%)
> > >  rename Documentation/hwmon/{nct6775 => nct6775.rst} (100%)
> > >  rename Documentation/hwmon/{nct7802 => nct7802.rst} (100%)
> > >  rename Documentation/hwmon/{nct7904 => nct7904.rst} (100%)
> > >  rename Documentation/hwmon/{npcm750-pwm-fan => npcm750-pwm-fan.rst} (100%)
> > >  rename Documentation/hwmon/{nsa320 => nsa320.rst} (100%)
> > >  rename Documentation/hwmon/{ntc_thermistor => ntc_thermistor.rst} (100%)
> > >  rename Documentation/hwmon/{occ => occ.rst} (100%)
> > >  rename Documentation/hwmon/{pc87360 => pc87360.rst} (100%)
> > >  rename Documentation/hwmon/{pc87427 => pc87427.rst} (100%)
> > >  rename Documentation/hwmon/{pcf8591 => pcf8591.rst} (100%)
> > >  rename Documentation/hwmon/{pmbus-core => pmbus-core.rst} (100%)
> > >  rename Documentation/hwmon/{pmbus => pmbus.rst} (100%)
> > >  rename Documentation/hwmon/{powr1220 => powr1220.rst} (100%)
> > >  rename Documentation/hwmon/{pwm-fan => pwm-fan.rst} (100%)
> > >  rename Documentation/hwmon/{raspberrypi-hwmon => raspberrypi-hwmon.rst} (100%)
> > >  rename Documentation/hwmon/{sch5627 => sch5627.rst} (100%)
> > >  rename Documentation/hwmon/{sch5636 => sch5636.rst} (100%)
> > >  rename Documentation/hwmon/{scpi-hwmon => scpi-hwmon.rst} (100%)
> > >  rename Documentation/hwmon/{sht15 => sht15.rst} (100%)
> > >  rename Documentation/hwmon/{sht21 => sht21.rst} (100%)
> > >  rename Documentation/hwmon/{sht3x => sht3x.rst} (100%)
> > >  rename Documentation/hwmon/{shtc1 => shtc1.rst} (100%)
> > >  rename Documentation/hwmon/{sis5595 => sis5595.rst} (99%)
> > >  rename Documentation/hwmon/{smm665 => smm665.rst} (100%)
> > >  rename Documentation/hwmon/{smsc47b397 => smsc47b397.rst} (100%)
> > >  rename Documentation/hwmon/{smsc47m1 => smsc47m1.rst} (100%)
> > >  rename Documentation/hwmon/{smsc47m192 => smsc47m192.rst} (100%)
> > >  rename Documentation/hwmon/{submitting-patches => submitting-patches.rst} (98%)
> > >  rename Documentation/hwmon/{sysfs-interface => sysfs-interface.rst} (100%)
> > >  rename Documentation/hwmon/{tc654 => tc654.rst} (100%)
> > >  rename Documentation/hwmon/{tc74 => tc74.rst} (100%)
> > >  rename Documentation/hwmon/{thmc50 => thmc50.rst} (99%)
> > >  rename Documentation/hwmon/{tmp102 => tmp102.rst} (93%)
> > >  rename Documentation/hwmon/{tmp103 => tmp103.rst} (92%)
> > >  rename Documentation/hwmon/{tmp108 => tmp108.rst} (95%)
> > >  rename Documentation/hwmon/{tmp401 => tmp401.rst} (97%)
> > >  rename Documentation/hwmon/{tmp421 => tmp421.rst} (100%)
> > >  rename Documentation/hwmon/{tps40422 => tps40422.rst} (96%)
> > >  rename Documentation/hwmon/{twl4030-madc-hwmon => twl4030-madc-hwmon.rst} (100%)
> > >  rename Documentation/hwmon/{ucd9000 => ucd9000.rst} (97%)
> > >  rename Documentation/hwmon/{ucd9200 => ucd9200.rst} (97%)
> > >  rename Documentation/hwmon/{userspace-tools => userspace-tools.rst} (100%)
> > >  rename Documentation/hwmon/{vexpress => vexpress.rst} (100%)
> > >  rename Documentation/hwmon/{via686a => via686a.rst} (100%)
> > >  rename Documentation/hwmon/{vt1211 => vt1211.rst} (100%)
> > >  rename Documentation/hwmon/{w83627ehf => w83627ehf.rst} (100%)
> > >  rename Documentation/hwmon/{w83627hf => w83627hf.rst} (100%)
> > >  rename Documentation/hwmon/{w83773g => w83773g.rst} (100%)
> > >  rename Documentation/hwmon/{w83781d => w83781d.rst} (100%)
> > >  rename Documentation/hwmon/{w83791d => w83791d.rst} (99%)
> > >  rename Documentation/hwmon/{w83792d => w83792d.rst} (100%)
> > >  rename Documentation/hwmon/{w83793 => w83793.rst} (100%)
> > >  rename Documentation/hwmon/{w83795 => w83795.rst} (100%)
> > >  rename Documentation/hwmon/{w83l785ts => w83l785ts.rst} (100%)
> > >  rename Documentation/hwmon/{w83l786ng => w83l786ng.rst} (100%)
> > >  rename Documentation/hwmon/{wm831x => wm831x.rst} (100%)
> > >  rename Documentation/hwmon/{wm8350 => wm8350.rst} (100%)
> > >  rename Documentation/hwmon/{xgene-hwmon => xgene-hwmon.rst} (100%)
> > >  rename Documentation/hwmon/{zl6100 => zl6100.rst} (98%)
> > > 
> > > diff --git a/Documentation/devicetree/bindings/hwmon/g762.txt b/Documentation/devicetree/bindings/hwmon/g762.txt
> > > index 25cc6d8ee575..6d154c4923de 100644
> > > --- a/Documentation/devicetree/bindings/hwmon/g762.txt
> > > +++ b/Documentation/devicetree/bindings/hwmon/g762.txt
> > > @@ -21,7 +21,7 @@ If an optional property is not set in .dts file, then current value is kept
> > >  unmodified (e.g. u-boot installed value).
> > >  
> > >  Additional information on operational parameters for the device is available
> > > -in Documentation/hwmon/g762. A detailed datasheet for the device is available
> > > +in Documentation/hwmon/g762.rst. A detailed datasheet for the device is available
> > >  at http://natisbad.org/NAS/refs/GMT_EDS-762_763-080710-0.2.pdf.
> > >  
> > >  Example g762 node:
> > > diff --git a/Documentation/hwmon/ab8500 b/Documentation/hwmon/ab8500.rst
> > > similarity index 86%
> > > rename from Documentation/hwmon/ab8500
> > > rename to Documentation/hwmon/ab8500.rst
> > > index d87c61151239..33f93a9cec04 100644
> > > --- a/Documentation/hwmon/ab8500
> > > +++ b/Documentation/hwmon/ab8500.rst
> > > @@ -18,7 +18,7 @@ Authors:
> > >  Description
> > >  -----------
> > >  
> > > -See also Documentation/hwmon/abx500. This is the ST-Ericsson AB8500 specific
> > > +See also Documentation/hwmon/abx500.rst. This is the ST-Ericsson AB8500 specific
> > >  driver.
> > >  
> > >  Currently only the AB8500 internal sensor and one external sensor for battery
> > > diff --git a/Documentation/hwmon/abituguru-datasheet b/Documentation/hwmon/abituguru-datasheet.rst
> > > similarity index 100%
> > > rename from Documentation/hwmon/abituguru-datasheet
> > > rename to Documentation/hwmon/abituguru-datasheet.rst
> > > diff --git a/Documentation/hwmon/abituguru b/Documentation/hwmon/abituguru.rst
> > > similarity index 100%
> > > rename from Documentation/hwmon/abituguru
> > > rename to Documentation/hwmon/abituguru.rst
> > > diff --git a/Documentation/hwmon/abituguru3 b/Documentation/hwmon/abituguru3.rst
> > > similarity index 100%
> > > rename from Documentation/hwmon/abituguru3
> > > rename to Documentation/hwmon/abituguru3.rst
> > > diff --git a/Documentation/hwmon/abx500 b/Documentation/hwmon/abx500.rst
> > > similarity index 100%
> > > rename from Documentation/hwmon/abx500
> > > rename to Documentation/hwmon/abx500.rst
> > > diff --git a/Documentation/hwmon/acpi_power_meter b/Documentation/hwmon/acpi_power_meter.rst
> > > similarity index 97%
> > > rename from Documentation/hwmon/acpi_power_meter
> > > rename to Documentation/hwmon/acpi_power_meter.rst
> > > index 7665ca6ba957..4a0941ade0ca 100644
> > > --- a/Documentation/hwmon/acpi_power_meter
> > > +++ b/Documentation/hwmon/acpi_power_meter.rst
> > > @@ -21,7 +21,7 @@ the ACPI 4.0 spec (Chapter 10.4).  These devices have a simple set of
> > >  features--a power meter that returns average power use over a configurable
> > >  interval, an optional capping mechanism, and a couple of trip points.  The
> > >  sysfs interface conforms with the specification outlined in the "Power" section
> > > -of Documentation/hwmon/sysfs-interface.
> > > +of Documentation/hwmon/sysfs-interface.rst.
> > >  
> > >  Special Features
> > >  ----------------
> > > diff --git a/Documentation/hwmon/ad7314 b/Documentation/hwmon/ad7314.rst
> > > similarity index 100%
> > > rename from Documentation/hwmon/ad7314
> > > rename to Documentation/hwmon/ad7314.rst
> > > diff --git a/Documentation/hwmon/adc128d818 b/Documentation/hwmon/adc128d818.rst
> > > similarity index 100%
> > > rename from Documentation/hwmon/adc128d818
> > > rename to Documentation/hwmon/adc128d818.rst
> > > diff --git a/Documentation/hwmon/adm1021 b/Documentation/hwmon/adm1021.rst
> > > similarity index 100%
> > > rename from Documentation/hwmon/adm1021
> > > rename to Documentation/hwmon/adm1021.rst
> > > diff --git a/Documentation/hwmon/adm1025 b/Documentation/hwmon/adm1025.rst
> > > similarity index 100%
> > > rename from Documentation/hwmon/adm1025
> > > rename to Documentation/hwmon/adm1025.rst
> > > diff --git a/Documentation/hwmon/adm1026 b/Documentation/hwmon/adm1026.rst
> > > similarity index 100%
> > > rename from Documentation/hwmon/adm1026
> > > rename to Documentation/hwmon/adm1026.rst
> > > diff --git a/Documentation/hwmon/adm1031 b/Documentation/hwmon/adm1031.rst
> > > similarity index 100%
> > > rename from Documentation/hwmon/adm1031
> > > rename to Documentation/hwmon/adm1031.rst
> > > diff --git a/Documentation/hwmon/adm1275 b/Documentation/hwmon/adm1275.rst
> > > similarity index 97%
> > > rename from Documentation/hwmon/adm1275
> > > rename to Documentation/hwmon/adm1275.rst
> > > index 5c5860011d6e..9a1913e5b4d9 100644
> > > --- a/Documentation/hwmon/adm1275
> > > +++ b/Documentation/hwmon/adm1275.rst
> > > @@ -68,7 +68,7 @@ integrated 12 bit analog-to-digital converter (ADC), accessed using a
> > >  PMBus interface.
> > >  
> > >  The driver is a client driver to the core PMBus driver. Please see
> > > -Documentation/hwmon/pmbus for details on PMBus client drivers.
> > > +Documentation/hwmon/pmbus.rst for details on PMBus client drivers.
> > >  
> > >  
> > >  Usage Notes
> > > @@ -90,7 +90,7 @@ Platform data support
> > >  ---------------------
> > >  
> > >  The driver supports standard PMBus driver platform data. Please see
> > > -Documentation/hwmon/pmbus for details.
> > > +Documentation/hwmon/pmbus.rst for details.
> > >  
> > >  
> > >  Sysfs entries
> > > diff --git a/Documentation/hwmon/adm9240 b/Documentation/hwmon/adm9240.rst
> > > similarity index 100%
> > > rename from Documentation/hwmon/adm9240
> > > rename to Documentation/hwmon/adm9240.rst
> > > diff --git a/Documentation/hwmon/ads1015 b/Documentation/hwmon/ads1015.rst
> > > similarity index 100%
> > > rename from Documentation/hwmon/ads1015
> > > rename to Documentation/hwmon/ads1015.rst
> > > diff --git a/Documentation/hwmon/ads7828 b/Documentation/hwmon/ads7828.rst
> > > similarity index 100%
> > > rename from Documentation/hwmon/ads7828
> > > rename to Documentation/hwmon/ads7828.rst
> > > diff --git a/Documentation/hwmon/adt7410 b/Documentation/hwmon/adt7410.rst
> > > similarity index 100%
> > > rename from Documentation/hwmon/adt7410
> > > rename to Documentation/hwmon/adt7410.rst
> > > diff --git a/Documentation/hwmon/adt7411 b/Documentation/hwmon/adt7411.rst
> > > similarity index 100%
> > > rename from Documentation/hwmon/adt7411
> > > rename to Documentation/hwmon/adt7411.rst
> > > diff --git a/Documentation/hwmon/adt7462 b/Documentation/hwmon/adt7462.rst
> > > similarity index 99%
> > > rename from Documentation/hwmon/adt7462
> > > rename to Documentation/hwmon/adt7462.rst
> > > index a7a831118d32..139e19696188 100644
> > > --- a/Documentation/hwmon/adt7462
> > > +++ b/Documentation/hwmon/adt7462.rst
> > > @@ -68,4 +68,3 @@ The ADT7462 will scale the pwm between the lower and higher pwm speed when
> > >  the temperature is between the two temperature boundaries.  PWM values range
> > >  from 0 (off) to 255 (full speed).  Fan speed will be set to maximum when the
> > >  temperature sensor associated with the PWM control exceeds temp#_max.
> > > -
> > > diff --git a/Documentation/hwmon/adt7470 b/Documentation/hwmon/adt7470.rst
> > > similarity index 100%
> > > rename from Documentation/hwmon/adt7470
> > > rename to Documentation/hwmon/adt7470.rst
> > > diff --git a/Documentation/hwmon/adt7475 b/Documentation/hwmon/adt7475.rst
> > > similarity index 100%
> > > rename from Documentation/hwmon/adt7475
> > > rename to Documentation/hwmon/adt7475.rst
> > > diff --git a/Documentation/hwmon/amc6821 b/Documentation/hwmon/amc6821.rst
> > > similarity index 99%
> > > rename from Documentation/hwmon/amc6821
> > > rename to Documentation/hwmon/amc6821.rst
> > > index d10eabcbc0f3..5ddb2849da90 100644
> > > --- a/Documentation/hwmon/amc6821
> > > +++ b/Documentation/hwmon/amc6821.rst
> > > @@ -106,4 +106,3 @@ different settings, you can set the following parameters:
> > >  
> > >  - init=1,
> > >  - pwminv: 0 default pwm output, 1 inverts pwm output.
> > > -
> > > diff --git a/Documentation/hwmon/asb100 b/Documentation/hwmon/asb100.rst
> > > similarity index 99%
> > > rename from Documentation/hwmon/asb100
> > > rename to Documentation/hwmon/asb100.rst
> > > index 311d9f7b6926..c2d5f97085fe 100644
> > > --- a/Documentation/hwmon/asb100
> > > +++ b/Documentation/hwmon/asb100.rst
> > > @@ -71,4 +71,3 @@ TODO:
> > >    * Experiment with temp. sensor types.
> > >    * Are there really 13 voltage inputs? Probably not...
> > >    * Cleanups, no doubt...
> > > -
> > > diff --git a/Documentation/hwmon/asc7621 b/Documentation/hwmon/asc7621.rst
> > > similarity index 100%
> > > rename from Documentation/hwmon/asc7621
> > > rename to Documentation/hwmon/asc7621.rst
> > > diff --git a/Documentation/hwmon/aspeed-pwm-tacho b/Documentation/hwmon/aspeed-pwm-tacho.rst
> > > similarity index 100%
> > > rename from Documentation/hwmon/aspeed-pwm-tacho
> > > rename to Documentation/hwmon/aspeed-pwm-tacho.rst
> > > diff --git a/Documentation/hwmon/coretemp b/Documentation/hwmon/coretemp.rst
> > > similarity index 100%
> > > rename from Documentation/hwmon/coretemp
> > > rename to Documentation/hwmon/coretemp.rst
> > > diff --git a/Documentation/hwmon/da9052 b/Documentation/hwmon/da9052.rst
> > > similarity index 100%
> > > rename from Documentation/hwmon/da9052
> > > rename to Documentation/hwmon/da9052.rst
> > > diff --git a/Documentation/hwmon/da9055 b/Documentation/hwmon/da9055.rst
> > > similarity index 100%
> > > rename from Documentation/hwmon/da9055
> > > rename to Documentation/hwmon/da9055.rst
> > > diff --git a/Documentation/hwmon/dme1737 b/Documentation/hwmon/dme1737.rst
> > > similarity index 100%
> > > rename from Documentation/hwmon/dme1737
> > > rename to Documentation/hwmon/dme1737.rst
> > > diff --git a/Documentation/hwmon/ds1621 b/Documentation/hwmon/ds1621.rst
> > > similarity index 100%
> > > rename from Documentation/hwmon/ds1621
> > > rename to Documentation/hwmon/ds1621.rst
> > > diff --git a/Documentation/hwmon/ds620 b/Documentation/hwmon/ds620.rst
> > > similarity index 100%
> > > rename from Documentation/hwmon/ds620
> > > rename to Documentation/hwmon/ds620.rst
> > > diff --git a/Documentation/hwmon/emc1403 b/Documentation/hwmon/emc1403.rst
> > > similarity index 100%
> > > rename from Documentation/hwmon/emc1403
> > > rename to Documentation/hwmon/emc1403.rst
> > > diff --git a/Documentation/hwmon/emc2103 b/Documentation/hwmon/emc2103.rst
> > > similarity index 100%
> > > rename from Documentation/hwmon/emc2103
> > > rename to Documentation/hwmon/emc2103.rst
> > > diff --git a/Documentation/hwmon/emc6w201 b/Documentation/hwmon/emc6w201.rst
> > > similarity index 100%
> > > rename from Documentation/hwmon/emc6w201
> > > rename to Documentation/hwmon/emc6w201.rst
> > > diff --git a/Documentation/hwmon/f71805f b/Documentation/hwmon/f71805f.rst
> > > similarity index 100%
> > > rename from Documentation/hwmon/f71805f
> > > rename to Documentation/hwmon/f71805f.rst
> > > diff --git a/Documentation/hwmon/f71882fg b/Documentation/hwmon/f71882fg.rst
> > > similarity index 100%
> > > rename from Documentation/hwmon/f71882fg
> > > rename to Documentation/hwmon/f71882fg.rst
> > > diff --git a/Documentation/hwmon/fam15h_power b/Documentation/hwmon/fam15h_power.rst
> > > similarity index 100%
> > > rename from Documentation/hwmon/fam15h_power
> > > rename to Documentation/hwmon/fam15h_power.rst
> > > diff --git a/Documentation/hwmon/ftsteutates b/Documentation/hwmon/ftsteutates.rst
> > > similarity index 100%
> > > rename from Documentation/hwmon/ftsteutates
> > > rename to Documentation/hwmon/ftsteutates.rst
> > > diff --git a/Documentation/hwmon/g760a b/Documentation/hwmon/g760a.rst
> > > similarity index 100%
> > > rename from Documentation/hwmon/g760a
> > > rename to Documentation/hwmon/g760a.rst
> > > diff --git a/Documentation/hwmon/g762 b/Documentation/hwmon/g762.rst
> > > similarity index 97%
> > > rename from Documentation/hwmon/g762
> > > rename to Documentation/hwmon/g762.rst
> > > index 54574e26df21..0371b3365c48 100644
> > > --- a/Documentation/hwmon/g762
> > > +++ b/Documentation/hwmon/g762.rst
> > > @@ -7,7 +7,7 @@ modes - PWM or DC - are supported by the device.
> > >  
> > >  For additional information, a detailed datasheet is available at
> > >  http://natisbad.org/NAS/ref/GMT_EDS-762_763-080710-0.2.pdf. sysfs
> > > -bindings are described in Documentation/hwmon/sysfs-interface.
> > > +bindings are described in Documentation/hwmon/sysfs-interface.rst.
> > >  
> > >  The following entries are available to the user in a subdirectory of
> > >  /sys/bus/i2c/drivers/g762/ to control the operation of the device.
> > > diff --git a/Documentation/hwmon/gl518sm b/Documentation/hwmon/gl518sm.rst
> > > similarity index 100%
> > > rename from Documentation/hwmon/gl518sm
> > > rename to Documentation/hwmon/gl518sm.rst
> > > diff --git a/Documentation/hwmon/hih6130 b/Documentation/hwmon/hih6130.rst
> > > similarity index 100%
> > > rename from Documentation/hwmon/hih6130
> > > rename to Documentation/hwmon/hih6130.rst
> > > diff --git a/Documentation/hwmon/hwmon-kernel-api.txt b/Documentation/hwmon/hwmon-kernel-api.rst
> > > similarity index 99%
> > > rename from Documentation/hwmon/hwmon-kernel-api.txt
> > > rename to Documentation/hwmon/hwmon-kernel-api.rst
> > > index b347b959fcda..c41eb6108103 100644
> > > --- a/Documentation/hwmon/hwmon-kernel-api.txt
> > > +++ b/Documentation/hwmon/hwmon-kernel-api.rst
> > > @@ -12,10 +12,10 @@ drivers that want to use the hardware monitoring framework.
> > >  This document does not describe what a hardware monitoring (hwmon) Driver or
> > >  Device is. It also does not describe the API which can be used by user space
> > >  to communicate with a hardware monitoring device. If you want to know this
> > > -then please read the following file: Documentation/hwmon/sysfs-interface.
> > > +then please read the following file: Documentation/hwmon/sysfs-interface.rst.
> > >  
> > >  For additional guidelines on how to write and improve hwmon drivers, please
> > > -also read Documentation/hwmon/submitting-patches.
> > > +also read Documentation/hwmon/submitting-patches.rst.
> > >  
> > >  The API
> > >  -------
> > > diff --git a/Documentation/hwmon/ibm-cffps b/Documentation/hwmon/ibm-cffps.rst
> > > similarity index 100%
> > > rename from Documentation/hwmon/ibm-cffps
> > > rename to Documentation/hwmon/ibm-cffps.rst
> > > diff --git a/Documentation/hwmon/ibmaem b/Documentation/hwmon/ibmaem.rst
> > > similarity index 100%
> > > rename from Documentation/hwmon/ibmaem
> > > rename to Documentation/hwmon/ibmaem.rst
> > > diff --git a/Documentation/hwmon/ibmpowernv b/Documentation/hwmon/ibmpowernv.rst
> > > similarity index 100%
> > > rename from Documentation/hwmon/ibmpowernv
> > > rename to Documentation/hwmon/ibmpowernv.rst
> > > diff --git a/Documentation/hwmon/ina209 b/Documentation/hwmon/ina209.rst
> > > similarity index 100%
> > > rename from Documentation/hwmon/ina209
> > > rename to Documentation/hwmon/ina209.rst
> > > diff --git a/Documentation/hwmon/ina2xx b/Documentation/hwmon/ina2xx.rst
> > > similarity index 97%
> > > rename from Documentation/hwmon/ina2xx
> > > rename to Documentation/hwmon/ina2xx.rst
> > > index 95badf9c396f..94b9a260c518 100644
> > > --- a/Documentation/hwmon/ina2xx
> > > +++ b/Documentation/hwmon/ina2xx.rst
> > > @@ -78,7 +78,7 @@ refer to the Documentation/devicetree/bindings/hwmon/ina2xx.txt for bindings
> > >  if the device tree is used.
> > >  
> > >  Additionally ina226 supports update_interval attribute as described in
> > > -Documentation/hwmon/sysfs-interface. Internally the interval is the sum of
> > > +Documentation/hwmon/sysfs-interface.rst. Internally the interval is the sum of
> > >  bus and shunt voltage conversion times multiplied by the averaging rate. We
> > >  don't touch the conversion times and only modify the number of averages. The
> > >  lower limit of the update_interval is 2 ms, the upper limit is 2253 ms.
> > > diff --git a/Documentation/hwmon/ina3221 b/Documentation/hwmon/ina3221.rst
> > > similarity index 100%
> > > rename from Documentation/hwmon/ina3221
> > > rename to Documentation/hwmon/ina3221.rst
> > > diff --git a/Documentation/hwmon/index.rst b/Documentation/hwmon/index.rst
> > > new file mode 100644
> > > index 000000000000..893804414510
> > > --- /dev/null
> > > +++ b/Documentation/hwmon/index.rst
> > > @@ -0,0 +1,179 @@
> > > +=========================
> > > +Linux Hardware Monitoring
> > > +=========================
> > > +
> > > +.. toctree::
> > > +   :maxdepth: 1
> > > +
> > > +   hwmon-kernel-api.rst
> > > +   pmbus-core.rst
> > > +   submitting-patches.rst
> > > +   sysfs-interface.rst
> > > +   userspace-tools.rst
> > > +
> > > +Hardware Monitoring Kernel Drivers
> > > +==================================
> > > +
> > > +.. toctree::
> > > +   :maxdepth: 1
> > > +
> > > +   ab8500.rst
> > > +   abituguru.rst
> > > +   abituguru3.rst
> > > +   abx500.rst
> > > +   acpi_power_meter.rst
> > > +   ad7314.rst
> > > +   adc128d818.rst
> > > +   adm1021.rst
> > > +   adm1025.rst
> > > +   adm1026.rst
> > > +   adm1031.rst
> > > +   adm1275.rst
> > > +   adm9240.rst
> > > +   ads1015.rst
> > > +   ads7828.rst
> > > +   adt7410.rst
> > > +   adt7411.rst
> > > +   adt7462.rst
> > > +   adt7470.rst
> > > +   adt7475.rst
> > > +   amc6821.rst
> > > +   asb100.rst
> > > +   asc7621.rst
> > > +   aspeed-pwm-tacho.rst
> > > +   coretemp.rst
> > > +   da9052.rst
> > > +   da9055.rst
> > > +   dme1737.rst
> > > +   ds1621.rst
> > > +   ds620.rst
> > > +   emc1403.rst
> > > +   emc2103.rst
> > > +   emc6w201.rst
> > > +   f71805f.rst
> > > +   f71882fg.rst
> > > +   fam15h_power.rst
> > > +   ftsteutates.rst
> > > +   g760a.rst
> > > +   g762.rst
> > > +   gl518sm.rst
> > > +   hih6130.rst
> > > +   ibmaem.rst
> > > +   ibm-cffps.rst
> > > +   ibmpowernv.rst
> > > +   ina209.rst
> > > +   ina2xx.rst
> > > +   ina3221.rst
> > > +   ir35221.rst
> > > +   it87.rst
> > > +   jc42.rst
> > > +   k10temp.rst
> > > +   k8temp.rst
> > > +   lineage-pem.rst
> > > +   lm25066.rst
> > > +   lm63.rst
> > > +   lm70.rst
> > > +   lm73.rst
> > > +   lm75.rst
> > > +   lm77.rst
> > > +   lm78.rst
> > > +   lm80.rst
> > > +   lm83.rst
> > > +   lm85.rst
> > > +   lm87.rst
> > > +   lm90.rst
> > > +   lm92.rst
> > > +   lm93.rst
> > > +   lm95234.rst
> > > +   lm95245.rst
> > > +   ltc2945.rst
> > > +   ltc2978.rst
> > > +   ltc2990.rst
> > > +   ltc3815.rst
> > > +   ltc4151.rst
> > > +   ltc4215.rst
> > > +   ltc4245.rst
> > > +   ltc4260.rst
> > > +   ltc4261.rst
> > > +   max16064.rst
> > > +   max16065.rst
> > > +   max1619.rst
> > > +   max1668.rst
> > > +   max197.rst
> > > +   max20751.rst
> > > +   max31722.rst
> > > +   max31785.rst
> > > +   max31790.rst
> > > +   max34440.rst
> > > +   max6639.rst
> > > +   max6642.rst
> > > +   max6650.rst
> > > +   max6697.rst
> > > +   max8688.rst
> > > +   mc13783-adc.rst
> > > +   mcp3021.rst
> > > +   menf21bmc.rst
> > > +   mlxreg-fan.rst
> > > +   nct6683.rst
> > > +   nct6775.rst
> > > +   nct7802.rst
> > > +   nct7904.rst
> > > +   npcm750-pwm-fan.rst
> > > +   nsa320.rst
> > > +   ntc_thermistor.rst
> > > +   occ.rst
> > > +   pc87360.rst
> > > +   pc87427.rst
> > > +   pcf8591.rst
> > > +   pmbus.rst
> > > +   powr1220.rst
> > > +   pwm-fan.rst
> > > +   raspberrypi-hwmon.rst
> > > +   sch5627.rst
> > > +   sch5636.rst
> > > +   scpi-hwmon.rst
> > > +   sht15.rst
> > > +   sht21.rst
> > > +   sht3x.rst
> > > +   shtc1.rst
> > > +   sis5595.rst
> > > +   smm665.rst
> > > +   smsc47b397.rst
> > > +   smsc47m192.rst
> > > +   smsc47m1.rst
> > > +   tc654.rst
> > > +   tc74.rst
> > > +   thmc50.rst
> > > +   tmp102.rst
> > > +   tmp103.rst
> > > +   tmp108.rst
> > > +   tmp401.rst
> > > +   tmp421.rst
> > > +   tps40422.rst
> > > +   twl4030-madc-hwmon.rst
> > > +   ucd9000.rst
> > > +   ucd9200.rst
> > > +   vexpress.rst
> > > +   via686a.rst
> > > +   vt1211.rst
> > > +   w83627ehf.rst
> > > +   w83627hf.rst
> > > +   w83773g.rst
> > > +   w83781d.rst
> > > +   w83791d.rst
> > > +   w83792d.rst
> > > +   w83793.rst
> > > +   w83795.rst
> > > +   w83l785ts.rst
> > > +   w83l786ng.rst
> > > +   wm831x.rst
> > > +   wm8350.rst
> > > +   xgene-hwmon.rst
> > > +   zl6100.rst
> > > +
> > > +.. only::  subproject and html
> > > +
> > > +   Indices
> > > +   =======
> > > +
> > > +   * :ref:`genindex`
> > > diff --git a/Documentation/hwmon/ir35221 b/Documentation/hwmon/ir35221.rst
> > > similarity index 100%
> > > rename from Documentation/hwmon/ir35221
> > > rename to Documentation/hwmon/ir35221.rst
> > > diff --git a/Documentation/hwmon/it87 b/Documentation/hwmon/it87.rst
> > > similarity index 100%
> > > rename from Documentation/hwmon/it87
> > > rename to Documentation/hwmon/it87.rst
> > > diff --git a/Documentation/hwmon/jc42 b/Documentation/hwmon/jc42.rst
> > > similarity index 100%
> > > rename from Documentation/hwmon/jc42
> > > rename to Documentation/hwmon/jc42.rst
> > > diff --git a/Documentation/hwmon/k10temp b/Documentation/hwmon/k10temp.rst
> > > similarity index 100%
> > > rename from Documentation/hwmon/k10temp
> > > rename to Documentation/hwmon/k10temp.rst
> > > diff --git a/Documentation/hwmon/k8temp b/Documentation/hwmon/k8temp.rst
> > > similarity index 100%
> > > rename from Documentation/hwmon/k8temp
> > > rename to Documentation/hwmon/k8temp.rst
> > > diff --git a/Documentation/hwmon/lineage-pem b/Documentation/hwmon/lineage-pem.rst
> > > similarity index 100%
> > > rename from Documentation/hwmon/lineage-pem
> > > rename to Documentation/hwmon/lineage-pem.rst
> > > diff --git a/Documentation/hwmon/lm25066 b/Documentation/hwmon/lm25066.rst
> > > similarity index 97%
> > > rename from Documentation/hwmon/lm25066
> > > rename to Documentation/hwmon/lm25066.rst
> > > index 60b7f2722931..da15e3094c8c 100644
> > > --- a/Documentation/hwmon/lm25066
> > > +++ b/Documentation/hwmon/lm25066.rst
> > > @@ -69,7 +69,7 @@ LM25066, LM5064, and LM5066/LM5066I Power Management, Monitoring,
> > >  Control, and Protection ICs.
> > >  
> > >  The driver is a client driver to the core PMBus driver. Please see
> > > -Documentation/hwmon/pmbus for details on PMBus client drivers.
> > > +Documentation/hwmon/pmbus.rst for details on PMBus client drivers.
> > >  
> > >  
> > >  Usage Notes
> > > diff --git a/Documentation/hwmon/lm63 b/Documentation/hwmon/lm63.rst
> > > similarity index 100%
> > > rename from Documentation/hwmon/lm63
> > > rename to Documentation/hwmon/lm63.rst
> > > diff --git a/Documentation/hwmon/lm70 b/Documentation/hwmon/lm70.rst
> > > similarity index 100%
> > > rename from Documentation/hwmon/lm70
> > > rename to Documentation/hwmon/lm70.rst
> > > diff --git a/Documentation/hwmon/lm73 b/Documentation/hwmon/lm73.rst
> > > similarity index 100%
> > > rename from Documentation/hwmon/lm73
> > > rename to Documentation/hwmon/lm73.rst
> > > diff --git a/Documentation/hwmon/lm75 b/Documentation/hwmon/lm75.rst
> > > similarity index 100%
> > > rename from Documentation/hwmon/lm75
> > > rename to Documentation/hwmon/lm75.rst
> > > diff --git a/Documentation/hwmon/lm77 b/Documentation/hwmon/lm77.rst
> > > similarity index 100%
> > > rename from Documentation/hwmon/lm77
> > > rename to Documentation/hwmon/lm77.rst
> > > diff --git a/Documentation/hwmon/lm78 b/Documentation/hwmon/lm78.rst
> > > similarity index 100%
> > > rename from Documentation/hwmon/lm78
> > > rename to Documentation/hwmon/lm78.rst
> > > diff --git a/Documentation/hwmon/lm80 b/Documentation/hwmon/lm80.rst
> > > similarity index 100%
> > > rename from Documentation/hwmon/lm80
> > > rename to Documentation/hwmon/lm80.rst
> > > diff --git a/Documentation/hwmon/lm83 b/Documentation/hwmon/lm83.rst
> > > similarity index 100%
> > > rename from Documentation/hwmon/lm83
> > > rename to Documentation/hwmon/lm83.rst
> > > diff --git a/Documentation/hwmon/lm85 b/Documentation/hwmon/lm85.rst
> > > similarity index 100%
> > > rename from Documentation/hwmon/lm85
> > > rename to Documentation/hwmon/lm85.rst
> > > diff --git a/Documentation/hwmon/lm87 b/Documentation/hwmon/lm87.rst
> > > similarity index 100%
> > > rename from Documentation/hwmon/lm87
> > > rename to Documentation/hwmon/lm87.rst
> > > diff --git a/Documentation/hwmon/lm90 b/Documentation/hwmon/lm90.rst
> > > similarity index 100%
> > > rename from Documentation/hwmon/lm90
> > > rename to Documentation/hwmon/lm90.rst
> > > diff --git a/Documentation/hwmon/lm92 b/Documentation/hwmon/lm92.rst
> > > similarity index 100%
> > > rename from Documentation/hwmon/lm92
> > > rename to Documentation/hwmon/lm92.rst
> > > diff --git a/Documentation/hwmon/lm93 b/Documentation/hwmon/lm93.rst
> > > similarity index 100%
> > > rename from Documentation/hwmon/lm93
> > > rename to Documentation/hwmon/lm93.rst
> > > diff --git a/Documentation/hwmon/lm95234 b/Documentation/hwmon/lm95234.rst
> > > similarity index 100%
> > > rename from Documentation/hwmon/lm95234
> > > rename to Documentation/hwmon/lm95234.rst
> > > diff --git a/Documentation/hwmon/lm95245 b/Documentation/hwmon/lm95245.rst
> > > similarity index 100%
> > > rename from Documentation/hwmon/lm95245
> > > rename to Documentation/hwmon/lm95245.rst
> > > diff --git a/Documentation/hwmon/ltc2945 b/Documentation/hwmon/ltc2945.rst
> > > similarity index 100%
> > > rename from Documentation/hwmon/ltc2945
> > > rename to Documentation/hwmon/ltc2945.rst
> > > diff --git a/Documentation/hwmon/ltc2978 b/Documentation/hwmon/ltc2978.rst
> > > similarity index 100%
> > > rename from Documentation/hwmon/ltc2978
> > > rename to Documentation/hwmon/ltc2978.rst
> > > diff --git a/Documentation/hwmon/ltc2990 b/Documentation/hwmon/ltc2990.rst
> > > similarity index 100%
> > > rename from Documentation/hwmon/ltc2990
> > > rename to Documentation/hwmon/ltc2990.rst
> > > diff --git a/Documentation/hwmon/ltc3815 b/Documentation/hwmon/ltc3815.rst
> > > similarity index 100%
> > > rename from Documentation/hwmon/ltc3815
> > > rename to Documentation/hwmon/ltc3815.rst
> > > diff --git a/Documentation/hwmon/ltc4151 b/Documentation/hwmon/ltc4151.rst
> > > similarity index 100%
> > > rename from Documentation/hwmon/ltc4151
> > > rename to Documentation/hwmon/ltc4151.rst
> > > diff --git a/Documentation/hwmon/ltc4215 b/Documentation/hwmon/ltc4215.rst
> > > similarity index 100%
> > > rename from Documentation/hwmon/ltc4215
> > > rename to Documentation/hwmon/ltc4215.rst
> > > diff --git a/Documentation/hwmon/ltc4245 b/Documentation/hwmon/ltc4245.rst
> > > similarity index 100%
> > > rename from Documentation/hwmon/ltc4245
> > > rename to Documentation/hwmon/ltc4245.rst
> > > diff --git a/Documentation/hwmon/ltc4260 b/Documentation/hwmon/ltc4260.rst
> > > similarity index 100%
> > > rename from Documentation/hwmon/ltc4260
> > > rename to Documentation/hwmon/ltc4260.rst
> > > diff --git a/Documentation/hwmon/ltc4261 b/Documentation/hwmon/ltc4261.rst
> > > similarity index 100%
> > > rename from Documentation/hwmon/ltc4261
> > > rename to Documentation/hwmon/ltc4261.rst
> > > diff --git a/Documentation/hwmon/max16064 b/Documentation/hwmon/max16064.rst
> > > similarity index 96%
> > > rename from Documentation/hwmon/max16064
> > > rename to Documentation/hwmon/max16064.rst
> > > index 61ec679dc477..6d5e9538991f 100644
> > > --- a/Documentation/hwmon/max16064
> > > +++ b/Documentation/hwmon/max16064.rst
> > > @@ -21,7 +21,7 @@ This driver supports hardware monitoring for Maxim MAX16064 Quad Power-Supply
> > >  Controller with Active-Voltage Output Control and PMBus Interface.
> > >  
> > >  The driver is a client driver to the core PMBus driver.
> > > -Please see Documentation/hwmon/pmbus for details on PMBus client drivers.
> > > +Please see Documentation/hwmon/pmbus.rst for details on PMBus client drivers.
> > >  
> > >  
> > >  Usage Notes
> > > diff --git a/Documentation/hwmon/max16065 b/Documentation/hwmon/max16065.rst
> > > similarity index 100%
> > > rename from Documentation/hwmon/max16065
> > > rename to Documentation/hwmon/max16065.rst
> > > diff --git a/Documentation/hwmon/max1619 b/Documentation/hwmon/max1619.rst
> > > similarity index 99%
> > > rename from Documentation/hwmon/max1619
> > > rename to Documentation/hwmon/max1619.rst
> > > index 4b3762c4eceb..e25956e70f73 100644
> > > --- a/Documentation/hwmon/max1619
> > > +++ b/Documentation/hwmon/max1619.rst
> > > @@ -31,4 +31,3 @@ Only the external sensor has high and low limits.
> > >  The max1619 driver will not update its values more frequently than every
> > >  other second; reading them more often will do no harm, but will return
> > >  'old' values.
> > > -
> > > diff --git a/Documentation/hwmon/max1668 b/Documentation/hwmon/max1668.rst
> > > similarity index 100%
> > > rename from Documentation/hwmon/max1668
> > > rename to Documentation/hwmon/max1668.rst
> > > diff --git a/Documentation/hwmon/max197 b/Documentation/hwmon/max197.rst
> > > similarity index 100%
> > > rename from Documentation/hwmon/max197
> > > rename to Documentation/hwmon/max197.rst
> > > diff --git a/Documentation/hwmon/max20751 b/Documentation/hwmon/max20751.rst
> > > similarity index 96%
> > > rename from Documentation/hwmon/max20751
> > > rename to Documentation/hwmon/max20751.rst
> > > index d546695900ef..aa4469be6674 100644
> > > --- a/Documentation/hwmon/max20751
> > > +++ b/Documentation/hwmon/max20751.rst
> > > @@ -23,7 +23,7 @@ This driver supports MAX20751 Multiphase Master with PMBus Interface
> > >  and Internal Buck Converter.
> > >  
> > >  The driver is a client driver to the core PMBus driver.
> > > -Please see Documentation/hwmon/pmbus for details on PMBus client drivers.
> > > +Please see Documentation/hwmon/pmbus.rst for details on PMBus client drivers.
> > >  
> > >  
> > >  Usage Notes
> > > diff --git a/Documentation/hwmon/max31722 b/Documentation/hwmon/max31722.rst
> > > similarity index 100%
> > > rename from Documentation/hwmon/max31722
> > > rename to Documentation/hwmon/max31722.rst
> > > diff --git a/Documentation/hwmon/max31785 b/Documentation/hwmon/max31785.rst
> > > similarity index 100%
> > > rename from Documentation/hwmon/max31785
> > > rename to Documentation/hwmon/max31785.rst
> > > diff --git a/Documentation/hwmon/max31790 b/Documentation/hwmon/max31790.rst
> > > similarity index 100%
> > > rename from Documentation/hwmon/max31790
> > > rename to Documentation/hwmon/max31790.rst
> > > diff --git a/Documentation/hwmon/max34440 b/Documentation/hwmon/max34440.rst
> > > similarity index 98%
> > > rename from Documentation/hwmon/max34440
> > > rename to Documentation/hwmon/max34440.rst
> > > index 639838ef29fd..939138e12b02 100644
> > > --- a/Documentation/hwmon/max34440
> > > +++ b/Documentation/hwmon/max34440.rst
> > > @@ -76,7 +76,7 @@ based on GIN pins. The MAX34460 supports 12 voltage channels, and the MAX34461
> > >  supports 16 voltage channels.
> > >  
> > >  The driver is a client driver to the core PMBus driver. Please see
> > > -Documentation/hwmon/pmbus for details on PMBus client drivers.
> > > +Documentation/hwmon/pmbus.rst for details on PMBus client drivers.
> > >  
> > >  
> > >  Usage Notes
> > > diff --git a/Documentation/hwmon/max6639 b/Documentation/hwmon/max6639.rst
> > > similarity index 100%
> > > rename from Documentation/hwmon/max6639
> > > rename to Documentation/hwmon/max6639.rst
> > > diff --git a/Documentation/hwmon/max6642 b/Documentation/hwmon/max6642.rst
> > > similarity index 100%
> > > rename from Documentation/hwmon/max6642
> > > rename to Documentation/hwmon/max6642.rst
> > > diff --git a/Documentation/hwmon/max6650 b/Documentation/hwmon/max6650.rst
> > > similarity index 99%
> > > rename from Documentation/hwmon/max6650
> > > rename to Documentation/hwmon/max6650.rst
> > > index 74dc3f0caaa2..253482add082 100644
> > > --- a/Documentation/hwmon/max6650
> > > +++ b/Documentation/hwmon/max6650.rst
> > > @@ -72,4 +72,3 @@ clock: The clock frequency in Hz of the chip the driver should assume [254000]
> > >  
> > >  Please have a look at the MAX6650/6651 data sheet and make sure that you fully
> > >  understand the meaning of these parameters before you attempt to change them.
> > > -
> > > diff --git a/Documentation/hwmon/max6697 b/Documentation/hwmon/max6697.rst
> > > similarity index 100%
> > > rename from Documentation/hwmon/max6697
> > > rename to Documentation/hwmon/max6697.rst
> > > diff --git a/Documentation/hwmon/max8688 b/Documentation/hwmon/max8688.rst
> > > similarity index 97%
> > > rename from Documentation/hwmon/max8688
> > > rename to Documentation/hwmon/max8688.rst
> > > index 43da139234c1..009487759c61 100644
> > > --- a/Documentation/hwmon/max8688
> > > +++ b/Documentation/hwmon/max8688.rst
> > > @@ -21,7 +21,7 @@ This driver supports hardware monitoring for Maxim MAX8688 Digital Power-Supply
> > >  Controller/Monitor with PMBus Interface.
> > >  
> > >  The driver is a client driver to the core PMBus driver. Please see
> > > -Documentation/hwmon/pmbus for details on PMBus client drivers.
> > > +Documentation/hwmon/pmbus.rst for details on PMBus client drivers.
> > >  
> > >  
> > >  Usage Notes
> > > diff --git a/Documentation/hwmon/mc13783-adc b/Documentation/hwmon/mc13783-adc.rst
> > > similarity index 100%
> > > rename from Documentation/hwmon/mc13783-adc
> > > rename to Documentation/hwmon/mc13783-adc.rst
> > > diff --git a/Documentation/hwmon/mcp3021 b/Documentation/hwmon/mcp3021.rst
> > > similarity index 100%
> > > rename from Documentation/hwmon/mcp3021
> > > rename to Documentation/hwmon/mcp3021.rst
> > > diff --git a/Documentation/hwmon/menf21bmc b/Documentation/hwmon/menf21bmc.rst
> > > similarity index 100%
> > > rename from Documentation/hwmon/menf21bmc
> > > rename to Documentation/hwmon/menf21bmc.rst
> > > diff --git a/Documentation/hwmon/mlxreg-fan b/Documentation/hwmon/mlxreg-fan.rst
> > > similarity index 100%
> > > rename from Documentation/hwmon/mlxreg-fan
> > > rename to Documentation/hwmon/mlxreg-fan.rst
> > > diff --git a/Documentation/hwmon/nct6683 b/Documentation/hwmon/nct6683.rst
> > > similarity index 100%
> > > rename from Documentation/hwmon/nct6683
> > > rename to Documentation/hwmon/nct6683.rst
> > > diff --git a/Documentation/hwmon/nct6775 b/Documentation/hwmon/nct6775.rst
> > > similarity index 100%
> > > rename from Documentation/hwmon/nct6775
> > > rename to Documentation/hwmon/nct6775.rst
> > > diff --git a/Documentation/hwmon/nct7802 b/Documentation/hwmon/nct7802.rst
> > > similarity index 100%
> > > rename from Documentation/hwmon/nct7802
> > > rename to Documentation/hwmon/nct7802.rst
> > > diff --git a/Documentation/hwmon/nct7904 b/Documentation/hwmon/nct7904.rst
> > > similarity index 100%
> > > rename from Documentation/hwmon/nct7904
> > > rename to Documentation/hwmon/nct7904.rst
> > > diff --git a/Documentation/hwmon/npcm750-pwm-fan b/Documentation/hwmon/npcm750-pwm-fan.rst
> > > similarity index 100%
> > > rename from Documentation/hwmon/npcm750-pwm-fan
> > > rename to Documentation/hwmon/npcm750-pwm-fan.rst
> > > diff --git a/Documentation/hwmon/nsa320 b/Documentation/hwmon/nsa320.rst
> > > similarity index 100%
> > > rename from Documentation/hwmon/nsa320
> > > rename to Documentation/hwmon/nsa320.rst
> > > diff --git a/Documentation/hwmon/ntc_thermistor b/Documentation/hwmon/ntc_thermistor.rst
> > > similarity index 100%
> > > rename from Documentation/hwmon/ntc_thermistor
> > > rename to Documentation/hwmon/ntc_thermistor.rst
> > > diff --git a/Documentation/hwmon/occ b/Documentation/hwmon/occ.rst
> > > similarity index 100%
> > > rename from Documentation/hwmon/occ
> > > rename to Documentation/hwmon/occ.rst
> > > diff --git a/Documentation/hwmon/pc87360 b/Documentation/hwmon/pc87360.rst
> > > similarity index 100%
> > > rename from Documentation/hwmon/pc87360
> > > rename to Documentation/hwmon/pc87360.rst
> > > diff --git a/Documentation/hwmon/pc87427 b/Documentation/hwmon/pc87427.rst
> > > similarity index 100%
> > > rename from Documentation/hwmon/pc87427
> > > rename to Documentation/hwmon/pc87427.rst
> > > diff --git a/Documentation/hwmon/pcf8591 b/Documentation/hwmon/pcf8591.rst
> > > similarity index 100%
> > > rename from Documentation/hwmon/pcf8591
> > > rename to Documentation/hwmon/pcf8591.rst
> > > diff --git a/Documentation/hwmon/pmbus-core b/Documentation/hwmon/pmbus-core.rst
> > > similarity index 100%
> > > rename from Documentation/hwmon/pmbus-core
> > > rename to Documentation/hwmon/pmbus-core.rst
> > > diff --git a/Documentation/hwmon/pmbus b/Documentation/hwmon/pmbus.rst
> > > similarity index 100%
> > > rename from Documentation/hwmon/pmbus
> > > rename to Documentation/hwmon/pmbus.rst
> > > diff --git a/Documentation/hwmon/powr1220 b/Documentation/hwmon/powr1220.rst
> > > similarity index 100%
> > > rename from Documentation/hwmon/powr1220
> > > rename to Documentation/hwmon/powr1220.rst
> > > diff --git a/Documentation/hwmon/pwm-fan b/Documentation/hwmon/pwm-fan.rst
> > > similarity index 100%
> > > rename from Documentation/hwmon/pwm-fan
> > > rename to Documentation/hwmon/pwm-fan.rst
> > > diff --git a/Documentation/hwmon/raspberrypi-hwmon b/Documentation/hwmon/raspberrypi-hwmon.rst
> > > similarity index 100%
> > > rename from Documentation/hwmon/raspberrypi-hwmon
> > > rename to Documentation/hwmon/raspberrypi-hwmon.rst
> > > diff --git a/Documentation/hwmon/sch5627 b/Documentation/hwmon/sch5627.rst
> > > similarity index 100%
> > > rename from Documentation/hwmon/sch5627
> > > rename to Documentation/hwmon/sch5627.rst
> > > diff --git a/Documentation/hwmon/sch5636 b/Documentation/hwmon/sch5636.rst
> > > similarity index 100%
> > > rename from Documentation/hwmon/sch5636
> > > rename to Documentation/hwmon/sch5636.rst
> > > diff --git a/Documentation/hwmon/scpi-hwmon b/Documentation/hwmon/scpi-hwmon.rst
> > > similarity index 100%
> > > rename from Documentation/hwmon/scpi-hwmon
> > > rename to Documentation/hwmon/scpi-hwmon.rst
> > > diff --git a/Documentation/hwmon/sht15 b/Documentation/hwmon/sht15.rst
> > > similarity index 100%
> > > rename from Documentation/hwmon/sht15
> > > rename to Documentation/hwmon/sht15.rst
> > > diff --git a/Documentation/hwmon/sht21 b/Documentation/hwmon/sht21.rst
> > > similarity index 100%
> > > rename from Documentation/hwmon/sht21
> > > rename to Documentation/hwmon/sht21.rst
> > > diff --git a/Documentation/hwmon/sht3x b/Documentation/hwmon/sht3x.rst
> > > similarity index 100%
> > > rename from Documentation/hwmon/sht3x
> > > rename to Documentation/hwmon/sht3x.rst
> > > diff --git a/Documentation/hwmon/shtc1 b/Documentation/hwmon/shtc1.rst
> > > similarity index 100%
> > > rename from Documentation/hwmon/shtc1
> > > rename to Documentation/hwmon/shtc1.rst
> > > diff --git a/Documentation/hwmon/sis5595 b/Documentation/hwmon/sis5595.rst
> > > similarity index 99%
> > > rename from Documentation/hwmon/sis5595
> > > rename to Documentation/hwmon/sis5595.rst
> > > index 5acba6b0c0db..16123b3bfff9 100644
> > > --- a/Documentation/hwmon/sis5595
> > > +++ b/Documentation/hwmon/sis5595.rst
> > > @@ -121,4 +121,3 @@ Problems
> > >  --------
> > >  Some chips refuse to be enabled. We don't know why.
> > >  The driver will recognize this and print a message in dmesg.
> > > -
> > > diff --git a/Documentation/hwmon/smm665 b/Documentation/hwmon/smm665.rst
> > > similarity index 100%
> > > rename from Documentation/hwmon/smm665
> > > rename to Documentation/hwmon/smm665.rst
> > > diff --git a/Documentation/hwmon/smsc47b397 b/Documentation/hwmon/smsc47b397.rst
> > > similarity index 100%
> > > rename from Documentation/hwmon/smsc47b397
> > > rename to Documentation/hwmon/smsc47b397.rst
> > > diff --git a/Documentation/hwmon/smsc47m1 b/Documentation/hwmon/smsc47m1.rst
> > > similarity index 100%
> > > rename from Documentation/hwmon/smsc47m1
> > > rename to Documentation/hwmon/smsc47m1.rst
> > > diff --git a/Documentation/hwmon/smsc47m192 b/Documentation/hwmon/smsc47m192.rst
> > > similarity index 100%
> > > rename from Documentation/hwmon/smsc47m192
> > > rename to Documentation/hwmon/smsc47m192.rst
> > > diff --git a/Documentation/hwmon/submitting-patches b/Documentation/hwmon/submitting-patches.rst
> > > similarity index 98%
> > > rename from Documentation/hwmon/submitting-patches
> > > rename to Documentation/hwmon/submitting-patches.rst
> > > index 12540b7d9b50..f9796b9d9db6 100644
> > > --- a/Documentation/hwmon/submitting-patches
> > > +++ b/Documentation/hwmon/submitting-patches.rst
> > > @@ -39,7 +39,7 @@ increase the chances of your change being accepted.
> > >  2. Adding functionality to existing drivers
> > >  -------------------------------------------
> > >  
> > > -* Make sure the documentation in Documentation/hwmon/<driver_name> is up to
> > > +* Make sure the documentation in Documentation/hwmon/<driver_name>.rst is up to
> > >    date.
> > >  
> > >  * Make sure the information in Kconfig is up to date.
> > > @@ -61,7 +61,7 @@ increase the chances of your change being accepted.
> > >  
> > >  * Consider adding yourself to MAINTAINERS.
> > >  
> > > -* Document the driver in Documentation/hwmon/<driver_name>.
> > > +* Document the driver in Documentation/hwmon/<driver_name>.rst.
> > >  
> > >  * Add the driver to Kconfig and Makefile in alphabetical order.
> > >  
> > > @@ -134,7 +134,7 @@ increase the chances of your change being accepted.
> > >    non-standard attributes, or you believe you do, discuss it on the mailing list
> > >    first. Either case, provide a detailed explanation why you need the
> > >    non-standard attribute(s).
> > > -  Standard attributes are specified in Documentation/hwmon/sysfs-interface.
> > > +  Standard attributes are specified in Documentation/hwmon/sysfs-interface.rst.
> > >  
> > >  * When deciding which sysfs attributes to support, look at the chip's
> > >    capabilities. While we do not expect your driver to support everything the
> > > diff --git a/Documentation/hwmon/sysfs-interface b/Documentation/hwmon/sysfs-interface.rst
> > > similarity index 100%
> > > rename from Documentation/hwmon/sysfs-interface
> > > rename to Documentation/hwmon/sysfs-interface.rst
> > > diff --git a/Documentation/hwmon/tc654 b/Documentation/hwmon/tc654.rst
> > > similarity index 100%
> > > rename from Documentation/hwmon/tc654
> > > rename to Documentation/hwmon/tc654.rst
> > > diff --git a/Documentation/hwmon/tc74 b/Documentation/hwmon/tc74.rst
> > > similarity index 100%
> > > rename from Documentation/hwmon/tc74
> > > rename to Documentation/hwmon/tc74.rst
> > > diff --git a/Documentation/hwmon/thmc50 b/Documentation/hwmon/thmc50.rst
> > > similarity index 99%
> > > rename from Documentation/hwmon/thmc50
> > > rename to Documentation/hwmon/thmc50.rst
> > > index 6dba1b59b20c..cfff3885287d 100644
> > > --- a/Documentation/hwmon/thmc50
> > > +++ b/Documentation/hwmon/thmc50.rst
> > > @@ -87,4 +87,3 @@ so it stops fans even if the value 0 into the ANALOG_OUT register does not.
> > >  
> > >  The driver was tested on Compaq AP550 with two ADM1022 chips (one works
> > >  in the temp3 mode), five temperature readings and two fans.
> > > -
> > > diff --git a/Documentation/hwmon/tmp102 b/Documentation/hwmon/tmp102.rst
> > > similarity index 93%
> > > rename from Documentation/hwmon/tmp102
> > > rename to Documentation/hwmon/tmp102.rst
> > > index 5e34821df4ab..b1f585531a88 100644
> > > --- a/Documentation/hwmon/tmp102
> > > +++ b/Documentation/hwmon/tmp102.rst
> > > @@ -28,4 +28,4 @@ The TMP102 has a programmable update rate that can select between 8, 4, 1, and
> > >  0.5 Hz. (Currently the driver only supports the default of 4 Hz).
> > >  
> > >  The driver provides the common sysfs-interface for temperatures (see
> > > -Documentation/hwmon/sysfs-interface under Temperatures).
> > > +Documentation/hwmon/sysfs-interface.rst under Temperatures).
> > > diff --git a/Documentation/hwmon/tmp103 b/Documentation/hwmon/tmp103.rst
> > > similarity index 92%
> > > rename from Documentation/hwmon/tmp103
> > > rename to Documentation/hwmon/tmp103.rst
> > > index 7682a795e38c..15d25806d585 100644
> > > --- a/Documentation/hwmon/tmp103
> > > +++ b/Documentation/hwmon/tmp103.rst
> > > @@ -27,7 +27,7 @@ Resolution: 8 Bits
> > >  Accuracy: ±1°C Typ (–10°C to +100°C)
> > >  
> > >  The driver provides the common sysfs-interface for temperatures (see
> > > -Documentation/hwmon/sysfs-interface under Temperatures).
> > > +Documentation/hwmon/sysfs-interface.rst under Temperatures).
> > >  
> > >  Please refer how to instantiate this driver:
> > >  Documentation/i2c/instantiating-devices
> > > diff --git a/Documentation/hwmon/tmp108 b/Documentation/hwmon/tmp108.rst
> > > similarity index 95%
> > > rename from Documentation/hwmon/tmp108
> > > rename to Documentation/hwmon/tmp108.rst
> > > index 7e08b7ef1e2f..5f4266a16cb2 100644
> > > --- a/Documentation/hwmon/tmp108
> > > +++ b/Documentation/hwmon/tmp108.rst
> > > @@ -38,4 +38,4 @@ and then the device is shut down automatically. (This driver only supports
> > >  continuous mode.)
> > >  
> > >  The driver provides the common sysfs-interface for temperatures (see
> > > -Documentation/hwmon/sysfs-interface under Temperatures).
> > > +Documentation/hwmon/sysfs-interface.rst under Temperatures).
> > > diff --git a/Documentation/hwmon/tmp401 b/Documentation/hwmon/tmp401.rst
> > > similarity index 97%
> > > rename from Documentation/hwmon/tmp401
> > > rename to Documentation/hwmon/tmp401.rst
> > > index bd865bbdb38d..6a05a0719bc7 100644
> > > --- a/Documentation/hwmon/tmp401
> > > +++ b/Documentation/hwmon/tmp401.rst
> > > @@ -68,7 +68,7 @@ supported by the driver so far, so using the default resolution of 0.5
> > >  degree).
> > >  
> > >  The driver provides the common sysfs-interface for temperatures (see
> > > -Documentation/hwmon/sysfs-interface under Temperatures).
> > > +Documentation/hwmon/sysfs-interface.rst under Temperatures).
> > >  
> > >  The TMP411 and TMP431 chips are compatible with TMP401. TMP411 provides
> > >  some additional features.
> > > diff --git a/Documentation/hwmon/tmp421 b/Documentation/hwmon/tmp421.rst
> > > similarity index 100%
> > > rename from Documentation/hwmon/tmp421
> > > rename to Documentation/hwmon/tmp421.rst
> > > diff --git a/Documentation/hwmon/tps40422 b/Documentation/hwmon/tps40422.rst
> > > similarity index 96%
> > > rename from Documentation/hwmon/tps40422
> > > rename to Documentation/hwmon/tps40422.rst
> > > index 359751eb5ed4..b691e30479dd 100644
> > > --- a/Documentation/hwmon/tps40422
> > > +++ b/Documentation/hwmon/tps40422.rst
> > > @@ -21,7 +21,7 @@ This driver supports TI TPS40422 Dual-Output or Two-Phase Synchronous Buck
> > >  Controller with PMBus
> > >  
> > >  The driver is a client driver to the core PMBus driver.
> > > -Please see Documentation/hwmon/pmbus for details on PMBus client drivers.
> > > +Please see Documentation/hwmon/pmbus.rst for details on PMBus client drivers.
> > >  
> > >  
> > >  Usage Notes
> > > diff --git a/Documentation/hwmon/twl4030-madc-hwmon b/Documentation/hwmon/twl4030-madc-hwmon.rst
> > > similarity index 100%
> > > rename from Documentation/hwmon/twl4030-madc-hwmon
> > > rename to Documentation/hwmon/twl4030-madc-hwmon.rst
> > > diff --git a/Documentation/hwmon/ucd9000 b/Documentation/hwmon/ucd9000.rst
> > > similarity index 97%
> > > rename from Documentation/hwmon/ucd9000
> > > rename to Documentation/hwmon/ucd9000.rst
> > > index d69061b7312c..ebc4f2b3bfea 100644
> > > --- a/Documentation/hwmon/ucd9000
> > > +++ b/Documentation/hwmon/ucd9000.rst
> > > @@ -57,7 +57,7 @@ system-health monitor. The device integrates a 12-bit ADC for monitoring up to
> > >  13 power-supply voltage, current, or temperature inputs.
> > >  
> > >  This driver is a client driver to the core PMBus driver. Please see
> > > -Documentation/hwmon/pmbus for details on PMBus client drivers.
> > > +Documentation/hwmon/pmbus.rst for details on PMBus client drivers.
> > >  
> > >  
> > >  Usage Notes
> > > @@ -72,7 +72,7 @@ Platform data support
> > >  ---------------------
> > >  
> > >  The driver supports standard PMBus driver platform data. Please see
> > > -Documentation/hwmon/pmbus for details.
> > > +Documentation/hwmon/pmbus.rst for details.
> > >  
> > >  
> > >  Sysfs entries
> > > diff --git a/Documentation/hwmon/ucd9200 b/Documentation/hwmon/ucd9200.rst
> > > similarity index 97%
> > > rename from Documentation/hwmon/ucd9200
> > > rename to Documentation/hwmon/ucd9200.rst
> > > index 44eda4a579b6..b819dfd75f71 100644
> > > --- a/Documentation/hwmon/ucd9200
> > > +++ b/Documentation/hwmon/ucd9200.rst
> > > @@ -33,7 +33,7 @@ dedicated circuitry for DC/DC loop management with flash memory and a serial
> > >  interface to support configuration, monitoring and management.
> > >  
> > >  This driver is a client driver to the core PMBus driver. Please see
> > > -Documentation/hwmon/pmbus for details on PMBus client drivers.
> > > +Documentation/hwmon/pmbus.rst for details on PMBus client drivers.
> > >  
> > >  
> > >  Usage Notes
> > > @@ -48,7 +48,7 @@ Platform data support
> > >  ---------------------
> > >  
> > >  The driver supports standard PMBus driver platform data. Please see
> > > -Documentation/hwmon/pmbus for details.
> > > +Documentation/hwmon/pmbus.rst for details.
> > >  
> > >  
> > >  Sysfs entries
> > > diff --git a/Documentation/hwmon/userspace-tools b/Documentation/hwmon/userspace-tools.rst
> > > similarity index 100%
> > > rename from Documentation/hwmon/userspace-tools
> > > rename to Documentation/hwmon/userspace-tools.rst
> > > diff --git a/Documentation/hwmon/vexpress b/Documentation/hwmon/vexpress.rst
> > > similarity index 100%
> > > rename from Documentation/hwmon/vexpress
> > > rename to Documentation/hwmon/vexpress.rst
> > > diff --git a/Documentation/hwmon/via686a b/Documentation/hwmon/via686a.rst
> > > similarity index 100%
> > > rename from Documentation/hwmon/via686a
> > > rename to Documentation/hwmon/via686a.rst
> > > diff --git a/Documentation/hwmon/vt1211 b/Documentation/hwmon/vt1211.rst
> > > similarity index 100%
> > > rename from Documentation/hwmon/vt1211
> > > rename to Documentation/hwmon/vt1211.rst
> > > diff --git a/Documentation/hwmon/w83627ehf b/Documentation/hwmon/w83627ehf.rst
> > > similarity index 100%
> > > rename from Documentation/hwmon/w83627ehf
> > > rename to Documentation/hwmon/w83627ehf.rst
> > > diff --git a/Documentation/hwmon/w83627hf b/Documentation/hwmon/w83627hf.rst
> > > similarity index 100%
> > > rename from Documentation/hwmon/w83627hf
> > > rename to Documentation/hwmon/w83627hf.rst
> > > diff --git a/Documentation/hwmon/w83773g b/Documentation/hwmon/w83773g.rst
> > > similarity index 100%
> > > rename from Documentation/hwmon/w83773g
> > > rename to Documentation/hwmon/w83773g.rst
> > > diff --git a/Documentation/hwmon/w83781d b/Documentation/hwmon/w83781d.rst
> > > similarity index 100%
> > > rename from Documentation/hwmon/w83781d
> > > rename to Documentation/hwmon/w83781d.rst
> > > diff --git a/Documentation/hwmon/w83791d b/Documentation/hwmon/w83791d.rst
> > > similarity index 99%
> > > rename from Documentation/hwmon/w83791d
> > > rename to Documentation/hwmon/w83791d.rst
> > > index a91f9e5fb0c6..3adaed39b157 100644
> > > --- a/Documentation/hwmon/w83791d
> > > +++ b/Documentation/hwmon/w83791d.rst
> > > @@ -102,7 +102,7 @@ This file is used for both legacy and new code.
> > >  
> > >  The sysfs interface to the beep bitmask has migrated from the original legacy
> > >  method of a single sysfs beep_mask file to a newer method using multiple
> > > -`*_beep` files as described in `Documentation/hwmon/sysfs-interface`.
> > > +`*_beep` files as described in `Documentation/hwmon/sysfs-interface.rst`.
> > >  
> > >  A similar change has occurred for the bitmap corresponding to the alarms. The
> > >  original legacy method used a single sysfs alarms file containing a bitmap
> > > diff --git a/Documentation/hwmon/w83792d b/Documentation/hwmon/w83792d.rst
> > > similarity index 100%
> > > rename from Documentation/hwmon/w83792d
> > > rename to Documentation/hwmon/w83792d.rst
> > > diff --git a/Documentation/hwmon/w83793 b/Documentation/hwmon/w83793.rst
> > > similarity index 100%
> > > rename from Documentation/hwmon/w83793
> > > rename to Documentation/hwmon/w83793.rst
> > > diff --git a/Documentation/hwmon/w83795 b/Documentation/hwmon/w83795.rst
> > > similarity index 100%
> > > rename from Documentation/hwmon/w83795
> > > rename to Documentation/hwmon/w83795.rst
> > > diff --git a/Documentation/hwmon/w83l785ts b/Documentation/hwmon/w83l785ts.rst
> > > similarity index 100%
> > > rename from Documentation/hwmon/w83l785ts
> > > rename to Documentation/hwmon/w83l785ts.rst
> > > diff --git a/Documentation/hwmon/w83l786ng b/Documentation/hwmon/w83l786ng.rst
> > > similarity index 100%
> > > rename from Documentation/hwmon/w83l786ng
> > > rename to Documentation/hwmon/w83l786ng.rst
> > > diff --git a/Documentation/hwmon/wm831x b/Documentation/hwmon/wm831x.rst
> > > similarity index 100%
> > > rename from Documentation/hwmon/wm831x
> > > rename to Documentation/hwmon/wm831x.rst
> > > diff --git a/Documentation/hwmon/wm8350 b/Documentation/hwmon/wm8350.rst
> > > similarity index 100%
> > > rename from Documentation/hwmon/wm8350
> > > rename to Documentation/hwmon/wm8350.rst
> > > diff --git a/Documentation/hwmon/xgene-hwmon b/Documentation/hwmon/xgene-hwmon.rst
> > > similarity index 100%
> > > rename from Documentation/hwmon/xgene-hwmon
> > > rename to Documentation/hwmon/xgene-hwmon.rst
> > > diff --git a/Documentation/hwmon/zl6100 b/Documentation/hwmon/zl6100.rst
> > > similarity index 98%
> > > rename from Documentation/hwmon/zl6100
> > > rename to Documentation/hwmon/zl6100.rst
> > > index 4029970bace4..41513bb7fe51 100644
> > > --- a/Documentation/hwmon/zl6100
> > > +++ b/Documentation/hwmon/zl6100.rst
> > > @@ -113,7 +113,7 @@ This driver supports hardware monitoring for Intersil / Zilker Labs ZL6100 and
> > >  compatible digital DC-DC controllers.
> > >  
> > >  The driver is a client driver to the core PMBus driver. Please see
> > > -Documentation/hwmon/pmbus and Documentation.hwmon/pmbus-core for details
> > > +Documentation/hwmon/pmbus.rst and Documentation.hwmon/pmbus-core for details
> > >  on PMBus client drivers.
> > >  
> > >  
> > > diff --git a/Documentation/index.rst b/Documentation/index.rst
> > > index 80a421cb935e..3a710dc24fc8 100644
> > > --- a/Documentation/index.rst
> > > +++ b/Documentation/index.rst
> > > @@ -83,6 +83,7 @@ needed).
> > >     media/index
> > >     networking/index
> > >     input/index
> > > +   hwmon/index
> > >     gpu/index
> > >     security/index
> > >     sound/index
> > > diff --git a/Documentation/thermal/sysfs-api.txt b/Documentation/thermal/sysfs-api.txt
> > > index 911399730c1c..c3fa500df92c 100644
> > > --- a/Documentation/thermal/sysfs-api.txt
> > > +++ b/Documentation/thermal/sysfs-api.txt
> > > @@ -316,7 +316,7 @@ ACPI thermal zones.
> > >      |---temp[1-*]_input:	The current temperature of thermal zone [1-*]
> > >      |---temp[1-*]_critical:	The critical trip point of thermal zone [1-*]
> > >  
> > > -Please read Documentation/hwmon/sysfs-interface for additional information.
> > > +Please read Documentation/hwmon/sysfs-interface.rst for additional information.
> > >  
> > >  ***************************
> > >  * Thermal zone attributes *
> > > diff --git a/MAINTAINERS b/MAINTAINERS
> > > index 349e5d8c3f58..6269c9d671ca 100644
> > > --- a/MAINTAINERS
> > > +++ b/MAINTAINERS
> > > @@ -468,7 +468,7 @@ ADM1025 HARDWARE MONITOR DRIVER
> > >  M:	Jean Delvare <jdelvare@suse.com>
> > >  L:	linux-hwmon@vger.kernel.org
> > >  S:	Maintained
> > > -F:	Documentation/hwmon/adm1025
> > > +F:	Documentation/hwmon/adm1025.rst
> > >  F:	drivers/hwmon/adm1025.c
> > >  
> > >  ADM1029 HARDWARE MONITOR DRIVER
> > > @@ -520,7 +520,7 @@ ADS1015 HARDWARE MONITOR DRIVER
> > >  M:	Dirk Eibach <eibach@gdsys.de>
> > >  L:	linux-hwmon@vger.kernel.org
> > >  S:	Maintained
> > > -F:	Documentation/hwmon/ads1015
> > > +F:	Documentation/hwmon/ads1015.rst
> > >  F:	drivers/hwmon/ads1015.c
> > >  F:	include/linux/platform_data/ads1015.h
> > >  
> > > @@ -533,7 +533,7 @@ ADT7475 HARDWARE MONITOR DRIVER
> > >  M:	Jean Delvare <jdelvare@suse.com>
> > >  L:	linux-hwmon@vger.kernel.org
> > >  S:	Maintained
> > > -F:	Documentation/hwmon/adt7475
> > > +F:	Documentation/hwmon/adt7475.rst
> > >  F:	drivers/hwmon/adt7475.c
> > >  
> > >  ADVANSYS SCSI DRIVER
> > > @@ -764,7 +764,7 @@ AMD FAM15H PROCESSOR POWER MONITORING DRIVER
> > >  M:	Huang Rui <ray.huang@amd.com>
> > >  L:	linux-hwmon@vger.kernel.org
> > >  S:	Supported
> > > -F:	Documentation/hwmon/fam15h_power
> > > +F:	Documentation/hwmon/fam15h_power.rst
> > >  F:	drivers/hwmon/fam15h_power.c
> > >  
> > >  AMD FCH GPIO DRIVER
> > > @@ -2531,7 +2531,7 @@ ASC7621 HARDWARE MONITOR DRIVER
> > >  M:	George Joseph <george.joseph@fairview5.com>
> > >  L:	linux-hwmon@vger.kernel.org
> > >  S:	Maintained
> > > -F:	Documentation/hwmon/asc7621
> > > +F:	Documentation/hwmon/asc7621.rst
> > >  F:	drivers/hwmon/asc7621.c
> > >  
> > >  ASPEED VIDEO ENGINE DRIVER
> > > @@ -4071,7 +4071,7 @@ CORETEMP HARDWARE MONITORING DRIVER
> > >  M:	Fenghua Yu <fenghua.yu@intel.com>
> > >  L:	linux-hwmon@vger.kernel.org
> > >  S:	Maintained
> > > -F:	Documentation/hwmon/coretemp
> > > +F:	Documentation/hwmon/coretemp.rst
> > >  F:	drivers/hwmon/coretemp.c
> > >  
> > >  COSA/SRP SYNC SERIAL DRIVER
> > > @@ -4627,7 +4627,7 @@ DIALOG SEMICONDUCTOR DRIVERS
> > >  M:	Support Opensource <support.opensource@diasemi.com>
> > >  W:	http://www.dialog-semiconductor.com/products
> > >  S:	Supported
> > > -F:	Documentation/hwmon/da90??
> > > +F:	Documentation/hwmon/da90??.rst
> > >  F:	Documentation/devicetree/bindings/mfd/da90*.txt
> > >  F:	Documentation/devicetree/bindings/input/da90??-onkey.txt
> > >  F:	Documentation/devicetree/bindings/thermal/da90??-thermal.txt
> > > @@ -4778,7 +4778,7 @@ DME1737 HARDWARE MONITOR DRIVER
> > >  M:	Juerg Haefliger <juergh@gmail.com>
> > >  L:	linux-hwmon@vger.kernel.org
> > >  S:	Maintained
> > > -F:	Documentation/hwmon/dme1737
> > > +F:	Documentation/hwmon/dme1737.rst
> > >  F:	drivers/hwmon/dme1737.c
> > >  
> > >  DMI/SMBIOS SUPPORT
> > > @@ -6006,7 +6006,7 @@ F71805F HARDWARE MONITORING DRIVER
> > >  M:	Jean Delvare <jdelvare@suse.com>
> > >  L:	linux-hwmon@vger.kernel.org
> > >  S:	Maintained
> > > -F:	Documentation/hwmon/f71805f
> > > +F:	Documentation/hwmon/f71805f.rst
> > >  F:	drivers/hwmon/f71805f.c
> > >  
> > >  FADDR2LINE
> > > @@ -7687,7 +7687,7 @@ INA209 HARDWARE MONITOR DRIVER
> > >  M:	Guenter Roeck <linux@roeck-us.net>
> > >  L:	linux-hwmon@vger.kernel.org
> > >  S:	Maintained
> > > -F:	Documentation/hwmon/ina209
> > > +F:	Documentation/hwmon/ina209.rst
> > >  F:	Documentation/devicetree/bindings/hwmon/ina2xx.txt
> > >  F:	drivers/hwmon/ina209.c
> > >  
> > > @@ -7695,7 +7695,7 @@ INA2XX HARDWARE MONITOR DRIVER
> > >  M:	Guenter Roeck <linux@roeck-us.net>
> > >  L:	linux-hwmon@vger.kernel.org
> > >  S:	Maintained
> > > -F:	Documentation/hwmon/ina2xx
> > > +F:	Documentation/hwmon/ina2xx.rst
> > >  F:	drivers/hwmon/ina2xx.c
> > >  F:	include/linux/platform_data/ina2xx.h
> > >  
> > > @@ -8328,7 +8328,7 @@ IT87 HARDWARE MONITORING DRIVER
> > >  M:	Jean Delvare <jdelvare@suse.com>
> > >  L:	linux-hwmon@vger.kernel.org
> > >  S:	Maintained
> > > -F:	Documentation/hwmon/it87
> > > +F:	Documentation/hwmon/it87.rst
> > >  F:	drivers/hwmon/it87.c
> > >  
> > >  IT913X MEDIA DRIVER
> > > @@ -8372,7 +8372,7 @@ M:	Guenter Roeck <linux@roeck-us.net>
> > >  L:	linux-hwmon@vger.kernel.org
> > >  S:	Maintained
> > >  F:	drivers/hwmon/jc42.c
> > > -F:	Documentation/hwmon/jc42
> > > +F:	Documentation/hwmon/jc42.rst
> > >  
> > >  JFS FILESYSTEM
> > >  M:	Dave Kleikamp <shaggy@kernel.org>
> > > @@ -8420,14 +8420,14 @@ K10TEMP HARDWARE MONITORING DRIVER
> > >  M:	Clemens Ladisch <clemens@ladisch.de>
> > >  L:	linux-hwmon@vger.kernel.org
> > >  S:	Maintained
> > > -F:	Documentation/hwmon/k10temp
> > > +F:	Documentation/hwmon/k10temp.rst
> > >  F:	drivers/hwmon/k10temp.c
> > >  
> > >  K8TEMP HARDWARE MONITORING DRIVER
> > >  M:	Rudolf Marek <r.marek@assembler.cz>
> > >  L:	linux-hwmon@vger.kernel.org
> > >  S:	Maintained
> > > -F:	Documentation/hwmon/k8temp
> > > +F:	Documentation/hwmon/k8temp.rst
> > >  F:	drivers/hwmon/k8temp.c
> > >  
> > >  KASAN
> > > @@ -9118,21 +9118,21 @@ LM78 HARDWARE MONITOR DRIVER
> > >  M:	Jean Delvare <jdelvare@suse.com>
> > >  L:	linux-hwmon@vger.kernel.org
> > >  S:	Maintained
> > > -F:	Documentation/hwmon/lm78
> > > +F:	Documentation/hwmon/lm78.rst
> > >  F:	drivers/hwmon/lm78.c
> > >  
> > >  LM83 HARDWARE MONITOR DRIVER
> > >  M:	Jean Delvare <jdelvare@suse.com>
> > >  L:	linux-hwmon@vger.kernel.org
> > >  S:	Maintained
> > > -F:	Documentation/hwmon/lm83
> > > +F:	Documentation/hwmon/lm83.rst
> > >  F:	drivers/hwmon/lm83.c
> > >  
> > >  LM90 HARDWARE MONITOR DRIVER
> > >  M:	Jean Delvare <jdelvare@suse.com>
> > >  L:	linux-hwmon@vger.kernel.org
> > >  S:	Maintained
> > > -F:	Documentation/hwmon/lm90
> > > +F:	Documentation/hwmon/lm90.rst
> > >  F:	Documentation/devicetree/bindings/hwmon/lm90.txt
> > >  F:	drivers/hwmon/lm90.c
> > >  F:	include/dt-bindings/thermal/lm90.h
> > > @@ -9141,7 +9141,7 @@ LM95234 HARDWARE MONITOR DRIVER
> > >  M:	Guenter Roeck <linux@roeck-us.net>
> > >  L:	linux-hwmon@vger.kernel.org
> > >  S:	Maintained
> > > -F:	Documentation/hwmon/lm95234
> > > +F:	Documentation/hwmon/lm95234.rst
> > >  F:	drivers/hwmon/lm95234.c
> > >  
> > >  LME2510 MEDIA DRIVER
> > > @@ -9214,7 +9214,7 @@ LTC4261 HARDWARE MONITOR DRIVER
> > >  M:	Guenter Roeck <linux@roeck-us.net>
> > >  L:	linux-hwmon@vger.kernel.org
> > >  S:	Maintained
> > > -F:	Documentation/hwmon/ltc4261
> > > +F:	Documentation/hwmon/ltc4261.rst
> > >  F:	drivers/hwmon/ltc4261.c
> > >  
> > >  LTC4306 I2C MULTIPLEXER DRIVER
> > > @@ -9445,7 +9445,7 @@ MAX16065 HARDWARE MONITOR DRIVER
> > >  M:	Guenter Roeck <linux@roeck-us.net>
> > >  L:	linux-hwmon@vger.kernel.org
> > >  S:	Maintained
> > > -F:	Documentation/hwmon/max16065
> > > +F:	Documentation/hwmon/max16065.rst
> > >  F:	drivers/hwmon/max16065.c
> > >  
> > >  MAX2175 SDR TUNER DRIVER
> > > @@ -9461,14 +9461,14 @@ F:	include/uapi/linux/max2175.h
> > >  MAX6650 HARDWARE MONITOR AND FAN CONTROLLER DRIVER
> > >  L:	linux-hwmon@vger.kernel.org
> > >  S:	Orphan
> > > -F:	Documentation/hwmon/max6650
> > > +F:	Documentation/hwmon/max6650.rst
> > >  F:	drivers/hwmon/max6650.c
> > >  
> > >  MAX6697 HARDWARE MONITOR DRIVER
> > >  M:	Guenter Roeck <linux@roeck-us.net>
> > >  L:	linux-hwmon@vger.kernel.org
> > >  S:	Maintained
> > > -F:	Documentation/hwmon/max6697
> > > +F:	Documentation/hwmon/max6697.rst
> > >  F:	Documentation/devicetree/bindings/hwmon/max6697.txt
> > >  F:	drivers/hwmon/max6697.c
> > >  F:	include/linux/platform_data/max6697.h
> > > @@ -10118,7 +10118,7 @@ F:	drivers/mfd/menf21bmc.c
> > >  F:	drivers/watchdog/menf21bmc_wdt.c
> > >  F:	drivers/leds/leds-menf21bmc.c
> > >  F:	drivers/hwmon/menf21bmc_hwmon.c
> > > -F:	Documentation/hwmon/menf21bmc
> > > +F:	Documentation/hwmon/menf21bmc.rst
> > >  
> > >  MEN Z069 WATCHDOG DRIVER
> > >  M:	Johannes Thumshirn <jth@kernel.org>
> > > @@ -10747,7 +10747,7 @@ NCT6775 HARDWARE MONITOR DRIVER
> > >  M:	Guenter Roeck <linux@roeck-us.net>
> > >  L:	linux-hwmon@vger.kernel.org
> > >  S:	Maintained
> > > -F:	Documentation/hwmon/nct6775
> > > +F:	Documentation/hwmon/nct6775.rst
> > >  F:	drivers/hwmon/nct6775.c
> > >  
> > >  NET_FAILOVER MODULE
> > > @@ -11841,7 +11841,7 @@ PC87360 HARDWARE MONITORING DRIVER
> > >  M:	Jim Cromie <jim.cromie@gmail.com>
> > >  L:	linux-hwmon@vger.kernel.org
> > >  S:	Maintained
> > > -F:	Documentation/hwmon/pc87360
> > > +F:	Documentation/hwmon/pc87360.rst
> > >  F:	drivers/hwmon/pc87360.c
> > >  
> > >  PC8736x GPIO DRIVER
> > > @@ -11853,7 +11853,7 @@ PC87427 HARDWARE MONITORING DRIVER
> > >  M:	Jean Delvare <jdelvare@suse.com>
> > >  L:	linux-hwmon@vger.kernel.org
> > >  S:	Maintained
> > > -F:	Documentation/hwmon/pc87427
> > > +F:	Documentation/hwmon/pc87427.rst
> > >  F:	drivers/hwmon/pc87427.c
> > >  
> > >  PCA9532 LED DRIVER
> > > @@ -12421,23 +12421,23 @@ S:	Maintained
> > >  F:	Documentation/devicetree/bindings/hwmon/ibm,cffps1.txt
> > >  F:	Documentation/devicetree/bindings/hwmon/max31785.txt
> > >  F:	Documentation/devicetree/bindings/hwmon/ltc2978.txt
> > > -F:	Documentation/hwmon/adm1275
> > > -F:	Documentation/hwmon/ibm-cffps
> > > -F:	Documentation/hwmon/ir35221
> > > -F:	Documentation/hwmon/lm25066
> > > -F:	Documentation/hwmon/ltc2978
> > > -F:	Documentation/hwmon/ltc3815
> > > -F:	Documentation/hwmon/max16064
> > > -F:	Documentation/hwmon/max20751
> > > -F:	Documentation/hwmon/max31785
> > > -F:	Documentation/hwmon/max34440
> > > -F:	Documentation/hwmon/max8688
> > > -F:	Documentation/hwmon/pmbus
> > > -F:	Documentation/hwmon/pmbus-core
> > > -F:	Documentation/hwmon/tps40422
> > > -F:	Documentation/hwmon/ucd9000
> > > -F:	Documentation/hwmon/ucd9200
> > > -F:	Documentation/hwmon/zl6100
> > > +F:	Documentation/hwmon/adm1275.rst
> > > +F:	Documentation/hwmon/ibm-cffps.rst
> > > +F:	Documentation/hwmon/ir35221.rst
> > > +F:	Documentation/hwmon/lm25066.rst
> > > +F:	Documentation/hwmon/ltc2978.rst
> > > +F:	Documentation/hwmon/ltc3815.rst
> > > +F:	Documentation/hwmon/max16064.rst
> > > +F:	Documentation/hwmon/max20751.rst
> > > +F:	Documentation/hwmon/max31785.rst
> > > +F:	Documentation/hwmon/max34440.rst
> > > +F:	Documentation/hwmon/max8688.rst
> > > +F:	Documentation/hwmon/pmbus.rst
> > > +F:	Documentation/hwmon/pmbus-core.rst
> > > +F:	Documentation/hwmon/tps40422.rst
> > > +F:	Documentation/hwmon/ucd9000.rst
> > > +F:	Documentation/hwmon/ucd9200.rst
> > > +F:	Documentation/hwmon/zl6100.rst
> > >  F:	drivers/hwmon/pmbus/
> > >  F:	include/linux/pmbus.h
> > >  
> > > @@ -12701,7 +12701,7 @@ M:	Bartlomiej Zolnierkiewicz <b.zolnierkie@samsung.com>
> > >  L:	linux-hwmon@vger.kernel.org
> > >  S:	Supported
> > >  F:	Documentation/devicetree/bindings/hwmon/pwm-fan.txt
> > > -F:	Documentation/hwmon/pwm-fan
> > > +F:	Documentation/hwmon/pwm-fan.rst
> > >  F:	drivers/hwmon/pwm-fan.c
> > >  
> > >  PWM IR Transmitter
> > > @@ -14366,21 +14366,21 @@ SMM665 HARDWARE MONITOR DRIVER
> > >  M:	Guenter Roeck <linux@roeck-us.net>
> > >  L:	linux-hwmon@vger.kernel.org
> > >  S:	Maintained
> > > -F:	Documentation/hwmon/smm665
> > > +F:	Documentation/hwmon/smm665.rst
> > >  F:	drivers/hwmon/smm665.c
> > >  
> > >  SMSC EMC2103 HARDWARE MONITOR DRIVER
> > >  M:	Steve Glendinning <steve.glendinning@shawell.net>
> > >  L:	linux-hwmon@vger.kernel.org
> > >  S:	Maintained
> > > -F:	Documentation/hwmon/emc2103
> > > +F:	Documentation/hwmon/emc2103.rst
> > >  F:	drivers/hwmon/emc2103.c
> > >  
> > >  SMSC SCH5627 HARDWARE MONITOR DRIVER
> > >  M:	Hans de Goede <hdegoede@redhat.com>
> > >  L:	linux-hwmon@vger.kernel.org
> > >  S:	Supported
> > > -F:	Documentation/hwmon/sch5627
> > > +F:	Documentation/hwmon/sch5627.rst
> > >  F:	drivers/hwmon/sch5627.c
> > >  
> > >  SMSC UFX6000 and UFX7000 USB to VGA DRIVER
> > > @@ -14393,7 +14393,7 @@ SMSC47B397 HARDWARE MONITOR DRIVER
> > >  M:	Jean Delvare <jdelvare@suse.com>
> > >  L:	linux-hwmon@vger.kernel.org
> > >  S:	Maintained
> > > -F:	Documentation/hwmon/smsc47b397
> > > +F:	Documentation/hwmon/smsc47b397.rst
> > >  F:	drivers/hwmon/smsc47b397.c
> > >  
> > >  SMSC911x ETHERNET DRIVER
> > > @@ -15744,7 +15744,7 @@ TMP401 HARDWARE MONITOR DRIVER
> > >  M:	Guenter Roeck <linux@roeck-us.net>
> > >  L:	linux-hwmon@vger.kernel.org
> > >  S:	Maintained
> > > -F:	Documentation/hwmon/tmp401
> > > +F:	Documentation/hwmon/tmp401.rst
> > >  F:	drivers/hwmon/tmp401.c
> > >  
> > >  TMPFS (SHMEM FILESYSTEM)
> > > @@ -16796,7 +16796,7 @@ VT1211 HARDWARE MONITOR DRIVER
> > >  M:	Juerg Haefliger <juergh@gmail.com>
> > >  L:	linux-hwmon@vger.kernel.org
> > >  S:	Maintained
> > > -F:	Documentation/hwmon/vt1211
> > > +F:	Documentation/hwmon/vt1211.rst
> > >  F:	drivers/hwmon/vt1211.c
> > >  
> > >  VT8231 HARDWARE MONITOR DRIVER
> > > @@ -16824,14 +16824,14 @@ W83791D HARDWARE MONITORING DRIVER
> > >  M:	Marc Hulsman <m.hulsman@tudelft.nl>
> > >  L:	linux-hwmon@vger.kernel.org
> > >  S:	Maintained
> > > -F:	Documentation/hwmon/w83791d
> > > +F:	Documentation/hwmon/w83791d.rst
> > >  F:	drivers/hwmon/w83791d.c
> > >  
> > >  W83793 HARDWARE MONITORING DRIVER
> > >  M:	Rudolf Marek <r.marek@assembler.cz>
> > >  L:	linux-hwmon@vger.kernel.org
> > >  S:	Maintained
> > > -F:	Documentation/hwmon/w83793
> > > +F:	Documentation/hwmon/w83793.rst
> > >  F:	drivers/hwmon/w83793.c
> > >  
> > >  W83795 HARDWARE MONITORING DRIVER
> > > @@ -16940,7 +16940,7 @@ L:	patches@opensource.cirrus.com
> > >  T:	git https://github.com/CirrusLogic/linux-drivers.git
> > >  W:	https://github.com/CirrusLogic/linux-drivers/wiki
> > >  S:	Supported
> > > -F:	Documentation/hwmon/wm83??
> > > +F:	Documentation/hwmon/wm83??.rst
> > >  F:	Documentation/devicetree/bindings/extcon/extcon-arizona.txt
> > >  F:	Documentation/devicetree/bindings/regulator/arizona-regulator.txt
> > >  F:	Documentation/devicetree/bindings/mfd/arizona.txt
> > > diff --git a/drivers/hwmon/Kconfig b/drivers/hwmon/Kconfig
> > > index dedd5febd3aa..470ba66b18b0 100644
> > > --- a/drivers/hwmon/Kconfig
> > > +++ b/drivers/hwmon/Kconfig
> > > @@ -17,7 +17,7 @@ menuconfig HWMON
> > >  
> > >  	  To find out which specific driver(s) you need, use the
> > >  	  sensors-detect script from the lm_sensors package.  Read
> > > -	  <file:Documentation/hwmon/userspace-tools> for details.
> > > +	  <file:Documentation/hwmon/userspace-tools.rst> for details.
> > >  
> > >  	  This support can also be built as a module. If so, the module
> > >  	  will be called hwmon.
> > > @@ -59,7 +59,7 @@ config SENSORS_ABITUGURU
> > >  	  chip can be found on Abit uGuru featuring motherboards (most modern
> > >  	  Abit motherboards from before end 2005). For more info and a list
> > >  	  of which motherboards have which revision see
> > > -	  Documentation/hwmon/abituguru
> > > +	  Documentation/hwmon/abituguru.rsthttps://lore.kernel.org/lkml/cccc2a52363a5aaeea10e186ead8570503ea648e.1555494108.git.mchehab+samsung@kernel.org/
> > >  
> > >  	  This driver can also be built as a module. If so, the module
> > >  	  will be called abituguru.
> > > @@ -73,7 +73,7 @@ config SENSORS_ABITUGURU3
> > >  	  and their settings is supported. The third revision of the Abit
> > >  	  uGuru chip can be found on recent Abit motherboards (since end
> > >  	  2005). For more info and a list of which motherboards have which
> > > -	  revision see Documentation/hwmon/abituguru3
> > > +	  revision see Documentation/hwmon/abituguru3.rst
> > >  
> > >  	  This driver can also be built as a module. If so, the module
> > >  	  will be called abituguru3.
> > > @@ -643,7 +643,7 @@ config SENSORS_CORETEMP
> > >  	help
> > >  	  If you say yes here you get support for the temperature
> > >  	  sensor inside your CPU. Most of the family 6 CPUs
> > > -	  are supported. Check Documentation/hwmon/coretemp for details.
> > > +	  are supported. Check Documentation/hwmon/coretemp.rst for details.
> > >  
> > >  config SENSORS_IT87
> > >  	tristate "ITE IT87xx and compatibles"
> > > diff --git a/drivers/hwmon/ads7828.c b/drivers/hwmon/ads7828.c
> > > index e6be617e3fb2..03d6e782777a 100644
> > > --- a/drivers/hwmon/ads7828.c
> > > +++ b/drivers/hwmon/ads7828.c
> > > @@ -8,7 +8,7 @@
> > >   *
> > >   * ADS7830 support, by Guillaume Roguez <guillaume.roguez@savoirfairelinux.com>
> > >   *
> > > - * For further information, see the Documentation/hwmon/ads7828 file.
> > > + * For further information, see the Documentation/hwmon/ads7828.rst file.
> > >   *
> > >   * This program is free software; you can redistribute it and/or modify
> > >   * it under the terms of the GNU General Public License as published by
> > > diff --git a/drivers/hwmon/max197.c b/drivers/hwmon/max197.c
> > > index 3d9e210beedf..dd6a35219a18 100644
> > > --- a/drivers/hwmon/max197.c
> > > +++ b/drivers/hwmon/max197.c
> > > @@ -8,7 +8,7 @@
> > >   * it under the terms of the GNU General Public License version 2 as
> > >   * published by the Free Software Foundation.
> > >   *
> > > - * For further information, see the Documentation/hwmon/max197 file.
> > > + * For further information, see the Documentation/hwmon/max197.rst file.
> > >   */
> > >  
> > >  #include <linux/kernel.h>
> > > diff --git a/drivers/hwmon/sht15.c b/drivers/hwmon/sht15.c
> > > index 39b41e35c2bf..7f4a63959730 100644
> > > --- a/drivers/hwmon/sht15.c
> > > +++ b/drivers/hwmon/sht15.c
> > > @@ -10,7 +10,7 @@
> > >   *
> > >   * Copyright (c) 2007 Wouter Horre
> > >   *
> > > - * For further information, see the Documentation/hwmon/sht15 file.
> > > + * For further information, see the Documentation/hwmon/sht15.rst file.
> > >   */
> > >  
> > >  #include <linux/interrupt.h>
> > > diff --git a/include/linux/platform_data/ads7828.h b/include/linux/platform_data/ads7828.h
> > > index 3245f45f9d77..a3370a007702 100644
> > > --- a/include/linux/platform_data/ads7828.h
> > > +++ b/include/linux/platform_data/ads7828.h
> > > @@ -4,7 +4,7 @@
> > >   * Copyright (c) 2012 Savoir-faire Linux Inc.
> > >   *          Vivien Didelot <vivien.didelot@savoirfairelinux.com>
> > >   *
> > > - * For further information, see the Documentation/hwmon/ads7828 file.
> > > + * For further information, see the Documentation/hwmon/ads7828.rst file.
> > >   *
> > >   * This program is free software; you can redistribute it and/or modify
> > >   * it under the terms of the GNU General Public License version 2 as
> > > diff --git a/include/linux/platform_data/ds620.h b/include/linux/platform_data/ds620.h
> > > index 6ef58bb77e46..f0ce22a78bb8 100644
> > > --- a/include/linux/platform_data/ds620.h
> > > +++ b/include/linux/platform_data/ds620.h
> > > @@ -14,7 +14,7 @@ struct ds620_platform_data {
> > >  	 *  1 = PO_LOW
> > >  	 *  2 = PO_HIGH
> > >  	 *
> > > -	 * (see Documentation/hwmon/ds620)
> > > +	 * (see Documentation/hwmon/ds620.rst)
> > >  	 */
> > >  	int pomode;
> > >  };
> > > diff --git a/include/linux/platform_data/ina2xx.h b/include/linux/platform_data/ina2xx.h
> > > index 9f0aa1b48c78..dde59fd3590f 100644
> > > --- a/include/linux/platform_data/ina2xx.h
> > > +++ b/include/linux/platform_data/ina2xx.h
> > > @@ -7,7 +7,7 @@
> > >   * it under the terms of the GNU General Public License version 2 as
> > >   * published by the Free Software Foundation.
> > >   *
> > > - * For further information, see the Documentation/hwmon/ina2xx file.
> > > + * For further information, see the Documentation/hwmon/ina2xx.rst file.
> > >   */
> > >  
> > >  /**
> > > diff --git a/include/linux/platform_data/max197.h b/include/linux/platform_data/max197.h
> > > index 8da8f94ee15c..2bbd0919bc89 100644
> > > --- a/include/linux/platform_data/max197.h
> > > +++ b/include/linux/platform_data/max197.h
> > > @@ -8,7 +8,7 @@
> > >   * it under the terms of the GNU General Public License version 2 as
> > >   * published by the Free Software Foundation.
> > >   *
> > > - * For further information, see the Documentation/hwmon/max197 file.
> > > + * For further information, see the Documentation/hwmon/max197.rst file.
> > >   */
> > >  
> > >  #ifndef _PDATA_MAX197_H
> > > diff --git a/include/linux/platform_data/ntc_thermistor.h b/include/linux/platform_data/ntc_thermistor.h
> > > index ee03d429742b..5fa115d3ea4b 100644
> > > --- a/include/linux/platform_data/ntc_thermistor.h
> > > +++ b/include/linux/platform_data/ntc_thermistor.h
> > > @@ -42,7 +42,7 @@ struct ntc_thermistor_platform_data {
> > >  	 * read_uV()
> > >  	 *
> > >  	 * How to setup pullup_ohm, pulldown_ohm, and connect is
> > > -	 * described at Documentation/hwmon/ntc_thermistor
> > > +	 * described at Documentation/hwmon/ntc_thermistor.rst
> > >  	 *
> > >  	 * pullup/down_ohm: 0 for infinite / not-connected
> > >  	 *    
> 
> 
> 
> Thanks,
> Mauro



Thanks,
Mauro

^ permalink raw reply	[flat|nested] 73+ messages in thread

* Re: [PATCH v3 21/21] docs: hwmon: Add an index file and rename docs to *.rst
  2019-04-17 17:22                           ` Mauro Carvalho Chehab
@ 2019-04-17 17:43                             ` Guenter Roeck
  2019-04-17 17:47                               ` Guenter Roeck
  0 siblings, 1 reply; 73+ messages in thread
From: Guenter Roeck @ 2019-04-17 17:43 UTC (permalink / raw)
  To: Mauro Carvalho Chehab
  Cc: Linux Doc Mailing List, linux-kernel, Jonathan Corbet,
	Jean Delvare, Rob Herring, Mark Rutland, Dirk Eibach,
	George Joseph, Joel Stanley, Andrew Jeffery, Fenghua Yu,
	Support Opensource, Juerg Haefliger, Steve Glendinning,
	Huang Rui, Benjamin Herrenschmidt, Paul Mackerras,
	Michael Ellerman, Clemens Ladisch, Rudolf Marek, Andreas Werner,
	Jim Cromie, Kamil Debski, Bartlomiej Zolnierkiewicz,
	Hans de Goede, Liviu Dudau, Sudeep Holla, Lorenzo Pieralisi,
	Marc Hulsman, linux-hwmon, devicetree, linux-arm-kernel,
	linux-aspeed, linuxppc-dev, patches

On Wed, Apr 17, 2019 at 02:22:15PM -0300, Mauro Carvalho Chehab wrote:
> Em Wed, 17 Apr 2019 14:13:52 -0300
> Mauro Carvalho Chehab <mchehab+samsung@kernel.org> escreveu:
> 
> > Em Wed, 17 Apr 2019 09:47:41 -0700
> > Guenter Roeck <linux@roeck-us.net> escreveu:
> > 
> > > On Wed, Apr 17, 2019 at 06:46:29AM -0300, Mauro Carvalho Chehab wrote:  
> > > > Now that all files were converted to ReST format, rename them
> > > > and add an index.
> > > > 
> > > > Signed-off-by: Mauro Carvalho Chehab <mchehab+samsung@kernel.org>
> > > > Acked-by: Liviu Dudau <liviu.dudau@arm.com>    
> > > 
> > > I applied all patches except this one, which fails due to a conflict in
> > > ab8500. I also notice that this file has not been touched by your series,
> > > which is odd. At the same time, patch 20/21 is missing from your series,
> > > and has been missing all along. Does the missing patch possibly touch
> > > Documentation/hwmon/ab8500 ?  
> > 
> > Patch 20/21 is the biggest one. Maybe vger rejected it either due to
> > its size or due to the number of c/c.
> > 
> > Just bounced it to you. Please let me know if you didn't receive it
> > yet.
> 
> Btw, LKML got it:
> 
> https://lore.kernel.org/lkml/cccc2a52363a5aaeea10e186ead8570503ea648e.1555494108.git.mchehab+samsung@kernel.org/
> 
patchwork didn't get it (or didn't accept it). I got it now.
All patches applied, and pushed out to hwmon-next.

We have one (new) unconverted file left - Documentation/hwmon/lochnagar.
Can you by any chance have a look into that as well ?

Thanks!
Guenter

^ permalink raw reply	[flat|nested] 73+ messages in thread

* Re: [PATCH v3 21/21] docs: hwmon: Add an index file and rename docs to *.rst
  2019-04-17 17:43                             ` Guenter Roeck
@ 2019-04-17 17:47                               ` Guenter Roeck
  2019-04-18  9:44                                 ` Mauro Carvalho Chehab
  0 siblings, 1 reply; 73+ messages in thread
From: Guenter Roeck @ 2019-04-17 17:47 UTC (permalink / raw)
  To: Mauro Carvalho Chehab
  Cc: Linux Doc Mailing List, linux-kernel, Jonathan Corbet,
	Jean Delvare, Rob Herring, Mark Rutland, Dirk Eibach,
	George Joseph, Joel Stanley, Andrew Jeffery, Fenghua Yu,
	Support Opensource, Juerg Haefliger, Steve Glendinning,
	Huang Rui, Benjamin Herrenschmidt, Paul Mackerras,
	Michael Ellerman, Clemens Ladisch, Rudolf Marek, Andreas Werner,
	Jim Cromie, Kamil Debski, Bartlomiej Zolnierkiewicz,
	Hans de Goede, Liviu Dudau, Sudeep Holla, Lorenzo Pieralisi,
	Marc Hulsman, linux-hwmon, devicetree, linux-arm-kernel,
	linux-aspeed, linuxppc-dev, patches

On Wed, Apr 17, 2019 at 10:43:37AM -0700, Guenter Roeck wrote:
> On Wed, Apr 17, 2019 at 02:22:15PM -0300, Mauro Carvalho Chehab wrote:
> > Em Wed, 17 Apr 2019 14:13:52 -0300
> > Mauro Carvalho Chehab <mchehab+samsung@kernel.org> escreveu:
> > 
> > > Em Wed, 17 Apr 2019 09:47:41 -0700
> > > Guenter Roeck <linux@roeck-us.net> escreveu:
> > > 
> > > > On Wed, Apr 17, 2019 at 06:46:29AM -0300, Mauro Carvalho Chehab wrote:  
> > > > > Now that all files were converted to ReST format, rename them
> > > > > and add an index.
> > > > > 
> > > > > Signed-off-by: Mauro Carvalho Chehab <mchehab+samsung@kernel.org>
> > > > > Acked-by: Liviu Dudau <liviu.dudau@arm.com>    
> > > > 
> > > > I applied all patches except this one, which fails due to a conflict in
> > > > ab8500. I also notice that this file has not been touched by your series,
> > > > which is odd. At the same time, patch 20/21 is missing from your series,
> > > > and has been missing all along. Does the missing patch possibly touch
> > > > Documentation/hwmon/ab8500 ?  
> > > 
> > > Patch 20/21 is the biggest one. Maybe vger rejected it either due to
> > > its size or due to the number of c/c.
> > > 
> > > Just bounced it to you. Please let me know if you didn't receive it
> > > yet.
> > 
> > Btw, LKML got it:
> > 
> > https://lore.kernel.org/lkml/cccc2a52363a5aaeea10e186ead8570503ea648e.1555494108.git.mchehab+samsung@kernel.org/
> > 
> patchwork didn't get it (or didn't accept it). I got it now.
> All patches applied, and pushed out to hwmon-next.
> 
> We have one (new) unconverted file left - Documentation/hwmon/lochnagar.

Plus ir38064 and isl68137. Lots of new drivers recently.

Guenter

^ permalink raw reply	[flat|nested] 73+ messages in thread

* Re: [PATCH v3 21/21] docs: hwmon: Add an index file and rename docs to *.rst
  2019-04-17 17:47                               ` Guenter Roeck
@ 2019-04-18  9:44                                 ` Mauro Carvalho Chehab
  2019-04-18 13:36                                   ` Guenter Roeck
  0 siblings, 1 reply; 73+ messages in thread
From: Mauro Carvalho Chehab @ 2019-04-18  9:44 UTC (permalink / raw)
  To: Guenter Roeck
  Cc: Linux Doc Mailing List, linux-kernel, Jonathan Corbet,
	Jean Delvare, Rob Herring, Mark Rutland, Dirk Eibach,
	George Joseph, Joel Stanley, Andrew Jeffery, Fenghua Yu,
	Support Opensource, Juerg Haefliger, Steve Glendinning,
	Huang Rui, Benjamin Herrenschmidt, Paul Mackerras,
	Michael Ellerman, Clemens Ladisch, Rudolf Marek, Andreas Werner,
	Jim Cromie, Kamil Debski, Bartlomiej Zolnierkiewicz,
	Hans de Goede, Liviu Dudau, Sudeep Holla, Lorenzo Pieralisi,
	Marc Hulsman, linux-hwmon, devicetree, linux-arm-kernel,
	linux-aspeed, linuxppc-dev, patches

Em Wed, 17 Apr 2019 10:47:28 -0700
Guenter Roeck <linux@roeck-us.net> escreveu:

> On Wed, Apr 17, 2019 at 10:43:37AM -0700, Guenter Roeck wrote:
> > On Wed, Apr 17, 2019 at 02:22:15PM -0300, Mauro Carvalho Chehab wrote:  
> > > Em Wed, 17 Apr 2019 14:13:52 -0300
> > > Mauro Carvalho Chehab <mchehab+samsung@kernel.org> escreveu:
> > >   
> > > > Em Wed, 17 Apr 2019 09:47:41 -0700
> > > > Guenter Roeck <linux@roeck-us.net> escreveu:
> > > >   
> > > > > On Wed, Apr 17, 2019 at 06:46:29AM -0300, Mauro Carvalho Chehab wrote:    
> > > > > > Now that all files were converted to ReST format, rename them
> > > > > > and add an index.
> > > > > > 
> > > > > > Signed-off-by: Mauro Carvalho Chehab <mchehab+samsung@kernel.org>
> > > > > > Acked-by: Liviu Dudau <liviu.dudau@arm.com>      
> > > > > 
> > > > > I applied all patches except this one, which fails due to a conflict in
> > > > > ab8500. I also notice that this file has not been touched by your series,
> > > > > which is odd. At the same time, patch 20/21 is missing from your series,
> > > > > and has been missing all along. Does the missing patch possibly touch
> > > > > Documentation/hwmon/ab8500 ?    
> > > > 
> > > > Patch 20/21 is the biggest one. Maybe vger rejected it either due to
> > > > its size or due to the number of c/c.
> > > > 
> > > > Just bounced it to you. Please let me know if you didn't receive it
> > > > yet.  
> > > 
> > > Btw, LKML got it:
> > > 
> > > https://lore.kernel.org/lkml/cccc2a52363a5aaeea10e186ead8570503ea648e.1555494108.git.mchehab+samsung@kernel.org/
> > >   
> > patchwork didn't get it (or didn't accept it). I got it now.
> > All patches applied, and pushed out to hwmon-next.
> > 
> > We have one (new) unconverted file left - Documentation/hwmon/lochnagar.  
> 
> Plus ir38064 and isl68137. Lots of new drivers recently.

Ok, just sent a patch for those three new files. I wrote a more
detailed description about what steps I followed at the conversion
of those tree files, and why I did it. 

Hopefully, this would help hwmon developers
that may already be preparing a new driver for submission.

Thanks,
Mauro

^ permalink raw reply	[flat|nested] 73+ messages in thread

* Re: [PATCH v3 21/21] docs: hwmon: Add an index file and rename docs to *.rst
  2019-04-18  9:44                                 ` Mauro Carvalho Chehab
@ 2019-04-18 13:36                                   ` Guenter Roeck
  0 siblings, 0 replies; 73+ messages in thread
From: Guenter Roeck @ 2019-04-18 13:36 UTC (permalink / raw)
  To: Mauro Carvalho Chehab
  Cc: Linux Doc Mailing List, linux-kernel, Jonathan Corbet,
	Jean Delvare, Rob Herring, Mark Rutland, Dirk Eibach,
	George Joseph, Joel Stanley, Andrew Jeffery, Fenghua Yu,
	Support Opensource, Juerg Haefliger, Steve Glendinning,
	Huang Rui, Benjamin Herrenschmidt, Paul Mackerras,
	Michael Ellerman, Clemens Ladisch, Rudolf Marek, Andreas Werner,
	Jim Cromie, Kamil Debski, Bartlomiej Zolnierkiewicz,
	Hans de Goede, Liviu Dudau, Sudeep Holla, Lorenzo Pieralisi,
	Marc Hulsman, linux-hwmon, devicetree, linux-arm-kernel,
	linux-aspeed, linuxppc-dev, patches

On 4/18/19 2:44 AM, Mauro Carvalho Chehab wrote:
> Em Wed, 17 Apr 2019 10:47:28 -0700
> Guenter Roeck <linux@roeck-us.net> escreveu:
> 
>> On Wed, Apr 17, 2019 at 10:43:37AM -0700, Guenter Roeck wrote:
>>> On Wed, Apr 17, 2019 at 02:22:15PM -0300, Mauro Carvalho Chehab wrote:
>>>> Em Wed, 17 Apr 2019 14:13:52 -0300
>>>> Mauro Carvalho Chehab <mchehab+samsung@kernel.org> escreveu:
>>>>    
>>>>> Em Wed, 17 Apr 2019 09:47:41 -0700
>>>>> Guenter Roeck <linux@roeck-us.net> escreveu:
>>>>>    
>>>>>> On Wed, Apr 17, 2019 at 06:46:29AM -0300, Mauro Carvalho Chehab wrote:
>>>>>>> Now that all files were converted to ReST format, rename them
>>>>>>> and add an index.
>>>>>>>
>>>>>>> Signed-off-by: Mauro Carvalho Chehab <mchehab+samsung@kernel.org>
>>>>>>> Acked-by: Liviu Dudau <liviu.dudau@arm.com>
>>>>>>
>>>>>> I applied all patches except this one, which fails due to a conflict in
>>>>>> ab8500. I also notice that this file has not been touched by your series,
>>>>>> which is odd. At the same time, patch 20/21 is missing from your series,
>>>>>> and has been missing all along. Does the missing patch possibly touch
>>>>>> Documentation/hwmon/ab8500 ?
>>>>>
>>>>> Patch 20/21 is the biggest one. Maybe vger rejected it either due to
>>>>> its size or due to the number of c/c.
>>>>>
>>>>> Just bounced it to you. Please let me know if you didn't receive it
>>>>> yet.
>>>>
>>>> Btw, LKML got it:
>>>>
>>>> https://lore.kernel.org/lkml/cccc2a52363a5aaeea10e186ead8570503ea648e.1555494108.git.mchehab+samsung@kernel.org/
>>>>    
>>> patchwork didn't get it (or didn't accept it). I got it now.
>>> All patches applied, and pushed out to hwmon-next.
>>>
>>> We have one (new) unconverted file left - Documentation/hwmon/lochnagar.
>>
>> Plus ir38064 and isl68137. Lots of new drivers recently.
> 
> Ok, just sent a patch for those three new files. I wrote a more
> detailed description about what steps I followed at the conversion
> of those tree files, and why I did it.
> 
Did the patches get lost ?

> Hopefully, this would help hwmon developers
> that may already be preparing a new driver for submission.
> 

That would be very useful.

Thanks,
Guenter

^ permalink raw reply	[flat|nested] 73+ messages in thread

end of thread, other threads:[~2019-04-18 13:36 UTC | newest]

Thread overview: 73+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2019-04-10 19:22 [PATCH v2 00/21] Convert hwmon documentation to ReST Mauro Carvalho Chehab
2019-04-10 19:22 ` [PATCH v2 01/21] docs: hwmon: k10temp: convert to ReST format Mauro Carvalho Chehab
2019-04-10 19:22 ` [PATCH v2 02/21] docs: hwmon: vexpress: " Mauro Carvalho Chehab
2019-04-11 13:05   ` Liviu Dudau
2019-04-10 19:22 ` [PATCH v2 03/21] docs: hwmon: menf21bmc: " Mauro Carvalho Chehab
2019-04-10 19:22 ` [PATCH v2 04/21] docs: hwmon: sch5627: " Mauro Carvalho Chehab
2019-04-10 19:22 ` [PATCH v2 05/21] docs: hwmon: emc2103: " Mauro Carvalho Chehab
2019-04-10 19:22 ` [PATCH v2 06/21] docs: hwmon: pc87360: " Mauro Carvalho Chehab
2019-04-10 19:22 ` [PATCH v2 07/21] docs: hwmon: fam15h_power: " Mauro Carvalho Chehab
2019-04-10 19:22 ` [PATCH v2 08/21] docs: hwmon: w83791d: " Mauro Carvalho Chehab
2019-04-10 19:22 ` [PATCH v2 09/21] docs: hwmon: coretemp: " Mauro Carvalho Chehab
2019-04-10 19:22 ` [PATCH v2 10/21] docs: hwmon: aspeed-pwm-tacho: " Mauro Carvalho Chehab
2019-04-11  0:27   ` Andrew Jeffery
2019-04-10 19:22 ` [PATCH v2 11/21] docs: hwmon: ibmpowernv: " Mauro Carvalho Chehab
2019-04-10 19:22 ` [PATCH v2 12/21] docs: hwmon: asc7621: " Mauro Carvalho Chehab
2019-04-10 19:22 ` [PATCH v2 13/21] docs: hwmon: ads1015: " Mauro Carvalho Chehab
2019-04-10 19:22 ` [PATCH v2 14/21] docs: hwmon: dme1737, vt1211: " Mauro Carvalho Chehab
2019-04-10 19:22 ` [PATCH v2 15/21] docs: hwmon: wm831x, wm8350: " Mauro Carvalho Chehab
2019-04-10 19:22 ` [PATCH v2 16/21] docs: hwmon: da9052, da9055: " Mauro Carvalho Chehab
2019-04-10 19:22 ` [PATCH v2 17/21] docs: hwmon: k8temp, w83793: " Mauro Carvalho Chehab
2019-04-10 19:22 ` [PATCH v2 18/21] docs: hwmon: pmbus files: " Mauro Carvalho Chehab
2019-04-10 19:22 ` [PATCH v2 19/21] docs: hwmon: misc " Mauro Carvalho Chehab
2019-04-10 19:22 ` [PATCH v2 20/21] docs: hwmon: convert remaining files " Mauro Carvalho Chehab
2019-04-10 19:22 ` [PATCH v2 21/21] docs: hwmon: Add an index file and rename docs to *.rst Mauro Carvalho Chehab
2019-04-11 13:07   ` Liviu Dudau
2019-04-11 18:43 ` [PATCH v2 00/21] Convert hwmon documentation to ReST Jonathan Corbet
2019-04-11 20:43   ` Mauro Carvalho Chehab
2019-04-11 21:07     ` Guenter Roeck
2019-04-11 23:54       ` Mauro Carvalho Chehab
2019-04-12 16:04       ` Jonathan Corbet
2019-04-12 16:12         ` Guenter Roeck
2019-04-13  0:25           ` Mauro Carvalho Chehab
2019-04-13  0:52             ` Guenter Roeck
2019-04-13  3:09         ` Guenter Roeck
2019-04-16 20:19           ` Jonathan Corbet
2019-04-16 20:31             ` Guenter Roeck
2019-04-17  1:58               ` Mauro Carvalho Chehab
2019-04-17  3:49                 ` Guenter Roeck
2019-04-17  9:46                   ` [PATCH v3 00/21]Convert " Mauro Carvalho Chehab
2019-04-17  9:46                     ` [PATCH v3 01/21] docs: hwmon: k10temp: convert to ReST format Mauro Carvalho Chehab
2019-04-17  9:46                     ` [PATCH v3 02/21] docs: hwmon: vexpress: " Mauro Carvalho Chehab
2019-04-17 10:24                       ` Liviu Dudau
2019-04-17 10:31                         ` Mauro Carvalho Chehab
2019-04-17 11:29                       ` Liviu Dudau
2019-04-17  9:46                     ` [PATCH v3 03/21] docs: hwmon: menf21bmc: " Mauro Carvalho Chehab
2019-04-17  9:46                     ` [PATCH v3 04/21] docs: hwmon: sch5627: " Mauro Carvalho Chehab
2019-04-17  9:46                     ` [PATCH v3 05/21] docs: hwmon: emc2103: " Mauro Carvalho Chehab
2019-04-17  9:46                     ` [PATCH v3 06/21] docs: hwmon: pc87360: " Mauro Carvalho Chehab
2019-04-17  9:46                     ` [PATCH v3 07/21] docs: hwmon: fam15h_power: " Mauro Carvalho Chehab
2019-04-17  9:46                     ` [PATCH v3 08/21] docs: hwmon: w83791d: " Mauro Carvalho Chehab
2019-04-17  9:46                     ` [PATCH v3 09/21] docs: hwmon: coretemp: " Mauro Carvalho Chehab
2019-04-17  9:46                     ` [PATCH v3 10/21] docs: hwmon: aspeed-pwm-tacho: " Mauro Carvalho Chehab
2019-04-17  9:46                     ` [PATCH v3 11/21] docs: hwmon: ibmpowernv: " Mauro Carvalho Chehab
2019-04-17  9:46                     ` [PATCH v3 12/21] docs: hwmon: asc7621: " Mauro Carvalho Chehab
2019-04-17  9:46                     ` [PATCH v3 13/21] docs: hwmon: ads1015: " Mauro Carvalho Chehab
2019-04-17  9:46                     ` [PATCH v3 14/21] docs: hwmon: dme1737, vt1211: " Mauro Carvalho Chehab
2019-04-17  9:46                     ` [PATCH v3 15/21] docs: hwmon: wm831x, wm8350: " Mauro Carvalho Chehab
2019-04-17  9:46                     ` [PATCH v3 16/21] docs: hwmon: da9052, da9055: " Mauro Carvalho Chehab
2019-04-17  9:46                     ` [PATCH v3 17/21] docs: hwmon: k8temp, w83793: " Mauro Carvalho Chehab
2019-04-17  9:46                     ` [PATCH v3 18/21] docs: hwmon: pmbus files: " Mauro Carvalho Chehab
2019-04-17  9:46                     ` [PATCH v3 19/21] docs: hwmon: misc " Mauro Carvalho Chehab
2019-04-17  9:46                     ` [PATCH v3 20/21] docs: hwmon: convert remaining files " Mauro Carvalho Chehab
2019-04-17  9:46                     ` [PATCH v3 21/21] docs: hwmon: Add an index file and rename docs to *.rst Mauro Carvalho Chehab
2019-04-17 11:31                       ` Liviu Dudau
2019-04-17 16:47                       ` Guenter Roeck
2019-04-17 16:54                         ` Guenter Roeck
2019-04-17 17:13                         ` Mauro Carvalho Chehab
2019-04-17 17:22                           ` Mauro Carvalho Chehab
2019-04-17 17:43                             ` Guenter Roeck
2019-04-17 17:47                               ` Guenter Roeck
2019-04-18  9:44                                 ` Mauro Carvalho Chehab
2019-04-18 13:36                                   ` Guenter Roeck
2019-04-17  9:47                   ` [PATCH v2 00/21] Convert hwmon documentation to ReST Mauro Carvalho Chehab

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).