From mboxrd@z Thu Jan 1 00:00:00 1970
Return-Path: <gentoo-commits+bounces-1627796-garchives=archives.gentoo.org@lists.gentoo.org>
Received: from lists.gentoo.org (pigeon.gentoo.org [208.92.234.80])
(using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)
key-exchange X25519 server-signature RSA-PSS (2048 bits))
(No client certificate requested)
by finch.gentoo.org (Postfix) with ESMTPS id 92AE7158064
for <garchives@archives.gentoo.org>; Sat, 4 May 2024 11:57:37 +0000 (UTC)
Received: from pigeon.gentoo.org (localhost [127.0.0.1])
by pigeon.gentoo.org (Postfix) with SMTP id CC4D5E29C1;
Sat, 4 May 2024 11:57:36 +0000 (UTC)
Received: from smtp.gentoo.org (woodpecker.gentoo.org [140.211.166.183])
(using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)
key-exchange X25519 server-signature RSA-PSS (4096 bits))
(No client certificate requested)
by pigeon.gentoo.org (Postfix) with ESMTPS id A7CB5E29C1
for <gentoo-commits@lists.gentoo.org>; Sat, 4 May 2024 11:57:36 +0000 (UTC)
Received: from oystercatcher.gentoo.org (oystercatcher.gentoo.org [148.251.78.52])
(using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)
key-exchange X25519 server-signature RSA-PSS (4096 bits))
(No client certificate requested)
by smtp.gentoo.org (Postfix) with ESMTPS id B8992340806
for <gentoo-commits@lists.gentoo.org>; Sat, 4 May 2024 11:57:35 +0000 (UTC)
Received: from localhost.localdomain (localhost [IPv6:::1])
by oystercatcher.gentoo.org (Postfix) with ESMTP id 529CB15AF
for <gentoo-commits@lists.gentoo.org>; Sat, 4 May 2024 11:57:34 +0000 (UTC)
From: "Sam James" <sam@gentoo.org>
To: gentoo-commits@lists.gentoo.org
Content-Transfer-Encoding: 8bit
Content-type: text/plain; charset=UTF-8
Reply-To: gentoo-dev@lists.gentoo.org, "Sam James" <sam@gentoo.org>
Message-ID: <1714823832.5b76e726a4000e28a2bc7c76e3538027c745de48.sam@gentoo>
Subject: [gentoo-commits] proj/crossdev:master commit in: /
X-VCS-Repository: proj/crossdev
X-VCS-Files: README
X-VCS-Directories: /
X-VCS-Committer: sam
X-VCS-Committer-Name: Sam James
X-VCS-Revision: 5b76e726a4000e28a2bc7c76e3538027c745de48
X-VCS-Branch: master
Date: Sat, 4 May 2024 11:57:34 +0000 (UTC)
Precedence: bulk
List-Post: <mailto:gentoo-commits@lists.gentoo.org>
List-Help: <mailto:gentoo-commits+help@lists.gentoo.org>
List-Unsubscribe: <mailto:gentoo-commits+unsubscribe@lists.gentoo.org>
List-Subscribe: <mailto:gentoo-commits+subscribe@lists.gentoo.org>
List-Id: Gentoo Linux mail <gentoo-commits.gentoo.org>
X-BeenThere: gentoo-commits@lists.gentoo.org
X-Auto-Response-Suppress: DR, RN, NRN, OOF, AutoReply
X-Archives-Salt: 77d9d434-33dd-4aec-8505-ed9f909ecfe4
X-Archives-Hash: 543a520ae8c1ca3d7693d53c8cebe369
commit: 5b76e726a4000e28a2bc7c76e3538027c745de48
Author: Sam James <sam <AT> gentoo <DOT> org>
AuthorDate: Sat May 4 11:57:12 2024 +0000
Commit: Sam James <sam <AT> gentoo <DOT> org>
CommitDate: Sat May 4 11:57:12 2024 +0000
URL: https://gitweb.gentoo.org/proj/crossdev.git/commit/?id=5b76e726
README: small fixes
Signed-off-by: Sam James <sam <AT> gentoo.org>
README | 20 +++++++++++---------
1 file changed, 11 insertions(+), 9 deletions(-)
diff --git a/README b/README
index d4198b2..c37472e 100644
--- a/README
+++ b/README
@@ -15,7 +15,7 @@ It is useful for various purposes:
Crossdev nano HOWTO
-------------------
-So you want to cross-compile a Gentoo package (say busybox to s390x):
+So you want to cross-compile a Gentoo package (say, busybox to s390x):
# crossdev -t s390x-unknown-linux-gnu
# (optional) ARCH=s390 PORTAGE_CONFIGROOT=/usr/s390x-unknown-linux-gnu eselect profile set default/linux/s390/17.0/s390x
@@ -30,7 +30,7 @@ You can use qemu-user to run this binary:
$ qemu-s390x -L /usr/s390x-unknown-linux-gnu/ /usr/s390x-unknown-linux-gnu/bin/busybox uname -m
s390x
-or even chroot to /usr/s390x-unknown-linux-gnu directory!
+or even chroot to the /usr/s390x-unknown-linux-gnu directory!
https://wiki.gentoo.org/wiki/Crossdev_qemu-static-user-chroot
@@ -120,7 +120,7 @@ If toolchains were simple programs crossdev would be a one-liner script:
ROOT=... \
emerge "$@"
-Unfortunately todays' toolchains have loops in their build-time dependencies:
+Unfortunately today's toolchains have cycles/loops in their build-time dependencies:
- cross-compiler itself normally needs a libc built for <target> because
libc defines various aspects of userland ABI and features provided.
@@ -153,11 +153,13 @@ Done!
How crossdev works (more details)
---------------------------------
-This section contains more details on what actually happens.
+This section contains more details on what actually happens (what crossdev
+does for you).
+
Here we elaborate on each step outlined in previous section:
1. create an overlay with new ebuilds (symlinks to existing ebuilds)
- <skipping numeruos mkdir and ln commands>. After this step the
+ <skipping numerous mkdir and ln commands>. After this step the
outcomes are:
- overlay layout is formed in cross-overlay/:
@@ -262,19 +264,19 @@ Various notes (AKA dirty little tricks)
Some ./configure scripts rely on runtime feature testing. We would
still like to enable things even in cross-environment.
- crossdev installs /usr/share/config.site with a bunch of cache
+ crossdev installs /usr/share/config.site.d/80crossdev.conf with a bunch of cache
variables preset for targets. It might be a nice place to drop
more things into. Or it could be a source of all your cross-compilation
problems if variables set incorrect values.
- eclass importing
- To find out various things about target crossdev loads multilib.eclass
- and tries to find out default ABI supported by the target.
+ To find out various things about the target, crossdev loads multilib.eclass
+ and tries to find out the default ABI supported by the target.
- crossdev is just a tiny shell script around emerge :)
- It's full source code is comparable to the size of this README.
+ Its full source code is comparable to the size of this README.
- USE=headers-only