Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) client-ip=2620:137:e000::1:20;
Date:   Wed, 23 Feb 2022 15:17:02 +0100
From:   Tomasz =?UTF-8?B?V2FybmllxYLFgm8=?= <tomasz.warniello@gmail.com>
To:     Akira Yokosawa <akiyks@gmail.com>
Cc:     Jonathan Corbet <corbet@lwn.net>,
        Randy Dunlap <rdunlap@infradead.org>,
        linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org
Subject: Re: [PATCH] scripts: kernel-doc: Check existence of FILE arg
Message-ID: <20220223151702.55a3a7a5@fuji.fritz.box>
In-Reply-To: <721f860a-a662-0f0c-a82d-eacf80841eb3@gmail.com>
References: <1c71e5d2-f87e-6c8e-6176-e5ce42e4d41b@gmail.com>
        <20220223144713.6e2284e3@fuji.fritz.box>
        <721f860a-a662-0f0c-a82d-eacf80841eb3@gmail.com>
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: quoted-printable
Precedence: bulk

On Wed, 23 Feb 2022 22:59:01 +0900
Akira Yokosawa <akiyks@gmail.com> wrote:

> On Wed, 23 Feb 2022 14:47:13 +0100,
> Tomasz Warnie=C5=82=C5=82o wrote:
> > On Wed, 23 Feb 2022 15:07:30 +0900
> > Akira Yokosawa <akiyks@gmail.com> wrote:
> >  =20
> >> Currently, when no FILE argument is given following switches such
> >> as -man, -rst, and -none, kernel-doc ends up in the error of (long
> >> msg from perl folded):
> >>
> >>     Use of uninitialized value $ARGV[0] in pattern match (m//)
> >>     at ./scripts/kernel-doc line 438. =20
> >=20
> > It's a warning not an error. =20
>=20
> Good catch!
>=20
> Will amend in v2 with proper attribution.
>=20
>         Thanks Akira

I'd include this in a series regulating all the CLI syntax - all those
mutual exclusions and arg parsing error handling, etc. At the moment they
exist only in the documentation.

But I'm not sure this is the right moment to do this. Have you seen
my RFC thread? I'd wait until the water stabilises and see the result.
This script may be phased out - how soon, I don't know. Unless you want
to do this purely for sport.

Tomasz