-
Notifications
You must be signed in to change notification settings - Fork 596
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Mirror of Picard metrics documentation generation changes. #7749
Conversation
@cmnbroad Could you rebase this branch when you get a chance, and un-mark it as a draft? |
Codecov Report
Additional details and impacted files@@ Coverage Diff @@
## master #7749 +/- ##
===============================================
+ Coverage 86.352% 86.635% +0.283%
+ Complexity 39055 38927 -128
===============================================
Files 2343 2334 -9
Lines 183577 182629 -948
Branches 20084 20052 -32
===============================================
- Hits 158522 158220 -302
+ Misses 17982 17372 -610
+ Partials 7073 7037 -36
|
8837e5f
to
b0c095c
Compare
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
@cmnbroad Looks good to me. A few minor questions.
@@ -46,6 +65,7 @@ public GATKHelpDocWorkUnitHandler(final HelpDoclet doclet) { | |||
* @param currentWorkUnit the work unit for the feature being documented | |||
*/ | |||
@Override | |||
@SuppressWarnings({"deprecation","removal"}) |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Is this something that's going to need to be updated as soon as we go to 17?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Yes, since I've now rebased this branch on the Java 17 code, I've removed these.
currentWorkUnit.setProperty(WORK_UNIT_SUMMARY_KEY, currentWorkUnit.getSummary()); | ||
final List<Map<String, String>> workUnitMetricsList = new ArrayList<>(); | ||
currentWorkUnit.setProperty(METRICS_MAP_ENTRY_KEY, workUnitMetricsList); | ||
final com.sun.javadoc.FieldDoc[] fieldDocs = currentWorkUnit.getClassDoc().fields(false); |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Why fully qualify this instead of importing it?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Not sure why this was like this, but this code has now been replaced with the Java 17 version since I rebase on that, so its gone anyway.
@@ -0,0 +1,69 @@ | |||
<?php |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
This is just copied from picard I assume?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Its copied from the Picard one that I made up when I added the metrics ;-). I removed the group in from it though, since thats not usually included in the detail pages and for some reason I left it in the Picard one (which is not really used anyway).
|
||
include '../../../common/include/common.php'; | ||
include_once '../../config.php'; | ||
$module = modules::GATK; |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
With some minor changes it looks like.
4cffeec
to
402fae2
Compare
… other detail pages.
0c21c49
to
f99ced2
Compare
Reflect the changes from broadinstitute/picard#1782 in the GATK doc build.
Note that this requires a new version of Picard that is not yet released. Also, I suppressed deprecation warnings caused by the use of obsolete Java 8 javadoc classes (FieldDoc) for now, since it causes the Java 11 build to fail.
A new metrics category shows up in the doc now, with all of the Picard and GATK metrics: