home | help
UNRTF(1)		     General Commands Manual			UNRTF(1)

NAME
     UnRTF - converts document in RTF format to other formats

SYNOPSIS
     unrtf [options] [file...]

     Options:  [--nopict]  [--noremap] [-P config_search_path] [--html] [--text]
     [--vt]  [--rtf]  [--latex]  [--help]  [--verbose]	 [--quiet]   [--version]
     [-t tags_file]

DESCRIPTION
     The  program  unrtf is a converter from Rich Text Format (RTF) to a growing
     number of document formats.  At present it supports Hypertext  Markup  Lan-
     guage (HTML), plain text, text with VT100 codes, LaTeX, and RTF itself.  It
     is  possible to produce troff files with macro calls; an example configura-
     tion for troff and the mm macro package is provided.   All  output  formats
     except  HTML are "alpha" i.e. limited and development has just begun.  How-
     ever with HTML, the program supports tables, fonts, hyperlinks,  and  para-
     graph  alignment.	 Font support includes face and size changes, as well as
     typical attributes such as italic, bold, underlining, strikethrough, small-
     caps, allcaps, expand, compress and both foreground and background  colors.
     Images  are  always  stored  to separate files in the current directory, or
     they can be ignored.

     Starting with version 0.21.0, all control of unrtf output is  through  run-
     time  configuration  files.   This makes it easy for users to fine-tune the
     output, and/or define new output formats.	The configuration files  can  be
     read  from  the  distributed  ones, or from user files, searched for in the
     config_search_path .  Note that the order of the -P and output arguments is
     important.  The search path must be set before any argument that will  load
     a configuration file if that file is not in the standard place.

     Code page conversion is performed with the iconv(3) package.

OPTIONS
     --nopict
	    disables  the  automatic storing of embedded pictures to the current
	    directory.

     --noremap
	    disables  charset  conversion  (currently  only  works   for   8-bit
	    charsets).

     --html
	    selects HTML output (default).

     --rtf  selects RTF output.  The resulting output will often be much smaller
	    than the input.

     --text
	    selects plain ASCII text output.

     --vt   selects text output with VT100 escape codes.

     --latex
	    selects output of a LaTeX document.

     --verbose
	    prints additional information.

     --quiet
	    suppress output of leading comments

     --version
	    prints the program version.

     -t tags_file
	    specifies  the  tags output configuration file to be used.	The com-
	    mand "unrtf -t html" is functionally identical  to	"unrtf	--html".
	    The  configuration	files are a simple format.  To change the behav-
	    iour of unrtf, a local copy of a system configuration file can be be
	    made and edited.  The most complete configuration file and hence the
	    best starting point is /usr/local/share/unrtf/html.conf.

     -P config_search_path
	    specifies the directories in which the configuration  file	for  the
	    specified format will be sought.  The path can be provided as a sin-
	    gle directory or a list of colon separated directories.  The default
	    is	/usr/local/share/unrtf	where  distributed  output configuration
	    files are installed.

FILES
     /usr/local/share/unrtf/*.conf
	    - run time output configuration files.

     /usr/local/share/unrtf/SYMBOL.charmap
	    - UTF encoding of the SYMBOL font used in many RTF files.	Unfortu-
	    nately  the iconv package does not include font encodings.	The for-
	    mat is identical to iconv code page files.

WEBSITE
     http://www.gnu.org/software/unrtf/unrtf.html

NOTES
     Report bugs in the program to http://savannah.gnu.org/projects/unrtf/

				GNU UnRTF 0.21.9			UNRTF(1)

home | help