Consider the situation where you are editing a file with two equations
labelled `eqn:euler`

and `eqn:einstein`

.
Now you want to insert a reference to one of these equations. To do this,
you type the `\ref{eqn:}`

command and with the cursor
placed after `eqn:`

, press `<F9>`

.
This will bring up two new windows beneath the main window you were working
in as shown in the figure below.

8 These are a couple of equations: 9 +-- 4 lines: eqnarray (eqn:euler) : e^{j\pi} + 1 &=& 0--------------- 13 +-- 4 lines: equation (eqn:einstein) : E = m c^2--------------------- 17 18 These are a couple of figures: 19 +-- 7 lines: figure (fig:monkeys) : Monkeys can Type------------------- 26 +-- 7 lines: figure (fig:shakespeare) : Shakespeare could not type----- 33 34 This is a reference to \ref{eqn:}<++> 35 36 37 \end{document} 38 ~ ~ ~ newfile.tex 34,32 Bot newfile.tex|11| \label{eqn:euler} newfile.tex|15| \label{eqn:einstein} ~ [Error List] 1,1 All 7 8 These are a couple of equations: 9 \begin{eqnarray} 10 e^{j\pi} + 1 &=& 0 11 \label{eqn:euler} 12 \end{eqnarray} 13 \begin{equation} 14 E = m c^2 15 \label{eqn:einstein} 16 \end{equation} newfile.tex [Preview] 11,3 21%

The first window (shown as `[Error List]`

above) is a
`|cwindow|`

containing a list of possible matches for the
reference. The cursor will be located in the first line of this window. The
bottom window is a `preview-window`

showing the context of
the `\label`

. Moving around in the
`[Error List]`

window automatically scrolls the
preview window so as to always keep showing the context of the
`\label`

being viewed in the
`[Error List]`

window. You can also press
`J`

and `K`

in the
`[ErrorList]`

window to scroll the preview window up and
down.

To insert one of the labels, simply position the cursor in the correct line
in the `[Error List]`

window and press
`<enter>`

. This will immediately close the two newly
opened windows, get back to the correct location in the original file being
edited and insert the label into the `\ref`

command.

If you notice carefully in the example above, the
`[Error List]`

window only showed the matches for the
equations and did not list any of the figure labels. This is because we
pressed `<F9>`

after `\ref{eqn:`

instead of simply after `\ref{`

. This caused Latex-Suite to
search only for those labels which started with the string
`eqn:`

. If you had pressed
`<F9>`

after a `\ref{`

, you would
have been shown matches from *all* labels, not just
those starting with `eqn:`

.

Thus prefixing all your labels with `eqn:`

,
`fig:`

, `tab:`

etc. depending on what you
are labelling will lead to an easier time completing references.