restore_hit_points()
FUNKTION:
    int restore_hit_points(int heal)

ARGUMENTE:
    int heal	- der zu heilende Betrag

BESCHREIBUNG:
    Dem Lebewesen werden heal Lebenspunkte aufgeschlagen. Die HP
    steigen nicht ueber P_MAX_HP.

RUECKGABEWERT:
    Die verbleibenden Lebenspunkte.

BEISPIELE:
    write("Ploetzlich schiesst eine scheussliche Kreatur aus der Pfuetze "+
          "heraus und\nschleimt dich heilend voll, sie verschwindet so, "+
          "wie sie gekommen ist.\n");
    this_player()->restore_hit_points(50);

BEMERKUNGEN:
    Bei Heilstellen sollte eine evtl. Heilung des Spielers mit der eigens
    dafuer eingerichteten Funktion check_and_update_timed_key realisiert
    werden.
    Ansonsten bitte buffer_hp() benutzen und die Konzeptseite lesen!

SIEHE AUCH:
    Gegenpart:	reduce_hit_points()
    Verwandt:	buffer_hp(), heal_self(), restore_spell_points()
    Props:	P_HP
    Konzept:	heilung

23.Feb.2004 Gloinson