Re: [gpsd-dev] [PATCH 2/3] Enable Windows version of gpxlogger

[Robert Norris]

>> For distributing
>> libgps.dll, gpspipe.exe and gpxlogger.exe I was thinking of just
>> offering the binaries only.
>>

> You could include the docs (either in the same package or a separate one)
> rather than relying on online docs.  If there's no "man" equivalent on
> Windows, this could be the HTML versions.

Good idea.

Then I'd like just to include the relevant html files for Windows.
But a pity that gpxlogger help is ATM inside gps.xml.
I think it would be useful to split gpxlogger off into it's own entry.

So I'm thinking of simply dumping a copy of the binaries on github release of 
Windows Hack Building branch of gpsd.
(i.e. no Windows installers).

I can  keep the Windows specific behaviour 'help' notes in that branch to avoid 
polluting it for everyone else.

--
Be Seeing You - Rob.
If at first you don't succeed,
then skydiving isn't for you.

________________________________________
From: gpsd-dev <address@hidden> on behalf of Fred Wright <address@hidden>
Sent: 05 March 2017 21:27:42
To: address@hidden
Subject: Re: [gpsd-dev] [PATCH 2/3] Enable Windows version of gpxlogger

On Sun, 5 Mar 2017, Robert Norris wrote:

> I don't think I've ever seen man pages on Windows. For distributing
> libgps.dll, gpspipe.exe and gpxlogger.exe I was thinking of just
> offering the binaries only.
>
> The man pages can often be found online (e.g.
> http://manpages.ubuntu.com/manpages/zesty/man1/gpspipe.1.html)

You could include the docs (either in the same package or a separate one)
rather than relying on online docs.  If there's no "man" equivalent on
Windows, this could be the HTML versions.

> However it would seem strange to mention Windows issues in the man
> pages, when they there mainly for Unix like systems.

Yeah, good point.

> Perhaps a statement about Windows support would be better off somewhere
> in the www/ documentation.

Sounds reasonable.  Especially since the www build is now working again.
:-)


Speaking of Windows and manpages, I made a recent change to suppress all
the "Note: Writing" crap when building in --silent mode.  This involves
replacing the "spawn" function for the manpage builders.  The standard
posix version is pretty simple, but the win32 version is much more
complicated, so it's not entirely clear that my replacement is valid for
win32.  But this only matters if one is building in --silent mode and:

1) One is actually building on Windows, rather than cross-building for
Windows on a POSIX platform.

and

2) One is building manpages, meaning that either xsltproc or xmlto is
available on Windows.

I suspect that at least one of those conditions is necessarily false for
other reasons.  If not, I'd be inclined to just disable the filtering hack
on Windows, rather than implement a more complicated version.

Fred Wright