[petsc-dev] PETSc goes Doxygen!?

[Matthew Knepley]

On Tue, Jan 15, 2013 at 3:35 PM, Jed Brown <jedbrown at mcs.anl.gov> wrote:

> On Tue, Jan 15, 2013 at 3:30 PM, Matthew Knepley <knepley at gmail.com>wrote:
>
>> I agree that it is not "user visible", but that does not mean I don't
>> want documentation on it.
>>
>
> There is no documentation on it now. We haven't made web pages for
> internal structures in the past. I don't use web documentation for private
> interfaces and I think it's a little dangerous to do so because it
> encourages people to include petsc-private/ headers and then scream at us
> when we change everything. We already have enough beginners on the mail
> list that accidentally tried to use developer level routines.
>

I am not sure I buy this argument, which is the same one that people in
Trilinos use to avoid
releasing source. I think it would be helpful in development.

  Matt

-- 
What most experimenters take for granted before they begin their
experiments is infinitely more interesting than any results to which their
experiments lead.
-- Norbert Wiener
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.mcs.anl.gov/pipermail/petsc-dev/attachments/20130115/7eeb92b1/attachment.html>