openwall / openwall/john

Document/review --test-full

Open
#4,627 6 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

bug documentation
Dominant language
C
Stars
13.6k
Forks
2.6k
PR merge metrics
No merged PRs in 30d

Description

I have no clue what the option does now. There seem to be no documentation other than the usage blob, which seems to be incorrect. It's listed as non-optional parameter but seems to be optional.

See https://github.com/openwall/john/issues/3514#issuecomment-799751758

I guess only @jfoug knows now, or do you @claudioandre-br or @solardiz ?

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start with the --test-full entry in the usage blob and review the discussion linked from issue #3514. Determine what the option does and whether its argument is optional, then update the documentation so the behavior and parameter status are accurate.

Written by the indexing model from the issue text.

Assessment

Tech stack
c
Domain
cli, documentation
Issue type
Documentation
Difficulty
4/5
Estimated time
3-5 days
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
25/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.