-
Notifications
You must be signed in to change notification settings - Fork 2
/
ludwig.1
157 lines (157 loc) · 4.31 KB
/
ludwig.1
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
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
.\" This source file by:
.\"
.\" Bevin R. Brett (1987); and
.\" Kelvin B. Nicolle (1989).
.\"
.\" Copyright 1987, 1989 University of Adelaide
.\"
.\" Permission is hereby granted, free of charge, to any person
.\" obtaining a copy of this software and associated documentation
.\" files (the "Software"), to deal in the Software without
.\" restriction, including without limitation the rights to use, copy,
.\" modify, merge, publish, distribute, sublicense, and/or sell copies
.\" of the Software, and to permit persons to whom the Software is
.\" furnished to do so, subject to the following conditions:
.\"
.\" The above copyright notice and this permission notice shall be
.\" included in all copies or substantial portions of the Software.
.\"
.\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
.\" EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
.\" MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
.\" NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS
.\" BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN
.\" ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
.\" CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
.\" SOFTWARE.
.TH Ludwig l "7 June 1989"
.SH NAME
ludwig \- an interactive, screen-oriented text editor.
.SH SYNTAX
.B ludwig
[
.B \-o
] [
.B \-O
] [
.B \-c
] [
.B \-r
] [
.B \-i
file
] [
.B \-I
] [
.B \-s
value
] [
.B \-m
file
] [
.B \-M
] [
.B \-t
] [
.B \-T
] [
.B \-b
value
] [
.B \-B
value
] [
.B \-u
] [
file
[
file
] ]
.SH DESCRIPTION
.I Ludwig
is an interactive, screen-oriented text editor.
It may be used to create and modify computer programs,
documents or any other text which consists only of
printable characters. During an editing session, the text
is displayed on the terminal screen and the user may type
in further text and enter commands to modify the text. The
changes made to the text will in most cases be immediately
visible on the screen. Ludwig may also be used on hardcopy
terminals and in shell scripts, but it is primarily an
interactive screen editor.
.SH OPTIONS
.TP
.B \-o
Use the old command language. This is the default action.
.TP
.B \-O
Use the new command language introduced with Ludwig V4.1. Further
information may be obtained from section 7 of the interactive help
facility of the new version of Ludwig.
.TP
.B \-c
Create an output file, checking that it doesn't exist already.
.TP
.B \-r
Open the file without an output file, i.e. in read\-only mode.
.TP
.B \-i file
Specify a file to be executed after the default frame LUDWIG has been
loaded but before editing may commence, the default file is ~/.ludwigrc.
.TP
.B \-I
Do not perform any initialization.
.TP
.B \-s value
The number of characters of text allowed in the default frame. The default
value, if this option is not used, is 500000.
.TP
.B \-m file
Use the first line in the named file as the name of the file to edit.
Ludwig will update this file with the path of the current output file,
by default this file is ~/.lud_memory.
.TP
.B \-M
Don't use, or set, the ludwig filename memory.
.TP
.B \-t
Entab all output files by default.
.TP
.B \-T
Disable entabbing of output files, this is the default action.
.TP
.B \-b value
Create backup copies of the output files, such that if more than
.I value
versions already exists the oldest version is deleted. The default value, if
.B \-B
is not used, is 1.
.TP
.B \-B value
Similar to the
.B \-b
option except that at most
.I value
versions of the file are kept. All extra versions are deleted.
.TP
.B \-u
Display a brief usage message as reminder of the various options available.
.SH NOTES
Ludwig uses a terminal description that identifies the ``function keys''
available on the keyboard called TERMDESC. Ludwig accesses the terminal
descriptions either through the translation of the environment variable
TERMDESC, or if this does not exist Ludwig looks in the directory
/usr/local/lib/termdesc. If the user wishes to have his/her own terminal
descriptions then they should define TERMDESC to be the path to a
directory containing binary terminal descriptions. Binary descriptions
are created by using the ``termdesc-parser'' program.
.SH SEE ALSO
``The Ludwig User Guide'', available from
.br
Computer Science Department,
.br
University of Adelaide,
.br
GPO Box 498 Adelaide 5001 SA,
.br
AUSTRALIA.