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 ESMTP id BEECE43EEB for ; Thu, 17 Nov 2022 14:17:54 +0000 (UTC) Received: from [127.0.1.1] (localhost [127.0.0.1]) by ffbox0-bg.mplayerhq.hu (Postfix) with ESMTP id B5AB068BB06; Thu, 17 Nov 2022 16:17:51 +0200 (EET) Received: from w4.tutanota.de (w4.tutanota.de [81.3.6.165]) by ffbox0-bg.mplayerhq.hu (Postfix) with ESMTPS id 8559168B94F for ; Thu, 17 Nov 2022 16:17:45 +0200 (EET) Received: from tutadb.w10.tutanota.de (unknown [192.168.1.10]) by w4.tutanota.de (Postfix) with ESMTP id 3A27D106031C for ; Thu, 17 Nov 2022 14:17:45 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; t=1668694664; s=s1; d=lynne.ee; h=From:From:To:To:Subject:Subject:Content-Description:Content-ID:Content-Type:Content-Type:Content-Transfer-Encoding:Content-Transfer-Encoding:Cc:Date:Date:In-Reply-To:In-Reply-To:MIME-Version:MIME-Version:Message-ID:Message-ID:Reply-To:References:References:Sender; bh=6tuW65HKMzL+wml/LDalmObsRuiFwrJntwn5fe4S1eU=; b=CU4xOuSUkIaHtlveAHNpp1VsXwtHYJG517aUqfTdoHyLVsNYdIy/kUkPv7UNUIyq nW8Q1kxgv46hS5Adv/TNNSkqIubXrqs/bOllJUD7yhIjCgoa1o7+pL41y31zcqSiSAH mX31HFoIcbEVdRDpzXqBH8xwJblmh111G9bLOaDU8IZf/q8AP/pJoB/Icb7EmXqo6oz U9TvgY0e79SkYE9EinquDNaw3ccNh0Ej8FQ1rHV9uULkZBHhQlmM0ttSQlz3nHns+CX gKKBcbJBl6Apmx/olKxiPCh349fDevyZV3tnt/t1+bH2La3Hp5cPFMxMobd9izYd727 ZiJkeq1eKw== Date: Thu, 17 Nov 2022 15:17:44 +0100 (CET) From: Lynne To: FFmpeg development discussions and patches Message-ID: In-Reply-To: <20221117100942.6217-4-anton@khirnov.net> References: <20221117100942.6217-1-anton@khirnov.net> <20221117100942.6217-4-anton@khirnov.net> MIME-Version: 1.0 Subject: Re: [FFmpeg-devel] [PATCH 4/7] doc/developer.texi: document the use of other languages than C 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 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: Nov 17, 2022, 11:09 by anton@khirnov.net: > --- > doc/developer.texi | 15 +++++++++++++-- > 1 file changed, 13 insertions(+), 2 deletions(-) > > diff --git a/doc/developer.texi b/doc/developer.texi > index 01735e07f5..44da6e41af 100644 > --- a/doc/developer.texi > +++ b/doc/developer.texi > @@ -56,9 +56,9 @@ and should try to fix issues their commit causes. > @anchor{Coding Rules} > @chapter Coding Rules > > -@section C language features > +@section Language > > -FFmpeg is programmed in the ISO C99 language, extended with: > +FFmpeg is mainly programmed in the ISO C99 language, extended with: > @itemize @bullet > @item > Atomic operations from C11 @file{stdatomic.h}. They are emulated on > @@ -83,6 +83,17 @@ complex numbers; > mixed statements and declarations. > @end itemize > > +Other languages than C may be used in special cases: > +@itemize @bullet > +@item > +NASM is preferred for x86 SIMD or other x86 assembly. Inline assembly and > +intrinsics should be avoided, unless there is a strong reason to use them (e.g. > +code that needs to be inlined). > We don't accept x86 intrinsics, so should isn't really appropriate. Also, a word for other architectures would do. Something like this maybe: @item NASM is required for x86 assembly. Inline assembly should be avoided, unless there's a strong reason to use it (e.g. code that has to be inlined). Intrinsics or other assembly flavours are not accepted for x86. @item For other architectures, GAS syntax should be used for assembly. Inline assembly should be avoided, unless there's a good reason to use it. Intrinsics are acceptable, but not recommended. Other architectures also have different assembly syntax versions, but it's so niche, it's not really worth mentioning. Other patches look good. _______________________________________________ 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".