diff options
Diffstat (limited to 'doc')
-rw-r--r-- | doc/developer-notes.md | 8 |
1 files changed, 5 insertions, 3 deletions
diff --git a/doc/developer-notes.md b/doc/developer-notes.md index b1bb7dc887..00fa0825a8 100644 --- a/doc/developer-notes.md +++ b/doc/developer-notes.md @@ -859,12 +859,12 @@ from using a different variable with the same name), please name variables so that their names do not shadow variables defined in the source code. When using nested cycles, do not name the inner cycle variable the same as in -the upper cycle, etc. +the outer cycle, etc. Threads and synchronization ---------------------------- -- Prefer `Mutex` type to `RecursiveMutex` one +- Prefer `Mutex` type to `RecursiveMutex` one. - Consistently use [Clang Thread Safety Analysis](https://clang.llvm.org/docs/ThreadSafetyAnalysis.html) annotations to get compile-time warnings about potential race conditions in code. Combine annotations in function declarations with @@ -943,6 +943,8 @@ TRY_LOCK(cs_vNodes, lockNodes); Scripts -------------------------- +Write scripts in Python rather than bash, when possible. + ### Shebang - Use `#!/usr/bin/env bash` instead of obsolete `#!/bin/bash`. @@ -1386,7 +1388,7 @@ communication: ``` - For consistency and friendliness to code generation tools, interface method - input and inout parameters should be ordered first and output parameters + input and in-out parameters should be ordered first and output parameters should come last. Example: |