// help_gen.h3

private:        void  help_gen :: mae2rtf

/* -----------------------------------------------------------------------------

   Der Aufrufer garantiert:

   -   String  from  enth„lt einen Backslash nur als erstes Symbol eines rtf-

       Befehls (genau dort also, wo er  n i c h t  nach  \\  zu transformieren

       w„re).

   Dir Funktion garantiert:  errno == 0

   -----------------------------------------------------------------------------

*/ (

char *         to

,  char *         from

) ;

private:        char *  help_gen :: set_ptc

/* -----------------------------------------------------------------------------

                   set ptc = encoded pt

   -----------------------------------------------------------------------------

*/ (

char *          pt                          

) ;

private:        on_page *  help_gen :: page_dir

/* -----------------------------------------------------------------------------

   Der Aufrufer garantiert:

   -   ref // 0  genau dann, wenn noch kein Eintrag  pt  existiert.

   -   Aufrufers Auftrag: Ab sofort soll genau ein Eintrag  pt  existieren.

       Return den Zeiger darauf.

   Die Funktion garantiert:  errno == 0

   -----------------------------------------------------------------------------

*/ (

char *          pt                          

,  BOOL            ref           //  reference to page or page itself   ) ;

private:        void  help_gen :: suggest_page_for

/* -----------------------------------------------------------------------------

   Der Aufrufer sagt:

   -   Hot Spot 'p kennt noch nicht die Seite, die er referenziert.

   -   Auftrag: Man finde sie unter der Annahme, daá ihr Titel nahezu identisch

       ist mit dem Titel des Hot Spots. Was 'nahezu identisch' bedeutet, wird

       definiert per 'tolerance. Hat sie den Wert 0, so bedeutet 'nahezu iden-

       tisch' wirklich 'exakt identisch'. Die genaue Definition des Begriffs

       definiert der Code zur Methode might_refer_to().

       Wird kein nahezu identischer page title gefunden, so wird als Ziel des

       Hot Spots die Seite 'ptc_sorry definiert.

   Die Funktion garantiert:  errno == EN_ok

                             und wohldefinierten Wert von p->suggested.

   -----------------------------------------------------------------------------

*/ (

on_page *       p

,  int             tolerance

) ;

private:        BOOL  help_gen :: might_refer_to

/* -----------------------------------------------------------------------------

               return BOOL( 'ptc might refer to suggested page 'pt )

   -----------------------------------------------------------------------------

*/ (

char *          pt                              

,  int             tolerance     //   ) ;