00000000
00000018
00000030
00000048
00000060
00000078
00000090
000000A8
000000C0
000000D8
000000F0
00000108
00000120
00000138
00000150
00000168
00000180
00000198
000001B0
000001C8
000001E0
000001F8
00000210
00000228
00000240
00000258
00000270
00000288
000002A0
000002B8
000002D0
000002E8
00000300
00000318
00000330
00000348
00000360
00000378
00000390
000003A8
000003C0
000003D8
000003F0
00000408
00000420
00000438
00000450
00000468
00000480
00000498
000004B0
000004C8
000004E0
000004F8
00000510
00000528
00000540
00000558
00000570
00000588
000005A0
000005B8
000005D0
000005E8
00000600
00000618
00000630
00000648
00000660
00000678
00000690
000006A8
000006C0
000006D8
000006F0
00000708
00000720
00000738
00000750
00000768
00000780
00000798
000007B0
000007C8
000007E0
000007F8
00000810
00000828
00000840
00000858
00000870
00000888
000008A0
000008B8
000008D0
000008E8
00000900
00000918
00000930
00000948
00000960
00000978
00000990
000009A8
000009C0
000009D8
000009F0
00000A08
00000A20
00000A38
00000A50
00000A68
00000A80
00000A98
00000AB0
00000AC8
00000AE0
00000AF8
00000B10
00000B28
00000B40
00000B58
00000B70
00000B88
00000BA0
00000BB8
00000BD0
00000BE8
00000C00
00000C18
00000C30
00000C48
00000C60
00000C78
00000C90
00000CA8
00000CC0
00000CD8
00000CF0
00000D08
00000D20
00000D38
00000D50
00000D68
00000D80
00000D98
00000DB0
00000DC8
00000DE0
00000DF8
00000E10
00000E28
00000E40
00000E58
00000E70
00000E88
00000EA0
00000EB8
00000ED0
00000EE8
00000F00
00000F18
00000F30
00000F48
00000F60
00000F78
00000F90
00000FA8
00000FC0
00000FD8
00000FF0
00001008
00001020
00001038
00001050
00001068
00001080
00001098
000010B0
000010C8
000010E0
000010F8
00001110
00001128
00001140
00001158
00001170
00001188
000011A0
000011B8
000011D0
000011E8
00001200
00001218
00001230
00001248
00001260
00001278
00001290
000012A8
000012C0
000012D8
000012F0
00001308
00001320
00001338
00001350
00001368
00001380
00001398
000013B0
000013C8
000013E0
000013F8
00001410
00001428
00001440
00001458
00001470
00001488
000014A0
000014B8
000014D0
000014E8
00001500
00001518
00001530
00001548
00001560
00001578
00001590
000015A8
000015C0
000015D8
000015F0
00001608
00001620
00001638
00001650
00001668
00001680
00001698
000016B0
000016C8
000016E0
000016F8
00001710
00001728
00001740
00001758
00001770
00001788
000017A0
000017B8
000017D0
000017E8
00001800
00001818
00001830
00001848
00001860
00001878
00001890
000018A8
000018C0
000018D8
000018F0
00001908
00001920
00001938
00001950
00001968
00001980
00001998
000019B0
000019C8
000019E0
000019F8
00001A10
00001A28
00001A40
00001A58
00001A70
00001A88
00001AA0
00001AB8
00001AD0
00001AE8
00001B00
00001B18
00001B30
00001B48
00001B60
00001B78
00001B90
00001BA8
00001BC0
00001BD8
00001BF0
00001C08
00001C20
00001C38
00001C50
00001C68
00001C80
00001C98
00001CB0
00001CC8
00001CE0
00001CF8
00001D10
00001D28
00001D40
00001D58
00001D70
00001D88
00001DA0
00001DB8
00001DD0
00001DE8
00001E00
00001E18
00001E30
00001E48
00001E60
00001E78
00001E90
00001EA8
00001EC0
00001ED8
00001EF0
00001F08
00001F20
00001F38
00001F50
00001F68
00001F80
00001F98
00001FB0
00001FC8
00001FE0
00001FF8
00002010
00002028
00002040
00002058
00002070
00002088
000020A0
000020B8
000020D0
000020E8
00002100
00002118
00002130
00002148
00002160
00002178
00002190
000021A8
000021C0
000021D8
000021F0
00002208
00002220
00002238
00002250
00002268
00002280
00002298
000022B0
000022C8
000022E0
000022F8
00002310
00002328
00002340
00002358
00002370
00002388
000023A0
000023B8
000023D0
000023E8
00002400
00002418
00002430
00002448
00002460
00002478
00002490
000024A8
000024C0
000024D8
000024F0
00002508
00002520
00002538
00002550
00002568
00002580
00002598
000025B0
000025C8
000025E0
000025F8
00002610
00002628
00002640
00002658
00002670
00002688
000026A0
000026B8
000026D0
000026E8
00002700
00002718
00002730
00002748
00002760
00002778
00002790
000027A8
000027C0
000027D8
000027F0
00002808
00002820
00002838
00002850
00002868
00002880
00002898
000028B0
000028C8
000028E0
000028F8
00002910
00002928
00002940
00002958
00002970
00002988
000029A0
000029B8
000029D0
000029E8
00002A00
00002A18
00002A30
00002A48
00002A60
00002A78
00002A90
00002AA8
00002AC0
00002AD8
00002AF0
00002B08
00002B20
00002B38
00002B50
00002B68
00002B80
00002B98
00002BB0
00002BC8
00002BE0
00002BF8
00002C10
00002C28
00002C40
00002C58
00002C70
00002C88
00002CA0
00002CB8
00002CD0
00002CE8
00002D00
00002D18
00002D30
00002D48
00002D60
00002D78
00002D90
00002DA8
00002DC0
00002DD8
00002DF0
00002E08
00002E20
00002E38
00002E50
00002E68
00002E80
00002E98
00002EB0
00002EC8
00002EE0
00002EF8
00002F10
00002F28
00002F40
00002F58
00002F70
00002F88
00002FA0
00002FB8
00002FD0
00002FE8
00003000
00003018
00003030
00003048
00003060
00003078
00003090
000030A8
000030C0
000030D8
000030F0
00003108
00003120
00003138
00003150
00003168
00003180
00003198
000031B0
000031C8
000031E0
000031F8
00003210
00003228
00003240
00003258
00003270
00003288
000032A0
000032B8
000032D0
000032E8
00003300
00003318
00003330
00003348
00003360
00003378
00003390
000033A8
000033C0
000033D8
000033F0
00003408
00003420
00003438
00003450
00003468
00003480
00003498
000034B0
000034C8
000034E0
000034F8
00003510
00003528
00003540
00003558
00003570
00003588
000035A0
000035B8
000035D0
000035E8
00003600
00003618
00003630
00003648
00003660
00003678
00003690
000036A8
000036C0
000036D8
000036F0
00003708
00003720
00003738
00003750
00003768
00003780
00003798
000037B0
000037C8
000037E0
000037F8
00003810
00003828
00003840
00003858
00003870
00003888
000038A0
000038B8
000038D0
000038E8
00003900
00003918
00003930
00003948
00003960
00003978
00003990
000039A8
000039C0
000039D8
000039F0
00003A08
00003A20
00003A38
00003A50
00003A68
00003A80
00003A98
00003AB0
00003AC8
00003AE0
00003AF8
00003B10
00003B28
00003B40
00003B58
00003B70
00003B88
00003BA0
00003BB8
00003BD0
00003BE8
00003C00
00003C18
00003C30
00003C48
00003C60
00003C78
00003C90
00003CA8
00003CC0
00003CD8
00003CF0
00003D08
00003D20
00003D38
00003D50
00003D68
00003D80
00003D98
00003DB0
00003DC8
00003DE0
00003DF8
00003E10
00003E28
00003E40
00003E58
00003E70
00003E88
00003EA0
00003EB8
00003ED0
00003EE8
00003F00
00003F18
00003F30
00003F48
00003F60
00003F78
00003F90
00003FA8
00003FC0
00003FD8
00003FF0
00004008
00004020
00004038
00004050
00004068
00004080
00004098
000040B0
000040C8
000040E0
000040F8
00004110
00004128
00004140
00004158
00004170
00004188
000041A0
000041B8
000041D0
000041E8
00004200
00004218
00004230
00004248
00004260
00004278
00004290
000042A8
000042C0
000042D8
000042F0
00004308
00004320
00004338
00004350
00004368
00004380
00004398
000043B0
000043C8
000043E0
000043F8
00004410
00004428
00004440
00004458
00004470
00004488
000044A0
000044B8
000044D0
000044E8
00004500
00004518
00004530
00004548
00004560
00004578
00004590
000045A8
000045C0
000045D8
000045F0
00004608
00004620
00004638
00004650
00004668
00004680
00004698
000046B0
000046C8
000046E0
000046F8
00004710
00004728
00004740
00004758
00004770
00004788
000047A0
000047B8
000047D0
000047E8
00004800
00004818
00004830
00004848
00004860
00004878
00004890
000048A8
000048C0
000048D8
000048F0
00004908
00004920
00004938
00004950
00004968
00004980
00004998
000049B0
000049C8
000049E0
000049F8
00004A10
00004A28
00004A40
00004A58
00004A70
00004A88
00004AA0
00004AB8
00004AD0
00004AE8
00004B00
00004B18
00004B30
00004B48
00004B60
00004B78
00004B90
00004BA8
00004BC0
00004BD8
00004BF0
00004C08
00004C20
00004C38
00004C50
| 23 21 2F 75 73 72 2F 62 69 6E 2F 70 65 72 6C 0A 20 20 20 20 65 76 61 6C
20 27 65 78 65 63 20 2F 75 73 72 2F 62 69 6E 2F 70 65 72 6C 20 2D 53 20
24 30 20 24 7B 31 2B 22 24 40 22 7D 27 0A 20 20 20 20 20 20 20 20 69 66
20 24 72 75 6E 6E 69 6E 67 5F 75 6E 64 65 72 5F 73 6F 6D 65 5F 73 68 65
6C 6C 3B 0A 0A 23 20 70 6F 64 32 6D 61 6E 20 2D 2D 20 43 6F 6E 76 65 72
74 20 50 4F 44 20 64 61 74 61 20 74 6F 20 66 6F 72 6D 61 74 74 65 64 20
2A 72 6F 66 66 20 69 6E 70 75 74 2E 0A 23 20 24 49 64 3A 20 70 6F 64 32
6D 61 6E 2E 50 4C 2C 76 20 31 2E 31 30 20 32 30 30 32 2F 30 37 2F 31 35
20 30 35 3A 34 35 3A 35 36 20 65 61 67 6C 65 20 45 78 70 20 24 0A 23 0A
23 20 43 6F 70 79 72 69 67 68 74 20 31 39 39 39 2C 20 32 30 30 30 2C 20
32 30 30 31 20 62 79 20 52 75 73 73 20 41 6C 6C 62 65 72 79 20 3C 72 72
61 40 73 74 61 6E 66 6F 72 64 2E 65 64 75 3E 0A 23 0A 23 20 54 68 69 73
20 70 72 6F 67 72 61 6D 20 69 73 20 66 72 65 65 20 73 6F 66 74 77 61 72
65 3B 20 79 6F 75 20 6D 61 79 20 72 65 64 69 73 74 72 69 62 75 74 65 20
69 74 20 61 6E 64 2F 6F 72 20 6D 6F 64 69 66 79 20 69 74 0A 23 20 75 6E
64 65 72 20 74 68 65 20 73 61 6D 65 20 74 65 72 6D 73 20 61 73 20 50 65
72 6C 20 69 74 73 65 6C 66 2E 0A 0A 72 65 71 75 69 72 65 20 35 2E 30 30
34 3B 0A 0A 75 73 65 20 47 65 74 6F 70 74 3A 3A 4C 6F 6E 67 20 71 77 28
47 65 74 4F 70 74 69 6F 6E 73 29 3B 0A 75 73 65 20 50 6F 64 3A 3A 4D 61
6E 20 28 29 3B 0A 75 73 65 20 50 6F 64 3A 3A 55 73 61 67 65 20 71 77 28
70 6F 64 32 75 73 61 67 65 29 3B 0A 0A 75 73 65 20 73 74 72 69 63 74 3B
0A 0A 23 20 53 69 6C 65 6E 63 65 20 2D 77 20 77 61 72 6E 69 6E 67 73 2E
0A 75 73 65 20 76 61 72 73 20 71 77 28 24 72 75 6E 6E 69 6E 67 5F 75 6E
64 65 72 5F 73 6F 6D 65 5F 73 68 65 6C 6C 29 3B 0A 0A 23 20 49 6E 73 65
72 74 20 2D 2D 20 69 6E 74 6F 20 40 41 52 47 56 20 62 65 66 6F 72 65 20
61 6E 79 20 73 69 6E 67 6C 65 20 64 61 73 68 20 61 72 67 75 6D 65 6E 74
20 74 6F 20 68 69 64 65 20 69 74 20 66 72 6F 6D 0A 23 20 47 65 74 6F 70
74 3A 3A 4C 6F 6E 67 3B 20 77 65 20 77 61 6E 74 20 74 6F 20 69 6E 74 65
72 70 72 65 74 20 69 74 20 61 73 20 6D 65 61 6E 69 6E 67 20 73 74 64 69
6E 20 28 77 68 69 63 68 20 50 6F 64 3A 3A 50 61 72 73 65 72 0A 23 20 64
6F 65 73 20 63 6F 72 72 65 63 74 6C 79 29 2E 0A 6D 79 20 24 73 74 64 69
6E 3B 0A 40 41 52 47 56 20 3D 20 6D 61 70 20 7B 20 24 5F 20 65 71 20 27
2D 27 20 26 26 20 21 24 73 74 64 69 6E 2B 2B 20 3F 20 28 27 2D 2D 27 2C
20 24 5F 29 20 3A 20 24 5F 20 7D 20 40 41 52 47 56 3B 0A 0A 23 20 50 61
72 73 65 20 6F 75 72 20 6F 70 74 69 6F 6E 73 2C 20 74 72 79 69 6E 67 20
74 6F 20 72 65 74 61 69 6E 20 62 61 63 6B 77 61 72 64 73 20 63 6F 6D 70
61 74 69 62 69 6C 69 74 79 20 77 69 74 68 20 70 6F 64 32 6D 61 6E 20 62
75 74 0A 23 20 61 6C 6C 6F 77 69 6E 67 20 73 68 6F 72 74 20 66 6F 72 6D
73 20 61 73 20 77 65 6C 6C 2E 20 20 2D 2D 6C 61 78 20 69 73 20 63 75 72
72 65 6E 74 6C 79 20 69 67 6E 6F 72 65 64 2E 0A 6D 79 20 25 6F 70 74 69
6F 6E 73 3B 0A 47 65 74 6F 70 74 3A 3A 4C 6F 6E 67 3A 3A 63 6F 6E 66 69
67 20 28 27 62 75 6E 64 6C 69 6E 67 5F 6F 76 65 72 72 69 64 65 27 29 3B
0A 47 65 74 4F 70 74 69 6F 6E 73 20 28 5C 25 6F 70 74 69 6F 6E 73 2C 20
27 73 65 63 74 69 6F 6E 7C 73 3D 73 27 2C 20 27 72 65 6C 65 61 73 65 7C
72 3A 73 27 2C 20 27 63 65 6E 74 65 72 7C 63 3D 73 27 2C 0A 20 20 20 20
20 20 20 20 20 20 20 20 27 64 61 74 65 7C 64 3D 73 27 2C 20 27 66 69 78
65 64 3D 73 27 2C 20 27 66 69 78 65 64 62 6F 6C 64 3D 73 27 2C 20 27 66
69 78 65 64 69 74 61 6C 69 63 3D 73 27 2C 0A 20 20 20 20 20 20 20 20 20
20 20 20 27 66 69 78 65 64 62 6F 6C 64 69 74 61 6C 69 63 3D 73 27 2C 20
27 6E 61 6D 65 7C 6E 3D 73 27 2C 20 27 6F 66 66 69 63 69 61 6C 7C 6F 27
2C 20 27 71 75 6F 74 65 73 7C 71 3D 73 27 2C 0A 20 20 20 20 20 20 20 20
20 20 20 20 27 6C 61 78 7C 6C 27 2C 20 27 68 65 6C 70 7C 68 27 2C 20 27
76 65 72 62 6F 73 65 7C 76 27 29 20 6F 72 20 65 78 69 74 20 31 3B 0A 70
6F 64 32 75 73 61 67 65 20 28 30 29 20 69 66 20 24 6F 70 74 69 6F 6E 73
7B 68 65 6C 70 7D 3B 0A 0A 23 20 4F 66 66 69 63 69 61 6C 20 73 65 74 73
20 2D 2D 63 65 6E 74 65 72 2C 20 62 75 74 20 64 6F 6E 27 74 20 6F 76 65
72 72 69 64 65 20 74 68 69 6E 67 73 20 65 78 70 6C 69 63 69 74 6C 79 20
73 65 74 2E 0A 69 66 20 28 24 6F 70 74 69 6F 6E 73 7B 6F 66 66 69 63 69
61 6C 7D 20 26 26 20 21 64 65 66 69 6E 65 64 20 24 6F 70 74 69 6F 6E 73
7B 63 65 6E 74 65 72 7D 29 20 7B 0A 20 20 20 20 24 6F 70 74 69 6F 6E 73
7B 63 65 6E 74 65 72 7D 20 3D 20 27 50 65 72 6C 20 50 72 6F 67 72 61 6D
6D 65 72 73 20 52 65 66 65 72 65 6E 63 65 20 47 75 69 64 65 27 3B 0A 7D
0A 0A 23 20 56 65 72 62 6F 73 65 20 69 73 20 6F 6E 6C 79 20 6F 75 72 20
66 6C 61 67 2C 20 6E 6F 74 20 61 20 50 6F 64 3A 3A 4D 61 6E 20 66 6C 61
67 2E 0A 6D 79 20 24 76 65 72 62 6F 73 65 20 3D 20 24 6F 70 74 69 6F 6E
73 7B 76 65 72 62 6F 73 65 7D 3B 0A 64 65 6C 65 74 65 20 24 6F 70 74 69
6F 6E 73 7B 76 65 72 62 6F 73 65 7D 3B 0A 0A 23 20 54 68 69 73 20 69 73
6E 27 74 20 61 20 76 61 6C 69 64 20 50 6F 64 3A 3A 4D 61 6E 20 6F 70 74
69 6F 6E 20 61 6E 64 20 69 73 20 6F 6E 6C 79 20 61 63 63 65 70 74 65 64
20 66 6F 72 20 62 61 63 6B 77 61 72 64 73 0A 23 20 63 6F 6D 70 61 74 69
62 69 6C 69 74 79 2E 0A 64 65 6C 65 74 65 20 24 6F 70 74 69 6F 6E 73 7B
6C 61 78 7D 3B 0A 0A 23 20 49 6E 69 74 69 61 6C 69 7A 65 20 61 6E 64 20
72 75 6E 20 74 68 65 20 66 6F 72 6D 61 74 74 65 72 2C 20 70 75 6C 6C 69
6E 67 20 61 20 70 61 69 72 20 6F 66 20 69 6E 70 75 74 20 61 6E 64 20 6F
75 74 70 75 74 20 6F 66 66 20 61 74 0A 23 20 61 20 74 69 6D 65 2E 0A 6D
79 20 24 70 61 72 73 65 72 20 3D 20 50 6F 64 3A 3A 4D 61 6E 2D 3E 6E 65
77 20 28 25 6F 70 74 69 6F 6E 73 29 3B 0A 6D 79 20 40 66 69 6C 65 73 3B
0A 64 6F 20 7B 0A 20 20 20 20 40 66 69 6C 65 73 20 3D 20 73 70 6C 69 63
65 20 28 40 41 52 47 56 2C 20 30 2C 20 32 29 3B 0A 20 20 20 20 70 72 69
6E 74 20 22 20 20 24 66 69 6C 65 73 5B 31 5D 5C 6E 22 20 69 66 20 24 76
65 72 62 6F 73 65 3B 0A 20 20 20 20 24 70 61 72 73 65 72 2D 3E 70 61 72
73 65 5F 66 72 6F 6D 5F 66 69 6C 65 20 28 40 66 69 6C 65 73 29 3B 0A 7D
20 77 68 69 6C 65 20 28 40 41 52 47 56 29 3B 0A 0A 5F 5F 45 4E 44 5F 5F
0A 0A 3D 68 65 61 64 31 20 4E 41 4D 45 0A 0A 70 6F 64 32 6D 61 6E 20 2D
20 43 6F 6E 76 65 72 74 20 50 4F 44 20 64 61 74 61 20 74 6F 20 66 6F 72
6D 61 74 74 65 64 20 2A 72 6F 66 66 20 69 6E 70 75 74 0A 0A 3D 68 65 61
64 31 20 53 59 4E 4F 50 53 49 53 0A 0A 70 6F 64 32 6D 61 6E 20 5B 42 3C
2D 2D 73 65 63 74 69 6F 6E 3E 3D 49 3C 6D 61 6E 65 78 74 3E 5D 20 5B 42
3C 2D 2D 72 65 6C 65 61 73 65 3E 3D 49 3C 76 65 72 73 69 6F 6E 3E 5D 0A
5B 42 3C 2D 2D 63 65 6E 74 65 72 3E 3D 49 3C 73 74 72 69 6E 67 3E 5D 20
5B 42 3C 2D 2D 64 61 74 65 3E 3D 49 3C 73 74 72 69 6E 67 3E 5D 20 5B 42
3C 2D 2D 66 69 78 65 64 3E 3D 49 3C 66 6F 6E 74 3E 5D 0A 5B 42 3C 2D 2D
66 69 78 65 64 62 6F 6C 64 3E 3D 49 3C 66 6F 6E 74 3E 5D 20 5B 42 3C 2D
2D 66 69 78 65 64 69 74 61 6C 69 63 3E 3D 49 3C 66 6F 6E 74 3E 5D 0A 5B
42 3C 2D 2D 66 69 78 65 64 62 6F 6C 64 69 74 61 6C 69 63 3E 3D 49 3C 66
6F 6E 74 3E 5D 20 5B 42 3C 2D 2D 6E 61 6D 65 3E 3D 49 3C 6E 61 6D 65 3E
5D 20 5B 42 3C 2D 2D 6F 66 66 69 63 69 61 6C 3E 5D 0A 5B 42 3C 2D 2D 6C
61 78 3E 5D 20 5B 42 3C 2D 2D 71 75 6F 74 65 73 3E 3D 49 3C 71 75 6F 74
65 73 3E 5D 20 5B 42 3C 2D 2D 76 65 72 62 6F 73 65 3E 5D 0A 5B 49 3C 69
6E 70 75 74 3E 20 5B 49 3C 6F 75 74 70 75 74 3E 5D 20 2E 2E 2E 5D 0A 0A
70 6F 64 32 6D 61 6E 20 42 3C 2D 2D 68 65 6C 70 3E 0A 0A 3D 68 65 61 64
31 20 44 45 53 43 52 49 50 54 49 4F 4E 0A 0A 42 3C 70 6F 64 32 6D 61 6E
3E 20 69 73 20 61 20 66 72 6F 6E 74 2D 65 6E 64 20 66 6F 72 20 50 6F 64
3A 3A 4D 61 6E 2C 20 75 73 69 6E 67 20 69 74 20 74 6F 20 67 65 6E 65 72
61 74 65 20 2A 72 6F 66 66 20 69 6E 70 75 74 0A 66 72 6F 6D 20 50 4F 44
20 73 6F 75 72 63 65 2E 20 20 54 68 65 20 72 65 73 75 6C 74 69 6E 67 20
2A 72 6F 66 66 20 63 6F 64 65 20 69 73 20 73 75 69 74 61 62 6C 65 20 66
6F 72 20 64 69 73 70 6C 61 79 20 6F 6E 20 61 0A 74 65 72 6D 69 6E 61 6C
20 75 73 69 6E 67 20 6E 72 6F 66 66 28 31 29 2C 20 6E 6F 72 6D 61 6C 6C
79 20 76 69 61 20 6D 61 6E 28 31 29 2C 20 6F 72 20 70 72 69 6E 74 69 6E
67 20 75 73 69 6E 67 20 74 72 6F 66 66 28 31 29 2E 0A 0A 49 3C 69 6E 70
75 74 3E 20 69 73 20 74 68 65 20 66 69 6C 65 20 74 6F 20 72 65 61 64 20
66 6F 72 20 50 4F 44 20 73 6F 75 72 63 65 20 28 74 68 65 20 50 4F 44 20
63 61 6E 20 62 65 20 65 6D 62 65 64 64 65 64 20 69 6E 0A 63 6F 64 65 29
2E 20 20 49 66 20 49 3C 69 6E 70 75 74 3E 20 69 73 6E 27 74 20 67 69 76
65 6E 2C 20 69 74 20 64 65 66 61 75 6C 74 73 20 74 6F 20 53 54 44 49 4E
2E 20 20 49 3C 6F 75 74 70 75 74 3E 2C 20 69 66 20 67 69 76 65 6E 2C 0A
69 73 20 74 68 65 20 66 69 6C 65 20 74 6F 20 77 68 69 63 68 20 74 6F 20
77 72 69 74 65 20 74 68 65 20 66 6F 72 6D 61 74 74 65 64 20 6F 75 74 70
75 74 2E 20 20 49 66 20 49 3C 6F 75 74 70 75 74 3E 20 69 73 6E 27 74 0A
67 69 76 65 6E 2C 20 74 68 65 20 66 6F 72 6D 61 74 74 65 64 20 6F 75 74
70 75 74 20 69 73 20 77 72 69 74 74 65 6E 20 74 6F 20 53 54 44 4F 55 54
2E 20 20 53 65 76 65 72 61 6C 20 50 4F 44 20 66 69 6C 65 73 20 63 61 6E
20 62 65 0A 70 72 6F 63 65 73 73 65 64 20 69 6E 20 74 68 65 20 73 61 6D
65 20 42 3C 70 6F 64 32 6D 61 6E 3E 20 69 6E 76 6F 63 61 74 69 6F 6E 20
28 73 61 76 69 6E 67 20 6D 6F 64 75 6C 65 20 6C 6F 61 64 20 61 6E 64 20
63 6F 6D 70 69 6C 65 0A 74 69 6D 65 73 29 20 62 79 20 70 72 6F 76 69 64
69 6E 67 20 6D 75 6C 74 69 70 6C 65 20 70 61 69 72 73 20 6F 66 20 49 3C
69 6E 70 75 74 3E 20 61 6E 64 20 49 3C 6F 75 74 70 75 74 3E 20 66 69 6C
65 73 20 6F 6E 20 74 68 65 0A 63 6F 6D 6D 61 6E 64 20 6C 69 6E 65 2E 0A
0A 42 3C 2D 2D 73 65 63 74 69 6F 6E 3E 2C 20 42 3C 2D 2D 72 65 6C 65 61
73 65 3E 2C 20 42 3C 2D 2D 63 65 6E 74 65 72 3E 2C 20 42 3C 2D 2D 64 61
74 65 3E 2C 20 61 6E 64 20 42 3C 2D 2D 6F 66 66 69 63 69 61 6C 3E 20 63
61 6E 20 62 65 0A 75 73 65 64 20 74 6F 20 73 65 74 20 74 68 65 20 68 65
61 64 65 72 73 20 61 6E 64 20 66 6F 6F 74 65 72 73 20 74 6F 20 75 73 65
3B 20 69 66 20 6E 6F 74 20 67 69 76 65 6E 2C 20 50 6F 64 3A 3A 4D 61 6E
20 77 69 6C 6C 0A 61 73 73 75 6D 65 20 76 61 72 69 6F 75 73 20 64 65 66
61 75 6C 74 73 2E 20 20 53 65 65 20 62 65 6C 6F 77 20 6F 72 20 4C 3C 50
6F 64 3A 3A 4D 61 6E 3E 20 66 6F 72 20 64 65 74 61 69 6C 73 2E 0A 0A 42
3C 70 6F 64 32 6D 61 6E 3E 20 61 73 73 75 6D 65 73 20 74 68 61 74 20 79
6F 75 72 20 2A 72 6F 66 66 20 66 6F 72 6D 61 74 74 65 72 73 20 68 61 76
65 20 61 20 66 69 78 65 64 2D 77 69 64 74 68 20 66 6F 6E 74 20 6E 61 6D
65 64 0A 43 57 2E 20 20 49 66 20 79 6F 75 72 73 20 69 73 20 63 61 6C 6C
65 64 20 73 6F 6D 65 74 68 69 6E 67 20 65 6C 73 65 20 28 6C 69 6B 65 20
43 52 29 2C 20 75 73 65 20 42 3C 2D 2D 66 69 78 65 64 3E 20 74 6F 20 73
70 65 63 69 66 79 0A 69 74 2E 20 20 54 68 69 73 20 67 65 6E 65 72 61 6C
6C 79 20 6F 6E 6C 79 20 6D 61 74 74 65 72 73 20 66 6F 72 20 74 72 6F 66
66 20 6F 75 74 70 75 74 20 66 6F 72 20 70 72 69 6E 74 69 6E 67 2E 20 20
53 69 6D 69 6C 61 72 6C 79 2C 0A 79 6F 75 20 63 61 6E 20 73 65 74 20 74
68 65 20 66 6F 6E 74 73 20 75 73 65 64 20 66 6F 72 20 62 6F 6C 64 2C 20
69 74 61 6C 69 63 2C 20 61 6E 64 20 62 6F 6C 64 20 69 74 61 6C 69 63 20
66 69 78 65 64 2D 77 69 64 74 68 0A 6F 75 74 70 75 74 2E 0A 0A 42 65 73
69 64 65 73 20 74 68 65 20 6F 62 76 69 6F 75 73 20 70 6F 64 20 63 6F 6E
76 65 72 73 69 6F 6E 73 2C 20 50 6F 64 3A 3A 4D 61 6E 2C 20 61 6E 64 20
74 68 65 72 65 66 6F 72 65 20 70 6F 64 32 6D 61 6E 20 61 6C 73 6F 0A 74
61 6B 65 73 20 63 61 72 65 20 6F 66 20 66 6F 72 6D 61 74 74 69 6E 67 20
66 75 6E 63 28 29 2C 20 66 75 6E 63 28 6E 29 2C 20 61 6E 64 20 73 69 6D
70 6C 65 20 76 61 72 69 61 62 6C 65 20 72 65 66 65 72 65 6E 63 65 73 0A
6C 69 6B 65 20 24 66 6F 6F 20 6F 72 20 40 62 61 72 20 73 6F 20 79 6F 75
20 64 6F 6E 27 74 20 68 61 76 65 20 74 6F 20 75 73 65 20 63 6F 64 65 20
65 73 63 61 70 65 73 20 66 6F 72 20 74 68 65 6D 3B 20 63 6F 6D 70 6C 65
78 0A 65 78 70 72 65 73 73 69 6F 6E 73 20 6C 69 6B 65 20 43 3C 24 66 72
65 64 7B 27 73 74 75 66 66 27 7D 3E 20 77 69 6C 6C 20 73 74 69 6C 6C 20
6E 65 65 64 20 74 6F 20 62 65 20 65 73 63 61 70 65 64 2C 20 74 68 6F 75
67 68 2E 0A 49 74 20 61 6C 73 6F 20 74 72 61 6E 73 6C 61 74 65 73 20 64
61 73 68 65 73 20 74 68 61 74 20 61 72 65 6E 27 74 20 75 73 65 64 20 61
73 20 68 79 70 68 65 6E 73 20 69 6E 74 6F 20 65 6E 20 64 61 73 68 65 73
2C 20 6D 61 6B 65 73 0A 6C 6F 6E 67 20 64 61 73 68 65 73 2D 2D 6C 69 6B
65 20 74 68 69 73 2D 2D 69 6E 74 6F 20 70 72 6F 70 65 72 20 65 6D 20 64
61 73 68 65 73 2C 20 66 69 78 65 73 20 22 70 61 69 72 65 64 20 71 75 6F
74 65 73 2C 22 20 61 6E 64 0A 74 61 6B 65 73 20 63 61 72 65 20 6F 66 20
73 65 76 65 72 61 6C 20 6F 74 68 65 72 20 74 72 6F 66 66 2D 73 70 65 63
69 66 69 63 20 74 77 65 61 6B 73 2E 20 20 53 65 65 20 4C 3C 50 6F 64 3A
3A 4D 61 6E 3E 20 66 6F 72 0A 63 6F 6D 70 6C 65 74 65 20 69 6E 66 6F 72
6D 61 74 69 6F 6E 2E 0A 0A 3D 68 65 61 64 31 20 4F 50 54 49 4F 4E 53 0A
0A 3D 6F 76 65 72 20 34 0A 0A 3D 69 74 65 6D 20 42 3C 2D 63 3E 20 49 3C
73 74 72 69 6E 67 3E 2C 20 42 3C 2D 2D 63 65 6E 74 65 72 3E 3D 49 3C 73
74 72 69 6E 67 3E 0A 0A 53 65 74 73 20 74 68 65 20 63 65 6E 74 65 72 65
64 20 70 61 67 65 20 68 65 61 64 65 72 20 74 6F 20 49 3C 73 74 72 69 6E
67 3E 2E 20 20 54 68 65 20 64 65 66 61 75 6C 74 20 69 73 20 22 55 73 65
72 0A 43 6F 6E 74 72 69 62 75 74 65 64 20 50 65 72 6C 20 44 6F 63 75 6D
65 6E 74 61 74 69 6F 6E 22 2C 20 62 75 74 20 61 6C 73 6F 20 73 65 65 20
42 3C 2D 2D 6F 66 66 69 63 69 61 6C 3E 20 62 65 6C 6F 77 2E 0A 0A 3D 69
74 65 6D 20 42 3C 2D 64 3E 20 49 3C 73 74 72 69 6E 67 3E 2C 20 42 3C 2D
2D 64 61 74 65 3E 3D 49 3C 73 74 72 69 6E 67 3E 0A 0A 53 65 74 20 74 68
65 20 6C 65 66 74 2D 68 61 6E 64 20 66 6F 6F 74 65 72 20 73 74 72 69 6E
67 20 74 6F 20 74 68 69 73 20 76 61 6C 75 65 2E 20 20 42 79 20 64 65 66
61 75 6C 74 2C 20 74 68 65 20 6D 6F 64 69 66 69 63 61 74 69 6F 6E 0A 64
61 74 65 20 6F 66 20 74 68 65 20 69 6E 70 75 74 20 66 69 6C 65 20 77 69
6C 6C 20 62 65 20 75 73 65 64 2C 20 6F 72 20 74 68 65 20 63 75 72 72 65
6E 74 20 64 61 74 65 20 69 66 20 69 6E 70 75 74 20 63 6F 6D 65 73 20 66
72 6F 6D 0A 53 54 44 49 4E 2E 0A 0A 3D 69 74 65 6D 20 42 3C 2D 2D 66 69
78 65 64 3E 3D 49 3C 66 6F 6E 74 3E 0A 0A 54 68 65 20 66 69 78 65 64 2D
77 69 64 74 68 20 66 6F 6E 74 20 74 6F 20 75 73 65 20 66 6F 72 20 76 65
72 74 61 62 69 6D 20 74 65 78 74 20 61 6E 64 20 63 6F 64 65 2E 20 20 44
65 66 61 75 6C 74 73 20 74 6F 20 43 57 2E 0A 53 6F 6D 65 20 73 79 73 74
65 6D 73 20 6D 61 79 20 77 61 6E 74 20 43 52 20 69 6E 73 74 65 61 64 2E
20 20 4F 6E 6C 79 20 6D 61 74 74 65 72 73 20 66 6F 72 20 74 72 6F 66 66
28 31 29 20 6F 75 74 70 75 74 2E 0A 0A 3D 69 74 65 6D 20 42 3C 2D 2D 66
69 78 65 64 62 6F 6C 64 3E 3D 49 3C 66 6F 6E 74 3E 0A 0A 42 6F 6C 64 20
76 65 72 73 69 6F 6E 20 6F 66 20 74 68 65 20 66 69 78 65 64 2D 77 69 64
74 68 20 66 6F 6E 74 2E 20 20 44 65 66 61 75 6C 74 73 20 74 6F 20 43 42
2E 20 20 4F 6E 6C 79 20 6D 61 74 74 65 72 73 20 66 6F 72 0A 74 72 6F 66
66 28 31 29 20 6F 75 74 70 75 74 2E 0A 0A 3D 69 74 65 6D 20 42 3C 2D 2D
66 69 78 65 64 69 74 61 6C 69 63 3E 3D 49 3C 66 6F 6E 74 3E 0A 0A 49 74
61 6C 69 63 20 76 65 72 73 69 6F 6E 20 6F 66 20 74 68 65 20 66 69 78 65
64 2D 77 69 64 74 68 20 66 6F 6E 74 20 28 61 63 74 75 61 6C 6C 79 2C 20
73 6F 6D 65 74 68 69 6E 67 20 6F 66 20 61 20 6D 69 73 6E 6F 6D 65 72 2C
0A 73 69 6E 63 65 20 6D 6F 73 74 20 66 69 78 65 64 2D 77 69 64 74 68 20
66 6F 6E 74 73 20 6F 6E 6C 79 20 68 61 76 65 20 61 6E 20 6F 62 6C 69 71
75 65 20 76 65 72 73 69 6F 6E 2C 20 6E 6F 74 20 61 6E 20 69 74 61 6C 69
63 0A 76 65 72 73 69 6F 6E 29 2E 20 20 44 65 66 61 75 6C 74 73 20 74 6F
20 43 49 2E 20 20 4F 6E 6C 79 20 6D 61 74 74 65 72 73 20 66 6F 72 20 74
72 6F 66 66 28 31 29 20 6F 75 74 70 75 74 2E 0A 0A 3D 69 74 65 6D 20 42
3C 2D 2D 66 69 78 65 64 62 6F 6C 64 69 74 61 6C 69 63 3E 3D 49 3C 66 6F
6E 74 3E 0A 0A 42 6F 6C 64 20 69 74 61 6C 69 63 20 28 70 72 6F 62 61 62
6C 79 20 61 63 74 75 61 6C 6C 79 20 6F 62 6C 69 71 75 65 29 20 76 65 72
73 69 6F 6E 20 6F 66 20 74 68 65 20 66 69 78 65 64 2D 77 69 64 74 68 20
66 6F 6E 74 2E 0A 50 6F 64 3A 3A 4D 61 6E 20 64 6F 65 73 6E 27 74 20 61
73 73 75 6D 65 20 79 6F 75 20 68 61 76 65 20 74 68 69 73 2C 20 61 6E 64
20 64 65 66 61 75 6C 74 73 20 74 6F 20 43 42 2E 20 20 53 6F 6D 65 20 73
79 73 74 65 6D 73 0A 28 73 75 63 68 20 61 73 20 53 6F 6C 61 72 69 73 29
20 68 61 76 65 20 74 68 69 73 20 66 6F 6E 74 20 61 76 61 69 6C 61 62 6C
65 20 61 73 20 43 58 2E 20 20 4F 6E 6C 79 20 6D 61 74 74 65 72 73 20 66
6F 72 20 74 72 6F 66 66 28 31 29 0A 6F 75 74 70 75 74 2E 0A 0A 3D 69 74
65 6D 20 42 3C 2D 68 3E 2C 20 42 3C 2D 2D 68 65 6C 70 3E 0A 0A 50 72 69
6E 74 20 6F 75 74 20 75 73 61 67 65 20 69 6E 66 6F 72 6D 61 74 69 6F 6E
2E 0A 0A 3D 69 74 65 6D 20 42 3C 2D 6C 3E 2C 20 42 3C 2D 2D 6C 61 78 3E
0A 0A 4E 6F 20 6C 6F 6E 67 65 72 20 75 73 65 64 2E 20 20 42 3C 70 6F 64
32 6D 61 6E 3E 20 75 73 65 64 20 74 6F 20 63 68 65 63 6B 20 69 74 73 20
69 6E 70 75 74 20 66 6F 72 20 76 61 6C 69 64 69 74 79 20 61 73 20 61 20
6D 61 6E 75 61 6C 0A 70 61 67 65 2C 20 62 75 74 20 74 68 69 73 20 73 68
6F 75 6C 64 20 6E 6F 77 20 62 65 20 64 6F 6E 65 20 62 79 20 4C 3C 70 6F
64 63 68 65 63 6B 65 72 28 31 29 3E 20 69 6E 73 74 65 61 64 2E 20 20 41
63 63 65 70 74 65 64 20 66 6F 72 0A 62 61 63 6B 77 61 72 64 73 20 63 6F
6D 70 61 74 69 62 69 6C 69 74 79 3B 20 74 68 69 73 20 6F 70 74 69 6F 6E
20 6E 6F 20 6C 6F 6E 67 65 72 20 64 6F 65 73 20 61 6E 79 74 68 69 6E 67
2E 0A 0A 3D 69 74 65 6D 20 42 3C 2D 6E 3E 20 49 3C 6E 61 6D 65 3E 2C 20
42 3C 2D 2D 6E 61 6D 65 3E 3D 49 3C 6E 61 6D 65 3E 0A 0A 53 65 74 20 74
68 65 20 6E 61 6D 65 20 6F 66 20 74 68 65 20 6D 61 6E 75 61 6C 20 70 61
67 65 20 74 6F 20 49 3C 6E 61 6D 65 3E 2E 20 20 57 69 74 68 6F 75 74 20
74 68 69 73 20 6F 70 74 69 6F 6E 2C 20 74 68 65 20 6D 61 6E 75 61 6C 0A
6E 61 6D 65 20 69 73 20 73 65 74 20 74 6F 20 74 68 65 20 75 70 70 65 72
63 61 73 65 64 20 62 61 73 65 20 6E 61 6D 65 20 6F 66 20 74 68 65 20 66
69 6C 65 20 62 65 69 6E 67 20 63 6F 6E 76 65 72 74 65 64 20 75 6E 6C 65
73 73 0A 74 68 65 20 6D 61 6E 75 61 6C 20 73 65 63 74 69 6F 6E 20 69 73
20 33 2C 20 69 6E 20 77 68 69 63 68 20 63 61 73 65 20 74 68 65 20 70 61
74 68 20 69 73 20 70 61 72 73 65 64 20 74 6F 20 73 65 65 20 69 66 20 69
74 20 69 73 20 61 0A 50 65 72 6C 20 6D 6F 64 75 6C 65 20 70 61 74 68 2E
20 20 49 66 20 69 74 20 69 73 2C 20 61 20 70 61 74 68 20 6C 69 6B 65 20
43 3C 2E 2E 2E 2F 6C 69 62 2F 50 6F 64 2F 4D 61 6E 2E 70 6D 3E 20 69 73
20 63 6F 6E 76 65 72 74 65 64 0A 69 6E 74 6F 20 61 20 6E 61 6D 65 20 6C
69 6B 65 20 43 3C 50 6F 64 3A 3A 4D 61 6E 3E 2E 20 20 54 68 69 73 20 6F
70 74 69 6F 6E 2C 20 69 66 20 67 69 76 65 6E 2C 20 6F 76 65 72 72 69 64
65 73 20 61 6E 79 0A 61 75 74 6F 6D 61 74 69 63 20 64 65 74 65 72 6D 69
6E 61 74 69 6F 6E 20 6F 66 20 74 68 65 20 6E 61 6D 65 2E 0A 0A 4E 6F 74
65 20 74 68 61 74 20 74 68 69 73 20 6F 70 74 69 6F 6E 20 69 73 20 70 72
6F 62 61 62 6C 79 20 6E 6F 74 20 75 73 65 66 75 6C 20 77 68 65 6E 20 63
6F 6E 76 65 72 74 69 6E 67 20 6D 75 6C 74 69 70 6C 65 20 50 4F 44 0A 66
69 6C 65 73 20 61 74 20 6F 6E 63 65 2E 20 20 54 68 65 20 63 6F 6E 76 65
6E 74 69 6F 6E 20 66 6F 72 20 55 6E 69 78 20 6D 61 6E 20 70 61 67 65 73
20 66 6F 72 20 63 6F 6D 6D 61 6E 64 73 20 69 73 20 66 6F 72 20 74 68 65
0A 6D 61 6E 20 70 61 67 65 20 74 69 74 6C 65 20 74 6F 20 62 65 20 69 6E
20 61 6C 6C 2D 75 70 70 65 72 63 61 73 65 20 65 76 65 6E 20 69 66 20 74
68 65 20 63 6F 6D 6D 61 6E 64 20 69 73 6E 27 74 2E 0A 0A 3D 69 74 65 6D
20 42 3C 2D 6F 3E 2C 20 42 3C 2D 2D 6F 66 66 69 63 69 61 6C 3E 0A 0A 53
65 74 20 74 68 65 20 64 65 66 61 75 6C 74 20 68 65 61 64 65 72 20 74 6F
20 69 6E 64 69 63 61 74 65 20 74 68 61 74 20 74 68 69 73 20 70 61 67 65
20 69 73 20 70 61 72 74 20 6F 66 20 74 68 65 20 73 74 61 6E 64 61 72 64
0A 50 65 72 6C 20 72 65 6C 65 61 73 65 2C 20 69 66 20 42 3C 2D 2D 63 65
6E 74 65 72 3E 20 69 73 20 6E 6F 74 20 61 6C 73 6F 20 67 69 76 65 6E 2E
0A 0A 3D 69 74 65 6D 20 42 3C 2D 71 3E 20 49 3C 71 75 6F 74 65 73 3E 2C
20 42 3C 2D 2D 71 75 6F 74 65 73 3E 3D 49 3C 71 75 6F 74 65 73 3E 0A 0A
53 65 74 73 20 74 68 65 20 71 75 6F 74 65 20 6D 61 72 6B 73 20 75 73 65
64 20 74 6F 20 73 75 72 72 6F 75 6E 64 20 43 45 3C 6C 74 3E 3E 20 74 65
78 74 20 74 6F 20 49 3C 71 75 6F 74 65 73 3E 2E 20 20 49 66 0A 49 3C 71
75 6F 74 65 73 3E 20 69 73 20 61 20 73 69 6E 67 6C 65 20 63 68 61 72 61
63 74 65 72 2C 20 69 74 20 69 73 20 75 73 65 64 20 61 73 20 62 6F 74 68
20 74 68 65 20 6C 65 66 74 20 61 6E 64 20 72 69 67 68 74 0A 71 75 6F 74
65 3B 20 69 66 20 49 3C 71 75 6F 74 65 73 3E 20 69 73 20 74 77 6F 20 63
68 61 72 61 63 74 65 72 73 2C 20 74 68 65 20 66 69 72 73 74 20 63 68 61
72 61 63 74 65 72 20 69 73 20 75 73 65 64 20 61 73 20 74 68 65 0A 6C 65
66 74 20 71 75 6F 74 65 20 61 6E 64 20 74 68 65 20 73 65 63 6F 6E 64 20
61 73 20 74 68 65 20 72 69 67 68 74 20 71 75 6F 74 65 64 3B 20 61 6E 64
20 69 66 20 49 3C 71 75 6F 74 65 73 3E 20 69 73 20 66 6F 75 72 0A 63 68
61 72 61 63 74 65 72 73 2C 20 74 68 65 20 66 69 72 73 74 20 74 77 6F 20
61 72 65 20 75 73 65 64 20 61 73 20 74 68 65 20 6C 65 66 74 20 71 75 6F
74 65 20 61 6E 64 20 74 68 65 20 73 65 63 6F 6E 64 20 74 77 6F 20 61 73
0A 74 68 65 20 72 69 67 68 74 20 71 75 6F 74 65 2E 0A 0A 49 3C 71 75 6F
74 65 73 3E 20 6D 61 79 20 61 6C 73 6F 20 62 65 20 73 65 74 20 74 6F 20
74 68 65 20 73 70 65 63 69 61 6C 20 76 61 6C 75 65 20 43 3C 6E 6F 6E 65
3E 2C 20 69 6E 20 77 68 69 63 68 20 63 61 73 65 20 6E 6F 0A 71 75 6F 74
65 20 6D 61 72 6B 73 20 61 72 65 20 61 64 64 65 64 20 61 72 6F 75 6E 64
20 43 45 3C 6C 74 3E 3E 20 74 65 78 74 20 28 62 75 74 20 74 68 65 20 66
6F 6E 74 20 69 73 20 73 74 69 6C 6C 20 63 68 61 6E 67 65 64 20 66 6F 72
0A 74 72 6F 66 66 20 6F 75 74 70 75 74 29 2E 0A 0A 3D 69 74 65 6D 20 42
3C 2D 72 3E 2C 20 42 3C 2D 2D 72 65 6C 65 61 73 65 3E 0A 0A 53 65 74 20
74 68 65 20 63 65 6E 74 65 72 65 64 20 66 6F 6F 74 65 72 2E 20 20 42 79
20 64 65 66 61 75 6C 74 2C 20 74 68 69 73 20 69 73 20 74 68 65 20 76 65
72 73 69 6F 6E 20 6F 66 20 50 65 72 6C 20 79 6F 75 20 72 75 6E 0A 42 3C
70 6F 64 32 6D 61 6E 3E 20 75 6E 64 65 72 2E 20 20 4E 6F 74 65 20 74 68
61 74 20 73 6F 6D 65 20 73 79 73 74 65 6D 20 61 6E 20 6D 61 63 72 6F 20
73 65 74 73 20 61 73 73 75 6D 65 20 74 68 61 74 20 74 68 65 0A 63 65 6E
74 65 72 65 64 20 66 6F 6F 74 65 72 20 77 69 6C 6C 20 62 65 20 61 20 6D
6F 64 69 66 69 63 61 74 69 6F 6E 20 64 61 74 65 20 61 6E 64 20 77 69 6C
6C 20 70 72 65 70 65 6E 64 20 73 6F 6D 65 74 68 69 6E 67 20 6C 69 6B 65
0A 22 4C 61 73 74 20 6D 6F 64 69 66 69 65 64 3A 20 22 3B 20 69 66 20 74
68 69 73 20 69 73 20 74 68 65 20 63 61 73 65 2C 20 79 6F 75 20 6D 61 79
20 77 61 6E 74 20 74 6F 20 73 65 74 20 42 3C 2D 2D 72 65 6C 65 61 73 65
3E 20 74 6F 0A 74 68 65 20 6C 61 73 74 20 6D 6F 64 69 66 69 65 64 20 64
61 74 65 20 61 6E 64 20 42 3C 2D 2D 64 61 74 65 3E 20 74 6F 20 74 68 65
20 76 65 72 73 69 6F 6E 20 6E 75 6D 62 65 72 2E 0A 0A 3D 69 74 65 6D 20
42 3C 2D 73 3E 2C 20 42 3C 2D 2D 73 65 63 74 69 6F 6E 3E 0A 0A 53 65 74
20 74 68 65 20 73 65 63 74 69 6F 6E 20 66 6F 72 20 74 68 65 20 43 3C 2E
54 48 3E 20 6D 61 63 72 6F 2E 20 20 54 68 65 20 73 74 61 6E 64 61 72 64
20 73 65 63 74 69 6F 6E 20 6E 75 6D 62 65 72 69 6E 67 0A 63 6F 6E 76 65
6E 74 69 6F 6E 20 69 73 20 74 6F 20 75 73 65 20 31 20 66 6F 72 20 75 73
65 72 20 63 6F 6D 6D 61 6E 64 73 2C 20 32 20 66 6F 72 20 73 79 73 74 65
6D 20 63 61 6C 6C 73 2C 20 33 20 66 6F 72 0A 66 75 6E 63 74 69 6F 6E 73
2C 20 34 20 66 6F 72 20 64 65 76 69 63 65 73 2C 20 35 20 66 6F 72 20 66
69 6C 65 20 66 6F 72 6D 61 74 73 2C 20 36 20 66 6F 72 20 67 61 6D 65 73
2C 20 37 20 66 6F 72 0A 6D 69 73 63 65 6C 6C 61 6E 65 6F 75 73 20 69 6E
66 6F 72 6D 61 74 69 6F 6E 2C 20 61 6E 64 20 38 20 66 6F 72 20 61 64 6D
69 6E 69 73 74 72 61 74 6F 72 20 63 6F 6D 6D 61 6E 64 73 2E 20 20 54 68
65 72 65 20 69 73 20 61 20 6C 6F 74 0A 6F 66 20 76 61 72 69 61 74 69 6F
6E 20 68 65 72 65 2C 20 68 6F 77 65 76 65 72 3B 20 73 6F 6D 65 20 73 79
73 74 65 6D 73 20 28 6C 69 6B 65 20 53 6F 6C 61 72 69 73 29 20 75 73 65
20 34 20 66 6F 72 20 66 69 6C 65 0A 66 6F 72 6D 61 74 73 2C 20 35 20 66
6F 72 20 6D 69 73 63 65 6C 6C 61 6E 65 6F 75 73 20 69 6E 66 6F 72 6D 61
74 69 6F 6E 2C 20 61 6E 64 20 37 20 66 6F 72 20 64 65 76 69 63 65 73 2E
20 20 53 74 69 6C 6C 20 6F 74 68 65 72 73 0A 75 73 65 20 31 6D 20 69 6E
73 74 65 61 64 20 6F 66 20 38 2C 20 6F 72 20 73 6F 6D 65 20 6D 69 78 20
6F 66 20 62 6F 74 68 2E 20 20 41 62 6F 75 74 20 74 68 65 20 6F 6E 6C 79
20 73 65 63 74 69 6F 6E 20 6E 75 6D 62 65 72 73 0A 74 68 61 74 20 61 72
65 20 72 65 6C 69 61 62 6C 79 20 63 6F 6E 73 69 73 74 65 6E 74 20 61 72
65 20 31 2C 20 32 2C 20 61 6E 64 20 33 2E 0A 0A 42 79 20 64 65 66 61 75
6C 74 2C 20 73 65 63 74 69 6F 6E 20 31 20 77 69 6C 6C 20 62 65 20 75 73
65 64 20 75 6E 6C 65 73 73 20 74 68 65 20 66 69 6C 65 20 65 6E 64 73 20
69 6E 20 2E 70 6D 20 69 6E 20 77 68 69 63 68 20 63 61 73 65 0A 73 65 63
74 69 6F 6E 20 33 20 77 69 6C 6C 20 62 65 20 73 65 6C 65 63 74 65 64 2E
0A 0A 3D 69 74 65 6D 20 42 3C 2D 76 3E 2C 20 42 3C 2D 2D 76 65 72 62 6F
73 65 3E 0A 0A 50 72 69 6E 74 20 6F 75 74 20 74 68 65 20 6E 61 6D 65 20
6F 66 20 65 61 63 68 20 6F 75 74 70 75 74 20 66 69 6C 65 20 61 73 20 69
74 20 69 73 20 62 65 69 6E 67 20 67 65 6E 65 72 61 74 65 64 2E 0A 0A 3D
62 61 63 6B 0A 0A 3D 68 65 61 64 31 20 44 49 41 47 4E 4F 53 54 49 43 53
0A 0A 49 66 20 42 3C 70 6F 64 32 6D 61 6E 3E 20 66 61 69 6C 73 20 77 69
74 68 20 65 72 72 6F 72 73 2C 20 73 65 65 20 4C 3C 50 6F 64 3A 3A 4D 61
6E 3E 20 61 6E 64 20 4C 3C 50 6F 64 3A 3A 50 61 72 73 65 72 3E 20 66 6F
72 0A 69 6E 66 6F 72 6D 61 74 69 6F 6E 20 61 62 6F 75 74 20 77 68 61 74
20 74 68 6F 73 65 20 65 72 72 6F 72 73 20 6D 69 67 68 74 20 6D 65 61 6E
2E 0A 0A 3D 68 65 61 64 31 20 45 58 41 4D 50 4C 45 53 0A 0A 20 20 20 20
70 6F 64 32 6D 61 6E 20 70 72 6F 67 72 61 6D 20 3E 20 70 72 6F 67 72 61
6D 2E 31 0A 20 20 20 20 70 6F 64 32 6D 61 6E 20 53 6F 6D 65 4D 6F 64 75
6C 65 2E 70 6D 20 2F 75 73 72 2F 70 65 72 6C 2F 6D 61 6E 2F 6D 61 6E 33
2F 53 6F 6D 65 4D 6F 64 75 6C 65 2E 33 0A 20 20 20 20 70 6F 64 32 6D 61
6E 20 2D 2D 73 65 63 74 69 6F 6E 3D 37 20 6E 6F 74 65 2E 70 6F 64 20 3E
20 6E 6F 74 65 2E 37 0A 0A 49 66 20 79 6F 75 20 77 6F 75 6C 64 20 6C 69
6B 65 20 74 6F 20 70 72 69 6E 74 20 6F 75 74 20 61 20 6C 6F 74 20 6F 66
20 6D 61 6E 20 70 61 67 65 20 63 6F 6E 74 69 6E 75 6F 75 73 6C 79 2C 20
79 6F 75 20 70 72 6F 62 61 62 6C 79 0A 77 61 6E 74 20 74 6F 20 73 65 74
20 74 68 65 20 43 20 61 6E 64 20 44 20 72 65 67 69 73 74 65 72 73 20 74
6F 20 73 65 74 20 63 6F 6E 74 69 67 75 6F 75 73 20 70 61 67 65 20 6E 75
6D 62 65 72 69 6E 67 20 61 6E 64 0A 65 76 65 6E 2F 6F 64 64 20 70 61 67
69 6E 67 2C 20 61 74 20 6C 65 61 73 74 20 6F 6E 20 73 6F 6D 65 20 76 65
72 73 69 6F 6E 73 20 6F 66 20 6D 61 6E 28 37 29 2E 0A 0A 20 20 20 20 74
72 6F 66 66 20 2D 6D 61 6E 20 2D 72 43 31 20 2D 72 44 31 20 70 65 72 6C
2E 31 20 70 65 72 6C 64 61 74 61 2E 31 20 70 65 72 6C 73 79 6E 2E 31 20
2E 2E 2E 0A 0A 54 6F 20 67 65 74 20 69 6E 64 65 78 20 65 6E 74 72 69 65
73 20 6F 6E 20 73 74 64 65 72 72 2C 20 74 75 72 6E 20 6F 6E 20 74 68 65
20 46 20 72 65 67 69 73 74 65 72 2C 20 61 73 20 69 6E 3A 0A 0A 20 20 20
20 74 72 6F 66 66 20 2D 6D 61 6E 20 2D 72 46 31 20 70 65 72 6C 2E 31 0A
0A 54 68 65 20 69 6E 64 65 78 69 6E 67 20 6D 65 72 65 6C 79 20 6F 75 74
70 75 74 73 20 6D 65 73 73 61 67 65 73 20 76 69 61 20 43 3C 2E 74 6D 3E
20 66 6F 72 20 65 61 63 68 20 6D 61 6A 6F 72 20 70 61 67 65 2C 0A 73 65
63 74 69 6F 6E 2C 20 73 75 62 73 65 63 74 69 6F 6E 2C 20 69 74 65 6D 2C
20 61 6E 64 20 61 6E 79 20 43 3C 58 45 3C 6C 74 3E 45 3C 67 74 3E 3E 20
64 69 72 65 63 74 69 76 65 73 2E 20 20 53 65 65 0A 4C 3C 50 6F 64 3A 3A
4D 61 6E 3E 20 66 6F 72 20 6D 6F 72 65 20 64 65 74 61 69 6C 73 2E 0A 0A
3D 68 65 61 64 31 20 42 55 47 53 0A 0A 4C 6F 74 73 20 6F 66 20 74 68 69
73 20 64 6F 63 75 6D 65 6E 74 61 74 69 6F 6E 20 69 73 20 64 75 70 6C 69
63 61 74 65 64 20 66 72 6F 6D 20 4C 3C 50 6F 64 3A 3A 4D 61 6E 3E 2E 0A
0A 3D 68 65 61 64 31 20 4E 4F 54 45 53 0A 0A 46 6F 72 20 74 68 6F 73 65
20 6E 6F 74 20 73 75 72 65 20 6F 66 20 74 68 65 20 70 72 6F 70 65 72 20
6C 61 79 6F 75 74 20 6F 66 20 61 20 6D 61 6E 20 70 61 67 65 2C 20 68 65
72 65 20 61 72 65 20 73 6F 6D 65 20 6E 6F 74 65 73 0A 6F 6E 20 77 72 69
74 69 6E 67 20 61 20 70 72 6F 70 65 72 20 6D 61 6E 20 70 61 67 65 2E 0A
0A 54 68 65 20 6E 61 6D 65 20 6F 66 20 74 68 65 20 70 72 6F 67 72 61 6D
20 62 65 69 6E 67 20 64 6F 63 75 6D 65 6E 74 65 64 20 69 73 20 63 6F 6E
76 65 6E 74 69 6F 6E 61 6C 6C 79 20 77 72 69 74 74 65 6E 20 69 6E 20 62
6F 6C 64 0A 28 75 73 69 6E 67 20 42 45 3C 6C 74 3E 45 3C 67 74 3E 29 20
77 68 65 72 65 76 65 72 20 69 74 20 6F 63 63 75 72 73 2C 20 61 73 20 61
72 65 20 61 6C 6C 20 70 72 6F 67 72 61 6D 20 6F 70 74 69 6F 6E 73 2E 0A
41 72 67 75 6D 65 6E 74 73 20 73 68 6F 75 6C 64 20 62 65 20 77 72 69 74
74 65 6E 20 69 6E 20 69 74 61 6C 69 63 73 20 28 49 45 3C 6C 74 3E 45 3C
67 74 3E 29 2E 20 20 46 75 6E 63 74 69 6F 6E 73 20 61 72 65 0A 74 72 61
64 69 74 69 6F 6E 61 6C 6C 79 20 77 72 69 74 74 65 6E 20 69 6E 20 69 74
61 6C 69 63 73 3B 20 69 66 20 79 6F 75 20 77 72 69 74 65 20 61 20 66 75
6E 63 74 69 6F 6E 20 61 73 20 66 75 6E 63 74 69 6F 6E 28 29 2C 0A 50 6F
64 3A 3A 4D 61 6E 20 77 69 6C 6C 20 74 61 6B 65 20 63 61 72 65 20 6F 66
20 74 68 69 73 20 66 6F 72 20 79 6F 75 2E 20 20 4C 69 74 65 72 61 6C 20
63 6F 64 65 20 6F 72 20 63 6F 6D 6D 61 6E 64 73 20 73 68 6F 75 6C 64 0A
62 65 20 69 6E 20 43 45 3C 6C 74 3E 45 3C 67 74 3E 2E 20 20 52 65 66 65
72 65 6E 63 65 73 20 74 6F 20 6F 74 68 65 72 20 6D 61 6E 20 70 61 67 65
73 20 73 68 6F 75 6C 64 20 62 65 20 69 6E 20 74 68 65 20 66 6F 72 6D 0A
43 3C 6D 61 6E 70 61 67 65 28 73 65 63 74 69 6F 6E 29 3E 2C 20 61 6E 64
20 50 6F 64 3A 3A 4D 61 6E 20 77 69 6C 6C 20 61 75 74 6F 6D 61 74 69 63
61 6C 6C 79 20 66 6F 72 6D 61 74 20 74 68 6F 73 65 0A 61 70 70 72 6F 70
72 69 61 74 65 6C 79 2E 20 20 41 73 20 61 6E 20 65 78 63 65 70 74 69 6F
6E 2C 20 69 74 27 73 20 74 72 61 64 69 74 69 6F 6E 61 6C 20 6E 6F 74 20
74 6F 20 75 73 65 20 74 68 69 73 20 66 6F 72 6D 20 77 68 65 6E 0A 72 65
66 65 72 72 69 6E 67 20 74 6F 20 6D 6F 64 75 6C 65 20 64 6F 63 75 6D 65
6E 74 61 74 69 6F 6E 3B 20 75 73 65 20 43 3C 4C 45 3C 6C 74 3E 4D 6F 64
75 6C 65 3A 3A 4E 61 6D 65 45 3C 67 74 3E 3E 20 69 6E 73 74 65 61 64 2E
0A 0A 52 65 66 65 72 65 6E 63 65 73 20 74 6F 20 6F 74 68 65 72 20 70 72
6F 67 72 61 6D 73 20 6F 72 20 66 75 6E 63 74 69 6F 6E 73 20 61 72 65 20
6E 6F 72 6D 61 6C 6C 79 20 69 6E 20 74 68 65 20 66 6F 72 6D 20 6F 66 20
6D 61 6E 0A 70 61 67 65 20 72 65 66 65 72 65 6E 63 65 73 20 73 6F 20 74
68 61 74 20 63 72 6F 73 73 2D 72 65 66 65 72 65 6E 63 69 6E 67 20 74 6F
6F 6C 73 20 63 61 6E 20 70 72 6F 76 69 64 65 20 74 68 65 20 75 73 65 72
20 77 69 74 68 0A 6C 69 6E 6B 73 20 61 6E 64 20 74 68 65 20 6C 69 6B 65
2E 20 20 49 74 27 73 20 70 6F 73 73 69 62 6C 65 20 74 6F 20 6F 76 65 72
64 6F 20 74 68 69 73 2C 20 74 68 6F 75 67 68 2C 20 73 6F 20 62 65 20 63
61 72 65 66 75 6C 20 6E 6F 74 0A 74 6F 20 63 6C 75 74 74 65 72 20 79 6F
75 72 20 64 6F 63 75 6D 65 6E 74 61 74 69 6F 6E 20 77 69 74 68 20 74 6F
6F 20 6D 75 63 68 20 6D 61 72 6B 75 70 2E 0A 0A 54 68 65 20 6D 61 6A 6F
72 20 68 65 61 64 65 72 73 20 73 68 6F 75 6C 64 20 62 65 20 73 65 74 20
6F 75 74 20 75 73 69 6E 67 20 61 20 43 3C 3D 68 65 61 64 31 3E 20 64 69
72 65 63 74 69 76 65 2C 20 61 6E 64 20 61 72 65 0A 68 69 73 74 6F 72 69
63 61 6C 6C 79 20 77 72 69 74 74 65 6E 20 69 6E 20 74 68 65 20 72 61 74
68 65 72 20 73 74 61 72 74 6C 69 6E 67 20 41 4C 4C 20 55 50 50 45 52 20
43 41 53 45 20 66 6F 72 6D 61 74 2C 20 61 6C 74 68 6F 75 67 68 0A 74 68
69 73 20 69 73 20 6E 6F 74 20 6D 61 6E 64 61 74 6F 72 79 2E 20 20 4D 69
6E 6F 72 20 68 65 61 64 65 72 73 20 6D 61 79 20 62 65 20 69 6E 63 6C 75
64 65 64 20 75 73 69 6E 67 20 43 3C 3D 68 65 61 64 32 3E 2C 20 61 6E 64
0A 61 72 65 20 74 79 70 69 63 61 6C 6C 79 20 69 6E 20 6D 69 78 65 64 20
63 61 73 65 2E 0A 0A 54 68 65 20 73 74 61 6E 64 61 72 64 20 73 65 63 74
69 6F 6E 73 20 6F 66 20 61 20 6D 61 6E 75 61 6C 20 70 61 67 65 20 61 72
65 3A 0A 0A 3D 6F 76 65 72 20 34 0A 0A 3D 69 74 65 6D 20 4E 41 4D 45 0A
0A 4D 61 6E 64 61 74 6F 72 79 20 73 65 63 74 69 6F 6E 3B 20 73 68 6F 75
6C 64 20 62 65 20 61 20 63 6F 6D 6D 61 2D 73 65 70 61 72 61 74 65 64 20
6C 69 73 74 20 6F 66 20 70 72 6F 67 72 61 6D 73 20 6F 72 20 66 75 6E 63
74 69 6F 6E 73 0A 64 6F 63 75 6D 65 6E 74 65 64 20 62 79 20 74 68 69 73
20 70 6F 64 70 61 67 65 2C 20 73 75 63 68 20 61 73 3A 0A 0A 20 20 20 20
66 6F 6F 2C 20 62 61 72 20 2D 20 70 72 6F 67 72 61 6D 73 20 74 6F 20 64
6F 20 73 6F 6D 65 74 68 69 6E 67 0A 0A 4D 61 6E 75 61 6C 20 70 61 67 65
20 69 6E 64 65 78 65 72 73 20 61 72 65 20 6F 66 74 65 6E 20 65 78 74 72
65 6D 65 6C 79 20 70 69 63 6B 79 20 61 62 6F 75 74 20 74 68 65 20 66 6F
72 6D 61 74 20 6F 66 20 74 68 69 73 0A 73 65 63 74 69 6F 6E 2C 20 73 6F
20 64 6F 6E 27 74 20 70 75 74 20 61 6E 79 74 68 69 6E 67 20 69 6E 20 69
74 20 65 78 63 65 70 74 20 74 68 69 73 20 6C 69 6E 65 2E 20 20 41 20 73
69 6E 67 6C 65 20 64 61 73 68 2C 20 61 6E 64 0A 6F 6E 6C 79 20 61 20 73
69 6E 67 6C 65 20 64 61 73 68 2C 20 73 68 6F 75 6C 64 20 73 65 70 61 72
61 74 65 20 74 68 65 20 6C 69 73 74 20 6F 66 20 70 72 6F 67 72 61 6D 73
20 6F 72 20 66 75 6E 63 74 69 6F 6E 73 20 66 72 6F 6D 0A 74 68 65 20 64
65 73 63 72 69 70 74 69 6F 6E 2E 20 20 46 75 6E 63 74 69 6F 6E 73 20 73
68 6F 75 6C 64 20 6E 6F 74 20 62 65 20 71 75 61 6C 69 66 69 65 64 20 77
69 74 68 20 43 3C 28 29 3E 20 6F 72 20 74 68 65 20 6C 69 6B 65 2E 0A 54
68 65 20 64 65 73 63 72 69 70 74 69 6F 6E 20 73 68 6F 75 6C 64 20 69 64
65 61 6C 6C 79 20 66 69 74 20 6F 6E 20 61 20 73 69 6E 67 6C 65 20 6C 69
6E 65 2C 20 65 76 65 6E 20 69 66 20 61 20 6D 61 6E 20 70 72 6F 67 72 61
6D 0A 72 65 70 6C 61 63 65 73 20 74 68 65 20 64 61 73 68 20 77 69 74 68
20 61 20 66 65 77 20 74 61 62 73 2E 0A 0A 3D 69 74 65 6D 20 53 59 4E 4F
50 53 49 53 0A 0A 41 20 73 68 6F 72 74 20 75 73 61 67 65 20 73 75 6D 6D
61 72 79 20 66 6F 72 20 70 72 6F 67 72 61 6D 73 20 61 6E 64 20 66 75 6E
63 74 69 6F 6E 73 2E 20 20 54 68 69 73 20 73 65 63 74 69 6F 6E 20 69 73
20 6D 61 6E 64 61 74 6F 72 79 0A 66 6F 72 20 73 65 63 74 69 6F 6E 20 33
20 70 61 67 65 73 2E 0A 0A 3D 69 74 65 6D 20 44 45 53 43 52 49 50 54 49
4F 4E 0A 0A 45 78 74 65 6E 64 65 64 20 64 65 73 63 72 69 70 74 69 6F 6E
20 61 6E 64 20 64 69 73 63 75 73 73 69 6F 6E 20 6F 66 20 74 68 65 20 70
72 6F 67 72 61 6D 20 6F 72 20 66 75 6E 63 74 69 6F 6E 73 2C 20 6F 72 20
74 68 65 20 62 6F 64 79 0A 6F 66 20 74 68 65 20 64 6F 63 75 6D 65 6E 74
61 74 69 6F 6E 20 66 6F 72 20 6D 61 6E 20 70 61 67 65 73 20 74 68 61 74
20 64 6F 63 75 6D 65 6E 74 20 73 6F 6D 65 74 68 69 6E 67 20 65 6C 73 65
2E 20 20 49 66 0A 70 61 72 74 69 63 75 6C 61 72 6C 79 20 6C 6F 6E 67 2C
20 69 74 27 73 20 61 20 67 6F 6F 64 20 69 64 65 61 20 74 6F 20 62 72 65
61 6B 20 74 68 69 73 20 75 70 20 69 6E 74 6F 20 73 75 62 73 65 63 74 69
6F 6E 73 0A 43 3C 3D 68 65 61 64 32 3E 20 64 69 72 65 63 74 69 76 65 73
20 6C 69 6B 65 3A 0A 0A 20 20 20 20 3D 68 65 61 64 32 20 4E 6F 72 6D 61
6C 20 55 73 61 67 65 0A 0A 20 20 20 20 3D 68 65 61 64 32 20 41 64 76 61
6E 63 65 64 20 46 65 61 74 75 72 65 73 0A 0A 20 20 20 20 3D 68 65 61 64
32 20 57 72 69 74 69 6E 67 20 43 6F 6E 66 69 67 75 72 61 74 69 6F 6E 20
46 69 6C 65 73 0A 0A 6F 72 20 77 68 61 74 65 76 65 72 20 69 73 20 61 70
70 72 6F 70 72 69 61 74 65 20 66 6F 72 20 79 6F 75 72 20 64 6F 63 75 6D
65 6E 74 61 74 69 6F 6E 2E 0A 0A 3D 69 74 65 6D 20 4F 50 54 49 4F 4E 53
0A 0A 44 65 74 61 69 6C 65 64 20 64 65 73 63 72 69 70 74 69 6F 6E 20 6F
66 20 65 61 63 68 20 6F 66 20 74 68 65 20 63 6F 6D 6D 61 6E 64 2D 6C 69
6E 65 20 6F 70 74 69 6F 6E 73 20 74 61 6B 65 6E 20 62 79 20 74 68 65 0A
70 72 6F 67 72 61 6D 2E 20 20 54 68 69 73 20 73 68 6F 75 6C 64 20 62 65
20 73 65 70 61 72 61 74 65 20 66 72 6F 6D 20 74 68 65 20 64 65 73 63 72
69 70 74 69 6F 6E 20 66 6F 72 20 74 68 65 20 75 73 65 20 6F 66 20 74 68
69 6E 67 73 0A 6C 69 6B 65 20 4C 3C 50 6F 64 3A 3A 55 73 61 67 65 7C 50
6F 64 3A 3A 55 73 61 67 65 3E 2E 20 20 54 68 69 73 20 69 73 20 6E 6F 72
6D 61 6C 6C 79 20 70 72 65 73 65 6E 74 65 64 20 61 73 20 61 20 6C 69 73
74 2C 20 77 69 74 68 0A 65 61 63 68 20 6F 70 74 69 6F 6E 20 61 73 20 61
20 73 65 70 61 72 61 74 65 20 43 3C 3D 69 74 65 6D 3E 2E 20 20 54 68 65
20 73 70 65 63 69 66 69 63 20 6F 70 74 69 6F 6E 20 73 74 72 69 6E 67 20
73 68 6F 75 6C 64 20 62 65 0A 65 6E 63 6C 6F 73 65 64 20 69 6E 20 42 45
3C 6C 74 3E 45 3C 67 74 3E 2E 20 20 41 6E 79 20 76 61 6C 75 65 73 20 74
68 61 74 20 74 68 65 20 6F 70 74 69 6F 6E 20 74 61 6B 65 73 20 73 68 6F
75 6C 64 20 62 65 0A 65 6E 63 6C 6F 73 65 64 20 69 6E 20 49 45 3C 6C 74
3E 45 3C 67 74 3E 2E 20 20 46 6F 72 20 65 78 61 6D 70 6C 65 2C 20 74 68
65 20 73 65 63 74 69 6F 6E 20 66 6F 72 20 74 68 65 20 6F 70 74 69 6F 6E
0A 42 3C 2D 2D 73 65 63 74 69 6F 6E 3E 3D 49 3C 6D 61 6E 65 78 74 3E 20
77 6F 75 6C 64 20 62 65 20 69 6E 74 72 6F 64 75 63 65 64 20 77 69 74 68
3A 0A 0A 20 20 20 20 3D 69 74 65 6D 20 42 3C 2D 2D 73 65 63 74 69 6F 6E
3E 3D 49 3C 6D 61 6E 65 78 74 3E 0A 0A 53 79 6E 6F 6E 79 6D 6F 75 73 20
6F 70 74 69 6F 6E 73 20 28 6C 69 6B 65 20 62 6F 74 68 20 74 68 65 20 73
68 6F 72 74 20 61 6E 64 20 6C 6F 6E 67 20 66 6F 72 6D 73 29 20 61 72 65
20 73 65 70 61 72 61 74 65 64 20 62 79 20 61 0A 63 6F 6D 6D 61 20 61 6E
64 20 61 20 73 70 61 63 65 20 6F 6E 20 74 68 65 20 73 61 6D 65 20 43 3C
3D 69 74 65 6D 3E 20 6C 69 6E 65 2C 20 6F 72 20 6F 70 74 69 6F 6E 61 6C
6C 79 20 6C 69 73 74 65 64 20 61 73 20 74 68 65 69 72 0A 6F 77 6E 20 69
74 65 6D 20 77 69 74 68 20 61 20 72 65 66 65 72 65 6E 63 65 20 74 6F 20
74 68 65 20 63 61 6E 6F 6E 69 63 61 6C 20 6E 61 6D 65 2E 20 20 46 6F 72
20 65 78 61 6D 70 6C 65 2C 20 73 69 6E 63 65 0A 42 3C 2D 2D 73 65 63 74
69 6F 6E 3E 20 63 61 6E 20 61 6C 73 6F 20 62 65 20 77 72 69 74 74 65 6E
20 61 73 20 42 3C 2D 73 3E 2C 20 74 68 65 20 61 62 6F 76 65 20 77 6F 75
6C 64 20 62 65 3A 0A 0A 20 20 20 20 3D 69 74 65 6D 20 42 3C 2D 73 3E 20
49 3C 6D 61 6E 65 78 74 3E 2C 20 42 3C 2D 2D 73 65 63 74 69 6F 6E 3E 3D
49 3C 6D 61 6E 65 78 74 3E 0A 0A 28 57 72 69 74 69 6E 67 20 74 68 65 20
73 68 6F 72 74 20 6F 70 74 69 6F 6E 20 66 69 72 73 74 20 69 73 20 61 72
67 75 61 62 6C 79 20 65 61 73 69 65 72 20 74 6F 20 72 65 61 64 2C 20 73
69 6E 63 65 20 74 68 65 20 6C 6F 6E 67 0A 6F 70 74 69 6F 6E 20 69 73 20
6C 6F 6E 67 20 65 6E 6F 75 67 68 20 74 6F 20 64 72 61 77 20 74 68 65 20
65 79 65 20 74 6F 20 69 74 20 61 6E 79 77 61 79 20 61 6E 64 20 74 68 65
20 73 68 6F 72 74 20 6F 70 74 69 6F 6E 20 63 61 6E 0A 6F 74 68 65 72 77
69 73 65 20 67 65 74 20 6C 6F 73 74 20 69 6E 20 76 69 73 75 61 6C 20 6E
6F 69 73 65 2E 29 0A 0A 3D 69 74 65 6D 20 52 45 54 55 52 4E 20 56 41 4C
55 45 0A 0A 57 68 61 74 20 74 68 65 20 70 72 6F 67 72 61 6D 20 6F 72 20
66 75 6E 63 74 69 6F 6E 20 72 65 74 75 72 6E 73 2C 20 69 66 20 73 75 63
63 65 73 73 66 75 6C 2E 20 20 54 68 69 73 20 73 65 63 74 69 6F 6E 20 63
61 6E 20 62 65 0A 6F 6D 69 74 74 65 64 20 66 6F 72 20 70 72 6F 67 72 61
6D 73 20 77 68 6F 73 65 20 70 72 65 63 69 73 65 20 65 78 69 74 20 63 6F
64 65 73 20 61 72 65 6E 27 74 20 69 6D 70 6F 72 74 61 6E 74 2C 20 70 72
6F 76 69 64 65 64 0A 74 68 65 79 20 72 65 74 75 72 6E 20 30 20 6F 6E 20
73 75 63 63 65 73 73 20 61 73 20 69 73 20 73 74 61 6E 64 61 72 64 2E 20
20 49 74 20 73 68 6F 75 6C 64 20 61 6C 77 61 79 73 20 62 65 20 70 72 65
73 65 6E 74 20 66 6F 72 0A 66 75 6E 63 74 69 6F 6E 73 2E 0A 0A 3D 69 74
65 6D 20 45 52 52 4F 52 53 0A 0A 45 78 63 65 70 74 69 6F 6E 73 2C 20 65
72 72 6F 72 20 72 65 74 75 72 6E 20 63 6F 64 65 73 2C 20 65 78 69 74 20
73 74 61 74 75 73 65 73 2C 20 61 6E 64 20 65 72 72 6E 6F 20 73 65 74 74
69 6E 67 73 2E 0A 54 79 70 69 63 61 6C 6C 79 20 75 73 65 64 20 66 6F 72
20 66 75 6E 63 74 69 6F 6E 20 64 6F 63 75 6D 65 6E 74 61 74 69 6F 6E 3B
20 70 72 6F 67 72 61 6D 20 64 6F 63 75 6D 65 6E 74 61 74 69 6F 6E 20 75
73 65 73 0A 44 49 41 47 4E 4F 53 54 49 43 53 20 69 6E 73 74 65 61 64 2E
20 20 54 68 65 20 67 65 6E 65 72 61 6C 20 72 75 6C 65 20 6F 66 20 74 68
75 6D 62 20 69 73 20 74 68 61 74 20 65 72 72 6F 72 73 20 70 72 69 6E 74
65 64 20 74 6F 0A 53 54 44 4F 55 54 20 6F 72 20 53 54 44 45 52 52 20 61
6E 64 20 69 6E 74 65 6E 64 65 64 20 66 6F 72 20 74 68 65 20 65 6E 64 20
75 73 65 72 20 61 72 65 20 64 6F 63 75 6D 65 6E 74 65 64 20 69 6E 20 44
49 41 47 4E 4F 53 54 49 43 53 0A 77 68 69 6C 65 20 65 72 72 6F 72 73 20
70 61 73 73 65 64 20 69 6E 74 65 72 6E 61 6C 20 74 6F 20 74 68 65 20 63
61 6C 6C 69 6E 67 20 70 72 6F 67 72 61 6D 20 61 6E 64 20 69 6E 74 65 6E
64 65 64 20 66 6F 72 20 6F 74 68 65 72 0A 70 72 6F 67 72 61 6D 6D 65 72
73 20 61 72 65 20 64 6F 63 75 6D 65 6E 74 65 64 20 69 6E 20 45 52 52 4F
52 53 2E 20 20 57 68 65 6E 20 64 6F 63 75 6D 65 6E 74 69 6E 67 20 61 20
66 75 6E 63 74 69 6F 6E 20 74 68 61 74 20 73 65 74 73 0A 65 72 72 6E 6F
2C 20 61 20 66 75 6C 6C 20 6C 69 73 74 20 6F 66 20 74 68 65 20 70 6F 73
73 69 62 6C 65 20 65 72 72 6E 6F 20 76 61 6C 75 65 73 20 73 68 6F 75 6C
64 20 62 65 20 67 69 76 65 6E 20 68 65 72 65 2E 0A 0A 3D 69 74 65 6D 20
44 49 41 47 4E 4F 53 54 49 43 53 0A 0A 41 6C 6C 20 70 6F 73 73 69 62 6C
65 20 6D 65 73 73 61 67 65 73 20 74 68 65 20 70 72 6F 67 72 61 6D 20 63
61 6E 20 70 72 69 6E 74 20 6F 75 74 2D 2D 61 6E 64 20 77 68 61 74 20 74
68 65 79 20 6D 65 61 6E 2E 20 20 59 6F 75 0A 6D 61 79 20 77 69 73 68 20
74 6F 20 66 6F 6C 6C 6F 77 20 74 68 65 20 73 61 6D 65 20 64 6F 63 75 6D
65 6E 74 61 74 69 6F 6E 20 73 74 79 6C 65 20 61 73 20 74 68 65 20 50 65
72 6C 20 64 6F 63 75 6D 65 6E 74 61 74 69 6F 6E 3B 0A 73 65 65 20 70 65
72 6C 64 69 61 67 28 31 29 20 66 6F 72 20 6D 6F 72 65 20 64 65 74 61 69
6C 73 20 28 61 6E 64 20 6C 6F 6F 6B 20 61 74 20 74 68 65 20 50 4F 44 20
73 6F 75 72 63 65 20 61 73 20 77 65 6C 6C 29 2E 0A 0A 49 66 20 61 70 70
6C 69 63 61 62 6C 65 2C 20 70 6C 65 61 73 65 20 69 6E 63 6C 75 64 65 20
64 65 74 61 69 6C 73 20 6F 6E 20 77 68 61 74 20 74 68 65 20 75 73 65 72
20 73 68 6F 75 6C 64 20 64 6F 20 74 6F 20 63 6F 72 72 65 63 74 0A 74 68
65 20 65 72 72 6F 72 3B 20 64 6F 63 75 6D 65 6E 74 69 6E 67 20 61 6E 20
65 72 72 6F 72 20 61 73 20 69 6E 64 69 63 61 74 69 6E 67 20 22 74 68 65
20 69 6E 70 75 74 20 62 75 66 66 65 72 20 69 73 20 74 6F 6F 0A 73 6D 61
6C 6C 22 20 77 69 74 68 6F 75 74 20 74 65 6C 6C 69 6E 67 20 74 68 65 20
75 73 65 72 20 68 6F 77 20 74 6F 20 69 6E 63 72 65 61 73 65 20 74 68 65
20 73 69 7A 65 20 6F 66 20 74 68 65 20 69 6E 70 75 74 20 62 75 66 66 65
72 0A 28 6F 72 20 61 74 20 6C 65 61 73 74 20 74 65 6C 6C 69 6E 67 20 74
68 65 6D 20 74 68 61 74 20 69 74 20 69 73 6E 27 74 20 70 6F 73 73 69 62
6C 65 29 20 61 72 65 6E 27 74 20 76 65 72 79 20 75 73 65 66 75 6C 2E 0A
0A 3D 69 74 65 6D 20 45 58 41 4D 50 4C 45 53 0A 0A 47 69 76 65 20 73 6F
6D 65 20 65 78 61 6D 70 6C 65 20 75 73 65 73 20 6F 66 20 74 68 65 20 70
72 6F 67 72 61 6D 20 6F 72 20 66 75 6E 63 74 69 6F 6E 2E 20 20 44 6F 6E
27 74 20 73 6B 69 6D 70 3B 20 75 73 65 72 73 20 6F 66 74 65 6E 0A 66 69
6E 64 20 74 68 69 73 20 74 68 65 20 6D 6F 73 74 20 75 73 65 66 75 6C 20
70 61 72 74 20 6F 66 20 74 68 65 20 64 6F 63 75 6D 65 6E 74 61 74 69 6F
6E 2E 20 20 54 68 65 20 65 78 61 6D 70 6C 65 73 20 61 72 65 0A 67 65 6E
65 72 61 6C 6C 79 20 67 69 76 65 6E 20 61 73 20 76 65 72 62 61 74 69 6D
20 70 61 72 61 67 72 61 70 68 73 2E 0A 0A 44 6F 6E 27 74 20 6A 75 73 74
20 70 72 65 73 65 6E 74 20 61 6E 20 65 78 61 6D 70 6C 65 20 77 69 74 68
6F 75 74 20 65 78 70 6C 61 69 6E 69 6E 67 20 77 68 61 74 20 69 74 20 64
6F 65 73 2E 20 20 41 64 64 69 6E 67 20 61 0A 73 68 6F 72 74 20 70 61 72
61 67 72 61 70 68 20 73 61 79 69 6E 67 20 77 68 61 74 20 74 68 65 20 65
78 61 6D 70 6C 65 20 77 69 6C 6C 20 64 6F 20 63 61 6E 20 69 6E 63 72 65
61 73 65 20 74 68 65 20 76 61 6C 75 65 20 6F 66 0A 74 68 65 20 65 78 61
6D 70 6C 65 20 69 6D 6D 65 6E 73 65 6C 79 2E 0A 0A 3D 69 74 65 6D 20 45
4E 56 49 52 4F 4E 4D 45 4E 54 0A 0A 45 6E 76 69 72 6F 6E 6D 65 6E 74 20
76 61 72 69 61 62 6C 65 73 20 74 68 61 74 20 74 68 65 20 70 72 6F 67 72
61 6D 20 63 61 72 65 73 20 61 62 6F 75 74 2C 20 6E 6F 72 6D 61 6C 6C 79
20 70 72 65 73 65 6E 74 65 64 20 61 73 20 61 0A 6C 69 73 74 20 75 73 69
6E 67 20 43 3C 3D 6F 76 65 72 3E 2C 20 43 3C 3D 69 74 65 6D 3E 2C 20 61
6E 64 20 43 3C 3D 62 61 63 6B 3E 2E 20 20 46 6F 72 20 65 78 61 6D 70 6C
65 3A 0A 0A 20 20 20 20 3D 6F 76 65 72 20 36 0A 0A 20 20 20 20 3D 69 74
65 6D 20 48 4F 4D 45 0A 0A 20 20 20 20 55 73 65 64 20 74 6F 20 64 65 74
65 72 6D 69 6E 65 20 74 68 65 20 75 73 65 72 27 73 20 68 6F 6D 65 20 64
69 72 65 63 74 6F 72 79 2E 20 20 46 3C 2E 66 6F 6F 72 63 3E 20 69 6E 20
74 68 69 73 0A 20 20 20 20 64 69 72 65 63 74 6F 72 79 20 69 73 20 72 65
61 64 20 66 6F 72 20 63 6F 6E 66 69 67 75 72 61 74 69 6F 6E 20 64 65 74
61 69 6C 73 2C 20 69 66 20 69 74 20 65 78 69 73 74 73 2E 0A 0A 20 20 20
20 3D 62 61 63 6B 0A 0A 53 69 6E 63 65 20 65 6E 76 69 72 6F 6E 6D 65 6E
74 20 76 61 72 69 61 62 6C 65 73 20 61 72 65 20 6E 6F 72 6D 61 6C 6C 79
20 69 6E 20 61 6C 6C 20 75 70 70 65 72 63 61 73 65 2C 20 6E 6F 20 61 64
64 69 74 69 6F 6E 61 6C 0A 73 70 65 63 69 61 6C 20 66 6F 72 6D 61 74 74
69 6E 67 20 69 73 20 67 65 6E 65 72 61 6C 6C 79 20 6E 65 65 64 65 64 3B
20 74 68 65 79 27 72 65 20 67 6C 61 72 69 6E 67 20 65 6E 6F 75 67 68 20
61 73 20 69 74 20 69 73 2E 0A 0A 3D 69 74 65 6D 20 46 49 4C 45 53 0A 0A
41 6C 6C 20 66 69 6C 65 73 20 75 73 65 64 20 62 79 20 74 68 65 20 70 72
6F 67 72 61 6D 20 6F 72 20 66 75 6E 63 74 69 6F 6E 2C 20 6E 6F 72 6D 61
6C 6C 79 20 70 72 65 73 65 6E 74 65 64 20 61 73 20 61 20 6C 69 73 74 2C
20 61 6E 64 0A 77 68 61 74 20 69 74 20 75 73 65 73 20 74 68 65 6D 20 66
6F 72 2E 20 20 46 69 6C 65 20 6E 61 6D 65 73 20 73 68 6F 75 6C 64 20 62
65 20 65 6E 63 6C 6F 73 65 64 20 69 6E 20 46 45 3C 6C 74 3E 45 3C 67 74
3E 2E 20 20 49 74 27 73 0A 70 61 72 74 69 63 75 6C 61 72 6C 79 20 69 6D
70 6F 72 74 61 6E 74 20 74 6F 20 64 6F 63 75 6D 65 6E 74 20 66 69 6C 65
73 20 74 68 61 74 20 77 69 6C 6C 20 62 65 20 70 6F 74 65 6E 74 69 61 6C
6C 79 20 6D 6F 64 69 66 69 65 64 2E 0A 0A 3D 69 74 65 6D 20 43 41 56 45
41 54 53 0A 0A 54 68 69 6E 67 73 20 74 6F 20 74 61 6B 65 20 73 70 65 63
69 61 6C 20 63 61 72 65 20 77 69 74 68 2C 20 73 6F 6D 65 74 69 6D 65 73
20 63 61 6C 6C 65 64 20 57 41 52 4E 49 4E 47 53 2E 0A 0A 3D 69 74 65 6D
20 42 55 47 53 0A 0A 54 68 69 6E 67 73 20 74 68 61 74 20 61 72 65 20 62
72 6F 6B 65 6E 20 6F 72 20 6A 75 73 74 20 64 6F 6E 27 74 20 77 6F 72 6B
20 71 75 69 74 65 20 72 69 67 68 74 2E 0A 0A 3D 69 74 65 6D 20 52 45 53
54 52 49 43 54 49 4F 4E 53 0A 0A 42 75 67 73 20 79 6F 75 20 64 6F 6E 27
74 20 70 6C 61 6E 20 74 6F 20 66 69 78 2E 20 20 3A 2D 29 0A 0A 3D 69 74
65 6D 20 4E 4F 54 45 53 0A 0A 4D 69 73 63 65 6C 6C 61 6E 65 6F 75 73 20
63 6F 6D 6D 65 6E 74 61 72 79 2E 0A 0A 3D 69 74 65 6D 20 53 45 45 20 41
4C 53 4F 0A 0A 4F 74 68 65 72 20 6D 61 6E 20 70 61 67 65 73 20 74 6F 20
63 68 65 63 6B 20 6F 75 74 2C 20 6C 69 6B 65 20 6D 61 6E 28 31 29 2C 20
6D 61 6E 28 37 29 2C 20 6D 61 6B 65 77 68 61 74 69 73 28 38 29 2C 20 6F
72 0A 63 61 74 6D 61 6E 28 38 29 2E 20 20 4E 6F 72 6D 61 6C 6C 79 20 61
20 73 69 6D 70 6C 65 20 6C 69 73 74 20 6F 66 20 6D 61 6E 20 70 61 67 65
73 20 73 65 70 61 72 61 74 65 64 20 62 79 20 63 6F 6D 6D 61 73 2C 20 6F
72 20 61 0A 70 61 72 61 67 72 61 70 68 20 67 69 76 69 6E 67 20 74 68 65
20 6E 61 6D 65 20 6F 66 20 61 20 72 65 66 65 72 65 6E 63 65 20 77 6F 72
6B 2E 20 20 4D 61 6E 20 70 61 67 65 20 72 65 66 65 72 65 6E 63 65 73 2C
20 69 66 20 74 68 65 79 0A 75 73 65 20 74 68 65 20 73 74 61 6E 64 61 72
64 20 43 3C 6E 61 6D 65 28 73 65 63 74 69 6F 6E 29 3E 20 66 6F 72 6D 2C
20 64 6F 6E 27 74 20 68 61 76 65 20 74 6F 20 62 65 20 65 6E 63 6C 6F 73
65 64 20 69 6E 0A 4C 45 3C 6C 74 3E 45 3C 67 74 3E 20 28 61 6C 74 68 6F
75 67 68 20 69 74 27 73 20 72 65 63 6F 6D 6D 65 6E 64 65 64 29 2C 20 62
75 74 20 6F 74 68 65 72 20 74 68 69 6E 67 73 20 69 6E 20 74 68 69 73 20
73 65 63 74 69 6F 6E 0A 70 72 6F 62 61 62 6C 79 20 73 68 6F 75 6C 64 20
62 65 20 77 68 65 6E 20 61 70 70 72 6F 70 72 69 61 74 65 2E 0A 0A 49 66
20 74 68 65 20 70 61 63 6B 61 67 65 20 68 61 73 20 61 20 6D 61 69 6C 69
6E 67 20 6C 69 73 74 2C 20 69 6E 63 6C 75 64 65 20 61 20 55 52 4C 20 6F
72 20 73 75 62 73 63 72 69 70 74 69 6F 6E 0A 69 6E 73 74 72 75 63 74 69
6F 6E 73 20 68 65 72 65 2E 0A 0A 49 66 20 74 68 65 20 70 61 63 6B 61 67
65 20 68 61 73 20 61 20 77 65 62 20 73 69 74 65 2C 20 69 6E 63 6C 75 64
65 20 61 20 55 52 4C 20 68 65 72 65 2E 0A 0A 3D 69 74 65 6D 20 41 55 54
48 4F 52 0A 0A 57 68 6F 20 77 72 6F 74 65 20 69 74 20 28 75 73 65 20 41
55 54 48 4F 52 53 20 66 6F 72 20 6D 75 6C 74 69 70 6C 65 20 70 65 6F 70
6C 65 29 2E 20 20 49 6E 63 6C 75 64 69 6E 67 20 79 6F 75 72 20 63 75 72
72 65 6E 74 0A 65 2D 6D 61 69 6C 20 61 64 64 72 65 73 73 20 28 6F 72 20
73 6F 6D 65 20 65 2D 6D 61 69 6C 20 61 64 64 72 65 73 73 20 74 6F 20 77
68 69 63 68 20 62 75 67 20 72 65 70 6F 72 74 73 20 73 68 6F 75 6C 64 20
62 65 20 73 65 6E 74 29 0A 73 6F 20 74 68 61 74 20 75 73 65 72 73 20 68
61 76 65 20 61 20 77 61 79 20 6F 66 20 63 6F 6E 74 61 63 74 69 6E 67 20
79 6F 75 20 69 73 20 61 20 67 6F 6F 64 20 69 64 65 61 2E 20 20 52 65 6D
65 6D 62 65 72 20 74 68 61 74 0A 70 72 6F 67 72 61 6D 20 64 6F 63 75 6D
65 6E 74 61 74 69 6F 6E 20 74 65 6E 64 73 20 74 6F 20 72 6F 61 6D 20 74
68 65 20 77 69 6C 64 20 66 6F 72 20 66 61 72 20 6C 6F 6E 67 65 72 20 74
68 61 6E 20 79 6F 75 20 65 78 70 65 63 74 0A 61 6E 64 20 70 69 63 6B 20
61 6E 20 65 2D 6D 61 69 6C 20 61 64 64 72 65 73 73 20 74 68 61 74 27 73
20 6C 69 6B 65 6C 79 20 74 6F 20 6C 61 73 74 20 69 66 20 70 6F 73 73 69
62 6C 65 2E 0A 0A 3D 69 74 65 6D 20 43 4F 50 59 52 49 47 48 54 20 41 4E
44 20 4C 49 43 45 4E 53 45 0A 0A 46 6F 72 20 63 6F 70 79 72 69 67 68 74
0A 0A 20 20 20 20 43 6F 70 79 72 69 67 68 74 20 59 45 41 52 28 73 29 20
62 79 20 59 4F 55 52 20 4E 41 4D 45 28 73 29 0A 0A 28 4E 6F 2C 20 28 43
29 20 69 73 20 6E 6F 74 20 6E 65 65 64 65 64 2E 20 20 4E 6F 2C 20 22 61
6C 6C 20 72 69 67 68 74 73 20 72 65 73 65 72 76 65 64 22 20 69 73 20 6E
6F 74 20 6E 65 65 64 65 64 2E 29 0A 0A 46 6F 72 20 6C 69 63 65 6E 73 69
6E 67 20 74 68 65 20 65 61 73 69 65 73 74 20 77 61 79 20 69 73 20 74 6F
20 75 73 65 20 74 68 65 20 73 61 6D 65 20 6C 69 63 65 6E 73 69 6E 67 20
61 73 20 50 65 72 6C 20 69 74 73 65 6C 66 3A 0A 0A 20 20 20 20 54 68 69
73 20 6C 69 62 72 61 72 79 20 69 73 20 66 72 65 65 20 73 6F 66 74 77 61
72 65 3B 20 79 6F 75 20 6D 61 79 20 72 65 64 69 73 74 72 69 62 75 74 65
20 69 74 20 61 6E 64 2F 6F 72 20 6D 6F 64 69 66 79 0A 20 20 20 20 69 74
20 75 6E 64 65 72 20 74 68 65 20 73 61 6D 65 20 74 65 72 6D 73 20 61 73
20 50 65 72 6C 20 69 74 73 65 6C 66 2E 0A 0A 54 68 69 73 20 6D 61 6B 65
73 20 69 74 20 65 61 73 79 20 66 6F 72 20 70 65 6F 70 6C 65 20 74 6F 20
75 73 65 20 79 6F 75 72 20 6D 6F 64 75 6C 65 20 77 69 74 68 20 50 65 72
6C 2E 20 20 4E 6F 74 65 20 74 68 61 74 0A 74 68 69 73 20 6C 69 63 65 6E
73 69 6E 67 20 69 73 20 6E 65 69 74 68 65 72 20 61 6E 20 65 6E 64 6F 72
73 65 6D 65 6E 74 20 6F 72 20 61 20 72 65 71 75 69 72 65 6D 65 6E 74 2C
20 79 6F 75 20 61 72 65 20 6F 66 0A 63 6F 75 72 73 65 20 66 72 65 65 20
74 6F 20 63 68 6F 6F 73 65 20 61 6E 79 20 6C 69 63 65 6E 73 69 6E 67 2E
0A 0A 3D 69 74 65 6D 20 48 49 53 54 4F 52 59 0A 0A 50 72 6F 67 72 61 6D
73 20 64 65 72 69 76 65 64 20 66 72 6F 6D 20 6F 74 68 65 72 20 73 6F 75
72 63 65 73 20 73 6F 6D 65 74 69 6D 65 73 20 68 61 76 65 20 74 68 69 73
2C 20 6F 72 20 79 6F 75 20 6D 69 67 68 74 20 6B 65 65 70 0A 61 20 6D 6F
64 69 66 69 63 61 74 69 6F 6E 20 6C 6F 67 20 68 65 72 65 2E 20 20 49 66
20 74 68 65 20 6C 6F 67 20 67 65 74 73 20 6F 76 65 72 6C 79 20 6C 6F 6E
67 20 6F 72 20 64 65 74 61 69 6C 65 64 2C 0A 63 6F 6E 73 69 64 65 72 20
6D 61 69 6E 74 61 69 6E 69 6E 67 20 69 74 20 69 6E 20 61 20 73 65 70 61
72 61 74 65 20 66 69 6C 65 2C 20 74 68 6F 75 67 68 2E 0A 0A 3D 62 61 63
6B 0A 0A 49 6E 20 61 64 64 69 74 69 6F 6E 2C 20 73 6F 6D 65 20 73 79 73
74 65 6D 73 20 75 73 65 20 43 4F 4E 46 4F 52 4D 49 4E 47 20 54 4F 20 74
6F 20 6E 6F 74 65 20 63 6F 6E 66 6F 72 6D 61 6E 63 65 20 74 6F 20 72 65
6C 65 76 61 6E 74 0A 73 74 61 6E 64 61 72 64 73 20 61 6E 64 20 4D 54 2D
4C 45 56 45 4C 20 74 6F 20 6E 6F 74 65 20 73 61 66 65 6E 65 73 73 20 66
6F 72 20 75 73 65 20 69 6E 20 74 68 72 65 61 64 65 64 20 70 72 6F 67 72
61 6D 73 20 6F 72 0A 73 69 67 6E 61 6C 20 68 61 6E 64 6C 65 72 73 2E 20
20 54 68 65 73 65 20 68 65 61 64 69 6E 67 73 20 61 72 65 20 70 72 69 6D
61 72 69 6C 79 20 75 73 65 66 75 6C 20 77 68 65 6E 20 64 6F 63 75 6D 65
6E 74 69 6E 67 20 70 61 72 74 73 0A 6F 66 20 61 20 43 20 6C 69 62 72 61
72 79 2E 20 20 44 6F 63 75 6D 65 6E 74 61 74 69 6F 6E 20 6F 66 20 6F 62
6A 65 63 74 2D 6F 72 69 65 6E 74 65 64 20 6C 69 62 72 61 72 69 65 73 20
6F 72 20 6D 6F 64 75 6C 65 73 20 6D 61 79 0A 75 73 65 20 43 4F 4E 53 54
52 55 43 54 4F 52 53 20 61 6E 64 20 4D 45 54 48 4F 44 53 20 73 65 63 74
69 6F 6E 73 20 66 6F 72 20 64 65 74 61 69 6C 65 64 20 64 6F 63 75 6D 65
6E 74 61 74 69 6F 6E 20 6F 66 20 74 68 65 0A 70 61 72 74 73 20 6F 66 20
74 68 65 20 6C 69 62 72 61 72 79 20 61 6E 64 20 73 61 76 65 20 74 68 65
20 44 45 53 43 52 49 50 54 49 4F 4E 20 73 65 63 74 69 6F 6E 20 66 6F 72
20 61 6E 20 6F 76 65 72 76 69 65 77 3B 20 6F 74 68 65 72 0A 6C 61 72 67
65 20 6D 6F 64 75 6C 65 73 20 6D 61 79 20 75 73 65 20 46 55 4E 43 54 49
4F 4E 53 20 66 6F 72 20 73 69 6D 69 6C 61 72 20 72 65 61 73 6F 6E 73 2E
20 20 53 6F 6D 65 20 70 65 6F 70 6C 65 20 75 73 65 0A 4F 56 45 52 56 49
45 57 20 74 6F 20 73 75 6D 6D 61 72 69 7A 65 20 74 68 65 20 64 65 73 63
72 69 70 74 69 6F 6E 20 69 66 20 69 74 27 73 20 71 75 69 74 65 20 6C 6F
6E 67 2E 0A 0A 53 65 63 74 69 6F 6E 20 6F 72 64 65 72 69 6E 67 20 76 61
72 69 65 73 2C 20 61 6C 74 68 6F 75 67 68 20 4E 41 4D 45 20 73 68 6F 75
6C 64 20 49 3C 61 6C 77 61 79 73 3E 20 62 65 20 74 68 65 20 66 69 72 73
74 20 73 65 63 74 69 6F 6E 0A 28 79 6F 75 27 6C 6C 20 62 72 65 61 6B 20
73 6F 6D 65 20 6D 61 6E 20 70 61 67 65 20 73 79 73 74 65 6D 73 20 6F 74
68 65 72 77 69 73 65 29 2C 20 61 6E 64 20 4E 41 4D 45 2C 20 53 59 4E 4F
50 53 49 53 2C 0A 44 45 53 43 52 49 50 54 49 4F 4E 2C 20 61 6E 64 20 4F
50 54 49 4F 4E 53 20 67 65 6E 65 72 61 6C 6C 79 20 61 6C 77 61 79 73 20
6F 63 63 75 72 20 66 69 72 73 74 20 61 6E 64 20 69 6E 20 74 68 61 74 20
6F 72 64 65 72 20 69 66 0A 70 72 65 73 65 6E 74 2E 20 20 49 6E 20 67 65
6E 65 72 61 6C 2C 20 53 45 45 20 41 4C 53 4F 2C 20 41 55 54 48 4F 52 2C
20 61 6E 64 20 73 69 6D 69 6C 61 72 20 6D 61 74 65 72 69 61 6C 20 73 68
6F 75 6C 64 20 62 65 20 6C 65 66 74 0A 66 6F 72 20 6C 61 73 74 2E 20 20
53 6F 6D 65 20 73 79 73 74 65 6D 73 20 61 6C 73 6F 20 6D 6F 76 65 20 57
41 52 4E 49 4E 47 53 20 61 6E 64 20 4E 4F 54 45 53 20 74 6F 20 6C 61 73
74 2E 20 20 54 68 65 20 6F 72 64 65 72 0A 67 69 76 65 6E 20 61 62 6F 76
65 20 73 68 6F 75 6C 64 20 62 65 20 72 65 61 73 6F 6E 61 62 6C 65 20 66
6F 72 20 6D 6F 73 74 20 70 75 72 70 6F 73 65 73 2E 0A 0A 46 69 6E 61 6C
6C 79 2C 20 61 73 20 61 20 67 65 6E 65 72 61 6C 20 6E 6F 74 65 2C 20 74
72 79 20 6E 6F 74 20 74 6F 20 75 73 65 20 61 6E 20 65 78 63 65 73 73 69
76 65 20 61 6D 6F 75 6E 74 20 6F 66 20 6D 61 72 6B 75 70 2E 0A 41 73 20
64 6F 63 75 6D 65 6E 74 65 64 20 68 65 72 65 20 61 6E 64 20 69 6E 20 4C
3C 50 6F 64 3A 3A 4D 61 6E 3E 2C 20 79 6F 75 20 63 61 6E 20 73 61 66 65
6C 79 20 6C 65 61 76 65 20 50 65 72 6C 20 76 61 72 69 61 62 6C 65 73 2C
0A 66 75 6E 63 74 69 6F 6E 20 6E 61 6D 65 73 2C 20 6D 61 6E 20 70 61 67
65 20 72 65 66 65 72 65 6E 63 65 73 2C 20 61 6E 64 20 74 68 65 20 6C 69
6B 65 20 75 6E 61 64 6F 72 6E 65 64 20 62 79 20 6D 61 72 6B 75 70 20 61
6E 64 0A 74 68 65 20 50 4F 44 20 74 72 61 6E 73 6C 61 74 6F 72 73 20 77
69 6C 6C 20 66 69 67 75 72 65 20 69 74 20 6F 75 74 20 66 6F 72 20 79 6F
75 2E 20 20 54 68 69 73 20 6D 61 6B 65 73 20 69 74 20 6D 75 63 68 20 65
61 73 69 65 72 0A 74 6F 20 6C 61 74 65 72 20 65 64 69 74 20 74 68 65 20
64 6F 63 75 6D 65 6E 74 61 74 69 6F 6E 2E 20 20 4E 6F 74 65 20 74 68 61
74 20 6D 61 6E 79 20 65 78 69 73 74 69 6E 67 20 74 72 61 6E 73 6C 61 74
6F 72 73 0A 28 69 6E 63 6C 75 64 69 6E 67 20 74 68 69 73 20 6F 6E 65 20
63 75 72 72 65 6E 74 6C 79 29 20 77 69 6C 6C 20 64 6F 20 74 68 65 20 77
72 6F 6E 67 20 74 68 69 6E 67 20 77 69 74 68 20 65 2D 6D 61 69 6C 20 61
64 64 72 65 73 73 65 73 0A 6F 72 20 55 52 4C 73 20 77 68 65 6E 20 77 72
61 70 70 65 64 20 69 6E 20 4C 45 3C 6C 74 3E 45 3C 67 74 3E 2C 20 73 6F
20 64 6F 6E 27 74 20 64 6F 20 74 68 61 74 2E 0A 0A 46 6F 72 20 61 64 64
69 74 69 6F 6E 61 6C 20 69 6E 66 6F 72 6D 61 74 69 6F 6E 20 74 68 61 74
20 6D 61 79 20 62 65 20 6D 6F 72 65 20 61 63 63 75 72 61 74 65 20 66 6F
72 20 79 6F 75 72 20 73 70 65 63 69 66 69 63 0A 73 79 73 74 65 6D 2C 20
73 65 65 20 65 69 74 68 65 72 20 4C 3C 6D 61 6E 28 35 29 3E 20 6F 72 20
4C 3C 6D 61 6E 28 37 29 3E 20 64 65 70 65 6E 64 69 6E 67 20 6F 6E 20 79
6F 75 72 20 73 79 73 74 65 6D 20 6D 61 6E 75 61 6C 0A 73 65 63 74 69 6F
6E 20 6E 75 6D 62 65 72 69 6E 67 20 63 6F 6E 76 65 6E 74 69 6F 6E 73 2E
0A 0A 3D 68 65 61 64 31 20 53 45 45 20 41 4C 53 4F 0A 0A 4C 3C 50 6F 64
3A 3A 4D 61 6E 3E 2C 20 4C 3C 50 6F 64 3A 3A 50 61 72 73 65 72 3E 2C 20
4C 3C 6D 61 6E 28 31 29 3E 2C 20 4C 3C 6E 72 6F 66 66 28 31 29 3E 2C 20
4C 3C 70 6F 64 63 68 65 63 6B 65 72 28 31 29 3E 2C 0A 4C 3C 74 72 6F 66
66 28 31 29 3E 2C 20 4C 3C 6D 61 6E 28 37 29 3E 0A 0A 54 68 65 20 6D 61
6E 20 70 61 67 65 20 64 6F 63 75 6D 65 6E 74 69 6E 67 20 74 68 65 20 61
6E 20 6D 61 63 72 6F 20 73 65 74 20 6D 61 79 20 62 65 20 4C 3C 6D 61 6E
28 35 29 3E 20 69 6E 73 74 65 61 64 20 6F 66 0A 4C 3C 6D 61 6E 28 37 29
3E 20 6F 6E 20 79 6F 75 72 20 73 79 73 74 65 6D 2E 0A 0A 54 68 65 20 63
75 72 72 65 6E 74 20 76 65 72 73 69 6F 6E 20 6F 66 20 74 68 69 73 20 73
63 72 69 70 74 20 69 73 20 61 6C 77 61 79 73 20 61 76 61 69 6C 61 62 6C
65 20 66 72 6F 6D 20 69 74 73 20 77 65 62 20 73 69 74 65 20 61 74 0A 4C
3C 68 74 74 70 3A 2F 2F 77 77 77 2E 65 79 72 69 65 2E 6F 72 67 2F 7E 65
61 67 6C 65 2F 73 6F 66 74 77 61 72 65 2F 70 6F 64 6C 61 74 6F 72 73 2F
3E 2E 20 20 49 74 20 69 73 20 61 6C 73 6F 20 70 61 72 74 20 6F 66 20 74
68 65 0A 50 65 72 6C 20 63 6F 72 65 20 64 69 73 74 72 69 62 75 74 69 6F
6E 20 61 73 20 6F 66 20 35 2E 36 2E 30 2E 0A 0A 3D 68 65 61 64 31 20 41
55 54 48 4F 52 0A 0A 52 75 73 73 20 41 6C 6C 62 65 72 79 20 3C 72 72 61
40 73 74 61 6E 66 6F 72 64 2E 65 64 75 3E 2C 20 62 61 73 65 64 20 49 3C
76 65 72 79 3E 20 68 65 61 76 69 6C 79 20 6F 6E 20 74 68 65 20 6F 72 69
67 69 6E 61 6C 0A 42 3C 70 6F 64 32 6D 61 6E 3E 20 62 79 20 4C 61 72 72
79 20 57 61 6C 6C 20 61 6E 64 20 54 6F 6D 20 43 68 72 69 73 74 69 61 6E
73 65 6E 2E 20 20 4C 61 72 67 65 20 70 6F 72 74 69 6F 6E 73 20 6F 66 20
74 68 69 73 0A 64 6F 63 75 6D 65 6E 74 61 74 69 6F 6E 2C 20 70 61 72 74
69 63 75 6C 61 72 6C 79 20 74 68 65 20 73 65 63 74 69 6F 6E 73 20 6F 6E
20 74 68 65 20 61 6E 61 74 6F 6D 79 20 6F 66 20 61 20 70 72 6F 70 65 72
20 6D 61 6E 0A 70 61 67 65 2C 20 61 72 65 20 74 61 6B 65 6E 20 66 72 6F
6D 20 74 68 65 20 42 3C 70 6F 64 32 6D 61 6E 3E 20 64 6F 63 75 6D 65 6E
74 61 74 69 6F 6E 20 62 79 20 54 6F 6D 2E 0A 0A 3D 68 65 61 64 31 20 43
4F 50 59 52 49 47 48 54 20 41 4E 44 20 4C 49 43 45 4E 53 45 0A 0A 43 6F
70 79 72 69 67 68 74 20 31 39 39 39 2C 20 32 30 30 30 2C 20 32 30 30 31
20 62 79 20 52 75 73 73 20 41 6C 6C 62 65 72 79 20 3C 72 72 61 40 73 74
61 6E 66 6F 72 64 2E 65 64 75 3E 2E 0A 0A 54 68 69 73 20 70 72 6F 67 72
61 6D 20 69 73 20 66 72 65 65 20 73 6F 66 74 77 61 72 65 3B 20 79 6F 75
20 6D 61 79 20 72 65 64 69 73 74 72 69 62 75 74 65 20 69 74 20 61 6E 64
2F 6F 72 20 6D 6F 64 69 66 79 20 69 74 0A 75 6E 64 65 72 20 74 68 65 20
73 61 6D 65 20 74 65 72 6D 73 20 61 73 20 50 65 72 6C 20 69 74 73 65 6C
66 2E 0A 0A 3D 63 75 74 0A | #!/usr/bin/perl eval
'exec /usr/bin/perl -S
$0 ${1+"$@"}' if
$running_under_some_she
ll; # pod2man -- Conver
t POD data to formatted
*roff input. # $Id: pod2
man.PL,v 1.10 2002/07/15
05:45:56 eagle Exp $ #
# Copyright 1999, 2000,
2001 by Russ Allbery <rr
a@stanford.edu> # # This
program is free softwar
e; you may redistribute
it and/or modify it # un
der the same terms as Pe
rl itself. require 5.00
4; use Getopt::Long qw(
GetOptions); use Pod::Ma
n (); use Pod::Usage qw(
pod2usage); use strict;
# Silence -w warnings.
use vars qw($running_un
der_some_shell); # Inse
rt -- into @ARGV before
any single dash argument
to hide it from # Getop
t::Long; we want to inte
rpret it as meaning stdi
n (which Pod::Parser # d
oes correctly). my $stdi
n; @ARGV = map { $_ eq '
-' && !$stdin++ ? ('--',
$_) : $_ } @ARGV; # Pa
rse our options, trying
to retain backwards comp
atibility with pod2man b
ut # allowing short form
s as well. --lax is cur
rently ignored. my %opti
ons; Getopt::Long::confi
g ('bundling_override');
GetOptions (\%options,
'section|s=s', 'release|
r:s', 'center|c=s',
'date|d=s', 'fix
ed=s', 'fixedbold=s', 'f
ixeditalic=s',
'fixedbolditalic=s',
'name|n=s', 'official|o'
, 'quotes|q=s',
'lax|l', 'help|h', '
verbose|v') or exit 1; p
od2usage (0) if $options
{help}; # Official sets
--center, but don't ove
rride things explicitly
set. if ($options{offici
al} && !defined $options
{center}) { $options
{center} = 'Perl Program
mers Reference Guide'; }
# Verbose is only our
flag, not a Pod::Man fla
g. my $verbose = $option
s{verbose}; delete $opti
ons{verbose}; # This is
n't a valid Pod::Man opt
ion and is only accepted
for backwards # compati
bility. delete $options{
lax}; # Initialize and
run the formatter, pulli
ng a pair of input and o
utput off at # a time. m
y $parser = Pod::Man->ne
w (%options); my @files;
do { @files = splic
e (@ARGV, 0, 2); pri
nt " $files[1]\n" if $v
erbose; $parser->par
se_from_file (@files); }
while (@ARGV); __END__
=head1 NAME pod2man -
Convert POD data to for
matted *roff input =hea
d1 SYNOPSIS pod2man [B<
--section>=I<manext>] [B
<--release>=I<version>]
[B<--center>=I<string>]
[B<--date>=I<string>] [B
<--fixed>=I<font>] [B<--
fixedbold>=I<font>] [B<-
-fixeditalic>=I<font>] [
B<--fixedbolditalic>=I<f
ont>] [B<--name>=I<name>
] [B<--official>] [B<--l
ax>] [B<--quotes>=I<quot
es>] [B<--verbose>] [I<i
nput> [I<output>] ...]
pod2man B<--help> =head
1 DESCRIPTION B<pod2man
> is a front-end for Pod
::Man, using it to gener
ate *roff input from POD
source. The resulting
*roff code is suitable f
or display on a terminal
using nroff(1), normall
y via man(1), or printin
g using troff(1). I<inp
ut> is the file to read
for POD source (the POD
can be embedded in code)
. If I<input> isn't giv
en, it defaults to STDIN
. I<output>, if given,
is the file to which to
write the formatted outp
ut. If I<output> isn't
given, the formatted out
put is written to STDOUT
. Several POD files can
be processed in the sam
e B<pod2man> invocation
(saving module load and
compile times) by provid
ing multiple pairs of I<
input> and I<output> fil
es on the command line.
B<--section>, B<--relea
se>, B<--center>, B<--da
te>, and B<--official> c
an be used to set the he
aders and footers to use
; if not given, Pod::Man
will assume various def
aults. See below or L<P
od::Man> for details. B
<pod2man> assumes that y
our *roff formatters hav
e a fixed-width font nam
ed CW. If yours is call
ed something else (like
CR), use B<--fixed> to s
pecify it. This general
ly only matters for trof
f output for printing.
Similarly, you can set t
he fonts used for bold,
italic, and bold italic
fixed-width output. Bes
ides the obvious pod con
versions, Pod::Man, and
therefore pod2man also t
akes care of formatting
func(), func(n), and sim
ple variable references
like $foo or @bar so you
don't have to use code
escapes for them; comple
x expressions like C<$fr
ed{'stuff'}> will still
need to be escaped, thou
gh. It also translates d
ashes that aren't used a
s hyphens into en dashes
, makes long dashes--lik
e this--into proper em d
ashes, fixes "paired quo
tes," and takes care of
several other troff-spec
ific tweaks. See L<Pod:
:Man> for complete infor
mation. =head1 OPTIONS
=over 4 =item B<-c> I<
string>, B<--center>=I<s
tring> Sets the centere
d page header to I<strin
g>. The default is "Use
r Contributed Perl Docum
entation", but also see
B<--official> below. =i
tem B<-d> I<string>, B<-
-date>=I<string> Set th
e left-hand footer strin
g to this value. By def
ault, the modification d
ate of the input file wi
ll be used, or the curre
nt date if input comes f
rom STDIN. =item B<--fi
xed>=I<font> The fixed-
width font to use for ve
rtabim text and code. D
efaults to CW. Some syst
ems may want CR instead.
Only matters for troff
(1) output. =item B<--f
ixedbold>=I<font> Bold
version of the fixed-wid
th font. Defaults to CB
. Only matters for trof
f(1) output. =item B<--
fixeditalic>=I<font> It
alic version of the fixe
d-width font (actually,
something of a misnomer,
since most fixed-width
fonts only have an obliq
ue version, not an itali
c version). Defaults to
CI. Only matters for t
roff(1) output. =item B
<--fixedbolditalic>=I<fo
nt> Bold italic (probab
ly actually oblique) ver
sion of the fixed-width
font. Pod::Man doesn't a
ssume you have this, and
defaults to CB. Some s
ystems (such as Solaris)
have this font availabl
e as CX. Only matters f
or troff(1) output. =it
em B<-h>, B<--help> Pri
nt out usage information
. =item B<-l>, B<--lax>
No longer used. B<pod
2man> used to check its
input for validity as a
manual page, but this sh
ould now be done by L<po
dchecker(1)> instead. A
ccepted for backwards co
mpatibility; this option
no longer does anything
. =item B<-n> I<name>,
B<--name>=I<name> Set t
he name of the manual pa
ge to I<name>. Without
this option, the manual
name is set to the upper
cased base name of the f
ile being converted unle
ss the manual section is
3, in which case the pa
th is parsed to see if i
t is a Perl module path.
If it is, a path like
C<.../lib/Pod/Man.pm> is
converted into a name l
ike C<Pod::Man>. This o
ption, if given, overrid
es any automatic determi
nation of the name. Not
e that this option is pr
obably not useful when c
onverting multiple POD f
iles at once. The conve
ntion for Unix man pages
for commands is for the
man page title to be in
all-uppercase even if t
he command isn't. =item
B<-o>, B<--official> S
et the default header to
indicate that this page
is part of the standard
Perl release, if B<--ce
nter> is not also given.
=item B<-q> I<quotes>,
B<--quotes>=I<quotes>
Sets the quote marks use
d to surround CE<lt>> te
xt to I<quotes>. If I<q
uotes> is a single chara
cter, it is used as both
the left and right quot
e; if I<quotes> is two c
haracters, the first cha
racter is used as the le
ft quote and the second
as the right quoted; and
if I<quotes> is four ch
aracters, the first two
are used as the left quo
te and the second two as
the right quote. I<quo
tes> may also be set to
the special value C<none
>, in which case no quot
e marks are added around
CE<lt>> text (but the f
ont is still changed for
troff output). =item B
<-r>, B<--release> Set
the centered footer. By
default, this is the ve
rsion of Perl you run B<
pod2man> under. Note th
at some system an macro
sets assume that the cen
tered footer will be a m
odification date and wil
l prepend something like
"Last modified: "; if t
his is the case, you may
want to set B<--release
> to the last modified d
ate and B<--date> to the
version number. =item
B<-s>, B<--section> Set
the section for the C<.
TH> macro. The standard
section numbering conve
ntion is to use 1 for us
er commands, 2 for syste
m calls, 3 for functions
, 4 for devices, 5 for f
ile formats, 6 for games
, 7 for miscellaneous in
formation, and 8 for adm
inistrator commands. Th
ere is a lot of variatio
n here, however; some sy
stems (like Solaris) use
4 for file formats, 5 f
or miscellaneous informa
tion, and 7 for devices.
Still others use 1m in
stead of 8, or some mix
of both. About the only
section numbers that ar
e reliably consistent ar
e 1, 2, and 3. By defau
lt, section 1 will be us
ed unless the file ends
in .pm in which case sec
tion 3 will be selected.
=item B<-v>, B<--verbo
se> Print out the name
of each output file as i
t is being generated. =
back =head1 DIAGNOSTICS
If B<pod2man> fails wi
th errors, see L<Pod::Ma
n> and L<Pod::Parser> fo
r information about what
those errors might mean
. =head1 EXAMPLES
pod2man program > progra
m.1 pod2man SomeModu
le.pm /usr/perl/man/man3
/SomeModule.3 pod2ma
n --section=7 note.pod >
note.7 If you would li
ke to print out a lot of
man page continuously,
you probably want to set
the C and D registers t
o set contiguous page nu
mbering and even/odd pag
ing, at least on some ve
rsions of man(7). t
roff -man -rC1 -rD1 perl
.1 perldata.1 perlsyn.1
... To get index entrie
s on stderr, turn on the
F register, as in:
troff -man -rF1 perl.1
The indexing merely out
puts messages via C<.tm>
for each major page, se
ction, subsection, item,
and any C<XE<lt>E<gt>>
directives. See L<Pod::
Man> for more details.
=head1 BUGS Lots of thi
s documentation is dupli
cated from L<Pod::Man>.
=head1 NOTES For those
not sure of the proper
layout of a man page, he
re are some notes on wri
ting a proper man page.
The name of the program
being documented is con
ventionally written in b
old (using BE<lt>E<gt>)
wherever it occurs, as a
re all program options.
Arguments should be writ
ten in italics (IE<lt>E<
gt>). Functions are tra
ditionally written in it
alics; if you write a fu
nction as function(), Po
d::Man will take care of
this for you. Literal
code or commands should
be in CE<lt>E<gt>. Refe
rences to other man page
s should be in the form
C<manpage(section)>, and
Pod::Man will automatic
ally format those approp
riately. As an exceptio
n, it's traditional not
to use this form when re
ferring to module docume
ntation; use C<LE<lt>Mod
ule::NameE<gt>> instead.
References to other pr
ograms or functions are
normally in the form of
man page references so t
hat cross-referencing to
ols can provide the user
with links and the like
. It's possible to over
do this, though, so be c
areful not to clutter yo
ur documentation with to
o much markup. The majo
r headers should be set
out using a C<=head1> di
rective, and are histori
cally written in the rat
her startling ALL UPPER
CASE format, although th
is is not mandatory. Mi
nor headers may be inclu
ded using C<=head2>, and
are typically in mixed
case. The standard sect
ions of a manual page ar
e: =over 4 =item NAME
Mandatory section; shou
ld be a comma-separated
list of programs or func
tions documented by this
podpage, such as:
foo, bar - programs to d
o something Manual page
indexers are often extr
emely picky about the fo
rmat of this section, so
don't put anything in i
t except this line. A s
ingle dash, and only a s
ingle dash, should separ
ate the list of programs
or functions from the d
escription. Functions s
hould not be qualified w
ith C<()> or the like. T
he description should id
eally fit on a single li
ne, even if a man progra
m replaces the dash with
a few tabs. =item SYNO
PSIS A short usage summ
ary for programs and fun
ctions. This section is
mandatory for section 3
pages. =item DESCRIPTI
ON Extended description
and discussion of the p
rogram or functions, or
the body of the document
ation for man pages that
document something else
. If particularly long,
it's a good idea to bre
ak this up into subsecti
ons C<=head2> directives
like: =head2 Norma
l Usage =head2 Adva
nced Features =head
2 Writing Configuration
Files or whatever is ap
propriate for your docum
entation. =item OPTIONS
Detailed description o
f each of the command-li
ne options taken by the
program. This should be
separate from the descr
iption for the use of th
ings like L<Pod::Usage|P
od::Usage>. This is nor
mally presented as a lis
t, with each option as a
separate C<=item>. The
specific option string
should be enclosed in BE
<lt>E<gt>. Any values t
hat the option takes sho
uld be enclosed in IE<lt
>E<gt>. For example, th
e section for the option
B<--section>=I<manext>
would be introduced with
: =item B<--section
>=I<manext> Synonymous
options (like both the s
hort and long forms) are
separated by a comma an
d a space on the same C<
=item> line, or optional
ly listed as their own i
tem with a reference to
the canonical name. For
example, since B<--sect
ion> can also be written
as B<-s>, the above wou
ld be: =item B<-s>
I<manext>, B<--section>=
I<manext> (Writing the
short option first is ar
guably easier to read, s
ince the long option is
long enough to draw the
eye to it anyway and the
short option can otherw
ise get lost in visual n
oise.) =item RETURN VAL
UE What the program or
function returns, if suc
cessful. This section c
an be omitted for progra
ms whose precise exit co
des aren't important, pr
ovided they return 0 on
success as is standard.
It should always be pre
sent for functions. =it
em ERRORS Exceptions, e
rror return codes, exit
statuses, and errno sett
ings. Typically used for
function documentation;
program documentation u
ses DIAGNOSTICS instead.
The general rule of th
umb is that errors print
ed to STDOUT or STDERR a
nd intended for the end
user are documented in D
IAGNOSTICS while errors
passed internal to the c
alling program and inten
ded for other programmer
s are documented in ERRO
RS. When documenting a
function that sets errno
, a full list of the pos
sible errno values shoul
d be given here. =item
DIAGNOSTICS All possibl
e messages the program c
an print out--and what t
hey mean. You may wish
to follow the same docum
entation style as the Pe
rl documentation; see pe
rldiag(1) for more detai
ls (and look at the POD
source as well). If app
licable, please include
details on what the user
should do to correct th
e error; documenting an
error as indicating "the
input buffer is too sma
ll" without telling the
user how to increase the
size of the input buffe
r (or at least telling t
hem that it isn't possib
le) aren't very useful.
=item EXAMPLES Give so
me example uses of the p
rogram or function. Don
't skimp; users often fi
nd this the most useful
part of the documentatio
n. The examples are gen
erally given as verbatim
paragraphs. Don't just
present an example with
out explaining what it d
oes. Adding a short par
agraph saying what the e
xample will do can incre
ase the value of the exa
mple immensely. =item E
NVIRONMENT Environment
variables that the progr
am cares about, normally
presented as a list usi
ng C<=over>, C<=item>, a
nd C<=back>. For exampl
e: =over 6 =it
em HOME Used to det
ermine the user's home d
irectory. F<.foorc> in
this directory is re
ad for configuration det
ails, if it exists.
=back Since environmen
t variables are normally
in all uppercase, no ad
ditional special formatt
ing is generally needed;
they're glaring enough
as it is. =item FILES
All files used by the pr
ogram or function, norma
lly presented as a list,
and what it uses them f
or. File names should b
e enclosed in FE<lt>E<gt
>. It's particularly im
portant to document file
s that will be potential
ly modified. =item CAVE
ATS Things to take spec
ial care with, sometimes
called WARNINGS. =item
BUGS Things that are b
roken or just don't work
quite right. =item RES
TRICTIONS Bugs you don'
t plan to fix. :-) =it
em NOTES Miscellaneous
commentary. =item SEE A
LSO Other man pages to
check out, like man(1),
man(7), makewhatis(8), o
r catman(8). Normally a
simple list of man page
s separated by commas, o
r a paragraph giving the
name of a reference wor
k. Man page references,
if they use the standar
d C<name(section)> form,
don't have to be enclos
ed in LE<lt>E<gt> (altho
ugh it's recommended), b
ut other things in this
section probably should
be when appropriate. If
the package has a maili
ng list, include a URL o
r subscription instructi
ons here. If the packag
e has a web site, includ
e a URL here. =item AUT
HOR Who wrote it (use A
UTHORS for multiple peop
le). Including your cur
rent e-mail address (or
some e-mail address to w
hich bug reports should
be sent) so that users h
ave a way of contacting
you is a good idea. Rem
ember that program docum
entation tends to roam t
he wild for far longer t
han you expect and pick
an e-mail address that's
likely to last if possi
ble. =item COPYRIGHT AN
D LICENSE For copyright
Copyright YEAR(s)
by YOUR NAME(s) (No, (C
) is not needed. No, "a
ll rights reserved" is n
ot needed.) For licensi
ng the easiest way is to
use the same licensing
as Perl itself: Thi
s library is free softwa
re; you may redistribute
it and/or modify it
under the same terms as
Perl itself. This make
s it easy for people to
use your module with Per
l. Note that this licen
sing is neither an endor
sement or a requirement,
you are of course free
to choose any licensing.
=item HISTORY Program
s derived from other sou
rces sometimes have this
, or you might keep a mo
dification log here. If
the log gets overly lon
g or detailed, consider
maintaining it in a sepa
rate file, though. =bac
k In addition, some sys
tems use CONFORMING TO t
o note conformance to re
levant standards and MT-
LEVEL to note safeness f
or use in threaded progr
ams or signal handlers.
These headings are prim
arily useful when docume
nting parts of a C libra
ry. Documentation of ob
ject-oriented libraries
or modules may use CONST
RUCTORS and METHODS sect
ions for detailed docume
ntation of the parts of
the library and save the
DESCRIPTION section for
an overview; other larg
e modules may use FUNCTI
ONS for similar reasons.
Some people use OVERVI
EW to summarize the desc
ription if it's quite lo
ng. Section ordering va
ries, although NAME shou
ld I<always> be the firs
t section (you'll break
some man page systems ot
herwise), and NAME, SYNO
PSIS, DESCRIPTION, and O
PTIONS generally always
occur first and in that
order if present. In ge
neral, SEE ALSO, AUTHOR,
and similar material sh
ould be left for last.
Some systems also move W
ARNINGS and NOTES to las
t. The order given abov
e should be reasonable f
or most purposes. Final
ly, as a general note, t
ry not to use an excessi
ve amount of markup. As
documented here and in L
<Pod::Man>, you can safe
ly leave Perl variables,
function names, man pag
e references, and the li
ke unadorned by markup a
nd the POD translators w
ill figure it out for yo
u. This makes it much e
asier to later edit the
documentation. Note tha
t many existing translat
ors (including this one
currently) will do the w
rong thing with e-mail a
ddresses or URLs when wr
apped in LE<lt>E<gt>, so
don't do that. For add
itional information that
may be more accurate fo
r your specific system,
see either L<man(5)> or
L<man(7)> depending on y
our system manual sectio
n numbering conventions.
=head1 SEE ALSO L<Pod
::Man>, L<Pod::Parser>,
L<man(1)>, L<nroff(1)>,
L<podchecker(1)>, L<trof
f(1)>, L<man(7)> The ma
n page documenting the a
n macro set may be L<man
(5)> instead of L<man(7)
> on your system. The c
urrent version of this s
cript is always availabl
e from its web site at L
<http://www.eyrie.org/~e
agle/software/podlators/
>. It is also part of t
he Perl core distributio
n as of 5.6.0. =head1 A
UTHOR Russ Allbery <rra
@stanford.edu>, based I<
very> heavily on the ori
ginal B<pod2man> by Larr
y Wall and Tom Christian
sen. Large portions of
this documentation, part
icularly the sections on
the anatomy of a proper
man page, are taken fro
m the B<pod2man> documen
tation by Tom. =head1 C
OPYRIGHT AND LICENSE Co
pyright 1999, 2000, 2001
by Russ Allbery <rra@st
anford.edu>. This progr
am is free software; you
may redistribute it and
/or modify it under the
same terms as Perl itsel
f. =cut |