mkstr.1 (4b952f84cbfa0244a20ee7ec271872e86304bb80) mkstr.1 (e8937ba00998cca6f259b3fdf32a7f7a38bc26ec)
1.\" Copyright (c) 1980, 1990, 1993
2.\" The Regents of the University of California. All rights reserved.
3.\"
4.\" Redistribution and use in source and binary forms, with or without
5.\" modification, are permitted provided that the following conditions
6.\" are met:
7.\" 1. Redistributions of source code must retain the above copyright
8.\" notice, this list of conditions and the following disclaimer.

--- 30 unchanged lines hidden (view full) ---

39.Nm mkstr
40.Nd create an error message file by massaging C source
41.Sh SYNOPSIS
42.Nm
43.Op Fl
44.Ar messagefile
45.Ar prefix Ar
46.Sh DESCRIPTION
1.\" Copyright (c) 1980, 1990, 1993
2.\" The Regents of the University of California. All rights reserved.
3.\"
4.\" Redistribution and use in source and binary forms, with or without
5.\" modification, are permitted provided that the following conditions
6.\" are met:
7.\" 1. Redistributions of source code must retain the above copyright
8.\" notice, this list of conditions and the following disclaimer.

--- 30 unchanged lines hidden (view full) ---

39.Nm mkstr
40.Nd create an error message file by massaging C source
41.Sh SYNOPSIS
42.Nm
43.Op Fl
44.Ar messagefile
45.Ar prefix Ar
46.Sh DESCRIPTION
47.Nm Mkstr
48creates files containing error messages extracted from C source,
47The
48.Nm
49utility creates files containing error messages extracted from C source,
49and restructures the same C source, to utilize the created error message
50file.
51The intent of
52.Nm
53was to reduce the size of large programs and
54reduce swapping (see
55.Sx BUGS
56section below).
57.Pp
50and restructures the same C source, to utilize the created error message
51file.
52The intent of
53.Nm
54was to reduce the size of large programs and
55reduce swapping (see
56.Sx BUGS
57section below).
58.Pp
58.Nm Mkstr
59processes each of the specified
59The
60.Nm
61utility processes each of the specified
60.Ar files ,
61placing a restructured version of the input in a file whose name
62consists of the specified
63.Ar prefix
64and the original name.
65A typical usage of
66.Nm
67is

--- 8 unchanged lines hidden (view full) ---

76files whose names are prefixed with
77.Ar \&xx .
78.Pp
79Options:
80.Bl -tag -width indent
81.It Fl
82Error messages are placed at the end of the specified
83message file for recompiling part of a large
62.Ar files ,
63placing a restructured version of the input in a file whose name
64consists of the specified
65.Ar prefix
66and the original name.
67A typical usage of
68.Nm
69is

--- 8 unchanged lines hidden (view full) ---

78files whose names are prefixed with
79.Ar \&xx .
80.Pp
81Options:
82.Bl -tag -width indent
83.It Fl
84Error messages are placed at the end of the specified
85message file for recompiling part of a large
84.Nm
85ed
86.Nm Ns ed
86program.
87.El
88.Pp
87program.
88.El
89.Pp
89.Nm Mkstr
90finds error messages in the source by
90The
91.Nm
92utility finds error messages in the source by
91searching for the string
92.Li \&`error("'
93in the input stream.
94Each time it occurs, the C string starting at the
95.Sq \&"\&
96is stored
97in the message file followed by a null character and a new-line character;
98The new source is restructured with

--- 17 unchanged lines hidden (view full) ---

116 err(1, "%s", efilname);
117 printf(buf, a2, a3, a4);
118}
119.Ed
120.Sh SEE ALSO
121.Xr xstr 1 ,
122.Xr lseek 2
123.Sh HISTORY
93searching for the string
94.Li \&`error("'
95in the input stream.
96Each time it occurs, the C string starting at the
97.Sq \&"\&
98is stored
99in the message file followed by a null character and a new-line character;
100The new source is restructured with

--- 17 unchanged lines hidden (view full) ---

118 err(1, "%s", efilname);
119 printf(buf, a2, a3, a4);
120}
121.Ed
122.Sh SEE ALSO
123.Xr xstr 1 ,
124.Xr lseek 2
125.Sh HISTORY
124.Nm Mkstr
125appeared in
126A
127.Nm
128utility appeared in
126.Bx 3.0 .
127.Sh BUGS
129.Bx 3.0 .
130.Sh BUGS
128.Nm Mkstr
129was intended for the limited architecture of the PDP 11 family.
131The
132.Nm
133utility was intended for the limited architecture of the PDP 11 family.
130Very few programs actually use it.
131The Pascal interpreter,
132.Xr \&pi 1
133and the editor,
134.Xr \&ex 1
135are two programs that are built this way.
136It is not an efficient method, the error messages
137should be stored in the program text.
134Very few programs actually use it.
135The Pascal interpreter,
136.Xr \&pi 1
137and the editor,
138.Xr \&ex 1
139are two programs that are built this way.
140It is not an efficient method, the error messages
141should be stored in the program text.