There's a new thing with the gretl help files; I'd be grateful if people would help check it for breakage. Right now it's Linux-only, but I'll try to find a way to implement it on Windows and Mac.

Anyway, this doesn't seem to work on my MATE laptop. I've tried evince, atril and okular, to no avail. stderr gives no debugging messages except for pdf help: looking for gretl-guide-a4.pdf In all three case, the guide opens, but not at the indicated chapter. Sorry I don't have time today to pursue this any further.

On Tue, 1 Mar 2016, Riccardo (Jack) Lucchetti wrote: > Anyway, this doesn't seem to work on my MATE laptop. I've tried evince, > atril and okular, to no avail. stderr gives no debugging messages except > for > > pdf help: looking for gretl-guide-a4.pdf > > In all three case, the guide opens, but not at the indicated chapter. Sorry > I don't have time today to pursue this any further. Correction/integration: it works with okular, provided you've rebuild the pdf files from scratch. That is, between "configure + make" and "make install", you run "make pdfdocs".

That said, I suspect that a setting I have with both evince and atril by which those two programs remember the page they where at when a given file was last closed is maybe interfering with the desired outcome, but I wouldn't know how to turn it off/on (I actually like it).

On Tue, 1 Mar 2016, Allin Cottrell wrote: >> That said, I suspect that a setting I have with both evince and atril by >> which those two programs remember the page they where at when a given file >> was last closed is maybe interfering with the desired outcome, but I >> wouldn't know how to turn it off/on (I actually like it). > > My evince also remembers the last-viewed position in PDF files; nonethless > it respects the option passed by gretl. You can test this (what gretl's > doing) at the command line. For example > > evince gretl-guide.pdf --named-dest=chap:join > > should open at the top of the "Joining data sources" chapter. > (Though maybe not if the Guide is already open in evince?) Problem solved with evince. As for atril, it seems that at least 1.12.2 it doesn't have the equivalent option. It does have, however, an option for opening a document at a specific page number. Perhaps we could use a \pageref{}?

On Tue, 1 Mar 2016, Allin Cottrell wrote: > Anyway, I see that atril offers a --page-label=PAGE option (as opposed to > --page-index=NUMBER). Perhaps you could try to find out how that works, we > could maybe use it. Nope, no luck.

On Thu, 3 Mar 2016, Juan C. Estévez wrote: > 'join' then don´t opens the chapter 7. So one must close the pdf > before clicking a new link. > That's right? That depends on the particular PDF viewer. With Acrobat Reader, you're right. If we passed the "/n" switch to Reader that ought to open a new instance of the program in which the PDF is opened at the second destination, but I'm not sure that's what the user would want (multiple copies of Reader running).

On Thu, 3 Mar 2016, Sven Schreiber wrote:

> on Windows. For example it could be that they tell Acrobat to close the > program and the re-open it in the running instance. Hmm, good point. I guess the TeX editors must be using the DDE (Dynamic Data Exchange) API. We could try that.

I have just done some translations. I see some of them are about the gretlcli help, but after the translation, running gretlcli --help I can see my changes but this paragraph is untraslated: Special batch-mode option: --scriptopt=<value> sets a scalar value, accessible to a script under the name "scriptopt" I think probably it is not marked for translation.

On 10 Mar 2016, at 23:51, Allin Cottrell <cottrell(a)wfu.edu&gt; wrote: Here's an update on the status of clicking on a link to the (PDF) User's Guide in the GUI help text. The precise effect depends on the platform and the PDF viewer. There are two questions: 1) Does the platform/viewer support opening the PDF at a specified "named destination" at all? 2) If so, what happens on a second click on a GUI help-text link, pointing to a different chapter: will the viewer obligingly update the read position in the PDF file, or do you only get one shot? Linux: evince: Yes on question 1, and Yes on the update in question 2. xpdf: Yes on question 1; opens a new window in re. question 2. okular: Supposed to be Yes on question 1, according to the docs; I don't know about question 2. (I'm not in a position to test.) other viewers: I'm not aware of any others that will cooperate. Windows: Adobe Acrobat/Acrobat Reader: Yes on 1, and also Yes on updating the viewing position now that I've added some DDE code (in git and snapshots). other viewers: I'm not aware of any others that will cooperate. Mac: Nothing doing, so far as I can see. I can't get Adobe products to do anything useful, nor the native Apple Preview.app. I can't find any relevant documentation. I did try a few experiments aimed at Acrobat Reader DC, but to no effect.

