sawfish(1)

📦
version 1.13.0 · 2 versions
, in fedora 43, fedora 44, nixos 26.05

✨ sawfish — the manual page, bestie edition ✨

okay so you're reading the sawfish(1) page from the General Commands Manual and honestly? iconic of you. sit down, grab a strawberry 🍓, and let's get into it.

💖 NAME 💖

sawfish — the Sawfish window manager. that's it, that's the name, she's simple like that 💅

🌸 SYNOPSIS 🌸

sawfish

no flags, no arguments, just vibes. run it and she's there 🦋

👑 DESCRIPTION 👑

Sawfish is a lisp-extensible window manager for X11. like, she runs your windows, and you can teach her new tricks in Lisp.

her whole thing — her main character energy, if you will — is that she wants all areas of window management (decoration, manipulation) to be customizable as far as is possible, while still remaining as fast as existing window managers. so: fully customizable and not slow. she ate 💅✨

🎀 OPTIONS 🎀

  • --disable-nls — turn off internationalization of messages. no translations, just the raw text, no cap.
  • FILE — load the Lisp file FILE (from the cwd if possible — she'll try, bestie). heads up: this implies --batch.
  • --batch — batch mode: process the options and then exit. in and out, no lingering 🚪
  • --interp — interpreted mode: don't load compiled Lisp files. we're reading the source today, periodt.
  • -f, --call FUNCTION — call the Lisp function FUNCTION.
  • -l, --load FILE — load the file of Lisp forms called FUNCTION. (yes, that's what it says. the manpage said it, so I said it. iykyk 💀)
  • --version — print version details. the receipts ✨
  • --no-rc — don't load rc or site-init files.
  • -q, --quit — terminate the interpreter process. bye bestie 👋
  • --5-buttons — support keyboard layout switching, but drop mouse buttons 6 - 8 support. you're trading one thing for another, that's the deal.
  • --replace — replace the running window manager with Sawfish. out with the old, in with the slay 🔥

🌈 Display Options 🌈

  • --display=DPY — connect to X display DPY.
  • --multihead — fork a copy of sawfish for each screen. one sawfish per screen, a whole squad 🫶
  • --visual=VISUAL — preferred VISUAL type.
  • --depth=DEPTH — preferred color DEPTH.

💜 Customization Files Options 💜

  • --custom-file FILE — overrides the default custom file ~/.sawfish/custom.
  • --window-history-file FILE — overrides the default window history file ~/.sawfish/window-history.
  • --no-rc — do not load the rc file.

🧚 Session Management Options 🧚

  • --sm-client-id ID
  • --sm-prefix PREFIX

(no descriptions given in the original, so we're leaving those exactly as they are — mystery queens 💅)

⭐ Debugging Option ⭐

  • --sync — Read src/display.c. Don't use it unless you're sure.
okay but fr fr, that's a real warning. the manpage literally says don't use it unless you're sure. be sure, or don't. 💀

🔥 SEE ALSO 🔥

Sawfish is documented fully by John Harper, available via the Info system. go read the full thing, it's giving ✨ comprehensive ✨

🌸 AUTHOR 🌸

This manual page was written by Christian Marillat marillat@debian.org for the Debian GNU/Linux system (but may be used by others). king behavior honestly 👑

and that's the whole page bestie 🫶 it's the sawfish(1) manual, straight out of the General Commands Manual — no version number, no date on this one, just the good word. go customize some windows 💖🎀🦋

📦 where this page comes from