Re: [avr-libc-dev] [patch #7464] Fix iom168p.h to be compatible withiom168.h

[Weddington, Eric]

> -----Original Message-----
> From: address@hidden
> [mailto:address@hidden On
> Behalf Of Joerg Wunsch
> Sent: Tuesday, May 24, 2011 7:59 AM
> To: address@hidden
> Subject: Re: [avr-libc-dev] [patch #7464] Fix iom168p.h to be compatible
> withiom168.h
> 
> As Weddington, Eric wrote:
> 
> > It describes the two different naming systems, but you're right, it
> > doesn't seem to explicitly say that the "SIG_" names are
> > deprecated. Joerg, we will need to change that.
> 
> Some work needs to be spent there anyway.  This entire documentation
> part used to be semi-automatically created based on Ted Roth's XML
> stuff in the xml/ subdirectory.  This system has not been used anymore
> for new header files (unfortunately, I'd say - it would have allowed
> us to regenerate the header files from scratch at any time, instead of
> manually editing them later on), so all documentation updates for
> recent devices are missing.

Well I'd say that that is a theoretical difference. As we've seen, we can't 
rely on the fact that the XML device files are always up-to-date. We have 
plenty of situations where the datasheets are updated first and the XML files 
are afterward, even by some amount of time.

There is also the issue of deprecations. Deprecations in the IO header files 
can't easily be automated. You end up with exceptions to a build script for 
almost every single header file. This necessitates maintaining the header files 
by hand after the *initial* header file generation.

Speaking of which, you closed a bug or two recently with some renamed values. 
You haven't answered yet my email about if you want to deprecate the old names 
using our new deprecation system...

Eric