Re: [Windows/RFA/commit] Deprecate windows-specific dll-symbols command and aliases

Pedro Alves
2014-02-04T20:20:54Z

On 01/31/2014 11:49 AM, Eli Zaretskii wrote:
>> > If no one else comments on it, I'll go with your suggestion of
>> > removing it now.
> I think we shouldn't advertise deprecated features.

I'm not sure I agree with that policy. I mean, we shouldn't advertise
them, yes, and I think we do hide deprecated commands in the CLI
at places, IIRC, but as long as they exist, I think they should
be documented. IMO, it'd be nicer to users who are currently using
such commands, and find out they're deprecated (because GDB warns) if
they go to the manual and find both the replacement they should be
using (and how), and the docu for the old command, so they can easily
map arguments, etc. IOW, IMO, we should instead add a "This command is
deprecated; a better alternative is blah blah" note. When I grep
for deprecate_cmd, and then look for the documentation of the
corresponding deprecated commands, I do find it.
E.g., "record restore", "disable tracepoint", "set remotebreak", etc.

--
Pedro Alves