summaryrefslogtreecommitdiff
path: root/ipl/cfuncs/README
diff options
context:
space:
mode:
authorIgor Pashev <pashev.igor@gmail.com>2013-01-27 23:51:56 +0000
committerIgor Pashev <pashev.igor@gmail.com>2013-01-27 23:51:56 +0000
commit6ab0c0f5bf14ed9c15370407b9ee7e0b4b089ae1 (patch)
tree926065cf45450116098db664e3c61dced9e1f21a /ipl/cfuncs/README
downloadicon-6ab0c0f5bf14ed9c15370407b9ee7e0b4b089ae1.tar.gz
Initial upstream version 9.4.3upstream/9.4.3
Diffstat (limited to 'ipl/cfuncs/README')
-rw-r--r--ipl/cfuncs/README15
1 files changed, 15 insertions, 0 deletions
diff --git a/ipl/cfuncs/README b/ipl/cfuncs/README
new file mode 100644
index 0000000..d30a658
--- /dev/null
+++ b/ipl/cfuncs/README
@@ -0,0 +1,15 @@
+C Interface Functions for Icon
+
+This directory contains C functions that can be called from Icon on
+systems supporting dynamic loading via dlopen(3). These systems include
+SunOS, Solaris, OSF/1, Irix, and Linux.
+
+To see what's available, look at the comments in the .c files. To use
+a C function, just use "link cfunc" and call the function by name.
+
+The C functions are loaded at runtime from a library file "libcfunc.so",
+which is found automatically in the Icon binary directory. This can be
+be overridden by setting the FPATH environment variable to a search path.
+
+To build the library, run "make". This process also builds "cfunc.icn",
+the file of interface procedures that actually load the C functions.