Noratrieb/nilstrieb-c-style-guide-edition-2
1
0
Fork 0
mirror of https://github.com/Noratrieb/nilstrieb-c-style-guide-edition-2.git synced 2026-01-14 15:25:10 +01:00
Code Issues Projects Releases Packages Wiki Activity Actions

Merge pull request #1 from OliveIsAWord/master

Browse source 
spelling and grammar
This commit is contained in:
nora 2022-08-02 07:44:20 +02:00 • committed by GitHub
commit acf99e34fd
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
2 changed files with 3 additions and 3 deletions
Download patch file Download diff file Expand all files Collapse all files

4
src/conventions.md
View file

@ -4,7 +4,7 @@ General conventions that C code should obey.
## Memory allocation ## Memory allocation
Always check the return value of `malloc`. If it is a null pointer, dereference it to immediately abort the processas as we cannot reasonable recover from OOM in most cases. If such a recovery is possible, recover instead. On some platforms, dereferencing a null pointer does _not_ abort the process. In these cases, the null pointer is a perfectly fine pointer, and just continue using it instead. Note that this derefence should usually be a volatile operation as the compiler would optimize it away otherwise. I have reported upstream issues on compilers about this, but they have not yet answered. Always check the return value of `malloc`. If it is a null pointer, dereference it to immediately abort the processas as we cannot reasonably recover from OOM in most cases. If such a recovery is possible, recover instead. On some platforms, dereferencing a null pointer does _not_ abort the process. In these cases, the null pointer is a perfectly fine pointer, and just continue using it instead. Note that this derefence should usually be a volatile operation as the compiler would optimize it away otherwise. I have reported upstream issues on compilers about this, but they have not yet answered.
If the pointer is non-null, `free` it directly after the `malloc` call. This prevents memory leaks of all sorts. Afterwards, If the pointer is non-null, `free` it directly after the `malloc` call. This prevents memory leaks of all sorts. Afterwards,
you can use it freely in your program. you can use it freely in your program.
@ -19,7 +19,7 @@ All identifiers should be given meaningful english names. To work with ancient l
## Comments ## Comments
Comments are vital to readability. Therefore, code should always be well commented. Comments must be written in the lingua franca of programming, swiss german. Comments are vital to readability. Therefore, code should always be well commented. Comments must be written in the lingua franca of programming, Swiss German.
```c ```c
int main() { int main() {

2
src/formatting.md
View file

@ -27,7 +27,7 @@ body cannot fit into a single line, make a new function instead.
## Identation ## Identation
C code must be indented with 3 spaces. The toplevel should be indented as well. C code must be indented with 3 spaces. The top-level should be indented as well.
```c ```c
#include<stdio.h> #include<stdio.h>