misc fixes for better display
authoroetiker <oetiker@a5681a0c-68f1-0310-ab6d-d61299d08faa>
Mon, 18 Apr 2005 22:13:20 +0000 (22:13 +0000)
committeroetiker <oetiker@a5681a0c-68f1-0310-ab6d-d61299d08faa>
Mon, 18 Apr 2005 22:13:20 +0000 (22:13 +0000)
git-svn-id: svn://svn.oetiker.ch/rrdtool/branches/1.2/program@413 a5681a0c-68f1-0310-ab6d-d61299d08faa

doc/rrdcgi.pod
doc/rrdcreate.pod
doc/rrddump.pod
doc/rrdfetch.pod
doc/rrdfirst.pod
doc/rrdgraph.src
doc/rrdgraph_data.src
doc/rrdgraph_examples.src
doc/rrdgraph_graph.src
doc/rrdgraph_rpn.src
doc/rrdtool.pod

index b0ececb..e999fea 100644 (file)
@@ -2,12 +2,9 @@
 
 rrdcgi - Create web pages containing RRD graphs based on templates
 
-=for html <div align="right"><a href="rrdcgi.pdf">PDF</a> version.</div>
-
 =head1 SYNOPSIS
 
-#!/path/to/B<rrdcgi> 
-S<[B<--filter>]>
+C<#!/path/to/>B<rrdcgi> S<[B<--filter>]>
 
 =head1 DESCRIPTION
 
index 84d405e..80f3970 100644 (file)
@@ -2,8 +2,6 @@
 
 rrdcreate - Set up a new Round Robin Database
 
-=for html <div align="right"><a href="rrdcreate.pdf">PDF</a> version.</div>
-
 =head1 SYNOPSIS
 
 B<rrdtool> B<create> I<filename> 
@@ -189,8 +187,6 @@ I<rows> defines how many generations of data values are kept in an B<RRA>.
 
 =head1 Aberrant Behavior Detection with Holt-Winters Forecasting
 
-by Jake Brutlag E<lt>jakeb@corp.webtv.netE<gt>
-
 In addition to the aggregate functions, there are a set of specialized
 functions that enable B<RRDtool> to provide data smoothing (via the
 Holt-Winters forecasting algorithm), confidence bands, and the flagging
@@ -424,9 +420,12 @@ days on the x axis and one bar for each day).
 
 =head1 EXAMPLE
 
-C<rrdtool create temperature.rrd --step 300 DS:temp:GAUGE:600:-273:5000
-RRA:AVERAGE:0.5:1:1200 RRA:MIN:0.5:12:2400 RRA:MAX:0.5:12:2400
-RRA:AVERAGE:0.5:12:2400>
+ rrdtool create temperature.rrd --step 300 \
+  DS:temp:GAUGE:600:-273:5000 \
+  RRA:AVERAGE:0.5:1:1200 \
+  RRA:MIN:0.5:12:2400 \
+  RRA:MAX:0.5:12:2400 \
+  RRA:AVERAGE:0.5:12:2400
 
 This sets up an B<RRD> called F<temperature.rrd> which accepts one
 temperature value every 300 seconds. If no new data is supplied for
@@ -442,10 +441,10 @@ average temperature, respectively.
 
 =head1 EXAMPLE 2
 
-C<rrdtool create monitor.rrd --step 300 
-DS:ifOutOctets:COUNTER:1800:0:4294967295
-RRA:AVERAGE:0.5:1:2016
-RRA:HWPREDICT:1440:0.1:0.0035:288>
+ rrdtool create monitor.rrd --step 300        \ 
+   DS:ifOutOctets:COUNTER:1800:0:4294967295   \ 
+   RRA:AVERAGE:0.5:1:2016                     \
+   RRA:HWPREDICT:1440:0.1:0.0035:288 
 
 This example is a monitor of a router interface. The first B<RRA> tracks the
 traffic flow in octets; the second B<RRA> generates the specialized
@@ -468,25 +467,25 @@ the FAILURES B<RRA>.
 The same RRD file and B<RRAs> are created with the following command, which explicitly
 creates all specialized function B<RRAs>.
 
-C<rrdtool create monitor.rrd --step 300 
-DS:ifOutOctets:COUNTER:1800:0:4294967295
-RRA:AVERAGE:0.5:1:2016
-RRA:HWPREDICT:1440:0.1:0.0035:288:3
-RRA:SEASONAL:288:0.1:2
-RRA:DEVPREDICT:1440:5
-RRA:DEVSEASONAL:288:0.1:2
-RRA:FAILURES:288:7:9:5>
+ rrdtool create monitor.rrd --step 300 \ 
+   DS:ifOutOctets:COUNTER:1800:0:4294967295 \ 
+   RRA:AVERAGE:0.5:1:2016 \ 
+   RRA:HWPREDICT:1440:0.1:0.0035:288:3 \ 
+   RRA:SEASONAL:288:0.1:2 \ 
+   RRA:DEVPREDICT:1440:5 \ 
+   RRA:DEVSEASONAL:288:0.1:2 \ 
+   RRA:FAILURES:288:7:9:5 
 
 Of course, explicit creation need not replicate implicit create, a number of arguments 
 could be changed.
 
 =head1 EXAMPLE 3
 
