PLUMA(1)

πŸ’– PLUMA β€” the MATE Text Editor, bestie edition πŸ’–

okay so you opened the PLUMA(1) page from the General Commands Manual and honestly? slay. this is the glow-up guide to Pluma, the official text editor of the MATE desktop environment, and i'm gonna walk you through it like we're texting at 2am. πŸ¦‹


✨ NAME ✨

Pluma β€” The MATE Text Editor. that's it, that's the name, she's iconic, no notes. πŸ‘‘


🌸 SYNOPSIS 🌸

pluma [OPTIONS...] [FILES...]

literally just: her name, some options if you're feeling fancy, and the files you wanna open. periodt. πŸ’…


πŸ’œ DESCRIPTION πŸ’œ

So. Pluma is the official text editor of the MATE desktop environment. and the way that she's aiming at simplicity and ease of use while ALSO being a powerful general purpose text editor?? main character energy fr fr. she can create and edit all sorts of text files, like, any kind, she doesn't discriminate. πŸŽ€

Pluma also has a flexible plugin system which can be used to dynamically add new advanced features to Pluma herself. so she's always growing, always evolving, she's on her self-improvement arc and we love that for her. ✨

this manual page briefly documents the pluma command. brief but thorough, like a good gossip recap. 😌


⭐ OPTIONS ⭐

okay bestie, here's where it gets juicy. every single flag, no skips, no cap:

  • filename(s)... β€” specifies the file to open when pluma starts. if you don't give her one, she'll start a new, blank file with an "Unsaved Document" label (her little baby). multiple files can be loaded if they're separated by spaces. and yes, pluma also supports handling of remote files. she's flexible like that. 🌈
  • --display=DISPLAY β€” X display to use.
  • --encoding β€” set the character encoding to be used for opening the files listed on the command line. (iykyk, encodings are a whole thing.)
  • --new-window β€” create a new toplevel window in an existing instance of pluma. new window, who dis? πŸͺŸ
  • --new-document β€” create a new document in an existing instance of pluma, on the last Pluma window that had focus. she remembers where you were. attentive queen. πŸ’–
  • +[num] β€” for the first file, go to the line specified by num (do not insert a space between the + sign and the number). if num is missing, go to the last line. teleportation but make it text editing. 🧚
  • --list-encodings β€” display list of possible values for the encoding option and exit.
  • --version β€” output version information and exit. (she'll tell you who she is.)
  • -?, -h, --help β€” print standard command line options.
  • --help-all β€” print all command line options. the full lore drop.
also: this program also accepts the standard GTK options. so if you know GTK, you already know half the vibe. 🫢

πŸ¦‹ EXAMPLES πŸ¦‹

real scenarios, real energy, let's go:

pluma --encoding WINDOWS-1252
ftp://ftp.kernel.org/pub/linux/kernel/README

open the Linux Kernel README file from kernel.org's FTP server using Windows-1252 character encoding. pulling files from the kernel FTP like it's nothing. πŸ’€

pluma +156 http://mate-desktop.org/

open the main web page of mate-desktop.org and jump to line 156. jumping straight to the good part, as you should. πŸ”₯

pluma --new-window ~/.bashrc ~/.bash_history

open the current users .bashrc and .bash_history files in a new Pluma window. peak config-editing behavior, we've all been there at 3am. πŸ™ˆ


πŸ’€ BUGS πŸ’€

should you encounter any bugs, they may be reported at:

http://github.com/mate-desktop/pluma/issues

go tell the devs, they wanna know, fr fr. πŸ›


πŸŽ€ NOTES πŸŽ€

This version of the Pluma Manual Page was written with Pluma. =) yes she wrote her own manual. self-made icon behavior. πŸ‘‘


🌸 AUTHORS 🌸

This Man Page has been updated/re-written for the MATE Desktop Environment by:

  • Adam Erdman <hekel@archlinux.info> (2014)

thank you for your service. 🫑


πŸ“œ HISTORY πŸ“œ

Some portions of this manual were originally written by Gedit's previous developers, to accompany it in the GNOME Desktop Environment by:

  • Paolo Maggi <paolo@gnome.org>
  • Paolo Borelli <pborelli@katamail.com>
  • James Willcox <jwillcox@gnome.org>
  • Federico Mena Quintero <federico@novell.com>
  • Chema Celorio
  • (2000-2010)

the ancestors. the origin story. we stan a documented lineage. 🌈


πŸ‘‘ SEE ALSO πŸ‘‘

Pluma documentation can be found from the "Help" menu, or by pressing the F1 key.

Further information may also be available at:

http://wiki.mate-desktop.org/docs

press F1, bestie, the answers are right there. πŸ’œ


and that's the whole page!! MATE Desktop Environment, 29 January 2014, PLUMA(1) β€” mwah, love u, go edit some text πŸ’–βœ¨