Relinking and new stuff.

doc/2-interface/README.md

@@ -9,6 +9,7 @@ the default layout of Furnace is depicted below.
 primary topics:
 
 - [menu bar](menu-bar.md)
+- [order list](order-list.md)
 - [play/edit controls](play-edit-controls.md)
 - [instrument/wavetable/sample list](asset-list.md)
 - [song information](song-info.md)

doc/2-interface/menu-bar.md

@@ -154,8 +154,8 @@ it's not really useful, unless you're a developer and want to use a command stre
   - if a column is already selected, it will select the entire channel.
   - if a channel is already selected, it will select the entire pattern.
 
-- **operation mask**: this is an advanced feature. see [this page](../3-pattern/opmask.md) for more information.
-- **input latch**: this is an advanced feature. see [this page](../3-pattern/inputlatch.md) for more information.
+- **operation mask**: toggles which columns will be affected by the listed commands. [more information here.](../8-advanced/opmask.md)
+- **input latch**: determines which data are placed along with a note. [more information here.](../8-advanced/inputlatch.md)
 
 - **note/octave up/down**: transposes notes in the current selection.
 
@@ -176,7 +176,7 @@ it's not really useful, unless you're a developer and want to use a command stre
 - **invert values**: `00` becomes `FF`, `01` becomes `FE`, `02` becomes `FD` and so on.
 
 - **flip selection**: flips the selection so it is backwards.
-- **collapse/expand amount**: allows you to specify how much to collapse/expand in the next options.
+- **collapse/expand amount**: allows you to specify how much to collapse/expand in the next commands.
 - **collapse**: shrinks the selected contents.
 - **expand**: expands the selected contents.
 
@@ -188,7 +188,7 @@ it's not really useful, unless you're a developer and want to use a command stre
 - **expand song**: same as expand, but affects the entire song.
   - it also changes speeds and pattern length to compensate.
 
-- **find/replace**: opens the Find/Replace window. see [this page](../3-pattern/find-replace.md) for more information.
+- **find/replace**: shows [the Find/Replace window](../8-advanced/find-replace.md).
 
 - **clear**: allows you to mass-delete things like songs, instruments and the like.
 
@@ -199,46 +199,42 @@ it's not really useful, unless you're a developer and want to use a command stre
 - **basic mode**: toggles [Basic Mode](basic-mode.md).
 - **visualizer**: toggles pattern view particle effects when the song plays.
 - **reset layout**: resets the workspace to its defaults.
-- **settings...**: opens the Settings window. these are detailed in [settings.md].
+- **settings...**: shows the Settings window. these are detailed in [settings.md].
 
 # window
 
-- **song information**: shows/hides the Song Information window.
-- **subsongs**: shows/hides the Subsongs window.
-- **speed**: shows/hides the Speed window.
-- **instruments**: shows/hides the instrument list.
-- **wavetables**: shows/hides the wavetable list.
-- **samples**: shows/hides the sample list.
-- **orders**: shows/hides the Orders window.
-- **pattern**: shows/hides the pattern view.
-- **mixer**: shows/hides the Mixer window.
-- **grooves**: shows/hides the Grooves window.
-- **channels**: shows/hides the Channels window.
-- **pattern manager**: shows/hides the Pattern Manager window.
-- **chip manager**: shows/hides the Chip Manager window.
-- **compatibility flags**: shows/hides the Compatibility Flags window.
-- **song comments**: shows/hides the Song Comments window.
+all these commands show or hide their associated windows.
 
-- **instrument editor**: shows/hides the Instrument Editor
-- **wavetable editor**: shows/hides the Wavetable Editor.
-- **sample editor**: shows/hides the Sample Editor.
+- [song information](song-info.md)
+- [subsongs](song-info.md)
+- [speed](song-info.md)
+- [instruments](../4-instrument/README.md)
+- [wavetables](../5-wave/README.md)
+- [samples](../6-sample/README.md)
+- [orders](order-list.md)
+- [pattern](../3-pattern/README.md)
+- [mixer](mixer.md)
+- [grooves](grooves.md)
+- [channels](channels.md)
+- [pattern manager](pat-manager.md)
+- [chip manager](chip-manager.md)
+- [compatibility flags](compat-flags.md)
+- [song comments](comments.md)
 
-- **play/edit controls**: shows/hides the Play/Edit Controls.
-- **piano/input pad**: shows/hides the Piano/Input Pad window.
-- **oscilloscope (master)**: shows/hides the oscilloscope.
-- **oscilloscope (per-channel)**: shows/hides the per-channel oscilloscope.
-- **volume meter**: shows/hides the volume meter.
-- **clock**: shows/hides the clock.
-- **register view**: shows/hides the Register View window.
-- **log viewer**: shows/hides the log Viewer.
-- **statistics**: shows/hides the Statistics window.
+- [piano](piano.md)
+- [oscilloscope](osc.md)
+- [oscilloscopes (per-channel)](chanosc.md)
+- [clock](clock.md)
+- [register view](regview.md)
+- [log viewer](log-viewer.md)
+- [stats](stats.md)
 
 # help
 
 - **effect list**: displays the effect list.
 - **debug menu**: this menu contains various debug utilities.
   - unless you are working with the Furnace codebase, it's not useful.
-- **inspector**: this options opens the Dear ImGui Metrics/Debugger window.
+- **inspector**: this option shows the Dear ImGui Metrics/Debugger window.
   - unless you are working with the Furnace codebase, it's not useful.
 - **panic**: this resets all chips while the song is playing, effectively silencing everything.
 - **about...**: displays the About screen.

doc/2-interface/order-list.md

@@ -0,0 +1,29 @@
+# order list
+
+the order list is a playlist for patterns.
+
+![order list](order-list.png)
+
+along the top are the available channels. their abbreviations can be set in the [channels window](../8-advanced/channels.md). the highlighted channel follows the channel the pattern view cursor is in.
+
+along the left are the order numbers. these are referenced with the `0Bxx` command. the highlighted row follows the order the pattern view cursor is in.
+
+each entry in the table is the pattern that will play during that order. these can be changed according to the order edit mode.
+
+hovering over a pattern number will pop up a tooltip showing the name of that pattern, if it has one.
+
+The buttons are as follows:
+- **Add new order**.
+- **Remove order**.
+- **Duplicate order**: adds a new order with patterns matching the selected one directly below it. right-click to "deep clone"; this copies all patterns involved to new ones.
+- **Move order up**: swaps the selected order with the one above it.
+- **Move order down**: swaps the selected order with the one below it.
+- **Duplicate order at end of song**: same as "Duplicate order" except the new order is added at the bottom of the list.
+- **Order change mode**: selects how much of the order will change with an edit. only applies if "Order edit mode" is set to "Click to change".
+  - **one**: only current channel's pattern will change.
+  - **entire row**: all patterns in the order will change.
+- **Order edit mode**: selects the method of changing orders.
+  - **Click to change**: a click will add one to the pattern number. a right-click will subtract one.
+  - **Select and type (don't scroll)**: select a pattern and type.
+  - **Select and type (scroll horizontally)**: as above, but after entering two digits, the cursor moves to the next channel.
+  - **Select and type (scroll vertically)**: as above, but after entering two digits, the cursor moves to the next order.