GNU ld docs -- incorrect EXCLUDE_FILE example?

[Oleg Katsitadze]

Hi,

I've found an example of using EXCLUDE_FILE in linker scripts in the
GNU ld documentation:

  (*(EXCLUDE_FILE (*crtend.o *otherfile.o) .ctors))

I've tried this, and several variations thereof, to no avail -- I
always get "parse error".  I put it in place of a usual `*(.data)',
which until then was accepted by ld without any errors, so my script
should be ok.

The weird thing is that there is no other mention of this function in
the docs (not even in the "Builtin Functions" section), and googling
doesn't give anything useful.  The latest mention in the ChangeLog
seems to be on 2000-02-28.  Has this function been obsoleted?  If not,
I'll try to provide a minimal failing example.

I have:

  $ ld -v
  GNU ld (GNU Binutils for Debian) 2.17.90.20070812

Please CC me, I'm not on the list.

Thanks for any hint,
Oleg