Editing Show error hook

=The show_error_hook callback=

This [[Callbacks|callback]] doesn't replace any internal code and isn't supposed to do anything meaningful. It is called when an error message occurs, precisely right after the first line of the error message (beginning with an exclamation mark) has been printed, and before the rest of the message is given.

No argument is passed to the function registered in the callback, and return values, if any, are ignored. Its best use is probably to report additional information besides the error message. For instance, the input text <tt>a_1</tt> will produce the following error message (and another one quite similar at the end of the paragraph):

<pre>
! Missing $ inserted.
<inserted text> 
                $
<to be read again> 
                   _
l.1 a_
      1
I've inserted a begin-math/end-math symbol since I think
you left one out. Proceed, with fingers crossed.
</pre>

This message can be annoying for two reasons: first, if one has a document made of several files, one doesn't know which file is concerned here (one can read the log file upward to spot the latest input file, but that isn't very convenient); second, the line number takes some time to arrive after the message's first line. The lines 2 to 4 aren't very informative, and it could be useful if the line number was available at once.

The following code inserts the input file's name and line number just after the first line of the message; thus the rest of the message can be ignored (as many users do, the first line, along with where the error happened, being often informative enough):

<pre>
luatexbase.add_to_callback("show_error_hook",
  function ()
    texio.write_nl("[FILE: " .. status.filename .. ", LINE: " .. status.linenumber .. "]")
  end, "More descriptive error message", 5
)
</pre>

Some information from the <tt>status</tt> library is put to use here: <tt>status.filename</tt> returns a string with the name of the current input file, <tt>status.linenumber</tt> returns a number (automatically converted to a string here) indicating the line TeX is currently reading.

Now the error message looks like this, assuming that <tt>a_1</tt> appeared in file called <tt>test_input.tex</tt> in the same directory as the main file:

<pre>
! Missing $ inserted.
[FILE: ./test_input.tex, LINE: 1]
<inserted text> 
                $
<to be read again> 
                   _
l.1 a_
      1
I've inserted a begin-math/end-math symbol since I think
you left one out. Proceed, with fingers crossed.
</pre>

If one wants a full path instead of a relative path, one can use [http://keplerproject.github.com/luafilesystem/ the LuaFileSystem library], shipped with LuaTeX (the use of <tt>%</tt> implies that this code isn't simply passed to <tt>\directlua</tt>; see [[Writing Lua in TeX]]):

<pre>
luatexbase.add_to_callback("show_error_hook",
  function ()
    local f = status.filename
    f = string.gsub(f, "^%.", lfs.currentdir())
    texio.write_nl("[FILE: " .. f .. ", LINE: " .. status.linenumber .. "]")
  end, "More descriptive error message", 5
)
</pre>

This replaces <tt>./</tt> at the beginning of the filename (if any) with the string returned by <tt>lfs.currentdir()</tt>, whose meaning should be obvious. (See [http://www.lua.org/manual/5.1/manual.html#pdf-string.gsub the Lua reference manual] for information on <tt>string.gsib()</tt>.)