QUICKPLOT_SHELL(1)

💖 QUICKPLOT_SHELL 💖

okay so bestie, welcome to quickplot_shell — it's the remote command line shell for quickplot, and it is literally the group chat between you and a running Quickplot program. no cap. 🫶

---

✨ SYNOPSIS ✨

Usage: quickplot_shell [PID]|[-h|--help]|[QUICKPLOT_OPTIONS]

like... you either hand it a PID, or you ask for help, or you toss it some QUICKPLOT_OPTIONS. pick your fighter. 💅

---

🌸 DESCRIPTION 🌸

So. Quickplot is an interactive 2D plotter, and its whole main character thing is displaying 2D plots interactively. Obsessed. 🌈

quickplot_shell connects to a Quickplot program that's already running. It gives you a command line interface for most of the graphical user interfaces that are in the Quickplot program. It reads from standard input and writes to standard output, respectively — like the well-behaved little shell it is.

When standard input is a tty device, quickplot_shell turns on readline tab completion and history. yes. tab completion. we love to see it. ✨

Want your Quickplot shell history to survive between sessions? Just make a .quickplot_history in your home directory, like:

touch ~/.quickplot_history

and boom, your history is saved forever (well, saved). 💖

If the argument option PID is not given, quickplot_shell will launch Quickplot as a brand new process and connect to that new process. In that case Quickplot gets started with QUICKPLOT_OPTIONS, if any are given. giving "i'll make my own Quickplot" energy. 👑

If PID is given, quickplot_shell connects to a running Quickplot program with process ID PID. reconnecting to your ex... except it's a plotter and it's consensual. 🙈

Here's the tea on how it actually works: quickplot_shell sets up two named pipes, signals the running Quickplot program, and then writes commands and reads responses to and from the pipe. The named pipes get unlinked as soon as they're connected, so they'll be removed automatically when the two programs are no longer running. self-cleaning. iconic. 🧚

And now the vibe check: quickplot_shell, the remote Quickplot shell, acts just like running quickplot --shell, a local Quickplot shell. The difference? quickplot_shell runs as a separate process and talks to the Quickplot program using pipes, whereas quickplot --shell runs one single process with both the GUI and the shell, with no pipes. And here's the slay part: you may connect any number of remote Quickplot shells to a Quickplot program. the more the merrier fr fr. 🌸

• -h, --help — display help and exit. short, sweet, helpful. we stan. 🎀

---

👀 SEE ALSO 👀

• quickplot(1)

---

📜 COPYRIGHT 📜

Copyright (C) 1998-2011 Lance Arsenault

Quickplot is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

Quickplot is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

no warranty bestie, that part is real and it matters. 😭

You should have received a copy of the GNU General Public License along with Quickplot. If not, see <http://www.gnu.org/licenses/>.

---

🦋 AUTHOR 🦋

Lance Arsenault <lanceman@users.sourceforge.net>

Send bug reports or comments to the above address.

For more information, see the Quickplot homepage at <http://quickplot.sourceforge.net/>.

---

and that's the whole page, bestie 💖 stay connected, stay tab-completed, and go plot something gorgeous.

Quickplot Version 1.0.1rc: 10 Jan 2016 04:50:02 — mwah, xoxo, bye! 🎀✨