#

## expand

Expand everything inside or touching the cursor box, or toggle expanded/unexpanded cells in the current selection.

### Usage:

> expand [selection|surround|overlap|all] [toggle]

### Shortcuts:

> Key macro x implements the command expand.
> Key macro Control-X implements the command expand toggle.

### Summary:

> The expand command expands the view of subcells to display the contents of the subcells. Option overlap expands all unexpanded subcells that overlap with the cursor box in the layout window.

> Option surround expands all unexpanded subcells that are completely surrounded by the cursor box in the layout window.

> Option all expands all subcells in the layout window.

> Option selection operates on the current selection, not relative to the cursor box, expanding all selected cells.

> Option toggle will expand a selected cell that is unexpanded, or unexpand a cell that is already expanded. toggle may be given as an additional option to any of the other options above; however, the toggle option must be the last option given to the command.

> With no arguments, the expand command behaves like expand overlap, and the expand toggle command with no additonal arguments behaves like expand selection toggle, for backwards-compatible behavior with earlier versions of magic which offered only the toggle option.

### Implementation Notes:

> expand is implemented as a built-in magic command.

### See Also:

> unexpand

Return to command index

Last updated: March 7, 2020 at 1:06pm