Check-in [b2c948dd8a]
Not logged in
Home Help Timeline Files Branches Tags Forum Tickets Wiki More... Login
Overview
Comment:Minor refactoring to centralize handling of the login cookie checks.
Downloads: Tarball | ZIP archive | SQL archive
Timelines: family | ancestors | descendants | both | trunk
Files: files | file ages | folders
SHA1: b2c948dd8aeb51fd9b622bc4bbbda40fd603c600
User & Date: mistachkin on 2024-06-14 21:58:32
Other Links: manifest | tags
Context
2024-07-13
06:27
Update use of the 'tcl load' sub-command. Now requires Beta 55 of Eagle. check-in: 03fae306b8 user: mistachkin tags: trunk
2024-06-14
21:58
Minor refactoring to centralize handling of the login cookie checks. check-in: b2c948dd8a user: mistachkin tags: trunk
2024-06-03
04:37
Update docs. check-in: 96fc9afa4e user: mistachkin tags: trunk
Changes
Hide Diffs Side-by-Side Diffs Ignore Whitespace Patch

Modified client/1.0/neutral/pkgd.eagle from [50ec21baae] to [f5323e45b7].

︙
1284
1285
1286
1287
1288
1289
1290

























1291
1292
1293
1294
1295
1296
1297

1284
1285
1286
1287
1288
1289
1290
1291
1292
1293
1294
1295
1296
1297
1298
1299
1300
1301
1302
1303
1304
1305
1306
1307
1308
1309
1310
1311
1312
1313
1314
1315
1316
1317
1318
1319
1320
1321
1322








+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+








      }
      default {
        error "unsupported package platform"
      }
    }
  }

  #
  # NOTE: This procedure checks the current login cookie to make sure that
  #       it exists -AND- conforms to the correct format.
  #
  proc haveValidLoginCookie {} {
    variable loginCookie

    if {![info exists loginCookie]} then {
      return false
    }

    if {[isEagle] || \
        ([info exists tcl_version] && $tcl_version >= 8.5)} then {
      if {[string is list -strict $loginCookie]} then {
        return false
      }
    }

    if {[llength $loginCookie] != 2} then {
      return false
    }

    return true
  }

  #
  # NOTE: This procedure issues a request to an HTTP(S) server.  It returns
  #       the raw response data verbatim.  It may raise a script error.  It
  #       will always use the currently configured HTTP(S) login cookie, if
  #       any; therefore, it should really only be used for requests to the
  #       package file server.  The uri argument is the fully qualified URI
  #       to request.  The allowHtml argument should be non-zero if raw HTML
︙
1324
1325
1326
1327
1328
1329
1330
1331

1332
1333
1334
1335
1336
1337
1338
1339
1340
1341
1342
1343
1344
1345
1346
1347
1348

1349
1350
1351
1352
1353
1354
1355

1349
1350
1351
1352
1353
1354
1355

1356
1357
1358
1359
1360
1361
1362
1363
1364
1365
1366
1367
1368
1369
1370
1371
1372

1373
1374
1375
1376
1377
1378
1379
1380








-
+
















