"src28"の使い方の説明                      2002/08/29 川合秀実

１．これは何か？

  "src28"は、OSASK ver.2.8の「OSASK28.EXE」を生成するのに必要なモジュールのソー
スプログラムのセットです。ただし、以前のバージョンのものをそのまま利用している
ものついては、このアーカイブに含まれていません。OSASK28.EXEを生成するのに必要な
モジュールのバージョンを書いておきます。

  (このアーカイブ内に含まれているもの)

    PIONEER0.BIN : ver.2.5
    INIT.ASK     : ver.2.6
    WINMAN0.BIN  : ver.2.2
    POKON0.BIN   : ver.2.8

    PCAT/
      VGADRV0.BIN  : ver.1.6

    TOWNS/
      VGADRV0.BIN  : ver.1.6

    NEC98/
      BASE.EXE     : ver.2.1
      VGADRV0.BIN  : ver.1.6
      TIMERDRV.BIN : type-A ver.1.1
      KEYMOS0.BIN  : ver.0.4
      DECODE0.BIN  : ver.1.0
      FDCDRV0.BIN  : ver.1.6

  (以前のバージョンのものを利用するもの)

    OSASKINC.ASK : ver.0.0
    TAPI0.BIN    : ver.0.4
    PAPI0.BIN    : ver.0.6
    OSALINK0.OPT : ver.1.9
    SYSGG00.LIB  : ver.0.8

    PCAT/ および TOWNS/
      BASE.EXE     : ver.2.1
      TIMERDRV.BIN : type-A ver.1.1
      KEYMOS0.BIN  : ver.0.4
      DECODE0.BIN  : ver.1.0
      FDCDRV0.BIN  : ver.1.6

  このバージョンナンバーは完成度と比例しません。改定が行われるたびに増加してい
るだけです。

２．コンパイル＆アセンブル方法

  使用したアセンブラ、コンパイラ、コンバータ、ライブラリは以下の通りです。

・aska10b19 (ASKA version 1.0 beta 19 Modified by RisaPapa)
・naskset0  (NASK ver.0.0 + naskcnv0 + osalink0)
・introa09  (obj2bim2 + bim2bin2 + gg00lib9 + stdlib6)
・lcc-win32 (LCC.EXEのタイムスタンプ2002/06/09、サイズ532,000バイト)

OSASKの開発者向けページに、lcc以外の全てのツールが公開されています。lccについて
は、introa09のドキュメントにしたがって入手してください。

  BASE.EXEの生成は、以下のように行います。

>nask base.nas base.exe base.lst

  SYSGG00.LIBの生成は、MAKEFILEで行いました。MAKEFILEを読んでコンパイル・アセン
ブル手順を把握してください。SYSGG00.LIBは、WINMAN0.BINとPOKON0.BINの生成のみに
必要な専用ライブラリです。

  拡張子が.ASKのものは、lcc-win32→ASKA→naskcnv0→NASKで.BINファイルにします。
naskcnv0のオプション指定では、-lと-sを指定します。lcc-win32はプリプロセッサとし
て使います。オプション-EPを付けてください。ただしAT互換機版を生成する時は、LCC
に「-DPCAT」オプションをつけてください。またTOWNS版を生成する時は、LCCに「-DTO
WNS」オプションをつけてください。またウィンドウデザインを指定するために「-DWIN
9X」「-DTMENU」「-DCHO_OSASK」「-DNEWSTYLE」「-DWIN31」のいずれかも併せて指定し
ます。以下は一例です。

>lcc -EP -DPCAT -DWIN9X init.ask
>aska init.i init.3as
>naskcnv0 -l -s init.3as init.nas
>nask init.nas init.bin init.lst

（このinitの部分を置き換えれば他のソースも同様にアセンブルできます）

  拡張子が.Cのものは、linkset3で説明されている方法で生成できます。ただし、AT互
換機版を生成する時は、LCCに「-DPCAT」オプションをつけてください。またTOWNS版を
生成する時は、LCCに「-DTOWNS」オプションをつけてください。98版は「-DNEC98」です
。またここでもウィンドウデザインに関するオプションが必要です。ライブラリーにSYS
GG00を使う必要があることにも注意してください。指定すべきスタックサイズ、malloc
サイズは、各ソース中の最初の方に明記してあります。

  OSALINK0.OPTに書かれている全てのファイルが用意できたら、osalnk0pでそれらをま
とめて、OSASK.EXEを生成できます。osalnk0pの使い方は、osalnk0p内のアーカイブを参
照してください。

  またVMware対応バイナリを生成する場合は、-DPCATに加えて-DVMWAREを指定してくだ
さい。

  Bochs 1.3対応バイナリを生成する場合は、-DPCATに加えて-DBOCHSを指定した上に、
base.nasを以下の指示にしたがって書き換える必要があります。

・86〜87行目のセミコロンだけを削除する（.fromdos:の直後の2行）。
・284行目の(セミコロンの前の)0を1に変更する（to_winman0の初期値）。

  Bochs 1.2.1対応バイナリを生成する場合は、-DPCATに加えて-DBOCHSと-DNOHLTを指定
した上に、base.nasをBochs 1.3と同様に書き換えてください。

３．説明＆注意点

  これらのソースは、単にOSASKを改良するためだけではなく、他のOSのために利用した
り、その他の目的に利用することを認めています。詳しい利用範囲はLICENSE.TXTを参照
してください。

  これらのソースの大半は、全く清書されていません。註釈がついているものもありま
すが、意味の無い註釈だったり、バージョンアップの過程でコードが削除されたのに註
釈だけ残ったものなどがあり、はっきりいってあてになりません。

  このソースを公開することにしたのは、「バイナリだけよりはマシだろう」というひ
どいセンスによるものです。読みにくくてほとんど役に立たないかもしれません。大変
申し訳ないです。どなたかが著作者に代わって清書してくれるのは大歓迎です。

  何か疑問に感じられることがあれば、OSASK-MLにメールでご連絡ください(OSASK伝言
板でもかまいません)。すぐにはお返事できないかもしれませんが、できるだけお答えし
ます。川合秀実にメールすることもできますが、基本的に個人メールでなければいけな
い理由がなければ、OSASK-MLかOSASK伝言板の利用をお願いします。

４．謝辞

  このアーカイブは、各著作者が川合堂ライセンス-01の適用に快く応じていただけたこ
とで公開することができました。この場を借りて、心からお礼申し上げます。

５．著作権

  著作権については、該当するOSASKの一般公開版に付属するCOPYRIGHT.TXTを参照して
ください。このアーカイブないの全てのファイルに対して川合堂ライセンス-01を適用し
ます。

６．リンク

  このドキュメントに関係のあるいくつかのURLを挙げておきます。

    OSASKの開発者向けページ   http://www.imasy.org/~kawai/osask/developers.html
    小柳さんのOSASKのページ   http://homepage1.nifty.com/dreaming/osask/
    OSASKのページ             http://www.imasy.org/~kawai/osask/
    OSASK伝言板               http://www.imasy.org/~mone/osask/index.cgi
    川合秀実のページ          http://www.imasy.org/~kawai/
