www.delorie.com/gnu/docs/guile/guile_54.html

search

	Buy GNU books!

Guile Reference Manual

13.2.1 Writing Executable Modules

See template file PROGRAM for a quick start.

Programs must follow the executable module convention, documented here:

• The file name must not end in ".scm".

• The file must be executable (chmod +x).

• The module name must be "(scripts PROGRAM)". A procedure named PROGRAM w/ signature "(PROGRAM . args)" must be exported. Basically, use some variant of the form:

  (define-module (scripts PROGRAM) :export (PROGRAM))

  Feel free to export other definitions useful in the module context.

• There must be the alias:

  (define main PROGRAM)

  However, `main' must NOT be exported.

• The beginning of the file must use the following invocation sequence:

  #!/bin/sh main='(module-ref (resolve-module '\''(scripts PROGRAM)) '\'main')' exec ${GUILE-guile} -l $0 -c "(apply $main (cdr (command-line)))" "$@" !#

Following these conventions allows the program file to be used as module (scripts PROGRAM) in addition to as a standalone executable. Please also include a helpful Commentary section w/ some usage info.