From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <ffmpeg-devel-bounces@ffmpeg.org>
Received: from ffbox0-bg.mplayerhq.hu (ffbox0-bg.ffmpeg.org [79.124.17.100])
	by master.gitmailbox.com (Postfix) with ESMTPS id 1AA144C5EF
	for <ffmpegdev@gitmailbox.com>; Thu, 23 Jan 2025 21:18:24 +0000 (UTC)
Received: from [127.0.1.1] (localhost [127.0.0.1])
	by ffbox0-bg.mplayerhq.hu (Postfix) with ESMTP id E2CCB68B7B5;
	Thu, 23 Jan 2025 23:18:21 +0200 (EET)
Received: from mail-ed1-f54.google.com (mail-ed1-f54.google.com
 [209.85.208.54])
 by ffbox0-bg.mplayerhq.hu (Postfix) with ESMTPS id 1DB5468B65B
 for <ffmpeg-devel@ffmpeg.org>; Thu, 23 Jan 2025 23:18:15 +0200 (EET)
Received: by mail-ed1-f54.google.com with SMTP id
 4fb4d7f45d1cf-5d3bbb0f09dso2557612a12.2
 for <ffmpeg-devel@ffmpeg.org>; Thu, 23 Jan 2025 13:18:15 -0800 (PST)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
 d=gmail.com; s=20230601; t=1737667094; x=1738271894; darn=ffmpeg.org;
 h=content-transfer-encoding:mime-version:references:in-reply-to
 :message-id:date:subject:cc:to:from:from:to:cc:subject:date
 :message-id:reply-to;
 bh=UHC6OevPutfoXJTQCJjaqVulHAEEblqGFlJHZ0XxVDU=;
 b=j7xJBTegRf5LfvXI0zZeeUhN1wfaU2d5HGuTAMgxkbms2qFEsLuF0UbfDrt95qsfG2
 oDsimdlDdECNSmJeuIrdiu8aZ5ORvfONUk/zCS2UXGQHtMD3hwtUnrKFQ3Vl2M0FPaN4
 Yp9U8sP55+ECTPG9h6iD3wjf56g1Gjo7waWj8KBWgu4HN++HjHCBzmOYau8r8FUf2uip
 WxPQLm2xoPg97dV/ZYN5bADcax1xV16Wd7CRr6buuTwBIzoerW4Xm4tYcunP8k2BoEXr
 st8/TBEyRoUc9cjkonHHMin2UosSemfGZziPHi2niRzlSkTjXf4dCqhnky9StwAH+FLi
 or9Q==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
 d=1e100.net; s=20230601; t=1737667094; x=1738271894;
 h=content-transfer-encoding:mime-version:references:in-reply-to
 :message-id:date:subject:cc:to:from:x-gm-message-state:from:to:cc
 :subject:date:message-id:reply-to;
 bh=UHC6OevPutfoXJTQCJjaqVulHAEEblqGFlJHZ0XxVDU=;
 b=RIOltFCKuRVUsY2YOOltPMTtW/WXesQ1SCZC5YfON4hx+QFZ79qROAa017VB1bxmvu
 QyMfejKiBBf2UTkZBbEOO1lV7bZqKlDq/LUownHrMdPFtyKQmV9fk9TCBAJ0SVbVu3kd
 /CDTgW1IdvXdaM/9SQEvgMXc4PMA4CJLq3Exek58qlkm3Ep5mricNNWBhr9S8/SZf805
 u+ItcuEK2OiuLAB7i8hCX2R2y6sjlm4kjWz0qd+Jtih0KNbaEw4T/aLPQo02pA/sf4Vo
 j14hcoYD6uWMOE7/0WYPBnvw9lr8FhWJekYmuiuDhTn58RmwxkI/jQf/20GVeceLnfKe
 t2mg==
X-Gm-Message-State: AOJu0Yzr7DD2j0O3pDG5LBVTkFm8eu/5rJMhWbWmepm2TE8Zpk2K5F2F
 gqAPXZwxzL23b1ESi2/07cMQ/p7Q7LjPk7H4aZfMeIorKnYsZNVwjT4GUg==
X-Gm-Gg: ASbGnct91mLPAjTlMoqfTEmt3PqhoLs62O8XNFj+zjxwPvPNoY6NSVHLptacX+qearC
 YEURM6ax0xJK7vtOS21JJnUWQvHdKJA2s7s4n9QoQJKPa45d+X6bI10l1LDXtFvjk8Ej9C69KRj
 k5w+gy52PGKyQ+7U9dL0Jaf5rwe3tu+ZJinpVMdhDduDJoJJsLCkFvug+hhy/fP22WUCZAPPLOQ
 Kibb1oHnu7yd24Dpbd0Q+Ug6w0H6wsd6pbn4A3yyHmbsMt6H3lGde9xezz1Qh0VCKJAwjxBKbMP
 Q50ZoN7rczZr9wjk4eGDudWRzLivAW0awSWXm+wCxV8yAGkGYdseS1Ktjvp7mQQPQREbBQ3El/h
 4NhjdWtwpUYjUyHjl
X-Google-Smtp-Source: AGHT+IFz243zv0Jzv3jXlQ52cd8QGXa5iZasymAo3UisWKouD6oGdY0nvpagRuMDejuAMJBER7qv7w==
X-Received: by 2002:a05:6402:5201:b0:5d1:2440:9ad3 with SMTP id
 4fb4d7f45d1cf-5db7d633180mr26743156a12.30.1737667094051; 
 Thu, 23 Jan 2025 13:18:14 -0800 (PST)
