On-line Help Tags

Glossary of On-line Help Terms

Chapter 15: Ohbld Error Messages

This chapter lists the error messages issued by the On-line Help Builder.

The On-line Help Builder issues error messages with the following severity levels:

• Fatal - Indicates an unrecoverable error. Building of the help file stops.
• Error - Indicates a tag or directive that the On-line Help Builder cannot understand. Building of the help file continues but the syntax at fault is ignored.
• Warning - Indicates a tag or directive that might contain an error even though it is syntactically correct

The severity level is indicated by the last letter of the error message number.

You can disable reporting of warnings using the WARNING directive.

When the On-line Help Builder has finished, the total number of errors in each category is output.

OHB001F Illegal command line

• The On-line Help Builder command line you specified was not correct. This could have been due to a missing file or an incorrectly specified parameter.

OHB002F Failed to open source file source-filename

• The source file could not be opened. This is normally because it was not found as specified.

OHB003E Unknown Ohbld directive

• You have attempted to specify an unknown directive on the On-line Help Builder command line.

OHB005E Failed to open /DEFINE file def-filename

• The file you specified in the /DEFINE directive cannot be opened. This could be due to lack of disk space, or because a file with the name specified already exists but is locked by another process or marked as read-only.

OHB006E Failed to open /CPY file cpy-filename

• The file you specified in the /CPY directive cannot be opened. This could be due to lack of disk space, or because a file with the name specified already exists but is locked by another process or marked as read-only.

OHB007E Failed to open /LIST file list-filename

• The file you specified in the /LIST directive cannot be opened. This could be due to lack of disk space, or because a file with the name specified already exists but is locked by another process or marked as read-only.

OHB011E Heading tag or .context expected

• The first tag in the source text must be one of .title, .define, .comment or a heading. The first tag in your source, however, is not one of these.

OHB012W .title has no text

• Your source contains a .title tag with no following text for the title. The result is as if no .title tag was included.

OHB013W More than one .title specified. The first one will be used

• Your source contained more than one .title tag. Only the first .title tag is used.

OHB016E Unknown parameter

• A tag was specified with an invalid parameter. Examples of tags that could lead to this error are :h1, :h2, :dl. and :sl.

OHB017E This tag is only valid at the start of the source

• A .define or .title tag has been used after the start of the first topic. Move the tag to the start of the source or move preceding topics so they start after this tag.

OHB020W Duplicate .define - ignored

• You have tried to use the same topic-name in two define commands.

OHB021E Local context name expected after .define

• The first parameter to a .define command must be a local topic-name. That is, it must have a leading @ character.

OHB022W .define context name too long. Truncated to 32 characters

• The local topic-name specified in a .define command was too long. It was truncated to 32 characters.

OHB023E .define name has no context number

• You did not specify a context number in a .define command.

OHB030E Context name context-name is already defined

• You tried to specify an external topic-name more than once. This is not allowed.

OHB031E Context no. reserved for topic-name is used by another topic

• You tried to use the same context number for two separate topics. This is not allowed.

OHB032W Topic has more than one context number

• A topic has multiple local topic names attached to it, and more than one of these is referenced prior to being defined. This causes more than one context number to point to the same topic, wasting space in the look-up table.

  You can avoid this by using only one local name for each topic, or only referring to the first local name defined for a topic prior to the topic appearing, or using a .define tag to attach the same context number to the names prior to their use.

OHB034E Topic has too many context names

• A single topic is allowed a maximum of 32 context names. Those beyond the 32nd were ignored.

OHB035E Topic has no context number

• You used an :hn tag to define a topic but did not specify a value for topic-name.

OHB036W Heading level is wrong

• You have incorrectly specified a heading tag. An :h2 tag must follow either an :h1 tag or another :h2 tag. An :h3 tag must follow either an :h2 tag or another :h3 tag.

OHB040E Hotspot has no text

• You have defined a hotspot that contains no text. This occurs if the \v tag is immediately preceded by the \a tag.

OHB042E Illegal reference

• You have tried to specify an illegal hotspot reference.

  Make sure that there is a delimiting \v tag at the end of the hotspot, and that there is a reference present between the two \v tags.

OHB043E source-filename line line-no: local context context-name undefined

• A local topic-name has been used as a cross-reference but does not appear in a .context command.

OHB050W Context name truncated to 32 characters

• A topic-name was too long. It was truncated to 32 characters.

OHB051E In a single pass, context numbers may only be reserved at start

• The RES option in a heading tag can be used only when the /PASS2 directive is specified on the On-line Help Builder command line.

OHB063W .topic has no text

• A topic containing no text was found. This is not allowed.

