[Tex/LaTex] How to make `latexmk` run the appropriate amount of times

auctexcompilingemacslatexmk

System:

Ubuntu 13.04, Texlive2012, Emacs 24.something, I run Emacs from the terminal and not the GUI, and I have server mode on in Emacs.

When compiling my latex documents, I use AucTeX in emacs to run latexmk but latexmk only runs once and will say you should run latexmk again and then reason whether it be references or something else. Isn't the point of latexmk to run the appropriate amount of times from the get go?

How can I have latexmk do this with out me telling emacs to run it again?

My latex portion of my .emacs is below in case there is something I need to add or remove from it to get the desired results.

;;============AucTex===========                                                 
(require 'tex-site)
(add-hook 'LaTeX-mode-hook 'turn-on-reftex)
(setq reftex-plug-into-AUCTex t)
(global-font-lock-mode t)
(setq font-lock-maximum-decoration t)

;;============ Latexmk setup==============                                        
(defun run-latexmk ()
  (interactive)
  (let ((TeX-save-query nil)
        (TeX-process-asynchronous nil)
        (master-file (TeX-master-file)))
    (TeX-save-document "")
    (TeX-run-TeX "latexmk"
                (TeX-command-expand "latexmk -pdflatex='pdflatex -file-line-error  \
                                  -synctex=1' -pdf %s" 'TeX-master-file)
                 master-file))
    (if (plist-get TeX-error-report-switches (intern master-file))
        (TeX-next-error t)
      (progn
        (demolish-tex-help)
        (minibuffer-message "latexmk: done."))))

(add-hook 'LaTeX-mode-hook (lambda ()
    (push
     '("Latexmk" "latexmk -pdf %s" TeX-run-TeX nil t
       :help "Run Latexmk on file")
     TeX-command-list)))

;; Set okular to open with C-c C-v view option                                      
(defun Okular-make-url () (concat
     "file://"
     (expand-file-name (funcall file (TeX-output-extension) t)
                       (file-name-directory (TeX-master-file))
                       "#src:"
                       (TeX-current-line)
                       (expand-file-name (TeX-master-directory))
                       "./"
                       (TeX-current-file-name-master-relative))))

