# MCPP-PORTING

## == How to Port MCPP ==

#### for V.2.7.2 (2008/11)
松井 潔 (kmatsui@t3.rim.or.jp)

## == 目次 ==

####

1. 概要
  1.1. ＯＳや処理系を選ばない portable なソース
  1.2. 正確な Standard C モードに加えてその他の各種モードも
  1.3. このドキュメントの表記法
2. 履歴
3. 各処理系に移植する方法：概要
  3.1. 移植ずみの処理系: compiler-specific-build のコンパイル
    3.1.1. どの処理系でも必要な設定
    3.1.2. FreeBSD / GCC V.2.*, V.3.*, V.4.*
    3.1.3. Linux / GCC V.2.*, V.3.*, V.4.*
    3.1.4. Mac OS X / Apple-GCC V.4.*
    3.1.5. CygWIN / GCC V.2.*, V.3.*
    3.1.6. MinGW / GCC V.3.*
    3.1.7. LCC-WIN32 2003-08, 2006-03
    3.1.8. Visual C++ V.6.0, 2002, 2003, 2005, 2008
    3.1.9. Borland C V.5.*
  3.2. DECUS cpp で対応していた処理系
  3.3. noconfig.H, configed.H, system.H
  3.4. system.c
  3.5. ライブラリ関数
  3.6. 標準ヘッダ
  3.7. makefile と mcpp を使ったリコンパイル
  3.8. mcpp をコンパイルできる処理系
  3.9. コンパイルする処理系とターゲットの処理系
  3.10. MS-DOS 上の処理系、DJGPP 等
  3.11. Compiler-independent-build のコンパイル
  3.12. Subroutine-build のコンパイル
    3.12.1. configure する場合
    3.12.2. noconfig/*.mak を使う場合
    3.12.3. static library と shared library および DLL
4. 各処理系に移植する方法：詳細
  4.1. noconfig.H, configed.H, system.H の設定
    4.1.1. PART 1 ターゲットシステムの設定: compiler-specific-build
      4.1.1.1. 事前定義マクロ
      4.1.1.2. Include ディレクトリ等
      4.1.1.3. 行番号情報の出力形式その他
      4.1.1.4. 処理系の言語仕様に応じた設定
      4.1.1.5. Multi-byte character
      4.1.1.6. ターゲットとホストに共通の設定
    4.1.2. PART 2 ホストシステムの設定
    4.1.3. PART 3 mcpp の動作仕様の設定
      4.1.3.1. 新旧各種の動作モード
      4.1.3.2. 動作モードの細部の指定
      4.1.3.3. Translation limits の指定
  4.2. system.c
  4.extra. malloc()
5. バグ報告と移植の報告
  5.1. バグかどうか？
  5.2. malloc() 関連のバグチェック
  5.3. バグ報告を
  5.4. 移植の報告を
  5.5. GCC 以外の処理系での configure の情報を
  5.6. データを送ってくれれば移植してみます
  5.7. 検証セットによる他の処理系のテスト報告を
  5.8. 改善のご意見を
6. mcpp の長い道のり
  6.1. 構想３日、制作６年
  6.2. V.2.3 へ
  6.3. 「未踏ソフトウェア創造事業」に採択

# 1. 概要

mcpp は Martin Minow の DECUS cpp を元に kmatsui（松井 潔）が全面的に書き直したＣプリプロセッサです。mcpp という名前は Matsui cpp という意味です。これはソースで提供するもので、各処理系で使うには、その処理系に合わせてソースに若干の変更を加えた上でコンパイルして、mcpp の実行プログラムを作る必要があります。*1

このドキュメントはソースを各処理系に移植する方法を説明しています。できあがった実行プログラムの動作仕様については、mcpp-manual.html というマニュアルを参照してください。
これらのソース、ドキュメントはすべてオープンソース・ソフトウェアとして提供します。
mcpp は次のような特徴を持っています。

注:

*1 mcpp V.2.6.3 からはコンパイルずみの何種類かのバイナリ・パッケージも次のサイトで提供するようにした。しかし、このドキュメントではそれには触れない。バイナリ・パッケージについてはこの web page を参照のこと。

> http://mcpp.sourceforge.net/

## 1.1. ＯＳや処理系を選ばない portable なソース

Linux, FreeBSD, Windows 等の多くのＯＳをサポートしている portable なプリプロセッサであり、そのソースは Standard C (ANSI/ISO/JIS C) の処理系でさえあればコンパイルできる広い portability を持っています。ライブラリ関数は古典的なものしか使っていません。
各処理系に移植するためには、多くの場合、ヘッダファイル中のいくつかのマクロ定義を書き替えてコンパイルするだけですみます。最悪の場合でもソースファイルに数十行書き足す程度です。

Multi-byte character（漢字）の処理は日本の EUC-JP, shift-JIS, ISO2022-JP、中国の GB-2312、台湾の Big-5、韓国の KSC-5601 (KSX 1001) に対応しており、UTF-8 も使えます。Shift-JIS, ISO2022-JP, Big-5 の場合、コンパイラ本体が漢字を認識しない処理系では、mcpp がそれを補います。

## 1.2. 正確な Standard C モードに加えてその他の各種モードも

Standard C 準拠の動作モードのほかに、K&R 1st. のモードや "Reiser" model cpp のモードもあり、さらには自称 post-Standard 仕様のモードまであります。C++ のプリプロセッサとして動作する実行時オプションもあります。
Standard C モードは既存の多くのプリプロセッサと違って、規格を完全に実装しているつもりです。C90, C95, C99, C++98 のすべてに対応しています。Standard C プリプロセスの reference model となるものを目指して作ってあります。これらの規格のバージョンは実行時オプションで指定することができます。*1

ほかにいくつかの有用な拡張機能も持っています。マクロの展開機序や #if 式の評価機序をトレースする #pragma MCPP debug もあります。ヘッダファイルを "pre-preprocess" しておくこともできます。
いくつかの有用な実行時オプションも備えています。ウォーニングのレベルを指定するオプションや、include directory を指定するオプション等です。
ソースにどんな間違いがあっても mcpp は暴走したり見当外れなメッセージを出したりせず、正確でわかりやすい診断メッセージを出して適切な処理をします。移植上で問題となる点についても警告を発します。
高品質でありながら、コードサイズは比較的小さく、メモリ消費も比較的少なくてすみます。
詳細なドキュメントも付属しています。

mcpp の欠点を強いて挙げれば、速度がやや遅いことです。GCC 3.*, 4.* / cc1 に比べると２倍から３倍の時間がかかります。しかし、Borland C 5.5 / cpp と同じくらいの速度で、ヘッダファイルの pre-preprocess の機能を使うともう少し速くなるので、特に遅いほうではありません。正確であること、portable なソースであること、少ないメモリでも動作すること等のためには、この程度の処理時間はやむをえないと考えています。

なお、プリプロセッサの Standard C 準拠度をテストするための検証セットである "Validation Suite for Standard C Preprocessing"、その解説およびそれを使ってテストした各種プリプロセッサの採点簿 cpp-test.html を mcpp とともに公開しています。これを見ると、「Standard C 準拠」と称する既存のプリプロセッサにいかに多くの問題があるかがわかります。*2

注:

*1 Ｃ言語の規格としては ISO/IEC 9899:1990 (JIS X 3010-1993) が長く使われてきたが、1999 年には ISO/IEC 9899:1999 が採択された。ここでは前者を C90、後者を C99 と呼ぶ。前者は ANSI X3.159-1989 が移行したものなので、一般には ANSI C または C89 と呼ばれることもある。また、ISO/IEC 9899:1990 + Amendment 1995 を C95 と呼ぶことがある。C++ の規格は ISO/IEC 14882:1998 およびその正誤訂正版である ISO/IEC 14882:2003 で、この両者をここでは C++98 と呼ぶ。

*2 この cpp は V.2.2 までは単に cpp と呼んでいたが、一般の cpp と紛らわしいので、V.2.3 からは mcpp と呼ぶことにした。このドキュメントでは V.2.2 までのバージョンも mcpp と呼ぶ。また、このドキュメントの名前は V.2.2 までは cpp.doc としていたが、V.2.3 からは porting.txt と変更し、V.2.5 からは mcpp-porting.txt と変更し、さらに V.2.6.2 からは mcpp-porting.html と変更した。私自身の名前も、V.2.2 までは Psycho としていたが、V.2.3 からは kmatsui に変更した。

## 1.3. このドキュメントの表記法

このドキュメントはかつてはテキストファイルでしたが、V.2.6.2 からは html ファイルに変わりました。
このドキュメントでは次のようにフォントを使い分けています。

- `source`:
  `紺色`の等幅フォントは、 ソースコードの断片およびコマンドラインの入力を示すのに使われます。
- `__STDC__`:
  `くり色`の等幅フォントは、標準事前定義マクロおよび何らかのマクロを示すのに使われます。
- STD:
  Italic フォントは mcpp の `system.H` というソースファイルで定義されるマクロを表します。このドキュメントではこれらの名前を mcpp の種々の設定を表記するためにも使います。これらのマクロは mcpp をコンパイルする時に使われるだけで、mcpp の実行プログラムには存在していないことに注意してください。

# 2. 履歴

1. DECUS cpp は Martin Minow によって作られ、1984/05 に usenet / net.sources で公開されました。DECUS というのは、DEC Users' Society という DEC 社のコンピュータのユーザグループだそうです。DECUS cpp は DEC の PDP-11 / RT11, PDP-11 / RSX, VAX / VMS, VAX / ULTRIX 等のシステムの当時のＣ言語処理系のために書かれたＣプリプロセッサです。移植性の良い書き方がされているので、他のシステムに移植することは比較的容易で、オリジナル版でもすでに DEC 以外のいくつかの UNIX システムに対応していたようです。
2. 私が mcpp の出発点としたのは、C Users' Group の配付ディスク #243 でした。このソース中にある修正履歴を見ると、原作者による最終修正が 85/06 となっています。その後、原作者がバージョンアップをしているという話は聞きません。
3. その後 88/12 までに何人かによって MS-DOS 上のいくつかの処理系にも移植されました。CUG のディスクに入っているのはこのバージョンです。
4. ftp.oreilly.com/pub/examples/imake/DECUS-cpp.tar.gz にもソースがあり、その time-stamp は 93/02 となっていますが、実際の内容は CUG のものより古く、85/01 のものです。なお、これに含まれている Martin Minow の README によると、このプログラムは public domain となっています（この README 自体も 84 または 85 年のものと思われる）。
5. 89/04 に Gigo らによって OS-9/6x09 の Microware C に移植されたものが NIFTY-SERVE / FOS9 / lib 2 に登録されていました。
6. mcpp V.2 は、私がこれらを元に全面的に書き直したものです。移植性をさらに向上させ、Standard C に完全に対応させるため、ソースファイルの分割の仕方も変え、多くのマクロを追加し、関数と変数の追加・分割・書き換え・改名を大幅に行っています。ソースの量もオリジナル版の３倍になっています。ドキュメントと検証セットはすべて、私がまったく新しく書いたものです。
   私はこれらをオープンソース・ソフトウェアとして公開します。私自身は DECUS とは何の関係もありません。
   なお、オリジナル版には版数が付けられていませんが、mcpp と対比する時には、そちらを DECUS cpp と呼ぶことにします。
7. Standard C のマクロ展開の実装方法については、E. Ream 作の MS-DOS 上の PDS である CPP V.5.3 (1989/08, CUG #319) のソースも参考にしました。そのほか、GCC / cpp の動作や、J. Roskind の JRCPP のドキュメントからもいくつかの示唆を得ています。
8. mcpp V.2.0 は検証セット V.1.0 とともに 1998/08 に NIFTY SERVE / FC / LIB 2 で公開され、ベクター社のサイトにも転載されました。
9. mcpp V.2.1 は、V.2.0 に C99 1998/08 draft に対応するための修正を加えたものです。検証セット V.1.1 とともに 1998/09 に NIFTY SERVE / FC / LIB 2 およびベクター社のサイトに同時にアプロードされました。
10. mcpp V.2.2 は V.2.1 を 1998/07 に決まった C++ Standard (ISO/IEC 14882:1998) に対応して update したものです。検証セット V.1.2 とともに 1998/11 に NIFTY SERVE / FC / LIB 2 およびベクター社のサイトに同時にアプロードされました。
11. mcpp V.2.3 は V.2.2 を C99 に対応して update し、さらに Linux / GCC 2.95, GCC 3.2 等への移植を追加して、GCC / cpp との互換性を向上させたものです。また、実行時オプションを追加し、一部を変更しました。V.2.3 ではドキュメントの英語版も作成されました。mcpp に付属する検証セットには、GCC / testsuite の一部として自動的にテストを実行することのできる edition が追加されました。
12. mcpp は V.2.3 の開発の途中で、検証セット V.1.3 とともに、情報処理推進機構(IPA) の平成１４年度「未踏ソフトウェア創造事業」に新部 裕・プロジェクトマネージャによって採択され、2002/07 - 2003/02 の間は IPA の資金援助と新部ＰＭの助言のもとに開発が進められました。英語版ドキュメントもこのプロジェクトの中で、有限会社・ハイウェル（東京）に翻訳を委託し、それに私が修正とテキスト整形を加えてできあがったものです。このプロジェクトの中で cvs repository と ftp site が用意され、V.2.3 はそこで 2002/08 に pre-release 1 が、2002/12 に pre-release 2 が、2003/02 にリリース版が開発されました。その後、2003/03 に V.2.3 patch 1 が出されています。*1
13. mcpp はさらに平成１５年度にも「未踏ソフトウェア創造事業」に伊知地 宏 PM によって継続して採択され、2003/06 - 2004/02 の間は IPA の資金援助と伊知地ＰＭの助言のもとに V.2.4 への update 作業が進められました。そして、2003/11 には V.2.4 prerelease が開発されました。このバージョンでは Visual C++ 2003 への移植が追加され、また、mcpp の make を自動化する configure スクリプトが作成されました。なお、mcpp はそれまで明確なライセンス表示をしていませんでしたが、この時から BSD スタイルのライセンス表示をするようになりました。さらに、2004/02 にはリリース版が開発されました。このバージョンでは multi-byte character の処理が拡張されました。また、英語版ドキュメントもハイウェルに翻訳を委託し、日本語版に合わせて update されました。
    2004/03 には mcpp V.2.4.1 がリリースされました。これは再帰的マクロの展開方法を修正したものです。
14. 2005/03 には mcpp V.2.5 がリリースされました。このバージョンでは、POST_STANDARD というコンパイル時のモードは STANDARD モードにその実行時オプションの一つとして吸収され、OLD_PREPROCESSOR というコンパイル時の設定は PRE_STANDARD モードの実行時オプションとして吸収されました。再帰的マクロの展開方法は再修正されて完全なものとなりました。また、GCC V.3.3, 3.4 に対応した一方で、16 ビットシステムでの処理系に関するドキュメントの多くを削除しました。
15. 2006/07 には mcpp V.2.6 がリリースされました。このバージョンでは、STANDARD モードと PRE_STANDARD モードが１つの実行プログラムにまとめられました。compiler-independent-build の仕様は処理系に依存しないものに改められました。いくつかの処理系の新しいバージョンへの対応が追加された一方で、pre-C90 の仕様の処理系に移植するための設定は削除されました。MS-DOS 上のコンパイラへの移植も削除されました。ソースの書き換えは大幅なものになりました。今後はソースの追加や細部の修正はあっても、大幅な書き換えは発生しない見込みです。
    2006/08 には mcpp V.2.6.1 がリリースされました。このバージョンでは、MinGW への移植が追加されました。そのほか、バグ修正といくつかの比較的小さい改良がありました。
    2006/11 には mcpp V.2.6.2 がリリースされました。このバージョンでは、いくつかのバグが修正されるとともに、テキストファイルのドキュメントが html に変更されました。また、Juergen Mueller の contribution による subroutine-build が実装されました。
    2007/04 には mcpp V.2.6.3 がリリースされました。このバージョンでは、GCC-specific-build の GCC との互換性が強化されました。Subroutine-build では Greg Kress の contribution によってメモリ上のバッファへの出力が実装されました。また、このバージョンからいくつかのシステム用のバイナリ・パッケージが提供されるようになりました。
    2007/05 には mcpp V.2.6.4 がリリースされました。これは V.2.6.3 のバグフィックス版です。
16. 2008/03 には mcpp V.2.7 がリリースされました。 マクロに関する情報をコメントに書き込んで出力する「マクロ注釈モード」(macro notification mode) というものが実装され、コードがかなり増えました。このモードでは、プリプロセス後の出力から元のソース上のマクロの位置を知ることができます。このモードは C/C++ の refactoring tool のために実装されたものです。 また、Mac OS X / Apple-GCC への移植が追加されました。 Visual C++ 2008 への移植もされました。 GCC-specific-build はさらに GCC に近いものになりました。 前バージョンのいくつかのバグも修正されました。
    2008/05 には mcpp V.2.7.1 がリリースされました。 これは V.2.7 のバグフィックス版で、前バージョンのいくつかのバグが修正されました。 また、UNIX 系システムのバイナリ・パッケージはすべて shared library または DLL と、それをリンクした実行プログラムを提供するようになりました。
    2008/11 には mcpp V.2.7.2 がリリースされました。 これは前バージョンのバグフィックス版です。

注:

*1 「未踏ソフトウェア創造事業」(Exploratory Software Project) の概要は次のところで知ることができる。

> http://www.ipa.go.jp/jinzai/esp/

mcpp V.2.3 から V.2.5 までは次のところに置いてきたが、

> http://www.m17n.org/mcpp/

2006/04 に次のところに移った。

> http://mcpp.sourceforge.net/

cpp V.2.2 はベクター社のサイトの次のところにある。dos/prog/c というディレクトリに入れられているが、MS-DOS 専用ではない。ソースは UNIX, WIN32/MS-DOS 等に対応している。

> http://www.vector.co.jp/soft/dos/prog/se081188.html
> http://www.vector.co.jp/soft/dos/prog/se081189.html
> http://www.vector.co.jp/soft/dos/prog/se081186.html

これらのアーカイブファイル中のテキストファイルは、Vector のものは DOS/Windows 系に合わせて、改行コードは [CR]+[LF]、漢字は shift-JIS で encode してある。SourceForge のものは V.2.5 までは UNIX 系に合わせて改行コードは [LF]、漢字は EUC-JP である。V.2.6 からは [CR]+[LF] / shift-JIS の zip 版と [LF] / EUC-JP の tar.gz 版の２種類のアーカイブファイルを置くようにした。

# 3. 各処理系に移植する方法：概要

mcpp のソースは５本のヘッダファイルと７本の *.c ファイルからなっています。ＯＳや処理系に依存する部分は `configed.H, noconfig.H, system.H, system.c` の４本のソースにまとめてあります。`configed.H` と `noconfig.H` とは同時に使われることはなく、必ずどちらか一方が使われます。また、ライブラリ関数の一部のＣによるソースが `system.c` にあります。したがって、mcpp を何らかの処理系で使うには、それに合わせてこれらのソースファイルに変更を加える必要があります。

mcpp の実行プログラムは build する方法に応じて何種類かあります。 Build する方法には次の２つの次元があります。

1. stand-alone-build vs subroutine-build
2. compiler-independent-build vs compiler-specific-build

- stand-alone-build: １つのコマンドとして単体で動くプリプロセッサです。 処理系のコンパイラ・ドライバから呼び出されるものもあります。
- subroutine-build: 他のメインプログラムの中からサブルーチンとして （必要なら繰り返し）呼び出されるものです。 これについては 3.12 で述べます。

- compiler-independent-build: 処理系からは独立して動くプリプロセッサです。 実行時オプションなどの仕様は処理系のいかんによらず一定です。 プリプロセスだけすることができますが、処理系の一部として動作することはできません。*1
  これは多くの場合、コンパイルさえ通ればすむのでごく簡単です。これについては 3.11 で述べます。*2
- compiler-specific-build: 特定の処理系のプリプロセッサを（もし可能なら）代替するためのものです。 その処理系に専用の仕様を持ち、その処理系の専用のディレクトリにインストールされます。

以下の 3.1 - 3.9 ではこの stand-alone の compiler-specific-build を説明します。「GCC 版」「Visual C 用」等と表記しているのはすべて、それぞれ GCC-specific-build, Visual C-specific-build のことです。

mcpp をコンパイルするには２つの方法があります。１つは configure スクリプトを実行して、`config.h` というヘッダファイルと Makefile を自動生成する方法です。あとは単に make; make install とするだけですみます。`configed.H` というヘッダファイルはこの場合に使われます。しかし、configure は UNIX 系のシステムと CygWIN, MinGW でしか使えません。
もう１つは各処理系用の差分ファイルを使ってヘッダファイルに変更を加え、必要ならさらにヘッダファイルを編集した上で、その処理系専用の makefile を使って make する方法です。`noconfig.H` というヘッダファイルはこの場合に使われます。差分ファイルと makefile は noconfig というディレクトリにあります。Configure の使えるシステムでも、ヘッダファイルを直接、編集することで細かい制御をすることができます。しかし、差分ファイルはすでに移植ずみの処理系用のものしかありません。
この章では差分ファイルを使う方法について説明します。Configure については INSTALL を見てください。

注:

*1 これを V.2.6, V.2.6.1 では stand-alone-build と呼んでいた。 V.2.6.2 で subroutine-build ができたのに伴って、呼称を変更した。

*2 mcpp V.2.6.3 からは mcpp.sourceforge.net で何種類かのバイナリ・パッケージが提供されるようになったが、これはすべて stand-alone の compiler-independent-build である。

## 3.1. 移植ずみの処理系: compiler-specific-build のコンパイル

私自身が動かすことのできるＣ処理系は次のもので、このいずれにも mcpp を移植してあります。すなわち、このソースをコンパイルでき、生成されたプリプロセッサがそれぞれの処理系の上で正しく動作することを確認しています。いずれも CPU は x86 系を使っています。Ubuntu だけが 64 ビット版で、他は 32 ビット版です。

> FreeBSD 6.3 | GCC V.3.4.6
> Vine Linux 4.2 | GCC V.2.95.3, V.3.2, V.3.3.6, V.3.4.3, V.4.1.1
> Fedora Linux 9 | GCC V.4.3.0
> Debian LInux 4.0 | GCC V.4.1.2
> Ubuntu Linux 8.04 / x86_64 | GCC V.4.2.3
> Mac OS 10.5 | GCC V.4.0.1
> CygWIN 1.3.10 | GCC V.2.95.3
> CygWIN 1.5.18 | GCC V.3.4.4
> MinGW (MSYS 1.0.11) | GCC V.3.4.5
> WIN32 | Visual C++ 2003, 2005, 2008
> WIN32 | Borland C++ V.5.5J
> WIN32 | LCC-Win32 2003-08, 2006-03

また、他のユーザから提供された Visual C++ V.6.0, Visual C++ 2002, C++Builder 2007 (aka BCC V.5.9) の情報もあり、それらの処理系でコンパイルすることもできます。

これらの処理系で mcpp をコンパイルするための修正は簡単で、`noconfig.H` の数個のマクロ定義を変更するだけです。

noconfig ディレクトリの *.dif というファイルは FreeBSD 6.* / GCC 3.4 用の `noconfig.H` を各処理系用に修正する差分ファイルです。Visual C++ 2005 を例にとると、src ディレクトリで

    patch -c < ..\noconfig\vc2005.dif

とすると、修正されます。patch は UNIX の標準的なコマンドで、Windows 等にも移植されています。patch を使わなくても、差分ファイルを見てエディタで修正してもかまいません。

Include ディレクトリの指定などは、差分ファイルによる修正とは別に、ユーザが自分のシステムに合わせて修正しなければなりません。

こうして修正したソースをコンパイルするための各処理系用の makefile も添付してあります（3.7 参照）。

    copy ..\noconfig\visualc.mak Makefile

として src ディレクトリにコピーします。

以下の作業も src ディレクトリで行います。作業は特に断らない限り、`noconfig.H` の修正です。

### 3.1.1. どの処理系でも必要な設定

以下のどの処理系でも、compiler-specific-build を作るためには、

    #define COMPILER        INDEPENDENT

となっている行を

    #define COMPILER        MSC

等と、その処理系を表すマクロに変更します。そして、

    #define VERSION_MSG     "GCC 3.4"

という行を次のように適宜書き換えます。

    #define VERSION_MSG     "Visual C 2005"

COMPILER の定義は make のオプションで上書きすることもできます。 例えば、

    nmake COMPILER=MSC
    nmake COMPILER=MSC install

等とします。差分ファイルで `noconfig.H` を書き換えた場合は、compiler-specific-build のための設定もその処理系用に書き換えられるので、COMPILER は書き換える必要はありません。make で COMPILER を指定すると compiler-specific-build が生成され、指定しないと compiler-independent-build が生成されます。

また、デフォルトの include directory の設定が `noconfig.H` のものと異なる場合は、それを C_INCLUDE_DIR1, C_INCLUDE_DIR2 というマクロに書いておきます。C と異なる C++ 固有の include directory がある場合は、それを CPLUS_INCLUDE_DIR1, CPLUS_INCLUDE_DIR2, CPLUS_INCLUDE_DIR3 に書きます（これらのディレクトリは実行時に環境変数や -I オプションで指定することもできる）。`noconfig.H` で設定するのは処理系固有の include directory です。
Include directory はこのほか、`system.c` でも設定されています。UNIX で言えば `system.c` で設定されるのはいわゆる OS-specific なもの（通常は /usr/include）といわゆる site-specific なもの（通常は /usr/local/include）です。Windows では `system.c` では include directory は何も設定されません。Windows では `noconfig.H` でもデフォルトでは include directory は設定されないので、自分で書くか、または環境変数 INCLUDE, CPLUS_INCLUDE で指定する必要があります。

また、必要なら COMPILER_STD1, COMPILER_STD2 等で定義される組み込みマクロ名も変更します。

Multi-byte character の encoding はデフォルトでは、UNIX 系では EUC-JP、Windows では shift-JIS としていますが、必要なら MBCHAR というマクロを書き換えて他の encoding に変更します（Multi-byte character encoding は実行時に環境変数・オプション・#pragma で変更することもできる）。
処理系によっては shift-JIS や Big5 等の encoding に対応していないため、multi-byte character の中に '\\' と同じ 0x5c の値のバイトがあると tokenization でエラーになることがありますが、そういう処理系では mcpp は特殊な処理をしてコンパイラの欠陥を補います。この設定については 4.1.1.5 を見てください。

添付の makefile については、BINDIR という変数で処理系のバイナリの置かれているディレクトリを書きます。

GCC V.3, V.4 ではプリプロセスがコンパイラ (cc1, cc1plus) に吸収されてしまったので、GCC-specific-build の mcpp を使うには、gcc, g++ の呼び出しを shell-script に置き換えて、mcpp => cc1, mcpp => cc1plus の順序で実行されるようにしなければなりません。添付の makefile では、

    make COMPILER=GNUC
    make COMPILER=GNUC install

とすると、これが自動的に設定されます。詳細は mcpp-manual.html#3.9.7 を見てください。

ユーザが BINDIR 等への書き込み権限を持っていない場合は、UNIX 系では sudo make COMPILER=GNUC install とします。Windows ではあらかじめ administrator アカウントで、そのディレクトリの permission を変更しておきます。

### 3.1.2. FreeBSD / GCC V.2.*, V.3.*, V.4.*

ソースは FreeBSD 6.* 上の GCC (GNU C) V.3.4.* でコンパイルして compiler-independent-build の mcpp を生成する状態になっています。FreeBSD 6.* / GCC V.3.4.* 用の compiler-specific-build を作るには、

    #define COMPILER        INDEPENDENT

となっている行を

    #define COMPILER        GNUC

として、コンパイルすればできあがりです。 COMPLIER は make COMPILER=GNUC で上書きすることもできます。

GCC の他のバージョンであれば、VERSION_MSG というマクロおよび

    #define COMPILER_EXT_VAL    "3"
    #define COMPILER_EXT2_VAL   "4"
    #define COMPILER_CPLUS_VAL  "3"
    #define GCC_MAJOR_VERSION   3

となっているところのバージョン番号を変更します。 COMPILER_EXT_VAL は GCC の major version number を、COMPILER_EXT2_VAL は minor version number をいずれも文字列リテラルで書きます。COMPILER_CPLUS_VAL は `__GNUG__` マクロの値で、COMPILER_EXT_VAL と同じになります。 また、GCC_MAJOR_VERSION は COMPILER_EXT_VAL と同じ値を数値で書きます。

FreeBSD のバージョンが 6.* でなければ、

    #define SYSTEM_EXT_VAL      "6"     /* V.5.*: 5, V.6.*:6    */

