Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
ECL(1)			    General Commands Manual			ECL(1)

NAME
       ecl - Embeddable	Common Lisp

SYNOPSIS
       ecl [-? | --help]
       [--dir dir] [--load file] [--shell file]	[--eval	expr]
       [--norc]	[--hp |	--nohp]
       [--debug	| --nodevbug]
       [--c-stack size]	[--lisp-stack size]
       [--heap-size size] [--frame-stack size]
       [[-o ofile] [-c [cfile]]	[-h [hfile]] [--data [datafile]]
	[-s] [-q] --compile file]
       [[-o ofile] --link file+]
       [--input-encoding external-format] [--output-encoding external-format]
       [--error-encoding external-format] [--encoding external-format]
       DEPRECATION  NOTE: one-dash versions of long flags(e.g. -eval or	-data)
       are deprecated; you  should  use	 two-dash  versions  (e.g.  --eval  or
       --data) now.

DESCRIPTION
       ECL  (Embeddable	Common-Lisp) is	an interpreter of the Common-Lisp lan-
       guage as	described in the  X3J13	 Ansi  specification,  featuring  CLOS
       (Common-Lisp  Object System), conditions, loops,	etc. plus a translator
       to C, which can produce standalone executables.

       ECL supports the	operating systems Linux, FreeBSD, NetBSD, OpenBSD,  OS
       X, Solaris and Windows, running on top of the Intel, Sparc, Alpha, Pow-
       erPC and	ARM processors.

       The current ECL implementation features:

       o      A	bytecode compiler and interpreter.

       o      Compiles Lisp also with any C/C++	compiler

       o      Can build	standalone executables and libraries

       o      ASDF, Sockets, Gray streams, MOP,	and other useful components

       o      Extremely	portable

       o      A	reasonable license

       ecl without any argument	starts the interactive lisp session.

OPTIONS
       -?, --help
		 Shows the help	prompt without running the ECL.

       --norc	 Do not	load configuration files at startup.

       --version Prints	the current version of ECL, without running the	ECL.

       -debug	 Turned	on by default, this enables the	debugging in the setup
		 phase,	so that	you can	debug your files.

       --nodebug Run  without  debugging setup phase, meaning that errors pre-
		 vent ECL from starting	up.

       --eval file
		 Evaluate the file before loading the .rc  file	 and  starting
		 the Top Level.

       --shell file
		 Executes  the given file and exits, without providing a read-
		 eval-print loop.  If you want to use lisp as a	scripting lan-
		 guage,	 you can write #!${exec_prefix}/bin/ecl	--shell	on the
		 first line of the file	to be executed,	and then ECL  will  be
		 automatically invoked.

       --load file
		 Load source file before loading the .rc file and starting the
		 Top Level.

       --dir directory
		 Use directory as a system directory.

       --heap-size size
		 Specify heap size in kilobytes.

       --lisp-stack size
		 Specify stack size in kilobytes for bytecodes interpreter.

       --frame-stack size
		 Specify frame stack size in  kilobytes	 for  runtime  control
		 structures.

       --c-stack size
		 Specify stack size in kilobytes for C compiler.

       --trap-fpe
		 Make ECL debugger catch floating point	exception.

       --no-trap-fpe
		 Make ECL debugger not catch floating point exception.

       --encoding encoding
		 Specify  the  external	 encoding  for standard	input, output,
		 trace and error.

       --input-encoding	encoding
		 Specify the external encoding for standard input.

       --output-encoding encoding
		 Specify the external encoding for standard output.

       --error-encoding	encoding
		 Specify the external encoding for standard error.

       -o file	 Provide the output target file	for compilation.

       -c cfile	 When compiling	name the intermediary C	file cfile and do  not
		 delete	it afterwards.

       -h cfile	 When  compiling name the intermediary C file cfile and	do not
		 delete	it afterwards.

       --data [datafile]
		 Dumps compiler	data into datafile or, if not supplied,	into a
		 file  named  after  the source	file, but with .data as	exten-
		 sion.

       --compile file
		 Translates file to C and invokes the local C compiler to pro-
		 duce a	native code program.

       -q	 Short for quiet - produce less	notes.

       --hp	 This option is	deprecated and doesn't do anything.

       --nodp	 This option is	deprecated and doesn't do anything.

       -s	 Produce  a  linkable  object  file.  It cannot	be loaded with
		 load, but it can be used to build libraries or	standalone ex-
		 ecutable programs.

       AUTHORS

	      The  original version was	developed by Giuseppe Attardi starting
	      from the Kyoto Common  Lisp  implementation  by  Taiichi	Yuasa,
	      Masami  Hagiya. Further development was lead by Juan Jose	Garcia
	      Ripoll.  The current maintainer of ECL is	Daniel KochmaAski, who
	      can be reached at	the ECL	mailing	list.

FILES
       ~/.ecl, ~/.eclrc
	      Default initialization files loaded at startup unless the	option
	      --norc is	provided.  (if they exist).

SEE ALSO
       ANSI

       The

BUGS
       Unfortunately it	is possible that there are some	bugs in	 the  program.
       In  case	 you  find any bug, please report it as	an issue (after	making
       sure that it hasn't been	reported or fixed) to official gitlab  reposi-
       tory: https://gitlab.com/embeddable-common-lisp/ecl/issues .

LICENSE
       ECL  is	free  software;	you can	redistribute it	and/or modify it under
       the terms of the	GNU Library General Public License as published	by the
       Free  Software Foundation; either version 2 of the License, or (at your
       option) any later version; see file 'Copying'.  This  program  is  dis-
       tributed	 in the	hope that it will be useful, but WITHOUT ANY WARRANTY;
       without even the	implied	warranty of MERCHANTABILITY or FITNESS	FOR  A
       PARTICULAR  PURPOSE.   See  the	GNU Library General Public License for
       more details.

       You should have received	a copy of the GNU Library General  Public  Li-
       cense along with	this program; if not, write to the Free	Software Foun-
       dation, Inc., 675 Mass Ave, Cambridge, MA 02139,	USA.

       Please report bugs, comments, suggestions to the	ecl mailing list: ecl-
       devel@common-lisp.net (or use gitlab).

4th Berkeley Distribution	  2016-09-17				ECL(1)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | FILES | SEE ALSO | BUGS | LICENSE

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=ecl&sektion=1&manpath=FreeBSD+12.2-RELEASE+and+Ports>

home | help