more updates

doc/2-interface/song-info.md

@@ -43,13 +43,13 @@ the effective BPM is displayed as well, taking all settings into account.
 - depending on the tempo and tick rate, the results may sound uneven. another way to reach a specific tempo with more control over the results is to use grooves. see the page on [grooves](../8-advanced/grooves.md) for details.
 
 **BPM**: the track's initial tempo in beats per minute.
-- note: this uses the highlight values below in calculating beats.
+- this is calculated using the previous settings and highlight values.
 
 **Highlight**: sets the pattern row highlights:
 - the first value represents the number of rows per beat.
 - the second value represents the number of rows per measure.
-- these don't have to line up with the music's actual beats and measures. set them as preferred for tracking.
-  - note: these values are used for the metronome and calculating BPM.
+- these don't have to line up with the track's actual beats and measures. set them as preferred for tracking.
+- these values are used for the metronome and calculating BPM.
 
 **Pattern Length**: the length of each pattern in rows. this affects all patterns in the song, and every pattern must be the same length. (Individual patterns can be cut short by `0Bxx`, `0Dxx`, and `FFxx` commands.)
 

doc/4-instrument/README.md

@@ -3,7 +3,7 @@
 the instrument editor allows you to edit instruments.
 it can be activated by double-clicking on an instrument in the instrument list.
 
-alternatively, the menu item "window > assets > instrument editor" displays it.
+it can also be found by going to window > assets > instrument editor in the main menu bar.
 
 ## main
 

doc/6-sample/README.md

@@ -65,7 +65,7 @@ due to limitations in some of those sound chips, some restrictions exist:
 - Seta/Allumer X1-010: frequency resolution is terrible in the lower end. your sample can't be longer than 131072.
 - C219: sample lengths and loop will be set to an even number, and your sample can't be longer than 131070.
 
-furthermore, many of these chips have a limited amount of sample memory. check memory usage with the Memory Composition window (menu item "window > debug > memory composition").
+furthermore, many of these chips have a limited amount of sample memory. check memory usage in the Memory Composition window (window > debug > memory composition).
 
 ## the sample editor
 

doc/7-systems/dac.md

@@ -21,4 +21,4 @@ the following options are available in the Chip Manager window:
 - **Maximum volume**: sets the max value in the volume column.
 - **Stereo**: when enabled, you may use panning effects.
 - **Interpolation**: "softens" samples played back at lower rates.
-- **Channels**: sets the number of available channels, from 1 up to 128.
+- **Channels**: sets the number of channels, from 1 to 128.

doc/7-systems/es5506.md

@@ -57,4 +57,4 @@ the following options are available in the Chip Manager window:
 - **Amiga channel volumes**: makes volume linear, from 0 to 64 (40 in hex). used in S3M, XM and IT import.
 - **Amiga-like pitch**: pretends to be an Amiga, with periodic slides. used in S3M, XM and IT import (the latter two when linear slides are disabled).
   - only effective when pitch linearity is None.
-- **Channels**: sets the number of channels available in the tracker, from 5 up to 32.
+- **Channels**: sets the number of channels, from 5 to 32.

doc/7-systems/msm6258.md

@@ -32,4 +32,4 @@ the following options are available in the Chip Manager window:
 
 this chip uses the [MSM6258](../4-instrument/msm6258.md) instrument editor.
 
-when exporting to VGM, make sure that "direct stream mode" is disabled (unchecked).
+when exporting to VGM, make sure that "direct stream mode" is disabled (unchecked) IN THE VGM EXPORT SETTINGS.

doc/7-systems/n163.md

@@ -48,11 +48,11 @@ this chip uses the [Namco 163](../4-instrument/n163.md) instrument editor.
 the following options are available in the Chip Manager window:
 
 - **Clock rate**: sets the rate at which the chip will run.
