From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from ffbox0-bg.mplayerhq.hu (ffbox0-bg.ffmpeg.org [79.124.17.100]) by master.gitmailbox.com (Postfix) with ESMTPS id BB7114C33D for ; Wed, 22 Jan 2025 22:19:21 +0000 (UTC) Received: from [127.0.1.1] (localhost [127.0.0.1]) by ffbox0-bg.mplayerhq.hu (Postfix) with ESMTP id AC6F768B9EF; Thu, 23 Jan 2025 00:19:15 +0200 (EET) Received: from mail-wr1-f46.google.com (mail-wr1-f46.google.com [209.85.221.46]) by ffbox0-bg.mplayerhq.hu (Postfix) with ESMTPS id 4BE8568B71A for ; Thu, 23 Jan 2025 00:19:09 +0200 (EET) Received: by mail-wr1-f46.google.com with SMTP id ffacd0b85a97d-385e0e224cbso109382f8f.2 for ; Wed, 22 Jan 2025 14:19:09 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1737584348; x=1738189148; 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=SjNUo0j26xdLiqmtSiLbDC0BHtgyo4rX35cBQKV5sRw=; b=Wuq8xE+hbyRECBBQlyYeiPyTp7fuZxuerP+TNLsHXErRkX545wSBPURqY3B4Hs22Jt Ysl0stJTx8oN2KCcA/o7CSmB6rP647cADNZzh3vKhIBxymSeFRea4zUbBnQg8stxLKhf cmTYWCGel0GPHfXXxFygLHGuWzULbL4Z6l9oeCZNf0N/6iLDFYoiLX9N8rcodAgBGflW P8U0ht7KRFxWDqFiMYxHsi8RDXV6TdaINDrNqv08UDTL/s9Rxmej++VuHyeJ0fWs8cCy 3UtLdrgTSSHQBhBEOH4kZcXE64hgbMwsukAiNVHCfLNUOfkaAedFq42GmAzH/L+JEQsI nX4Q== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1737584348; x=1738189148; 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=SjNUo0j26xdLiqmtSiLbDC0BHtgyo4rX35cBQKV5sRw=; b=nhZIJrNu89qDnLJgKMinL2A2elx23jxfsoiL/9GSSFvRtPJZ/iu9sjXnMXLb4QaMCi AxJ/6BVx+fBuSC3TxnifuNZtYzalqetjF6tEWhfTNQMAroibAtbwSO38+x9HHIX9AL0W r6TkjItG86yAlSObUcAXRr0LijkJ5cNB6kr7ZbbkVLiRdVmR4H0JfZxvBF50v5h7nHDH jedvEY/6N4AZP6772YuF3NsztvbZX9VmvxyrFj+LnMYGb8WqQXjsuu0LzzS9iN7CQXun YH8YZdByShGKh9an8Iu61aJtY3x7wTPfn/jrfBDk9NePE4OQo81dhY0ibJBFtWclRrmP WPjA== X-Gm-Message-State: AOJu0Yypta9HYyK2n1BXkDAbTlSTsh6izYF6/jJEhPCYkzaoMxMTJPtn Xdgo1xkmiqSdT+4bxXvgGQgMJKeiGeXD6hedXJUTvBWBazqNE1SfGHSZbA== X-Gm-Gg: ASbGncvdIgwu7NLiJCroQ9eV49FyoZk/V73h4M2Crd8UyabqsuG9rjB6RRVoiCgHHa4 OXAPb/DIZvSKoU1OMR4dvvq5B1RmOJfBawAbMt0GzqymNc2eGyI1BpXJwUgaoSO0qTJh5vnsWag 0K0yOWE2SMtxf8OFBJXFPwViP5TJPUnFydJBcg68JkTPDtKUxvqWsHwJCI3wCh6dJHLUJgJSVla kn+Ml+QY0YDwirRQhx7paDV1cz7wFZR3TrK/Tg7R9hBYBeXKgmv6+pZBYBL+oPm2+tmJRdp4ss5 Nyv9zxUQFRcsgAGqGJ+7t05Y39vtbnseC87r2QIYz/kJiR32kme7ZO4plpo5e6O8zCsg8j+Em4y Zu0d1 X-Google-Smtp-Source: AGHT+IHwJyRlRSxDQaO0PMrEr4yJnEuejGz8Eldaj72adgwl7P99tn0H+z0D9oQzNqe5IW8iXQ2+Ug== X-Received: by 2002:a5d:6d8d:0:b0:38a:88bc:ace1 with SMTP id ffacd0b85a97d-38bf57a9608mr19628205f8f.34.1737584348329; Wed, 22 Jan 2025 14:19:08 -0800 (PST) Received: from [192.168.178.30] (p200300cccf399000d96e09593551d22b.dip0.t-ipconnect.de. [2003:cc:cf39:9000:d96e:959:3551:d22b]) by smtp.gmail.com with ESMTPSA id ffacd0b85a97d-38bf3215066sm17705218f8f.11.2025.01.22.14.19.07 (version=TLS1_2 cipher=ECDHE-ECDSA-AES128-GCM-SHA256 bits=128/128); Wed, 22 Jan 2025 14:19:07 -0800 (PST) From: epirat07@gmail.com To: FFmpeg development discussions and patches Date: Wed, 22 Jan 2025 23:19:06 +0100 X-Mailer: MailMate (1.14r6065) Message-ID: In-Reply-To: References: MIME-Version: 1.0 Subject: Re: [FFmpeg-devel] [PATCH] 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 List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Reply-To: FFmpeg development discussions and patches Cc: Alexander Strasser Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit Errors-To: ffmpeg-devel-bounces@ffmpeg.org Sender: "ffmpeg-devel" Archived-At: List-Archive: List-Post: On 22 Jan 2025, at 22:59, 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 > --- > libavutil/avstring.h | 18 +++++++++++++++--- > 1 file changed, 15 insertions(+), 3 deletions(-) > > diff --git a/libavutil/avstring.h b/libavutil/avstring.h > index fc095349d2..133d021632 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 parameter name, is found at least You can use @p to refer to parameters, like: "given in @p name". > + * once in the parameter list. > + * > + * In both parameters, multiple names must be separated by the character > + * given in parameter separator. > + * > + * This is in line e.g. with the rule used for naming demuxers. > + * > + * @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); > Looks good otherwise, thanks for clarifying the documentation! > -- > _______________________________________________ > 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".