From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1754213AbcLSUkg (ORCPT ); Mon, 19 Dec 2016 15:40:36 -0500 Received: from cloudserver094114.home.net.pl ([79.96.170.134]:44903 "EHLO cloudserver094114.home.net.pl" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1753134AbcLSUkf (ORCPT ); Mon, 19 Dec 2016 15:40:35 -0500 From: "Rafael J. Wysocki" To: Jonathan Corbet Cc: LKML , Linux PM , Mauro Carvalho Chehab , Linux Documentation Subject: [PATCH] PM / docs: Drop confusing kernel-doc references from infrastructure.rst Date: Mon, 19 Dec 2016 21:36:39 +0100 Message-ID: <1637935.8QKVTKQPm8@aspire.rjw.lan> User-Agent: KMail/4.14.10 (Linux/4.9.0-rc8+; KDE/4.14.9; x86_64; ; ) MIME-Version: 1.0 Content-Transfer-Encoding: 7Bit Content-Type: text/plain; charset="us-ascii" Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org 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 cover the API in a meaningful way. Drop them for now. Signed-off-by: Rafael J. Wysocki --- Documentation/driver-api/infrastructure.rst | 15 --------------- 1 file changed, 15 deletions(-) Index: linux-pm/Documentation/driver-api/infrastructure.rst =================================================================== --- linux-pm.orig/Documentation/driver-api/infrastructure.rst +++ linux-pm/Documentation/driver-api/infrastructure.rst @@ -55,21 +55,6 @@ Device Drivers DMA Management .. kernel-doc:: drivers/base/dma-mapping.c :export: -Device Drivers Power Management -------------------------------- - -.. kernel-doc:: drivers/base/power/main.c - :export: - -Device Drivers ACPI Support ---------------------------- - -.. kernel-doc:: drivers/acpi/scan.c - :export: - -.. kernel-doc:: drivers/acpi/scan.c - :internal: - Device drivers PnP support --------------------------