Beefy Boxes and Bandwidth Generously Provided by pair Networks
"be consistent"
 
PerlMonks  

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

by hippo (Archbishop)
on Nov 13, 2024 at 10:28 UTC ( [id://11162675]=note: print w/replies, xml ) Need Help??


in reply to Re: Choosing namespace/name for (my first) CPAN module which is a sub-class of a well-known distribution
in thread 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.

Log In?
Username:
Password:

What's my password?
Create A New User
Domain Nodelet?
Node Status?
node history
Node Type: note [id://11162675]
help
Chatterbox?
and the web crawler heard nothing...

How do I use this?Last hourOther CB clients
Other Users?
Others wandering the Monastery: (6)
As of 2026-02-18 10:14 GMT
Sections?
Information?
Find Nodes?
Leftovers?
    Voting Booth?

    No recent polls found

    Notices?
    hippoepoptai's answer Re: how do I set a cookie and redirect was blessed by hippo!
    erzuuliAnonymous Monks are no longer allowed to use Super Search, due to an excessive use of this resource by robots.