-C<rrdtool create proxy.rrd --step 300 
-DS:TotalRequests:DERIVE:1800:0:U
-DS:AccumDuration:DERIVE:1800:0:U
-DS:AvgReqDuration:COMPUTE:AccumDuration,TotalRequests,0,EQ,1,TotalRequests,IF,/
-RRA:AVERAGE:0.5:1:2016>
+ rrdtool create proxy.rrd --step 300 \ 
+   DS:Total:DERIVE:1800:0:U  \ 
+   DS:Duration:DERIVE:1800:0:U  \ 
+   DS:AvgReqDur:COMPUTE:Duration,Requests,0,EQ,1,Requests,IF,/ \ 
+   RRA:AVERAGE:0.5:1:2016 
 
 This example is monitoring the average request duration during each 300 sec 
 interval for requests processed by a web proxy during the interval.
index f1e653f..f93c144 100644 (file)
@@ -2,8 +2,6 @@
 
 rrddump - dump the contents of an RRD to XML format
 
-=for html <div align="right"><a href="rrddump.pdf">PDF</a> version.</div>
-
 =head1 SYNOPSIS
 
 B<rrdtool> B<dump> I<filename.rrd> E<gt> I<filename.xml> 
index 80053f3..16bee22 100644 (file)
@@ -2,8 +2,6 @@
 
 rrdfetch - Fetch data from an RRD.
 
-=for html <div align="right"><a href="rrdfetch.pdf">PDF</a> version.</div>
-
 =head1 SYNOPSIS
 
 B<rrdtool> B<fetch> I<filename> I<CF> 
@@ -99,13 +97,16 @@ So, if time now is called "t",
 
 In e.g. bash this could look as:
 
- TIME=$(date +%s); RRDRES=900; rrdtool fetch subdata.rrd AVERAGE -r $RRDRES \
- -e $(echo $(($TIME/$RRDRES*$RRDRES))) -s e-1h
+ TIME=$(date +%s)
+ RRDRES=900
+ rrdtool fetch subdata.rrd AVERAGE -r $RRDRES \
+    -e $(echo $(($TIME/$RRDRES*$RRDRES))) -s e-1h
 
 Or in Perl:
 
- perl -e '$ctime = time; $rrdres = 900; system "rrdtool fetch subdata.rrd AVERAGE \
- -r $rrdres -e @{[int($ctime/$rrdres)*$rrdres]} -s e-1h"'
+ perl -e '$ctime = time; $rrdres = 900; \
+          system "rrdtool fetch subdata.rrd AVERAGE \
+                  -r $rrdres -e @{[int($ctime/$rrdres)*$rrdres]} -s e-1h"'
 
 
 =head2 AT-STYLE TIME SPECIFICATION
@@ -253,4 +254,3 @@ I<19970703 12:45> -- 12:45  July 3th, 1997
 =head1 AUTHOR
 
 Tobias Oetiker <oetiker@ee.ethz.ch>
-
index 85aae58..63ef79e 100644 (file)
@@ -2,8 +2,6 @@
 
 rrdfirst - Return the date of the first data sample in an RRA within an RRD
 
-=for html <div align="right"><a href="rrdfirst.pdf">PDF</a> version.</div>
-
 =head1 SYNOPSIS
 
 B<rrdtool> B<first> I<filename> [I<--rraindex number>]
index c6a91be..1faec25 100644 (file)
@@ -8,8 +8,6 @@ WARNING: DO NOT EDIT THE POD FILES. THEY ARE AUTO-GENERATED
 
 rrdgraph - Round Robin Database tool grapher functions
 
-=include name
-
 =head1 SYNOPSIS
 
 B<rrdtool graph> I<filename>
@@ -332,6 +330,18 @@ You need at least one graph element to generate an image and/or
 at least one print statement to generate a report.
 See L<rrdgraph_graph> for exact format.
 
-=back
+=head1 SEE ALSO
+
+L<rrdgraph> gives an overview of how B<rrdtool graph> works.
+L<rrdgraph_data> describes B<DEF>,B<CDEF> and B<VDEF> in detail,
+L<rrdgraph_rpn> describes the B<RPN> language used in the B<?DEF> statements,
+L<rrdgraph_graph> page describes all of the graph and print functions.
+
+Make sure to read L<rrdgraph_examples> for tipsE<amp>tricks.
+
+=head1 AUTHOR
+
+Program by Tobias Oetiker E<lt>oetiker@ee.ethz.chE<gt>
+
+This manual page by Alex van den Bogaerdt E<lt>alex@ergens.op.het.netE<gt>
 
-=include see_also
index 5a8d51f..bef3690 100644 (file)
@@ -1,11 +1,5 @@
 =head1 NAME
 
-=cut
-
-WARNING: DO NOT EDIT THE POD FILES. THEY ARE AUTO-GENERATED
-
-=pod
-
 rrdgraph_data - preparing data for graphing in rrdtool graph
 
 =head1 SYNOPSIS
