From unknown Mon Jun 16 23:30:26 2025 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable MIME-Version: 1.0 X-Mailer: MIME-tools 5.509 (Entity 5.509) Content-Type: text/plain; charset=utf-8 From: bug#35525 <35525@debbugs.gnu.org> To: bug#35525 <35525@debbugs.gnu.org> Subject: Status: guix-manual proposals Reply-To: bug#35525 <35525@debbugs.gnu.org> Date: Tue, 17 Jun 2025 06:30:26 +0000 retitle 35525 guix-manual proposals reassign 35525 guix submitter 35525 znavko@disroot.org severity 35525 normal thanks From debbugs-submit-bounces@debbugs.gnu.org Wed May 01 11:59:13 2019 Received: (at submit) by debbugs.gnu.org; 1 May 2019 15:59:13 +0000 Received: from localhost ([127.0.0.1]:44661 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hLrdY-0006Td-Lg for submit@debbugs.gnu.org; Wed, 01 May 2019 11:59:13 -0400 Received: from eggs.gnu.org ([209.51.188.92]:56158) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hLrdV-0006TQ-Kq for submit@debbugs.gnu.org; Wed, 01 May 2019 11:59:11 -0400 Received: from lists.gnu.org ([209.51.188.17]:58344) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1hLrdQ-00040z-Eq for submit@debbugs.gnu.org; Wed, 01 May 2019 11:59:04 -0400 Received: from eggs.gnu.org ([209.51.188.92]:42288) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1hLrdN-0000GS-9f for bug-guix@gnu.org; Wed, 01 May 2019 11:59:04 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1hLrdK-0003vK-7G for bug-guix@gnu.org; Wed, 01 May 2019 11:59:01 -0400 Received: from knopi.disroot.org ([178.21.23.139]:43132) by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1hLrdJ-0003rp-BE for bug-guix@gnu.org; Wed, 01 May 2019 11:58:58 -0400 Received: from localhost (localhost [127.0.0.1]) by disroot.org (Postfix) with ESMTP id 0C8A5303AE for ; Wed, 1 May 2019 17:58:54 +0200 (CEST) X-Virus-Scanned: Debian amavisd-new at disroot.org Received: from knopi.disroot.org ([127.0.0.1]) by localhost (disroot.org [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id g6ekCKRPAypc for ; Wed, 1 May 2019 17:58:52 +0200 (CEST) Mime-Version: 1.0 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=disroot.org; s=mail; t=1556726332; bh=xC3dKjlzWz0gNjEorbvVD6wHMRwPbKrMP4BII2vloeo=; h=Date:From:Subject:To; b=l8n+51ZdwkCpm9siWvJ7wwWCIOACE7loMrA3BrkzL02CXIBdyUwlhnHY6KwEo/ckP n/SxC7/yXT35NdxyRdoLG7mFTP5wEiJf1EfHHMd7Sg2fnz+TJQYWtU96WBnIH4E6NL 3gsnQaryW4WVKakYruOvENf8abFjyDfmSh3ExRI77k/q49SMmWi2361cqrLIUi1mW6 93tbGSZ4fgYz2rqsRkucH5PdAXI7Dcn36iy8p+Yx0VfTpOATUfbG63ojiDMWofsgAe lRxKT1O2KyK/ZQbDBI7Ys0eNYS9hDtm2TQHvE2G09bp1rMD6r+XlHrvAC7YFfShOn2 XdxdOaYkuQOVw== Date: Wed, 01 May 2019 15:58:52 +0000 Content-Type: multipart/alternative; boundary="--=_RainLoop_961_864802940.1556726332" From: znavko@disroot.org Message-ID: Subject: guix-manual proposals To: "bug-guix" X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 178.21.23.139 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x X-Spam-Score: -1.4 (-) X-Debbugs-Envelope-To: submit X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -2.4 (--) ----=_RainLoop_961_864802940.1556726332 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: quoted-printable Hello! Here it is 'many types of fs', but only one mentioned as example:= =0A=0A#. type: Plain text=0A#: doc/guix.texi:2268=0Amsgid ""=0A"Alternati= vely, you may use a swap file. For example, assuming that in the "=0A"new= system you want to use the file @file{/swapfile} as a swap file, you "= =0A"would run@footnote{This example will work for many types of file syst= ems (e."=0A"g., ext4). However, for copy-on-write file systems (e.g., btr= fs), the "=0A"required steps may be different. For details, see the manua= l pages for "=0A"@command{mkswap} and @command{swapon}.}:"=0AAlso, writin= g configuration step is not so easy when using manual installation. I thi= nk, there also should be a message with link to 'Graphical Installation',= that you can use graphical installation that will generate configuration= you need automatically.=0A=0A#. type: Plain text=0A#: doc/guix.texi:2315= =0Amsgid ""=0A"@xref{Using the Configuration System}, for an overview of = the configuration "=0A"file. The example configurations discussed in that= section are available "=0A"under @file{/etc/configuration} in the instal= lation image. Thus, to get "=0A"started with a system configuration provi= ding a graphical display server (a "=0A"``desktop'' system), you can run = something along these lines:"=0A=0AAnd also if another language is ready = to use (Spanish), need to say it on:=0A=0A#. type: Plain text=0A#: doc/gu= ix.texi:117=0Amsgid ""=0A"This manual is also available in French (@pxref= {Top,,, guix.fr, Manuel de "=0A"r=C3=A9f=C3=A9rence de GNU Guix}) and Ger= man (@pxref{Top,,, guix.de, Referenzhandbuch "=0A"zu GNU Guix}). If you w= ould like to translate it in your native language, "=0A"consider joining = the @uref{https://translationproject.org/domain/guix-manual."=0A"html, Tr= anslation Project}." ----=_RainLoop_961_864802940.1556726332 Content-Type: text/html; charset="utf-8" Content-Transfer-Encoding: quoted-printable
H= ello! Here it is 'many types of fs', but only one mentioned as example:
#. type: Plain text
#: doc/guix.texi:2268=
msgid ""
"Alternatively, you may use a swap file. For example, ass= uming that in the "
"new system you want to use the file @file{/swapfi= le} as a swap file, you "
"would run@footnote{This example will work f= or many types of file systems (e."
"g., ext4). However, for copy-on-wr= ite file systems (e.g., btrfs), the "
"required steps may be different= . For details, see the manual pages for "
"@command{mkswap} and @comma= nd{swapon}.}:"


Also, writing configuration step is not so easy= when using manual installation. I think, there also should be a message = with link to 'Graphical Installation', that you can use graphical install= ation that will generate configuration you need automatically.

#. = type: Plain text
#: doc/guix.texi:2315
msgid ""
"@xref{Using the= Configuration System}, for an overview of the configuration "
"file. = The example configurations discussed in that section are available "
"= under @file{/etc/configuration} in the installation image. Thus, to get "=
"started with a system configuration providing a graphical display se= rver (a "
"``desktop'' system), you can run something along these line= s:"

And also if another language is ready to use (Spanish), need t= o say it on:

