[FIX] Comments for Set, IdentitySet, IdentityDictionary, WeakValueAssociation

Richard A. O'Keefe ok at cs.otago.ac.nz
Mon Apr 22 00:48:16 UTC 2002


This change set includes new class comments for
Set, IdentitySet, IdentityDictionary, and WeakValueAssociation,
revised class comments for
ArrayedCollection and Dictionary,
and a revised method comment for Dictionary>>copy.

The most I will claim for these comments is that to the best of
my belief they are true and helpful, and in some way each of them
is an improvement on what was there before.

begin 644 Comments-raok.1.cs
M)T9R;VT at 4W%U96%K,RXP(&]F(#0 at 1F5B<G5A<GD@,C`P,2!;;&%T97-T('5P
M9&%T93H@(S,U-3)=(&]N(#(R($%P<FEL(#(P,#(@870@,3(Z-#<Z-#$@<&TG
M(0T-(4%R<F%Y961#;VQL96-T:6]N(&-O;6UE;G13=&%M<#H@)W)A;VL at -"\R
M,B\R,#`R(#$R.C`S)R!P<FEO<CH@,"$-22!A;2!A;B!A8G-T<F%C="!C;VQL
M96-T:6]N(&]F(&5L96UE;G1S('=I=&@@82!F:7AE9"!R86YG92!O9B!I;G1E
M9V5R<R`H9G)O;2`Q('1O(&X^/3`I(&%S(&5X=&5R;F%L(&ME>7,N(0T-#2%3
M970 at 8V]M;65N=%-T86UP.B`G<F%O:R`T+S(R+S(P,#(@,3(Z,C<G('!R:6]R
M.B`P(0U)(')E<')E<V5N="!A('-E="!O9B!O8FIE8W1S('=I=&AO=70 at 9'5P
M;&EC871E<RX@($D at 8V%N(&AO;&0 at 86YY=&AI;F<@=&AA="!R97-P;VYD<R!T
M;PTC:&%S:"!A;F0@(STL(&5X8V5P="!F;W(@;FEL+B`@37D@:6YS=&%N8V5S
M('=I;&P at 875T;VUA=&EC86QL>2!G<F]W+"!I9B!N96-E<W-A<GDL#4YO=&4@
M=&AA="!)(')E;'D@;VX@(STL(&YO="`C/3TN("!)9B!Y;W4@=V%N="!A('-E
M="!U<VEN9R`C/3TL('5S92!)9&5N=&ET>5-E="X-#4EN<W1A;F-E('-T<G5C
M='5R93H-#2`@87)R87D)06X at 87)R87D@=VAO<V4@;F]N+6YI;"!E;&5M96YT
M<R!A<F4@=&AE(&5L96UE;G1S(&]F('1H92!S970L#0D)86YD('=H;W-E(&YI
M;"!E;&5M96YT<R!A<F4 at 96UP='D@<VQO=',N("!4:&5R92!I<R!A;'=A>7,@
M870@;&5A<W0@;VYE(&YI;"X-"0E);B!F86-T($D@=')Y('1O(&ME97`@;7D@
M(FQO860B(&%T(#<U)2!O<B!L97-S('-O('1H870@:&%S:&EN9R!W:6QL('=O
M<FL@=V5L;"X-#2`@=&%L;'D)5&AE(&YU;6)E<B!O9B!E;&5M96YT<R!I;B!T
M:&4@<V5T+B`@5&AE(&%R<F%Y('-I>F4@:7, at 86QW87ES(&=R96%T97(@=&AA
M;B!T:&ES+ at T-5&AE(&-O<F4@;W!E<F%T:6]N(&ES("-F:6YD16QE;65N=$]R
M3FEL.BP@=VAI8V@@96ET:&5R(&9I;F1S('1H92!P;W-I=&EO;B!W:&5R92!A
M;@UO8FIE8W0@:7,@<W1O<F5D(&EN(&%R<F%Y+"!I9B!I="!I<R!P<F5S96YT
M+"!O<B!F:6YD<R!A('-U:71A8FQE('!O<VET:6]N(&AO;&1I;F<@;FEL+"!I
M9 at UI=', at 87)G=6UE;G0@:7,@;F]T('!R97-E;G0@:6X at 87)R87DL(0T-#2%$
M:6-T:6]N87)Y(&-O;6UE;G13=&%M<#H@)W)A;VL at -"\R,B\R,#`R(#$R.C$T
M)R!P<FEO<CH@,"$-22!R97!R97-E;G0 at 82!S970@;V8 at 96QE;65N=',@=&AA
M="!C86X at 8F4@=FEE=V5D(&9R;VT@;VYE(&]F('1W;R!P97)S<&5C=&EV97,Z
M(&$@<V5T(&]F(&%S<V]C:6%T:6]N<RP@;W(@82!C;VYT86EN97(@;V8@=F%L
M=65S('1H870 at 87)E(&5X=&5R;F%L;'D@;F%M960@=VAE<F4@=&AE(&YA;64@
M8V%N(&)E(&%N>2!O8FIE8W0@=&AA="!R97-P;VYD<R!T;R`]+B!4:&4 at 97AT
M97)N86P@;F%M92!I<R!R969E<G)E9"!T;R!A<R!T:&4@:V5Y+B`@22!I;FAE
M<FET(&UA;GD@;W!E<F%T:6]N<R!F<F]M(%-E="XA#0T-(4ED96YT:71Y1&EC
M=&EO;F%R>2!C;VUM96YT4W1A;7`Z("=R86]K(#0O,C(O,C`P,B`Q,CHS,"<@
M<')I;W(Z(#`A#4D@<F5P<F5S96YT(&$@<V5T(&]F(&%S<V]C:6%T:6]N<R!A
M;&P@;V8@=VAO<V4@(VME>2!P87)T<R!A<F4 at 9&ES=&EN8W0 at 86-C;W)D:6YG
M('1O#2,]/2`H:61E;G1I='D@=&5S="DN("!#;VYS:61E<F5D(&%N;W1H97(@
M=V%Y+"!)(')E<')E<V5N="!A(&-O;&QE8W1I;VX@;V8@=F%L=65S#6%C8V5S
M<V5D(&)Y(&5X=&5R;F%L(&YA;65S+"!T=V\@97AT97)N86P@;F%M97, at 8F5I
M;F<@8V]N<VED97)E9"!T:&4@<V%M92!I9B!A;F0-;VYL>2!I9B!T:&5Y(&%R
M92`C/3TN#0U!<&%R="!F<F]M('1H870L($DG;2!P<F5T='D@;75C:"!T:&4@
M<V%M92!A<R!$:6-T:6]N87)Y+B$-#0TA261E;G1I='E3970 at 8V]M;65N=%-T
M86UP.B`G<F%O:R`T+S(R+S(P,#(@,3(Z,S at G('!R:6]R.B`P(0U)(')E<')E
M<V5N="!A('-E="!O9B!O8FIE8W1S+"!W:&5R92!T=V\@;V)J96-T<R!A<F4@
M<F5G87)D960 at 87,@=&AE('-A;64@:68 at 86YD(&]N;'D-:68@=&AE(&%R92`C
M/3T@*&ED96YT:6-A;"DN("!)(&-A;B!H;VQD(&%N>2!O8FIE8W1S('1H870@
M<F5S<&]N9"!M96%N:6YG9G5L;'D@=&\-(VAA<V@@86YD(",]/2X-#45X8V5P
M="!F;W(@=7-I;F<@(ST](&EN<W1E860@;V8@(STL($DG;2!P<F5T='D@;75C
M:"!T:&4@<V%M92!A<R!3970N#0U)9B!Y;W4 at 8V]M8FEN92!P;&%I;B!3971S
M(&%N9"!)9&5N=&ET>5-E=',@=7-I;F<@(W5N:6]N.BP@(VEN=&5R<V5C=&EO
M;BP-;W(@(V1I9F9E<F5N8V4Z+"!S;VUE=&EM97,@:70@=VEL;"!W;W)K+"!A
M;F0@<V]M971I;65S(&ET('=I;&P at 8F4@=F5R>2!Q=65E<BX-1F]R(&5X86UP
M;&4L("AS,2!I;G1E<G-E8W1I;VXZ(',R*2!M87D at 97%U86P@<S$@979E;B!T
M:&]S92`H<S$@:6YC;'5D97,Z('@I(&ES#69A;'-E(&9O<B!E=F5R>2!E;&5M
M96YT(&]F(',R+B`@*$)E8V%U<V4@=&AE(&QA='1E<B!A<VMS(',Q(&EF('1H
M92!E;&5M96YT(&ES#71H97)E+"!U<VEN9R`]/2P at 8G5T('1H92!F;W)M97(@
M87-K<R!S,B!I9B!T:&4 at 96QE;65N="!I<R!T:&5R92P@=7-I;F<@/2XI#5-O
M(&5V96X@:68@>6]U('1H:6YK('EO=2!K;F]W('=H870@>6]U(&%R92!D;VEN
M9RP@=7-E(&%S261E;G1I='E3970@;W(-87-3970@=&\@8G)I;F<@=&AE('-E
M=',@=&\@82!C;VUM;VX at 9F]R;2!B969O<F4 at 8V]M8FEN:6YG('1H96TN(0T-
M#2%796%K5F%L=65!<W-O8VEA=&EO;B!C;VUM96YT4W1A;7`Z("=R86]K(#0O
M,C(O,C`P,B`Q,CHT-B<@<')I;W(Z(#`A#4D at 86T@82!L;V]K=7`@:V5Y("AA
M8W1I;F<@;&EK92!A;B!A<W-O8VEA=&EO;B!B=70I(&AO;&1I;F<@;VYL>2!W
M96%K;'D@;VX@;7D@=F%L=64N(0T-#2%$:6-T:6]N87)Y(&UE=&AO9'-&;W(Z
M("=P<FEV871E)R!S=&%M<#H@)W)A;VL at -"\R,B\R,#`R(#$R.C`Y)R$-8V]P
M>0T)(DUU<W0 at 8V]P>2!T:&4 at 87-S;V-I871I;VYS+"!O<B!L871E<B!S=&]R
M92!W:6QL(&%F9F5C="!B;W1H('1H90UO<FEG:6YA;"!A;F0@=&AE(&-O<'DB
M#0T)7B!S96QF('-H86QL;W=#;W!Y('=I=&A!<G)A>3H-"0DH87)R87D at 8V]L
M;&5C=#H at 6SIA<W-O8R!\#0D)"6%S<V]C(&EF3FEL.B!;;FEL70T)"0D):69.
M;W1.:6PZ(%M!<W-O8VEA=&EO;B!K97DZ(&%S<V]C(&ME>0UV86QU93H at 87-S
0;V,@=F%L=65=72DA("$-#6EO
`
end



More information about the Squeak-dev mailing list