Return to mkstr.1 CVS log

Up to [CSRG BSD Unix] / 43BSDTahoe / man / man1

Annotation of 43BSDTahoe/man/man1/mkstr.1, revision 1.1

1.1     ! root        1: .\" Copyright (c) 1980 Regents of the University of California.
        !             2: .\" All rights reserved.  The Berkeley software License Agreement
        !             3: .\" specifies the terms and conditions for redistribution.
        !             4: .\"
        !             5: .\"    @(#)mkstr.1     6.2 (Berkeley) 5/7/86
        !             6: .\"
        !             7: .TH MKSTR 1 "May 7, 1986"
        !             8: .UC
        !             9: .SH NAME
        !            10: mkstr \- create an error message file by massaging C source
        !            11: .SH SYNOPSIS
        !            12: .B mkstr
        !            13: [
        !            14: .B \-
        !            15: ]
        !            16: messagefile prefix file ...
        !            17: .SH DESCRIPTION
        !            18: .I Mkstr
        !            19: is used to create files of error messages.
        !            20: Its use can make programs with large numbers of error diagnostics much
        !            21: smaller, and reduce system overhead in running the program as the
        !            22: error messages do not have to be constantly swapped in and out.
        !            23: .PP
        !            24: .I Mkstr
        !            25: will process each of the specified
        !            26: .I files,
        !            27: placing a massaged version of the input file in a file whose name
        !            28: consists of the specified
        !            29: .I prefix 
        !            30: and the original name.
        !            31: A typical usage of
        !            32: .I mkstr
        !            33: would be
        !            34: .DT
        !            35: .PP
        !            36:        mkstr pistrings xx *.c
        !            37: .PP
        !            38: This command would cause all the error messages from the C source
        !            39: files in the current directory to be placed in the file
        !            40: .I pistrings
        !            41: and processed copies of the source for these files to be placed in
        !            42: files whose names are prefixed with
        !            43: .I xx.
        !            44: .PP
        !            45: To process the error messages in the source to the message file
        !            46: .I mkstr
        !            47: keys on the string
        !            48: \%`error("'
        !            49: in the input stream.
        !            50: Each time it occurs, the C string starting at the `"' is placed
        !            51: in the message file followed by a null character and a new-line character;
        !            52: the null character terminates the message so it can be easily used
        !            53: when retrieved, the new-line character makes it possible to sensibly
        !            54: .I cat
        !            55: the error message file to see its contents.
        !            56: The massaged copy of the input file then contains a
        !            57: .I lseek
        !            58: pointer into the file which can be used to retrieve the message, i.e.:
        !            59: .IP
        !            60: .DT
        !            61: .nf
        !            62: \fBchar\fR     efilname[] =  "/usr/lib/pi_strings";
        !            63: \fBint\fR      efil = -1;
        !            64: .sp
        !            65: error(a1, a2, a3, a4)
        !            66: {
        !            67:        \fBchar\fR buf[256];
        !            68: 
        !            69:        \fBif\fR (efil < 0) {
        !            70:                efil = open(efilname, 0);
        !            71:                \fBif\fR (efil < 0) {
        !            72: oops:
        !            73:                        perror(efilname);
        !            74:                        exit(1);
        !            75:                }
        !            76:        }
        !            77:        \fBif\fR (lseek(efil, (long) a1, 0) |\|| read(efil, buf, 256) <= 0)
        !            78:                \fBgoto\fR oops;
        !            79:        printf(buf, a2, a3, a4);
        !            80: }
        !            81: .fi
        !            82: .PP
        !            83: The optional
        !            84: .B \-
        !            85: causes the error messages to be placed at the end of the specified
        !            86: message file for recompiling part of a large
        !            87: .IR mkstr \|ed
        !            88: program.
        !            89: .SH SEE\ ALSO
        !            90: lseek(2), xstr(1)

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.