[RFA] Add stabs entries for coalesced symbols.

[Jim Blandy]

I like these docs a lot better, thanks.

Klee Dienes <klee@apple.com> writes:
> (speaking of
> which, I should mention that these docs are extensively plagiarized
> from docs written by another engineer at Apple; I'm just adapting them
> as best I can from the release notes for use in the stabs document)

Does that engineer have an assignment on file?  Or does Apple have a
blanket assignment in place?

> +The static link editor divides up a coalesced section on the
> +boundaries of the symbols in that section, associating the bytes of
> +the section after each symbol with the preceding symbol.  An object
> +file is considered malformed if a coalesced section does not have a
> +symbol at the first address of the section.
> +
> +To allow the linker to properly manage the debug information for
> +coalesced symbols, the stabs entries for a given coalesced symbol must
> +be preceded by @code{N_BNSYM} and terminated with @code{N_ENSYM}.
> +These stabs must be at the start and end of the given coalesced
> +symbol, respectively.

That is:

    the value of the N_BNYSM stab should be the start address of the
    coalesced portion (the same value as the symbol that begins the
    portion), and the value of the N_ENSYM stab should be the end address
    of the coalesced prtion (the same value as the next coalesced symbol,
    or the end of the whole coalesced section).

If that's right, then please include that language, or something
equally explicit; I'm happy to see this committed.