unofficial mirror of help-guix@gnu.org 
 help / color / mirror / Atom feed
From: Pascal Lorenz <guix.gnu.org-p@trilingual.eu>
To: Tobias Geerinckx-Rice <me@tobias.gr>
Cc: help-guix@gnu.org
Subject: Re: How to use "setuid-program"?
Date: Fri, 17 Sep 2021 20:26:11 +0200	[thread overview]
Message-ID: <49774D41-D089-47E8-AD95-E946B565E4DC@trilingual.eu> (raw)
In-Reply-To: <878rzv16lv.fsf@nckx>

What do you think about merging both entries of the manual in the main menu of the page and let it display a page in this vein:

NU Guix Reference Manual

This document is available in the following languages:

| language | current ("developer")     | Version (1.3.) ("stable")          |
|----------+---------------------------+------------------------------------|
| Deutsch  |[[https://guix.gnu.org/manual/devel/de/html_node][HTML]],  [[https://guix.gnu.org/manual/devel/de/guix.html][HTML (single page)]],  [[https://guix.gnu.org/manual/devel/de/guix.pdf][PDF]] |[[https://guix.gnu.org/manual/de/html_node][HTML]],  [[https://guix.gnu.org/manual/de/guix.html][HTML (single page)]],  [[https://guix.gnu.org/manual/de/guix.pdf][PDF]] |
| English   |[[https://guix.gnu.org/manual/devel/en/html_node][HTML]],  [[https://guix.gnu.org/manual/devel/en/guix.html][HTML (single page)]],  [[https://guix.gnu.org/manual/devel/en/guix.pdf][PDF]] |[[https://guix.gnu.org/manual/en/html_node][HTML]],  [[https://guix.gnu.org/manual/en/guix.html][HTML (single page)]],  [[https://guix.gnu.org/manual/en/guix.pdf][PDF]] |
| Español  |[[https://guix.gnu.org/manual/devel/es/html_node][HTML]],  [[https://guix.gnu.org/manual/devel/es/guix.html][HTML (single page)]],  [[https://guix.gnu.org/manual/devel/es/guix.pdf][PDF]] |[[https://guix.gnu.org/manual/es/html_node][HTML]],  [[https://guix.gnu.org/manual/es/guix.html][HTML (single page)]],  [[https://guix.gnu.org/manual/es/guix.pdf][PDF]] |
| français  |[[https://guix.gnu.org/manual/devel/fr/html_node][HTML]],  [[https://guix.gnu.org/manual/devel/fr/guix.html][HTML (single page)]],  [[https://guix.gnu.org/manual/devel/fr/guix.pdf][PDF]] |[[https://guix.gnu.org/manual/fr/html_node][HTML]],  [[https://guix.gnu.org/manual/fr/guix.html][HTML (single page)]],  [[https://guix.gnu.org/manual/fr/guix.pdf][PDF]] |
| русский   |[[https://guix.gnu.org/manual/devel/ru/html_node][HTML]],  [[https://guix.gnu.org/manual/devel/ru/guix.html][HTML (single page)]],  [[https://guix.gnu.org/manual/devel/ru/guix.pdf][PDF]] |[[https://guix.gnu.org/manual/ru/html_node][HTML]],  [[https://guix.gnu.org/manual/ru/guix.html][HTML (single page)]],  [[https://guix.gnu.org/manual/ru/guix.pdf][PDF]] |
| 中文     |[[https://guix.gnu.org/manual/devel/zh-cn/html_node][HTML]],  [[https://guix.gnu.org/manual/devel/zh-cn/guix.html][HTML (single page)]],  [[https://guix.gnu.org/manual/devel/zh-cn/guix.pdf][PDF]] |[[https://guix.gnu.org/manual/zh-cn/html_node][HTML]],  [[https://guix.gnu.org/manual/zh-cn/guix.html][HTML (single page)]],  [[https://guix.gnu.org/manual/zh-cn/guix.pdf][PDF]] |


  * If you computer is already running Guix, running `info guix` is probably the best way to read the current documentation
  * If unsure, the "stable" documentation is probably not the one you are looking for
  * You might also want to download the [[https://guix.gnu.org/guix-refcard.pdf][Guix reference card]]
  * Or have a look at the cookbook, accessible via `info guix-cookbook` or [[https://guix.gnu.org/cookbook/][online]].
    It contains tutorials, how-to guides and examples contributed by the Guix community which show you how to use the system and its collection of packages to achieve common and not-so-common goals users may have.
  * There is also a [[https://libreplanet.org/wiki/Group:Guix][wiki]] & [[https://guix.gnu.org/en/videos/][videos]]
  * If you need help, there are the IRC, the mailing lists and their archives available at [[https://guix.gnu.org/en/contact/][guix.gnu.org/en/contact]] 
     
?

Am I right in assuming that the stable version of the manual is only useful before the first pull?

Is there a way to display the reference card on the system without grabbing the pdf? And: it would be nicer if the orientation of the pages in the pdf was rotated


Kind Regards,

Pascal


> On 17. Sep 2021, at 18:47, Tobias Geerinckx-Rice <me@tobias.gr> wrote:
> 
> Matthew Brooks 写道:
>> Thanks! I didn't realize there were two versions of the manual, and had been checking the stable one.
> 
> This state is extremely confusing and should be improved.  How did you search/browse to the ‘stable’ manual?
> 
> More generally: why did you end up loading a browser to look for the manual on the Web, instead of consulting the one on your Guix machine?  Were you aware of it?  Would you have seen a warning at the top of the page, or did you click straight through to a section/chapter?  Consider this low-budget telemetry to find out how better to point users to other options ;-)
> 
> Kind regards,
> 
> T G-R


  reply	other threads:[~2021-09-18 17:17 UTC|newest]

Thread overview: 8+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2021-09-03 18:24 How to use "setuid-program"? Matthew Brooks
2021-09-03 18:49 ` Tobias Geerinckx-Rice
2021-09-03 20:16   ` Julien Lepiller
2021-09-17 16:28     ` Matthew Brooks
2021-09-17 16:47       ` Tobias Geerinckx-Rice
2021-09-17 18:26         ` Pascal Lorenz [this message]
2021-09-19 11:37         ` Efraim Flashner
2021-09-19 15:45           ` Leo Famulari

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

  List information: https://guix.gnu.org/

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=49774D41-D089-47E8-AD95-E946B565E4DC@trilingual.eu \
    --to=guix.gnu.org-p@trilingual.eu \
    --cc=help-guix@gnu.org \
    --cc=me@tobias.gr \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).