From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-7.0 required=3.0 tests=INCLUDES_PATCH, MAILING_LIST_MULTI,SIGNED_OFF_BY,SPF_HELO_NONE,SPF_PASS,URIBL_BLOCKED autolearn=unavailable autolearn_force=no version=3.4.0 Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id 0207FC31E4C for ; Fri, 14 Jun 2019 08:32:13 +0000 (UTC) Received: from lists.ozlabs.org (lists.ozlabs.org [203.11.71.2]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mail.kernel.org (Postfix) with ESMTPS id 540F82084E for ; Fri, 14 Jun 2019 08:32:12 +0000 (UTC) DMARC-Filter: OpenDMARC Filter v1.3.2 mail.kernel.org 540F82084E Authentication-Results: mail.kernel.org; dmarc=fail (p=none dis=none) header.from=kernel.org Authentication-Results: mail.kernel.org; spf=pass smtp.mailfrom=linuxppc-dev-bounces+linuxppc-dev=archiver.kernel.org@lists.ozlabs.org Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) by lists.ozlabs.org (Postfix) with ESMTP id 45QDP53lz6zDrc1 for ; Fri, 14 Jun 2019 18:32:09 +1000 (AEST) Authentication-Results: lists.ozlabs.org; spf=pass (mailfrom) smtp.mailfrom=gmail.com (client-ip=209.85.167.194; helo=mail-oi1-f194.google.com; envelope-from=rjwysocki@gmail.com; receiver=) Authentication-Results: lists.ozlabs.org; dmarc=fail (p=none dis=none) header.from=kernel.org Received: from mail-oi1-f194.google.com (mail-oi1-f194.google.com [209.85.167.194]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by lists.ozlabs.org (Postfix) with ESMTPS id 45QDM36xhfzDr86 for ; Fri, 14 Jun 2019 18:30:23 +1000 (AEST) Received: by mail-oi1-f194.google.com with SMTP id a127so695069oii.2 for ; Fri, 14 Jun 2019 01:30:23 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:references:in-reply-to:from:date :message-id:subject:to:cc; bh=aBX5S6bgTctWckd9/P2tFIY6izVzBb7AzQ5sf+y29+s=; b=U63kkY3n/oh5TU0dU2dGBl+USGv435bdX3VHG/2Kafii6g/7bZE9Rl3ewbAcZHToX6 k9XKrRmHmmpnBCnxf34vygNjw5QOlMkRNCiuU/oSn1xAX6yO3OTwhJGB9Mfzv/NroX5W 4X3qLw9DeK4REtCgaXeIbLU6p6V8/oq38ea0oWM3JpuzI1xzjCzVVxFYMAg9Y5JUZ4c8 AA0xOZ/+RHnUNru3ppwu3l4RYrPhrhKOfOSJ+wbceR5azaH42QmZxPbGqibibx4w8B+/ rGE1Fa7QfMrdU1n/5iiw73lrfNhAu8SL5CYi4+Y8oCJBF2WcWLWKVAOen4wO5gFV1S7N 2xxg== X-Gm-Message-State: APjAAAWOskfqTBrmz0pBtofBuPQtzatB2sXHG/KtOnq2HZR72P0ayFAz DlFiRfYtRvPPDkM8Fs53rVVOapw6tRZVX8KAEDg= X-Google-Smtp-Source: APXvYqx1omA4R75tw8TDas2oab9KcZIvx/qWC/wiBq28VqDt/zUvgcBSEWWYNiN8xHrBQ36Y0tGYodw0/oHg4FHPCEo= X-Received: by 2002:aca:3256:: with SMTP id y83mr1140955oiy.110.1560501020169; Fri, 14 Jun 2019 01:30:20 -0700 (PDT) MIME-Version: 1.0 References: In-Reply-To: From: "Rafael J. Wysocki" Date: Fri, 14 Jun 2019 10:30:07 +0200 Message-ID: Subject: Re: [PATCH 01/14] ABI: fix some syntax issues at the ABI database To: Mauro Carvalho Chehab Content-Type: text/plain; charset="UTF-8" X-BeenThere: linuxppc-dev@lists.ozlabs.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Linux on PowerPC Developers Mail List List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: Tony Luck , Lars-Peter Clausen , Andrew Donnellan , Jonathan Corbet , linux-iio@vger.kernel.org, Greg Kroah-Hartman , Sebastian Reichel , Linux Doc Mailing List , Linux Kernel Mailing List , Mauro Carvalho Chehab , Mauro Carvalho Chehab , Colin Cross , Linux PM , Andreas Klinger , Peter Meerwald-Stadler , Hartmut Knaack , Frederic Barrat , linuxppc-dev , Anton Vorontsov , Jonathan Cameron , Kees Cook Errors-To: linuxppc-dev-bounces+linuxppc-dev=archiver.kernel.org@lists.ozlabs.org Sender: "Linuxppc-dev" On Fri, Jun 14, 2019 at 4:04 AM Mauro Carvalho Chehab wrote: > > From: Mauro Carvalho Chehab > > On those three files, the ABI representation described at > README are violated. > > - at sysfs-bus-iio-proximity-as3935: > a ':' character is missing after "What" > > - at sysfs-class-devfreq: > there's a typo at Description > > - at sysfs-class-cxl, it is using the ":" character at a > file preamble, causing it to be misinterpreted as a > tag. > > - On the other files, instead of "What", they use "Where". > > Signed-off-by: Mauro Carvalho Chehab > Signed-off-by: Mauro Carvalho Chehab Acked-by: Rafael J. Wysocki > --- > Documentation/ABI/testing/pstore | 2 +- > .../sysfs-bus-event_source-devices-format | 2 +- > .../ABI/testing/sysfs-bus-i2c-devices-hm6352 | 6 ++--- > .../ABI/testing/sysfs-bus-iio-distance-srf08 | 4 ++-- > .../testing/sysfs-bus-iio-proximity-as3935 | 4 ++-- > .../ABI/testing/sysfs-bus-pci-devices-cciss | 22 +++++++++---------- > .../testing/sysfs-bus-usb-devices-usbsevseg | 12 +++++----- > Documentation/ABI/testing/sysfs-class-cxl | 6 ++--- > Documentation/ABI/testing/sysfs-class-devfreq | 2 +- > .../ABI/testing/sysfs-class-powercap | 2 +- > Documentation/ABI/testing/sysfs-kernel-fscaps | 2 +- > .../ABI/testing/sysfs-kernel-vmcoreinfo | 2 +- > 12 files changed, 33 insertions(+), 33 deletions(-) > > diff --git a/Documentation/ABI/testing/pstore b/Documentation/ABI/testing/pstore > index 5fca9f5e10a3..8d6e48f4e8ef 100644 > --- a/Documentation/ABI/testing/pstore > +++ b/Documentation/ABI/testing/pstore > @@ -1,4 +1,4 @@ > -Where: /sys/fs/pstore/... (or /dev/pstore/...) > +What: /sys/fs/pstore/... (or /dev/pstore/...) > Date: March 2011 > Kernel Version: 2.6.39 > Contact: tony.luck@intel.com > diff --git a/Documentation/ABI/testing/sysfs-bus-event_source-devices-format b/Documentation/ABI/testing/sysfs-bus-event_source-devices-format > index 77f47ff5ee02..b6f8748e0200 100644 > --- a/Documentation/ABI/testing/sysfs-bus-event_source-devices-format > +++ b/Documentation/ABI/testing/sysfs-bus-event_source-devices-format > @@ -1,4 +1,4 @@ > -Where: /sys/bus/event_source/devices//format > +What: /sys/bus/event_source/devices//format > Date: January 2012 > Kernel Version: 3.3 > Contact: Jiri Olsa > diff --git a/Documentation/ABI/testing/sysfs-bus-i2c-devices-hm6352 b/Documentation/ABI/testing/sysfs-bus-i2c-devices-hm6352 > index feb2e4a87075..29bd447e50a0 100644 > --- a/Documentation/ABI/testing/sysfs-bus-i2c-devices-hm6352 > +++ b/Documentation/ABI/testing/sysfs-bus-i2c-devices-hm6352 > @@ -1,18 +1,18 @@ > -Where: /sys/bus/i2c/devices/.../heading0_input > +What: /sys/bus/i2c/devices/.../heading0_input > Date: April 2010 > Kernel Version: 2.6.36? > Contact: alan.cox@intel.com > Description: Reports the current heading from the compass as a floating > point value in degrees. > > -Where: /sys/bus/i2c/devices/.../power_state > +What: /sys/bus/i2c/devices/.../power_state > Date: April 2010 > Kernel Version: 2.6.36? > Contact: alan.cox@intel.com > Description: Sets the power state of the device. 0 sets the device into > sleep mode, 1 wakes it up. > > -Where: /sys/bus/i2c/devices/.../calibration > +What: /sys/bus/i2c/devices/.../calibration > Date: April 2010 > Kernel Version: 2.6.36? > Contact: alan.cox@intel.com > diff --git a/Documentation/ABI/testing/sysfs-bus-iio-distance-srf08 b/Documentation/ABI/testing/sysfs-bus-iio-distance-srf08 > index 0a1ca1487fa9..a133fd8d081a 100644 > --- a/Documentation/ABI/testing/sysfs-bus-iio-distance-srf08 > +++ b/Documentation/ABI/testing/sysfs-bus-iio-distance-srf08 > @@ -1,4 +1,4 @@ > -What /sys/bus/iio/devices/iio:deviceX/sensor_sensitivity > +What: /sys/bus/iio/devices/iio:deviceX/sensor_sensitivity > Date: January 2017 > KernelVersion: 4.11 > Contact: linux-iio@vger.kernel.org > @@ -6,7 +6,7 @@ Description: > Show or set the gain boost of the amp, from 0-31 range. > default 31 > > -What /sys/bus/iio/devices/iio:deviceX/sensor_max_range > +What: /sys/bus/iio/devices/iio:deviceX/sensor_max_range > Date: January 2017 > KernelVersion: 4.11 > Contact: linux-iio@vger.kernel.org > diff --git a/Documentation/ABI/testing/sysfs-bus-iio-proximity-as3935 b/Documentation/ABI/testing/sysfs-bus-iio-proximity-as3935 > index 9a17ab5036a4..c59d95346341 100644 > --- a/Documentation/ABI/testing/sysfs-bus-iio-proximity-as3935 > +++ b/Documentation/ABI/testing/sysfs-bus-iio-proximity-as3935 > @@ -1,4 +1,4 @@ > -What /sys/bus/iio/devices/iio:deviceX/in_proximity_input > +What: /sys/bus/iio/devices/iio:deviceX/in_proximity_input > Date: March 2014 > KernelVersion: 3.15 > Contact: Matt Ranostay > @@ -6,7 +6,7 @@ Description: > Get the current distance in meters of storm (1km steps) > 1000-40000 = distance in meters > > -What /sys/bus/iio/devices/iio:deviceX/sensor_sensitivity > +What: /sys/bus/iio/devices/iio:deviceX/sensor_sensitivity > Date: March 2014 > KernelVersion: 3.15 > Contact: Matt Ranostay > diff --git a/Documentation/ABI/testing/sysfs-bus-pci-devices-cciss b/Documentation/ABI/testing/sysfs-bus-pci-devices-cciss > index 53d99edd1d75..eb449169c30b 100644 > --- a/Documentation/ABI/testing/sysfs-bus-pci-devices-cciss > +++ b/Documentation/ABI/testing/sysfs-bus-pci-devices-cciss > @@ -1,66 +1,66 @@ > -Where: /sys/bus/pci/devices//ccissX/cXdY/model > +What: /sys/bus/pci/devices//ccissX/cXdY/model > Date: March 2009 > Kernel Version: 2.6.30 > Contact: iss_storagedev@hp.com > Description: Displays the SCSI INQUIRY page 0 model for logical drive > Y of controller X. > > -Where: /sys/bus/pci/devices//ccissX/cXdY/rev > +What: /sys/bus/pci/devices//ccissX/cXdY/rev > Date: March 2009 > Kernel Version: 2.6.30 > Contact: iss_storagedev@hp.com > Description: Displays the SCSI INQUIRY page 0 revision for logical > drive Y of controller X. > > -Where: /sys/bus/pci/devices//ccissX/cXdY/unique_id > +What: /sys/bus/pci/devices//ccissX/cXdY/unique_id > Date: March 2009 > Kernel Version: 2.6.30 > Contact: iss_storagedev@hp.com > Description: Displays the SCSI INQUIRY page 83 serial number for logical > drive Y of controller X. > > -Where: /sys/bus/pci/devices//ccissX/cXdY/vendor > +What: /sys/bus/pci/devices//ccissX/cXdY/vendor > Date: March 2009 > Kernel Version: 2.6.30 > Contact: iss_storagedev@hp.com > Description: Displays the SCSI INQUIRY page 0 vendor for logical drive > Y of controller X. > > -Where: /sys/bus/pci/devices//ccissX/cXdY/block:cciss!cXdY > +What: /sys/bus/pci/devices//ccissX/cXdY/block:cciss!cXdY > Date: March 2009 > Kernel Version: 2.6.30 > Contact: iss_storagedev@hp.com > Description: A symbolic link to /sys/block/cciss!cXdY > > -Where: /sys/bus/pci/devices//ccissX/rescan > +What: /sys/bus/pci/devices//ccissX/rescan > Date: August 2009 > Kernel Version: 2.6.31 > Contact: iss_storagedev@hp.com > Description: Kicks of a rescan of the controller to discover logical > drive topology changes. > > -Where: /sys/bus/pci/devices//ccissX/cXdY/lunid > +What: /sys/bus/pci/devices//ccissX/cXdY/lunid > Date: August 2009 > Kernel Version: 2.6.31 > Contact: iss_storagedev@hp.com > Description: Displays the 8-byte LUN ID used to address logical > drive Y of controller X. > > -Where: /sys/bus/pci/devices//ccissX/cXdY/raid_level > +What: /sys/bus/pci/devices//ccissX/cXdY/raid_level > Date: August 2009 > Kernel Version: 2.6.31 > Contact: iss_storagedev@hp.com > Description: Displays the RAID level of logical drive Y of > controller X. > > -Where: /sys/bus/pci/devices//ccissX/cXdY/usage_count > +What: /sys/bus/pci/devices//ccissX/cXdY/usage_count > Date: August 2009 > Kernel Version: 2.6.31 > Contact: iss_storagedev@hp.com > Description: Displays the usage count (number of opens) of logical drive Y > of controller X. > > -Where: /sys/bus/pci/devices//ccissX/resettable > +What: /sys/bus/pci/devices//ccissX/resettable > Date: February 2011 > Kernel Version: 2.6.38 > Contact: iss_storagedev@hp.com > @@ -71,7 +71,7 @@ Description: Value of 1 indicates the controller can honor the reset_devices > a dump device, as kdump requires resetting the device in order > to work reliably. > > -Where: /sys/bus/pci/devices//ccissX/transport_mode > +What: /sys/bus/pci/devices//ccissX/transport_mode > Date: July 2011 > Kernel Version: 3.0 > Contact: iss_storagedev@hp.com > diff --git a/Documentation/ABI/testing/sysfs-bus-usb-devices-usbsevseg b/Documentation/ABI/testing/sysfs-bus-usb-devices-usbsevseg > index 70d00dfa443d..f6199b314196 100644 > --- a/Documentation/ABI/testing/sysfs-bus-usb-devices-usbsevseg > +++ b/Documentation/ABI/testing/sysfs-bus-usb-devices-usbsevseg > @@ -1,12 +1,12 @@ > -Where: /sys/bus/usb/.../powered > +What: /sys/bus/usb/.../powered > Date: August 2008 > Kernel Version: 2.6.26 > Contact: Harrison Metzger > Description: Controls whether the device's display will powered. > A value of 0 is off and a non-zero value is on. > > -Where: /sys/bus/usb/.../mode_msb > -Where: /sys/bus/usb/.../mode_lsb > +What: /sys/bus/usb/.../mode_msb > +What: /sys/bus/usb/.../mode_lsb > Date: August 2008 > Kernel Version: 2.6.26 > Contact: Harrison Metzger > @@ -16,7 +16,7 @@ Description: Controls the devices display mode. > for an 8 character display the values are > MSB 0x08; LSB 0xFF. > > -Where: /sys/bus/usb/.../textmode > +What: /sys/bus/usb/.../textmode > Date: August 2008 > Kernel Version: 2.6.26 > Contact: Harrison Metzger > @@ -25,13 +25,13 @@ Description: Controls the way the device interprets its text buffer. > hex: each character is between 0-15 > ascii: each character is between '0'-'9' and 'A'-'F'. > > -Where: /sys/bus/usb/.../text > +What: /sys/bus/usb/.../text > Date: August 2008 > Kernel Version: 2.6.26 > Contact: Harrison Metzger > Description: The text (or data) for the device to display > > -Where: /sys/bus/usb/.../decimals > +What: /sys/bus/usb/.../decimals > Date: August 2008 > Kernel Version: 2.6.26 > Contact: Harrison Metzger > diff --git a/Documentation/ABI/testing/sysfs-class-cxl b/Documentation/ABI/testing/sysfs-class-cxl > index bbbabffc682a..fc7c6f7c21b3 100644 > --- a/Documentation/ABI/testing/sysfs-class-cxl > +++ b/Documentation/ABI/testing/sysfs-class-cxl > @@ -1,6 +1,6 @@ > -Note: Attributes that are shared between devices are stored in the directory > -pointed to by the symlink device/. > -Example: The real path of the attribute /sys/class/cxl/afu0.0s/irqs_max is > +Please notice that attributes that are shared between devices are stored in > +the directory pointed to by the symlink device/. > +For example, the real path of the attribute /sys/class/cxl/afu0.0s/irqs_max is > /sys/class/cxl/afu0.0s/device/irqs_max, i.e. /sys/class/cxl/afu0.0/irqs_max. > > > diff --git a/Documentation/ABI/testing/sysfs-class-devfreq b/Documentation/ABI/testing/sysfs-class-devfreq > index ee39acacf6f8..01196e19afca 100644 > --- a/Documentation/ABI/testing/sysfs-class-devfreq > +++ b/Documentation/ABI/testing/sysfs-class-devfreq > @@ -47,7 +47,7 @@ Description: > What: /sys/class/devfreq/.../trans_stat > Date: October 2012 > Contact: MyungJoo Ham > -Descrtiption: > +Description: > This ABI shows the statistics of devfreq behavior on a > specific device. It shows the time spent in each state and > the number of transitions between states. > diff --git a/Documentation/ABI/testing/sysfs-class-powercap b/Documentation/ABI/testing/sysfs-class-powercap > index db3b3ff70d84..f333a0ccc29b 100644 > --- a/Documentation/ABI/testing/sysfs-class-powercap > +++ b/Documentation/ABI/testing/sysfs-class-powercap > @@ -147,6 +147,6 @@ What: /sys/class/powercap/...//enabled > Date: September 2013 > KernelVersion: 3.13 > Contact: linux-pm@vger.kernel.org > -Description > +Description: > This allows to enable/disable power capping at power zone level. > This applies to current power zone and its children. > diff --git a/Documentation/ABI/testing/sysfs-kernel-fscaps b/Documentation/ABI/testing/sysfs-kernel-fscaps > index 50a3033b5e15..bcff34665192 100644 > --- a/Documentation/ABI/testing/sysfs-kernel-fscaps > +++ b/Documentation/ABI/testing/sysfs-kernel-fscaps > @@ -2,7 +2,7 @@ What: /sys/kernel/fscaps > Date: February 2011 > KernelVersion: 2.6.38 > Contact: Ludwig Nussel > -Description > +Description: > Shows whether file system capabilities are honored > when executing a binary > > diff --git a/Documentation/ABI/testing/sysfs-kernel-vmcoreinfo b/Documentation/ABI/testing/sysfs-kernel-vmcoreinfo > index 7bd81168e063..1f1087a5f075 100644 > --- a/Documentation/ABI/testing/sysfs-kernel-vmcoreinfo > +++ b/Documentation/ABI/testing/sysfs-kernel-vmcoreinfo > @@ -4,7 +4,7 @@ KernelVersion: 2.6.24 > Contact: Ken'ichi Ohmichi > Kexec Mailing List > Vivek Goyal > -Description > +Description: > Shows physical address and size of vmcoreinfo ELF note. > First value contains physical address of note in hex and > second value contains the size of note in hex. This ELF > -- > 2.21.0 >