Allin _______________________________________________ Gretl-devel mailing list Gretl-devel(a)lists.wfu.edu http://lists.wfu.edu/mailman/listinfo/gretl-devel

>> Nothing doing, so far as I can see. I can't get Adobe products >> to do anything useful, nor the native Apple Preview.app. I can't >> find any relevant documentation. I did try a few experiments >> aimed at Acrobat Reader DC, but to no effect. > > Mac: > > Could/can Skim do it? I've tried jumping between a .tex and the corresponding .pdf with the editor TextMate and the LaTeX bundle. It's possible to jump back and forth to the appropriate sections.

Here's an update on the status of clicking on a link to the (PDF) User's Guide in the GUI help text. The precise effect depends on the platform and the PDF viewer. There are two questions: 1) Does the platform/viewer support opening the PDF at a specified "named destination" at all? 2) If so, what happens on a second click on a GUI help-text link, pointing to a different chapter: will the viewer obligingly update the read position in the PDF file, or do you only get one shot? Linux: evince: Yes on question 1, and Yes on the update in question 2. xpdf: Yes on question 1; opens a new window in re. question 2. okular: Supposed to be Yes on question 1, according to the docs; I don't know about question 2. (I'm not in a position to test.) other viewers: I'm not aware of any others that will cooperate. Windows: Adobe Acrobat/Acrobat Reader: Yes on 1, and also Yes on updating the viewing position now that I've added some DDE code (in git and snapshots). other viewers: I'm not aware of any others that will cooperate.

Mac: Nothing doing, so far as I can see. I can't get Adobe products to do anything useful, nor the native Apple Preview.app. I can't find any relevant documentation. I did try a few experiments aimed at Acrobat Reader DC, but to no effect.

Am 10.03.2016 um 23:51 schrieb Allin Cottrell: > Here's an update on the status of clicking on a link to the (PDF) User's > Guide in the GUI help text. The precise effect depends on the platform > and the PDF viewer. There are two questions: > > Windows: > > Adobe Acrobat/Acrobat Reader: Yes on 1, and also Yes on updating the > viewing position now that I've added some DDE code (in git and snapshots). Very nice! (haven't tested yet, though) > > other viewers: I'm not aware of any others that will cooperate. SumatraPDF seems to do some of it: https://github.com/sumatrapdfreader/sumatrapdf/wiki/Command-line-arguments e.g.: -named-dest <destination-name> "Combine with -reuse-instance if the document is already open" -page <pageNo>

