Re^2: Choosing namespace/name for (my first) CPAN module which is a sub-class of a well-known distribution

is PDF::Manipulate (rather, PDF::Manipulate::X) an OK name? (Contra: Verb as 2nd term? Too long? Negative connotations?)

"Manipulate" seems OK to me. If you think it is overly long then "Manip" is also fine (See Date::Manip, Bit::Manip, et al).

I considered "Parser", or "Wielder", or "ReadWrite", but like them even less.

Simply, "Edit"?

Honestly, it's the ::X and ::X2 which are slightly more confusing anyway. I would probably be more inclined to go with PDF::Foo::Compat for the drop-in replacement one and just PDF::Foo for the forward-looking one (where Foo is one of Manipulate/Manip/Edit/...). How does that sound?

🦛

Comment on Re^2: Choosing namespace/name for (my first) CPAN module which is a sub-class of a well-known distribution Select or Download Code

Replies are listed 'Best First'.
Re^3: Choosing namespace/name for (my first) CPAN module which is a sub-class of a well-known distribution by Anonymous Monk on Nov 13, 2024 at 17:04 UTC
Thank you very much, hippo, I like `PDF::Manip` a lot. Somehow modules you mentioned slipped my mind, and metacpan's search for "Manipulate" didn't show them in the 1st hundred. Very respectful company for my distribution, then :-). `Edit` is not so apt, because "editing" may falsely imply the ability to e.g. "search for word 'Perl' and make its font bold-faced". I also see good reasons/logic for having `Compat` in module's name. Originally I intended (restoring for a moment the previous name-set) to have `PDF::CAMPDF::X` in Synopsis, etc., and only later/gradually advise to use `X2` in new code. For usual/small PDF files, `X2` is not much of an advantage, and less confusion to learn the difference. But now I see perhaps you are right, I owe fair amount of explaining to would-be users anyway.	[reply] [d/l] [select]

Replies are listed 'Best First'.

Re^3: Choosing namespace/name for (my first) CPAN module which is a sub-class of a well-known distribution
by Anonymous Monk on Nov 13, 2024 at 17:04 UTC

Thank you very much, hippo, I like PDF::Manip a lot. Somehow modules you mentioned slipped my mind, and metacpan's search for "Manipulate" didn't show them in the 1st hundred. Very respectful company for my distribution, then :-). Edit is not so apt, because "editing" may falsely imply the ability to e.g. "search for word 'Perl' and make its font bold-faced". I also see good reasons/logic for having Compat in module's name. Originally I intended (restoring for a moment the previous name-set) to have PDF::CAMPDF::X in Synopsis, etc., and only later/gradually advise to use X2 in new code. For usual/small PDF files, X2 is not much of an advantage, and less confusion to learn the difference. But now I see perhaps you are right, I owe fair amount of explaining to would-be users anyway.

[reply]
[d/l]
[select]