From mboxrd@z Thu Jan 1 00:00:00 1970 From: Indraneel Majumdar Subject: Re: Re: [PATCH] Compiling multiple times the LaTeX output Date: Tue, 05 Oct 2010 20:32:09 +0530 Message-ID: <4CAB3DF1.3000807@indraneel.info> References: <87zkv0pqyi.fsf@mundaneum.com> <87r5gcshnf.fsf@noorul.maa.corp.collab.net> <874od7uzsa.fsf_-_@mundaneum.com> <30671.1285861145@gamaville.dokosmarshall.org> <87vd5njhm8.fsf@mundaneum.com> <87lj6h1ukw.fsf@mundaneum.com> <87sk0kyfgw.fsf@mundaneum.com> Mime-Version: 1.0 Content-Type: multipart/mixed; boundary="===============1291734307==" Return-path: Received: from [140.186.70.92] (port=34404 helo=eggs.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1P392k-00012j-OD for emacs-orgmode@gnu.org; Tue, 05 Oct 2010 11:03:38 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1P392D-0001BH-Qn for emacs-orgmode@gnu.org; Tue, 05 Oct 2010 11:03:01 -0400 Received: from mailout14.yourhostingaccount.com ([65.254.253.118]:40032) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1P392D-00018n-NV for emacs-orgmode@gnu.org; Tue, 05 Oct 2010 11:02:29 -0400 Received: from mailscan13.yourhostingaccount.com ([10.1.15.13] helo=mailscan13.yourhostingaccount.com) by mailout14.yourhostingaccount.com with esmtp (Exim) id 1P3929-0005a0-Hn for emacs-orgmode@gnu.org; Tue, 05 Oct 2010 11:02:25 -0400 In-Reply-To: List-Id: "General discussions about Org-mode." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org Errors-To: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org To: Matthew Leifer Cc: emacs-orgmode This is a multi-part message in MIME format. --===============1291734307== Content-Type: multipart/alternative; boundary="------------050806090301050604070201" This is a multi-part message in MIME format. --------------050806090301050604070201 Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 8bit texi2dvi is also on my minimal MikTex system, I'd certainly love a patch that uses it instead of a shell script (although I also have cygwin too).. On 2010-10-05 20:00, Matthew Leifer wrote: > Hi, > > I don't know if you are aware, but there is a utility called texi2dvi > that figures out how many times LaTeX, bibtex, etc. need to be run and > automatically runs them the correct number of times for you. It also > has an option -p that uses pdflatex and generates pdf instead of dvi. > In my opinion, it would be better to make use of this rather than > writing new code to do this, as they have thought about all the edge > cases in far more detail than is possible here. It is possible that > some LaTeX installations do not come with texi2dvi, but it does come > with the full TeXLive installation so plenty of people are likely to > have it installed. If you want to avoid this breaking on systems that > do not have texi2dvi installed then you could just check for it, use > it if it is available and, if not, give the user a warning message > that they may get better results if they install texi2dvi whilst using > the existing code. > > Best, > > Matt Leifer > > 2010/10/5 Sébastien Vauban > > > Hi Carsten, > > Carsten Dominik wrote: > > Thanks for the patch! I would certainly have a better way to > process these > > files. > > Could you make your latest sentence more explicit? > > > > 1. Can we run bibtex only if we have an indication that it might > be needed? > > Maybe by looking at the output of the first LaTeX run? Hmm, > maybe this > > would not work if only the bibtex database file was changed. > > I guess things in that direction are entirely possible. I don't > use bibtex > yet, but will have a look at a better integration. > > > > 2. The contrill structures you are using, are they standard > shell or is bash > > needed for this? > > Good question! Yes, I implicitly wrote in bash. That won't work > for sure in > Windows... > > But, then, how do we do for writing such shells in Emacs? Go to > Emacs's > builtin shell? I have no experience with it, but I can have a > look, except: > how would we be sure that the preferred shell of the user is that one? > > > > 3. Maybe we can extract a useful error message if the last > PDFLaTeX run > > still contains problems? Maybe even load the log file in this > case? > > For sure, such behaviors would be a great, in case of failures. > > Best regards, > Seb > > >> Here is my (much) better proposition: > >> > >> --8<---------------cut here---------------start------------->8--- > >> diff --git a/lisp/org-latex.el b/lisp/org-latex.el > >> index 9a62457..0a2c5fe 100644 > >> --- a/lisp/org-latex.el > >> +++ b/lisp/org-latex.el > >> @@ -455,25 +455,35 @@ allowed. The default we use here > encompasses both." > >> :group 'org-export-latex > >> :group 'org-export) > >> > >> +(defcustom org-latex-pdf-max-runs 3 > >> + "Maximum number of times PDFLaTeX is run after BibTeX." > >> + :group 'org-export-pdf > >> + :type 'int) > >> + > >> (defcustom org-latex-to-pdf-process > >> - '("pdflatex -interaction nonstopmode -output-directory %o %f" > >> - "pdflatex -interaction nonstopmode -output-directory %o %f") > >> + `("pdflatex -interaction nonstopmode -output-directory %o %f" > >> + "bibtex %b" > >> + ,(concat "let COUNTER=0; while (grep -e \"Rerun .* cross- > >> references\" %b.log > /dev/null); do if [ $COUNTER -eq " > >> + (int-to-string org-latex-pdf-max-runs) > >> + " ]; then break; fi; pdflatex -interaction > nonstopmode > >> -output-directory %o %f; let COUNTER=COUNTER+1; done")) > >> "Commands to process a LaTeX file to a PDF file. > >> This is a list of strings, each of them will be given to the shell > >> as a command. %f in the command will be replaced by the full > file name, %b > >> by the file base name (i.e. without extension) and %o by the > base directory > >> of the file. > >> The reason why this is a list is that it usually takes several > runs of > >> -pdflatex, maybe mixed with a call to bibtex. Org does not > have a clever > >> -mechanism to detect which of these commands have to be run to > get to a > >> stable > >> -result, and it also does not do any error checking. > >> +pdflatex, mixed with a call to bibtex. Org does now have a clever > >> mechanism > >> +to detect how many times the document has to be compiled to > get to a stable > >> +result for the cross-references. Moreover, the number of > compilations > >> after > >> +bibtex is limited to 3 by default (see > `org-latex-pdf-max-runs' for more). > >> +Though, it does not do any error checking. > >> > >> Alternatively, this may be a Lisp function that does the > processing, so you > >> could use this to apply the machinery of AUCTeX or the Emacs > LaTeX mode. > >> This function should accept the file name as its single argument." > >> :group 'org-export-pdf > >> :type '(choice (repeat :tag "Shell command sequence" > >> - (string :tag "Shell command")) > >> + (string :tag "Shell command")) > >> (function))) > >> > >> (defcustom org-export-pdf-logfiles > >> --8<---------------cut here---------------end--------------->8--- > >> > >> Enhancements: > >> > >> - variable to limit the number of PDFLaTeX runs (3, by default) > >> > >> Though, the way it is evaluated, you need to set it before calling > >> org-latex > >> (before defining org-latex-to-pdf-process). Not a problem, > IMHO. Maybe > >> there > >> are better ways, though? > >> > >> - real standard sequence to compile the doc: > >> > >> + one call to PDFLaTeX > >> + one call to BibTeX > >> + as many calls as needed to PDFLaTeX (max 3) > > -- > Sébastien Vauban > > > _______________________________________________ > Emacs-orgmode mailing list > Please use `Reply All' to send replies to the list. > Emacs-orgmode@gnu.org > http://lists.gnu.org/mailman/listinfo/emacs-orgmode > > > > _______________________________________________ > Emacs-orgmode mailing list > Please use `Reply All' to send replies to the list. > Emacs-orgmode@gnu.org > http://lists.gnu.org/mailman/listinfo/emacs-orgmode --------------050806090301050604070201 Content-Type: text/html; charset=ISO-8859-1 Content-Transfer-Encoding: 7bit texi2dvi is also on my minimal MikTex system, I'd certainly love a patch that uses it instead of a shell script (although I also have cygwin too)..

On 2010-10-05 20:00, Matthew Leifer wrote:
Hi,

I don't know if you are aware, but there is a utility called texi2dvi that figures out how many times LaTeX, bibtex, etc. need to be run and automatically runs them the correct number of times for you.  It also has an option -p that uses pdflatex and generates pdf instead of dvi.  In my opinion, it would be better to make use of this rather than writing new code to do this, as they have thought about all the edge cases in far more detail than is possible here.  It is possible that some LaTeX installations do not come with texi2dvi, but it does come with the full TeXLive installation so plenty of people are likely to have it installed.  If you want to avoid this breaking on systems that do not have texi2dvi installed then you could just check for it, use it if it is available and, if not, give the user a warning message that they may get better results if they install texi2dvi whilst using the existing code.

Best,

Matt Leifer

2010/10/5 Sébastien Vauban <wxhgmqzgwmuf@spammotel.com>
Hi Carsten,

Carsten Dominik wrote:
> Thanks for the patch! I would certainly have a better way to process these
> files.

Could you make your latest sentence more explicit?


> 1. Can we run bibtex only if we have an indication that it might be needed?
>    Maybe by looking at the output of the first LaTeX run? Hmm, maybe this
>    would not work if only the bibtex database file was changed.

I guess things in that direction are entirely possible. I don't use bibtex
yet, but will have a look at a better integration.


> 2. The contrill structures you are using, are they standard shell or is bash
>    needed for this?

Good question!  Yes, I implicitly wrote in bash. That won't work for sure in
Windows...

But, then, how do we do for writing such shells in Emacs?  Go to Emacs's
builtin shell?  I have no experience with it, but I can have a look, except:
how would we be sure that the preferred shell of the user is that one?


> 3. Maybe we can extract a useful error message if the last PDFLaTeX run
>    still contains problems? Maybe even load the log file in this case?

For sure, such behaviors would be a great, in case of failures.

Best regards,
 Seb

>> Here is my (much) better proposition:
>>
>> --8<---------------cut here---------------start------------->8---
>> diff --git a/lisp/org-latex.el b/lisp/org-latex.el
>> index 9a62457..0a2c5fe 100644
>> --- a/lisp/org-latex.el
>> +++ b/lisp/org-latex.el
>> @@ -455,25 +455,35 @@ allowed.  The default we use here encompasses both."
>>   :group 'org-export-latex
>>   :group 'org-export)
>>
>> +(defcustom org-latex-pdf-max-runs 3
>> +  "Maximum number of times PDFLaTeX is run after BibTeX."
>> +  :group 'org-export-pdf
>> +  :type 'int)
>> +
>> (defcustom org-latex-to-pdf-process
>> -  '("pdflatex -interaction nonstopmode -output-directory %o %f"
>> -    "pdflatex -interaction nonstopmode -output-directory %o %f")
>> +  `("pdflatex -interaction nonstopmode -output-directory %o %f"
>> +    "bibtex %b"
>> +    ,(concat "let COUNTER=0; while (grep -e \"Rerun .* cross-
>> references\" %b.log > /dev/null); do if [ $COUNTER -eq "
>> +             (int-to-string org-latex-pdf-max-runs)
>> +             " ]; then break; fi; pdflatex -interaction nonstopmode
>> -output-directory %o %f; let COUNTER=COUNTER+1; done"))
>>   "Commands to process a LaTeX file to a PDF file.
>> This is a list of strings, each of them will be given to the shell
>> as a command.  %f in the command will be replaced by the full file name, %b
>> by the file base name (i.e. without extension) and %o by the base directory
>> of the file.
>> The reason why this is a list is that it usually takes several runs of
>> -pdflatex, maybe mixed with a call to bibtex.  Org does not have a clever
>> -mechanism to detect which of these commands have to be run to get to a
>> stable
>> -result, and it also does not do any error checking.
>> +pdflatex, mixed with a call to bibtex.  Org does now have a clever
>> mechanism
>> +to detect how many times the document has to be compiled to get to a stable
>> +result for the cross-references.  Moreover, the number of compilations
>> after
>> +bibtex is limited to 3 by default (see `org-latex-pdf-max-runs' for more).
>> +Though, it does not do any error checking.
>>
>> Alternatively, this may be a Lisp function that does the processing, so you
>> could use this to apply the machinery of AUCTeX or the Emacs LaTeX mode.
>> This function should accept the file name as its single argument."
>>   :group 'org-export-pdf
>>   :type '(choice (repeat :tag "Shell command sequence"
>> -              (string :tag "Shell command"))
>> +                     (string :tag "Shell command"))
>>               (function)))
>>
>> (defcustom org-export-pdf-logfiles
>> --8<---------------cut here---------------end--------------->8---
>>
>> Enhancements:
>>
>> - variable to limit the number of PDFLaTeX runs (3, by default)
>>
>>  Though, the way it is evaluated, you need to set it before calling
>> org-latex
>>  (before defining org-latex-to-pdf-process). Not a problem, IMHO. Maybe
>> there
>>  are better ways, though?
>>
>> - real standard sequence to compile the doc:
>>
>>  + one call to PDFLaTeX
>>  + one call to BibTeX
>>  + as many calls as needed to PDFLaTeX (max 3)

--
Sébastien Vauban


_______________________________________________
Emacs-orgmode mailing list
Please use `Reply All' to send replies to the list.
Emacs-orgmode@gnu.org
http://lists.gnu.org/mailman/listinfo/emacs-orgmode


_______________________________________________
Emacs-orgmode mailing list
Please use `Reply All' to send replies to the list.
Emacs-orgmode@gnu.org
http://lists.gnu.org/mailman/listinfo/emacs-orgmode
--------------050806090301050604070201-- --===============1291734307== Content-Type: text/plain; charset="us-ascii" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Content-Disposition: inline _______________________________________________ Emacs-orgmode mailing list Please use `Reply All' to send replies to the list. Emacs-orgmode@gnu.org http://lists.gnu.org/mailman/listinfo/emacs-orgmode --===============1291734307==--