.\" $HeadURL$ $LastChangedRevision$
.\" vim: filetype=nroff
.\"
.TH GPXSPLIT\-UNBUNDLE 1 "ADE_APP_TOKEN_RELEASE_DATE_MAN"
.SH NAME
gpxsplit\-unbundle \- split GPX route file into individual routes
.br
.ne 5
.SH SYNOPSIS
.B gpxsplit\-unbundle
\*[ade_standard_synopsis_component]
.I gpx\-file
.br
.ne 5
.SH DESCRIPTION
.B Gpxsplit\-unbundle
converts one GPX file containing many routes into many GPX files each containing one route. 
.br
.ne 5
.SH CONFIGURATION
GPS displays may not be wide enough to display the whole of route's name. 
For this reason, if you name your routes according to the following format:
.IP
\fInumber\-or\-word\fB\-\fIdescription\fR
.PP
for example:
.IP
.B 123\ \-\ Ammersee\ round\-trip (128km)
.PP
then
.B gpxsplit\-unbundle
will set the route name to 
.I number\-or\-word
in the GPX file, for example:
.IP 
.B 123
.br
.ne 5
.SH OPTIONS
\*[ade_standard_options_component]
.br
.ne 5
.SH EXIT STATUS
On success
.B gpxsplit\-unbundle
returns zero. On failure it returns non-zero and displays a diagnostic
message.
.br
.ne 5
.SH FILES
None.
.br
.ne 5
.SH ENVIRONMENT VARIABLES
None.
.br
.ne 5
.SH EXAMPLES
Here is the output from processing a GPX file containing five routes:
.IP
.nf
.fam C
user$ \fBls \-1rt\fR
training-route-gpswandern.gpx
user$ \fBgpxsplit-unbundle -v training-route-gpswandern.gpx\fR
gpxsplit-unbundle: INFO: splitting training-route-gpswandern.gpx into individual routes ...
gpxsplit-unbundle: INFO: processing '20 126km' ...
gpxsplit-unbundle: WARNING: 20 126km: couldn't determine short name as route name isn't '<number-or-word>-<description>'; using 01 ...
gpxsplit-unbundle: INFO: processing '30 - Dachau/Vanilla - 62km' ...
gpxsplit-unbundle: INFO: processing '40 - Dachau/Neufahrn - 77km' ...
gpxsplit-unbundle: INFO: processing '50 - Finsing - 31km' ...
gpxsplit-unbundle: INFO: processing '60 - Flughafen - 50km' ...
user$ \fBls \-1rt\fR
training-route-gpswandern.gpx
20 126km.gpx
30 - Dachau-Vanilla - 62km.gpx
40 - Dachau-Neufahrn - 77km.gpx
50 - Finsing - 31km.gpx
60 - Flughafen - 50km.gpx
user$
.fam T
.fi
.br
.ne 5
.SH CAVEATS
None.
.br
.ne 5
.SH STANDARDS
This manual page documents version ADE_APP_TOKEN_RELEASE_ID of
.B gpxsplit\-unbundle\fR.
.br
.ne 5
.SH SEE ALSO
gpxsplit\-unbundle-config(1), gpxsplit\-chunk(1)
.br
.ne 5
.SH AUTHOR
ADE_APP_TOKEN_AUTHOR_NAME <ADE_APP_TOKEN_AUTHOR_EMAIL>
.br
.ne 5
.SH COPYRIGHT & DISTRIBUTION POLICY
Copyright (C) 2017-ADE_APP_TOKEN_RELEASE_YEAR ADE_APP_TOKEN_AUTHOR_NAME
\*[ade_standard_copyright_component]