Code

Ack NMU.
[pkg-rrdtool.git] / doc / rrdgraph_graph.1
index 9507bbe4dd6800a4bf1bb78f078ee4b90a43f4ce..e41dbff25c36cf7f6f69f0514d7d1a31358f3d37 100644 (file)
@@ -1,4 +1,4 @@
-.\" Automatically generated by Pod::Man 2.1801 (Pod::Simple 3.05)
+.\" Automatically generated by Pod::Man 2.22 (Pod::Simple 3.07)
 .\"
 .\" Standard preamble:
 .\" ========================================================================
 .\" ========================================================================
 .\"
 .IX Title "RRDGRAPH_GRAPH 1"
-.TH RRDGRAPH_GRAPH 1 "2009-02-21" "1.3.8" "rrdtool"
+.TH RRDGRAPH_GRAPH 1 "2012-01-20" "1.4.7" "rrdtool"
 .\" For nroff, turn off justification.  Always turn off hyphenation; it makes
 .\" way too many mistakes in technical documents.
 .if n .ad l
@@ -204,7 +204,7 @@ unit stays undefined. Thus, formatter strings using \fB\f(CB%S\fB\fR and no \fB\
 will all use the same magnitude unit except for zero values.
 .PP
 If you \s-1PRINT\s0 a \s-1VDEF\s0 value, you can also print the time associated with it by appending the string
-\&\fB:strftime\fR to the format. Note that rrdtool uses the strftime function of your OSs C library. This means that
+\&\fB:strftime\fR to the format. Note that RRDtool uses the strftime function of your OSs C library. This means that
 the conversion specifier may vary. Check the manual page if you are uncertain. The following is a list of
 conversion specifiers usually supported across the board.
 .ie n .IP "\fB\fB%a\fB\fR" 4
@@ -265,7 +265,7 @@ The second as a decimal number (range 00 to 61).
 .ie n .IP "\fB\fB%S\fB\fR" 4
 .el .IP "\fB\f(CB%S\fB\fR" 4
 .IX Item "%S"
-The seconds since the epoch (1.1.1970) (libc dependant non standard!)
+The seconds since the epoch (1.1.1970) (libc dependent non standard!)
 .ie n .IP "\fB\fB%U\fB\fR" 4
 .el .IP "\fB\f(CB%U\fB\fR" 4
 .IX Item "%U"
@@ -452,7 +452,7 @@ right aligned, and \fB\ec\fR for centered. In the next section there is an
 example showing how to use centered formatting.
 .PP
 \&\fB\en\fR is a valid alias for \fB\el\fR since incomplete parsing in earlier
-versions of rrdtool lead to this behavior and a number of people has been using it.
+versions of RRDtool lead to this behavior and a number of people has been using it.
 .PP
 Normally there are two space characters inserted between every two items
 printed into the graph. The space following a string can be suppressed by
@@ -467,8 +467,24 @@ in connection with \fB\f(CB%s\fB\fR to suppress empty unit strings.
 A special case is \s-1COMMENT:\s0\fB\es\fR which inserts some additional vertical space
 before placing the next row of legends.
 .PP
-If you are using the proportional font in your graph, you can use tab
-characters or the sequence \fB\et\fR to line-up legend elements. Note that
+If you want to have left and right aligned legends on the same line use \s-1COMMENT:\s0\fB\eu\fR
+to go one line back like this:
+.PP
+.Vb 3
+\& COMMENT:left\el
+\& COMMENT:\eu
+\& COMMENT:right\er
+.Ve
+.PP
+There is also a 'nop' control for situations where you want a string to
+actually end in a backslash character sequence \fB\e.\fR
+.PP
+.Vb 1
+\& COMMENT:OS\e2\e.
+.Ve
+.PP
+When using a proportional font in your graph, the tab
+characters or the sequence \fB\et\fR will line-up legend elements. Note that
 the tabs inserted are relative to the start of the current legend
 element!
 .PP
@@ -526,7 +542,7 @@ Vertical displacement, in 10000ths of an em. Can be negative for subscript, posi
 \&'true' or 'false' whether to strike through the text
 .IP "\fBstrikethrough_color\fR" 4
 .IX Item "strikethrough_color"
-The color of strikethrough lines; an \s-1RGB\s0 color specification such as '#00FF00' or a color name such as 'red'
+The color of crossed out lines; an \s-1RGB\s0 color specification such as '#00FF00' or a color name such as 'red'
 .IP "\fBfallback\fR" 4
 .IX Item "fallback"
 \&'true' or 'false' whether to enable fallback. If disabled, then characters will only be used from the closest matching font on the system. No fallback will be done to other fonts on the system that might contain the characters in the text. Fallback is enabled by default. Most applications should not disable fallback.
@@ -555,7 +571,7 @@ Makes font relatively larger, equivalent to <span size=\*(L"larger\*(R">
 Italic
 .IP "\fBs\fR" 4
 .IX Item "s"
-Strikethrough
+Strike through
 .IP "\fBsub\fR" 4
 .IX Item "sub"
 Subscript