From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp0 ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms0.migadu.com with LMTPS id 4PCQLzRjVWE1CgEAgWs5BA (envelope-from ) for ; Thu, 30 Sep 2021 09:11:48 +0200 Received: from aspmx1.migadu.com ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp0 with LMTPS id +MFHKzRjVWGlBQAA1q6Kng (envelope-from ) for ; Thu, 30 Sep 2021 07:11:48 +0000 Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by aspmx1.migadu.com (Postfix) with ESMTPS id 72F2235DD for ; Thu, 30 Sep 2021 09:11:48 +0200 (CEST) Received: from localhost ([::1]:46268 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1mVqEN-0001tE-K6 for larch@yhetil.org; Thu, 30 Sep 2021 03:11:47 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:35014) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mVqBi-0006s1-Ot for guix-patches@gnu.org; Thu, 30 Sep 2021 03:09:02 -0400 Received: from debbugs.gnu.org ([209.51.188.43]:39752) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1mVqBi-0006A1-FB for guix-patches@gnu.org; Thu, 30 Sep 2021 03:09:02 -0400 Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1mVqBi-00024a-A8 for guix-patches@gnu.org; Thu, 30 Sep 2021 03:09:02 -0400 X-Loop: help-debbugs@gnu.org Subject: [bug#50873] [PATCH 5/5] doc: Document the =?UTF-8?Q?=E2=80=98guix?= home =?UTF-8?Q?import=E2=80=99?= subcommand. Resent-From: Andrew Tropin Original-Sender: "Debbugs-submit" Resent-CC: guix-patches@gnu.org Resent-Date: Thu, 30 Sep 2021 07:09:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 50873 X-GNU-PR-Package: guix-patches X-GNU-PR-Keywords: patch To: Xinglu Chen , 50873@debbugs.gnu.org Cc: Ludovic =?UTF-8?Q?Court=C3=A8s?= Received: via spool by 50873-submit@debbugs.gnu.org id=B50873.16329857407958 (code B ref 50873); Thu, 30 Sep 2021 07:09:02 +0000 Received: (at 50873) by debbugs.gnu.org; 30 Sep 2021 07:09:00 +0000 Received: from localhost ([127.0.0.1]:51298 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1mVqBf-00024I-U8 for submit@debbugs.gnu.org; Thu, 30 Sep 2021 03:09:00 -0400 Received: from mail-lf1-f49.google.com ([209.85.167.49]:34419) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1mVqBc-000241-9Q for 50873@debbugs.gnu.org; Thu, 30 Sep 2021 03:08:58 -0400 Received: by mail-lf1-f49.google.com with SMTP id g41so21202003lfv.1 for <50873@debbugs.gnu.org>; Thu, 30 Sep 2021 00:08:56 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=trop-in.20210112.gappssmtp.com; s=20210112; h=from:to:cc:subject:in-reply-to:references:date:message-id :mime-version; bh=bTeuW3+LMqEhwU25kEL+7oYUHmV1P6LodFInKksU4jQ=; b=rjydLJyTQmdzUI2bsvxAyuCOTwgw6y8CToVQdHqMwnxiGl+8UqhjlR7jRlJbNj47nd OKvMfGiN5knINtIm6Luiao6MSt9+k4qsjFhx0ar1eVg5ezcUPyOsm+1j+NaHUchoukki XxUcM/3ifYAcTZXOS6GIlHYy1lVoWb0UQ+6uhdXdEHfdAg8h9K5aiel3+Cljz+JXzzIP mlx12eJtMABYrT5QwW1Njy8MLuQxvIWUB5iGbWpH7abpsqeHNDIsshkiizIyHXeOBo5b VftHCc/IZQJBr2kozar9g1mBa5iCZCPDqnSNZjEvRJ9fWFvGskI68lvJec3MC6/oYoHB qiTQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=x-gm-message-state:from:to:cc:subject:in-reply-to:references:date :message-id:mime-version; bh=bTeuW3+LMqEhwU25kEL+7oYUHmV1P6LodFInKksU4jQ=; b=rBg1P+8BuPXkGQ+g/0HsyMoTlWKzU1f3m5ppxnSuJNrf87TBd/H3fQMmShLDl/wqoa mZlTyQP8j5GVMfCukyWcsPii17HfDpCN73QT3HxMTlmVL2eyvbY7VEcb7rrGaKwbofVt yOj5l1zluBUtnm++cWnG5ghpvy9i1P0UOS1Rqu1KTQmFaJIvGZve/y6OT5Ynr69JGX0I ogIGCFNQU/N+8wqRTzEX9V5qw2pJmmUjXUzGsg5UDURjJeQrJ8hLk+fcEHmxXblXKYrZ Yd2WExZY4G52kAHI0rvYBfOBjHuglXXjVLU9cWc8W5hh46Gb/GU0TIP0vpFjFjdzMyug jcRw== X-Gm-Message-State: AOAM5318PX0j/cALNCcleIiKdZqaxn8DoPCkr/sM7B2i/yqfjOUFhB5c HV60tTTVLcjEerSWQDDISGm3AQ== X-Google-Smtp-Source: ABdhPJwn48xORd89V96fCgRcbsToGq9UvuFENEh1Ohefp6oFdR5u9vUQcMo62rkVfs9uvfevJCW9yA== X-Received: by 2002:a2e:9b13:: with SMTP id u19mr4265647lji.41.1632985729947; Thu, 30 Sep 2021 00:08:49 -0700 (PDT) Received: from localhost (109-252-140-132.dynamic.spd-mgts.ru. [109.252.140.132]) by smtp.gmail.com with ESMTPSA id k26sm267316lfj.69.2021.09.30.00.08.48 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 30 Sep 2021 00:08:49 -0700 (PDT) From: Andrew Tropin In-Reply-To: References: Date: Thu, 30 Sep 2021 10:08:45 +0300 Message-ID: <87h7e2o802.fsf@trop.in> MIME-Version: 1.0 Content-Type: multipart/signed; boundary="=-=-="; micalg=pgp-sha512; protocol="application/pgp-signature" X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-BeenThere: guix-patches@gnu.org List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: guix-patches-bounces+larch=yhetil.org@gnu.org Sender: "Guix-patches" X-Migadu-Flow: FLOW_IN ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1632985908; h=from:from:sender:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:cc:mime-version:mime-version: content-type:content-type:resent-cc:resent-from:resent-sender: resent-message-id:in-reply-to:in-reply-to:references:references: list-id:list-help:list-unsubscribe:list-subscribe:list-post: dkim-signature; bh=bTeuW3+LMqEhwU25kEL+7oYUHmV1P6LodFInKksU4jQ=; b=KNKFhKVLam8x6oEsvweA6ox5CotJVu2lYRL4bdrTeSIBPygXM2IQe0lVt44vOxQAWBpBL2 1FZAZYeP6dl6gqYCm/MJFaxx0OaFIcsYxuWfIGdPEjhjCI4CKkkMAUqWM/MTXmUgHJIO2f 2lE1JO2ON5rn7E61e1Y/1IK5YSQPP7RLYW2H565l5BvNZFb5/HtoCbCz+nqLEQ34Ovbz/y aMBrnA93ETtTu53FdNWqrXWqPWIrISbFDZPJYuZcqy+1WQU188Sy2QQ3yYCXwz1I5lK/AC ddv8bEZrm8M7T9M2xC0k0NWd+YjvlKNWvgD06h6v38+51Ac8hD6RjJQld8hgfg== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1632985908; a=rsa-sha256; cv=none; b=Yp4vxDRpsVKFUeiyGft9cABMUagf4xo+ax7RvzyB02i1RnWPPbKcZt2kU0sIH/FSkeQMny nu+28psoTWS5+OslRAhg7LL/6hjBQdnAqm/7lAsQKVRIToJa95YtgkjxWU5hWDjrimgtic mzSgsHp+HM7c7Pr/OuMd8JVPjJCGyZe8guu33u+BJxLzYbGF8pWGetsioUsmM7yG8lpvlS WszQjMuCdwtkJe2IJB4ZTSHoI/wISM81KW4vH/F1sMoeDxSsMFMRnxfy9a/gzuE3QhGOn0 L7v9FJUyEzHGCRiyYxbcPRvSMh5zuzsp+Z+rS101/fTgrX4gv/ax9prjkd+40A== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=fail ("headers rsa verify failed") header.d=trop-in.20210112.gappssmtp.com header.s=20210112 header.b=rjydLJyT; dmarc=none; spf=pass (aspmx1.migadu.com: domain of guix-patches-bounces@gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=guix-patches-bounces@gnu.org X-Migadu-Spam-Score: -3.90 Authentication-Results: aspmx1.migadu.com; dkim=fail ("headers rsa verify failed") header.d=trop-in.20210112.gappssmtp.com header.s=20210112 header.b=rjydLJyT; dmarc=none; spf=pass (aspmx1.migadu.com: domain of guix-patches-bounces@gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=guix-patches-bounces@gnu.org X-Migadu-Queue-Id: 72F2235DD X-Spam-Score: -3.90 X-Migadu-Scanner: scn1.migadu.com X-TUID: Ebv2xdrjvnDR --=-=-= Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable On 2021-09-28 19:36, Xinglu Chen wrote: > * doc/guix.texi (Invoking guix home): Document =E2=80=98guix home import= =E2=80=99. > --- > doc/guix.texi | 33 +++++++++++++++++++++++++++++++++ > 1 file changed, 33 insertions(+) > > diff --git a/doc/guix.texi b/doc/guix.texi > index 7956652050..2c268705d0 100644 > --- a/doc/guix.texi > +++ b/doc/guix.texi > @@ -36088,6 +36088,39 @@ > $ guix home list-generations 10d > @end example >=20=20 > +@item import > +Generate a @dfn{home environment} from the packages in the default > +profile and configuration files found in the user's home directory. The > +configuration files will be copied to the specified directory. Note > +that not every home service that exists is supported (@pxref{Home > +Services}). > + > +@example > +$ guix home import ~/guix-config > +;; This "home-environment" file can be passed to 'guix home reconfigure' > +;; to reproduce the content of your profile. This is "symbolic": it only > +;; specifies package names. To reproduce the exact same profile, you al= so > +;; need to capture the channels being used, as returned by "guix describ= e". > +;; See the "Replicating Guix" section in the manual. > + > +(use-modules > + (gnu home) > + (gnu packages) > + (gnu home-services bash)) > + > +(home-environment > + (packages > + (map specification->package > + (list "glibc-locales" "nss-certs" "nss"))) > + (services > + (list (service > + home-bash-service-type > + (home-bash-configuration > + (bashrc > + (list (slurp-file-gexp It still uses slurp-file-gexp, which is not upstreamed, but overall looks ok. I'll make a rationale behind this function and the approach I picked in home services config serializers and will prepare some examples next week. Maybe it will convince Ludovic or maybe I'll change my mind and rework configuration records for home services to use file-like objects. > + (local-file "/home/alice/guix-config/.bashrc")))= )))))) > +@end example > + > @end table >=20=20 > @node Documentation --=-=-= Content-Type: application/pgp-signature; name="signature.asc" -----BEGIN PGP SIGNATURE----- iQIzBAEBCgAdFiEEKEGaxlA4dEDH6S/6IgjSCVjB3rAFAmFVYn0ACgkQIgjSCVjB 3rAXpw//Xy3kH7/bzCT5yRf1wKEsHX7Bs1eN0S51kkZY5fYQy9oqa9GwmQe0bMX7 xu3UMJhRt8ndFjLPtUIArVeSBhHFOi8uPpfBJPZzJQh1lp2XXxNx+ldp1VKHCuzO E/AxP21BJLKYZ3x+C2gO33nD/EhAg2d2NvRmC7sYG81EloDmOrgoVgfnp9REtbP/ hsK0S4H+XFNIbHYQ/Llt554Oz43crism4S277KqiDuRlcxAfApGCPO5/2iGLFGQt tEYtrDTEcVQtWqvAcA4I1y0wegxgUYkpTXa1Y54taMnQK3xfwm189XBpnQa0nBGJ +GcLIxVtcW6O28fB3Ocp5nqlptaQyEhB4frVJCPG+JQjSiRXvfyLuz7Lj3dXIS/r 5RjWBszzNIykzHvpnw2cpLughK0/yk9vnOcDpGnJOmLYdXCRPJ9hylSCXsuJPdzM t7CtI+galfI2N8fP5sNj08sazzVEqRS+l5uQyOiHVLKQY2Ez8yXnWJ9Scpzr275z SPNsN2NOtC6xrClauouRhPFFLNPsNv/WpGMZD8CyYHEjXogTrePGm8RJG50moFKQ u1HRIs/TKZ7OAYheJKXLuaUpuA3kBVXGZeARgoQpkDS/sq/V9TaB9Mq/MwXe1Bnp wa1O/87WQw9KPUFgpSPyAdk1aAzZt6cmxtwVzlnWRuFsm8bwdQw= =CSlo -----END PGP SIGNATURE----- --=-=-=--