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;
IronPort-SDR: SALwNfhBZNDenf591k52Ny+hSFwP3e0ROX0R5eMw0YzZKb4tmzXjTsNZzErmjBdcWOheFBmQUm
 wuE3Il2AHOFg==
IronPort-SDR: taSB7atfiX84dKZCdsTjr/r7vGfhWCmZDfH93ZmS/DNjCJnF6wlZKsXv04kLN0j4WPRxPLNXHe
 SHjl32LHBvQQ==
Date:   Wed, 11 Nov 2020 18:48:16 +0200
From:   Andy Shevchenko <andriy.shevchenko@linux.intel.com>
To:     Petr Mladek <pmladek@suse.com>
Cc:     Geert Uytterhoeven <geert+renesas@glider.be>,
        Jonathan Corbet <corbet@lwn.net>,
        Steven Rostedt <rostedt@goodmis.org>,
        Sergey Senozhatsky <sergey.senozhatsky@gmail.com>,
        Rasmus Villemoes <linux@rasmusvillemoes.dk>,
        linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org
Subject: Re: [PATCH] docs: core-api/printk-formats.rst: Clarify formatting
 {cpu,node}mask
Message-ID: <20201111164816.GN4077@smile.fi.intel.com>
References: <20201110144121.3278667-1-geert+renesas@glider.be>
 <20201111152933.GA1702@alley>
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <20201111152933.GA1702@alley>
Organization: Intel Finland Oy - BIC 0357606-4 - Westendinkatu 7, 02160 Espoo
Precedence: bulk

On Wed, Nov 11, 2020 at 04:29:33PM +0100, Petr Mladek wrote:
> On Tue 2020-11-10 15:41:21, Geert Uytterhoeven wrote:
> > Clarify how to pass the field width for bitmaps, and mention the helper
> > macros that are available to ease printing cpumask and nodemask.

...

> 	%*pb	0779
> 	%*pbl	0,3-6,8-10
> 
> For printing bitmap and its derivatives such as cpumask and nodemask.
> 
> It takes two arguments, see '*'. The first argument defines the number
> of bits in the mask. The second argument points to the mask.
> 
> %*pb outputs the bitmap as a hex number. If the size is bigger than 32-bit
> then 32-bit values are separated by a comma.
> 
> %*pbl outputs the bitmap as a range list.
> 
> The number of bits is passed by value. The mask is passed by reference.

It can be improved at least by replacing mask with bitmap here.

> Helper macros cpumask_pr_args() and nodemask_pr_args() are available to
> ease printing cpumask and nodemask.

-- 
With Best Regards,
Andy Shevchenko