((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/awful-postgresql" "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 "awful-postgresql" (toc) (section 3 "Description" (p "Postgresql support for " (int-link "/eggref/4/awful" "awful") ".") (p "This extension provides the " (tt "enable-db") " and " (tt "switch-to-postgresql-database") " procedures which add Postgresql support for awful, based on the features provided by the " (int-link "/eggref/4/postgresql" "postgresql egg") ".")) (section 3 "Author" (p (int-link "/users/mario-domenech-goulart" "Mario Domenech Goulart"))) (section 3 "Repository" (p (link "https://github.com/mario-goulart/awful-postgresql" "https://github.com/mario-goulart/awful-postgresql"))) (section 3 "Requirements" (ul (li (int-link "/eggref/4/awful" "awful")) (li (int-link "/eggref/4/postgresql" "postgresql")))) (section 3 "Procedures" (section 4 (tt "enable-db") (def (sig (procedure "(enable-db)" (id enable-db))) (p "Enable Postgresql support for " (int-link "/eggref/4/awful" "awful") ".  This procedure basically sets up awful to use the connection, disconnection, query and query escaping procedures for Postgresql databases."))) (section 4 (tt "switch-to-postgresql-database") (def (sig (procedure "(switch-to-postgresql-database)" (id switch-to-postgresql-database))) (p "Resets all the awful db-related parameters to postgresql values (for when using multiple databases under the same awful server).")))) (section 3 "Parameters" (section 4 (tt "db-result-processor") (p "This parameter yields a one-argument procedure (the argument is the object representing the results as returned by the postgresql bindings).") (p "The default value is:") (highlight scheme "(lambda (result)\n  (row-map identity result))") (p "This parameter has been added in version 0.5."))) (section 3 "License" (pre "Copyright (c) 2008-2018, Mario Domenech Goulart\nAll rights reserved.\n\nRedistribution and use in source and binary forms, with or without\nmodification, are permitted provided that the following conditions are\nmet:\n\nRedistributions of source code must retain the above copyright\nnotice, this list of conditions and the following disclaimer.\n\nRedistributions in binary form must reproduce the above copyright\nnotice, this list of conditions and the following disclaimer in the\ndocumentation and/or other materials provided with the distribution.\n\nNeither the name of the author nor the names of its contributors may\nbe used to endorse or promote products derived from this software\nwithout specific prior written permission.\n\nTHIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS\n\"AS IS\" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT\nLIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS\nFOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE\nCOPYRIGHT HOLDERS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT,\nINDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES\n(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR\nSERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)\nHOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,\nSTRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)\nARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED\nOF THE POSSIBILITY OF SUCH DAMAGE.")) (section 3 "Version history" (section 5 "version 0.7.0" (ul (li "CHICKEN 5 support") (li "Remove implementation of " (tt "sql-quoter") " (deprecated in version 0.5)"))) (section 5 "version 0.6.0" (ul (li "SSQL support") (li "The default value for " (tt "(db-inquirer)") "'s " (tt "default") " keyword parameter is now " (tt "'()") ". " (b "Warning") ": this change may break your code!")) (p "In case of an empty result set from a query, " (tt "(db-inquirer)") " will now return " (tt "'()") " instead of " (tt "#f") ".") (p "This change can be specially harmful in case you have something like") (highlight scheme "(or ($db \"some query\") \"something\")") (p "In this example, if the query returns an empty result set, that expression would produce:") (ul (li "in older awful-postgresql versions: " (tt "\"something\"")) (li "in awful-postgresql versions with this change: " (tt "'()")))) (section 5 "version 0.5.1" (ul (li "Fix application of " (tt "db-result-processor") " (patch by Hugo Arregui)"))) (section 5 "version 0.5" (ul (li "Added " (tt "db-result-processor") " parameter (patch by Hugo Arregui)") (li "Deprecated " (tt "sql-quoter") " parameter"))) (section 5 "version 0.4" (ul (li "Added " (tt "switch-to-postgresql-database") " procedure"))) (section 5 "version 0.3" (ul (li (tt "db-inquirer") " supports the " (tt "values") " keyword parameter (patch by Stephen Eilert)"))) (section 5 "version 0.2" (ul (li "fix for " (tt "sql-quoter") " (reflects on awful's " (tt "sql-quote") ")"))) (section 5 "version 0.1" (ul (li "Initial release"))))))