get-next-line(2)

NAME

get-next-line - Find the next command line

SYNOPSIS

n get-next-line (C-x `) 

DESCRIPTION

get-next-line is typically used in conjunction with the compile(3) and grep(3) commands to enable the user to step through errors/locations one by one. The command looks for lines in the form defined by add-next-line(2) in the order of definition. If a match is found the command attempts to find the next error or warning found from the current location (See compile(3)). If the buffer was not found then the next buffer set is searched for, and if found then the next expression from the cursor is automatically located. The command fails if none of the buffers exist, or the end of the buffer is reached.

The argument n can be used to change the default behavior of get-next-line described above, n is a bit based flag where:-

0x01


Use popup-window to display the buffer containing the next location in a different window (default) when this flag is not given the window containing the 'next' command output, or the current window if the 'next' command output is not currently displayed.

0x02


When set the command returns an error if the current buffer is not a 'next' command buffer, this effectively forces the command to only get the next line in the current buffer. This flag is used by ipipe output processing macros to highlight error lines in the current buffer.

0x04


When set the command does not open the file/buffer containing the next location, leaving the 'next' command buffer current with the cursor at the next line.

0x08


When set the command does not attempt to get the next line, this can be used to simply go to the most current 'next' command buffer or, if used in conjunction with bit 0x02, to confirm the current buffer is a 'next' command buffer.

SEE ALSO

$file-template(5), $line-template(5), add-next-line(2), keep-next-buffer(3), compile(3), grep(3).

(c) Copyright JASSPA 2025
Last Modified: 2025/01/28
Generated On: 2025/09/29