Index: doc/v1.html ================================================================== --- doc/v1.html +++ doc/v1.html @@ -78,11 +78,11 @@ argument is the number of milliseconds to wait until the next
periodic progress indicator should be emitted. This procedure
reschedules its own execution.


-Public API Procedure "::PackageDownloader::useServerId" (from "pkgd.eagle")
+Public API Procedure "::PackageDownloader::useServerId" (from "pkgd.eagle")

    Optional argument "serverId" with default value ""

@@ -91,11 +91,11 @@ backend file servers may be used. The serverId argument must
consist only of alphanumeric characters and it must begin with
a letter.


-Public API Procedure "::PackageDownloader::useVersionId" (from "pkgd.eagle")
+Public API Procedure "::PackageDownloader::useVersionId" (from "pkgd.eagle")

    Optional argument "versionId" with default value ""

@@ -102,11 +102,11 @@ This procedure modifies the version variables used by the package
downloader client so that a specific version will be used. The
versionId argument must consist only of hexadecimal characters.


-Public API Procedure "::PackageDownloader::resetCookieAndLoginSimple" (from "pkgd.eagle")
+Public API Procedure "::PackageDownloader::resetCookieAndLoginSimple" (from "pkgd.eagle")

This procedure resets the currently configured login cookie, if
any, and then attempts to login using the configured package
repository server API key -OR- using the public access account.
@@ -113,11 +113,11 @@ Upon success, it will set the login cookie to the one from the
raw response data. Upon failure, a script error will be raised.
There are no arguments.


-Public API Procedure "::PackageDownloader::resetCookieAndLogin" (from "pkgd.eagle")
+Public API Procedure "::PackageDownloader::resetCookieAndLogin" (from "pkgd.eagle")

    Required argument "userName"
    Required argument "password"
@@ -131,19 +131,19 @@ server user with at least Fossil Check-Out (o) permissions on the
package file server. The password argument must be the plaintext
password that is associated with the specified user name.


-Public API Procedure "::PackageDownloader::logoutAndResetCookie" (from "pkgd.eagle")
+Public API Procedure "::PackageDownloader::logoutAndResetCookie" (from "pkgd.eagle")

This procedure attempts to logout using the currently configured
login cookie, if any, and then resets the login cookie. There
are no arguments. This procedure may raise a script error.


-Public API Procedure "::PackageDownloader::checkForHigherVersion" (from "pkgd.eagle")
+Public API Procedure "::PackageDownloader::checkForHigherVersion" (from "pkgd.eagle")

    Required argument "language"
    Required argument "version"
@@ -169,11 +169,11 @@ directory on the package file server and may be an empty string.
The usePgp argument should be non-zero when an OpenPGP signature
file needs to be downloaded and verified for the downloaded file.


-Public API Procedure "::PackageDownloader::downloadFiles" (from "pkgd.eagle")
+Public API Procedure "::PackageDownloader::downloadFiles" (from "pkgd.eagle")

    Required argument "language"
    Required argument "version"
@@ -207,11 +207,11 @@ persistent directories containing the downloaded files. The
-allowUpdate option should be non-zero to allow existing package
files to be overwritten.


-Internal API Procedure "::PackageDownloader::downloadAndSaveOpenPgpKeyFile" (from "pkgd.eagle")
+Internal API Procedure "::PackageDownloader::downloadAndSaveOpenPgpKeyFile" (from "pkgd.eagle")

    Required argument "fileName"

@@ -221,11 +221,11 @@ where the downloaded data should be written. This procedure is only
intended to be used from the "pkgr_setup.eagle" tool script and may
go away in later versions of this package.


-Internal API Procedure "::PackageDownloader::verifyPackageName" (from "pkgd.eagle")
+Internal API Procedure "::PackageDownloader::verifyPackageName" (from "pkgd.eagle")

    Required argument "packageName"

@@ -232,11 +232,11 @@ This procedure verifies that the specified value is indeed a valid
package name. The packageName argument is the value to verify.
This procedure may raise script errors.


