From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mail-vs1-xe2e.google.com (mail-vs1-xe2e.google.com [IPv6:2607:f8b0:4864:20::e2e]) by gabe.freedesktop.org (Postfix) with ESMTPS id A6D3410E090 for ; Wed, 3 Aug 2022 05:27:17 +0000 (UTC) Received: by mail-vs1-xe2e.google.com with SMTP id x125so16742324vsb.13 for ; Tue, 02 Aug 2022 22:27:17 -0700 (PDT) From: Tales Aparecida To: igt-dev@lists.freedesktop.org, Chris Wilson Date: Wed, 3 Aug 2022 02:26:52 -0300 Message-Id: <20220803052654.98827-3-tales.aparecida@gmail.com> In-Reply-To: <20220803052654.98827-1-tales.aparecida@gmail.com> References: <20220803052654.98827-1-tales.aparecida@gmail.com> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Subject: [igt-dev] [PATCH i-g-t 2/4] CONTRIBUTING: Add reference for GTKDoc List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: siqueirajordao@riseup.net, magalilemes00@gmail.com, tales.aparecida@gmail.com, Isabella Basso , andrealmeid@riseup.net, Trevor Woerner Errors-To: igt-dev-bounces@lists.freedesktop.org Sender: "igt-dev" List-ID: Add reference links about code documentation. Signed-off-by: Tales Aparecida --- CONTRIBUTING.md | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 6d1294ad..2b5a78b5 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -13,6 +13,12 @@ The Code - The code should follow kernel coding style: https://www.kernel.org/doc/html/latest/process/coding-style.html +- The in-code documentation should follow GtkDoc specifications: + https://developer-old.gnome.org/gtk-doc-manual/stable/documenting.html. + For an updated version, you can also download the GtkDoc's + [source code][gtkdoc-repo] and open its manual with `yelp` directly by typing + in a terminal: `yelp file:///absolute/path/to/gtk-doc/help/manual/C/index.docbook` + - Testcases (subtests) have to use minus signs (-) as a word separator. The generated documentation contains glossary of commonly used terms. @@ -31,6 +37,7 @@ The Code more automatic conversions. [igt-describe]: https://drm.pages.freedesktop.org/igt-gpu-tools/igt-gpu-tools-Core.html#igt-describe +[gtkdoc-repo]: https://gitlab.gnome.org/GNOME/gtk-doc Sending Patches -- 2.37.0