Next: Manual

GNUstep Java Interface (JIGS) Manual

Written by: Nicola Pero (n.pero@mi.flashnet.it)

Date: February 2001, April 2001

COPYRIGHT © 2000, 2001 FREE SOFTWARE FOUNDATION, INC.

Permission is granted to make and distribute verbatim copies of this manual provided the copyright notice and this permission notice are preserved on all copies.

Permission is granted to copy and distribute modified versions of this manual under the conditions for verbatim copying, provided that the entire resulting derived work is distributed under the terms of a permission notice identical to this one. Permission is granted to copy and distribute translations of this manual into another language, under the above conditions for modified versions.

- Manual
- 1. What is JIGS
- 2. Quick Overview of JIGS
  - 2.1 Components of JIGS
  - 2.2 Which Components are Used for What
    - 2.2.1 Starting a Java VM inside an Objective-C program
    - 2.2.2 Using the GNUstep Base and Gui Libraries from Java
    - 2.2.3 Using Other GNUstep Libraries from Java
- 3. Programming GNUstep in Java
  - 3.1 Compiling Java Code Using GNUstep Make
    - 3.1.1 Compiling a Single Class
    - 3.1.2 Compiling Classes Belonging to a Package
    - 3.1.3 Installing Java classes where you like
    - 3.1.4 Creating Java Tools
    - 3.1.5 Documenting Classes Using Javadoc
  - 3.2 Accessing the GNUstep Base Library From Java
    - 3.2.1 A First Example
    - 3.2.2 The General Idea
  - 3.3 How the Wrapping Works
    - 3.3.1 Classes
    - 3.3.2 Methods
    - 3.3.3 Constructors
    - 3.3.4 Primitive Types
    - 3.3.5 Strings
    - 3.3.6 Numbers
      - 3.3.6.1 Details of Number Mapping
    - 3.3.7 Exceptions
    - 3.3.8 Base Library Structs
  - 3.4 Advanced Topics
    - 3.4.1 Weak References to Java Objects
    - 3.4.2 Selectors
    - 3.4.3 Subclassing GNUstep Objects in Java
    - 3.4.4 Using Java Threads
      - 3.4.4.1 The Fine Prints About Threads
- 4. Wrapping Objective-C Libraries
  - 4.0.1 Historical Notes
  - 4.1 Compiling ready-to-use wrappers
    - 4.1.1 Creating and compiling the wrappers
    - 4.1.2 Structure of the wrappers
      - 4.1.2.1 The Java subdirectory
      - 4.1.2.2 The Objc subdirectory
  - 4.2 The GNUmakefile for java wrappers
  - 4.3 Specifying the main library header
  - 4.4 Library header name
  - 4.5 Library header location
    - 4.5.1 Special header flags
  - 4.6 The wrapper directory
  - 4.7 The .jigs File
    - 4.7.1 Determining which .jigs file to read
    - 4.7.2 Overview of the .jigs file
    - 4.7.3 The Classes section
      - 4.7.3.1 java name
      - 4.7.3.2 objective-c name
      - 4.7.3.3 initializers
      - 4.7.3.4 class methods
      - 4.7.3.5 instance methods
      - 4.7.3.6 method declarations
      - 4.7.3.7 hardcoded constants
      - 4.7.3.8 enumerations
      - 4.7.3.9 file to include in java code
      - 4.7.3.10 file to include in preamble java code
      - 4.7.3.11 file to include in objective-c code
    - 4.7.4 Method Name Mapping
    - 4.7.5 Prerequisite Libraries
    - 4.7.6 Types
  - 4.8 Useful Make Options when Creating Wrappers
    - 4.8.1 Silencing the Wrapper Generator
    - 4.8.2 Enabling Debugging
    - 4.8.3 Debugging or Non-Debugging
      - 4.8.3.1 The Fine Prints About Debugging
    - 4.8.4 Turning off the Generation of Quick Reference Doc
  - 4.9 Including Special Code in the Wrapper GNUmakefiles
    - 4.9.1 Finding the library
  - 4.10 Controlling the Quick Reference Documentation
    - 4.10.1 Generating Documentation for Packages
    - 4.10.2 Installation Directory
  - 4.11 Generating RPMs for the wrapper library
- About this document ...