From mboxrd@z Thu Jan 1 00:00:00 1970 From: znavko@disroot.org Subject: bug#35525: guix-manual proposals Date: Wed, 01 May 2019 18:03:10 +0000 Message-ID: <2530df52d53c8ac976ce37ed854b509a@disroot.org> References: Mime-Version: 1.0 Content-Type: multipart/alternative; boundary="--=_RainLoop_664_271612391.1556733790" Return-path: Received: from eggs.gnu.org ([209.51.188.92]:43888) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1hLtaO-0004wv-PG for bug-guix@gnu.org; Wed, 01 May 2019 14:04:06 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1hLtaM-0004a6-WD for bug-guix@gnu.org; Wed, 01 May 2019 14:04:04 -0400 Received: from debbugs.gnu.org ([209.51.188.43]:59554) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1hLtaM-0004Zg-80 for bug-guix@gnu.org; Wed, 01 May 2019 14:04:02 -0400 Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1hLtaL-0003F7-Ti for bug-guix@gnu.org; Wed, 01 May 2019 14:04:01 -0400 Sender: "Debbugs-submit" Resent-Message-ID: In-Reply-To: List-Id: Bug reports for GNU Guix List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-guix-bounces+gcggb-bug-guix=m.gmane.org@gnu.org Sender: "bug-Guix" To: 35525@debbugs.gnu.org ----=_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--