GNU bug report logs -
#78021
30.1; Unclear sentence in (emacs)Matching
Previous Next
Reported by: Drew Adams <drew.adams <at> oracle.com>
Date: Wed, 23 Apr 2025 22:44:03 UTC
Severity: normal
Found in version 30.1
Done: Stephen Berman <stephen.berman <at> gmx.net>
Bug is archived. No further changes may be made.
Full log
Message #48 received at 78021 <at> debbugs.gnu.org (full text, mbox):
> > I do think so. Ordinary users of all stripes are encouraged
> > to file bug reports and enhancement requests. They shouldn't
> > need to access texi sources or be familiar with diffs or
> > patches. Especially for doc changes. Just tossing them a
> > patch discourages such participation.
> >
> > I write technical docs. There's no way we would expect our
> > reviewers to fiddle with source input (XML) to the doc process
> > or diffs/patches, even though they're all competent software
> > people. Reviewing doc is about reading text, and preferably
> > doing so in context.
> >
> > Think about this: Surely you didn't _write_ your improved
> > text in the form of a diff. You wrote it as ordinary text,
> > and you probably did so reading the surrounding context as
> > ordinary text. And even if you didn't, mere mortals would.
>
> Of course I didn't write the diff by hand, but I did make changes
> directly in the .texi file and then the easiest and quickest way (for
> me) to see the changes in context, and present them to others, is to
> generate a diff. To extract plain text out that is an added burden for
> me (granted, probably in most cases only a small one). But I shouldn't
> have presumed to judge what is burdensome for others.
Too burdensome for me, to deal with the diff. And I don't
want to have to track down the current doc state that it
applies against, and use the patch to create the new doc
state from that, to be reviewed.
This bug report was last modified 107 days ago.
Previous Next
GNU bug tracking system
Copyright (C) 1999 Darren O. Benham,
1997,2003 nCipher Corporation Ltd,
1994-97 Ian Jackson.