GNU bug report logs - #70228
[PATCH] doc: Update gnome-desktop-configuration.

Previous Next

Package: guix-patches;

Reported by: Liliana Marie Prikler <liliana.prikler <at> gmail.com>

Date: Sat, 6 Apr 2024 05:26:03 UTC

Severity: normal

Tags: patch

Full log


View this message in rfc822 format

From: Liliana Marie Prikler <liliana.prikler <at> gmail.com>
To: Maxim Cournoyer <maxim.cournoyer <at> gmail.com>
Cc: 70228 <at> debbugs.gnu.org, rg <at> raghavgururajan.name, vivien <at> planete-kraus.eu
Subject: [bug#70228] [PATCH] doc: Update gnome-desktop-configuration.
Date: Sun, 07 Apr 2024 08:23:17 +0200
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.