Ignore:
Timestamp:
01/05/08 20:17:50 (12 years ago)
Author:
felix winkelmann
Message:

merged trunk

File:
1 edited

Legend:

Unmodified
Added
Removed
  • chicken/branches/release/manual/chicken-setup

    r5945 r7276  
    8181
    8282The optional argument {{INFOLIST}} should be an association list that
    83 maps symbols to values, this list will be stored as {{ID.setup}} at the same
     83maps symbols to values, this list will be stored as {{ID.setup-info}} at the same
    8484location as the extension code. Currently the following properties are used:
    8585
     
    118118
    119119Copies the given files into the examples directory, which is usually
    120 {{$prefix/share/chicken/examples}} (equivalent to {{$CHICKEN_HOME/examples}}
     120{{$prefix/share/chicken/examples}}
    121121or {{(make-pathname (chicken-home) "examples")}}).
    122122
     
    270270
    271271Holds the path where executables are installed and defaults to either {{$CHICKEN_PREFIX/bin}},
    272 if the environment variable {{CHICKEN_PREFIX}} is set, {{$CHICKEN_HOME}} or the
     272if the environment variable {{CHICKEN_PREFIX}} is set or the
    273273path where the CHICKEN binaries ({{chicken}}, {{csi}}, etc.) are installed.
    274274
     
    325325 [procedure] (cross-chicken)
    326326
    327 Retrusn {{#t}} if this system is configured for cross-compilation or {{#f}}
     327Returns {{#t}} if this system is configured for cross-compilation or {{#f}}
    328328otherwise.
     329
     330
     331==== host-extension
     332
     333 [parameter] host-extension
     334
     335For a cross-compiling CHICKEN, when compiling an extension, then it
     336should be built for the host environment (as opposed to the target
     337environment). This parameter is controlled by the {{-host-extension}} command-line
     338option. A setup script should perform the proper steps of compiling any
     339code by passing {{-host}} when invoking {{csc}} or using the {{compile}}
     340macro.
    329341
    330342
     
    515527; {{-r  -run FILENAME}} : Load and execute given file.
    516528; {{-s  -script FILENAME}} :Executes the given Scheme source file with all remaining arguments and exit. The ''she-bang'' shell script header is recognized, so you can write Scheme scripts that use {{chicken-setup}} just as with {{csi}}.
    517 ; {{-e  -eval EXPRESSION}} : Evaluates the given expression(s).
    518 ; {{-v  -verbose}} : Display additional debug information.
    519 ; {{-k  -keep}} : Keep temporary files and directories.
    520 ; {{-c  -csc-option OPTION}} : Passes {{OPTION}} as an extra argument to invocations of the compiler-driver ({{csc}}). This works only if {{csc}} is invoked as {{(run (csc ...))}}.
    521 ; {{-d  -dont-ask}} : Do not ask the user before trying to download required extensions.
    522 ; {{-n  -no-install}} : Do not install generated binaries and/or support files. Any invocations of {{install-program}}, {{install-extension}} or {{install-script}} will be be no-ops.
    523 ; {{-i  -docindex}} : Displays the path to the index-page of any installed extension-documentation. If the index page does not exist, it is created.
     529; {{-e  -eval EXPRESSION}} : Evaluates the given expression(s)
     530; {{-v  -verbose}} : Display additional debug information
     531; {{-k  -keep}} : Keep temporary files and directories
     532; {{-c  -csc-option OPTION}} : Passes {{OPTION}} as an extra argument to invocations of the compiler-driver ({{csc}}); this works only if {{csc}} is invoked as {{(run (csc ...))}}
     533; {{-d  -dont-ask}} : Do not ask the user before trying to download required extensions
     534; {{-n  -no-install}} : Do not install generated binaries and/or support files; any invocations of {{install-program}}, {{install-extension}} or {{install-script}} will be be no-ops
     535; {{-i  -docindex}} : Displays the path to the index-page of any installed extension-documentation; if the index page does not exist, it is created
    524536; {{-t  -test EXTENSION ...}} : return success if all given extensions are installed
    525537; {{-ls EXTENSION}} : List installed files for extension
    526538; {{-fetch-tree}} : Download and print the repository catalog
    527 ; {{-t  -test}} : If the extension sources contain a directory named {{tests}} and this directory includes a file named {{run.scm}} then this file is executed (with {{tests}} being the current working directory).
     539; {{-create-tree DIRECTORY}} : Create a fresh, minimal repository catalog and writes it to stdout
     540; {{-t  -test}} : If the extension sources contain a directory named {{tests}} and this directory includes a file named {{run.scm}} then this file is executed (with {{tests}} being the current working directory)
    528541; {{-tree FILENAME}} : Download and show the repository catalog
    529542; {{-svn URL}} : Fetch extension from [[http://subversion.tigris.org|Subversion]] repository
     
    531544; {{-local PATHNAME}} : Fetch extension from local file
    532545; {{-destdir PATHNAME}} : Specify alternative installation prefix (for packaging)
    533 ; {{--}} : Ignore all following arguments.
     546; {{-host-extension}} : Compile extension in "host" mode (sets the parameter {{host-extension}} to {{#f}})
     547; {{--}} : Ignore all following arguments
    534548
    535549Note that the options are processed exactly in the order in which they appear in the command-line.
     
    543557{{chicken-setup -fetch}}) and extract its contents with a separate
    544558program (like {{winzip}}). the {{CHICKEN_REPOSITORY}} environment
    545 variable has to be set (in addition to {{CHICKEN_HOME}}) to a
     559variable has to be set to a
    546560directory where your compiled extensions should be located.
    547561
Note: See TracChangeset for help on using the changeset viewer.