#. type: Plain text
#: doc/guix.texi:117
msgid = ""
"This manual is also available in French (@pxref{Top,,, guix.fr, Ma= nuel de "
"r=C3=A9f=C3=A9rence de GNU Guix}) and German (@pxref{Top,,,= guix.de, Referenzhandbuch "
"zu GNU Guix}). If you would like to tran= slate it in your native language, "
"consider joining the @uref{https:= //translationproject.org/domain/guix-manual."
"html, Translation Proje= ct}."
----=_RainLoop_961_864802940.1556726332-- From debbugs-submit-bounces@debbugs.gnu.org Wed May 01 14:03:20 2019 Received: (at 35525) by debbugs.gnu.org; 1 May 2019 18:03:20 +0000 Received: from localhost ([127.0.0.1]:44865 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hLtZf-0003E1-DU for submit@debbugs.gnu.org; Wed, 01 May 2019 14:03:19 -0400 Received: from knopi.disroot.org ([178.21.23.139]:40184) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hLtZc-0003Dr-St for 35525@debbugs.gnu.org; Wed, 01 May 2019 14:03:18 -0400 Received: from localhost (localhost [127.0.0.1]) by disroot.org (Postfix) with ESMTP id 91F55303C2 for <35525@debbugs.gnu.org>; Wed, 1 May 2019 20:03:15 +0200 (CEST) X-Virus-Scanned: Debian amavisd-new at disroot.org Received: from knopi.disroot.org ([127.0.0.1]) by localhost (disroot.org [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id UuW6XW0Sz0vM for <35525@debbugs.gnu.org>; Wed, 1 May 2019 20:03:13 +0200 (CEST) Mime-Version: 1.0 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=disroot.org; s=mail; t=1556733790; bh=hHyKEHrVc68A5C37vHRezp7BkMoeKO8xioKS5VVceP4=; h=Date:From:Subject:To:In-Reply-To:References; b=iAfLbThPlAoURrVBV6mT9ygWONpyRJkMstYNiMr8tQq7j9HqCS+Bl8Y2KQF81wiDy ZjEp5PMEvjLf7v9YrAAm3ebQFKOpHD2JvPOqy5PirfjdbL2lrR2uQtR/FssIt0CwmM iq+IxAfcnnewi6kvARBTMhLJtXp0F1NyrqkWki0gOKf0IGUDu5MvlpJVkSrd9O2/GQ smSvTInW73dO6PZWpWQftNq00ps+3FlD0B4jwWwRni230RrSjBYOBKO4ZVRHnGNX+x oU/vCUf8LfFI69OQh7rVhbivxK4xykP2TPAoiMpDuPRHlb/NxKO6HNhW0y6Zzj5JQT QFIPbIRzGBg4w== Date: Wed, 01 May 2019 18:03:10 +0000 Content-Type: multipart/alternative; boundary="--=_RainLoop_664_271612391.1556733790" From: znavko@disroot.org Message-ID: <2530df52d53c8ac976ce37ed854b509a@disroot.org> Subject: Re: bug#35525: guix-manual proposals To: 35525@debbugs.gnu.org In-Reply-To: References: X-Spam-Score: 0.0 (/) X-Debbugs-Envelope-To: 35525 X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.0 (-) ----=_RainLoop_664_271612391.1556733790 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: quoted-printable Also here GuixSD rests instead of Guix System:=0A=0A#. type: Plain text= =0A#: doc/guix.texi:2650=0Amsgid ""=0A"If you are not using the Guix Syst= em Distribution, consider adding the "=0A"following lines to your @file{~= /.bash_profile} (@pxref{Bash Startup Files,,, "=0A"bash, The GNU Bash Ref= erence Manual}) so that newly-spawned shells get all "=0A"the right envir= onment variable definitions:"=0AAnd this text is English-specific, lacks = its features in another language, words 'force a local build' and 'challe= nge providers' in Russian has no direct translations:=0A=0A#. type: Plain= text=0A#: doc/guix.texi:2589 doc/guix.texi:2582=0Amsgid ""=0A"This found= ation allows Guix to support @dfn{transparent binary/source "=0A"deployme= nt}. When a pre-built binary for a @file{/gnu/store} item is "=0A"availab= le from an external source---a @dfn{substitute}, Guix just downloads "=0A= "it and unpacks it; otherwise, it builds the package from source, locally= "=0A"(@pxref{Substitutes}). Because build results are usually bit-for-bi= t "=0A"reproducible, users do not have to trust servers that provide subs= titutes: "=0A"they can force a local build and @emph{challenge} providers= (@pxref{Invoking "=0A"guix challenge})."=0Amsgstr "=D0=AD=D1=82=D0=B0 = =D0=BA=D0=BE=D0=BD=D1=86=D0=B5=D0=BF=D1=86=D0=B8=D1=8F =D0=BF=D0=BE=D0=B7= =D0=B2=D0=BE=D0=BB=D1=8F=D0=B5=D1=82 Guix =D0=BF=D0=BE=D0=B4=D0=B4=D0=B5= =D1=80=D0=B6=D0=B8=D0=B2=D0=B0=D1=82=D1=8C @dfn{=D0=BF=D1=80=D0=BE=D0=B7= =D1=80=D0=B0=D1=87=D0=BD=D0=BE=D0=B5 =D0=B2=D0=BD=D0=B5=D0=B4=D1=80=D0=B5= =D0=BD=D0=B8=D0=B5 =D0=B1=D0=B8=D0=BD=D0=B0=D1=80=D0=BD=D0=B8=D0=BA=D0=BE= =D0=B2/=D0=B8=D1=81=D1=85=D0=BE=D0=B4=D0=BD=D0=B8=D0=BA=D0=BE=D0=B2}. =D0= =9A=D0=BE=D0=B3=D0=B4=D0=B0 =D0=B4=D0=BE=D1=81=D1=82=D1=83=D0=BF=D0=B5=D0= =BD =D1=8D=D0=BB=D0=B5=D0=BC=D0=B5=D0=BD=D1=82 @file{/gnu/store}, =D1=81= =D0=BE=D0=B1=D1=80=D0=B0=D0=BD=D0=BD=D1=8B=D0=B9 =D0=B7=D0=B0=D1=80=D0=B0= =D0=BD=D0=B5=D0=B5 =D0=BD=D0=B0 =D0=B2=D0=BD=D0=B5=D1=88=D0=BD=D0=B5=D0= =BC =D0=B8=D1=81=D1=82=D0=BE=D1=87=D0=BD=D0=B8=D0=BA=D0=B5, =D1=82=D0=BE = =D0=B5=D1=81=D1=82=D1=8C =D0=B3=D0=BE=D1=82=D0=BE=D0=B2=D0=B0 @dfn{=D0=BF= =D0=BE=D0=B4=D1=81=D1=82=D0=B0=D0=BD=D0=BE=D0=B2=D0=BA=D0=B0}, Guix =D0= =BF=D1=80=D0=BE=D1=81=D1=82=D0=BE =D1=81=D0=BA=D0=B0=D1=87=D0=B8=D0=B2=D0= =B0=D0=B5=D1=82 =D0=B8 =D1=80=D0=B0=D1=81=D0=BF=D0=B0=D0=BA=D0=BE=D0=B2= =D1=8B=D0=B2=D0=B0=D0=B5=D1=82 =D0=B5=D0=B3=D0=BE. =D0=92 =D0=BF=D1=80=D0= =BE=D1=82=D0=B8=D0=B2=D0=BD=D0=BE=D0=BC =D1=81=D0=BB=D1=83=D1=87=D0=B0=D0= =B5 =D0=BE=D0=BD =D1=81=D0=BE=D0=B1=D0=B8=D1=80=D0=B0=D0=B5=D1=82 =D0=BF= =D0=B0=D0=BA=D0=B5=D1=82 =D0=B8=D0=B7 =D0=B8=D1=81=D1=85=D0=BE=D0=B4=D0= =BD=D0=B8=D0=BA=D0=BE=D0=B2 =D0=BD=D0=B0 =D0=BB=D0=BE=D0=BA=D0=B0=D0=BB= =D1=8C=D0=BD=D0=BE=D0=B9 =D0=BC=D0=B0=D1=88=D0=B8=D0=BD=D0=B5 (@pxref{Sub= stitutes}). =D0=A2=D0=B0=D0=BA =D0=BA=D0=B0=D0=BA =D1=80=D0=B5=D0=B7=D1= =83=D0=BB=D1=8C=D1=82=D0=B0=D1=82=D1=8B =D1=81=D0=B1=D0=BE=D1=80=D0=BA=D0= =B8 =D0=BE=D0=B1=D1=8B=D1=87=D0=BD=D0=BE =D0=B2=D0=BE=D1=81=D0=BF=D1=80= =D0=BE=D0=B8=D0=B7=D0=B2=D0=BE=D0=B4=D0=B8=D0=BC=D1=8B =D0=B1=D0=B8=D1=82= -=D0=BA-=D0=B1=D0=B8=D1=82=D1=83, =D0=BF=D0=BE=D0=BB=D1=8C=D0=B7=D0=BE=D0= =B2=D0=B0=D1=82=D0=B5=D0=BB=D0=B8 =D0=BD=D0=B5 =D0=B4=D0=BE=D0=BB=D0=B6= =D0=BD=D1=8B =D0=B4=D0=BE=D0=B2=D0=B5=D1=80=D1=8F=D1=82=D1=8C =D1=81=D0= =B5=D1=80=D0=B2=D0=B5=D1=80=D0=B0=D0=BC, =D0=BA=D0=BE=D1=82=D0=BE=D1=80= =D1=8B=D0=B5 =D0=BF=D0=BE=D1=81=D1=82=D0=B0=D0=B2=D0=BB=D1=8F=D1=8E=D1=82= =D0=BF=D0=BE=D0=B4=D1=81=D1=82=D0=B0=D0=BD=D0=BE=D0=B2=D0=BA=D0=B8 --- = =D0=BE=D0=BD=D0=B8 =D0=BC=D0=BE=D0=B3=D1=83=D1=82 =D1=86=D0=B5=D0=BB=D0= =B5=D0=BD=D0=B0=D0=BF=D1=80=D0=B0=D0=B2=D0=BB=D0=B5=D0=BD=D0=BD=D0=BE =D0= =B7=D0=B0=D0=BF=D1=80=D0=BE=D1=81=D0=B8=D1=82=D1=8C =D0=BB=D0=BE=D0=BA=D0= =B0=D0=BB=D1=8C=D0=BD=D1=83=D1=8E =D1=81=D0=B1=D0=BE=D1=80=D0=BA=D1=83 = =D0=B8 @emph{=D0=BD=D0=B5 =D0=BF=D0=BE=D0=BB=D1=8C=D0=B7=D0=BE=D0=B2=D0= =B0=D1=82=D1=8C=D1=81=D1=8F} =D1=81=D0=B5=D1=80=D0=B2=D0=B5=D1=80=D0=B0= =D0=BC=D0=B8 =D0=BF=D0=BE=D0=B4=D1=81=D1=82=D0=B0=D0=BD=D0=BE=D0=B2=D0=BA= =D0=B8 (@pxref{Invoking guix challenge})."=0A=0Aforce a local build - Ru= ssian equivalent can be only 'purposely ask local build'=0Achallenge prov= iders - in Russian we do not have such idea (as some others equivalents o= f words too), so I've translated exactly 'do not use substitute servers'= =0A=0AI think this text may be simplified and extended a bit.=0AMay 1, 20= 19 4:00 PM, znavko@disroot.org (mailto:znavko@disroot.org) wrote:=0AHello= ! Here it is 'many types of fs', but only one mentioned as example:=0A=0A= #. type: Plain text=0A#: doc/guix.texi:2268=0Amsgid ""=0A"Alternatively, = you may use a swap file. For example, assuming that in the "=0A"new syste= m you want to use the file @file{/swapfile} as a swap file, you "=0A"woul= d run@footnote{This example will work for many types of file systems (e."= =0A"g., ext4). However, for copy-on-write file systems (e.g., btrfs), the= "=0A"required steps may be different. For details, see the manual pages = for "=0A"@command{mkswap} and @command{swapon}.}:"=0AAlso, writing config= uration step is not so easy when using manual installation. I think, ther= e also should be a message with link to 'Graphical Installation', that yo= u can use graphical installation that will generate configuration you nee= d automatically.=0A=0A#. type: Plain text=0A#: doc/guix.texi:2315=0Amsgid= ""=0A"@xref{Using the Configuration System}, for an overview of the conf= iguration "=0A"file. The example configurations discussed in that section= are available "=0A"under @file{/etc/configuration} in the installation i= mage. Thus, to get "=0A"started with a system configuration providing a g= raphical display server (a "=0A"``desktop'' system), you can run somethin= g along these lines:"=0A=0AAnd also if another language is ready to use (= Spanish), need to say it on:=0A=0A#. type: Plain text=0A#: doc/guix.texi:= 117=0Amsgid ""=0A"This manual is also available in French (@pxref{Top,,, = guix.fr, Manuel de "=0A"r=C3=A9f=C3=A9rence de GNU Guix}) and German (@px= ref{Top,,, guix.de, Referenzhandbuch "=0A"zu GNU Guix}). If you would lik= e to translate it in your native language, "=0A"consider joining the @ure= f{https://translationproject.org/domain/guix-manual (https://translationp= roject.org/domain/guix-manual)."=0A"html, Translation Project}." ----=_RainLoop_664_271612391.1556733790 Content-Type: text/html; charset="utf-8" Content-Transfer-Encoding: quoted-printable
A= lso here GuixSD rests instead of Guix System:

#. type: Plain text<= br>#: doc/guix.texi:2650
msgid ""
"If you are not using the Guix Sy= stem Distribution, consider adding the "
"following lines to your @fil= e{~/.bash_profile} (@pxref{Bash Startup Files,,, "
"bash, The GNU Bash= Reference Manual}) so that newly-spawned shells get all "
"the right = environment variable definitions:"


And this text is English-sp= ecific, lacks its features in another language, words 'force a local buil= d' and 'challenge providers' in Russian has no direct translations:
#. type: Plain text
#: doc/guix.texi:2589 doc/guix.texi:2582
msgi= d ""
"This foundation allows Guix to support @dfn{transparent binary/s= ource "
"deployment}. When a pre-built binary for a @file{/gnu/store} = item is "
"available from an external source---a @dfn{substitute}, Gui= x just downloads "
"it and unpacks it; otherwise, it builds the packag= e from source, locally "
"(@pxref{Substitutes}). Because build results= are usually bit-for-bit "
"reproducible, users do not have to trust s= ervers that provide substitutes: "
"they can force a local build and @= emph{challenge} providers (@pxref{Invoking "
"guix challenge})."
ms= gstr "=D0=AD=D1=82=D0=B0 =D0=BA=D0=BE=D0=BD=D1=86=D0=B5=D0=BF=D1=86=D0=B8= =D1=8F =D0=BF=D0=BE=D0=B7=D0=B2=D0=BE=D0=BB=D1=8F=D0=B5=D1=82 Guix =D0=BF= =D0=BE=D0=B4=D0=B4=D0=B5=D1=80=D0=B6=D0=B8=D0=B2=D0=B0=D1=82=D1=8C @dfn{= =D0=BF=D1=80=D0=BE=D0=B7=D1=80=D0=B0=D1=87=D0=BD=D0=BE=D0=B5 =D0=B2=D0=BD= =D0=B5=D0=B4=D1=80=D0=B5=D0=BD=D0=B8=D0=B5 =D0=B1=D0=B8=D0=BD=D0=B0=D1=80= =D0=BD=D0=B8=D0=BA=D0=BE=D0=B2/=D0=B8=D1=81=D1=85=D0=BE=D0=B4=D0=BD=D0=B8= =D0=BA=D0=BE=D0=B2}. =D0=9A=D0=BE=D0=B3=D0=B4=D0=B0 =D0=B4=D0=BE=D1=81=D1= =82=D1=83=D0=BF=D0=B5=D0=BD =D1=8D=D0=BB=D0=B5=D0=BC=D0=B5=D0=BD=D1=82 @f= ile{/gnu/store}, =D1=81=D0=BE=D0=B1=D1=80=D0=B0=D0=BD=D0=BD=D1=8B=D0=B9 = =D0=B7=D0=B0=D1=80=D0=B0=D0=BD=D0=B5=D0=B5 =D0=BD=D0=B0 =D0=B2=D0=BD=D0= =B5=D1=88=D0=BD=D0=B5=D0=BC =D0=B8=D1=81=D1=82=D0=BE=D1=87=D0=BD=D0=B8=D0= =BA=D0=B5, =D1=82=D0=BE =D0=B5=D1=81=D1=82=D1=8C =D0=B3=D0=BE=D1=82=D0=BE= =D0=B2=D0=B0 @dfn{=D0=BF=D0=BE=D0=B4=D1=81=D1=82=D0=B0=D0=BD=D0=BE=D0=B2= =D0=BA=D0=B0}, Guix =D0=BF=D1=80=D0=BE=D1=81=D1=82=D0=BE =D1=81=D0=BA=D0= =B0=D1=87=D0=B8=D0=B2=D0=B0=D0=B5=D1=82 =D0=B8 =D1=80=D0=B0=D1=81=D0=BF= =D0=B0=D0=BA=D0=BE=D0=B2=D1=8B=D0=B2=D0=B0=D0=B5=D1=82 =D0=B5=D0=B3=D0=BE= . =D0=92 =D0=BF=D1=80=D0=BE=D1=82=D0=B8=D0=B2=D0=BD=D0=BE=D0=BC =D1=81=D0= =BB=D1=83=D1=87=D0=B0=D0=B5 =D0=BE=D0=BD =D1=81=D0=BE=D0=B1=D0=B8=D1=80= =D0=B0=D0=B5=D1=82 =D0=BF=D0=B0=D0=BA=D0=B5=D1=82 =D0=B8=D0=B7 =D0=B8=D1= =81=D1=85=D0=BE=D0=B4=D0=BD=D0=B8=D0=BA=D0=BE=D0=B2 =D0=BD=D0=B0 =D0=BB= =D0=BE=D0=BA=D0=B0=D0=BB=D1=8C=D0=BD=D0=BE=D0=B9 =D0=BC=D0=B0=D1=88=D0=B8= =D0=BD=D0=B5 (@pxref{Substitutes}). =D0=A2=D0=B0=D0=BA =D0=BA=D0=B0=D0=BA= =D1=80=D0=B5=D0=B7=D1=83=D0=BB=D1=8C=D1=82=D0=B0=D1=82=D1=8B =D1=81=D0= =B1=D0=BE=D1=80=D0=BA=D0=B8 =D0=BE=D0=B1=D1=8B=D1=87=D0=BD=D0=BE =D0=B2= =D0=BE=D1=81=D0=BF=D1=80=D0=BE=D0=B8=D0=B7=D0=B2=D0=BE=D0=B4=D0=B8=D0=BC= =D1=8B =D0=B1=D0=B8=D1=82-=D0=BA-=D0=B1=D0=B8=D1=82=D1=83, =D0=BF=D0=BE= =D0=BB=D1=8C=D0=B7=D0=BE=D0=B2=D0=B0=D1=82=D0=B5=D0=BB=D0=B8 =D0=BD=D0=B5= =D0=B4=D0=BE=D0=BB=D0=B6=D0=BD=D1=8B =D0=B4=D0=BE=D0=B2=D0=B5=D1=80=D1= =8F=D1=82=D1=8C =D1=81=D0=B5=D1=80=D0=B2=D0=B5=D1=80=D0=B0=D0=BC, =D0=BA= =D0=BE=D1=82=D0=BE=D1=80=D1=8B=D0=B5 =D0=BF=D0=BE=D1=81=D1=82=D0=B0=D0=B2= =D0=BB=D1=8F=D1=8E=D1=82 =D0=BF=D0=BE=D0=B4=D1=81=D1=82=D0=B0=D0=BD=D0=BE= =D0=B2=D0=BA=D0=B8 --- =D0=BE=D0=BD=D0=B8 =D0=BC=D0=BE=D0=B3=D1=83=D1=82 = =D1=86=D0=B5=D0=BB=D0=B5=D0=BD=D0=B0=D0=BF=D1=80=D0=B0=D0=B2=D0=BB=D0=B5= =D0=BD=D0=BD=D0=BE =D0=B7=D0=B0=D0=BF=D1=80=D0=BE=D1=81=D0=B8=D1=82=D1=8C= =D0=BB=D0=BE=D0=BA=D0=B0=D0=BB=D1=8C=D0=BD=D1=83=D1=8E =D1=81=D0=B1=D0= =BE=D1=80=D0=BA=D1=83 =D0=B8 @emph{=D0=BD=D0=B5 =D0=BF=D0=BE=D0=BB=D1=8C= =D0=B7=D0=BE=D0=B2=D0=B0=D1=82=D1=8C=D1=81=D1=8F} =D1=81=D0=B5=D1=80=D0= =B2=D0=B5=D1=80=D0=B0=D0=BC=D0=B8 =D0=BF=D0=BE=D0=B4=D1=81=D1=82=D0=B0=D0= =BD=D0=BE=D0=B2=D0=BA=D0=B8 (@pxref{Invoking guix challenge})."

force a local build - Russian equivalent can be only 'pur= posely ask local build'
challenge providers - in Russ= ian we do not have such idea (as some others equivalents of words too), s= o I've translated exactly 'do not use substitute servers'

I think = this text may be simplified and extended a bit.


May 1, 2019 4:= 00 PM, znavko@disroot.org wrote:
Hello! Here it is 'ma= ny types of fs', but only one mentioned as example:

#. type: Plain text
#: doc/guix.texi:2268
msgid ""
"Alt= ernatively, you may use a swap file. For example, assuming that in the "<= br>"new system you want to use the file @file{/swapfile} as a swap file, = you "
"would run@footnote{This example will work for many types of fil= e systems (e."
"g., ext4). However, for copy-on-write file systems (e.= g., btrfs), the "
"required steps may be different. For details, see t= he manual pages for "
"@command{mkswap} and @command{swapon}.}:"

Also, writing configuration step is not so easy when using manual i= nstallation. I think, there also should be a message with link to 'Graphi= cal Installation', that you can use graphical installation that will gene= rate configuration you need automatically.

#. type: Plain text
= #: doc/guix.texi:2315
msgid ""
"@xref{Using the Configuration Syste= m}, for an overview of the configuration "
"file. The example configur= ations discussed in that section are available "
"under @file{/etc/con= figuration} in the installation image. Thus, to get "
"started with a = system configuration providing a graphical display server (a "
"``desk= top'' system), you can run something along these lines:"

And also = if another language is ready to use (Spanish), need to say it on:

= #. type: Plain text
#: doc/guix.texi:117
msgid ""
"This manual i= s also available in French (@pxref{Top,,, guix.fr, Manuel de "
"r=C3= =A9f=C3=A9rence de GNU Guix}) and German (@pxref{Top,,, guix.de, Referenz= handbuch "
"zu GNU Guix}). If you would like to translate it in your n= ative language, "
"consider joining the @uref{https://translationproject.org/domain/guix-manual."
"ht= ml, Translation Project}."


----=_RainLoop_664_271612391.1556733790-- From debbugs-submit-bounces@debbugs.gnu.org Thu May 02 04:38:30 2019 Received: (at 35525) by debbugs.gnu.org; 2 May 2019 08:38:30 +0000 Received: from localhost ([127.0.0.1]:45550 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hM7Eb-0000oJ-Sm for submit@debbugs.gnu.org; Thu, 02 May 2019 04:38:30 -0400 Received: from knopi.disroot.org ([178.21.23.139]:34280) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hM7EX-0000o8-RW for 35525@debbugs.gnu.org; Thu, 02 May 2019 04:38:28 -0400 Received: from localhost (localhost [127.0.0.1]) by disroot.org (Postfix) with ESMTP id 33DE722594 for <35525@debbugs.gnu.org>; Thu, 2 May 2019 10:38:24 +0200 (CEST) X-Virus-Scanned: Debian amavisd-new at disroot.org Received: from knopi.disroot.org ([127.0.0.1]) by localhost (disroot.org [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id 6d4bBeIHZ7fT for <35525@debbugs.gnu.org>; Thu, 2 May 2019 10:38:21 +0200 (CEST) Mime-Version: 1.0 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=disroot.org; s=mail; t=1556786301; bh=pEtW2g1uw4QvkGsmMtrHh64Qy04AUEqRt6ypgBVWNB8=; h=Date:From:Subject:To:In-Reply-To:References; b=hZpW8iOPRqiXvRGZT6SEZfaYSCjUF26j6B3Yc/QRCuzZuJ9N84GwzsVWVaCuVamw8 jz5fq86qqo1EKivSCbbiioq5QeEeZsGz3K3YDWmXGRNGVbThOnhxkBXnIw71+2Upch K2mxfTLpgN4wzQrP+cy30V8jhrFoPlCB6RnnIClBKm6nwe2/mrUce17NN0z+SHbsmj EgYDIctfFN6HwGex1a+Fq3leqsUDSJW0OSal2y6KcC0l1k9p/Kxa3vWCJbFjK0txz0 D9lORvN8AbbRpCHO0vPQJhC02pImYky4wFQ5pvPXlaM8M+wUuNB6cKucn4datcErcs fQvUEs1obq3Ow== Date: Thu, 02 May 2019 08:38:21 +0000 Content-Type: multipart/alternative; boundary="--=_RainLoop_566_350337971.1556786301" From: znavko@disroot.org Message-ID: Subject: Re: bug#35525: guix-manual proposals To: 35525@debbugs.gnu.org In-Reply-To: <2530df52d53c8ac976ce37ed854b509a@disroot.org> References: <2530df52d53c8ac976ce37ed854b509a@disroot.org> X-Spam-Score: 0.0 (/) X-Debbugs-Envelope-To: 35525 X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.0 (-) ----=_RainLoop_566_350337971.1556786301 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: quoted-printable I think here the word 'installed' is wrong:=0A=0A#. type: itemx=0A#: doc/= guix.texi:3011 doc/guix.texi:3024=0A#, no-wrap=0Amsgid "-A [@var{regexp}]= "=0A=0A#. type: table=0A#: doc/guix.texi:3015 doc/guix.texi:3028=0Amsgid = ""=0A"List packages currently available in the distribution for this syst= em "=0A"(@pxref{GNU Distribution}). When @var{regexp} is specified, list = only "=0A"installed packages whose name matches @var{regexp}."=0A=0AIn my= own as I see, it does not list installed but all available packages.=0AM= ay 1, 2019 6:04 PM, znavko@disroot.org (mailto:znavko@disroot.org) wrote:= =0AAlso here GuixSD rests instead of Guix System:=0A=0A#. type: Plain tex= t=0A#: doc/guix.texi:2650=0Amsgid ""=0A"If you are not using the Guix Sys= tem Distribution, consider adding the "=0A"following lines to your @file{= ~/.bash_profile} (@pxref{Bash Startup Files,,, "=0A"bash, The GNU Bash Re= ference Manual}) so that newly-spawned shells get all "=0A"the right envi= ronment variable definitions:"=0AAnd this text is English-specific, lacks= its features in another language, words 'force a local build' and 'chall= enge providers' in Russian has no direct translations:=0A=0A#. type: Plai= n text=0A#: doc/guix.texi:2589 doc/guix.texi:2582=0Amsgid ""=0A"This foun= dation allows Guix to support @dfn{transparent binary/source "=0A"deploym= ent}. When a pre-built binary for a @file{/gnu/store} item is "=0A"availa= ble from an external source---a @dfn{substitute}, Guix just downloads "= =0A"it and unpacks it; otherwise, it builds the package from source, loca= lly "=0A"(@pxref{Substitutes}). Because build results are usually bit-for= -bit "=0A"reproducible, users do not have to trust servers that provide s= ubstitutes: "=0A"they can force a local build and @emph{challenge} provid= ers (@pxref{Invoking "=0A"guix challenge})."=0Amsgstr "=D0=AD=D1=82=D0=B0= =D0=BA=D0=BE=D0=BD=D1=86=D0=B5=D0=BF=D1=86=D0=B8=D1=8F =D0=BF=D0=BE=D0= =B7=D0=B2=D0=BE=D0=BB=D1=8F=D0=B5=D1=82 Guix =D0=BF=D0=BE=D0=B4=D0=B4=D0= =B5=D1=80=D0=B6=D0=B8=D0=B2=D0=B0=D1=82=D1=8C @dfn{=D0=BF=D1=80=D0=BE=D0= =B7=D1=80=D0=B0=D1=87=D0=BD=D0=BE=D0=B5 =D0=B2=D0=BD=D0=B5=D0=B4=D1=80=D0= =B5=D0=BD=D0=B8=D0=B5 =D0=B1=D0=B8=D0=BD=D0=B0=D1=80=D0=BD=D0=B8=D0=BA=D0= =BE=D0=B2/=D0=B8=D1=81=D1=85=D0=BE=D0=B4=D0=BD=D0=B8=D0=BA=D0=BE=D0=B2}. = =D0=9A=D0=BE=D0=B3=D0=B4=D0=B0 =D0=B4=D0=BE=D1=81=D1=82=D1=83=D0=BF=D0=B5= =D0=BD =D1=8D=D0=BB=D0=B5=D0=BC=D0=B5=D0=BD=D1=82 @file{/gnu/store}, =D1= =81=D0=BE=D0=B1=D1=80=D0=B0=D0=BD=D0=BD=D1=8B=D0=B9 =D0=B7=D0=B0=D1=80=D0= =B0=D0=BD=D0=B5=D0=B5 =D0=BD=D0=B0 =D0=B2=D0=BD=D0=B5=D1=88=D0=BD=D0=B5= =D0=BC =D0=B8=D1=81=D1=82=D0=BE=D1=87=D0=BD=D0=B8=D0=BA=D0=B5, =D1=82=D0= =BE =D0=B5=D1=81=D1=82=D1=8C =D0=B3=D0=BE=D1=82=D0=BE=D0=B2=D0=B0 @dfn{= =D0=BF=D0=BE=D0=B4=D1=81=D1=82=D0=B0=D0=BD=D0=BE=D0=B2=D0=BA=D0=B0}, Guix= =D0=BF=D1=80=D0=BE=D1=81=D1=82=D0=BE =D1=81=D0=BA=D0=B0=D1=87=D0=B8=D0= =B2=D0=B0=D0=B5=D1=82 =D0=B8 =D1=80=D0=B0=D1=81=D0=BF=D0=B0=D0=BA=D0=BE= =D0=B2=D1=8B=D0=B2=D0=B0=D0=B5=D1=82 =D0=B5=D0=B3=D0=BE. =D0=92 =D0=BF=D1= =80=D0=BE=D1=82=D0=B8=D0=B2=D0=BD=D0=BE=D0=BC =D1=81=D0=BB=D1=83=D1=87=D0= =B0=D0=B5 =D0=BE=D0=BD =D1=81=D0=BE=D0=B1=D0=B8=D1=80=D0=B0=D0=B5=D1=82 = =D0=BF=D0=B0=D0=BA=D0=B5=D1=82 =D0=B8=D0=B7 =D0=B8=D1=81=D1=85=D0=BE=D0= =B4=D0=BD=D0=B8=D0=BA=D0=BE=D0=B2 =D0=BD=D0=B0 =D0=BB=D0=BE=D0=BA=D0=B0= =D0=BB=D1=8C=D0=BD=D0=BE=D0=B9 =D0=BC=D0=B0=D1=88=D0=B8=D0=BD=D0=B5 (@pxr= ef{Substitutes}). =D0=A2=D0=B0=D0=BA =D0=BA=D0=B0=D0=BA =D1=80=D0=B5=D0= =B7=D1=83=D0=BB=D1=8C=D1=82=D0=B0=D1=82=D1=8B =D1=81=D0=B1=D0=BE=D1=80=D0= =BA=D0=B8 =D0=BE=D0=B1=D1=8B=D1=87=D0=BD=D0=BE =D0=B2=D0=BE=D1=81=D0=BF= =D1=80=D0=BE=D0=B8=D0=B7=D0=B2=D0=BE=D0=B4=D0=B8=D0=BC=D1=8B =D0=B1=D0=B8= =D1=82-=D0=BA-=D0=B1=D0=B8=D1=82=D1=83, =D0=BF=D0=BE=D0=BB=D1=8C=D0=B7=D0= =BE=D0=B2=D0=B0=D1=82=D0=B5=D0=BB=D0=B8 =D0=BD=D0=B5 =D0=B4=D0=BE=D0=BB= =D0=B6=D0=BD=D1=8B =D0=B4=D0=BE=D0=B2=D0=B5=D1=80=D1=8F=D1=82=D1=8C =D1= =81=D0=B5=D1=80=D0=B2=D0=B5=D1=80=D0=B0=D0=BC, =D0=BA=D0=BE=D1=82=D0=BE= =D1=80=D1=8B=D0=B5 =D0=BF=D0=BE=D1=81=D1=82=D0=B0=D0=B2=D0=BB=D1=8F=D1=8E= =D1=82 =D0=BF=D0=BE=D0=B4=D1=81=D1=82=D0=B0=D0=BD=D0=BE=D0=B2=D0=BA=D0=B8= --- =D0=BE=D0=BD=D0=B8 =D0=BC=D0=BE=D0=B3=D1=83=D1=82 =D1=86=D0=B5=D0=BB= =D0=B5=D0=BD=D0=B0=D0=BF=D1=80=D0=B0=D0=B2=D0=BB=D0=B5=D0=BD=D0=BD=D0=BE = =D0=B7=D0=B0=D0=BF=D1=80=D0=BE=D1=81=D0=B8=D1=82=D1=8C =D0=BB=D0=BE=D0=BA= =D0=B0=D0=BB=D1=8C=D0=BD=D1=83=D1=8E =D1=81=D0=B1=D0=BE=D1=80=D0=BA=D1=83= =D0=B8 @emph{=D0=BD=D0=B5 =D0=BF=D0=BE=D0=BB=D1=8C=D0=B7=D0=BE=D0=B2=D0= =B0=D1=82=D1=8C=D1=81=D1=8F} =D1=81=D0=B5=D1=80=D0=B2=D0=B5=D1=80=D0=B0= =D0=BC=D0=B8 =D0=BF=D0=BE=D0=B4=D1=81=D1=82=D0=B0=D0=BD=D0=BE=D0=B2=D0=BA= =D0=B8 (@pxref{Invoking guix challenge})."=0A=0Aforce a local build - Ru= ssian equivalent can be only 'purposely ask local build'=0Achallenge prov= iders - in Russian we do not have such idea (as some others equivalents o= f words too), so I've translated exactly 'do not use substitute servers'= =0A=0AI think this text may be simplified and extended a bit.=0AMay 1, 20= 19 4:00 PM, znavko@disroot.org (mailto:znavko@disroot.org) wrote:=0AHello= ! Here it is 'many types of fs', but only one mentioned as example:=0A=0A= #. type: Plain text=0A#: doc/guix.texi:2268=0Amsgid ""=0A"Alternatively, = you may use a swap file. For example, assuming that in the "=0A"new syste= m you want to use the file @file{/swapfile} as a swap file, you "=0A"woul= d run@footnote{This example will work for many types of file systems (e."= =0A"g., ext4). However, for copy-on-write file systems (e.g., btrfs), the= "=0A"required steps may be different. For details, see the manual pages = for "=0A"@command{mkswap} and @command{swapon}.}:"=0AAlso, writing config= uration step is not so easy when using manual installation. I think, ther= e also should be a message with link to 'Graphical Installation', that yo= u can use graphical installation that will generate configuration you nee= d automatically.=0A=0A#. type: Plain text=0A#: doc/guix.texi:2315=0Amsgid= ""=0A"@xref{Using the Configuration System}, for an overview of the conf= iguration "=0A"file. The example configurations discussed in that section= are available "=0A"under @file{/etc/configuration} in the installation i= mage. Thus, to get "=0A"started with a system configuration providing a g= raphical display server (a "=0A"``desktop'' system), you can run somethin= g along these lines:"=0A=0AAnd also if another language is ready to use (= Spanish), need to say it on:=0A=0A#. type: Plain text=0A#: doc/guix.texi:= 117=0Amsgid ""=0A"This manual is also available in French (@pxref{Top,,, = guix.fr, Manuel de "=0A"r=C3=A9f=C3=A9rence de GNU Guix}) and German (@px= ref{Top,,, guix.de, Referenzhandbuch "=0A"zu GNU Guix}). If you would lik= e to translate it in your native language, "=0A"consider joining the @ure= f{https://translationproject.org/domain/guix-manual (https://translationp= roject.org/domain/guix-manual)."=0A"html, Translation Project}." ----=_RainLoop_566_350337971.1556786301 Content-Type: text/html; charset="utf-8" Content-Transfer-Encoding: quoted-printable
I= think here the word 'installed' is wrong:

#. type: itemx
#: do= c/guix.texi:3011 doc/guix.texi:3024
#, no-wrap
msgid "-A [@var{rege= xp}]"

#. type: table
#: doc/guix.texi:3015 doc/guix.texi:3028msgid ""
"List packages currently available in the distribution for = this system "
"(@pxref{GNU Distribution}). When @var{regexp} is specif= ied, list only "
"installed packages whose n= ame matches @var{regexp}."

In my own as I see, it does not list in= stalled but all available packages.


May 1, 2019 6:04 PM, znavko= @disroot.org wrote:
Also here GuixSD rests instead of = Guix System:

#. type: Plain text
#: doc/guix.texi:2650
msgid= ""
"If you are not using the Guix System Distribution, consider addin= g the "
"following lines to your @file{~/.bash_profile} (@pxref{Bash S= tartup Files,,, "
"bash, The GNU Bash Reference Manual}) so that newly= -spawned shells get all "
"the right environment variable definitions:= "


And this text is English-specific, lacks its features in ano= ther language, words 'force a local build' and 'challenge providers' in R= ussian has no direct translations:

#. type: Plain text
#: doc/g= uix.texi:2589 doc/guix.texi:2582
msgid ""
"This foundation allows G= uix to support @dfn{transparent binary/source "
"deployment}. When a p= re-built binary for a @file{/gnu/store} item is "
"available from an e= xternal source---a @dfn{substitute}, Guix just downloads "
"it and unp= acks it; otherwise, it builds the package from source, locally "
"(@px= ref{Substitutes}). Because build results are usually bit-for-bit "
"re= producible, users do not have to trust servers that provide substitutes: = "
"they can force a local build and @emph{challenge} providers (@pxref= {Invoking "
"guix challenge})."
msgstr "=D0=AD=D1=82=D0=B0 =D0=BA= =D0=BE=D0=BD=D1=86=D0=B5=D0=BF=D1=86=D0=B8=D1=8F =D0=BF=D0=BE=D0=B7=D0=B2= =D0=BE=D0=BB=D1=8F=D0=B5=D1=82 Guix =D0=BF=D0=BE=D0=B4=D0=B4=D0=B5=D1=80= =D0=B6=D0=B8=D0=B2=D0=B0=D1=82=D1=8C @dfn{=D0=BF=D1=80=D0=BE=D0=B7=D1=80= =D0=B0=D1=87=D0=BD=D0=BE=D0=B5 =D0=B2=D0=BD=D0=B5=D0=B4=D1=80=D0=B5=D0=BD= =D0=B8=D0=B5 =D0=B1=D0=B8=D0=BD=D0=B0=D1=80=D0=BD=D0=B8=D0=BA=D0=BE=D0=B2= /=D0=B8=D1=81=D1=85=D0=BE=D0=B4=D0=BD=D0=B8=D0=BA=D0=BE=D0=B2}. =D0=9A=D0= =BE=D0=B3=D0=B4=D0=B0 =D0=B4=D0=BE=D1=81=D1=82=D1=83=D0=BF=D0=B5=D0=BD = =D1=8D=D0=BB=D0=B5=D0=BC=D0=B5=D0=BD=D1=82 @file{/gnu/store}, =D1=81=D0= =BE=D0=B1=D1=80=D0=B0=D0=BD=D0=BD=D1=8B=D0=B9 =D0=B7=D0=B0=D1=80=D0=B0=D0= =BD=D0=B5=D0=B5 =D0=BD=D0=B0 =D0=B2=D0=BD=D0=B5=D1=88=D0=BD=D0=B5=D0=BC = =D0=B8=D1=81=D1=82=D0=BE=D1=87=D0=BD=D0=B8=D0=BA=D0=B5, =D1=82=D0=BE =D0= =B5=D1=81=D1=82=D1=8C =D0=B3=D0=BE=D1=82=D0=BE=D0=B2=D0=B0 @dfn{=D0=BF=D0= =BE=D0=B4=D1=81=D1=82=D0=B0=D0=BD=D0=BE=D0=B2=D0=BA=D0=B0}, Guix =D0=BF= =D1=80=D0=BE=D1=81=D1=82=D0=BE =D1=81=D0=BA=D0=B0=D1=87=D0=B8=D0=B2=D0=B0= =D0=B5=D1=82 =D0=B8 =D1=80=D0=B0=D1=81=D0=BF=D0=B0=D0=BA=D0=BE=D0=B2=D1= =8B=D0=B2=D0=B0=D0=B5=D1=82 =D0=B5=D0=B3=D0=BE. =D0=92 =D0=BF=D1=80=D0=BE= =D1=82=D0=B8=D0=B2=D0=BD=D0=BE=D0=BC =D1=81=D0=BB=D1=83=D1=87=D0=B0=D0=B5= =D0=BE=D0=BD =D1=81=D0=BE=D0=B1=D0=B8=D1=80=D0=B0=D0=B5=D1=82 =D0=BF=D0= =B0=D0=BA=D0=B5=D1=82 =D0=B8=D0=B7 =D0=B8=D1=81=D1=85=D0=BE=D0=B4=D0=BD= =D0=B8=D0=BA=D0=BE=D0=B2 =D0=BD=D0=B0 =D0=BB=D0=BE=D0=BA=D0=B0=D0=BB=D1= =8C=D0=BD=D0=BE=D0=B9 =D0=BC=D0=B0=D1=88=D0=B8=D0=BD=D0=B5 (@pxref{Substi= tutes}). =D0=A2=D0=B0=D0=BA =D0=BA=D0=B0=D0=BA =D1=80=D0=B5=D0=B7=D1=83= =D0=BB=D1=8C=D1=82=D0=B0=D1=82=D1=8B =D1=81=D0=B1=D0=BE=D1=80=D0=BA=D0=B8= =D0=BE=D0=B1=D1=8B=D1=87=D0=BD=D0=BE =D0=B2=D0=BE=D1=81=D0=BF=D1=80=D0= =BE=D0=B8=D0=B7=D0=B2=D0=BE=D0=B4=D0=B8=D0=BC=D1=8B =D0=B1=D0=B8=D1=82-= =D0=BA-=D0=B1=D0=B8=D1=82=D1=83, =D0=BF=D0=BE=D0=BB=D1=8C=D0=B7=D0=BE=D0= =B2=D0=B0=D1=82=D0=B5=D0=BB=D0=B8 =D0=BD=D0=B5 =D0=B4=D0=BE=D0=BB=D0=B6= =D0=BD=D1=8B =D0=B4=D0=BE=D0=B2=D0=B5=D1=80=D1=8F=D1=82=D1=8C =D1=81=D0= =B5=D1=80=D0=B2=D0=B5=D1=80=D0=B0=D0=BC, =D0=BA=D0=BE=D1=82=D0=BE=D1=80= =D1=8B=D0=B5 =D0=BF=D0=BE=D1=81=D1=82=D0=B0=D0=B2=D0=BB=D1=8F=D1=8E=D1=82= =D0=BF=D0=BE=D0=B4=D1=81=D1=82=D0=B0=D0=BD=D0=BE=D0=B2=D0=BA=D0=B8 --- = =D0=BE=D0=BD=D0=B8 =D0=BC=D0=BE=D0=B3=D1=83=D1=82 =D1=86=D0=B5=D0=BB=D0= =B5=D0=BD=D0=B0=D0=BF=D1=80=D0=B0=D0=B2=D0=BB=D0=B5=D0=BD=D0=BD=D0=BE =D0= =B7=D0=B0=D0=BF=D1=80=D0=BE=D1=81=D0=B8=D1=82=D1=8C =D0=BB=D0=BE=D0=BA=D0= =B0=D0=BB=D1=8C=D0=BD=D1=83=D1=8E =D1=81=D0=B1=D0=BE=D1=80=D0=BA=D1=83 = =D0=B8 @emph{=D0=BD=D0=B5 =D0=BF=D0=BE=D0=BB=D1=8C=D0=B7=D0=BE=D0=B2=D0= =B0=D1=82=D1=8C=D1=81=D1=8F} =D1=81=D0=B5=D1=80=D0=B2=D0=B5=D1=80=D0=B0= =D0=BC=D0=B8 =D0=BF=D0=BE=D0=B4=D1=81=D1=82=D0=B0=D0=BD=D0=BE=D0=B2=D0=BA= =D0=B8 (@pxref{Invoking guix challenge})."

force a local b= uild - Russian equivalent can be only 'purposely ask local buil= d'
challenge providers - in Russian we do not have su= ch idea (as some others equivalents of words too), so I've translated exa= ctly 'do not use substitute servers'

I think this text may be simp= lified and extended a bit.


May 1, 2019 4:00 PM, znavko@disroot.org wrote:

Hello! Here it is 'many types of fs', but only one mentioned as ex= ample:

#. type: Plain text
#: doc/guix.t= exi:2268
msgid ""
"Alternatively, you may use a swap file. For exam= ple, assuming that in the "
"new system you want to use the file @file= {/swapfile} as a swap file, you "
"would run@footnote{This example wil= l work for many types of file systems (e."
"g., ext4). However, for co= py-on-write file systems (e.g., btrfs), the "
"required steps may be d= ifferent. For details, see the manual pages for "
"@command{mkswap} an= d @command{swapon}.}:"


Also, writing configuration step is not= so easy when using manual installation. I think, there also should be a = message with link to 'Graphical Installation', that you can use graphical= installation that will generate configuration you need automatically.
#. type: Plain text
#: doc/guix.texi:2315
msgid ""
"@xref{U= sing the Configuration System}, for an overview of the configuration ""file. The example configurations discussed in that section are availabl= e "
"under @file{/etc/configuration} in the installation image. Thus, = to get "
"started with a system configuration providing a graphical di= splay server (a "
"``desktop'' system), you can run something along th= ese lines:"

And also if another language is ready to use (Spanish)= , need to say it on:

#. type: Plain text
#: doc/guix.texi:117msgid ""
"This manual is also available in French (@pxref{Top,,, gui= x.fr, Manuel de "
"r=C3=A9f=C3=A9rence de GNU Guix}) and German (@pxre= f{Top,,, guix.de, Referenzhandbuch "
"zu GNU Guix}). If you would like= to translate it in your native language, "
"consider joining the @ure= f{ht= tps://translationproject.org/domain/guix-manual."
"html, Translati= on Project}."




----=_RainLoop_566_350337971.1556786301-- From debbugs-submit-bounces@debbugs.gnu.org Thu May 02 11:22:49 2019 Received: (at 35525-done) by debbugs.gnu.org; 2 May 2019 15:22:49 +0000 Received: from localhost ([127.0.0.1]:46742 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hMDXt-0004DL-3Y for submit@debbugs.gnu.org; Thu, 02 May 2019 11:22:49 -0400 Received: from eggs.gnu.org ([209.51.188.92]:44775) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hMDXr-0004D7-TB for 35525-done@debbugs.gnu.org; Thu, 02 May 2019 11:22:48 -0400 Received: from fencepost.gnu.org ([2001:470:142:3::e]:45580) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1hMDXm-0004d5-Mw; Thu, 02 May 2019 11:22:42 -0400 Received: from [2001:660:6102:320:e120:2c8f:8909:cdfe] (port=52346 helo=ribbon) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1hMDXm-0006hn-01; Thu, 02 May 2019 11:22:42 -0400 From: =?utf-8?Q?Ludovic_Court=C3=A8s?= To: znavko@disroot.org Subject: Re: bug#35525: guix-manual proposals References: <2530df52d53c8ac976ce37ed854b509a@disroot.org> X-URL: http://www.fdn.fr/~lcourtes/ X-Revolutionary-Date: 13 =?utf-8?Q?Flor=C3=A9al?= an 227 de la =?utf-8?Q?R?= =?utf-8?Q?=C3=A9volution?= X-PGP-Key-ID: 0x090B11993D9AEBB5 X-PGP-Key: http://www.fdn.fr/~lcourtes/ludovic.asc X-PGP-Fingerprint: 3CE4 6455 8A84 FDC6 9DB4 0CFB 090B 1199 3D9A EBB5 X-OS: x86_64-pc-linux-gnu Date: Thu, 02 May 2019 17:22:40 +0200 In-Reply-To: (znavko@disroot.org's message of "Thu, 02 May 2019 08:38:21 +0000") Message-ID: <87tvecubi7.fsf@gnu.org> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/26.2 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 35525-done Cc: 35525-done@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) Hi znavko, We do not handle translations here. Please contact directly the relevant team at the Translation Project: https://translationproject.org/domain/guix-manual.html Thanks, Ludo=E2=80=99. From debbugs-submit-bounces@debbugs.gnu.org Thu May 02 11:37:21 2019 Received: (at 35525-done) by debbugs.gnu.org; 2 May 2019 15:37:21 +0000 Received: from localhost ([127.0.0.1]:46755 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hMDlx-0006f1-Hu for submit@debbugs.gnu.org; Thu, 02 May 2019 11:37:21 -0400 Received: from dd26836.kasserver.com ([85.13.145.193]:34804) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hMDlu-0006es-SE for 35525-done@debbugs.gnu.org; Thu, 02 May 2019 11:37:19 -0400 Received: from localhost (212095005090.public.telering.at [212.95.5.90]) by dd26836.kasserver.com (Postfix) with ESMTPSA id 369BF3360B77; Thu, 2 May 2019 17:37:17 +0200 (CEST) Date: Thu, 2 May 2019 17:37:14 +0200 From: Danny Milosavljevic To: Ludovic =?ISO-8859-1?Q?Court=E8s?= Subject: Re: bug#35525: guix-manual proposals Message-ID: <20190502173714.2cb399c3@scratchpost.org> In-Reply-To: <87tvecubi7.fsf@gnu.org> References: <2530df52d53c8ac976ce37ed854b509a@disroot.org> <87tvecubi7.fsf@gnu.org> X-Mailer: Claws Mail 3.17.3 (GTK+ 2.24.32; x86_64-unknown-linux-gnu) MIME-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha256; boundary="Sig_/5.o8YNvV_wZtLe9/EBZv=JO"; protocol="application/pgp-signature" X-Spam-Score: -0.7 (/) X-Debbugs-Envelope-To: 35525-done Cc: 35525-done@debbugs.gnu.org, znavko@disroot.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.7 (-) --Sig_/5.o8YNvV_wZtLe9/EBZv=JO Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: quoted-printable Hi Ludo, as far as I can see, it's also wrong in the original in the manual. doc/guix.texi: @item --list-available[=3D@var{regexp}] @itemx -A [@var{regexp}] List packages currently available in the distribution for this system (@pxref{GNU Distribution}). When @var{regexp} is specified, list only installed packages whose name matches @var{regexp}. ^^^^^^^^^ ?? --Sig_/5.o8YNvV_wZtLe9/EBZv=JO Content-Type: application/pgp-signature Content-Description: OpenPGP digital signature -----BEGIN PGP SIGNATURE----- iQEzBAEBCAAdFiEEds7GsXJ0tGXALbPZ5xo1VCwwuqUFAlzLDqoACgkQ5xo1VCww uqUW5Af/d9HK1XCAKIK06sQVngyDZh/aLyCrFXFPLcWhSjJk5vAyRIOq2BuRr8Oo Kb+7k18YmNj99U25iDDq1EoWv1L6geLT10wNjKXnbT7x01kZKcDELug50DfAPFzh 2KbJZErYtzBZMDw8IIMLecv6cdu0EtPm6YtPFTWMRiVzFcNnQROWTbI05sY3YMxb bFmUJqtMyN0+t66YUE1l9U9GWSIo59khILOW+Xl47z92KNloolNqze4YkCX48Xax 7aCEfSGBtoaN6rAgQtKJjzqyDJpNrxztsACKusL4DhV6RdmNJ1k+gVtS7HqnKgVu hgFrNs5JXqoKiVekIcZ0VsidKeCf3Q== =129X -----END PGP SIGNATURE----- --Sig_/5.o8YNvV_wZtLe9/EBZv=JO-- From debbugs-submit-bounces@debbugs.gnu.org Thu May 02 17:43:19 2019 Received: (at 35525-done) by debbugs.gnu.org; 2 May 2019 21:43:19 +0000 Received: from localhost ([127.0.0.1]:47184 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hMJU7-0000yM-EX for submit@debbugs.gnu.org; Thu, 02 May 2019 17:43:19 -0400 Received: from eggs.gnu.org ([209.51.188.92]:51795) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hMJU6-0000yB-Am for 35525-done@debbugs.gnu.org; Thu, 02 May 2019 17:43:18 -0400 Received: from fencepost.gnu.org ([2001:470:142:3::e]:53320) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1hMJU0-0004cW-Gs; Thu, 02 May 2019 17:43:12 -0400 Received: from [2a01:e0a:1d:7270:af76:b9b:ca24:c465] (port=42660 helo=ribbon) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1hMJU0-0005Uv-1w; Thu, 02 May 2019 17:43:12 -0400 From: =?utf-8?Q?Ludovic_Court=C3=A8s?= To: Danny Milosavljevic Subject: Re: bug#35525: guix-manual proposals References: <2530df52d53c8ac976ce37ed854b509a@disroot.org> <87tvecubi7.fsf@gnu.org> <20190502173714.2cb399c3@scratchpost.org> X-URL: http://www.fdn.fr/~lcourtes/ X-Revolutionary-Date: 13 =?utf-8?Q?Flor=C3=A9al?= an 227 de la =?utf-8?Q?R?= =?utf-8?Q?=C3=A9volution?= X-PGP-Key-ID: 0x090B11993D9AEBB5 X-PGP-Key: http://www.fdn.fr/~lcourtes/ludovic.asc X-PGP-Fingerprint: 3CE4 6455 8A84 FDC6 9DB4 0CFB 090B 1199 3D9A EBB5 X-OS: x86_64-pc-linux-gnu Date: Thu, 02 May 2019 23:43:09 +0200 In-Reply-To: <20190502173714.2cb399c3@scratchpost.org> (Danny Milosavljevic's message of "Thu, 2 May 2019 17:37:14 +0200") Message-ID: <87h8acsfbm.fsf@gnu.org> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/26.2 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 35525-done Cc: 35525-done@debbugs.gnu.org, znavko@disroot.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) Danny Milosavljevic skribis: > as far as I can see, it's also wrong in the original in the manual. > > doc/guix.texi: > > @item --list-available[=@var{regexp}] > @itemx -A [@var{regexp}] > List packages currently available in the distribution for this system > (@pxref{GNU Distribution}). When @var{regexp} is specified, list only > installed packages whose name matches @var{regexp}. > ^^^^^^^^^ ?? Oops indeed! I guess you can push a fix. :-) Ludo'. From debbugs-submit-bounces@debbugs.gnu.org Fri May 03 00:51:43 2019 Received: (at 35525-done) by debbugs.gnu.org; 3 May 2019 04:51:43 +0000 Received: from localhost ([127.0.0.1]:47495 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hMQAg-0002Wf-IQ for submit@debbugs.gnu.org; Fri, 03 May 2019 00:51:43 -0400 Received: from knopi.disroot.org ([178.21.23.139]:32768) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hMQAe-0002WX-R3 for 35525-done@debbugs.gnu.org; Fri, 03 May 2019 00:51:41 -0400 Received: from localhost (localhost [127.0.0.1]) by disroot.org (Postfix) with ESMTP id AE4CC2AB3C; Fri, 3 May 2019 06:51:39 +0200 (CEST) X-Virus-Scanned: Debian amavisd-new at disroot.org Received: from knopi.disroot.org ([127.0.0.1]) by localhost (disroot.org [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id Is4Mz-0gGYHd; Fri, 3 May 2019 06:51:37 +0200 (CEST) Mime-Version: 1.0 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=disroot.org; s=mail; t=1556859097; bh=GgCGa/0PkBEM/vqDojmZQf37wU/FuakCnrmhqDC5Jrk=; h=Date:From:Subject:To:Cc:In-Reply-To:References; b=SydUpEH+1FEe/1NtRaxOCcpYd6BbI8oD0Ggao3+nuuhOOyJ4aXs8b0MHRLBIlet/n qHc4Kqrfu2Bo2QkU47UvawmffY2O+AO3B3/kh0C/tlQw7vTjT3as66Ng+ll+rlESJr EMI4WYdufKZmng8HqqUv3Jjma5kOEQ0HpsDl3ShWmjgX1SbkTBnKy4ET9h5GHNxH7W vL16HGB/g3BMVHP5bPiNQ0cbzexCaFyXqIocRIK+W9IDolCK5svf0u1MwBrG4uR5WA hZRW2fIZ3XwMUpIPP/yvTijRhZ/bNtbdYGcBUYJNKk68SPWlRFbVxewCOkmhz2yH5C HHCQnjCUuF+iA== Date: Fri, 03 May 2019 04:51:37 +0000 Content-Type: multipart/alternative; boundary="--=_RainLoop_191_148558526.1556859097" From: znavko@disroot.org Message-ID: Subject: Re: bug#35525: guix-manual proposals To: "=?utf-8?B?THVkb3ZpYyBDb3VydMOocw==?=" , "Danny Milosavljevic" In-Reply-To: <87h8acsfbm.fsf@gnu.org> References: <87h8acsfbm.fsf@gnu.org> <2530df52d53c8ac976ce37ed854b509a@disroot.org> <87tvecubi7.fsf@gnu.org> <20190502173714.2cb399c3@scratchpost.org> X-Spam-Score: 0.0 (/) X-Debbugs-Envelope-To: 35525-done Cc: 35525-done@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.0 (-) ----=_RainLoop_191_148558526.1556859097 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: quoted-printable These are my current suggestions:=0AHere GuixSD rests instead of Guix Sys= tem:=0A=0A#. type: Plain text=0A#: doc/guix.texi:2650=0Amsgid ""=0A"If yo= u are not using the Guix System Distribution, consider adding the "=0A"fo= llowing lines to your @file{~/.bash_profile} (@pxref{Bash Startup Files,,= , "=0A"bash, The GNU Bash Reference Manual}) so that newly-spawned shells= get all "=0A"the right environment variable definitions:"=0A#. type: Pla= in text=0A#: doc/guix.texi:3140=0Amsgid ""=0A"Substitutes from the offici= al build farm are enabled by default when using "=0A"the Guix System Dist= ribution (@pxref{GNU Distribution}). However, they are "=0A"disabled by d= efault when using Guix on a foreign distribution, unless you "=0A"have ex= plicitly enabled them via one of the recommended installation steps "=0A"= (@pxref{Installation}). The following paragraphs describe how to enable o= r "=0A"disable substitutes for the official build farm; the same procedur= e can also "=0A"be used to enable substitutes for any other substitute se= rver."=0AThe word 'installed' is wrong:=0A=0A#. type: itemx=0A#: doc/guix= .texi:3011 doc/guix.texi:3024=0A#, no-wrap=0Amsgid "-A [@var{regexp}]"=0A= =0A#. type: table=0A#: doc/guix.texi:3015 doc/guix.texi:3028=0Amsgid ""= =0A"List packages currently available in the distribution for this system= "=0A"(@pxref{GNU Distribution}). When @var{regexp} is specified, list on= ly "=0A"installed packages whose name matches @var{regexp}."=0A=0AIn my o= wn as I see, it does not list installed but all available packages.=0AHer= e it is 'many types of fs', but only one mentioned as example:=0A=0A#. ty= pe: Plain text=0A#: doc/guix.texi:2268=0Amsgid ""=0A"Alternatively, you m= ay use a swap file. For example, assuming that in the "=0A"new system you= want to use the file @file{/swapfile} as a swap file, you "=0A"would run= @footnote{This example will work for many types of file systems (e."=0A"g= ., ext4). However, for copy-on-write file systems (e.g., btrfs), the "=0A= "required steps may be different. For details, see the manual pages for "= =0A"@command{mkswap} and @command{swapon}.}:"=0AAnd also if another langu= age is ready to use (Spanish), need to say it on:=0A=0A#. type: Plain tex= t=0A#: doc/guix.texi:117=0Amsgid ""=0A"This manual is also available in F= rench (@pxref{Top,,, guix.fr, Manuel de "=0A"r=C3=A9f=C3=A9rence de GNU G= uix}) and German (@pxref{Top,,, guix.de, Referenzhandbuch "=0A"zu GNU Gui= x}). If you would like to translate it in your native language, "=0A"cons= ider joining the @uref{https://translationproject.org/domain/guix-manual.= "=0A"html, Translation Project}."=0AMay 2, 2019 9:43 PM, "Ludovic Court= =C3=A8s" wrote:=0A Danny Milosavljev= ic skribis:=0A a= s far as I can see, it's also wrong in the original in the manual.=0A=0Ad= oc/guix.texi:=0A=0A@item --list-available[=3D@var{regexp}]=0A@itemx -A [@= var{regexp}]=0AList packages currently available in the distribution for = this system=0A(@pxref{GNU Distribution}). When @var{regexp} is specified,= list only=0Ainstalled packages whose name matches @var{regexp}.=0A^^^^^^= ^^^ ?? =0A=0AOops indeed! I guess you can push a fix. :-)=0A=0ALudo'. ----=_RainLoop_191_148558526.1556859097 Content-Type: text/html; charset="utf-8" Content-Transfer-Encoding: quoted-printable
T= hese are my current suggestions:




Here GuixSD rests ins= tead of Guix System:

#. type: Plain text
#: doc/guix.texi:2650<= br>msgid ""
"If you are not using the Guix System Distribution, consid= er adding the "
"following lines to your @file{~/.bash_profile} (@pxre= f{Bash Startup Files,,, "
"bash, The GNU Bash Reference Manual}) so th= at newly-spawned shells get all "
"the right environment variable defi= nitions:"


#. type: Plain text
#: doc/guix.texi:3140
msgi= d ""
"Substitutes from the official build farm are enabled by default = when using "
"the Guix System Distribution (@pxref{GNU Distribution}).= However, they are "
"disabled by default when using Guix on a foreign= distribution, unless you "
"have explicitly enabled them via one of t= he recommended installation steps "
"(@pxref{Installation}). The follo= wing paragraphs describe how to enable or "
"disable substitutes for t= he official build farm; the same procedure can also "
"be used to enab= le substitutes for any other substitute server."



The word = 'installed' is wrong:

#. type: itemx
#: doc/guix.texi:3011 doc/= guix.texi:3024
#, no-wrap
msgid "-A [@var{regexp}]"

#. type:= table
#: doc/guix.texi:3015 doc/guix.texi:3028
msgid ""
"List p= ackages currently available in the distribution for this system "
"(@p= xref{GNU Distribution}). When @var{regexp} is specified, list only "
"= installed packages whose name matches @var{regexp}."

In my own as = I see, it does not list installed but all available packages.


=

Here it is 'many types of fs', but only one mentioned as example:=

#. type: Plain text
#: doc/guix.texi:2268
msgid ""
"Alte= rnatively, you may use a swap file. For example, assuming that in the ""new system you want to use the file @file{/swapfile} as a swap file, y= ou "
"would run@footnote{This example will work for many types of file= systems (e."
"g., ext4). However, for copy-on-write file systems (e.g= ., btrfs), the "
"required steps may be different. For details, see th= e manual pages for "
"@command{mkswap} and @command{swapon}.}:"



And also if another language is ready to use (Spanish), need= to say it on:

#. type: Plain text
#: doc/guix.texi:117
msgi= d ""
"This manual is also available in French (@pxref{Top,,, guix.fr, = Manuel de "
"r=C3=A9f=C3=A9rence de GNU Guix}) and German (@pxref{Top,= ,, guix.de, Referenzhandbuch "
"zu GNU Guix}). If you would like to tr= anslate it in your native language, "
"consider joining the @uref{http= s://translationproject.org/domain/guix-manual."
"html, Translation Pro= ject}."





May 2, 2019 9:43 PM, "Ludovic Court=C3=A8s= " <ludo@gnu.org> wrote:
Danny Milosavljevi= c <dannym@scratchpost.org> skribis:
as far as I can see, it's also wrong in the original in the manual.
doc/guix.texi:

@item --list-available[=3D@var{regexp}]
@i= temx -A [@var{regexp}]
List packages currently available in the distri= bution for this system
(@pxref{GNU Distribution}). When @var{regexp} i= s specified, list only
installed packages whose name matches @var{rege= xp}.
^^^^^^^^^ ??


Oops indeed! I guess you can pu= sh a fix. :-)

Ludo'.
----=_RainLoop_191_148558526.1556859097-- From debbugs-submit-bounces@debbugs.gnu.org Thu May 09 15:12:42 2019 Received: (at 35525-done) by debbugs.gnu.org; 9 May 2019 19:12:42 +0000 Received: from localhost ([127.0.0.1]:36453 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hOoTB-0004xe-PI for submit@debbugs.gnu.org; Thu, 09 May 2019 15:12:42 -0400 Received: from knopi.disroot.org ([178.21.23.139]:35202) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hOoT7-0004xP-FV for 35525-done@debbugs.gnu.org; Thu, 09 May 2019 15:12:39 -0400 Received: from localhost (localhost [127.0.0.1]) by disroot.org (Postfix) with ESMTP id 622E030C99; Thu, 9 May 2019 21:12:35 +0200 (CEST) X-Virus-Scanned: Debian amavisd-new at disroot.org Received: from knopi.disroot.org ([127.0.0.1]) by localhost (disroot.org [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id wh7M4MHYR88j; Thu, 9 May 2019 21:12:32 +0200 (CEST) Mime-Version: 1.0 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=disroot.org; s=mail; t=1557429152; bh=lUXav+tySfsDSFMDZjnriqqCtsUsTwA4Qmdm1rHUz0U=; h=Date:From:Subject:To:Cc:In-Reply-To:References; b=dY3Nk90VlSbbjJH7XA/wPCYRSxxEck89R5xIeAu5ad3B/cPAed2FSeJZlsUheR/9Q +o7tmxmJGdxTUZMh/MRbk9IFq2Gh8zsEKLmmXWJtHe+sITRpiNEpoogXK57QT0PnOc k1brNwCXqQX1Pk6t0koTjYhg4Go31sZ6KTf6FcGXobHndhHXoVkzxLCjmbSv38+PMO Xd57WEY1JV/88HOzxp27N6Kketj8+sTnyo4DidIs56aZ85QczKqHgj+xbZbmQHdhgA qTqnWK7pCqYQH+M4Bb4t4ie5XMbQ3Dwt+S3I1F5SIpDBNbYUdH7naAB8NJXTOYyqth 2PJkSbACgh6kg== Date: Thu, 09 May 2019 19:12:31 +0000 Content-Type: multipart/alternative; boundary="--=_RainLoop_224_431844835.1557429151" From: znavko@disroot.org Message-ID: <6fc33b228dc5956eb23e82e6bcc6c49d@disroot.org> Subject: Re: bug#35525: guix-manual proposals To: "=?utf-8?B?THVkb3ZpYyBDb3VydMOocw==?=" , "Danny Milosavljevic" In-Reply-To: References: <87h8acsfbm.fsf@gnu.org> <2530df52d53c8ac976ce37ed854b509a@disroot.org> <87tvecubi7.fsf@gnu.org> <20190502173714.2cb399c3@scratchpost.org> X-Spam-Score: 0.0 (/) X-Debbugs-Envelope-To: 35525-done Cc: 35525-done@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.0 (-) ----=_RainLoop_224_431844835.1557429151 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: quoted-printable Hello! Thank you for your corrections. I've discovered new mistakes in th= e Guix Manual:=0A=0A;;09-05-2019=0A;; what is API@ ? is @ symbol necessar= y there?=0A=0A#. type: Plain text=0A#: doc/guix.texi:3987=0Amsgid "When c= ombined with channels (@pxref{Channels}), inferiors provide a simple way = to interact with a separate revision of Guix. For example, let's assume y= ou want to install in your profile the current @code{guile} package, alon= g with the @code{guile-json} as it existed in an older revision of Guix--= -perhaps because the newer @code{guile-json} has an incompatible API and = you want to run your code against the old API@. To do that, you could wri= te a manifest for use by @code{guix package --manifest} (@pxref{Invoking = guix package}); in that manifest, you would create an inferior for that o= ld Guix revision you care about, and you would look up the @code{guile-js= on} package in the inferior:"=0A;;09-05-2019=0A;; why '(as always!)@:'? i= s @ symbol necessary there?=0A=0A#. type: Plain text=0A#: doc/guix.texi:3= 850=0Amsgid "Note that the snippet above is (as always!)@: Scheme code; w= e use @code{cons} to add a channel the list of channels that the variable= @code{%default-channels} is bound to (@pxref{Pairs, @code{cons} and list= s,, guile, GNU Guile Reference Manual}). With this file in place, @comman= d{guix pull} builds not only Guix but also the package modules from your = own repository. The result in @file{~/.config/guix/current} is the union = of Guix with your own package modules:"=0A;;09-05-2019=0A;; 'to' is misse= d here: 'to add a channel .. the list'=0A#. type: Plain text=0A#: doc/gui= x.texi:3850=0Amsgid "Note that the snippet above is (as always!)@: Scheme= code; we use @code{cons} to add a channel the list of channels that the = variable @code{%default-channels} is bound to (@pxref{Pairs, @code{cons} = and lists,, guile, GNU Guile Reference Manual}). With this file in place,= @command{guix pull} builds not only Guix but also the package modules fr= om your own repository. The result in @file{~/.config/guix/current} is th= e union of Guix with your own package modules:"=0AThe word 'installed' is= wrong:=0A=0A#. type: itemx=0A#: doc/guix.texi:3011 doc/guix.texi:3024=0A= #, no-wrap=0Amsgid "-A [@var{regexp}]"=0A=0A#. type: table=0A#: doc/guix.= texi:3015 doc/guix.texi:3028=0Amsgid ""=0A"List packages currently availa= ble in the distribution for this system "=0A"(@pxref{GNU Distribution}). = When @var{regexp} is specified, list only "=0A"installed packages whose n= ame matches @var{regexp}."=0A=0AIn my own as I see, it does not list inst= alled but all available packages.=0APlease, inform me if these mistakes a= re not mistakes or when they will be corrected for I to be patient.=0AMay= 3, 2019 4:52 AM, znavko@disroot.org (mailto:znavko@disroot.org) wrote:= =0AThese are my current suggestions:=0AHere GuixSD rests instead of Guix = System:=0A=0A#. type: Plain text=0A#: doc/guix.texi:2650=0Amsgid ""=0A"If= you are not using the Guix System Distribution, consider adding the "=0A= "following lines to your @file{~/.bash_profile} (@pxref{Bash Startup File= s,,, "=0A"bash, The GNU Bash Reference Manual}) so that newly-spawned she= lls get all "=0A"the right environment variable definitions:"=0A#. type: = Plain text=0A#: doc/guix.texi:3140=0Amsgid ""=0A"Substitutes from the off= icial build farm are enabled by default when using "=0A"the Guix System D= istribution (@pxref{GNU Distribution}). However, they are "=0A"disabled b= y default when using Guix on a foreign distribution, unless you "=0A"have= explicitly enabled them via one of the recommended installation steps "= =0A"(@pxref{Installation}). The following paragraphs describe how to enab= le or "=0A"disable substitutes for the official build farm; the same proc= edure can also "=0A"be used to enable substitutes for any other substitut= e server."=0AThe word 'installed' is wrong:=0A=0A#. type: itemx=0A#: doc/= guix.texi:3011 doc/guix.texi:3024=0A#, no-wrap=0Amsgid "-A [@var{regexp}]= "=0A=0A#. type: table=0A#: doc/guix.texi:3015 doc/guix.texi:3028=0Amsgid = ""=0A"List packages currently available in the distribution for this syst= em "=0A"(@pxref{GNU Distribution}). When @var{regexp} is specified, list = only "=0A"installed packages whose name matches @var{regexp}."=0A=0AIn my= own as I see, it does not list installed but all available packages.=0AH= ere it is 'many types of fs', but only one mentioned as example:=0A=0A#. = type: Plain text=0A#: doc/guix.texi:2268=0Amsgid ""=0A"Alternatively, you= may use a swap file. For example, assuming that in the "=0A"new system y= ou want to use the file @file{/swapfile} as a swap file, you "=0A"would r= un@footnote{This example will work for many types of file systems (e."=0A= "g., ext4). However, for copy-on-write file systems (e.g., btrfs), the "= =0A"required steps may be different. For details, see the manual pages fo= r "=0A"@command{mkswap} and @command{swapon}.}:"=0AAnd also if another la= nguage is ready to use (Spanish), need to say it on:=0A=0A#. type: Plain = text=0A#: doc/guix.texi:117=0Amsgid ""=0A"This manual is also available i= n French (@pxref{Top,,, guix.fr, Manuel de "=0A"r=C3=A9f=C3=A9rence de GN= U Guix}) and German (@pxref{Top,,, guix.de, Referenzhandbuch "=0A"zu GNU = Guix}). If you would like to translate it in your native language, "=0A"c= onsider joining the @uref{https://translationproject.org/domain/guix-manu= al (https://translationproject.org/domain/guix-manual)."=0A"html, Transla= tion Project}."=0AMay 2, 2019 9:43 PM, "Ludovic Court=C3=A8s" wrote:=0A=0A Danny Milosavljevic skribis:as far as I can see, i= t's also wrong in the original in the manual.=0A=0Adoc/guix.texi:=0A=0A@i= tem --list-available[=3D@var{regexp}]=0A@itemx -A [@var{regexp}]=0AList p= ackages currently available in the distribution for this system=0A(@pxref= {GNU Distribution}). When @var{regexp} is specified, list only=0Ainstalle= d packages whose name matches @var{regexp}.=0A^^^^^^^^^ ?? =0A=0AOops ind= eed! I guess you can push a fix. :-)=0A=0ALudo'. ----=_RainLoop_224_431844835.1557429151 Content-Type: text/html; charset="utf-8" Content-Transfer-Encoding: quoted-printable
H= ello! Thank you for your corrections. I've discovered new mistakes in the= Guix Manual:

;;09-05-2019
;; what is API@ ? is @ symbol necess= ary there?

#. type: Plain text
#: doc/guix.texi:3987
msgid "= When combined with channels (@pxref{Channels}), inferiors provide a simpl= e way to interact with a separate revision of Guix. For example, let's as= sume you want to install in your profile the current @code{guile} package= , along with the @code{guile-json} as it existed in an older revision of = Guix---perhaps because the newer @code{guile-json} has an incompatible AP= I and you want to run your code against the old API@. To do that, you cou= ld write a manifest for use by @code{guix package --manifest} (@pxref{Inv= oking guix package}); in that manifest, you would create an inferior for = that old Guix revision you care about, and you would look up the @code{gu= ile-json} package in the inferior:"


;;09-05-2019
;; why '(a= s always!)@:'? is @ symbol necessary there?

#. type: Plain text#: doc/guix.texi:3850
msgid "Note that the snippet above is (as alway= s!)@: Scheme code; we use @code{cons} to add a channel the list of channe= ls that the variable @code{%default-channels} is bound to (@pxref{Pairs, = @code{cons} and lists,, guile, GNU Guile Reference Manual}). With this fi= le in place, @command{guix pull} builds not only Guix but also the packag= e modules from your own repository. The result in @file{~/.config/guix/cu= rrent} is the union of Guix with your own package modules:"


;;= 09-05-2019
;; 'to' is missed here: 'to add a channel .. the list'
#= . type: Plain text
#: doc/guix.texi:3850
msgid "Note that the snipp= et above is (as always!)@: Scheme code; we use @code{cons} to add a chann= el the list of channels that the variable @code{%default-channels} is bou= nd to (@pxref{Pairs, @code{cons} and lists,, guile, GNU Guile Reference M= anual}). With this file in place, @command{guix pull} builds not only Gui= x but also the package modules from your own repository. The result in @f= ile{~/.config/guix/current} is the union of Guix with your own package mo= dules:"




The word 'installed' is wrong:

#. type:= itemx
#: doc/guix.texi:3011 doc/guix.texi:3024
#, no-wrap
msgid= "-A [@var{regexp}]"

#. type: table
#: doc/guix.texi:3015 doc/g= uix.texi:3028
msgid ""
"List packages currently available in the di= stribution for this system "
"(@pxref{GNU Distribution}). When @var{re= gexp} is specified, list only "
"installed packages whose name matches= @var{regexp}."

In my own as I see, it does not list installed but= all available packages.


Please, inform me if these mistakes a= re not mistakes or when they will be corrected for I to be patient.



May 3, 2019 4:52 AM, znavko@disroot.org wrote:
These are my current suggestions:




Here GuixSD re= sts instead of Guix System:

#. type: Plain text
#: doc/guix.tex= i:2650
msgid ""
"If you are not using the Guix System Distribution,= consider adding the "
"following lines to your @file{~/.bash_profile}= (@pxref{Bash Startup Files,,, "
"bash, The GNU Bash Reference Manual}= ) so that newly-spawned shells get all "
"the right environment variab= le definitions:"


#. type: Plain text
#: doc/guix.texi:3140<= br>msgid ""
"Substitutes from the official build farm are enabled by d= efault when using "
"the Guix System Distribution (@pxref{GNU Distribu= tion}). However, they are "
"disabled by default when using Guix on a = foreign distribution, unless you "
"have explicitly enabled them via o= ne of the recommended installation steps "
"(@pxref{Installation}). Th= e following paragraphs describe how to enable or "
"disable substitute= s for the official build farm; the same procedure can also "
"be used = to enable substitutes for any other substitute server."



Th= e word 'installed' is wrong:

#. type: itemx
#: doc/guix.texi:30= 11 doc/guix.texi:3024
#, no-wrap
msgid "-A [@var{regexp}]"

#= . type: table
#: doc/guix.texi:3015 doc/guix.texi:3028
msgid ""
= "List packages currently available in the distribution for this system "<= br>"(@pxref{GNU Distribution}). When @var{regexp} is specified, list only= "
"installed packages whose name matches @var{regexp}."

In my = own as I see, it does not list installed but all available packages.
<= br>


Here it is 'many types of fs', but only one mentioned as e= xample:

#. type: Plain text
#: doc/guix.texi:2268
msgid """Alternatively, you may use a swap file. For example, assuming that in = the "
"new system you want to use the file @file{/swapfile} as a swap = file, you "
"would run@footnote{This example will work for many types = of file systems (e."
"g., ext4). However, for copy-on-write file syste= ms (e.g., btrfs), the "
"required steps may be different. For details,= see the manual pages for "
"@command{mkswap} and @command{swapon}.}:"=




And also if another language is ready to use (Spanish= ), need to say it on:

#. type: Plain text
#: doc/guix.texi:117<= br>msgid ""
"This manual is also available in French (@pxref{Top,,, gu= ix.fr, Manuel de "
"r=C3=A9f=C3=A9rence de GNU Guix}) and German (@pxr= ef{Top,,, guix.de, Referenzhandbuch "
"zu GNU Guix}). If you would lik= e to translate it in your native language, "
"consider joining the @ur= ef{https://translationproject.org/doma= in/guix-manual."
"html, Translation Project}."




=
May 2, 2019 9:43 PM, "Ludovic Court=C3=A8s" <ludo@gnu.org> wrote:

Danny M= ilosavljevic <dannym@= scratchpost.org> skribis:
as far as I can see, it's als= o wrong in the original in the manual.

doc/guix.texi:

@item= --list-available[=3D@var{regexp}]
@itemx -A [@var{regexp}]
List pa= ckages currently available in the distribution for this system
(@pxref= {GNU Distribution}). When @var{regexp} is specified, list only
install= ed packages whose name matches @var{regexp}.
^^^^^^^^^ ??
=

Oops indeed! I guess you can push a fix. :-)

Ludo'.


<= /div> ----=_RainLoop_224_431844835.1557429151-- From unknown Mon Jun 16 23:30:26 2025 Received: (at fakecontrol) by fakecontrolmessage; To: internal_control@debbugs.gnu.org From: Debbugs Internal Request Subject: Internal Control Message-Id: bug archived. Date: Fri, 07 Jun 2019 11:24:06 +0000 User-Agent: Fakemail v42.6.9 # This is a fake control message. # # The action: # bug archived. thanks # This fakemail brought to you by your local debbugs # administrator