diff options
69 files changed, 2070 insertions, 156 deletions
diff --git a/docs/docs/0010.html b/docs/docs/0010.html index c11c42c..4547016 100644 --- a/docs/docs/0010.html +++ b/docs/docs/0010.html @@ -33,11 +33,11 @@ ul.no-bullet {list-style: none} --> </style> -<meta http-equiv="Refresh" content="0; url=Conventions.html#g_t0010"> +<meta http-equiv="Refresh" content="0; url=General-Conventions.html#g_t0010"> </head> <body lang="en"> -<p>The node you are looking for is at <a href="Conventions.html#g_t0010">0010</a>.</p> +<p>The node you are looking for is at <a href="General-Conventions.html#g_t0010">0010</a>.</p> </body> diff --git a/docs/docs/0011.html b/docs/docs/0011.html index c8e9a20..5bfb360 100644 --- a/docs/docs/0011.html +++ b/docs/docs/0011.html @@ -33,11 +33,11 @@ ul.no-bullet {list-style: none} --> </style> -<meta http-equiv="Refresh" content="0; url=Conventions.html#g_t0011"> +<meta http-equiv="Refresh" content="0; url=General-Conventions.html#g_t0011"> </head> <body lang="en"> -<p>The node you are looking for is at <a href="Conventions.html#g_t0011">0011</a>.</p> +<p>The node you are looking for is at <a href="General-Conventions.html#g_t0011">0011</a>.</p> </body> diff --git a/docs/docs/0012.html b/docs/docs/0012.html index 39b6015..faeff7f 100644 --- a/docs/docs/0012.html +++ b/docs/docs/0012.html @@ -33,11 +33,11 @@ ul.no-bullet {list-style: none} --> </style> -<meta http-equiv="Refresh" content="0; url=Conventions.html#g_t0012"> +<meta http-equiv="Refresh" content="0; url=General-Conventions.html#g_t0012"> </head> <body lang="en"> -<p>The node you are looking for is at <a href="Conventions.html#g_t0012">0012</a>.</p> +<p>The node you are looking for is at <a href="General-Conventions.html#g_t0012">0012</a>.</p> </body> diff --git a/docs/docs/0013.html b/docs/docs/0013.html index 483f1b2..a5b5957 100644 --- a/docs/docs/0013.html +++ b/docs/docs/0013.html @@ -33,11 +33,11 @@ ul.no-bullet {list-style: none} --> </style> -<meta http-equiv="Refresh" content="0; url=Conventions.html#g_t0013"> +<meta http-equiv="Refresh" content="0; url=General-Conventions.html#g_t0013"> </head> <body lang="en"> -<p>The node you are looking for is at <a href="Conventions.html#g_t0013">0013</a>.</p> +<p>The node you are looking for is at <a href="General-Conventions.html#g_t0013">0013</a>.</p> </body> diff --git a/docs/docs/1010.html b/docs/docs/1010.html index 80fd2d9..0d8c219 100644 --- a/docs/docs/1010.html +++ b/docs/docs/1010.html @@ -33,11 +33,11 @@ ul.no-bullet {list-style: none} --> </style> -<meta http-equiv="Refresh" content="0; url=Conventions.html#g_t1010"> +<meta http-equiv="Refresh" content="0; url=Shell-Conventions.html#g_t1010"> </head> <body lang="en"> -<p>The node you are looking for is at <a href="Conventions.html#g_t1010">1010</a>.</p> +<p>The node you are looking for is at <a href="Shell-Conventions.html#g_t1010">1010</a>.</p> </body> diff --git a/docs/docs/1020.html b/docs/docs/1020.html index dc08d81..c003ed0 100644 --- a/docs/docs/1020.html +++ b/docs/docs/1020.html @@ -33,11 +33,11 @@ ul.no-bullet {list-style: none} --> </style> -<meta http-equiv="Refresh" content="0; url=Conventions.html#g_t1020"> +<meta http-equiv="Refresh" content="0; url=Shell-Conventions.html#g_t1020"> </head> <body lang="en"> -<p>The node you are looking for is at <a href="Conventions.html#g_t1020">1020</a>.</p> +<p>The node you are looking for is at <a href="Shell-Conventions.html#g_t1020">1020</a>.</p> </body> diff --git a/docs/docs/1030.html b/docs/docs/1030.html index f4fd1ff..8e23c32 100644 --- a/docs/docs/1030.html +++ b/docs/docs/1030.html @@ -33,11 +33,11 @@ ul.no-bullet {list-style: none} --> </style> -<meta http-equiv="Refresh" content="0; url=Conventions.html#g_t1030"> +<meta http-equiv="Refresh" content="0; url=Shell-Conventions.html#g_t1030"> </head> <body lang="en"> -<p>The node you are looking for is at <a href="Conventions.html#g_t1030">1030</a>.</p> +<p>The node you are looking for is at <a href="Shell-Conventions.html#g_t1030">1030</a>.</p> </body> diff --git a/docs/docs/1040.html b/docs/docs/1040.html index c42eff1..eb80fab 100644 --- a/docs/docs/1040.html +++ b/docs/docs/1040.html @@ -33,11 +33,11 @@ ul.no-bullet {list-style: none} --> </style> -<meta http-equiv="Refresh" content="0; url=Conventions.html#g_t1040"> +<meta http-equiv="Refresh" content="0; url=Shell-Conventions.html#g_t1040"> </head> <body lang="en"> -<p>The node you are looking for is at <a href="Conventions.html#g_t1040">1040</a>.</p> +<p>The node you are looking for is at <a href="Shell-Conventions.html#g_t1040">1040</a>.</p> </body> diff --git a/docs/docs/1041.html b/docs/docs/1041.html index 61beac5..6dab115 100644 --- a/docs/docs/1041.html +++ b/docs/docs/1041.html @@ -33,11 +33,11 @@ ul.no-bullet {list-style: none} --> </style> -<meta http-equiv="Refresh" content="0; url=Conventions.html#g_t1041"> +<meta http-equiv="Refresh" content="0; url=Shell-Conventions.html#g_t1041"> </head> <body lang="en"> -<p>The node you are looking for is at <a href="Conventions.html#g_t1041">1041</a>.</p> +<p>The node you are looking for is at <a href="Shell-Conventions.html#g_t1041">1041</a>.</p> </body> diff --git a/docs/docs/1042.html b/docs/docs/1042.html index ac625f2..a6e26a9 100644 --- a/docs/docs/1042.html +++ b/docs/docs/1042.html @@ -33,11 +33,11 @@ ul.no-bullet {list-style: none} --> </style> -<meta http-equiv="Refresh" content="0; url=Conventions.html#g_t1042"> +<meta http-equiv="Refresh" content="0; url=Shell-Conventions.html#g_t1042"> </head> <body lang="en"> -<p>The node you are looking for is at <a href="Conventions.html#g_t1042">1042</a>.</p> +<p>The node you are looking for is at <a href="Shell-Conventions.html#g_t1042">1042</a>.</p> </body> diff --git a/docs/docs/1043.html b/docs/docs/1043.html index d293a4e..5105a21 100644 --- a/docs/docs/1043.html +++ b/docs/docs/1043.html @@ -33,11 +33,11 @@ ul.no-bullet {list-style: none} --> </style> -<meta http-equiv="Refresh" content="0; url=Conventions.html#g_t1043"> +<meta http-equiv="Refresh" content="0; url=Shell-Conventions.html#g_t1043"> </head> <body lang="en"> -<p>The node you are looking for is at <a href="Conventions.html#g_t1043">1043</a>.</p> +<p>The node you are looking for is at <a href="Shell-Conventions.html#g_t1043">1043</a>.</p> </body> diff --git a/docs/docs/1050.html b/docs/docs/1050.html index 7422d14..4b3a5ec 100644 --- a/docs/docs/1050.html +++ b/docs/docs/1050.html @@ -33,11 +33,11 @@ ul.no-bullet {list-style: none} --> </style> -<meta http-equiv="Refresh" content="0; url=Conventions.html#g_t1050"> +<meta http-equiv="Refresh" content="0; url=Shell-Conventions.html#g_t1050"> </head> <body lang="en"> -<p>The node you are looking for is at <a href="Conventions.html#g_t1050">1050</a>.</p> +<p>The node you are looking for is at <a href="Shell-Conventions.html#g_t1050">1050</a>.</p> </body> diff --git a/docs/docs/2010.html b/docs/docs/2010.html new file mode 100644 index 0000000..02f5170 --- /dev/null +++ b/docs/docs/2010.html @@ -0,0 +1,43 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> +<html> +<!-- Copyright (C) 2020 Cem Keylan + +Licensed under Gnu Free Documentation License. --> +<!-- Created by GNU Texinfo 6.7, http://www.gnu.org/software/texinfo/ --> +<!-- This file redirects to the location of a node or anchor --> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> +<title>2010 (Carbs Linux User Manual)</title> + +<meta name="description" content="2010 (Carbs Linux User Manual)"> +<meta name="keywords" content="2010 (Carbs Linux User Manual)"> +<meta name="resource-type" content="document"> +<meta name="distribution" content="global"> +<meta name="Generator" content="makeinfo"> +<style type="text/css"> +<!-- +a.summary-letter {text-decoration: none} +blockquote.indentedblock {margin-right: 0em} +div.display {margin-left: 3.2em} +div.example {margin-left: 3.2em} +div.lisp {margin-left: 3.2em} +kbd {font-style: oblique} +pre.display {font-family: inherit} +pre.format {font-family: inherit} +pre.menu-comment {font-family: serif} +pre.menu-preformatted {font-family: serif} +span.nolinebreak {white-space: nowrap} +span.roman {font-family: initial; font-weight: normal} +span.sansserif {font-family: sans-serif; font-weight: normal} +ul.no-bullet {list-style: none} +--> +</style> + +<meta http-equiv="Refresh" content="0; url=Repository-Conventions.html#g_t2010"> + +</head> + +<body lang="en"> + +<p>The node you are looking for is at <a href="Repository-Conventions.html#g_t2010">2010</a>.</p> +</body> diff --git a/docs/docs/2020.html b/docs/docs/2020.html new file mode 100644 index 0000000..0162983 --- /dev/null +++ b/docs/docs/2020.html @@ -0,0 +1,43 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> +<html> +<!-- Copyright (C) 2020 Cem Keylan + +Licensed under Gnu Free Documentation License. --> +<!-- Created by GNU Texinfo 6.7, http://www.gnu.org/software/texinfo/ --> +<!-- This file redirects to the location of a node or anchor --> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> +<title>2020 (Carbs Linux User Manual)</title> + +<meta name="description" content="2020 (Carbs Linux User Manual)"> +<meta name="keywords" content="2020 (Carbs Linux User Manual)"> +<meta name="resource-type" content="document"> +<meta name="distribution" content="global"> +<meta name="Generator" content="makeinfo"> +<style type="text/css"> +<!-- +a.summary-letter {text-decoration: none} +blockquote.indentedblock {margin-right: 0em} +div.display {margin-left: 3.2em} +div.example {margin-left: 3.2em} +div.lisp {margin-left: 3.2em} +kbd {font-style: oblique} +pre.display {font-family: inherit} +pre.format {font-family: inherit} +pre.menu-comment {font-family: serif} +pre.menu-preformatted {font-family: serif} +span.nolinebreak {white-space: nowrap} +span.roman {font-family: initial; font-weight: normal} +span.sansserif {font-family: sans-serif; font-weight: normal} +ul.no-bullet {list-style: none} +--> +</style> + +<meta http-equiv="Refresh" content="0; url=Repository-Conventions.html#g_t2020"> + +</head> + +<body lang="en"> + +<p>The node you are looking for is at <a href="Repository-Conventions.html#g_t2020">2020</a>.</p> +</body> diff --git a/docs/docs/2030.html b/docs/docs/2030.html new file mode 100644 index 0000000..82e6284 --- /dev/null +++ b/docs/docs/2030.html @@ -0,0 +1,43 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> +<html> +<!-- Copyright (C) 2020 Cem Keylan + +Licensed under Gnu Free Documentation License. --> +<!-- Created by GNU Texinfo 6.7, http://www.gnu.org/software/texinfo/ --> +<!-- This file redirects to the location of a node or anchor --> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> +<title>2030 (Carbs Linux User Manual)</title> + +<meta name="description" content="2030 (Carbs Linux User Manual)"> +<meta name="keywords" content="2030 (Carbs Linux User Manual)"> +<meta name="resource-type" content="document"> +<meta name="distribution" content="global"> +<meta name="Generator" content="makeinfo"> +<style type="text/css"> +<!-- +a.summary-letter {text-decoration: none} +blockquote.indentedblock {margin-right: 0em} +div.display {margin-left: 3.2em} +div.example {margin-left: 3.2em} +div.lisp {margin-left: 3.2em} +kbd {font-style: oblique} +pre.display {font-family: inherit} +pre.format {font-family: inherit} +pre.menu-comment {font-family: serif} +pre.menu-preformatted {font-family: serif} +span.nolinebreak {white-space: nowrap} +span.roman {font-family: initial; font-weight: normal} +span.sansserif {font-family: sans-serif; font-weight: normal} +ul.no-bullet {list-style: none} +--> +</style> + +<meta http-equiv="Refresh" content="0; url=Repository-Conventions.html#g_t2030"> + +</head> + +<body lang="en"> + +<p>The node you are looking for is at <a href="Repository-Conventions.html#g_t2030">2030</a>.</p> +</body> diff --git a/docs/docs/2040.html b/docs/docs/2040.html new file mode 100644 index 0000000..51bd56e --- /dev/null +++ b/docs/docs/2040.html @@ -0,0 +1,43 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> +<html> +<!-- Copyright (C) 2020 Cem Keylan + +Licensed under Gnu Free Documentation License. --> +<!-- Created by GNU Texinfo 6.7, http://www.gnu.org/software/texinfo/ --> +<!-- This file redirects to the location of a node or anchor --> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> +<title>2040 (Carbs Linux User Manual)</title> + +<meta name="description" content="2040 (Carbs Linux User Manual)"> +<meta name="keywords" content="2040 (Carbs Linux User Manual)"> +<meta name="resource-type" content="document"> +<meta name="distribution" content="global"> +<meta name="Generator" content="makeinfo"> +<style type="text/css"> +<!-- +a.summary-letter {text-decoration: none} +blockquote.indentedblock {margin-right: 0em} +div.display {margin-left: 3.2em} +div.example {margin-left: 3.2em} +div.lisp {margin-left: 3.2em} +kbd {font-style: oblique} +pre.display {font-family: inherit} +pre.format {font-family: inherit} +pre.menu-comment {font-family: serif} +pre.menu-preformatted {font-family: serif} +span.nolinebreak {white-space: nowrap} +span.roman {font-family: initial; font-weight: normal} +span.sansserif {font-family: sans-serif; font-weight: normal} +ul.no-bullet {list-style: none} +--> +</style> + +<meta http-equiv="Refresh" content="0; url=Repository-Conventions.html#g_t2040"> + +</head> + +<body lang="en"> + +<p>The node you are looking for is at <a href="Repository-Conventions.html#g_t2040">2040</a>.</p> +</body> diff --git a/docs/docs/2050.html b/docs/docs/2050.html new file mode 100644 index 0000000..d7628b2 --- /dev/null +++ b/docs/docs/2050.html @@ -0,0 +1,43 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> +<html> +<!-- Copyright (C) 2020 Cem Keylan + +Licensed under Gnu Free Documentation License. --> +<!-- Created by GNU Texinfo 6.7, http://www.gnu.org/software/texinfo/ --> +<!-- This file redirects to the location of a node or anchor --> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> +<title>2050 (Carbs Linux User Manual)</title> + +<meta name="description" content="2050 (Carbs Linux User Manual)"> +<meta name="keywords" content="2050 (Carbs Linux User Manual)"> +<meta name="resource-type" content="document"> +<meta name="distribution" content="global"> +<meta name="Generator" content="makeinfo"> +<style type="text/css"> +<!-- +a.summary-letter {text-decoration: none} +blockquote.indentedblock {margin-right: 0em} +div.display {margin-left: 3.2em} +div.example {margin-left: 3.2em} +div.lisp {margin-left: 3.2em} +kbd {font-style: oblique} +pre.display {font-family: inherit} +pre.format {font-family: inherit} +pre.menu-comment {font-family: serif} +pre.menu-preformatted {font-family: serif} +span.nolinebreak {white-space: nowrap} +span.roman {font-family: initial; font-weight: normal} +span.sansserif {font-family: sans-serif; font-weight: normal} +ul.no-bullet {list-style: none} +--> +</style> + +<meta http-equiv="Refresh" content="0; url=Repository-Conventions.html#g_t2050"> + +</head> + +<body lang="en"> + +<p>The node you are looking for is at <a href="Repository-Conventions.html#g_t2050">2050</a>.</p> +</body> diff --git a/docs/docs/2210.html b/docs/docs/2210.html new file mode 100644 index 0000000..29009ab --- /dev/null +++ b/docs/docs/2210.html @@ -0,0 +1,43 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> +<html> +<!-- Copyright (C) 2020 Cem Keylan + +Licensed under Gnu Free Documentation License. --> +<!-- Created by GNU Texinfo 6.7, http://www.gnu.org/software/texinfo/ --> +<!-- This file redirects to the location of a node or anchor --> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> +<title>2210 (Carbs Linux User Manual)</title> + +<meta name="description" content="2210 (Carbs Linux User Manual)"> +<meta name="keywords" content="2210 (Carbs Linux User Manual)"> +<meta name="resource-type" content="document"> +<meta name="distribution" content="global"> +<meta name="Generator" content="makeinfo"> +<style type="text/css"> +<!-- +a.summary-letter {text-decoration: none} +blockquote.indentedblock {margin-right: 0em} +div.display {margin-left: 3.2em} +div.example {margin-left: 3.2em} +div.lisp {margin-left: 3.2em} +kbd {font-style: oblique} +pre.display {font-family: inherit} +pre.format {font-family: inherit} +pre.menu-comment {font-family: serif} +pre.menu-preformatted {font-family: serif} +span.nolinebreak {white-space: nowrap} +span.roman {font-family: initial; font-weight: normal} +span.sansserif {font-family: sans-serif; font-weight: normal} +ul.no-bullet {list-style: none} +--> +</style> + +<meta http-equiv="Refresh" content="0; url=Repository-Conventions.html#g_t2210"> + +</head> + +<body lang="en"> + +<p>The node you are looking for is at <a href="Repository-Conventions.html#g_t2210">2210</a>.</p> +</body> diff --git a/docs/docs/2211.html b/docs/docs/2211.html new file mode 100644 index 0000000..a4a85e3 --- /dev/null +++ b/docs/docs/2211.html @@ -0,0 +1,43 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> +<html> +<!-- Copyright (C) 2020 Cem Keylan + +Licensed under Gnu Free Documentation License. --> +<!-- Created by GNU Texinfo 6.7, http://www.gnu.org/software/texinfo/ --> +<!-- This file redirects to the location of a node or anchor --> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> +<title>2211 (Carbs Linux User Manual)</title> + +<meta name="description" content="2211 (Carbs Linux User Manual)"> +<meta name="keywords" content="2211 (Carbs Linux User Manual)"> +<meta name="resource-type" content="document"> +<meta name="distribution" content="global"> +<meta name="Generator" content="makeinfo"> +<style type="text/css"> +<!-- +a.summary-letter {text-decoration: none} +blockquote.indentedblock {margin-right: 0em} +div.display {margin-left: 3.2em} +div.example {margin-left: 3.2em} +div.lisp {margin-left: 3.2em} +kbd {font-style: oblique} +pre.display {font-family: inherit} +pre.format {font-family: inherit} +pre.menu-comment {font-family: serif} +pre.menu-preformatted {font-family: serif} +span.nolinebreak {white-space: nowrap} +span.roman {font-family: initial; font-weight: normal} +span.sansserif {font-family: sans-serif; font-weight: normal} +ul.no-bullet {list-style: none} +--> +</style> + +<meta http-equiv="Refresh" content="0; url=Repository-Conventions.html#g_t2211"> + +</head> + +<body lang="en"> + +<p>The node you are looking for is at <a href="Repository-Conventions.html#g_t2211">2211</a>.</p> +</body> diff --git a/docs/docs/2212.html b/docs/docs/2212.html new file mode 100644 index 0000000..171c2c6 --- /dev/null +++ b/docs/docs/2212.html @@ -0,0 +1,43 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> +<html> +<!-- Copyright (C) 2020 Cem Keylan + +Licensed under Gnu Free Documentation License. --> +<!-- Created by GNU Texinfo 6.7, http://www.gnu.org/software/texinfo/ --> +<!-- This file redirects to the location of a node or anchor --> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> +<title>2212 (Carbs Linux User Manual)</title> + +<meta name="description" content="2212 (Carbs Linux User Manual)"> +<meta name="keywords" content="2212 (Carbs Linux User Manual)"> +<meta name="resource-type" content="document"> +<meta name="distribution" content="global"> +<meta name="Generator" content="makeinfo"> +<style type="text/css"> +<!-- +a.summary-letter {text-decoration: none} +blockquote.indentedblock {margin-right: 0em} +div.display {margin-left: 3.2em} +div.example {margin-left: 3.2em} +div.lisp {margin-left: 3.2em} +kbd {font-style: oblique} +pre.display {font-family: inherit} +pre.format {font-family: inherit} +pre.menu-comment {font-family: serif} +pre.menu-preformatted {font-family: serif} +span.nolinebreak {white-space: nowrap} +span.roman {font-family: initial; font-weight: normal} +span.sansserif {font-family: sans-serif; font-weight: normal} +ul.no-bullet {list-style: none} +--> +</style> + +<meta http-equiv="Refresh" content="0; url=Repository-Conventions.html#g_t2212"> + +</head> + +<body lang="en"> + +<p>The node you are looking for is at <a href="Repository-Conventions.html#g_t2212">2212</a>.</p> +</body> diff --git a/docs/docs/2220.html b/docs/docs/2220.html new file mode 100644 index 0000000..58fd3f9 --- /dev/null +++ b/docs/docs/2220.html @@ -0,0 +1,43 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> +<html> +<!-- Copyright (C) 2020 Cem Keylan + +Licensed under Gnu Free Documentation License. --> +<!-- Created by GNU Texinfo 6.7, http://www.gnu.org/software/texinfo/ --> +<!-- This file redirects to the location of a node or anchor --> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> +<title>2220 (Carbs Linux User Manual)</title> + +<meta name="description" content="2220 (Carbs Linux User Manual)"> +<meta name="keywords" content="2220 (Carbs Linux User Manual)"> +<meta name="resource-type" content="document"> +<meta name="distribution" content="global"> +<meta name="Generator" content="makeinfo"> +<style type="text/css"> +<!-- +a.summary-letter {text-decoration: none} +blockquote.indentedblock {margin-right: 0em} +div.display {margin-left: 3.2em} +div.example {margin-left: 3.2em} +div.lisp {margin-left: 3.2em} +kbd {font-style: oblique} +pre.display {font-family: inherit} +pre.format {font-family: inherit} +pre.menu-comment {font-family: serif} +pre.menu-preformatted {font-family: serif} +span.nolinebreak {white-space: nowrap} +span.roman {font-family: initial; font-weight: normal} +span.sansserif {font-family: sans-serif; font-weight: normal} +ul.no-bullet {list-style: none} +--> +</style> + +<meta http-equiv="Refresh" content="0; url=Repository-Conventions.html#g_t2220"> + +</head> + +<body lang="en"> + +<p>The node you are looking for is at <a href="Repository-Conventions.html#g_t2220">2220</a>.</p> +</body> diff --git a/docs/docs/2230.html b/docs/docs/2230.html new file mode 100644 index 0000000..42c9004 --- /dev/null +++ b/docs/docs/2230.html @@ -0,0 +1,43 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> +<html> +<!-- Copyright (C) 2020 Cem Keylan + +Licensed under Gnu Free Documentation License. --> +<!-- Created by GNU Texinfo 6.7, http://www.gnu.org/software/texinfo/ --> +<!-- This file redirects to the location of a node or anchor --> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> +<title>2230 (Carbs Linux User Manual)</title> + +<meta name="description" content="2230 (Carbs Linux User Manual)"> +<meta name="keywords" content="2230 (Carbs Linux User Manual)"> +<meta name="resource-type" content="document"> +<meta name="distribution" content="global"> +<meta name="Generator" content="makeinfo"> +<style type="text/css"> +<!-- +a.summary-letter {text-decoration: none} +blockquote.indentedblock {margin-right: 0em} +div.display {margin-left: 3.2em} +div.example {margin-left: 3.2em} +div.lisp {margin-left: 3.2em} +kbd {font-style: oblique} +pre.display {font-family: inherit} +pre.format {font-family: inherit} +pre.menu-comment {font-family: serif} +pre.menu-preformatted {font-family: serif} +span.nolinebreak {white-space: nowrap} +span.roman {font-family: initial; font-weight: normal} +span.sansserif {font-family: sans-serif; font-weight: normal} +ul.no-bullet {list-style: none} +--> +</style> + +<meta http-equiv="Refresh" content="0; url=Repository-Conventions.html#g_t2230"> + +</head> + +<body lang="en"> + +<p>The node you are looking for is at <a href="Repository-Conventions.html#g_t2230">2230</a>.</p> +</body> diff --git a/docs/docs/2240.html b/docs/docs/2240.html new file mode 100644 index 0000000..4417ca4 --- /dev/null +++ b/docs/docs/2240.html @@ -0,0 +1,43 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> +<html> +<!-- Copyright (C) 2020 Cem Keylan + +Licensed under Gnu Free Documentation License. --> +<!-- Created by GNU Texinfo 6.7, http://www.gnu.org/software/texinfo/ --> +<!-- This file redirects to the location of a node or anchor --> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> +<title>2240 (Carbs Linux User Manual)</title> + +<meta name="description" content="2240 (Carbs Linux User Manual)"> +<meta name="keywords" content="2240 (Carbs Linux User Manual)"> +<meta name="resource-type" content="document"> +<meta name="distribution" content="global"> +<meta name="Generator" content="makeinfo"> +<style type="text/css"> +<!-- +a.summary-letter {text-decoration: none} +blockquote.indentedblock {margin-right: 0em} +div.display {margin-left: 3.2em} +div.example {margin-left: 3.2em} +div.lisp {margin-left: 3.2em} +kbd {font-style: oblique} +pre.display {font-family: inherit} +pre.format {font-family: inherit} +pre.menu-comment {font-family: serif} +pre.menu-preformatted {font-family: serif} +span.nolinebreak {white-space: nowrap} +span.roman {font-family: initial; font-weight: normal} +span.sansserif {font-family: sans-serif; font-weight: normal} +ul.no-bullet {list-style: none} +--> +</style> + +<meta http-equiv="Refresh" content="0; url=Repository-Conventions.html#g_t2240"> + +</head> + +<body lang="en"> + +<p>The node you are looking for is at <a href="Repository-Conventions.html#g_t2240">2240</a>.</p> +</body> diff --git a/docs/docs/2241.html b/docs/docs/2241.html new file mode 100644 index 0000000..6cb5a09 --- /dev/null +++ b/docs/docs/2241.html @@ -0,0 +1,43 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> +<html> +<!-- Copyright (C) 2020 Cem Keylan + +Licensed under Gnu Free Documentation License. --> +<!-- Created by GNU Texinfo 6.7, http://www.gnu.org/software/texinfo/ --> +<!-- This file redirects to the location of a node or anchor --> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> +<title>2241 (Carbs Linux User Manual)</title> + +<meta name="description" content="2241 (Carbs Linux User Manual)"> +<meta name="keywords" content="2241 (Carbs Linux User Manual)"> +<meta name="resource-type" content="document"> +<meta name="distribution" content="global"> +<meta name="Generator" content="makeinfo"> +<style type="text/css"> +<!-- +a.summary-letter {text-decoration: none} +blockquote.indentedblock {margin-right: 0em} +div.display {margin-left: 3.2em} +div.example {margin-left: 3.2em} +div.lisp {margin-left: 3.2em} +kbd {font-style: oblique} +pre.display {font-family: inherit} +pre.format {font-family: inherit} +pre.menu-comment {font-family: serif} +pre.menu-preformatted {font-family: serif} +span.nolinebreak {white-space: nowrap} +span.roman {font-family: initial; font-weight: normal} +span.sansserif {font-family: sans-serif; font-weight: normal} +ul.no-bullet {list-style: none} +--> +</style> + +<meta http-equiv="Refresh" content="0; url=Repository-Conventions.html#g_t2241"> + +</head> + +<body lang="en"> + +<p>The node you are looking for is at <a href="Repository-Conventions.html#g_t2241">2241</a>.</p> +</body> diff --git a/docs/docs/Contribution-Guidelines.html b/docs/docs/Contribution-Guidelines.html index 986da28..f11356d 100644 --- a/docs/docs/Contribution-Guidelines.html +++ b/docs/docs/Contribution-Guidelines.html @@ -48,12 +48,14 @@ Next: <a href="Init-System.html" accesskey="n" rel="next">Init System</a>, Previ <span id="Contribution-Guidelines-1"></span><h2 class="chapter">3 Contribution Guidelines</h2> <p>Thanks for taking your time to contribute! To maintain stylistic behaviour -throughout the repositories, one must adhere to these guidelines. Exceptions and -changes may occur with good reasoning. +throughout the repositories, one must adhere to these conventions. Exceptions +and changes may occur with good reasoning. </p> <table class="menu" border="0" cellspacing="0"> <tr><td align="left" valign="top">• <a href="Conventions.html" accesskey="1">Conventions</a></td><td> </td><td align="left" valign="top"> </td></tr> +<tr><td align="left" valign="top">• <a href="Sending-Git-mails.html" accesskey="2">Sending Git mails</a></td><td> </td><td align="left" valign="top"> +</td></tr> </table> diff --git a/docs/docs/Conventions.html b/docs/docs/Conventions.html index 042f21d..55c3972 100644 --- a/docs/docs/Conventions.html +++ b/docs/docs/Conventions.html @@ -15,7 +15,7 @@ Licensed under Gnu Free Documentation License. --> <meta name="Generator" content="makeinfo"> <link href="index.html" rel="start" title="Top"> <link href="Contribution-Guidelines.html" rel="up" title="Contribution Guidelines"> -<link href="Init-System.html" rel="next" title="Init System"> +<link href="General-Conventions.html" rel="next" title="General Conventions"> <link href="Contribution-Guidelines.html" rel="prev" title="Contribution Guidelines"> <style type="text/css"> <!-- @@ -42,59 +42,20 @@ ul.no-bullet {list-style: none} <body lang="en"> <span id="Conventions"></span><div class="header"> <p> -Up: <a href="Contribution-Guidelines.html" accesskey="u" rel="up">Contribution Guidelines</a> </p> +Next: <a href="Sending-Git-mails.html" accesskey="n" rel="next">Sending Git mails</a>, Up: <a href="Contribution-Guidelines.html" accesskey="u" rel="up">Contribution Guidelines</a> </p> </div> <hr> <span id="Conventions-1"></span><h3 class="section">3.1 Conventions</h3> -<span id="General-Conventions-_002d_002d-00"></span><h4 class="subsection">3.1.1 General Conventions – 00</h4> -<p>These apply to each and every file on the repositories. -</p> -<ul> -<li> Try to keep the file readable. <strong>[<span id="g_t0010"></span>0010]</strong> -<ul> -<li> Characters on a line shouldn’t exceed 100 characters excluding indentation. <strong>[<span id="g_t0011"></span>0011]</strong> -</li><li> Make sure you don’t have code commented out during commit. Uncomment them -or remove them completely. <strong>[<span id="g_t0012"></span>0012]</strong> -</li><li> Do not add comments following the code, add them to the top of the code. It -makes it harder to read, and lines longer. <strong>[<span id="g_t0013"></span>0013]</strong> -Here is an example: -<div class="example"> -<pre class="example"># Good way of commenting. -your code goes here +<table class="menu" border="0" cellspacing="0"> +<tr><td align="left" valign="top">• <a href="General-Conventions.html" accesskey="1">General Conventions – 00</a></td><td> </td><td align="left" valign="top"> +</td></tr> +<tr><td align="left" valign="top">• <a href="Shell-Conventions.html" accesskey="2">Shell Conventions – 10</a></td><td> </td><td align="left" valign="top"> +</td></tr> +<tr><td align="left" valign="top">• <a href="Repository-Conventions.html" accesskey="3">Repository Conventions – 20</a></td><td> </td><td align="left" valign="top"> +</td></tr> +</table> -your code goes here # Avoid this way of commenting. -</pre></div> -</li></ul> -</li></ul> - -<span id="Shell-Conventions-_002d_002d-10"></span><h4 class="subsection">3.1.2 Shell Conventions – 10</h4> - -<p>Shell is central to Carbs Linux projects. Most of the tools and packages are -written in POSIX sh. -</p> -<ul> -<li> Use 4 spaces for indentation, instead of tabs. <strong>[<span id="g_t1010"></span>1010]</strong> -</li><li> Make sure you don’t use bash-specific code. <strong>[<span id="g_t1020"></span>1020]</strong> -</li><li> Make sure you lint your code with <code>shellcheck</code> and if you are new to -POSIX sh, use <code>checkbashisms</code>. <strong>[<span id="g_t1030"></span>1030]</strong> -</li><li> Don’t spawn new processes if you don’t absolutely need to, especially during -string manipulation. <strong>[<span id="g_t1040"></span>1040]</strong> -<ul> -<li> Never use a program for text manupilation that isn’t defined in the POSIX -standard. This includes <code>gawk</code> and <code>perl</code>. <strong>[<span id="g_t1041"></span>1041]</strong> -</li><li> Instead of <code>$(basename $file)</code>, use <code>${file##*}</code>. <strong>[<span id="g_t1042"></span>1042]</strong> -</li><li> Instead of <code>$(dirname $file)</code>, use <code>${file%/*}</code>. <strong>[<span id="g_t1043"></span>1043]</strong> -</li></ul> -<div class="example"> -<pre class="example"># This is the same thing as <code>basename /path/to/test.asc .asc</code> - -$ file=/path/to/test.asc file=${file##*/} file=${file%.asc} -$ echo $file -test -</pre></div> -</li><li> Instead of backticks, use <tt>$(..)</tt>. <strong>[<span id="g_t1050"></span>1050]</strong> -</li></ul> diff --git a/docs/docs/General-Conventions.html b/docs/docs/General-Conventions.html new file mode 100644 index 0000000..a75fca5 --- /dev/null +++ b/docs/docs/General-Conventions.html @@ -0,0 +1,79 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> +<html> +<!-- Copyright (C) 2020 Cem Keylan + +Licensed under Gnu Free Documentation License. --> +<!-- Created by GNU Texinfo 6.7, http://www.gnu.org/software/texinfo/ --> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> +<title>General Conventions (Carbs Linux User Manual)</title> + +<meta name="description" content="General Conventions (Carbs Linux User Manual)"> +<meta name="keywords" content="General Conventions (Carbs Linux User Manual)"> +<meta name="resource-type" content="document"> +<meta name="distribution" content="global"> +<meta name="Generator" content="makeinfo"> +<link href="index.html" rel="start" title="Top"> +<link href="Conventions.html" rel="up" title="Conventions"> +<link href="Shell-Conventions.html" rel="next" title="Shell Conventions"> +<link href="Conventions.html" rel="prev" title="Conventions"> +<style type="text/css"> +<!-- +a.summary-letter {text-decoration: none} +blockquote.indentedblock {margin-right: 0em} +div.display {margin-left: 3.2em} +div.example {margin-left: 3.2em} +div.lisp {margin-left: 3.2em} +kbd {font-style: oblique} +pre.display {font-family: inherit} +pre.format {font-family: inherit} +pre.menu-comment {font-family: serif} +pre.menu-preformatted {font-family: serif} +span.nolinebreak {white-space: nowrap} +span.roman {font-family: initial; font-weight: normal} +span.sansserif {font-family: sans-serif; font-weight: normal} +ul.no-bullet {list-style: none} +--> +</style> + + +</head> + +<body lang="en"> +<span id="General-Conventions"></span><div class="header"> +<p> +Next: <a href="Shell-Conventions.html" accesskey="n" rel="next">Shell Conventions</a>, Up: <a href="Conventions.html" accesskey="u" rel="up">Conventions</a> </p> +</div> +<hr> +<span id="General-Conventions-_002d_002d-00"></span><h4 class="subsection">3.1.1 General Conventions – 00</h4> + +<dl compact="compact"> +<dt><strong>[<span id="g_t0010"></span>0010]</strong></dt> +<dd><p>Try to keep the file readable. +</p><dl compact="compact"> +<dt><strong>[<span id="g_t0011"></span>0011]</strong></dt> +<dd><p>Characters on a line shouldn’t exceed 100 characters. +</p></dd> +<dt><strong>[<span id="g_t0012"></span>0012]</strong></dt> +<dd><p>Make sure you don’t have code commented out during commit. Uncomment them +or remove them completely. +</p></dd> +<dt><strong>[<span id="g_t0013"></span>0013]</strong></dt> +<dd><p>Do not add comments following the code, add them to the top of the code. It +makes it harder to read, and lines longer. Here is an example: +</p><div class="example"> +<pre class="example"># Good way of commenting. +your code goes here + +your code goes here # Avoid this way of commenting. +</pre></div> +</dd> +</dl> +</dd> +</dl> + + + + +</body> +</html> diff --git a/docs/docs/Init-System.html b/docs/docs/Init-System.html index afbd087..285dfab 100644 --- a/docs/docs/Init-System.html +++ b/docs/docs/Init-System.html @@ -16,7 +16,7 @@ Licensed under Gnu Free Documentation License. --> <link href="index.html" rel="start" title="Top"> <link href="index.html" rel="up" title="Top"> <link href="Configuring-Init.html" rel="next" title="Configuring Init"> -<link href="Conventions.html" rel="prev" title="Conventions"> +<link href="Sending-Git-mails.html" rel="prev" title="Sending Git mails"> <style type="text/css"> <!-- a.summary-letter {text-decoration: none} diff --git a/docs/docs/Repository-Conventions.html b/docs/docs/Repository-Conventions.html new file mode 100644 index 0000000..bb276dc --- /dev/null +++ b/docs/docs/Repository-Conventions.html @@ -0,0 +1,207 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> +<html> +<!-- Copyright (C) 2020 Cem Keylan + +Licensed under Gnu Free Documentation License. --> +<!-- Created by GNU Texinfo 6.7, http://www.gnu.org/software/texinfo/ --> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> +<title>Repository Conventions (Carbs Linux User Manual)</title> + +<meta name="description" content="Repository Conventions (Carbs Linux User Manual)"> +<meta name="keywords" content="Repository Conventions (Carbs Linux User Manual)"> +<meta name="resource-type" content="document"> +<meta name="distribution" content="global"> +<meta name="Generator" content="makeinfo"> +<link href="index.html" rel="start" title="Top"> +<link href="Conventions.html" rel="up" title="Conventions"> +<link href="Sending-Git-mails.html" rel="next" title="Sending Git mails"> +<link href="Shell-Conventions.html" rel="prev" title="Shell Conventions"> +<style type="text/css"> +<!-- +a.summary-letter {text-decoration: none} +blockquote.indentedblock {margin-right: 0em} +div.display {margin-left: 3.2em} +div.example {margin-left: 3.2em} +div.lisp {margin-left: 3.2em} +kbd {font-style: oblique} +pre.display {font-family: inherit} +pre.format {font-family: inherit} +pre.menu-comment {font-family: serif} +pre.menu-preformatted {font-family: serif} +span.nolinebreak {white-space: nowrap} +span.roman {font-family: initial; font-weight: normal} +span.sansserif {font-family: sans-serif; font-weight: normal} +ul.no-bullet {list-style: none} +--> +</style> + + +</head> + +<body lang="en"> +<span id="Repository-Conventions"></span><div class="header"> +<p> +Previous: <a href="Shell-Conventions.html" accesskey="p" rel="prev">Shell Conventions</a>, Up: <a href="Conventions.html" accesskey="u" rel="up">Conventions</a> </p> +</div> +<hr> +<span id="Repository-Conventions-_002d_002d-20"></span><h4 class="subsection">3.1.3 Repository Conventions – 20</h4> + +<p>Repository conventions are important in order to ensure every package resemble +themselves. Here are the things to keep in mind: +</p> +<dl compact="compact"> +<dt><strong>[<span id="g_t2010"></span>2010]</strong></dt> +<dd><p>Prefer tarballs over git packages unless there is a sensible reason. +Here are some: +</p> +<ul> +<li> Every patch is a new release. (See <a href="https://github.com/vim/vim">vim</a>) +</li><li> There are no releases. (See <a href="https://git.suckless.org/sbase">https://git.suckless.org/sbase</a>) +</li><li> Following a development branch. +</li><li> There has been a long time since the latest release, but upstream is far ahead. +</li></ul> + +</dd> +<dt><strong>[<span id="g_t2020"></span>2020]</strong></dt> +<dd><p>Prefer sources without a dependency to <code>automake</code>. There are usually +distribution tarballs that are <code>autoconf</code>’ed. Don’t submit tarballs +with an automake dependency unless you are <strong>sure</strong> there is no +alternative. +</p></dd> +<dt><strong>[<span id="g_t2030"></span>2030]</strong></dt> +<dd><p>Avoid these packages: +</p><dl compact="compact"> +<dt><code>dbus</code></dt> +<dd><p>Usually can be disabled by <samp>--disable-dbus</samp> +</p></dd> +<dt><code>gettext</code></dt> +<dd><p>Usually can be disabled by <samp>--disable-nls</samp> +</p></dd> +</dl> +</dd> +<dt><strong>[<span id="g_t2040"></span>2040]</strong></dt> +<dd><ul> +<li> Always install a package to the <samp>/usr</samp> prefix. +</li><li> All binaries should go to <samp>/usr/bin</samp>, not <samp>/usr/sbin</samp> or any other +directory. +</li><li> All libraries should go to <samp>/usr/lib</samp>. +</li></ul> +</dd> +<dt><strong>[<span id="g_t2050"></span>2050]</strong></dt> +<dd><p>All build files on the repository should be a POSIX shell script, and must start +with <code>#!/bin/sh -e</code>. +</p></dd> +</dl> + +<p>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. +</p> +<p><strong>[<span id="g_t2210"></span>2210] Make</strong> +</p> +<div class="example"> +<pre class="example">#!/bin/sh -e + +make +make DESTDIR="$1" PREFIX=/usr install +</pre></div> + +<p><strong>[<span id="g_t2211"></span>2211] Configure/Make</strong> +</p> +<div class="example"> +<pre class="example">#!/bin/sh -e + +./configure \ + --prefix=/usr \ + --disable-option \ + --enable-option + +make +make DESTDIR="$1" install +</pre></div> + + +<p><strong>[<span id="g_t2212"></span>2212] Autoconf/Automake</strong> +</p> +<p>See <a href="#g_t2020">2020</a> +</p> +<div class="example"> +<pre class="example">#!/bin/sh -e + +autoreconf -fi + +./configure \ + --prefix=/usr \ + --disable-option \ + --enable-option + +make +make DESTDIR="$1" install +</pre></div> + +<p><strong>[<span id="g_t2220"></span>2220] Meson</strong> +</p> +<div class="example"> +<pre class="example">#!/bin/sh -e + +export DESTDIR=$1 + +meson \ + --prefix=/usr \ + -Doption=false \ + -Doption2=true \ + . output + +ninja -C output +ninja -C output install +</pre></div> + +<p><strong>[<span id="g_t2230"></span>2230] Cmake</strong> +</p> +<div class="example"> +<pre class="example">#!/bin/sh -e + +export DESTDIR=$1 + +cmake -B build \ + -DCMAKE_INSTALL_PREFIX=/usr \ + -DCMAKE_BUILD_TYPE=Release \ + -DOPTION=ON + +cmake --build build +cmake --install build +</pre></div> + +<p><strong>[<span id="g_t2240"></span>2240] Go</strong> +</p> +<div class="example"> +<pre class="example">#!/bin/sh -e + +export GOPATH=$PWD/gopath +trap "go clean -modcache" EXIT INT +go mod vendor + +go build +install -Dm755 program "$1/usr/bin/program" +</pre></div> + +<p><strong>[<span id="g_t2241"></span>2241] Python</strong> +</p> +<div class="example"> +<pre class="example">#!/bin/sh -e + +python setup.py build +python setup.py install --prefix=/usr --root="$1" +</pre></div> + +<hr> +<div class="header"> +<p> +Previous: <a href="Shell-Conventions.html" accesskey="p" rel="prev">Shell Conventions</a>, Up: <a href="Conventions.html" accesskey="u" rel="up">Conventions</a> </p> +</div> + + + +</body> +</html> diff --git a/docs/docs/Sending-Git-mails.html b/docs/docs/Sending-Git-mails.html new file mode 100644 index 0000000..86fa2f7 --- /dev/null +++ b/docs/docs/Sending-Git-mails.html @@ -0,0 +1,95 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> +<html> +<!-- Copyright (C) 2020 Cem Keylan + +Licensed under Gnu Free Documentation License. --> +<!-- Created by GNU Texinfo 6.7, http://www.gnu.org/software/texinfo/ --> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> +<title>Sending Git mails (Carbs Linux User Manual)</title> + +<meta name="description" content="Sending Git mails (Carbs Linux User Manual)"> +<meta name="keywords" content="Sending Git mails (Carbs Linux User Manual)"> +<meta name="resource-type" content="document"> +<meta name="distribution" content="global"> +<meta name="Generator" content="makeinfo"> +<link href="index.html" rel="start" title="Top"> +<link href="Contribution-Guidelines.html" rel="up" title="Contribution Guidelines"> +<link href="Init-System.html" rel="next" title="Init System"> +<link href="Repository-Conventions.html" rel="prev" title="Repository Conventions"> +<style type="text/css"> +<!-- +a.summary-letter {text-decoration: none} +blockquote.indentedblock {margin-right: 0em} +div.display {margin-left: 3.2em} +div.example {margin-left: 3.2em} +div.lisp {margin-left: 3.2em} +kbd {font-style: oblique} +pre.display {font-family: inherit} +pre.format {font-family: inherit} +pre.menu-comment {font-family: serif} +pre.menu-preformatted {font-family: serif} +span.nolinebreak {white-space: nowrap} +span.roman {font-family: initial; font-weight: normal} +span.sansserif {font-family: sans-serif; font-weight: normal} +ul.no-bullet {list-style: none} +--> +</style> + + +</head> + +<body lang="en"> +<span id="Sending-Git-mails"></span><div class="header"> +<p> +Previous: <a href="Conventions.html" accesskey="p" rel="prev">Conventions</a>, Up: <a href="Contribution-Guidelines.html" accesskey="u" rel="up">Contribution Guidelines</a> </p> +</div> +<hr> +<span id="Sending-Git-mails-1"></span><h3 class="section">3.2 Sending Git mails</h3> + +<p>As mentioned, the preferred way of contribution is via patches. The easiest way +for sending git mails without <code>git send-email</code> is using <code>msmtp</code>. +You can install it from the repository by doing: +</p> +<div class="example"> +<pre class="example">$ cpt b msmtp && cpt i msmtp +</pre></div> + +<p>You can then edit <samp>~/.config/msmtp/config</samp> to add your email. Here is an +example configuration, you can use <code>pass</code>, <code>pash</code>, or any other +password manager that fits your needs: +</p> +<div class="example"> +<pre class="example">defaults +auth on +tls on +tls_trust_file /etc/ssl/certs/ca-certificates.crt +logfile ~/.config/msmtp/msmtp.log +account my-mail +host mail.example.com +port 587 +from me@example.com +user me@example.com +passwordeval "pass my-mail" +</pre></div> + +<p>In order to simply send your patch, do the following: +</p> +<div class="example"> +<pre class="example">$ git format-patch --to=~carbslinux/dev+subscribe@lists.sr.ht -1 --stdout | + msmtp -t -a my-mail +</pre></div> + +<p>You can also send multiple patches by doing the following: +</p> +<div class="example"> +<pre class="example">$ 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 +</pre></div> + + + +</body> +</html> diff --git a/docs/docs/Setting-up-an-rsync-repository-for-distribution.html b/docs/docs/Setting-up-an-rsync-repository-for-distribution.html index 5c94c69..87dfe78 100644 --- a/docs/docs/Setting-up-an-rsync-repository-for-distribution.html +++ b/docs/docs/Setting-up-an-rsync-repository-for-distribution.html @@ -96,5 +96,6 @@ exec rsync --daemon --no-detach + </body> </html> diff --git a/docs/docs/Shell-Conventions.html b/docs/docs/Shell-Conventions.html new file mode 100644 index 0000000..bcaf8b9 --- /dev/null +++ b/docs/docs/Shell-Conventions.html @@ -0,0 +1,96 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> +<html> +<!-- Copyright (C) 2020 Cem Keylan + +Licensed under Gnu Free Documentation License. --> +<!-- Created by GNU Texinfo 6.7, http://www.gnu.org/software/texinfo/ --> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> +<title>Shell Conventions (Carbs Linux User Manual)</title> + +<meta name="description" content="Shell Conventions (Carbs Linux User Manual)"> +<meta name="keywords" content="Shell Conventions (Carbs Linux User Manual)"> +<meta name="resource-type" content="document"> +<meta name="distribution" content="global"> +<meta name="Generator" content="makeinfo"> +<link href="index.html" rel="start" title="Top"> +<link href="Conventions.html" rel="up" title="Conventions"> +<link href="Repository-Conventions.html" rel="next" title="Repository Conventions"> +<link href="General-Conventions.html" rel="prev" title="General Conventions"> +<style type="text/css"> +<!-- +a.summary-letter {text-decoration: none} +blockquote.indentedblock {margin-right: 0em} +div.display {margin-left: 3.2em} +div.example {margin-left: 3.2em} +div.lisp {margin-left: 3.2em} +kbd {font-style: oblique} +pre.display {font-family: inherit} +pre.format {font-family: inherit} +pre.menu-comment {font-family: serif} +pre.menu-preformatted {font-family: serif} +span.nolinebreak {white-space: nowrap} +span.roman {font-family: initial; font-weight: normal} +span.sansserif {font-family: sans-serif; font-weight: normal} +ul.no-bullet {list-style: none} +--> +</style> + + +</head> + +<body lang="en"> +<span id="Shell-Conventions"></span><div class="header"> +<p> +Next: <a href="Repository-Conventions.html" accesskey="n" rel="next">Repository Conventions</a>, Previous: <a href="General-Conventions.html" accesskey="p" rel="prev">General Conventions</a>, Up: <a href="Conventions.html" accesskey="u" rel="up">Conventions</a> </p> +</div> +<hr> +<span id="Shell-Conventions-_002d_002d-10"></span><h4 class="subsection">3.1.2 Shell Conventions – 10</h4> + +<p>Shell is central to Carbs Linux projects. Most of the tools and packages are +written in POSIX sh. +</p> +<dl compact="compact"> +<dt><strong>[<span id="g_t1010"></span>1010]</strong></dt> +<dd><p>Use 4 spaces for indentation, don’t use tabs. +</p></dd> +<dt><strong>[<span id="g_t1020"></span>1020]</strong></dt> +<dd><p>Make sure you don’t use bash-specific code. +</p></dd> +<dt><strong>[<span id="g_t1030"></span>1030]</strong></dt> +<dd><p>Make sure you lint your code with <code>shellcheck</code> and if you are new to +POSIX sh, use <code>checkbashisms</code>. +</p></dd> +<dt><strong>[<span id="g_t1040"></span>1040]</strong></dt> +<dd><p>Don’t spawn new processes if you don’t absolutely need to, especially during +string manipulation. +</p><dl compact="compact"> +<dt><strong>[<span id="g_t1041"></span>1041]</strong></dt> +<dd><p>Never use a program for text manupilation that isn’t defined in the POSIX +standard. This includes <code>gawk</code> and <code>perl</code>. +</p></dd> +<dt><strong>[<span id="g_t1042"></span>1042]</strong></dt> +<dd><p>Instead of <code>$(basename $file)</code>, use <code>${file##*}</code>. +</p></dd> +<dt><strong>[<span id="g_t1043"></span>1043]</strong></dt> +<dd><p>Instead of <code>$(dirname $file)</code>, use <code>${file%/*}</code>. +</p></dd> +</dl> +<div class="example"> +<pre class="example"># This is the same thing as <code>basename /path/to/test.asc .asc</code> + +$ file=/path/to/test.asc file=${file##*/} file=${file%.asc} +$ echo $file +test +</pre></div> +</dd> +<dt><strong>[<span id="g_t1050"></span>1050]</strong></dt> +<dd><p>Instead of backticks, use <tt>$(..)</tt>. +</p></dd> +</dl> + + + + +</body> +</html> diff --git a/docs/news.xml b/docs/news.xml index 319cae7..521ac5d 100644 --- a/docs/news.xml +++ b/docs/news.xml @@ -9,7 +9,7 @@ <description>a simple linux distribution</description> <link>https://carbslinux.org</link> <atom:link href="https://carbslinux.org/news.xml" rel="self" type="application/rss+xml" /> - <lastBuildDate>Mon Sep 14 2020 09:00</lastBuildDate> + <lastBuildDate>Mon Sep 14 2020 17:00</lastBuildDate> <item> <title>Sep 03 2020</title> <pubDate>Thu, 03 Sep 2020</pubDate> diff --git a/docs/rss.xml b/docs/rss.xml index 1980970..10aaaef 100644 --- a/docs/rss.xml +++ b/docs/rss.xml @@ -9,7 +9,7 @@ <description>a simple linux distribution</description> <link>https://carbslinux.org</link> <atom:link href="https://carbslinux.org/rss.xml" rel="self" type="application/rss+xml" /> - <lastBuildDate>Mon Sep 14 2020 09:00</lastBuildDate> + <lastBuildDate>Mon Sep 14 2020 17:00</lastBuildDate> <item> <title>August 2020 News Post</title> <pubDate>Mon, 03 Aug 2020</pubDate> diff --git a/src/docs/0010.html b/src/docs/0010.html index c11c42c..4547016 100644 --- a/src/docs/0010.html +++ b/src/docs/0010.html @@ -33,11 +33,11 @@ ul.no-bullet {list-style: none} --> </style> -<meta http-equiv="Refresh" content="0; url=Conventions.html#g_t0010"> +<meta http-equiv="Refresh" content="0; url=General-Conventions.html#g_t0010"> </head> <body lang="en"> -<p>The node you are looking for is at <a href="Conventions.html#g_t0010">0010</a>.</p> +<p>The node you are looking for is at <a href="General-Conventions.html#g_t0010">0010</a>.</p> </body> diff --git a/src/docs/0011.html b/src/docs/0011.html index c8e9a20..5bfb360 100644 --- a/src/docs/0011.html +++ b/src/docs/0011.html @@ -33,11 +33,11 @@ ul.no-bullet {list-style: none} --> </style> -<meta http-equiv="Refresh" content="0; url=Conventions.html#g_t0011"> +<meta http-equiv="Refresh" content="0; url=General-Conventions.html#g_t0011"> </head> <body lang="en"> -<p>The node you are looking for is at <a href="Conventions.html#g_t0011">0011</a>.</p> +<p>The node you are looking for is at <a href="General-Conventions.html#g_t0011">0011</a>.</p> </body> diff --git a/src/docs/0012.html b/src/docs/0012.html index 39b6015..faeff7f 100644 --- a/src/docs/0012.html +++ b/src/docs/0012.html @@ -33,11 +33,11 @@ ul.no-bullet {list-style: none} --> </style> -<meta http-equiv="Refresh" content="0; url=Conventions.html#g_t0012"> +<meta http-equiv="Refresh" content="0; url=General-Conventions.html#g_t0012"> </head> <body lang="en"> -<p>The node you are looking for is at <a href="Conventions.html#g_t0012">0012</a>.</p> +<p>The node you are looking for is at <a href="General-Conventions.html#g_t0012">0012</a>.</p> </body> diff --git a/src/docs/0013.html b/src/docs/0013.html index 483f1b2..a5b5957 100644 --- a/src/docs/0013.html +++ b/src/docs/0013.html @@ -33,11 +33,11 @@ ul.no-bullet {list-style: none} --> </style> -<meta http-equiv="Refresh" content="0; url=Conventions.html#g_t0013"> +<meta http-equiv="Refresh" content="0; url=General-Conventions.html#g_t0013"> </head> <body lang="en"> -<p>The node you are looking for is at <a href="Conventions.html#g_t0013">0013</a>.</p> +<p>The node you are looking for is at <a href="General-Conventions.html#g_t0013">0013</a>.</p> </body> diff --git a/src/docs/1010.html b/src/docs/1010.html index 80fd2d9..0d8c219 100644 --- a/src/docs/1010.html +++ b/src/docs/1010.html @@ -33,11 +33,11 @@ ul.no-bullet {list-style: none} --> </style> -<meta http-equiv="Refresh" content="0; url=Conventions.html#g_t1010"> +<meta http-equiv="Refresh" content="0; url=Shell-Conventions.html#g_t1010"> </head> <body lang="en"> -<p>The node you are looking for is at <a href="Conventions.html#g_t1010">1010</a>.</p> +<p>The node you are looking for is at <a href="Shell-Conventions.html#g_t1010">1010</a>.</p> </body> diff --git a/src/docs/1020.html b/src/docs/1020.html index dc08d81..c003ed0 100644 --- a/src/docs/1020.html +++ b/src/docs/1020.html @@ -33,11 +33,11 @@ ul.no-bullet {list-style: none} --> </style> -<meta http-equiv="Refresh" content="0; url=Conventions.html#g_t1020"> +<meta http-equiv="Refresh" content="0; url=Shell-Conventions.html#g_t1020"> </head> <body lang="en"> -<p>The node you are looking for is at <a href="Conventions.html#g_t1020">1020</a>.</p> +<p>The node you are looking for is at <a href="Shell-Conventions.html#g_t1020">1020</a>.</p> </body> diff --git a/src/docs/1030.html b/src/docs/1030.html index f4fd1ff..8e23c32 100644 --- a/src/docs/1030.html +++ b/src/docs/1030.html @@ -33,11 +33,11 @@ ul.no-bullet {list-style: none} --> </style> -<meta http-equiv="Refresh" content="0; url=Conventions.html#g_t1030"> +<meta http-equiv="Refresh" content="0; url=Shell-Conventions.html#g_t1030"> </head> <body lang="en"> -<p>The node you are looking for is at <a href="Conventions.html#g_t1030">1030</a>.</p> +<p>The node you are looking for is at <a href="Shell-Conventions.html#g_t1030">1030</a>.</p> </body> diff --git a/src/docs/1040.html b/src/docs/1040.html index c42eff1..eb80fab 100644 --- a/src/docs/1040.html +++ b/src/docs/1040.html @@ -33,11 +33,11 @@ ul.no-bullet {list-style: none} --> </style> -<meta http-equiv="Refresh" content="0; url=Conventions.html#g_t1040"> +<meta http-equiv="Refresh" content="0; url=Shell-Conventions.html#g_t1040"> </head> <body lang="en"> -<p>The node you are looking for is at <a href="Conventions.html#g_t1040">1040</a>.</p> +<p>The node you are looking for is at <a href="Shell-Conventions.html#g_t1040">1040</a>.</p> </body> diff --git a/src/docs/1041.html b/src/docs/1041.html index 61beac5..6dab115 100644 --- a/src/docs/1041.html +++ b/src/docs/1041.html @@ -33,11 +33,11 @@ ul.no-bullet {list-style: none} --> </style> -<meta http-equiv="Refresh" content="0; url=Conventions.html#g_t1041"> +<meta http-equiv="Refresh" content="0; url=Shell-Conventions.html#g_t1041"> </head> <body lang="en"> -<p>The node you are looking for is at <a href="Conventions.html#g_t1041">1041</a>.</p> +<p>The node you are looking for is at <a href="Shell-Conventions.html#g_t1041">1041</a>.</p> </body> diff --git a/src/docs/1042.html b/src/docs/1042.html index ac625f2..a6e26a9 100644 --- a/src/docs/1042.html +++ b/src/docs/1042.html @@ -33,11 +33,11 @@ ul.no-bullet {list-style: none} --> </style> -<meta http-equiv="Refresh" content="0; url=Conventions.html#g_t1042"> +<meta http-equiv="Refresh" content="0; url=Shell-Conventions.html#g_t1042"> </head> <body lang="en"> -<p>The node you are looking for is at <a href="Conventions.html#g_t1042">1042</a>.</p> +<p>The node you are looking for is at <a href="Shell-Conventions.html#g_t1042">1042</a>.</p> </body> diff --git a/src/docs/1043.html b/src/docs/1043.html index d293a4e..5105a21 100644 --- a/src/docs/1043.html +++ b/src/docs/1043.html @@ -33,11 +33,11 @@ ul.no-bullet {list-style: none} --> </style> -<meta http-equiv="Refresh" content="0; url=Conventions.html#g_t1043"> +<meta http-equiv="Refresh" content="0; url=Shell-Conventions.html#g_t1043"> </head> <body lang="en"> -<p>The node you are looking for is at <a href="Conventions.html#g_t1043">1043</a>.</p> +<p>The node you are looking for is at <a href="Shell-Conventions.html#g_t1043">1043</a>.</p> </body> diff --git a/src/docs/1050.html b/src/docs/1050.html index 7422d14..4b3a5ec 100644 --- a/src/docs/1050.html +++ b/src/docs/1050.html @@ -33,11 +33,11 @@ ul.no-bullet {list-style: none} --> </style> -<meta http-equiv="Refresh" content="0; url=Conventions.html#g_t1050"> +<meta http-equiv="Refresh" content="0; url=Shell-Conventions.html#g_t1050"> </head> <body lang="en"> -<p>The node you are looking for is at <a href="Conventions.html#g_t1050">1050</a>.</p> +<p>The node you are looking for is at <a href="Shell-Conventions.html#g_t1050">1050</a>.</p> </body> diff --git a/src/docs/2010.html b/src/docs/2010.html new file mode 100644 index 0000000..02f5170 --- /dev/null +++ b/src/docs/2010.html @@ -0,0 +1,43 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> +<html> +<!-- Copyright (C) 2020 Cem Keylan + +Licensed under Gnu Free Documentation License. --> +<!-- Created by GNU Texinfo 6.7, http://www.gnu.org/software/texinfo/ --> +<!-- This file redirects to the location of a node or anchor --> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> +<title>2010 (Carbs Linux User Manual)</title> + +<meta name="description" content="2010 (Carbs Linux User Manual)"> +<meta name="keywords" content="2010 (Carbs Linux User Manual)"> +<meta name="resource-type" content="document"> +<meta name="distribution" content="global"> +<meta name="Generator" content="makeinfo"> +<style type="text/css"> +<!-- +a.summary-letter {text-decoration: none} +blockquote.indentedblock {margin-right: 0em} +div.display {margin-left: 3.2em} +div.example {margin-left: 3.2em} +div.lisp {margin-left: 3.2em} +kbd {font-style: oblique} +pre.display {font-family: inherit} +pre.format {font-family: inherit} +pre.menu-comment {font-family: serif} +pre.menu-preformatted {font-family: serif} +span.nolinebreak {white-space: nowrap} +span.roman {font-family: initial; font-weight: normal} +span.sansserif {font-family: sans-serif; font-weight: normal} +ul.no-bullet {list-style: none} +--> +</style> + +<meta http-equiv="Refresh" content="0; url=Repository-Conventions.html#g_t2010"> + +</head> + +<body lang="en"> + +<p>The node you are looking for is at <a href="Repository-Conventions.html#g_t2010">2010</a>.</p> +</body> diff --git a/src/docs/2020.html b/src/docs/2020.html new file mode 100644 index 0000000..0162983 --- /dev/null +++ b/src/docs/2020.html @@ -0,0 +1,43 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> +<html> +<!-- Copyright (C) 2020 Cem Keylan + +Licensed under Gnu Free Documentation License. --> +<!-- Created by GNU Texinfo 6.7, http://www.gnu.org/software/texinfo/ --> +<!-- This file redirects to the location of a node or anchor --> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> +<title>2020 (Carbs Linux User Manual)</title> + +<meta name="description" content="2020 (Carbs Linux User Manual)"> +<meta name="keywords" content="2020 (Carbs Linux User Manual)"> +<meta name="resource-type" content="document"> +<meta name="distribution" content="global"> +<meta name="Generator" content="makeinfo"> +<style type="text/css"> +<!-- +a.summary-letter {text-decoration: none} +blockquote.indentedblock {margin-right: 0em} +div.display {margin-left: 3.2em} +div.example {margin-left: 3.2em} +div.lisp {margin-left: 3.2em} +kbd {font-style: oblique} +pre.display {font-family: inherit} +pre.format {font-family: inherit} +pre.menu-comment {font-family: serif} +pre.menu-preformatted {font-family: serif} +span.nolinebreak {white-space: nowrap} +span.roman {font-family: initial; font-weight: normal} +span.sansserif {font-family: sans-serif; font-weight: normal} +ul.no-bullet {list-style: none} +--> +</style> + +<meta http-equiv="Refresh" content="0; url=Repository-Conventions.html#g_t2020"> + +</head> + +<body lang="en"> + +<p>The node you are looking for is at <a href="Repository-Conventions.html#g_t2020">2020</a>.</p> +</body> diff --git a/src/docs/2030.html b/src/docs/2030.html new file mode 100644 index 0000000..82e6284 --- /dev/null +++ b/src/docs/2030.html @@ -0,0 +1,43 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> +<html> +<!-- Copyright (C) 2020 Cem Keylan + +Licensed under Gnu Free Documentation License. --> +<!-- Created by GNU Texinfo 6.7, http://www.gnu.org/software/texinfo/ --> +<!-- This file redirects to the location of a node or anchor --> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> +<title>2030 (Carbs Linux User Manual)</title> + +<meta name="description" content="2030 (Carbs Linux User Manual)"> +<meta name="keywords" content="2030 (Carbs Linux User Manual)"> +<meta name="resource-type" content="document"> +<meta name="distribution" content="global"> +<meta name="Generator" content="makeinfo"> +<style type="text/css"> +<!-- +a.summary-letter {text-decoration: none} +blockquote.indentedblock {margin-right: 0em} +div.display {margin-left: 3.2em} +div.example {margin-left: 3.2em} +div.lisp {margin-left: 3.2em} +kbd {font-style: oblique} +pre.display {font-family: inherit} +pre.format {font-family: inherit} +pre.menu-comment {font-family: serif} +pre.menu-preformatted {font-family: serif} +span.nolinebreak {white-space: nowrap} +span.roman {font-family: initial; font-weight: normal} +span.sansserif {font-family: sans-serif; font-weight: normal} +ul.no-bullet {list-style: none} +--> +</style> + +<meta http-equiv="Refresh" content="0; url=Repository-Conventions.html#g_t2030"> + +</head> + +<body lang="en"> + +<p>The node you are looking for is at <a href="Repository-Conventions.html#g_t2030">2030</a>.</p> +</body> diff --git a/src/docs/2040.html b/src/docs/2040.html new file mode 100644 index 0000000..51bd56e --- /dev/null +++ b/src/docs/2040.html @@ -0,0 +1,43 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> +<html> +<!-- Copyright (C) 2020 Cem Keylan + +Licensed under Gnu Free Documentation License. --> +<!-- Created by GNU Texinfo 6.7, http://www.gnu.org/software/texinfo/ --> +<!-- This file redirects to the location of a node or anchor --> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> +<title>2040 (Carbs Linux User Manual)</title> + +<meta name="description" content="2040 (Carbs Linux User Manual)"> +<meta name="keywords" content="2040 (Carbs Linux User Manual)"> +<meta name="resource-type" content="document"> +<meta name="distribution" content="global"> +<meta name="Generator" content="makeinfo"> +<style type="text/css"> +<!-- +a.summary-letter {text-decoration: none} +blockquote.indentedblock {margin-right: 0em} +div.display {margin-left: 3.2em} +div.example {margin-left: 3.2em} +div.lisp {margin-left: 3.2em} +kbd {font-style: oblique} +pre.display {font-family: inherit} +pre.format {font-family: inherit} +pre.menu-comment {font-family: serif} +pre.menu-preformatted {font-family: serif} +span.nolinebreak {white-space: nowrap} +span.roman {font-family: initial; font-weight: normal} +span.sansserif {font-family: sans-serif; font-weight: normal} +ul.no-bullet {list-style: none} +--> +</style> + +<meta http-equiv="Refresh" content="0; url=Repository-Conventions.html#g_t2040"> + +</head> + +<body lang="en"> + +<p>The node you are looking for is at <a href="Repository-Conventions.html#g_t2040">2040</a>.</p> +</body> diff --git a/src/docs/2050.html b/src/docs/2050.html new file mode 100644 index 0000000..d7628b2 --- /dev/null +++ b/src/docs/2050.html @@ -0,0 +1,43 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> +<html> +<!-- Copyright (C) 2020 Cem Keylan + +Licensed under Gnu Free Documentation License. --> +<!-- Created by GNU Texinfo 6.7, http://www.gnu.org/software/texinfo/ --> +<!-- This file redirects to the location of a node or anchor --> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> +<title>2050 (Carbs Linux User Manual)</title> + +<meta name="description" content="2050 (Carbs Linux User Manual)"> +<meta name="keywords" content="2050 (Carbs Linux User Manual)"> +<meta name="resource-type" content="document"> +<meta name="distribution" content="global"> +<meta name="Generator" content="makeinfo"> +<style type="text/css"> +<!-- +a.summary-letter {text-decoration: none} +blockquote.indentedblock {margin-right: 0em} +div.display {margin-left: 3.2em} +div.example {margin-left: 3.2em} +div.lisp {margin-left: 3.2em} +kbd {font-style: oblique} +pre.display {font-family: inherit} +pre.format {font-family: inherit} +pre.menu-comment {font-family: serif} +pre.menu-preformatted {font-family: serif} +span.nolinebreak {white-space: nowrap} +span.roman {font-family: initial; font-weight: normal} +span.sansserif {font-family: sans-serif; font-weight: normal} +ul.no-bullet {list-style: none} +--> +</style> + +<meta http-equiv="Refresh" content="0; url=Repository-Conventions.html#g_t2050"> + +</head> + +<body lang="en"> + +<p>The node you are looking for is at <a href="Repository-Conventions.html#g_t2050">2050</a>.</p> +</body> diff --git a/src/docs/2210.html b/src/docs/2210.html new file mode 100644 index 0000000..29009ab --- /dev/null +++ b/src/docs/2210.html @@ -0,0 +1,43 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> +<html> +<!-- Copyright (C) 2020 Cem Keylan + +Licensed under Gnu Free Documentation License. --> +<!-- Created by GNU Texinfo 6.7, http://www.gnu.org/software/texinfo/ --> +<!-- This file redirects to the location of a node or anchor --> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> +<title>2210 (Carbs Linux User Manual)</title> + +<meta name="description" content="2210 (Carbs Linux User Manual)"> +<meta name="keywords" content="2210 (Carbs Linux User Manual)"> +<meta name="resource-type" content="document"> +<meta name="distribution" content="global"> +<meta name="Generator" content="makeinfo"> +<style type="text/css"> +<!-- +a.summary-letter {text-decoration: none} +blockquote.indentedblock {margin-right: 0em} +div.display {margin-left: 3.2em} +div.example {margin-left: 3.2em} +div.lisp {margin-left: 3.2em} +kbd {font-style: oblique} +pre.display {font-family: inherit} +pre.format {font-family: inherit} +pre.menu-comment {font-family: serif} +pre.menu-preformatted {font-family: serif} +span.nolinebreak {white-space: nowrap} +span.roman {font-family: initial; font-weight: normal} +span.sansserif {font-family: sans-serif; font-weight: normal} +ul.no-bullet {list-style: none} +--> +</style> + +<meta http-equiv="Refresh" content="0; url=Repository-Conventions.html#g_t2210"> + +</head> + +<body lang="en"> + +<p>The node you are looking for is at <a href="Repository-Conventions.html#g_t2210">2210</a>.</p> +</body> diff --git a/src/docs/2211.html b/src/docs/2211.html new file mode 100644 index 0000000..a4a85e3 --- /dev/null +++ b/src/docs/2211.html @@ -0,0 +1,43 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> +<html> +<!-- Copyright (C) 2020 Cem Keylan + +Licensed under Gnu Free Documentation License. --> +<!-- Created by GNU Texinfo 6.7, http://www.gnu.org/software/texinfo/ --> +<!-- This file redirects to the location of a node or anchor --> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> +<title>2211 (Carbs Linux User Manual)</title> + +<meta name="description" content="2211 (Carbs Linux User Manual)"> +<meta name="keywords" content="2211 (Carbs Linux User Manual)"> +<meta name="resource-type" content="document"> +<meta name="distribution" content="global"> +<meta name="Generator" content="makeinfo"> +<style type="text/css"> +<!-- +a.summary-letter {text-decoration: none} +blockquote.indentedblock {margin-right: 0em} +div.display {margin-left: 3.2em} +div.example {margin-left: 3.2em} +div.lisp {margin-left: 3.2em} +kbd {font-style: oblique} +pre.display {font-family: inherit} +pre.format {font-family: inherit} +pre.menu-comment {font-family: serif} +pre.menu-preformatted {font-family: serif} +span.nolinebreak {white-space: nowrap} +span.roman {font-family: initial; font-weight: normal} +span.sansserif {font-family: sans-serif; font-weight: normal} +ul.no-bullet {list-style: none} +--> +</style> + +<meta http-equiv="Refresh" content="0; url=Repository-Conventions.html#g_t2211"> + +</head> + +<body lang="en"> + +<p>The node you are looking for is at <a href="Repository-Conventions.html#g_t2211">2211</a>.</p> +</body> diff --git a/src/docs/2212.html b/src/docs/2212.html new file mode 100644 index 0000000..171c2c6 --- /dev/null +++ b/src/docs/2212.html @@ -0,0 +1,43 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> +<html> +<!-- Copyright (C) 2020 Cem Keylan + +Licensed under Gnu Free Documentation License. --> +<!-- Created by GNU Texinfo 6.7, http://www.gnu.org/software/texinfo/ --> +<!-- This file redirects to the location of a node or anchor --> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> +<title>2212 (Carbs Linux User Manual)</title> + +<meta name="description" content="2212 (Carbs Linux User Manual)"> +<meta name="keywords" content="2212 (Carbs Linux User Manual)"> +<meta name="resource-type" content="document"> +<meta name="distribution" content="global"> +<meta name="Generator" content="makeinfo"> +<style type="text/css"> +<!-- +a.summary-letter {text-decoration: none} +blockquote.indentedblock {margin-right: 0em} +div.display {margin-left: 3.2em} +div.example {margin-left: 3.2em} +div.lisp {margin-left: 3.2em} +kbd {font-style: oblique} +pre.display {font-family: inherit} +pre.format {font-family: inherit} +pre.menu-comment {font-family: serif} +pre.menu-preformatted {font-family: serif} +span.nolinebreak {white-space: nowrap} +span.roman {font-family: initial; font-weight: normal} +span.sansserif {font-family: sans-serif; font-weight: normal} +ul.no-bullet {list-style: none} +--> +</style> + +<meta http-equiv="Refresh" content="0; url=Repository-Conventions.html#g_t2212"> + +</head> + +<body lang="en"> + +<p>The node you are looking for is at <a href="Repository-Conventions.html#g_t2212">2212</a>.</p> +</body> diff --git a/src/docs/2220.html b/src/docs/2220.html new file mode 100644 index 0000000..58fd3f9 --- /dev/null +++ b/src/docs/2220.html @@ -0,0 +1,43 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> +<html> +<!-- Copyright (C) 2020 Cem Keylan + +Licensed under Gnu Free Documentation License. --> +<!-- Created by GNU Texinfo 6.7, http://www.gnu.org/software/texinfo/ --> +<!-- This file redirects to the location of a node or anchor --> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> +<title>2220 (Carbs Linux User Manual)</title> + +<meta name="description" content="2220 (Carbs Linux User Manual)"> +<meta name="keywords" content="2220 (Carbs Linux User Manual)"> +<meta name="resource-type" content="document"> +<meta name="distribution" content="global"> +<meta name="Generator" content="makeinfo"> +<style type="text/css"> +<!-- +a.summary-letter {text-decoration: none} +blockquote.indentedblock {margin-right: 0em} +div.display {margin-left: 3.2em} +div.example {margin-left: 3.2em} +div.lisp {margin-left: 3.2em} +kbd {font-style: oblique} +pre.display {font-family: inherit} +pre.format {font-family: inherit} +pre.menu-comment {font-family: serif} +pre.menu-preformatted {font-family: serif} +span.nolinebreak {white-space: nowrap} +span.roman {font-family: initial; font-weight: normal} +span.sansserif {font-family: sans-serif; font-weight: normal} +ul.no-bullet {list-style: none} +--> +</style> + +<meta http-equiv="Refresh" content="0; url=Repository-Conventions.html#g_t2220"> + +</head> + +<body lang="en"> + +<p>The node you are looking for is at <a href="Repository-Conventions.html#g_t2220">2220</a>.</p> +</body> diff --git a/src/docs/2230.html b/src/docs/2230.html new file mode 100644 index 0000000..42c9004 --- /dev/null +++ b/src/docs/2230.html @@ -0,0 +1,43 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> +<html> +<!-- Copyright (C) 2020 Cem Keylan + +Licensed under Gnu Free Documentation License. --> +<!-- Created by GNU Texinfo 6.7, http://www.gnu.org/software/texinfo/ --> +<!-- This file redirects to the location of a node or anchor --> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> +<title>2230 (Carbs Linux User Manual)</title> + +<meta name="description" content="2230 (Carbs Linux User Manual)"> +<meta name="keywords" content="2230 (Carbs Linux User Manual)"> +<meta name="resource-type" content="document"> +<meta name="distribution" content="global"> +<meta name="Generator" content="makeinfo"> +<style type="text/css"> +<!-- +a.summary-letter {text-decoration: none} +blockquote.indentedblock {margin-right: 0em} +div.display {margin-left: 3.2em} +div.example {margin-left: 3.2em} +div.lisp {margin-left: 3.2em} +kbd {font-style: oblique} +pre.display {font-family: inherit} +pre.format {font-family: inherit} +pre.menu-comment {font-family: serif} +pre.menu-preformatted {font-family: serif} +span.nolinebreak {white-space: nowrap} +span.roman {font-family: initial; font-weight: normal} +span.sansserif {font-family: sans-serif; font-weight: normal} +ul.no-bullet {list-style: none} +--> +</style> + +<meta http-equiv="Refresh" content="0; url=Repository-Conventions.html#g_t2230"> + +</head> + +<body lang="en"> + +<p>The node you are looking for is at <a href="Repository-Conventions.html#g_t2230">2230</a>.</p> +</body> diff --git a/src/docs/2240.html b/src/docs/2240.html new file mode 100644 index 0000000..4417ca4 --- /dev/null +++ b/src/docs/2240.html @@ -0,0 +1,43 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> +<html> +<!-- Copyright (C) 2020 Cem Keylan + +Licensed under Gnu Free Documentation License. --> +<!-- Created by GNU Texinfo 6.7, http://www.gnu.org/software/texinfo/ --> +<!-- This file redirects to the location of a node or anchor --> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> +<title>2240 (Carbs Linux User Manual)</title> + +<meta name="description" content="2240 (Carbs Linux User Manual)"> +<meta name="keywords" content="2240 (Carbs Linux User Manual)"> +<meta name="resource-type" content="document"> +<meta name="distribution" content="global"> +<meta name="Generator" content="makeinfo"> +<style type="text/css"> +<!-- +a.summary-letter {text-decoration: none} +blockquote.indentedblock {margin-right: 0em} +div.display {margin-left: 3.2em} +div.example {margin-left: 3.2em} +div.lisp {margin-left: 3.2em} +kbd {font-style: oblique} +pre.display {font-family: inherit} +pre.format {font-family: inherit} +pre.menu-comment {font-family: serif} +pre.menu-preformatted {font-family: serif} +span.nolinebreak {white-space: nowrap} +span.roman {font-family: initial; font-weight: normal} +span.sansserif {font-family: sans-serif; font-weight: normal} +ul.no-bullet {list-style: none} +--> +</style> + +<meta http-equiv="Refresh" content="0; url=Repository-Conventions.html#g_t2240"> + +</head> + +<body lang="en"> + +<p>The node you are looking for is at <a href="Repository-Conventions.html#g_t2240">2240</a>.</p> +</body> diff --git a/src/docs/2241.html b/src/docs/2241.html new file mode 100644 index 0000000..6cb5a09 --- /dev/null +++ b/src/docs/2241.html @@ -0,0 +1,43 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> +<html> +<!-- Copyright (C) 2020 Cem Keylan + +Licensed under Gnu Free Documentation License. --> +<!-- Created by GNU Texinfo 6.7, http://www.gnu.org/software/texinfo/ --> +<!-- This file redirects to the location of a node or anchor --> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> +<title>2241 (Carbs Linux User Manual)</title> + +<meta name="description" content="2241 (Carbs Linux User Manual)"> +<meta name="keywords" content="2241 (Carbs Linux User Manual)"> +<meta name="resource-type" content="document"> +<meta name="distribution" content="global"> +<meta name="Generator" content="makeinfo"> +<style type="text/css"> +<!-- +a.summary-letter {text-decoration: none} +blockquote.indentedblock {margin-right: 0em} +div.display {margin-left: 3.2em} +div.example {margin-left: 3.2em} +div.lisp {margin-left: 3.2em} +kbd {font-style: oblique} +pre.display {font-family: inherit} +pre.format {font-family: inherit} +pre.menu-comment {font-family: serif} +pre.menu-preformatted {font-family: serif} +span.nolinebreak {white-space: nowrap} +span.roman {font-family: initial; font-weight: normal} +span.sansserif {font-family: sans-serif; font-weight: normal} +ul.no-bullet {list-style: none} +--> +</style> + +<meta http-equiv="Refresh" content="0; url=Repository-Conventions.html#g_t2241"> + +</head> + +<body lang="en"> + +<p>The node you are looking for is at <a href="Repository-Conventions.html#g_t2241">2241</a>.</p> +</body> diff --git a/src/docs/Contribution-Guidelines.html b/src/docs/Contribution-Guidelines.html index 986da28..f11356d 100644 --- a/src/docs/Contribution-Guidelines.html +++ b/src/docs/Contribution-Guidelines.html @@ -48,12 +48,14 @@ Next: <a href="Init-System.html" accesskey="n" rel="next">Init System</a>, Previ <span id="Contribution-Guidelines-1"></span><h2 class="chapter">3 Contribution Guidelines</h2> <p>Thanks for taking your time to contribute! To maintain stylistic behaviour -throughout the repositories, one must adhere to these guidelines. Exceptions and -changes may occur with good reasoning. +throughout the repositories, one must adhere to these conventions. Exceptions +and changes may occur with good reasoning. </p> <table class="menu" border="0" cellspacing="0"> <tr><td align="left" valign="top">• <a href="Conventions.html" accesskey="1">Conventions</a></td><td> </td><td align="left" valign="top"> </td></tr> +<tr><td align="left" valign="top">• <a href="Sending-Git-mails.html" accesskey="2">Sending Git mails</a></td><td> </td><td align="left" valign="top"> +</td></tr> </table> diff --git a/src/docs/Conventions.html b/src/docs/Conventions.html index 042f21d..55c3972 100644 --- a/src/docs/Conventions.html +++ b/src/docs/Conventions.html @@ -15,7 +15,7 @@ Licensed under Gnu Free Documentation License. --> <meta name="Generator" content="makeinfo"> <link href="index.html" rel="start" title="Top"> <link href="Contribution-Guidelines.html" rel="up" title="Contribution Guidelines"> -<link href="Init-System.html" rel="next" title="Init System"> +<link href="General-Conventions.html" rel="next" title="General Conventions"> <link href="Contribution-Guidelines.html" rel="prev" title="Contribution Guidelines"> <style type="text/css"> <!-- @@ -42,59 +42,20 @@ ul.no-bullet {list-style: none} <body lang="en"> <span id="Conventions"></span><div class="header"> <p> -Up: <a href="Contribution-Guidelines.html" accesskey="u" rel="up">Contribution Guidelines</a> </p> +Next: <a href="Sending-Git-mails.html" accesskey="n" rel="next">Sending Git mails</a>, Up: <a href="Contribution-Guidelines.html" accesskey="u" rel="up">Contribution Guidelines</a> </p> </div> <hr> <span id="Conventions-1"></span><h3 class="section">3.1 Conventions</h3> -<span id="General-Conventions-_002d_002d-00"></span><h4 class="subsection">3.1.1 General Conventions – 00</h4> -<p>These apply to each and every file on the repositories. -</p> -<ul> -<li> Try to keep the file readable. <strong>[<span id="g_t0010"></span>0010]</strong> -<ul> -<li> Characters on a line shouldn’t exceed 100 characters excluding indentation. <strong>[<span id="g_t0011"></span>0011]</strong> -</li><li> Make sure you don’t have code commented out during commit. Uncomment them -or remove them completely. <strong>[<span id="g_t0012"></span>0012]</strong> -</li><li> Do not add comments following the code, add them to the top of the code. It -makes it harder to read, and lines longer. <strong>[<span id="g_t0013"></span>0013]</strong> -Here is an example: -<div class="example"> -<pre class="example"># Good way of commenting. -your code goes here +<table class="menu" border="0" cellspacing="0"> +<tr><td align="left" valign="top">• <a href="General-Conventions.html" accesskey="1">General Conventions – 00</a></td><td> </td><td align="left" valign="top"> +</td></tr> +<tr><td align="left" valign="top">• <a href="Shell-Conventions.html" accesskey="2">Shell Conventions – 10</a></td><td> </td><td align="left" valign="top"> +</td></tr> +<tr><td align="left" valign="top">• <a href="Repository-Conventions.html" accesskey="3">Repository Conventions – 20</a></td><td> </td><td align="left" valign="top"> +</td></tr> +</table> -your code goes here # Avoid this way of commenting. -</pre></div> -</li></ul> -</li></ul> - -<span id="Shell-Conventions-_002d_002d-10"></span><h4 class="subsection">3.1.2 Shell Conventions – 10</h4> - -<p>Shell is central to Carbs Linux projects. Most of the tools and packages are -written in POSIX sh. -</p> -<ul> -<li> Use 4 spaces for indentation, instead of tabs. <strong>[<span id="g_t1010"></span>1010]</strong> -</li><li> Make sure you don’t use bash-specific code. <strong>[<span id="g_t1020"></span>1020]</strong> -</li><li> Make sure you lint your code with <code>shellcheck</code> and if you are new to -POSIX sh, use <code>checkbashisms</code>. <strong>[<span id="g_t1030"></span>1030]</strong> -</li><li> Don’t spawn new processes if you don’t absolutely need to, especially during -string manipulation. <strong>[<span id="g_t1040"></span>1040]</strong> -<ul> -<li> Never use a program for text manupilation that isn’t defined in the POSIX -standard. This includes <code>gawk</code> and <code>perl</code>. <strong>[<span id="g_t1041"></span>1041]</strong> -</li><li> Instead of <code>$(basename $file)</code>, use <code>${file##*}</code>. <strong>[<span id="g_t1042"></span>1042]</strong> -</li><li> Instead of <code>$(dirname $file)</code>, use <code>${file%/*}</code>. <strong>[<span id="g_t1043"></span>1043]</strong> -</li></ul> -<div class="example"> -<pre class="example"># This is the same thing as <code>basename /path/to/test.asc .asc</code> - -$ file=/path/to/test.asc file=${file##*/} file=${file%.asc} -$ echo $file -test -</pre></div> -</li><li> Instead of backticks, use <tt>$(..)</tt>. <strong>[<span id="g_t1050"></span>1050]</strong> -</li></ul> diff --git a/src/docs/General-Conventions.html b/src/docs/General-Conventions.html new file mode 100644 index 0000000..a75fca5 --- /dev/null +++ b/src/docs/General-Conventions.html @@ -0,0 +1,79 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> +<html> +<!-- Copyright (C) 2020 Cem Keylan + +Licensed under Gnu Free Documentation License. --> +<!-- Created by GNU Texinfo 6.7, http://www.gnu.org/software/texinfo/ --> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> +<title>General Conventions (Carbs Linux User Manual)</title> + +<meta name="description" content="General Conventions (Carbs Linux User Manual)"> +<meta name="keywords" content="General Conventions (Carbs Linux User Manual)"> +<meta name="resource-type" content="document"> +<meta name="distribution" content="global"> +<meta name="Generator" content="makeinfo"> +<link href="index.html" rel="start" title="Top"> +<link href="Conventions.html" rel="up" title="Conventions"> +<link href="Shell-Conventions.html" rel="next" title="Shell Conventions"> +<link href="Conventions.html" rel="prev" title="Conventions"> +<style type="text/css"> +<!-- +a.summary-letter {text-decoration: none} +blockquote.indentedblock {margin-right: 0em} +div.display {margin-left: 3.2em} +div.example {margin-left: 3.2em} +div.lisp {margin-left: 3.2em} +kbd {font-style: oblique} +pre.display {font-family: inherit} +pre.format {font-family: inherit} +pre.menu-comment {font-family: serif} +pre.menu-preformatted {font-family: serif} +span.nolinebreak {white-space: nowrap} +span.roman {font-family: initial; font-weight: normal} +span.sansserif {font-family: sans-serif; font-weight: normal} +ul.no-bullet {list-style: none} +--> +</style> + + +</head> + +<body lang="en"> +<span id="General-Conventions"></span><div class="header"> +<p> +Next: <a href="Shell-Conventions.html" accesskey="n" rel="next">Shell Conventions</a>, Up: <a href="Conventions.html" accesskey="u" rel="up">Conventions</a> </p> +</div> +<hr> +<span id="General-Conventions-_002d_002d-00"></span><h4 class="subsection">3.1.1 General Conventions – 00</h4> + +<dl compact="compact"> +<dt><strong>[<span id="g_t0010"></span>0010]</strong></dt> +<dd><p>Try to keep the file readable. +</p><dl compact="compact"> +<dt><strong>[<span id="g_t0011"></span>0011]</strong></dt> +<dd><p>Characters on a line shouldn’t exceed 100 characters. +</p></dd> +<dt><strong>[<span id="g_t0012"></span>0012]</strong></dt> +<dd><p>Make sure you don’t have code commented out during commit. Uncomment them +or remove them completely. +</p></dd> +<dt><strong>[<span id="g_t0013"></span>0013]</strong></dt> +<dd><p>Do not add comments following the code, add them to the top of the code. It +makes it harder to read, and lines longer. Here is an example: +</p><div class="example"> +<pre class="example"># Good way of commenting. +your code goes here + +your code goes here # Avoid this way of commenting. +</pre></div> +</dd> +</dl> +</dd> +</dl> + + + + +</body> +</html> diff --git a/src/docs/Init-System.html b/src/docs/Init-System.html index afbd087..285dfab 100644 --- a/src/docs/Init-System.html +++ b/src/docs/Init-System.html @@ -16,7 +16,7 @@ Licensed under Gnu Free Documentation License. --> <link href="index.html" rel="start" title="Top"> <link href="index.html" rel="up" title="Top"> <link href="Configuring-Init.html" rel="next" title="Configuring Init"> -<link href="Conventions.html" rel="prev" title="Conventions"> +<link href="Sending-Git-mails.html" rel="prev" title="Sending Git mails"> <style type="text/css"> <!-- a.summary-letter {text-decoration: none} diff --git a/src/docs/Repository-Conventions.html b/src/docs/Repository-Conventions.html new file mode 100644 index 0000000..bb276dc --- /dev/null +++ b/src/docs/Repository-Conventions.html @@ -0,0 +1,207 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> +<html> +<!-- Copyright (C) 2020 Cem Keylan + +Licensed under Gnu Free Documentation License. --> +<!-- Created by GNU Texinfo 6.7, http://www.gnu.org/software/texinfo/ --> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> +<title>Repository Conventions (Carbs Linux User Manual)</title> + +<meta name="description" content="Repository Conventions (Carbs Linux User Manual)"> +<meta name="keywords" content="Repository Conventions (Carbs Linux User Manual)"> +<meta name="resource-type" content="document"> +<meta name="distribution" content="global"> +<meta name="Generator" content="makeinfo"> +<link href="index.html" rel="start" title="Top"> +<link href="Conventions.html" rel="up" title="Conventions"> +<link href="Sending-Git-mails.html" rel="next" title="Sending Git mails"> +<link href="Shell-Conventions.html" rel="prev" title="Shell Conventions"> +<style type="text/css"> +<!-- +a.summary-letter {text-decoration: none} +blockquote.indentedblock {margin-right: 0em} +div.display {margin-left: 3.2em} +div.example {margin-left: 3.2em} +div.lisp {margin-left: 3.2em} +kbd {font-style: oblique} +pre.display {font-family: inherit} +pre.format {font-family: inherit} +pre.menu-comment {font-family: serif} +pre.menu-preformatted {font-family: serif} +span.nolinebreak {white-space: nowrap} +span.roman {font-family: initial; font-weight: normal} +span.sansserif {font-family: sans-serif; font-weight: normal} +ul.no-bullet {list-style: none} +--> +</style> + + +</head> + +<body lang="en"> +<span id="Repository-Conventions"></span><div class="header"> +<p> +Previous: <a href="Shell-Conventions.html" accesskey="p" rel="prev">Shell Conventions</a>, Up: <a href="Conventions.html" accesskey="u" rel="up">Conventions</a> </p> +</div> +<hr> +<span id="Repository-Conventions-_002d_002d-20"></span><h4 class="subsection">3.1.3 Repository Conventions – 20</h4> + +<p>Repository conventions are important in order to ensure every package resemble +themselves. Here are the things to keep in mind: +</p> +<dl compact="compact"> +<dt><strong>[<span id="g_t2010"></span>2010]</strong></dt> +<dd><p>Prefer tarballs over git packages unless there is a sensible reason. +Here are some: +</p> +<ul> +<li> Every patch is a new release. (See <a href="https://github.com/vim/vim">vim</a>) +</li><li> There are no releases. (See <a href="https://git.suckless.org/sbase">https://git.suckless.org/sbase</a>) +</li><li> Following a development branch. +</li><li> There has been a long time since the latest release, but upstream is far ahead. +</li></ul> + +</dd> +<dt><strong>[<span id="g_t2020"></span>2020]</strong></dt> +<dd><p>Prefer sources without a dependency to <code>automake</code>. There are usually +distribution tarballs that are <code>autoconf</code>’ed. Don’t submit tarballs +with an automake dependency unless you are <strong>sure</strong> there is no +alternative. +</p></dd> +<dt><strong>[<span id="g_t2030"></span>2030]</strong></dt> +<dd><p>Avoid these packages: +</p><dl compact="compact"> +<dt><code>dbus</code></dt> +<dd><p>Usually can be disabled by <samp>--disable-dbus</samp> +</p></dd> +<dt><code>gettext</code></dt> +<dd><p>Usually can be disabled by <samp>--disable-nls</samp> +</p></dd> +</dl> +</dd> +<dt><strong>[<span id="g_t2040"></span>2040]</strong></dt> +<dd><ul> +<li> Always install a package to the <samp>/usr</samp> prefix. +</li><li> All binaries should go to <samp>/usr/bin</samp>, not <samp>/usr/sbin</samp> or any other +directory. +</li><li> All libraries should go to <samp>/usr/lib</samp>. +</li></ul> +</dd> +<dt><strong>[<span id="g_t2050"></span>2050]</strong></dt> +<dd><p>All build files on the repository should be a POSIX shell script, and must start +with <code>#!/bin/sh -e</code>. +</p></dd> +</dl> + +<p>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. +</p> +<p><strong>[<span id="g_t2210"></span>2210] Make</strong> +</p> +<div class="example"> +<pre class="example">#!/bin/sh -e + +make +make DESTDIR="$1" PREFIX=/usr install +</pre></div> + +<p><strong>[<span id="g_t2211"></span>2211] Configure/Make</strong> +</p> +<div class="example"> +<pre class="example">#!/bin/sh -e + +./configure \ + --prefix=/usr \ + --disable-option \ + --enable-option + +make +make DESTDIR="$1" install +</pre></div> + + +<p><strong>[<span id="g_t2212"></span>2212] Autoconf/Automake</strong> +</p> +<p>See <a href="#g_t2020">2020</a> +</p> +<div class="example"> +<pre class="example">#!/bin/sh -e + +autoreconf -fi + +./configure \ + --prefix=/usr \ + --disable-option \ + --enable-option + +make +make DESTDIR="$1" install +</pre></div> + +<p><strong>[<span id="g_t2220"></span>2220] Meson</strong> +</p> +<div class="example"> +<pre class="example">#!/bin/sh -e + +export DESTDIR=$1 + +meson \ + --prefix=/usr \ + -Doption=false \ + -Doption2=true \ + . output + +ninja -C output +ninja -C output install +</pre></div> + +<p><strong>[<span id="g_t2230"></span>2230] Cmake</strong> +</p> +<div class="example"> +<pre class="example">#!/bin/sh -e + +export DESTDIR=$1 + +cmake -B build \ + -DCMAKE_INSTALL_PREFIX=/usr \ + -DCMAKE_BUILD_TYPE=Release \ + -DOPTION=ON + +cmake --build build +cmake --install build +</pre></div> + +<p><strong>[<span id="g_t2240"></span>2240] Go</strong> +</p> +<div class="example"> +<pre class="example">#!/bin/sh -e + +export GOPATH=$PWD/gopath +trap "go clean -modcache" EXIT INT +go mod vendor + +go build +install -Dm755 program "$1/usr/bin/program" +</pre></div> + +<p><strong>[<span id="g_t2241"></span>2241] Python</strong> +</p> +<div class="example"> +<pre class="example">#!/bin/sh -e + +python setup.py build +python setup.py install --prefix=/usr --root="$1" +</pre></div> + +<hr> +<div class="header"> +<p> +Previous: <a href="Shell-Conventions.html" accesskey="p" rel="prev">Shell Conventions</a>, Up: <a href="Conventions.html" accesskey="u" rel="up">Conventions</a> </p> +</div> + + + +</body> +</html> diff --git a/src/docs/Sending-Git-mails.html b/src/docs/Sending-Git-mails.html new file mode 100644 index 0000000..86fa2f7 --- /dev/null +++ b/src/docs/Sending-Git-mails.html @@ -0,0 +1,95 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> +<html> +<!-- Copyright (C) 2020 Cem Keylan + +Licensed under Gnu Free Documentation License. --> +<!-- Created by GNU Texinfo 6.7, http://www.gnu.org/software/texinfo/ --> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> +<title>Sending Git mails (Carbs Linux User Manual)</title> + +<meta name="description" content="Sending Git mails (Carbs Linux User Manual)"> +<meta name="keywords" content="Sending Git mails (Carbs Linux User Manual)"> +<meta name="resource-type" content="document"> +<meta name="distribution" content="global"> +<meta name="Generator" content="makeinfo"> +<link href="index.html" rel="start" title="Top"> +<link href="Contribution-Guidelines.html" rel="up" title="Contribution Guidelines"> +<link href="Init-System.html" rel="next" title="Init System"> +<link href="Repository-Conventions.html" rel="prev" title="Repository Conventions"> +<style type="text/css"> +<!-- +a.summary-letter {text-decoration: none} +blockquote.indentedblock {margin-right: 0em} +div.display {margin-left: 3.2em} +div.example {margin-left: 3.2em} +div.lisp {margin-left: 3.2em} +kbd {font-style: oblique} +pre.display {font-family: inherit} +pre.format {font-family: inherit} +pre.menu-comment {font-family: serif} +pre.menu-preformatted {font-family: serif} +span.nolinebreak {white-space: nowrap} +span.roman {font-family: initial; font-weight: normal} +span.sansserif {font-family: sans-serif; font-weight: normal} +ul.no-bullet {list-style: none} +--> +</style> + + +</head> + +<body lang="en"> +<span id="Sending-Git-mails"></span><div class="header"> +<p> +Previous: <a href="Conventions.html" accesskey="p" rel="prev">Conventions</a>, Up: <a href="Contribution-Guidelines.html" accesskey="u" rel="up">Contribution Guidelines</a> </p> +</div> +<hr> +<span id="Sending-Git-mails-1"></span><h3 class="section">3.2 Sending Git mails</h3> + +<p>As mentioned, the preferred way of contribution is via patches. The easiest way +for sending git mails without <code>git send-email</code> is using <code>msmtp</code>. +You can install it from the repository by doing: +</p> +<div class="example"> +<pre class="example">$ cpt b msmtp && cpt i msmtp +</pre></div> + +<p>You can then edit <samp>~/.config/msmtp/config</samp> to add your email. Here is an +example configuration, you can use <code>pass</code>, <code>pash</code>, or any other +password manager that fits your needs: +</p> +<div class="example"> +<pre class="example">defaults +auth on +tls on +tls_trust_file /etc/ssl/certs/ca-certificates.crt +logfile ~/.config/msmtp/msmtp.log +account my-mail +host mail.example.com +port 587 +from me@example.com +user me@example.com +passwordeval "pass my-mail" +</pre></div> + +<p>In order to simply send your patch, do the following: +</p> +<div class="example"> +<pre class="example">$ git format-patch --to=~carbslinux/dev+subscribe@lists.sr.ht -1 --stdout | + msmtp -t -a my-mail +</pre></div> + +<p>You can also send multiple patches by doing the following: +</p> +<div class="example"> +<pre class="example">$ 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 +</pre></div> + + + +</body> +</html> diff --git a/src/docs/Setting-up-an-rsync-repository-for-distribution.html b/src/docs/Setting-up-an-rsync-repository-for-distribution.html index 5c94c69..87dfe78 100644 --- a/src/docs/Setting-up-an-rsync-repository-for-distribution.html +++ b/src/docs/Setting-up-an-rsync-repository-for-distribution.html @@ -96,5 +96,6 @@ exec rsync --daemon --no-detach + </body> </html> diff --git a/src/docs/Shell-Conventions.html b/src/docs/Shell-Conventions.html new file mode 100644 index 0000000..bcaf8b9 --- /dev/null +++ b/src/docs/Shell-Conventions.html @@ -0,0 +1,96 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> +<html> +<!-- Copyright (C) 2020 Cem Keylan + +Licensed under Gnu Free Documentation License. --> +<!-- Created by GNU Texinfo 6.7, http://www.gnu.org/software/texinfo/ --> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> +<title>Shell Conventions (Carbs Linux User Manual)</title> + +<meta name="description" content="Shell Conventions (Carbs Linux User Manual)"> +<meta name="keywords" content="Shell Conventions (Carbs Linux User Manual)"> +<meta name="resource-type" content="document"> +<meta name="distribution" content="global"> +<meta name="Generator" content="makeinfo"> +<link href="index.html" rel="start" title="Top"> +<link href="Conventions.html" rel="up" title="Conventions"> +<link href="Repository-Conventions.html" rel="next" title="Repository Conventions"> +<link href="General-Conventions.html" rel="prev" title="General Conventions"> +<style type="text/css"> +<!-- +a.summary-letter {text-decoration: none} +blockquote.indentedblock {margin-right: 0em} +div.display {margin-left: 3.2em} +div.example {margin-left: 3.2em} +div.lisp {margin-left: 3.2em} +kbd {font-style: oblique} +pre.display {font-family: inherit} +pre.format {font-family: inherit} +pre.menu-comment {font-family: serif} +pre.menu-preformatted {font-family: serif} +span.nolinebreak {white-space: nowrap} +span.roman {font-family: initial; font-weight: normal} +span.sansserif {font-family: sans-serif; font-weight: normal} +ul.no-bullet {list-style: none} +--> +</style> + + +</head> + +<body lang="en"> +<span id="Shell-Conventions"></span><div class="header"> +<p> +Next: <a href="Repository-Conventions.html" accesskey="n" rel="next">Repository Conventions</a>, Previous: <a href="General-Conventions.html" accesskey="p" rel="prev">General Conventions</a>, Up: <a href="Conventions.html" accesskey="u" rel="up">Conventions</a> </p> +</div> +<hr> +<span id="Shell-Conventions-_002d_002d-10"></span><h4 class="subsection">3.1.2 Shell Conventions – 10</h4> + +<p>Shell is central to Carbs Linux projects. Most of the tools and packages are +written in POSIX sh. +</p> +<dl compact="compact"> +<dt><strong>[<span id="g_t1010"></span>1010]</strong></dt> +<dd><p>Use 4 spaces for indentation, don’t use tabs. +</p></dd> +<dt><strong>[<span id="g_t1020"></span>1020]</strong></dt> +<dd><p>Make sure you don’t use bash-specific code. +</p></dd> +<dt><strong>[<span id="g_t1030"></span>1030]</strong></dt> +<dd><p>Make sure you lint your code with <code>shellcheck</code> and if you are new to +POSIX sh, use <code>checkbashisms</code>. +</p></dd> +<dt><strong>[<span id="g_t1040"></span>1040]</strong></dt> +<dd><p>Don’t spawn new processes if you don’t absolutely need to, especially during +string manipulation. +</p><dl compact="compact"> +<dt><strong>[<span id="g_t1041"></span>1041]</strong></dt> +<dd><p>Never use a program for text manupilation that isn’t defined in the POSIX +standard. This includes <code>gawk</code> and <code>perl</code>. +</p></dd> +<dt><strong>[<span id="g_t1042"></span>1042]</strong></dt> +<dd><p>Instead of <code>$(basename $file)</code>, use <code>${file##*}</code>. +</p></dd> +<dt><strong>[<span id="g_t1043"></span>1043]</strong></dt> +<dd><p>Instead of <code>$(dirname $file)</code>, use <code>${file%/*}</code>. +</p></dd> +</dl> +<div class="example"> +<pre class="example"># This is the same thing as <code>basename /path/to/test.asc .asc</code> + +$ file=/path/to/test.asc file=${file##*/} file=${file%.asc} +$ echo $file +test +</pre></div> +</dd> +<dt><strong>[<span id="g_t1050"></span>1050]</strong></dt> +<dd><p>Instead of backticks, use <tt>$(..)</tt>. +</p></dd> +</dl> + + + + +</body> +</html> diff --git a/src/news.xml b/src/news.xml index 319cae7..521ac5d 100644 --- a/src/news.xml +++ b/src/news.xml @@ -9,7 +9,7 @@ <description>a simple linux distribution</description> <link>https://carbslinux.org</link> <atom:link href="https://carbslinux.org/news.xml" rel="self" type="application/rss+xml" /> - <lastBuildDate>Mon Sep 14 2020 09:00</lastBuildDate> + <lastBuildDate>Mon Sep 14 2020 17:00</lastBuildDate> <item> <title>Sep 03 2020</title> <pubDate>Thu, 03 Sep 2020</pubDate> diff --git a/src/rss.xml b/src/rss.xml index 1980970..10aaaef 100644 --- a/src/rss.xml +++ b/src/rss.xml @@ -9,7 +9,7 @@ <description>a simple linux distribution</description> <link>https://carbslinux.org</link> <atom:link href="https://carbslinux.org/rss.xml" rel="self" type="application/rss+xml" /> - <lastBuildDate>Mon Sep 14 2020 09:00</lastBuildDate> + <lastBuildDate>Mon Sep 14 2020 17:00</lastBuildDate> <item> <title>August 2020 News Post</title> <pubDate>Mon, 03 Aug 2020</pubDate> diff --git a/texidocs b/texidocs -Subproject fdebe8e585426ec55012108bcb16a2f16b044bd +Subproject 698d8ebd4c99da1a208c8cbe94d5c12a1c363e3 |