sa1: Update manual page

Explain new option "--rotate".

Signed-off-by: Sebastien GODARD <sysstat@users.noreply.github.com>

diff --git a/man/sa1.in b/man/sa1.in
index 5bf0a9a66f3c627be21b1533b0a5358e70bd6bbf..7ce07a394505ae9144de7ba3c70b3a21d2bbd4e8 100644 (file)
--- a/man/sa1.in
+++ b/man/sa1.in
@@ -1,10 +1,10 @@
 .\" sa1 manual page - (C) 1999-2020 Sebastien Godard (sysstat <at> orange.fr)
-.TH SA1 8 "JULY 2020" Linux "Linux User's Manual" -*- nroff -*-
+.TH SA1 8 "NOVEMBER 2020" Linux "Linux User's Manual" -*- nroff -*-
 .SH NAME
 sa1 \- Collect and store binary data in the system activity daily data file.
 
 .SH SYNOPSIS
-.B @SA_LIB_DIR@/sa1 [ --boot | --sleep |
+.B @SA_LIB_DIR@/sa1 [ --boot | --rotate [ iso ] | --sleep |
 .I interval count
 .B ]
 
@@ -47,6 +47,14 @@ command should be called without specifying the
 parameters in order to insert a dummy record, marking the time when the counters
 restart from 0.
 .TP
+.B --rotate [ iso ]
+.RB "Use this option to tell " "sa1 " "to insert a record of statistics to the standard"
+.IR "saDD" " system activity daily data file of the previous day."
+This should be done shortly after midnight (on day DD+1) in order to make sure that the
+data file covers the whole day, including the last interval of time just before midnight.
+.RB "Adding the " "iso" " keyword tells " "sa1" " to use
+.IR "saYYYYMMDD" " instead of " "saDD" " as the standard system activity daily data file name."
+.TP
 .B --sleep
 .RB "This option tells " "sa1 " "that the " "sadc"
 command should insert a comment indicating that the system is entering or leaving
@@ -58,6 +66,11 @@ place the following entry in your root crontab file:
 
 .B 0,10,20,30,40,50 * * * * @SA_LIB_DIR@/sa1 1 1 -S DISK
 
+To rotate current system activity daily data file, ensuring it is complete,
+place the following entry in your root crontab file:
+
+.B 0 0 * * * @SA_LIB_DIR@/sa1 --rotate
+
 .SH FILES
 .I @SA_DIR@/saDD
 .br