TEXT2PS(L)

πŸ“¦
version 2.20+TSQD Β· 2 versions
, in debian bookworm, debian trixie, ubuntu jammy, ubuntu noble, ubuntu questing

πŸ’– text2ps β€” like, the manual page (section L, bestie) πŸ’–

okay so hi. welcome to text2ps(L), the manual page for the little icon that turns your boring plain text into PostScript so your printer can actually do something with it. sit down, grab a strawberry πŸ“, and let's go.


✨ NAME ✨

text2ps β€” convert text files to PostScript. that's it. that's the whole job. and she ate. πŸ’…


🌸 SYNOPSIS 🌸

text2ps [ options ] [ files ]

πŸ¦‹ DESCRIPTION πŸ¦‹

okay so here's the tea: text2ps reads the input files (or standard input if you didn't give it any files, she's not gonna judge) and produces PostScript code which, when you feed it to a PostScript printer, will print the files. literally that's it. iconic behaviour. πŸ‘‘

with text2ps you can pick any font, any point size, and any number of columns. options and files can be intermixed on the command line β€” no rules, we're fluid like that ✨. options are effective for all the following files until they get overridden. it's giving "whatever I said last is what I meant".

πŸŽ€ Options πŸŽ€

here follows a list of options that text2ps recognises. most numeric arguments are significant to one decimal place (yes bestie, decimals count, she's precise). options are evaluated from left to right. later options override earlier ones β€” last one standing wins, periodt. πŸ’…

  • -# n β€” print n copies of each page. (Default 1.)
  • -c n β€” print in n columns. (Default 1.)
  • -f font β€” print using font font. (Default Courier.)
  • -p n β€” print with point size n. (Default 9.)
  • -v n β€” use a vertical spacing of n points. if the vertical spacing is set to 0, the spacing will be 1.2 times the point size. (Default 0.)
  • -l n β€” print n lines per column. when the line count is 0, print as many lines as will fit. (Default 0.)
  • -r [p|l] β€” set the orientation to either portrait mode (p) or landscape mode (l). (Default p.)
  • -b [+|-] β€” set page break mode. an argument + will force new files to be always printed on a new page (this is the default). after - new files will be put on the same page if there are still empty columns and the number of columns, the orientation or the number of copies didn't change. new files always start new columns. (Default -.)
  • -mt n β€” the top margin is n points. (Default 63.)
  • -mb n β€” the bottom margin is n points. (Default 63.)
  • -ml n β€” the left margin is n points. (Default 59.)
  • -mr n β€” the right margin is n points. (Default 59.)
  • -mg n β€” the inter-column gap is n points. (Default 25.)
  • -t [+|-] β€” if the argument is + the name of the file being printed will be printed on each page. if the argument is - the file name will not be printed. -t + implies -b +.
  • -T text β€” print text as title on each page. this implies -t - and -b +. this option can be switched off by specifying -t - or -t +. (Default no title.)
  • -F font β€” set the title font to font. (Default Helvetica.)
  • -P n β€” set the title point size to n. (Default 12.)
  • -B n β€” draw borders around each page. the number n specifies how to draw borders. N can have any of the following values or-ed in:
    1. draw a line along the left of the page.
    2. draw a line along the bottom of the page.
    3. draw a line along the right of the page.
    4. draw a line along the top of the page.
    5. draw a line between columns. this line does not connect to the lines along the top or bottom.
    6. draw a connecting line between the line between columns and the line along the top.
    7. draw a connecting line between the line between columns and the line along the bottom.

when n is 0, no border lines are drawn. (Default no bordering lines.) yes it's bitwise. yes it's or-ed. no I will not elaborate further, she's just built like that. πŸ’…

  • -w n β€” tab stops are set every n spaces. set the width of the TAB character. (Default 8.)
  • -1 β€” sets up options to print in one column in portrait mode with the Courier font, so that you get 66 lines on a page. equivalent to specifying the options -c 1 -f Courier -p 9 -v 0 -r p -l 0 -mt 63 -mb 63 -ml 59 -mr 59. this is the default. 🫢
  • -2 β€” sets up options to print in two columns in landscape mode with the Courier font, so that you get two 66-line columns on a page. equivalent to specifying the options -c 2 -f Courier -p 6 -v 0 -r l -l 0 -mt 63 -mb 63 -ml 59 -mr 59 -mg 25. together with the -1 option, this is probably the most useful option. (no cap, -2 is the moment, she's the main character 🌈)
also bestie, the name - means standard input. yes literally just a dash. she's mysterious like that. πŸ’€

πŸ’€ BUGS πŸ’€

okay so the vibes are immaculate but nothing is perfect, and here's the honest list:

  • Too many options. (fr fr. that's the bug. the bug is that there are too many of them. 😭)
  • There is no way to specify where the title will be placed.
  • If the font being used is not a constant width font and there are other characters than just tabs and spaces in front of a tab, the next character may not align properly.

and that's the whole page, bestie πŸ’– this was the text2ps(L) manual page β€” the (L) is right there in the title and right there in the footer, same energy, same page, slay. go print something cute. πŸŽ€βœ¨πŸ¦‹πŸ‘‘

πŸ“¦ where this page comes from