kdocParseDoc

Routines for parsing of javadoc comments.

newDocComment

Parameters: begin (starting line of declaration)

Reads a doc comment to the end and creates a new doc node.

Read a line
check if it changes the current context
	yes
		flush old context
		check if it is a non-text tag 
					(ie internal/deprecated etc)
			yes
				reset context to text
				set associated property
			no
				set the new context
				assign text to new buffer
	no	add to text buffer
		continue
at end
	flush anything pending.

setType

Parameters: propname, proptype ( 0 = single, 1 = list, 2 = text )

Set the name and type of the pending property.

flushProp

Flush any pending item and reset the buffer. type is set to DocText.

codeProp

Flush the last node, add a new property and reset type to DocText.

docListProp

The next item is a list property of docNode.

docProp

The next item is a simple property of docNode.

textProp

Parameters: prop, val

Set next item to be a 'Text' list node. if val is assigned, the
new node is assigned that text and flushed immediately. If this
is the case, the next item is given the 'DocText' text property.

initDocNode

Creates docNode if it is not defined.

attachDoc

Connects a docnode to a code node, setting any other properties if required, such as groups, internal/deprecated flags etc.