これは、Ubuntu Online、Fedora Online、Windows オンライン エミュレータ、MAC OS オンライン エミュレータなどの複数の無料オンライン ワークステーションの XNUMX つを使用して、OnWorks の無料ホスティング プロバイダで実行できるコマンド lexgrog です。
プログラム:
NAME
lexgrog - マニュアルページのヘッダー情報を解析します
SYNOPSIS
レックスグロッグ [-m|-c] [-dfw?V] [-E エンコーディング] file ...
DESCRIPTION
レックスグロッグ 従来の「groffguess」ユーティリティの実装です。 LEX。 こう書かれています
コマンドライン上のファイルのリスト (マニュアルページのソースファイルまたはフォーマット済みのファイルのいずれか)
「cat」ページ。 で使用される名前と説明が表示されます。 ところで & whatis
マニュアルページが渡される前に必要な前処理フィルターのリスト ンロフ or
troff、 または両方。
入力の形式が正しくない場合、 レックスグロッグ 「解析に失敗しました」と表示されます。 これは役に立つかもしれません
マニュアルページが正しいかどうかをチェックする必要がある外部プログラム。 のいずれかであれば、 レックスグロッグさんの入力
files が「-」の場合、標準入力から読み取ります。 入力ファイルが圧縮されている場合、
解凍されたバージョンは自動的に読み込まれます。
OPTIONS
-d, - デバッグ
デバッグ情報を出力します。
-m, - 男
入力をマニュアルページのソースファイルとして解析します。 どちらでもない場合、これがデフォルトです - 男 また
- 猫 与えられます。
-c, - 猫
入力をフォーマット済みのマニュアル ページ (「猫ページ」) として解析します。 - 男 & - 猫 じゃないかもしれない
同時に与えられます。
-w, - とは
で使用される、マニュアルページのヘッダーの名前と説明を表示します。 ところで &
whatis。 どちらでもない場合、これがデフォルトです - とは また --フィルター 与えられます。
-f, --フィルター
マニュアルページをフォーマットする前に前処理するために必要なフィルタのリストを表示します。
ンロフ or troff.
-E エンコーディング, - エンコーディング エンコーディング
ページの推測された文字セットを上書きして、 エンコーディング.
-?, - 助けて
ヘルプメッセージを印刷して終了します。
- 利用方法
短い使用法メッセージを印刷して終了します。
-V, - バージョン
バージョン情報を表示します。
EXIT ステータス
0 プログラムの実行が成功しました。
1 使用法エラー。
2 レックスグロッグ XNUMX つ以上の入力ファイルの解析に失敗しました。
例
$ レックスグロッグマン.1
man.1: 「man - オンラインリファレンスマニュアルへのインターフェース」
$ lexgrog -fw man.1
man.1 (t): "man - オンライン リファレンス マニュアルへのインターフェイス"
$ lexgrog -c whatis.cat1
whatis.cat1: "whatis - マニュアルページの説明を表示"
$ lexgrog が壊れました.1
壊れた.1: 解析に失敗しました
とは 構文解析
マンドブ (以下と同じコードを使用します) レックスグロッグ) を解析します NAME それぞれの上部のセクション
マニュアルページで、それぞれに文書化されている機能の名前と説明を探します。 その間
パーサーは、さまざまな形式に対応する必要があるため、非常に寛容です。
歴史的に使用されてきたため、必要な情報を抽出できない場合があります。
従来のものを使用する場合 man マクロセット、正しい NAME セクションは次のようになります
この:
.SH 名
foo \- 何かを行うプログラム
一部の手動ページャーでは、「\-」を表示どおりにする必要があります。 マンドブ より寛容ですが、
他のシステムとの互換性を確保するために、
バックスラッシュ。
左側には、カンマで区切られて複数の名前が表示される場合があります。 を含む名前
特定の不正な形式での病的な動作を避けるために、空白は無視されます。 NAME
セクション。 右側のテキストは自由形式であり、複数にまたがる場合があります。
線。 異なる説明を持つ複数の機能が同じ文書に文書化されている場合
したがって、マニュアル ページでは次の形式が使用されます。
.SH 名
foo, bar \- 何かを行うプログラム
.br
baz \- 何もしないプログラム
(新しい段落を開始するマクロ (.PP など) をブレーク マクロの代わりに使用できます。
.br.)
BSD由来のものを使用する場合 mdoc マクロセット、正しい NAME セクションは次のようになります
この:
.Sh 名前
.Nm フー
何かをするための .Nd プログラム
whatis の解析が失敗する一般的な理由はいくつかあります。 場合によってはマニュアルの作成者
ページでは「.SH NAME」を「.SH MYPROGRAM」に置き換えてから、 マンドブ からのセクションが見つかりません
必要な情報を抽出するためのものです。 著者が NAME セクションを含めることもありますが、
「名前 \- 説明」ではなく、自由形式のテキストをそこに配置します。 ただし、どのような構文であっても、
上記に似ているものは受け入れられるはずです。
onworks.net サービスを使用してオンラインで lexgrog を使用する