www.digitalmars.com         C & C++   DMDScript  

digitalmars.D - Improved std.path documentation

Here is a patch to improve std.path documentation. I found out that
ddoc doesn't allow me to document the whole module, text which would
appear at the top of the HTML file before any other line. This is
a shame, because it doesn't allow to write general introductions
to a module's function. Or at least, the syntax to do it avoided
me when I read about ddoc.

begin 664 d_path_doc.diff.gz
M'XL("*BKW$,"`V1?<&%T:%]D;V,N9&EF9 #M6
ML65)MFH[B9LZ[G'2^L+2R5D"2Q$1"*!84!2=."_6GM.+/E!?H3.SN_ C2)%R
ME)[VA">126!V9G;VFV]G%XO7H2=NCYE,W%X\B4:1[,G4Z\4\G=A>X_3S/XV]
MO;UZ[3NM1-SXTH]"YCQN-[K=[BJY>91<^^$5<Z-XT6X\?\[V'&N?=?'/\^>-
MO4;WWW__9X/U.IT&8QWVAKM))(_Q^\[[U]^\9J?LN]3[,^BBIH>6TV==^'N$
MC5'H!:A-_*M)REINFPWZ?6</_ARPT8*]]*_\E`> ,Y$D>QX$[!W*2O9.2)'<


M2B>"1;%(2(>D]A Y%H7!`OXPF28016FAX`(LAKLI`_%QE$P9#Q
M*?Q#K7-EMO9$\%!"<YXR?\PXPP&"40&W?;C.F><GPDVC9$%N*0]\$($[46JQ
M\2QT21T+_&O!KD3ZZC9MM4$&O"=72=I/V8\SF3*N^ "6X,J<HP'LLLU>C]DB
MFK%0J&AX_G L$ B>SU.!G8/8N%P*:5%[%"4+1AZB2+$"B-D40QW L9^`U99O
M PE?OO235KMMX^CV&JRQU^NQ+TW`:0` EH`]TQB583B> BSK]3PQFEV=TH6=
M'6 */8^F.,#H0#I

M D$J#Y2$H=>C:=>IY4&J-?>,XO, %4F(JK1K+!JC^ ^7EK(&&L%9+YK+6I5H
M2^M\VGQ**C%#C8=1HM&ZW'AP"> )A>EJ<A'J]JOZ2M*U3KBS!`*!:NQ*P!(1
M)V`"(`4_$"L B C+`U?K&% T"NVR5TL*0;2BKXOZ ,3N,6CL+\#BB
M!T.0M#XFSHB
MRKSQ3TSC=+'*B1+Z<C?JX<+.X=K4!Q4!.*:ZJKVQH+=T.?>B$(I5ULM`O7N0
M"&T60UR6S0/%>NPB-WZ7[3J<-]BGG`L";*JX8.7(]7Y%(NB;H?CU*>!X.PIP
MRJ'YG0`>F !Z_[7\ST'WW\S\X]\T\Y?A37D/)4AGY0?`"(6F2)FX344HJ8C$
M2U]" ,0MG\:!L%C3.[[`7EV,H\ >\;0)J,1:1+(F_ ($;I4!.+Q0UT&-U%V3
M5NN55K.`M=)YA%IE1>U2<C6ZH+FCRF0H(Q/NII)49A% XR2:ZJ*1JC:(A:*V


MU,><5"%0G<C[^4X-\S%6SC1F5$Z/(T"BE?LH$<X^1%$MAF!DM)O8&/U\G=7\
MN4<%1=AKTT7/]V!Y0>WU^H"6&#BP9AAR)=!G`\00%!3')X&('+-O(V`*G`G,


M[&?!9Q4UO;Q1279I=.E?9CCUHML96D] V7WH6,-]M7B&#Y= ,&WY[/24]=O;
M4!4!!5=\L.2\+V\5[A!_=4J`+_,!X$46YZS?F6%K9 C$^/^3&+X%WU8S0^EZ
M<W6[SR,)I6L=2]3<V]R;['ISG=$EZBC<VH0]2%\]?1PXEN.P[F"P;PV?9/P!
MYF9!"K-ZYHR*/7C]5$D`M3!W&K>4)-`!#H*Y6:6?KBJGEK761$47=882,G#L

M6W6)"96_IDXJ4.%;$$_FOA16L7NYP,-1V!] 3-?3F/FU!2?E2M?Q$GW? !PR




MVI93KYA[6..LRSO:K[+4EEW6-Q[,^4*6BG3F3Z?"PT=QP>(S$ B! 6%>ER'-
M];BBYO6H.AH JO:= 350,\W.IQQ9ZW%%((+1R-:.7B0D/DKE`9"QMV`3#N
M8;[NM* )CV-D_O(.%7RCW4$50+JIJL "],ZI(3U>%6..56W>'D8[7\6N`J":

MBAIP.0?KOE`4R!A+8*17D<Z%"',WL/_:DKFF=93CBM&CY\/HQ7*"9/H4I>=/


M:#RFRJ4XWMQ3F1"*>3D;%$>_6Y<.GD<[!8F(`^Z*\ `_4$)DMO` `D+0X!5I
M&&CT=2E)BGB#K_H8A$H#E5K(O7>D426%2,FV:51-(5*R:1IUE[3YLKR75BC=
M2`>65'$>SEU9!H%5XI6<]62A.--C?=\T!%BM3\$L6XJ2&XC=(_5TTSO3;CCH

M%[+LQ42XU[).6PUF8%Y 'T42Z<E"U^-K;:FC.=0HH^2'*K=]";ZWFHD(>`HE

M7`YP$ZU?V$0C`' VH.P* G^B*E+]ZXLOZ.<'<_L2]Z'PB6W_<H.]J"K8_ACA

MN=(P%$MJJ!R&JT#M6`*'+J?9*1[4P!CL=?$.^SJ:"QAJB^`_(/"'>3:A;4L=


ML.PD7V'IY"K\N -5A+S`/5*)\Q>PAI\NH)A2TU<4%H]:`IKD0J9B6L`W&2E6

M6J*&WDZUF^[`^HVH>!QB),AN:Y?O6FQWM%LAXI+(.8KPW>V(^'.,K.?D8C,/
MOT(4+::_:8`>]`&9?=8]&AY:!TYQRV)SHJT -7M0BMR#AV_P )4Y03&. B":




MH1+Q)#X[*;A4'47PUSO+T #O&(3D XKPX"$N=W!OJQ 8FYK#GV1)^[/UVHFD
MZ!CZ/?6OA,AJFT5;2Z9*",J:%\=X!(+7`FJ2-4X]>A"O*LA;ZQWC8]4.MY7<
M $_IP#Y0>W*]Y+C&*D!$E5 A'>0+`CSZ[\$<Y\T`G+DO^6PD:=^0YB,7Y,TN

M23$9U%*"K&4.S!*<L5 <)>J] D M0):83?$ ;?A+FDFSB5W =*ZX4,_C^OV&
MJIR]>BHU23ZM3/O+LZIQQZ A#L%E&VX]4'-%)$+\<![(Z+ <XH>;E96![,D[
ME&V=ZNJE*-3+2DU\&M\9=9)UTD;E^%E6"O:7!;_*!3^,KRZ?/<NE:]1ZQ7H7
MB]L._*JVV*A6R,QW5IFO<18#T
MPN/P\-!R#EGWR7

