Assorted documentation upkeep.

doc/1-intro/concepts.md

@@ -15,22 +15,22 @@ The **[pattern view](../3-pattern/README.md)** is like a spreadsheet that displa
 ## structure
 
 The **order list** is a smaller spreadsheet showing the overall song structure.
-- A song is made up of a list of **orders**.
-- An **order** is a set of numbered **patterns** used for each channel.
+- A song is made up of a list of orders.
+- An **order** is a set of numbered patterns used for each channel.
 - Each channel has its own unique list of patterns.
-- Each pattern contains note and effect data for that channel only.
+- Each **pattern** contains note and effect data for that channel only.
 - Patterns may be used multiple times in the order list. Changing a pattern's data in one order will affect the same pattern used in other orders.
 
 ## time
 
-- Each pattern is made of the same number of **rows** as seen in the tracker view.
-- During playback, Each row lasts a number of **ticks** determined by its **speed** value.
-- A tick is the smallest measure of time to which all note, effect, and macro times are quantized.
+- Each pattern is made of the same number of rows as seen in the tracker view.
+- During playback, each **row** lasts a number of ticks determined by its **speed** value.
+- A **tick** is the smallest measure of time to which all note, effect, and macro times are quantized.
 
 ## sound
 
 Different chips have different capabilities. Even within the same chip, each channel may have its own ways of making sound.
 - Some channels use one or more waveform **generators** (sine, square, noise...) to build up a sound.
 - Of special note are **[FM (frequency modulation)](../4-instrument/fm.md)** channels, which use a number of generators called **operators** that can interact to make very complex sounds.
-- Some channels use **[samples](../6-sample/README.md)** - recordings of sounds, often with defined loop points to allow a note to sustain.
+- Some channels use **[samples](../6-sample/README.md)** which are recordings of sounds, often with defined loop points to allow a note to sustain.
 - Some channels use **[wavetables](../5-wave/README.md)**, which are like very short samples of fixed length that automatically loop.

doc/2-interface/asset-list.md

@@ -3,10 +3,20 @@
 ![instruments window](instruments.png)
 
 Buttons from left to right:
-- **Add**: Creates a new, default instrument.
+- **Add**: pops up a menu to select which type of instrument to add.
+  - If the "Display instrument type menu when adding instrument" setting is disabled, this skips the menu and creates an instrument according to the chip under the cursor.
+  - Right-clicking always brings up the menu.
 - **Duplicate**: Duplicates the currently selected instrument.
 - **Open**: Brings up a file dialog to load a file as a new instrument at the end of the list.
-- **Save**: Brings up a file dialog to save the currently selected instrument.
+- **Save**: Brings up a file dialog to save the currently selected asset.
+  - Instruments are saved as Furnace instrument (.fui) files.
+  - Wavetables are saved as Furnace wavetable (.fuw) files. 
+  - Samples are saved as standard wave (.wav) files.
+  - Right-clicking brings up a menu with the applicable items from this list:
+    - **save instrument as .dmp...**: saves the selected instrument in DefleMask format.
+    - **save wavetable as .dmw...**: saves the selected wavetable in DefleMask format.
+    - **save raw wavetable...**: saves the selected wavetable as raw data.
+    - **save raw sample...**: saves the selected sample as raw data.
 - **Toggle folders/standard view**: Enables (and disables) folder view, explained below.
 - **Move up**: Moves the currently selected instrument up in the list. Pattern data will automatically be adjusted to match.
 - **Move down**: Same, but downward.

doc/2-interface/menu-bar.md

@@ -6,10 +6,10 @@ items in _italics_ don't appear in basic mode and are only available in advanced
 
 # file
 
-- **new...**: create a new song.
+- **new...**: creates a new song.
 - **open...**: opens the file picker, allowing you to select a song to open.
 - **open recent**: contains a list of the songs you've opened before.
-  - **clear history**: this option erases the file history.
+  - **clear history**: erases the file history.
 
 - **save**: saves the current song.
   - opens the file picker if this is a new song, or a backup.
@@ -33,9 +33,9 @@ items in _italics_ don't appear in basic mode and are only available in advanced
     - Neo Geo CD (DefleMask 1.0+)
   - only use this option if you really need it. there are features which DefleMask does not support, like some effects and FM macros, so these will be lost.
 
