<docbook><section><title>GitSource</title><title> Using iODBC Open Source Edition GIT Tree</title> Using iODBC Open Source Edition GIT Tree
<bridgehead class="http://www.w3.org/1999/xhtml:h2"> Introduction</bridgehead>
<para>Developers who want to actively track progress of the iODBC source code and contribute bugfixes or enhancements to the project need Git access.</para>
<para>This access requires basic knowledge of Git itself; the general layout of open source and GNU projects; the use of autoconf and automake; and other things that are beyond the scope of this document.</para>
<bridgehead class="http://www.w3.org/1999/xhtml:h2"> Git Archive Server Access</bridgehead>
<bridgehead class="http://www.w3.org/1999/xhtml:h3"> <ulink url="GitHub">GitHub</ulink></bridgehead>
<para>For main development, we publish the iODBC open-source tree to <ulink url="https://github.com/">GitHub</ulink>.
We encourage everyone who is interested in tracking the project to create an account there.</para>
<para>Users who mainly just want to look at the code can use the <ulink url="https://github.com/openlink/iODBC">GitHub web interface</ulink> or check out a local copy of the tree:</para>
<programlisting>$ git clone git://github.com/openlink/iODBC.git
</programlisting><para> At this point, you can create your own work branch based on any available branch; create bug fixes; commit them to your own branch; and then use git format-patch to generate diffs.</para>
<para>Developers are encouraged to fork the project on <ulink url="GitHub">GitHub</ulink>, create branches for enhancements and bug fixes, and submit pull requests so changes can be reviewed and incorporated into the main tree for future release.</para>
<para>For more information, see <ulink url="https://docs.github.com/">GitHub Documentation</ulink>.</para>
<bridgehead class="http://www.w3.org/1999/xhtml:h3"> <ulink url="SourceForge">SourceForge</ulink></bridgehead>
<para><ulink url="OpenLink">OpenLink</ulink> continues to use <ulink url="https://sourceforge.net/projects/iodbc/">SourceForge</ulink> to release source tarballs and certain binaries.</para>
<para><ulink url="SourceForge">SourceForge</ulink> also contains a frozen CVS archive for historical reference, and read-only Git archive access is available there as well.</para>
<para>For more information, see <ulink url="https://sourceforge.net/scm/?type=git&amp;group_id=161622">SourceForge Git Documentation</ulink>.</para>
<bridgehead class="http://www.w3.org/1999/xhtml:h2"> Git Tag-Signing Key</bridgehead>
<para>To verify signed releases, import our Git public GPG key in one of these ways:</para>
<itemizedlist mark="bullet" spacing="compact"><listitem>Run: <programlisting>$ gpg --recv-keys 089DE67A
</programlisting></listitem>
<listitem>Or download <ulink url="GitSource/089DE67A.asc">089DE67A.asc</ulink> and run: <programlisting>$ gpg --import 089DE67A.asc
</programlisting></listitem>
<listitem>Or run: <programlisting>$ echo &#39;-----BEGIN PGP PUBLIC KEY BLOCK-----

mQENBE9pILIBCACpRFwsoYwyfswRt7QMWtifJb/L1Zo9955pKyOnnI/vZ2S2uFv0
OALpyUoR/WhQzIrtmzVYfBSmmBhAr5sh05tcXjFmyulhecAllYfaNAHEYAfgczaj
7TMYkHOd4xU2dl2PEPpWYaQJ/tuokZICC5BBakpHDN12TUrZTyCe1qEUgJvM6e3A
8BAwZSB9wbdwhxVwZEbeNYcINsBXL9kc/oy0v61XEIr17n/GS2Lmh533XP97kTz5
IJhTwrGf3lQUpEYRWptepUI2bnBSO3ZJ8G4x5w4ESP0f+Uw1ihx/yqTmOeeJfvX1
rhnLF5kOjN8xXtvI4nrYm/ctVtr68A33hjP9ABEBAAG0Q09wZW5MaW5rIFNvZnR3
YXJlIFNpZ25pbmcgS2V5IChHaXQgdGFncykgPGdpdC5hZG1pbkBvcGVubGlua3N3
LmNvbT6JAT4EEwECACgFAk9pILICGy8FCQeGH4AGCwkIBwMCBhUIAgkKCwQWAgMB
Ah4BAheAAAoJEHtptnAIneZ6TJ8IAIytxv4t2umvjWFSOULLLTiQu11WMnYdPWS7
fMPVznZDpIs9RR1egmj4QAC0x/ImgtRGn3uoebNv2E9WBRYQw+OL4+AnY/y6Grfm
plkOO/EW3GZYMMWjm6Ih7EhlLooW3Epv1oP8tdikVHKTPl4SiWSPOt1j+W1QyeFO
7EjWi1zSPL6R0kwqBY/Lpf2SXiiXU40FwoU2J2gPFcWYuBal1Jc3iiBq3hF9W5LZ
kuJ0D09VXoS6hwc0GkEv2ibFmtBVOsjsjH6N3ENApLT5YK9Pgm2sk5kYXRLDsj1V
3ojRNFlZbFHr2Hwjwrh0vo9y5XeXUebMu+QPkIQmMeECFkcdl7Y=
=zD+s
-----END PGP PUBLIC KEY BLOCK-----
&#39; | gpg --import
</programlisting> The fingerprint of this key is 7D6E 3898 F670 9F7A C25C 19D0 7B69 B670 089D E67A.</listitem>
</itemizedlist><bridgehead class="http://www.w3.org/1999/xhtml:h2"> Further Documentation</bridgehead>
<para>Please see our <ulink url="https://www.iodbc.org/dataspace/iodbc/wiki/iodbcWiki/GitStrategy">Git Usage</ulink> document concerning the usage of branches and tags.</para>
<para>For an introduction to Git, see the <ulink url="http://virtuoso.openlinksw.com/dataspace/dav/wiki/Main/GitQuickstartTips">Git Quickstart and Tips</ulink> guide.
</para>
</section></docbook>