NAME
====
  vg_sound_pate() - pause a (group of) soundfile(s), when at end


SYNOPSIS
========
  void vg_sound_pate(const char * sgname)


DESCRIPTION
===========
  Pauses a playing soundfile or a group of playing soundfiles or all,
  when it/they reached its/their end.

  sgname is a sound-name for a single soundfile (refer to vg_sound_attach()),
    a group-name for a group of soundfiles (refer to vg_sound_gadd()),
    or "ALL" for all soundfiles.

  Refer to Understanding sound: "Pausing a sound at its end"
  for a short description when to use this function.


RETURN VALUE
============
  No value is returned.


SEE ALSO
========
  Index
  Understanding sound
  vg_sound_startserver()
  vg_sound_endserver()
  vg_sound_attach()
  vg_sound_play()
  vg_sound_paus()
  vg_sound_cont()
  vg_sound_catb()
  vg_sound_stop()
  vg_sound_gclr()
  vg_sound_gadd()
  vg_sound_gdel()
  vg_sound_volm()
  vg_sound_volumename()