Code

Imported Debian patch 1.2.26-1
[pkg-rrdtool.git] / debian / trytime.1
1 .\"                                      Hey, EMACS: -*- nroff -*-
2 .\" First parameter, NAME, should be all caps
3 .\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
4 .\" other parameters are allowed: see man(7), man(1)
5 .TH TRYTIME 1 "September 2000" "rrdtool"
6 .\" Please adjust this date whenever revising the manpage.
7 .\"
8 .\" Some roff macros, for reference:
9 .\" .nh        disable hyphenation
10 .\" .hy        enable hyphenation
11 .\" .ad l      left justify
12 .\" .ad b      justify to both left and right margins
13 .\" .nf        disable filling
14 .\" .fi        enable filling
15 .\" .br        insert line break
16 .\" .sp <n>    insert n+1 empty lines
17 .\" for manpage-specific macros, see man(7)
18 .SH NAME
19 trytime \- a program to experiment with at-style time specifications as
20 implemented by rrdtool
21 .SH SYNOPSIS
22 .B trytime
23 [--start=\fItimespec\fP]
24 [--end=\fItimespec\fP]
25 .br
26 .SH DESCRIPTION
27 This manual page documents briefly the
28 .B trytime
29 command.  This manual page was written for the Debian GNU/Linux
30 distribution because the original program does not have a manual page.
31 It was derived from the file \fBcontrib/trytime/README\fP from the
32 rrdtool distribution, which can be found in
33 \fB/usr/share/rrdtool/trytime/README\fP on Debian systems.
34 .PP
35 .\" TeX users may be more comfortable with the \fB<whatever>\fP and
36 .\" \fI<whatever>\fP escape sequences to invode bold face and italics, 
37 .\" respectively.
38 \fBtrytime\fP is a small program that allows you to play with at-style
39 time specifications without actually bothering any of the rrd
40 databases.  It takes either single at-style specification or two of
41 those (for start and end time, just like rrdtool fetch or graph do)
42 and reports what it thinks of it. The diagnostic is as close as
43 possible to that of rrdtool compiled for at-style time specification
44 support.
46 To learn what's possible with at-style time specifications, see
47 the \fBAT-STYLE TIME SPECIFICATION\fP section in the
48 .BR rrdfetch (1)
49 documentation.
51 .SH AUTHOR
52 This manual page was written by Matt Zimmerman <mdz@debian.org>, for
53 the Debian GNU/Linux system (but may be used by others).