M,.DP?MUEL,X8=DPI*1HPW<XT1TEQXPZDPFAV-0'BF>+3WC0B%>8=*6SYMYE0
M1[7OV46TZ*LMP?S<<Q;N+7I,*NIZO7F/245=K^MZ;*"1$2"]+49'L:DR1=$4
M"E"<AF*.ZV\Z]T4O<F6BI,'LSYN=SU'>A,S0$[IL6:1N?8^:6VUP,1$PK9B-
M0YQN>')%;\[E5G*:-32)+V>]G:5OQV^HBR4*K=RK//!8'1RUO5`,;1!%U[.8
MJ!RO0UGP"PX(E 4PM80IO\W#F

M__H'M:JLWHO#I2

MCT[9[B^[>+IK.TO=G:U-L)W"#EXF0
M7"=$-0N."'`C?X?^6:'CI<9Z28%9WQH=Q6(#DUB/^^-]1+;3/W`,M-4XXO/Y
MK]^^>45%H'HWD]-KDOJI2TXMMFJ#N.HPG'W5^3Y W583->0G!B%LZOZI.KN7
M=U)W2;VJV=TI_62ES50H?T=^*%Y +]\#Q;W$+Z36TGN`CCK*A[U[/#RPG`%T

MMQN)L9V"N4RS`4^7.<LCMJ$_1NW=+BU+%DWJ!,_=/%.AQ$_C/P1/%7:1/ ``
`
end
Jan 29 2006