(type egg)
(signature "inclub 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/inclub" "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.") (toc)) (section 2 "Inclub" (section 3 "Description" (p "The syntax form " (tt "inclub") " is a convenience substitute for " (tt "include") " for use in multi-file projects.  When the program may be run either interpreted or compiled, and may be executed from outside its directory, possibly through a symlink, inclub handles the details of making sure the \"inclubbed\" files get loaded as intended.") (p "In compiled code, inclub simply expands to include, meaning the inclubbed file will be compiled into the binary.") (p "In interpreted code, inclub resolves any symlinks back to the directory the program resides in, and calls " (tt "load") " on the inclubbed file in that directory.")) (section 3 "Authors" (ul (li "John J Foerch"))) (section 3 "Repository" (p "The source can be obtained or browsed " (link "http://github.com/retroj/inclub" "on github") ".")) (section 3 "Requirements" (ul (li (int-link "filepath")))) (section 3 "API" (def (sig (syntax "(inclub STRING)" (id inclub))))) (section 3 "Examples" (section 4 "Basic Usage" (p "To use inclub to load a file called \"myfile.scm\":") (highlight scheme "(use inclub)\n(inclub \"myfile\")") (p "If myfile.scm contains a module called " (tt "myfile") ", add this:") (highlight scheme "(import myfile)") (p "If the project has multiple modules that need to import a module provided by an inclubbed file, the file should be inclubbed only in the main file; the other files can then import the module."))) (section 3 "Acknowledgements" (p "Thanks to Zbigniew for working out the basic mechanism, and also for proposing the name \"inclub\" — " (i "inclub: the brute force include."))) (section 3 "License" (p "BSD")) (section 3 "Version History" (ul (li "0.1: (2012-01-01) initial release") (li "0.2: (2012-05-11) trivial update"))))))
