Received: by 2002:a05:6a11:4021:0:0:0:0 with SMTP id ky33csp875702pxb; Tue, 14 Sep 2021 10:33:11 -0700 (PDT) X-Google-Smtp-Source: ABdhPJwoo3cZHuZr85txgniQ2jeEghA9NzISmPIIXv8NlXh03ndHFaa6uNI8zdys7H3hh7feJ7U5 X-Received: by 2002:a05:6e02:964:: with SMTP id q4mr7592110ilt.290.1631640791452; Tue, 14 Sep 2021 10:33:11 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1631640791; cv=none; d=google.com; s=arc-20160816; b=mbYy++At20Frk3epFPsvjU/5fhaUTpH9A/44Uns+f1S+yOE9/kzESJFmknD95GSahD x+ye4TtESUzvZs8DwPd6dxiPpKPi6u2zg9C6YHr+HfhrV5d/XWydpZNSBvIbiQe1ESSU O/NEukmFxJptClFMiuzLi8Ecpjh6FneFvogyY5VE8z55ExZnewI5OBAAkRFr4NTPpWk1 dY0jOIq1xUjNEb301yqgy+91q9joZHZcaE87iWm84PjLx0GbnNhs86BIWgw/s60FzCum zh9FXwFYZyl8eIkFs8V+4dKUu23/6Hlef+xbQyexXkC1Tx/EaL8g144IvLGsnYdpxh9c QW5A== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:cc:to:subject :message-id:date:from:in-reply-to:references:mime-version :dkim-signature; bh=qs/nXFozNO4XKGck5LQAgcVnI2HZwI8WrVsYnHtpC94=; b=M5OWLe5Y3R68wSEyzX8qW7Kb/gvw8Nv3+mNLw898QWFrOitDommu1mXhE6wc1wvclC TxIXbsNo6bAM/0RN3mHxr7F6KFZswb9KBBiFlpIIi/H56XMGw/XECoNnjNnSxs67gdSb Gw8O9yuySLRkYCJ1CTnkd4QqitJ8Z/4YzPn55scCN3+8896HZumBOCqgR8zkdGRWaxAC wEhmkzGE5a2mKPEm2jPGrdqp0jVhxV38UTohIufcT1k0Vzekt1IhQ6DX+19VfvAHY4iS RvqY7QMvPQ7juwyxu8gkUK6wpf/EXXusmPuTi8Zb03vVqi9LGXP9H6Y3G2mFiv9xaFwq 5G9Q== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@google.com header.s=20210112 header.b=RJypP0ZE; 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=REJECT sp=REJECT dis=NONE) header.from=google.com Return-Path: Received: from vger.kernel.org (vger.kernel.org. [23.128.96.18]) by mx.google.com with ESMTP id m33si10491805jaf.66.2021.09.14.10.32.52; Tue, 14 Sep 2021 10:33:11 -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=@google.com header.s=20210112 header.b=RJypP0ZE; 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=REJECT sp=REJECT dis=NONE) header.from=google.com Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S229464AbhINRdS (ORCPT + 99 others); Tue, 14 Sep 2021 13:33:18 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:53858 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S229526AbhINRdR (ORCPT ); Tue, 14 Sep 2021 13:33:17 -0400 Received: from mail-pf1-x436.google.com (mail-pf1-x436.google.com [IPv6:2607:f8b0:4864:20::436]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 06E88C061762 for ; Tue, 14 Sep 2021 10:32:00 -0700 (PDT) Received: by mail-pf1-x436.google.com with SMTP id m26so13014927pff.3 for ; Tue, 14 Sep 2021 10:32:00 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=20210112; h=mime-version:references:in-reply-to:from:date:message-id:subject:to :cc:content-transfer-encoding; bh=qs/nXFozNO4XKGck5LQAgcVnI2HZwI8WrVsYnHtpC94=; b=RJypP0ZEIzGrEzxsJiZ3f0EhlTI1eSOUL1RNtKf3JNQjS/D/d/8TfWrRamUe+4uj8F +9R28NsHtXqgtoLOrQuCinGRhCU5+xPekYQzfQkk4KeTx+NqAgCJ/jOHs2EB63+fWZ28 CiVZ8vUPO+r3bA0nU12WHmTBuzxoVY6LkE+nsMbPacqfdTYzSBmV1BvmMGBi2N7L8Ndt Hk4QaqGHrrANd5wG9uK+GLpVubcflZiUE2P84BsEL/S+6AU5sZaqw+iucEOwT7NQKczB 7Vfk8LbYYQh5hlbchTgQzdJZuGbUwSnTD4t6hMWx42JAg0EPigS1trYjsclzOmxN5dWG iORw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=x-gm-message-state:mime-version:references:in-reply-to:from:date :message-id:subject:to:cc:content-transfer-encoding; bh=qs/nXFozNO4XKGck5LQAgcVnI2HZwI8WrVsYnHtpC94=; b=EnT6RRzdYz0js1fxbhdkMhfrzpSKMR0nHHIk19chkuAUkLDQ1pKh8flms+r8r2ntz1 8M5clArh4f6Ts6qA4ED3uvIroN2YsZkkbZDwl76LDI30oPKQ+ki9VNZ/ifq4sKzsw8+x dE1DGnSwjqxs50gX328VkryISYdnPXddeD/0wdyO8Ofh+zWbY8rIRY5UdoG8mh6eqJ4h TVcqSljdJFBrK0KVkVfS9sarLSHnUqYHNsXBByz/B5u3ioh4AGg+3NS4pWCjySTav+3m DUn/hHLPeG9HybpH9yUbwYK/TNCOWA13LxIygPuyDCW+bBUmLK0pEtcWpAxcvzLW4kRr HDAQ== X-Gm-Message-State: AOAM531g5aEs8x/pDyk46A/1AIkvQLGqSh+0SHNxWyB/bRymNiPqzQDG zLWkBaFg0uOIFsmIV4ZDlLCG85OnnSYcHYGC241n/w== X-Received: by 2002:a62:e70c:0:b0:43e:2de6:b09d with SMTP id s12-20020a62e70c000000b0043e2de6b09dmr134044pfh.9.1631640719199; Tue, 14 Sep 2021 10:31:59 -0700 (PDT) MIME-Version: 1.0 References: In-Reply-To: From: Rajat Jain Date: Tue, 14 Sep 2021 10:31:23 -0700 Message-ID: Subject: Re: [PATCH v2 01/29] ABI: sysfs-bus-usb: better document variable argument To: Mauro Carvalho Chehab Cc: Greg Kroah-Hartman , Linux Doc Mailing List , Jonathan Corbet , Bjorn Helgaas , Heikki Krogerus , Jonathan Cameron , linux-kernel@vger.kernel.org Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org On Tue, Sep 14, 2021 at 7:32 AM 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 In case it matters: Acked-by: Rajat Jain > --- > 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, a= nd 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_ty= pe > +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=C3=B8rn 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_curre= nt_count > +What: /sys/bus/usb/devices/...//port/over_cur= rent_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=3D/sys/bus/usb/devices/.../(hub inter= face)/portX > + OVER_CURRENT_PORT=3D/sys/bus/usb/devices/...//port > OVER_CURRENT_COUNT=3D[current value of this sysfs attri= bute] > > -What: /sys/bus/usb/devices/.../(hub interface)/portX/usb3_lpm_p= ermit > +What: /sys/bus/usb/devices/...//port/usb3_lpm= _permit > Date: November 2015 > Contact: Lu Baolu > Description: > -- > 2.31.1 >