www.digitalmars.com         C & C++   DMDScript  

D - (Ann): Dependency walker for D source files

reply "Lars Ivar Igesund" <larsivi stud.ntnu.no> writes:
Hi!

I've made a dependency walker for D source files. Given an input
file, it searches through it and the imported modules to find all
d files that the input file depend on. (Source is attached, compile
with "dmd depsrc.d", only deps are to platform independent parts
of phobos. Therefore it should work on both win32 and linux, but
only win32 has been tested.)

If an imported module imports other modules privately, these aren't
searched.
If the imported module is part of phobos, it is ignored.
The output consists of the base file that is checked, all the modules
it depends on, a path where this module is found and the depths
where the modules are found. (If a module is imported from a
module that is imported from the base file, the module is said to be
found on depth 2.)

By default, the found dependencies are printed to the console. Use
-w/--writetofile to have them written to the file "depfile". (This don't
work due to recently reported phobos bug.).
There are no known bugs :)
The source code is free in all ways (except that it is copyrighted.)

The dependencies should be easy to automatically process. Given
the command

depsrc -Isomepath foo.d bar.d, the output will be something like:



foo.d

moduledep1 pathtomoduledep1 1,2
moduledep2 pathtomoduledep2 3

bar.d

moduledep3 pathtomoduledep3 1
...
...

What's the use for this program? It might be a nice diagnostic if
you don't have control over which modules have have been imported
from where. Also it can be used by build systems to find the
dependencies such that it knows when to recompile/relink.
If anyone wants to include it in their packages, feel free (dmd, dide, leds,
etc.)

It would be nice if someone would like to test it on linux.
Suggestions, fixes, etc are welcome.

Lars Ivar Igesund


begin 666 depsrc.d



M<VEO;B!T;R!U<V4L(&-O<'DL(&UO9&EF>2P 9&ES=')I8G5T92!A;F0 <V5L

