Skip to content
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

Fix #1081. Make --USE_SEQUENTIAL_FASTQS help message more user friendly #1891

Merged
merged 2 commits into from
Jun 13, 2023

Conversation

nrockweiler
Copy link
Contributor

@nrockweiler nrockweiler commented Jun 12, 2023

  • Issue How to use USE_SEQUENTIAL_FASTQS option #1081 raised that help message for FastqToSam.java's --USE_SEQUENTIAL_FASTQS was not very intuititive. When I used this tool for the first time today, I also found the documentation confusing. Therefore, I made a PR.

  • Updated help message with more explicit usage (specific text on how to use the option and example commands).

Checklist (never delete this)

Never delete this, it is our record that procedure was followed. If you find that for whatever reason one of the checklist points doesn't apply to your PR, you can leave it unchecked but please add an explanation below.

Content

  • Added or modified tests to cover changes and any new functionality (not applicable; only documentation changed)
  • Edited the README / documentation (if applicable)
  • All tests passing on github actions

Review

  • Final thumbs-up from reviewer
  • Rebase, squash and reword as applicable

For more detailed guidelines, see https://github.com/broadinstitute/picard/wiki/Guidelines-for-pull-requests

…re user friendly in FastqToSam.java

 - Issue broadinstitute#1081 raised that help message for FastqToSam.java's --USE_SEQUENTIAL_FASTQS was not very intuititive.

 - Updated help message with more explicit usage (specific text on how to use the option and example commands).
@@ -161,17 +161,17 @@ public class FastqToSam extends CommandLineProgram {
@Argument(shortName="F2", doc="Input fastq file (optionally gzipped) for the second read of paired end data.", optional=true)
public PicardHtsPath FASTQ2;

@Argument(doc="Use sequential fastq files with the suffix <prefix>_###.fastq or <prefix>_###.fastq.gz." +
"The files should be named:\n" +
@Argument(doc="Use sequential fastq files with the suffix <prefix>_###.fastq[.qz]." +
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This should be [.gz], not [.qz]

Copy link
Contributor

@tmelman tmelman left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

".qz" should actually be ".gz". Pending that we will approve this change.

Copy link
Contributor

@tmelman tmelman left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Approved.

@tmelman tmelman merged commit 8ac4d15 into broadinstitute:master Jun 13, 2023
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants