You show the generated Doxygen, or you use Doxygen's formatting of the .cc source? That's also possible through the hg interface, e.g. https://rivet.hepforge.org/hg/rivet/file/tip But I admit that the URLs are awkward, and there's no syntax highlighting.<div><div><br></div><div>Here's a possibility: we add syntax-highlighted source code to the analysis metadata pages, now that that's not on one huge HTML page. Would that do what you need? It would have the benefits of keeping the API docs clean (although still very much improveable...) and of not adding any more steps to the release procedure.</div><div><div><br></div><div>Andy</div><br><signature><div><table cellpadding="0" cellspacing="0"><tbody><tr><td colspan="2"><div style="padding-bottom:15px;"><div><strong>Dr Andy Buckley, Lecturer / Royal Society University Research Fellow</strong></div><div>Particle Physics Experiment Group, University of Glasgow</div></div></td></tr><tr><td style="vertical-align:top;"></td><td><div style="font-size:0.9em;white-space:nowrap;border-left:2px solid gray;margin-left:20px;padding-left:20px;"><div><div></div><div></div></div></div></td></tr></tbody></table></div></signature></div></div>
<div class="gmail_quote nylas-quote nylas-quote-id-1C14EE62-6B2D-42EA-98DC-90889F83A1A7@cern.ch">
<br>
On Jan 8 2018, at 9:39 am, Christian Gutschow <chris.g@cern.ch> wrote:
<br>
<blockquote class="gmail_quote"
style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex;">
<span></span><body style="word-wrap: break-word; -webkit-nbsp-mode: space; line-break: after-white-space;"><div style="padding-bottom: 20px;"></div><div>
<meta content="text/html; charset=utf-8">
Hi,<br>
<div><br>
<blockquote type="cite">
<div>
<div>
<div>This wasn't just an accident: the point of the API documentation is to tell users about the code interface. Analyses aren't part of the interface -- they all have to behave like the base Analysis class, but any other aspects of their derived interface
are purely implementation details and ~no-one should care. Those who do can look at the code directly, and "metadata" about them is available via the (now more convenient) analysis documentation.</div>
<div><br>
</div>
<div>Why do you need access to the analysis Doxygen? We could make a second Doxygen build for that purpose, but since it would be yet more work/complexity as part of the release process there would need to be a very good reason... and I don't currently
see what that would be.</div>
</div>
</div>
</blockquote>
<div><br>
</div>
<div>
<div>True for the projections, but I reckon that if you’re new to Rivet (and possibly beyond), it is more instructive/convenient to browse through the existing experimental analysis cc files in a web browser in order to understand how the projections are being
used, no?</div>
<div><br>
</div>
<div>I’m certainly guilty of advertising in tutorials and what not a wealth of example code from existing analyses on the web...</div>
<div><br>
</div>
<div>Cheers,</div>
<div>Chris</div>
</div>
<div><br>
</div>
<div><br>
</div>
<div><br>
</div>
<blockquote type="cite">
<div>
On Jan 6 2018, at 12:11 pm, David Yallup <<a href="mailto:david.yallup@cern.ch">david.yallup@cern.ch</a>> wrote:
<br>
<blockquote style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex;">
<span></span>
<div>
<div style="padding-bottom: 20px;"></div>
<div>Dear Rivet authors, <br>
<br>
This might be me being dense but I can't find the source code in doxygen <br>
for the analysis plugins on the hepforge site any more? I used to just <br>
go here <br>
<br>
<a href="https://rivet.hepforge.org/code/dev/files.html">https://rivet.hepforge.org/code/dev/files.html</a>
<br>
<br>
But I can't seem to find them, have they been moved/gone missing? <br>
<br>
Cheers, <br>
<br>
David <br>
<br>
_______________________________________________ <br>
Rivet mailing list <br>
<a href="mailto:Rivet@projects.hepforge.org">Rivet@projects.hepforge.org</a>
<br>
<a href="https://www.hepforge.org/lists/listinfo/rivet">https://www.hepforge.org/lists/listinfo/rivet</a>
<br>
</div>
</div>
</blockquote>
</div>
_______________________________________________<br>
Rivet mailing list<br>
<a href="mailto:Rivet@projects.hepforge.org">Rivet@projects.hepforge.org</a><br>
https://www.hepforge.org/lists/listinfo/rivet</blockquote>
</div>
<br>
<div>
<div style="color: rgb(0, 0, 0); letter-spacing: normal; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; word-spacing: 0px; -webkit-text-stroke-width: 0px; word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space;">
<div style="color: rgb(0, 0, 0); letter-spacing: normal; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; word-spacing: 0px; -webkit-text-stroke-width: 0px; word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space;">
<div style="color: rgb(0, 0, 0); letter-spacing: normal; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; word-spacing: 0px; -webkit-text-stroke-width: 0px; word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space;">
<div style="color: rgb(0, 0, 0); letter-spacing: normal; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; word-spacing: 0px; -webkit-text-stroke-width: 0px; word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space;">
<div style="color: rgb(0, 0, 0); letter-spacing: normal; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; word-spacing: 0px; -webkit-text-stroke-width: 0px; word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space;">
<div style="color: rgb(0, 0, 0); font-family: Helvetica; font-size: 12px; font-style: normal; font-variant-caps: normal; font-weight: normal; letter-spacing: normal; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; word-spacing: 0px; -webkit-text-stroke-width: 0px; word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space;">
<div style="color: rgb(0, 0, 0); letter-spacing: normal; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; word-spacing: 0px; -webkit-text-stroke-width: 0px; word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space;">
<div style="color: rgb(34, 34, 34); font-family: arial, sans-serif; font-variant-ligatures: normal; font-variant-position: normal; font-variant-numeric: normal; font-variant-alternates: normal; font-variant-east-asian: normal;">
<br>
<br>
</div>
<div style="color: rgb(34, 34, 34); font-family: arial, sans-serif; font-variant-ligatures: normal; font-variant-position: normal; font-variant-numeric: normal; font-variant-alternates: normal; font-variant-east-asian: normal;">
<br>
</div>
<div style="color: rgb(34, 34, 34); font-family: arial, sans-serif; font-variant-ligatures: normal; font-variant-position: normal; font-variant-numeric: normal; font-variant-alternates: normal; font-variant-east-asian: normal;">
—</div>
<div style="color: rgb(34, 34, 34); font-family: arial, sans-serif; font-variant-ligatures: normal; font-variant-position: normal; font-variant-numeric: normal; font-variant-alternates: normal; font-variant-east-asian: normal;">
<br>
</div>
<div style="color: rgb(34, 34, 34); font-family: arial, sans-serif; font-variant-ligatures: normal; font-variant-position: normal; font-variant-numeric: normal; font-variant-alternates: normal; font-variant-east-asian: normal;">
Dr. Christian Gütschow</div>
<div style="color: rgb(34, 34, 34); font-family: arial, sans-serif; font-variant-ligatures: normal; font-variant-position: normal; font-variant-numeric: normal; font-variant-alternates: normal; font-variant-east-asian: normal;">
<br>
</div>
<div style="color: rgb(34, 34, 34); font-family: arial, sans-serif; font-variant-ligatures: normal; font-variant-position: normal; font-variant-numeric: normal; font-variant-alternates: normal; font-variant-east-asian: normal;">
Department of Physics and Astronomy</div>
<div style="color: rgb(34, 34, 34); font-family: arial, sans-serif; font-variant-ligatures: normal; font-variant-position: normal; font-variant-numeric: normal; font-variant-alternates: normal; font-variant-east-asian: normal;">
University College London</div>
<div style="color: rgb(34, 34, 34); font-family: arial, sans-serif; font-variant-ligatures: normal; font-variant-position: normal; font-variant-numeric: normal; font-variant-alternates: normal; font-variant-east-asian: normal;">
Gower Street</div>
<div style="color: rgb(34, 34, 34); font-family: arial, sans-serif; font-variant-ligatures: normal; font-variant-position: normal; font-variant-numeric: normal; font-variant-alternates: normal; font-variant-east-asian: normal;">
London WC1E 6BT</div>
</div>
</div>
<br style="color: rgb(0, 0, 0); font-family: Helvetica; font-size: 12px; font-style: normal; font-variant-caps: normal; font-weight: normal; letter-spacing: normal; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; word-spacing: 0px; -webkit-text-stroke-width: 0px;">
<br>
</div>
</div>
</div>
</div>
</div>
</div>
<br>
</div></body>
</blockquote>
</div>