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.
--- 16 unchanged lines hidden (view full) ---
25.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
26.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
27.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
28.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
29.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
30.\" SUCH DAMAGE.
31.\"
32.\" @(#)mkstr.1 8.1 (Berkeley) 6/6/93
33.\" $FreeBSD: head/usr.bin/mkstr/mkstr.1 94503 2002-04-12 13:08:00Z charnier $
34.\"
35.Dd June 6, 1993
36.Dt MKSTR 1
37.Os
38.Sh NAME
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,
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
58.Nm Mkstr
59processes 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
84.Nm
85ed
86program.
87.El
88.Pp
89.Nm Mkstr
90finds 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
124.Nm Mkstr
125appeared in
126.Bx 3.0 .
127.Sh BUGS
128.Nm Mkstr
129was 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.
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.
--- 16 unchanged lines hidden (view full) ---
25.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
26.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
27.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
28.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
29.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
30.\" SUCH DAMAGE.
31.\"
32.\" @(#)mkstr.1 8.1 (Berkeley) 6/6/93
33.\" $FreeBSD: head/usr.bin/mkstr/mkstr.1 94503 2002-04-12 13:08:00Z charnier $
34.\"
35.Dd June 6, 1993
36.Dt MKSTR 1
37.Os
38.Sh NAME
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,
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
58.Nm Mkstr
59processes 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
84.Nm
85ed
86program.
87.El
88.Pp
89.Nm Mkstr
90finds 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
124.Nm Mkstr
125appeared in
126.Bx 3.0 .
127.Sh BUGS
128.Nm Mkstr
129was 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.