pkg::create(3tcl)

✨ pkg::create ✨

okay bestie, welcome to the pkg::create page from the Tcl built-in commands manual 💖 this one's short and sweet and honestly kinda iconic.

---

🌸 NAME 🌸

pkg::create — build a whole 'package ifneeded' command for a package spec you hand it. it's giving matchmaker for packages fr fr 💅

---

🦋 SYNOPSIS 🦋

::pkg::create -name packageName -version packageVersion ?-load filespec?
... ?-source filespec? ...

---

💜 DESCRIPTION 💜

so ::pkg::create is a utility procedure, and it lives right in the standard Tcl library — she's part of the family 🫶. her whole job is to create an appropriate package ifneeded command for a given package specification. that's it. that's the gig.

and why do we care? because you can use her to construct a pkgIndex.tcl file for use with the package mechanism. yes bestie, the actual package mechanism. main character energy ✨

---

🎀 OPTIONS 🎀

the parameters she supports are:

• -name packageName — this one sets the name of the package. it's required, no skipping, no cap 💀
• -version packageVersion — this one sets the version of the package. also required babe, both of them, always 🌸
• -load filespec — this one says "hey, here's a library that must be loaded with the load command." and filespec is a list with two elements:
  • the first element is the name of the file to load 📁
  • the second element is optional, and it's a list of commands supplied by loading that file
  • if that list of procedures is empty or just... not there, then ::pkg::create will set up the library for direct loading (peep pkg_mkIndex for the lore 👀)
  • you can throw in any number of -load parameters, go off ✨
• -source filespec — basically the same vibe as -load, except this one specifies a Tcl library that must be loaded with the source command instead. and yes, any number of -source parameters may be specified 💖

okay real talk though: at least one -load or -source parameter must be given. you can't just show up with a name and a version and nothing else, that's not the move 😭

---

🔥 SEE ALSO 🔥

package(3tcl)

---

👑 KEYWORDS 👑

auto-load, index, package, version

---

and that's the whole page bestie, short king behavior but she gets the job done 💅✨

this was the Tcl 8.3 era of the manual, page pkg::create(3tcl) — mwah, sending you off with a 🎀 and a 🦋, go build that pkgIndex.tcl iykyk 💖