roff2x(1)

💅 roff2x — bestie edition

okay so real quick, before anything: this is roff2x(1), a page from the General Commands Manual. she's a little transformation girlie and she's about to eat. 🦋

---

✨ NAME ✨

roff2x — transform roff code into x mode

like. that's it. that's the job. slay.

---

✨ SYNOPSIS ✨

roff2x --help```

roff2x --version```

okay so let's break this down bestie, because there's actually a lot happening here and none of it is scary, i promise 🫶

- The options <cyan>`-v`</cyan> and <cyan>`--version`</cyan> print the version information of the program to standard output and exit. that's it. she just tells you who she is and dips. iconic behaviour honestly 💅
- The options <cyan>`-h`</cyan> and <cyan>`--help`</cyan> print a usage information of the program to standard output and stop the program instantly. instant. no goodbye. no nothing. just facts and ✌️

- All other options are assumed to be groffer options. They are internally passed to `groffer`. They override the behavior of the program. The options are optional, they can be omitted. (yes bestie, the optional options are optional, the manpage really said it twice, and honestly? valid. she's being thorough. let her cook 👑)

- The <lavender>*filespec*</lavender> arguments correspond to the <lavender>*filespec*</lavender> arguments of `groffer`. So they are either the names of existing, readable files or <cyan>`-`</cyan> for standard input, or the name of a man page or a `groffer(1)` man page search pattern. If no <lavender>*filespec*</lavender> is specified standard input is assumed automatically. so if you show up with nothing, she just reads your stdin. no notes. no complaints. she's flexible like that 😌

---

# ✨ DESCRIPTION ✨

`roff2x` transforms roff code into <hotpink>X mode</hotpink> corresponding to the groff devices `X*`; this mode is suitable for `gxditview(1)`. Print the result to standard output.

so like. roff goes in. X-mode-ified roff comes out. and it comes out on <cyan>standard output</cyan>, which means you can pipe it, redirect it, whatever your heart desires. the world is your oyster, bestie 🦋

There are more of these programs for generating other formats of roff input. and here's the whole friend group, no one left out:

- `roff2dvi(1)` — is for dvi mode.
- `roff2html(1)` — generates HTML output.
- `roff2pdf(1)` — outputs pdf mode.
- `roff2ps(1)` — prints PostScript format to standard output.
- `roff2text(1)` — generates text output in the groff device `latin1`.

five sisters. all iconic. all doing their own thing. the range? unmatched. 🌈

---

# ✨ AUTHORS ✨

`roff2x` was written by <purple>Bernd Warken</purple>. we love and respect a legend. 🎀

---

# ✨ SEE ALSO ✨

`groff(1)`, `groffer(1)`, `roff2dvi(1)`, `roff2html(1)`, `roff2pdf(1)`, `roff2ps(1)`, `roff2text(1)`, `gxditview(1)`.

go read them. all of them. it's giving ✨research✨ and you'll be smarter for it, no cap 💜

---

<rainbow>and that's the whole page, bestie!!</rainbow> this one shipped as part of <green>groff 1.22.4</green>, dated <yellow>23 March 2022</yellow> — so if you were wondering when this slay dropped, now you know. mwah 💖🦋✨