summaryrefslogtreecommitdiff
path: root/support/word2x/word2x.1
blob: 06bf9ff9d992a4f2814cefc947c23b2a9c1c5a1f (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
.\" $Id: word2x.1,v 1.4 1997/04/10 21:30:05 dps Exp $
.TH word2x 1 "1st April 1997" "Duncan Simpson" "LOCAL COMMANDS"
.SH NAME
word2x \- convert word 6 documents to another format

.SH SYNOPSIS
.B word2x
[-Vhvq] [-w width] [-f format] [-d date-style] files...

.SH DESCRIPTION
.I word2x
is a program that attempts to produce a component, if not perfect
rendition of a word 6 document. It guesses rather a lot from context
and can make mistakes. Pictures are not supported and will not
appear. There is very limited maths support in LaTeX mode, mainly due
to lack of samples of mathematics. (I probably should have done this
using TeX catcode and macro magic, instead of writing special code).

Input files must be seekable and therefore stdin is not allowed. The
files argument is of the form
.IR "input file" ", " "output file" ", " "input file" ", " "output file"
etc. \- may be used for stdout in the output file. If the output file
is not sepcified a named is generated by adding on an appropiate
suffix in place of .DOC (or .doc). Both .DOC and .doc are added
automatically if the file name specified can not be found.

As a special exception to the above any file ending on .doc or .DOC is
assumed to be an input file. This allows one to type
.BR "word2x -f latex *.DOC" ,
for example.

.SH OPTIONS
.TP
.B -V, --version
print version on stderr and exit.
.TP
.B -h, --help
show synopsis, output and date formats supported.
.TP
.B -v, --verbose
be (moderately) verbose
.TP
.B -q, --quiet
supress non-error messages (this is the default).
.TP
.B -w, --width
set the maximum width of a line in the output
.TP
.B -d, --dates
set the date format. Currently the formats supported are
.IR uk ", " british ", " us .
.I uk
dates are
.IR "22nd April, 1997" ,
for example and US style dates
.IR "April 22nd, 1997" .
.I british
is a synonym for
.IR uk .
The default is
.IR uk .
.TP
.B -f, --format
Set the output format. Currently
.I text
and
.I latex
are supported. The LaTeX output requires the AMS LaTeX package and
LaTeX 2e.  It should be reasonably easy to add another format, however
some formats do a large amount of context guesswork, for example the
LaTeX format (esp.  in the paragraph handling code).
.I text
is the default.

.SH BUGS

One argument does not produce output on stdout

The reader sometimes generates error messages when it is confused.

The equation support is limited to only fractions at present.

The program appears to understand a lot more than it really does.

Pictures are silently disguared.

Fast save files are not supported.

The conversion is not perfect and needs manual cleaning up.

Non-word files silently produce empty output in most cases.

Equations are not supported in text output.

If the cues the program recognised LaTeX mode does little more than
produce LaTeX format tables and plain text output.

.SH AUTHOR

word2x is (C) Duncan Simpson 1997 and may be distributed under the GPL
version 2, or any later version at your option. I would appreciate
patches and information emailed to dps@io.stargate.co.uk