|
Name |
|
Date |
Size |
#Lines |
LOC |
| .. | | 03-May-2022 | - |
| help/ | H | 03-May-2022 | - | | |
| images/ | H | 03-May-2022 | - | | |
| AUTHORS | H A D | 02-Sep-2009 | 1.5 KiB | 81 | 74 |
| README.contrib | H A D | 02-Nov-2009 | 5 KiB | 115 | 91 |
| README.gui | H A D | 02-Nov-2009 | 104 | 6 | 3 |
| TODO | H A D | 06-Aug-2009 | 391 | 13 | 8 |
| aboutdlg.cpp | H A D | 17-Jan-2010 | 1.7 KiB | 48 | 21 |
| aboutdlg.h | H A D | 05-Jul-2009 | 1.2 KiB | 41 | 12 |
| aboutui.ui | H A D | 17-Jan-2010 | 7.9 KiB | 148 | 147 |
| advdlg.cpp | H A D | 02-Nov-2009 | 2.2 KiB | 64 | 38 |
| advdlg.h | H A D | 02-Nov-2009 | 1.4 KiB | 54 | 24 |
| advui.ui | H A D | 02-Nov-2009 | 4.3 KiB | 176 | 175 |
| app.pro | H A D | 27-Aug-2012 | 2.2 KiB | 110 | 92 |
| app.qrc | H A D | 12-Oct-2009 | 545 | 20 | 18 |
| app.rc | H A D | 02-Nov-2009 | 48 | 2 | 1 |
| appname.h | H A D | 06-Sep-2009 | 1,009 | 27 | 4 |
| babeldata.h | H A D | 19-Jun-2010 | 6.2 KiB | 182 | 135 |
| babelstrings.pl | H A D | 02-Sep-2009 | 349 | 20 | 16 |
| donate.cpp | H A D | 19-Jun-2010 | 1.3 KiB | 38 | 13 |
| donate.h | H A D | 19-Jun-2010 | 1.2 KiB | 47 | 18 |
| donate.ui | H A D | 19-Jun-2010 | 4.2 KiB | 135 | 134 |
| dpencode.cpp | H A D | 04-Mar-2012 | 6.2 KiB | 205 | 140 |
| dpencode.h | H A D | 08-Sep-2009 | 1.7 KiB | 54 | 24 |
| env.sh | H A D | 05-Jul-2009 | 202 | 11 | 5 |
| filterdata.cpp | H A D | 02-Nov-2009 | 4.8 KiB | 177 | 132 |
| filterdata.h | H A D | 02-Nov-2009 | 8.7 KiB | 263 | 207 |
| filterdlg.cpp | H A D | 08-Sep-2009 | 4.3 KiB | 135 | 83 |
| filterdlg.h | H A D | 05-Jul-2009 | 1.6 KiB | 59 | 28 |
| filterui.ui | H A D | 06-Jul-2009 | 3.6 KiB | 143 | 142 |
| filterwidgets.cpp | H A D | 02-Nov-2009 | 10 KiB | 241 | 176 |
| filterwidgets.h | H A D | 02-Nov-2009 | 7.7 KiB | 310 | 239 |
| format.cpp | H A D | 14-Feb-2010 | 2.8 KiB | 79 | 50 |
| format.h | H A D | 15-Feb-2010 | 7 KiB | 223 | 176 |
| formatload.cpp | H A D | 02-Nov-2009 | 5.1 KiB | 163 | 126 |
| formatload.h | H A D | 05-Jul-2009 | 1.3 KiB | 44 | 15 |
| gmapdlg.cpp | H A D | 04-Mar-2012 | 18.4 KiB | 568 | 464 |
| gmapdlg.h | H A D | 29-Jan-2012 | 2.8 KiB | 97 | 59 |
| gmapui.ui | H A D | 02-Nov-2009 | 3.7 KiB | 143 | 142 |
| gpsbabel.desktop | H A D | 19-Oct-2011 | 195 | 10 | 9 |
| gpsbabel.ts | H A D | 02-Oct-2011 | 81.8 KiB | 1,941 | 1,926 |
| gpsbabel_de.ts | H A D | 19-May-2010 | 85.6 KiB | 2,060 | 2,059 |
| gpsbabel_es.ts | H A D | 02-Sep-2009 | 86.6 KiB | 2,064 | 2,063 |
| gpsbabel_fr.ts | H A D | 02-Sep-2009 | 83.4 KiB | 2,061 | 2,060 |
| gpsbabel_hu.ts | H A D | 02-Sep-2009 | 82.5 KiB | 2,061 | 2,060 |
| gpsbabel_it.ts | H A D | 07-Jun-2010 | 96 KiB | 1,947 | 1,918 |
| gpsbabelfe | H A D | 14-Sep-2009 | 1.4 KiB | 47 | 21 |
| gpsbabelfe.ts | H A D | 04-Sep-2012 | 69 KiB | 1,598 | 1,583 |
| gpsbabelfe_de.ts | H A D | 04-Sep-2012 | 88.3 KiB | 1,784 | 1,747 |
| gpsbabelfe_es.ts | H A D | 04-Sep-2012 | 95.7 KiB | 1,789 | 1,755 |
| gpsbabelfe_fr.ts | H A D | 04-Sep-2012 | 70.7 KiB | 1,647 | 1,632 |
| gpsbabelfe_hu.ts | H A D | 04-Sep-2012 | 70.5 KiB | 1,642 | 1,627 |
| gpsbabelfe_it.ts | H A D | 04-Sep-2012 | 86.2 KiB | 1,674 | 1,645 |
| gpsbabelfe_ru.ts | H A D | 04-Sep-2012 | 94.7 KiB | 1,671 | 1,642 |
| gpx.cpp | H A D | 04-Mar-2012 | 6.4 KiB | 246 | 182 |
| gpx.h | H A D | 29-Jan-2012 | 8.5 KiB | 320 | 248 |
| help.cpp | H A D | 02-Nov-2009 | 1.3 KiB | 42 | 12 |
| help.h | H A D | 02-Nov-2009 | 1 KiB | 31 | 5 |
| latlng.cpp | H A D | 28-Aug-2009 | 2.7 KiB | 73 | 22 |
| latlng.h | H A D | 05-Jul-2009 | 1.4 KiB | 44 | 15 |
| main.cpp | H A D | 04-Sep-2011 | 2 KiB | 66 | 34 |
| mainwindow.cpp | H A D | 04-Mar-2012 | 44.4 KiB | 1,351 | 1,071 |
| mainwindow.h | H A D | 02-Oct-2011 | 4.3 KiB | 138 | 100 |
| mainwinui.ui | H A D | 03-Oct-2011 | 21.1 KiB | 694 | 693 |
| makelinuxdist.sh.in | H A D | 14-Sep-2009 | 1.9 KiB | 70 | 47 |
| makesetup.bat | H A D | 06-Sep-2011 | 1.9 KiB | 61 | 51 |
| map.cpp | H A D | 04-Mar-2012 | 13.1 KiB | 443 | 348 |
| map.h | H A D | 05-Jul-2009 | 2.6 KiB | 109 | 62 |
| miscfltui.ui | H A D | 02-Nov-2009 | 4.2 KiB | 147 | 145 |
| optionsdlg.cpp | H A D | 01-Mar-2010 | 8.1 KiB | 246 | 188 |
| optionsdlg.h | H A D | 02-Nov-2009 | 1.9 KiB | 78 | 41 |
| preferences.cpp | H A D | 01-Nov-2010 | 3 KiB | 95 | 61 |
| preferences.h | H A D | 15-Feb-2010 | 1.2 KiB | 46 | 20 |
| preferences.ui | H A D | 27-Jun-2010 | 4.1 KiB | 145 | 144 |
| processwait.cpp | H A D | 28-Aug-2009 | 6.4 KiB | 217 | 154 |
| processwait.h | H A D | 05-Jul-2009 | 2.3 KiB | 85 | 49 |
| qt.conf | H A D | 05-Jul-2009 | 102 | 8 | 7 |
| rttrkui.ui | H A D | 06-Jul-2009 | 5.8 KiB | 147 | 144 |
| serial_mac.cpp | H A D | 14-Feb-2010 | 10.2 KiB | 215 | 80 |
| serial_unix.cpp | H A D | 13-Feb-2010 | 1.3 KiB | 41 | 18 |
| serial_win.cpp | H A D | 21-Jun-2010 | 2.5 KiB | 73 | 36 |
| setting.h | H A D | 15-Feb-2010 | 3.9 KiB | 136 | 83 |
| setup.iss | H A D | 03-Sep-2012 | 3.6 KiB | 86 | 69 |
| setup.iss.in | H A D | 03-Oct-2011 | 3.7 KiB | 86 | 69 |
| showUrl.sh | H A D | 05-Jul-2009 | 144 | 10 | 5 |
| trackui.ui | H A D | 02-Nov-2009 | 14.6 KiB | 452 | 444 |
| upgrade.cpp | H A D | 26-Aug-2012 | 9.2 KiB | 323 | 243 |
| upgrade.h | H A D | 12-Apr-2010 | 2.1 KiB | 78 | 48 |
| upgrade.ui | H A D | 27-Jul-2009 | 1.6 KiB | 79 | 78 |
| version_mismatch.cpp | H A D | 19-Jun-2010 | 1.2 KiB | 35 | 10 |
| version_mismatch.h | H A D | 19-Jun-2010 | 1.2 KiB | 40 | 13 |
| version_mismatch.ui | H A D | 19-Jun-2010 | 4.1 KiB | 169 | 168 |
| wayptsui.ui | H A D | 06-Jul-2009 | 9.8 KiB | 258 | 255 |
README.contrib
1If you're interested in contributing to this program, here are some
2guidelines. Mail patches to gpsbabel-code@lists.sourceforge.net for
3consideration and integration.
4
5Rules to Live By
6----------------
7
8Standards are good. ISO C and POSIX are greatly preferred.
9
10Reuse is good, if doing so is not onerous. For example, using the expat
11libraries vastly simplifies the XML parsers while increasing their
12robustness plus those libraries are ubiquitous. So I consider it OK to
13require expat.
14
15You may find format_skeleton.c and filter_skeleton.c in the source tree
16to be helpful examples. Just add meat!
17
18Compilers complain for a reason. Code shouldn't emit warnings.
19
20The entire world doesn't run <your OS here>. I've tested this code on
21at least five different OSes. If you find yourself wanting to insert
22compiler or OS specific magic, please resist.
23
24Coding consistency is encouraged. The reality is we have a lot of code
25that was written by different authors. Some code from other projects is
26included. We don't have immutable rules about code style (indention,
27curly location, whitespace rules, etc.) but we do ask that you try to
28match what is around any code you modify. "When in Rome..."
29
30If writing new code, we'd prefer a style like:
31
32 int
33 mumble(int whatever)
34 {
35 <tab>if (whatevever) {
36 <tab><tab>return blah;
37 <tab>}
38 }
39
40...but if you're submitting a new source file that you intend to
41maintain and are convinced that two space indents will make the world a
42better place, knock yourself out. But if you need to add a line of code
43to the above before "return blah" and do it with spaces instead of hard
44tabs, that would be bad.
45
46Submitting Patches
47------------------
48
49If you are creating a new target you should submit patches (use
50"cvs diff -uN" to create patches) to the following files:
51* Yourcode.c and/or Yourcode.h - this is the code required to do your
52 conversions and any support files that your code requires.
53* vecs.c - an updated vecs.c file implementing your conversion code into
54 GPSBabel.
55* Makefile - an updated Makefile telling the compiler how to build and link
56 your conversion into GPSBabel
57* testo - an updated script that tests your conversion (this should produce
58 no output if all is good, see the current testo script for examples)
59* YourOutput - a sample file of code produced by your function (used in testo
60 and lives in a directory called "reference").
61* Documentation - see below.
62
63Please ensure that you are building and testing against the latest code
64from the top of the CVS tree and that any code you modify is the latest
65version from the CVS - Note: code changes sometimes occur frequently!
66
67Documentation
68-------------
69
70HTML and text documentation are generated automatically from DocBook
71source located in the "xmldoc" directory. That directory contains
72two subdirectories of interest: "formats" and "filters". If your
73contribution adds or affects a format, you'll want to be in the "formats"
74directory. Otherwise, you'll want to be in the "filters" directory.
75
76You should contribute a file called "yourname.xml", where "yourname" is the
77name you would give on the command-line to invoke your new format or filter.
78For example, the arc filter is documented in "filters/arc.xml".
79
80This file contains a general description of your format or filter, any
81limitations in your support for it, and anything else the end user should
82know. For file formats, links to manufacturers' websites are encouraged.
83The contents of this file are not valid or even well-formed XML on their own;
84they are included into a larger framework. If you know DocBook, you should
85ensure that the contents of this file will validate if included in a <section>.
86If you do not know DocBook, see the other files in this directory for examples
87or see http://docbook.org/tdg/en/html/docbook.html for the gory details. Tags
88of interest will almost certainly include <para> for paragraphs,
89<ulink url="..."> for web links, and <screen format="linespecific"> for
90example command lines.
91
92For each option supported by your format or filter, you should also contribute
93a file in the "options" subdirectory called "yourname-youroption.xml", again
94using the names you would use on the command line to invoke your format or
95filter with that particular option. For example, the "distance" option to the
96"arc" filter is documented in "filters/options/arc-distance.xml". These
97files are similar to the general description above, and should meet the same
98validation requirements.
99
100As of this writing, there are two formats that violate this rule: Magellan
101serial and Microsoft Streets & Trips. Because those formats have the same
102names as other formats, their descriptions are located in "magellan1.xml" and
103"msroute1.xml" respectively. These are special cases, and you should do your
104best to ensure that they remain the only special cases.
105
106Note that the automated framework already includes the name and description of
107your format and its options as described in vecs.c and yourcode.c, so there is
108no need to repeat that information in your documentation.
109
110
111Enjoy!
112
113Robert Lipe,
114robertlipe@usa.net
115
README.gui
1* Adding your own language to GPSBabelFE *
2-------------------------------------------
3
4To be written.
5
6