Active, Current Projects.

The purpose here is to explain in short what happens when you edit many files and open many projects in iTeXMac at the same time. iTeXMac needs additional information about what to do.

Actually iTeXMac cannot guess from the context if an edited file belongs to a given project, except for the root file, which is annoying for documents splitted in multiple files. One solution is to add information inside each source file to give iTeXMac all the missing information. The solution described here deals with active and current projects.

All open projects are listed in TeX submenu "Activate Project".

Current project:
The current project is the one who actually receives the typesetting directives, even if it is not on screen. The current project is the one in the first item of the project menu.

Active project:
The one checked in TeX submenu "Activate Project" is the active one. When iTeXMac can not find any pertinent information in the source file (with header directives detailed in Typesetting Control from the Source), it chooses as current project the active one.

Change the Active project

You change the active project by activating another one in the TeX appropriate submenu.

Change the Current project

You change the current project by ordering front another project window.

The current project automatically changes when the context changes, for example when you are changing the frontmost window.

Also, when you are editing a TeX source document, iTeXMac looks into its open projects list to see if the source document is the root file of a project. In that case this project automatically becomes the current one. Otherwise, iTeXMac chooses the active project, fixing its root if it is a generic project. In short, iTeXMac understands you changed the project you were working on if you edit a new root file.