-Internal API Procedure "::PackageDownloader::verifyPackagePatchLevel" (from "pkgd.eagle")
+Internal API Procedure "::PackageDownloader::verifyPackagePatchLevel" (from "pkgd.eagle")

    Required argument "patchLevel"

@@ -243,11 +243,11 @@ This procedure verifies that the specified value is indeed a valid
patch level. The patchLevel argument is the value to verify. This
procedure may raise script errors.


-Internal API Procedure "::PackageDownloader::verifyLanguageAndVersion" (from "pkgd.eagle")
+Internal API Procedure "::PackageDownloader::verifyLanguageAndVersion" (from "pkgd.eagle")

    Required argument "language"
    Required argument "version"
@@ -266,19 +266,19 @@ in the context of the immediate caller that will receive a boolean
value indicating if the specified language is actually a reference
to the package downloader client itself.


-Internal API Procedure "::PackageDownloader::getPlatform" (from "pkgd.eagle")
+Internal API Procedure "::PackageDownloader::getPlatform" (from "pkgd.eagle")

This procedure returns the name of the current platform. There are
no arguments. An empty string will be returned if the name of the
current platform cannot be determined for any reason.


-Internal API Procedure "::PackageDownloader::verifyVersionId" (from "pkgd.eagle")
+Internal API Procedure "::PackageDownloader::verifyVersionId" (from "pkgd.eagle")

    Required argument "versionId"

@@ -285,11 +285,11 @@ This procedure verifies that the specified value is indeed a valid
version identifier. The versionId argument is the value to verify.
This procedure may raise script errors.


-Internal API Procedure "::PackageDownloader::verifyPlatform" (from "pkgd.eagle")
+Internal API Procedure "::PackageDownloader::verifyPlatform" (from "pkgd.eagle")

    Required argument "platform"
    Required argument "varName"
@@ -304,11 +304,11 @@ that will receive a modified platform name, if applicable. Upon
failure, a script error will be raised. The return value is
undefined.


-Internal API Procedure "::PackageDownloader::maybeResetCookieAndLoginSimple" (from "pkgd.eagle")
+Internal API Procedure "::PackageDownloader::maybeResetCookieAndLoginSimple" (from "pkgd.eagle")

This procedure attempts to login using the configured package
repository server API key -OR- using the public access account,
if not already logged in. Upon success, it will set the login
@@ -372,11 +372,11 @@ parameters used by the package downloader client. The script
argument is the fully qualified path and file name for the script
being evaluated.


-Private Procedure "::PackageDownloader::uriEscape" (from "pkgd.eagle")
+Private Procedure "::PackageDownloader::uriEscape" (from "pkgd.eagle")

    Required argument "name"
    Required argument "value"
@@ -385,27 +385,27 @@ This procedure escapes a single name/value pair for use in a URI
query string. The name argument is the name of the parameter.
The value argument is the value of the parameter.


-Private Procedure "::PackageDownloader::getPersistentRootDirectory" (from "pkgd.eagle")
+Private Procedure "::PackageDownloader::getPersistentRootDirectory" (from "pkgd.eagle")

This procedure returns the root directory where any packages that
are downloaded should be saved to permanent storage for subsequent
use. There are no arguments.


-Private Procedure "::PackageDownloader::verifyPersistentRootDirectory" (from "pkgd.eagle")
+Private Procedure "::PackageDownloader::verifyPersistentRootDirectory" (from "pkgd.eagle")

This procedure checks the configured persistent root directory for
downloaded packages. If any checks fail, a script error is raised.
There are no arguments. The return value is undefined.


-Private Procedure "::PackageDownloader::getPackageIndexFileName" (from "pkgd.eagle")
+Private Procedure "::PackageDownloader::getPackageIndexFileName" (from "pkgd.eagle")

    Required argument "language"

