[PATCH 00/24] Remove TRAD_SYNOPSIS
Craig Howland
howland@LGSInnovations.com
Thu Nov 30 16:11:00 GMT 2017
On 11/30/2017 05:28 AM, Yaakov Selkowitz wrote:
> This completely removes TRAD_SYNOPSIS and renames ANSI_SYNOPSIS to
> SYNOPSIS throughout Newlib's docuemntation. I'm just not sure about
> the doc tools themselves; should support for both of those names also
> be removed?
>
A thought is to leave them in the doc tools. Since the tools treat SYNOPSIS and
ANSI_SYNOPSIS the same, they'll work the same with or without the present
change. Leaving in TRAD_SYNOPSIS as something to be ignored plus keeping
ANSI_SYNOPSIS as working could possibly help out people that have added their
own stuff, not forcing them to make these same changes. (Probably a very small
to non-existent set of people, but it is difficult to know if there are any or
not.)Â It doesn't seem to hurt anything to leave them, although adding a note
that they have been retained for legacy purposes might be a good idea.
Thank you for doing this. I've thought of doing this for a long while, but have
never had the time to actually go ahead and do it.
Craig
More information about the Newlib
mailing list