wuggy/Dactyloidae
wuggy/Dactyloidae
1
0
Fork 0
mirror of https://repo.dactyloidae.xyz/Dactyloidae/UXP.git synced 2026-10-23 23:57:31 +09:00
Code Issues Projects Releases Packages Wiki Activity

Update UXP Coding Style guideline document (WIP)

Browse source
This commit is contained in:
wolfbeast 2019-01-02 12:42:56 +01:00 • committed by Roy Tam
commit 0e379c7aef
1 changed files with 32 additions and 9 deletions
Download patch file Download diff file Expand all files Collapse all files

41
docs/UXP Coding Style.md
View file

@ -58,14 +58,14 @@ Applies to `*.c`, `*.cc`, `*.cpp` and `*.h`. Potentially also `*.mm` for Mac cod
int * myvar; int * myvar;
int *myvar1, *myvar2; int *myvar1, *myvar2;
int* myvar1, *myvar2; int* myvar1, *myvar2;
int* myvar1, myvar2; //myvar2 isn't a pointer. use separate lines! int* myvar1, myvar2; //myvar2 isn't a pointer!
``` ```
CORRECT: CORRECT:
```C++ ```C++
char* somePointer; char* somePointer;
int* myvar1; int* myvar1;
int* myvar2; int* myvar2;
function a(char *somePointer) [...] function a(char* somePointer) [...]
myString = *somePointer; myString = *somePointer;
myPointer = &myString; myPointer = &myString;
``` ```
@ -85,6 +85,23 @@ if (something == somethingelse) {
} else { } else {
false_case_code here; false_case_code here;
} }
if (case1) {
case1_code here;
} else if (case2) {
case2_code here;
} else {
other_case_code here;
}
if (case1) {
case1_code here;
} else {
if (case2) {
case2_code here;
}
case2_and_other_code here;
}
``` ```
#### for #### for
`for` loop example: `for` loop example:
@ -125,8 +142,8 @@ switch (variable) {
### Classes ### Classes
Classes have some special formatting rules applied to them: Classes have some special formatting rules applied to them:
- Classes follow the following sequence: CTOR, DTOR, methods, variables - Classes follow the following sequence: CTOR, DTOR, methods, variables
- Class CTOR variable initializers are listed one-per-line with a leading comma (or colon for the first). - Class CTOR variable initializers (in lieu of assignments in the CTOR body) are listed one-per-line with a leading comma (or colon for the first).
- `public`, `private` and `protected` keywords are not indented and are at the same level as the class identifier statement. - `public`, `private` and `protected` keywords are not indented and are at the same indentation level as the class identifier statement.
Example class definition: Example class definition:
```C++ ```C++
@ -176,7 +193,7 @@ private:
nsCOMPtr<EventTarget> mRelatedTarget; nsCOMPtr<EventTarget> mRelatedTarget;
}; };
``` ```
### Splitting overly-long lines ### Long line wrapping
If statements on a single line become overly long, they should be split into multiple lines: If statements on a single line become overly long, they should be split into multiple lines:
- Binary operators (including ternary) must be left on their original lines if the line break happens around the operator. The second line should start in the same column as the start of the expression in the first line. - Binary operators (including ternary) must be left on their original lines if the line break happens around the operator. The second line should start in the same column as the start of the expression in the first line.
- Lists of variables (e.g. when calling or declaring a function) should be split so variables are listed one-per-line, where second and subsequent lines start in the same column as the first variable listed, even if more than one variable would fit on the line segment until the wrapping column. - Lists of variables (e.g. when calling or declaring a function) should be split so variables are listed one-per-line, where second and subsequent lines start in the same column as the first variable listed, even if more than one variable would fit on the line segment until the wrapping column.
@ -189,6 +206,8 @@ somelongnamespace::somelongfunction(
var1, var2, var3, var4, var5); var1, var2, var3, var4, var5);
if (somelongvariable == somelongothervariable if (somelongvariable == somelongothervariable
|| somelongvariable2 == somelongothervariable2) { || somelongvariable2 == somelongothervariable2) {
somelongvariable = somelongexpression ? somevalue1
: somevalue2;
``` ```
CORRECT: CORRECT:
```C++ ```C++
@ -199,6 +218,9 @@ somelongnamespace::somelongfunction(var1,
var5); var5);
if (somelongvariable == somelongothervariable || if (somelongvariable == somelongothervariable ||
somelongvariable2 == somelongothervariable2) { somelongvariable2 == somelongothervariable2) {
somelongvariable = somelongexpression ?
somevalue1 :
somevalue2;
``` ```
## JavaScript ## JavaScript
@ -209,8 +231,9 @@ Applies to `*.xul`, `*.html`, `*.xhtml`.
Applies to `*.idl`, `*.xpidl` and `*.webidl`. Applies to `*.idl`, `*.xpidl` and `*.webidl`.
<!--stackedit_data: <!--stackedit_data:
eyJoaXN0b3J5IjpbODM0NjI2MDQ5LC0xOTAzMjcxOTk2LC0xMD eyJoaXN0b3J5IjpbMjUzODYzMzMsMjg5MjUwODIsLTQzMjMzNz
EyMDI3NzgzLC0xODM4MzgzOTAyLDgwOTIxMzUxMiwtNTM4NDIz ExMSw4MzQ2MjYwNDksLTE5MDMyNzE5OTYsLTEwMTIwMjc3ODMs
ODAwLDM4MjYyNzQ2MywyMDg2MDIyMDg1LC0xNTI1OTIxNjIyLC LTE4MzgzODM5MDIsODA5MjEzNTEyLC01Mzg0MjM4MDAsMzgyNj
02NTkzMzEwNDAsLTc0MDkxOTA0NSwxODY3NTU0MTQyXX0= I3NDYzLDIwODYwMjIwODUsLTE1MjU5MjE2MjIsLTY1OTMzMTA0
MCwtNzQwOTE5MDQ1LDE4Njc1NTQxNDJdfQ==
--> -->