Code

fixed many pod bugs while creating the new website
authoroetiker <oetiker@a5681a0c-68f1-0310-ab6d-d61299d08faa>
Sun, 17 Apr 2005 22:43:11 +0000 (22:43 +0000)
committeroetiker <oetiker@a5681a0c-68f1-0310-ab6d-d61299d08faa>
Sun, 17 Apr 2005 22:43:11 +0000 (22:43 +0000)
git-svn-id: svn://svn.oetiker.ch/rrdtool/branches/1.2@411 a5681a0c-68f1-0310-ab6d-d61299d08faa

20 files changed:
program/doc/bin_dec_hex.pod
program/doc/rrd-beginners.pod
program/doc/rrdcgi.pod
program/doc/rrdcreate.pod
program/doc/rrddump.pod
program/doc/rrdfetch.pod
program/doc/rrdfirst.pod
program/doc/rrdgraph.src
program/doc/rrdgraph_data.src
program/doc/rrdgraph_examples.src
program/doc/rrdgraph_graph.src
program/doc/rrdgraph_rpn.src
program/doc/rrdinfo.pod
program/doc/rrdlast.pod
program/doc/rrdresize.pod
program/doc/rrdrestore.pod
program/doc/rrdthreads.pod
program/doc/rrdtune.pod
program/doc/rrdupdate.pod
program/doc/rrdxport.pod

index 3a2f2fbc2f8ca63c82e1fdc91381db189f080fd9..0ab2709ff8df888451f66c5478a9f9360f7dd9a8 100644 (file)
@@ -1,6 +1,6 @@
 =head1 NAME
 
-Binary Decimal Hexadecimal - How does it work
+bin_dec_hex - How Binary, Decimal, Hexadecimal
 
 =for html <div align="right"><a href="bin_dec_hex.pdf">PDF</a> version.</div>
 
@@ -361,5 +361,4 @@ other people by pointing them to this document when they are asking
 basic questions. They will not only get their answer but at the same
 time learn a whole lot more.
 
-Alex van den Bogaerdt 
-<alex@ergens.op.het.net>
+Alex van den Bogaerdt  E<lt>alex@ergens.op.het.netE<gt>
index 363cc2e1053a3c6ce4e169d8006aff4fe2b05b0e..85b4adefdd75b0a73901650a84a569d1bcb1ac26 100644 (file)
@@ -1,6 +1,6 @@
 =head1 NAME 
 
-rrd-beginners - Beginners guide
+rrd-beginners - RRDtool Beginners guide
 
 =head1 SYNOPSIS
 
index 6a46ce2633bf98090c8dc83f6300ae657a338a31..b0ececb4c8f8614f4909a5bf2a7c92dbd9ebcabd 100644 (file)
@@ -1,6 +1,6 @@
 =head1 NAME
 
-rrdcgi - create web pages containing RRD graphs based on templates
+rrdcgi - Create web pages containing RRD graphs based on templates
 
 =for html <div align="right"><a href="rrdcgi.pdf">PDF</a> version.</div>
 
index affe4611bffdec5b7e4d85869aa5bddaf96216f3..84d405e9f28c2ca9d7d4475bf9321c15e8368d17 100644 (file)
@@ -1,6 +1,6 @@
 =head1 NAME
 
-rrdtool create - Set up a new Round Robin Database
+rrdcreate - Set up a new Round Robin Database
 
 =for html <div align="right"><a href="rrdcreate.pdf">PDF</a> version.</div>
 
index de6b0ecea91e018c5024b9860d115037f5d779a7..f1e653f7164e7b63553337ab18b864b557844ec1 100644 (file)
@@ -1,6 +1,6 @@
 =head1 NAME
 
-rrdtool dump - dump the contents of an B<RRD> to XML format
+rrddump - dump the contents of an RRD to XML format
 
 =for html <div align="right"><a href="rrddump.pdf">PDF</a> version.</div>
 
index a4e87c54d10bc15bfa53440464c8a49d70cc0d88..80053f3a2cd3405e99df1b3c9953fe3b023ef35c 100644 (file)
@@ -1,6 +1,6 @@
 =head1 NAME
 
