NAME

NewLoadSeg: Improved version of LoadSeg for stacksizes (V36)

SYNOPSIS

seglist = NewLoadSeg(filename, tags)
D0 D1 D2

BPTR NewLoadSeg(STRPTR, struct TagItem *)

seglist = NewLoadSegTagList(filename, tags)
D0 D1 D2

BPTR NewLoadSegTagList(STRPTR, struct TagItem *)

seglist = NewLoadSegTags(file, ...)

BPTR NewLoadSegTags(STRPTR, ...)

FUNCTION

Loads a load file, similar to LoadSeg(), and takes additional actions based on the tags supplied.

Clears unused portions of Code and Data hunks (as well as BSS hunks). (This also applies to InternalLoadSeg() and LoadSeg()).

NOTE to overlay users: NewLoadSeg() does NOT return seglist in both D0 and D1, as LoadSeg does. The current ovs.asm uses LoadSeg() and assumes returns are in D1. We will support this for LoadSeg() ONLY.

INPUTS

filename: File name of file to load, shall not be NULL.
tags: pointer to tagitem array

RESULT

seglist: Seglist loaded, or NULL

NOTES

The use of NewLoadSeg() is discouraged because its function and scope is limited to what LoadSeg() already accomplishes.

BUGS

No tags are currently defined. This call runs into the function as LoadSeg(), and thus misinterprets the tags in case the name pointer is NULL.