porgrc(5)

📦 version 0.10, in debian bookworm, ubuntu jammy, ubuntu noble

💖 porgrc(5) — the glow-up config file 💖

okay bestie, so porgrc is literally the configuration file for porg. yes, that porg — the source code package organizer, aka porg(8). this page is its manual, and it's giving "system-wide settings" energy. let's get into it 🫶

✨ SYNOPSIS ✨

/etc/porgrc

that's it. that's the whole vibe. one path. iconic. 👑

🌸 DESCRIPTION 🌸

porgrc is the system-wide configuration file for porg(8), the source code package organizer. no cap. that's the job. 💅

🎀 SYNTAX 🎀

the file is made of two things: comments and key-value pairs. that's the whole menu, girl.

  • Comments live on their own separate lines and start with a # symbol. that's the only way to comment, periodt.
  • Key-value pairs look exactly like this:
key=value

where key contains no whitespace and no equal signs, and value is all of the text after the equal sign, until (but not including) the ending newline. so yeah, everything up to the line break. 🙈

and here's a lil detail that's lowkey important: the name of key is case insensitive. like, INCLUDE, include and INcludE are all equivalent. same key, different font. slay. ✨

💅 OPTIONS 💅

here are all the options you can set. the equivalent command line options (if any exist) are listed in brackets, so you can match them up:

  • logdir [-L|--logdir] — the base porg logs directory. default is /var/lib/porg. environment variables like $HOME are expanded at runtime, so go wild. 🌈
  • include [-I|--include] — a colon-separated list of paths to scan when logging the installation of a package. default is /. shell wildcards are allowed in the paths — see PATH MATCHING below for the deets. 🦋
  • exclude [-E|--exclude] — a colon-separated list of paths to skip when logging the installation of a package. default is /tmp:/dev:/proc:/sys:/run. shell wildcards are allowed in the paths — again, see PATH MATCHING below. 💀
  • remove_skip [-e|--skip] — a colon-separated list of paths to skip when removing a package. default is '' — which means all logged files are removed. shell wildcards are allowed in the paths, and yes, see PATH MATCHING below. 🔥

🌟 PATH MATCHING 🌟

the variables include, exclude and remove_skip all accept a colon-separated list of paths, and each one of those paths may contain shell-like wildcards: *, ? and [..].

files get matched against each of those paths, following the standard shell-like expansion — but with one exception, and it's a big one:

If a path in the list does not contain any wildcard, and it is a directory, it matches any file within that directory.

so no wildcard needed for directories. she just knows. 🧚

📁 FILES 📁

  • /etc/porgrc — active configuration file (the one that's actually doing something 💅)
  • /usr/share/porg/porgrc — sample configuration file (the inspo board 🎀)

👑 AUTHOR 👑

Written by David Ricart (http://porg.sourceforge.net)

🔗 SEE ALSO 🔗

porg(8), porgball(8)

and that's the whole page, bestie!! this was porg 0.10, dated 17 May 2016 — go forth and configure, you absolute main character. mwah 💖✨🎀🦋🌸🫶

📦 where this page comes from