map::mark(3tk)

πŸ’– map::mark πŸ’–

okay bestie, welcome to map::mark(3tk) β€” it lives under the manual name map::mark, and the whole vibe is Map display support. It's a Tcl thing. It's a map thing. It's lowkey iconic. Let's get into it πŸ—ΊοΈβœ¨


✨ NAME ✨

map::mark β€” Map Action Engine β€” Mark A Point 🎯

That's it. That's the whole name. Short, sweet, main character energy.


πŸŽ€ SYNOPSIS πŸŽ€

package require Tcl 8.6-

package require debug

package require debug::caller

package require snit

package require map::mark ?0.1?

yes you need all of those, no you can't skip the boring ones, they're the supporting cast and they ate πŸ’…


🌸 DESCRIPTION 🌸

So here's the tea, bestie πŸ“: this package hands you a map::display attachment. An attachment, okay, not a whole new thing β€” it hooks onto the map and extends the map's behaviour. Think of it like putting a cute charm on your phone case. Same phone. Way more fun. ✨

And what does this attachment actually do? It lets the user mark locations, i.e. geo/points πŸ“. You point at a spot on the map, boom, it's marked.

The way you find out about those marked locations? A callback. The marked locations are reported via a callback. So it's not out here yelling at you unprompted β€” it tells you when you've asked it to tell you. Respectful. Considerate. Queen behaviour πŸ‘‘.


πŸ’… API πŸ’…

okay so… this section is empty in the source, bestie 😭 No entries. Nothing. Nada. The heading is there but there's no content under it. So there's genuinely nothing for me to spill here β€” I'm not about to invent API details and lie to you, that would be so not the move πŸ™ˆ. If the API shows up in a future version, slay, but right now it's giving bare shelf.


πŸ¦‹ EXAMPLE πŸ¦‹

same situation as API, bestie β€” this one is empty too πŸ’€ No example provided in the original. No code, no demo, no little snippet to copy-paste. I would love to hand you a cute example but there isn't one in the page, and making one up would be a fake-out. So: nothing here. Periodt. πŸŽ€


🌈 BUGS, IDEAS, FEEDBACK 🌈

real talk time 🫢 This document, and the package it describes, will undoubtedly contain bugs and other problems. Not "might". Will. Undoubtedly. That's the actual wording and honestly? The honesty is refreshing 😭.

So if you find something broken:

  • Report it in the category map of the Tklib Trackers: http://core.tcl.tk/tklib/reportlist
  • Also report ideas for enhancements you may have β€” for either the package and/or the documentation πŸ“

Yes, they want your ideas too. Your thoughts are valid. Your feedback is wanted. Go off, bestie πŸ’–


⭐ KEYWORDS ⭐

  • location marking
  • map
  • mark location

iykyk β€” if you know, you know πŸ“


πŸ‘‘ CATEGORY πŸ‘‘

Map Display and Supporting Utilities 🌸


reminder bestie: nothing in this page invented new behaviour. The package requires those exact package require lines, it extends map::display via an attachment, it marks geo/points, and it reports them through a callback. That's the whole story. No cap. πŸ’―

and that's the page!! πŸ’–βœ¨πŸŽ€ Big love to the tklib crew for this one, version 0.1, and shoutout to the 0.1 release of map::mark(3tk) itself. Manual page done, vibe check passed, go mark some points on a map and be the main character of your own geography πŸŒˆπŸ¦‹πŸ“πŸ’…πŸ‘‘

πŸ“¦ where this page comes from