ANTIWORD(1)

✨ ANTIWORD(1) ✨ 💖 Linux User's Manual 💖

🎀 NAME

Okay bestie, so antiword is the tool that lets you peek at the text and images inside MS Word docs. 💅 antiword ✨

🌸 SYNOPSIS

antiword [ options ] wordfiles

---

🦋 DESCRIPTION

Okay so antiword is literally an app that shows you the text AND the images from Microsoft Word documents. 🔥 It's giving main character energy. 💖

If you pass a wordfile named -, antiword reads the Word document from standard input instead. 🧚 Lowkey so useful for piping stuff in!

Ngl, only the binary format docs are supported. That means MS Word versions 2, 6, 7, 97, 2000 and 2003. 💜 Newer Word versions default to a totally different format: XML files stuffed in a ZIP container (usually with a .docx extension), and antiword does NOT support those. 💀 It also doesn't support the "flat" XML format that MS Word 2003 had. Not me being like "wait, what?" 😭

---

👑 OPTIONS

• -a papersize — Okay this one outputs in Adobe PDF form! 📄 It's printable on paper in these sizes: 10x14, a3, a4, a5, b4, b5, executive, folio, legal, letter, note, quarto, statement or tabloid. 🦋
• -f — Formatted text vibes! ✨ Bold text shows up as *bold*, italics as /italics/, and underlined text as _underlined_. Iconic. 💅
• -h — Need a little help? Gives you a help message. 🫶
• -i image level — This decides how images get shown. 🌈
  • 0 — Uses non-standard extensions from Ghostscript. 💀 This output might NOT print on any PostScript printer, but it's useful if you don't need a hard copy. It's also handy when Ghostscript is acting as a filter to print a PostScript file to a non-PostScript printer.
  • 1 — Shows no images. 🙈
  • 2 — PostScript level 2 compatible. (default) 👑
  • 3 — PostScript level 3 compatible. ⚠️ EXPERIMENTAL, and Portable Network Graphics (PNG) images are not printed correctly. 😭
• -m mapping file — This file maps Unicode characters to your local character set. 🗺️ The default mapping file depends on your locale. 🌍
• -p papersize — Same vibe as -a, but this one outputs in PostScript form. 📜 Printable on paper in these sizes: 10x14, a3, a4, a5, b4, b5, executive, folio, legal, letter, note, quarto, statement or tabloid. 💖
• -r — Includes text that got removed by the revisioning system. 🍓 The tea is served! ☕
• -s — Includes text with the so-called "hidden text" attribute. 🙈 Shhh 🤫
• -t — Output in text form. (default) 🎀
• -w width — In text mode, this sets the line width in characters. 📏 A value of 0 puts an entire paragraph on one line, which is super useful if the text is going into another word processor. ✨ This value is ignored in PostScript mode. 💅
• -x document type definition — Outputs in XML form. 🧚 Right now the only document type definition is db (for DocBook). 📚
• -L — In PostScript mode, uses landscape mode. 🌅

---

🗂️ FILES

• Mapping files like 8859-1.txt — Antiword looks for these in three directories, in this order:
  1. The directory specified by $ANTIWORDHOME 🏠
  2. The directory specified by $HOME/.antiword 🏡
  3. Directory /usr/share/antiword 🌸
• The fontnames file — Antiword checks the same directories as the mapping files for its fontname file. 🔤 It's the translation table from font names MS Word uses to font names PostScript uses. 🦋

NOTE: Antiword cannot tell the difference between a file that does not exist and a file that cannot be opened for reading. 🙃 Plot twist, no cap!

---

🌈 ENVIRONMENT

Antiword uses the environment variable ANTIWORDHOME as the first directory to look in for its files. 🏠 It uses HOME to find the user's home directory. 🏡 When in text mode, it uses the COLUMNS variable to set the output width (unless you override it with the -w option). 📏

Antiword also checks LC_ALL, LC_CTYPE and LANG (in that order) to get the current locale, and uses that to pick the default mapping file. 🌍 Iykyk! 💜

---

🐛 BUGS

Okay bestie, antiword is far from complete. 🥺 Lots of features are still missing, and many images aren't shown yet. 😭 Some of the images that DO show up get placed in the wrong spot. 🙈 PostScript output is only available in ISO 8859-1 and ISO 8859-2. 💀

---

🌐 WEB SITES

The most recent released version of Antiword is always over at: http://www.winfield.demon.nl/index.html 🦋

---

👩‍💻 AUTHOR

Adri van Os <antiword@winfield.demon.nl> 👑

R.F. Smith <rsmith@xs4all.nl> and Sindi Keesan <keesan@cyberspace.org> helped out with this manual page. 🫶

---

📜 LICENSE

Antiword is free software! 🎉 You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 2 of the License, or (at your option) any later version. 💖

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY. Not even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. 😭 See the GNU General Public License for more details. 📖

You should have received a copy of the GNU General Public License along with this program. If not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA. 🌸

---

🫧 ACKNOWLEDGEMENTS

Linux is a registered trademark of Linus Torvalds. 🐧 Adobe, PDF and PostScript are trademarks of Adobe Systems Incorporated. 🦋 Microsoft is a registered trademark and Windows is a trademark of Microsoft Corporation. 💜

---

Antiword 0.37 dropped on Oct 29, 2005 🎀 and that's the tea, bestie! Slay forever. 💅✨