<div dir="ltr"><br><div class="gmail_extra">On Sun, Dec 23, 2012 at 9:27 PM, Barry Smith <span dir="ltr"><<a href="mailto:bsmith@mcs.anl.gov" target="_blank">bsmith@mcs.anl.gov</a>></span> wrote:<br><div class="gmail_quote">
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div class="im"><br>
On Dec 23, 2012, at 4:16 PM, Jed Brown <<a href="mailto:jedbrown@mcs.anl.gov">jedbrown@mcs.anl.gov</a>> wrote:<br>
<br>
> On Sun, Dec 23, 2012 at 9:56 AM, Karl Rupp <<a href="mailto:rupp@mcs.anl.gov">rupp@mcs.anl.gov</a>> wrote:<br>
><br>
><br>
</div><div class="im">> As for the cross-referencing manuals and man-pages: I talked with Barry about that two weeks ago, since I had to produce a HTML version of my PhD thesis:<br>
>   <a href="http://www.iue.tuwien.ac.at/phd/rupp/" target="_blank">http://www.iue.tuwien.ac.at/phd/rupp/</a><br>
> I used tex4ht, which is still not perfect, but worked with reasonable effort. At least one can get reasonable HTML output from LaTeX.<br>
> Maybe one could customize the anchors so that one can not only reference out of the HTML output, but also *into* the output - however, I still have to check that...<br>
><br>
> I think that is the most important part. I would love for the DMDACreate2d man page to have a link into that section of the manual, for example. PETSc's manual already has links running the other direction.<br>
<br>
</div>   My understanding is that in our manual pages we should be able to make links like <a href="http://www.mcs.anl.gov/petsc/petsc-current/docs/manual.pdf#nameddest=SNESSolve" target="_blank">http://www.mcs.anl.gov/petsc/petsc-current/docs/manual.pdf#nameddest=SNESSolve</a> and when clicked on in the browser the browser would jump to that link in the pdf file; sadly I cannot get nameddest to work in ANY browser.<br>
</blockquote><div><br></div><div style>Is there any way to see what URL this thing is actually following in the browser and debug the failure?</div><div style><br></div><div style>   Matt</div><div> </div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">

   However I could get #page=number to work correctly in both Firefox and Chrome (but sadly to an Apple dude, not Safari). So I suggest we scarf up the index created by make manual.pdf with a little python script and use it to add to each manual page something like<br>

<br>
In users manual number, number, number<br>
<br>
where the user can click on the number and it jumps to the pdf page of that number so DMDACreate2d has a link to the page in manual.<br>
<br>
Much nicer that using some ugly non-PDF presentation of the users manual.<br>
<br>
Good idea, bad idea, ???<br>
<br>
   Barry<br>
<br>
We can add a message to Safari users to use another browser for this feature.<br>
<div class="HOEnZb"><div class="h5"><br>
<br>
><br>
> About two years ago I went through the deal.II documentation generator, at that time it used quite a number of scripts in order to extract the necessary information from the files. These were required to overcome some of the deficiencies of Doxygen at that time, e.g. math fonts and I think some cross-links. Meanwhile Doxygen also supports math formulae, and a couple of additional structuring mechanisms. I haven't tried any of the three items you mentioned, though...<br>

><br>
> Yeah, I see some hackery in doc/doxygen/tutorial/Makefile.<br>
><br>
> I might experiment with doxygen filters in a young project to see if it can be coerced into doing the things we'd like.<br>
<br>
</div></div></blockquote></div><br><br clear="all"><div><br></div>-- <br>What most experimenters take for granted before they begin their experiments is infinitely more interesting than any results to which their experiments lead.<br>
-- Norbert Wiener
</div></div>