の値を変更します。

さらに include directory が FreeBSD 6.* の標準と違っている場合は、

    #define CPLUS_INCLUDE_DIR1  "/usr/include/c++/3.4"
    #define CPLUS_INCLUDE_DIR2  "/usr/include/c++/3.4/backward"

となっているディレクトリを変更します。CPLUS_INCLUDE_DIR3, C_INCLUDE_DIR1 の設定も必要かもしれません。

GCC V.2.7-2.95 であれば次のマクロの定義を 199409L に変更します。

    #define STDC_VERSION        0L

他の UNIX 系 OS でもコンパイラが GCC であれば、このバージョン表示や、include ディレクトリの設定、ＯＳ固有の組み込みマクロの設定、等を変えるだけですむかもしれません（4.1.1 参照）。

### 3.1.3. Linux / GCC V.2.*, V.3.*, V.4.*

Linux / GCC ではまず、

    #define SYSTEM      SYS_FREEBSD

を

    #define SYSTEM      SYS_LINUX

に変更します。 そして、FreeBSD の場合と同じように、COMPILER, VERSION_MSG, COMPILER_EXT_VAL, COMPILER_EXT2_VAL, COMPILER_CPLUS_VAL, GCC_MAJOR_VERSION CPLUS_INCLUDE_DIR1, CPLUS_INCLUDE_DIR2, C_INCLUDE_DIR1 等のマクロの値を変更します。

