Received: by 2002:a05:6a11:4021:0:0:0:0 with SMTP id ky33csp938837pxb; Tue, 14 Sep 2021 12:03:16 -0700 (PDT) X-Google-Smtp-Source: ABdhPJyQtFOHDFP4P0FKRYu6wvlL0g0yO80B2CjmIfsryWNSAKW58GMd8KfRc6PHhUaQGd2obu/r X-Received: by 2002:a2e:1556:: with SMTP id 22mr16218554ljv.253.1631646196643; Tue, 14 Sep 2021 12:03:16 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1631646196; cv=none; d=google.com; s=arc-20160816; b=UDccAj8/ps8rAv9fBfyw3tW/s/FhXd0EANpyPoglYSWGRMW5iqJRMAJia+2jOtRRVo psrWUMLlwSBBOrMb9/41j+ht7cEFCPEOXVTb8aqPto+vyf+SgGXS5Mz4MofE/zBAOwld Ia0xoFchGiSoVv8KWeF4sYTxc8pKe+uPBGcYKrA2FgoyEc1SLP8g8T2b/uGL77vXXg2+ ZgckOZ6odbMQG/ZyH9efP9WhSKwQpNRvPCndrn/Vja+md5B6/Df4VCu16l75re5iKPxr 8SF2VqfiOqEGUoBs0oNNMrvXFuzH/ru2gKV7nkZZXioPSmXik3oECgH8N7feAs8d8FM8 49fg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:in-reply-to:content-transfer-encoding :content-disposition:mime-version:message-id:subject:cc:to:from:date :dkim-signature; bh=eSp8OoLv0ZFY0t1T5cOPI7/8EsyfkpTxOMcdOg7xPhk=; b=HrJzuIg3woZ4XkXVEntRrZmmXtrUIz6pXOmA4fgwBRrtE9a/7A1KZVeDbXxGyHt4vm bCdea/tqtWuQetzyLht32Ledjv7Fe8qWlZ8eo87r0YpB52Qxl0NewaGtPnn0FxrEOyl0 6JNh5ySjURbohKAOs7mHjxKOKtCSxjwJkr4ahVJdv8mvOql7u5QgYKUQNhaiS4p9hM6y ebegyPw5cXeqeIXy9AlsOIsyeddidM40Hlx2y0NIyT9+kAbCPPVIcg/3pkf0qC6firDi b1QYQ/Yxq+V/G+L6R8+yCMeD6dHjd32wFQRROWoINFjLfUN3+SJPi8aIvN0BfamfCT5C EnwA== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@kernel.org header.s=k20201202 header.b=BCkemMXY; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=kernel.org Return-Path: Received: from vger.kernel.org (vger.kernel.org. [23.128.96.18]) by mx.google.com with ESMTP id y24si13277968lji.406.2021.09.14.12.02.24; Tue, 14 Sep 2021 12:03:16 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) client-ip=23.128.96.18; Authentication-Results: mx.google.com; dkim=pass header.i=@kernel.org header.s=k20201202 header.b=BCkemMXY; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=kernel.org Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S229728AbhINS7P (ORCPT + 99 others); Tue, 14 Sep 2021 14:59:15 -0400 Received: from mail.kernel.org ([198.145.29.99]:34880 "EHLO mail.kernel.org" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S232359AbhINS7L (ORCPT ); Tue, 14 Sep 2021 14:59:11 -0400 Received: by mail.kernel.org (Postfix) with ESMTPSA id 0EBA761130; Tue, 14 Sep 2021 18:57:53 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1631645874; bh=dd5YBsKq0kKtdjlfugGsWrclHUSx6pYm7MzhzBwLRTI=; h=Date:From:To:Cc:Subject:In-Reply-To:From; b=BCkemMXYji7HDVg761E4H3PDpguL8jvcwoRW+aootTkauFiy92a9EoVbo/gacOd84 NPzWME9JZ+mM3Fl9Oy5es8U5RU2VAi7SY8VPgjruP0LL84vz6dSoMPel04EpGJCX3d 5IcWF9LoaipjKcsC0wKt//3yeZB4ocfgPegGf8xSFQC4naLa+bG9au9mCw1D8D64Yl LGhOjjVxJOmeCYg11m6Mg0LcIZJyTpQsBcdW4P6qGoAualZY0zroABSRGgQobuXGKJ OV4W68mrPp8UV7I1akHb7zEGl0MfmZDoP468vquN3mxuS6lrkFrwMpB3y3smC5y1Vs W3LkUQ91O+RGw== Date: Tue, 14 Sep 2021 13:57:52 -0500 From: Bjorn Helgaas To: Mauro Carvalho Chehab Cc: Greg Kroah-Hartman , Linux Doc Mailing List , Jonathan Corbet , Bjorn Helgaas , Heikki Krogerus , Jonathan Cameron , Rajat Jain , linux-kernel@vger.kernel.org Subject: Re: [PATCH v2 01/29] ABI: sysfs-bus-usb: better document variable argument Message-ID: <20210914185752.GA1444725@bjorn-Precision-5520> MIME-Version: 1.0 Content-Type: text/plain; charset=iso-8859-1 Content-Disposition: inline Content-Transfer-Encoding: 8bit In-Reply-To: Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org On Tue, Sep 14, 2021 at 04:32:16PM +0200, Mauro Carvalho Chehab wrote: > On almost all ABI documents, variable arguments are declared > as . Change it here too, in order to allow replacing > such wildcards by regexes on a scriptable way. > > Signed-off-by: Mauro Carvalho Chehab Acked-by: Bjorn Helgaas > --- > Documentation/ABI/testing/sysfs-bus-usb | 16 ++++++++-------- > 1 file changed, 8 insertions(+), 8 deletions(-) > > diff --git a/Documentation/ABI/testing/sysfs-bus-usb b/Documentation/ABI/testing/sysfs-bus-usb > index 73eb23bc1f34..42103f0f54d6 100644 > --- a/Documentation/ABI/testing/sysfs-bus-usb > +++ b/Documentation/ABI/testing/sysfs-bus-usb > @@ -166,14 +166,14 @@ Description: > The file will be present for all speeds of USB devices, and will > always read "no" for USB 1.1 and USB 2.0 devices. > > -What: /sys/bus/usb/devices/.../(hub interface)/portX > +What: /sys/bus/usb/devices/...//port > Date: August 2012 > Contact: Lan Tianyu > Description: > - The /sys/bus/usb/devices/.../(hub interface)/portX > + The /sys/bus/usb/devices/...//port > is usb port device's sysfs directory. > > -What: /sys/bus/usb/devices/.../(hub interface)/portX/connect_type > +What: /sys/bus/usb/devices/...//port/connect_type > Date: January 2013 > Contact: Lan Tianyu > Description: > @@ -182,7 +182,7 @@ Description: > The file will read "hotplug", "hardwired" and "not used" if the > information is available, and "unknown" otherwise. > > -What: /sys/bus/usb/devices/.../(hub interface)/portX/location > +What: /sys/bus/usb/devices/...//port/location > Date: October 2018 > Contact: Bj?rn Mork > Description: > @@ -192,7 +192,7 @@ Description: > raw location value as a hex integer. > > > -What: /sys/bus/usb/devices/.../(hub interface)/portX/quirks > +What: /sys/bus/usb/devices/...//port/quirks > Date: May 2018 > Contact: Nicolas Boichat > Description: > @@ -216,7 +216,7 @@ Description: > used to help make enumeration work better on some high speed > devices. > > -What: /sys/bus/usb/devices/.../(hub interface)/portX/over_current_count > +What: /sys/bus/usb/devices/...//port/over_current_count > Date: February 2018 > Contact: Richard Leitner > Description: > @@ -230,10 +230,10 @@ Description: > Any time this value changes the corresponding hub device will send a > udev event with the following attributes:: > > - OVER_CURRENT_PORT=/sys/bus/usb/devices/.../(hub interface)/portX > + OVER_CURRENT_PORT=/sys/bus/usb/devices/...//port > OVER_CURRENT_COUNT=[current value of this sysfs attribute] > > -What: /sys/bus/usb/devices/.../(hub interface)/portX/usb3_lpm_permit > +What: /sys/bus/usb/devices/...//port/usb3_lpm_permit > Date: November 2015 > Contact: Lu Baolu > Description: > -- > 2.31.1 >