aboutsummaryrefslogtreecommitdiffstats
path: root/util/README.md
diff options
context:
space:
mode:
authorAnton Samokhvalov <pg83@yandex.ru>2022-02-10 16:45:15 +0300
committerDaniil Cherednik <dcherednik@yandex-team.ru>2022-02-10 16:45:15 +0300
commit72cb13b4aff9bc9cf22e49251bc8fd143f82538f (patch)
treeda2c34829458c7d4e74bdfbdf85dff449e9e7fb8 /util/README.md
parent778e51ba091dc39e7b7fcab2b9cf4dbedfb6f2b5 (diff)
downloadydb-72cb13b4aff9bc9cf22e49251bc8fd143f82538f.tar.gz
Restoring authorship annotation for Anton Samokhvalov <pg83@yandex.ru>. Commit 1 of 2.
Diffstat (limited to 'util/README.md')
-rw-r--r--util/README.md24
1 files changed, 12 insertions, 12 deletions
diff --git a/util/README.md b/util/README.md
index 496efa633c..5b44ea3dd8 100644
--- a/util/README.md
+++ b/util/README.md
@@ -1,5 +1,5 @@
# Coding style
-
+
Style guide for the util folder is a stricter version of
[general style guide](https://docs.yandex-team.ru/arcadia-cpp/cpp_style_guide)
(mostly in terms of ambiguity resolution).
@@ -9,31 +9,31 @@ Style guide for the util folder is a stricter version of
* always use `using` not `typedef`
* even a single line block must be in braces {}:
```
- if (A) {
- B();
- }
+ if (A) {
+ B();
+ }
```
* _ at the end of private data member of a class - `First_`, `Second_`
* every .h file must be accompanied with corresponding .cpp to avoid a leakage and check that it is self contained
* prohibited to use `printf`-like functions
-
-
+
+
Things declared in the general style guide, which sometimes are missed:
-
+
* `template <`, not `template<`
* `noexcept`, not `throw ()` nor `throw()`, not required for destructors
* indents inside `namespace` same as inside `class`
-
-
+
+
Requirements for a new code (and for corrections in an old code which involves change of behaviour) in util:
-
+
* presence of UNIT-tests
* presence of comments in Doxygen style
* accessors without Get prefix (`Length()`, but not `GetLength()`)
-
+
This guide is not a mandatory as there is the general style guide.
Nevertheless if it is not followed, then a next `ya style .` run in the util folder will undeservedly update authors of some lines of code.
-
+
Thus before a commit it is recommended to run `ya style .` in the util folder.