Received: from [192.168.178.30]
 (p200300cccf399000d0db1a30d89ea1a7.dip0.t-ipconnect.de.
 [2003:cc:cf39:9000:d0db:1a30:d89e:a1a7])
 by smtp.gmail.com with ESMTPSA id
 4fb4d7f45d1cf-5dc186d8e2dsm160159a12.75.2025.01.23.13.18.11
 (version=TLS1_2 cipher=ECDHE-ECDSA-AES128-GCM-SHA256 bits=128/128);
 Thu, 23 Jan 2025 13:18:12 -0800 (PST)
From: epirat07@gmail.com
To: FFmpeg development discussions and patches <ffmpeg-devel@ffmpeg.org>
Date: Thu, 23 Jan 2025 22:18:10 +0100
X-Mailer: MailMate (1.14r6065)
Message-ID: <71F8D183-2DAC-4422-B303-8FCA378964E1@gmail.com>
In-Reply-To: <Z5KoK4QFRc2xaKYD@metallschleim.local>
References: <Z5KoK4QFRc2xaKYD@metallschleim.local>
MIME-Version: 1.0
Subject: Re: [FFmpeg-devel] [PATCH v2] libavutil/avstring: av_match_list:
 Update API documentation
X-BeenThere: ffmpeg-devel@ffmpeg.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: FFmpeg development discussions and patches <ffmpeg-devel.ffmpeg.org>
List-Unsubscribe: <https://ffmpeg.org/mailman/options/ffmpeg-devel>,
 <mailto:ffmpeg-devel-request@ffmpeg.org?subject=unsubscribe>
List-Archive: <https://ffmpeg.org/pipermail/ffmpeg-devel>
List-Post: <mailto:ffmpeg-devel@ffmpeg.org>
List-Help: <mailto:ffmpeg-devel-request@ffmpeg.org?subject=help>
List-Subscribe: <https://ffmpeg.org/mailman/listinfo/ffmpeg-devel>,
 <mailto:ffmpeg-devel-request@ffmpeg.org?subject=subscribe>
Reply-To: FFmpeg development discussions and patches <ffmpeg-devel@ffmpeg.org>
Cc: Alexander Strasser <eclipse7@gmx.net>
Content-Type: text/plain; charset="us-ascii"
Content-Transfer-Encoding: 7bit
Errors-To: ffmpeg-devel-bounces@ffmpeg.org
Sender: "ffmpeg-devel" <ffmpeg-devel-bounces@ffmpeg.org>
Archived-At: <https://master.gitmailbox.com/ffmpegdev/71F8D183-2DAC-4422-B303-8FCA378964E1@gmail.com/>
List-Archive: <https://master.gitmailbox.com/ffmpegdev/>
List-Post: <mailto:ffmpegdev@gitmailbox.com>

On 23 Jan 2025, at 21:35, Alexander Strasser via ffmpeg-devel wrote:

> Since av_match_list was added in commit 0d92b0d5f445d4f2 , this
> function changed its semantics shortly after, especially with
> commit 3c0b98dced394da3 .
>
> Signed-off-by: Alexander Strasser <eclipse7@gmx.net>
> ---
>
> Diff to v1:
>   * use @p as suggested by ePirat
>   * clarify that the hint about demuxer names is about FFmpeg
>
>  libavutil/avstring.h | 18 +++++++++++++++---
>  1 file changed, 15 insertions(+), 3 deletions(-)
>
> diff --git a/libavutil/avstring.h b/libavutil/avstring.h
> index fc095349d2..1a5405581a 100644
> --- a/libavutil/avstring.h
> +++ b/libavutil/avstring.h
> @@ -409,9 +409,21 @@ int av_utf8_decode(int32_t *codep, const uint8_t **bufp, const uint8_t *buf_end,
>                     unsigned int flags);
>
>  /**
> - * Check if a name is in a list.
> - * @returns 0 if not found, or the 1 based index where it has been found in the
> - *            list.
> + * Check if one of the given names is in a list.
> + *
> + * Check if any of the names, given in @p name, is found at least
> + * once in @p list.
> + *
> + * In both parameters, multiple names must be separated by the character
> + * given in @p separator.
> + *
> + * This is in line e.g. with the rule used for naming demuxers in FFmpeg.
> + *
> + * @param name      Contains names searched for in list.
> + * @param list      List of names that is searched in.
> + * @param separator Character that separates items in the given lists.
> + *
> + * @returns 0 if no match was found, otherwise 1.
>   */
>  int av_match_list(const char *name, const char *list, char separator);
>

LGTM, thanks!

> --
> _______________________________________________
> ffmpeg-devel mailing list
> ffmpeg-devel@ffmpeg.org
> https://ffmpeg.org/mailman/listinfo/ffmpeg-devel
>
> To unsubscribe, visit link above, or email
> ffmpeg-devel-request@ffmpeg.org with subject "unsubscribe".
_______________________________________________
ffmpeg-devel mailing list
ffmpeg-devel@ffmpeg.org
https://ffmpeg.org/mailman/listinfo/ffmpeg-devel

To unsubscribe, visit link above, or email
ffmpeg-devel-request@ffmpeg.org with subject "unsubscribe".