-rrdtool fetch - fetch data from an RRD.
+rrdfetch - Fetch data from an RRD.
 
 =for html <div align="right"><a href="rrdfetch.pdf">PDF</a> version.</div>
 
index 4d01273ea6a8e7ed4852efdda5091aaafe3d6654..85aae587eaa8b43a7fd7ae8c0a971926d8367194 100644 (file)
@@ -1,6 +1,6 @@
 =head1 NAME
 
-rrdfirst - Return the date of the first data sample in an B<RRA> within an B<RRD>
+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>
 
index 18a5442fec5efd7c5ae52c9dda20aeddbf1d14e9..c6a91be91adf56f68da432a4735371b95165555c 100644 (file)
@@ -1,14 +1,24 @@
+=head1 NAME
+
+=cut
+
+WARNING: DO NOT EDIT THE POD FILES. THEY ARE AUTO-GENERATED
+
+=pod
+
+rrdgraph - Round Robin Database tool grapher functions
+
 =include name
 
 =head1 SYNOPSIS
 
 B<rrdtool graph> I<filename>
-[E<lt>B<L<option|rrdgraph/OPTIONS>>E<gt> ...]
-[E<lt>B<L<data definition|rrdgraph_data/DEF>>E<gt> ...]
-[E<lt>B<L<data calculation|rrdgraph_data/CDEF>>E<gt> ...]
-[E<lt>B<L<variable definition|rrdgraph_data/VDEF>>E<gt> ...]
-[E<lt>B<L<graph element|rrdgraph_graph/GRAPH>>E<gt> ...]
-[E<lt>B<L<print element|rrdgraph_graph/PRINT>>E<gt> ...]
+[I<L<option|rrdgraph/OPTIONS>> ...]
+[I<L<data definition|rrdgraph_data/DEF>> ...]
+[I<L<data calculation|rrdgraph_data/CDEF>> ...]
+[I<L<variable definition|rrdgraph_data/VDEF>> ...]
+[I<L<graph element|rrdgraph_graph/GRAPH>> ...]
+[I<L<print element|rrdgraph_graph/PRINT>> ...]
 
 =head1 DESCRIPTION
 
index f5c1114460a87d0d701b7f2131c71a5dedfe78d9..5a8d51f199cf4ecfc0b8fe088d8daa7223ae3bbd 100644 (file)
@@ -1,4 +1,12 @@
-=include name
+=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
 
index 632c78772f51f234195e861bee44ff5ad38e912e..8ccf8ebddf6f884fc19ed33e3367fec673803e8a 100644 (file)
@@ -1,4 +1,12 @@
-=include name
+=head1 NAME
+
+=cut
+
+WARNING: DO NOT EDIT THE POD FILES. THEY ARE AUTO-GENERATED
+
+=pod
+
+rrdgraph_examples - Examples for rrdtool graph
 
 =head1 SYNOPSIS
 
@@ -36,16 +44,24 @@ ready because comments are intermixed with the examples.
     VDEF:ds1avg=ds1,AVERAGE,8,*
     VDEF:ds1min=ds1,MINIMUM,8,*
     VDEF:ds1pct=95,ds1,PERCENTILE,8,*
+
 Note: consolidation occurs here.
+
     CDEF:ds0bits=ds0,8,*
     CDEF:ds1bits=ds1,8,*
+
 Note: 10 spaces to move text to the right
+
     COMMENT:"          "
+
 Note: three times size == 11 chars, "###.## xBps"
+
     COMMENT:"Maximum    "
     COMMENT:"Average    "
     COMMENT:"Minimum    "
+
 Note: last line contains new-line character
+
     COMMENT:"95th percentile\n"
     AREA:ds0bits#00C000:"Inbound "
     GPRINT:ds0max:"%6.2lf %Sbps"
@@ -69,7 +85,9 @@ Depending on your needs you can do this in two ways:
 Offset the data, then graph this
 
     DEF:mydata=my.rrd:ds:AVERAGE
+
 Note: this will also influence anything that uses "data"
