Position

The buffer ordering system is configured by setting various position variables. A position is either a number, giving the index of insertion into a buffer-list, or it is a function that returns such an index. The position 0 is the front of a buffer-list.

When a position is given as a function, the function takes three arguments and returns an index. The arguments are:

container
the buffer_container being inserted into
buffer
the buffer being inserted
i
the index of another buffer, appropriate to the action taking place.

For example, when you follow a link in a new buffer, the argument i is the index of the buffer containing the link.

Several position functions are provided by Conkeror to cover the most common cases:

buffer_position_before
before the other buffer.
buffer_position_after
after the other buffer.
buffer_position_end
the end of the buffer list.
buffer_position_end_by_type
after the last buffer of the same type.