> On Fri, 11 Mar 2016, Sven Schreiber wrote: > >> Am 10.03.2016 um 23:51 schrieb Allin Cottrell: >>> Here's an update on the status of clicking on a link to the (PDF) >>> User's Guide in the GUI help text. The precise effect depends on the >>> platform and the PDF viewer. There are two questions: >>> >> >>> Windows: >>> >>> Adobe Acrobat/Acrobat Reader: Yes on 1, and also Yes on updating the >>> viewing position now that I've added some DDE code (in git and > snapshots). >> >> Very nice! (haven't tested yet, though) I just tested the latest snapshot (3-10-16), on Win 7 (Enterprise) with Adobe Reader. I can confirm the "yes on 1" (user's guide opens to the correct chapter when clicking on the link in the help window), but the location doesn't update.

-----Original Message----- From: gretl-devel-bounces(a)lists.wfu.edu [mailto:gretl-devel- bounces(a)lists.wfu.edu] On Behalf Of Summers, Peter Sent: Friday, March 11, 2016 12:58 PM To: Gretl development Subject: Re: [Gretl-devel] help files > On Fri, 11 Mar 2016, Summers, Peter wrote: > > >> On Fri, 11 Mar 2016, Sven Schreiber wrote: > >> > >>> Am 10.03.2016 um 23:51 schrieb Allin Cottrell: > >>>> Here's an update on the status of clicking on a link to the (PDF) > >>>> User's Guide in the GUI help text. The precise effect depends on > >>>> the platform and the PDF viewer. There are two questions: > >>>> > >>> > >>>> Windows: > >>>> > >>>> Adobe Acrobat/Acrobat Reader: Yes on 1, and also Yes on updating > >>>> the viewing position now that I've added some DDE code (in git > >>>> and > >> snapshots). > >>> > >>> Very nice! (haven't tested yet, though) > > > > I just tested the latest snapshot (3-10-16), on Win 7 (Enterprise) > > with Adobe Reader. I can confirm the "yes on 1" (user's guide opens > > to the correct chapter when clicking on the link in the help > > window), but the location doesn't update. > > What version of Adobe Reader, please? Getting DDE to work is quite > tricky, particularly since Adobe writes the wrong identifier for its > DDE "server" into the Windows registry -- so finding the right > identifier is a matter of informed guesswork. I've tested with Reader > DC 2015 on Windows 8 and that works for updating the read location. > Adobe Reader XI, version 11.0.07. I'll update & try again

>>>> On Fri, 11 Mar 2016, Sven Schreiber wrote:

>>>>> Very nice! (haven't tested yet, though) >>>

Confirmed -- Reader DC works great. FWIW, PDF Architect 4 has the same behavior as Sumatra (opens the manual but not to the correct chapter).

Am 01.03.2016 um 04:04 schrieb Allin Cottrell: > There's a new thing with the gretl help files; I'd be grateful if people > would help check it for breakage. Right now it's Linux-only, but I'll > try to find a way to implement it on Windows and Mac. > This sounds very good! Related to the pdf user guide on Windows, I think when repeatedly installing new snapshots (and releases?) the pdf doesn't get updated, or perhaps it gets updated only in some but not all storage locations. So I've acquired the habit to delete the pdf file manually every once in a while, then gretl downloads the current one from the internet. This problem might become more relevant when there are direct links that assume the current version.

At least on my Windows 7 desktop, the documentation gets removed by the uninstaller automatically. I can also confirm the behavior of the new link (Gretl guide opens, but not to the indicated chapter).

Personally I like PDF a lot, but all this non-standardization sounds like it could be solved using web formats. So perhaps this would be an argument to move the help output format to HTML5 + MathML + WhateverML.... ? Given that Gretl already does a lot of XML maybe that wouldn't even be too painful. Just thinking out loud...

I absolutely agree that TeX should stay. I just thought that in the meantime there must have been created a decent converter from LaTeX to HTML. But it's been a while since I looked at the issue seriously.

Am 02.03.2016 um 00:01 schrieb Allin Cottrell: > On Tue, 1 Mar 2016, Sven Schreiber wrote: > >> I absolutely agree that TeX should stay. I just thought that in the >> meantime there must have been created a decent converter from LaTeX to >> HTML. But it's been a while since I looked at the issue seriously. > > Me too. But I'm pretty confident there has been no "breakthrough" on > that front. Some LateX to HTML converters work reasonably well for > simple text, but even then (in my experience) they can't be left to work > unattended; they require human intervention to sort out the finer > points. For complex text plus complex mathematics I will eat my > proverbial hat if there's a half-way adequate converter. (I don't count > PNG pictures of TeX math as half-way adequate.) Does anybody know this thing: https://en.wikipedia.org/wiki/LaTeXML ?