+
     CDEF:data=mydata,100,+
     LINE1:data#FF0000:"Data with offset"
 
@@ -78,9 +96,13 @@ Note: this will also influence anything that uses "data"
 Graph the original data, with an offset
 
     DEF:mydata=my.rrd:ds:AVERAGE
+
 Note: no color in the first line so it is not visible
+
     LINE1:100
+
 Note: the second line gets stacked on top of the first one
+
     LINE1:data#FF0000:"Data with offset":STACK
 
 =back
@@ -99,7 +121,9 @@ Note: the second line gets stacked on top of the first one
     --end now --start end-1w
     DEF:thisweek=router.rrd:ds0:AVERAGE
     DEF:lastweek=router.rrd:ds0:AVERAGE:end=now-1w:start=end-1w
+
 shift the data forward by one week (604800 seconds)
+
     SHIFT:lastweek:604800
     [ more of the usual VDEF and CDEF stuff if you like ]
     AREA:lastweek#0000FF:Last\ week
index 83ccae58aa29f6fe16e5ce3aac93a490d3add621..a683923a09844067f89d47be066bff4fa75f46e8 100644 (file)
@@ -1,54 +1,44 @@
-=include name
+=head1 NAME  
 
-=head1 SYNOPSIS
-
-=over 4
-
-=item B<old-style commands, for compatibility>
-
-=over 4
-
-=item B<PRINT> : I<vname> : I<CF> : I<format>
-
-=item B<GPRINT> : I<vname> : I<CF> : I<format>
+=cut
 
-=item B<HRULE> : I<value> # I<color> [ :I<legend> ]
+WARNING: DO NOT EDIT THE POD FILES. THEY ARE AUTO-GENERATED
 
-=item B<STACK> : I<vname> # I<color> [ :I<legend> ]
+=pod
 
-=back
+rrdgraph_graph - rrdtool graph command reference
 
-Z<>
+=head1 SYNOPSIS
 
-=item B<available commands>
+B<PRINT>B<:>I<vname>B<B<:>>I<format>
 
-=over 8
+B<GPRINT>B<:>I<vname>B<:>I<format>
 
-=item B<PRINT> : I<vname> : I<format>
+B<COMMENT>B<:>I<text>
 
-=item B<GPRINT> : I<vname> : I<format>
+B<VRULE>B<:>I<vname>B<#>I<color>[B<:>I<legend>]
 
-=item B<COMMENT> : I<text>
+B<LINE>I<width>B<:>I<vname>B<#>I<color>[B<:>I<legend>][B<:>B<STACK>]
 
-=item B<VRULE> : I<vname> # I<color> [ : I<legend> ]
+B<AREA>B<:>I<vname>B<#>I<color>[B<:>I<legend>][B<:>B<STACK>]
 
-=item B<LINE>{I<width>} : I<vname> # I<color> [ : I<legend> ] [ C<:STACK> ]
+B<TICK>B<:>I<vname>B<#>I<rrggbb>[I<aa>][B<:>I<fraction>[B<:>I<legend>]]
 
-=item B<AREA> C<:> I<vname> C<#> I<color> [ C<:> I<legend> ] [ C<:STACK> ]
+B<SHIFT>B<:>I<vname>B<:>I<offset>
 
 =cut
 
-# =item B<PART> : I<vname> B<#> I<rrggbbaa> [ B<:> I<legend> ]
+B<PART>B<:>I<vname>B<#>I<rrggbb>[I<aa>][B<:>I<legend>]
 
 =pod
 
-=item B<TICK> : I<vname> B<#> I<rrggbbaa> [ : I<fraction> [ : I<legend> ] ]
+B<PRINT>B<:>I<vname>B<:>I<CF>B<:>I<format> (deprecated)
 
-=item B<SHIFT> : I<vname> , I<offset>
+B<GPRINT>B<:>I<vname>B<:>I<CF>B<:>I<format> (deprecated)
 
-=back
+B<HRULE>B<:>I<value>B<#>I<color>[B<:>I<legend>] (deprecated)
 
-=back
+B<STACK>B<:>I<vname>B<#>I<color>[B<:>I<legend>] (deprecated)
 
 =head1 DESCRIPTION
 