-- when loading files created in earlier versions of Furnace, there may be a warning here that the legacy channel limit doesn't equal the channel count set below.
-  - **Fix channel count**: changes "Channels" to match the track.
-  - **Give me more channels**: adjusts the track according to "Channels".
+- when loading files created in earlier versions of Furnace, there may be a warning specifying that the legacy channel limit isn't equal to the channel count. in that case, two options will be available:
+  - **Fix channel count**: changes Channels to match the track. note that this is a **destructive** operation!
+  - **Give me more channels**: adjusts the chip to an appropriate channel count.
 - **Disable hissing**: remove TDM artifacts by mixing. sacrifices some accuracy!
 - **Scale frequency to wave length**: automatically adjusts note frequency to account for differing waveform lengths.
   - if disabled, note frequencies ignore waveform length. this is how FamiTracker behaves.
-- **Channels**: sets the number of channels that will be active, from 1 up to 8. higher values reduce volume and make TDM artifacts more noticeable.
- 
+- **Channels**: sets the number of channels, from 1 to 8. higher values reduce volume and make TDM artifacts more noticeable.
+ 

doc/7-systems/segapcm.md

@@ -8,7 +8,8 @@ a chip used in the Sega OutRun/X/Y arcade boards. eventually the MultiPCM surpas
 
 ## 5-channel SegaPCM
 
-Furnace previously had a five channel version of this chip, but it only existed for DefleMask compatibility reasons. when opening older Furnace files and all DefleMask files, the channel count can be corrected by opening the chip config window and clicking the "click here to fix it." button beneath "irregular channel count detected!"
+Furnace previously had a five channel version of this chip, but it only existed for DefleMask compatibility reasons. when opening older Furnace files and all DefleMask files, you may come across a SegaPCM with 5 channels.
+to correct this, configure the chip. a button will allow you to set the channel count back to 16.
 
 ## effects
 

doc/7-systems/ym2610.md

@@ -138,7 +138,8 @@ working with CSM is beyond the scope of this documentation. for more information
 
 ## ADPCM-B
 
-when opening some older Furnace files and all DefleMask files using this chip, the ADPCM-B channel will be absent. this can be corrected by opening the chip config window and clicking the "click here to fix it." button beneath "irregular channel count detected!"
+when opening some older Furnace files and all DefleMask files using this chip, the ADPCM-B channel will be absent.
+this can be corrected by configuring the chip, akin to SegaPCM.
 
 ## chip config
 

doc/8-advanced/grooves.md

@@ -5,7 +5,7 @@ a **groove** is the equivalent of repeating `0Fxx` effects on each row to get a
 ![groove](groove.png)
 
 to set the song's groove:
-- open the ["Speed" window](../2-interface/song-info.md#speed) from the "window" menu in the "tempo" section.
+- go to the [Speed](../2-interface/song-info.md#speed) window (window > tempo > speed).
 - click the "Speed" button so it becomes "Speeds" (effectively a groove of two speeds).
 - click again so it becomes "Groove".
 - enter a sequence of up to 16 speeds.

doc/9-guides/tuning-samples.md

@@ -15,4 +15,4 @@ for this example, we'll use a sample of a note played at E and recorded at 22050
 
 to find the frequency of a note, open the [tuner](../8-advanced/tuner.md) (window > visualizers > tuner). when sound is played, the tuner will continually update to show the note closest to it. this corresponds to the highest peak shown in the [spectrum analyzer](../8-advanced/spectrum.md) (window > visualizers > spectrum).
 
-if notes seem "capped" – for example, playing anything over D-6 sounds like a D-6 – those notes exceed the maximum sample playback rate for the chip. the only solution is to use "Resample" to change the sample to a lower rate. similarly, if samples sound fine in the editor but out of tune when used in the track, there may be limitations on available playback rates. check the [chip's documentation](../7-systems/README.md) for details.
+if notes seem "capped" (for example, playing anything over D-6 sounds like a D-6), those notes exceed the maximum sample playback rate for the chip. the only solution is to use "Resample" to change the sample to a lower rate. similarly, if samples sound fine in the editor but out of tune when used in the track, there may be limitations on available playback rates. check the [chip's documentation](../7-systems/README.md) for details.