Steel Wheels Project Blog

This blog is moved

2012-01-17T21:06:00.002+09:00

The Steel Wheels Project Blog is moved to http://steel-wheels.hatenablog.com/. Because I could not customize the layout of this blog well. Goodbye blogger.

Tools: MSCGEN

2011-10-16T22:18:00.005+09:00

mscgen is a small program that parses Message Sequence Chart descriptions and produces PNG, SVG, EPS image.
It can be used with doxygen.

Reference: Graphics

2011-09-04T16:46:00.001+09:00

References for graphics

Web graphics with SVG 2011 (Japanese), Released by Kanagawa.it

Reference: Debugging

2011-09-02T23:44:00.003+09:00

Format for debugging: STAB and DWARF(Japanese)

Reference: Database

2011-08-22T19:11:00.002+09:00

Object database

Object database on wikipedia(Japanese)

Core Data for Mac

Core Data Programming Guide (Japanese)

Application: The concept/design of Kiwi Card

2011-08-22T09:57:00.001+09:00

Introduction

Kiwi Card manages the ideas.

Data structure

The data structure of KiwiCard data is called "KCCard". The primitive data structure to implement KCCard is called "KCPrimitive".


  struct KCPrimitive {NSUInteger key, struct KCValue * value} ;

The set of KCPrimitive is used to present "item". It is called KCItem.


  struct KCItem {CNInstanceList primitiveList} ;

KCCard has a list of KCPrimitive or KCItem.


  struct KCCard { CNInstanceList itemList ; }

The document for the Kiwi Card application is called "KCDocument". It has the list of KCCard.


  struct KCDocument { CNInstanceList cardList : }

OS X Tips

2011-07-30T21:00:00.000+09:00

To make visible the folder (such as ~/Library folder on OS X Lion), execute next command


chflags nohidden ~/Library

To hide the folder, execute the command


chflags hidden ~/Library

Game: The balance of the nature

2011-06-05T10:54:00.000+09:00

This is a simulation of the earth. You are the responsible person of the protection of the environment.

Xcode: Build settings

2011-05-05T07:30:00.002+09:00

