(type egg)
(signature "gather-egg-information egg")
(timestamp 1612269487)
(sxml ((section 2 "Outdated egg!" (p "This is an egg for CHICKEN 4, the unsupported old release.  You're almost certainly looking for " (int-link "/eggref/5/gather-egg-information" "the CHICKEN 5 version of this egg") ", if it exists.") (p "If it does not exist, there may be equivalent functionality provided by another egg; have a look at the " (link "https://wiki.call-cc.org/chicken-projects/egg-index-5.html" "egg index") ". Otherwise, please consider porting this egg to the current version of CHICKEN.")) (section 2 "gather-egg-information" (section 3 "Description" (p "This egg implements a replacement for CHICKEN core's " (tt "gather-egg-information") " procedure which works with both old and new " (int-link "/egg/henrietta-cache" "henrietta-cache") " cache formats.") (p "Although it is an obscure, undocumented and likely to be removed CHICKEN core procedure, " (tt "gather-egg-information") " is used by a couple of eggs to extract egg metadata out of a directory containing source code of eggs.") (p "Historically, CHICKEN eggs were maintained in a centralized Subversion repository (some still are), which adopted the tags/trunk convention for directory layout.  Currently, a " (int-link "/releasing-your-egg" "distributed egg system") " is in use. Eggs can be hosted on a variety of version control systems, so the tags/trunk layout for egg sources out of Subversion doesn't make sense anymore. " (int-link "/egg/henrietta-cache" "henrietta-cache") ", the tool which fetches egg sources and centralizes them under a " (i "cache") " directory, got rid of the tags/trunk layout convention in version 1.0, and that change broke the CHICKEN core's " (tt "gather-egg-information") " procedure, since it assumes a tags/trunk layout (in fact, only the " (tt "tags") " directory is relevant here).") (p "This egg provides a replacement for CHICKEN core's " (tt "gather-egg-information") " procedure, supporting both henrietta-cache's cache formats (with and without the tags/trunk layout).")) (section 3 "Author" (p "The CHICKEN Team")) (section 3 "Requirements" (p "None")) (section 3 "API" (def (sig (procedure "(gather-egg-information dir)" (id gather-egg-information))) (p "Return an alist mapping egg names (symbols) to their corresponding version and metadata."))) (section 3 "License" (p "BSD")) (section 3 "Version history" (dl (dt "1.0.0") (dd "Initial release"))))))
