aboutsummaryrefslogtreecommitdiff
path: root/contribution.texi
diff options
context:
space:
mode:
Diffstat (limited to 'contribution.texi')
-rw-r--r--contribution.texi53
1 files changed, 53 insertions, 0 deletions
diff --git a/contribution.texi b/contribution.texi
index e7e776c..ad685af 100644
--- a/contribution.texi
+++ b/contribution.texi
@@ -1,3 +1,9 @@
+@c This document is part of Carbs Linux Documentation.
+@c See the top.texi file for LICENSE information.
+
+@c -----------------------------------------------------------------------------
+
+@c Macro Definitions
@macro contid{id}
[@anchor{\id\}\id\]
@end macro
@@ -6,6 +12,9 @@
@strong{@contid{\id\} \sect\}
@end macro
+
+@c -----------------------------------------------------------------------------
+
@node Contribution Guidelines
@chapter Contribution Guidelines
@@ -18,9 +27,21 @@ and changes may occur with good reasoning.
* Sending Git mails::
@end menu
+
+@c -----------------------------------------------------------------------------
+
@node Conventions
@section Conventions
+@menu
+* General Conventions::
+* Shell Conventions::
+* Repository Conventions::
+@end menu
+
+
+@c -----------------------------------------------------------------------------
+
@node General Conventions
@subsection General Conventions -- 00
@@ -45,6 +66,9 @@ your code goes here # Avoid this way of commenting.
@end table
@end table
+
+@c -----------------------------------------------------------------------------
+
@node Shell Conventions
@subsection Shell Conventions -- 10
@@ -82,6 +106,9 @@ test
Instead of backticks, use @verb{|$(..)|}.
@end table
+
+@c -----------------------------------------------------------------------------
+
@node Repository Conventions
@subsection Repository Conventions -- 20
@@ -136,6 +163,9 @@ The next section is about package templates that should be used in order to
ensure stylistic consistency. Note that the option configurations shouldn't be
taken literally, they are meant as examples.
+
+@c -----------------------------------------------------------------------------
+
@sectid{2210, Make}
@example
@@ -145,6 +175,9 @@ make
make DESTDIR="$1" PREFIX=/usr install
@end example
+
+@c -----------------------------------------------------------------------------
+
@sectid{2211, Configure/Make}
@example
@@ -160,6 +193,8 @@ make DESTDIR="$1" install
@end example
+@c -----------------------------------------------------------------------------
+
@sectid{2212, Autoconf/Automake}
@xref{2020}
@@ -178,6 +213,9 @@ make
make DESTDIR="$1" install
@end example
+
+@c -----------------------------------------------------------------------------
+
@sectid{2220, Meson}
@example
@@ -195,6 +233,9 @@ ninja -C output
ninja -C output install
@end example
+
+@c -----------------------------------------------------------------------------
+
@sectid{2230, Cmake}
@example
@@ -211,6 +252,9 @@ cmake --build build
cmake --install build
@end example
+
+@c -----------------------------------------------------------------------------
+
@sectid{2240, Go}
@example
@@ -224,6 +268,9 @@ go build
install -Dm755 program "$1/usr/bin/program"
@end example
+
+@c -----------------------------------------------------------------------------
+
@sectid{2241, Python}
@example
@@ -233,6 +280,9 @@ python setup.py build
python setup.py install --prefix=/usr --root="$1"
@end example
+
+@c -----------------------------------------------------------------------------
+
@node Sending Git mails
@section Sending Git mails
@@ -277,3 +327,6 @@ $ git format-patch --to=~carbslinux/dev+subscribe@@lists.sr.ht <region>
Edit those files as necessary and send them.
$ for file in *.patch; do msmtp -t -a my-mail < $patch; done
@end example
+
+
+@c -----------------------------------------------------------------------------