Re: [PATCH] maintain: Use full email addresses for mailing lists.

[Thien-Thi Nguyen]

() Mathieu Lirzin <address@hidden>
() Tue, 22 Dec 2015 15:01:54 +0100

   I have noticed a problem with email addresses in the “Standard
   Mailing Lists” section of maintain.texi.

Thanks for pointing this out.  I think your patch can be improved,
and presume you still want to contribute, so here's some feedback.

   address@hidden@var{package}.org}, for people to ask other users for help.
   -If your program has many users, you should create such a list for it.
   -For a fairly new program, which doesn't have a large user base yet, it
   -is better not to bother with this.
   address@hidden@var{package}@@gnu.org}, for people to ask other users for 
help.
   +If your program has many users, you should create such a list for it.  For a
   +fairly new program, which doesn't have a large user base yet, it is better 
not
   +to bother with this.

This is more noisy than it could be.  For "If your program has many
users...", the only difference is whitespace (due to refill).  Since
makeinfo(1) does its own filling, there is no need to touch those
lines at all.  When a modification makes the line wider than the
standard 80 (or 72) columns, you can simply break the line at a
convenient place, leaving two short(er) lines.

Also, another possible solution for this bug is to eliminate the
trailing ".org" entirely.  If you choose that approach, then you can
avoid the "line too long" considerations as the operation would
shorten the line.  Another bonus is...

    @cindex announcements, mailing list for
    If you wish, you can also have a mailing list
   address@hidden@var{package}} for announcements (@pxref{Announcements}).
   address@hidden@var{package}@@gnu.org} for announcements 
(@pxref{Announcements}).
    Any other mailing lists you find useful can also be created.

...that this chunk can be eliminated as well, on the grounds that the
various "@gnu.org" are unnecessary.  (Perhaps that was the original
thinking -- i don't know.)

-- 
Thien-Thi Nguyen -----------------------------------------------
  (if you're human and you know it) read my lisp:
    (defun responsep (type via)
      (case type
        (technical (eq 'mailing-list via))
        ...))
---------------------------------------------- GPG key: 4C807502

signature.asc
Description: PGP signature