/ The Datafile PD-CD 5 / DATAFILE_PDCD5.iso / utilities / p / python / pytexdoc / ext / lib / libr / riscospath / tex

MacOS 8.1

Win98

DOS

view JSON data

view as text

+--------+-------------------------+-------------------------+--------+--------+
|00000000| 5c 73 65 63 74 69 6f 6e | 7b 53 74 61 6e 64 61 72 |\section|{Standar|
|00000010| 64 20 4d 6f 64 75 6c 65 | 20 5c 73 65 63 74 63 6f |d Module| \sectco|
|00000020| 64 65 7b 72 69 73 63 6f | 73 70 61 74 68 7d 7d 0a |de{risco|spath}}.|
|00000030| 5c 73 74 6d 6f 64 69 6e | 64 65 78 7b 72 69 73 63 |\stmodin|dex{risc|
|00000040| 6f 73 70 61 74 68 7d 0a | 0a 54 68 69 73 20 6d 6f |ospath}.|.This mo|
|00000050| 64 75 6c 65 20 69 6d 70 | 6c 65 6d 65 6e 74 73 20 |dule imp|lements |
|00000060| 73 6f 6d 65 20 75 73 65 | 66 75 6c 20 66 75 6e 63 |some use|ful func|
|00000070| 74 69 6f 6e 73 20 6f 6e | 20 52 69 73 63 4f 53 20 |tions on| RiscOS |
|00000080| 70 61 74 68 6e 61 6d 65 | 73 2e 0a 0a 5c 73 74 72 |pathname|s...\str|
|00000090| 6f 6e 67 7b 44 6f 20 6e | 6f 74 20 69 6d 70 6f 72 |ong{Do n|ot impor|
|000000a0| 74 20 74 68 69 73 20 6d | 6f 64 75 6c 65 20 64 69 |t this m|odule di|
|000000b0| 72 65 63 74 6c 79 2e 7d | 20 20 49 6e 73 74 65 61 |rectly.}|  Instea|
|000000c0| 64 2c 20 69 6d 70 6f 72 | 74 20 74 68 65 0a 6d 6f |d, impor|t the.mo|
|000000d0| 64 75 6c 65 20 5c 63 6f | 64 65 7b 6f 73 7d 20 61 |dule \co|de{os} a|
|000000e0| 6e 64 20 75 73 65 20 5c | 63 6f 64 65 7b 6f 73 2e |nd use \|code{os.|
|000000f0| 70 61 74 68 7d 2e 0a 5c | 73 74 6d 6f 64 69 6e 64 |path}..\|stmodind|
|00000100| 65 78 7b 6f 73 7d 0a 0a | 5c 72 65 6e 65 77 63 6f |ex{os}..|\renewco|
|00000110| 6d 6d 61 6e 64 7b 5c 69 | 6e 64 65 78 73 75 62 69 |mmand{\i|ndexsubi|
|00000120| 74 65 6d 7d 7b 28 69 6e | 20 6d 6f 64 75 6c 65 20 |tem}{(in| module |
|00000130| 72 69 73 63 6f 73 70 61 | 74 68 29 7d 0a 0a 5c 62 |riscospa|th)}..\b|
|00000140| 65 67 69 6e 7b 66 75 6e | 63 64 65 73 63 7d 7b 62 |egin{fun|cdesc}{b|
|00000150| 61 73 65 6e 61 6d 65 7d | 7b 70 7d 0a 52 65 74 75 |asename}|{p}.Retu|
|00000160| 72 6e 20 74 68 65 20 62 | 61 73 65 20 6e 61 6d 65 |rn the b|ase name|
|00000170| 20 6f 66 20 70 61 74 68 | 6e 61 6d 65 0a 5c 76 61 | of path|name.\va|
|00000180| 72 7b 70 7d 2e 0a 54 68 | 69 73 20 69 73 20 74 68 |r{p}..Th|is is th|
|00000190| 65 20 73 65 63 6f 6e 64 | 20 68 61 6c 66 20 6f 66 |e second| half of|
|000001a0| 20 74 68 65 20 70 61 69 | 72 20 72 65 74 75 72 6e | the pai|r return|
|000001b0| 65 64 20 62 79 0a 5c 63 | 6f 64 65 7b 72 69 73 63 |ed by.\c|ode{risc|
|000001c0| 6f 73 70 61 74 68 2e 73 | 70 6c 69 74 28 5c 76 61 |ospath.s|plit(\va|
|000001d0| 72 7b 70 7d 29 7d 2e 0a | 5c 65 6e 64 7b 66 75 6e |r{p})}..|\end{fun|
|000001e0| 63 64 65 73 63 7d 0a 0a | 5c 62 65 67 69 6e 7b 66 |cdesc}..|\begin{f|
|000001f0| 75 6e 63 64 65 73 63 7d | 7b 63 6f 6d 6d 6f 6e 70 |uncdesc}|{commonp|
|00000200| 72 65 66 69 78 7d 7b 6c | 69 73 74 7d 0a 52 65 74 |refix}{l|ist}.Ret|
|00000210| 75 72 6e 20 74 68 65 20 | 6c 6f 6e 67 65 73 74 20 |urn the |longest |
|00000220| 73 74 72 69 6e 67 20 74 | 68 61 74 20 69 73 20 61 |string t|hat is a|
|00000230| 20 70 72 65 66 69 78 20 | 6f 66 20 61 6c 6c 20 73 | prefix |of all s|
|00000240| 74 72 69 6e 67 73 20 69 | 6e 0a 5c 76 61 72 7b 6c |trings i|n.\var{l|
|00000250| 69 73 74 7d 2e 0a 49 66 | 0a 5c 76 61 72 7b 6c 69 |ist}..If|.\var{li|
|00000260| 73 74 7d 0a 69 73 20 65 | 6d 70 74 79 2c 20 72 65 |st}.is e|mpty, re|
|00000270| 74 75 72 6e 20 74 68 65 | 20 65 6d 70 74 79 20 73 |turn the| empty s|
|00000280| 74 72 69 6e 67 20 28 5c | 63 6f 64 65 7b 27 27 7d |tring (\|code{''}|
|00000290| 29 2e 0a 5c 65 6e 64 7b | 66 75 6e 63 64 65 73 63 |)..\end{|funcdesc|
|000002a0| 7d 0a 0a 5c 62 65 67 69 | 6e 7b 66 75 6e 63 64 65 |}..\begi|n{funcde|
|000002b0| 73 63 7d 7b 65 78 69 73 | 74 73 7d 7b 70 7d 0a 52 |sc}{exis|ts}{p}.R|
|000002c0| 65 74 75 72 6e 20 74 72 | 75 65 20 69 66 0a 5c 76 |eturn tr|ue if.\v|
|000002d0| 61 72 7b 70 7d 0a 72 65 | 66 65 72 73 20 74 6f 20 |ar{p}.re|fers to |
|000002e0| 61 6e 20 65 78 69 73 74 | 69 6e 67 20 70 61 74 68 |an exist|ing path|
|000002f0| 2e 0a 5c 65 6e 64 7b 66 | 75 6e 63 64 65 73 63 7d |..\end{f|uncdesc}|
|00000300| 0a 0a 5c 62 65 67 69 6e | 7b 66 75 6e 63 64 65 73 |..\begin|{funcdes|
|00000310| 63 7d 7b 65 78 70 61 6e | 64 76 61 72 73 7d 7b 70 |c}{expan|dvars}{p|
|00000320| 7d 0a 52 65 74 75 72 6e | 20 74 68 65 20 61 72 67 |}.Return| the arg|
|00000330| 75 6d 65 6e 74 20 77 69 | 74 68 20 65 6e 76 69 72 |ument wi|th envir|
|00000340| 6f 6e 6d 65 6e 74 20 76 | 61 72 69 61 62 6c 65 73 |onment v|ariables|
|00000350| 20 65 78 70 61 6e 64 65 | 64 2e 20 20 53 75 62 73 | expande|d.  Subs|
|00000360| 74 72 69 6e 67 73 0a 6f | 66 20 74 68 65 20 66 6f |trings.o|f the fo|
|00000370| 72 6d 20 5c 73 61 6d 70 | 7b 5c 24 5c 76 61 72 7b |rm \samp|{\$\var{|
|00000380| 6e 61 6d 65 7d 7d 20 6f | 72 20 5c 73 61 6d 70 7b |name}} o|r \samp{|
|00000390| 5c 24 5c 7b 5c 76 61 72 | 7b 6e 61 6d 65 7d 5c 7d |\$\{\var|{name}\}|
|000003a0| 7d 20 61 72 65 0a 72 65 | 70 6c 61 63 65 64 20 62 |} are.re|placed b|
|000003b0| 79 20 74 68 65 20 76 61 | 6c 75 65 20 6f 66 20 65 |y the va|lue of e|
|000003c0| 6e 76 69 72 6f 6e 6d 65 | 6e 74 20 76 61 72 69 61 |nvironme|nt varia|
|000003d0| 62 6c 65 20 5c 76 61 72 | 7b 6e 61 6d 65 7d 2e 20 |ble \var|{name}. |
|000003e0| 20 4d 61 6c 66 6f 72 6d | 65 64 0a 76 61 72 69 61 | Malform|ed.varia|
|000003f0| 62 6c 65 20 6e 61 6d 65 | 73 20 61 6e 64 20 72 65 |ble name|s and re|
|00000400| 66 65 72 65 6e 63 65 73 | 20 74 6f 20 6e 6f 6e 2d |ferences| to non-|
|00000410| 65 78 69 73 74 69 6e 67 | 20 76 61 72 69 61 62 6c |existing| variabl|
|00000420| 65 73 20 61 72 65 20 6c | 65 66 74 0a 75 6e 63 68 |es are l|eft.unch|
|00000430| 61 6e 67 65 64 2e 0a 5c | 65 6e 64 7b 66 75 6e 63 |anged..\|end{func|
|00000440| 64 65 73 63 7d 0a 0a 5c | 62 65 67 69 6e 7b 66 75 |desc}..\|begin{fu|
|00000450| 6e 63 64 65 73 63 7d 7b | 69 73 61 62 73 7d 7b 70 |ncdesc}{|isabs}{p|
|00000460| 7d 0a 52 65 74 75 72 6e | 20 74 72 75 65 20 69 66 |}.Return| true if|
|00000470| 20 5c 76 61 72 7b 70 7d | 20 69 73 20 61 6e 20 61 | \var{p}| is an a|
|00000480| 62 73 6f 6c 75 74 65 20 | 70 61 74 68 6e 61 6d 65 |bsolute |pathname|
|00000490| 20 28 68 61 73 20 61 20 | 64 6f 6c 6c 61 72 29 2e | (has a |dollar).|
|000004a0| 0a 5c 65 6e 64 7b 66 75 | 6e 63 64 65 73 63 7d 0a |.\end{fu|ncdesc}.|
|000004b0| 0a 5c 62 65 67 69 6e 7b | 66 75 6e 63 64 65 73 63 |.\begin{|funcdesc|
|000004c0| 7d 7b 69 73 66 69 6c 65 | 7d 7b 70 7d 0a 52 65 74 |}{isfile|}{p}.Ret|
|000004d0| 75 72 6e 20 74 72 75 65 | 20 69 66 20 5c 76 61 72 |urn true| if \var|
|000004e0| 7b 70 7d 20 69 73 20 61 | 6e 20 65 78 69 73 74 69 |{p} is a|n existi|
|000004f0| 6e 67 20 66 69 6c 65 2e | 20 20 54 68 69 73 20 69 |ng file.|  This i|
|00000500| 6e 63 6c 75 64 65 73 20 | 69 6d 61 67 65 20 66 69 |ncludes |image fi|
|00000510| 6c 65 73 2e 0a 5c 65 6e | 64 7b 66 75 6e 63 64 65 |les..\en|d{funcde|
|00000520| 73 63 7d 0a 0a 5c 62 65 | 67 69 6e 7b 66 75 6e 63 |sc}..\be|gin{func|
|00000530| 64 65 73 63 7d 7b 69 73 | 64 69 72 7d 7b 70 7d 0a |desc}{is|dir}{p}.|
|00000540| 52 65 74 75 72 6e 20 74 | 72 75 65 20 69 66 20 5c |Return t|rue if \|
|00000550| 76 61 72 7b 70 7d 20 69 | 73 20 61 6e 20 65 78 69 |var{p} i|s an exi|
|00000560| 73 74 69 6e 67 20 64 69 | 72 65 63 74 6f 72 79 2e |sting di|rectory.|
|00000570| 20 54 68 69 73 20 69 6e | 63 6c 75 64 65 73 20 69 | This in|cludes i|
|00000580| 6d 61 67 65 20 66 69 6c | 65 73 2e 0a 5c 65 6e 64 |mage fil|es..\end|
|00000590| 7b 66 75 6e 63 64 65 73 | 63 7d 0a 0a 5c 62 65 67 |{funcdes|c}..\beg|
|000005a0| 69 6e 7b 66 75 6e 63 64 | 65 73 63 7d 7b 69 73 6c |in{funcd|esc}{isl|
|000005b0| 69 6e 6b 7d 7b 70 7d 0a | 41 6c 77 61 79 73 20 72 |ink}{p}.|Always r|
|000005c0| 65 74 75 72 6e 73 20 66 | 61 6c 73 65 2e 0a 5c 65 |eturns f|alse..\e|
|000005d0| 6e 64 7b 66 75 6e 63 64 | 65 73 63 7d 0a 0a 0a 5c |nd{funcd|esc}...\|
|000005e0| 62 65 67 69 6e 7b 66 75 | 6e 63 64 65 73 63 7d 7b |begin{fu|ncdesc}{|
|000005f0| 6a 6f 69 6e 7d 7b 70 5c | 2c 20 71 7d 0a 4a 6f 69 |join}{p\|, q}.Joi|
|00000600| 6e 20 74 68 65 20 70 61 | 74 68 73 0a 5c 76 61 72 |n the pa|ths.\var|
|00000610| 7b 70 7d 0a 61 6e 64 0a | 5c 76 61 72 7b 71 7d 20 |{p}.and.|\var{q} |
|00000620| 69 6e 74 65 6c 6c 69 67 | 65 6e 74 6c 79 3a 0a 49 |intellig|ently:.I|
|00000630| 66 0a 5c 76 61 72 7b 71 | 7d 0a 69 73 20 61 6e 20 |f.\var{q|}.is an |
|00000640| 61 62 73 6f 6c 75 74 65 | 20 70 61 74 68 2c 20 74 |absolute| path, t|
|00000650| 68 65 20 72 65 74 75 72 | 6e 20 76 61 6c 75 65 20 |he retur|n value |
|00000660| 69 73 0a 5c 76 61 72 7b | 71 7d 2e 0a 4f 74 68 65 |is.\var{|q}..Othe|
|00000670| 72 77 69 73 65 2c 20 74 | 68 65 20 63 6f 6e 63 61 |rwise, t|he conca|
|00000680| 74 65 6e 61 74 69 6f 6e | 20 6f 66 0a 5c 76 61 72 |tenation| of.\var|
|00000690| 7b 70 7d 0a 61 6e 64 0a | 5c 76 61 72 7b 71 7d 0a |{p}.and.|\var{q}.|
|000006a0| 69 73 20 72 65 74 75 72 | 6e 65 64 2c 20 77 69 74 |is retur|ned, wit|
|000006b0| 68 20 61 20 66 75 6c 6c | 20 73 74 6f 70 20 28 5c |h a full| stop (\|
|000006c0| 63 6f 64 65 7b 27 2e 27 | 7d 29 20 69 6e 73 65 72 |code{'.'|}) inser|
|000006d0| 74 65 64 20 75 6e 6c 65 | 73 73 0a 5c 76 61 72 7b |ted unle|ss.\var{|
|000006e0| 70 7d 0a 69 73 20 65 6d | 70 74 79 20 6f 72 20 65 |p}.is em|pty or e|
|000006f0| 6e 64 73 20 69 6e 20 61 | 20 73 6c 61 73 68 2e 0a |nds in a| slash..|
|00000700| 5c 65 6e 64 7b 66 75 6e | 63 64 65 73 63 7d 0a 0a |\end{fun|cdesc}..|
|00000710| 5c 62 65 67 69 6e 7b 66 | 75 6e 63 64 65 73 63 7d |\begin{f|uncdesc}|
|00000720| 7b 6e 6f 72 6d 63 61 73 | 65 7d 7b 70 7d 0a 4e 6f |{normcas|e}{p}.No|
|00000730| 72 6d 61 6c 69 7a 65 20 | 74 68 65 20 63 61 73 65 |rmalize |the case|
|00000740| 20 6f 66 20 61 20 70 61 | 74 68 6e 61 6d 65 2e 20 | of a pa|thname. |
|00000750| 20 54 68 69 73 20 63 6f | 6e 76 65 72 74 73 20 75 | This co|nverts u|
|00000760| 70 70 65 72 20 63 61 73 | 65 20 74 6f 0a 6c 6f 77 |pper cas|e to.low|
|00000770| 65 72 20 63 61 73 65 2e | 0a 5c 65 6e 64 7b 66 75 |er case.|.\end{fu|
|00000780| 6e 63 64 65 73 63 7d 0a | 0a 5c 62 65 67 69 6e 7b |ncdesc}.|.\begin{|
|00000790| 66 75 6e 63 64 65 73 63 | 7d 7b 73 70 6c 69 74 7d |funcdesc|}{split}|
|000007a0| 7b 70 7d 0a 53 70 6c 69 | 74 20 74 68 65 20 70 61 |{p}.Spli|t the pa|
|000007b0| 74 68 6e 61 6d 65 20 5c | 76 61 72 7b 70 7d 20 69 |thname \|var{p} i|
|000007c0| 6e 20 61 20 70 61 69 72 | 20 5c 63 6f 64 65 7b 28 |n a pair| \code{(|
|000007d0| 5c 76 61 72 7b 68 65 61 | 64 7d 2c 20 5c 76 61 72 |\var{hea|d}, \var|
|000007e0| 7b 74 61 69 6c 7d 29 7d | 2c 0a 77 68 65 72 65 20 |{tail})}|,.where |
|000007f0| 5c 76 61 72 7b 74 61 69 | 6c 7d 20 69 73 20 74 68 |\var{tai|l} is th|
|00000800| 65 20 6c 61 73 74 20 70 | 61 74 68 6e 61 6d 65 20 |e last p|athname |
|00000810| 63 6f 6d 70 6f 6e 65 6e | 74 20 61 6e 64 20 5c 76 |componen|t and \v|
|00000820| 61 72 7b 68 65 61 64 7d | 20 69 73 0a 65 76 65 72 |ar{head}| is.ever|
|00000830| 79 74 68 69 6e 67 20 6c | 65 61 64 69 6e 67 20 75 |ything l|eading u|
|00000840| 70 20 74 6f 20 74 68 61 | 74 2e 20 20 54 68 65 20 |p to tha|t.  The |
|00000850| 5c 76 61 72 7b 74 61 69 | 6c 7d 20 70 61 72 74 20 |\var{tai|l} part |
|00000860| 77 69 6c 6c 20 6e 65 76 | 65 72 20 63 6f 6e 74 61 |will nev|er conta|
|00000870| 69 6e 0a 61 20 66 75 6c | 6c 20 73 74 6f 70 3b 20 |in.a ful|l stop; |
|00000880| 69 66 20 5c 76 61 72 7b | 70 7d 20 65 6e 64 73 20 |if \var{|p} ends |
|00000890| 69 6e 20 61 20 66 75 6c | 6c 20 73 74 6f 70 2c 20 |in a ful|l stop, |
|000008a0| 5c 76 61 72 7b 74 61 69 | 6c 7d 20 77 69 6c 6c 20 |\var{tai|l} will |
|000008b0| 62 65 20 65 6d 70 74 79 | 2e 20 20 49 66 0a 74 68 |be empty|.  If.th|
|000008c0| 65 72 65 20 69 73 20 6e | 6f 20 66 75 6c 6c 20 73 |ere is n|o full s|
|000008d0| 74 6f 70 20 69 6e 20 5c | 76 61 72 7b 70 7d 2c 20 |top in \|var{p}, |
|000008e0| 5c 76 61 72 7b 68 65 61 | 64 7d 20 77 69 6c 6c 20 |\var{hea|d} will |
|000008f0| 62 65 20 65 6d 70 74 79 | 2e 20 20 49 66 20 5c 76 |be empty|.  If \v|
|00000900| 61 72 7b 70 7d 20 69 73 | 0a 65 6d 70 74 79 2c 20 |ar{p} is|.empty, |
|00000910| 62 6f 74 68 20 5c 76 61 | 72 7b 68 65 61 64 7d 20 |both \va|r{head} |
|00000920| 61 6e 64 20 5c 76 61 72 | 7b 74 61 69 6c 7d 20 61 |and \var|{tail} a|
|00000930| 72 65 20 65 6d 70 74 79 | 2e 20 20 54 72 61 69 6c |re empty|.  Trail|
|00000940| 69 6e 67 20 66 75 6c 6c | 20 73 74 6f 70 73 20 61 |ing full| stops a|
|00000950| 72 65 0a 73 74 72 69 70 | 70 65 64 20 66 72 6f 6d |re.strip|ped from|
|00000960| 20 5c 76 61 72 7b 68 65 | 61 64 7d 20 75 6e 6c 65 | \var{he|ad} unle|
|00000970| 73 73 20 69 74 20 69 73 | 20 74 68 65 20 72 6f 6f |ss it is| the roo|
|00000980| 74 2e 0a 20 20 49 6e 20 | 6e 65 61 72 6c 79 20 61 |t..  In |nearly a|
|00000990| 6c 6c 20 63 61 73 65 73 | 2c 20 5c 63 6f 64 65 7b |ll cases|, \code{|
|000009a0| 6a 6f 69 6e 28 5c 76 61 | 72 7b 68 65 61 64 7d 2c |join(\va|r{head},|
|000009b0| 20 5c 76 61 72 7b 74 61 | 69 6c 7d 29 7d 0a 65 71 | \var{ta|il})}.eq|
|000009c0| 75 61 6c 73 20 5c 76 61 | 72 7b 70 7d 2e 0a 5c 65 |uals \va|r{p}..\e|
|000009d0| 6e 64 7b 66 75 6e 63 64 | 65 73 63 7d 0a 0a 5c 62 |nd{funcd|esc}..\b|
|000009e0| 65 67 69 6e 7b 66 75 6e | 63 64 65 73 63 7d 7b 73 |egin{fun|cdesc}{s|
|000009f0| 70 6c 69 74 65 78 74 7d | 7b 70 7d 0a 53 70 6c 69 |plitext}|{p}.Spli|
|00000a00| 74 20 74 68 65 20 70 61 | 74 68 6e 61 6d 65 20 5c |t the pa|thname \|
|00000a10| 76 61 72 7b 70 7d 20 69 | 6e 20 61 20 70 61 69 72 |var{p} i|n a pair|
|00000a20| 20 5c 63 6f 64 65 7b 28 | 5c 76 61 72 7b 72 6f 6f | \code{(|\var{roo|
|00000a30| 74 7d 2c 20 5c 76 61 72 | 7b 65 78 74 7d 29 7d 0a |t}, \var|{ext})}.|
|00000a40| 73 75 63 68 20 74 68 61 | 74 20 5c 63 6f 64 65 7b |such tha|t \code{|
|00000a50| 5c 76 61 72 7b 72 6f 6f | 74 7d 20 2b 20 5c 76 61 |\var{roo|t} + \va|
|00000a60| 72 7b 65 78 74 7d 20 3d | 3d 20 5c 76 61 72 7b 70 |r{ext} =|= \var{p|
|00000a70| 7d 7d 2c 0a 74 68 65 20 | 6c 61 73 74 20 63 6f 6d |}},.the |last com|
|00000a80| 70 6f 6e 65 6e 74 20 6f | 66 20 5c 76 61 72 7b 72 |ponent o|f \var{r|
|00000a90| 6f 6f 74 7d 20 63 6f 6e | 74 61 69 6e 73 20 6e 6f |oot} con|tains no|
|00000aa0| 20 73 6c 61 73 68 65 73 | 73 2c 0a 61 6e 64 20 5c | slashes|s,.and \|
|00000ab0| 76 61 72 7b 65 78 74 7d | 20 69 73 20 65 6d 70 74 |var{ext}| is empt|
|00000ac0| 79 20 6f 72 20 62 65 67 | 69 6e 73 20 77 69 74 68 |y or beg|ins with|
|00000ad0| 20 61 20 73 6c 61 73 68 | 2e 0a 5c 65 6e 64 7b 66 | a slash|..\end{f|
|00000ae0| 75 6e 63 64 65 73 63 7d | 0a 0a 5c 62 65 67 69 6e |uncdesc}|..\begin|
|00000af0| 7b 66 75 6e 63 64 65 73 | 63 7d 7b 77 61 6c 6b 7d |{funcdes|c}{walk}|
|00000b00| 7b 70 5c 2c 20 76 69 73 | 69 74 5c 2c 20 61 72 67 |{p\, vis|it\, arg|
|00000b10| 7d 0a 43 61 6c 6c 73 20 | 74 68 65 20 66 75 6e 63 |}.Calls |the func|
|00000b20| 74 69 6f 6e 20 5c 76 61 | 72 7b 76 69 73 69 74 7d |tion \va|r{visit}|
|00000b30| 20 77 69 74 68 20 61 72 | 67 75 6d 65 6e 74 73 0a | with ar|guments.|
|00000b40| 5c 63 6f 64 65 7b 28 5c | 76 61 72 7b 61 72 67 7d |\code{(\|var{arg}|
|00000b50| 2c 20 5c 76 61 72 7b 64 | 69 72 6e 61 6d 65 7d 2c |, \var{d|irname},|
|00000b60| 20 5c 76 61 72 7b 6e 61 | 6d 65 73 7d 29 7d 20 66 | \var{na|mes})} f|
|00000b70| 6f 72 20 65 61 63 68 20 | 64 69 72 65 63 74 6f 72 |or each |director|
|00000b80| 79 20 69 6e 20 74 68 65 | 0a 64 69 72 65 63 74 6f |y in the|.directo|
|00000b90| 72 79 20 74 72 65 65 20 | 72 6f 6f 74 65 64 20 61 |ry tree |rooted a|
|00000ba0| 74 20 5c 76 61 72 7b 70 | 7d 20 28 69 6e 63 6c 75 |t \var{p|} (inclu|
|00000bb0| 64 69 6e 67 20 5c 76 61 | 72 7b 70 7d 20 69 74 73 |ding \va|r{p} its|
|00000bc0| 65 6c 66 2c 20 69 66 20 | 69 74 20 69 73 20 61 0a |elf, if |it is a.|
|00000bd0| 64 69 72 65 63 74 6f 72 | 79 29 2e 20 20 54 68 65 |director|y).  The|
|00000be0| 20 61 72 67 75 6d 65 6e | 74 20 5c 76 61 72 7b 64 | argumen|t \var{d|
|00000bf0| 69 72 6e 61 6d 65 7d 20 | 73 70 65 63 69 66 69 65 |irname} |specifie|
|00000c00| 73 20 74 68 65 20 76 69 | 73 69 74 65 64 20 64 69 |s the vi|sited di|
|00000c10| 72 65 63 74 6f 72 79 2c | 0a 74 68 65 20 61 72 67 |rectory,|.the arg|
|00000c20| 75 6d 65 6e 74 20 5c 76 | 61 72 7b 6e 61 6d 65 73 |ument \v|ar{names|
|00000c30| 7d 20 6c 69 73 74 73 20 | 74 68 65 20 66 69 6c 65 |} lists |the file|
|00000c40| 73 20 69 6e 20 74 68 65 | 20 64 69 72 65 63 74 6f |s in the| directo|
|00000c50| 72 79 20 28 67 6f 74 74 | 65 6e 20 66 72 6f 6d 0a |ry (gott|en from.|
|00000c60| 5c 63 6f 64 65 7b 72 69 | 73 63 6f 73 2e 6c 69 73 |\code{ri|scos.lis|
|00000c70| 74 64 69 72 28 5c 76 61 | 72 7b 64 69 72 6e 61 6d |tdir(\va|r{dirnam|
|00000c80| 65 7d 29 7d 2e 0a 20 20 | 54 68 65 20 5c 76 61 72 |e})}..  |The \var|
|00000c90| 7b 76 69 73 69 74 7d 20 | 66 75 6e 63 74 69 6f 6e |{visit} |function|
|00000ca0| 20 6d 61 79 20 6d 6f 64 | 69 66 79 20 5c 76 61 72 | may mod|ify \var|
|00000cb0| 7b 6e 61 6d 65 73 7d 20 | 74 6f 0a 69 6e 66 6c 75 |{names} |to.influ|
|00000cc0| 65 6e 63 65 20 74 68 65 | 20 73 65 74 20 6f 66 20 |ence the| set of |
|00000cd0| 64 69 72 65 63 74 6f 72 | 69 65 73 20 76 69 73 69 |director|ies visi|
|00000ce0| 74 65 64 20 62 65 6c 6f | 77 20 5c 76 61 72 7b 64 |ted belo|w \var{d|
|00000cf0| 69 72 6e 61 6d 65 7d 2c | 20 65 2e 67 2e 2c 20 74 |irname},| e.g., t|
|00000d00| 6f 0a 61 76 6f 69 64 20 | 76 69 73 69 74 69 6e 67 |o.avoid |visiting|
|00000d10| 20 63 65 72 74 61 69 6e | 20 70 61 72 74 73 20 6f | certain| parts o|
|00000d20| 66 20 74 68 65 20 74 72 | 65 65 2e 20 20 28 54 68 |f the tr|ee.  (Th|
|00000d30| 65 20 6f 62 6a 65 63 74 | 20 72 65 66 65 72 72 65 |e object| referre|
|00000d40| 64 20 74 6f 20 62 79 0a | 5c 76 61 72 7b 6e 61 6d |d to by.|\var{nam|
|00000d50| 65 73 7d 20 6d 75 73 74 | 20 62 65 20 6d 6f 64 69 |es} must| be modi|
|00000d60| 66 69 65 64 20 69 6e 20 | 70 6c 61 63 65 2c 20 75 |fied in |place, u|
|00000d70| 73 69 6e 67 20 5c 63 6f | 64 65 7b 64 65 6c 7d 20 |sing \co|de{del} |
|00000d80| 6f 72 20 73 6c 69 63 65 | 0a 61 73 73 69 67 6e 6d |or slice|.assignm|
|00000d90| 65 6e 74 2e 29 0a 5c 65 | 6e 64 7b 66 75 6e 63 64 |ent.).\e|nd{funcd|
|00000da0| 65 73 63 7d 0a          |                         |esc}.   |        |
+--------+-------------------------+-------------------------+--------+--------+