GCC 2.* では STDC_VERSION の値を変更し、さらに、

    #define COMPILER_SP3_VAL    "int"

を

    #define COMPILER_SP3_VAL    "long int"

に変更します。

include directory は

    gcc -xc -E -v /dev/null
    g++ -xc++ -E -v /dev/null

として確かめてから設定してください。

noconfig ディレクトリの linux_gcc2953.dif, linux_gcc32.dif, linux_gcc336.dif, linux_gcc343.dif は FreeBSD 6.* / GCC V.3.4 用のソースを VineLinux 4.0 / GCC V.2.95.3, V.3.2, V.3.3.6, V.3.4.3 用に修正する差分ファイルです。 また、linux_gcc412.dif は Debian 4.0 / GCC V.4.1.2 用に修正するものです。 それぞれ compiler-specific-build ではさらに COMPILER を変更します。Distribution の標準の GCC と追加インストールした GCC とで include directory がかなり異なる点に注意してください。

なお、glibc の getopt() は POSIX 等の標準のものとは仕様が異なるので、使わずに、`system.c` の mcpp_getopt() を使ってください。

### 3.1.4. Mac OS X / Apple-GCC V.4.*

Mac OS X では Xcode というパッケージをインストールすると GCC もインストールされます。 /usr/bin に多くの gcc, cc, g++, c++ 等々が現れますが、Intel-Mac の Mac OS X 10.5 (Leopard) の場合は、i686-apple-darwin9-gcc-4.0.1, i686-apple-darwin9-g++-4.0.1 というのがそのマシン用の native code を生成するコンパイラです。 同時にクロスコンパイラもインストールされます。 Intel-Mac の場合は、powerpc-apple-darwin9-gcc-4.0.1, powerpc-apple-darwin9-g++-4.0.1 というのが powerpc 用のバイナリを生成するクロスコンパイラです。 単なる gcc (g++) は gcc-4.0 (g++-4.0) へのリンクで、これはデフォルトでは native compiler として動作しますが、-arch ppc というオプションを付けて起動すると powerpc 用のコンパイラ本体が呼び出されます。 また、/Developer/usr/bin にも /usr/bin と同じコンパイラ一式がインストールされます。

これらはいずれも Apple によって多くの拡張を施された Mac OS X 専用の GCC です。 他のシステムの GCC と異なるのは、１つは framework と呼ばれる独特なディレクトリを system header directory としていることです。 もう１つは Intel-Mac と PowerPC-Mac の双方のバイナリを片方の（１台の）マシン上で生成できるようになっていることです。 さらに双方のバイナリを１つにバンドルしてどちらのマシンでも動くようにした universal binary というものを生成するしくみもあります。 実は gcc-4.0, i686-apple-darwin9-gcc-4.0.1, powerpc-apple-darwin9-gcc-4.0.1 等や、そこから呼び出されるコンパイラ本体である /usr/libexec/gcc/SYSTEM/4.0.1 の cc1, cc1plus 等々もすべて i386 用と ppc 用との universal binary なのです（SYSTEM は i686-apple-darwin9 または powerpc-apple-darwin9）。 これらをそのまま x86 マシンから powerpc マシンに持っていけば、native と cross の関係が逆転した状態で動くようになっているものと思われます。 その上、Intel-Mac は ppc 用のバイナリを x86 のコードに変換しながら自動的に動かすようになっています。

こういうことで、/usr/bin と /Developer/usr/bin に多くの gcc, g++ があり、それらへのリンクがあり、x86 用と ppc 用の libexec ディレクトリがあり、１つの実行プログラムに２つのバイナリがバンドルされており、ppc 用のバイナリが x86 で動き、拡張機能があり、非常に紛らわしいので注意してください。 ここでは Intel-Mac 上の Mac OS X 10.5 (Leopard) を例にとりますが、ppc-Mac では i686 と powerpc (ppc) を入れ替えて読んでください。 また、Mac OS X 10.4 (Tiger) では darwin9 を darwin8 と読み替えてください。

#### 3.1.4.1. ネイティブコンパイラとクロスコンパイラ

ネイティブコンパイラ用の mcpp のインストールは簡単です。 noconfig.H に mac_gcc401_i686.dif の変更を加えると、Intel-Mac 上の Mac OS X 10.5 / GCC 4.0.1 用の設定になります。 Makefile としては mac_osx.mak を使います。 make; sudo make install とすると compiler-independent-build が、make COMPILER=GNUC; sudo make COMPILER=GNUC install とすると GCC-specific-build ができます。 /Developer/usr/bin には通常は PATH は通っていないので、コンパイラは /usr/bin のものが使われます。

Intel-Mac 上で powerpc 用のクロスコンパイラにインストールするには、まず noconfig.H に mac_gcc401_powerpc.dif の変更を加えます。 さらに Makefile を修正します。

compiler-independent-build では NAME, CC, CXX という変数の定義を、いずれも mac_osx.mak 中のコメントにあるように powerpc を含む文字列に変更します。 そして make; sudo make install とします。 これは「クロスコンパイラで」コンパイルされたもので、ppc-Mac 上で動くはずです。

GCC-specific-build では NAME, INCDIR, BINDIR, target_cc, arch を、やはり powerpc (ppc) を含む名前に変更します（CC, CXX は変更しない）。 そして、make COMPILER=GNUC; sudo make COMPILER=GNUC install とします。 これは Intel-Mac 上で動く「クロスコンパイラのための」ものなので、Intel-Mac 上で動きます。

ppcMac 上では、Intel-Mac とは逆に、mac_gcc401_powerpc.dif でネイティブコンパイラ用の設定になり、mac_gcc401_i686.dif でクロスコンパイラ用の設定になるはずです。 クロスコンパイラ用では、上記の Intel-Mac の Makefile の設定で変数に powerpc を含む名前を使ったところを、すべて i686 に変更します。

#### 3.1.4.2. Universal binary

Universal binary を作るには、mac_osx.mak の UFLAGS という変数定義をコメントアウトしている # を外して、これを有効にするだけです。 あとは前節の設定のままです。

### 3.1.5. CygWIN / GCC V.2.*, 3.*

CygWIN V.1.3.10 / GCC V.2.95.3 では `noconfig.H` に cyg1310.dif にあるような変更を加えます。
CygWIN V.1.5.18 / GCC V.3.4.4 では cyg1518.dif を使います。

さらに CYGWIN_ROOT_DIRECTORY というマクロを自分の環境に合わせて修正します。これは CygWIN の存在する Windows 上のディレクトリを次の形式で定義するものです。

    #define CYGWIN_ROOT_DIRECTORY   "c:/pub/compilers/cygwin"

path-list 中の大文字・小文字は関係ありません。

他の version でも、VERSION_MSG, CYGWIN_ROOT_DIRECTORY、および include directory のマクロを変更することで対応できるでしょう。

CygWIN は Windows 上のシステムですが、UNIX のファイルシステムがシミュレートされているので、mcpp では UNIX 系システムの GCC とほぼ同様に扱います。Include directories も UNIX 系と同様に組み込まれます。

### 3.1.6. MinGW / GCC V.3.*

MinGW / GCC V.3.4.5 では `noconfig.H` に mingw345.dif のような変更を加えます。
さらに MSYS_ROOT_DIRECTORY, MINGW_DIRECTORY という２つのマクロを自分の環境に合わせて修正します。これは次のように、それぞれ /, /mingw ディレクトリの Windows 上の位置に定義するものです。

    #define MSYS_ROOT_DIRECTORY "C:/Program Files/MSYS/1.0"
    #define MINGW_DIRECTORY     "C:/Program Files/MinGW"

path-list 中の大文字・小文字は関係ありません。

他の version でも、これらのマクロと VERSION_MSG、および include directory のマクロを変更することで対応できるでしょう。Include directory のマクロ定義は "C:/dir/mingw/include" という絶対パスでも、"/mingw/include" という MinGW 内のディレクトリでもかまいません。

MinGW では symbolic link がサポートされていないので、gcc から GCC-specific-build の mcpp を起動するのに symbolic link が使えません。その上、MinGW / gcc はたとえ cc1 という名前でも shell-script の起動は拒否します。そこで、mcpp のコンパイルでは cc1.exe という実行プログラムを生成して、この中から mcpp.exe または GCC の cc1.exe, cc1plus.exe を呼び出します。

MinGW の GCC-specific-build では include directories は mcpp が設定しますが、compiler-independent-build では設定されないので、環境変数 INCLUDE, CPLUS_INCLUDE で指定する必要があります。

### 3.1.7. LCC-WIN32 2003-08, 2006-03

LCC-WIN32 2003-08-*, 2006-03-* ではそれぞれ lcc0308.dif, lcc0603.dif のような変更を加えます。
他の version では VERSION_MSG マクロを変更します。

### 3.1.8. Visual C++ V.6.0, 2002, 2003, 2005, 2008

Visual C++ 2008, 2005, 2003, 2002, 6.0 ではそれぞれ vc2008.dif, vc2005.dif, vc2003.dif, vc2002.dif, vc6.dif のような変更を加えます。もちろん、compiler-specific-build では COMPILER マクロを書き換えるか、nmake -DCOMPILER=MSC オプションで上書きします。

Visual C の他のバージョンでは、VERSION_MSG マクロを変更するほか、`_MSC_VER` および `_MSC_FULL_VER` という組み込みマクロの値をそれぞれ COMPILER_EXT_VAL, COMPILER_EXT2_VAL というマクロの設定を変えることで対応させます。

### 3.1.9. Borland C++ V.5.*

Borland C V.5.5, V.5.9 (C++Builder 2007) / bcc32 ではそれぞれ bc55.dif, bc59.dif のような変更を加えます。

Borland C/C++ の別のバージョンでは VERSION_MSG のほか、`__TURBOC__`, `__BORLANDC__`, `__BCPLUSPLUS__` という組み込みマクロの値をそれぞれ `noconfig.H` の COMPILER_STD2_VAL, COMPILER_EXT_VAL, COMPILER_CPLUS_VAL というマクロの設定を変えることで、対応させます（4.1.1.1 参照）。Digraphs の実装されているバージョンであれば、HAVE_DIGRAPHS の設定を変更します。`__STDC_VERSION__` の実装されているバージョンであれば、STDC_VERSION の設定を変更します。

## 3.2. DECUS cpp で対応していた処理系

PDP-11 上の RT-11 / DECUS C, RSX / DECUS C、VAX 上の VMS / VAX-11 C、PDP-11 / UNIX, VAX / ULTRIX の何かのＣには DECUS cpp が対応していたようです。MS-DOS 上の Microsoft C, Lattice C のかなり古い版にも対応していたようです。これらはさすがにもう不要と思われ、また私自身がメンテナンスできないので、削除しました。

## 3.3. noconfig.H, configed.H, system.H

`system.H` は HAVE_CONFIG_H というマクロが non-0 に定義されていると `configed.H` を include し、そうでなければ `noconfig.H` を include します。`configed.H, noconfig.H` には mcpp の設定の PART 1 と PART 2 という部分があり、`system.H` には PART 3 があります。

これらのファイルには、各処理系に移植する時に必要ないくつかのマクロが定義されています。まだ移植されていない処理系に移植するには、PART 1 に数行ないし十数行を書き足します。
PART 1 はＯＳと target 処理系に依存する定義で、PART 2 は host 処理系に依存する定義、そして PART 3 は mcpp の動作仕様の定義です。
`configed.H, noconfig.H` ではターゲット処理系とホスト処理系とが同じであると仮定していますが、異なる場合は PART 2 を編集する必要があります。

デフォルトの設定と違う設定で移植する場合は、これらのファイルの全体に必ず目を通してください。

## 3.4. system.c

`configed.H (noconfig.H), system.H` のマクロだけでは吸収できないＯＳや処理系の差異は、`system.c` で吸収しています。未実装の処理系に移植するには、ここに数十行のソースを書き足すことが必要になるでしょう。

このファイルに記述されているのは、mcpp 起動時のオプション、usage 文、include ディレクトリ、ヘッダファイルやソースファイルをオープンする時のＯＳ固有のディレクトリパスの扱い、#pragma の処理、処理系固有の拡張ディレクティブの処理、等です。ほとんどは target OS と target 処理系の設定です。

## 3.5. ライブラリ関数

ライブラリ関数のうち、Standard C にない getopt(), stpcpy() のＣによるソースも system.c に書いてあります。mcpp は getcwd(), stat() も使い、UNIX 系では readlink() も使いますが、この３つは OS に依存する関数であり portable に書くことができないので、ここには含めていません。この３つは Standard C にはありませんが、POSIX では規定されています。mcpp の使う低水準関数はこの３つだけです。これらを持たない処理系はないでしょう。 このほか、MSC では stricmp() を、Mac OS X, CygWIN, MinGW では strcasecmp() も使います。*1, *2
ライブラリ関数はいずれも、処理系によって微妙に違う恐れのある仕様に依存した使い方はしていないので、どの処理系のものでもバグさえなければ大丈夫です。

注:

*1 MinGW 版に限って spawnv() も使われる。

*2 mcpp V.2.6.4 までは lib.c というソースファイルを独立させていたが、その内容が getopt(), stpcpy() の２つだけになったので、V.2.7 から system.c に吸収した。 そして、getopt() は mcpp_getopt() と名前を変えて、リンクのトラブルを解消した。

## 3.6. 標準ヘッダ

mcpp のソースでは `stdio.h, ctype.h, errno.h, stdlib.h, string.h, stddef.h, limits.h, time.h, sys/types.h, sys/stat.h` を無条件で include しています。UNIX 系のシステムでは `unistd.h` も include します。これらを持たない処理系はまずないでしょう。

## 3.7. makefile と mcpp を使ったリコンパイル

noconfig ディレクトリにある *.mak は個別の処理系用の makefile です。詳細な設定ができます。make そのものは各処理系に付属のもの、またはそのシステムの標準的なものを想定しています。Visual C では make ではなく nmake を使います。

まず、処理系を xyz とすると、FreeBSD / GCC 以外では

    patch -c < ../noconfig/xyz.dif

