Also updated the HTML command reference for the "expand" and

"unexpand" commands to include the options just implemented.
This commit is contained in:
R. Timothy Edwards 2026-04-04 21:03:06 -04:00
parent ceba050a21
commit 6e295d030e
2 changed files with 46 additions and 11 deletions

View File

@ -26,7 +26,8 @@ expanded/unexpanded cells in the current selection.
<H3>Usage:</H3> <H3>Usage:</H3>
<BLOCKQUOTE> <BLOCKQUOTE>
<B>expand</B> [<B>toggle</B>] <BR><BR> <B>expand</B> [<B>selection</B>|<B>surround</B>|<B>overlap</B>|<B>all</B>]
[<B>toggle</B>] <BR><BR>
</BLOCKQUOTE> </BLOCKQUOTE>
<H3>Shortcuts:</H3> <H3>Shortcuts:</H3>
@ -38,14 +39,32 @@ expanded/unexpanded cells in the current selection.
<H3>Summary:</H3> <H3>Summary:</H3>
<BLOCKQUOTE> <BLOCKQUOTE>
The <B>expand</B> command expands the view of subcells to The <B>expand</B> command expands the view of subcells to
display the contents of the subcells. Without arguments, display the contents of the subcells.
the <B>expand</B> command expands all unexpanded subcells that
touch or intersect the cursor box in the layout window. <P> Option <B>overlap</B> expands all unexpanded subcells that
overlap with the cursor box in the layout window. <P>
Option <B>surround</B> expands all unexpanded subcells that
are completely surrounded by the cursor box in the layout window. <P>
Option <B>all</B> expands all subcells in the layout window. <P>
Option <B>selection</B> operates on the current selection, not
relative to the cursor box, expanding all selected cells. <P>
Option <B>toggle</B> will expand a selected cell that is
unexpanded, or unexpand a cell that is already expanded.
<B>toggle</B> may be given as an additional option to any
of the other options above; however, the <B>toggle</B> option
must be the last option given to the command.<P>
With no arguments, the <B>expand</B> command behaves like
<B>expand overlap</B>, and the <B>expand toggle</B> command
with no additonal arguments behaves like
<B>expand selection toggle</B>, for backwards-compatible
behavior with earlier versions of magic which offered only
the <B>toggle</B> option.
Option <B>expand toggle</B> operates on the current selection,
not relative to the cursor box, and will expand a selected
cell that is unexpanded, or unexpand a cell that is already
expanded.
</BLOCKQUOTE> </BLOCKQUOTE>
<H3>Implementation Notes:</H3> <H3>Implementation Notes:</H3>

View File

@ -25,7 +25,8 @@ Unexpand everything inside or touching the cursor box.
<H3>Usage:</H3> <H3>Usage:</H3>
<BLOCKQUOTE> <BLOCKQUOTE>
<B>unexpand</B> <BR><BR> <B>unexpand</B> [<B>selection</B>|<B>surround</B>|<B>overlap</B>|<B>all</B>]
<BR><BR>
</BLOCKQUOTE> </BLOCKQUOTE>
<H3>Shortcuts:</H3> <H3>Shortcuts:</H3>
@ -37,8 +38,23 @@ Unexpand everything inside or touching the cursor box.
<BLOCKQUOTE> <BLOCKQUOTE>
The <B>unexpand</B> command unexpands the view of subcells to The <B>unexpand</B> command unexpands the view of subcells to
hide the contents of the subcells and show the bounding box hide the contents of the subcells and show the bounding box
outline only. The <B>unexpand</B> command unexpands all subcells outline only.
that touch or intersect the cursor box in the layout window. <P>
Option <B>overlap</B> unexpands all expanded subcells that
overlap with the cursor box in the layout window. <P>
Option <B>surround</B> unexpands all expanded subcells that
are completely surrounded by the cursor box in the layout window. <P>
Option <B>all</B> unexpands all subcells in the layout window. <P>
Option <B>selection</B> operates on the current selection, not
relative to the cursor box, unexpanding all selected cells. <P>
With no arguments, the <B>unexpand</B> command behaves like
<B>unexpand surround</B>, for backwards-compatible behavior with
earlier versions of magic which did not offer the options.
</BLOCKQUOTE> </BLOCKQUOTE>
<H3>Implementation Notes:</H3> <H3>Implementation Notes:</H3>