fix github issue 361 to make user_sounds useful even if MSGTYPE is hidden

fixes #361

Also, experminental introduction of vt_sounddata to enable tty to pass
a sound file index to the terminal side of things where perhaps someone
can add code to something like hterm to take the information relayed by
NetHack to trigger user_sounds locally even if playing on a server.

Compile time option TTY_SOUND_ESCCODES required to build that support in.

It should be independent of TTY_TILE_ESCCODES.

doc/Guidebook.mn

@@ -35,7 +35,7 @@
 .ds vr "NetHack 3.7
 .ds f0 "\*(vr
 .ds f1
-.ds f2 "June 20, 2020
+.ds f2 "July 2, 2020
 .
 .\" A note on some special characters:
 .\" \(lq = left double quote
@@ -4662,6 +4662,8 @@ the pattern to match;
 the sound file to play;
 .PL volume
 the volume to be set while playing the sound file.
+.PL "vt_sounddata index"
+optional - the index corresponding to a sound file;
 .PE
 .lp ""
 The pattern should be a POSIX extended regular expression.

doc/Guidebook.tex

@@ -45,7 +45,7 @@
 %.au
 \author{Original version - Eric S. Raymond\\
 (Edited and expanded for 3.7 by Mike Stephenson and others)}
-\date{June 20, 2020}
+\date{July 2, 2020}
 
 \maketitle
 
@@ -5110,6 +5110,7 @@ Each SOUND entry is broken down into the following parts:
 {\tt pattern   } --- the pattern to match;\\
 {\tt sound file} --- the sound file to play;\\
 {\tt volume    } --- the volume to be set while playing the sound file.
+{\tt sound index } --- optional - the index corresponding to a sound file.
 %.ei
 %.ed
 \elist

doc/fixes37.0

@@ -298,6 +298,10 @@ Unix: when user name is used as default character name, keep hyphenated value
 	intact instead stripping off dash and whatever follows as if that
 	specified role/race/&c (worked once upon a time; broken since 3.3.0)
 Unix: add "ec2-user" to the list of user names 'sysconf' classifies as generic
+user_sounds: move the message hook from inside individual window display ports
+	to the core where it allows MSGTYP_NOSHOW msgtyp's to still trigger
+	sounds to correct a reported github issue; also fixes a past reported
+	issue that the curses port on Windows not working with user_sounds
 Windows: update for new status condition fields
 Windows: include commented-out 'PORTABLE_DEVICE_PATHS' in sysconf.template
 X11: substantial overhaul of status display, both 'fancy' and 'tty-style'
@@ -384,6 +388,11 @@ record number of wishes and artifact wishes in xlogfile
 
 Platform- and/or Interface-Specific New Features
 ------------------------------------------------
+user_sounds: provide an experimental mechanism for terminal-side sounds similar
+	to the method used for vt_tiledata; new option vt_sounddata that also
+	requires compile-time definition of TTY_SOUND_ESCCODES (also requires
+	terminal-side code external to NetHack to recognize the sequence and
+	act on it
 
 
 NetHack Community Patches (or Variation) Included