FM Towns: Free Software Collection 1/FREEWARE.BIN/ms_dos/larc/referenc.man

Text File | 1989-10-17 | 22KB | 727 lines

LARC Ver3.32                                             REFERENCE GUIDE


________________________________________________________________________

                        ＬＡＲＣ　Ｖｅｒ３．３２

                     圧縮機能付きファイル管理ソフト

                          リファレンス・ガイド
________________________________________________________________________










●用語 ............................................................    1

●動作環境 ........................................................    2

●制限 ............................................................    3

●変数 ............................................................    4

●文法通則 ........................................................    5

●命令モード ......................................................    6

●対話モード ......................................................    7

●命令 ............................................................    8

●スイッチ ........................................................    9

●命令／スイッチ対応表 ............................................   10











                        １９８９年２月１２（月）

                        三木和彦(NIFTY SDI00147)

      連絡先 : NIFTY(ﾌｫｰﾗﾑSDRの会議室)及びPC-VAN(SIGｻｲｴﾝｽのﾌｫｰﾗﾑ)










LARC Ver3.32                                             REFERENCE GUIDE


●用語



　このリファレンス・ガイドで特有の用語を次に説明する。なお、カレント・デ
ィレクトリ等の一般用語については、市販のＭＳ－ＤＯＳの解説書、或は、ＮＩ
ＦＴＹ－ＳＤＲのライブラリに掲載している「超入門ＭＳ－ＤＯＳ」を参照され
たい。


________________________________________________________________________

◆書庫ファイル　　　　拡張子がＬＺＳであるファイルの総称

◆自己解凍ファイル　　拡張子がＣＯＭあるいはＥＸＥであるファイルで、実行
                      するだけで自動的に必要なファイルが産み出されるファ
                      イルの総称

◆凍結ファイル　　　　書庫ファイルに冷凍されているファイルの総称

◆対象ファイル　　　　作業をする場合の対象ファイルの総称であり、凍結ファ
                      イルとディスク上ファイルの２種類がある

◆オーバレイファイル　ＬＡＲＣ＊．ＯＶＲという名称のファイルで、ＬＡＲＣ．
                      ＥＸＥとともに実行に際して、必要不可欠なファイル

◆作業ファイル　　　　ＬＡＲＣが必要に応じて作成する作業用のファイルの総
                      称で、終了と同時に削除される

◆ＶＭＡファイル　　　バージョン管理情報を含んでいるテキストファイル

◆冷凍　　　　　　　　ファイルを圧縮しつつ書庫ファイルに保存すること

◆解凍　　　　　　　　書庫ファイルから必要な凍結ファイルを抽出すること

◆Ｖバージョン　　　　バージョン管理用の番号であり、数字が大きい程新しい
                      バージョンとなる

◆テロップファイル　　自己解凍する前に出力されるテキストファイル
________________________________________________________________________


















                                  - 1 -




LARC Ver3.32                                             REFERENCE GUIDE


●動作環境



________________________________________________________________________

◆機種等　　　　　　　ＯＳはＭＳ－ＤＯＳ　Ｖｅｒ２．１１以上。シェルはＣ
                      ＯＭＭＡＮＤ．ＣＯＭ、もしくはＡＤＣＯＭ．ＥＸＥ Ｖ
                      ｅｒ２．１７以上

◆必要メモリ 　　　　 プログラムが走行する以外に、ファイル名の取得などの
                      ための作業領域として、ファイル数に応じた変動するメ
                      モリ領域がさらに必要となる。通常の使用では、１５０
                      Ｋバイト程度のメモリがあれば充分であろう。なお、コ
                      ード、オーバレイ、データ、スタック、ヒープ領域につ
                      いてはＨ命令で、その大きさを表示している

◆画面　　　　　　　　行数については、８０桁、２４行の画面構成を標準にし
                      ているが、スイッチや環境変数を利用することにより変
                      更できる

◆制御コード　　　　　使用している制御コードは次の３種類のみであり、互換
                      性が担保できないエスケープシーケンスは使用していな
                      い

                      　　０７　ブザーを約１秒鳴らす
                        　０８  カーソルを１文字左に移動する
                        　０Ａ　カーソルを１行下に移動する
                        　０Ｄ　カーソルを行頭へ

◆オーバレイパス　　　オーバレイファイルは次に示す順に探す。但し、ＬＡＲ
                      Ｃ．ＥＸＥのディレクトリはＭＳ－ＤＯＳ　Ｖｅｒ２．
                      ｘ以下の場合には探さない

                      　　カレントディレクトリ
                      　　　　　↓
                      　　ＬＡＲＣ．ＥＸＥのディレクトリ
                      　　　　　↓
                      　　環境変数ＰＡＴＨ

◆ファイルズ　　　　　オ－プンするファイルは最大５つなのであるが、ＣＯＮ
                      ＦＩＧ．ＳＹＳでＦＩＬＥＳの設定は２０程度にしてお
                      くのが望ましい
________________________________________________________________________



　ＭＳ－ＤＯＳが走る全てのパソコンでの動作可能を保証したいので、万が一動
作不良な場合に遭遇した場合には、是非、そのパソコン機種とＭＳ－ＤＯＳのバ
ージョンを連絡して頂きたい。








                                  - 2 -




LARC Ver3.32                                             REFERENCE GUIDE


●制限



________________________________________________________________________

◆ファイル数　　　　　コマンドライン上で、一度に指定できる対象ファイル（
                      ワイルドカードも可）数は最大４０。内部的に処理可能
                      なファイル数は１０２４であるが、ワーク処理としては
                      ２０４８まで対応している

◆Ｖバジージョン　　　バージョン管理書庫ファイルのＶバージョンの最大値は
                      ９９であり、それ以上の更新をしたい場合には、Ｍ命令
                      でバックアップファイルを一括削除しなければならない

◆対象ファイルの属性　対象ファイルの属性については、保存ビットと書込み禁
                      止ビット以外のビットが立っているファイルについては、
                      そのファイルの存在を認識しない

◆ｄスイッチの対象　　ＬＡＲＣ＊．ＯＶＲというファイル名については、その
                      ファイルはｄスイッチによる削除対象にはしない

◆スタック　　　　　　ソートと再帰的ファイル収集において再帰関数を使用し
                      ているが、スタックのオーバフローチェックはしていな
                      い
________________________________________________________________________
































                                  - 3 -




LARC Ver3.32                                             REFERENCE GUIDE


●変数



________________________________________________________________________

◆環境変数　　　　　　環境変数としては、オ－バレイファイルを探索するＰＡ
                      ＴＨとスイッチを指定するＬＡＲＣがある。なお、スイ
                      ッチの優先順位はコマンドラインの方を優先し、ＬＡＲ
                      Ｃ変数での複数のスイッチを指定するには、／等のパラ
                      メ－タスイッチを前置した各スイッチを、スペ－ス等で
                      分離せず連続して指定する

◆作業ファイル名　　　以下のように定めており、これらのファイル名の変更は
                      できない

                      ＬＺＳＳ＿ＴＭＰ．）１（
                            ファイルを冷凍する際に、いったんこの作業ファ
                            イルに圧縮コードを出力する

                      ＬＺＳＳ＿ＴＭＰ．）２（
                            書庫ファイルを更新する際に、新しい書庫ファイ
                            ルを、いったんこの作業ファイルに出力する。ま
                            た、自己解凍ファイルの中間ファイルとしても使
                            用する

                      ＬＺＳＳ＿ＴＭＰ．）３（
                            新規に書庫ファイルを作成する場合に、内部的に
                            このファイルを書庫ファイル名として扱う

◆作業ファイルのパス　作業ファイルを作成するパスであり、ｗスイッチで指定
                      しない場合には、カレントパスを仮定する。

◆頁行数　　　　　　　リストの出力においてページ管理を行っているが、その
                      １ページ当りの行数である。指定しない場合には２０行
                      と仮定する

◆ＶＭＡファイル名　　無指定の場合には、ＭＡＫＥＦＩＬＥと仮定する

◆テロップファイル名　無指定の場合には、ＡＵＴＯＬＡＲＣ．ＤＯＣと仮定す
                      る
________________________________________________________________________
















                                  - 4 -




LARC Ver3.32                                             REFERENCE GUIDE


●文法通則



________________________________________________________________________

◆モ－ド　　　　　　　命令モードと対話モードがあり、引数が少ない時など必
                      要に応じ、対話モードへ移行する

◆命令　　　　　　　　命令として有効なものは、Ａ、Ｆ、Ｄ、Ｅ、Ｐ、Ｌ、Ｓ、
                      Ｈ、Ｉ、Ｏ、Ｖ、Ｍ、Ｒの１２種類あり、その内の１つ
                      のみを指定できる

◆スイッチ　　　　　　スイッチとして有効なものは、ｘ、ｄ、ｍ、ｃ、ｖ、ｗ、
                      ａ、ｌ、ｅ、ｎ、ｏの１２種類であり、それらは複数指
                      定できる。なお、重複して指定した場合には、最後に指
                      定したものが有効となる。また、スイッチの前に－を置
                      くとそのスイッチ機能を抑制する

◆ワイルドカード　　　書庫及び対象ファイルの指定においてはワイルドカード
                      が使用できる

◆冷凍不可能ファイル　ファイル属性がシステム、隠し、ボリューム、ディレク
                      トリのファイル、又は、作業対象の書庫ファイルそのも
                      のは冷凍しない

◆ファイル属性　　　　日付、時間とともに、保存ビット、書込み禁止ビットの
                      ファイル属性を復活する

◆パス名　　　　　　　パス名を指定した場合には、そのパス名（相対パスの場
                      合には相対パスのまま）も含めて冷凍する
________________________________________________________________________


























                                  - 5 -




LARC Ver3.32                                             REFERENCE GUIDE


●命令モード



　命令モードとは、コマンドライン上で必要な引数を指定して実行するモードで
あるが、省略不可能な引数が指定されていない場合には自動的に対話モードに入
る。なお、Ｉ、Ｏ、Ｖ命令では、第三引数は無く第二引数はＶＭＡファイルとな
るが、省略時にはＭＡＫＥＦＩＬＥと仮定するので、対話モードへの移行は無い。
また、スイッチはコマンドライン上なら、どこにでも指定できる。

        A>larc command [/[-]switch] [archive] [sources [source..]]

        　　　第一引数　command　　命令
        　　　第二引数　archive  　書庫ファイル（ＶＭＡファイル）
        　　　第三引数　source     対象ファイル

________________________________________________________________________

◆書庫ファイルの指定　指定できるものは、ディレクトリ、ドライブ、パス名で
                      ありワイルドカードの使用も可能である。ディレクトリ、
                      ドライブ、ワイルドカードの場合には、対話モードに一
                      時的に入り当該書庫ファイルを選択しなければならない。
                      拡張子を指定しない場合にはＬＺＳと仮定し、また、Ｌ
                      ＺＳ以外の拡張子は無効である。

◆ＶＭＡファイル　　　ＶＭＡファイルとは、書庫ファイル、対象ファイルを指
                      定するテキストファイルである。テキストファイルでの
                      指定方法は行頭を＃＃とし、その後ろに書庫ファイル、
                      対象ファイルの順に空白、タブで区切って指定する。な
                      お、行頭が＃＃でない行はコメント行となる。

◆対象ファイルの指定　１つ以上のファイル指定が可能であるが、特例として、
                      対象ファイルの指定が一つだけの場合には、ドライブ、
                      ディレクトリの指定ができ、そこにあるファイル一覧を
                      表示して、対話モードに移行する。Ｅ、Ｆ、Ｌ、Ｓ命令
                      では、対象ファイルの指定を省略でき、この場合には、
                      書庫ファイルの凍結ファイルをすべて指定したものと仮
                      定する。

                      ワイルドカードの探索対象は、Ａ命令の場合にはディス
                      クであり、Ｆ、Ｅ、Ｄ、Ｐ、Ｌ、Ｓ命令の場合には対象
                      書庫ファイルである。Ａ命令においてもパス名の前にＬ
                      Ｚ：を付加することによりワイルドカードの対象領域を
                      書庫ファイルに切り替えることができる。なお、書庫フ
                      ァイルが対象ファイルの場合のワイルドカードは、ディ
                      レクトリ＋ファイル名と拡張子でそれぞれ＊を一回使用
                      できることがＭＳ－ＤＯＳの仕様と大きく異なっている。
________________________________________________________________________










                                  - 6 -




LARC Ver3.32                                             REFERENCE GUIDE


●対話モード



　コマンドライン上のパラメ－タ無く起動すると、後は問い合わせに応えて行く
だけで、目的の動作に達する。




________________________________________________________________________

◆命令　　　　　　　　選択キーで選択するか、直接、命令を入力する。また、
                      コマンドの後ろに／などとスイッチキャラクタを付ける
                      と、次のスイッチ入力モードに移行する。なお、対話モ
                      ードではバージョン管理命令は使用はできない

◆スイッチ　　　　　　このモードでは、選択キーによるモードは無く、直接入
                      力しなければならない。また、改行キーのみを入力する
                      と次のモードに移行する。

◆書庫ファイル　　　　対象ディレクトリにある書庫ファイル一覧とサブディレ
                      クトリを表示するので、選択キーで書庫ファイルを選択
                      するか、あるいは直接書庫ファイル名を入力する。

◆対象ファイル　　　　書庫ファイルとほぼ同じ選択方法であるが、複数の対象
                      ファイルを指定できるので、終了時にはＥＳＣキーで中
                      止するか、ＬＺ：￥＊．＊を入力しなければならない。
________________________________________________________________________


               上記入力時の有効なキーは以下のものである。

        ________________________________________________________

        ◆スペース　    次を選択する
        ◆＾Ｘ　        同上
        ◆＾Ｅ　 　　 　前を選択する
        ◆リターン　    選択したものを確定する
        ◆ＥＳＣ　      入力を中止する
        ◆ＢＳ　        バックスペース
        ◆その他のキー　通常の入力モードとなる
        ________________________________________________________


また、ディレクトリを移動したい場合には、該当ディレクトリを選択するか、直
接入力する。元のディレクトリに戻るには、　．　を入力する。











                                  - 7 -




LARC Ver3.32                                             REFERENCE GUIDE


●命令



________________________________________________________________________

◆Ａ  add　　　　　　 対象ファイルを書庫ファイルに冷凍する。冷凍に失敗し
                      た場合には更新しない。同名のファイルが既に冷凍され
                      ている場合の動作はｃスイッチによる

◆Ｆ　fresh 　　　　　対象ファイルが書庫ファイルにあることを前提にする以
                      外はＡ命令と同じ動作をする

◆Ｄ　delete　　　　　書庫ファイルから凍結ファイルを削除する

◆Ｅ　extract　　　　 書庫ファイルから凍結ファイルを解凍する。既にディス
                      ク上にファイルがある場合の動作はｃスイッチによる

◆Ｐ　print　　　　　 書庫ファイルから凍結ファイルを解凍し、標準出力に出
                      す

◆Ｌ　list　　　　　　書庫ファイルにある凍結ファイルのリストを表示する

◆Ｓ　self extract　　凍結ファイルを抽出し、自己解凍ルーチンを付け加えて、
                      自己解凍ファイルを作成する。６４Ｋバイト未満の場合
                      にはＣＯＭファイル、６４Ｋバイト以上の場合にはＥＸ
                      Ｅファイルとなり、また、自動実行、テロップ機能も付
                      加することが可能である

◆Ｈ　help　　　　　　簡易ヘルプ画面の表示

◆Ｉ　in　　　　　　　バージョン管理命令。ＶＭＡファイルを参照し、バック
                      アップファイルを書庫ファイル内に作成する以外はＡ命
                      令とほぼ同じ動作をする

◆Ｏ　out 　　　　　　バージョン管理命令。ＶＭＡファイルを参照する以外は
                      ｘスイッチ付きのＥ命令とほぼ同じ動作をする

◆Ｍ　move　　　　　　バージョン管理命令。ＶＭＡファイルを参照し、バック
                      アップファイルを書庫からすべて削除する

◆Ｖ　version　　　　 バージョン管理命令。ＶＭＡファイルを参照する以外は
                      Ｌ命令とほぼ同じ動作をする
________________________________________________________________________














                                  - 8 -




LARC Ver3.32                                             REFERENCE GUIDE


●スイッチ



________________________________________________________________________

◆ｒ　reflex　　　　　当該ディレクトリから下のディレクトリに向かって、一
                      致する対象ファイルをすべて対象とするものである

◆ｘ　path extract　　凍結ファイルを、その当該ディレクトリ（存在していな
                      い場合には作成する）に解凍する。なお、Ｏ命令では、
                      内部的にはｘスイッチが指定されているものとして作業
                      する

◆ｍ　no message　　　このスイッチを指定すると、注意喚起などのメッセージ
                      出力を抑制する

◆ｃ　no check time 　通常は、ディスク上のファイルと日時を照合し、解凍の
                      場合には同日時の場合、冷凍の場合には古い場合にはそ
                      の作業をパスするが、このスイッチを指定すると、その
                      比較をせず作業をする

◆ｄ　delete　　　　　冷凍作業の対象ファイルをディスク上から削除する。

◆ｖ　version　 　　　Ｖバージョンの指定をするが、、数字そのものを省略す
                      ると、最新のＶバージョンが指定されたものと仮定する。
                      なお、スイッチを指定しない場合には、Ｏ命令では最新、
                      Ｖ命令においては全てのＶバージョンと仮定する

◆ｗ　work path 　　　作業パスの指定をする

◆ｌ　screen line　　 ページ行数を指定する

◆ａ　autolarc.doc　　このスイッチに引き続いてファイル名を指定すると、そ
                      のファイルを自己解凍ファイルのデータ領域の先頭に置
                      く。自己解凍ファイルの実行においては、そのファイル
                      を画面に出力した上で、ＹまたＮのキー入力を待つ

◆ｅ　extract path　　このスイッチに引き続いてパス名を指定すると、ファイ
                      ルをその指定パスに作成する

◆ｎ　name only　　　 このスイッチを指定すると、Ａ命令では冷凍時にパス名
                      を付けずに凍結し、他の命令では書庫ファイルを対象と
                      するファイル名の指定においてパス名無しで指定できる。
                      このスイッチはＡＲＣなどの既存の書庫管理ソフトとの
                      互換性を担保するものである

◆ｏ　overwrite　　　 ディスク上のファイルに上書きする場合には、その確認
                      の入力を促すが、このスイッチを指定するとそれを抑制
                      する
________________________________________________________________________







                                  - 9 -




LARC Ver3.32                                             REFERENCE GUIDE


●命令／スイッチ対応表



スイッチと命令の有効関係は次の通りであり、無効な組み合せは単に無視するだ
けで動作上は問題ない。


          　　　　　　　　　　　スイッチ

          　　　｜　ｍ　ｗ　ｌ　ｅ　ｘ　ｃ　ｄ　ａ　ｒ　ｎ　ｏ　ｖ
          　　－－－－－－－－－－－－－－－－－－－－－－－－－－
          　　Ｈ｜　○　○　－　－　－　－　－　－　－　－　－　－
          　　　｜
          　　Ａ｜　○　○　－　－　－　○　○　－　○　○　－　－
          　　　｜
          　　Ｆ｜　○　○　－　－　－　○　○　－　－　○　－　－
          　　　｜
          　　Ｄ｜　○　○　－　－　－　－　－　－　－　○　－　－
          　　　｜
          命　Ｅ｜　○　○　－　○　○　○　－　－　－　○　○　－
          　　　｜
          　　Ｓ｜　○　○　－　○　－　－　－　○　－　○　○　－
          　　　｜
          令　Ｐ｜　○　○　－　－　－　－　－　－　－　○　－　－
          　　　｜
          　　Ｌ｜　○　○　○　－　－　－　－　－　－　○　－　－
          　　　｜
          　　Ｉ｜　○　○　－　－　－　○　○　－　－　－　－　－
          　　　｜
          　　Ｏ｜　○　○　－　－　－　○　－　－　－　－　○　○
          　　　｜
          　　Ｖ｜　○　○　○　－　－　－　－　－　－　－　－　○
          　　　｜
          　　Ｍ｜　○　○　－　－　－　－　－　－　－　－　－　－























                                  - 10 -