pr(1)

💅 pr(1) — the paginate-and-columnate bestie 💅

okay so real talk, you found the manual page for pr from the General Commands Manual section of the manual pages. she's giving printing-prep energy and honestly? iconic.

---

✨ NAME ✨

pr — paginate or columnate FILE(s) for printing

like, she takes your files and makes them cute and page-shaped for when they hit actual paper. no cap. 🖨️

---

🌸 SYNOPSIS 🌸

pr [--pages] [-h|--header] [-D|--date-format] [-d|--double-space]
[-n|--number-lines] [-N|--first-line-number] [-t|--omit-header]
[-T|--omit-pagination] [-l|--length] [-r|--no-file-warnings]
[-F|--form-feed] [-w|--width] [-W|--page-width] [-a|--across] [--column]
[-s|--separator] [-S|--sep-string] [-m|--merge] [-o|--indent] [-J ]
[--help] [-e|--expand-tabs] [-V|--version] [files]

---

👑 DESCRIPTION 👑

paginate or columnate FILE(s) for printing

that's the whole vibe bestie, she paginates and columnates. periodt.

---

✨ OPTIONS ✨

• --pages <FIRST_PAGE[:LAST_PAGE]> — start printing at page FIRST_PAGE and stop at page FIRST_PAGE[:LAST_PAGE]. yes, you can gatekeep pages now. 🎀
• -h, --header <STRING> — swap the file name in the header line for the string header. main character energy for your header. 💅
• -D, --date-format <FORMAT> — use a date-style FORMAT for the date up in the header. fancy.
• -d, --double-space — output comes out double spaced. an extra <newline> character gets output after every <newline> found in the input. roomy. 🌸
• -n, --number-lines <[char][width]> — gives you line numbering with width digits. the default for width, if you don't specify it, is 5. the number takes up the first width column positions of each text column or each line of -m output. if char is given (any non-digit character), it gets appended to the line number to separate it from whatever comes next. the default for char is a <tab>. and heads up: line numbers longer than width columns are truncated. ✂️
• -N, --first-line-number <NUMBER> — start counting with NUMBER at the 1st line of the first page printed. cute lil head start. ⭐
• -t, --omit-header — write neither the five-line identifying header nor the five-line trailer that's usually supplied for each page. quit writing after the last line of each file, with no spacing to the end of the page. bare minimum, no decor. 💀
• -T, --omit-pagination — omit page headers and trailers, and eliminate any pagination by form feeds set in input files. she's not doing pages today.
• -l, --length <PAGE_LENGTH> — override the 66-line default (the default number of lines of text is 56, and with -F it's 63) and reset the page length to lines. if lines is not greater than the sum of both the header and trailer depths (in lines), then pr shall suppress both the header and the trailer, as if the -t option were in effect. so like, don't make it too tiny or she just gives up on headers entirely. 🙈
• -r, --no-file-warnings — omit the warning when a file cannot be opened. we're not talking about it. 🙈
• -F, --form-feed — use a <form-feed> for new pages, instead of the default behavior that uses a sequence of <newline>s.
• -w, --width <width> — set the width of the line to width column positions, and this one is for multiple text-column output only. if the -w option is not specified and the -s option is not specified, the default width shall be 72. if the -w option is not specified and the -s option is specified, the default width shall be 512. the way those numbers differ… iykyk. 👑
• -W, --page-width <width> — set page width to PAGE_WIDTH (72) characters always, truncate lines, except when the -J option is set, and with no interference with -S or -s.
• -a, --across — modifies the effect of the - column option so the columns get filled across the page in a round-robin order. for example, when column is 2, the first input line heads column 1, the second heads column 2, the third is the second line in column 1, and so on. slay, rotating. 🔄
• --column <column> — produce multi-column output arranged in column columns (the default shall be 1) and written down each column in the order in which the text is received from the input file. this option should not be used with -m. the options -e and -i shall be assumed for multiple text-column output. whether or not text columns are produced with identical vertical lengths is unspecified, but a text column shall never exceed the length of the page (see the -l option). when used with -t, use the minimum number of lines to write the output. 🌈
• -s, --separator [<char>] — separate text columns by the single character char instead of by the appropriate number of <space>s (default for char is the <tab> character). 🎀
• -S, --sep-string [<string>] — separate columns by STRING. without -S: the default separator is <TAB> with -J and <space> otherwise (same as -S" "). no effect on column options.
• -m, --merge — merge files. standard output shall be formatted so the pr utility writes one line from each file specified by a file operand, side by side into text columns of equal fixed widths, in terms of the number of column positions. implementations shall support merging of at least nine file operands. nine besties holding hands fr fr. 🫶
• -o, --indent <margin> — each line of output shall be preceded by offset <space>s. if the -o option is not specified, the default offset shall be zero. the space taken is in addition to the output line width (see the -w option below).
• -J — merge full lines, turns off -W line truncation, no column alignment, --sep-string[=STRING] sets separators.
• --help — print help information. 🆘
• -e, --expand-tabs <[CHAR][WIDTH]> — expand input CHARs (TABs) to tab WIDTH (8). 🌱
• -V, --version — print version.
• [files] — the files, bestie.

---

💖 EXTRA 💖

if no FILE(s) are given, or if FILE is -, read standard input. so - is giving "just read stdin, don't make it weird." 🦋

when creating multicolumn output, columns will be of equal width. when using the '-s' option to separate columns, the default separator is a single tab character. when using the '-S' option to separate columns, the default separator is a single space character.

---

⭐ VERSION ⭐

v(uutils coreutils) 0.7.0

---

and that's the whole page, bestie. this is pr from uutils coreutils, version 0.7.0, documented as pr(1) in the General Commands Manual. go paginate something pretty. mwah. 💅✨💖