dcmd2csv.1

.\"	$Id$
.\"
.\" Copyright (c) 2017 Kristaps Dzonsons <kristaps@bsd.lv>
.\"
.\" This library is free software; you can redistribute it and/or
.\" modify it under the terms of the GNU Lesser General Public
.\" License as published by the Free Software Foundation; either
.\" version 2.1 of the License, or (at your option) any later version.
.\"
.\" This library is distributed in the hope that it will be useful,
.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
.\" Lesser General Public License for more details.
.\"
.\" You should have received a copy of the GNU Lesser General Public
.\" License along with this library; if not, write to the Free Software
.\" Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,
.\" MA 02110-1301 USA
.\"
.Dd $Mdocdate$
.Dt DCMD2CSV 1
.Os
.Sh NAME
.Nm dcmd2csv
.Nd export dives to CSV
.Sh SYNOPSIS
.Nm dcmd2csv
.Op Fl v
.Op Ar files...
.Sh DESCRIPTION
The
.Nm
utility accepts XML files generated by
.Xr dcmd 1
and exports dive profiles to CSV.
This can then read by, say, Subsurface.
Its arguments are as follows:
.Bl -tag -width Ds
.It Fl v
Parse files in verbose mode.
.It Ar files...
XML input files with one or more dives.
.El
.Ss Output
The output of
.Nm
consists of comma-separated rows of dive number, time (seconds since
start of the dive), depth (metres), and temperature (celsius).
The depth and temperature fields may be empty.
.Pp
To import into subsurface, these columns correspond to the
.Dq Dive No. ,
.Dq Time ,
.Dq Sample depth ,
and
.Dq Sample temperature
fields when importing from a dive log CSV file.
The separator is a comma, time in seconds, measures in metric.
.Sh EXIT STATUS
.Ex -std
.Sh AUTHORS
The
.Nm
utility was written by
.An Kristaps Dzonsons ,
.Mt kristaps@bsd.lv .