Ringbuffer rework.
[obnox/wireshark/wip.git] / doc / ethereal.pod.template
index 6a8ad3aabeb51d883649224ffbab82255f3bee20..db02c73befb6b3afafa9822a5429c4b706d57df0 100644 (file)
@@ -118,25 +118,19 @@ kilobytes (where a kilobyte is 1000 bytes, not 1024 bytes).
 
 If a maximum capture file size was specified, cause B<Ethereal> to run
 in "ring buffer" mode, with the specified number of files.  In "ring
-buffer" mode, B<Ethereal> will write to several capture files; the name
-of the first file, while the capture is in progress, will be the name
-specified by the B<-w> flag, and subsequent files with have .I<n>
-appended, with I<n> counting up.
+buffer" mode, B<Ethereal> will write to several capture files. 
+Their name is based on the number of the file and on the creation date 
+and time.
 
 When the first capture file fills up, B<Ethereal> will switch to writing
 to the next file, until it fills up the last file, at which point it'll
-discard the data in the first file and start writing to that file.  When
-that file fills up, B<Ethereal> will discard the data in the next file
-and start writing to it, and so on.
+discard the data in the first file (unless 0 is specified, in which case,
+the number of files is unlimited) and start writing to that file and so on.
 
 If the optional duration is specified, B<Ethereal> will switch also 
 to the next file when the specified number of seconds has elapsed even
 if the current file is not completely fills up.
 
-When the capture completes, the files will be renamed to have names
-based on the number of the file and on the date and time at which
-packets most recently started being written to the file.
-
 =item -B
 
 Set the initial height of the byte view (bottom) pane.
@@ -1113,7 +1107,7 @@ can save those packets to a file with the I<File:Save As> menu item.
 
 The I<Use ring buffer> check box lets you specify that the capture
 should be done in "ring buffer" mode; the I<Number of files> field
-lets you specify the number of files in the ring buffer
+lets you specify the number of files in the ring buffer (0 means unlimited).
 
 The I<Rotate capture file every ...  second(s)> check box and field lets
 you to specify that the swith to a next ring buffer file should be done