This is the mail archive of the
gdb-patches@sourceware.org
mailing list for the GDB project.
Re: GDB 7.99.91 MinGW compilation error in cli-script.c
> Cc: brobecker@adacore.com, simon.marchi@polymtl.ca, gdb-patches@sourceware.org
> From: Pedro Alves <palves@redhat.com>
> Date: Fri, 26 May 2017 15:10:01 +0100
>
> > So the convention is to include the full qualifier of every method?
> > Including the namespace of the class? Does that include the whole
> > chain of namespaces up to the root? If not, where does one stop?
>
> I admit that I'm puzzled about you having an issue with
> gdb::to_string, when your original entry said "(std::to_string)",
> not "(to_string)".
I did that because of the different namespaces involved in that
particular change. But that was an exception: I normally don't look
too hard at what Emacs's add-log commands produce in the parentheses,
I just trust it to DTRT. Having to manually correct that in each case
is a complication.
> I think the convention is to provide enough qualifiers to
> to make it convenient to search/see what function was changed.
> For class methods, I think we should include the class name,
> otherwise it can get ambiguous. I'm fine with not mentioning
> the namespace when otherwise it's obvious or redundant. E.g.,
> if all of gdb was in namespace gdb [it's not], it'd probably not
> make much sense to keep putting "gdb::" everywhere. But when
> referring to a symbol outside gdb's namespace, I'd think it wise to
> mention the namespace, so that it's clearer what the entry
> is referring to.
Well, I suggest to document these conventions somewhere, like the
Wiki. I don't think they are self-evident, and standards.texi doesn't
say anything about qualifying method names, it just tells to use the
Emacs add-log commands and the related VC features.
> I never managed to get used to using emacs commands to write the ChangeLog.
> I write ChangeLog entries manually, directly in the git commit log,
> while scrolling through the diff, as last "self review" event, and
> then copy over to the ChangeLog file at push time.
You will find some advice for a better workflow in the CONTRIBUTE file
in the Emacs repository
(http://git.savannah.gnu.org/cgit/emacs.git/tree/CONTRIBUTE).
I've just asked the CC Mode maintainer to allow the add-log commands
to not strip the class qualifiers. But namespace qualifiers will
still have to be added by hand, I'm afraid, which is a bit of a
nuisance, IMO.