Let me know and feel free to create a PR. I can cut a release candidate whenever you are ready.
Gary On Sun, Nov 10, 2024, 7:23 AM Eric Pugh <ep...@opensourceconnections.com> wrote: > 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 <cla...@xenei.com> wrote: > > > Thx Gary. I will review this weekend. > > > > On Fri 4 Oct 2024, 15:41 Gary D. Gregory, <ggreg...@apache.org> 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, <garydgreg...@gmail.com> > > wrote: > > > > > > > > > Sorry about that, I'll have a look today or tomorrow. > > > > > > > > > > Gary > > > > > > > > > > On Wed, Oct 2, 2024, 3:39 AM Claude Warren <cla...@xenei.com> > 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 <pe...@quux.net> > > 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 <cla...@xenei.com > > > > > 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 < > > cla...@xenei.com> > > > > > > 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 < > > > cla...@xenei.com> > > > > > > > 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 < > > > > > > gillese...@gmail.com > > > > > > > > > > > > > > > > >> wrote: > > > > > > > > >> > > > > > > > > >>> Le sam. 28 sept. 2024 à 00:17, Gary Gregory < > > > > > > garydgreg...@gmail.com> > > > > > > > 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: > dev-unsubscr...@commons.apache.org > > > > > > > > >>> For additional commands, e-mail: > > dev-h...@commons.apache.org > > > > > > > > >>> > > > > > > > > >>> > > > > > > > > >> > > > > > > > > >> -- > > > > > > > > >> 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: dev-unsubscr...@commons.apache.org > > > For additional commands, e-mail: dev-h...@commons.apache.org > > > > > > > > >
