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.