[RTEMS Project] #3860: Code Formatting and Style Check for RTEMS score

[RTEMS trac]

#3860: Code Formatting and Style Check for RTEMS score
---------------------------------+----------------------------
  Reporter:  Christian Mauderer  |      Owner:  (none)
      Type:  enhancement         |     Status:  new
  Priority:  normal              |  Milestone:  Indefinite
 Component:  score               |    Version:
  Severity:  normal              |   Keywords:  SoC, ecosystem
Blocked By:                      |   Blocking:
---------------------------------+----------------------------
 == Introduction

 For the core parts of RTEMS the coding style is defined in the
 documentation (https://docs.rtems.org/branches/master/eng/coding-
 conventions.html). But there is no automatic checking. Therefore for
 people new to RTEMS it can get tricky to get it right when sending
 patches.

 == Project

 This project should improve the situation and work towards automatic
 checking for RTEMS score.

 == Tasks

 * Find a code checker or formater that can produce results that match the
 RTEMS coding conventions. Some tools have been discussed on the list or
 described in the wiki in the past. But a new tool is possible too.
 * If necessary create a configuration for the code checker (most likely it
 is necessary).
 * Make sure the tool works on all mayor development platforms for RTEMS
 (Linux, FreeBSD, Windows, MacOS).
 * If necessary: Integrate the tool into rtems-source-builder.
 * Add a build target for automatic code checking.

 == Prerequisites

 * Knowledge of C and (most likely) Python programming languages.
 * Knowledge of host software and building packages.
 * Access to test systems for the development platforms (at least two to
 three of them).

 == Possible Hurdles

 * The existing code isn't entirely consistent. Discussions are necessary
 whether these inconsistencies should be patched.
 * Maybe some style discussions will be started.

 Both points could lead to long discussions. But don't hesitate: The mentor
 of the project will help with them.

--
Ticket URL: <http://devel.rtems.org/ticket/3860>
RTEMS Project <http://www.rtems.org/>
RTEMS Project