This is common setting (but it is not equals to Xcode's default) for my projects.

Common build settings
Kind	Target	Value
Build options	Debug InformationFormat	DRARF with DSYM file
Deployment	Strip debug symbols during copy	No
Search paths	Framework search paths	$(HOME)/Library/Frameworks
Code Generation	Optimization level	-O2
Warnings	Other warning flags	-W -Wall
Warnings	Treat warning as errors	Yes

Xcode: .gitignore

2011-05-02T22:45:00.002+09:00

Source code is managed by git. This is an example of .gitignore file.


.DS_Store 

Document/html 

*.xcuserdatad

Xcode: Flex with Xcode

2011-04-30T22:20:00.000+09:00

The C compiler outputs warnings when it compile the source code which is generated by flex. To suppress them, %top section can be used for it.


%top { 

  /* Adjust the size type */ 

#define YY_TYPEDEF_YY_SIZE_T 

typedef NSUInteger yy_size_t  ; 

}

And sometimes, the flex generate the function which has unused parameter. To suppress the warning about it. Use


#pragma GCC diagnostic ignored "-Wunused-parameter"

Product: Unit test

2011-04-17T15:56:00.008+09:00

All frameworks contains unit tests. The unit test is a console application and it prints execution logs of tests. The expected value is prepared in source repository, so we can compare the output of the unit test and expected value for regression.

To execute the unit test, following information about the file location is required:

Unit test application
The log file to keep the output of the unit test application
The log file which records the expected outputs

But the "Test" scheme of Xcode 4.0.2 does not have the way to pass the above location information to the shell script for unit test. So the unit text execution is done in "build" phase instead of "run" phase.

Xcode: Location of build product

2011-04-17T08:06:00.003+09:00

You can define the location to build the application on Xcode. See setting of target "Build setting"

Deployment Location : set "YES"
Deployment Postprocessing : set "YES"
Installation directory : set path to install the tool

Reference: Multi Thread Programming on Mac OS X

2011-03-27T18:24:00.002+09:00

Graphics
- Enabling multi-threaded execution of the OpenGL framework

Reference: XML Technology

2011-02-12T17:51:00.002+09:00

Reference about XML technology

XSLT
- XSLTの極意 (Japanese)
Library
- libxml2 : Library for XML data representation. It is installed in Mac OS X. To study programming, see Libxml Tutorial.

Tools: Tool Manual

2011-01-23T23:30:00.001+09:00

Bison
- Bison 2.4.3 manual
VIM editor
- Introduction of VIM script (Japanese)
Tera Term
- Introduction of TeraTerm macro (Japanese)

Product: XML Parser on Coconut Framework

2011-01-23T21:28:00.004+09:00

The Coconut Framework supports XML parser based on yacc/bison. You can define the XML schema by the BNF on yacc.

CNXMLLex() function is combined with yyparse() function to parse XML document by BNF.

Format: EPUB

2011-01-09T18:47:00.002+09:00

References:

電子書籍ファイルePubについて -ePubを自分で作成する- (Japanese)

Hobby: Old Computers

2011-01-08T17:20:00.001+09:00

OLD-COMPUTERS.COM

Xcode: Bison with Xcode

2011-01-06T00:48:00.002+09:00

See Bison 2.3 manual at the GNU site. Japanese edition is Bison 1.28.

Setting of Xcode to use bison (yacc)
- Use file extension .ym to generate .m file from yacc source
- Change build option for yacc. Define YACC_GENERATED_FILE_STEM macro
How to reentrant programming
- A Pure (Reentrant) Parser
- Reentrant parser programming (in Blog) (Japanese)

Cocoa Programming: Reference & Sample code

2010-12-30T16:50:00.000+09:00

Image
- Makuri's Cocoa Tips : Using NSImage
Localization
- Getting the Current Language and Locale: There are an example o get the list of preferred languages from the defaults database using Cocoa.
CPU
- SIMD Primer : A complete routine showing how to use SIMD, particularly Intel's SSE and SSE2, to increase performance.

Product updated: Kiwi User Interface

2010-12-26T21:58:00.000+09:00

The Kiwi User Interface Framework is released. The Kiwi-User-Interface-Framework supports the implementation of graphical user interface for Mac OS X based on Cocoa framework. You can implement GUI based on multi threading software architecture.

The framework is released at 2010/11/27 and updated at 2010/12/26.

Cocoa Programming - GUI

2010-12-15T22:02:00.005+09:00

Guide
- Cocoa Drawing Guide
Image
- NSBitmapImageRep Class Reference
- NSImage Class Reference
Icon
- How to generalte ICON file for application (Japanese)

Useful Unix Commands

2010-11-27T21:55:00.001+09:00

MultiTail : MultiTail follows files in style, it is tail on steroids.

Reference: Game

2010-11-06T21:57:00.004+09:00

Framework for interactive fictions.

Undum : A client side framework for hypertext interactive fiction games

New product released: Kiwi Thread

2010-07-22T00:14:00.003+09:00

The product name is Kiwi Thread framework. It supports the implementation of Hierarchical Control/Data Flow Graph. The graph is used to execute the parallel multi threads. For more details, see the Kiwi Thread Framework web page.

New Products Released

2010-03-06T21:39:00.004+09:00

Following products are released from my project.

Kiwi Engine Framework : The framework for interpreter of procedural languate.
Kiwi Basic: Tiny basic interpreter based on the Kiwi Engine Framework.

Xcode: Install build

2009-12-30T23:31:00.002+09:00

To install framework on Xcode project, execute follwing command:

xcodebuild install -configuration Release DSTROOT=/ ARCHS="i386 x86_64" See Build for release and 64bit transition guide in Apple Developer Connection.

Reference: Programming Language

2009-09-11T22:52:00.004+09:00

BASIC

Apple II BASIC: Applesoft BASIC Quick Reference

LISP

Guile : The GNU extension language

Update release

2009-08-23T23:54:00.003+09:00

Coconut v0.5.0 and XSugar v0.5.0 are released. XSugar supports new command, xsg-indent command. It is used to adjust indent of XML document to improve readability.

References: Programming

2009-06-21T22:42:00.003+09:00

This is URL list to refer information for software development.

Objective-C
- Objective-C 2.0 Programming Language (Japanese) : Feature of Objective-C 2.0
- Introduction to The Objective-C Programming Language: Overview of Objective-C.
- MPWXmlKit: Objective-C framework to operate XML data
Programming Language
- Tiny Basic: TINY BASIC User Manual produced by Itty Bitty Computers.
WebKit
- Introduction to Web Kit Objective-C Programming Guide: Tutorial to use WebKit by Objective-C.
- Introducing SquirrelFish Extreme: Today they would like to announce the next generation of our JavaScript engine - SquirrelFish Extreme (or SFX for short). SquirrelFish Extreme uses more advanced techniques, including fast native code generation, to deliver even more JavaScript performance.
Xcode
- Xcode 2.4 Build Settings Notes: Pre-defined environment variables by Xcode. It is used to build software under Xcode environment.
- Getting Control with Subversion and Xcode: Installing Subversion fully on Mac OS X Server v10.4 requires installation of Apache 2.0 and other steps specific to Mac OS X. The installation process detailed here will help ensure that you as a Mac developer have easy access to this valuable tool.
- Using Doxygen to Create Xcode Documentation Sets : n Xcode 3.0, you can integrate doc sets for your own products into the Xcode Documentation window. By providing your documentation as a doc set, users can take advantage of all the Xcode documentation-viewing features to browse and search for information in your documents.
Mac OS X
- Mac OS X manual pages: HTML version of man pages
Compiler
- Learn about GCC4 (Japanese).
- SSA: A New Optimization Interface for GCC. PDF File
- The LLVM Compiler Infrastructure Project: LLVM is also a collection of source code that implements the language and compilation strategy
Web programming
- Index of XML standards: The index provides a detailed cross-reference of many XML standards, including links to additional coverage for each.
- Ajax and XML: Learning from Ajax's best: It focuses on programming for current major web servives such as Google Maps, TaDaList, Campfire, etc...
- Scripting JavaScript in Cocoa: How to execute JavaScript from Cocoa program.
Release
- Software Delivery Guide: How to package software products to distribute.
Parallel programing
- OpenCL from Khronos group.
Coding Style
- Google C++ Style Guide : Coding guideline for C++

Cocoa Programming - Memory Zone

2009-05-22T22:54:00.003+09:00

NSCreateZone is used to keep memory spaces. To release every contents in the zone, use malloc_destroy_zone in malloc.h. For more precise, see Cocoa Memory Management.

JavaScript programming environment for Mac OS X

2009-04-29T14:14:00.017+09:00

Implementations

Using JavaScript From Objective-C: Execute JavaScript program from Cocoa.
Cappuccino is an open source framework that makes it easy to build desktop-caliber applications that run in a web browser. It is written by Objective-J.
SproutCore
JSCore
TraceMonkey: JavaScript engine for FireFox 3.1 or later. It's VM is called Tamarin. Nanojit is is a small, cross-platform C++ library that emits machine code. Both the Tamarin JIT and the SpiderMonkey JIT (a.k.a. TraceMonkey) use Nanojit as their back end. Simple Nanogit Example describes how to use it. (SpiderMonkey is used before FireFox 3.0.).
V8 JavaScript Engine is written in C++ and is used in Google Chrome, the open source browser from Google.
SquirrelFish Extreme.
Carakan, Futhark: JavaScript Engine for Opera.

Test

sputniktests : ECMA Script 3 conformance test suite.

Papers/Presentations

The Structure and Performance of Eﬃcient Interpreters
Trace Monkey (Japanese) Presentation about JavaScript.

Infrastructure for language interpreter

2009-03-24T00:28:00.002+09:00

Parrot: Parrot is a virtual machine designed to efficiently compile and execute bytecode for dynamic languages.
SpiderMonkey: SpiderMonkey is the code-name for the Mozilla's C implementation of JavaScript.

Update release

2009-03-23T00:13:00.002+09:00

Cocoa Programming - Localization

2009-01-04T17:50:00.004+09:00

You can get array of supported language by following instructions.


 NSUserDefaults* defs = [NSUserDefaults standardUserDefaults];

 NSArray* languages = [defs objectForKey:@"AppleLanguages"];

On my mac os x system, the contents of array languages are:


ja, en, fr, de, es, it, pt, pt-PT, nl, sv, nb, da, fi, ru, pl, zh-Hans, zh-Hant, ko

Python

2009-01-03T20:56:00.001+09:00

The difference Python 2.X and 3.Y (Japanese)

Update release

2008-12-23T23:14:00.002+09:00

Following updates are released.

Coconut Framework: Version 0.2.0
XSugar Tools: Version 0.1.0

Variable number of arguments

2008-10-26T12:20:00.001+09:00

Links to the apple technical Q and A: "How can I write a method that takes a variable number of arguments, like NSString's +stringWithFormat ?".

Format: XML Data Representations

2008-07-25T21:43:00.002+09:00

This list contains major XML formats for their purposes.

Property list: This format can contain (nested) primitive data. So Coconut Framework support this as CNValue class.
XUL (XML User interface Language): Language to describe user interface. You can start from XUL Tutorial.
XBEL (The XML Bookmark Exchange Language): This data structure is used to present a bookmark information.
Motion XML Format: It defines information about XML elements of the Motion scene graph
Discovering XProc : An XML Pipeline Language

Other Products and Frameworks

2008-05-16T00:55:00.000+09:00

Here is a list of products and frameworks:

Framework
- SQLite : Application can operate DBMS by linking this library instead of communicating with SQL server. It is default installed on Mac OS X.
- Google Data APIs Objective-C Client Library can be used to access services provided by google. It is distributed under Apache License, Version 2.0.
- RegexKit Framework: RegexKit is an Objective-C framework for regular expressions
- DrawKit : Cocoa Vector Graphics Framework
Application
- Pathan : Pathan is a open source library which allows developers using Xerces-C to parse and evaluate XPath expressions for XML node selection. It also contains some command line utilities: XGrep. Pathan is developed by DecisionSoft Open Source.

Library: Build readline library to Mac OS X 10.5.2

2008-04-12T15:12:00.004+09:00

The readline library supports typing operation at the command line for console application. This page describes how to install it to Mac OS X 10.5.2. The version of the library is 5.2.

When I try to install the library by configure and make, following compile error occured: gcc version 4.0.1 (Apple Inc. build 5465) i686-apple-darwin9-gcc-4.0.1: -compatibility_version only allowed with -dynamiclib

The error is occured because -dynamic is used insted of -dynamiclib in shlib/Makefile. The original shlib/Makefile defines SHOBJ_LDFLAGS=-dynamic but it must be replaced by SHOBJ_LDFLAGS=-dynamiclib. After this modification, making the library is succeeded.

Tools: GPG

2008-04-09T22:57:00.009+09:00

The GNU Privacy Guard allows to encrypt and sign your data and communication. This document describes briefly usage of this command because this public/private key are used to commit sourceforge.

Download source code from GPG download page. configure and make install can be done without any modification on Leopard.
Generate private & public key by gpg --gen-key command. gpg --list-keys command prints the list of key on your home.
Generate ASCII code for public key, execute gpg -o public.asc -a --export USER-ID.

References

The GNU Privacy Handbook
How to use GnuPG (Japanese)

Reference: Cocoa programming guide

2008-03-12T13:43:00.002+09:00

CoreData
- Low-Level Core Data Tutorial
Thread
- Thread Programming
- Introduction to Distributed Objects: This programming topic describes the Cocoa classes that form the distributed objects system for interprocess/thread communications.
AppleScript
- Introduction to AppleScript Language Guide
JavaScript
- JavaScript Scripting Guide for QuickTime

Operate variable number of arguments in macro definition

2008-02-21T23:18:00.005+09:00

To operate variable number of arguments in macro, GCC support following declarations:


#define debug(format, ...) fprintf (stderr, format, ## __VA_ARGS__)

For more details, see Macros with a Variable Number of Arguments section in Using the GNU compiler collection.

Tools: doxygen, How to build doxygen on Mac OS X 10.5.1 (Leopard)

2008-02-11T23:54:00.001+09:00

Compilation of doxygen for Mac OS X 10.5.1 (Leopard) is failed with following message


c++ -Wl,-search_paths_first -Wl,-syslibroot,/Developer/SDKs/MacOSX10.4u.sdk -arch i386 -arch ppc -o ../bin/doxygen ../objects/main.o  -L../lib -ldoxygen -ldoxycfg -lqtools -lpng -lmd5 -liconv
ld: library not found for -ld: library not found for -lcrt1.10.5.o
collect2: ld returned 1 exit status
lcrt1.10.5.o
collect2: ld returned 1 exit status
lipo: can't open input file: /var/folders/BW/BWP+Ws1mG5GSpkgGxTlXx++++TI/-Tmp-//cc2wov6G.out (No such file or directory)
make[2]: *** [../bin/doxygen] Error 1
make[1]: *** [all] Error 2
make: *** [all] Error 2 M

It is occured because path setting in Makefile is not collect. Replace syslibroot,/Developer/SDKs/MacOSX10.4u.sdk by syslibroot,/Developer/SDKs/MacOSX10.4u.sdk/usr/lib in Makefile.doxygen and Makefile.doxytag in package of doxygen.

libxml2

2008-02-10T23:04:00.001+09:00

Here is memo for programming with libxml2.

Parser
- After parsing XML document, call xmlGetLastError to get some errors.
- Strings to determine encoding are defined in xmlParseCharEncoding function in encoding.c. They are "UTF-8", "UTF-16", "UCS-2", "UCS-4", "ISO-LATIN-1", "ISO-LATIN-2" etc...
Node operation
- xmlDocCopyNode: This function is used to copy nodes from an xml document to other xml document. You have to call this function to copy XML nodes into other XML document.

Libxml2 Tips

2008-02-09T16:59:00.001+09:00

Apple

2008-01-12T23:58:00.000+09:00

This page contains stories about Apple Inc, Macintosh or other technology.

'You've got to find what you love,' Jobs says

Format: XML Regular Expression

2007-10-22T23:45:00.002+09:00

Introduction

XML Regular Expression is used to point some XML nodes in XML document. It is used by XSugarTools and implemented on Coconut Framework.

Node expression

Usual regular expression (See regex on wiki) is used to present XML element node, attribute node and text node.

Prefix: Kind of node
e:: Element node
a:: Attribute name node
v:: Attribute value node
t:: Text node

Format: XPath and Regular expression for XSugarTools

2007-08-19T22:36:00.003+09:00

I'm learning about XPath for matching. The matching method will be used by XSugar Tools. XPath is used as regular expression for SoftwareTools. I want to know I can use original xpath with libxml or I have to design original regular expression and implement it.

Update release

2007-07-08T22:19:00.000+09:00

Coconut Framework : CNLibXMLEnumerator class is added. API documentations are added.

XSugarTools

2007-06-28T00:19:00.000+09:00

XSugarTools contains software tools for XML data processing. It is command line application for Mac OS X. Design concent of these tools is inspired from Software Tools (link to amazon) by Brian W. Kernighan and P. J. Plauger, So they have follwing features.

Each command has only one function. Everything is kept as simple as possible.
Each commands can be combined to solve more complex problem. The output of the command can be used as input for the other command.

Following commands are/will be contained in this package:

xsg-cat : Concatenate or merge XML files. It similar to cat command.
xsg-link : Check or modify the link information in XHTML file.

This software uses Coconut Framework by this project and Cocoa from Apple Inc.

Modified: 2007/04/27, 2007/05/12, 2007/05/17, 2007/06/28

Update release

2007-06-25T23:39:00.000+09:00

Following software are updated on Steel Wheels Project.

XSugarTools Command line tools for XML data operation.
Coconut Framework General purpose framework for Mac OS X.

Objective-C Programming Tips

2007-05-19T21:59:00.000+09:00

Objective-C supports special directives:

@synchronize, @throw, @try, @catch: There directives are used for mutal execlusion or exception. For more details, see Introduction to The Objective-C Programming Language, "The language", "Exception Handling and Thread Synchronization"

Sometimes, error will be occured in the initialize of object. In this case, use following template code:

 -(id)initWithError: (NSError **) error
 {
     if (self = [super init]) {
         err = /* try and error */
         if (err != nil) {
             *error = err ;
             [self release] ;
             return nil ;
         }
     }
     return self;
 }

Initial post: 2007/04/21, 2007/04/24, 2007/04/27, 2007/05/19

Command line parser for Cocoa Application

2007-05-08T21:36:00.000+09:00

There are some ways to parse command line options for console application built-on Cocoa Framework.

First, we can use NSUserDefaults. It is described in Command line processing in Cocoa. A Reader of the blog said NSArgumentDomain can be used for this. For NSArgumentDomain, See Introduction to User Defaults.

Second, We can use GetOpt (in Apple's page). It is installed on cocoa. Almost of UNIX applications uses this. We can use getopt or getopt_long. The library comes from NetBSD, not GNU. For more precise information for getopt, see Solaris's manual. Apple's manual page is too short and lacks information.

Modified: '07/04/22, '07/05/05, '07/05/08

Adventure Game

2007-05-06T17:25:00.000+09:00

The one last goal of Steel Wheels Project is develop the adventure game on the product. There are many systems to create interactive-finction game. Brass Lantern is major site to review adventure game for player and creator.

The site recommend Inform 7 as development environment. The colmun Introducing Inform 7 explain about it.

Coconut Framework

2007-05-05T23:50:00.000+09:00

Coconut Framework defines basic data structure and it's operation. Other products of Steel Wheels Project require this framework. This framework is written by Objective-C and developed under Xcode environment.

Coconut Framework has following functions:

XML data operation
Command line tool support
- Command line option parser based on getopt.

Modified: 07/04/23, 07/04/27, 07/05/05

Tools to generate API documentation

2007-04-21T10:10:00.000+09:00

I choosen doxygento generate API reference manual from source code (and embedded comments). It supports Objective-C language, so I can use it for my source code.

Here is documentation tools to generate API manual from source code.

HeaderDoc: a tool for generating HTML reference documentation from comments in headers, and source code written in C, C++, Objective-C , Java, JavaScript, Pascal, PHP, Perl, MIG, and shell scripts.
JavaDoc : a tool for generating API documentation in HTML format from doc comments in Java source code.

HeaderDoc is most suitable tool because it is installed on Mac OS X. But I feel it has some bugs and it has fewer functions against doxygen.

Hello, world !!

2007-04-18T16:50:00.000+09:00

This blog reports the progress of software development on Steel Wheels Project. The project focuses on free (= freedom) software for Mac OS X. All software and documentations are distributed under GNU public license or Lessor GNU public lisence.

And some tips and links for software development will be recorded on this site.

There are some frameworks and applications are under development:

Coconut Framework: Defines basic data model and it's operation. All classes in this framework is XML friendly.
Melon Framework: This framework contains some data model classes and XML coder for them.