PCE version 4C hlp_bufferfirst_fragment last_fragmenteditorsmodifiedundo_buffer_sizesyntaxrequest_renumberfileOIxC hlp_fragment text_buffernextpreviousstylelabelOIxRIOIxRIC hlp_header text_buffernextpreviousstylelabelOIxRIOIxRIOIxRIOIxRIOIxRIOI xRIOI xRIOI xRIOI xRIOI xRIOIxRIOIxRIOIxRIOIxRIOIxRIOIxRIOIxRIOIxRIOIxRIOIxRIOIxRIOIxRIOIxRIOIxRInRINexamplenØ.RINboldnÍRIN subsectionN4.2.__starting_the_help-systemTRINexamplenöRINexamplenE)RINboldnûRIN subsectionN(4.1.__declaring_an_application_help_file(RINsectionN,4.__calling_the_manual_from_your_applicationQ,RINboldn4RINboldnRINboldNbuttonRINbuttonNbuttonùRINboldnÌRI Nboldn„RI NsectionNreadingÙRI Nboldn~ RI NsectionN2.__introduction:RI NbuttonN4.2.__starting_the_help-systemRINbuttonN(4.1.__declaring_an_application_help_fileí(RINbuttonN,4.__calling_the_manual_from_your_application¼,RINbuttonNreading¤RINbuttonN2.__introduction’RINbuttonN 1.__contents„ RINsectionN 1.__contentsu RIN emphasizen&nNtitlenRInaI'Adefault_syntax_tableuCfilenamepathkindstatusfilterOIxNhelp.hlpN'/staff/jan/src/xpce/prolog/lib/help.hlpNbinaryNwriten XPCE Application Help System By Jan Wielemaker SWI, University of Amsterdam, E-mail: jan@swi.psy.uva.nl 1. Contents 1. Contents 2. Introduction 3. Reading the Manual 4. Calling the manual from your application 4.1. Declaring an application help file 4.2. Starting the help-system 2. Introduction The XPCE application help-system is a very simple hyper-text system with some interface hooks that may be used by application-programmers. 3. Reading the Manual The manual is built around an XPCE editor object and provides a GNU-Emacs look alike interface. Important key-bindings: \C-s Start incremental search forward \C-r Start incremental search backward \C-hb Display key-binding table Text printed like this: ``button'' represents a button. Double-clicking on a button jumps to the related text. 4. Calling the manual from your application 4.1. Declaring an application help file To call this manual from a Prolog application you have to declare a help-file and labels in this help file. A help-file is declared using the directive :- pce_help_file(+Identifier, +FileName). `Identifier' should be a unique identifier for your application. `FileName' is the name of a local file, normally with the extension .hlp. The first time you call the help system it will prompt you to create a new help file. 4.2. Starting the help-system To start a help-view given an application identifier and a label, just send a message to @helper: send(@helper, give_help, +Identifier, +Label). x