M(&%N>2!P=7)P;W-E(&ES(&AE<F5B>2!G<F%N=&5D('=I=&AO=70 9F5E+ T*
M("H <')O=FED960 =&AA="!T:&4 86)O=F4 8V]P>7)I9VAT(&YO=&EC92!A
M<'!E87( :6X 86QL(&-O<&EE<R!A;F0-"B J('1H870 8F]T:"!T:&%T(&-O
M<'ER:6=H="!N;W1I8V4 86YD('1H:7, <&5R;6ES<VEO;B!N;W1I8V4 87!P

M;W9I9&5D(")A<R!I<R( =VET:&]U="!E>'!R97-S( T*("H ;W( :6UP;&EE


M=&1I;SL-" T*8F]O;"!H96QP8V%L;&5D(#T
M;VYC86QL960 /2!F86QS93L-"F)O;VP =W)I=&4 /2!F86QS93L-"FEN="!C
M=7)O<'0 /2 Q.PT*:6YT(&YU;7!A=&AS(#T ,#L-"FEN="!A;&QP871H<R ]



M9&5P=&AS.PT*8VAA<B!;75M=('!A=&AS.PT*8VAA<B!;75M=(&%R9W-L:7-T

M<G)A>2!W:&5N(&YE8V5S<V%R>0T*8V]N<W0 8VAA<B!;75M=('!H;V)O<R ]
M(%L-"B  (" B8V]M<&EL97(B+ T*("  (")C;VYV(BP-"B  (" B8W1Y<&4B


M(G!A=& B+ T*("  (")P<F]C97-S(BP-"B  (" B<F%N9&]M(BP-"B  (" B
M<F5G97AP(BP-"B  (" B<W1D:6YT(BP-"B  (" B<W1R96%M(BP-"B  (" B
M<W1R:6YG(BP-"B  (" B<WES=&5M(BP-"B  (" B=&AR96%D(BP-"B  (" B
M=7)I(BP-"B  (" B=71F(BP-"B  (" B>FEP(BP-"B  (" B8RYS=&1I;R(L






M("  ("( ("U)6W!A=&A=("  ("  ("  ("  ("  061D(&$ <&%T:"!T;R!B
M92!S96%R8VAE9"Y<;B( ? T*("  ("  ("  (" B(" M:"\M+6AE;'  ("  
M("  ("  ("  (%!R:6YT<R!T:&ES(&AE;'  =&%B;&4N7&XB('X-"B  ("  
M("  ("  (B  +60]6VYU;5TO+2UD97!T:#U;;G5M72!,:6UI="!T:&4 9&5P
M=&  <V5A<F-H960 7&XB('X-"B  ("  ("  ("  (B  ("  ("  ("  ("  
M("  ("  ("  ("  ("  ("  (&9O<B!D97!E;F1E;F-I97,N7&XB('X-"B  
M("  ("  ("  (B  +58O+2UV97)S:6]N("  ("  ("  ("!0<FEN=', =&AE
M('9E<G-I;VXN7&XB('X-"B  ("  ("  ("  (B  +7<O+2UW<FET971O9FEL
M92  ("  ("!0<FEN=', =&AE(&1E<&5N9&5N8VEE<R!T;R!T:&4 9FEL95QN

M9&5P9FEL92< :6YS=&5A9"!O9B!T;R!T:&4 8V]N<V]L92XB*3L-"B  ?0T*
M("!H96QP8V%L;&5D(#T =')U93L-"GT-" T*+RH-"B J($9U;F-T:6]N('1H
M870 8VAE8VMS(&EF(&%N(&%R9W5M96YT(&ES(&%N(&]P=&EO;BX-"B J+PT*

M<VQI<W1;87)G72D >PT*("!C87-E("(M+79E<G-I;VXB. T*("!C87-E("(M


M;W!T2&5L<" I.PT*("  (')E='5R;B!T<G5E.PT*("  (&)R96%K.PT*("!C
M87-E("(M+7=R:71E=&]F:6QE(CH-"B  8V%S92 B+7<B. T*("  (&]P=%=R

M(BTM9&5P=& ](CH-"B  ("!O<'1$97!T:"AA<F<L('1R=64I.PT*("  (')E
M='5R;B!T<G5E.PT*("  (&)R96%K.PT*("!C87-E("(M9#TB. T*("  (&]P
M=$1E<'1H*&%R9RP 9F%L<V4I.PT*("  (')E='5R;B!T<G5E.PT*("  (&)R

M87)G<VQI<W1;87)G75LP+BXR72P (BU)(BD /3T ,"D >PT*("  (&]P=$EM

M86QS93L-"GT-" T*+RH-"B J($9U;F-T:6]N('1H870 <W1A<G1S('1H92!D
M97!E;F1E;F-Y('=A;&MI;F< 9F]R(&)A<V4 <V]U<F-E(&9I;&5S+ T*("HO

M92AA<F=S;&ES=%MA<F==*3L-"B  9&5P5V%L:RAA<F=S;&ES=%MA<F==+" B

M86EN(&1E<&5N9&5N8WD =V%L:VEN9R!R96-U<G-I=F5L>2X 268 :70 9FEN
M9 T*("H 9FEL97, =&AA="!H87, 8F5E;B!W86QK960 8F5F;W)E+"!I="!S
M:VEP<R!I="!T;R!A=F]I9"!I;F9I;FET90T*("H 8WEC;&EC(&1E<&5N9&5N

M(%M=(&UO9"P 8F]O;"!B87-E*0T*>PT*("!C:&%R(%M=(&9I;&5P871H(#T 
M9FEL93L-"B  :6YT(&D /2 P.PT*("!W:&EL92 H:2 \(&YU;7!A=&AS("8F

M+FIO:6XH<&%T:'-;:5TL(&9I;&4I.PT*("  (&DK*SL-"B  ?0T*("!&:6QE
M('-R8R ](&YE=R!&:6QE*&9I;&5P871H*3L-"B  =VAI;&4 *"%S<F,N96]F
M*"DI('L-"B  ("!C:&%R(%M=(&QI;F4 /2!S<F,N<F5A9$QI;F4H*3L-"B  


M("D >PT*("  ("  :6YT('!O<R ](&9I;F0H<W1A=&5M96YT<UMI72P (FEM
M<&]R="(I.PT*("  ("  :68 *'!O<R ]/2 M,2D >PT*("  ("  ("!C;VYT
M:6YU93L-"B  ("  ('T-"B  ("  (&5L<V4 >PT*("  ("  ("!I9B H(6)A
M<V4I('L-"B  ("  ("  ("!I;G0 <')I=G!O<R ](')F:6YD*'-T871E;65N

M,2 F)B!P<FEV<&]S(#P

M("  ("  ("!C:&%R(%M=6UT =V]R9', /2!S<&QI="AI;7!S=&UT*3L-"B  
M("  ("  ("  (&EF("AW;W)D<RYL96YG=&  /3T ,BD >PT*("  ("  ("  

M("  ("  ('T-"B  ("  ("  8VAA<B!;72!M;V0 /2!S=')I<"AS=&%T96UE
M;G1S6VE=6W!O<RLW+BYS=&%T96UE;G1S6VE=+FQE;F=T:%TI.PT*("  ("  
M("!I9B H8VAE8VM.;W1-;V0H;6]D*2D >PT*("  ("  ("  (&-O;G1I;G5E


M("  ("  ('T-"B  ("  ("  9G  /2!C<F5A=&5&:6QE4&%T:"AM;V0I.PT*
M("  ("  ("!D97!T:"LK.PT*("  ("  ("!I9B H9&5P=&AL:6UI=" ]/2 M
M,2!\?"!D97!T:" \/2!D97!T:&QI;6ET*2![(" -"B  ("  ("  ("!D97!7
M86QK*&9P+"!M;V0L(&9A;'-E*3L-"B  ("  ("  ?0T*("  ("  ("!D97!T
M:"TM.PT*("  ("  ?0T*("  ('T-"B  ?0T*("!I9B H(6)A<V4I('L-"B  

M* T*("H 1G5N8W1I;VX 8V%L;&5D(&EF('1H92 B=F5R<VEO;B( ;W!T:6]N


M;&ME<B!F;W( 1"!S;W5R8V4 9FEL97,N7&XB('X-"B  ("  ("  ("  (E9E


M*B!&=6YC=&EO;B!C86QL960 :68 =&AE(")W<FET971O9FEL92( ;W!T:6]N

M(#T =')U93L-"GT-" T*+RH-"B J($9U;F-T:6]N(&-A;&QE9"!I9B!T:&4 
M(F1E<'1H(B!O<'1I;VX :7, =7-E9"!T;R!D96-I9&4 =&AE(&UA>&EM=6T-






M;F-T:6]N(&-A;&QE9"!F;W( 86QL('1H92 B+4DB(&EM<&]R="!O<'1I;VYS

M:68 *&%R9W-L:7-T6V%R9UTN;&5N9W1H(#T


M82!D97!E;F1E;F-Y('1O('1H92!L:7-T('=H96X :70 :7, =F5R:69I960N


M(&9O=6YD(&)E9F]R92P =&AE(&YE=R!D97!T:"!I<R!A9&1E9"!T;R!T:&4-

M:6QE<&%T:"P 8VAA<B!;72!M;V0L(&EN="!D97!T:"D-"GL-"B  9F]R("AI

M*&-M<"AD97!M;V1S6VE=+"!M;V0I(#T

M9&5P=& I.PT*("  ("  <F5T=7)N.PT*("  ('T-"B  ?0T*("!N=6UD97!S


M9FEL97,N;&5N9W1H(#T 86QL9&5P<SL-"B  ("!D97!D97!T:',N;&5N9W1H
M(#T 86QL9&5P<SL-"B  ?0T*("!D97!M;V1S6VYU;61E<',M,5T /2!M;V0[


M*B!&=6YC=&EO;B!T:&%T(&%D9', =&AE(&9I;&5N86UE(&]F('1H92!C=7)R

M"G9O:60 861D3F5W0F%S949I;&4H8VAA<B!;72!F:6QE*0T*>PT*("!N=6UD


M("  9&5P9FEL97,N;&5N9W1H(#T 86QL9&5P<SL-"B  ("!D97!D97!T:',N
M;&5N9W1H(#T 86QL9&5P<SL-"B  ?0T*("!D97!M;V1S6VYU;61E<',M,UT 


M/2!D97!F:6QE<UMN=6UD97!S+3)=(#T 9&5P9FEL97-;;G5M9&5P<RTQ72 ]
M("(B.PT*("!D97!D97!T:'-;;G5M9&5P<RTS72 ](&1E<&1E<'1H<UMN=6UD
M97!S+3)=(#T 9&5P9&5P=&AS6VYU;61E<',M,5T /2 B(CL-"GT-" T*+RH-
M"B J($9U;F-T:6]N('1H870 =&%K97, 82!M;V1U;&4 ;F%M92!A;F0 8W)E
M871E<R!A(')E86P <&%T:"X-"B J+PT*( T*8VAA<B!;72!C<F5A=&5&:6QE
M4&%T:"AC:&%R(%M=(&UO9"D-"GL-"B  8VAA<B!;72!T96UP;6]D93L-"B  
M=&5M<&UO9&4 /2!R97!L86-E*&UO9"P (BXB+"!S97 I.PT*("!T96UP;6]D

M:&5C:W, :68 =&AE(&9O=6YD(&1E<&5N9&5N8WD :7, 82!P87)T(&]F('!H


M(&D /2 P.R!I(#P <&AO8F]S+FQE;F=T:#L
M<"AM;V0L('!H;V)O<UMI72D /3T ,"D >PT*("  ("  <F5T=7)N('1R=64[

M96-K<R!I9B!T:&4 9F]U;F0 ;6]D=6QE(')E86QL>2!C86X 8F4 82!M;V1U

M*B\-" T*8F]O;"!C:&5C:TYO=$UO9"AC:&%R(%M=(&UO9"D-"GL-"B  8VAA

M<G,L(&UO9%LP72D /3T +3$I('L-"B  ("!R971U<FX =')U93L-"B  ?0T*
M("!F;W( *&EN="!I(#T ,3L :2 \(&UO9"YL96YG=& [(&DK*RD >PT*("  
M(&EF("AF:6YD*&EL;&-H87)S+"!M;V1;:5TI(#X +3$I('L-"B  ("  (')E



M>PT*("!N=6UP871H<RLK.PT*("!I9B H;G5M<&%T:', /B!A;&QP871H<RD 



M;VP 9FEL945X:7-T*&-H87( 6UT 9FEL92D-"GL-"B  8F]O;"!R97-U;'0 


M"B  <F5T=7)N(')E<W5L=#L-"GT-" T*:6YT(&UA:6XH8VAA<EM=6UT 87)G
M<RD-"GL-"B  :68 *&%R9W,N;&5N9W1H(#T

M(#T
M;&5N9W1H(#T
M:7-T(#T 87)G<SL-"B  =VAI;&4 *&-U<F]P=" \(&%R9W,N;&5N9W1H("8F
M(&-H96-K3W!T:6]N*&-U<F]P="DI('L-"B  ("!C=7)O<'0K*SL-"B  ?0T*

M(&D /2!C=7)O<'0[(&D /"!A<F=S+FQE;F=T:#L

M($9I;&4 9&5P9FEL92 ](&YE=R!&:6QE*")D97!S(BP 1FEL94UO9&4N3W5T
M*3L-"B  ("!F;W( *&EN="!I(#T ,#L :2 \(&YU;61E<',[(&DK*RD >PT*
M("  ("  <')I;G1F*&1E<&UO9'-;:5T ?B B("( ?B!D97!F:6QE<UMI72!^
M("( (B!^(&1E<&1E<'1H<UMI72!^(")<;B(I.PT*("  ('T-"B  ("!D97!F


M6VE=('X (B B('X 9&5P9FEL97-;:5T ?B B("( ?B!D97!D97!T:'-;:5T 

`
end
Oct 26 2003
parent "Lars Ivar Igesund" <larsivi stud.ntnu.no> writes:
I've now added a switch "-m" or "--make-syntax" that when used
will print out the dependencies in make syntax. It looks like this:


 depsrc -m foo.d


foo.obj : foo.d dep1.d dep2.d dep3.d ...

The object suffix  is .obj on Windows and .o on linux.

One hitch; only one input file is supported when using this switch.

Lars Ivar Igesund

"Lars Ivar Igesund" <larsivi stud.ntnu.no> wrote in message
news:bngc8g$mel$1 digitaldaemon.com...

 Hi!

 I've made a dependency walker for D source files. Given an input
 file, it searches through it and the imported modules to find all
 d files that the input file depend on. (Source is attached, compile
 with "dmd depsrc.d", only deps are to platform independent parts
 of phobos. Therefore it should work on both win32 and linux, but
 only win32 has been tested.)

 If an imported module imports other modules privately, these aren't
 searched.
 If the imported module is part of phobos, it is ignored.
 The output consists of the base file that is checked, all the modules
 it depends on, a path where this module is found and the depths
 where the modules are found. (If a module is imported from a
 module that is imported from the base file, the module is said to be
 found on depth 2.)

 By default, the found dependencies are printed to the console. Use
 -w/--writetofile to have them written to the file "depfile". (This don't
 work due to recently reported phobos bug.).
 There are no known bugs :)
 The source code is free in all ways (except that it is copyrighted.)

 The dependencies should be easy to automatically process. Given
 the command

depsrc -Isomepath foo.d bar.d, the output will be something like:



 foo.d

 moduledep1 pathtomoduledep1 1,2
 moduledep2 pathtomoduledep2 3

 bar.d

 moduledep3 pathtomoduledep3 1
 ...
 ...

 What's the use for this program? It might be a nice diagnostic if
 you don't have control over which modules have have been imported
 from where. Also it can be used by build systems to find the
 dependencies such that it knows when to recompile/relink.
 If anyone wants to include it in their packages, feel free (dmd, dide,


leds,

 etc.)

 It would be nice if someone would like to test it on linux.
 Suggestions, fixes, etc are welcome.

 Lars Ivar Igesund



begin 666 depsrc.d



M<VEO;B!T;R!U<V4L(&-O<'DL(&UO9&EF>2P 9&ES=')I8G5T92!A;F0 <V5L

M(&%N>2!P=7)P;W-E(&ES(&AE<F5B>2!G<F%N=&5D('=I=&AO=70 9F5E+ T*
M("H <')O=FED960 =&AA="!T:&4 86)O=F4 8V]P>7)I9VAT(&YO=&EC92!A
M<'!E87( :6X 86QL(&-O<&EE<R!A;F0-"B J('1H870 8F]T:"!T:&%T(&-O
M<'ER:6=H="!N;W1I8V4 86YD('1H:7, <&5R;6ES<VEO;B!N;W1I8V4 87!P

M;W9I9&5D(")A<R!I<R( =VET:&]U="!E>'!R97-S( T*("H ;W( :6UP;&EE


M=&1I;SL-" T*8F]O;"!H96QP8V%L;&5D(#T
M;VYC86QL960 /2!F86QS93L-"F)O;VP =W)I=&4 /2!F86QS93L-"F)O;VP 

M<&%T:', /2 P.PT*:6YT(&%L;'!A=&AS(#T
M=" ]("TQ.PT*:6YT(&1E<'1H(#T ,#L-"FEN="!N=6UD97!S(#T ,#L-"FEN
M="!A;&QD97!S(#T
M72!D97!M;V1S.PT*8VAA<B!;75M=(&1E<&9I;&5S.PT*8VAA<B!;75M=(&1E
M<&1E<'1H<SL-"F-H87( 6UU;72!P871H<SL-"F-H87( 6UU;72!A<F=S;&ES
M=#L-
M87)R87D =VAE;B!N96-E<W-A<GD-"F-O;G-T(&-H87( 6UU;72!P:&]B;W, 


M(FUA=& B+ T*("  (")O8FIE8W0B+ T*("  (")O=71B=69F97(B+ T*("  




M+ T*("  (")I;G1R:6YS:6,B+ T*("  (")W:6YD;W=S(BP-"B  (" B1"YW
M:6XS,BYR96=I<W1R>2( 73L-" T*+RH-"B J($9U;F-T:6]N(&-A;&QE9"!W


M<&-A;&QE9"D >PT*("  ('!R:6YT9B B7&XB('X-"B  ("  ("  ("  (E-Y
M;G1A>#H 9&5P<W)C(%MO<'1I;VYS72!;<W)C("XN+EU<;B( ? T*("  ("  
M("  (" B(" M25MP871H72  ("  ("  ("  ("  ($%D9"!A('!A=&  =&\ 
M8F4 <V5A<F-H960N7&XB('X-"B  ("  ("  ("  (B  +6 O+2UH96QP("  

M("  ("  ("( ("UD/5MN=6U=+RTM9&5P=& ]6VYU;5T 3&EM:70 =&AE(&1E


M("  ("( ("UM+RTM;6%K92US>6YT87  ("  ("  4')I;G0 =&AE(&1E<&5N

M("  ("  ("  ("  ("  ("  ("  ("!S>6YT87 N(%PB;V)J96-T9FEL92 Z
M('-R8R!D97!S7")<;B( ? T*("  ("  ("  (" B(" M5B\M+79E<G-I;VX 
M("  ("  ("  (%!R:6YT<R!T:&4 =F5R<VEO;BY<;B( ? T*("  ("  ("  
M(" B(" M=R\M+7=R:71E=&]F:6QE("  ("  (%!R:6YT<R!T:&4 9&5P96YD
M96YC:65S('1O('1H92!F:6QE7&XB('X-"B  ("  ("  ("  (B  ("  ("  
M("  ("  ("  ("  ("  ("  ("=D97!F:6QE)R!I;G-T96%D(&]F('1O('1H












M:68 *&-M<"AA<F=S;&ES=%MA<F==6S N+C-=+" B+60](BD /3T ,"D >PT*
M("  (&]P=$1E<'1H*&%R9RP 9F%L<V4I.PT*("  (')E='5R;B!T<G5E.PT*

M97!T:"(I(#T

M+BXR72P (BU)(BD /3T ,"D >PT*("  (&]P=$EM<&]R="AA<F<I.PT*("  

M"B J($9U;F-T:6]N('1H870 <W1A<G1S('1H92!D97!E;F1E;F-Y('=A;&MI

M92AI;G0 87)G*0T*>PT*("!A9&1.97="87-E1FEL92AA<F=S;&ES=%MA<F==


M=V%L:VEN9R!R96-U<G-I=F5L>2X 268 :70 9FEN9 T*("H 9FEL97, =&AA
M="!H87, 8F5E;B!W86QK960 8F5F;W)E+"!I="!S:VEP<R!I="!T;R!A=F]I

M;VED(&1E<%=A;&LH8VAA<B!;72!F:6QE+"!C:&%R(%M=(&UO9"P 8F]O;"!B
M87-E*0T*>PT*("!C:&%R(%M=(&9I;&5P871H(#T 9FEL93L-"B  :6YT(&D 
M/2 P.PT*("!W:&EL92 H:2 \(&YU;7!A=&AS("8F("%F:6QE17AI<W0H9FEL

M(&9I;&4I.PT*("  (&DK*SL-"B  ?0T*("!&:6QE('-R8R ](&YE=R!&:6QE
M*&9I;&5P871H*3L-"B  =VAI;&4 *"%S<F,N96]F*"DI('L-"B  ("!C:&%R
M(%M=(&QI;F4 /2!S<F,N<F5A9$QI;F4H*3L-"B  ("!C:&%R(%M=6UT <W1A


M('!O<R ](&9I;F0H<W1A=&5M96YT<UMI72P (FEM<&]R="(I.PT*("  ("  
M:68 *'!O<R ]/2 M,2D >PT*("  ("  ("!C;VYT:6YU93L-"B  ("  ('T-
M"B  ("  (&5L<V4 >PT*("  ("  ("!I9B H(6)A<V4I('L-"B  ("  ("  
M("!I;G0 <')I=G!O<R ](')F:6YD*'-T871E;65N='-;:5TL(")P<FEV871E



M6UT =V]R9', /2!S<&QI="AI;7!S=&UT*3L-"B  ("  ("  ("  (&EF("AW
M;W)D<RYL96YG=&  /3T ,BD >PT*("  ("  ("  ("  ("!C;VYT:6YU93L-

M("  8VAA<B!;72!M;V0 /2!S=')I<"AS=&%T96UE;G1S6VE=6W!O<RLW+BYS
M=&%T96UE;G1S6VE=+FQE;F=T:%TI.PT*("  ("  ("!I9B H8VAE8VM.;W1-



M("  9G  /2!C<F5A=&5&:6QE4&%T:"AM;V0I.PT*("  ("  ("!D97!T:"LK
M.PT*("  ("  ("!I9B H9&5P=&AL:6UI=" ]/2 M,2!\?"!D97!T:" \/2!D
M97!T:&QI;6ET*2![(" -"B  ("  ("  ("!D97!786QK*&9P+"!M;V0L(&9A
M;'-E*3L-"B  ("  ("  ?0T*("  ("  ("!D97!T:"TM.PT*("  ("  ?0T*
M("  ('T-"B  ?0T*("!I9B H(6)A<V4I('L-"B  ("!A9&1$97 H9FEL97!A


M" T*=F]I9"!O<'1697)S:6]N*"D-"GL-"B  :68 *"%V97)S:6]N8V%L;&5D






M+RH-"B J($9U;F-T:6]N(&-A;&QE9"!I9B!T:&4 (F1E<'1H(B!O<'1I;VX 
M:7, =7-E9"!T;R!D96-I9&4 =&AE(&UA>&EM=6T-"B J(&1E<'1H(&9O<B!R


M=&AL:6UI=" ]("AI;G0I871O:2AA<F=S;&ES=%MA<F==6S N+F%R9W-L:7-T

M=" ]("AI;G0I871O:2AA<F=S;&ES=%MA<F==6S,N+F%R9W-L:7-T6V%R9UTN


M=F]I9"!O<'1);7!O<G0H:6YT(&%R9RD-"GL-"B  :68 *&%R9W-L:7-T6V%R
M9UTN;&5N9W1H(#T






M97!T:"!W:&5R92!I="!W87, 9F]U;F0 :7, 86QS;R!A9&1E9"X 268 =&AE


M" T*=F]I9"!A9&1$97 H8VAA<B!;72!F:6QE<&%T:"P 8VAA<B!;72!M;V0L

M+FQE;F=T:#L
M(#T
M97!D97!T:'-;:5T ?CT =&]3=')I;F<H9&5P=& I.PT*("  ("  <F5T=7)N

M86QL9&5P<RD >PT*("  (&%L;&1E<', *CT ,CL-"B  ("!D97!M;V1S+FQE

M<SL-"B  ("!D97!D97!T:',N;&5N9W1H(#T 86QL9&5P<SL-"B  ?0T*("!D

M,5T /2!F:6QE<&%T:#L-"B  9&5P9&5P=&AS6VYU;61E<',M,5T /2!T;U-T

M=&AE(&9I;&5N86UE(&]F('1H92!C=7)R96YT(&-H96-K960 9FEL92!T;PT*


M97!S(#X 86QL9&5P<RD >PT*("  (&%L;&1E<', *CT ,CL-"B  ("!D97!M

M86QL9&5P<SL-"B  ("!D97!D97!T:',N;&5N9W1H(#T 86QL9&5P<SL-"B  



M(#T 9&5P9FEL97-;;G5M9&5P<RTQ72 ]("(B.PT*("!D97!D97!T:'-;;G5M
M9&5P<RTS72 ](&1E<&1E<'1H<UMN=6UD97!S+3)=(#T 9&5P9&5P=&AS6VYU
M;61E<',M,5T /2 B(CL-"GT-" T*+RH-"B J($9U;F-T:6]N('1H870 =&%K
M97, 82!M;V1U;&4 ;F%M92!A;F0 8W)E871E<R!A(')E86P <&%T:"X-"B J
M+PT*( T*8VAA<B!;72!C<F5A=&5&:6QE4&%T:"AC:&%R(%M=(&UO9"D-"GL-
M"B  8VAA<B!;72!T96UP;6]D93L-"B  =&5M<&UO9&4 /2!R97!L86-E*&UO
M9"P (BXB+"!S97 I.PT*("!T96UP;6]D92!^/2 B+F0B.PT*("!R971U<FX 




M;F=T:#L

M;B!F86QS93L-"GT-" T*+RH-"B J($-H96-K<R!I9B!T:&4 9F]U;F0 ;6]D
M=6QE(')E86QL>2!C86X 8F4 82!M;V1U;&4 <VEN8V4 =&AE('!A<G-I;F<-

M9"AC:&%R(%M=(&UO9"D-"GL-"B  8VAA<B!;72!I;&QC:&%R<R ]("(I*%M=

M"B  ("!R971U<FX =')U93L-"B  ?0T*("!F;W( *&EN="!I(#T ,3L :2 \
M(&UO9"YL96YG=& [(&DK*RD >PT*("  (&EF("AF:6YD*&EL;&-H87)S+"!M
M;V1;:5TI(#X +3$I('L-"B  ("  (')E='5R;B!T<G5E.PT*("  ('T-"B  


M(&%D9%!A=& H8VAA<B!;72!P871H*0T*>PT*("!N=6UP871H<RLK.PT*("!I




M9FEL92D-"GL-"B  8F]O;"!R97-U;'0 /2!T<G5E.PT*("!T<GD >PT*("  

M("  <F5S=6QT(#T
M" T*:6YT(&UA:6XH8VAA<EM=6UT 87)G<RD-"GL-"B  :68 *&%R9W,N;&5N
M9W1H(#T



M*&-U<F]P=" \(&%R9W,N;&5N9W1H("8F(&-H96-K3W!T:6]N*&-U<F]P="DI

M+FQE;F=T:"D >PT*("  (&9I<G-T9FEL92 ](&-U<F]P=#L-"B  ("!F;W( 
M*&EN="!I(#T 8W5R;W!T.R!I(#P 87)G<RYL96YG=& [(&DK*RD >PT*("  

M"B  ("!&:6QE(&1E<&9I;&4 /2!N97< 1FEL92 B9&5P<R(L($9I;&5-;V1E

M('L-"B  ("  ('!R:6YT9BAD97!M;V1S6VE=('X (B B('X 9&5P9FEL97-;



M=F5R<VEO;B H5VEN,S(I('L-"B  ("  ("  ;V)J<W5F(#T (BYO8FHB.PT*
M("  ("  ?0T*("  ("  =F5R<VEO;B H;&EN=7 I('L-"B  ("  ("  ;V)J
M<W5F(#T (BYO(CL-"B  ("  ('T-"B  ("  (&-H87( 6UT 9&5P<R ](')E
M<&QA8V4H87)G<UMF:7)S=&9I;&5=+" B+F0B+"!O8FIS=68I.PT*("  ("  
M9&5P<R!^/2 B(#H (CL-"B  ("  (&1E<', ?CT 87)G<UMF:7)S=&9I;&5=

M:2 \(&YU;61E<',[(&DK*RD >PT*("  ("  ("!D97!S('X](&1E<&9I;&5S
M6VE=('X (B B.PT*("  ("  ?0T*("  ("  <')I;G1F*&1E<',I.PT*("  
M('T-"B  ("!E;'-E('L-"B  ("  (&9O<B H:6YT(&D /2 P.R!I(#P ;G5M

M('X 9&5P9FEL97-;:5T ?B B("( ?B!D97!D97!T:'-;:5T ?B B7&XB*3L-

`
end
Oct 27 2003