NAUTY-SUMLINES(1)

🎀 NAUTY-SUMLINES 🎀

okay so this is the page for nauty-sumlines from the nauty manual — yes bestie, the one that's all about sumlines, and it's lowkey iconic. let's get into it 💖

---

✨ NAME ✨

nauty-sumlines — sum lines matching specified graph formats 🦋

---

🌸 SYNOPSIS 🌸

sumlines [-w|-W] [-v] [-d] [-n] [-f fmtfile]...  file file file ...

---

💅 DESCRIPTION 💅

okay so the whole vibe: it sums up lines that match the formats you specify. that's the gig. 🫶

you can throw any number of input files at it, fr fr.

• - means stdin. yes, just a lil dash.
• if there are no files given, it just assumes stdin. that's it, that's the default.
• file names can contain wildcards, and in that case every matching file gets used — in numerically sorted order, no cap.

---

🌈 where the formats come from 🌈

bestie, the formats get read from four sources, and the order matters, so pay attention 👑

1. any files mentioned with -f on the command line (any number of them).
2. the file named in the environment variable SUMLINES.FMT (if any).
3. the file sumlines.fmt in the current directory (if it exists).
4. the file sumlines.fmt in the home directory (if it exists).

all of these are read if they exist, and the results are concatenated. and here's the tea: formats that exactly match earlier formats (except perhaps for flags) are not used. like, we already have that one, moving on 💅

---

🧚 how a format is shaped 🧚

each format occupies exactly two lines, periodt.

• the first line gives a list of flags: DEFAULT FINAL ERROR UNIQUE COUNT CONTINUE NUMERIC SILENT ENDFILE P=# NOPREFIX BEFORE/.../ AFTER/.../ — separated by spaces, commas or |s.
• the second line gives the format itself.

⚠️ heads up bestie: there can also be blank lines and lines with only comments — but not between the flags line and the format itself. the two of them are a package deal, don't separate them 😭

---

🍓 example 🍓

this totals the summary lines of autoson runs:

DEFAULT
# comment
cpu=%fu,%fs,%fx
pf=%d

---

👑 OPTIONS 👑

• -d — don't read sumlines.fmt or ~/sumlines.fmt or $SUMLINES.FMT
• -w — suppresses warning messages about no matching lines or no matching final lines.
• -W — in addition, suppresses warning about missing cases.
• -n — don't write the number of matching lines for each format.
• -v — produces a list of all the formats.

---

and that's the whole page, bestie, you ate it 💜 this was nauty version 2.8.9, dated September 2024 — go forth and sum those lines, main character 🌟💖