MAN page from RedHat Other gwydion-dylan-2.3.3-2.i386.rpm

MELANGE

Section: Gwydion Dylan (1)
Updated: 17 May 2000
Index

NAME

melange - Translates C headers into Dylan

SYNOPSIS

d2c[-v] [--mindy|--d2c] [-Iincludedir]... infile [outfile]

WARNING

This man page is intended to supplement the main Gwydion Dylandocumentation athttp://www.gwydiondylan.org/.It provides an incomplete reference of the available options. For a fullreference or a tutorial, please see the web site.

DESCRIPTION

melangeparses C headers and emits equivalent Dylan interfaces. The current versioncan handle some fairly ugly headers, but not everything found on theaverage Unix system. Melange actually contains a full-fledged Cpreprocessor and a C parser. Unlike many similar tools, it's not just doingsimple pattern matching--it's actually trying to emulate the front end of aC compiler.

Eventually, we want Melange to handle any header which GCC can parse. Forthe time being, generating interfaces is more of an art, and any large setof headers is virtually gauranteed to find a new bug. Please report everybug you encounter togd-bugsAATTgwydiondylan.org,preferably with a short example. We're trying to locate and fix all theproblems, and should respond fairly quickly.

IMPORTING HEADERS

To import a header named foo.h, you'll probably want to add a new module toyour exports.dylan file. Call it foo-interface. Make sure your libraryuses melange-support, and that foo-interface uses the module of the samename:

library: my-applicationdefine library my-application  use dylan;  use melange-support;end library;define module my-application  use dylan;  use melange-support;  use foo-interface;end module;define module foo-interface  use dylan;  use melange-support;  export    /* All the things you want from foo.h. */;end module;

Next, create a file called foo-intr.intr which appears as follows:

module: foo-interfacedefine interface  #include "foo.h";end interface;

Typemelange -v foo-intr.intr foo-intr.dylanto process the header file. Then add foo-intr.dylan to your lid file andrecompile your program.

There are many other things which can be added to an interface definitionto control imports, rename symbols, express relationships between types anddefine preprocessor macros. These are described in detail by the Melangemanual (which is available through the website).

OPTIONS

--help: Print out a message describing the available options.
--version: Print out the version and copyright.
-v, --verbose: Print out the name of each C declaration as Melange processes it. Thisshould help find where Melange crashed, choked or got confused.
--d2c, --mindy: Only generate code for one environment or the other. The default is togenerate code for both.
-I, --include-dir dir: Searchdirfor C headers.

BUGS

Lots of them. Everywhere. We're fixing them as quickly as we can. (See thebug tracker on the website for an up-to-date list.)

In particular, it would be desirable for melange to search includedirectories in exactly the fashion as a given platform's C compiler.

AUTHORS

The Gwydion Group at CMU and the current Gwydion Dylan maintainers. See theCREDITS file in the Gwydion Dylan distribution for more information.

This document was created byman2html,using the manual pages.