Re: [boost] [conversion] implicit_cast undocumented

From: Andy Little (andy_at_[hidden])
Date: 2006-01-26 21:18:18

"David Abrahams"  wrote

> In future send your attachment as a patch and it will come through OK.

I am have attached 3 items including the patch  (because My last attach test 
went OK, but
unfortunately I have to keep changing settings for something else. I hope I got
it right now.( Think its got to be UUencode FWIW) If not I'll try again).

implicit_cast.qbk  and Jamfile to go in new directory
<libs/conversion/implicit_cast/>
patch is for <libs/conversion/index.html>

The jamfile BTW is just based on the Boost.Typeof  doc jamfile by Peder Holt. I
dont know too much about it, but it seems to work ok.

> So, thanks, but it's not really sufficient.  Linking to the header is
> really unacceptable, IMO.  It should link to an HTML file with a
> specification of the signature of implicit cast, its requirements,
> effects, etc., and preferably, an example.

There is a reasonable skeleton there I hope. Obviously you are better placed to
rewrite the text...

> P.S. I can see that I already wrote a test for implicit_cast, so
>     consider yourself lucky that I'm not asking you for one of those
>     ;-)

I'll be interested as I need some expected to fail tests, and I presume there
should be some there.

> P.P.S. I'm actually very grateful that you've done anything; I'm just
>       trying to scam you into finishing the job and doing it right
>       ;-)

Its ten past 2 in the morning here in the U.K, but I'm not saying that to make
feel guilty in any way  ;-)

hmm... hope the attachments dont get mangled... If they do I'll send them 
embedded in the message.

regards
Andy Little

