Re: [avr-libc-dev] [RFC] updates for sfr dox

[Theodore A. Roth]

On Thu, 22 Aug 2002, Joerg Wunsch wrote:

:) > I'll commit this tomorrow if there are no objections.
:)
:) My only concern is whether to move out the deprecated macros into
:) <avr/compat.h> instead.

Is that going to be included in one of the std files? If not, we will
break user's code, which I think we should try to keep to a minimum for
the next release.

Is there any way to have the compiler emit a warning message when the user
try to compile something that uses a deprecated interface? I think this
would be the most "gentle" way to nudge users away from the old
interfaces.

:)
:) >  The compiler's choice of which method to use when actually accessing
:) > -the IO port is completely independent of the programmer's way to write
:) > -the code.  So even if the programmer uses the memory-mapped paradigm
:) > -and writes
:) > +the IO port is completely independent of the way the programmer chooses
:) > +to write the code.  So even if the programmer uses the memory-mapped
:) > +paradigm and writes
:)
:) A wish here: when committing cosmetic fixes (like the grammar change),
:) it's IMHO better to not reformat the paragraph even if it's going to
:) overflow the usual line length.  (Of course, only in cases like this
:) where the actual formatting is done by another utility later on.)
:) That way, the actualy change (which is just a few words) won't be
:) hidden by the formatting change when reviewing the CVS diff.
:)
:) If reformatting is desired, it should then be done in a separate
:) commit (where the commit message explicitly states that it's a change
:) that doesn't affect the content at all).

I will redo the patch without formatting, commit it and then reformat as a
add-on patch. I totally agree with you, I was just being lazy (it's just
too easy to hit F5 to reformat a paragraph with my emacs setup ;-).

:)
:) Apart from this: thanks for the fixes.  English is not my native
:) language, so i'm glad i could get away with only that few grammar
:) changes at all. ;-)

Your english is great. If I ever make it to Germany, we can have some beer
and laugh at my german. ;-)

Ted Roth