summaryrefslogtreecommitdiff
path: root/objective-cl.texinfo
diff options
context:
space:
mode:
Diffstat (limited to 'objective-cl.texinfo')
-rw-r--r--objective-cl.texinfo213
1 files changed, 213 insertions, 0 deletions
diff --git a/objective-cl.texinfo b/objective-cl.texinfo
new file mode 100644
index 0000000..70077e2
--- /dev/null
+++ b/objective-cl.texinfo
@@ -0,0 +1,213 @@
+\input texinfo @c -*- texinfo; coding: utf-8 -*-
+@c %**start of header
+@setfilename objective-cl.info
+@settitle Objective-CL
+@c %**end of header
+
+@c The time stamp is automatically maintained by Emacs.
+@c Time-stamp: <2007-09-12 01:24:21 mulk>
+@set VERSION 0.0.1
+@set UPDATED 11. September 2007
+
+@c vr
+@c fn
+@c cp
+@defindex mc
+@defindex cl
+@defindex sym
+
+@copying
+This is the official manual for Objective-CL
+(version @value{VERSION}, @value{UPDATED}),
+a portable Objective-C bridge for Common Lisp.
+
+Copyright @copyright{} 2007 Matthias Benkard.
+
+@quotation
+@end quotation
+@end copying
+
+@dircategory Lisp Programming
+@direntry
+* Objective-CL: (Objective-CL)A portable Objective-C bridge for Common Lisp.
+@end direntry
+
+@dircategory Common Lisp
+@direntry
+* Objective-CL: (Objective-CL)A portable Objective-C bridge for Common Lisp.
+@end direntry
+
+
+@titlepage
+@title Objective-CL User Manual
+@subtitle for version @value{VERSION}, @value{UPDATED}
+@author Matthias Andreas Benkard (@email{matthias@@benkard.de})
+@page
+@vskip 0pt plus 1filll
+@insertcopying
+@end titlepage
+
+@contents
+
+@ifnottex
+@node Top
+@top Objective-CL
+
+@insertcopying
+@end ifnottex
+
+@menu
+* Introduction:: A quick-start guide to Objective-CL.
+* Objective-CL Concepts:: Selectors, class instances, and method
+ invocations.
+* Interacting with Objective-C:: Invoking methods, creating instances, defining
+ classes, and converting data.
+* Reference Manual:: A reference of the Objective-CL API.
+* Concept Index:: A menu covering many concepts.
+* Symbol Index:: A list of symbols defined by Objective-CL.
+* Copying This Manual:: The GNU General Public License, Version 3.
+@end menu
+
+
+@node Introduction, Objective-CL Concepts,, Top
+@chapter Introduction
+@menu
+* Purpose:: Whom Objective-CL is for and why it exists.
+* A Simple Example:: Using Objective-CL to invoke methods.
+* History:: How the project came to be.
+@end menu
+
+
+@node Objective-CL Concepts, Interacting with Objective-C, Introduction, Top
+@chapter Objective-CL Concepts
+@menu
+@end menu
+
+
+@node Interacting with Objective-C, Reference Manual, Interacting with Objective-C, Top
+@chapter Interacting with Objective-C
+@menu
+* Initialisation and Shutdown:: Initialising the Objective-C runtime and
+ shutting it down cleanly.
+* Calling Objective-C:: Instantiating and retrieving classes and
+ objects, and ways of sending messages to
+ them.
+* Defining Classes:: Defining classes and making them accessible to
+ Objective-C code.
+* Data Conversion:: How conversion between Lisp and Objective-C data
+ types works.
+* Special Data Types:: Data types that are handled specially in order
+ to improve integration.
+@end menu
+
+@node Initialisation and Shutdown, Calling Objective-C,, Interacting with Objective-C
+@section Initialisation and Shutdown
+@menu
+* Initialising the runtime::
+* Shutting the runtime down::
+
+Details:
+
+* Function @code{initialise-runtime}::
+* Function @code{shutdown-runtime}::
+@end menu
+
+
+@node Calling Objective-C, Defining Classes, Initialisation and Shutdown, Interacting with Objective-C
+@section Calling Objective-C
+@menu
+* Using the @code{invoke} function:: The primitive, but safe way of doing things.
+* Objective-C-style invocations:: Invoking methods in a syntactically pleasant
+ way.
+
+Details:
+
+* Function @code{invoke}::
+* Function @code{invoke-by-name}::
+* Function @code{install-reader-syntax}::
+
+Convenience functions:
+
+* Function @code{objc-eql}::
+* Function @code{objc-equal}::
+@end menu
+
+@node Using the @code{invoke} function, Objective-C-style invocations,, Calling Objective-C
+@subsection Using the @code{invoke} macro
+
+@node Objective-C-style invocations, Function @code{invoke}, Using the @code{invoke} function, Calling Objective-C
+@subsection Objective-C-style invocations
+
+
+@ignore
+@include fun_invoke.texinfo
+@include fun_invoke-by-name.texinfo
+@include fun_objc-eql.texinfo
+@include fun_objc-equal.texinfo
+@end ignore
+
+
+@node Reference Manual
+@chapter Reference Manual
+@menu
+* Functions:: Details about some functions.
+@c * Macros:: Details about some macros.
+* Variables:: Details about some special variables.
+* Classes:: Details about some classes.
+
+* Function Index:: A list of all functions.
+@c * Macro Index:: A list of all macros.
+* Variable Index:: A list of all special variables.
+* Class Index:: A list of all classes.
+@end menu
+
+
+@ignore
+@include extracted-docs.texinfo
+
+@node Macro @code{invoke}
+@chapter Macro @code{invoke}
+
+@findex invoke
+@symindex invoke
+@cindex invoking methods via @code{invoke}
+@include m_invoke.texinfo
+@end ignore
+
+@node Copying This Manual
+@appendix Copying This Manual
+
+@menu
+* GNU General Public License:: The license for copying this manual.
+@end menu
+
+@c @include fdl.texi
+
+
+@node Function Index
+@unnumbered Index of Functions
+@printindex fn
+
+@ignore
+@node Macro Index
+@unnumbered Index of Macros
+@printindex mc
+@end ignore
+
+@node Variable Index
+@unnumbered Index of Special Variables
+@printindex vr
+
+@node Class Index
+@unnumbered Index of Classes
+@printindex cl
+
+@node Symbol Index
+@unnumbered Index of Symbols
+@printindex sym
+
+@node Concept Index
+@unnumbered Index of Concepts
+@printindex cp
+
+@bye