@@ -60,12 +50,12 @@ Similarly no report is generated if you don't use print options.
 
 =over 4
 
-=item B<PRINT> : I<vname> : I<CF> : I<format>
+=item B<PRINT:>I<vname>B<:>I<CF><:>I<format>
 
 I<Deprecated. Use the new form of this command in new scripts.>
 The first form of this command is to be used with B<CDEF> I<vname>s.
 
-=item B<PRINT> : I<vname> : I<format>
+=item B<PRINT:>I<vname>B<:>I<format>
 
 Depending on the context, either the value component or the time
 component of a B<VDEF> is printed using I<format>. It is an error
@@ -161,24 +151,24 @@ B<%Z> time zone
 
 =over 4
 
-=item B<GPRINT> : I<vname> : I<CF> : I<format>
+=item B<GPRINT>B<:>I<vname>B<:>I<CF>B<:>I<format>
 
 I<Deprecated. Use the new form of this command in new scripts.>
 This is the same as C<PRINT> but now it is printed inside the graph.
 
-=item B<GPRINT> : I<vname> : I<format>
+=item B<GPRINT>B<:>I<vname>B<:>I<format>
 
 This is the same as C<PRINT> but now it is printed inside the graph.
 
-=item B<COMMENT> : I<text>
+=item B<COMMENT>B<:>I<text>
 
 Text is printed literally in the legend section of the graph
 
-=item B<HRULE> : I<value> # I<color> [ :I<legend> ]
+=item B<HRULE>B<:>I<value>B<#>I<color> [ :I<legend> ]
 
 I<Deprecated. Use B<LINEx> in new scripts.>
 
-=item B<VRULE> : I<vname> # I<color> [ : I<legend> ]
+=item B<VRULE>B<:>I<vname>B<#>I<color> [B<:>I<legend> ]
 
 Draw a vertical line at I<time>.  Its color is composed from three
 hexadecimal numbers specifying the color components (00 is off, FF is
@@ -186,7 +176,7 @@ maximum) red, green and blue.  Optionally a legend box and string is
 printed in the legend section. I<time> may be a number or a variable
 from a B<VDEF>. It is an error to use I<vname>s from B<DEF> or B<CDEF> here.
 
-=item B<LINE>{I<width>} : I<{vname or number}> # I<color> [ : I<legend> ]
+=item B<LINE>I<width>B<:>I<{vname or number}>B<#>I<color>[B<:>I<legend>]
 [ C<:STACK> ]
 
 Draw a line of the specified width into the graph. If the color
@@ -198,12 +188,12 @@ B<CDEF>.  If the optional B<STACK> modifier is used, this line is
 stacked on top of the previous element which can be a B<LINEx> or
 an B<AREA>
 
-=item B<AREA> C<:> I<vname> C<#> I<color> [ C<:> I<legend> ] [ C<:STACK> ]
+=item B<AREA>B<:>I<vname>B<#>I<rrggbb>[I<aa>][B<:>I<legend>][B<:STACK>]
 
 See B<LINE>, however the area between the x-axis and the line will
 also be filled.
 
-=item B<TICK> : I<vname> B<#> I<rrggbbaa> [ : I<fraction> [ : I<legend> ] ]
+=item B<TICK>B<:>I<vname>B<#>I<rrggbb>[I<aa>][B<:>I<fraction>[B<:>I<legend>]]
 
 Plot a tick mark (a vertical line) for each value of I<vname> that is
 non-zero and not *UNKNOWN*. The I<fraction> argument specifies the
@@ -211,7 +201,7 @@ length of the tick mark as a fraction of the y-axis; the default value
 is 0.1 (10% of the axis). Note that the color specification is not
 optional.
 
-=item B<SHIFT> : I<vname> : I<offset>
+=item B<SHIFT>B<:>I<vname>B<:>I<offset>
 
 Using this command B<RRDtool> will graph the following elements
 with the specified offset.  For instance, you can specify an
@@ -222,22 +212,22 @@ a variable here.
 
 =cut
 
