Re: Examples of local-host-entries or hosts-service-type?

[Remco van 't Veer]

Hi Sergiu,

2023/02/13 11:49, Sergiu Ivanov:

> Actually, where did you get local-host-entries from?  The documentation
> page you and Bruno cite doesn't seem to ever mention this function :O
> Unless I am looking at some old version of the docs.

To be honest, I did not know about local-host-entries before your email
and thought it would allow me to cleanup my own (operating-system
.. (hosts-file (plain-file .. (string-append ..) mess.  So I did some
digging in the guix source and found some references in gnu/system.scm.

>> Also, I agree the documentation needs some love here.
>
> I am willing to contribute.  What would be the best place to do changes
> to the documentation?

doc/guix.texi

> I would follow this mini-roadmap:
>
> 1. Add the explanation of local-host-entries to
>    
> https://guix.gnu.org/en/manual/devel/en/html_node/Service-Reference.html#index-hosts_002dservice_002dtype
>
> 2. Say here
>    
> https://guix.gnu.org/manual/en/html_node/operating_002dsystem-Reference.html
>    that hosts-file is deprecated.
>
> 3. Update the examples here to use hosts-service-type instead of
>    hosts-file: https://guix.gnu.org/manual/en/guix.html
>
> What do you think?

Sounds like a plan to me.  Note: all the above is part of doc/guix.texi,
I think.

> I've never submitted a patch to Guix docs before, so all suggestions and
> hints are welcome :-)

Me neither (apart from a typo I found in the Service Reference section
during grepping for examples).  I don't have a clue about how
translations are kept in sync.  Maybe just go for it and collect some
feedback with a patch.

Cheers,
Remco