GNU bug report logs -
#70228
[PATCH] doc: Update gnome-desktop-configuration.
Previous Next
Full log
View this message in rfc822 format
Am Samstag, dem 06.04.2024 um 11:50 -0400 schrieb Maxim Cournoyer:
> Hi Liliana,
>
> Liliana Marie Prikler <liliana.prikler <at> gmail.com> writes:
>
> > * doc/guix.texi (gnome-desktop-configuration): Fill in missing
> > fields.
> > [gnome]: Talk about the deprecation.
> > ---
> > Hi Guix,
> >
> > this patch updates the gnome-desktop-configuration documentation,
> > that really ought to have been updated sooner. It does not quite
> > match the auto-generated documentation, because I took some
> > stylistic choices and went further in some places.
>
> The long term plan (TM) is to have the auto-generated documentation
> truly auto-generated at build time. You should think of any extra
> edits manually made as possibly lost in the future, so it'd be best
> to either
>
> 1. edit the real source (docstrings)
> 2. fix the doc-generating macros if there's a problem worthy of
> addressing
>
> Otherwise, LGTM.
My edits concern a field that I'd like to see gone in that long-term
future, so it's fine. Maybe I'm missing a record-level documentation
field, though, because I'm also adding a line there.
Cheers
This bug report was last modified 1 year and 69 days ago.
Previous Next
GNU bug tracking system
Copyright (C) 1999 Darren O. Benham,
1997,2003 nCipher Corporation Ltd,
1994-97 Ian Jackson.