[MacPorts] #58340: Ill named binary for plantuml

MacPorts noreply at macports.org
Sat Apr 13 22:48:37 UTC 2019


#58340: Ill named binary for plantuml
---------------------------+--------------------
 Reporter:  informatimago  |      Owner:  (none)
     Type:  defect         |     Status:  new
 Priority:  Normal         |  Milestone:
Component:  ports          |    Version:
 Keywords:                 |       Port:
---------------------------+--------------------
 The binary for plantuml is named: /opt/local/bin/plantuml.sh*
 This is wrong.

 Unix scripts should not have any file extension.

 - They unnecessarily expose implementation detail (breaking
 encapsulation).
 - They uselessly and incompletely mimic detail from the #! line.
 - They capture insufficient detail to be useful at the system level (and
 aren't used).
 - They clash with recommended Unix (and Linux) practice.
 - They add noise to the command-level API.
 - They are very commonly technically incorrect for the script.
 - They give incorrect impressions about the use of the files they adorn.
 - They aren't validated even for what little info is present in them.
 - They interfere with switching scripting languages.
 - They interfere with changing scripting language versions.
 - They interfere with changing to presumably-faster compiled forms.
 - They encourage naively running scripts with the extension-implied
 interpreter.
 - They infect novice scripters with misinformation about Unix scripting.
 - They ironically are only a problem when interpreted by humans.

 See more at:

 http://www.talisman.org/~erlkonig/documents/commandname-extensions-
 considered-harmful

-- 
Ticket URL: <https://trac.macports.org/ticket/58340>
MacPorts <https://www.macports.org/>
Ports system for macOS


More information about the macports-tickets mailing list