@@ -85,4 +79,17 @@ the script, just as if it were generated by a B<DEF> instruction.
 
 Example: C<CDEF:mydatabits=mydata,8,*>
 
-=include see_also
+=head1 SEE ALSO
+
+L<rrdgraph> gives an overview of how B<rrdtool graph> works.
+L<rrdgraph_data> describes B<DEF>,B<CDEF> and B<VDEF> in detail,
+L<rrdgraph_rpn> describes the B<RPN> language used in the B<?DEF> statements,
+L<rrdgraph_graph> page describes all of the graph and print functions.
+
+Make sure to read L<rrdgraph_examples> for tipsE<amp>tricks.
+
+=head1 AUTHOR
+
+Program by Tobias Oetiker E<lt>oetiker@ee.ethz.chE<gt>
+
+This manual page by Alex van den Bogaerdt E<lt>alex@ergens.op.het.netE<gt>
index 8ccf8eb..9360e06 100644 (file)
@@ -1,11 +1,5 @@
 =head1 NAME
 
-=cut
-
-WARNING: DO NOT EDIT THE POD FILES. THEY ARE AUTO-GENERATED
-
-=pod
-
 rrdgraph_examples - Examples for rrdtool graph
 
 =head1 SYNOPSIS
@@ -129,5 +123,17 @@ shift the data forward by one week (604800 seconds)
     AREA:lastweek#0000FF:Last\ week
     LINE1:thisweek#FF0000:This\ week
 
-=include see_also
+=head1 SEE ALSO
+
+L<rrdgraph> gives an overview of how B<rrdtool graph> works.
+L<rrdgraph_data> describes B<DEF>,B<CDEF> and B<VDEF> in detail,
+L<rrdgraph_rpn> describes the B<RPN> language used in the B<?DEF> statements,
+L<rrdgraph_graph> page describes all of the graph and print functions.
+
+Make sure to read L<rrdgraph_examples> for tipsE<amp>tricks.
+
+=head1 AUTHOR
+
+Program by Tobias Oetiker E<lt>oetiker@ee.ethz.chE<gt>
 
+This manual page by Alex van den Bogaerdt E<lt>alex@ergens.op.het.netE<gt>
index 3826f08..bf92d45 100644 (file)
@@ -1,11 +1,5 @@
 =head1 NAME  
 
-=cut
-
-WARNING: DO NOT EDIT THE POD FILES. THEY ARE AUTO-GENERATED
-
-=pod
-
 rrdgraph_graph - rrdtool graph command reference
 
 =head1 SYNOPSIS
@@ -284,4 +278,17 @@ If you are using the proportional font in your graph, you can use tab characters
 or the sequence B<\t> to lin-up legend elements. Note that the tabs inserted are
 relative to the start of the current legend element!
 
-=include see_also
+=head1 SEE ALSO
+
+L<rrdgraph> gives an overview of how B<rrdtool graph> works.
+L<rrdgraph_data> describes B<DEF>,B<CDEF> and B<VDEF> in detail,
+L<rrdgraph_rpn> describes the B<RPN> language used in the B<?DEF> statements,
+L<rrdgraph_graph> page describes all of the graph and print functions.
+
+Make sure to read L<rrdgraph_examples> for tipsE<amp>tricks.
+
+=head1 AUTHOR
+
+Program by Tobias Oetiker E<lt>oetiker@ee.ethz.chE<gt>
+
+This manual page by Alex van den Bogaerdt E<lt>alex@ergens.op.het.netE<gt>
index 9e6f70e..b79e4e2 100644 (file)
@@ -1,11 +1,5 @@
 =head1 NAME  
 
-=cut
-
-WARNING: DO NOT EDIT THE POD FILES. THEY ARE AUTO-GENERATED
-
-=pod
-
 rrdgraph_rpn - About RPN Math in rrdtool graph
 
 =head1 SYNOPSIS
@@ -265,4 +259,17 @@ Example: C<VDEF:perc95=mydata,95,PERCENT>
 
 =back
 
-=include see_also
+=head1 SEE ALSO
+
+L<rrdgraph> gives an overview of how B<rrdtool graph> works.
+L<rrdgraph_data> describes B<DEF>,B<CDEF> and B<VDEF> in detail,
+L<rrdgraph_rpn> describes the B<RPN> language used in the B<?DEF> statements,
+L<rrdgraph_graph> page describes all of the graph and print functions.
+
+Make sure to read L<rrdgraph_examples> for tipsE<amp>tricks.
+
+=head1 AUTHOR
+
+Program by Tobias Oetiker E<lt>oetiker@ee.ethz.chE<gt>
+
+This manual page by Alex van den Bogaerdt E<lt>alex@ergens.op.het.netE<gt>
index 58a8561..89030b8 100644 (file)
@@ -1,8 +1,6 @@
 =head1 NAME
 
-rrdtool - round robin database tool
-
-=for html <div align="right"><a href="rrdtool.pdf">PDF</a> version.</div>
+rrdtool - Round Robin Database Tool
 
 =head1 SYNOPSIS