!*************************************************************************
!									 *
! © Copyright 2005 Hewlett-Packard Development Company, L.P.		 *
!									 *
! Confidential computer software. Valid license  from  HP  required  for *
! possession, use or copying. Consistent with  FAR  12.211  and  12.212, *
! Commercial Computer Software,  Computer  Software  Documentation,  and *
! Technical  Data  for  Commercial  Items  are  licensed  to  the   U.S. *
! Government under vendor's standard commercial license.		 *
!									 *
!*************************************************************************
 
!++
! Facility:
!   eXtended LSE
! 
! Abstract:
!   Defines Help "language" templates compatible with DECwindows Help.
! 
! Author:
!   W. Ward Clark, LinkWorks Project
! 
! Creation Date: 10-Sep-88
! 
! Modification History:
!   X1.3    WWC  15-Jan-89  normalize LSE command syntax
!			    1988 --> 1989
!   X3.0    WWC   1-Jan-90  upgrade to LSE V3.0
!                           1989 --> 1990
!   X3.0-1  WWC  28-Jan-90  add PDF definitions
!   X3.1    WWC  29-Oct-91  1990 --> 1991
!   X4.0a   WWC  24-Feb-93  make modification-id an optional placeholder
!   X4.0a-1 WWC  24-Feb-93  1991 --> 1993
!--
!
DELETE LANGUAGE help
DEFINE LANGUAGE help -
    /COMMENT=( -
	ASSOCIATED_IDENTIFIER = PREVIOUS, -
	NOBEGIN, -
	NOEND, -
	NOFIXED, -
	LINE=("!"), -
	NOTRAIL) -
    /CAPABILITIES=NODIAGNOSTICS -
    /COMPILE_COMMAND="" -
    /EXPAND_CASE=AS_IS -
    /FILE_TYPES=(.HLP) -
    /NOHELP_LIBRARY -
    /IDENTIFIER_CHARACTERS= -
	"abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ%$_0123456789" -
    /INITIAL_STRING="[module]" -
    /LEFT_MARGIN=CONTEXT_DEPENDENT -
    /OVERVIEW_OPTIONS=( -
        MINIMUM_LINES=1, -
        TAB_RANGE=(4,8)) -
    /PLACEHOLDER_DELIMITERS=( -
        REQUIRED=      ("{","}"), -
        REQUIRED_LIST= ("{","}..."), -
        OPTIONAL=      ("[","]"), -
        OPTIONAL_LIST= ("[","]..."), -
        PSEUDOCODE=    ("«","»")) -
    /PUNCTUATION_CHARACTERS=",;()""" -
    /NOQUOTED_ITEM -
    /RIGHT_MARGIN=56 -
    /TAB_INCREMENT=8 -
    /TOPIC_STRING="" -
    /WRAP -
    /VERSION="(XLSE X4.0a)"

SET LANGUAGE help

DELETE PLACEHOLDER *
DELETE TOKEN *
!
!+
!   Language-independent definitions
!-
DELETE PLACEHOLDER "lse$block_comment"
DEFINE PLACEHOLDER "lse$block_comment" -
    /TYPE=NONTERMINAL

    "! {tbs}"
    "!"

    END DEFINE

DELETE PLACEHOLDER "lse$generic"
DEFINE PLACEHOLDER "lse$generic" -
    /TYPE=NONTERMINAL

    "{tbs}"

    END DEFINE

DELETE PLACEHOLDER "lse$line_comment"
DEFINE PLACEHOLDER "lse$line_comment" -
    /TYPE=NONTERMINAL

    "! {tbs}"

    END DEFINE

DEFINE PLACEHOLDER "tbs" -
    /DESCRIPTION="field to be specified" -
    /TOPIC="" -
    /TYPE=TERMINAL

    "to be specified"

    END DEFINE

DEFINE TOKEN "tbs" -
    /DESCRIPTION="to-be-specified"
    "[tbs]"
    END DEFINE

DEFINE PLACEHOLDER "module" -
    /DESCRIPTION="Help Language Module" -
    /TYPE=NONTERMINAL

    "[module-level-comments]"
    ""
    "[level-1-topic]..."

    END DEFINE

DEFINE TOKEN module /PLACEHOLDER=module

DEFINE PLACEHOLDER "module-level-comments" -
    /DESCRIPTION="" -
    /DUPLICATION=VERTICAL -
    /TYPE=NONTERMINAL

    "!++"
    "! Facility:"
    "!     {tbs}"
    "!"
    "! Abstract:"
    "!     {tbs}"
    "!"
    "! Author:"
    "!     {tbs}"
    "!"
    "! Creation Date: {tbs}"
    "!"
    "! Modification History:"
    "!--"

    END DEFINE
!+
!   Modification History definitions
!-
DEFINE TOKEN "new_modification" -
    /DESCRIPTION="modification history entry"
    "    [modification-id]  {your-initials}  {modification-date}  {modification-remark}"
    END DEFINE

DEFINE PLACEHOLDER "modification-id" -
    /DESCRIPTION="modification identification number" -
    /TYPE=TERMINAL

    "modification identification number"

    END DEFINE

DEFINE PLACEHOLDER "your-initials" -
    /DESCRIPTION="your initials" -
    /TYPE=TERMINAL

    "your initials"

    END DEFINE

DEFINE PLACEHOLDER "modification-date" -
    /DESCRIPTION="modification date" -
    /TYPE=TERMINAL

    "modification date (dd-mmm-yy)"

    END DEFINE

DEFINE PLACEHOLDER "modification-remark" -
    /DESCRIPTION="brief description of a modification" -
    /TYPE=TERMINAL

    "brief description of the modification"

    END DEFINE

