From mboxrd@z Thu Jan 1 00:00:00 1970 From: znavko@disroot.org Subject: bug#35525: guix-manual proposals Date: Thu, 02 May 2019 08:38:21 +0000 Message-ID: References: <2530df52d53c8ac976ce37ed854b509a@disroot.org> Mime-Version: 1.0 Content-Type: multipart/alternative; boundary="--=_RainLoop_566_350337971.1556786301" Return-path: Received: from eggs.gnu.org ([209.51.188.92]:48652) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1hM7FA-0006ru-TB for bug-guix@gnu.org; Thu, 02 May 2019 04:39:06 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1hM7F8-0006Dt-IW for bug-guix@gnu.org; Thu, 02 May 2019 04:39:04 -0400 Received: from debbugs.gnu.org ([209.51.188.43]:60240) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1hM7F8-0006Dd-EY for bug-guix@gnu.org; Thu, 02 May 2019 04:39:02 -0400 Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1hM7F8-0000p7-7E for bug-guix@gnu.org; Thu, 02 May 2019 04:39:02 -0400 Sender: "Debbugs-submit" Resent-Message-ID: In-Reply-To: <2530df52d53c8ac976ce37ed854b509a@disroot.org> 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_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--