aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorCem Keylan <cem@ckyln.com>2024-03-06 18:59:08 +0100
committerCem Keylan <cem@ckyln.com>2024-03-06 18:59:08 +0100
commit3dd47cab312977f52461281c6bc7e70abb76e516 (patch)
treeb82106bb446c1ef9b9049417527138bfc2f92121
parent46285bc8a9dea0dce013ad1c5d482483a7f33cce (diff)
downloaddocs-3dd47cab312977f52461281c6bc7e70abb76e516.tar.gz
contrib: add new guideline sectionHEADmaster
-rw-r--r--carbslinux.org19
-rw-r--r--carbslinux.texi24
-rw-r--r--carbslinux.txt22
3 files changed, 63 insertions, 2 deletions
diff --git a/carbslinux.org b/carbslinux.org
index 5d9e1c6..21b8117 100644
--- a/carbslinux.org
+++ b/carbslinux.org
@@ -977,6 +977,9 @@ ninja -C output install
install -Dm755 program "$1/usr/bin/program"
#+END_SRC
+*NOTE*: Follow 2242 if you are packaging for non-Community repository.
+#+TEXINFO: @xref{2242}
+
**** {{{sectid(2241, Python)}}}
#+BEGIN_SRC sh
@@ -986,6 +989,22 @@ ninja -C output install
python setup.py install --prefix=/usr --root="$1"
#+END_SRC
+**** {{{sectid(2242, Go (pre-vendored))}}}
+:PROPERTIES:
+:ID: d2c828ae-bc56-4183-8830-becbf6a812d1
+:END:
+
+If you are a distribution maintainer create and upload vendor tarballs
+so that no internet connection is required during package compilation at all.
+You can use the following template for this case:
+
+#+BEGIN_SRC sh
+#!/bin/sh -e
+
+go build -v -mod=vendor
+clinst -Dm755 program "$1/usr/bin/program"
+#+END_SRC
+
** Contributing to the Community repository
:PROPERTIES:
:DESCRIPTION: Package maintainership and issue reports
diff --git a/carbslinux.texi b/carbslinux.texi
index a67e4ea..d3be7f9 100644
--- a/carbslinux.texi
+++ b/carbslinux.texi
@@ -1012,7 +1012,7 @@ ahead.
@item [@anchor{2020}2020]
Prefer sources without a dependency to @samp{automake}. There
are usually distribution tarballs that are @samp{autoconf}'ed. Don't submit tarballs
-with an automake dependency unless you are @samp{sure} there is no alternative.
+with an automake dependency unless you are @strong{sure} there is no alternative.
@item [@anchor{2030}2030]
Avoid these packages:
@table @asis
@@ -1160,6 +1160,9 @@ go build
install -Dm755 program "$1/usr/bin/program"
@end example
+@strong{NOTE}: Follow 2242 if you are packaging for non-Community repository.
+@xref{2242}
+
@item
@anchor{Python [2241]}Python [2241]
@@ -1173,6 +1176,25 @@ install -Dm755 program "$1/usr/bin/program"
python setup.py build
python setup.py install --prefix=/usr --root="$1"
@end example
+
+@item
+@anchor{Go (pre-vendored) [2242]}Go (pre-vendored) [2242]
+
+
+@anchor{2242}
+
+:ID: d2c828ae-bc56-4183-8830-becbf6a812d1
+
+If you are a distribution maintainer create and upload vendor tarballs
+so that no internet connection is required during package compilation at all.
+You can use the following template for this case:
+
+@example
+#!/bin/sh -e
+
+go build -v -mod=vendor
+clinst -Dm755 program "$1/usr/bin/program"
+@end example
@end enumerate
@node Contributing to the Community repository
diff --git a/carbslinux.txt b/carbslinux.txt
index 2525c09..5fde782 100644
--- a/carbslinux.txt
+++ b/carbslinux.txt
@@ -891,7 +891,7 @@ with the info reader. It is divided into sections and easier to read.
Prefer sources without a dependency to `automake'. There are
usually distribution tarballs that are `autoconf''ed. Don't
submit tarballs with an automake dependency unless you are
- `sure' there is no alternative.
+ *sure* there is no alternative.
[2030]
Avoid these packages:
dbus
@@ -1029,6 +1029,8 @@ with the info reader. It is divided into sections and easier to read.
| install -Dm755 program "$1/usr/bin/program"
`----
+ *NOTE*: Follow 2242 if you are packaging for non-Community repository.
+
* 4.1.2.7 Python [2241]
@@ -1043,6 +1045,24 @@ with the info reader. It is divided into sections and easier to read.
`----
+* 4.1.2.8 Go (pre-vendored) [2242]
+
+
+
+ :ID: d2c828ae-bc56-4183-8830-becbf6a812d1
+
+ If you are a distribution maintainer create and upload vendor tarballs
+ so that no internet connection is required during package compilation
+ at all. You can use the following template for this case:
+
+ ,----
+ | #!/bin/sh -e
+ |
+ | go build -v -mod=vendor
+ | clinst -Dm755 program "$1/usr/bin/program"
+ `----
+
+
4.2 Contributing to the Community repository
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~