Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

update building from source directions. #1403

Merged
merged 4 commits into from
Jan 24, 2025
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
19 changes: 10 additions & 9 deletions xmldoc/chapters/build.xml
Original file line number Diff line number Diff line change
Expand Up @@ -26,33 +26,34 @@ etc. Clang/LLVM, GNU C++, and MSVC are regularly exercised via automation.
<para>
You can grab a release from the <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="https://www.gpsbabel.org/download.html">GPSBabel download page</link>, but if you're going to be doing any development, you'll find that working from the <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="https://github.com/gpsbabel/gpsbabel">GPSBabel Github repo</link> is easier. Checkouts via Git, HTTPS, SSH, and Subversion are supported.
</para>
<para>There are external requirements for bulding.</para>
<para>There are external requirements for building.</para>
<variablelist>
<varlistentry>
<term>
<link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://qt-project.org">Qt</link>
<link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="https://contribute.qt-project.org/">Qt</link>
</term>
<listitem>
<para>
Qt version 5.12 or newer is required for all builds. MacOS and Windows users can download
binaries from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://qt-project.org/downloads">Qt Downloads</link>
Fedora or CentOS users may need to 'dnf install qt5-qtbase-devel'. When in doubt, 'dnf search qt' or 'dnf search qt5' may help you find the correct package name. Ubuntu users may need to 'apt-get install qt5-default'. Package names
Qt version 6.2 or newer is required for all builds.
You may download directly from Qt using the <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="https://doc.qt.io/qt-6/get-and-install-qt.html">Qt supplied directions</link>.
Alternatively, MacOS users can download binaries from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="https://formulae.brew.sh/formula/qt">Homebrew</link>.
Fedora or CentOS users may need to 'dnf install qt6-qtbase-devel qt6-qt5compat-devel'. When in doubt, 'dnf search qt' or 'dnf search qt6' may help you find the correct package name. Ubuntu users may need to 'apt-get install qt6-base-dev qt6-5compat-dev'. Additional qt6 packages are required to build the GUI. Package names
and versions in Linux frequently change, so you may need to ask your Linux vendor
for help or look in tools/Docker* for inspiration for our automated builds that
for help or look in our <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="https://github.com/GPSBabel/gpsbabel/tree/master/tools">Docker files</link> for inspiration from our automated builds that
use Docker.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>
<link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://libusb.info">libusb 1.0</link>
<link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="https://libusb.info/">libusb 1.0</link>
</term>
<listitem>
<para>
is needed to communicate with use with older USB Garmins.
For macOS, we use an included copy.
Fedora users may need to 'yum install libusb-devel'. Ubuntu users may
need to 'apt install libusb-dev' or look in tools/Docker* for inspiration
Fedora users may need to 'dnf install libusb1-devel'. Ubuntu users may
need to 'apt-get install libusb-1.0-0-dev' or look in tools/Docker* for inspiration
from our automated Docker builds.</para>
</listitem>
</varlistentry>
Expand Down
Loading