Delta Tao's "What's New" for v533:

2/13/2008 v533
Get around people who have something of value to share with you. Their impact will continue to have a significant effect on your life long they have departed. - Jim Rohn, "motivational speaker"

* No crashes in 680 days and counting.
* New (experimental) macro features in the Mac client: @my.shares_in and @my.shares_out, holding your incoming and outgoing sharers' names. You can count how many incoming shares you have like so:
set sharers @my.shares_in
set num_shares sharers.num_words
and extract them individually using sharers[1], sharers[2], etc.

Warning, this feature is preliminary. Use it at your own risk -- but if you do find any problems, please report them! Once we get the bugs ironed out, if it turns out to be widely useful, it'll be added to the Windows client as well.
* You'll have to explore to discover this Chaos Storm's changes. Enjoy!

OMG! They added my suggestion! So fast! Thanks guy and gal GMs! (:

looks like a syntax error in the description to extract individual names you must use sharers.word[1] not just sharers[1].

REFERENCE (this works):
set myStone "SunGem"
"/sgs"
{
"/useitem sungem /clear \r"
set shares @my.shares_out
message shares
set slot 1
set num_shares @my.shares_out.num_words

label addloop
if slot <= num_shares
"/useitem Sungem /add " shares.word[slot] "\r"
pause 1
set slot + 1
pause 1
goto addloop
end if
"/useitem " myStone "/who \r"
label end
}

I don't really understand the function of this? How is it more useful than just typing "/share" and reading the sidebar?

It's for macro enthusiasts, for share-macros.

Normal /share + @env.textlog doesn't catch all the people you are sharing with, I believe, so it's nice to have this built in.

Alls we need now is a macro hook to tell us if we're being healed and we can overhaul sharecads!

(Thanks MacroGM!)