Index: doc/v1.html ================================================================== --- doc/v1.html +++ doc/v1.html @@ -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 "::PackageRepository::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 "::PackageRepository::getPackageFromRepository" (from "pkgr.eagle")
+Public API Procedure "::PackageRepository::getPackageFromRepository" (from "pkgr.eagle")

    Required argument "package"
    Required argument "version"
@@ -907,27 +907,27 @@ 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 "::PackageRepository::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 "::PackageRepository::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 "::PackageRepository::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.
@@ -1107,11 +1107,25 @@ 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 "::PackageRepository::isValidPackageRequirement" (from "pkgr.eagle")
+Private Procedure "::PackageRepository::isValidPackageName" (from "pkgr.eagle")
+
+ +    Required argument "name"
+ +    Optional argument "emptyOk" with default value "false"
+ +

+This procedure returns non-zero if the specified string value is a
+valid package name. The emptyOk argument can be non-zero if the
+caller wishes to permit an empty string. This procedure is shared
+with the server.
+


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

    Required argument "requirement"
    Required argument "rangeOk"
@@ -1130,11 +1144,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 "::PackageRepository::extractAndVerifyLookupMetadata" (from "pkgr.eagle")
+Private Procedure "::PackageRepository::extractAndVerifyLookupMetadata" (from "pkgr.eagle")

    Required argument "result"
    Required argument "varName"
@@ -1148,27 +1162,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 "::PackageRepository::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 "::PackageRepository::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 "::PackageRepository::processLookupMetadata" (from "pkgr.eagle")
+Private Procedure "::PackageRepository::processLookupMetadata" (from "pkgr.eagle")

    Required argument "varName"

@@ -1186,11 +1200,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 "::PackageRepository::isPackagePresent" (from "pkgr.eagle")
+Private Procedure "::PackageRepository::isPackagePresent" (from "pkgr.eagle")

    Required argument "package"
    Required argument "version"
@@ -1201,11 +1215,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 "::PackageRepository::isPackageAvailable" (from "pkgr.eagle")
+Private Procedure "::PackageRepository::isPackageAvailable" (from "pkgr.eagle")

    Required argument "package"
    Required argument "version"
@@ -1216,11 +1230,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 "::PackageRepository::canDownloadPackage" (from "pkgr.eagle")
+Private Procedure "::PackageRepository::canDownloadPackage" (from "pkgr.eagle")

    Required argument "package"

@@ -1228,49 +1242,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 "::PackageRepository::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 "::PackageRepository::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 "::PackageRepository::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 "::PackageRepository::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 "::PackageRepository::runSavedPackageUnknownHandler" (from "pkgr.eagle")
+Private Procedure "::PackageRepository::runSavedPackageUnknownHandler" (from "pkgr.eagle")

    Required argument "package"
    Required argument "version"
@@ -1279,11 +1293,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 "::PackageRepository::packageUnknownHandler" (from "pkgr.eagle")
+Private Procedure "::PackageRepository::packageUnknownHandler" (from "pkgr.eagle")

    Required argument "package"
    Optional argument "version" with default value ""
@@ -1296,11 +1310,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
@@ -1307,19 +1321,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 -iQIcBAABCAAGBQJdae3PAAoJEFAslq9JXcLZHxYP/25j7mSSLvy6Wb/fAxCR1SO5 -yaheakkLRrSKyZuK3z9jJe8dG7X6fqnHSxVMNFkSFWN9cUZlTwYL/YG6irudARxS -T2J1DtEzfXKB/HrVnuTB4EuWbeFOmI6phV7N/Y6x13KUzVD8LOLvfEX3K4zyEVmc -jpJDX2le9lNDBsdI/jwp6bU4nM1EQAB2u2OKiloQnBgX2oABcLPtOcAMgm+cp9Qp -TemzeaQjTpJi3YJHZdpcT6tF72RN+N8s1Vz/0JpVteAe/GBkhdIrzDOOdUE087Lx -VpuEmj2x25IUMy2UWrHCrBYL9SUNIcjduNPHQcbe3NlaCvcSvmAA08PfxRhVF3E4 -5dK8y9KLFk75n3lE+cIOhJy4lMKd8yKTl+JcwESA5oX6VHEzzvqx6WsUPVLJCAAQ -lYcfzhe7Vpc5x8d5qodoLHqadVMHR5Ot0lAsd8pVQwtcHEBD84Sr8z0e9QIphwSm -NnFHPFmHSbIKubWzSpFZfYvmPgSRo9KUsysQu0aN6kXxNsovnYoDfogurcx67bJR -OtI1Y0xG3QM4e1oUXrSYYMurige7z2aHCcjmSUJfxDgIq9cC+z6Ubhv2i/AKFUNK -dDVGy7oxrbLt+abx4Yd+u4e4tBcOSKZPe2FxJql6ky37d6JWsbjPKdB6zh5z4Aw+ -A3ExJ1ajxDjQ4S4ULgin -=5aK4 +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 -----END PGP SIGNATURE-----