* [GIT PULL] platform-drivers-x86 for 4.15-1
@ 2017-11-18 18:09 Andy Shevchenko
2017-11-18 18:37 ` Linus Torvalds
0 siblings, 1 reply; 7+ messages in thread
From: Andy Shevchenko @ 2017-11-18 18:09 UTC (permalink / raw)
To: Linus Torvalds; +Cc: LKML
Hi Linus,
Here is the collected material against Platform Drivers x86 subsystem.
It's rather bit busy cycle for PDx86, mostly due to Dell SMBIOS driver
activity.
During merge it will get a conflict
CONFLICT (content): Merge conflict in Documentation/admin-guide/thunderbolt.rst
that is pretty straight forward to solve, i.e. we need all parts of
documentation be in, where "Networking over Thunderbolt cable" is
followed by "Forcing power" chapter.
Thanks,
With Best Regards,
Andy Shevchenko
The following changes since commit 0224d45c9d46401b6d7018a96cfe049c5da7d91c:
i2c-cht-wc: Add device-properties for fusb302 integration (2017-10-27 15:51:51 +0200)
are available in the Git repository at:
git://git.infradead.org/linux-platform-drivers-x86.git tags/platform-drivers-x86-v4.15-1
for you to fetch changes up to aaa40965d2342137d756121993c395e2a7463a8d:
platform/x86: silead_dmi: Add silead, home-button property to some tablets (2017-11-18 19:28:58 +0200)
----------------------------------------------------------------
platform-drivers-x86 for v4.15-1
For this cycle we have quite an update for the Dell SMBIOS driver
including WMI work to provide an interface for SMBIOS tokens via sysfs
and WMI support for 2017+ Dell laptop models. SMM dispatcher code is
split into a separate driver followed by a new WMI dispatcher.
The latter provides a character device interface to user space.
The pull request contains a merge of immutable branch from Wolfram Sang
in order to apply a dependent fix to the Intel CherryTrail Battery
Management driver.
Other Intel drivers got a lot of cleanups. The Turbo Boost Max 3.0
support is added for Intel Skylake.
Peaq WMI hotkeys driver gets its own maintainer and white list of
supported models.
Silead DMI is expanded to support few additional platforms.
Tablet mode via GMMS ACPI method is added to support some ThinkPad
tablets.
Two commits appear here which were previously merged during the
v4.14-rcX cycle:
- d7ca5ebf2493 platform/x86: intel_pmc_ipc: Use devm_* calls in driver probe function
- e3075fd6f80c platform/x86: intel_pmc_ipc: Use spin_lock to protect GCR updates
Add driver to force WMI Thunderbolt controller power status:
- Add driver to force WMI Thunderbolt controller power status
asus-wmi:
- Add lightbar led support
dell-laptop:
- Allocate buffer before rfkill use
dell-smbios:
- fix string overflow
- Add filtering support
- Introduce dispatcher for SMM calls
- Add a sysfs interface for SMBIOS tokens
- only run if proper oem string is detected
- Prefix class/select with cmd_
- Add pr_fmt definition to driver
dell-smbios-smm:
- test for WSMT
dell-smbios-wmi:
- release mutex lock on WMI call failure
- introduce userspace interface
- Add new WMI dispatcher driver
dell-smo8800:
- remove redundant assignments to byte_data
dell-wmi:
- don't check length returned
- clean up wmi descriptor check
- increase severity of some failures
- Do not match on descriptor GUID modalias
- Label driver as handling notifications
dell-*wmi*:
- Relay failed initial probe to dependent drivers
dell-wmi-descriptor:
- check if memory was allocated
- split WMI descriptor into it's own driver
fujitsu-laptop:
- Fix radio LED detection
- Don't oops when FUJ02E3 is not presnt
hp_accel:
- Add quirk for HP ProBook 440 G4
hp-wmi:
- Fix tablet mode detection for convertibles
ideapad-laptop:
- Add Lenovo Yoga 920-13IKB to no_hw_rfkill dmi list
intel_cht_int33fe:
- Update fusb302 type string, add properties
- make a couple of local functions static
- Work around BIOS bug on some devices
intel-hid:
- Power button suspend on Dell Latitude 7275
intel_ips:
- Convert timers to use timer_setup()
- Remove FSF address from GPL notice
- Remove unneeded fields and label
- Keep pointer to struct device
- Use PCI_VDEVICE() macro
- Switch to new PCI IRQ allocation API
- Simplify error handling via devres API
intel_pmc_ipc:
- Revert Use MFD framework to create dependent devices
- Use MFD framework to create dependent devices
- Use spin_lock to protect GCR updates
- Use devm_* calls in driver probe function
intel_punit_ipc:
- Fix resource ioremap warning
intel_telemetry:
- Remove useless default in Kconfig
- Add needed inclusion
- cleanup redundant headers
- Fix typos
- Fix load failure info
intel_telemetry_debugfs:
- Use standard ARRAY_SIZE() macro
intel_turbo_max_3:
- Add Skylake platform
intel-wmi-thunderbolt:
- Silence error cases
MAINTAINERS:
- Add entry for the PEAQ WMI hotkeys driver
mlx-platform:
- make a couple of structures static
peaq_wmi:
- Fix missing terminating entry for peaq_dmi_table
peaq-wmi:
- Remove unnecessary checks from peaq_wmi_exit
- Add DMI check before binding to the WMI interface
- Revert Blacklist Lenovo ideapad 700-15ISK
- Blacklist Lenovo ideapad 700-15ISK
silead_dmi:
- Add silead, home-button property to some tablets
- Add entry for the Digma e200 tablet
- Fix GP-electronic T701 entry
- Add entry for the Chuwi Hi8 Pro tablet
sony-laptop:
- Drop variable assignment in sony_nc_setup_rfkill()
- Fix error handling in sony_nc_setup_rfkill()
thinkpad_acpi:
- Implement tablet mode using GMMS method
tools/wmi:
- add a sample for dell smbios communication over WMI
wmi:
- release mutex on module acquistion failure
- create userspace interface for drivers
- Don't allow drivers to get each other's GUIDs
- Add new method wmidev_evaluate_method
- Destroy on cleanup rather than unregister
- Cleanup exit routine in reverse order of init
- Sort include list
----------------------------------------------------------------
Allen Pais (1):
platform/x86: intel_telemetry_debugfs: Use standard ARRAY_SIZE() macro
Andy Shevchenko (11):
platform/x86: peaq-wmi: Revert Blacklist Lenovo ideapad 700-15ISK
platform/x86: intel_ips: Simplify error handling via devres API
platform/x86: intel_ips: Switch to new PCI IRQ allocation API
platform/x86: intel_ips: Use PCI_VDEVICE() macro
platform/x86: intel_ips: Keep pointer to struct device
platform/x86: intel_ips: Remove unneeded fields and label
platform/x86: intel_ips: Remove FSF address from GPL notice
platform/x86: intel_telemetry: Add needed inclusion
platform/x86: intel_telemetry: Remove useless default in Kconfig
Merge branch 'i2c/cht-wc-fusb302-immutable' of git://git.kernel.org/.../wsa/linux
platform/x86: Revert intel_pmc_ipc: Use MFD framework to create dependent devices
Arnd Bergmann (1):
platform/x86: dell-smbios: fix string overflow
Benjamin Berg (1):
platform/x86: thinkpad_acpi: Implement tablet mode using GMMS method
Colin Ian King (3):
platform/x86: mlx-platform: make a couple of structures static
platform/x86: intel_cht_int33fe: make a couple of local functions static
platform/x86: dell-smo8800: remove redundant assignments to byte_data
Hans de Goede (9):
platform/x86: intel_cht_int33fe: Work around BIOS bug on some devices
platform/x86: peaq-wmi: Add DMI check before binding to the WMI interface
MAINTAINERS: Add entry for the PEAQ WMI hotkeys driver
platform/x86: silead_dmi: Add entry for the Chuwi Hi8 Pro tablet
platform/x86: peaq_wmi: Fix missing terminating entry for peaq_dmi_table
platform/x86: peaq-wmi: Remove unnecessary checks from peaq_wmi_exit
platform/x86: silead_dmi: Fix GP-electronic T701 entry
platform/x86: intel_cht_int33fe: Update fusb302 type string, add properties
platform/x86: silead_dmi: Add silead, home-button property to some tablets
Jérôme de Bretagne (1):
platform/x86: intel-hid: Power button suspend on Dell Latitude 7275
Kai Heng Feng (1):
platform/x86: peaq-wmi: Blacklist Lenovo ideapad 700-15ISK
Kees Cook (1):
platform/x86: intel_ips: Convert timers to use timer_setup()
Kuppuswamy Sathyanarayanan (4):
platform/x86: intel_pmc_ipc: Use devm_* calls in driver probe function
platform/x86: intel_pmc_ipc: Use spin_lock to protect GCR updates
platform/x86: intel_punit_ipc: Fix resource ioremap warning
platform/x86: intel_pmc_ipc: Use MFD framework to create dependent devices
Mario Limonciello (29):
platform/x86: Add driver to force WMI Thunderbolt controller power status
platform/x86: intel-wmi-thunderbolt: Silence error cases
platform/x86: dell-wmi: Label driver as handling notifications
platform/x86: dell-wmi: Do not match on descriptor GUID modalias
platform/x86: dell-smbios: Add pr_fmt definition to driver
platform/x86: wmi: Sort include list
platform/x86: wmi: Cleanup exit routine in reverse order of init
platform/x86: wmi: Destroy on cleanup rather than unregister
platform/x86: dell-smbios: Prefix class/select with cmd_
platform/x86: wmi: Add new method wmidev_evaluate_method
platform/x86: dell-wmi: increase severity of some failures
platform/x86: dell-wmi: clean up wmi descriptor check
platform/x86: dell-wmi: don't check length returned
platform/x86: dell-wmi-descriptor: split WMI descriptor into it's own driver
platform/x86: wmi: Don't allow drivers to get each other's GUIDs
platform/x86: dell-smbios: only run if proper oem string is detected
platform/x86: dell-smbios: Add a sysfs interface for SMBIOS tokens
platform/x86: dell-smbios: Introduce dispatcher for SMM calls
platform/x86: dell-smbios-wmi: Add new WMI dispatcher driver
platform/x86: dell-smbios-smm: test for WSMT
platform/x86: dell-smbios: Add filtering support
platform/x86: wmi: create userspace interface for drivers
platform/x86: dell-smbios-wmi: introduce userspace interface
tools/wmi: add a sample for dell smbios communication over WMI
platform/x86: wmi: release mutex on module acquistion failure
platform/x86: dell-smbios-wmi: release mutex lock on WMI call failure
platform/x86: dell-wmi-descriptor: check if memory was allocated
platform/x86: dell-*wmi*: Relay failed initial probe to dependent drivers
platform/x86: dell-laptop: Allocate buffer before rfkill use
Markus Elfring (2):
platform/x86: sony-laptop: Fix error handling in sony_nc_setup_rfkill()
platform/x86: sony-laptop: Drop variable assignment in sony_nc_setup_rfkill()
Maxime Bellengé (1):
platform/x86: asus-wmi: Add lightbar led support
Michał Kępień (1):
platform/x86: fujitsu-laptop: Fix radio LED detection
Osama Khan (1):
platform/x86: hp_accel: Add quirk for HP ProBook 440 G4
Philipp Hug (1):
platform/x86: ideapad-laptop: Add Lenovo Yoga 920-13IKB to no_hw_rfkill dmi list
Rajneesh Bhardwaj (3):
platform/x86: intel_telemetry: Fix load failure info
platform/x86: intel_telemetry: Fix typos
platform/x86: intel_telemetry: cleanup redundant headers
Sergey Tshovrebov (1):
platform/x86: silead_dmi: Add entry for the Digma e200 tablet
Srinivas Pandruvada (1):
platform/x86: intel_turbo_max_3: Add Skylake platform
Stefan Brüns (1):
platform/x86: hp-wmi: Fix tablet mode detection for convertibles
Ville Syrjälä (1):
platform/x86: fujitsu-laptop: Don't oops when FUJ02E3 is not presnt
Documentation/ABI/testing/dell-smbios-wmi | 41 ++
.../ABI/testing/sysfs-platform-dell-smbios | 21 +
.../testing/sysfs-platform-intel-wmi-thunderbolt | 11 +
Documentation/admin-guide/thunderbolt.rst | 15 +
MAINTAINERS | 39 +-
drivers/platform/x86/Kconfig | 56 ++-
drivers/platform/x86/Makefile | 4 +
drivers/platform/x86/asus-wmi.c | 63 +++
drivers/platform/x86/dell-laptop.c | 284 +++++-------
drivers/platform/x86/dell-smbios-smm.c | 196 ++++++++
drivers/platform/x86/dell-smbios-wmi.c | 272 +++++++++++
drivers/platform/x86/dell-smbios.c | 512 +++++++++++++++++++--
drivers/platform/x86/dell-smbios.h | 49 +-
drivers/platform/x86/dell-smo8800.c | 3 +-
drivers/platform/x86/dell-wmi-descriptor.c | 191 ++++++++
drivers/platform/x86/dell-wmi-descriptor.h | 27 ++
drivers/platform/x86/dell-wmi.c | 97 +---
drivers/platform/x86/fujitsu-laptop.c | 14 +-
drivers/platform/x86/hp-wmi.c | 2 +-
drivers/platform/x86/hp_accel.c | 1 +
drivers/platform/x86/ideapad-laptop.c | 7 +
drivers/platform/x86/intel-hid.c | 18 +
drivers/platform/x86/intel-wmi-thunderbolt.c | 98 ++++
drivers/platform/x86/intel_cht_int33fe.c | 114 ++++-
drivers/platform/x86/intel_ips.c | 160 +++----
drivers/platform/x86/intel_ips.h | 4 -
drivers/platform/x86/intel_pmc_ipc.c | 115 ++---
drivers/platform/x86/intel_punit_ipc.c | 8 +-
drivers/platform/x86/intel_telemetry_core.c | 3 +-
drivers/platform/x86/intel_telemetry_debugfs.c | 24 +-
drivers/platform/x86/intel_telemetry_pltdrv.c | 25 +-
drivers/platform/x86/intel_turbo_max_3.c | 1 +
drivers/platform/x86/mlx-platform.c | 4 +-
drivers/platform/x86/peaq-wmi.c | 19 +-
drivers/platform/x86/silead_dmi.c | 52 +++
drivers/platform/x86/sony-laptop.c | 16 +-
drivers/platform/x86/thinkpad_acpi.c | 132 +++++-
drivers/platform/x86/wmi.c | 254 ++++++++--
include/linux/wmi.h | 13 +-
include/uapi/linux/wmi.h | 73 +++
tools/Makefile | 14 +-
tools/wmi/Makefile | 18 +
tools/wmi/dell-smbios-example.c | 210 +++++++++
43 files changed, 2654 insertions(+), 626 deletions(-)
create mode 100644 Documentation/ABI/testing/dell-smbios-wmi
create mode 100644 Documentation/ABI/testing/sysfs-platform-dell-smbios
create mode 100644 Documentation/ABI/testing/sysfs-platform-intel-wmi-thunderbolt
create mode 100644 drivers/platform/x86/dell-smbios-smm.c
create mode 100644 drivers/platform/x86/dell-smbios-wmi.c
create mode 100644 drivers/platform/x86/dell-wmi-descriptor.c
create mode 100644 drivers/platform/x86/dell-wmi-descriptor.h
create mode 100644 drivers/platform/x86/intel-wmi-thunderbolt.c
create mode 100644 include/uapi/linux/wmi.h
create mode 100644 tools/wmi/Makefile
create mode 100644 tools/wmi/dell-smbios-example.c
--
With Best Regards,
Andy Shevchenko
^ permalink raw reply [flat|nested] 7+ messages in thread
* Re: [GIT PULL] platform-drivers-x86 for 4.15-1
2017-11-18 18:09 [GIT PULL] platform-drivers-x86 for 4.15-1 Andy Shevchenko
@ 2017-11-18 18:37 ` Linus Torvalds
2017-11-18 20:09 ` Linus Torvalds
2017-11-20 19:06 ` Darren Hart
0 siblings, 2 replies; 7+ messages in thread
From: Linus Torvalds @ 2017-11-18 18:37 UTC (permalink / raw)
To: Andy Shevchenko, Darren Hart; +Cc: LKML
On Sat, Nov 18, 2017 at 10:09 AM, Andy Shevchenko
<andriy.shevchenko@linux.intel.com> wrote:
>
> Here is the collected material against Platform Drivers x86 subsystem.
> It's rather bit busy cycle for PDx86, mostly due to Dell SMBIOS driver
> activity.
So I note that you seem to use the same summary script that Darren used.
Guys, the "merge summary" should be human-readable, not just a
slightly munged version of "git shortlog" that has been sorted by
first word.
Feel free to use that munged version as a base-line, but don't just
send me automated merge messages.
The whole point of a summary is to summarize. And merge messages
should be legible, not "this is all the details that you could have
just used 'git shortlog' to get".
When you can't even be bothered to fix up obvious issues like
(a) "yeah, I just sorted things alphabetically without any human interaction":
intel-wmi-thunderbolt:
- Silence error cases
MAINTAINERS:
- Add entry for the PEAQ WMI hotkeys driver
mlx-platform:
- make a couple of structures static
(b) "yeah, my summary script splits the overview at a colon, so when
there is no colon it doesn't work":
Add driver to force WMI Thunderbolt controller power status:
- Add driver to force WMI Thunderbolt controller power status
it's good that you have a fairly unified commit message model and can
do these summaries, but it's bad when you then don't do much of any
_human_ summary at all or even check the result for sanity.
Linus
^ permalink raw reply [flat|nested] 7+ messages in thread
* Re: [GIT PULL] platform-drivers-x86 for 4.15-1
2017-11-18 18:37 ` Linus Torvalds
@ 2017-11-18 20:09 ` Linus Torvalds
2017-11-20 17:17 ` Darren Hart
2017-11-20 19:06 ` Darren Hart
1 sibling, 1 reply; 7+ messages in thread
From: Linus Torvalds @ 2017-11-18 20:09 UTC (permalink / raw)
To: Andy Shevchenko, Darren Hart; +Cc: LKML
On Sat, Nov 18, 2017 at 10:37 AM, Linus Torvalds
<torvalds@linux-foundation.org> wrote:
>
> So I note that you seem to use the same summary script that Darren used.
.. oh, and I note a *much* worse issue.
You add new drivers and then default them to "on".
THAT IS COMPLETELY UNACCEPTABLE.
I don't know why I have to say this every single merge window, but
let's do it one more time:
As a developer, you think _your_ driver or feature is the most
important thing ever, and you have the hardware.
AND ALMOST NOBODY ELSE CARES.
Read it and weep. Unless your hardware is completely ubiquitous, it
damn well should not default to being defaulted everybody elses
config.
In particular, people who do "make oldconfig" clearly had a
configuration _without_ your hardware and were happy with it, and want
to keep it working. That's what "oldconfig" means.
You don't say "hey, let's enable this piece of hardware that you don't
have anyway, just to waste your time and disk and memory".
So the things that merit "default y/m" are
(a) you added a Kconfig option for something that used to always be
built. Then it merits that "default y" exactly because "make
oldconfig" should just work.
(b) corollary of the above: if you add a new gatekeeping Kconfig
option that hides/shows other Kconfig options (but doesn't generate
any code of its own), it should be enabled by default, simply so that
by default people will see those other options.
(c) your driver itself defaults to off, but you then have sub-driver
options for behavior or similar, where you can give sane defaults for
people who _do_ have your hardware, and want the driver for it, and
within those constraints the extended option makes sense
(d) your piece of hardware or infrastructure really is something that
everybody expects. If you have CONFIG_NET or CONFIG_BLOCK, you get to
enable it by default.
But something like CONFIG_DELL_SMBIOS sure as hell does not merit
being default on. Not even if you have enabled WMI.
EVERY SINGLE "default" line that got added by this branch was wrong.
Stop doing this. It's a serious violation of peoples expectations.
When I do "make oldconfig", I don't want some new random hardware
support.
Linus
^ permalink raw reply [flat|nested] 7+ messages in thread
* Re: [GIT PULL] platform-drivers-x86 for 4.15-1
2017-11-18 20:09 ` Linus Torvalds
@ 2017-11-20 17:17 ` Darren Hart
0 siblings, 0 replies; 7+ messages in thread
From: Darren Hart @ 2017-11-20 17:17 UTC (permalink / raw)
To: Linus Torvalds; +Cc: Andy Shevchenko, LKML
On Sat, Nov 18, 2017 at 12:09:10PM -0800, Linus Torvalds wrote:
> On Sat, Nov 18, 2017 at 10:37 AM, Linus Torvalds
> <torvalds@linux-foundation.org> wrote:
> >
> > So I note that you seem to use the same summary script that Darren used.
>
> .. oh, and I note a *much* worse issue.
>
> You add new drivers and then default them to "on".
>
> THAT IS COMPLETELY UNACCEPTABLE.
>
> I don't know why I have to say this every single merge window, but
> let's do it one more time:
>
> As a developer, you think _your_ driver or feature is the most
> important thing ever, and you have the hardware.
>
> AND ALMOST NOBODY ELSE CARES.
>
> Read it and weep. Unless your hardware is completely ubiquitous, it
> damn well should not default to being defaulted everybody elses
> config.
Understood and agreed, this is especially true for our subsystem which
is full of .... platform .... specific drivers.
>
> In particular, people who do "make oldconfig" clearly had a
> configuration _without_ your hardware and were happy with it, and want
> to keep it working. That's what "oldconfig" means.
>
> You don't say "hey, let's enable this piece of hardware that you don't
> have anyway, just to waste your time and disk and memory".
>
> So the things that merit "default y/m" are
>
> (a) you added a Kconfig option for something that used to always be
> built. Then it merits that "default y" exactly because "make
> oldconfig" should just work.
>
> (b) corollary of the above: if you add a new gatekeeping Kconfig
> option that hides/shows other Kconfig options (but doesn't generate
> any code of its own), it should be enabled by default, simply so that
> by default people will see those other options.
>
> (c) your driver itself defaults to off, but you then have sub-driver
> options for behavior or similar, where you can give sane defaults for
> people who _do_ have your hardware, and want the driver for it, and
> within those constraints the extended option makes sense
>
> (d) your piece of hardware or infrastructure really is something that
> everybody expects. If you have CONFIG_NET or CONFIG_BLOCK, you get to
> enable it by default.
>
> But something like CONFIG_DELL_SMBIOS sure as hell does not merit
> being default on. Not even if you have enabled WMI.
>
> EVERY SINGLE "default" line that got added by this branch was wrong.
>
> Stop doing this. It's a serious violation of peoples expectations.
> When I do "make oldconfig", I don't want some new random hardware
> support.
The above looks like good Documentation/ material. A quick scan doesn't
find it, but I'll look more closely and prepare a patch adding it if
I don't find it.
I'll have a sidebar with Andy and we'll review, set expectations, update
tooling as necessary, and resubmit. Given the above Kconfig default,
we'll prepare a patch on top of the existing HEAD to default to No, and
create a new tag.
Appreciate the detail above, we'll make sure it doesn't get lost.
--
Darren Hart
VMware Open Source Technology Center
^ permalink raw reply [flat|nested] 7+ messages in thread
* Re: [GIT PULL] platform-drivers-x86 for 4.15-1
2017-11-18 18:37 ` Linus Torvalds
2017-11-18 20:09 ` Linus Torvalds
@ 2017-11-20 19:06 ` Darren Hart
2017-11-21 7:48 ` Linus Torvalds
1 sibling, 1 reply; 7+ messages in thread
From: Darren Hart @ 2017-11-20 19:06 UTC (permalink / raw)
To: Linus Torvalds; +Cc: Andy Shevchenko, LKML
On Sat, Nov 18, 2017 at 10:37:55AM -0800, Linus Torvalds wrote:
> On Sat, Nov 18, 2017 at 10:09 AM, Andy Shevchenko
> <andriy.shevchenko@linux.intel.com> wrote:
> >
> > Here is the collected material against Platform Drivers x86 subsystem.
> > It's rather bit busy cycle for PDx86, mostly due to Dell SMBIOS driver
> > activity.
>
> So I note that you seem to use the same summary script that Darren used.
>
> Guys, the "merge summary" should be human-readable, not just a
> slightly munged version of "git shortlog" that has been sorted by
> first word.
>
> Feel free to use that munged version as a base-line, but don't just
> send me automated merge messages.
>
> The whole point of a summary is to summarize. And merge messages
> should be legible, not "this is all the details that you could have
> just used 'git shortlog' to get".
Hi Linus,
Back in the 4.2 timeframe, platform-drivers-x86-v4.2-2 specifically, I
started adding my pull request commentary to the tag directly and the
pull requests themselves tended to have little or no information beyond
that. I didn't see a clear division between what should go in the pull
request email body and what should be in the tag, this kept all the
information about the pull request together in the tag.
Andy's pull request follows this pattern, with the text of the tag
opening with the summary and context relevant to the pull request before
the munged shortlog:
--- 8< ---
For this cycle we have quite an update for the Dell SMBIOS driver
including WMI work to provide an interface for SMBIOS tokens via sysfs
and WMI support for 2017+ Dell laptop models. SMM dispatcher code is
split into a separate driver followed by a new WMI dispatcher.
The latter provides a character device interface to user space.
The pull request contains a merge of immutable branch from Wolfram Sang
in order to apply a dependent fix to the Intel CherryTrail Battery
Management driver.
Other Intel drivers got a lot of cleanups. The Turbo Boost Max 3.0
support is added for Intel Skylake.
Peaq WMI hotkeys driver gets its own maintainer and white list of
supported models.
Silead DMI is expanded to support few additional platforms.
Tablet mode via GMMS ACPI method is added to support some ThinkPad
tablets.
Two commits appear here which were previously merged during the
v4.14-rcX cycle:
- d7ca5ebf2493 platform/x86: intel_pmc_ipc: Use devm_* calls in driver probe function
- e3075fd6f80c platform/x86: intel_pmc_ipc: Use spin_lock to protect GCR updates
--- 8< ---
Do you not want to see this in the tag and prefer we move it to the GIT
PULL email body? If so, what do you want to see in the tag message?
Or, is the above not what you're looking for at all? And if not, what
are you looking for instead?
>
> When you can't even be bothered to fix up obvious issues like
>
> (a) "yeah, I just sorted things alphabetically without any human interaction":
>
> intel-wmi-thunderbolt:
> - Silence error cases
>
> MAINTAINERS:
> - Add entry for the PEAQ WMI hotkeys driver
>
> mlx-platform:
> - make a couple of structures static
>
> (b) "yeah, my summary script splits the overview at a colon, so when
> there is no colon it doesn't work":
>
> Add driver to force WMI Thunderbolt controller power status:
> - Add driver to force WMI Thunderbolt controller power status
>
> it's good that you have a fairly unified commit message model and can
> do these summaries, but it's bad when you then don't do much of any
> _human_ summary at all or even check the result for sanity.
Agreed. Andy, we need to read through everything we put into that pull
request and adjust to make sense. Pull Requests are not automated, the
scripts are there to help us avoid human error, and be as consistent as
possible.
--
Darren Hart
VMware Open Source Technology Center
^ permalink raw reply [flat|nested] 7+ messages in thread
* Re: [GIT PULL] platform-drivers-x86 for 4.15-1
2017-11-20 19:06 ` Darren Hart
@ 2017-11-21 7:48 ` Linus Torvalds
2017-11-21 23:59 ` Darren Hart
0 siblings, 1 reply; 7+ messages in thread
From: Linus Torvalds @ 2017-11-21 7:48 UTC (permalink / raw)
To: Darren Hart; +Cc: Andy Shevchenko, LKML
On Mon, Nov 20, 2017 at 9:06 AM, Darren Hart <dvhart@infradead.org> wrote:
>
> Back in the 4.2 timeframe, platform-drivers-x86-v4.2-2 specifically, I
> started adding my pull request commentary to the tag directly and the
> pull requests themselves tended to have little or no information beyond
> that.
Right - that's fine. I don't actually care whether the information is
in the signed tag, or in the emailed pull request, or in both. I'll
take it either way.
There are valid reasons to put it in the signed tag - that way you
write it as you do the tag, and then "git pull-request" is pretty much
entirely just automation.
But some people prefer to do the tag as just a marker (so the tag
message may be basically worthless), and then write the explanation
later in the email as they send it off. And that's fine too.
And yet other people do both - write some summary in the tag, but hen
write more about it in the emailed message. And I'll take that too, no
problem.
And in all three cases I'll edit things for grammar and whitespace
(indentation) etc, and may remove commentary that may be interesting
for me doing the merge, but isn't relevant in the history once the
merge is done.
> I didn't see a clear division between what should go in the pull
> request email body and what should be in the tag, this kept all the
> information about the pull request together in the tag.
There really is no division at all. One common _pattern_ is to have
the email message contain more of a freeform message, while the tag
contains more of a "summary list", but that's just a pattern that some
people tend to use, and it's not in any way universal or required.
> Andy's pull request follows this pattern, with the text of the tag
> opening with the summary and context relevant to the pull request before
> the munged shortlog:
Yes, and that separation is fine.
But I do want both parts to make sense. If the munged shortlog is pure
automation, why send it to me at all? Or if you do send it to me, say
that it's just filler for _you_, not for me.
But it looks like useful information, but without human editing, it's not.
It's basically the difference between "data" and "information". I want
information, and if it's pure data that I could get from "git
shortlog" that I should just ignore, then tell me to ignore it.
Linus
^ permalink raw reply [flat|nested] 7+ messages in thread
* Re: [GIT PULL] platform-drivers-x86 for 4.15-1
2017-11-21 7:48 ` Linus Torvalds
@ 2017-11-21 23:59 ` Darren Hart
0 siblings, 0 replies; 7+ messages in thread
From: Darren Hart @ 2017-11-21 23:59 UTC (permalink / raw)
To: Linus Torvalds; +Cc: Andy Shevchenko, LKML
On Mon, Nov 20, 2017 at 09:48:58PM -1000, Linus Torvalds wrote:
> On Mon, Nov 20, 2017 at 9:06 AM, Darren Hart <dvhart@infradead.org> wrote:
> >
> > Back in the 4.2 timeframe, platform-drivers-x86-v4.2-2 specifically, I
> > started adding my pull request commentary to the tag directly and the
> > pull requests themselves tended to have little or no information beyond
> > that.
>
> Right - that's fine. I don't actually care whether the information is
> in the signed tag, or in the emailed pull request, or in both. I'll
> take it either way.
>
> There are valid reasons to put it in the signed tag - that way you
> write it as you do the tag, and then "git pull-request" is pretty much
> entirely just automation.
>
> But some people prefer to do the tag as just a marker (so the tag
> message may be basically worthless), and then write the explanation
> later in the email as they send it off. And that's fine too.
>
> And yet other people do both - write some summary in the tag, but hen
> write more about it in the emailed message. And I'll take that too, no
> problem.
>
> And in all three cases I'll edit things for grammar and whitespace
> (indentation) etc, and may remove commentary that may be interesting
> for me doing the merge, but isn't relevant in the history once the
> merge is done.
>
> > I didn't see a clear division between what should go in the pull
> > request email body and what should be in the tag, this kept all the
> > information about the pull request together in the tag.
>
> There really is no division at all. One common _pattern_ is to have
> the email message contain more of a freeform message, while the tag
> contains more of a "summary list", but that's just a pattern that some
> people tend to use, and it's not in any way universal or required.
>
> > Andy's pull request follows this pattern, with the text of the tag
> > opening with the summary and context relevant to the pull request before
> > the munged shortlog:
>
> Yes, and that separation is fine.
>
> But I do want both parts to make sense. If the munged shortlog is pure
> automation, why send it to me at all? Or if you do send it to me, say
> that it's just filler for _you_, not for me.
>
> But it looks like useful information, but without human editing, it's not.
>
> It's basically the difference between "data" and "information". I want
> information, and if it's pure data that I could get from "git
> shortlog" that I should just ignore, then tell me to ignore it.
Thanks Linus, this is helpful. Andy and I have updated our tooling to
reflect the above, and we will modify our human-information-add as
follows:
The pull-request body will include merge-specific information and
instructions which are unrelated to the content. e.g. previously merged
fixes, pre-merged immutable branches, recommended merge conflict
resolution.
The tag message will include a human written highlights and summary,
followed by a git shortlog grouped by driver with a prefix indicating it
is automatically generated (although we will still verify the script
grouped things properly). This just offers a quick glance at what
changed by driver. I will also sometimes group fixes from static
analysis that would otherwise be rather noisy under a common group, e.g.
sparse fixes:
- Updated several drivers to use const strings
--
Darren Hart
VMware Open Source Technology Center
^ permalink raw reply [flat|nested] 7+ messages in thread
end of thread, other threads:[~2017-11-21 23:59 UTC | newest]
Thread overview: 7+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2017-11-18 18:09 [GIT PULL] platform-drivers-x86 for 4.15-1 Andy Shevchenko
2017-11-18 18:37 ` Linus Torvalds
2017-11-18 20:09 ` Linus Torvalds
2017-11-20 17:17 ` Darren Hart
2017-11-20 19:06 ` Darren Hart
2017-11-21 7:48 ` Linus Torvalds
2017-11-21 23:59 ` Darren Hart
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.