@@ -412,11 +412,11 @@ This procedure returns the name of the package index file for the
language specified by the language argument. An empty string will
be returned if the language is unsupported or unrecognized.


-Private Procedure "::PackageDownloader::maybeCreateMasterTclPackageIndex" (from "pkgd.eagle")
+Private Procedure "::PackageDownloader::maybeCreateMasterTclPackageIndex" (from "pkgd.eagle")

This procedure, which is only used for native Tcl, generates a
"master" package index file (i.e. "pkgIndex.tcl") suitable for
use with native Tcl 8.4 (or higher). It will recursively scan
@@ -426,11 +426,11 @@ Since Eagle (by default) already performs recursive searches for
its package index files, this procedure is not needed for Eagle.
The return value is undefined.


-Private Procedure "::PackageDownloader::isOpenPgpSignatureFileName" (from "pkgd.eagle")
+Private Procedure "::PackageDownloader::isOpenPgpSignatureFileName" (from "pkgd.eagle")

    Required argument "fileName"
    Required argument "nameOnly"
@@ -440,11 +440,11 @@ an OpenPGP signature file. The fileName argument is the name of
the file to check, which may or may not exist. The nameOnly
argument should be non-zero to ignore the contents of the file.


-Private Procedure "::PackageDownloader::getAutoPath" (from "pkgd.eagle")
+Private Procedure "::PackageDownloader::getAutoPath" (from "pkgd.eagle")

    Required argument "language"

@@ -452,11 +452,11 @@ the language argument. An empty list is returned if the auto-path
does not exist in the target language. This procedure may raise
script errors.


-Private Procedure "::PackageDownloader::addToAutoPath" (from "pkgd.eagle")
+Private Procedure "::PackageDownloader::addToAutoPath" (from "pkgd.eagle")

    Required argument "language"
    Required argument "directory"
@@ -468,11 +468,11 @@ literal string "eagle" or the literal string "tcl". The directory
argument is the fully qualified path for the directory to add to
the auto-path.


-Private Procedure "::PackageDownloader::maybeAddToAutoPath" (from "pkgd.eagle")
+Private Procedure "::PackageDownloader::maybeAddToAutoPath" (from "pkgd.eagle")

    Required argument "language"
    Required argument "directory"
@@ -485,30 +485,40 @@ argument is the fully qualified path for the directory to add to
the auto-path. The directory will not be added if it falls under
a directory already in the auto-path.


-Private Procedure "::PackageDownloader::isMonoInstalled" (from "pkgd.eagle")
+Private Procedure "::PackageDownloader::isMonoInstalled" (from "pkgd.eagle")

This procedure attempts to verify that an instance of Mono and its
associated runtimes are installed locally. There are no arguments.
The return value is non-zero if Mono appears to be installed and
available for use; otherwise, the return value is zero.


-Private Procedure "::PackageDownloader::canUseMsilPlatform" (from "pkgd.eagle")
+Private Procedure "::PackageDownloader::isDotNetCoreInstalled" (from "pkgd.eagle")
+ +

+This procedure attempts to verify that an instance of .NET Core
+and its associated runtimes are installed locally. There are no
+arguments. The return value is non-zero if Mono appears to be
+installed and available for use; otherwise, the return value is
+zero.
+


+ +Private Procedure "::PackageDownloader::canUseMsilPlatform" (from "pkgd.eagle")

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


-Private Procedure "::PackageDownloader::getPackageFile" (from "pkgd.eagle")
+Private Procedure "::PackageDownloader::getPackageFile" (from "pkgd.eagle")

    Required argument "uri"

@@ -518,19 +528,19 @@ 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.


-Private Procedure "::PackageDownloader::getDownloadVarNamePrefix" (from "pkgd.eagle")
+Private Procedure "::PackageDownloader::getDownloadVarNamePrefix" (from "pkgd.eagle")

This procedure returns the prefix for fully qualified variable
names that MAY be present in the global namespace. There are
no arguments.


-Private Procedure "::PackageDownloader::getUniqueTempDirectory" (from "pkgd.eagle")
+Private Procedure "::PackageDownloader::getUniqueTempDirectory" (from "pkgd.eagle")

    Optional argument "prefix" with default value ""

@@ -538,11 +548,11 @@ more files may be saved. The prefix argument is a prefix for the
directory name and it may be an empty string. There is no attempt
to actually create the resulting directory.


-Private Procedure "::PackageDownloader::guessPackageNameFromFileNames" (from "pkgd.eagle")
+Private Procedure "::PackageDownloader::guessPackageNameFromFileNames" (from "pkgd.eagle")

    Required argument "language"
    Required argument "fileNames"
@@ -555,11 +565,11 @@ must be the list of file names to be downloaded. The package name,
if one can be detected, is returned; otherwise, an empty string will
be returned.


-Private Procedure "::PackageDownloader::downloadAllPlatforms" (from "pkgd.eagle")
+Private Procedure "::PackageDownloader::downloadAllPlatforms" (from "pkgd.eagle")

    Required argument "language"
    Required argument "version"
@@ -583,11 +593,11 @@ The fileNames argument is the list of file names to be downloaded.
The usePgp argument should be non-zero when an OpenPGP signature
needs to be verified for the downloaded file.


-Private Procedure "::PackageDownloader::downloadOneUriToFile" (from "pkgd.eagle")
+Private Procedure "::PackageDownloader::downloadOneUriToFile" (from "pkgd.eagle")

    Required argument "localFileName"
    Required argument "uri"
@@ -603,11 +613,11 @@ The uri argument is the URI to download. The usePgp argument should
be non-zero when the OpenPGP signature file needs to be verified for
the downloaded file. The return value is undefined.


-Private Procedure "::PackageDownloader::downloadOneFile" (from "pkgd.eagle")
+Private Procedure "::PackageDownloader::downloadOneFile" (from "pkgd.eagle")

    Required argument "language"
    Required argument "version"
@@ -739,11 +749,11 @@ backend repository servers may be used. The serverId argument
must consist only of alphanumeric characters and it must begin
with a letter.


-Public API Procedure "::PackageRepository::maybeReadSettingsFile" (from "pkgr.eagle")
+Public API Procedure "::PackageRepository::maybeReadSettingsFiles" (from "pkgr.eagle")

    Required argument "script"

@@ -752,11 +762,11 @@ masked. The script argument must be the fully qualified path
and file name for the primary package repository client script
file.


-Public API Procedure "::PackageRepository::getPackageFromRepository" (from "pkgr.eagle")
+Public API Procedure "::PackageRepository::getPackageFromRepository" (from "pkgr.eagle")

    Required argument "package"
    Required argument "version"
@@ -1310,11 +1320,11 @@ that conforms to TIP #268. This version argument must be optional
here, because Eagle does not add a version argument when one is
not explicitly supplied to the [package require] sub-command.


-Private Procedure "::PackageRepository::maybeReadApiKeysFile" (from "pkgr.eagle")
+Private Procedure "::PackageRepository::maybeReadApiKeysFile" (from "pkgr.eagle")

This procedure evaluates a package repository client API keys
script file, if it has been configured -AND- actually exists.
Any script errors raised are not masked. The evaluated script
@@ -1321,19 +1331,19 @@ file should (normally) modify the "::pkgr_api_keys" variable
in order to add API keys for use with the package repository
client.


-Private Procedure "::PackageRepository::setupRepositoryOpenPgpVars" (from "pkgr.eagle")
+Private Procedure "::PackageRepository::setupRepositoryOpenPgpVars" (from "pkgr.eagle")

This procedure sets up the default values for all configuration
parameters used to interact with the OpenPGP implementation.
There are no arguments.


-Private Procedure "::PackageRepository::setupPackageUnknownVars" (from "pkgr.eagle")
+Private Procedure "::PackageRepository::setupPackageUnknownVars" (from "pkgr.eagle")