として `noconfig.H` を修正します。次に、`noconfig.H` の COMPILER と VERSION_MSG というマクロを書き換えます。さらに自分のシステムに合わせて `noconfig.H` の C_INCLUDE_DIR? 等のマクロを修正します。そして、使用する noconfig/xyz.mak を Makefile にコピーし、ディレクトリ指定等を自分のシステムに合わせて修正した上で、

    make
    make install
    make clean

としてください。

他の処理系では、これらを参考に必要な makefile を書いてください。ソースの依存関係は単純で、

1. `main.c, directive.c, eval.c, expand.c, support.c, system.c, mbchar.c` は `system.H, internal.H` に依存する
2. `system.H` は `configed.H (noconfig.H)` に依存する

という関係になっています。 `system.H` は `internal.H` より先に include する必要があります。 `internal.H` はさらに `mcpp_lib.h` を include します。

mcpp 自身を使って mcpp をリコンパイルするには、処理系のプリプロセッサのある場所にこの実行プログラムをおきます。例えば GCC V.2.95 であれば、処理系付属の cpp0 を cpp0_gnuc とでも rename しておき、その時に使うものを cpp0 にリンクするのが良いでしょう。すなわち、使うプリプロセッサを mcpp とすると、

    ln -sf mcpp cpp0

とします。Windows では使うものを cpp32.exe 等にコピーします。*1

mcpp 実行プログラムの名前は

    make NAME=mcpp

等として指定することができます（同じことを BC make では make -DNAME=mcpp とする。UCB make では -D は付けても付けなくても良い。GNU make では -D は付けてはいけない）。

添付の makefile では GCC 用（freebsd.mak, linux.mak, mac_osx.mak, cygwin.mak, mingw.mak）以外は make install ではこまかい処理はしないので、手で補ってください。処理系付属のプリプロセッサは、make install で消してしまうことのないように、あらかじめ別名のファイルにコピーしておいてください。

Visual C, Borland C のような１パスコンパイラで mcpp を使ってリコンパイルする場合は、mcpp の出力ファイルをコンパイラに与えるソースファイルとします（例えば `main.c` というソースをプリプロセスしたものを `main.i` といった名前で出力して、それを cl や bcc32 にコンパイルさせる）。

mcpp を使ってリコンパイルする時は、ヘッダファイルの "pre-preprocess" の機能を使うと、プリプロセス時間が大幅に短縮されます。添付の makefile を使う場合は、UCB make, GNU make, MS nmake では、

    make PREPROCESSED=1

BC make では

    make -DPREPROCESSED=1

とすると、自動的にヘッダファイルを pre-preprocess した上でプリプロセスし、それからコンパイルします。LCC-Win32 の make では if 文による場合分けができないので、makefile を修正してリコンパイルする必要があります。修正の内容は makefile そのものにコメントとして書いてあります。

UCB make, GNU make, MS nmake では、MALLOC=KMMALLOC というオプションを付けて make すると、私が書いた malloc() をリンクします。これについては 4.extra を見てください。BC make では同じことを -DKMMALLOC というオプションで指定します。LCC-Win32 make で私の malloc() をリンクするためには、makefile を修正する必要があります。

注:

*1 FreeBSD では cpp0, cc1 を置く標準のディレクトリは /usr/libexec である。Linux では /usr/lib/gcc-lib/i686-redhat-linux/3.3.2 といったひどく奥深いディレクトリになっている。Linux / GCC では distribution やその version に応じて makefile のこのディレクトリの指定を書き換える必要がある。Include directory もいろいろあるので、確かめなければならない。

また、Linux や FreeBSD では /usr/bin/cpp というものがあるが、これは実際には cpp0 または cc1 を呼び出す。gcc も cpp0 または cc1 を呼び出す。
なお、mcpp-manual.html#3.9.5, mcpp-manual.html#3.9.7 も参照のこと。GCC 3.*, 4.* ではプリプロセスがコンパイラ (cc1, cc1plus) に吸収されてしまったので、mcpp を使うには gcc, g++ の呼び出しを shell-script に置き換える必要がある。

## 3.8. mcpp をコンパイルできる処理系

各処理系に移植するためにはいくつかの設定が必要ですが、mcpp のソースをコンパイルすること自体は、C90 (ANSI C) の仕様を満たしている処理系であれば十分できます。プリプロセッサも同様です。*1, *2

char 型は符号付きでも符号なしでもかまいません。
浮動小数点演算は不要です。

このソースは処理系の微妙な差に影響されないように書いてあります。 もっとも、実際に各処理系でコンパイルするためには、さらにその処理系のバグも回避する必要があります。これはやってみないと何が出てくるかわかりません。私が移植したいくつかの処理系でも、バグであることを確かめその回避方法を見つけるまでにかなりの時間がかかってしまったことが何回かあります。

mcpp が対応していないのは、pre-C90 の処理系のほか、特殊な文字セットを持つ処理系と特殊な CPU です。
EBCDIC には対応していません。
また、整数演算が２の補数でない CPU にも、対応していません。２の補数でない場合は、#if 式でオーバーフローが発生した時に、おかしくなるかもしれません。

注:

*1 mcpp V.2.5 までは K&R 1st. の処理系でもコンパイルできるようにしていたが、すでにその必要はなくなっていると思われるので、V.2.6 からは C90 を前提とするように改めた。それに伴ってソースを整理し、このドキュメントも整理した。

*2 V.2.6.2 までは C++ でもコンパイルできるようにしていたが、V.2.6.3 からは C だけとした。

## 3.9. コンパイルする処理系とターゲットの処理系

mcpp のソースをコンパイルする処理系（ホスト）と、それによって生成された mcpp の実行プログラムを使う処理系（ターゲット）とは、必ずしも同じである必要はありません。これが違っている場合は、`noconfig.H (configed.H)` の SYSTEM, COMPILER でターゲットを指定し、HOST_SYSTEM, HOST_COMPILER はホストを指定します。また、PART 1 にある諸定義はターゲット用のもので、PART 2 にあるものはホスト用の設定です。`system.c` は主としてターゲット用のものです。

ホストとターゲットの関係には、次のような制限があります。

1. ホスト処理系はターゲット処理系と同じＯＳ上のものであるか、またはクロスコンパイラであることが必要です。 ホスト処理系とターゲット処理系の文字セットとはともに ASCII であることが必要です。
2. ホスト処理系の long (unsigned long) はターゲット処理系のそれより範囲が狭くてはいけません。これは Standard C で規定されている条件でもあります。C99 では long long (unsigned long long) について同じことが言えます。

なお、ここで言うホストとターゲットというのは、クロスコンパイラのそれとは関係ありません。クロスコンパイルするのはコンパイラ本体の仕事で、プリプロセッサは原則としてそれには関知しません。mcpp を「クロスコンパイラに」移植する場合は、そのクロスコンパイラがここで言うターゲット処理系です。ホスト処理系としてはクロスコンパイラでないものを使うことになるはずです。mcpp を「クロスコンパイラで」コンパイルする場合は、そのクロスコンパイラがホスト処理系で、クロスコンパイラのターゲットがターゲット処理系となります。

## 3.10. MS-DOS 上の処理系、DJGPP 等

mcpp の過去のバージョンでサポートしていたもののその後、サポートをやめた処理系について述べておきます。

mcpp V.2.2 までは次の処理系をサポートしていましたが、V.2.4 で削除しました。

> MS-DOS | Turbo C V.2.0
> OS-9/6x09 | Microware C

V.2.5 では次の処理系に関するドキュメントを削除しました。

> DJGPP V.1.12 | GCC V.2.7.1
> MS-DOS | LSI C-86 V.3.3 試食版

V.2.6 では上の２つの処理系の設定をソースからも削除し、さらに次の処理系に関するドキュメントとソースを削除しました。

> MS-DOS | Borland C 4.0
> Plan 9 | pcc

V.2.6 ではまた、MS-DOS 上の処理系やメモリの小さいシステムのための設定をすべて削除し、pre-C90 の処理系のための設定も削除しました。

V.2.7.2 では次の処理系のサポートも削除しました。

> Win32 | Borland C 4.0

いずれも古い処理系で、ユーザは少なくなっていると思われるものです。
もしそれらの処理系でコンパイルする場合は、compiler-specific-build では多くの設定が必要で簡単ではありませんが、compiler-independent-build なら、その処理系が C90 の仕様をほぼ実装していれば、次のようにして簡単にできます。

DJGPP については、noconfig.H で SYSTEM, HOST_SYSTEM を SYS_WIN32 とし、HAVE_INTMAX_T, HAVE_INTTYPES_H を FALSE とし、system.H で NBUFF をデフォルトの 1/4 くらいに押さえます。*1

MS-DOS 上の処理系については、noconfig.H で SYSTEM, HOST_SYSTEM を SYS_WIN32 とし、HAVE_LONG_LONG を FALSE とし、system.H で NBUFF をデフォルトの 1/16 くらいに、IDMAX をデフォルトの 1/4 くらいに押さえます。さらに directive.c で SBSIZE をデフォルトの 1/8 くらいにします。そして、large memory model でコンパイルします。
ただし、MS-DOS ではメモリの制約が厳しいので、この設定でコンパイルしておいても、長大なマクロ定義の多い場合などは out of memory となることがあります。

注:

*1 DJGPP / GCC 4.1.0 ではこの設定で mcpp V.2.6.1 をコンパイルできたという報告がある。

## 3.11. Compiler-independent-build のコンパイル

mcpp を処理系からは独立して単体で動く compiler-independent 版としてコンパイルすることもできます。これは多くの場合はコンパイルさえ通ればすむので簡単です。Compiler-independent 版は実行時オプションなどの仕様は一定で、処理系依存の部分はありません。OS による相違が少しあるだけです。include directory も UNIX 系で /usr/include, /usr/local/include が設定されるだけなので、あとは環境変数や -I オプションで指定する必要があります。*1, *2

configure が使えるシステムで GCC でコンパイルする場合は単に mcpp のルートディレクトリで

    ./configure; make; make install

とすればすみます。この場合は `noconfig.H` ではなく `configed.H` というヘッダファイルが使われます。configure の詳細については INSTALL-jp を参照してください。

configure の使えないシステムでも mcpp がすでに移植されている処理系では、noconfig ディレクトリにある所定の差分ファイルを使って `noconfig.H` を書き換えればすみます。それ以外の変更は必要ありません。makefile も noconfig ディレクトリにあるものをコピーして使います。インストールするディレクトリは makefile 中の BINDIR という変数に書きます。そして、src ディレクトリで make し、make install します。
mcpp がすでに移植されている処理系とバージョンが少し違うだけの場合は、まず近いバージョンの差分ファイルを適用して、それを編集します。

mcpp がまだ移植されていない処理系では、`noconfig.H` を編集して数個のマクロを書き換えたり書き加えたりしてください。まず、HOST_COMPILER を適宜定義します。そして、COMPILER を INDEPENDENT に定義し、SYSTEM をその OS に定義し、VERSION_MSG を適宜定義します。ターゲット処理系は存在しないので、PART 1 には設定することはありません。

PART 2 は mcpp をコンパイルするホスト処理系が Standard C の仕様をどれだけ実装しているか、必要な関数を持っているかによって、設定が違ってきます。最も違うのは long long という型の実装です。Visual C 2002, 2003, 2005 や Borland C 5.5 等では `__int64` という型になっていて、その値を printf() で表示する指定子が VC 2005 以外では j や ll ではなく I64 なので、LL_FORM というマクロを "I64" に定義します。MinGW では long long がありますが、printf() の指定子は I64 です。 Visual C 2008 では long long という型名も使えるようになりました。

stpcpy() という関数のない処理系では、HOST_HAVE_STPCPY を FALSE に定義します。

makefile は noconfig ディレクトリにあるものを参考にして書いてください（3.7 も参照のこと）。

Mac OS X には x86 と powerpc の双方のバイナリを片方のマシンで作れるように、ネイティブコンパイラとクロスコンパイラとが用意されています。 また、それを使って universal binary というものも作れるようになっています。 これは x86 と powerpc 用のバイナリを１本のファイルに束ねたものです。 これらの仕組みは少し複雑なので、3.1.4 に compiler-specific-build と compiler-independent-build の双方についてまとめて説明してあります。

なお、mcpp V.2.6.3 からは sourceforge のサイトで compiler-independent-build の何種類かのバイナリ・パッケージが提供されるようになりましたが、これはそれぞれのパッケージング方式に固有の方法でパッケージングされたものです。そのパッケージング仕様はそれぞれに対応するソース・パッケージ中にある設定ファイルに書かれています。FreeBSD, Linux, Mac OS X 用のものはすべてコンパイルには configure スクリプトを使っています。

注:

*1 mcpp V.2.4, V.2.5 では compiler-independent 版の仕様は中途半端で、 処理系の仕様に対応した一般のコマンドとしてのプリプロセッサであった。V.2.6 からは処理系から独立した一定の仕様とした。

*2 コンパイルさえ通ればすむと言っても、MS-DOS 上の処理系ではメモリの制約が厳しいので、コンパイルはできても実行すると out of memory になることがある。MS-DOS では translation limits の設定を大幅に押さえてコンパイルしなければならない。3.10 を参照。

## 3.12. Subroutine-build のコンパイル

mcpp を他の何らかのメインプログラムからサブルーチンとして呼び出すようにコンパイルすることもできます。これは独立したプリプロセッサと同じように、呼び出し元から実行時オプションを受取り、指定された入力ファイルをプリプロセスして出力ファイルに出力して、呼び出し元に戻るものです。必要なら複数のファイルについて繰り返し呼び出すこともできます。しかし、呼び出し元とトークン単位のやりとりをするものではありません。

サブルーチン版では、出力先としてファイルではなくメモリ上のバッファを使うこともできます。

mcpp のソースは、MCPP_LIB というマクロを non-0 に定義してコンパイルすると、サブルーチン版としてコンパイルされるようになっています。サブルーチンの入り口は stand-alone 版の main() が次のように mcpp_lib_main() という名前に変わるだけです。

        int mcpp_lib_main( int argc, char ** argv);

GCC では COMPILER マクロは GNUC ではなく INDEPENDENT のままでコンパイルします。GNUC とすると、GCC の libexec ディレクトリにインストールされて GCC から呼び出されるものができてしまうからです。
他方で、Visual C, Borland C, LCC-Win32 等では COMPILER は INDEPENDENT でも MSC, BORLANDC, LCC 等のどちらでもかまいません。これらの処理系ではプリプロセッサが独立していないので、compiler-specific-build でも処理系から呼び出されることはないからです。compiler-specific-build では処理系固有の事前定義マクロやオプションやいくつかの処理系固有の仕様が定義されるので、それがつごうが良いか悪いかでコンパイルの仕方を選びます。

