diff --git a/doc/en/contents.xml b/doc/en/contents.xml
index ebbb04f..9a4f4e4 100644
--- a/doc/en/contents.xml
+++ b/doc/en/contents.xml
@@ -23,6 +23,7 @@
Selects all components in the current circuit.
Available only when editing how a circuit's appearance, this menu item +raises the currently selected object(s) to be drawn +on top of an object that currently overlaps the selection. If the selected +object is overlapped by several objects, it is raised only to be above the lowest +one; select the menu item repeatedly until it is in the order it +should be.
+ +(Determining whether two arbitrary objects overlap is difficult. Logisim uses +an algorithm of selecting several random points in each of the two objects +and seeing if any point is also in the other object. Sometimes it will fail to +detect an overlap if the overlap is small — say, less than 5% of +either of the objects.)
Available only when editing a circuit's appearance, this menu item +lowers the currently selected object(s) to be drawn below an object that the +object currently overlaps. If it overlaps several objects, it is lowered only +to be below the highest one; select the menu item repeatedly until it is in the +order it should be.
Available only when editing a circuit's appearance and a point has been +selected on a line, polyline, or polygon, this menu item inserts a new vertex +onto the shape. Previous to insertion, the selected point is drawn as a +diamond.
Available only when editing a circuit's appearance and an existing +vertex has been selected on a polyline or polygon, this menu item removes +the selected vertex. Previous to deletion, the selected vertex is drawn as a +diamond within the square representing the vertex. Logisim will not permit +removing a vertex on a polygon with only three vertices or on a polyline with +only two vertices.
Next: The Project menu.
diff --git a/doc/en/guide/menu/project.html b/doc/en/guide/menu/project.html index 7a25a67..0916612 100644 --- a/doc/en/guide/menu/project.html +++ b/doc/en/guide/menu/project.html @@ -36,11 +36,29 @@ circuits within the project, as displayed in the explorer pane.Sets the currently displayed circuit to be the project's
-``main circuit.'' (This menu item will be grayed out if the
+main circuit.
(This menu item will be grayed out if the
current circuit is already the project's main circuit.)
The only significance of the main circuit is that it is the
circuit that first appears when a project file is opened.
Switches to allow you to edit how the layout of components that +determines how the circuit works. This is what the program does when it starts, +and you will edit circuit layouts most often using Logisim, so this menu item +is normally disabled.
Switches to allow you to edit how the circuit will be represented
+when it is used as a subcircuit within another circuit. By default, the circuit
+is represented as a rectangle with a gray notch
on its north end, but
+this menu option allows you to draw a different appearance for the
+subcircuit.
If you've edited the circuit's appearance, this menu item reverts +the appearance back to the default rectangle-with-notch appearance. +The menu item is enabled only when editing the circuit's appearance.
Removes the currently displayed circuit from the project. Logisim will prevent you from removing circuits that are used as @@ -85,7 +103,8 @@ not included in the unique and recursive counts.
When checked, this menu item indicates that a small toolbar should be displayed above the explorer pane, allowing the user easy access to adding, renaming, reordering, and removing circuits -from a project.
+ | Select, move, copy, and paste shapes. |
+ | Add or edit text. |
+ | Create a line segment. Shift-drag keeps the line at 45° angles. |
+ | Create a quadratic Bezier curve. + For the first drag, where you specify the curve's endpoints, + shift-drag keeps the endpoints at a 45° angle from each other. + Then you click to indicate the control point's location; + shift-click ensures the curve is symmetric, + while alt-click draws the curve through the control point. |
+ | Create a sequence of connected lines, whose vertices are indicated by + a succession of clicks. Shift-clicking ensures that the vertex is at a 45° + angle from the previous one. Double-click or press the Enter key to complete the + shape. |
+ | Create a rectangle through dragging from one corner to the opposite corner. + Shift-drag to create a square, and alt-drag to create the rectangle starting + from the center. |
+ | Create a rectangle with rounded corners through dragging from one corner to the opposite corner. + Shift-drag to create a square, and alt-drag to create the rectangle starting + from the center. |
+ | Create an oval through dragging from one corner of its bounding box to the opposite corner. + Shift-drag to create a circle, and alt-drag to create the circle starting + from the center. |
+ | Create an arbitrary polygon, whose vertices are indicated by + a succession of clicks. Shift-clicking ensures that the vertex is at a 45° + angle from the previous one. Double-click, press the Enter key, or click the + starting vertex to complete the shape. |
Next: Using subcircuits.
+ + + diff --git a/doc/en/guide/subcirc/custom-appear.png b/doc/en/guide/subcirc/custom-appear.png new file mode 100644 index 0000000..88b5943 Binary files /dev/null and b/doc/en/guide/subcirc/custom-appear.png differ diff --git a/doc/en/guide/subcirc/custom-layout.png b/doc/en/guide/subcirc/custom-layout.png new file mode 100644 index 0000000..4041bc6 Binary files /dev/null and b/doc/en/guide/subcirc/custom-layout.png differ diff --git a/doc/en/guide/subcirc/index.html b/doc/en/guide/subcirc/index.html index 6e24289..bd4b8c3 100644 --- a/doc/en/guide/subcirc/index.html +++ b/doc/en/guide/subcirc/index.html @@ -24,6 +24,7 @@ facilitate debugging.Creating circuitsdiff --git a/doc/en/guide/subcirc/using.html b/doc/en/guide/subcirc/using.html index 18111af..c9de485 100644 --- a/doc/en/guide/subcirc/using.html +++ b/doc/en/guide/subcirc/using.html @@ -67,7 +67,7 @@ deleting, or moving them) will rearrange them also in the containing circuit. Thus, if you change any pins in a circuit, you will also need to edit any circuits using it as a subcircuit. -
Using subcircuits +
Editing subcircuit appearance
Debugging subcircuits
Logisim libraries
Next: Debugging subcircuits.
+