Re: [PATCH] PM / docs: Drop confusing kernel-doc references from infrastructure.rst

2017-01-02 Thread Rafael J. Wysocki
On Monday, January 02, 2017 03:39:20 PM Jonathan Corbet wrote: > On Mon, 02 Jan 2017 23:05:31 +0100 > "Rafael J. Wysocki" wrote: > > > > From: Rafael J. Wysocki > > > > > > The references to drivers/base/power/main.c and > > > drivers/acpi/scan.c from Documentation/driver-api/infrastructure.rst

Re: [PATCH] PM / docs: Drop confusing kernel-doc references from infrastructure.rst

2017-01-02 Thread Jonathan Corbet
On Mon, 02 Jan 2017 23:05:31 +0100 "Rafael J. Wysocki" wrote: > > From: Rafael J. Wysocki > > > > The references to drivers/base/power/main.c and > > drivers/acpi/scan.c from Documentation/driver-api/infrastructure.rst > > are confusing. They both cause descriptions of functions that are > > n

Re: [PATCH] PM / docs: Drop confusing kernel-doc references from infrastructure.rst

2017-01-02 Thread Rafael J. Wysocki
On Monday, December 19, 2016 09:36:39 PM Rafael J. Wysocki wrote: > From: Rafael J. Wysocki > > The references to drivers/base/power/main.c and > drivers/acpi/scan.c from Documentation/driver-api/infrastructure.rst > are confusing. They both cause descriptions of functions that are > not relevan

[PATCH] PM / docs: Drop confusing kernel-doc references from infrastructure.rst

2016-12-19 Thread Rafael J. Wysocki
From: Rafael J. Wysocki The references to drivers/base/power/main.c and drivers/acpi/scan.c from Documentation/driver-api/infrastructure.rst are confusing. They both cause descriptions of functions that are not relevant to device drivers at all to be generated and none of them is sufficient to c