実際にコンパイルする時の手順を configure script を使う場合と noconfig/*.mak ファイルを使う場合とに分けて説明します。

### 3.12.1. configure する場合

GCC でコンパイルする場合は configure が使えます。

    ./configure --enable-mcpplib
    make
    sudo make install

とすると、Linux や FreeBSD では compiler-independent 版の libmcpp.a, libmcpp.so.$(SHLIB_VER) が生成されて、デフォルトでは /usr/local/lib にインストールされます。 そして、libmcpp.so および libmcpp.so.0 から libmcpp.so.$(SHLIB_VER) へのリンクが張られます。 *.a は static ライブラリ、*.so は shared ライブラリです。 libmcpp.la というファイルも生成されますが、これは libtool というツールが使うためのものです。 $(SHLIB_VER) は mcpp V.2.6.3 では 0.0.0、V.2.6.4 では 0.0.1、V.2.7 では 0.1.0、V.2.7.1 では 0.2.0、V.2.7.2 では 0.3.0 としています。 mcpp_lib.h, mcpp_out.h というヘッダファイルも /usr/local/include にインストールされます。 これは libmcpp を使うプログラムに必要なものです。

Mac OS X では *.so ではなく *.dylib という名前になります。 また、make で CFLAGS+='-arch i386 -arch ppc' 等と、-arch オプションでいくつかの CPU を指定すると、それらに対応する universal binary のライブラリができます。 さらに -isysroot と -mmacosx-version-min= というオプションを使って、使える Mac OS X のバージョンの範囲を広げることができます。 次の例は、Leopard 上で Tiger と互換の i386 と ppc 用の universal binary の shared ライブラリを作るコマンドです。

    make CFLAGS+='-isysroot /Developer/SDKs/MacOSX10.4u.sdk -mmacosx-version-min=10.4 -arch i386 -arch ppc'

CygWIN, MinGW では *.so ではなく *.dll という名前の DLL となります。 CygWIN では libmcpp.a, libmcpp.dll.a, libmcpp.la が /usr/local/lib に、cygmcpp-0.dll が /usr/local/bin にインストールされます。 MinGW もほとんど同じですが、cygmcpp-0.dll が libmcpp-0.dll という名前になります。 DLL を使うときは libmcpp.dll.a をリンクします。 これは import library というものです。

生成された libmcpp.so をリンクする main_libmcpp.c という簡単なソースもコンパイルされて、mcpp という名前で /use/local/bin にインストールされます。 このソースでわかるように、libmcpp を使うには mcpp_lib.h というヘッダファイルを include します。*1

最小限のドキュメントもインストールされます。

testmain.c をコンパイルしてライブラリとリンクすると、もう少し複雑なテストができます。 これは configure ではやらないので、次節の方法で行います。

注:

*1 libmcpp を使わない stand-alone 版の compiler-independent-build の mcpp も同じ名前で同じディレクトリにインストールされるので、お互いに上書きし合うことになる。 ドキュメントは同じものが同じディレクトリにインストールされるので、これも上書きされる。

### 3.12.2. noconfig/*.mak を使う場合

noconfig.H と noconfig ディレクトリの makefile を使う場合は（noconfig.H にその処理系のバージョン用の patch を当てて、makefile の各ディレクトリの設定を自分のシステムに合わせて修正した上で）、次のようにします。

    make MCPP_LIB=1 mcpplib
    make MCPP_LIB=1 mcpplib_install

これは compiler-independent 版のコンパイルですが、GCC 以外では COMPILER=MSC 等として compiler-specific 版でコンパイルしてもかまいません。
Visual C では make ではなく nmake を使います。
LCC-Win32 の make は低機能で if 文による場合分けができないので、makefile を編集しながら make する必要があります。

Linux, FreeBSD, Mac OS X, CygWIN, MinGW では、libmcpp.la が生成されないのとドキュメントがインストールされない以外は、configure して make した場合と同様の結果になります。 Mac OS X では、mac_osx.mak の UFLAGS という変数定義をコメントアウトしている # を外すと、universal binary の設定になります。 Windows 上の処理系ではライブラリの名前は Linux 等とは違って、次のようになります。

| FreeBSD / GCC | Linux / GCC | Mac OS X / GCC | CygWIN / GCC | MinGW / GCC | Visual C, Borland C, LCC-Win32
--- | --- | --- | --- | --- | --- | ---
static library | libmcpp.a | libmcpp.a | libmcpp.a | libmcpp.a | libmcpp.a | mcpp.lib
shared library or DLL | libmcpp.so.$(SHL_VER) | libmcpp.so.$(SHLIB_VER) | libmcpp.$(SHLIB_VER).dylib | cygmcpp-$(DLL_VER).dll | libmcpp-$(DLL_VER).dll | mcpp$(DLL_VER).dll
import library of DLL |  |  |  | libmcpp-$(DLL_VER).dll.a | libmcpp-$(DLL_VER).dll.a | mcpp$(DLL_VER).lib

$(SHL_VER) は mcpp V.2.6.3, V.2.6.4 では 0、V.2.7 では 1、V.2.7.1 では 2、V.2.7.2 では 3 です。 $(SHLIB_VER) は mcpp V.2.6.3 では 0.0.0、V.2.6.4 では 0.0.1、V.2.7 では 0.1.0、V.2.7.1 では 0.2.0、V.2.7.2 では 0.3.0 です。 $(DLL_VER) は mcpp V.2.6.3, V.2.6.4, V.2.7, V.2.7.1, V.2.7.2 ともに 0 です。 $(SHLIB_VER) の１ケタ目または $(DLL_VER) が同じ場合は、$(SHLIB_VER) の２ケタ目以降の高いバージョンは低いバージョンの上位互換の関係にあります。

Windows 上の処理系では import library というものも生成されますが、これは DLL を使うためのものです。 DLL を使うときはこの import library をリンクします。 Static library と import library は makefile 中で指定された $(LIBDIR) に、DLL 本体は $(BINDIR) にインストールされます。 DLL を $(BINDIR) にインストールするのは、Windows では DLL は実行プログラムの PATH の通ったディレクトリになければならないからです。

mcpp_lib.h, mcpp_out.h が $(INCDIR) にインストールされます。

ライブラリ版をリンクする main_mcpplib.c もコンパイルされて mcpp という名前で $(BINDIR) にインストールされます。 Windows 上の処理系ではさらに 'DLL_IMPORT=1' というオプションを指定すると、DLL 版の mcpp がリンクされます。

次のようにすると、testmain.c というサンプルをメインプログラムとしてライブラリ版の mcpp がリンクされます。

    make testmain
    make testmain_install

testmain.c にはメモリ上のバッファに出力する例も書いてあります。 メモリに出力するには、メインプログラム中で mcpp_lib.h というヘッダファイルを include して、そこで宣言されている関数を使います。 上記のコマンドに 'OUT2MEM=1' というオプションを付け加えると、testmain.c でこれが有効になります。 `OUT2MEM` というマクロは単に testmain.c のためのもので、mcpp のためにはこのマクロは必要ありません。

ライブラリ版を使うときは、testmain.c を参考に main プログラムを書き、noconfig/*.mak を参考に makefile を書いてください。

### 3.12.3. static library と shared library および DLL

ライブラリには static library と shared library（Windows 上では dynamically-linking library: DLL）とあります。 Static library は *.o (*.obj) ファイルを集めたもので、コンパイル時にリンクされます。 その変数や関数の global name はそのまま呼び出し側の global name となり、名前の衝突の危険もあります。 このことは、V.2.6.1 まではライブラリ化を予定せずに開発されてきた mcpp にとっては大きな問題となります。 これに対して shared library (DLL) は実行時にリンクされるもので、他のプログラムと共有されます。

Windows 上の DLL ではライブラリの global name は外からは見えず、明示的に export された名前だけが外から import 可能です。 mcpp の場合は mcpp_lib.h にある名前だけを import できます。

UNIX 上の shared library では、一般にはライブラリの global name は外から丸見えで、名前の衝突に神経を使わなければなりません。 しかし、GCC 4.0 以降で mcpp V.2.7 以降をコンパイルした場合は、mcpp_lib.h にある名前以外は外からは見えません。*1, *2

こういうことで、Windows 上では DLL を使い、UNIX 上では GCC 4.0 以降でコンパイルした shared library を使うのが、名前の衝突が起こらず安心です。

注:

*1 mcpp V.2.7 以降では GCC V.4.0 で実装された #pragma GCC visibility * というディレクティブを使うようにしたためである。

*2 なお、GCC V.4.1 以降には -fstack-protector というオプションがあるが、これは #pragma GCC visibility hidden とは両立しないようである。 したがって、libmcpp のコンパイルでは使えない。

# 4. 各処理系に移植する方法：詳細

## 4.1. noconfig.H, configed.H, system.H の設定

これらのヘッダファイルに記述されていることの意味は、たいていは読めばわかると思います。コメントも多く書き込んであります。さらに念のために以下に注釈を書いておきます。
設定の PART 1, PART 2 は `noconfig.H (configed.H)` にあり、PART 3 は `system.H` にあります。

まず、ターゲットシステム（mcpp を移植するシステム）とホストシステム（mcpp をコンパイルするシステム）を指定します。

- `SYSTEM`
  ターゲット処理系が動くＯＳを指定します。ＯＳの名前はこの直後に定義されています。名前が定義されていないＯＳは適宜定義してください。
- `COMPILER`
  ターゲット処理系を指定します。コンパイラの名前はこの直後に定義されています。名前が定義されていないコンパイラは適宜定義してください。COMPILER を INDEPENDENT に定義すると、ターゲット処理系の存在しない compiler-independent 版の mcpp が生成されます。この場合は PART 1 の多くの設定が無視されます。
- `VERSION_MSG`
  -v オプションや usage() 文で表示するためのホスト処理系のバージョン情報を文字列リテラルで書きます。
- `HOST_SYSTEM, HOST_COMPILER`
  ホストＯＳ、ホスト処理系を指定します。ターゲットと同じ場合は、

      #define HOST_SYSTEM     SYSTEM
      #define HOST_COMPILER   COMPILER

  としておきます。

SYSTEM, COMPILER の命名には一定の規則がありますが、ソースを見たほうがわかりやすいでしょう。いささか仰々しい形になっていますが、SYSTEM はインクルードファイルのパスリストの形式やＯＳ標準のインクルードディレクトリ等を知るためにしか使われていないので、あまり考える必要はありません。

### 4.1.1. PART 1 ターゲットシステムの設定: compiler-specific-build

#### 4.1.1.1. 事前定義マクロ

- `SYSTEM_OLD, SYSTEM_STD1, SYSTEM_STD2, SYSTEM_EXT, SYSTEM_EXT2, COMPILER_OLD, COMPILER_STD1, COMPILER_STD2, COMPILER_EXT, COMPILER_EXT2`
  mcpp で predefine する処理系固有のマクロの名前を文字列リテラルで指定します。不要なものは定義しないでおきます（0 個のトークンに定義してはいけない）。*_OLD で生成されるのは '_' (underline) で始まらない古い流儀のマクロで、これらは mcpp 実行時に -S <n> オプションで <n> に 1 以上を指定すると predefine されません（ただし、GCC-specific-build の STD モードでは、-ansi または -std=iso* オプションが指定されない限り、これらのマクロも定義される）。 *_STD?, *_EXT, *_EXT2 では必ず _ で始まるマクロ名を指定します。*_STD1 は `__` で始まるもので、*_STD2 は `__` で始まって `__` で終わるものです。SYSTEM_EXT, SYSTEM_EXT2, COMPILER_STD1, COMPILER_STD2, COMPILER_EXT, COMPILER_EXT2 ではそのマクロの値も SYSTEM_EXT_VAL, SYSTEM_EXT2_VAL, COMPILER_STD1_VAL, COMPILER_STD2_VAL, COMPILER_EXT_VAL, COMPILER_EXT2_VAL で指定します。これは整数を "" で囲んだ文字列リテラルで指定します。0 個のトークンに展開されるマクロは "" と定義します。指定されなければ、そのマクロの値は 1 になります。その他の predefined マクロ（SYSTEM_OLD, SYSTEM_STD1, SYSTEM_STD2, COMPILER_OLD で指定されるもの）はすべて 1 の値を持ちます。
- `SYSTEM_SP_OLD, SYSTEM_SP_STD`
  処理系固有の特殊な事前定義マクロの名前を文字列リテラルで書き、その値を SYSTEM_SP_OLD_VAL, SYSTEM_SP_STD_VAL で定義します。
- `COMPILER_SP1, COMPILER_SP2, COMPILER_SP3`
  処理系固有の特殊な事前定義マクロの名前を文字列リテラルで書き、その値を COMPILER_SP1_VAL, COMPILER_SP2_VAL, COMPILER_SP3_VAL で定義します。
- `COMPILER_CPLUS, COMPILER_CPLUS_VAL`
  -+ オプション（C++ プリプロセス）を指定した時に定義される処理系固有の事前定義マクロの名前とその値を上記と同じように文字列リラテルで指定します。COMPILER_CPLUS_VAL を指定しないと、そのマクロの値は 1 になります。名前は '_' で始まるものでなければなりません。必要がなければ COMPILER_CPLUS そのものを定義しないでおきます。

このほか、実行時オプションに応じて `system.c` で定義される事前定義マクロもあります。CPU-dependent なマクロなどです。GCC V.3.3 以降では大量の事前定義マクロがあるので、これらの設定とは別に `mcpp_g*.h` という名前の４本の専用のヘッダファイルが mcpp のインストール時に自動的に生成されます。

以上の設定で事前定義されたマクロはすべて実行時には -N オプションで無効となります。

#### 4.1.1.2. Include ディレクトリ等

- `C_INCLUDE_DIR1, C_INCLUDE_DIR2, CPLUS_INCLUDE_DIR1, CPLUS_INCLUDE_DIR2, CPLUS_INCLUDE_DIR3`
  mcpp でサーチする標準ヘッダファイルの include directory を指定します。CPLUS_INCLUDE_DIR? は C++ の include directory がＣのものと違っている場合に、設定します（mcpp を起動する時に -+ オプションを指定することで有効となる）。UNIX の /usr/include, /usr/local/include は `system.c` で設定されるので、C_INCLUDE_DIR? にはそれ以外の処理系固有のものを指定します。
- `ENV_C_INCLUDE_DIR, ENV_CPLUS_INCLUDE_DIR`
  mcpp でサーチする標準ヘッダファイルの include directory を実行時に環境変数で指定する場合のために、その環境変数の名前に定義します。ENV_CPLUS_INCLUDE_DIR は C++ の include directory を指定する環境変数の名前です。デフォルトではそれぞれ "INCLUDE", "CPLUS_INCLUDE" に定義されます。GCC-specific-build では "C_INCLUDE_PATH", "CPLUS_INCLUDE_PATH" がデフォルトです。
  サーチパスはその外、`system.c` で設定されるもの、-I オプションで設定されるものがあります（それらの優先順位については mcpp-manual.html#4.2 を参照）。
- `ENV_SEP`
  この環境変数に複数のパスを書く時の separator を文字定数で書きます。
  `/usr/local/abc/include:/usr/local/xyz/include` と書く時の ':' や
  `C:/BC55/INCLUDE;C:/BC55/LOCAL/INCLUDE` と書く時の ';' がこれです。
- `SEARCH_INIT`
  ターゲット処理系が include ファイルをサーチする時のルールを書きます。#include "../dir/header.h" といったディレクティブを処理する時に、include ディレクトリをサーチする前にどのディレクトリをサーチするのかというルールです。カレントディレクトリからの相対パスをサーチする処理系では CURRENT とし、ソースファイル（include 元）のあるディレクトリからの相対パスをサーチする処理系では SOURCE とします。この両者の組合わせである場合は (CURRENT & SOURCE) とします。

#### 4.1.1.3. 行番号情報の出力形式その他

- `LINE_PREFIX`
  mcpp から compiler-proper にファイル名と行番号情報を伝える形式を設定します。

      #line 123 "fname"

  というＣのソースの形式がデフォルトとなっています。その他の形式を使う処理系では、この `"#line "` の部分を置き換える sequence を文字列リテラルで書いておきます。

      # 123 "fname"

  という形式なら `"# "` と定義し、どちらでもない独自の形式ならそれに合わせて定義します（場合によっては `main.c` の sharp() 等に書き足さなければならないかもしれない）。
  Visual C++ .net や Borland C のような１パスコンパイラの前段に mcpp を使う場合は、組み込みプリプロセッサに出力を渡すことになるので、mcpp の出力はＣのソースになっていなければなりません。したがって、行番号の受け渡しは１番目の形式でなければなりません。
- `EMFILE`
  `<errno.h>` で too many open files (for the process) を意味する errno の値を表すマクロが EMFILE でない場合は、EMFILE をそのマクロ名に定義します（もちろん、`<errno.h>` 自体に書き加えてもかまわない）。
- `ONE_PASS`
  ターゲット処理系がプリプロセッサの分離されていないいわゆる「ワンパスコンパイラ」であればこれを TRUE に、そうでなければ FALSE に定義します。これを TRUE とすると、#pragma MCPP put_defines (#put_defines) では、処理系の事前定義マクロはすべてコメントで囲んで出力します。ワンパスコンパイラでは mcpp の出力をこれに与えると再度プリプロセスされることになるので、二重定義を避けるためです。
  ただし、GCC V.3, V.4 はワンパスコンパイラとも言えますが、独立したプリプロセッサを使うこともできるので、このマクロは FALSE としておきます。
- `FNAME_FOLD`
  Windows のようにファイル名の大文字と小文字が区別されないＯＳではこれを TRUE と定義し、そうでなければ FALSE とします。

#### 4.1.1.4. 処理系の言語仕様に応じた設定

- `EXPAND_PRAGMA`
  #pragma 行の引数が STDC 以外であればマクロ展開の対象となる処理系では、これを TRUE に定義します。デフォルトでは FALSE としています。Visual C, Borland C では #pragma 行の引数は常にマクロ展開の対象となるので、これは TRUE とします。C99 では #pragma の引数がマクロ展開の対象となるかどうかは implementation-defined で、C90 ではマクロ展開されないのが規定なのですが、しかし、mcpp は Visual C, Borland C 用に限っては C99 でなくてもマクロ展開の対象とします（引数が STDC または MCPP で始まらない限り）。
- `HAVE_DIGRAPHS`
  Digraphs 処理が実装されている場合は TRUE、そうでなければ FALSE とします。
- `STDC`
  ターゲット処理系の事前定義マクロ `__STDC__` のデフォルト値に定義します。`__STDC__` が定義されていなければ 0 とします。
- `STDC_VERSION`
  ターゲット処理系の事前定義マクロ `__STDC_VERSION__` のデフォルト値に定義します。`__STDC_VERSION__` が定義されていなければ 0L とします。
- `CHARBIT, UCHARMAX, LONGMAX, ULONGMAX`
  ターゲット処理系の `<limits.h>` の `CHAR_BIT, UCHAR_MAX, LONG_MAX, ULONG_MAX` の値を書きます。
  ただし、`limits.h` の `UCHAR_MAX` の定義は間違っている場合があるので、注意が必要です。255U, 0xffU 等と unsigned にしてはいけません。255, 0xff 等と signed int の値に定義します（cpp-test.html#5.1.3 参照）。

#### 4.1.1.5. Multi-byte character

MBCHAR というマクロは multi-byte character の encoding を指定するものです。mcpp では下記の数種の encoding がすべて同時に実装されます。MBCHAR はデフォルトの encoding を指定するだけで、実行時に encoding を環境変数・オプション・#pragma で変更することができます（使い方については mcpp-manual.html#2.3, mcpp-manual#2.8, mcpp-manual.#3.4 を参照）。

- `MBCHAR`
  ターゲットの multi-byte character（日本語では漢字）の encoding の種類を定義します。

  > EUC_JP | 日本の extended UNIX code (UJIS)
  > SJIS | 日本の shift-JIS (MS-Kanji)
  > GB2312 | 中国の EUC-like な GB-2312（簡体字）
  > BIGFIVE | 台湾の Big5（繁体字）
  > KSC5601 | 韓国の EUC-like な KSC-5601 (KSX 1001)
  > ISO2022_JP | ISO-2022-JP1 という国際規格の日本語
  > UTF8 | unicode の encoding の１種である UTF-8

  初めの５つはいずれも shift-states を持たない、１文字が２バイトを占める encoding です。なお、multi-byte character, wide character の encoding が２バイトであるにもかかわらず、wchar_t が４バイトの型になっている処理系もありますが、プリプロセッサは wchar_t の型には関知しません。ソース上では multi-byte character や wide character が２バイトを占めているので、それに従って処理をします。
  ISO-2022-* は shift-states を持つ encoding です。UTF-8 は２バイトの unicode を１バイトないし３バイトで encode するものです。漢字は３バイトになります。
  MBCHAR を 0 に定義した場合、multi-byte character の処理をしないのがデフォルトの仕様になるだけで、環境変数・オプション・#pragma で実行時に変更されます。
- `SJIS_IS_ESCAPE_FREE`
  コンパイラ本体が shift-JIS の処理をする場合は TRUE とし、しない場合は FALSE とします。
  Shift-JIS では漢字の２バイト目が '\\' と同じ 0x5c の値になることがあります。コンパイラ本体が shift-JIS を認識しない場合は、これを escape sequence と解釈してしまい、tokenization でエラーになります。
  SJIS_IS_ESCAPE_FREE を FALSE とすると、mcpp が処理を補います。すなわち、最終出力の時に、文字列リテラルまたは文字定数の中の shift-JIS 漢字第２バイトが 0x5c であった場合は、そこに 0x5c のバイトをもう１つ付加します。これによって、英語版のコンパイラを一応 shift-JIS に対応させることができます。
- `BIGFIVE_IS_ESCAPE_FREE`
  同様に、コンパイラ本体が Big 5 の処理をする場合はこれを TRUE とし、しない場合は FALSE とします。
- `IS02022_JP_IS_ESCAPE_FREE`
  同様に、コンパイラ本体が ISO-2022-JP の処理をする場合はこれを TRUE とし、しない場合は FALSE とします。IS0-2022-* では '\\' ばかりでなく、'\'' や '"' と一致するバイトも出現します。ISO2022_JP_IS_ESCAPE_FREE が FALSE の場合は mcpp は、'\\', '\'', '"' と一致するバイトの直前にすべて 0x5c のバイトを１つ挿入します。

なお、multi-byte character に関するコンパイラの動作は実行する時の環境によって変わる場合があります。自分の使う環境に合わせて設定してください。これについては、mcpp-manual.html#2.8 も参照してください。

#### 4.1.1.6. ターゲットとホストに共通の設定

次の２つは便宜上、PART 2 に書いてありますが、 ターゲット処理系とホスト処理系の双方が指定の型を持つ場合に TRUE とし、そうでない場合は FALSE とします。

- `HAVE_LONG_LONG`
  long long というデータ型を持つ処理系ではこれを TRUE とします。
  Visual C の 2005 までや Borland C 5.* のように、long long はないが __int64 という同じサイズの型があり printf() で表示するための length modifier も用意されている場合は、これは TRUE とします。 Visual C 2008 では long long が使えます。
- `HAVE_INTMAX_T`
  intmax_t というデータ型が定義されていればこれを TRUE とします。
- `LL_FORM`
  双方の処理系が long long を持っている場合は、ホスト処理系の最大の整数型の値を printf() で表示するための length modifier を文字列リテラルで定義します。C99 では "j" です。また、C99 では long long の length modifier は "ll" (ell-ell) です。Visual C の 2003 までと Borland C 5.* では __int64 の値を表示する "I64" を使います。MinGW でも "I64" です。

### 4.1.2. PART 2 ホストシステムの設定

`noconfig.H, configed.H` ではターゲット処理系とホスト処理系とが同一であると仮定していますが、異なる場合は PART 2 を書き直す必要があります。

- HOST_HAVE_STPCPY
  ホスト処理系のライブラリに stpcpy() があれば TRUE に、なければ FALSE に定義します。FALSE であれば stpcpy() には `system.c` のものが使われます。
- `PATHMAX`
  ホスト処理系の `<limits.h`> の `PATH_MAX` の値です。 これは POSIX で規定されているマクロですが、これがない処理系では `<stdio.h`> の `FILENAME_MAX` の値を使います。

PART 1 にもホストとターゲットが同一と仮定している部分があるので、必要ならそれを書き換えます。例えば次のようにホスト処理系の事前定義マクロを使っている行です。

    #if _MSC_VER >= 1200

### 4.1.3. PART 3 mcpp の動作仕様の設定

#### 4.1.3.1. 新旧各種の動作モード

`system.H` では mcpp の動作仕様を指定するマクロが定義されています。

mcpp には mcpp_mode という変数があり、これがマクロの展開方法、使えるディレクティブ、使える predefined マクロ等、プリプロセッサの根幹となる動作の仕様を決めています。mcpp_mode の値には OLD_PREP, KR, STD, POST_STD の４種があります。
mcpp の動作モードは実行時オプションで指定されます。mcpp をコンパイルする時には、これらの４つのマクロについては何も設定することはありません。しかし、各種の設定を正しく行うためには４つの動作仕様の違いを理解することが必要です。
このほかに COMPAT モードもありますが、これは STD の変種です。

- `OLD_PREP`
  いわゆる "Reiser" model cpp の動作仕様です。
- `KR`
  C90 以前の K&R 1st. のプリプロセス仕様です。
- `STD`
  規格 (C90, C99, C++98) 準拠のプリプロセス仕様です。
- `POST_STD`
  筆者が勝手に作ったプリプロセス仕様で、規格の首尾一貫しない規定を整理して単純化したものです。

ここでは KR と OLD_PREP を合わせて pre-Standard モード、STD と POST_STD を合わせて Standard モードと呼ぶことにします。各モードの仕様の詳細については mcpp-manual.html#2.1 を参照してください。

#### 4.1.3.2. 動作モードの細部の指定

- `CPLUS`
  -+ オプションで C++ のプリプロセッサとして動作させた時に、標準組み込みマクロ `__cplusplus` がこの値に事前定義されます。C++98 では 199711L です。-V オプションによって実行時に変更できます。
- `TRIGRAPHS_INIT`
  STD モードでの trigraph 処理の初期状態を指定します。-3 オプションはその状態を反転させます。これを TRUE にすると、default で trigraph が認識され、-3 オプションで起動すると認識しません。FALSE の場合は逆に default で認識せず、-3 オプションで認識するようになります。
- `DIGRAPHS_INIT`
  Standard モードでの digraph 処理の初期状態を指定します。-2 オプションはその状態を反転させます。これを TRUE にすると、default で digraph が認識され、-2 オプションで起動すると認識しません。FALSE の場合は逆に default で認識せず、-2 オプションで認識するようになります。
  HAVE_DIGRAPHS == FALSE の処理系の場合、digraphs は mcpp が通常のトークンに変換します。
- `OK_UCN`
  STD モード で -V199901L または -+ オプションを指定した時に UCN (universal-character-name) を有効にするには、これを TRUE に定義します。デフォルトでは TRUE としています。*1
- `OK_MBIDENT`
  STD モード で -V199901L オプションを指定したときに identifier 中に multi-byte character を使えるようにするには、これを TRUE に定義します。デフォルトでは FALSE としています。
- `expr_t, uexpr_t`
  最も大きい整数の型に typedef で定義します。intmax_t, uintmax_t という型があればそれに、そうでなくて long long, unsigned long long を持つ処理系ではそれに、そうでなくて __int64, unsigned __int64 を持つ処理系ではそれに、そうでなければ long, unsigned long に定義します。
- `EXPR_MAX`
  uexpr_t の最大値に定義します。

注:

*1 UCN は C++, C99 の仕様で、Unicode の文字の値を \u または \U で始まる１６進 escape sequence で表記するものである（mcpp-manual.html#3.7, cpp-test.html#2.8, cpp-test.html#4.6 参照）。

#### 4.1.3.3. Translation limits の指定

- `RESCAN_LIMIT`
  Standard モードでのマクロ展開時の再走査回数の限度を定義します。 Standard モード では再走査回数は少ないので、あまり大きな値を設定する必要はありません。
- `PRESTD_RESCAN_LIMIT`
  pre-Standard モードでのマクロ展開時の再走査回数の限度を定義します。pre-Standard モード では再帰的なマクロ展開によって無限ループが発生しえますが、それがこのリミットにひっかかります。
- `NBUFF`
  論理行（ソースの物理行の行末の \ を取って接続した行）の最大長 +1 を定義します。コメントを a space に変換した後の行（コメントによって複数の論理行にまたがることもありうる）もこの長さにおさまっていなければなりません。
- `NMACWORK`
  マクロ展開の内部的なバッファのサイズを定義します。すなわち、１つの論理行中のマクロを展開した結果（マクロ呼び出しが複数行にまたがる場合は、それを展開した結果）はこのサイズにおさまっていなければなりません。これはまた、１つのマクロ定義の置換リストを内部的に記憶する際の最大長としても使われます。これは NBUFF*2 以上で NWORK*2 以上でなければなりません。
- `NWORK`
  mcpp の出力する最大行長を定義します。これは compiler-proper の受け取れる最大行長+1 を越えてはいけません。また、NBUFF の値を越えてもいけません。マクロ展開後の行長がこれを越えた時は、mcpp がこれ以下の行長に分割して出力します。文字列リテラルの長さは NWORK-2 の範囲に収まっていなければなりません（文字列リテラルの長さというのは、char 配列の要素数のことではなく、ソース上での文字列リテラルというトークンの長さである。両端の " を含み、\n 等は２バイトと数える。ワイド文字列リテラルでは先頭の L も含む）。
  ただし、GCC 版および Visual C 版では出力の最大行長としては NWORK ではなく NMACWORK を使います。 これらの処理系ではコンパイラがかなり長い行を受け取ることができるので、分割して出力する必要がないからです。
- `IDMAX`
  識別子の最大長を定義します。これより長い名前もエラーにはなりませんが、この長さに切り詰められます。
- `NMACPARS`
  関数様マクロの引数の最大数を定義します。これは UCHARMAX よりも大きくはできません。
- `NEXP`
  #if 行の式のカッコでくくられるネストレベルの限度を定義します（本当はネストレベルがこれで直接決まるわけではない。正確には、式中の定数トークンの数がこの２倍、演算子トークンの数がこの３倍まで使える。かっこは一対で２つと数える）。
- `BLK_NEST`
  #if (#ifdef, #ifndef) section のネストレベルの限度（#if, etc. が何段階にネストできるか）を定義します。
- `INCLUDE_NEST`
  #include のネストレベルの限度を定義します。#include の無限再帰をチェックするためのものです。同時にオープンできるファイルの数に関する OS の制限を超えていてもかまいません。
- `SBSIZE`
  マクロを内部的に hash で分類して記憶する際の hash table の要素数を定義します。必ず２のベキ乗でなければなりません。マクロの数より小さくても動作は正常にしますが、大きいほうが処理はやや速くなります。

それぞれ大きい値にするほど仕様は上等になりますが、NWORK, NBUFF, NMACWORK, SBSIZE は大きいとそれだけ大きなメモリを食います。実際のメモリ消費はマクロ定義の量によってさらに増えてゆきます（それぞれのマクロ定義の長さによって必要メモリが決まる。マクロ定義の内部的な形式は `internal.H` の struct defbuf に書いてある）。

NMACWORK, NEXP, RESCAN_LIMIT はスタックを消費します。
他のものはメモリはさほど必要としませんが、`system.H` のデフォルトの値以上にしても実用上の意味はほとんどないでしょう。

C90, C99 の要求する translation limits の最低限度は `system.H` の最後のほうに書いてあります。C++98 の translation limits も書いてありますが、これはＣと異なり、要求仕様ではありません。

## 4.2. system.c

主としてターゲット処理系に関するいくつかの設定を実装しています。

- `PATH_DELIM`
  ＯＳの path-delimiter を定義しています。PATH_DELIM は \ としてはいけません（プログラムのつごうで）。Windows では / としています。ユーザプログラムではもちろん \ も使えますが、それを内部的には / に変換します。
- `OBJEXT`
  処理系の生成するいわゆるオブジェクトファイルの接尾子を文字列リテラルで定義します。UNIX 上の処理系の "o"、Windows 上の処理系の "obj" 等です。これは -M* オプションを指定した時の makefile 用依存関係行の出力に使われるものです。
- `do_options()`
  mcpp を起動する時のオプションを実装しています。まだ移植されていない処理系に移植する時には、その処理系付属のコンパイラドライバに合わせて、ここに何行か書き足すことが必要でしょう。do_options() に追加した時は、それに対応して次の set_opt_list(), usage() にも書き足します。
  do_options() は mcpp_getopt() を呼び出します。mcpp_getopt() は POSIX の getopt() と同じ仕様です。 そのため、１つのオプション文字は引数なしか引数ありのどちらかに決めなければなりません。-P と -P- といったオプションの使い方は原則としてできません（しかし、処理系付属のプリプロセッサとの互換性のために必要な場合は、無理やりできなくもない。-M オプションの実装を参照）。また、-trigraphs といった長いオプションは t をオプション文字として rigraphs を引数とすることで実装するしかありません。
- `set_opt_list()`
  do_options() で使うオプション文字を設定します。
- `usage()`
  Usage 文が書かれています。 モードごとのオプションがアルファベット順に並べられています。
- `set_sys_dirs()`
  Include directory を設定しています。`noconfig.H (configed.H)` のマクロ C_INCLUDE_DIR?, CPLUS_INCLUDE_DIR? で指定された処理系固有のディレクトリのほか、UNIX 系ＯＳでの /usr/include, /usr/local/include もここで設定しています（`noconfig.H, configed.H` のマクロ ENV_C_INCLUDE_DIR, ENV_CPLUS_INCLUDE_DIR で定義された名前の環境変数による include directory 指定は set_env_dirs() で設定される）。
- `do_pragma()`
  #pragma の処理を実装しています。mcpp 自身が処理しない #pragma sub-directive はそのまま出力して compiler-proper に渡します。mcpp 自身が処理する #pragma MCPP debug 等はここから呼び出す関数で処理します。mcpp 自身が処理する #pragma sub-directive は原則として MCPP という名前で始まるようにしています。MCPP で始まる #pragma 行そのものは出力しません。また #pragma once も出力しません。しかし、#pragma __setlocale 行は出力します。規格では処理系固有の拡張 directive は #pragma sub-directive として実装することになっています。
- `do_old()`
  規格に合致しない preprocessing directive （#pragma sub-directive でない #assert, #asm, #endasm, #include_next, #warning, #put_defines, #debug 等）が必要な場合は、その処理をする関数を書き足したうえで、ここからそれを呼び出すようにします（ただし、GCC 用では #include_next, #warning は STD モード でも使えるようにしてある）。

Standard C にはないライブラリ関数のうち、getopt() と stpcpy() のソースがここに書いてあります。 getopt() はリンクのトラブルを防ぐため、mcpp_getopt() と名前を変えてあります。 stpcpy() は HOST_HAVE_STPCPY が FALSE の時に使われます。

## 4.extra. malloc()

「kmmalloc -- デバッグ機能を持つ malloc()」というのは、私がＣで書いた malloc(), free(), realloc(), calloc() の portable なソースです。これはメモリ効率を改善するとともに、デバッグのつごうを考えて書いてあります。デバッグ用のルーチンも添付してあります。これをリンクしておくと、思わぬバグがひっかかってくることがあります。*1, *2

noconfig/*.mak で -DKMMALLOC -D_MEM_DEBUG -DXMALLOC というオプションを与えているのは、この私の malloc() 等とデバッグルーチンをリンクするためのものです。これをリンクした mcpp がEFREEP, EFREEBLK, EALLOCBLK, EFREEWRT, ETRAILWRT というエラー番号で途中で exit することがあれば、それは mcpp のバグを意味します。

BSD_MALLOC, DB_MALLOC, MALLOC_DBG というマクロのどれかを 1 に定義して mcpp をコンパイルすると、私の malloc() とは別のそれぞれデバッグ機能を持った malloc() が使われます。いずれにしても、処理系付属のものではない malloc() を使うには、コンパイルする前にライブラリを作っておかなければなりません。これについては kmmalloc のドキュメントを見てください。

注:

*1 kmmalloc は次のところにある。

> http://download.vector.co.jp/pack/dos/prog/se026997.html

*2 CygWIN ではライブラリの組み立てが他の malloc() を使えないようになっているので、私の malloc() は使っていない。 Visual C 2005, 2008 でも同様である。

# 5. バグ報告と移植の報告

## 5.1. バグかどうか？

プリプロセスの Standard C 適合性を検証するための Validation Suite を mcpp といっしょに公開しています。Standard C のプリプロセスのすべての規定を検証できるものにしたつもりです。もちろん、mcpp はこれを使ってチェックしてあります。それも、上記のすべての処理系でコンパイルしてチェックしてあります。したがって、バグや誤仕様はほとんどないと思いますが、しかし、まだいくつか残っている恐れもあります。まだ移植されていない処理系に新しく移植した場合は、処理系のバグにひっかかる可能性もあります。

もし、不可解な動作が発見されたら、ぜひご報告ください。その際には、次の点のチェックをお願いします。

1. STD モードの場合、自分の Standard C 解釈を確かめるため、まず Validation Suite を使ってみる。GCC / testsuite の使えるシステムでは、オプションを付けて configure して make check で自動テストができる。
2. 自分の mcpp の移植に間違いはないかどうか、ドキュメントを確かめる。
3. バグを再現するサンプルソースを抽出する。
4. バグを引き出す部分を #pragma MCPP debug <args> と #pragma MCPP end_debug ではさんで mcpp の動作をトレースしてみる。この <args> をさらに増やしてより詳細にトレースしてみる。

もし、"Bug: ..." という診断メッセージが出たら、それは間違いなく mcpp または処理系の（たぶん mcpp の）バグです。また、たとえむちゃくちゃな「ソース」でも、それを食わせることで mcpp が暴走するなら、それもバグです。
もちろん、Standard C モード以外のモードの mcpp は Validation Suite では「間違い」だらけの動作をしますが、それは仕様です（それでも暴走はしないはず）。どういう仕様かは 4.1.3 を見てください。

## 5.2. malloc() 関連のバグチェック

私が書いた kmmalloc という malloc() 等のライブラリがあります（4.extra 参照）。
もし、私のこの malloc() 等をリンクした mcpp で 120 から 124（処理系によっては 2120 から 2124）のエラー番号で途中で exit することがあれば、それは間違いなく mcpp または処理系の（たぶんライブラリ関数の）バグです。

また、テストに使うサンプルソースのどこかに

    #pragma MCPP debug memory

と書いておくと、その個所および終了時にヒープメモリに関する情報が出力されますが、ここで Heap error: ... というメッセージが出ることがあれば、それも間違いなく mcpp または処理系のバグです。

これらのバグが発見されたら、サンプルソースの各部分を #if 0 と #endif ではさんでテストを繰り返し、バグを発生する部分を絞り込んでみてください。

## 5.3. バグ報告を

バグ報告には次のようなデータを付けてくださるようお願いします。

1. mcpp を移植した処理系。
2. 移植した方法（`noconfig.H` 等の設定）。
3. バグと思われるものを再現できるサンプルソース。
4. その処理結果。

## 5.4. 移植の報告を

mcpp はほとんどの処理系に比較的簡単に移植できるように書いてあるつもりです。 しかし、私が持っている処理系は少数です。他の処理系への移植ではソースの書き足しが必要なはずです。それらの処理系への移植の報告をお待ちしています。それをソースにフィードバックしていきたいと思います。
移植の報告は次のような形でお願いします。

1. 処理系。
2. `noconfig.H (configed.H), system.H, system.c` の設定。 なるべくオリジナルとの差分ファイルが良いが、簡単なものならメモでも可。

正しく移植できたかどうかを確かめるには、compiler-specific-build では、まずプリプロセッサを入れ替えて、ヘッダファイルの "pre-preprocess" の機能を使って自分自身をリコンパイルしてみるのが手っ取り早いでしょう。

さらに Validation Suite で STD モードのチェックをします。ただ、これはファイルの数が多いので、デバッグを繰り返す時には手間がかかりすぎます。デバッグ中はまず、n_std.c をコンパイルして、正常にコンパイル・実行されるかどうかを見ます。処理系付属のコンパイラドライバでは mcpp に渡す方法のないオプションもありますが、それについては mcpp-manual.html#2.2 を見てください。先に mcpp を通してからコンパイルする手もあります。

もしこれがうまくいかない場合は、 n_std.t というサンプルを使って、どこが悪いのか、目でチェックします。これがうまくいったら、e_std.t, m_*.t, unspcs.t, warns.t, misc.t もチェックします。"post-Standard" モードでは n_post.t, e_post.t を使います。

これらを mcpp -QCz23 というオプションを付けて処理します（post-Standard モードでは -3 は不可）。STDC == 0 でコンパイルしてあれば -S1 -V199409L オプションも付けます。-C オプションでコメントも出力されるので、処理結果が期待通りかどうかがすぐわかります。
-Q オプションで診断メッセージは mcpp.err というファイルに出力されるので、それをページャー等で読みます。
-z オプションで、ヘッダファイルの出力は省略されます。
-2 -3 で digraph と trigraph が有効になります。-S1 -V199409L で `__STDC__` が 1 に `__STDC_VERSION__` が 199409L になります。
C99 対応のテストをするためには、-V199901L オプションを付けて n_std99.t, e_std99.t のチェックをします。

Validation Suite の `cpp_test.c` というプログラムを使うと、n_*.c, i_*.c のサンプルのテストを自動的に行うことができます（ただし、これは○×をつけるだけで、詳細はわからない。また、e_*.?, u_*.?, unspcs.?, warns.? 等のテストは含まれない。mcpp 自身のテストをするためには、n_std.c をコンパイルするほうが早い）。

なお、Validation Suite は GCC の testsuite に対応しています。したがって、mcpp を GCC のどれかのバージョンに移植した場合は、GCC / testsuite がインストールされていれば、GCC のプリプロセッサを mcpp に置き換えると、mcpp の自動テストができます。これについては cpp-test.html#3.2.3, mcpp-manual.html#3.9.7 を見てください。

## 5.5. GCC 以外の処理系での configure の情報を

mcpp は UNIX 系システムでは configure スクリプトが使えます。 しかし、UNIX 系システムでの GCC 以外の処理系については私はまったく知らないので、compiler-specific-build の configure ではいくつかのオプションを指定してもらわなければなりません。

これらのオプションで指定する内容については、その処理系を使っている人は知っているか、または調べることができるはずです。おわかりの方はぜひ教えてください。Configure に取り込んでゆきたいと思います。
Configure については INSTALL をご覧ください。

## 5.6. データを送ってくれれば移植してみます

移植がうまくいかない場合は、そのようすをお知らせください。
次のデータを付けてくれれば、移植したソースをお返しできるかもしれません。Configure の使える環境では、これらのデータのうちのかなりの部分を configure によって知ることができます。
なお、C90 (ANSI C) に対応していない処理系は、mcpp V.2.6 からは移植の対象から外しました。

1. ＯＳとそのパスリストの形式（私は UNIX 系, DOS/Windows 系, OS-9 しか知らない）。
2. 処理系の名前とバージョン。
3. 基本文字セットは ASCII か。 そうでなければどういう文字セットか。Multi-byte character（漢字）の encoding はシフト JIS か EUC-JP か、それとも何か。Shift-JIS のように <backslash> と同じコードが multi-byte character に含まれる encoding の場合、コンパイラ本体はそれを認識するか。
4. Shell（コマンドプロセッサ）は大文字と小文字を区別するか。
5. ファイル名の大文字と小文字は区別されるか。
6. 実装したい実行時オプション。コンパイラドライバから渡されるオプション。 プリプロセッサ単体で動かす時のオプション（getopt() で実装できないものは不可）。
7. プリプロセッサが分離されている処理系か、それともいわゆるワンパスコンパイラか。
8. その処理系の事前定義マクロとその値。C++ の時はどうなるか（コンパイラドライバから -D オプション等でプリプロセッサに渡されるマクロと、プリプロセッサ自身が事前定義するマクロとを区別すること）。
9. long long 型はあるか。long long がある場合、printf() での long long の length modifier は何か。long long がなくても同じサイズの型があるか。
10. #pragma 行の引数はマクロ展開の対象となるか。
11. Include directory を指定する環境変数にはどういう名前を使うか。環境変数で複数のパスを記述する時の separator には何を使うか。
12. 通常使う include directory。#include でヘッダファイルをサーチする時の規則。
13. 必要な関数で、ライブラリに無いものがあるか。
14. コンパイラ本体は digraph を認識するか。
15. 識別子に $ を使うか。
16. #asm, #endasm はあるか。 これではさまれたブロックのコンパイラ本体への受け渡し形式はどうか。その他の規格外 directive にはどんなものがあるか。
17. プリプロセッサで処理すべき #pragma sub-directive には何があるか。
18. コンパイラ本体が受け取れる行長はどのくらいまでか（Validation Suite にある `test-l/l_37_8.c` をコンパイルするとわかる）。
19. コンパイラ本体では、識別子は何バイトまで識別されるか。
20. コンパイル後、リンク前の「オブジェクトファイル」の接尾子は何か（UNIX 上の処理系の .o や Windows 上の処理系の .obj に相当するもの）。
21. 次の `t_line.c` というサンプルをプリプロセッサだけに通した結果（単体プリプロセッサを使うか、またはオプションでプリプロセス後の出力を指定する）。これは行番号とファイル名の情報をコンパイラ本体に渡す方法を見るためのものである。`<stdio.h>` の内容は長すぎるので、途中をカットして最初の１０〜２０行と最後の１０〜２０行があれば十分である。
    さらに、#line 1000 が処理された結果が #line 1000 "t_line.c" とならず #1000 "t_line.c" とかその他の形式になる処理系では、その部分を #line 1000 "t_line.c" と書き替えてコンパイラ本体に渡して、これを認識できるかどうかを見る（#line 1000 "t_line.c" でエラーにならなければ error line; の行でエラーメッセージが出るはずであるが、その時に行番号がどう出るか）。

    /* t_line.c */
    #include    <stdio.h>

    #line 1000

    error line;

    main( void)
    {
        return  0;
    }

