bionic (1) ellcc.xemacs21.1.gz

NAME

       ellcc - Program to compile an emacs dynamic module

SYNOPSIS

       ellcc  [--mode={compile,link,init,verbose}] [--mod-name=NAME] [--mod-title=TITLE] [--mod-version=VERSION]
       [Any compiler command line args]

DESCRIPTION

       This manual page documents briefly the ellcc, command.  This manual  page  was  written  for  the  Debian
       GNU/Linux distribution because the original program does not have a manual page.

       The following is taken directly from the comments in the source.

       Here's the scoop. We would really like this to be a shell script, but the various Windows platforms don't
       have reliable scripting that suits our needs. We don't want to rely on perl or some other  such  language
       so we have to roll our own executable to act as a front-end for the compiler.

       This program is used to invoke the compiler, the linker and to generate the module specific documentation
       and initialization code.  We assume we are in 'compile' mode unless we encounter an argument which  tells
       us  that  we're  not.   We take all arguments and pass them on directly to the compiler, except for a few
       which are specific to this program:

       The idea is that Makefiles will use ellcc as the compiler for making  dynamic  Emacs  modules,  and  life
       should be as simple as:

         make CC=ellcc LD='ellcc --mode=link'

       The  only  additional  requirement is an entry in the Makefile to produce the module initialization file,
       which will usually be something along the lines of:

OPTIONS

       --mode=VALUE
               This sets the program mode. VALUE can be one of compile, link, init or verbose.

       --mod-name=NAME
               Sets the module name to the string NAME.

       --mod-title=TITLE
               Sets the module title to the string TITLE.

       --mod-version=VERSION
               Sets the module version to the string VER.

EXAMPLE

           modinit.c: $(SRCS)
                        ellcc --mode=init --mod-name=
                          --mod-title=
                          -o $@ $(SRCS)
           See the samples for more details.

AUTHOR

       This manual page was written by James LewisMoss <dres@debian.org>, for the Debian GNU/Linux  system  (but
       may be used by others).

                                                                                                        ELLCC(1)