01/01: doc: Document how to enable qemu binfmt service and how to use it.

[guix-commits]

dannym pushed a commit to branch master
in repository guix.

commit 89339a35bd8610ec585da36f3da6ddf116c3fe89
Author: Danny Milosavljevic <address@hidden>
Date:   Sun Feb 3 16:29:00 2019 +0100

    doc: Document how to enable qemu binfmt service and how to use it.
    
    * doc/contributing.texi (Submitting Patches): Document how to enable qemu
    binfmt service and how to use it.
    
    Co-authored-by: Ricardo Wurmus <address@hidden>
---
 doc/contributing.texi | 27 +++++++++++++++++++++++++++
 1 file changed, 27 insertions(+)

diff --git a/doc/contributing.texi b/doc/contributing.texi
index d579a39..9459c48 100644
--- a/doc/contributing.texi
+++ b/doc/contributing.texi
@@ -818,6 +818,33 @@ Make sure the package builds on your platform, using 
@code{guix build
 @var{package}}.
 
 @item
+We recommend you also try building the package on other supported
+platforms.  As you may not have access to actual hardware platforms, we
+recommend using the @code{qemu-binfmt-service-type} to emulate them.  In
+order to enable it, add the following service to the list of services in
+your @code{operating-system} configuration:
+
address@hidden
+(service qemu-binfmt-service-type
+ (qemu-binfmt-configuration
+   (platforms (lookup-qemu-platforms "arm" "aarch64" "ppc" "mips64el"))
+   (guix-support? #t)))
address@hidden example
+
+Then reconfigure your system.
+
+You can then build packages for different platforms by specifying the
address@hidden option.  For example, to build the "hello" package for
+the armhf, aarch64, powerpc, or mips64 architectures, you would run the
+following commands, respectively:
address@hidden
+guix build --system=armhf-linux --rounds=2 hello
+guix build --system=aarch64-linux --rounds=2 hello
+guix build --system=powerpc-linux --rounds=2 hello
+guix build --system=mips64el-linux --rounds=2 hello
address@hidden example
+
address@hidden
 @cindex bundling
 Make sure the package does not use bundled copies of software already
 available as separate packages.