<docbook><section><title>VOSGIT</title><title> Using Virtuoso Open Source Edition GIT Tree</title> Using Virtuoso 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 Virtuoso 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 which are beyond the scope of this document.</para>
<para>If you have any questions, please email the <ulink url="mailto:vos.admin@openlinksw.com">Virtuoso Open Source Maintainer</ulink>.</para>
<para> </para>
<bridgehead class="http://www.w3.org/1999/xhtml:h2"> Git Archive Server Access</bridgehead>
<bridgehead class="http://www.w3.org/1999/xhtml:h3">GitHub</bridgehead>
<para>For main development, we will publish the Virtuoso Open Source tree to <ulink url="http://github.com/">GitHub</ulink>.
We encourage everyone who is interested in tracking the project to make an account there.</para>
<para>Users who mainly just want to look at the code can use the <ulink url="https://github.com/openlink/virtuoso-opensource">GitHub Web interface</ulink> or track the archive by checking out a local copy of the tree, with a command like this:</para>
<programlisting>$ git clone git://github.com/openlink/virtuoso-opensource.git
</programlisting><para> At this point, you can create your own work-branch based on any available branch; create bugfixes; commit them to your own branch; and then use the git format-patch command to generate appropriate diffs to email to the <ulink url="mailto:vos.admin@openlinksw.com">Virtuoso Open Source Maintainer</ulink>.</para>
<para>Developers are encouraged to fork the project using GitHub; create your own branches to make enhancements/bugfixes; and then send pull requests using the excellent GitHub interface, so we can examine and incorporate those fixes into the master tree for future release.</para>
<para>For more information, please read the <ulink url="http://help.github.com/">GitHub Documentation</ulink> on how to fork a project, send pull requests, track a project, etc.</para>
<bridgehead class="http://www.w3.org/1999/xhtml:h3">SourceForge</bridgehead>
<para><ulink url="OpenLink">OpenLink</ulink> will continue to use <ulink url="http://sourceforge.net/projects/virtuoso/">sourceforge.net</ulink> for to release source tarballs and certain binaries.</para>
<para>SourceForge also contains the frozen <ulink url="http://virtuoso.cvs.sourceforge.net/viewvc/virtuoso/virtuoso-opensource/">CVS Archive</ulink> for historical reference, and for completeness, read-only <ulink url="http://virtuoso.git.sourceforge.net/git/gitweb.cgi?p=virtuoso/virtuoso-opensource">Git Archive</ulink> access will also be available there.</para>
<para>For more information, please see the <ulink url="https://sourceforge.net/scm/?type=git&amp;group_id=161622">SourceForge Git Documentation</ulink>.</para>
<para> </para>
<bridgehead class="http://www.w3.org/1999/xhtml:h2">Git Tag-Signing Key</bridgehead>
<para>To verify signed releases, you should import our Git public GPG key, by either:</para>
<itemizedlist mark="bullet" spacing="compact"><listitem>running <programlisting>$ gpg --recv-keys 089DE67A
</programlisting> </listitem>
<listitem>or downloading the attached <ulink url="VOSGIT/089DE67A.asc">089DE67A.asc</ulink> file, and running <programlisting>$ gpg --import 089DE67A.asc
</programlisting> </listitem>
<listitem>or running <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></listitem>
</itemizedlist><para>The fingerprint of this key is <computeroutput>7D6E 3898 F670 9F7A C25C 19D0 7B69 B670 089D E67A</computeroutput>.</para>
<bridgehead class="http://www.w3.org/1999/xhtml:h2">Further Documentation</bridgehead>
<para>Please see our <ulink url="VOSGitUsage">Git Usage</ulink> document concerning the usage of branches and tags.</para>
<para>For an introduction to Git, see our <ulink url="GitQuickstartTips">Git Quickstart and Tips</ulink> guide.</para>
<bridgehead class="http://www.w3.org/1999/xhtml:h2"> Next...</bridgehead>
<para>Proceed to the <ulink url="VOSMake">build documentation</ulink>.
</para>
</section></docbook>