public inbox for isar-users@googlegroups.com
 help / color / mirror / Atom feed
From: Jan Kiszka <jan.kiszka@web.de>
To: isar-users <isar-users@googlegroups.com>
Subject: [PATCH] doc: Rework description of build dependencies installation
Date: Fri, 26 Aug 2022 11:03:28 +0200	[thread overview]
Message-ID: <2fd9b2b0-72ec-ac67-1f4c-42fc38589a07@web.de> (raw)

From: Jan Kiszka <jan.kiszka@siemens.com>

Fold in sbuild and schroot packages so that everything needed for
building is in one list.

Move qemu out of this list because it is only optional.

Reorder the note about adding the user to the sbuild group so that it
introduces the related command.

Signed-off-by: Jan Kiszka <jan.kiszka@siemens.com>
---
 doc/user_manual.md | 24 +++++++++++-------------
 1 file changed, 11 insertions(+), 13 deletions(-)

diff --git a/doc/user_manual.md b/doc/user_manual.md
index 546ae75c..5b2387d8 100644
--- a/doc/user_manual.md
+++ b/doc/user_manual.md
@@ -78,37 +78,30 @@ apt install \
   parted \
   python3 \
   quilt \
-  qemu \
   qemu-user-static \
   reprepro \
   sudo \
   git-buildpackage \
-  pristine-tar
+  pristine-tar \
+  sbuild \
+  schroot
 ```

-Additional setup is required since `sbuild` is now used for package build.
-Install the following packages:
+If your host is >= buster, also install the following package.
 ```
-apt install \
-  sbuild \
-  schroot
+apt install python3-distutils
 ```
-Also, user who runs isar should be added to `sbuild` group.

 **NOTE:** sbuild version (<=0.78.1) packaged in Debian Buster doesn't support
 `$apt_keep_downloaded_packages` option which is required in Isar for
 populating `${DL_DIR}/deb`. So, host `sbuild` in this case should be manually
 upgraded to >=0.81.2 version from Debian Bullseye.

+Next, the user who should run Isar needs to be added to `sbuild` group.
 ```
 sudo gpasswd -a <username> sbuild
 ```

-If your host is >= buster, also install the following package.
-```
-apt install python3-distutils
-```
-
 If you want to generate containerized SDKs, also install the following
 packages: `umoci` and `skopeo`.
 Umoci is provided by Debian Buster and can be installed with
@@ -129,6 +122,11 @@ Notes:
   handled by QEMU (check e.g. `qemu-arm` in `/usr/sbin/update-binfmts
   --display`).

+To run images built for QEMU, you also need to install the related package:
+```
+apt install qemu
+```
+
 ### Setup Sudo

 Isar requires `sudo` rights without password to work with `chroot` and `debootstrap`. To add them, use the following steps:
--
2.35.3


             reply	other threads:[~2022-08-26  9:03 UTC|newest]

Thread overview: 4+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2022-08-26  9:03 Jan Kiszka [this message]
2022-08-29 10:26 ` Anton Mikanovich
2022-08-30 18:05   ` Jan Kiszka
2022-09-05  7:39 ` Anton Mikanovich

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=2fd9b2b0-72ec-ac67-1f4c-42fc38589a07@web.de \
    --to=jan.kiszka@web.de \
    --cc=isar-users@googlegroups.com \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox