diff --git a/doc/os_haiku.jax b/doc/os_haiku.jax new file mode 100644 index 000000000..0c2760ab3 --- /dev/null +++ b/doc/os_haiku.jax @@ -0,0 +1,231 @@ +*os_haiku.txt* For Vim バージョン 8.2. Last change: 2020 Feb 26 + + + VIMリファレンスマニュアル by Bram Moolenaar + + + *Haiku* +このファイルは Haiku 版の Vim 特有の事柄に関して記述されています。このファイル +で説明されていない事項について、Vim の挙動は Unix |os_unix.txt| 版と非常に良く +似ています。 + +Haiku は BeOS に触発されたオープンソースのオペレーティングシステムで、明確に +パーソナルコンピューターをターゲットとしています。 + + 1. 全般 |haiku-general| + 2. Vim のコンパイル |haiku-compiling| + 3. Haiku の GUI |haiku-gui| + 4. $VIM ディレクトリ |haiku-vimdir| + 5. $BE_USER_SETTINGS ディレクトリ + |haiku-user-settings-dir| + 6. ドラッグ&ドロップ |haiku-dragndrop| + 7. 複数同時起動不可と複数起動可能 + |haiku-launch| + 8. フォント |haiku-fonts| + 9. Meta キー |haiku-meta| +10. マウスのキーマッピング |haiku-mouse| +11. 色名 |haiku-colors| +12. クレジット |haiku-support-credits| +13. バグと ToDo 的な事柄 |haiku-bugs| + + +1. 全般 *haiku-general* + +デフォルトのシンタックスハイライトは異なる前景色のハイライトアイテムについて多 +くの場合動作します。もっとも良く動作させるには暗めの背景色と明るい文字をターミ +ナルウィンドウに設定します。いくつかの中間的なグレーの背景色 (例えば +(r,g,b)=(168,168,168)) と黒の文字でもまた良く動くでしょう。 + + +2. Vim のコンパイル *haiku-compiling* + +Vim は標準的な configure/make 手法を用いてコンパイルすることができます。 +./configure を引数無しか --enable-gui=haiku で Haiku の GUI をサポートしてコン +パイルできます。./configure --help を走らせることで、あなたが他に有効/無効にで +きる機能を見付けることができるでしょう。 + +"make" で Vim をコンパイルでき、次いで "install" でインストールすることができ +ます。GUI 版で追加的に GUI レスの vim バイナリもインストールされ、Haiku にシー +ムレスに統合されます。典型的なコマンドは以下: > + + ./configure --prefix=`finddir B_SYSTEM_NONPACKAGED_DIRECTORY` \ + --datarootdir=`finddir B_SYSTEM_NONPACKAGED_DATA_DIRECTORY` \ + --mandir=`finddir B_SYSTEM_NONPACKAGED_DIRECTORY`/documentation/man \ + make clean + make install + + ./configure --prefix=`finddir B_SYSTEM_NONPACKAGED_DIRECTORY` \ + --datarootdir=`finddir B_SYSTEM_NONPACKAGED_DATA_DIRECTORY` \ + --mandir=`finddir B_SYSTEM_NONPACKAGED_DIRECTORY`/documentation/man \ + --disable-gui + make clean + make install + + +3. Haiku の GUI *haiku-gui* + +通常、起動を gvim か vim -g で行うと GUI の Vim が起動します。GUI 付き版の vim +はターミナルからではなくトラッカーからの起動であるかどうかを判定しようとしま +す、そしてそうだった場合 GUI を使います。しかしながら、現在の判定スキームでは +"vim - + + :version + +通常は /boot/common/data/vim になっています。この値が好ましくなく変更したいな +ら、環境変数 VIM に値を設定することで上書きでき、あるいは{訳註:ヘルプファ +イルなら}あなたの .vimrc で 'helpfile' を設定してもできます: > + + :if version >= 500 + : set helpfile=~/vim/runtime/doc/help.txt + : syntax on + :endif + + +5. $BE_USER_SETTINGS ディレクトリ *haiku-user-settings-dir* + +$USER_SETTINGS_DIR は Haiku の設定とコンフィグファイルを保存している場所へのシ +ンボル名です。 + +通常は /boot/home/config/settings になっています。 + + +6. ドラッグ&ドロップ *haiku-dragndrop* + +Vim のアイコン(ドロップするファイルのアプリケーションが Vim の"複数同時起動不 +可"に設定されていなければ新しい Vim のセッションを開始します)、もしくは Vim の +ウィンドウ(ファイルの編集を始めます)にファイル(複数)もしくはディレクトリ(複数) +をドロップすることができます。フォルダをドロップした場合は Vim のカレントワー +キングディレクトリに設定します。|:cd| |:pwd| +もし SHIFT キーを押しながら、ファイルもしくはフォルダをドロップしたなら、 Vim +は最初にドロップされたアイテムが含まれるディレクトリに{訳註:カレントワーキング +ディレクトリを}変更します。Vim を起動するときはShiftキーを押す必要はなく: Vim +は、(Shift キーを押したときと) 同じように動作します。 + +ファイルのドロップは引数リストを設定します。 |argument-list| + + +7. 複数同時起動不可と複数起動可能 *haiku-launch* + +配布されている Vim のアプリケーションフラグ(ファイルタイプの設定で確認できる) +は複数起動可能に設定されています。もし望むなら代わりに複数同時起動不可をセット +することもできます。2つめの Vim のコピーが起動するとき最初の Vim でファイルを +代わりに開くよう試みます。これはトラッカーから開いたときにコマンドラインから開 +くのと同じように働きます。後者のケースでは、ノンファイルな(オプション)引数はサ +ポートされません。別の複数同時起動不可での後退点は、Vim のインスタンスが GUI +サポートでコンパイルされていても非 GUI アプリケーションとして動作するとき、 +"Open With ..." での要求を無言で無視してしまうことです。Vim インスタンスが GUI +ありで動作するときはこの問題はありません。 + +注意: GUI バージョンだけが BApplication です (そしてその為にアプリケーションフ +ラグがある)。 +この章は GUI レスバージョンについては適用されず、そのようにコンパイルする必要 +があります。 + + +8. フォント *haiku-fonts* + +フォントの設定は > + + :set guifont=DejaVu_Sans_Mono/Book/12 + +最初の部分はフォントファミリー、次の部分はスタイル、三番目はサイズです。(フォ +ント)ファミリーとスタイルのスペースはアンダースコアに置き換えられます。 + +等幅フォントで最良の結果が得られます。Vim は全てのフォントについて、 +B_FIXED_SPACING モードを適用しようとしますが、どうやらプロポーショナルフォント +については働かないようです(BeBook と呼ばれているにもかかわらずです)。 + +現在のフォントでどのエンコーディングをサポートしているか検証したいなら > + + :digraphs + +コマンドを与えて、ISO Latin 1 エンコーディングでのたくさんの文字を一覧表示しま +す。もし、例えば、その中に"ボックス"文字{訳註: 俗に言う表示できない時の豆腐文 +字}があったり、もしくは最後がドット付きyではない場合は、そのエンコーディングで +このフォントは動きません。 + +もし指定したフォントが無いなら、システムの固定フォントが得られます。 + +GUI でのフォント選択ダイアログは、次のようにして > + + :set guifont=* + +コマンドを与えることで利用できます。 + + +9. Meta キー *haiku-meta* + +META 修飾キーは左もしくは右の OPTION キーによって得られます。これは ALT(もしく +は COMMAND)キーがアプリケーションに通知されないことを意味します。 + + +10. マウスのキーマッピング *haiku-mouse* + +Vim は様々なマウスのボタンを LeftMouse、MiddleMouse そして RightMouse と呼んで +います。デフォルトのマウスの設定を使用するなら、これらの名前が実際のボタンに対 +応します。Vim は次のマッピングを使用します: + + Button 1 -> LeftMouse, + Button 2 -> RightMouse, + Button 3 -> MiddleMouse. + +もし、あなたのマウスが3ボタンより少ないなら、修飾キーとマウスの他のボタンを組 +み合せてマウスクリックをマッピングすることができます。例として +$VIM/macros/swapmous.vim ファイルを見てください。 |gui-mouse-mapping| + + +11. 色名 *haiku-colors* + +Vim は多数の色名を内蔵しています。追加の名前については $VIMRUNTIME/rgb.txt が +あれば、それから読み込みます。このファイルは基本的には X の色データベースです。 +名前を使う時に効率的にするため、このファイルはキャッシュされます。 + + +12. GUI ツールバーイメージ *haiku-toolbar-images* + +ツールバー画像の代替セットは任意の高さのPNG画像でなくてなはなりません。画像幅 +は1行のセルに最低32個のボタンが入るように計算されます。画像は + $VIRUNTIME/bitmaps/builtin-tools.png という名前で保存すること。ボタンの割り当 +てについての情報は |builtin-tools| を参照のこと。 + + +13. クレジット *haiku-support-credits* + +多数の人の手により Haiku 版は BeOS 版をベースとして移植されました + - BeBox GUI サポート Copyright 1998 by Olaf Seibert; + - R4 への移植 by Richard Offer Jul 99; + - 上記に含まれないが忘れられたわけではない多数の人の提供; + - Haiku サポート by Siarzhuk Zharski Apr-Mai 2009. + +すべての変更とパッチは vim-license 下で提供されます。 + +みんなありがとう! + + +13. バグと ToDo 的な事柄 *haiku-bugs* + +この移植は開発中で完全な状態から遠く離れています。バグレポート、パッチ、そして +要望を歓迎します。 + + + -Siarzhuk Zharski + + + vim:tw=78:ts=8:ft=help:norl: diff --git a/en/os_haiku.txt b/en/os_haiku.txt new file mode 100644 index 000000000..1154ea755 --- /dev/null +++ b/en/os_haiku.txt @@ -0,0 +1,228 @@ +*os_haiku.txt* For Vim version 8.2. Last change: 2020 Feb 26 + + + VIM REFERENCE MANUAL by Bram Moolenaar + + + *Haiku* +This file contains the particularities for the Haiku version of Vim. For +matters not discussed in this file, Vim behaves very much like the Unix +|os_unix.txt| version. + +Haiku is an open-source operating system inspired by BeOS, that specifically +targets personal computing. + + 1. General |haiku-general| + 2. Compiling Vim |haiku-compiling| + 3. The Haiku GUI |haiku-gui| + 4. The $VIM directory |haiku-vimdir| + 5. The $BE_USER_SETTINGS + directory |haiku-user-settings-dir| + 6. Drag & Drop |haiku-dragndrop| + 7. Single Launch vs. Multiple + Launch |haiku-launch| + 8. Fonts |haiku-fonts| + 9. The meta key modifier |haiku-meta| +10. Mouse key mappings |haiku-mouse| +11. Color names |haiku-colors| +12. Credits |haiku-support-credits| +13. Bugs & things To Do |haiku-bugs| + + +1. General *haiku-general* + +The default syntax highlighting mostly works with different foreground colors +to highlight items. This works best if you set your Terminal window to a +darkish background and light letters. Some middle-grey background (for +instance (r,g,b)=(168,168,168)) with black letters also works nicely. + + +2. Compiling Vim *haiku-compiling* + +Vim can be compiled using the standard configure/make approach. Running +./configure without any arguments or passing --enable-gui=haiku, will compile +vim with the Haiku GUI support. Run ./configure --help , to find out other +features you can enable/disable. + +Now you should use "make" to compile Vim, then "make install" to install it. +For seamless integration into the Haiku the GUI-less vim binary should be +additionally installed over the GUI version. Typical build commands are: > + + ./configure --prefix=`finddir B_SYSTEM_NONPACKAGED_DIRECTORY` \ + --datarootdir=`finddir B_SYSTEM_NONPACKAGED_DATA_DIRECTORY` \ + --mandir=`finddir B_SYSTEM_NONPACKAGED_DIRECTORY`/documentation/man \ + make clean + make install + + ./configure --prefix=`finddir B_SYSTEM_NONPACKAGED_DIRECTORY` \ + --datarootdir=`finddir B_SYSTEM_NONPACKAGED_DATA_DIRECTORY` \ + --mandir=`finddir B_SYSTEM_NONPACKAGED_DIRECTORY`/documentation/man \ + --disable-gui + make clean + make install + + +3. The Haiku GUI *haiku-gui* + +Normally Vim starts with the GUI if you start it as gvim or vim -g. The vim +version with GUI tries to determine if it was started from the Tracker instead +of the Terminal, and if so, uses the GUI anyway. However, the current detection +scheme is fooled if you use the command "vim - + + :version + +The normal value is /boot/common/data/vim. If you don't like it you can +set the VIM environment variable to override this, or set 'helpfile' in your +.vimrc: > + + :if version >= 500 + : set helpfile=~/vim/runtime/doc/help.txt + : syntax on + :endif + + +5. The $USER_SETTINGS_DIR directory *haiku-user-settings-dir* + +$USER_SETTINGS_DIR is the symbolic name for the place where Haiku +configuration and settings files are stored. + +The normal value is /boot/home/config/settings. + + +6. Drag & Drop *haiku-dragndrop* + +You can drop files and directories on either the Vim icon (starts a new Vim +session, unless you use the File Types application to set Vim to be "Single +Launch") or on the Vim window (starts editing the files). Dropping a folder +sets Vim's current working directory. |:cd| |:pwd| If you drop files or +folders with either SHIFT key pressed, Vim changes directory to the folder +that contains the first item dropped. When starting Vim, there is no need to +press shift: Vim behaves as if you do. + +Files dropped set the current argument list. |argument-list| + + +7. Single Launch vs. Multiple Launch *haiku-launch* + +As distributed Vim's Application Flags (as seen in the FileTypes preference) +are set to Multiple Launch. If you prefer, you can set them to Single Launch +instead. Attempts to start a second copy of Vim will cause the first Vim to +open the files instead. This works from the Tracker but also from the command +line. In the latter case, non-file (option) arguments are not supported. +Another drawback of the Single Launch is silent ignore of "Open With ..." +requests by vim instance that running as non-GUI application even GUI support +was compiled in. Vim instance running with GUI has no such problems. + +NB: Only the GUI version has a BApplication (and hence Application Flags). +This section does not apply to the GUI-less version, should you compile one. + + +8. Fonts *haiku-fonts* + +Set fonts with > + + :set guifont=DejaVu_Sans_Mono/Book/12 + +where the first part is the font family, the second part the style, and the +third part the size. You can use underscores instead of spaces in family and +style. + +Best results are obtained with monospaced fonts. Vim attempts to use all +fonts in B_FIXED_SPACING mode but apparently this does not work for +proportional fonts (despite what the BeBook says). + +To verify which encodings are supported by the current font give the > + + :digraphs + +command, which lists a bunch of characters with their ISO Latin 1 encoding. +If, for instance, there are "box" characters among them, or the last character +isn't a dotted-y, then for this font the encoding does not work. + +If the font you specify is unavailable, you get the system fixed font. + +GUI Font Selection Dialog is available at giving the > + + :set guifont=* + +command. + + +9. The meta key modifier *haiku-meta* + +The META key modifier is obtained by the left or right OPTION keys. This is +because the ALT (aka COMMAND) keys are not passed to applications. + + +10. Mouse key mappings *haiku-mouse* + +Vim calls the various mouse buttons LeftMouse, MiddleMouse and RightMouse. If +you use the default Mouse preference settings these names indeed correspond to +reality. Vim uses this mapping: + + Button 1 -> LeftMouse, + Button 2 -> RightMouse, + Button 3 -> MiddleMouse. + +If your mouse has fewer than 3 buttons you can provide your own mapping from +mouse clicks with modifier(s) to other mouse buttons. See the file +$VIM/macros/swapmous.vim for an example. |gui-mouse-mapping| + + +11. Color names *haiku-colors* + +Vim has a number of color names built-in. Additional names are read from the +file $VIMRUNTIME/rgb.txt, if present. This file is basically the color +database from X. Names used from this file are cached for efficiency. + + +12. GUI Toolbar Images *haiku-toolbar-images* + +Alternative set of toolbar images should be the PNG image of any height you +like. Image width is calculated to contain at least 32 buttons in one-row +cells. +The image should be stored under the name $VIRUNTIME/bitmaps/builtin-tools.png +More info about the buttons assignment are at |builtin-tools|. + + +13. Credits *haiku-support-credits* + +Haiku port is based on work done for BeOS version by many people + - BeBox GUI support Copyright 1998 by Olaf Seibert; + - Ported to R4 by Richard Offer Jul 99; + - Those who contributed, not listed above but not forgotten; + - Haiku support by Siarzhuk Zharski Apr-Mai 2009. + +All the changes and patches released under vim-license. + +Thank you, all! + + +13. Bugs & things To Do *haiku-bugs* + +The port is under development now and far away from the perfect state. Bug +reports, patches and wishes are welcome. + + + -Siarzhuk Zharski + + + vim:tw=78:ts=8:ft=help:norl: