Next: About this document Up: Command Keys Previous: Tips

# Double-clicking

The arguments of certain LaTeX commands are command-double-clickable, that is, you hold down the <CMD> key while double-clicking the argument of certain LaTeX commands. These commands are underlined and therefore easily recognized in your document. When you command-double-click the required argument of a `\ref` command, for example, the cursor jumps to the corresponding `\label`. (Note: Press <CTL .> to return to the original cursor position.) Similarly, when you cmd-dbl-click the required argument of a `\cite` command, the cursor jumps to the corresponding `\bibitem` if the document contains a `thebibliography` environment; otherwise, the arguments of a `\bibliography` command are sequentially searched until the `.bib` file containing the target item is found. This `.bib` file is then opened and the cursor jumps to the target item.

Tip: By default, `\ref`, `\pageref`, `\cite`, and `\nocite` commands are cmd-dbl-clickable. If you use a package that defines other `\ref`-like or `\cite`-like commands, modify the TeX mode variables refCommands or citeCommands discussed in section 1.4.2.

Other LaTeX commands may also be command-double-clicked, for example, `\input`, `\include`, `\includegraphics` (or rather the commands specified in the TeX mode variable boxMacroNames mentioned in section 1.4.2), `\bibliography`, `\usepackage`, and `\documentclass`. Note that the required arguments of these commands are files, and so command-double-clicking such an argument opens the corresponding file. Unless the filename includes a Macintosh path (which is not recommended, since it's not portable), the current folder is searched first. If the file is not found in the current folder, the algorithm next checks the hierarchy of folders under the user-specified ``TeX Inputs Folder'', which is optionally set by choosing App Paths on the Config menu. If the file is still not found, all folders whose name contains the string ``inputs'' in the TeX application folder are checked next. For example, all folders in the TeX folder with names such as `TeX-inputs`, `TeX-inputs2`, and `My-TeX-inputs` will be searched.

Tip: A command-double-click operation may be simulated with a keystroke. With the cursor inside the required argument of a cmd-dbl-clickable LaTeX command, press <F6> to activate the algorithm.

Alpha has another modified double-click that will be of interest to LaTeX users. You may already know that double-clicking a delimiter (parenthesis, bracket, or brace) selects the text between it and its matching delimiter. Moreover, if you hold down the <CTL> key while double-clicking a delimiter, the text and the delimiters will be selected. These commands are very handy for cutting and pasting blocks of delimited text, especially in a LaTeX document where braces, for example, run rampant.

Next: About this document Up: Command Keys Previous: Tips