Code is the source of truth. The picocli annotation drives how options are parsed. And how the help is printed and how refguide man-page is written. Find a bug, fix the annotation once. Add a CLI option to a Tool? Add it in the code. Help and man in sync.
Jan > 15. okt. 2026 kl. 00:26 skrev Gus Heck <[email protected]>: > > What do you mean by zero drift? > > On Wed, Oct 14, 2026 at 4:41 PM Jan Høydahl <[email protected]> > wrote: > >> Hi, >> >> My preference is annotated code that generates both help output and man >> pages. Zero drift. Anywhere. >> >> Jan Høydahl >> >>> 14. okt. 2026 kl. 18:13 skrev Gus Heck <[email protected]>: >>> >>> Hmm, just noticed this thread, so I'm late to the party, but did anyone >>> look at DocOpt? http://docopt.org/ It's a system for generating the >> parser >>> from POSIX command help that would leave us with zero parsing/config code >>> to maintain. All we would need is to maintain the help file... >>> >>>> On Tue, Oct 13, 2026 at 9:10 AM Eric Pugh <[email protected]> wrote: >>>> >>>> The level of focus to make the new picocli backwards compatible has been >>>> really impressive, so I think swapping to the new Picocli makes a ton of >>>> sense. And if anyone finds an issue, or maybe uses a script, then they >> can >>>> use the fallback to commons-cli. >>>> >>>> +1 to flipping the switch in 10.2. >>>> >>>> --------------------------------------------------------------------- >>>> To unsubscribe, e-mail: [email protected] >>>> For additional commands, e-mail: [email protected] >>>> >>>> >>> >>> -- >>> http://www.needhamsoftware.com (work) >>> https://a.co/d/b2sZLD9 (my fantasy fiction book) >> >> --------------------------------------------------------------------- >> To unsubscribe, e-mail: [email protected] >> For additional commands, e-mail: [email protected] >> >> > > -- > http://www.needhamsoftware.com (work) > https://a.co/d/b2sZLD9 (my fantasy fiction book) --------------------------------------------------------------------- To unsubscribe, e-mail: [email protected] For additional commands, e-mail: [email protected]