-- **export audio...**: export your song to a .wav file. see next section for more details.
-- **export VGM...**: export your song to a .vgm file. see next section for more details.
-- **export ZSM...**: export your song to a .zsm file. see next section for more details.
+- **export audio...**: opens the file picker, allowing you to export your song to a .wav file. see next section for more details.
+- **export VGM...**: opens the file picker, allowing you to export your song to a .vgm file. see next section for more details.
+- **export ZSM...**: opens the file picker, allowing you to export your song to a .zsm file. see next section for more details.
   - only available when there's a YM2151 and/or VERA.
 - **export command stream...**: export song data to a command stream file. see next section for more details.
   - this option is for developers.
@@ -48,7 +48,7 @@ items in _italics_ don't appear in basic mode and are only available in advanced
 - _**remove chip...**_: remove a chip.
   - **Preserve channel positions**: same thing as above.
 
-- **restore backup**: restore a previously saved backup.
+- **restore backup**: restores a previously saved backup.
   - Furnace keeps up to 5 backups of a song.
   - the backup directory is located in:
     - Windows: `%USERPROFILE%\AppData\Roaming\furnace\backups`
@@ -87,8 +87,8 @@ the following settings exist:
   - other versions may not support all chips.
   - use this option if you need to export for a quirky player or parser.
     - for example, RYMCast is picky with format versions. if you're going to use this player, select 1.60.
-- **loop**: writes loop. if disabled, the resulting file won't loop.
-- **loop trail**: this option allows you to set how much of the song is written after it loops.
+- **loop**: includes loop information. if disabled, the resulting file won't loop.
+- **loop trail**: sets how much of the song is written after it loops.
   - the reason this exists is to work around a VGM format limitation in where post-loop state isn't recorded at all.
   - this may change the song length as it appears on a player.
   - **auto-detect**: detect how much to write automatically.
@@ -137,6 +137,8 @@ it's not really useful, unless you're a developer and want to use a command stre
 
 # edit
 
+- **...**: does nothing except prevent accidental clicks on later menu items.
+
 - **undo**: reverts the last action.
 - **redo**: repeats what you undid previously.
 

doc/6-sample/README.md

@@ -46,7 +46,7 @@ if you need to use more samples, you may change the sample bank using effect `EB
 
 due to limitations in some of those sound chips, some restrictions exist:
 
-- Amiga: maximum frequency is 31,469Hz, but anything over 28,867 will sound glitchy on hardware. sample lengths and loop will be set to an even number, and your sample can't be longer than 131070.
+- Amiga: maximum frequency is 31469Hz, but anything over 28867 will sound glitchy on hardware. sample lengths and loop will be set to an even number, and your sample can't be longer than 131070.
 - NES: if on DPCM mode, only a limited selection of frequencies is available, and loop position isn't supported (only entire sample).
 - SegaPCM: your sample can't be longer than 65535, and the maximum frequency is 31.25KHz.
 - QSound: your sample can't be longer than 65535, and the loop length shall not be greater than 32767.
@@ -79,7 +79,8 @@ in there, you can modify certain data pertaining to your sample, such as the:
 - **Name**: name in sample list.
 - button to left of **Info**: collapses and expands the info bar.
 - **Type**: sample format. only 8-bit and 16-bit PCM samples are editable. selecting a format converts the sample data.
-- **BRR emphasis**: boosts higher frequencies to compensate for the SNES low-pass filter. should not be enabled for BRR-type samples.
+- **BRR emphasis**: boosts higher frequencies to compensate for the SNES low-pass filter. should not be enabled for BRR-type samples. only appears when applicable.
+- **8-bit dither**: applies dithering to samples meant to play back at 8-bit resolution. only appears when applicable.
 
 - **Rate**: switches to normal rate values.
 - **Compat Rate**: switches to DefleMask-compatible rate values for sample mapping.

doc/8-advanced/comments.md

@@ -2,7 +2,7 @@
 
 ![comments dialog](comments.png)
 
-Comments, credits, or any arbitrary text may be entered here.
+Comments, credits, or any arbitrary text may be entered here.\
 It has no effect on the song.
 
 There is no word wrap; long lines must be broken manually with the Enter key.