still confusion with the %doc directive in a spec file

[rpjday <rpjday mindspring com>]

  i've been fighting with the %doc directive in a sample spec file,
and i'm finally convinced that either i'm clueless or it doesn't do
what it's supposed to.

  first, even though i've defined:

  BuildRoot: %{_tmppath}/${name}-root

if i try to use a shortcut in the %files section of

  %doc README ChangeLog (etc etc)

the build looks for these doc files, and finds them, in ~/rpm/BUILD.  
*not* in an RPM-specific subdirectory for this particular RPM that i'm 
building, but in the shared BUILD directory.  this makes no sense.  can 
someone explain this?  it would have made far more sense if this %doc 
shortcut looked in, say, the RPM-specific build root directory.
comments?

  and second, when i specifically tag files as documentation files like
this, they do indeed show up when i query the new RPM with "rpm -qpd", but
they will *still* be installed even when i use the "--excludedocs"
directive at install time.  have i forgotten something?  thanks muchly.

rday