Commit ee72ffd0 by Ben Straub

Markdownize CONVENTIONS

parent 41b00ccc
...@@ -43,5 +43,5 @@ porting code *from* to see what you need to do. ...@@ -43,5 +43,5 @@ porting code *from* to see what you need to do.
We like to keep the source code consistent and easy to read. Maintaining this We like to keep the source code consistent and easy to read. Maintaining this
takes some discipline, but it's been more than worth it. Take a look at the takes some discipline, but it's been more than worth it. Take a look at the
[conventions file](https://github.com/libgit2/libgit2/blob/development/CONVENTIONS). [conventions file](https://github.com/libgit2/libgit2/blob/development/CONVENTIONS.md).
...@@ -14,9 +14,9 @@ Type Definitions ...@@ -14,9 +14,9 @@ Type Definitions
Most types should be opaque, e.g.: Most types should be opaque, e.g.:
---- ```C
typedef struct git_odb git_odb; typedef struct git_odb git_odb;
---- ```
with allocation functions returning an "instance" created within with allocation functions returning an "instance" created within
the library, and not within the application. This allows the type the library, and not within the application. This allows the type
...@@ -28,9 +28,9 @@ Public Exported Function Definitions ...@@ -28,9 +28,9 @@ Public Exported Function Definitions
All exported functions must be declared as: All exported functions must be declared as:
---- ```C
GIT_EXTERN(result_type) git_modulename_functionname(arg_list); GIT_EXTERN(result_type) git_modulename_functionname(arg_list);
---- ```
Semi-Private Exported Functions Semi-Private Exported Functions
...@@ -52,10 +52,10 @@ few arguments if multiple outputs are supplied). ...@@ -52,10 +52,10 @@ few arguments if multiple outputs are supplied).
int status codes are 0 for GIT_OK and < 0 for an error. int status codes are 0 for GIT_OK and < 0 for an error.
This permits common POSIX result testing: This permits common POSIX result testing:
---- ```C
if (git_odb_open(&odb, path)) if (git_odb_open(&odb, path))
abort("odb open failed"); abort("odb open failed");
---- ```
Functions returning a pointer may return NULL instead of an int Functions returning a pointer may return NULL instead of an int
if there is only one type of failure (GIT_ENOMEM). if there is only one type of failure (GIT_ENOMEM).
...@@ -84,7 +84,7 @@ All public headers defining types, functions or macros must use ...@@ -84,7 +84,7 @@ All public headers defining types, functions or macros must use
the following form, where ${filename} is the name of the file, the following form, where ${filename} is the name of the file,
after replacing non-identifier characters with '_'. after replacing non-identifier characters with '_'.
---- ```C
#ifndef INCLUDE_git_${filename}_h__ #ifndef INCLUDE_git_${filename}_h__
#define INCLUDE_git_${filename}_h__ #define INCLUDE_git_${filename}_h__
...@@ -104,4 +104,4 @@ after replacing non-identifier characters with '_'. ...@@ -104,4 +104,4 @@ after replacing non-identifier characters with '_'.
/** @} */ /** @} */
GIT_END_DECL GIT_END_DECL
#endif #endif
---- ```
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment