From: "Alfred M. Szmidt" <ams@gnu.org>
To: Eli Zaretskii <eliz@gnu.org>
Cc: drow@false.org, nathan@codesourcery.com, gdb-patches@sourceware.org
Subject: Re: more missing gplv3 notices
Date: Wed, 18 Mar 2009 16:01:00 -0000 [thread overview]
Message-ID: <E1LjxyR-0002PV-L5@fencepost.gnu.org> (raw)
In-Reply-To: <uk56oq6nl.fsf@gnu.org> (message from Eli Zaretskii on Tue, 17 Mar 2009 21:41:02 +0200)
> > 2009-01-12 Christopher Faylor <me+cygwin@cgf.cx>
> >
> > * amd64-windows-nat.c Rename gdb-specific win32_* to windows_*
> > throughout.
> > * i386-cygwin-tdep.c: Ditto.
> > * i386-windows-nat.c: Ditto.
> > * windows-nat.h: Ditto.
> > * windows-tdep.c: Ditto.
> > * windows-tdep.h: Ditto.
> > * windows-nat.c: Ditto.
> >
> > See the node "Style of Change Logs" in standards.info for details.
>
> It does not say that explicitly (doesn't mention multi-file changes at
> all), and this is not the prevailing style used by GDB developers
> based on my survey of the changelogs.
Sorry, I forgot I shouldn't talk about these things.
Though, to open a can of worms,
| It's important to name the changed function or variable in full.
| Don't abbreviate function or variable names, and don't combine them.
| Subsequent maintainers will often search for a function name to find all
| the change log entries that pertain to it; if you abbreviate the name,
| they won't find it when they search.
|
| For example, some people are tempted to abbreviate groups of function
| names by writing `* register.el ({insert,jump-to}-register)'; this is
| not a good idea, since searching for `jump-to-register' or
| `insert-register' would not find that entry.
next prev parent reply other threads:[~2009-03-18 15:46 UTC|newest]
Thread overview: 11+ messages / expand[flat|nested] mbox.gz Atom feed top
2009-03-16 9:49 Nathan Sidwell
2009-03-16 19:32 ` Eli Zaretskii
2009-03-17 11:36 ` Nathan Sidwell
2009-03-17 19:04 ` Eli Zaretskii
2009-03-17 19:28 ` Daniel Jacobowitz
2009-03-17 20:03 ` Eli Zaretskii
2009-03-18 16:01 ` Alfred M. Szmidt [this message]
2009-03-18 16:12 ` Pedro Alves
2009-03-18 16:33 ` Alfred M. Szmidt
2009-03-18 19:24 ` Pedro Alves
2009-03-18 11:05 ` Nathan Sidwell
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=E1LjxyR-0002PV-L5@fencepost.gnu.org \
--to=ams@gnu.org \
--cc=drow@false.org \
--cc=eliz@gnu.org \
--cc=gdb-patches@sourceware.org \
--cc=nathan@codesourcery.com \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox