From mboxrd@z Thu Jan 1 00:00:00 1970 Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="ZDd3sVge" Received: from mail-oi1-x22d.google.com (mail-oi1-x22d.google.com [IPv6:2607:f8b0:4864:20::22d]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 97661D48 for ; Thu, 23 Nov 2023 06:07:55 -0800 (PST) Received: by mail-oi1-x22d.google.com with SMTP id 5614622812f47-3b3f55e1bbbso591841b6e.2 for ; Thu, 23 Nov 2023 06:07:55 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1700748475; x=1701353275; darn=vger.kernel.org; h=in-reply-to:content-disposition:mime-version:references:message-id :subject:cc:to:from:date:from:to:cc:subject:date:message-id:reply-to; bh=fndfJCwgQ1H3nATDA2gXkw25F384XEdKUqVLbEdHiAg=; b=ZDd3sVge3dRcrZAkTxuLEEs288393loya1o2RbPLyHeLruAFEgUZrhEl1DGsj9WseR Dz/H7voPT7t08vdHDnyIFwdJaeOnbUqYqiaUzeBLmqq298jlyJAU6xPsiEZO2HNjnzyW K1UMkUIjdUEaLDqOZLR0XXjMwKZBhEvxAzUdqEup3aIDJYA7h78a3vQcsxb/NMviIqPK 0DmMixPHN72TV4dGgUJb1mQwX0GMEqbuT+huB1RAo83oylpWPo/h4/kWI+3VWNQUej3D 6gIfjeI4lYDR/IvjXlqwx1ED6TYZooosvrfQsfrzjwKka1ghhohWsF+tNmvkLm0GlYwN Rjww== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1700748475; x=1701353275; h=in-reply-to:content-disposition:mime-version:references:message-id :subject:cc:to:from:date:x-gm-message-state:from:to:cc:subject:date :message-id:reply-to; bh=fndfJCwgQ1H3nATDA2gXkw25F384XEdKUqVLbEdHiAg=; b=mJDu1bmRc26UMxsydJpRLuNz+XGCzTD/B/DX3VeN+Te0ra7VCwVxViI2pNuY/yabKg V3vStx6NmQbcM9+Kzm4ISLu0xzsSFUvvTscatUAYNxpHUhoLjbIGYG0vl9Y2wsIGdgHf Muikx+Tj19Qy7RPp7rRXwWoHxG3Nje0pH0Bi/SRBFgIJx3IEImyTn4nnxswHexAvygNO QR79djmYUc1nP34h7+8vOOlOyUC/k0wp4+IswdsGOBMKxM7ECy3f8bv4x/i/AKt52zED Zo/fEWrYN2RNSN7SIcebuOtwP50FZJTH2AYPNojYOJL4GgZkNQUlbSOLhe7NJGPai8mP NRLQ== X-Gm-Message-State: AOJu0Yxhn9YK6g4VqjuVX4vphpAqymAKb6rHBrFU5aOvZj+2kmN1Qu+q ZIP81jwaGNJxve4Ya8RA8+Q= X-Google-Smtp-Source: AGHT+IEqIPBOsUlB1wwxF3Qi4U3qWKKkSBmMze/UuE021V6g65AwkgJwQ0WdcR1UOh5P0uUdgrlQow== X-Received: by 2002:a05:6808:14d3:b0:3af:9848:1590 with SMTP id f19-20020a05680814d300b003af98481590mr7307222oiw.6.1700748474849; Thu, 23 Nov 2023 06:07:54 -0800 (PST) Received: from Laptop-X1 ([43.228.180.230]) by smtp.gmail.com with ESMTPSA id s78-20020a632c51000000b00578b8fab907sm1396276pgs.73.2023.11.23.06.07.50 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 23 Nov 2023 06:07:53 -0800 (PST) Date: Thu, 23 Nov 2023 22:07:47 +0800 From: Hangbin Liu To: Jakub Kicinski Cc: netdev@vger.kernel.org, "David S . Miller" , David Ahern , Eric Dumazet , Paolo Abeni , Ido Schimmel , Nikolay Aleksandrov , Roopa Prabhu , Stephen Hemminger , Florian Westphal , Andrew Lunn , Florian Fainelli , Vladimir Oltean , Jiri Pirko , Marc Muehlfeld Subject: Re: [PATCH net-next 01/10] net: bridge: add document for IFLA_BR enum Message-ID: References: <20231117093145.1563511-1-liuhangbin@gmail.com> <20231117093145.1563511-2-liuhangbin@gmail.com> <20231118094525.75a88d09@kernel.org> <20231121082127.62a3a478@kernel.org> Precedence: bulk X-Mailing-List: netdev@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20231121082127.62a3a478@kernel.org> On Tue, Nov 21, 2023 at 08:21:27AM -0800, Jakub Kicinski wrote: > On Tue, 21 Nov 2023 11:28:30 +0800 Hangbin Liu wrote: > > Thanks for this info. Will the YAML spec be build by the document team? > > I'd prefer all the doc shows in https://www.kernel.org/doc/html/latest/ > > so users could find the doc easily. > > That's the plan, it will render under ${base}/networking/netlink_spec/ > > > It would be good if there is an example in Documentation/netlink/specs/ (when > > the patch applied) so I can take as a reference :) > > All the operations, attributes etc in the spec accept a "doc" property. > The html output is just a rendering of those doc strings. > So the existing specs are already kind of examples, although they don't > have doc strings in very many places so the output looks a bit empty :( Thanks, I will investigate how to convert the bridge yaml. But next week I will be in vacation. So I may post another patch after vacation. Regards Hangbin