TCAL(1)

✨ TCAL — bestie's guide to the tomorrow button ✨

okay so real talk, you found the tcal page in the General Commands Manual and honestly? it's giving tiny-but-mighty. let's go 💖

---

🌸 NAME 🌸

Tcal — runs the Gcal program with the date of tomorrow's day.

like, it's a whole vibe. you want tomorrow? boom, tomorrow. 🦋

---

🎀 SYNOPSIS 🎀

tcal [--help | --version] | [--shift=[+|-]number] [Argument...]

look at her. compact. iconic. no notes. ✨

---

💅 DESCRIPTION 💅

okay so Tcal is this little program that runs gcal with a date set one day ahead — which is literally equivalent to the --shift=1 option, no cap. one day. tomorrow. that's the whole personality. 🔥

and the way it treats your args?? all given arguments are passed unmodified to the Gcal program. untouched. pristine. she's not editing your fit, she's just delivering it. 🫶

but what if you don't want tomorrow, bestie? what if you want, like, a specific other date? valid. that's what --shift=[+|-]number is for — here [+|-]number is the distance in days the desired date is distant from the actual date. so you're basically saying "yo, take me this many days away from rn." 🧚

⚠️ heads up though: this works only for Gregorian years. don't come at me, that's just the rules.

⚠️ also — and this one matters — the --shift option must be given before all other arguments which are passed to the Gcal program. before. like, first. the moment she's not first, it's over. 😭

and exit statuses? simple queen behaviour: an exit status of 0 means all processing is successfully done. any other value means an error has occurred. periodt. 💀

---

⭐ OPTIONS ⭐

• --help — print a usage message listing all available options, then exit successfully. she's helpful AND she leaves on a high note. 👑
• --version — print the version number, then exit successfully. just the digits, then dip. 💨
• --shift=[+|-]number — define the displacement in [+|-]number days the desired date is distant from the actual date. yes bestie, you're time travelling, and [+|-]number is your ticket. 🕰️✨

---

🌈 ENVIRONMENT 🌈

• GCALPROG — this environment variable contains the file name of the executable Gcal program, which is used by Tcal to call Gcal. and the tea? it takes precedence over the file name gcal, which is burned-in during the compilation step of tcal. so like, environment variable is the main character here, the compiled-in default is just the understudy. 🎬

---

👑 COPYRIGHT 👑

Tcal Copyright (c) 1995, 96, 1997, 2000 Thomas Esken

---

okay so here's the serious part, and I need you to actually read it, bestie:

This software doesn't claim completeness, correctness or usability. On principle I will not be liable for any damages or losses (implicit or explicit), which result from using or handling my software. If you use this software, you agree without any exception to this agreement, which binds you LEGALLY !!

like. LEGALLY. capital letters. that's not a vibe, that's a contract. 📜

---

Tcal is free software and distributed under the terms of the GNU General Public License; published by the Free Software Foundation; version 2 or (at your option) any later version.

---

Any suggestions, improvements, extensions, bug reports, donations, proposals for contract work, and so forth are welcome! If you like this tool, I'd appreciate a postcard from you!

not me about to send an actual postcard?? 📮💌

Enjoy it =8^)

---

🦋 AUTHOR 🦋

  ------------------------oOO      \\\_''/      OOo---------------------------
  Thomas Esken               O     (/o-o\)     O  eMail: esken@gmx.net
  Im Hagenfeld 84                 ((  ^  ))       Phone: +49 251 232585
  D-48147 Muenster; Germany    \____) ~ (____/    MotD : 2old2live, 2young2die

the ASCII art?? the MotD?? 2old2live, 2young2die?? that's a whole aesthetic and I'm obsessed. 🥹

---

🍓 SEE ALSO 🍓

• gcal(1)
• txt2gcal(1)
• gcal2txt(1)

the whole friend group. go say hi. iykyk. 💜

---

💖 that's the page, bestie — dated June 14, 2000, from the General Commands Manual, and it lives in the TCAL(1) corner of the universe. mwah. 💅✨