From 524440e920df1fc0b1839178fc391c1bf7f90b3c Mon Sep 17 00:00:00 2001 From: "Tobin C. Harding" Date: Fri, 17 Aug 2018 13:55:47 +1000 Subject: [PATCH] CODING_STLYE: Remove sections implied by 'kernel style' We explicitly state that LXC uses coding style based on Linux kernel style. It is redundant to then document obvious, and well known, kernel style rules. Identifier names certainly fall into this category as does usage of braces. Remove sections implied by 'kernel style'. Naming conventions and brace placement conventions. Signed-off-by: Tobin C. Harding --- CODING_STYLE.md | 45 --------------------------------------------- 1 file changed, 45 deletions(-) diff --git a/CODING_STYLE.md b/CODING_STYLE.md index 7e1cbf326..b4c77d0c8 100644 --- a/CODING_STYLE.md +++ b/CODING_STYLE.md @@ -130,10 +130,6 @@ https://www.kernel.org/doc/html/latest/process/coding-style.html - Functions declared in header files (`*.h`) should use the `extern` keyword. - Functions declared in source files (`*.c`) should not use the `extern` keyword. -#### All Names Must Be In lower_case - -- All functions and variable names must use lower case. - #### Declaring Variables - variables should be declared at the top of the function or at the beginning @@ -177,47 +173,6 @@ https://www.kernel.org/doc/html/latest/process/coding-style.html } ``` -#### Single-line `if` blocks should not be enclosed in `{}` - -- This also affects `if-else` ladders if and only if all constituting - conditions are - single-line conditions. If there is at least one non-single-line - condition `{}` must be used. -- For example: - ```C - /* no brackets needed */ - if (size > INT_MAX) - return -EFBIG; - - /* The else branch has more than one-line and so needs {}. This entails that - * the if branch also needs to have {}. - */ - if ( errno == EROFS ) { - WARN("Warning: Read Only file system while creating %s", path); - } else { - SYSERROR("Error creating %s", path); - return -1; - } - - /* also fine */ - for (i = 0; list[i]; i++) - if (strcmp(list[i], entry) == 0) - return true; - - /* also fine */ - if (ret < 0) - WARN("Failed to set FD_CLOEXEC flag on slave fd %d of " - "pty device \"%s\": %s", pty_info->slave, - pty_info->name, strerror(errno)); - - /* also fine */ - if (ret == 0) - for (i = 0; i < sizeof(limit_opt)/sizeof(limit_opt[0]); ++i) { - if (strcmp(res, limit_opt[i].name) == 0) - return limit_opt[i].value; - } - ``` - #### Functions Not Returning Booleans Must Assign Return Value Before Performing Checks - When checking whether a function not returning booleans was successful or not -- 2.47.2