Re: How to use "setuid-program"?

[Pascal Lorenz]

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