MA...GE(1)

💅 MA...GE(1) 💅 — Oracle SQL Developer Command-Line Debian package builder

okay so bestie, welcome to the manual page for make-sqlcl-package — yes the header literally says MA...GE(1) and no we are not fixing it, it's iconic, it's giving mystery, it's giving "the man page writer had ONE job". Anyway. Sit down, grab a boba, we're building a Debian package for Oracle SQL Developer Command-Line and you're gonna understand every last flag. 🧚

✨ NAME ✨

make-sqlcl-package — the Oracle SQL Developer Command-Line Debian package builder. that's the whole name section, we keep it simple, we keep it slay. 💖

🌸 SYNOPSIS 🌸

make-sqlcl-package [options] <file>

like that's it. that's the whole vibe. options, then a file. periodt. 💅

🦋 DESCRIPTION 🦋

so make-sqlcl-package is a utility that builds a Debian package for Oracle SQL Developer Command-Line. literally its whole personality. 🔥

okay important part, don't scroll past this one bestie 😭

The Oracle SQL Developer Command-Line program is governed by the copyright holder (Oracle USA, Inc.), so you may be limited as to what you can do with the resulting package (i.e. no redistribution, etc). This utility will simply help you create the Debian package — it is your responsibility to use the resulting package accordingly with the OTN license, a copy of which is included in the created package, and that you must agree on when downloading the source. no cap, that license is in there, you agreed to it, it's real. 🫶

Also, this utility will require you to download the "Oracle SQL Developer Command-Line for All Platforms" archive from http://www.oracle.com/technetwork/developer-tools/sqlcl/overview/ to create the Debian package from. so like, go get the archive first, the tool is not gonna magically materialize it for you, bestie. 🌈

👑 OPTIONS 👑

every single one, in order, no skips, we don't do that here:

• -b, --build-dir <dir> — base directory to build package(s) (autogenerated). you don't have to pick one, it'll make one for you, main character energy fr fr ✨
• -e, --email <email> — local maintainer email (use DEBEMAIL or auto-generate). so it'll either read DEBEMAIL or just make one up for you 💌
• -i, --install — install the generated package(s) — needs root privilege (no). default is no, and heads up, this one needs root, so act accordingly 👑
• -k, --keep-dir — keep the build directory (no). by default it gets yeeted, this keeps it around 🎀
• -l, --revision <number> — local revision to append to package version (1). default is 1, it just gets tacked onto the version number 🔢
• -m, --maintainer <name> — local maintainer name (use DEBFULLNAME or leave empty). DEBFULLNAME if you've got it, otherwise empty, no stress 🌸
• -q, --quiet — suppress normal output (no). for when you want it to shut up and just work 🤫
• -r, --root-command <command> — command to gain root privilege for package build (fakeroot). the default root-gaining command is literally fakeroot, cute 🧚
• -u, --upstream-version <version> — force the upstream version (autodetected). it'll figure it out itself unless you insist 💅
• -x, --extract-only — prepare build tree, do not build package(s) [implies -k, --keep-dir] (no). notice how it implies --keep-dir? yeah. it does that. 🦋
• -h, --help — display the help screen. classic. always there for you 💖
• -v, --version — show the program version. also classic 🌟
• <file> — the "Oracle SQL Developer Command-Line for All Platforms" archive from http://www.oracle.com/technetwork/developer-tools/sqlcl/overview/. this is the one positional argument, don't forget it or the whole thing's a vibe check fail 😭

🎀 AUTHOR 🎀

make-sqlcl-package was written by Lazarus Long <lazarus.long@sapo.pt>. 🫶

This manual page was written by Lazarus Long <lazarus.long@sapo.pt>, for the Debian project (but may be used by others). so like, Debian core but it's generous with it, we love that for them 💜

and that's the page bestie!! footer says GNU, dated 2018-01-10, filed under MA...GE(1) — so go forth, download that archive, and build your package. you got this, no cap. 🎀💖✨