SGB(1)

🌸 SGB(1) — General Commands Manual 🌸

okay bestie, sit down, hydrate, because we're talking about The Stanford GraphBase and it's genuinely a whole vibe 💖

---

✨ NAME ✨

<purple>sgb</purple> — The Stanford GraphBase: combinatorial data and algorithms 🦋

---

💅 SYNOPSIS 💅

not me having to say this but like… there's no fancy synopsis line here. sgb isn't one of those "type a flag, get a result" commands. it's a system. a whole collection. so just keep reading, bestie, it's giving library energy 📚✨

---

🌈 DESCRIPTION 🌈

okay so first thing's first: this manual page is out here documenting the Stanford GraphBase briefly, and it was written specifically for the Debian GNU/Linux distribution (but like, other people can use it too, it's not gatekept 🫶). the reason it exists at all is that the original program doesn't have a manual page — so this is basically the fandom wiki page we made ourselves. iconic behavior honestly.

The Stanford GraphBase, created by Prof. Donald Knuth of Stanford University, is a highly portable collection of programs and data for researchers who study combinatorial algorithms and data structures. no cap, it's been serving cunt in academia for decades 👑

and here's the part that makes it chef's kiss: the programs are intended to be interesting in themselves, as examples of literate programming. so you can also think of the Stanford GraphBase as a collection of approximately 30 essays for programmers to enjoy reading — whether or not you're out here doing algorithmic research. it's giving "read it for the plot" energy. the programs are written in CWEB, a combination of TeX and C that's easy to use by anyone who knows those languages, and easy to read by anyone familiar with the rudiments of C. so if you know C even a little, you're in, bestie, no gatekeeping 💖

More details about the Stanford GraphBase can be found in the file /usr/share/doc/sgb/abstract.dvi.gz. you can view it using xdvi ✨ you can also convert it from DVI to some other format — a PostScript version can be created by using the command:

dvips -o abstract.ps abstract.dvi

and if you prefer a less readable ASCII version instead of Postscript (no judgment, we love a scrappy text file 🍓), you can create it with the non-free dvi2tty program:

dvi2tty -w132 -e-40 abstract.dvi >abstract.txt

Complete instructions to the Stanford Graphbase appear in the book by D. E. Knuth entitled The Stanford GraphBase: A Platform for Combinatorial Computing, published jointly by ACM Press and Addison-Wesley (1993), ISBN 0-201-54275-7. yes we're citing the ISBN, we're thorough like that 📖💜

All of the source code may be found in the directory /usr/sgb/doc/src. you can read the code directly, OR you can turn it into a pretty-printable TeX form by using the cweave program — see the cweb(1) manpage for more details. and lowkey this is the important bit: the source code forms the main documentation of the libgb library. so like, the source is the docs. main character energy fr fr ✨

---

🎀 FILES 🎀

• /usr/share/sgb — Data files for the GraphBase programs. 🗂️
• /usr/share/doc/sgb — The source code for the GraphBase programs. 📜
• /usr/lib/libgb.{a,so} — The GraphBase libraries. 🧚
• /usr/include/gb_*.h — Header files for the GraphBase library programs. 💜
• /usr/share/cweb — Directory for files included in the GraphBase programs via the CWEB @i command. 🦋

---

💀 BUGS 💀

Genuine bugs may be reported to Donald Knuth via email to sgb@cs.stanford.edu.

🚨 PLEASE DO NOT USE THIS EMAIL ADDRESS FOR ANY PURPOSE OTHER THAN TO REPORT BUGS IN THE STANFORD GRAPHBASE. PROF. KNUTH DOES NOT ACCEPT UNSOLICITED EMAIL. 🚨

like bestie I cannot stress this enough, that is a bug-report-only inbox, do NOT send him your fan mail, do NOT send him your startup pitch, do NOT send him a "hey quick question" — just bugs. periodt 🙈

---

👑 SEE ALSO 👑

• cweb(1)

---

🌸 AUTHOR 🌸

The Stanford Graphbase is copyrighted by Stanford University.

This manual page was written by Julian Gilbey <jdg@debian.org> for the Debian GNU/Linux system. 🫶

---

and that's the whole page, bestie!! this was the SGB(1) page from the General Commands Manual, as shipped in the Debian GNU/Linux distribution 💖 go forth, read some literate CWEB, report only genuine bugs, and slay 💅✨🌈