summaryrefslogtreecommitdiff
path: root/man/Xmark.man
diff options
context:
space:
mode:
authorGaetan Nadon <memsize@videotron.ca>2011-01-19 10:06:55 -0500
committerGaetan Nadon <memsize@videotron.ca>2011-01-19 10:06:55 -0500
commit490ceddc3e97e8c5bf1ed61265525c213abf65d1 (patch)
tree2ab2e918ff853c00ca6be4c0d3a9e317d7198fb9 /man/Xmark.man
parent36d4517099505fac29a3c0b8c6c3779b3f05b8ff (diff)
config: move man pages into their own directory
Use services provided by XORG_MANPAGE_SECTIONS. Use standard Makefile for man pages. Signed-off-by: Gaetan Nadon <memsize@videotron.ca>
Diffstat (limited to 'man/Xmark.man')
-rw-r--r--man/Xmark.man66
1 files changed, 66 insertions, 0 deletions
diff --git a/man/Xmark.man b/man/Xmark.man
new file mode 100644
index 0000000..4e91162
--- /dev/null
+++ b/man/Xmark.man
@@ -0,0 +1,66 @@
+.\" This manpage was written by Richard Braakman and is licensed under the
+.\" XFree86 license.
+.TH Xmark 1 __xorgversion__
+.SH NAME
+Xmark \- summarize x11perf results
+.SH SYNTAX
+.B Xmark
+datafile
+.SH DESCRIPTION
+.B Xmark
+is a shell script that reads the indicated datafile and compiles a
+benchmark which it writes to standard output. It writes three
+numbers:
+.PP
+.RS
+A weighted performance number for the
+.I x11perf
+results.
+.PP
+A weighted performance number for a standard SparcStation 1, with
+SunOS 4.1.2, X11R5 Xsun, and a CG3 dumb Color Frame Buffer.
+.\" I assume the latter is a graphics card.
+.PP
+The Xmark, which is the ratio of the two numbers above.
+.RE
+.PP
+The datafile must be an ordinary file, produced by x11perf in the
+following way:
+.PP
+.BI "x11perf -display " display " -v1.3 -rop GXcopy GXxor -all > " datafile
+.PP
+It is possible to run the GXcopy and GXxor tests separately, as long as they
+are concatenated to the same output file:
+.nf
+.BI "x11perf -display " display " -v1.3 -rop GXcopy -all > " datafile
+.BI "x11perf -display " display " -v1.3 -rop GXxor -all >> " datafile
+.fi
+or
+.nf
+.BI "x11perf -display " display " -v1.3 -rop GXxor -all > " datafile
+.BI "x11perf -display " display " -v1.3 -rop GXcopy -all >> " datafile
+.fi
+.SH FILES
+.TP
+.B temp.$$
+Temporary file created in the current directory, deleted after use.
+.SH DIAGNOSTICS
+.TP
+.B Usage: Xmark datafile
+.I Xmark
+was invoked without arguments or with more than one argument, or
+with options. Xmark takes no options.
+.TP
+.B "Error: data file does not exist or is not ordinary."
+.I Xmark
+cannot find the datafile named on its command line, or the datafile
+is a special file such as a directory.
+.TP
+.BR "WARNING: datafile contains " nnn ", not 441 or 447 'trep' results;"
+The file named on the command line does not seem to be a file generated
+by x11perf in the expected way.
+.TP
+.BR "Diagnostic: ERROR: sum of weights =" nnn ", not equal to 4566.0;"
+There is an internal error in Xmark.
+.SH "SEE ALSO"
+X(__miscmansuffix__), x11perf(__appmansuffix__), x11perfcomp(__appmansuffix__)