aboutsummaryrefslogtreecommitdiff
path: root/doc/manual/4_WorkingWithFiles.md
blob: b57667bcc2e154da8a0b094cd2711d12fee67614 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
# Working with Files

## Lack of Tabs

One of the first things you will notice when opening multiple files in Textadept
is that there is no tab bar showing the files that are open. This was a design
decision. Textadept was built to support unlimited split views, so having a tab
bar with all open buffers would clutter the interface greatly. There is also the
question of where to place the bar (above, below, or to one side) and how many
to have (one for each split view or a single one under the menubar).

You can see which buffer is active by looking at Textadept's titlebar. Pressing
`Ctrl+Tab` cycles to the next buffer and `Ctrl+Shift+Tab` cycles to the previous
one.

## Buffer Browser

To move quickly between buffers, press `Ctrl+B` (`Apple+B` on Mac OSX) to open
the buffer browser.

![Buffer Browser](images/bufferbrowser.png)

The buffer browser shows you a list of currently open buffers, the most recent
towards the bottom. Typing part of any filename filters the list. Spaces are
wildcards. You can also just use the arrow keys. Pressing `Enter` or clicking
`OK` switches to the selected buffer.

![Buffer Browser Filtered](images/bufferbrowserfiltered.png)

## Split Views

Textadept allows you to split the editor window as many times as you like either
horizontally or vertically. `Ctrl+Alt+V, Shift+S` splits vertically
(side-by-side) and `Ctrl+Alt+V, S` splits horizontally (`Ctrl+V, Shift+S` and
`Ctrl+V, S` respectively on Mac OSX). You can resize the splitter bar by
clicking and dragging with the mouse. The same file can be worked with in
multiple split views.

Pressing `Ctrl+Alt+V, N` (`Ctrl+V, N` on Mac OSX) goes to the next view and
`Ctrl+Alt+V, P` goes to the previous one.

To unsplit a view, enter the view to keep open and press `Ctrl+Alt+V, W`
(`Ctrl+V, W` on Mac OSX). To unsplit all views, use `Ctrl+Alt+V, Shift+W`.

## Sessions

By default, Textadept saves the list of open buffers on exit so it can reload
them the next time it starts up. You can disable this by passing the `-n` or
`--no-session` switch to Textadept on startup. Sessions can be manually saved
and opened via the `File -> Save Session...` and `File -> Load Session...`
menus.

Sessions save additional information such as current split views, caret and
scroll positions in each buffer, and Textadept's window size.

## Snapopen

A quicker, though slightly more limited alternative to the standard
`File -> Open` dialog is snapopen. It behaves like the buffer browser, but
displays a list of files to open, including files in subdirectories. You can
snapopen the current file's directory from the `Tools -> Snapopen -> Current
Directory` menu. Snapopen is pretty limited from the menu, but more versitile
in scripts. See its [LuaDoc](../modules/_m.textadept.snapopen.html).

![Snapopen](images/snapopen.png)