Buffer List plugin

• Introduction
• Session Management
• The Buffer List
• Customization
• License
• Feedback

Introduction

The Buffer List maintains lists of open files - called a session aka workspace - and offers some functions to switch between them. The current list of open files and the list of recently opened files are shown in a dockable window that can be placed permanently in jEdit's view.

Session Management

To do... (sorry!)

Attention! If you use the SessionSwitcher, you should no longer use the jEdit commands Load Session... and Save Session... in menu File ! jEdit might loose track of the current session.

The Buffer List

The BufferList shows:

• Status icon
• Filename
• Directory
• Mode name

This can be configured to some extent in the Global Options. See Customization.

Mouse Actions

On the open files list:

• single click jumps to the selected buffer
• double click closes the selected buffer
• right mouse button click opens a popup with some convenient actions (goto, open in new view, close, save, save as, reload)

On the recent files list:

• double click opens the selected buffer
• right mouse button click opens a popup with some convenient actions (open, open in new view)

On both lists:

• If the column headers are displayed (see Global Options), single-clicking a column header sorts the list by this by this column, in ascending order.
  Clicking it again sorts the list in descending order.
  Clicking it again turns sorting off and reverts to jEdit's sort order.
• If the column headers are displayed, double-clicking on a column header edge auto-resizes the column to the size of the largest cell in that column.
  This only works if auto-resizing of columns is turned off in the Global options.

Menu Actions

The following menu actions are available in the menu Plugins ->Buffer List:

• Buffer List
  Show/Hide the Buffer List.
• Go to Next Buffer in Buffer List
  ...
• Go to Previous Buffer in Buffer List
  ...
• Save Session
  ...
• Save Session As...
  ...
• Manage Sessions...
  ...

Key Actions

Buffer List is fully keyboard navigable. A prerequisite is that you assigned a keyboard shortcut to the action Bring Buffer List to front, that is available after installation of BufferList.

You can assign a keyboard shortcut to this action under Utilities -> Global options -> Command Shortcuts. I suggest "A+b".

Customization

Appearance

You can customize the appearance of the Buffer List under Utilities -> Global options -> Plugin Options -> Buffer List. The following options are available:

1. Buffer List Options
   • Auto-Show on buffer change
     If enabled, the Buffer List is automatically shown, if the buffer has been changed.
   • Show vertical lines
   • Show horizontal lines
   • Show column headers
     If the column headers are not shown, columns will be auto-resized.
   • Auto-Resize columns
     If checked, the columns are auto-resized to the width of their longest entry. You cannot resize the columns manually any longer, if this option is checked.
   • Show absolute pathname in filename column
     The filename column is always shown. Use this option, if you want to disable the directory column, but still see the directory.
     
2. Session Switcher Options
   • Show Session Switcher
   • Show "Session:" label
   • Autosave Sessions
   • Close all files before switching to new session

Docking

Buffer List may be docked into the view.

Open "Utilities -> Global options -> Docking" to define the position, where Buffer List will be docked.

License

The source code is distributed under the GPL. Please see http://www.fsf.org/copyleft/gpl.html

Feedback

The preferred way to send bug reports or feature requests is to use the Sourceforge Bug Tracker at http://sourceforge.net/bugs/?group_id=588.

You can also write to:

• Dirk Möbius <dmoebius@gmx.net>, or
• jEdit-users mailing-list <jedit-users@lists.sourceforge.net>, or
• jEdit-devel mailing-list <jedit-devel@lists.sourceforge.net>.