ホスト処理系とターゲット処理系が違う場合はその双方について上記のデータがあれば、何とかなるでしょう。

こうして並べてみると、チェックすべきことがずいぶんたくさんありますね。しかし、多くの処理系では移植ずみの処理系と共通の特性が多いでしょうから、一応動作するだけの移植であればさほどの手間ではないはずです。比較的手間のかかるのは実行時オプションと #pragma、さらに規格外仕様の実装です。これは一応動作するようになってから、徐々にやってゆくこともできます。唯一面倒なのは、処理系のバグにひっかかった場合です。

## 5.7. 検証セットによる他の処理系のテスト報告を

私が持っている処理系のプリプロセッサを私の検証セットでテストした結果は、cpp-test.html#6 にまとめてあります。
その他の処理系についてテストした結果をお知らせください。項目が多いのでかなりの手間ですが。
`cpp_test.c` によるテストであれば手間はかからないので、これだけでもお願いします。GCC の場合は、検証セットによる自動テストができます。

## 5.8. 改善のご意見を

バグ報告のほかにも、mcpp の使い勝手、診断メッセージ、mcpp のソース、Validation Suite、私の Standard C 解釈、ドキュメントの書き方、などについてご意見をお寄せください。
趣味で作ったプリプロセッサですが、V.2.0 までだけでも６年半もかけて凝りに凝った労作です。凝りついでにできるだけ良いものにしたいと思っています。Ｃプリプロセッサについては、私の持っていない処理系への移植とテスト以外は、やって意味のあることはほとんどすべてやったつもりです。多少とも問題が残っていれば、手を入れたいと思います。
Martin Minow のソースはとてもきれいな、クセのない、わかりやすいもので、これを読むだけでも私にとってはずいぶん勉強になりました。
こういうものに興味を持つ人はかなり限られていると思いますが、多くのコメントと情報をお待ちしています。
ご意見と情報は

http://mcpp.sourceforge.net/

の "Open Discussion Forum" またはメールでお願いします。

# 6. mcpp の長い道のり

## 6.1. 構想３日、制作６年

1992/01 に DECUS cpp をいじりだした時には、 こんな長丁場になるとは夢にも思いませんでした。正月休みにちょこっとバージョンアップしてみようと思っただけだったのです。
やり始めて、ソースをちゃんと読まないとダメだとわかり、２か月くらいかけて読みました。読みがいのあるソースだったからでもあります。次にいくつかの仕様を C90 対応にバージョンアップしました。ここまでは当初の目的の通りでした。

しかし、ここで私は自分が C90 のプリプロセス仕様を正確には知っていないことに気付きました。P. J. Plauger & Jim Brodie "Standard C" (1989) を読んだところ、function-like マクロの展開方法は、私の先入見をひっくり返すものでした（ある邦訳書はここを誤訳していたが）。そこで規格書を買って、プリプロセスに関する難解な文章をくり返し読みました。その結果、C90 のプリプロセスは伝統的なものとは多くの点で異なっていることがわかりました。#, ## 演算子が追加されたことは、そのほんの一部分にすぎなかったのです。

ことに function-like マクロの展開ルーチンにはかなり頭を悩ましました。E. Ream の cpp のソースを参考に２〜３週間考えて、C90 用マクロ展開ルーチンを新しく書きました。私がプログラムのアルゴリズムでこんなに一生懸命考えたのは、後にも先にもないことです。1992/04 のことでした。