-#=item B<PART> : I<vname> B<#> I<rrggbbaa> [ B<:> I<legend> ]
-#
-#B<RRDtool> has now support for B<pie charts>. If you include the
-#B<PART> command, the canvas is extended to make room for a chart
-#The size of the canvas is determined by the lesser of
-#L<width and height|rrdgraph/item_Size>.
-#
-#Pie parts will be concatenated, the first one will start at the
-#top and parts will be created clockwise.  The size of the part
-#is defined by the value part of the L<VDEF|rrdgraph_data/VDEF>
-#function.  It should return a number between 0 and 100, being a
-#percentage.  Providing wrong input will produce undefined results.
+=item B<PART>B<:>I<vname>B<#>I<rrggbb>[I<aa>][B<:>I<legend>]
+
+B<RRDtool> has now support for B<pie charts>. If you include the
+B<PART> command, the canvas is extended to make room for a chart
+The size of the canvas is determined by the lesser of
+L<width and height|rrdgraph/item_Size>.
+
+Pie parts will be concatenated, the first one will start at the
+top and parts will be created clockwise.  The size of the part
+is defined by the value part of the L<VDEF|rrdgraph_data/VDEF>
+function.  It should return a number between 0 and 100, being a
+percentage.  Providing wrong input will produce undefined results.
 
 =pod
 
-=item B<STACK> : I<vname> # I<color> [ :I<legend> ]
+=item B<STACK>B<:>I<vname>B<#>I<color>[B<:>I<legend>]
 
 I<Deprecated.  Use the B<STACK> modifiers on the other commands.>
 
index 51ed056341a556577cb7427f7a59544ce0e6e560..9e6f70ed0579c4c7b98555a9e592286bbbb7543d 100644 (file)
@@ -1,10 +1,16 @@
-=include name
+=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
 
-I<E<lt>RPN expressionE<gt>> := 
-I<E<lt>vnameE<gt>>|I<E<lt>operatorE<gt>>|I<E<lt>valueE<gt>>
-[ , I<E<lt>RPN expressionE<gt>>]
+I<RPN expression>:=I<vname>|I<operator>|I<value>[,I<RPN expression>]
 
 =head1 DESCRIPTION
 
index 3558d7a8dc99b6b942b9ef5c24d9c75ad6b199eb..b03032c3d6c34538e5693a7a91d6265bbe51238d 100644 (file)
@@ -1,6 +1,6 @@
 =head1 NAME
 
-rrdtool info - extract header information from an RRD
+rrdinfo - extract header information from an RRD
 
 =for html <div align="right"><a href="rrdinfo.pdf">PDF</a> version.</div>
 
index 20e20daae364a9e4c44572381423c17d4b9cbc6e..44492369110b8f7f29d9ac892e414157bfeebae0 100644 (file)
@@ -1,6 +1,6 @@
 =head1 NAME
 
-rrdtool last - Return the date of the last data sample in an B<RRD>
+rrdlast - Return the date of the last data sample in an RRD
 
 =for html <div align="right"><a href="rrdlast.pdf">PDF</a> version.</div>
 
index cdece4500179a7ced82e13222544eced4d666279..f6acb9b6fe031c7b9d68daa1e097acb72fd988b9 100644 (file)
@@ -1,6 +1,6 @@
 =head1 NAME
 
-rrdtool resize - alters the size of an RRA and creates new .rrd file
+rrdresize - alters the size of an RRA and creates new .rrd file
 
 =for html <div align="right"><a href="rrdresize.pdf">PDF</a> version.</div>
 
index e587d8446765be10dfc7cde9bb2f364862461382..e30a25b2823844fe146a6783ce45d4a6a3205397 100644 (file)
@@ -1,6 +1,6 @@
 =head1 NAME
 
-rrdtool restore - restore the contents of an B<RRD> from its XML dump format
+rrdrestore - Restore the contents of an RRD from its XML dump format
 
 =for html <div align="right"><a href="rrdrestore.pdf">PDF</a> version.</div>
 
index 00f5e02d91f1388e71a69743b5c0d63935a3a91c..a1f6e742154c5ea195464f197b37ef703610a874 100644 (file)
@@ -1,6 +1,6 @@
 =head1 NAME
 
