You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@freemarker.apache.org by Daniel Dekany <da...@gmail.com> on 2020/08/04 00:24:08 UTC
"freemarker-cli" command should be renamed to "freemarker-generator"
I brought this up earlier (can't find the mail), and it was not concluded.
The "product" name is freemarker-generator, therefore the command line
command (script) name should be freemarker-generator too, and not
freemarker-cli. Can we agree on this, and go ahead and rename those
executables? Then I will do the same in the Docgen documentation. If
there's a disagreement... read on.
If users keep typing freemarker-cli, they will start calling the product
"FreeMarker CLI", which is confusing, as we call it "FreeMarker Generator",
like when doing a release, or any communication, other than showing an
example command line call. Besides, it's just the convention that if a
product has a CLI, like let's say Java has one, the main CLI is just called
the product name ("java" in this case), but certainly not
${productName}-cli. Because usually it's obvious for the user that they
calls a CLI, when it's done. (Anyway, the product name is not just
"freemarker", which is the template engine.)
--
Best regards,
Daniel Dekany
Re: "freemarker-cli" command should be renamed to
"freemarker-generator"
Posted by Siegfried Goeschl <si...@gmail.com>.
+1 for freemarker-generator name
Thanks in advance,
Siegfried Goeschl
> On 04.08.2020, at 10:03, Jacques Le Roux <ja...@les7arts.com> wrote:
>
> +1 for freemarker-generator name
Re: "freemarker-cli" command should be renamed to
"freemarker-generator"
Posted by Jacques Le Roux <ja...@les7arts.com>.
+1 for freemarker-generator name
Jacques
Le 04/08/2020 à 02:24, Daniel Dekany a écrit :
> I brought this up earlier (can't find the mail), and it was not concluded.
> The "product" name is freemarker-generator, therefore the command line
> command (script) name should be freemarker-generator too, and not
> freemarker-cli. Can we agree on this, and go ahead and rename those
> executables? Then I will do the same in the Docgen documentation. If
> there's a disagreement... read on.
>
> If users keep typing freemarker-cli, they will start calling the product
> "FreeMarker CLI", which is confusing, as we call it "FreeMarker Generator",
> like when doing a release, or any communication, other than showing an
> example command line call. Besides, it's just the convention that if a
> product has a CLI, like let's say Java has one, the main CLI is just called
> the product name ("java" in this case), but certainly not
> ${productName}-cli. Because usually it's obvious for the user that they
> calls a CLI, when it's done. (Anyway, the product name is not just
> "freemarker", which is the template engine.)
>