This procedure sets up the default values for all configuration
parameters used by the package repository client. There are no
arguments.
Index: doc/v1.html.asc ================================================================== --- doc/v1.html.asc +++ doc/v1.html.asc @@ -1,18 +1,18 @@ -----BEGIN PGP SIGNATURE----- Version: GnuPG v2 Comment: Eagle Package Repository -iQIcBAABCAAGBQJddXtqAAoJEFAslq9JXcLZKCUQAIs4CiGExGghiYq8PK3HyMJe -qkI1yqtPstUgSltlSzqbgYdQY3nayDxwUp6+RTdXAW/lIWMuFBG0yydmyAa3Ux2d -HSR+8YFdIRRjJK7JgO3vFA2yj925KDlet4j2kLTQPhmx3jruOm9K03S/SMy1Nv4P -vU9If18R1WHPYeZuOEFx6kyQAwaIhOqUwcvxzSQhQ1XaP8P89tvCqs6GFm4mrevX -GcnB8qAXgd2jVwI8uCzs1XFn/4xF54srqI7DBSgZr5gqMMJBqFDVwQGkWmKfP5FR -ITwo1KTjGIPXH1RVUoSWFz0P2TMXg8iCBY4yl5mJr1eopy2RRULRnY+a/vAQXRCK -aOqweSdU3qOZJ0s5jeoBhV4A9ty24EMeMUwN+/HyUzHFOYblbUGUtLWKrXJomRiD -w4U1Yl7brDsk4JWmgpyOuQ78VSS03tlYpQeT1t6gJZw457V8tlnyApsJs6/2EjVs -IIxZeVz/f9BhtluCv1CU/3D/jkIkoihqPbZOqGWB6XvFq+iOEVvmGm06djtJ0Xpp -pW41a79JPewJzo84IxZvyu6oOMn1szwszbod42cHb9Av18nYT9jDmNU0oS+KGAhk -7dDJ2v3/Tr6NMPrbKOI/tQ/sMvVWxOgYfdyxn8r0Dq/pitnINWAagv6QzI1Be37n -eHZmD4zKSoKJ/t7Q922m -=Kqw1 +iQIcBAABCAAGBQJdqUxkAAoJEFAslq9JXcLZU5AP/RyM1FpTYa/A1vNpBOEs9O/p +3JYElIQCPBndxJqJ140YCgRwWJX/FD3ufoSXVXLyaM52IwuiwXFuPr1abkTgGBSe +18GcfE/bZ979JRipDT5J1GHV9NNuJOoEeqx+mFFQntP31EljY8WfiMb9qWDvWhyf +VneU3TsIzYMNEUJSe8hYfK2fDckU46KoN+GLi6tXpVfRIkMfBaNuuBzOV0tbQAXY +LsxlrqLJSFFLmUQKTBIcrkIfH26dHhvRo6/D/STo0fTTorz1Iuq/18RHX7DbgIyc +t5rkeQvhnzPlGQog/4WdOsAvqyB0Q1EhGzfCXFKj8dRlEkHHR/usDrujpdADHcwv +HLkLc99FPnINuOaMpMtdA7e34c0UJ/1MQKICJ+hm2PPWLSH+22YwH7BxkszljmXG +RONfda2I5BJK2jsuO9XGiYePgUQxm9pTi+5+RpMvuhONNwKzWJTljsjnj6nZ1seI +ArYfJKO02LLQtVTO3BWPehVGHFwrgFdBanKS/5V3S5gX2vC7ARjNcEKk7NNO/7mH ++8WyM35jzs1+5vvl8JbPrENcHdwbpnx2r5m3nbwelQkLVNfutFW1pyOy5ClrHd0w +KDsIcPg1+LsnZlV9qy+tv8IL+Sw2Z406CUEEAJRwqDzZTJdfgEFGeqZAIjwr1wFL +2t8EF5hLQ/xC4NyuOZGR +=MkDq -----END PGP SIGNATURE-----