Merge pull request #2604 from h-east/update-tabpage

Update tabpage.{txt,jax}

Author: h-east

doc/tabpage.jax

@@ -1,4 +1,4 @@
-*tabpage.txt*	For Vim バージョン 9.2.  Last change: 2026 Apr 25
+*tabpage.txt*	For Vim バージョン 9.2.  Last change: 2026 Apr 28
 
 
 		  VIM リファレンスマニュアル	by Bram Moolenaar
@@ -483,36 +483,40 @@ GUI のタブページラインにはポップアップメニューがありま
 ハイライトグループを使用して、タブページラベルの外観をカスタマイズできます:
 |hl-TabPanel| |hl-TabPanelSel| |hl-TabPanelFill|
 
-タブパネルのスクロール:					*tabpanel-scroll*
+☆タブパネルのスクロール				*tabpanel-scroll*
 
-タブページのリストの合計高さが画面の表示高さを超えると、タブパネルはデフォルト
-でカレントタブページを含む "ページ" を表示し、そのページ以外のタブページを表示
-する方法は提供しない。
+タブページのリストの総高さが画面表示の高さを超えると、タブパネル領域内でのマウ
+スホイールイベントによってタブページのリストが上下にスクロールする。スクロール
+のステップ数は 'mousescroll' 設定に従う。タブパネル領域内でのホイールイベント
+はタブパネルによって消費され、|<ScrollWheelUp>| または |<ScrollWheelDown>| の
+マッピングはトリガーされない。
 
-タブパネルをスクロール可能にするには、'tabpanelopt' に "scroll" を追加する: >
-	:set tabpanelopt+=scroll
+カレントタブページは常に表示される。選択されたタブページが変更されると
+(|gt|、|gT|、|:tabnext| など)、パネルがスクロールして現在のエントリが表示され
+る。
 
-"scroll" が有効になっている場合、タブパネル領域上でのマウスホイールイベントは、
-タブページのリストを上下にスクロールする。スクロール動作は 'mousescroll' 設定
-に従う。
-タブパネル領域内でのホイールイベントはタブパネルによって処理され、
-|<ScrollWheelUp>| または |<ScrollWheelDown>| のマッピングはトリガーされない。
-
-スクロール位置を示す垂直スクロールバーを追加するには、"scrollbar" を使用する: >
+現在のスクロール位置を示す垂直スクロールバーを表示するには、'tabpanelopt' に
+"scrollbar" を追加する: >
 	:set tabpanelopt+=scrollbar
 
-"scrollbar" の値は "scroll" の意味を含む。タブパネルの端に 1 列のスクロールバー
-が確保される。スクロールバーの列をクリックすると、サム (thumb) がクリック位置
+タブパネルの右端には、'tabpanelopt' の "align:" 設定に関係なく常に 1 列のスク
+ロールバーが表示される。スクロールバーの列をクリックすると、サムがクリック位置
 に移動し、サムをドラッグすることで連続的にスクロールできる。
 
-"vert" と "scrollbar" を組み合わせると、スクロールバーはパネル側の垂直セパレー
-ターの横に描画される。
-
 スクロールバーは、トラックに |hl-PmenuSbar| ハイライトグループを、サムに
 |hl-PmenuThumb| を使用する。
 
-スクロールのオフセットは再描画後も保持さるが、 "scroll" または "scrollbar" を
-オフにしてから再びオンにするとリセットされる。
+スクロールオフセットは再描画後も保持される。
+
+☆タブパネル内でのマウスクリック			*tabpanel-mouse*
+
+タブパネルの行を左クリックすると、その行に対応するタブページが選択される。タブ
+ラインとは異なり、タブパネルでダブルクリックしても新しい空のタブページは開かれ
+ず、シングルクリックと同じように扱われる。
+
+より詳細な制御を行うために、'tabpanel' の値には、|stl-%[FuncName]| クリック領
+域を含めることができる。これらの領域のクリックは、タブ選択にフォールスルーする
+代わりに、コールバック関数に処理が渡される。
 
 ==============================================================================
 6. 'guitablabel' の設定					*setting-guitablabel*

en/tabpage.txt

@@ -1,4 +1,4 @@
-*tabpage.txt*	For Vim version 9.2.  Last change: 2026 Apr 25
+*tabpage.txt*	For Vim version 9.2.  Last change: 2026 Apr 28
 
 
 		  VIM REFERENCE MANUAL	  by Bram Moolenaar
@@ -482,36 +482,41 @@ The vertical separator character is taken from "tpl_vert" in 'fillchars'.
 You can customize the appearance of the tab page labels using the highlight
 groups: |hl-TabPanel| |hl-TabPanelSel| |hl-TabPanelFill|
 
-SCROLLING IN THE TABPANEL:				*tabpanel-scroll*
+SCROLLING IN THE TABPANEL				*tabpanel-scroll*
 
 When the total height of the tab page list exceeds the visible screen height,
-the tabpanel by default displays the "page" that contains the current tab page
-and offers no way to view tab pages outside that page.
+mouse wheel events over the tabpanel area scroll the tab page list up or down.
+The scroll step follows the 'mousescroll' setting.  Wheel events inside the
+tabpanel area are consumed by the tabpanel and do not trigger
+|<ScrollWheelUp>| or |<ScrollWheelDown>| mappings.
 
-To make the tabpanel scrollable, add "scroll" to 'tabpanelopt': >
-	:set tabpanelopt+=scroll
+The current tab page is always brought into view: when the selected tab page
+changes (by |gt|, |gT|, |:tabnext| etc.), the panel scrolls so the current
+entry is visible.
 
-With "scroll" enabled, mouse wheel events over the tabpanel area scroll the
-tab page list up or down.  The scroll step follows the 'mousescroll' setting.
-Wheel events inside the tabpanel area are consumed by the tabpanel and do not
-trigger |<ScrollWheelUp>| or |<ScrollWheelDown>| mappings.
-
-To additionally show a vertical scrollbar indicating the current scroll
-position, use "scrollbar": >
+To show a vertical scrollbar indicating the current scroll position, add
+"scrollbar" to 'tabpanelopt': >
 	:set tabpanelopt+=scrollbar
 
-The "scrollbar" value implies "scroll".  A one-column scrollbar is reserved at
-the edge of the tabpanel; clicking on the scrollbar column moves the thumb to
-the click position, and the thumb can be dragged to scroll continuously.
-
-When "vert" is combined with "scrollbar", the scrollbar is drawn next to the
-vertical separator, on the panel side.
+A one-column scrollbar is always displayed at the right edge of the tabpanel,
+regardless of the "align:" setting in 'tabpanelopt'.  Clicking on the
+scrollbar column moves the thumb to the click position, and the thumb can be
+dragged to scroll continuously.
 
 The scrollbar uses the |hl-PmenuSbar| highlight group for the track and
 |hl-PmenuThumb| for the thumb.
 
-The scroll offset is remembered across redraws but is reset when "scroll" or
-"scrollbar" is toggled off and back on.
+The scroll offset is remembered across redraws.
+
+MOUSE CLICKS IN THE TABPANEL				*tabpanel-mouse*
+
+A left click on a row in the tabpanel selects the tab page that the row
+belongs to.  Unlike the tabline, a double click in the tabpanel does not open
+a new, empty tab page; it is treated the same as a single click.
+
+For finer-grained control, the 'tabpanel' value may contain |stl-%[FuncName]|
+click regions.  Clicks on those regions are dispatched to the callback
+function instead of falling through to tab selection.
 
 ==============================================================================
 6. Setting 'guitablabel'				*setting-guitablabel*