-
+








            TestSetScriptNewWebClientCallback "" true true error]

        if {$code ne "Ok"} then {
          error [getStringFromObjectHandle $error]
        }
      }

      if {[info exists loginCookie] && [llength $loginCookie] == 2} then {
      if {[haveValidLoginCookie]} then {
        set script [object create String {
          if {[methodName ToString] eq "GetWebRequest"} then {
            webRequest Headers.Add Cookie [join $loginCookie =]
          }
        }]

        set data [uri download \
            -timeouttype network -inline \
            -webclientdata $script -- $uri]
      } else {
        set data [uri download \
            -timeouttype network -inline -- $uri]
      }
    } else {
      set options [list -binary true]

      if {[info exists loginCookie] && [llength $loginCookie] == 2} then {
      if {[haveValidLoginCookie]} then {
        lappend options -headers [list Cookie [join $loginCookie =]]
      }

      set data [eval ::PackageRepository::getFileViaHttp \
          [list $uri] [list 20] [list stdout] [list $quiet] $options]
    }
︙
1413
1414
1415
1416
1417
1418
1419
1420

1421
1422
1423
1424
1425
1426
1427

1438
1439
1440
1441
1442
1443
1444

1445
1446
1447
1448
1449
1450
1451
1452








-
+








  proc maybeResetCookieAndLoginSimple {} {
    variable loginCookie

    #
    # NOTE: Attempt to verify that we are currently logged in.  If so, do
    #       nothing; otherwise, attempt to login.
    #
    if {![info exists loginCookie] || [llength $loginCookie] != 2} then {
    if {![haveValidLoginCookie]} then {
      resetCookieAndLoginSimple
    }
  }

  #
  # NOTE: This procedure resets the currently configured login cookie, if
  #       any, and then attempts to login using the specified user name and
︙
1491
1492
1493
1494
1495
1496
1497
1498

1499
1500
1501
1502
1503
1504
1505

1516
1517
1518
1519
1520
1521
1522

1523
1524
1525
1526
1527
1528
1529
1530








-
+








    variable loginCookie
    variable logoutUri
    variable logoutUrn

    #
    # NOTE: Attempt to verify that we are currently logged in.
    #
    if {![info exists loginCookie] || [llength $loginCookie] != 2} then {
    if {![haveValidLoginCookie]} then {
      error "missing or invalid login cookie"
    }

    #
    # NOTE: Build the full URI for the logout request, performing any
    #       applicable substitutions in the URI prior to using it as
    #       the basis for logging out of the repository.
︙

Modified client/1.0/neutral/pkgd.eagle.asc from [b76dc737a2] to [2e5f347713]. 

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17













18

1
2
3
4













5
6
7
8
9
10
11
12
13
14
15
16
17
18





-
-
-
-
-
-
-
-
-
-
-
-
-
+
+
+
+
+
+
+
+
+
+
+
+
+


-----BEGIN PGP SIGNATURE-----
Version: GnuPG v2
Comment: Eagle Package Repository

iQIcBAABCAAGBQJmAPHiAAoJEFAslq9JXcLZDoYQALvvMTVxpJbWur/iDqW6WAvu
0cBa7gI/nNW2EVNULiZy2bjDhRPoFD24zMuoW7F1F7FUll5GQsSE8lF9cJdtVvok
6i/bZeqiNUQ7YVTDcJsyt1Q7mXJOlkvm2bdKSD7FGTo6uJt4RpeXqPkd95IvD9bB
fJAbG1WTvoVVPXMI/PjajK9ZN0T8I3VAghdLwgHQLFF8V2Dl+RZZFBkj1/Wm0E65
xnlkREUmdhgG86sSCbZ5a6DdJVrzOVcWQtuqLDTqWGZJZpL/2pU1rCRAukif9VlR
9MhqfJ9/63l7MEybMvNDZgCIbRixTbo7C5edIc97n1RVMIG8zm+O4O3JHaopZkmb
1spBRe70HB79ZiBaWOoKrpqVjUdM4KPif4hVtk+Dp9waznZH8Ve5yMjFUBqzQuYP
ZkCdROll9yRPP44pAzRY1H92VO/KWbhBIFV5vmQlZlCSwuwe+Fyo0e30uo89RX+x
XovwST3CMvrIHrkNNM/3z+ZXgu67NFVCk03NFYwOIMpf0YXp/RbZvxuv7cLRzNqf
NlmY0lqeS5Ga11gqKnz5QZu5ZCx0TCpqnv3Rl3P4p/HVem4g5kULKhKrM6d5H8E3
fl87LL21rCuwXHCE0Qh1fR6gzJwukWTa0M/ubMgFk3JdL1nuflQPRoVs94rvxTiu
S90xFqz/MYIP/5OFkpz+
=TH85
iQIcBAABCAAGBQJmbLygAAoJEFAslq9JXcLZQ7IP/2DjWkWybtaM0JOYcLXkC/la
4qqYI/3T3EWLvwrIww2GGQYts9+KKAGjXQ60DXvOwdJd4rnRpG1NIdYMVSU3YfNp
Jpw5+dQxB09oMp7vYwKidbcAhKANjm3UsKJid7YFuzaUYAmkzhGWgE5dh3M2a31b
MzUt9i4X7vNti+t4nVLQVn0Zgw4evRdkCSYg2seDVz1788ipaIW7ndVGC8gisxrN
DzW7mxnAlre7hzkxEKT76lfpOhpwJc3GNWyqCOJXamPAncsYo2eq0J29o95RiRoe
pSNKgnm5WR1N0CBRxy5P2mtdQOmpSR5RknFctlHzidV39XxVgVUG3MDz/8eUogG4
N8mSIbTQ5CAxE0F6bk6zTYpukUVVPUJH8mg8pFhjokEPRdwPVSPUOHk92BnTIwVi
UWtxKIixkghvK2u0Khemu4h8DMV9Iv5UK1jvM+BcTcC5Ka8HkOHtphKm7nV7oDab
UanomRftfT58EtQSxLg7NG41mQ2WIs7NgHo03yKuz2htllpET1NpzFniQvhPhVLV
iPFDrYYoeCtuya8F5Ymf1fJ+qe7wewQ7qPF2Px2vVEXIki3JIXyEmuLRy7pefoaC
do6bfd4oFbRnKcgiH3/qq/EH6oJASzo/wm42GmZGFFcOF8m+0Tsh5n3UdQBcm0Qb
AQO28k8+k1+2ImXXIVtV
=RhPm
-----END PGP SIGNATURE-----

Modified client/1.0/neutral/pkgd.eagle.harpy from [7a63ef98fe] to [8d96478328].

︙
17
18
19
20
21
22
23
24

25
26
27

28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66




































67
68

17
18
19
20
21
22
23

24
25
26

27
28
29
30




































31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68








-
+


-
+



-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+



    THE ASSOCIATED SOFTWARE MAY NOT WORK PROPERLY IF THIS FILE IS ALTERED.
-->
<Certificate xmlns="https://eagle.to/2011/harpy"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xmlns:xsd="http://www.w3.org/2001/XMLSchema">
  <Protocol>None</Protocol>
  <Vendor>Mistachkin Systems</Vendor>
  <Id>293e75a9-d22d-4a80-9a2e-2d613dcffd26</Id>
  <Id>4ff99c42-6423-48cc-affc-8cf628e83ace</Id>
  <HashAlgorithm>SHA512</HashAlgorithm>
  <EntityType>Script</EntityType>
  <TimeStamp>2024-03-25T03:39:03.6423313Z</TimeStamp>
  <TimeStamp>2024-06-14T21:56:34.0847234Z</TimeStamp>
  <Duration>-1.00:00:00</Duration>
  <Key>0x9559f6017247e3e2</Key>
  <Signature>
    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
  </Signature>
</Certificate>

Modified client/1.0/neutral/pkgd.eagle.harpy.asc from [e04d6d98aa] to [768621003f]. 

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17













18

1
2
3
4













5
6
7
8
9
10
11
12
13
14
15
16
17
18





-
-
-
-
-
-
-
-
-
-
-
-
-
+
+
+
+
+
+
+
+
+
+
+
+
+


-----BEGIN PGP SIGNATURE-----
Version: GnuPG v2
Comment: Eagle Package Repository

iQIcBAABCAAGBQJmAPHkAAoJEFAslq9JXcLZFwAQALHQUZShoBVm8VSUaBKIRvFS
E+3CqRZYlW9mCqn6jmdv9IL/VjIotsomlJ7pNGLJg4lFy65YzlmOgqlLmfCKR5W5
1xETZ85bLygT6RWbqPNwcdIe5Fu6uv0fVVa6dDFogxNVGb21dNbSWSkHpesOkI0n
nGRJUE9hzuK0rHkkQbsVr2h1JcieqUc2/gLgr+FEZlFWbWXSII8X4deug7PFyJVs
yaGKE57LMFWmWGp+CkMyzQOSz/CU75G5hMIXYPT7VcfTgKokkiaFRSZSi16TUFH7
YX6BRmhve6OH9cRcWfH6TRn3RrfOgduxt4Os0vYPSrjtHLkYWWQi4sJB6uNZU0zU
147G1f3sRVLH6YN/6e81n8gFbEUHLvPFTH+huPQubof7+L49U1RL5o+zlaCB27jW
ACQrkjw6XKVyVV0t5Tt/VXca8MM1Pg9o/YUEfkL6qYIj82WwPa0TIkrkpWfVxFyl
nc0wFzkPbMgM5G1Nn4ISIL+c4lUyzYXTZDFwUMi5SQsYoOLqN+B7F4pzbI9LzruP
PX9hW2geAmwQHoL9su4QozhJq0Za4wxU4QaNCRO5iO3FohSdeDBr328KxGSzaRyY
OVh8uSEhxRvPaq7F+w3GgNgNLmLmX38lAJ57Hio4ATy1N1KtxKTsXJpcskFCoWYF
1DG+YInxIJ67MzcVuC3+
=In4V
iQIcBAABCAAGBQJmbLyhAAoJEFAslq9JXcLZI8YQALaC4xZWgogT2Lk7ZgrcNBZA
V4NI9LMjbb/QEkS4SoIAsl1scPo/tgSxRDxed8N6nPv8l8AIaYC996vPYENst3ml
PJ86tOchJbZY0Q53saZudbA34YF1OFac0Ici7g4Hh28oKdiTzdyms57LIGuS6gQt
r3fesoLbcPQsCmzd23vpi9aGt3bs9geVLRPk0C2b1JeY4x0hS4JOnpDUilZs1Tgl
moSPyx+FddB44oYFMkh5hLZeBJ1n+twLgs5OcP5X/F7Jiq+4WfGsby1B5C0BotzB
Gkn0AXUvioB/qGpr1uB/OpzxhYUoqhn4XJ52bwPkymZE4E9hqnTRX6SRu0uQHBU6
P3T7+Bpmkvuxp6hWP35gN4GdO4HMkhJoXuf4+hFxz5H5OxLeeBHZQklRaaFOB/wL
a1v+RPktYL78wEUjAmx/M/mw6KoRxlH3GVQBlGnuMWCEGpx2ocYWlbDD/o6LIBqz
JwNsZM5mIFO5XAbSyXIhykA/yUpb/p16sjWbDGdbL4tnzyAoVZu0DmK9g1MmEsRI
sAIE+x2v/tidt5JM2/tkPCHQ2stDc+/wxCSfRhj5PjGc544K97HevEwWdNcJxqTl
HPENJ8itWvehKsaam0L08sbQa4YbGFlzrQm2vghMfyox0mEwpvJqRZSX+dlBLTnt
SzASWPgex0pYMuij6cNv
=/uXR
-----END PGP SIGNATURE-----

Modified doc/v1.html from [2a9b14679c] to [f91b600e55]. 

1
2
3

4
5
6
7
8
9
10

1
2

3
4
5
6
7
8
9
10



-
+








<div class="fossil-doc" data-title="Package Client Toolset API v1"><br>

<big><big><span style="font-family: monospace;">Generated [2024-06-03 @ 04:22:59 UTC] from checkout [17012cff1e01097762dddc6b7222a639a76e82d8 2024-03-25 05:13:08 UTC]</span></big></big><br><br><hr><br>
<big><big><span style="font-family: monospace;">Generated [2024-06-14 @ 21:57:18 UTC] from checkout [96fc9afa4e9742bef71ef5d6070f1d6736948fc9 2024-06-03 04:37:38 UTC]</span></big></big><br><br><hr><br>


<big><big><span style="font-family: monospace;">Public API Procedure &quot;<a href="$ROOT/artifact?ci=trunk&amp;filename=client/1.0/neutral/common.tcl&amp;ln=272">::Eagle::Tools::Common::getFileViaHttp</a>&quot;&nbsp;(from&nbsp;&quot;<a href="$ROOT/artifact?ci=trunk&amp;filename=client/1.0/neutral/common.tcl">common.tcl</a>&quot;)</span></big></big><br>
<br>

<big><span style="font-family: monospace;">&nbsp;&nbsp;&nbsp;&nbsp;Required argument &quot;uri&quot;</span></big><br>
︙
126
127
128
129
130
131
132
133

134
135
136
137
138
139
140
141
142
143
144

145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162

163
164
165
166
167
168
169
170

171
172
173
174
175
176
177

126
127
128
129
130
131
132

133
134
135
136
137
138
139
140
141
142
143

144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161

162
163
164
165
166
167
168
169

170
171
172
173
174
175
176
177








-
+










-
+

















-
+







-
+









<blockquote style="font-family: monospace;"><br>
This procedure modifies the version variables used by the package<br>
downloader client so that a specific version will be used.  The<br>
versionId argument must consist only of hexadecimal characters.<br>
</blockquote><br><hr><br>

<big><big><span style="font-family: monospace;">Public API Procedure &quot;<a href="$ROOT/artifact?ci=trunk&amp;filename=client/1.0/neutral/pkgd.eagle&amp;ln=1386">::PackageDownloader::resetCookieAndLoginSimple</a>&quot;&nbsp;(from&nbsp;&quot;<a href="$ROOT/artifact?ci=trunk&amp;filename=client/1.0/neutral/pkgd.eagle">pkgd.eagle</a>&quot;)</span></big></big><br>
<big><big><span style="font-family: monospace;">Public API Procedure &quot;<a href="$ROOT/artifact?ci=trunk&amp;filename=client/1.0/neutral/pkgd.eagle&amp;ln=1411">::PackageDownloader::resetCookieAndLoginSimple</a>&quot;&nbsp;(from&nbsp;&quot;<a href="$ROOT/artifact?ci=trunk&amp;filename=client/1.0/neutral/pkgd.eagle">pkgd.eagle</a>&quot;)</span></big></big><br>

<blockquote style="font-family: monospace;"><br>
This procedure resets the currently configured login cookie, if<br>
any, and then attempts to login using the configured package<br>
repository server API key -OR- using the public access account.<br>
Upon success, it will set the login cookie to the one from the<br>
raw response data.  Upon failure, a script error will be raised.<br>
There are no arguments.<br>
</blockquote><br><hr><br>

<big><big><span style="font-family: monospace;">Public API Procedure &quot;<a href="$ROOT/artifact?ci=trunk&amp;filename=client/1.0/neutral/pkgd.eagle&amp;ln=1436">::PackageDownloader::resetCookieAndLogin</a>&quot;&nbsp;(from&nbsp;&quot;<a href="$ROOT/artifact?ci=trunk&amp;filename=client/1.0/neutral/pkgd.eagle">pkgd.eagle</a>&quot;)</span></big></big><br>
<big><big><span style="font-family: monospace;">Public API Procedure &quot;<a href="$ROOT/artifact?ci=trunk&amp;filename=client/1.0/neutral/pkgd.eagle&amp;ln=1461">::PackageDownloader::resetCookieAndLogin</a>&quot;&nbsp;(from&nbsp;&quot;<a href="$ROOT/artifact?ci=trunk&amp;filename=client/1.0/neutral/pkgd.eagle">pkgd.eagle</a>&quot;)</span></big></big><br>
<br>

<big><span style="font-family: monospace;">&nbsp;&nbsp;&nbsp;&nbsp;Required argument &quot;userName&quot;</span></big><br>

<big><span style="font-family: monospace;">&nbsp;&nbsp;&nbsp;&nbsp;Required argument &quot;password&quot;</span></big><br>

<blockquote style="font-family: monospace;"><br>
This procedure resets the currently configured login cookie, if<br>
any, and then attempts to login using the specified user name and<br>
password.  Upon success, it will set the login cookie to the one<br>
from the raw response data.  Upon failure, a script error will be<br>
raised.  The userName argument must be the name of a package file<br>
server user with at least Fossil Check-Out (o) permissions on the<br>
package file server.  The password argument must be the plaintext<br>
password that is associated with the specified user name.<br>
</blockquote><br><hr><br>

<big><big><span style="font-family: monospace;">Public API Procedure &quot;<a href="$ROOT/artifact?ci=trunk&amp;filename=client/1.0/neutral/pkgd.eagle&amp;ln=1489">::PackageDownloader::logoutAndResetCookie</a>&quot;&nbsp;(from&nbsp;&quot;<a href="$ROOT/artifact?ci=trunk&amp;filename=client/1.0/neutral/pkgd.eagle">pkgd.eagle</a>&quot;)</span></big></big><br>
<big><big><span style="font-family: monospace;">Public API Procedure &quot;<a href="$ROOT/artifact?ci=trunk&amp;filename=client/1.0/neutral/pkgd.eagle&amp;ln=1514">::PackageDownloader::logoutAndResetCookie</a>&quot;&nbsp;(from&nbsp;&quot;<a href="$ROOT/artifact?ci=trunk&amp;filename=client/1.0/neutral/pkgd.eagle">pkgd.eagle</a>&quot;)</span></big></big><br>

<blockquote style="font-family: monospace;"><br>
This procedure attempts to logout using the currently configured<br>
login cookie, if any, and then resets the login cookie.  There<br>
are no arguments.  This procedure may raise a script error.<br>
</blockquote><br><hr><br>

<big><big><span style="font-family: monospace;">Public API Procedure &quot;<a href="$ROOT/artifact?ci=trunk&amp;filename=client/1.0/neutral/pkgd.eagle&amp;ln=1722">::PackageDownloader::checkForHigherVersion</a>&quot;&nbsp;(from&nbsp;&quot;<a href="$ROOT/artifact?ci=trunk&amp;filename=client/1.0/neutral/pkgd.eagle">pkgd.eagle</a>&quot;)</span></big></big><br>
<big><big><span style="font-family: monospace;">Public API Procedure &quot;<a href="$ROOT/artifact?ci=trunk&amp;filename=client/1.0/neutral/pkgd.eagle&amp;ln=1747">::PackageDownloader::checkForHigherVersion</a>&quot;&nbsp;(from&nbsp;&quot;<a href="$ROOT/artifact?ci=trunk&amp;filename=client/1.0/neutral/pkgd.eagle">pkgd.eagle</a>&quot;)</span></big></big><br>
<br>

<big><span style="font-family: monospace;">&nbsp;&nbsp;&nbsp;&nbsp;Required argument &quot;language&quot;</span></big><br>

<big><span style="font-family: monospace;">&nbsp;&nbsp;&nbsp;&nbsp;Required argument &quot;version&quot;</span></big><br>

<big><span style="font-family: monospace;">&nbsp;&nbsp;&nbsp;&nbsp;Required argument &quot;platform&quot;</span></big><br>
︙
193
194
195
196
197
198
199
200

201
202
203
204
205
206
207

193
194
195
196
197
198
199

200
201
202
203
204
205
206
207








-
+








not require a specific platform.  The packageName argument is a<br>
directory name relative to the language and version-specific<br>
directory on the package file server and may be an empty string.<br>
The usePgp argument should be non-zero when an OpenPGP signature<br>
file needs to be downloaded and verified for the downloaded file.<br>
</blockquote><br><hr><br>

<big><big><span style="font-family: monospace;">Public API Procedure &quot;<a href="$ROOT/artifact?ci=trunk&amp;filename=client/1.0/neutral/pkgd.eagle&amp;ln=2030">::PackageDownloader::downloadFiles</a>&quot;&nbsp;(from&nbsp;&quot;<a href="$ROOT/artifact?ci=trunk&amp;filename=client/1.0/neutral/pkgd.eagle">pkgd.eagle</a>&quot;)</span></big></big><br>
<big><big><span style="font-family: monospace;">Public API Procedure &quot;<a href="$ROOT/artifact?ci=trunk&amp;filename=client/1.0/neutral/pkgd.eagle&amp;ln=2055">::PackageDownloader::downloadFiles</a>&quot;&nbsp;(from&nbsp;&quot;<a href="$ROOT/artifact?ci=trunk&amp;filename=client/1.0/neutral/pkgd.eagle">pkgd.eagle</a>&quot;)</span></big></big><br>
<br>

<big><span style="font-family: monospace;">&nbsp;&nbsp;&nbsp;&nbsp;Required argument &quot;language&quot;</span></big><br>

<big><span style="font-family: monospace;">&nbsp;&nbsp;&nbsp;&nbsp;Required argument &quot;version&quot;</span></big><br>

<big><span style="font-family: monospace;">&nbsp;&nbsp;&nbsp;&nbsp;Required argument &quot;platform&quot;</span></big><br>
︙
231
232
233
234
235
236
237
238

239
240
241
242
243
244
245

231
232
233
234
235
236
237

238
239
240
241
242
243
244
245








-
+








for each downloaded file.  The -useAutoPath option should be<br>
non-zero to modify the auto-path to include the temporary or<br>
persistent directories containing the downloaded files.  The<br>
-allowUpdate option should be non-zero to allow existing package<br>
files to be overwritten.<br>
</blockquote><br><hr><br>

<big><big><span style="font-family: monospace;">Public API Procedure &quot;<a href="$ROOT/artifact?ci=trunk&amp;filename=client/1.0/neutral/pkgd.eagle&amp;ln=2256">::PackageDownloader::maybeAddTemporaryPackagesToAutoPath</a>&quot;&nbsp;(from&nbsp;&quot;<a href="$ROOT/artifact?ci=trunk&amp;filename=client/1.0/neutral/pkgd.eagle">pkgd.eagle</a>&quot;)</span></big></big><br>
<big><big><span style="font-family: monospace;">Public API Procedure &quot;<a href="$ROOT/artifact?ci=trunk&amp;filename=client/1.0/neutral/pkgd.eagle&amp;ln=2281">::PackageDownloader::maybeAddTemporaryPackagesToAutoPath</a>&quot;&nbsp;(from&nbsp;&quot;<a href="$ROOT/artifact?ci=trunk&amp;filename=client/1.0/neutral/pkgd.eagle">pkgd.eagle</a>&quot;)</span></big></big><br>
<br>

<big><span style="font-family: monospace;">&nbsp;&nbsp;&nbsp;&nbsp;Required argument &quot;language&quot;</span></big><br>

<big><span style="font-family: monospace;">&nbsp;&nbsp;&nbsp;&nbsp;Required argument &quot;options&quot;</span></big><br>

<big><span style="font-family: monospace;">&nbsp;&nbsp;&nbsp;&nbsp;Optional argument &quot;pattern&quot; with default value &quot;&quot;</span></big><br>
︙
357
358
359
360
361
362
363
364

365
366
367
368
369
370
371

357
358
359
360
361
362
363

364
365
366
367
368
369
370
371








-
+








entity does not require a specific platform.  The varName argument<br>
is the name of a variable in the context of the immediate caller<br>
that will receive a modified platform name, if applicable.  Upon<br>
failure, a script error will be raised.  The return value is<br>
undefined.<br>
</blockquote><br><hr><br>

<big><big><span style="font-family: monospace;">Internal API Procedure &quot;<a href="$ROOT/artifact?ci=trunk&amp;filename=client/1.0/neutral/pkgd.eagle&amp;ln=1413">::PackageDownloader::maybeResetCookieAndLoginSimple</a>&quot;&nbsp;(from&nbsp;&quot;<a href="$ROOT/artifact?ci=trunk&amp;filename=client/1.0/neutral/pkgd.eagle">pkgd.eagle</a>&quot;)</span></big></big><br>
<big><big><span style="font-family: monospace;">Internal API Procedure &quot;<a href="$ROOT/artifact?ci=trunk&amp;filename=client/1.0/neutral/pkgd.eagle&amp;ln=1438">::PackageDownloader::maybeResetCookieAndLoginSimple</a>&quot;&nbsp;(from&nbsp;&quot;<a href="$ROOT/artifact?ci=trunk&amp;filename=client/1.0/neutral/pkgd.eagle">pkgd.eagle</a>&quot;)</span></big></big><br>

<blockquote style="font-family: monospace;"><br>
This procedure attempts to login using the configured package<br>
repository server API key -OR- using the public access account,<br>
if not already logged in.  Upon success, it will set the login<br>
cookie to the one from the raw response data.  Upon failure, a<br>
script error will be raised.  There are no arguments.<br>
︙
583
584
585
586
587
588
589







590

591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607

608
609
610
611
612
613
614
615

616
617
618
619
620
621
622
623
624
625
626
627

628
629
630
631
632
633
634
635
636
637
638
639
640

641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658

659
660
661
662
663
664
665
666
667
668
669

670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686

687
688
689
690
691
692
693

583
584
585
586
587
588
589
590
591
592
593
594
595
596

597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613

614
615
616
617
618
619
620
621

622
623
624
625
626
627
628
629
630
631
632
633

634
635
636
637
638
639
640
641
642
643
644
645
646

647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664

665
666
667
668
669
670
671
672
673
674
675

676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692

693
694
695
696
697
698
699
700








+
+
+
+
+
+
+
-
+
















-
+







-
+











-
+












-
+

















-
+










-
+
















-
+








This procedure attempts to verify that some runtime is available to<br>
run CLR applications locally (e.g. the .NET Framework or Mono JIT).<br>
There are no arguments.  The return value is non-zero if it appears<br>
that CLR applications should be runnable locally; otherwise, the<br>
return value is zero.<br>
</blockquote><br><hr><br>

<big><big><span style="font-family: monospace;">Private Procedure &quot;<a href="$ROOT/artifact?ci=trunk&amp;filename=client/1.0/neutral/pkgd.eagle&amp;ln=1295">::PackageDownloader::haveValidLoginCookie</a>&quot;&nbsp;(from&nbsp;&quot;<a href="$ROOT/artifact?ci=trunk&amp;filename=client/1.0/neutral/pkgd.eagle">pkgd.eagle</a>&quot;)</span></big></big><br>

<blockquote style="font-family: monospace;"><br>
This procedure checks the current login cookie to make sure that<br>
it exists -AND- conforms to the correct format.<br>
</blockquote><br><hr><br>

<big><big><span style="font-family: monospace;">Private Procedure &quot;<a href="$ROOT/artifact?ci=trunk&amp;filename=client/1.0/neutral/pkgd.eagle&amp;ln=1300">::PackageDownloader::getPackageFile</a>&quot;&nbsp;(from&nbsp;&quot;<a href="$ROOT/artifact?ci=trunk&amp;filename=client/1.0/neutral/pkgd.eagle">pkgd.eagle</a>&quot;)</span></big></big><br>
<big><big><span style="font-family: monospace;">Private Procedure &quot;<a href="$ROOT/artifact?ci=trunk&amp;filename=client/1.0/neutral/pkgd.eagle&amp;ln=1325">::PackageDownloader::getPackageFile</a>&quot;&nbsp;(from&nbsp;&quot;<a href="$ROOT/artifact?ci=trunk&amp;filename=client/1.0/neutral/pkgd.eagle">pkgd.eagle</a>&quot;)</span></big></big><br>
<br>

<big><span style="font-family: monospace;">&nbsp;&nbsp;&nbsp;&nbsp;Required argument &quot;uri&quot;</span></big><br>

<big><span style="font-family: monospace;">&nbsp;&nbsp;&nbsp;&nbsp;Optional argument &quot;allowHtml&quot; with default value &quot;false&quot;</span></big><br>

<blockquote style="font-family: monospace;"><br>
This procedure issues a request to an HTTP(S) server.  It returns<br>
the raw response data verbatim.  It may raise a script error.  It<br>
will always use the currently configured HTTP(S) login cookie, if<br>
any; therefore, it should really only be used for requests to the<br>
package file server.  The uri argument is the fully qualified URI<br>
to request.  The allowHtml argument should be non-zero if raw HTML<br>
should be allowed in the response data.<br>
</blockquote><br><hr><br>

<big><big><span style="font-family: monospace;">Private Procedure &quot;<a href="$ROOT/artifact?ci=trunk&amp;filename=client/1.0/neutral/pkgd.eagle&amp;ln=1373">::PackageDownloader::getDownloadVarNamePrefix</a>&quot;&nbsp;(from&nbsp;&quot;<a href="$ROOT/artifact?ci=trunk&amp;filename=client/1.0/neutral/pkgd.eagle">pkgd.eagle</a>&quot;)</span></big></big><br>
<big><big><span style="font-family: monospace;">Private Procedure &quot;<a href="$ROOT/artifact?ci=trunk&amp;filename=client/1.0/neutral/pkgd.eagle&amp;ln=1398">::PackageDownloader::getDownloadVarNamePrefix</a>&quot;&nbsp;(from&nbsp;&quot;<a href="$ROOT/artifact?ci=trunk&amp;filename=client/1.0/neutral/pkgd.eagle">pkgd.eagle</a>&quot;)</span></big></big><br>

<blockquote style="font-family: monospace;"><br>
This procedure returns the prefix for fully qualified variable<br>
names that MAY be present in the global namespace.  There are<br>
no arguments.<br>
</blockquote><br><hr><br>

<big><big><span style="font-family: monospace;">Private Procedure &quot;<a href="$ROOT/artifact?ci=trunk&amp;filename=client/1.0/neutral/pkgd.eagle&amp;ln=1543">::PackageDownloader::getUniqueTempDirectory</a>&quot;&nbsp;(from&nbsp;&quot;<a href="$ROOT/artifact?ci=trunk&amp;filename=client/1.0/neutral/pkgd.eagle">pkgd.eagle</a>&quot;)</span></big></big><br>
<big><big><span style="font-family: monospace;">Private Procedure &quot;<a href="$ROOT/artifact?ci=trunk&amp;filename=client/1.0/neutral/pkgd.eagle&amp;ln=1568">::PackageDownloader::getUniqueTempDirectory</a>&quot;&nbsp;(from&nbsp;&quot;<a href="$ROOT/artifact?ci=trunk&amp;filename=client/1.0/neutral/pkgd.eagle">pkgd.eagle</a>&quot;)</span></big></big><br>
<br>

<big><span style="font-family: monospace;">&nbsp;&nbsp;&nbsp;&nbsp;Optional argument &quot;prefix&quot; with default value &quot;&quot;</span></big><br>

<blockquote style="font-family: monospace;"><br>
This procedure returns a unique temporary directory where one or<br>
more files may be saved.  The prefix argument is a prefix for the<br>
directory name and it may be an empty string.  There is no attempt<br>
to actually create the resulting directory.<br>
</blockquote><br><hr><br>

<big><big><span style="font-family: monospace;">Private Procedure &quot;<a href="$ROOT/artifact?ci=trunk&amp;filename=client/1.0/neutral/pkgd.eagle&amp;ln=1573">::PackageDownloader::createInterp</a>&quot;&nbsp;(from&nbsp;&quot;<a href="$ROOT/artifact?ci=trunk&amp;filename=client/1.0/neutral/pkgd.eagle">pkgd.eagle</a>&quot;)</span></big></big><br>
<big><big><span style="font-family: monospace;">Private Procedure &quot;<a href="$ROOT/artifact?ci=trunk&amp;filename=client/1.0/neutral/pkgd.eagle&amp;ln=1598">::PackageDownloader::createInterp</a>&quot;&nbsp;(from&nbsp;&quot;<a href="$ROOT/artifact?ci=trunk&amp;filename=client/1.0/neutral/pkgd.eagle">pkgd.eagle</a>&quot;)</span></big></big><br>
<br>

<big><span style="font-family: monospace;">&nbsp;&nbsp;&nbsp;&nbsp;Required argument &quot;varName&quot;</span></big><br>

<blockquote style="font-family: monospace;"><br>
This procedure creates a new interpreter, which may be &quot;safe&quot;, and<br>
places a reference to it in a variable in the context of the caller<br>
identified by the varName argument.  The created interpreter has a<br>
fully functioning [package] command ensemble; all other commands do<br>
nothing and return nothing.  This procedure may raise script errors.<br>
</blockquote><br><hr><br>

<big><big><span style="font-family: monospace;">Private Procedure &quot;<a href="$ROOT/artifact?ci=trunk&amp;filename=client/1.0/neutral/pkgd.eagle&amp;ln=1650">::PackageDownloader::getIfNeededVersions</a>&quot;&nbsp;(from&nbsp;&quot;<a href="$ROOT/artifact?ci=trunk&amp;filename=client/1.0/neutral/pkgd.eagle">pkgd.eagle</a>&quot;)</span></big></big><br>
<big><big><span style="font-family: monospace;">Private Procedure &quot;<a href="$ROOT/artifact?ci=trunk&amp;filename=client/1.0/neutral/pkgd.eagle&amp;ln=1675">::PackageDownloader::getIfNeededVersions</a>&quot;&nbsp;(from&nbsp;&quot;<a href="$ROOT/artifact?ci=trunk&amp;filename=client/1.0/neutral/pkgd.eagle">pkgd.eagle</a>&quot;)</span></big></big><br>
<br>

<big><span style="font-family: monospace;">&nbsp;&nbsp;&nbsp;&nbsp;Required argument &quot;interp&quot;</span></big><br>

<big><span style="font-family: monospace;">&nbsp;&nbsp;&nbsp;&nbsp;Required argument &quot;fileName&quot;</span></big><br>

<blockquote style="font-family: monospace;"><br>
This procedure evaluates a script file and attempts to determine the<br>
list of new [package ifneeded] scripts added by it.  When successful<br>
it returns a list-of-lists.  Each element of the outer list contains<br>
a package name and the list of its versions in descending order; in<br>
the event of failure, empty lists may be returned for the outer list<br>
or for a list of versions.  The interp argument is the interp to use<br>
when evaluating the file specified by the fileName argument.  This<br>
procedure may raise script errors.<br>
</blockquote><br><hr><br>

<big><big><span style="font-family: monospace;">Private Procedure &quot;<a href="$ROOT/artifact?ci=trunk&amp;filename=client/1.0/neutral/pkgd.eagle&amp;ln=1673">::PackageDownloader::extractVersionsFromFile</a>&quot;&nbsp;(from&nbsp;&quot;<a href="$ROOT/artifact?ci=trunk&amp;filename=client/1.0/neutral/pkgd.eagle">pkgd.eagle</a>&quot;)</span></big></big><br>
<big><big><span style="font-family: monospace;">Private Procedure &quot;<a href="$ROOT/artifact?ci=trunk&amp;filename=client/1.0/neutral/pkgd.eagle&amp;ln=1698">::PackageDownloader::extractVersionsFromFile</a>&quot;&nbsp;(from&nbsp;&quot;<a href="$ROOT/artifact?ci=trunk&amp;filename=client/1.0/neutral/pkgd.eagle">pkgd.eagle</a>&quot;)</span></big></big><br>
<br>

<big><span style="font-family: monospace;">&nbsp;&nbsp;&nbsp;&nbsp;Required argument &quot;fileName&quot;</span></big><br>

<blockquote style="font-family: monospace;"><br>
This procedure attempts to extract a package version information<br>
from the specified file.  The fileName argument is the local file<br>
name to read.  This procedure may raise script errors.<br>
</blockquote><br><hr><br>

<big><big><span style="font-family: monospace;">Private Procedure &quot;<a href="$ROOT/artifact?ci=trunk&amp;filename=client/1.0/neutral/pkgd.eagle&amp;ln=1785">::PackageDownloader::guessPackageNameFromFileNames</a>&quot;&nbsp;(from&nbsp;&quot;<a href="$ROOT/artifact?ci=trunk&amp;filename=client/1.0/neutral/pkgd.eagle">pkgd.eagle</a>&quot;)</span></big></big><br>
<big><big><span style="font-family: monospace;">Private Procedure &quot;<a href="$ROOT/artifact?ci=trunk&amp;filename=client/1.0/neutral/pkgd.eagle&amp;ln=1810">::PackageDownloader::guessPackageNameFromFileNames</a>&quot;&nbsp;(from&nbsp;&quot;<a href="$ROOT/artifact?ci=trunk&amp;filename=client/1.0/neutral/pkgd.eagle">pkgd.eagle</a>&quot;)</span></big></big><br>
<br>

<big><span style="font-family: monospace;">&nbsp;&nbsp;&nbsp;&nbsp;Required argument &quot;language&quot;</span></big><br>

<big><span style="font-family: monospace;">&nbsp;&nbsp;&nbsp;&nbsp;Required argument &quot;fileNames&quot;</span></big><br>

<blockquote style="font-family: monospace;"><br>
This procedure attempts to guess a package name based on a list of<br>
its files.  It relies upon the fact that all packages must include<br>
a package index file.  The language argument must be one of the<br>
literal strings &quot;eagle&quot;, &quot;tcl&quot;, or &quot;client&quot;.  The fileNames argument<br>
must be the list of file names to be downloaded.  The package name,<br>
if one can be detected, is returned; otherwise, an empty string will<br>
be returned.<br>
</blockquote><br><hr><br>

<big><big><span style="font-family: monospace;">Private Procedure &quot;<a href="$ROOT/artifact?ci=trunk&amp;filename=client/1.0/neutral/pkgd.eagle&amp;ln=1819">::PackageDownloader::downloadAllPlatforms</a>&quot;&nbsp;(from&nbsp;&quot;<a href="$ROOT/artifact?ci=trunk&amp;filename=client/1.0/neutral/pkgd.eagle">pkgd.eagle</a>&quot;)</span></big></big><br>
<big><big><span style="font-family: monospace;">Private Procedure &quot;<a href="$ROOT/artifact?ci=trunk&amp;filename=client/1.0/neutral/pkgd.eagle&amp;ln=1844">::PackageDownloader::downloadAllPlatforms</a>&quot;&nbsp;(from&nbsp;&quot;<a href="$ROOT/artifact?ci=trunk&amp;filename=client/1.0/neutral/pkgd.eagle">pkgd.eagle</a>&quot;)</span></big></big><br>
<br>

<big><span style="font-family: monospace;">&nbsp;&nbsp;&nbsp;&nbsp;Required argument &quot;language&quot;</span></big><br>

<big><span style="font-family: monospace;">&nbsp;&nbsp;&nbsp;&nbsp;Required argument &quot;version&quot;</span></big><br>

<big><span style="font-family: monospace;">&nbsp;&nbsp;&nbsp;&nbsp;Required argument &quot;packageName&quot;</span></big><br>
︙
707
708
709
710
711
712
713
714

715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734

735
736
737
738
739
740
741

714
715
716
717
718
719
720

721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740

741
742
743
744
745
746
747
748








-
+



















-
+








is a directory name relative to the language and version-specific<br>
directory on the package file server and may be an empty string.<br>
The fileNames argument is the list of file names to be downloaded.<br>
The usePgp argument should be non-zero when an OpenPGP signature<br>
needs to be verified for the downloaded file.<br>
</blockquote><br><hr><br>

<big><big><span style="font-family: monospace;">Private Procedure &quot;<a href="$ROOT/artifact?ci=trunk&amp;filename=client/1.0/neutral/pkgd.eagle&amp;ln=1923">::PackageDownloader::downloadOneUriToFile</a>&quot;&nbsp;(from&nbsp;&quot;<a href="$ROOT/artifact?ci=trunk&amp;filename=client/1.0/neutral/pkgd.eagle">pkgd.eagle</a>&quot;)</span></big></big><br>
<big><big><span style="font-family: monospace;">Private Procedure &quot;<a href="$ROOT/artifact?ci=trunk&amp;filename=client/1.0/neutral/pkgd.eagle&amp;ln=1948">::PackageDownloader::downloadOneUriToFile</a>&quot;&nbsp;(from&nbsp;&quot;<a href="$ROOT/artifact?ci=trunk&amp;filename=client/1.0/neutral/pkgd.eagle">pkgd.eagle</a>&quot;)</span></big></big><br>
<br>

<big><span style="font-family: monospace;">&nbsp;&nbsp;&nbsp;&nbsp;Required argument &quot;localFileName&quot;</span></big><br>

<big><span style="font-family: monospace;">&nbsp;&nbsp;&nbsp;&nbsp;Required argument &quot;uri&quot;</span></big><br>

<big><span style="font-family: monospace;">&nbsp;&nbsp;&nbsp;&nbsp;Required argument &quot;usePgp&quot;</span></big><br>

<big><span style="font-family: monospace;">&nbsp;&nbsp;&nbsp;&nbsp;Required argument &quot;forcePgp&quot;</span></big><br>

<blockquote style="font-family: monospace;"><br>
This procedure downloads a single URI from the package file server<br>
and writes the result to a local file.  The localFileName argument<br>
is the file name where the downloaded file should be written.  The<br>
The uri argument is the URI to download.  The usePgp argument should<br>
be non-zero when the OpenPGP signature file needs to be verified for<br>
the downloaded file.  The return value is undefined.<br>
</blockquote><br><hr><br>

<big><big><span style="font-family: monospace;">Private Procedure &quot;<a href="$ROOT/artifact?ci=trunk&amp;filename=client/1.0/neutral/pkgd.eagle&amp;ln=1964">::PackageDownloader::downloadOneFile</a>&quot;&nbsp;(from&nbsp;&quot;<a href="$ROOT/artifact?ci=trunk&amp;filename=client/1.0/neutral/pkgd.eagle">pkgd.eagle</a>&quot;)</span></big></big><br>
<big><big><span style="font-family: monospace;">Private Procedure &quot;<a href="$ROOT/artifact?ci=trunk&amp;filename=client/1.0/neutral/pkgd.eagle&amp;ln=1989">::PackageDownloader::downloadOneFile</a>&quot;&nbsp;(from&nbsp;&quot;<a href="$ROOT/artifact?ci=trunk&amp;filename=client/1.0/neutral/pkgd.eagle">pkgd.eagle</a>&quot;)</span></big></big><br>
<br>

<big><span style="font-family: monospace;">&nbsp;&nbsp;&nbsp;&nbsp;Required argument &quot;language&quot;</span></big><br>

<big><span style="font-family: monospace;">&nbsp;&nbsp;&nbsp;&nbsp;Required argument &quot;version&quot;</span></big><br>

<big><span style="font-family: monospace;">&nbsp;&nbsp;&nbsp;&nbsp;Required argument &quot;platform&quot;</span></big><br>
︙

Modified doc/v1.html.asc from [275f91f9f2] to [efdc277652]. 

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17













18

1
2
3
4













5
6
7
8
9
10
11
12
13
14
15
16
17
18





-
-
-
-
-
-
-
-
-
-
-
-
-
+
+
+
+
+
+
+
+
+
+
+
+
+


-----BEGIN PGP SIGNATURE-----
Version: GnuPG v2
Comment: Eagle Package Repository

iQIcBAABCAAGBQJmXUiMAAoJEFAslq9JXcLZ9PQP/0Y0LJ0UF+f5GGbdjPgHw3mi
nNrAFT2mIwIr73YGh/a9OZ/x7g2p4+Wxxl+EIbm3dhNdUlNxqnP//UPSnpSeKFT3
RMFH1NVRkaymyF+TrOx9I7OLHQNfayUxtLQd/WQQtf2/Pzn31pEiSt5hmh67LMSE
2ES30pZfAFJNRUkQ2WtMtjCMsxCyaqaHRiCyHSz8usp8kW2fxtGasOL7zQJ6EajJ
mOp0TBjEUHO3Yv4mS4l/tTucFL0fGxbUkGZq1eHzIcPBPkPQXl4q1vQ5EiHyhsYG
1Ef5QlkpnN8e7tYeahmkNXexymNZ4GnBVNeAaBS5hE5/kmztxuyVbxJ0ALiXuGmr
qV+kt0gvSKYRuZCXALg3QFERGDN9kL7axPeIqUuHGWlUuPHb3SukPAbPLVAAEb4A
YlQ+7oBcEUi68yPmF0tmysmQxYBMqlXBVZQBjoEqsOOLIfN9wu6qKag6kyC49x80
7LcrmtBGcfgKc2wsiAvmh8W7CAHkzeCAIgxhQE1/vCLYTNegLV5WwJJh9/x/ev4A
rpWQ9mykEw+e0HMnpy4KG0EHi3OPoDkJv4oNdOzQn6aY73RFCIjOLs8qiutGz1iF
fb09EhQjGqEU387xTCtSHT7Kh0mJh7aEzm/cZ6smH+Eh7KhC2g9NhmcWW76S6LYs
Va3/+KyB5xPUa6hW6j3I
=HWSl
iQIcBAABCAAGBQJmbLzjAAoJEFAslq9JXcLZEswQAKFGfjYOIVJkv/xTNXKIt/pX
s6T5eUf+wkLUuCzvaekgpdBfxHwlGifkk+O2N/Yd7PfOe5yGjXIOL2yDqd3/uDHn
IOwDrDlVXg1Bs/TH3tJeXyVPWlomW1cQgc30Zg1iNqfN2wScTvTY71/JgKjFiosd
6IN3ZatcCxNCUOH1AL7qGyejNeABQATQAhBlEjpz6HFjpP4I+aLVYeKniZnx7jWO
wpzEk7WOJfgbLvJ4K/YxiAVXifIvkoDJ+NSIJisnRvutb+3Qgsf7NNNqFdOwJ3xF
kkStUZ6pPA0YCVJ6zj7Vuaizkx/7NJrTY+poJPGMEC0dl3hSCmJOXQ0D6A0pGDXw
ZJaREMKxsFaXKJHHVCMt9YoYC7RbNNb10O99aqbK5lKAV171+8WyGDSLKidPLZkG
9WowM0pXqaVEfcyaqRJQoohWaXIP6UjP12F09SwBru2eQZQO1hEF3bGa4MqRlshh
44f/nb+HpWLw+uhQxNQ4qnraE8CTutA6ZqM3mVr698j1ocpEBGkoe8udiwT8V6zM
VwcNGrmXdtMZu1CoNy8ZVJt5QTHJXTLI3L5BSqTscKPvAe2r74fa/x4zMrXoh3VI
zy8Q6Nydef4ozazD+l77Jr13j5Pk7nLO6vZt83fiTfZTeQlXrfmZ/Z/J4vKF1/1H
LPiWMlDpO73Z6IzC5qo5
=MArJ
-----END PGP SIGNATURE-----

This page was generated in about 0.012s by Fossil version 2.20 Tcl version 8.6.12 [658547aa7c] 2022-10-09 01:11:55