I am starting to poke at the CLI-339 feature.. Looking at the PR, https://github.com/apache/commons-cli/pull/314/files#diff-c5837d81e3e4f87d5222b1d8caa45c9c9cd2c6edff6ad31e3a0b603f0b64d389, I see the code... I am not quite seeing the big picture however... I am hoping to see some docs on "How to use the new Help Formatter extensions"...
It does seem like JavaDocs are our primary documentation format over the website usage.html page... I'm hoping to confirm that what Claude wrote (thank you!!) works the way we want it to before 1.10 goes out! On Fri, Oct 4, 2024 at 12:56 PM Claude Warren <[email protected]> wrote: > Thx Gary. I will review this weekend. > > On Fri 4 Oct 2024, 15:41 Gary D. Gregory, <[email protected]> wrote: > > > Hi all, > > > > I wrote a bunch of comments in the PR. > > > > Gary > > > > On 2024/10/02 10:57:53 Tushar Kapila wrote: > > > I don't contribute code. But looking at the dictionary meaning Scribe > > fits. > > > So my vote is Scribe. > > > > > > a word that fits and not confused with existing class/ responsibility? > > > > > > verb > > > 1. > > > literary > > > write. > > > "he scribed a note that he passed to Dan" > > > > > > On Wed, 2 Oct 2024, 14:35 Gary Gregory, <[email protected]> > wrote: > > > > > > > Sorry about that, I'll have a look today or tomorrow. > > > > > > > > Gary > > > > > > > > On Wed, Oct 2, 2024, 3:39 AM Claude Warren <[email protected]> wrote: > > > > > > > > > Not hearing any other ideas and even though I prefer "Scribe" I > will > > > > rename > > > > > the class to "HelpWriter". > > > > > > > > > > Thanks everyone for your input. > > > > > > > > > > On Mon, Sep 30, 2024 at 9:26 PM Peter Burka <[email protected]> > wrote: > > > > > > > > > > > My vote (which everyone is free to ignore) is still for > HelpWriter. > > > > It's > > > > > > simple and intuitive, and it's consistent with the names of the > > methods > > > > > the > > > > > > interface declares (e.g. writePara, writeTable). I > > > > > > find SemanticAppendableDecorator too verbose and I have no > > intuition > > > > for > > > > > > what it means. > > > > > > > > > > > > Peter > > > > > > > > > > > > On Mon, Sep 30, 2024, 12:31 PM Claude Warren <[email protected]> > > wrote: > > > > > > > > > > > > > If we can settle on a name for the > > > > > > > serializer/scribe/writer/printDecorator/amenuensis thing the > > rest of > > > > > the > > > > > > > code is ready. It passes all the tests, it has 100% test > > coverage, > > > > > and > > > > > > it > > > > > > > works for what Rat is trying to do. > > > > > > > > > > > > > > > > > > > > > On Sat, Sep 28, 2024 at 2:08 PM Claude Warren < > [email protected]> > > > > > wrote: > > > > > > > > > > > > > > > I have opened https://github.com/apache/commons-cli/pull/314 > > to > > > > > track > > > > > > > the > > > > > > > > proposed changes > > > > > > > > > > > > > > > > On Sat, Sep 28, 2024 at 11:42 AM Claude Warren < > > [email protected]> > > > > > > wrote: > > > > > > > > > > > > > > > >> I know some graphics programs use the term "engraver" for > code > > > > that > > > > > > > >> creates the output of graphical representations of things > > (like > > > > > notes, > > > > > > > >> staves, and resets in musical notation). Scribe seems like > > the > > > > > > textual > > > > > > > >> equivalent. > > > > > > > >> > > > > > > > >> If we go with the decorator approach then I think the > > underlying > > > > > > > >> interface should be SemanticAppendableDecorator. > > > > > > > >> > > > > > > > >> > > > > > > > >> - Semantic because it describes what to do with the > > semantic > > > > > terms > > > > > > > >> like "paragraph", "header", and "list". > > > > > > > >> - Appendable because that is what is wraps. > > > > > > > >> - Decorator because that is what it does. > > > > > > > >> > > > > > > > >> > > > > > > > >> > > > > > > > >> On Sat, Sep 28, 2024 at 9:26 AM Gilles Sadowski < > > > > > [email protected] > > > > > > > > > > > > > > >> wrote: > > > > > > > >> > > > > > > > >>> Le sam. 28 sept. 2024 à 00:17, Gary Gregory < > > > > > [email protected]> > > > > > > a > > > > > > > >>> écrit : > > > > > > > >>> > > > > > > > > >>> > It's pretty unusual IMO, not like anything in the JDK for > > > > > example. > > > > > > > >>> > > > > > > > >>> Agreed. > > > > > > > >>> > > > > > > > >>> > I'll see > > > > > > > >>> > if I can come up with something tomorrow... > > > > > > > >>> > > > > > > > >>> How about "PrintDecorator" ? > > > > > > > >>> > > > > > > > >>> Gilles > > > > > > > >>> > > > > > > > >>> >>> [...] > > > > > > > >>> > > > > > > > >>> > > > > > > --------------------------------------------------------------------- > > > > > > > >>> To unsubscribe, e-mail: [email protected] > > > > > > > >>> For additional commands, e-mail: > [email protected] > > > > > > > >>> > > > > > > > >>> > > > > > > > >> > > > > > > > >> -- > > > > > > > >> LinkedIn: http://www.linkedin.com/in/claudewarren > > > > > > > >> > > > > > > > > > > > > > > > > > > > > > > > > -- > > > > > > > > LinkedIn: http://www.linkedin.com/in/claudewarren > > > > > > > > > > > > > > > > > > > > > > > > > > > > > -- > > > > > > > LinkedIn: http://www.linkedin.com/in/claudewarren > > > > > > > > > > > > > > > > > > > > > > > > > > > > -- > > > > > LinkedIn: http://www.linkedin.com/in/claudewarren > > > > > > > > > > > > > > > > --------------------------------------------------------------------- > > To unsubscribe, e-mail: [email protected] > > For additional commands, e-mail: [email protected] > > > > >
