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 >