DEFINE PLACEHOLDER "text" -
    /DESCRIPTION="any text" -
    /TYPE=TERMINAL

    "any text"

    END DEFINE
!
!+
!   Help-specific language definitions
!-
DEFINE PLACEHOLDER "topic" -
    /DESCRIPTION="Help topic" -
    /TYPE=MENU
    "level-1-topic" /PLACEHOLDER
    "level-2-topic" /PLACEHOLDER
    "level-3-topic" /PLACEHOLDER
    "level-4-topic" /PLACEHOLDER
    "level-5-topic" /PLACEHOLDER
    "level-6-topic" /PLACEHOLDER
    END DEFINE

DEFINE TOKEN "topic" /PLACEHOLDER="topic"

DEFINE PLACEHOLDER "level-1-topic" -
    /DESCRIPTION="Level-1 help topic" -
    /DUPLICATION=VERTICAL -
    /TYPE=NONTERMINAL

    "1 {topic-id}"
    "=TITLE [title-string]"
    "=KEYWORD [keyword-string]..."
    " {text}"
    ""
    "[level-2-topic]...

    END DEFINE

DEFINE TOKEN "1" /PLACEHOLDER="level-1-topic"

DEFINE PLACEHOLDER "level-2-topic" -
    /DESCRIPTION="Level-2 help topic" -
    /DUPLICATION=VERTICAL -
    /TYPE=NONTERMINAL

    "2 {topic-id}"
    "=TITLE [title-string]"
    "=KEYWORD [keyword-string]..."
    " {text}"
    ""
    "[level-3-topic]...

    END DEFINE

DEFINE TOKEN "2" /PLACEHOLDER="level-2-topic"

DEFINE PLACEHOLDER "level-3-topic" -
    /DESCRIPTION="Level-3 help topic" -
    /DUPLICATION=VERTICAL -
    /TYPE=NONTERMINAL

    "3 {topic-id}"
    "=TITLE [title-string]"
    "=KEYWORD [keyword-string]..."
    " {text}"
    ""
    "[level-4-topic]...

    END DEFINE

DEFINE TOKEN "3" /PLACEHOLDER="level-3-topic"

DEFINE PLACEHOLDER "level-4-topic" -
    /DESCRIPTION="Level-4 help topic" -
    /DUPLICATION=VERTICAL -
    /TYPE=NONTERMINAL

    "4 {topic-id}"
    "=TITLE [title-string]"
    "=KEYWORD [keyword-string]..."
    " {text}"
    ""
    "[level-5-topic]...

    END DEFINE

DEFINE TOKEN "4" /PLACEHOLDER="level-4-topic"

DEFINE PLACEHOLDER "level-5-topic" -
    /DESCRIPTION="Level-5 help topic" -
    /DUPLICATION=VERTICAL -
    /TYPE=NONTERMINAL

    "5 {topic-id}"
    "=TITLE [title-string]"
    "=KEYWORD [keyword-string]..."
    " {text}"
    ""
    "[level-6-topic]...

    END DEFINE

DEFINE TOKEN "5" /PLACEHOLDER="level-5-topic"

DEFINE PLACEHOLDER "level-6-topic" -
    /DESCRIPTION="Level-6 help topic" -
    /DUPLICATION=VERTICAL -
    /TYPE=NONTERMINAL

    "6 {topic-id}"
    "=TITLE [title-string]"
    "=KEYWORD [keyword-string]..."
    " {text}"

    END DEFINE

DEFINE TOKEN "6" /PLACEHOLDER="level-6-topic"

DEFINE PLACEHOLDER "topic-id" -
    /DESCRIPTION="Help topic identifier string" -
    /SEPARATOR=" " -
    /TYPE=TERMINAL

    "Enter a topic identifier string (with no spaces)"

    END DEFINE

DEFINE PLACEHOLDER "title-string" -
    /DESCRIPTION="Help topic title" -
    /LEADING="=TITLE" -
    /TYPE=TERMINAL

    "Enter a title for the topic"

    END DEFINE

DEFINE PLACEHOLDER "keyword-string" -
    /DESCRIPTION="Help topic keyword" -
    /LEADING="=KEYWORD" -
    /SEPARATOR="," -
    /TYPE=TERMINAL

    "Enter a topic keyword (with no spaces)"

    END DEFINE

DEFINE TOKEN "TITLE" -
    /DESCRIPTION="=TITLE command" -

    "=TITLE {title-string}"

    END DEFINE

DEFINE TOKEN "=TITLE" -
    /DESCRIPTION="=TITLE command" -

    "=TITLE {title-string}"

    END DEFINE

DEFINE TOKEN "KEYWORD" -
    /DESCRIPTION="=KEYWORD command" -

    "=KEYWORD {keyword-string}..."

    END DEFINE

DEFINE TOKEN "=KEYWORD" -
    /DESCRIPTION="=KEYWORD command" -

    "=KEYWORD {keyword-string}..."

    END DEFINE

DEFINE TOKEN "INCLUDE" -
    /DESCRIPTION="=INCLUDE command" -

    "=INCLUDE {full-topic-id-path}"

    END DEFINE

DEFINE TOKEN "=INCLUDE" -
    /DESCRIPTION="=INCLUDE command" -

    "=INCLUDE {full-topic-id-path}"

    END DEFINE

DEFINE PLACEHOLDER "full-topic-id-path" -
    /DESCRIPTION="Sequence of topic ids" -
    /TYPE=NONTERMINAL

    "{topic-id}..."

    END DEFINE