From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from smtp.kernel.org (aws-us-west-2-korg-mail-1.web.codeaurora.org [10.30.226.201]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 8F14025DB0D for ; Sun, 22 Feb 2026 14:19:35 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=10.30.226.201 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1771769975; cv=none; b=BtGMUVV8gWarFL2KUrcX9AynkVdus6EwXKZHRSBi/N636s/li61YMVeAeB4fRH2+7QU/u1nIBqMbAsk2lw6U1AYR7lrMcMV3W3fYORWLsADqul5tBy1+QLN+gEPjVWLyj4Pkc0gfukgh6EW4F4p1haRuuH1dkjZ4JLFrPgQYY7Q= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1771769975; c=relaxed/simple; bh=fgEKtAyjbUK+4KvUAHNiWU9me14VpfSBnDqpuJJRdmY=; h=Date:From:To:Cc:Subject:Message-ID:References:MIME-Version: Content-Type:Content-Disposition:In-Reply-To; b=dILuQJyTvGe2HDkJ+wn/AMR6rzxiGG0jRO4qaX6vvQPStDQJjOFGgymMDjO3PiIqptHNzJkTd+ab4dGj8ldnvKTBIdECsxaNUpJYXgftI/UyVmuv4mR6tAxV6kRt73MK/tlMGtE6/sFsTK8QJvzhy/R+GffR2xVry00DLkLON+Y= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b=sfNz/yym; arc=none smtp.client-ip=10.30.226.201 Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b="sfNz/yym" Received: by smtp.kernel.org (Postfix) with ESMTPSA id 2941AC116D0; Sun, 22 Feb 2026 14:19:33 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1771769975; bh=fgEKtAyjbUK+4KvUAHNiWU9me14VpfSBnDqpuJJRdmY=; h=Date:From:To:Cc:Subject:References:In-Reply-To:From; b=sfNz/yymoUhn/rXwH8d+0kGWWgTdM4S3oqgkyt8/9vCyKIZfGU+vDHRhkowfDUbin uFlb8NlbupguIlu5i0Q0pUp/Ic7K+ns4oBzqWLcoYUHR38hb814YVlH3CNXHr4wRUv lXFVmAqDW4We/0msqmEurHfGhT59X/SexadZtnxyiwEsIsR81j5EHzeuLmrpKOUNN6 b1edrVQiueXG8nv6oqHPyjvSzMfwqnn0tGMP3Pc7J0TSn0/QJ0tx+2zqmRa0z5GH1q C+RFEnmYNHFEY+dboLL3Go1L9YPBiHibTZVGWQIXbNrrlMBkGgNIZfQ7HG/kLe4Mu0 CtlRcuRfaAlgQ== Date: Sun, 22 Feb 2026 15:19:31 +0100 From: Alejandro Colomar To: Bruno Haible Cc: Paul Eggert , bug-gnulib@gnu.org, linux-man@vger.kernel.org Subject: Re: [PATCH v1 1/1] man/man3/strnul.3: New page Message-ID: References: <2947259.IIHS8v3jeM@nimes> Precedence: bulk X-Mailing-List: linux-man@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha512; protocol="application/pgp-signature"; boundary="bqqslsvldozl4xqs" Content-Disposition: inline In-Reply-To: <2947259.IIHS8v3jeM@nimes> --bqqslsvldozl4xqs Content-Type: text/plain; protected-headers=v1; charset=utf-8 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable From: Alejandro Colomar To: Bruno Haible Cc: Paul Eggert , bug-gnulib@gnu.org, linux-man@vger.kernel.org Subject: Re: [PATCH v1 1/1] man/man3/strnul.3: New page Message-ID: References: <2947259.IIHS8v3jeM@nimes> MIME-Version: 1.0 In-Reply-To: <2947259.IIHS8v3jeM@nimes> Hi Bruno, On 2026-02-22T15:10:03+0100, Bruno Haible wrote: > Alejandro Colomar wrote: > > .B #include > > .P > > -.BI char\~*strnul(const\~char\~* s ); > > +.BI QChar\~*strnul(QChar\~* s ); > > .fi >=20 > Ouch. This is not understandable. Why should a user learn about what 'QCh= ar' > is?? >=20 > It's basically like a C++ template with 2 instantiations. Just list them > explicitly; this will be much clearer. >=20 > It's common that the SYNOPSIS section has several lines. For example, > man1/locale.1 has 4 separate lines. Hmmm; sounds reasonable. I'll do that. Cheers, Alex --=20 --bqqslsvldozl4xqs Content-Type: application/pgp-signature; name="signature.asc" -----BEGIN PGP SIGNATURE----- iQIzBAABCgAdFiEES7Jt9u9GbmlWADAi64mZXMKQwqkFAmmbEHMACgkQ64mZXMKQ wqmx5w/9GSkPv7nf0i2t/jupHYPBt0LleXWAfBVX6gnkoallNN1B861lDCFDlF+N FLjc95FZi/w3z+5PeKSapCD+NMSsCvDm2kiJJd5kHZTQa5hyDeyx5uN8v4oblHN1 RrxKEXVOWfByWcwb8z0ULOrf77tN0w0+33u7KBiNYUChA/m0J8kEFCYL68KsQxUw FVhnUx4zeq0YkeQjmi0OdeTJqSxaiTatK5OOBWl/V+I3DR/WbQaWqVMN11uIaTLy oToiFpYhFFCIsAZxCeuku1sfv08OWU8Fx1738nNXdNK8jzZa96/UXf5ZOowXp9hH eHuaShDMoW22xbERjKX662fOSNB8Kye/TTfIvIQPdxXjBf2G7xcB98xnrSEJq3vx 3THLvwlY+IgX8uhmx3L+vQsyYmhXG5cevmPQHQHpl6BOwEsHngURfGNMBfuSHFZI HgwiLxR6kLzyiXKb401nqNd1b3pb1r+AmXfCFD4mV/HwmvQT2pr56VMOiD0duYgO Qx9V1sb914ufl3UG/hTQv9ocb1jkCW1rYujU5SKaw0IoYGKvZRdox/kOlHiYQUTo GoFZ5UATEjoiO2uBsdR+5hmYOp6v5UzeGFlpuSZgiursqJn11fSVAm3wI7VlmFzO TE750TuOCeoLaOupdJH6NOqm4wFW0vn7AEN4Kcus0Obr/Wa4CrI= =cFia -----END PGP SIGNATURE----- --bqqslsvldozl4xqs--