Index | PAL Intro | Commands | Registers | Indices | Stack | Macros | Classes | Attributes | Errors

debug/source - Define source file parameters

CONTENTS

Synopsis
Description
Error Handling
Examples
See Also
Author

debug/source [source_file], #source_line
debug/source #source_line

Sets the current source filename and source line number that is used in error reporting, e.g. stack traces. The source_file argument points to the text definition of the source file, while the source_line argument points to a raw index number defining the current source line number.

These parameters are reset when a function is called using func/call or func/bcall, and restored to their last setting when a function is returned from using func/rtn.

The source_file argument may be omitted, if the source line is the only parameter that needs to be updated. Note however, that as both parameters are reset when a function is called, all new functions must start by setting both.

A runtime error occurs if the arguments are the wrong type.

debug/source [musicians.ps], #101
	Sets source file to musicians.ps, and the source line number to 101.

pal_intro(5), pal_commands(5), pal_indices(5), debug_level(5),
PROSE Assembly Language at prose.sourceforge.net.

Copyright (c) 2002-2009 Mark R. Bannister <cambridge@users.sourceforge.net>.

This is free software and can be downloaded from prose.sourceforge.net; see the source for copying conditions. There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.