Newer
Older
Francois-Rene Rideau
committed
ASDF-ENCODINGS
This library allows you to use ASDF with Lisp source files
that use an encoding different from either ASCII or UTF-8.
It depends on ASDF 2.21 or later (actually 2.20.7 or later).
Francois-Rene Rideau
committed
TODO:
(1) actually support more implementations.
Francois-Rene Rideau
committed
(2) Add a test suite.
Francois-Rene Rideau
committed
==== Exported Functionality ====
The asdf-encodings defines a package ASDF-ENCODINGS.
It uses ASDF 2.21's asdf:*encoding-external-format-hook*
to define a simple mapping from encodings specified as portable keywords
to implementation-defined external formats.
It issues warnings or errors when no matching external-format is available,
depending on asdf-encodings.
function ENCODING-EXTERNAL-FORMAT (ENCODING &KEY (ON-ERROR *ON-UNSUPPORTED-ENCODING*))
Francois-Rene Rideau
committed
This function takes a keyword which is one of
:default
:utf-8 :utf8
:latin1 :latin-1 :iso-8859-1
a whole lot of other possibilities as per asdf-encodings::*encodings*
Francois-Rene Rideau
committed
and returns a value suitable for use as :external-format argument to
the current implementation's CL:OPEN, CL:LOAD or CL:COMPILE-FILE functions.
If the encoding is not supported on this implementation, the ON-ERROR
argument, which is one of :ERROR, :WARN, NIL, specifies what to do.