- rrdthreads - Provisions for linking the RRD library to use in multi-threaded programs
+rrdthreads - Provisions for linking the RRD library to use in multi-threaded programs
 
 =head1 SYNOPSIS
 
@@ -18,7 +18,7 @@ way. They all end in the usual "C<_r>" prefix.
 
 In order to use the librrd in multi-threaded programs you must:
 
-=over 4
+=over
 
 =item * 
 
@@ -54,11 +54,11 @@ library. Otherwise the call might fail due to some earlier error.
 
 =back
 
-=head1 IMPORTANT NOTES FOR RRD CONTRIBUTORS:
+=head2 NOTES FOR RRD CONTRIBUTORS
 
 Some precautions must be followed when developing RRD from now on:
 
-=over 4
+=over
 
 =item *
 
@@ -66,7 +66,7 @@ Only use thread-safe functions in library code. Many often used libc
 functions aren't thread-safe. Take care in the following
 situations/when using the following library functions:
 
-=over 8
+=over
 
 =item *
 
@@ -97,7 +97,9 @@ Many other (lookup documentation)
 
 =back
 
-As an aide(?) a header file named F<rrd_is_thread_safe.h> is provided
+=item *
+
+A header file named F<rrd_is_thread_safe.h> is provided
 that works with the GNU C-preprocessor to "poison" some of the most
 common non-thread-safe functions using the C<#pragma GCC poison>
 directive. Just include this header in source files you want to keep
@@ -132,19 +134,11 @@ operation (e.g., C<rrd_create>, but not in C<rrd_create_r>)
 
 =back
 
-=head1 CURRENTLY IMPLEMENTED THREAD SAFE FUNCTIONS
+=head2 CURRENTLY IMPLEMENTED THREAD SAFE FUNCTIONS
 
 Currently there exit thread-safe variants of C<rrd_update>,
 C<rrd_create>, C<rrd_dump>, C<rrd_info> and C<rrd_last>.
 
 =head1 AUTHOR
 
-Initial multi-threading support was implemented by Peter Stamfest
-<peter@stamfest.at> in Feb. 2003.
-
-This documentation was written by Peter Stamfest.
-
-Changes to the RRD library and this documentation are (c) 2003 by
-Peter Stamfest and are distributed under the GPL.
-
-=cut
+Peter Stamfest E<lt>peter@stamfest.atE<gt>
index c4175a77cd9362a09f896cf41457bfebe7c7c609..3e96f6de8b4be300206d75d75775b7de065c4157 100644 (file)
@@ -1,6 +1,6 @@
 =head1 NAME
 
-rrdtool tune - Modify some basic properties of a Round Robin Database
+rrdtune - Modify some basic properties of a Round Robin Database
 
 =for html <div align="right"><a href="rrdtune.pdf">PDF</a> version.</div>
 
index 2d4ee8c7dd4d94dfe7336f205dce1f00cacc5091..fe5ff6d73124e5c99b26f99a1fe959a375c29a08 100644 (file)
@@ -1,6 +1,6 @@
 =head1 NAME
 
-rrdtool update - Store a new set of values into the RRD
+rrdupdate - Store a new set of values into the RRD
 
 =for html <div align="right"><a href="rrdupdate.pdf">PDF</a> version.</div>
 
index f5f11f460a84fde80d6f156c08e04a172fc03fa2..1af2041b7aec1cd620252311ba8838ab9732c515 100644 (file)
@@ -1,6 +1,6 @@
 =head1 NAME
 
-rrdtool xport - Export data in XML format based on data from one or several RRD
+rrdxport - Export data in XML format based on data from one or several RRD
 
 =for html <div align="right"><a href="rrdxport.pdf">PDF</a> version.</div> 
 
@@ -48,7 +48,7 @@ for details.
 
 =item B<--step> I<value> (default automatic)
 
-See I<rrdgraph> documentation.
+See L<rrdgraph> documentation.
 
 =item B<DEF:>I<vname>B<=>I<rrd>B<:>I<ds-name>B<:>I<CF>