4.3.8 SelectDoc

Syntax: SelectDoc
Abbreviation: SD

displays a requester containing the names of all the documents in memory. Your cursor will be on your current document’s name, and documents with unsaved changes will be indicated with asterisks (and bold if your terminal supports that). You select whichever document you want to become the current document by moving your cursor to its name and hitting Return.

While the list of documents is displayed, you can close unmodified documents with your CloseDoc key (Control-Q), save named documents with your Save key (Control-S), and you can alter their relative order using your NextDoc and PrevDoc keys (f2 and f3), which have the effect of moving the currently selected document forward or backward in the list, respectively.

Using plain characters and the BackSpace navigates your displayed document names based on their common prefixes. The text between the beginning and the cursor within the currently selected document’s name is the current common prefix. The Ins key toggles between hiding or displaying names not matching the current common prefix. This can be especially useful if you have a large number of open documents.

If you escape from the requester, the requester goes away, you are returned to your original current document (unless you closed it!), and no reordering of documents takes place.

SelectDoc is especially useful if you have a large number of documents open or if you want to quickly see which documents contain unsaved changes. See NextDoc, and PrevDoc.