Troubleshooting Guide

This page is intended to help troubleshoot common issues.

If you encounter any issues not described here, please let me know. You can reach me by email at support at compositorapp dot com or via Twitter.

Alright, let’s see what error messages Compositor has to offer.

“File not found”

FileNotFound

The Problem

Compositor is unable to locate a file.

Workaround

If the file in question actually exists in the same folder as the document, or a subfolder thereof, make sure to grant Compositor permission to access other files in the document folder:

GrantAccess

This dialog will pop up any time you open a document and haven’t already granted access to the document folder. This slightly inconvenient additional step of asking users for permission is a consequence of app sandboxing. Once you answer this dialog with “Grant”, Compositor will insert a

%! \bookmark[document=Ym9va8...AAAAAAAAA=]

line into your LaTeX document. This so-called security-scoped bookmark persists your permission for access to the document folder, and the dialog will no longer pop up.

“TeX has run out of memory”

OutOfMemory

The Problem

TeX has a static memory layout – the different regions of TeX’s internal memory have a fixed size that is predetermined at compile time (when I build the app). If you see this alert, one of TeX’s internal memory regions is too small in its current configuration for the document at hand.

There exists a corresponding ticket on the issue tracker, but I’m not sure if and when this shortcoming will be addressed.

Workaround

One of the memory limits of TeX is an input buffer size of 3000 characters. Please check if your document has lines exceeding 3000 characters in length.

If that’s not the case, then there is no immediate workaround. I will need to investigate the problem and decide if I want to increase the size of the affected memory region in one of the next updates. It would be great if you could send me the document so that I can look into the issue.

“Unsupported statement: \input”

UnsupportedStmtInput

The Problem

You are using an \input or \include statement in your LaTeX file. This is one of Compositor’s current limitations.

Workaround

Consolidate your multi-file document into a single file. A corresponding feature to automate this is planned for one of the upcoming releases.

In the long run, I want to get rid of this limitation altogether.

“Unsupported package: inputenc”

UnsupportedPackageInputEnc

The Problem

The inputenc package is not supported. This limitation is described in more detail here.

Workaround

There is no immediate workaround. This limitation will be fixed at some point.

“Unsupported document class: scr…”

UnsupportetDocClass

The Problem

The Koma-Script document classes are not yet supported.

Workaround

There is no immediate workaround. This limitation will be fixed at some point.

“Not running under e-TeX”

eTeX

The Problem

Compositor does not yet support e-TeX, a set of extensions to the TeX3 engine.

Workaround

There is no immediate workaround. This limitation will be fixed in one of the next versions.

“Package expl3 Error: Required primitives not found”

expl3

The Problem

Compositor does not yet support LaTeX 3.

Workaround

There is no immediate workaround. This limitation will be fixed in one of the next versions.