Index: doc/v1.html
==================================================================
--- doc/v1.html
+++ doc/v1.html
@@ -1,8 +1,8 @@
-
Public API Procedure "getFileViaHttp" (from "common.tcl")
+
Public API Procedure "::Eagle::Tools::Common::getFileViaHttp" (from "common.tcl")
Required argument "uri"
Required argument "redirectLimit"
@@ -18,11 +18,11 @@
designed to process a single HTTP request, including any HTTP
3XX redirects (up to the specified limit), and return the raw
HTTP response data. It may raise any number of script errors.
-
Private Procedure "setupCommonVariables" (from "common.tcl")
+
Private Procedure "::Eagle::Tools::Common::setupCommonVariables" (from "common.tcl")
Required argument "force"
@@ -31,11 +31,11 @@
parameters used by this package. If the force argument is
non-zero, any existing values will be overwritten and set back
to their default values.
-
Private Procedure "pageOut" (from "common.tcl")
+
Private Procedure "::Eagle::Tools::Common::pageOut" (from "common.tcl")
Required argument "channel"
Required argument "string"
@@ -46,11 +46,11 @@
is the channel where the message should be written. The string
argument is the content of the message to emit. If the channel
argument is an empty string, nothing is written.
-
Private Procedure "pageLog" (from "common.tcl")
+
Private Procedure "::Eagle::Tools::Common::pageLog" (from "common.tcl")
Required argument "string"
@@ -58,11 +58,11 @@
designed to emit a message to the HTTP client log. The string
argument is the content of the message to emit. If the string
argument is an empty string, nothing is written.
-
Private Procedure "pageProgress" (from "common.tcl")
+
Private Procedure "::Eagle::Tools::Common::pageProgress" (from "common.tcl")
Required argument "channel"
Required argument "type"
@@ -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 "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 "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 "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 "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 "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 "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 "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 "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 "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 "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 "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 "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 "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 "verifyPlatform" (from "pkgd.eagle")
+
Internal API Procedure "::PackageDownloader::verifyPlatform" (from "pkgd.eagle")
Required argument "platform"
Required argument "varName"
@@ -304,31 +304,31 @@
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 "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
cookie to the one from the raw response data. Upon failure, a
script error will be raised. There are no arguments.
-
Private Procedure "pkgLog" (from "pkgd.eagle")
+
Private Procedure "::PackageDownloader::pkgLog" (from "pkgd.eagle")
Required argument "string"
This procedure emits a message to the package downloader client
log. The string argument is the content of the message to emit.
-
Private Procedure "setupDownloadServerVars" (from "pkgd.eagle")
+
Private Procedure "::PackageDownloader::setupDownloadServerVars" (from "pkgd.eagle")
Required argument "force"
@@ -336,11 +336,11 @@
parameters used by the package downloader client. If the force
argument is non-zero, any existing values will be overwritten and
set back to their default values.
-
Private Procedure "setupDownloadVersionVars" (from "pkgd.eagle")
+
Private Procedure "::PackageDownloader::setupDownloadVersionVars" (from "pkgd.eagle")
Required argument "force"
@@ -348,11 +348,11 @@
configuration parameters used by the package downloader client.
If the force argument is non-zero, any existing values will be
overwritten and set back to their default values.
-
Private Procedure "setupDownloadUriVars" (from "pkgd.eagle")
+
Private Procedure "::PackageDownloader::setupDownloadUriVars" (from "pkgd.eagle")
Required argument "force"
@@ -360,11 +360,11 @@
parameters used by the package downloader client. If the force
argument is non-zero, any existing values will be overwritten and
set back to their default values.
-
Private Procedure "setupDownloadVars" (from "pkgd.eagle")
+
Private Procedure "::PackageDownloader::setupDownloadVars" (from "pkgd.eagle")
Required argument "script"
@@ -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 "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 "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 "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 "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 "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 "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 "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 "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 "maybeAddToAutoPath" (from "pkgd.eagle")
+
Private Procedure "::PackageDownloader::maybeAddToAutoPath" (from "pkgd.eagle")
Required argument "language"
Required argument "directory"
@@ -485,30 +485,30 @@
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 "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 "canUseMsilPlatform" (from "pkgd.eagle")
+
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 "getPackageFile" (from "pkgd.eagle")
+
Private Procedure "::PackageDownloader::getPackageFile" (from "pkgd.eagle")
Required argument "uri"
@@ -518,19 +518,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 "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 "getUniqueTempDirectory" (from "pkgd.eagle")
+
Private Procedure "::PackageDownloader::getUniqueTempDirectory" (from "pkgd.eagle")
Optional argument "prefix" with default value ""
@@ -538,11 +538,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 "guessPackageNameFromFileNames" (from "pkgd.eagle")
+
Private Procedure "::PackageDownloader::guessPackageNameFromFileNames" (from "pkgd.eagle")
Required argument "language"
Required argument "fileNames"
@@ -555,11 +555,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 "downloadAllPlatforms" (from "pkgd.eagle")
+
Private Procedure "::PackageDownloader::downloadAllPlatforms" (from "pkgd.eagle")
Required argument "language"
Required argument "version"
@@ -583,11 +583,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 "downloadOneUriToFile" (from "pkgd.eagle")
+
Private Procedure "::PackageDownloader::downloadOneUriToFile" (from "pkgd.eagle")
Required argument "localFileName"
Required argument "uri"
@@ -603,11 +603,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 "downloadOneFile" (from "pkgd.eagle")
+
Private Procedure "::PackageDownloader::downloadOneFile" (from "pkgd.eagle")
Required argument "language"
Required argument "version"
@@ -640,11 +640,11 @@
file should be written. The usePgp argument should be non-zero when
the OpenPGP signature file needs to be verified for the downloaded
file.
-
Public API Procedure "isHarpyCertificate" (from "pkgr.eagle")
+
Public API Procedure "::PackageRepository::isHarpyCertificate" (from "pkgr.eagle")
Required argument "value"
@@ -652,11 +652,11 @@
looks like a Harpy (script) certificate. The value argument is
the string to check. The value 14 used within this procedure is
the length of the literal string "</Certificate>".
-
Public API Procedure "isOpenPgpSignature" (from "pkgr.eagle")
+
Public API Procedure "::PackageRepository::isOpenPgpSignature" (from "pkgr.eagle")
Required argument "value"
@@ -664,11 +664,11 @@
looks like an OpenPGP signature. The value argument is the string
to check. The value 27 used within this procedure is the length
of the literal string "-----END PGP SIGNATURE-----".
-
Public API Procedure "getFileTempDirectory" (from "pkgr.eagle")
+
Public API Procedure "::PackageRepository::getFileTempDirectory" (from "pkgr.eagle")
Optional argument "envVarName" with default value ""
@@ -675,20 +675,20 @@
This procedure returns the fully qualified name of the directory
where temporary files should be written. The envVarName argument
is an optional extra environment variable to check (first).
-
Public API Procedure "openPgpMustBeInstalled" (from "pkgr.eagle")
+
Public API Procedure "::PackageRepository::openPgpMustBeInstalled" (from "pkgr.eagle")
This procedure attempts to verify that a configured implementation
of OpenPGP is installed locally. There are no arguments. Script
errors are raised if any problems are found. The return value is
undefined.
-
Public API Procedure "verifyOpenPgpSignature" (from "pkgr.eagle")
+
Public API Procedure "::PackageRepository::verifyOpenPgpSignature" (from "pkgr.eagle")
Required argument "fileName"
@@ -698,11 +698,11 @@
not be raised by this procedure. The fileName argument must be
the fully qualified path and file name of the OpenPGP signature
file to verify.
-
Public API Procedure "createOpenPgpSignature" (from "pkgr.eagle")
+
Public API Procedure "::PackageRepository::createOpenPgpSignature" (from "pkgr.eagle")
Required argument "fileName"
@@ -711,11 +711,11 @@
signature is created successfully. A script error should not be
raised by this procedure. The fileName argument must be the fully
qualified path and file name of the file to be signed.
-
Public API Procedure "getUniqueSuffix" (from "pkgr.eagle")
+
Public API Procedure "::PackageRepository::getUniqueSuffix" (from "pkgr.eagle")
Optional argument "paranoia" with default value "1"
@@ -726,11 +726,11 @@
global namespace. The paranoia argument represents the relative
level of paranoia required by the caller; the higher this level,
the more uniqueness is required.
-
Public API Procedure "useServerId" (from "pkgr.eagle")
+
Public API Procedure "::PackageRepository::useServerId" (from "pkgr.eagle")
Optional argument "serverId" with default value ""
@@ -739,11 +739,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 "maybeReadSettingsFile" (from "pkgr.eagle")
+
Public API Procedure "::PackageRepository::maybeReadSettingsFile" (from "pkgr.eagle")
Required argument "script"
@@ -752,11 +752,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 "getPackageFromRepository" (from "pkgr.eagle")
+
Public API Procedure "::PackageRepository::getPackageFromRepository" (from "pkgr.eagle")
Required argument "package"
Required argument "version"
@@ -771,11 +771,11 @@
empty string. The version argument must be a specific version -OR-
a package specification that conforms to TIP #268. The caller
argument must be an empty string -OR- the literal string "handler".
-
Internal API Procedure "formatExecArgument" (from "pkgr.eagle")
+
Internal API Procedure "::PackageRepository::formatExecArgument" (from "pkgr.eagle")
Required argument "value"
@@ -782,11 +782,11 @@
This procedure returns a string argument value, which may contain
spaces, for use with the [exec] command. The value argument is
the string value to format as an [exec] argument.
-
Internal API Procedure "probeForOpenPgpInstallation" (from "pkgr.eagle")
+
Internal API Procedure "::PackageRepository::probeForOpenPgpInstallation" (from "pkgr.eagle")
This procedure attempts to check for an OpenPGP installation being
installed at the default location. There are no arguments. If the
OpenPGP installation is detected and is not yet present in the PATH,
@@ -794,11 +794,11 @@
OpenPGP installation directory was successfully detected and added
to the PATH -OR- detecting and adding it was not necessary because
it already appeared to be available for use.
-
Internal API Procedure "createHarpyCertificate" (from "pkgr.eagle")
+
Internal API Procedure "::PackageRepository::createHarpyCertificate" (from "pkgr.eagle")
Required argument "fileName"
@@ -809,11 +809,11 @@
fully qualified path and file name of the file to be signed. This
procedure assumes that the Harpy package for Eagle is installed and
ready for use (i.e. it can find a valid license certificate).
-
Internal API Procedure "importOpenPgpKeyFile" (from "pkgr.eagle")
+
Internal API Procedure "::PackageRepository::importOpenPgpKeyFile" (from "pkgr.eagle")
Required argument "fileName"
Required argument "varName"
@@ -827,11 +827,11 @@
to import. 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 "getApiKeys" (from "pkgr.eagle")
+
Internal API Procedure "::PackageRepository::getApiKeys" (from "pkgr.eagle")
Optional argument "prefix" with default value ""
Optional argument "prefixOnly" with default value "false"
@@ -844,11 +844,11 @@
that are already configured. The prefixOnly argument should be
non-zero to exclude any API keys other than those based on the
prefix specified by the caller.
-
Internal API Procedure "verifyMetadataLanguage" (from "pkgr.eagle")
+
Internal API Procedure "::PackageRepository::verifyMetadataLanguage" (from "pkgr.eagle")
Required argument "language"
@@ -855,11 +855,11 @@
This procedure verifies the language specified by the caller. The
language argument must be an empty string -OR- the literal string
"Eagle" or "Tcl". This procedure may raise script errors.
-
Internal API Procedure "verifyServerId" (from "pkgr.eagle")
+
Internal API Procedure "::PackageRepository::verifyServerId" (from "pkgr.eagle")
Required argument "serverId"
@@ -866,19 +866,19 @@
This procedure verifies that the specified value is indeed a valid
server identifier. The serverId argument is the value to verify.
This procedure may raise script errors.
-
Internal API Procedure "getSubmitBaseUri" (from "pkgr.eagle")
+
Internal API Procedure "::PackageRepository::getSubmitBaseUri" (from "pkgr.eagle")
This procedure returns the base URI for the package repository
server endpoint that is used to submit packages. There are no
arguments.
-
Internal API Procedure "getResponseCodeFromRawData" (from "pkgr.eagle")
+
Internal API Procedure "::PackageRepository::getResponseCodeFromRawData" (from "pkgr.eagle")
Required argument "data"
@@ -885,11 +885,11 @@
This procedure attempts to extract the lookup code from the raw
HTTP response data. The data argument is the raw HTTP response
data. An empty string is returned if no lookup code is available.
-
Internal API Procedure "getResponseResultFromRawData" (from "pkgr.eagle")
+
Internal API Procedure "::PackageRepository::getResponseResultFromRawData" (from "pkgr.eagle")
Required argument "data"
@@ -896,11 +896,11 @@
This procedure attempts to extract the lookup result from the raw
HTTP response data. The data argument is the raw HTTP response
data. An empty string is returned if no lookup result is available.
-
Internal API Procedure "isResponseCodeOk" (from "pkgr.eagle")
+
Internal API Procedure "::PackageRepository::isResponseCodeOk" (from "pkgr.eagle")
Required argument "code"
@@ -907,35 +907,35 @@
This procedure returns non-zero if the specified lookup response
code indicates success. The code argument is the extracted HTTP
lookup response code.
-
Internal API Procedure "makeTclReady" (from "pkgr.eagle")
+
Internal API Procedure "::PackageRepository::makeTclReady" (from "pkgr.eagle")
This procedure is designed for Eagle. It attempts to load the
"best" native Tcl library. It may raise any number of script
errors. There are no arguments.
-
Internal API Procedure "eagleMustBeReady" (from "pkgr.eagle")
+
Internal API Procedure "::PackageRepository::eagleMustBeReady" (from "pkgr.eagle")
This procedure, which may only be used from a native Tcl script,
checks if Garuda and Eagle are loaded and ready. If not, a script
error is raised. There are no arguments.
-
Internal API Procedure "makeEagleReady" (from "pkgr.eagle")
+
Internal API Procedure "::PackageRepository::makeEagleReady" (from "pkgr.eagle")
This procedure is designed for native Tcl. It attempts to load
the Garuda package and gain access to Eagle. It may raise any
number of script errors. There are no arguments.
-
Private Procedure "setupRepositoryServerVars" (from "pkgr.eagle")
+
Private Procedure "::PackageRepository::setupRepositoryServerVars" (from "pkgr.eagle")
Required argument "force"
@@ -943,11 +943,11 @@
parameters used by the package repository client. If the force
argument is non-zero, any existing values will be overwritten and
set back to their default values.
-
Private Procedure "setupRepositoryUriVars" (from "pkgr.eagle")
+
Private Procedure "::PackageRepository::setupRepositoryUriVars" (from "pkgr.eagle")
Required argument "force"
@@ -955,11 +955,11 @@
parameters used by the package repository client. If the force
argument is non-zero, any existing values will be overwritten and
set back to their default values.
-
Private Procedure "formatPackageName" (from "pkgr.eagle")
+
Private Procedure "::PackageRepository::formatPackageName" (from "pkgr.eagle")
Required argument "package"
Required argument "version"
@@ -969,11 +969,11 @@
package name, for use in logging. The package argument is the
name of the package. The version argument is the version of the
package.
-
Private Procedure "formatResult" (from "pkgr.eagle")
+
Private Procedure "::PackageRepository::formatResult" (from "pkgr.eagle")
Required argument "code"
Required argument "result"
@@ -983,21 +983,21 @@
result is empty, only the return code is used. The code argument
must be an integer Tcl return code (e.g. from [catch]) and the
result argument is the script result or error message.
-
Private Procedure "pkgLog" (from "pkgr.eagle")
+
Private Procedure "::PackageRepository::pkgLog" (from "pkgr.eagle")
Required argument "string"
This procedure emits a message to the package repository client
log. The string argument is the content of the message to emit.
-
Private Procedure "stringIsList" (from "pkgr.eagle")
+
Private Procedure "::PackageRepository::stringIsList" (from "pkgr.eagle")
Required argument "value"
@@ -1004,43 +1004,43 @@
This procedure attempts to determine if a string is a valid list
and returns non-zero when that is true. The value argument is
the string to check.
-
Private Procedure "getFileTempName" (from "pkgr.eagle")
+
Private Procedure "::PackageRepository::getFileTempName" (from "pkgr.eagle")
This procedure returns a unique temporary file name. A script
error is raised if this task cannot be accomplished. There are
no arguments.
-
Private Procedure "getOpenPgpPassphraseFile" (from "pkgr.eagle")
+
Private Procedure "::PackageRepository::getOpenPgpPassphraseFile" (from "pkgr.eagle")
This procedure returns the name of the file containing the OpenPGP
passphrase. This procedure is only used when creating an OpenPGP
signature. There are no arguments.
-
Private Procedure "getLookupVarNamePrefix" (from "pkgr.eagle")
+
Private Procedure "::PackageRepository::getLookupVarNamePrefix" (from "pkgr.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 "getLookupBaseUri" (from "pkgr.eagle")
+
Private Procedure "::PackageRepository::getLookupBaseUri" (from "pkgr.eagle")
This procedure returns the base URI for the package repository
server endpoint that is used to lookup packages. There are no
arguments.
-
Private Procedure "getLookupUri" (from "pkgr.eagle")
+
Private Procedure "::PackageRepository::getLookupUri" (from "pkgr.eagle")
Required argument "apiKeys"
Required argument "package"
@@ -1057,11 +1057,11 @@
looked up -OR- an empty string for any available version. There
are no HTTP requests issued by this procedure; it simply returns
the URI to use.
-
Private Procedure "getIfNeededVersion" (from "pkgr.eagle")
+
Private Procedure "::PackageRepository::getIfNeededVersion" (from "pkgr.eagle")
Required argument "package"
Required argument "version"
@@ -1073,11 +1073,11 @@
the name of the package, it cannot be an empty string. The
version argument is the specific version being looked up -OR- an
empty string for any available version.
-
Private Procedure "packageRequirementToVersion" (from "pkgr.eagle")
+
Private Procedure "::PackageRepository::packageRequirementToVersion" (from "pkgr.eagle")
Required argument "requirement"
@@ -1086,11 +1086,11 @@
returned, if appropriate (i.e. any version should be allowed).
The requirement argument must be a package specification that
conforms to TIP #268.
-
Private Procedure "getLookupData" (from "pkgr.eagle")
+
Private Procedure "::PackageRepository::getLookupData" (from "pkgr.eagle")
Required argument "apiKeys"
Required argument "package"
@@ -1107,11 +1107,11 @@
empty string for any available version. This procedure may raise
script errors. All line-endings are normalized to Unix-style;
therefore, all script signatures must assume this.
-
Private Procedure "isValidPackageRequirement" (from "pkgr.eagle")
+
Private Procedure "::PackageRepository::isValidPackageRequirement" (from "pkgr.eagle")
Required argument "requirement"
Required argument "rangeOk"
@@ -1130,11 +1130,11 @@
considered to be valid by the caller. The rangeOk argument should
be non-zero if the version range syntax is allowed; this argument is
ignored for Eagle because it requires TIP #268 support.
-
Private Procedure "extractAndVerifyLookupMetadata" (from "pkgr.eagle")
+
Private Procedure "::PackageRepository::extractAndVerifyLookupMetadata" (from "pkgr.eagle")
Required argument "result"
Required argument "varName"
@@ -1148,27 +1148,27 @@
of the immediate caller, that should receive the extracted package
lookup metadata. The caller argument must be an empty string -OR-
the literal string "handler".
-
Private Procedure "tclMustBeReady" (from "pkgr.eagle")
+
Private Procedure "::PackageRepository::tclMustBeReady" (from "pkgr.eagle")
This procedure, which may only be used from an Eagle script, checks
if a native Tcl library is loaded and ready. If not, a script error
is raised. There are no arguments.
-
Private Procedure "eagleHasSecurity" (from "pkgr.eagle")
+
Private Procedure "::PackageRepository::eagleHasSecurity" (from "pkgr.eagle")
This procedure returns non-zero if the current script is being
evaluated in Eagle with signed-only script security enabled.
There are no arguments.
-
Private Procedure "processLookupMetadata" (from "pkgr.eagle")
+
Private Procedure "::PackageRepository::processLookupMetadata" (from "pkgr.eagle")
Required argument "varName"
@@ -1186,11 +1186,11 @@
is the name of an array variable in the call frame of the
immediate caller, that contains the package lookup metadata. This
procedure may raise script errors.
-
Private Procedure "isPackagePresent" (from "pkgr.eagle")
+
Private Procedure "::PackageRepository::isPackagePresent" (from "pkgr.eagle")
Required argument "package"
Required argument "version"
@@ -1201,11 +1201,11 @@
sought, it cannot be an empty string. The version argument must be
a specific version -OR- a package specification that conforms to TIP
#268.
-
Private Procedure "isPackageAvailable" (from "pkgr.eagle")
+
Private Procedure "::PackageRepository::isPackageAvailable" (from "pkgr.eagle")
Required argument "package"
Required argument "version"
@@ -1216,11 +1216,11 @@
sought, it cannot be an empty string. The version argument must be
a specific version -OR- a package specification that conforms to TIP
#268.
-
Private Procedure "canDownloadPackage" (from "pkgr.eagle")
+
Private Procedure "::PackageRepository::canDownloadPackage" (from "pkgr.eagle")
Required argument "package"
@@ -1228,49 +1228,49 @@
downloaded, i.e. because it is not required for the downloading
process itself to be functional, etc. The package argument is
the name of the package to check.
-
Private Procedure "setupPackageUnknownHandler" (from "pkgr.eagle")
+
Private Procedure "::PackageRepository::setupPackageUnknownHandler" (from "pkgr.eagle")
This procedure performs initial setup of the package repository
client, using the current configuration parameters. There are
no arguments. It may load the Garuda package when evaluated in
native Tcl. It may load a native Tcl library when evaluated in
Eagle. It may install the [package unknown] hook.
-
Private Procedure "isPackageUnknownHandlerHooked" (from "pkgr.eagle")
+
Private Procedure "::PackageRepository::isPackageUnknownHandlerHooked" (from "pkgr.eagle")
This procedure returns non-zero if the [package unknown] handler
has already been hooked by the package repository client. There
are no arguments.
-
Private Procedure "hookPackageUnknownHandler" (from "pkgr.eagle")
+
Private Procedure "::PackageRepository::hookPackageUnknownHandler" (from "pkgr.eagle")
This procedure attempts to hook the [package unknown] handler. It
will raise a script error if this has already been done. The old
[package unknown] handler is saved and will be used by the new one
as part of the overall package loading process. There are no
arguments.
-
Private Procedure "unhookPackageUnknownHandler" (from "pkgr.eagle")
+
Private Procedure "::PackageRepository::unhookPackageUnknownHandler" (from "pkgr.eagle")
This procedure attempts to unhook the [package unknown] handler.
It will raise a script error if the [package unknown] handler is
not hooked. The old [package unknown] handler is restored and
the saved [package unknown] handler is cleared. There are no
arguments.
-
Private Procedure "runSavedPackageUnknownHandler" (from "pkgr.eagle")
+
Private Procedure "::PackageRepository::runSavedPackageUnknownHandler" (from "pkgr.eagle")
Required argument "package"
Required argument "version"
@@ -1279,11 +1279,11 @@
The procedure runs the saved [package unknown] handler. Any script
errors are raised to the caller. The package and version arguments
are passed in from the current [package unknown] handler verbatim.
-
Private Procedure "packageUnknownHandler" (from "pkgr.eagle")
+
Private Procedure "::PackageRepository::packageUnknownHandler" (from "pkgr.eagle")
Required argument "package"
Optional argument "version" with default value ""
@@ -1296,11 +1296,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 "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
@@ -1307,27 +1307,27 @@
file should (normally) modify the "::pkgr_api_keys" variable
in order to add API keys for use with the package repository
client.
-
Private Procedure "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 "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.
-
Internal API Procedure "setupArgumentData" (from "pkgu.eagle")
+
Internal API Procedure "::PackageUploader::setupArgumentData" (from "pkgu.eagle")
Required argument "argv"
@@ -1334,20 +1334,20 @@
This procedure initializes the array containing data derived from
the command line arguments, if any. The argv argument should be
the list of command line arguments.
-
Internal API Procedure "haveArgumentData" (from "pkgu.eagle")
+
Internal API Procedure "::PackageUploader::haveArgumentData" (from "pkgu.eagle")
This procedure is used to determine if all the package submission
data is available. There are no arguments. Non-zero is returned
if all the package submission data is available. This procedure
should not raise script errors.
-
Internal API Procedure "submitEventHandler" (from "pkgu.eagle")
+
Internal API Procedure "::PackageUploader::submitEventHandler" (from "pkgu.eagle")
Optional argument list "args"
@@ -1356,43 +1356,43 @@
args argument is not really used, it is a placeholder to make this
procedure more portable between Tcl and Eagle. This procedure may
raise script errors.
-
Internal API Procedure "setupWinFormsUserInterface" (from "pkgu.eagle")
+
Internal API Procedure "::PackageUploader::setupWinFormsUserInterface" (from "pkgu.eagle")
This procedure creates the user interface for this tool using Eagle
and WinForms. The existing argument data, if any, will be used to
populate it. There are no arguments.
-
Internal API Procedure "setupTkUserInterface" (from "pkgu.eagle")
+
Internal API Procedure "::PackageUploader::setupTkUserInterface" (from "pkgu.eagle")
This procedure creates the user interface for this tool using Tcl
and Tk. The existing argument data, if any, will be used to
populate it. There are no arguments.
-
Private Procedure "setupUploadVars" (from "pkgu.eagle")
+
Private Procedure "::PackageUploader::setupUploadVars" (from "pkgu.eagle")
This procedure sets up the default values for all configuration
parameters used by the package uploader client. There are no
arguments.
-
Private Procedure "setupCheckoutVars" (from "pkgu.eagle")
+
Private Procedure "::PackageUploader::setupCheckoutVars" (from "pkgu.eagle")
This procedure sets up the default values for all configuration
parameters used by the package uploader client that require the
location of the checkout directory. There are no arguments.
-
Private Procedure "formatStringMapValue" (from "pkgu.eagle")
+
Private Procedure "::PackageUploader::formatStringMapValue" (from "pkgu.eagle")
Required argument "value"
@@ -1401,11 +1401,11 @@
value argument is the string value to format. No return value is
reserved to indicate an error. This procedure may not raise any
script errors.
-
Private Procedure "countCommonPathParts" (from "pkgu.eagle")
+
Private Procedure "::PackageUploader::countCommonPathParts" (from "pkgu.eagle")
Required argument "path1"
Required argument "path2"
@@ -1415,11 +1415,11 @@
count is returned, zero if there are no common path components. The
path1 and path2 arguments are the paths to compare. This procedure
may not raise script errors.
-
Private Procedure "getCommonContainingDirectory" (from "pkgu.eagle")
+
Private Procedure "::PackageUploader::getCommonContainingDirectory" (from "pkgu.eagle")
Required argument "fileNames"
@@ -1428,11 +1428,11 @@
fileNames argument is the list of (fully?) qualified file names to
process. This procedure may not raise script errors. If there is
no common containing directory, an empty string is returned.
-
Private Procedure "getRelativeFileNames" (from "pkgu.eagle")
+
Private Procedure "::PackageUploader::getRelativeFileNames" (from "pkgu.eagle")
Required argument "fileNames"
Required argument "maximumLevels"
@@ -1444,11 +1444,11 @@
process. The maximumLevels argument is the maximum path depth that
is allowed for all file names. This procedure may raise script
errors.
-
Private Procedure "getScriptChunkForFileNames" (from "pkgu.eagle")
+
Private Procedure "::PackageUploader::getScriptChunkForFileNames" (from "pkgu.eagle")
Required argument "fileNames"
Required argument "maximumLevels"
@@ -1460,11 +1460,11 @@
the list variable. The maximumLevels argument is the maximum path
depth that is allowed for all file names. This procedure may raise
script errors.
-
Private Procedure "createRepositoryScript" (from "pkgu.eagle")
+
Private Procedure "::PackageUploader::createRepositoryScript" (from "pkgu.eagle")
Required argument "serverId"
Required argument "versionId"
@@ -1495,11 +1495,11 @@
(fully?) qualified file names to be downloaded when the associated
package is being provided. The options argument is reserved for
future use, it should be an empty list.
-
Private Procedure "createMultipartFormData" (from "pkgu.eagle")
+
Private Procedure "::PackageUploader::createMultipartFormData" (from "pkgu.eagle")
Required argument "boundary"
Required argument "request"
@@ -1510,19 +1510,19 @@
is a boundary value, as specified in section 4.1 of the RFC. The
request argument is the dictionary of name/value pairs to include
in the form body. This procedure may not raise script errors.
-
Private Procedure "getSubmitUri" (from "pkgu.eagle")
+
Private Procedure "::PackageUploader::getSubmitUri" (from "pkgu.eagle")
This procedure returns the full URI to use when submitting a new
package to the package repository server. There are no arguments.
This procedure may raise script errors.
-
Private Procedure "submitPackageMetadata" (from "pkgu.eagle")
+
Private Procedure "::PackageUploader::submitPackageMetadata" (from "pkgu.eagle")
Required argument "apiKey"
Required argument "package"
@@ -1547,86 +1547,86 @@
evaluated when the package needs to be provided. The certificate
argument is the certificate associated with the script, which may be
an OpenPGP signature or a Harpy script certificate.
-
Private Procedure "getCheckoutId" (from "pkgu.eagle")
+
Private Procedure "::PackageUploader::getCheckoutId" (from "pkgu.eagle")
This procedure attempts to query the identifier of the Fossil
checkout. There are no arguments. An empty string is returned if
the information cannot be determined.
-
Private Procedure "getCheckoutDirectory" (from "pkgu.eagle")
+
Private Procedure "::PackageUploader::getCheckoutDirectory" (from "pkgu.eagle")
This procedure attempts to query the root directory of the Fossil
checkout. There are no arguments. An empty string is returned if
the information cannot be determined.
-
Private Procedure "joinPath" (from "pkgu.eagle")
+
Private Procedure "::PackageUploader::joinPath" (from "pkgu.eagle")
Optional argument list "args"
This procedure builds a native path using the specified parts and
returns it. All arguments are considered to be parts of the path.
-
Private Procedure "verifyCheckoutDirectory" (from "pkgu.eagle")
+
Private Procedure "::PackageUploader::verifyCheckoutDirectory" (from "pkgu.eagle")
This procedure attempts to verify that the root directory of the
Fossil checkout is present, valid, and is actually a directory.
There are no arguments. Script errors will be raised if any of
the checks fail.
-
Private Procedure "fossilMustBeInstalled" (from "pkgu.eagle")
+
Private Procedure "::PackageUploader::fossilMustBeInstalled" (from "pkgu.eagle")
This procedure attempts to verify that an implementation of Fossil
is installed locally. There are no arguments. Script errors are
raised if any problems are found. The return value is undefined.
-
Private Procedure "verifyThereAreNoChanges" (from "pkgu.eagle")
+
Private Procedure "::PackageUploader::verifyThereAreNoChanges" (from "pkgu.eagle")
This procedure attempts to verify that the checkout directory does
not contain any (stray) changes. There are no arguments. Non-zero
is returned if the verification is successful.
-
Private Procedure "verifyThisIsTheCorrectProject" (from "pkgu.eagle")
+
Private Procedure "::PackageUploader::verifyThisIsTheCorrectProject" (from "pkgu.eagle")
This procedure attempts to verify that the checkout directory does
belong to the correct project. There are no arguments. Non-zero
is returned if the verification is successful.
-
Private Procedure "verifyThisIsTheCorrectBranch" (from "pkgu.eagle")
+
Private Procedure "::PackageUploader::verifyThisIsTheCorrectBranch" (from "pkgu.eagle")
This procedure attempts to verify that the checkout directory does
belong to the correct branch. There are no arguments. Non-zero
is returned if the verification is successful.
-
Private Procedure "changeToTheCorrectBranch" (from "pkgu.eagle")
+
Private Procedure "::PackageUploader::changeToTheCorrectBranch" (from "pkgu.eagle")
This procedure attempts to change the branch for the checkout
directory. There are no arguments. This procedure may raise
script errors.
-
Private Procedure "stageOnePackageFile" (from "pkgu.eagle")
+
Private Procedure "::PackageUploader::stageOnePackageFile" (from "pkgu.eagle")
Required argument "targetDirectory"
Required argument "fileName"
@@ -1637,11 +1637,11 @@
to the package platform directory. The fileName argument is the
relative name of the file to be staged. This procedure may raise
script errors.
-
Private Procedure "stagePackageFiles" (from "pkgu.eagle")
+
Private Procedure "::PackageUploader::stagePackageFiles" (from "pkgu.eagle")
Required argument "language"
Required argument "version"
@@ -1654,11 +1654,11 @@
This procedure attempts to stage the specified package files using
Fossil. The fileNames argument is a list of (fully?) qualified
local file names to stage.
-
Private Procedure "commitPackageFiles" (from "pkgu.eagle")
+
Private Procedure "::PackageUploader::commitPackageFiles" (from "pkgu.eagle")
Required argument "package"
Required argument "patchLevel"
@@ -1674,11 +1674,11 @@
remote package file repository using Fossil. The varName argument
is the name of a scalar variable in the context of the immediate
caller that will receive the resulting Fossil check-in identifier.
-
Private Procedure "textBoxEventHandler" (from "pkgu.eagle")
+
Private Procedure "::PackageUploader::textBoxEventHandler" (from "pkgu.eagle")
Required argument "varName"
Required argument "sender"
@@ -1693,11 +1693,11 @@
and e arguments are provided by the framework and represent the
control involved in the event and any extra data that may be
necessary to process the event.
-
Private Procedure "listBoxEventHandler" (from "pkgu.eagle")
+
Private Procedure "::PackageUploader::listBoxEventHandler" (from "pkgu.eagle")
Required argument "varName"
Optional argument list "args"
@@ -1711,11 +1711,11 @@
containing two elements. The first element is the control involved
in the event. The second element is any extra data that may be
necessary to process the event.
-
Private Procedure "handleFormClosedEvent" (from "pkgu.eagle")
+
Private Procedure "::PackageUploader::handleFormClosedEvent" (from "pkgu.eagle")
Optional argument list "args"
@@ -1724,11 +1724,11 @@
args argument is not really used, it is a placeholder to make this
procedure more portable between Tcl and Eagle. This procedure may
raise script errors.
-
Private Procedure "clearEventHandler" (from "pkgu.eagle")
+
Private Procedure "::PackageUploader::clearEventHandler" (from "pkgu.eagle")
Optional argument list "args"