=================================================================== RCS file: /cvsrepo/anoncvs/cvs/src/usr.bin/xstr/Attic/xstr.1,v retrieving revision 1.11 retrieving revision 1.12 diff -u -r1.11 -r1.12 --- src/usr.bin/xstr/Attic/xstr.1 2003/06/03 02:56:24 1.11 +++ src/usr.bin/xstr/Attic/xstr.1 2004/07/26 09:04:18 1.12 @@ -1,4 +1,4 @@ -.\" $OpenBSD: xstr.1,v 1.11 2003/06/03 02:56:24 millert Exp $ +.\" $OpenBSD: xstr.1,v 1.12 2004/07/26 09:04:18 jmc Exp $ .\" $NetBSD: xstr.1,v 1.4 1994/11/26 09:25:22 jtc Exp $ .\" .\" Copyright (c) 1980, 1993 @@ -38,10 +38,10 @@ .Nd "extract strings from C programs to implement shared strings" .Sh SYNOPSIS .Nm xstr -.Op Fl c +.Op Fl cv .Op Fl l Ar array .Op Fl -.Op Ar file +.Op Ar file ... .Sh DESCRIPTION .Nm maintains a file @@ -52,7 +52,7 @@ are also read-only. .Pp The options are as follows: -.Bl -tag -width Ds +.Bl -tag -width "-l arrayXX" .It Fl Cause .Nm @@ -81,17 +81,18 @@ Specify the named array in program references to abstracted strings. The default array name is .Dq xstr . +.It Fl v +Be verbose. .El .Pp -After all components of a large program have been compiled a file +After all components of a large program have been compiled, a file .Pa xs.c declaring the common .Nm -space can be created by a command of the form -.Bd -literal -offset indent -$ xstr -.Ed +space can be created by a command of the form: .Pp +.Dl $ xstr +.Pp The file .Pa xs.c should then be compiled and loaded with the rest @@ -101,19 +102,16 @@ .Pp .Nm can also be used on a single file. -A command -.Bd -literal -offset indent -$ xstr name -.Ed -.Pp -creates files +The following command creates files .Pa x.c and .Pa xs.c as before, without using or affecting any .Pa strings -file in the same directory. +file in the same directory: .Pp +.Dl $ xstr name +.Pp It may be useful to run .Nm after the C preprocessor if any macro definitions yield strings @@ -122,10 +120,9 @@ An appropriate command sequence for running .Nm after the C preprocessor is: -.Pp -.Bd -literal -offset indent -compact -$ cc \-E name.c | xstr \-c \- -$ cc \-c x.c +.Bd -literal -offset indent +$ cc -E name.c | xstr -c - +$ cc -c x.c $ mv x.o name.o .Ed .Pp