[Pkg-javascript-devel] add-node-component new option

[Jonas Smedegaard]

Quoting Yadd (2022-02-08 16:28:22)
> Since I saw you prefer to customize component names, I just added a 
> "-p" option to add-node-component (usable as environment variable: 
> PKGJS_CMP_PREFIX) to set a prefix to component names generated by 
> add-node-component. Will be released with pkg-js-tools 0.11.13.

Thanks, I appreciate that.

I must admit, however, that I feel alienated by pkg-js-tools and don't 
use those tools, but edit files in the debian subdirectory by hand.

Let's take this "add-node-component" tool as an example...:

I find the name unintuitive, and feel that it pollutes the global 
namespace.  What I would find intuitive was to type "pkg-js" and hit TAB 
to see which tools was available, and if that provided nothing then I 
would try "pkg" + TAB in case the tools used some other concatenating 
character than dash.  pkg-kde-tools is structured like that, and 
pkg-perl-tools is structured somewhat like that (it contains one tool 
"dpt" arguably confusingly named and a few general-purpose tools).

Even if you told me that a tool exists to add embed components in 
packages, how would I find that?  It is not mentioned in long 
description of the package, so won't show if I search for it with apt, 
apt-cache search, axi-cache search, or other similar tools.

Ok, so you tell me that it is called "add-node-component" and I locate 
with "apt-file search" which package it belong to and installs it - how 
to use it?  "man add-node-component" has an unusable NAME section (i.e. 
keywords for command "apropos"), DESCRIPTION section does not really 
describe what the tool does, only the syntax of the non-option argument 
to the tool.

Sorry, it sounds like a rant but isn't so much: I simply skip using 
those tools because I feel alienated by them - I am sharing my 
impression in case it might inspire to improve, and if not then I am 
fine continuing to not use those tools (and maybe you then prioritize 
other tasks than making the tools fit my unusual packaging style).


 - Jonas

-- 
 * Jonas Smedegaard - idealist & Internet-arkitekt
 * Tlf.: +45 40843136  Website: http://dr.jones.dk/

 [x] quote me freely  [ ] ask before reusing  [ ] keep private
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 833 bytes
Desc: signature
URL: <http://alioth-lists.debian.net/pipermail/pkg-javascript-devel/attachments/20220208/095664b4/attachment.sig>