<div dir="ltr">On Thu, Oct 24, 2013 at 9:11 AM, Jed Brown <span dir="ltr"><<a href="mailto:jedbrown@mcs.anl.gov" target="_blank">jedbrown@mcs.anl.gov</a>></span> wrote:<br><div class="gmail_extra"><div class="gmail_quote">
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">This is responding to Matt's comment, which is a topic that we could use<br>
more feedback on.<br>
<br>
<a href="https://bitbucket.org/petsc/petsc/commits/0a8e8854d85628d5034c7879b76533cb3504de85#general-comments" target="_blank">https://bitbucket.org/petsc/petsc/commits/0a8e8854d85628d5034c7879b76533cb3504de85#general-comments</a><br>

<br>
Should the formal citations list (produced when running with -citations)<br>
include underlying mathematical work or only tangible software that is<br>
being executed?  I'm hesitant to include the mathematical background, at<br>
least by default, because it is inherently non-scalable.<br></blockquote><div><br></div><div>I think we can differentiate between mathematical background and analysis, e.g.</div><div><br></div><div>  Proving that GMRES converges with these matrices, etc.</div>
<div><br></div><div>and showing exactly how to structure an algorithm:</div><div><br></div><div>  Saad and Schultz, 96</div><div><br></div><div>I am for including publications that show how to structure things even if they</div>
<div>do not produce code. I think in the future these kinds of publications will also</div><div>feature code since the culture is changing.</div><div> </div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">

We could perhaps have multiple levels of verbosity, one of which is<br>
basically "further reading".<br></blockquote><div><br></div><div>I think this could also be useful.</div><div> </div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">

Even with only software, applying automated citations recursively is a<br>
scalability risk similar to the advertising clause in 4-clause BSD,<br>
though the standard for publication about software tends to<br>
self-regulate a bit, along with the relative dearth of people interested<br>
in maintaining scientific software packages.<br></blockquote><div><br></div><div>If this does come to pass, we can add a "superceded" tag or something.</div><div><br></div><div>   Matt</div><div> </div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">

What do you think PetscCitations should be?<br>
</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>