OHB064E Topic is too large

• The text in a topic to be stored in the on-line file must not be larger than 32 Kilobytes, including control characters. In the unlikely event of getting this error you should consider reducing the size of your topics in the interests of usability.

OHB065F End of source, no topics found

• The On-line Help Builder reached the end of the source file specified without encountering any topics.

• Make sure that you specified the correct source file.

OHB066W Title text is too long. Truncated to 80 characters

• The title of a file was too long. It was truncated to 80 characters.

OHB067W Topic size exceeds 32K. It will not be compressed

• The topic in the .hnf file is larger than 32K, which is the size limit imposed by the compression program CBLDC002. When a topic is larger than this, it is stored in its non-compressed form. This affects only the size of the on-line help file; it has no effect when displaying the topic.

OHB070E Illegal browse chain id

• The only value you can specify for a browse chain id is #1.

OHB071E .browse local context expected

• Both topic names in the browse command must be local topic-names or numbers.

OHB090E .command must immediately follow context

• The .command tag must be specified immediately after the .context, :h1, :h2 or :h3 tags.

OHB091E Tag is illegal in a command topic

• The only tags allowed in a command topic are call, :i1, :i2, ..index, :exec and :shell.

OHB093E Tag is only allowed in a command topic

• The :call, :exec and :shell tags can be used only in a command topic.

OHB095E Command has no text

• You have specified a :call or :exec tag without a parameter. This is not allowed.

OHB102E ..index has no text

• An ..index tag was specified without any following text. The tag was ignored.

OHB111W Attribute found in hotspot text

• Text attributes are not allowed in hotspot text.

OHB113W :ehp tag is incorrect

• A closing :ehp?. tag was found without an associated opening :hp?. tag. For example, you might have specified the start of highlighted text using :hp1., but turned off the highlighting using :ehp2.

OHB132W List item is not inside a list

• A list item was found with no start-of-list tag preceding it. It was taken to be a :p. tag.

OHB136E End of list tag is invalid

• An end-of-list tag was found without a matching start-of-list tag. The tag was ignored.

OHB137E End of list tag expected

• A start-of-list tag was found without a matching end-of-list tag.

OHB138W definition tag expected

• A term tag (:dt. or :pt.) was found when a definition tag (:dd. or :pd.) was expected.

OHB139W defn list term expected

• A definition tag (:dd. or :pd.) was found when a term tag (:dt. or :pt.) was expected.

OHB140W Line truncated to 76 characters

• A line in a fixed-lines block was too long. It was truncated to 76 characters.

OHB142W :ecgraphic or :elines expected

• A :cgraphic. tag did not have a matching :ecgraphic. tag, or a :lines. tag did not have a matching :elines. tag.

OHB150W Boolean variable variable-name is undefined

• A conditional expression used a Boolean variable that had not been set by /IGNORE or /INCLUDE on the On-line Help Builder command line.

OHB153E Unknown boolean operator

• The only Boolean operators allowed in a conditional expression are AND, NOT and OR.

OHB155E Boolean variable expected

• No condition was found after a $if tag.

OHB156E $if at line line-no has no $end.

• A $if tag was found with no matching $end tag.

OHB160W Full stop ('.') expected after tag

• A tag was found without its trailing ".".

OHB161E .br only allowed in text

• The .br tag can only be used in paragraph text.

OHB170E :i2 refid index-entry is not defined in an :i1 entry

• The i1-id-name specified by an :i2. tag was not defined as an :i1. index entry.

OHB171W Index text too long. Truncated to 80 characters

• The text specified as an index entry was too long. It was truncated to 80 characters.

OHB172W Too many index items

OHB200W Failed to open text file

OHB201W Artlink expected

OHB202W Invalid item in artlink file

OHB203W Artwork missing

OHB204W Unknown tag

OHB205W Invalid token

OHB206W Too many browse chains

OHB212F Files limit exceeded

OHB213F Boolean limit exceeded

OHB214F i1 tag limit exceeded

OHB215F i2 tag limit exceeded

OHB216F Macro limit exceeded

OHB217F Globals limit exceeded

OHB218F Restable limit exceeded

OHB219F Topic control limit exceeded

OHB220F Topic text limit exceeded

• The text for a topic is too long. This may be caused by heading tags (:h1, :h2, etc) being incorrectly coded.

OHB221F HNF file size limit exceeded

OHB222F Local topic limit exceeded

OHB223F im limit exceeded

OHB224F Browse limit exceeded

OHB225F Topic start limit exceeded

OHB226W Line length limit exceeded

On-line Help Tags

Glossary of On-line Help Terms