さて、これで峠を越して、今度こそ cpp いじりはおしまいだと思ったのですが、ところがそれからさらに６年あまりたってしまいました。といっても、この間にはさほど頭を悩ます問題はなかったのです。にもかかわらず、時間はずいぶんかかりました。考えるだけ考えたら飽きてきて、cpp いじりに集中しなくなったせいもあります。しかし、それだけではありません。この間にやったのは次のようなことです。

1. 仕様をさらに明確にする。Standard モードでは規格に完全に対応させる。
2. Standard C のモードを中心にプログラム構造・データ構造を再構成する。
3. Portability を上げるため、ソースのスタイルを変える。
4. デバッグをする。 処理系のバグや不備に対処する。
5. テストプログラムすなわち Validation Suite を作る。
6. 他の処理系のテストをする。
7. ドキュメントを書く。
8. 1997/07 には新しいパソコンを買ったため、初めて使う WindowsNT/95,X Window System とそのソフトのインストールと習得に追われた。そうしているうちに C99-1997/11 draft が出て、これへの対応が必要となった。

中でも時間のかかったのはドキュメントでした。ことに後半の４年くらいはソースをいじった時間はほんの少しで、ドキュメント書きが作業の大半を占めていました。おかげで大変な分量になってしまいましたが、しかし、時間がかかったのは量が多いせいばかりではありません。ドキュメントを書いていると、仕様の不明確なところが次々と出てくるのです。そのたびに規格書を読み返し、ソースを少しずついじりました。ソースをいじった時間は少なくても、回数は少なくありません。規格書もプリプロセス規定だけではなく、全体を ANSI C の Rationale も含めてよく読んでみました。私はプリプロセッサを作ることを通して C90 の勉強をしたようなものです。さらにはこれを通して、C90 の規定の問題点も明確に把握することができました。

テストプログラムは初めは簡単なサンプルを何本か書いただけでした。ところが、書いて cpp をテストするたびに意外なバグが見つかるのです。そこで、C90 プリプロセスの全規定をテストする Validation Suite を書くことにしました。そして、Valadation Suite を書くことを通して、C90 の問題点がさらに明らかになってきました。C90 の不規則な部分に対応するのは、自分にとってはわずらわしいばかりであまり意味のないことでしたが、それよりも意味のある部分のほうがはるかに多かったことは確かです。
この作業を通して私が学んだのは、次のようなことです。

1. プログラムの仕様は、詳細なドキュメントを書き終えるまで確定しない。
2. プログラムのデバッグは、全仕様をテストするサンプルが完成するまで終わらない。

この考え方は完全主義的なものです。 世の中のことは完全主義ではうまくゆかないものが多く、プログラムも例外ではありませんが、中には完全主義が重要な意味を持つ分野もあります。言語処理系はその一つでしょう。
趣味だから何年もかけて徹底的にやることができたとも言えます。それにしても６年半は長すぎました。こんなに時間をかけて完全なプログラムを作って、いったいだれが使うのだろうという疑問がずっと続いていました。趣味で作るプログラムとしては、このくらいが規模の限度なのでしょう。

しかし、mcpp はもう作ってしまったので、今後もメンテナンスをしていくつもりです。せっかくですから皆さん、コメント、報告、移植をお願いします。

## 6.2. V.2.3 へ

V.2.0 を公開した後、さらに V.2.1, V.2.2, V.2.3 と update を繰り返しました。C99 や正式に承認された ISO / C++ に対応させたり、対応処理系を増やしたり、バグをとったりというのがその内容です。

V.2.2 までは簡単に update できていました。V.2.2 は V.2.0 から３か月しかたっていません。ところが、V.2.3 は V.2.2 から４年あまりもたってしまいました。私の身辺が多忙になり、時間がとれなくなったのが主な原因です。2000/07 に 60 歳になって、仕事を週４日に減らしてから、いくらか時間がとれるようになり、cpp いじりに復帰しました。

V.2.3 は時間だけでなく、手間も比較的かかっています。GCC V.2.9x に実装してみたところ、GCC / cpp との互換性確保のためにかなり手を加えなければならないことがわかったからです。多くのオプションを追加し、拡張仕様を実装しました。また、一部のエラーをウォーニングに格下げしたり、頻発するウォーニングをデフォルトのウォーニングクラスからはずしたりして、規格による制限を緩和しています。

こうした変更の多くは後向きのものであり、楽しいものではありませんでした。ことに C90 以前の "traditional" な仕様の一部を C99 の仕様と両立させなければならないというのは、はなはだ不本意なことでした。しかし、これが現在のオープンソース界の実情であれば、それにある程度合わせるのはやむをえません。
規格による制約を緩和したことで、他の処理系用の版も、処理系付属のプリプロセッサと置き換えて使うためには使いやすくなったと思います。

## 6.3. 「未踏ソフトウェア創造事業」に採択

V.2.3 への update の途中で、mcpp および Validation Suite は情報処理振興事業協会 (IPA) の平成１４年度「未踏ソフトウェア創造事業」というものに採択されました。たまたまこの事業のことを知ったので応募してみたところ、新部 裕・プロジェクトマネージャが採択してくれたのです。こうして 2002/07 から 2003/02 までは IPA の資金援助と新部ＰＭの助言のもとに、開発が進められることになりました。ドキュメントの英訳も、ハイウェルが引き受けてくれることになりました

比較的小さいソフトウェアながらも、これだけ時間をかけ、私のライフワークのようになってしまったものです。その完成度には自信がありましたが、世に出る機会がなく、残念な思いをしてきました。その機会がついに与えられたのです。私はこのプロジェクトを遂行するため、仕事を週３日に減らしました。
私がこのプロジェクトでやることとして考えたのは、次のようなことでした。

1. 英語版のドキュメントを作成する。それを使って、mcpp と検証セットを国際的な評価の場に出してゆく。Ｃ処理系の大半が外国製となっている現状では、英語版ドキュメントの存在は評価と普及のために必須だからである。
2. 移植の対象を広げる。これまで対応してきた処理系の新しいバージョンに対応させるほか、市販の主要な処理系への移植を進める。

さらに新部 PM から次の提案がありました。

1. GCC 3.x にも移植し、さらにその testsuite で私の検証セットが利用できるようにする。
2. 開発をオープンな形で進めてゆく。 開発とその成果を共有しやすいように、標準的なやり方を採用する。

私自身もこれらはぜひやりたいことであるので、喜んで計画に追加しました。
ところが、私の計画は遅延に遅延を重ねました。 まず、ディスククラッシュに見舞われました。また、何か新しいことをするたびに使ったことのないソフトウェアを使って、そのたびに時間がかかりました。GCC をソースからコンパイルしたのも初めてですが、これはいくつかのトラブルに見舞われました。大量のドキュメントの更新と大量の英訳のチェックと修正にも、かなりの時間がかかりました。その上、母の入院という事態まで発生しました。プロジェクトは市販の処理系への対応等、計画の一部を断念する結果となりました。

私はこれまで一つの穴を深く掘ってゆくようなことしかしてこなかったので、穴を少し広げようとするとひどく手間がかかってしまうのです。アマチュアプログラマが何かを掘り下げるには、こういうやり方をしなければできることではありません。しかし、その成果を世に出すためには、穴をいくらか広げなければならないのでした。
穴を広げる過程で、私は新部 PM の助言と励ましを得て、いくつかの未経験のソフトウェアを習得し、開発の前線というものに触れることができました。自分の文章がこなれた英文に翻訳されて戻ってくるのも、大変うれしいことでした。時間に追われるのは苦しいことですが、内容はどれも新鮮で楽しいことでした。

「未踏ソフトウェア創造事業」はこれでおしまいではありませんでした。平成１５年度にも、伊知地 宏・プロジェクトマネージャが mcpp を継続プロジェクトとして採択してくれたのです。こうして、前年度の積み残しの課題を初めとして、私にとっては未経験の領域のいくつかの課題に取り組むこととなりました。

今回も私の６年前のパソコンにトラブルが発生し、ハードウェアと OS を upgrade する過程でさらにいくつかのトラブルに見舞われました。未経験のソフトウェアの習得にも時間を要し、開発はやはり遅れ気味でした。いったん退院して比較的元気になっていた母の容態が、プロジェクトが大詰めに近づくのと並行して以前にも増して悪くなってきたことも、心配の種でした（母は 2004 年 2 月に死去した）。しかし、伊知地ＰＭが目標を無理のないところに設定してくれたおかげで、あわてずにじっくりと課題に取り組むことができました。

Visual C++ への移植、configure スクリプトの作成、多様な multi-byte character encoding への対応等の課題を達成することができました。また、ソースコードの整理という目立たないながらも作者としてはこだわりのある課題にも取り組みました。日本語版と英語版のドキュメントの更新という手間のかかる作業も、ハイウェルの協力を得て達成することができました。

この成果によって、私は伊知地ＰＭから何と「スーパークリエータ」という評価を受けることができました。私の実力にとっては過分の評価ですが、長年にわたる mcpp の積み重ねを認めていただいたものと思い、大変喜んでいます。

２年近くにわたる「未踏ソフトウェア」のプロジェクトによって、mcpp は世界一高品質な C/C++ プリプロセッサに仕上がったつもりです。熟年のアマチュアプログラマとして非力ながらもよくやったと自分では納得しています。

未踏ソフトウェアのプロジェクトが終わってからも、mcpp の改良作業は続けられています。まだいくつかの課題が残っています。これらの課題を達成し、mcpp を普及させるために、今後も着実に取り組みを続けてゆくつもりです。