begin 666 libs_conversion_index_html.patch
M26YD97_at_Z(&)O;W-T+VQI8G,O8V]N=F5R<VEO;B]I;F1E>"YH=&UL#0H]/3T]
M/3T]/3T]/3T]/3T]/3T]/3T]/3T]/3T]/3T]/3T]/3T]/3T]/3T]/3T]/3T]
M/3T]/3T]/3T]/3T]/3T]/3T]#0I20U,@9FEL93H@+V-V<W)O;W0O8F]O<W0O
M8F]O<W0O;&EB<R]C;VYV97)S:6]N+VEN9&5X+FAT;6PL=@T*<F5T<FEE=FEN
M9R!R979I<VEO;B Q+C0-"F1I9F8@+74@+7 @+7(Q+C0@:6YD97_at_N:'1M; T*
M+2TM(&)O;W-T+VQI8G,O8V]N=F5R<VEO;B]I;F1E>"YH=&UL"3(T($IU;B R
M,# U(#$T.C(T.C R("TP,# P"3$N- T**RLK(&)O;W-T+VQI8G,O8V]N=F5R
M<VEO;B]I;F1E>"YH=&UL"3(W($IA;B R,# V(# Q.C0Y.C R("TP,# P#0I 
M0" M,C L,3<@*S(P+#(S($! (%-T86YD87)D)W,@8G5I;'0M:6X_at_8V%S=',N
M/"]P/@T*($-O;G9E<G-I;VX_at_3&EB<F%R>2!I<PT*('-U<'!L:65D(&)Y('-E
M=F5R86P@:&5A9&5R<SH\+W ^#0H@/'5L/@T*+2 @/&QI/E1H92 \82!H<F5F
M/2)C87-T+FAT;2(^8F]O<W0O8V%S=#PO83X@:&5A9&5R('!R;W9I9&5S(#QB
M/G!O;'EM;W)P:&EC7V-A<W0F;'0[)F=T.SPO8CX-"BT@(" @86YD(#QB/G!O
M;'EM;W)P:&EC7V1O=VYC87-T)FQT.R9G=#L\+V(^('1O('!E<F9O<FT@<V%F
M92!C87-T:6YG(&)E='=E96X-"BL@( T**SQL:3Y4:&4@/&$@:')E9CTB8V%S
M="YH=&TB/F)O;W-T+V-A<W0\+V$^(&AE861E<B!P<F]V:61E<R \8CYP;VQY
M;6]R<&AI8U]C87-T)FQT.R9G=#L\+V(^#0HK("!A;F0@/&(^<&]L>6UO<G!H
M:6-?9&]W;F-A<W0F;'0[)F=T.SPO8CX@=&\@<&5R9F]R;2!S869E(&-A<W1I
M;F<@8F5T=V5E;@T*(" @<&]L>6UO<G!H:6,@='EP97,N/&)R/@T*+2 @/"]L
M:3X-"BT@(#QL:3Y4:&4@/&$@:')E9CTB;&5X:6-A;%]C87-T+FAT;2(^8F]O
M<W0O;&5X:6-A;%]C87-T/"]A/B!H96%D97(@<')O=FED97,@/&(^;&5X:6-A
M;%]C87-T)FQT.R9G=#L\+V(^#0HK(" -"BL\+VQI/@T**R @#0HK/&QI/E1H
M92 \82!H<F5F/2)L97AI8V%L7V-A<W0N:'1M(CYB;V]S="]L97AI8V%L7V-A
M<W0\+V$^(&AE861E<B!P<F]V:61E<R \8CYL97AI8V%L7V-A<W0F;'0[)F=T
M.SPO8CX-"B @(" @9V5N97)A;"!L:71E<F%L('1E>'0_at_8V]N=F5R<VEO;G,L
M('-U8V@@87,@86X@/&-O9&4^:6YT/"]C;V1E/B!R97!R97-E;G1E9"!A<PT*
M(" @("!A(#QC;V1E/G-T<FEN9SPO8V]D93XL(&]R('9I8V4M=F5R<V$N/"]L
M:3X-"BL-"BL\;&D^5&AE(#QA(&AR968](FEM<&QI8VET7V-A<W0O:'1M;"]I
M;F1E>"YH=&UL(CYB;V]S="]I;7!L:6-I=%]C87-T/"]A/B!H96%D97(@<')O
M=FED97,@/&(^:6UP;&EC:71?8V%S="9L=#LF9W0[/"]B/B!W:&EC:"!I<R!U
M<V5D('=H96X@=&AE('-O=7)C92!T>7!E(&ES(&EM<&QI8VET;'D_at_8V]N=F5R
M=&EB;&4@=&\@=&AE('1A<F=E="!T>7!E+"!T;R!F;W)C92!T:&4@:6UP;&EC
M:70_at_8V]N=F5R<VEO;BX_at_270G<R!L97-S(&QI8F5R86P@=&AA;B!S=&%T:6-?
M8V%S="P@=VAI8V@@=VEL;"!C;VYV97)T(&EN('1H92!O<'!O<VET92!D:7)E
M8W1I;VXN+CQB<CX-"BL@#0H@/"]U;#X-"B \:'(^#0H@/' ^4F5V:7-E9" \
M(2TM=V5B8F]T(&)O=#TB5&EM97-T86UP(B!3+51Y<&4](D5$251%1"(-"BU3
M+49O<FUA=#TB)60@)4(L("59(B!S=&%R='-P86X@+2T^2G5N92 R,RP@,C P
M-3PA+2UW96)B;W0_at_8F]T/2)4:6UE<W1A;7 B(&5N9'-P86X@:2UC:&5C:W-U
M;3TB,S S-#@B("TM/@T**U,M1F]R;6%T/2(E9" E0BP@)5DB('-T87)T<W!A
M;B M+3Y*86X@,C4L(#(P,#8\(2TM=V5B8F]T(&)O=#TB5&EM97-T86UP(B!E
M;F1S<&%N(&DM8VAE8VMS=6T](C,P,S0X(B M+3X-"B \+W ^#0H@#0H@/"]B
&;V1Y/@T*
`
end

begin 666 implicit_cast.qbk
M6W!A<G0@:6UP;&EC:71?8V%S= T*(" @(%MV97)S:6]N(#%=#0H@(" @6V-O
M<'ER:6=H=" R,# U+3(P,#8_at_70T*(" @(%MI9"!I;7!L:6-I=%]C87-T70T*
M(" @(%MC871E9V]R>2!I;7!L:6-I=%]C87-T70T*(" @(%MA=71H;W)S("!;
M06)R86AA;7,L1&%V:61=70T*(" @("!;;&EC96YS90T*(" @(" @("!$:7-T
M<FEB=71E9"!U;F1E<B!T:&4_at_0F]O<W0_at_4V]F='=A<F4_at_3&EC96YS92P_at_5F5R
M<VEO;B Q+C N#0H@(" @(" @("A3964_at_86-C;VUP86YY:6YG(&9I;&4_at_3$E#
M14Y315\Q7S N='AT(&]R(&-O<'D_at_870-"B @(" @(" @/'5L:6YK('5R;#TB
M:'1T<#HO+W=W=RYB;V]S="YO<F<O3$E#14Y315\Q7S N='AT(CX-"B @(" @
M(" @(" @(&AT=' Z+R]W=W<N8F]O<W0N;W)G+TQ)0T5.4T5?,5\P+G1X= T*
M(" @(" @(" \+W5L:6YK/BD-"B @("!=#0I=#0H-"EMS96-T:6]N.FEN9&5X
M($)O;W-T+DEM<&QI8VET7V-A<W1=#0H-"BH_at_6VQI;FL@<WEN;W!S:7,@4WEN
M;W!S:7-=#0HJ(%ML:6YK('-U;6UA<GD_at_4W5M;6%R>5T-"BH_at_6VQI;FL_at_97AA
M;7!L92!%>&%M<&QE70T*#0I;(W-Y;F]P<VES70T*#0I;:#,@4WEN;W!S:7-=
M#0H)#0IH96%D97(@6T N+B\N+B\N+B\N+B]B;V]S="]I;7!L:6-I=%]C87-T
M+FAP<" B8F]O<W0O:6UP;&EC:71?8V%S="YH<' B70T*#0H)=&5M<&QA=&4@
M/'1Y<&5N86UE(%0^(%0@:6UP;&EC:71?8V%S="@@5#$@>"D[#0H-"B @(%)E
M<75I<F5S.B!4,2!I<R!I;7!L:6-I=&QY(&-O;G9E<G1I8FQE('1O(%0N#0H@
M("!2971U<FYS.B!!;B!O8FIE8W0@;V8@='EP92!4('=H;W-E('9A;'5E(&ES
M('1H92!R97-U;'0@;V8@:6UP;&EC:70_at_8V]N=F5R<VEO;B!O9B!X(&9R;VT@
M='EP92!4,2!T;R!4+@T*#0I;(W-U;6UA<GE=#0H-"EMH,R!I;7!L:6-I=%]C
M87-T70T*:6UP;&EC:71?8V%S="!I<R!U<V5D('=H96X@=&AE('-O=7)C92!T
M>7!E(&ES(&EM<&QI8VET;'D-"F-O;G9E<G1I8FQE('1O('1H92!T87)G970@
M='EP92P@=&\@9F]R8V4@=&AE(&EM<&QI8VET(&-O;G9E<G-I;VXN#0I)="=S
M(&QE<W,@;&EB97)A;"!T:&%N('-T871I8U]C87-T+"!W:&EC:"!W:6QL(&-O
M;G9E<G0@:6X@=&AE(&]P<&]S:71E(&1I<F5C=&EO;BX@#0H-"ELC97AA;7!L
M95T-"@T*6V_at_S($5X86UP;&5=#0I!<R!A;B!E>&%M<&QE(&%P<&QI8V%T:6]N
M(&QE=',@=&%K92!I;FET:6%L:7-A=&EO;B!O9B!A('5S97(@9&5F:6YE9"!T
M>7!E("A51%0I('=H97)E($ET<R!U<W5A;"!T;R!R97%U:7)E(&5X<&QI8VET
M(&EN:71I86QI<V%T:6]N("AO<B!V86QU92!I;FET:6%L:7-A=&EO;BD_at_8GD@
M;6%K:6YG('1H92!C;VYS=')U8W1O<B!E>'!L:6-I="!T;R!P<F5V96YT(&EM
M<&QI8VET(&EN:71I86QI<V%T:6]N+B!);B!U9'1!('1H92!E>'!L:6-I="!C
M;VYS=')U8W1O<B!M96%N<R!T:&%T('5D=$$@8V%N(&)E(&EN:71I86QI<V5D
M('=I=&@@='EP97,@5"P_at_8G5T(&]N;'D@=7-I;F<@=&AE(&5X<&QI8VET(&]R
M('9A;'5E(&EN:71I86QI<V%T:6]N('-Y;G1A>"X-"B @#0H@(" @(VEN8VQU
M9&4@/&)O;W-T+VEM<&QI8VET7V-A<W0N:'!P/@T*#0H@(" @=&5M<&QA=&4@
M/'1Y<&5N86UE(%0^#0H@(" @<W1R=6-T('5D=$%[#0H@(" @(" @('1Y<&5D
M968_at_5"!V86QU95]T>7!E.PT*(" @(" @("!4('9A;#L-"B @(" @(" @=&5M
M<&QA=&4@/'1Y<&5N86UE(%0Q/@T*(" @(" @("!E>'!L:6-I="!U9'1!*"!4
M,2!C;VYS=" F('0I(#H@=F%L*'0I>WT-"B @("!].PT*#0I4:&4@<')O8FQE
M;2!I<R!T:&%T('5D=$$@8V%N(&)E('9A;'5E(&EN:71I86QI<V5D(&)Y(&%N
M('5N97AP96-T961L>2!W:61E(')A;F=E(&]F('1Y<&5S(&%S('-H;W=N(&EN
M('1H92!F:7)S="!E>&%M<&QE(&)E;&]W+B!4:&4@:6YI=&EA;&ES871I;VX@
M;V8_at_82!U9'1!/&1O=6)L93X@;V)J96-T(&ES('-A9F4_at_8F5C875S92!I="!C
M86X@;VYL>2!B92!V86QU92!I;FET:6%L:7-E9"!B>2!I;F)U:6QT('1Y<&5S
M+B!4:&4@;F5S=&5D('5D=$$\=61T03QD;W5B;&4^(#X_at_86QL;W=S(&EN:71I
M86QI<V%T:6]N(&)Y(&ET<R!V86QU95]T>7!E+"!A('5D=$$\9&]U8FQE/BP@
M87,@<VAO=VX@:6X@=&AE(&EN:71I86QI<V%T:6]N(&]F('9!,2P_at_8G5T(&ET
M(&%L<V\@86QL;W=S(&EN:71I86QI<V%T:6]N(&)Y(&%N(&EN="!A<R!S:&]W
M;B!I;B!V03(N(%1H:7,@;6%Y(&)E+"!B=70@:7,@<')O8F%B;'D@;F]T+"!W
M:&%T('1H92!A=71H;W(@;V8@=61T02!I;G1E;F1E9"X-"@T*(" @('5D=$$\
M9&]U8FQE/B!V03 H,2D[#0H@(" @=61T03QU9'1!/&1O=6)L93X@/G9!,2AV
M03 I.PT*(" @('5D=$$\=61T03QD;W5B;&4^(#YV03(H,2D[#0H-"E1H:7,@
M<')O8FQE;2!C86X_at_8F4@<')E=F5N=&5D(&)Y(&%D9&EN9R!@8F]O<W0Z.FEM
M<&QI8VET7V-A<W1@(&EN('1H92!I;FET:6%L:7-E<B!F;W(@=F%L(&%S('-H
M;W=N(&EN('5D=$(N#0H-"G1E;7!L871E(#QT>7!E;F%M92!4/@T*<W1R=6-T
M('5D=$)[#0H@(" @='EP961E9B!4('9A;'5E7W1Y<&4[#0H@(" @5"!V86P[
M#0H@(" @=&5M<&QA=&4@/'1Y<&5N86UE(%0Q/@T*(" @(&5X<&QI8VET('5D
M=$(H(%0Q(&-O;G-T("8@="D_at_.B!V86PH8F]O<W0Z.FEM<&QI8VET7V-A<W0\
M5#XH="DI>WT-"GT[#0H-"D%T=&5M<'1I;F<@=&\@:6YI=&EA;&ES92!A('5D
M=$(@8GD_at_82!T>7!E(&YO="!I;7!L:6-I=&QY(&-O;G9E<G1I8FQE('1O(&ET
M<R!V86QU95]T>7!E('=I;&P_at_8F4@<')E=F5N=&5D+B!4:&4_at_871T96UP=&5D
M(&EN:71I86QI<V%T:6]N(&]F('9",B!B>2!A;B!I;G0@=VEL;"!N;W<@8V%U
M<V4_at_82!C;VUP:6QE('1I;64_at_97)R;W(N#0H-"B @("!U9'1"/&1O=6)L93X@
M=D(P*#$I.PT*(" @('5D=$(\=61T0CQD;W5B;&4^(#YV0C$H=D(P*3L-"B @
M("!U9'1"/'5D=$(\9&]U8FQE/B ^=D(R*#$I.R O+R!%<G)O<B$-"@T*#0I;
*96YD<V5C=%T-"@``
`
end

begin 666 Jamfile.v2
M(V)A<VEC86QL>2!C;W!I960_at_9G)O;2!4>7!E;V8_at_2F%M9FEL92XN#0H-"B,@
M0V]P>7)I9VAT(%!E9&5R($AO;'0@,C P-2X_at_57-E+"!M;V1I9FEC871I;VXL
M(&%N9"!D:7-T<FEB=71I;VX_at_87)E#0HC('-U8FIE8W0@=&\@=&AE($)O;W-T
M(%-O9G1W87)E($QI8V5N<V4L(%9E<G-I;VX@,2XP+B H4V5E(&%C8V]M<&%N
M>6EN9PT*(R!F:6QE($Q)0T5.4T5?,5\P+G1X="!O<B!C;W!Y(&%T(&AT=' Z
M+R]W=W<N8F]O<W0N;W)G+TQ)0T5.4T5?,5\P+G1X="D-"@T*=7-I;F<@<75I
M8VMB;V]K(#L-"@T*>&UL(&EM<&QI8VET7V-A<W0_at_.B!I;7!L:6-I=%]C87-T
M+G%B:R [#0IB;V]S=&)O;VL@<W1A;F1A;&]N90T*(" @(#H-"B @(" @(" @
M:6UP;&EC:71?8V%S= T*(" @(#H-"B @(" @(" @/'AS;#IP87)A;3YN878N
M;&%Y;W5T/6YO;F4-"B @(" @(" @/'AS;#IP87)A;3YN879I9RYG<F%P:&EC
M<STP#0H@(" @.PT*#0II;G-T86QL(&AT;6P_at_.B N+B\N+B\N+B]D;V,O:'1M
M;"]B;V]S=&)O;VLN8W-S(#L-"FEN<W1A;&P@+BXO(#H@+BXO+BXO+BXO8F]O
,<W0N<&YG(#L-"@T*
`
end