From be62df7fc72b02f7a7c5a4c513299458b45374f5 Mon Sep 17 00:00:00 2001 From: John Ericson Date: Mon, 8 Apr 2024 10:38:11 -0400 Subject: [PATCH] Add a few more notes to the style guide - Mention 2 space indent seems to be the most idiomatic - Mention trailing commas are good - Update example to use trailing commas --- docs/markdown/Style-guide.md | 12 ++++++++---- 1 file changed, 8 insertions(+), 4 deletions(-) diff --git a/docs/markdown/Style-guide.md b/docs/markdown/Style-guide.md index f204a9a7055e..da827c9baff0 100644 --- a/docs/markdown/Style-guide.md +++ b/docs/markdown/Style-guide.md @@ -9,7 +9,11 @@ Meson build files. ## Tabs or spaces? -Always spaces. +Always spaces. Two spaces is the most common. + +## Trailing commas? + +Yes, where possible. They help make nicer diffs in version control systems. ## Naming Variable @@ -70,7 +74,7 @@ normal files. This rule also applies recursively for subdirectories. The following example shows correct source list definition: ```meson -sources = files([ +sources = files( 'aaa/a1.c', 'aaa/a2.c', 'bbb/subdir1/b1.c', @@ -82,6 +86,6 @@ sources = files([ 'f1.c', 'f2.c', 'f10.c', - 'f20.c' -]) + 'f20.c', +) ```