(add-hook 'LaTeX-mode-hook '(lambda ()
        (add-to-list 'TeX-expand-list
                     '("%u" Okular-make-url))))
(setq TeX-view-program-list
      '(("Okular" "okular --unique %u")))
(setq TeX-view-program-selection '((output-pdf "Okular")))

(custom-set-variables
 ;; custom-set-variables was added by Custom.                                       
 ;; If you edit it by hand, you could mess it up, so be careful.                    
 ;; Your init file should contain only one such instance.                           
 ;; If there is more than one, they won't work right.                               
 '(TeX-PDF-mode t)
 '(TeX-newline-function (quote newline-and-indent))
 '(TeX-source-correlate-method (quote synctex))
 '(TeX-source-correlate-mode t)
 '(TeX-source-correlate-start-server t)
 '(TeX-view-program-list (quote (("Okular" "okular -unique %o#src:%n%b"))) t)
 '(TeX-view-program-selection (quote ((output-pdf "Okular"))) t)
 '(compilation-auto-jump-to-first-error t))

Below is my .latexmkrc file

$pdf_mode = 1;
$pdflatex = 'pdflatex -interaction=nonstopmode -file-line-error -synctex=1';

Edit

Per John Collins' request, here is the message I received when running latexmk

You should run LaTeX again to get references right, {9} pages

Even though it says LaTeX, latexmk was ran here is the output to show this:

Running `Latexmk' on `TidalForce' with ``latexmk -pdf TidalForce''
Latexmk: This is Latexmk, John Collins, 11 Nov. 2012, version: 4.35.
**** Report bugs etc to John Collins <collins at phys.psu.edu>. ****
Latexmk: applying rule 'pdflatex'...
Rule 'pdflatex': File changes, etc:
   Changed files, or newly in use since previous run(s):
      'TidalForce.tex'
------------
Run number 1 of rule 'pdflatex'

As John Collins mentioned, here is the better format for the .emacs and .latexmkrc file.

;; ============ Latexmk setup ==============                                        
(defun run-latexmk ()
  (interactive)
  (let ((TeX-save-query nil)
        (TeX-process-asynchronous nil)
        (master-file (TeX-master-file)))
    (TeX-save-document "")
    (TeX-run-TeX "latexmk"
                 (TeX-command-expand "latexmk -pdf %s" 'TeX-master-file)
                 master-file))
    (if (plist-get TeX-error-report-switches (intern master-file))
        (TeX-next-error t)
      (progn
        (demolish-tex-help)
        (minibuffer-message "latexmk: done."))))

(add-hook 'LaTeX-mode-hook (lambda ()
    (push
     '("Latexmk" "latexmk -pdf %s" TeX-run-TeX nil t
       :help "Run Latexmk on file")
     TeX-command-list)))

.latexmkrc setup:

$pdflatex = 'pdflatex --shell-escape -interaction=nonstopmode -file-line-error -synctex=1 %O %S';

Best Answer

In your definitions of the command lines for latexmk, change %s to %O %S. (Both the O and S are upper case.) The %S is the correct placeholder for the name of the source file, and the %O is for options that latexmk may place on the command line. With the lower case s that you have, latexmk doesn't do the substitution for the name of the source file, and the command line passed to pdflatex is not the intended one.

Note added

It turned out later that the above answer was misleading/misinpretable. There is a configuration of emacs to call latexmk correctly, and a configuration of latexmk to call pdflatex as is desired by the OP. Although latexmk can be configured through its command line, which was done in the emacs configuration file .emacs in the question, it is normally easier and safer to configure latexmk in one of its own configuration files. See TikZ: compiling a standalone picture for a better configuration.

Related Solutions

[Tex/LaTex] AUCTeX -output-directory + copy *.pdf to working directory

If you want to use AUCTeX so desperately:

(add-hook 'LaTeX-mode-hook (lambda ()
                 (push 
                  '("Latex_outdir" "%`pdflatex --output-directory=/tmp %(mode)%' %t" 
                TeX-run-TeX nil (latex-mode doctex-mode) 
                :help "Run pdflatex with output in /tmp")
                  TeX-command-list)))

The question you linked to in your last comment is still unanswered, and will cause a serious problem with this setup: AUCTeX won't be able to locate your auxiliary files, and thus deduce the next step in the compilation step.

I suggest you use latexmk for the whole process instead:

(add-hook 'LaTeX-mode-hook (lambda ()
                 (push 
                  '("Make" "latexmk -outdir=/tmp %t" TeX-run-TeX nil t
                :help "Make pdf output using latexmk.")
                  TeX-command-list)))

Latexmk is aware of the option outdir, and will automatically search for the auxiliary files in this directory.

Either way, note the following point (from man latexmk):

Commonly, the directory specified for output files is a subdirectory of the current working directory. However, if you specify some other directory, e.g., "/tmp/foo" or "../output", be aware that this could cause problems, e.g., with makeindex or bibtex. This is because modern versions of these programs, by default, will refuse to work when they find that they are asked to write to a file in a directory that appears not to be the current working directory or one of its subdirectories. This is part of security measures by the whole TeX system that try to prevent malicious or errant TeX documents from incorrectly messing with a user's files. If for $out_dir or $aux_dir you really do need to specify an absolute pathname (e.g., "/tmp/foo") or a path (e.g., "../output") that includes a higher-level directory, then you need to disable the security measures (and assume any risks). This can be done by temporarily setting the operating system's environment variable openout_any to "a" (as in "all"), to override the default "paranoid" setting.

Another potential problem with this setting is that all your documents will share the same temporary directory, so you will need to make sure they all have different names.

For your cp step, you can use this line in your .latexmkrc:

$pdflatex .= ' && cp -v %Z/%D %D';

Note that most of this is untested, please let me know if it doesn't work.

[Tex/LaTex] latex and auctex, how to set up latex->dvips->ps2pdf

With the latest version of AUCTeX, if should be sufficient to customize the variable TeX-PDF-from-DVI as described in the manual. Try M-x customize-variable RET TeX-PDF-from-DVI RET , click on Value Menu and choose dvips - ps2pdf sequence, hit Apply and Save and you should be done.

I'm not sure how your workflow is, as you don't describe it. Consider this file:

\documentclass[10pt,a4paper]{article}
\begin{document}
foobar
\end{document}

%%% Local Variables:
%%% mode: latex
%%% TeX-master: t
%%% TeX-PDF-mode: t
%%% TeX-PDF-from-DVI: "Dvipdfmx"
%%% End:

When you open this file, the variable TeX-PDF-from-DVI is set to "Dvipdfmx". The idea is that you compile the file with C-c C-c which runs latex on the file and you hit C-c C-c a second time which then runs dvipdfmx. You can take a shortcut with C-c C-a which runs both commands subsequently.

Here the relevant part from the manual again:

User Option: TeX-PDF-from-DVI

This option controls if and how to produce a PDF file by converting a DVI file.

When TeX-PDF-mode is non-nil, if TeX-PDF-from-DVI is non-nil too the document is compiled to DVI instead of PDF. When the document is ready, C-c C-c will suggest to run the converter to PDF or an intermediate format.

If non-nil, TeX-PDF-from-DVI should be the name of the command, as a string, used to convert the DVI file to PDF or to an intermediate format. Values currently supported are:

"Dvips": the DVI file is converted to PS with dvips. After successfully running it, ps2pdf will be the default command to convert the PS file to PDF.

"Dvipdfmx": the DVI file is converted to PDF with dvipdfmx.

When the PDF file is finally ready, the next suggested command will be to open the viewer.

This option can also be set as a file local variable, in order to use this conversion on a per-document basis.

Recall the whole sequence of C-c C-c commands can be replace by the single C-c C-a.

Best Answer

Note added

Related Solutions

[Tex/LaTex] AUCTeX -output-directory + copy *.pdf to working directory

[Tex/LaTex] latex and auctex, how to set up latex->dvips->ps2pdf

Related Question