<div dir="ltr"><div class="gmail_extra"><div class="gmail_quote">On Fri, Jun 24, 2016 at 1:58 AM, Patrick Sanan <span dir="ltr"><<a href="mailto:patrick.sanan@gmail.com" target="_blank">patrick.sanan@gmail.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">I'm working on some groundwork to improve the PETSc documentation, and<br>
the next thing I'd like to look at is the User's Manual, adding<br>
slightly-prettier code listings (as in the update to the dev manual).<br>
<br>
Before doing that, however,  it would be very helpful to know if there<br>
are any sections of the manual which are known, by the relevant<br>
experts here, to require deletion or heavy rewrites; it would of<br>
course be a waste of time to format these.<br>
<br>
Specifically, I'm wondering about the following sections, which have<br>
in common that they are things concerned with friendly external tools.<br>
I've seen new users get very frustrated when they expect these sorts<br>
of things to "just work," so it's probably constructive to remove any<br>
outdated information here:<br>
<br>
- Chapter 11: Using MATLAB with PETSc . The support here has changed<br>
quite a lot, so I'm not sure what currently works. Is the MATLAB<br>
Compute Engine still supported?<br>
<br>
- Sections 15.10-15.14: Eclipse/Qt Creator/Developers Studio/XCode<br>
users. This is likely not all current. Is this information helpful<br>
here?<br>
<br>
- Section 15.15 : Graphics. I saw that there were some updates to the<br>
drawing tools recently by Lisandro, so if any of this material is<br>
known to be out of date, that would be helpful to know.<br>
</blockquote></div><br>I think graphics is not so much out of date now as incomplete. We really want</div><div class="gmail_extra">to be telling people to do things the modern way, but the old ways still work.</div><div class="gmail_extra"><br></div><div class="gmail_extra">   Matt<br clear="all"><div><br></div>-- <br><div class="gmail_signature" data-smartmail="gmail_signature">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></div>