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]UVV\81OA:?8LV+B#\02)#Z
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)'<
M"(^NS^=SVU/"4Y"UW6C:Z+(._L^^2CZ*JRCYR,X]/F5?\_#:%W/?_<BXYPF/
MR6 JF!>YLZD(4YY"/.RLZ?<37[)IY,T"P>#;3()\&K$83` V]N%JR*="V S]
M2B>"1;%(2(>D]A Y%H7!`OXPF28016FAX`(LAKLI`_%QE$P9#Q?,#^-9VHMF
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+0AP0$KI"9,<P,NEX5Q)"!X?6X(AUAT/K\#%AM,%N1(*)
MTGKOA\-!N\%^`LM[##X0?/#9G?#D W/)I( ![<V+B^;3'7"B!\#'(<]P`_=Y
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=(`B#>1
M!T.0M#XFSHB[US+ < +# [+L3WXXNX4;=-%&C'?7XBEW;_705T>>M;3^]I*'
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
M4GEMJE)5)$K!$W<"%X.`VI`.4 N#.`/'J<ZFUJI>I,HV+D,2_E,WT75P#(8;
M<B33Z:O"-A'<G0A/YT8.5K3F)?X-0$JDV#97W#KQSPC))SW_K$U:>""AHA3)
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,
MC5<*TK#*PU][^*%OE3H9+_U$?_&CUQN8!2H-LCQHL],SE0,KA6W`Y<7%B"=*
M&/TDV4\ENWI.KK?;F\!*KP>\D= 8HQXHLT$;V=[8<#/[N49_SX8LBV:)*W2C
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
M5"WB0"Y)FV%<DLX#;=K<GR-'7*HMI^UHT5RQ5]1(F5K% [\^]_U/T=YJYN)Z
M6W6)"96_IDXJ4.%;$$_FOA16L7NYP,-1V!] 3-?3F/FU!2?E2M?Q$GW? !PR
M;;4$,> ?8GTQ[!]9PP/B!TR3#1.EO#:^5Q&Q,EMRW0"1]/>4^8R4,07$?3*F
MIHMD<\D9#/\(E(1N,//4CH0)M=&J=PWTPP4P!^M25PB4'BW,=L$#)NM+/]FL
MY&C6M;I#0:YAFU3/-.:97JH[[O2DV*ZTK%E/"J9]/2?LTYIC>-2W!H.L9KB;
M%ZKL *FP+2FLYH-B8MV3#<`+C;*<&4;BR _#$K[*6:?D_;MSC?*,%,3!3#FM
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":
M1A0" =PSQPF#!3_1$S4=:(OH'1`D8H0H.8Q"8=-5"6OVP(,+J>GN`B#'/7PF
MBAIP.0?KOE`4R!A+8*17D<Z%"',WL/_:DKFF=93CBM&CY\/HQ7*"9/H4I>=/
MI8LCP2(#^+*M+LI\!EKUR-`V#*(TO4V;P"X)GQ=*+[Q8*[TLBK^61''-4I+$
MLBN3K$V#0G.3"+K;EA&!CNND>+)/27'0Q\?/FY5?.AUP=S<F$(A;7]+F;HZJ
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
M6X\A[2#[MDB[<O[I?'ETVL<!HW(8'_J-9!3,4F&.M`#>4EB_R+S 2**HL')J
M%[+LQ42XU[).6PUF8%Y 'T42Z<E"U^-K;:FC.=0HH^2'*K=]";ZWFHD(>`HE
M =F;P7'L5X6PV#`]52+.IB6TUE"JGK/V!0':O<J-UQ7'?IAJ:8T6]%C#9>  
M7`YP$ZU?V$0C`' VH.P* G^B*E+]ZXLOZ.<'<_L2]Z'PB6W_<H.]J"K8_ACA
M>FH>F=-?TQB8)(2ACAW*ZGAP9TF#*F2=CGRD 5)!GR$PQ8X,:G`_H/-2I15?
MN=(P%$MJJ!R&JT#M6`*'+J?9*1[4P!CL=?$.^SJ:"QAJB^`_(/"'>3:A;4L=
MJHL')7)_Z$V>'R%LK:9[K+:A+6(AS4?Z8N7)D&J A1':Y<W 3'8#="M5/=#5
M*UNF2S56>]ILKR!:,5C+F]3:P-[)^#(>*/SO']$FT>$3QQH\V8XN";UO>(KK
ML.PD7V'IY"K\N -5A+S`/5*)\Q>PAI\NH)A2TU<4%H]:`IKD0J9B6L`W&2E6
M%KF5M=L9F` \\:5:Y'F(:O\JC&BG`D\TVL6UF)J L%P!S6Q*_<*-#'6BLXC"
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":
MXR^ (<_EB8=#4D4B-TT9O\)E45HJDZ&/:'+G).6C0)SI[\G92>J=G8S..B>]
MT1G#'PIE?:R_I\2H&:ZK;9Y5VF!IFTE7A3^ ,&Y+ H#$;4FX=KE. 3J#C$P/
M#;):&,/QX7))^:/[:<>YATIS9:9LY1'3=GHZ9!CL[Z(RH43C+.HT <E8N#X/
M(/1XD!J'K$5'L<T#5?!Q*E*^EZN +5IB)?#9Y3`5DM\PUPCI\AC7$=_3>6=0
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
M3Y$.VQ:3^O30+$#"B6/02XOB%%94.'\(U3NLG]1Z,7O,3PBG(P#JK0291C%E
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*&%GF[S#"^L<QCNFS"L<K2NWE"M5VTB:."I
MPN/P\-!R#EGWR7"0O]RDZT),BAL>S/`]%:!X\T ,#[$FS./`"]S`$QN]GVB6
M$>&-GT0AO;AR`UR`_)&= -`O)%GYFG^.V4L`']%;-?[81UOCU;K,`H_V#>W,
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/,TRS(?D_ (5 ]'D,.'CZTLA3\59/#;7Q4X
MCMGY#?<#PABL!J":N.G;SOY0K5[/9^D$9M;CE6\?6A"!:,HE^V8F)GHK>)M6
M__H'M:JLWHO#I2]EXZ)HZLCI6\X0NGATA/^:]=%/#;8C\?5'UYR6 O+`;&"=
MGC('CTVI5R[H('[/;'I" 1141TTC$;!?>)6%MN#&K)7C)-LL<]C//^=^XDL'
MCT[9[B^[>+IK.TO=G:U-L)W"#EXF0>\1UBO#:)2U.84=O8I"-2!?0NGT*B>G
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
MS^D/\(MZ;=/X$G"9_D"[!.#0GM,VD,^\0IZ 5?ZIVJEUF&TSLUG["]N]Z.^B
MMQN)L9V"N4RS`4^7.<LCMJ$_1NW=+BU+%DWJ!,_=/%.AQ$_C/P1/%7:1/ ``
`
end
Jan 29 2006