From 3dd47cab312977f52461281c6bc7e70abb76e516 Mon Sep 17 00:00:00 2001
From: Cem Keylan <cem@ckyln.com>
Date: Wed, 6 Mar 2024 18:59:08 +0100
Subject: contrib: add new guideline section

---
 carbslinux.org  | 19 +++++++++++++++++++
 carbslinux.texi | 24 +++++++++++++++++++++++-
 carbslinux.txt  | 22 +++++++++++++++++++++-
 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
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-- 
cgit v1.2.3