Last-Modified: Fri, 15 Aug 2025 17:16:12 GMT
Expires: Mon, 13 Aug 2035 17:16:12 GMT

<!DOCTYPE html>
<html lang='en'>
<head>
<title>Avoid XKeysymToString() conflict with libX11 - tigervnc.git - High performance, multi-platform VNC client and server: https://github.com/TigerVNC/tigervnc</title>
<meta name='generator' content='cgit v1.2.3'/>
<meta name='robots' content='index, nofollow'/>
<link rel='stylesheet' type='text/css' href='/cgit.css'/>
<link rel='shortcut icon' href='/favicon.ico'/>
<link rel='alternate' title='Atom feed' href='https://source.dussan.org/tigervnc.git/atom/common/rfb/Blacklist.h?h=master' type='application/atom+xml'/>
</head>
<body>
<div id='cgit'><table id='header'>
<tr>
<td class='logo' rowspan='2'><a href='/'><img src='/cgit.png' alt='cgit logo'/></a></td>
<td class='main'><a href='/'>index</a> : <a href='/tigervnc.git/'>tigervnc.git</a></td><td class='form'><form method='get'>
<input type='hidden' name='id' value='01cf61b4e0f4cd5031794f0a82fdf603d20a7852'/><select name='h' onchange='this.form.submit();'>
<option value='1.0-branch'>1.0-branch</option>
<option value='1.1-branch'>1.1-branch</option>
<option value='1.10-branch'>1.10-branch</option>
<option value='1.11-branch'>1.11-branch</option>
<option value='1.12-branch'>1.12-branch</option>
<option value='1.13-branch'>1.13-branch</option>
<option value='1.14-branch'>1.14-branch</option>
<option value='1.15-branch'>1.15-branch</option>
<option value='1.2-branch'>1.2-branch</option>
<option value='1.3-branch'>1.3-branch</option>
<option value='1.4-branch'>1.4-branch</option>
<option value='1.5-branch'>1.5-branch</option>
<option value='1.6-branch'>1.6-branch</option>
<option value='1.7-branch'>1.7-branch</option>
<option value='1.8-branch'>1.8-branch</option>
<option value='1.9-branch'>1.9-branch</option>
<option value='master' selected='selected'>master</option>
</select> <input type='submit' value='switch'/></form></td></tr>
<tr><td class='sub'>High performance, multi-platform VNC client and server: https://github.com/TigerVNC/tigervnc</td><td class='sub right'>www-data</td></tr></table>
<table class='tabs'><tr><td>
<a href='/tigervnc.git/about/'>about</a><a href='/tigervnc.git/'>summary</a><a href='/tigervnc.git/refs/?id=01cf61b4e0f4cd5031794f0a82fdf603d20a7852'>refs</a><a href='/tigervnc.git/log/common/rfb/Blacklist.h'>log</a><a href='/tigervnc.git/tree/common/rfb/Blacklist.h?id=01cf61b4e0f4cd5031794f0a82fdf603d20a7852'>tree</a><a class='active' href='/tigervnc.git/commit/common/rfb/Blacklist.h?id=01cf61b4e0f4cd5031794f0a82fdf603d20a7852'>commit</a><a href='/tigervnc.git/diff/common/rfb/Blacklist.h?id=01cf61b4e0f4cd5031794f0a82fdf603d20a7852'>diff</a><a href='/tigervnc.git/stats/common/rfb/Blacklist.h'>stats</a></td><td class='form'><form class='right' method='get' action='/tigervnc.git/log/common/rfb/Blacklist.h'>
<input type='hidden' name='id' value='01cf61b4e0f4cd5031794f0a82fdf603d20a7852'/><select name='qt'>
<option value='grep'>log msg</option>
<option value='author'>author</option>
<option value='committer'>committer</option>
<option value='range'>range</option>
</select>
<input class='txt' type='search' size='10' name='q' value=''/>
<input type='submit' value='search'/>
</form>
</td></tr></table>
<div class='path'>path: <a href='/tigervnc.git/commit/?id=01cf61b4e0f4cd5031794f0a82fdf603d20a7852'>root</a>/<a href='/tigervnc.git/commit/common?id=01cf61b4e0f4cd5031794f0a82fdf603d20a7852'>common</a>/<a href='/tigervnc.git/commit/common/rfb?id=01cf61b4e0f4cd5031794f0a82fdf603d20a7852'>rfb</a>/<a href='/tigervnc.git/commit/common/rfb/Blacklist.h?id=01cf61b4e0f4cd5031794f0a82fdf603d20a7852'>Blacklist.h</a></div><div class='content'><div class='cgit-panel'><b>diff options</b><form method='get'><input type='hidden' name='id' value='01cf61b4e0f4cd5031794f0a82fdf603d20a7852'/><table><tr><td colspan='2'/></tr><tr><td class='label'>context:</td><td class='ctrl'><select name='context' onchange='this.form.submit();'><option value='1'>1</option><option value='2'>2</option><option value='3' selected='selected'>3</option><option value='4'>4</option><option value='5'>5</option><option value='6'>6</option><option value='7'>7</option><option value='8'>8</option><option value='9'>9</option><option value='10'>10</option><option value='15'>15</option><option value='20'>20</option><option value='25'>25</option><option value='30'>30</option><option value='35'>35</option><option value='40'>40</option></select></td></tr><tr><td class='label'>space:</td><td class='ctrl'><select name='ignorews' onchange='this.form.submit();'><option value='0' selected='selected'>include</option><option value='1'>ignore</option></select></td></tr><tr><td class='label'>mode:</td><td class='ctrl'><select name='dt' onchange='this.form.submit();'><option value='0' selected='selected'>unified</option><option value='1'>ssdiff</option><option value='2'>stat only</option></select></td></tr><tr><td/><td class='ctrl'><noscript><input type='submit' value='reload'/></noscript></td></tr></table></form></div><table summary='commit info' class='commit-info'>
<tr><th>author</th><td>Pierre Ossman &lt;ossman@cendio.se&gt;</td><td class='right'>2024-08-06 14:53:30 +0200</td></tr>
<tr><th>committer</th><td>Pierre Ossman &lt;ossman@cendio.se&gt;</td><td class='right'>2024-08-06 14:53:30 +0200</td></tr>
<tr><th>commit</th><td colspan='2' class='oid'><a href='/tigervnc.git/commit/common/rfb/Blacklist.h?id=01cf61b4e0f4cd5031794f0a82fdf603d20a7852'>01cf61b4e0f4cd5031794f0a82fdf603d20a7852</a> (<a href='/tigervnc.git/patch/common/rfb/Blacklist.h?id=01cf61b4e0f4cd5031794f0a82fdf603d20a7852'>patch</a>)</td></tr>
<tr><th>tree</th><td colspan='2' class='oid'><a href='/tigervnc.git/tree/?id=01cf61b4e0f4cd5031794f0a82fdf603d20a7852'>451c2633109483b2cc937e374ecff98a0b2e6524</a> /<a href='/tigervnc.git/tree/common/rfb/Blacklist.h?id=01cf61b4e0f4cd5031794f0a82fdf603d20a7852'>common/rfb/Blacklist.h</a></td></tr>
<tr><th>parent</th><td colspan='2' class='oid'><a href='/tigervnc.git/commit/common/rfb/Blacklist.h?id=e2bbd9ffbab6f14f135e6f8391bd0144585442e1'>e2bbd9ffbab6f14f135e6f8391bd0144585442e1</a> (<a href='/tigervnc.git/diff/common/rfb/Blacklist.h?id=01cf61b4e0f4cd5031794f0a82fdf603d20a7852&amp;id2=e2bbd9ffbab6f14f135e6f8391bd0144585442e1'>diff</a>)</td></tr><tr><th>download</th><td colspan='2' class='oid'><a href='/tigervnc.git/snapshot/tigervnc-01cf61b4e0f4cd5031794f0a82fdf603d20a7852.tar.gz'>tigervnc-01cf61b4e0f4cd5031794f0a82fdf603d20a7852.tar.gz</a><br/><a href='/tigervnc.git/snapshot/tigervnc-01cf61b4e0f4cd5031794f0a82fdf603d20a7852.zip'>tigervnc-01cf61b4e0f4cd5031794f0a82fdf603d20a7852.zip</a><br/></td></tr></table>
<div class='commit-subject'>Avoid XKeysymToString() conflict with libX11</div><div class='commit-msg'>We implement our own version of this, and because of this we carry our
lookup table generated by the same tool that libX11 uses. Unfortunately,
that table is a global symbol and as such there might be a mismatch of
which table should be used.

Make sure we get our own copy by changing the name of it. We use a
define rather than modifying ks_tables.h as that file is automatically
generated.
</div><div class='diffstat-header'><a href='/tigervnc.git/diff/?id=01cf61b4e0f4cd5031794f0a82fdf603d20a7852'>Diffstat</a> (limited to 'common/rfb/Blacklist.h')</div><table summary='diffstat' class='diffstat'></table><div class='diffstat-summary'>0 files changed, 0 insertions, 0 deletions</div><table summary='diff' class='diff'><tr><td></td></tr></table></div> <!-- class=content -->
<div class='footer'>generated by <a href='https://git.zx2c4.com/cgit/about/'>cgit v1.2.3</a> (<a href='https://git-scm.com/'>git 2.39.1</a>) at 2025-08-15 17:16:12 +0000</div>
</div> <!-- id=cgit -->
</body>
</html>
</a>
<a id='n21' href='#n21'>21</a>
<a id='n22' href='#n22'>22</a>
<a id='n23' href='#n23'>23</a>
<a id='n24' href='#n24'>24</a>
<a id='n25' href='#n25'>25</a>
<a id='n26' href='#n26'>26</a>
<a id='n27' href='#n27'>27</a>
<a id='n28' href='#n28'>28</a>
<a id='n29' href='#n29'>29</a>
<a id='n30' href='#n30'>30</a>
<a id='n31' href='#n31'>31</a>
<a id='n32' href='#n32'>32</a>
<a id='n33' href='#n33'>33</a>
<a id='n34' href='#n34'>34</a>
<a id='n35' href='#n35'>35</a>
<a id='n36' href='#n36'>36</a>
<a id='n37' href='#n37'>37</a>
<a id='n38' href='#n38'>38</a>
<a id='n39' href='#n39'>39</a>
<a id='n40' href='#n40'>40</a>
<a id='n41' href='#n41'>41</a>
<a id='n42' href='#n42'>42</a>
<a id='n43' href='#n43'>43</a>
<a id='n44' href='#n44'>44</a>
<a id='n45' href='#n45'>45</a>
<a id='n46' href='#n46'>46</a>
<a id='n47' href='#n47'>47</a>
<a id='n48' href='#n48'>48</a>
<a id='n49' href='#n49'>49</a>
<a id='n50' href='#n50'>50</a>
<a id='n51' href='#n51'>51</a>
<a id='n52' href='#n52'>52</a>
<a id='n53' href='#n53'>53</a>
<a id='n54' href='#n54'>54</a>
<a id='n55' href='#n55'>55</a>
<a id='n56' href='#n56'>56</a>
<a id='n57' href='#n57'>57</a>
<a id='n58' href='#n58'>58</a>
<a id='n59' href='#n59'>59</a>
<a id='n60' href='#n60'>60</a>
<a id='n61' href='#n61'>61</a>
<a id='n62' href='#n62'>62</a>
<a id='n63' href='#n63'>63</a>
<a id='n64' href='#n64'>64</a>
<a id='n65' href='#n65'>65</a>
<a id='n66' href='#n66'>66</a>
<a id='n67' href='#n67'>67</a>
<a id='n68' href='#n68'>68</a>
<a id='n69' href='#n69'>69</a>
<a id='n70' href='#n70'>70</a>
<a id='n71' href='#n71'>71</a>
<a id='n72' href='#n72'>72</a>
<a id='n73' href='#n73'>73</a>
<a id='n74' href='#n74'>74</a>
<a id='n75' href='#n75'>75</a>
<a id='n76' href='#n76'>76</a>
<a id='n77' href='#n77'>77</a>
<a id='n78' href='#n78'>78</a>
<a id='n79' href='#n79'>79</a>
<a id='n80' href='#n80'>80</a>
<a id='n81' href='#n81'>81</a>
<a id='n82' href='#n82'>82</a>
<a id='n83' href='#n83'>83</a>
<a id='n84' href='#n84'>84</a>
<a id='n85' href='#n85'>85</a>
<a id='n86' href='#n86'>86</a>
<a id='n87' href='#n87'>87</a>
<a id='n88' href='#n88'>88</a>
<a id='n89' href='#n89'>89</a>
<a id='n90' href='#n90'>90</a>
<a id='n91' href='#n91'>91</a>
<a id='n92' href='#n92'>92</a>
<a id='n93' href='#n93'>93</a>
<a id='n94' href='#n94'>94</a>
<a id='n95' href='#n95'>95</a>
<a id='n96' href='#n96'>96</a>
<a id='n97' href='#n97'>97</a>
<a id='n98' href='#n98'>98</a>
<a id='n99' href='#n99'>99</a>
<a id='n100' href='#n100'>100</a>
<a id='n101' href='#n101'>101</a>
<a id='n102' href='#n102'>102</a>
<a id='n103' href='#n103'>103</a>
<a id='n104' href='#n104'>104</a>
<a id='n105' href='#n105'>105</a>
<a id='n106' href='#n106'>106</a>
<a id='n107' href='#n107'>107</a>
<a id='n108' href='#n108'>108</a>
<a id='n109' href='#n109'>109</a>
<a id='n110' href='#n110'>110</a>
<a id='n111' href='#n111'>111</a>
<a id='n112' href='#n112'>112</a>
<a id='n113' href='#n113'>113</a>
<a id='n114' href='#n114'>114</a>
<a id='n115' href='#n115'>115</a>
<a id='n116' href='#n116'>116</a>
<a id='n117' href='#n117'>117</a>
<a id='n118' href='#n118'>118</a>
<a id='n119' href='#n119'>119</a>
<a id='n120' href='#n120'>120</a>
<a id='n121' href='#n121'>121</a>
<a id='n122' href='#n122'>122</a>
<a id='n123' href='#n123'>123</a>
<a id='n124' href='#n124'>124</a>
<a id='n125' href='#n125'>125</a>
<a id='n126' href='#n126'>126</a>
<a id='n127' href='#n127'>127</a>
<a id='n128' href='#n128'>128</a>
<a id='n129' href='#n129'>129</a>
<a id='n130' href='#n130'>130</a>
<a id='n131' href='#n131'>131</a>
<a id='n132' href='#n132'>132</a>
<a id='n133' href='#n133'>133</a>
<a id='n134' href='#n134'>134</a>
<a id='n135' href='#n135'>135</a>
<a id='n136' href='#n136'>136</a>
<a id='n137' href='#n137'>137</a>
<a id='n138' href='#n138'>138</a>
<a id='n139' href='#n139'>139</a>
<a id='n140' href='#n140'>140</a>
<a id='n141' href='#n141'>141</a>
<a id='n142' href='#n142'>142</a>
<a id='n143' href='#n143'>143</a>
<a id='n144' href='#n144'>144</a>
<a id='n145' href='#n145'>145</a>
<a id='n146' href='#n146'>146</a>
<a id='n147' href='#n147'>147</a>
<a id='n148' href='#n148'>148</a>
<a id='n149' href='#n149'>149</a>
<a id='n150' href='#n150'>150</a>
<a id='n151' href='#n151'>151</a>
<a id='n152' href='#n152'>152</a>
<a id='n153' href='#n153'>153</a>
<a id='n154' href='#n154'>154</a>
<a id='n155' href='#n155'>155</a>
<a id='n156' href='#n156'>156</a>
<a id='n157' href='#n157'>157</a>
<a id='n158' href='#n158'>158</a>
<a id='n159' href='#n159'>159</a>
<a id='n160' href='#n160'>160</a>
<a id='n161' href='#n161'>161</a>
<a id='n162' href='#n162'>162</a>
<a id='n163' href='#n163'>163</a>
<a id='n164' href='#n164'>164</a>
<a id='n165' href='#n165'>165</a>
<a id='n166' href='#n166'>166</a>
<a id='n167' href='#n167'>167</a>
<a id='n168' href='#n168'>168</a>
<a id='n169' href='#n169'>169</a>
<a id='n170' href='#n170'>170</a>
<a id='n171' href='#n171'>171</a>
<a id='n172' href='#n172'>172</a>
<a id='n173' href='#n173'>173</a>
<a id='n174' href='#n174'>174</a>
<a id='n175' href='#n175'>175</a>
<a id='n176' href='#n176'>176</a>
<a id='n177' href='#n177'>177</a>
<a id='n178' href='#n178'>178</a>
<a id='n179' href='#n179'>179</a>
<a id='n180' href='#n180'>180</a>
<a id='n181' href='#n181'>181</a>
<a id='n182' href='#n182'>182</a>
<a id='n183' href='#n183'>183</a>
<a id='n184' href='#n184'>184</a>
<a id='n185' href='#n185'>185</a>
<a id='n186' href='#n186'>186</a>
<a id='n187' href='#n187'>187</a>
<a id='n188' href='#n188'>188</a>
<a id='n189' href='#n189'>189</a>
<a id='n190' href='#n190'>190</a>
<a id='n191' href='#n191'>191</a>
<a id='n192' href='#n192'>192</a>
<a id='n193' href='#n193'>193</a>
<a id='n194' href='#n194'>194</a>
<a id='n195' href='#n195'>195</a>
<a id='n196' href='#n196'>196</a>
<a id='n197' href='#n197'>197</a>
<a id='n198' href='#n198'>198</a>
<a id='n199' href='#n199'>199</a>
<a id='n200' href='#n200'>200</a>
<a id='n201' href='#n201'>201</a>
<a id='n202' href='#n202'>202</a>
<a id='n203' href='#n203'>203</a>
<a id='n204' href='#n204'>204</a>
<a id='n205' href='#n205'>205</a>
<a id='n206' href='#n206'>206</a>
<a id='n207' href='#n207'>207</a>
<a id='n208' href='#n208'>208</a>
<a id='n209' href='#n209'>209</a>
<a id='n210' href='#n210'>210</a>
<a id='n211' href='#n211'>211</a>
<a id='n212' href='#n212'>212</a>
<a id='n213' href='#n213'>213</a>
<a id='n214' href='#n214'>214</a>
<a id='n215' href='#n215'>215</a>
<a id='n216' href='#n216'>216</a>
<a id='n217' href='#n217'>217</a>
<a id='n218' href='#n218'>218</a>
<a id='n219' href='#n219'>219</a>
<a id='n220' href='#n220'>220</a>
<a id='n221' href='#n221'>221</a>
<a id='n222' href='#n222'>222</a>
<a id='n223' href='#n223'>223</a>
<a id='n224' href='#n224'>224</a>
<a id='n225' href='#n225'>225</a>
<a id='n226' href='#n226'>226</a>
<a id='n227' href='#n227'>227</a>
<a id='n228' href='#n228'>228</a>
<a id='n229' href='#n229'>229</a>
<a id='n230' href='#n230'>230</a>
<a id='n231' href='#n231'>231</a>
<a id='n232' href='#n232'>232</a>
<a id='n233' href='#n233'>233</a>
<a id='n234' href='#n234'>234</a>
<a id='n235' href='#n235'>235</a>
<a id='n236' href='#n236'>236</a>
<a id='n237' href='#n237'>237</a>
<a id='n238' href='#n238'>238</a>
<a id='n239' href='#n239'>239</a>
<a id='n240' href='#n240'>240</a>
<a id='n241' href='#n241'>241</a>
<a id='n242' href='#n242'>242</a>
</pre></td>
<td class='lines'><pre><code><style>pre { line-height: 125%; }
td.linenos .normal { color: inherit; background-color: transparent; padding-left: 5px; padding-right: 5px; }
span.linenos { color: inherit; background-color: transparent; padding-left: 5px; padding-right: 5px; }
td.linenos .special { color: #000000; background-color: #ffffc0; padding-left: 5px; padding-right: 5px; }
span.linenos.special { color: #000000; background-color: #ffffc0; padding-left: 5px; padding-right: 5px; }
.highlight .hll { background-color: #ffffcc }
.highlight .c { color: #888888 } /* Comment */
.highlight .err { color: #a61717; background-color: #e3d2d2 } /* Error */
.highlight .k { color: #008800; font-weight: bold } /* Keyword */
.highlight .ch { color: #888888 } /* Comment.Hashbang */
.highlight .cm { color: #888888 } /* Comment.Multiline */
.highlight .cp { color: #cc0000; font-weight: bold } /* Comment.Preproc */
.highlight .cpf { color: #888888 } /* Comment.PreprocFile */
.highlight .c1 { color: #888888 } /* Comment.Single */
.highlight .cs { color: #cc0000; font-weight: bold; background-color: #fff0f0 } /* Comment.Special */
.highlight .gd { color: #000000; background-color: #ffdddd } /* Generic.Deleted */
.highlight .ge { font-style: italic } /* Generic.Emph */
.highlight .gr { color: #aa0000 } /* Generic.Error */
.highlight .gh { color: #333333 } /* Generic.Heading */
.highlight .gi { color: #000000; background-color: #ddffdd } /* Generic.Inserted */
.highlight .go { color: #888888 } /* Generic.Output */
.highlight .gp { color: #555555 } /* Generic.Prompt */
.highlight .gs { font-weight: bold } /* Generic.Strong */
.highlight .gu { color: #666666 } /* Generic.Subheading */
.highlight .gt { color: #aa0000 } /* Generic.Traceback */
.highlight .kc { color: #008800; font-weight: bold } /* Keyword.Constant */
.highlight .kd { color: #008800; font-weight: bold } /* Keyword.Declaration */
.highlight .kn { color: #008800; font-weight: bold } /* Keyword.Namespace */
.highlight .kp { color: #008800 } /* Keyword.Pseudo */
.highlight .kr { color: #008800; font-weight: bold } /* Keyword.Reserved */
.highlight .kt { color: #888888; font-weight: bold } /* Keyword.Type */
.highlight .m { color: #0000DD; font-weight: bold } /* Literal.Number */
.highlight .s { color: #dd2200; background-color: #fff0f0 } /* Literal.String */
.highlight .na { color: #336699 } /* Name.Attribute */
.highlight .nb { color: #003388 } /* Name.Builtin */
.highlight .nc { color: #bb0066; font-weight: bold } /* Name.Class */
.highlight .no { color: #003366; font-weight: bold } /* Name.Constant */
.highlight .nd { color: #555555 } /* Name.Decorator */
.highlight .ne { color: #bb0066; font-weight: bold } /* Name.Exception */
.highlight .nf { color: #0066bb; font-weight: bold } /* Name.Function */
.highlight .nl { color: #336699; font-style: italic } /* Name.Label */
.highlight .nn { color: #bb0066; font-weight: bold } /* Name.Namespace */
.highlight .py { color: #336699; font-weight: bold } /* Name.Property */
.highlight .nt { color: #bb0066; font-weight: bold } /* Name.Tag */
.highlight .nv { color: #336699 } /* Name.Variable */
.highlight .ow { color: #008800 } /* Operator.Word */
.highlight .w { color: #bbbbbb } /* Text.Whitespace */
.highlight .mb { color: #0000DD; font-weight: bold } /* Literal.Number.Bin */
.highlight .mf { color: #0000DD; font-weight: bold } /* Literal.Number.Float */
.highlight .mh { color: #0000DD; font-weight: bold } /* Literal.Number.Hex */
.highlight .mi { color: #0000DD; font-weight: bold } /* Literal.Number.Integer */
.highlight .mo { color: #0000DD; font-weight: bold } /* Literal.Number.Oct */
.highlight .sa { color: #dd2200; background-color: #fff0f0 } /* Literal.String.Affix */
.highlight .sb { color: #dd2200; background-color: #fff0f0 } /* Literal.String.Backtick */
.highlight .sc { color: #dd2200; background-color: #fff0f0 } /* Literal.String.Char */
.highlight .dl { color: #dd2200; background-color: #fff0f0 } /* Literal.String.Delimiter */
.highlight .sd { color: #dd2200; background-color: #fff0f0 } /* Literal.String.Doc */
.highlight .s2 { color: #dd2200; background-color: #fff0f0 } /* Literal.String.Double */
.highlight .se { color: #0044dd; background-color: #fff0f0 } /* Literal.String.Escape */
.highlight .sh { color: #dd2200; background-color: #fff0f0 } /* Literal.String.Heredoc */
.highlight .si { color: #3333bb; background-color: #fff0f0 } /* Literal.String.Interpol */
.highlight .sx { color: #22bb22; background-color: #f0fff0 } /* Literal.String.Other */
.highlight .sr { color: #008800; background-color: #fff0ff } /* Literal.String.Regex */
.highlight .s1 { color: #dd2200; background-color: #fff0f0 } /* Literal.String.Single */
.highlight .ss { color: #aa6600; background-color: #fff0f0 } /* Literal.String.Symbol */
.highlight .bp { color: #003388 } /* Name.Builtin.Pseudo */
.highlight .fm { color: #0066bb; font-weight: bold } /* Name.Function.Magic */
.highlight .vc { color: #336699 } /* Name.Variable.Class */
.highlight .vg { color: #dd7700 } /* Name.Variable.Global */
.highlight .vi { color: #3333bb } /* Name.Variable.Instance */
.highlight .vm { color: #336699 } /* Name.Variable.Magic */
.highlight .il { color: #0000DD; font-weight: bold } /* Literal.Number.Integer.Long */</style><div class="highlight"><pre><span></span><span class="cm">/*</span>
<span class="cm"> * Copyright (C) 2011, GitHub Inc.</span>
<span class="cm"> * and other copyright owners as documented in the project&#39;s IP log.</span>
<span class="cm"> *</span>
<span class="cm"> * This program and the accompanying materials are made available</span>
<span class="cm"> * under the terms of the Eclipse Distribution License v1.0 which</span>
<span class="cm"> * accompanies this distribution, is reproduced below, and is</span>
<span class="cm"> * available at http://www.eclipse.org/org/documents/edl-v10.php</span>
<span class="cm"> *</span>
<span class="cm"> * All rights reserved.</span>
<span class="cm"> *</span>
<span class="cm"> * Redistribution and use in source and binary forms, with or</span>
<span class="cm"> * without modification, are permitted provided that the following</span>
<span class="cm"> * conditions are met:</span>
<span class="cm"> *</span>
<span class="cm"> * - Redistributions of source code must retain the above copyright</span>
<span class="cm"> *   notice, this list of conditions and the following disclaimer.</span>
<span class="cm"> *</span>
<span class="cm"> * - Redistributions in binary form must reproduce the above</span>
<span class="cm"> *   copyright notice, this list of conditions and the following</span>
<span class="cm"> *   disclaimer in the documentation and/or other materials provided</span>
<span class="cm"> *   with the distribution.</span>
<span class="cm"> *</span>
<span class="cm"> * - Neither the name of the Eclipse Foundation, Inc. nor the</span>
<span class="cm"> *   names of its contributors may be used to endorse or promote</span>
<span class="cm"> *   products derived from this software without specific prior</span>
<span class="cm"> *   written permission.</span>
<span class="cm"> *</span>
<span class="cm"> * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND</span>
<span class="cm"> * CONTRIBUTORS &quot;AS IS&quot; AND ANY EXPRESS OR IMPLIED WARRANTIES,</span>
<span class="cm"> * INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES</span>
<span class="cm"> * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE</span>
<span class="cm"> * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR</span>
<span class="cm"> * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,</span>
<span class="cm"> * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT</span>
<span class="cm"> * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;</span>
<span class="cm"> * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER</span>
<span class="cm"> * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,</span>
<span class="cm"> * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)</span>
<span class="cm"> * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF</span>
<span class="cm"> * ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.</span>
<span class="cm"> */</span>
<span class="kn">package</span><span class="w"> </span><span class="nn">org.eclipse.jgit.api</span><span class="p">;</span>

<span class="kn">import</span><span class="w"> </span><span class="nn">java.io.File</span><span class="p">;</span>
<span class="kn">import</span><span class="w"> </span><span class="nn">java.io.IOException</span><span class="p">;</span>
<span class="kn">import</span><span class="w"> </span><span class="nn">java.text.MessageFormat</span><span class="p">;</span>

<span class="kn">import</span><span class="w"> </span><span class="nn">org.eclipse.jgit.api.errors.GitAPIException</span><span class="p">;</span>
<span class="kn">import</span><span class="w"> </span><span class="nn">org.eclipse.jgit.api.errors.JGitInternalException</span><span class="p">;</span>
<span class="kn">import</span><span class="w"> </span><span class="nn">org.eclipse.jgit.api.errors.NoFilepatternException</span><span class="p">;</span>
<span class="kn">import</span><span class="w"> </span><span class="nn">org.eclipse.jgit.errors.ConfigInvalidException</span><span class="p">;</span>
<span class="kn">import</span><span class="w"> </span><span class="nn">org.eclipse.jgit.internal.JGitText</span><span class="p">;</span>
<span class="kn">import</span><span class="w"> </span><span class="nn">org.eclipse.jgit.internal.submodule.SubmoduleValidator</span><span class="p">;</span>
<span class="kn">import</span><span class="w"> </span><span class="nn">org.eclipse.jgit.lib.ConfigConstants</span><span class="p">;</span>
<span class="kn">import</span><span class="w"> </span><span class="nn">org.eclipse.jgit.lib.Constants</span><span class="p">;</span>
<span class="kn">import</span><span class="w"> </span><span class="nn">org.eclipse.jgit.lib.NullProgressMonitor</span><span class="p">;</span>
<span class="kn">import</span><span class="w"> </span><span class="nn">org.eclipse.jgit.lib.ProgressMonitor</span><span class="p">;</span>
<span class="kn">import</span><span class="w"> </span><span class="nn">org.eclipse.jgit.lib.Repository</span><span class="p">;</span>
<span class="kn">import</span><span class="w"> </span><span class="nn">org.eclipse.jgit.lib.StoredConfig</span><span class="p">;</span>
<span class="kn">import</span><span class="w"> </span><span class="nn">org.eclipse.jgit.storage.file.FileBasedConfig</span><span class="p">;</span>
<span class="kn">import</span><span class="w"> </span><span class="nn">org.eclipse.jgit.submodule.SubmoduleWalk</span><span class="p">;</span>
<span class="kn">import</span><span class="w"> </span><span class="nn">org.eclipse.jgit.treewalk.filter.PathFilter</span><span class="p">;</span>
<span class="kn">import</span><span class="w"> </span><span class="nn">org.eclipse.jgit.treewalk.filter.TreeFilter</span><span class="p">;</span>

<span class="cm">/**</span>
<span class="cm"> * A class used to execute a submodule add command.</span>
<span class="cm"> *</span>
<span class="cm"> * This will clone the configured submodule, register the submodule in the</span>
<span class="cm"> * .gitmodules file and the repository config file, and also add the submodule</span>
<span class="cm"> * and .gitmodules file to the index.</span>
<span class="cm"> *</span>
<span class="cm"> * @see &lt;a href=</span>
<span class="cm"> *      &quot;http://www.kernel.org/pub/software/scm/git/docs/git-submodule.html&quot;</span>
<span class="cm"> *      &gt;Git documentation about submodules&lt;/a&gt;</span>
<span class="cm"> */</span>
<span class="kd">public</span><span class="w"> </span><span class="kd">class</span> <span class="nc">SubmoduleAddCommand</span><span class="w"> </span><span class="kd">extends</span>
<span class="w">		</span><span class="n">TransportCommand</span><span class="o">&lt;</span><span class="n">SubmoduleAddCommand</span><span class="p">,</span><span class="w"> </span><span class="n">Repository</span><span class="o">&gt;</span><span class="w"> </span><span class="p">{</span>

<span class="w">	</span><span class="kd">private</span><span class="w"> </span><span class="n">String</span><span class="w"> </span><span class="n">path</span><span class="p">;</span>

<span class="w">	</span><span class="kd">private</span><span class="w"> </span><span class="n">String</span><span class="w"> </span><span class="n">uri</span><span class="p">;</span>

<span class="w">	</span><span class="kd">private</span><span class="w"> </span><span class="n">ProgressMonitor</span><span class="w"> </span><span class="n">monitor</span><span class="p">;</span>

<span class="w">	</span><span class="cm">/**</span>
<span class="cm">	 * Constructor for SubmoduleAddCommand.</span>
<span class="cm">	 *</span>
<span class="cm">	 * @param repo</span>
<span class="cm">	 *            a {@link org.eclipse.jgit.lib.Repository} object.</span>
<span class="cm">	 */</span>
<span class="w">	</span><span class="kd">public</span><span class="w"> </span><span class="nf">SubmoduleAddCommand</span><span class="p">(</span><span class="n">Repository</span><span class="w"> </span><span class="n">repo</span><span class="p">)</span><span class="w"> </span><span class="p">{</span>
<span class="w">		</span><span class="kd">super</span><span class="p">(</span><span class="n">repo</span><span class="p">);</span>
<span class="w">	</span><span class="p">}</span>

<span class="w">	</span><span class="cm">/**</span>
<span class="cm">	 * Set repository-relative path of submodule</span>
<span class="cm">	 *</span>
<span class="cm">	 * @param path</span>
<span class="cm">	 *            (with &lt;code&gt;/&lt;/code&gt; as separator)</span>
<span class="cm">	 * @return this command</span>
<span class="cm">	 */</span>
<span class="w">	</span><span class="kd">public</span><span class="w"> </span><span class="n">SubmoduleAddCommand</span><span class="w"> </span><span class="nf">setPath</span><span class="p">(</span><span class="n">String</span><span class="w"> </span><span class="n">path</span><span class="p">)</span><span class="w"> </span><span class="p">{</span>
<span class="w">		</span><span class="k">this</span><span class="p">.</span><span class="na">path</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">path</span><span class="p">;</span>
<span class="w">		</span><span class="k">return</span><span class="w"> </span><span class="k">this</span><span class="p">;</span>
<span class="w">	</span><span class="p">}</span>

<span class="w">	</span><span class="cm">/**</span>
<span class="cm">	 * Set URI to clone submodule from</span>
<span class="cm">	 *</span>
<span class="cm">	 * @param uri</span>
<span class="cm">	 *            a {@link java.lang.String} object.</span>
<span class="cm">	 * @return this command</span>
<span class="cm">	 */</span>
<span class="w">	</span><span class="kd">public</span><span class="w"> </span><span class="n">SubmoduleAddCommand</span><span class="w"> </span><span class="nf">setURI</span><span class="p">(</span><span class="n">String</span><span class="w"> </span><span class="n">uri</span><span class="p">)</span><span class="w"> </span><span class="p">{</span>
<span class="w">		</span><span class="k">this</span><span class="p">.</span><span class="na">uri</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">uri</span><span class="p">;</span>
<span class="w">		</span><span class="k">return</span><span class="w"> </span><span class="k">this</span><span class="p">;</span>
<span class="w">	</span><span class="p">}</span>

<span class="w">	</span><span class="cm">/**</span>
<span class="cm">	 * The progress monitor associated with the clone operation. By default,</span>
<span class="cm">	 * this is set to &lt;code&gt;NullProgressMonitor&lt;/code&gt;</span>
<span class="cm">	 *</span>
<span class="cm">	 * @see NullProgressMonitor</span>
<span class="cm">	 * @param monitor</span>
<span class="cm">	 *            a {@link org.eclipse.jgit.lib.ProgressMonitor} object.</span>
<span class="cm">	 * @return this command</span>
<span class="cm">	 */</span>
<span class="w">	</span><span class="kd">public</span><span class="w"> </span><span class="n">SubmoduleAddCommand</span><span class="w"> </span><span class="nf">setProgressMonitor</span><span class="p">(</span><span class="n">ProgressMonitor</span><span class="w"> </span><span class="n">monitor</span><span class="p">)</span><span class="w"> </span><span class="p">{</span>
<span class="w">		</span><span class="k">this</span><span class="p">.</span><span class="na">monitor</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">monitor</span><span class="p">;</span>
<span class="w">		</span><span class="k">return</span><span class="w"> </span><span class="k">this</span><span class="p">;</span>
<span class="w">	</span><span class="p">}</span>

<span class="w">	</span><span class="cm">/**</span>
<span class="cm">	 * Is the configured already a submodule in the index?</span>
<span class="cm">	 *</span>
<span class="cm">	 * @return true if submodule exists in index, false otherwise</span>
<span class="cm">	 * @throws java.io.IOException</span>
<span class="cm">	 */</span>
<span class="w">	</span><span class="kd">protected</span><span class="w"> </span><span class="kt">boolean</span><span class="w"> </span><span class="nf">submoduleExists</span><span class="p">()</span><span class="w"> </span><span class="kd">throws</span><span class="w"> </span><span class="n">IOException</span><span class="w"> </span><span class="p">{</span>
<span class="w">		</span><span class="n">TreeFilter</span><span class="w"> </span><span class="n">filter</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">PathFilter</span><span class="p">.</span><span class="na">create</span><span class="p">(</span><span class="n">path</span><span class="p">);</span>
<span class="w">		</span><span class="k">try</span><span class="w"> </span><span class="p">(</span><span class="n">SubmoduleWalk</span><span class="w"> </span><span class="n">w</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">SubmoduleWalk</span><span class="p">.</span><span class="na">forIndex</span><span class="p">(</span><span class="n">repo</span><span class="p">))</span><span class="w"> </span><span class="p">{</span>
<span class="w">			</span><span class="k">return</span><span class="w"> </span><span class="n">w</span><span class="p">.</span><span class="na">setFilter</span><span class="p">(</span><span class="n">filter</span><span class="p">).</span><span class="na">next</span><span class="p">();</span>
<span class="w">		</span><span class="p">}</span>
<span class="w">	</span><span class="p">}</span>

<span class="w">	</span><span class="cm">/**</span>
<span class="cm">	 * {@inheritDoc}</span>
<span class="cm">	 * &lt;p&gt;</span>
<span class="cm">	 * Executes the {@code SubmoduleAddCommand}</span>
<span class="cm">	 *</span>
<span class="cm">	 * The {@code Repository} instance returned by this command needs to be</span>
<span class="cm">	 * closed by the caller to free resources held by the {@code Repository}</span>
<span class="cm">	 * instance. It is recommended to call this method as soon as you don&#39;t need</span>
<span class="cm">	 * a reference to this {@code Repository} instance anymore.</span>
<span class="cm">	 */</span>
<span class="w">	</span><span class="nd">@Override</span>
<span class="w">	</span><span class="kd">public</span><span class="w"> </span><span class="n">Repository</span><span class="w"> </span><span class="nf">call</span><span class="p">()</span><span class="w"> </span><span class="kd">throws</span><span class="w"> </span><span class="n">GitAPIException</span><span class="w"> </span><span class="p">{</span>
<span class="w">		</span><span class="n">checkCallable</span><span class="p">();</span>
<span class="w">		</span><span class="k">if</span><span class="w"> </span><span class="p">(</span><span class="n">path</span><span class="w"> </span><span class="o">==</span><span class="w"> </span><span class="kc">null</span><span class="w"> </span><span class="o">||</span><span class="w"> </span><span class="n">path</span><span class="p">.</span><span class="na">length</span><span class="p">()</span><span class="w"> </span><span class="o">==</span><span class="w"> </span><span class="mi">0</span><span class="p">)</span>
<span class="w">			</span><span class="k">throw</span><span class="w"> </span><span class="k">new</span><span class="w"> </span><span class="n">IllegalArgumentException</span><span class="p">(</span><span class="n">JGitText</span><span class="p">.</span><span class="na">get</span><span class="p">().</span><span class="na">pathNotConfigured</span><span class="p">);</span>
<span class="w">		</span><span class="k">if</span><span class="w"> </span><span class="p">(</span><span class="n">uri</span><span class="w"> </span><span class="o">==</span><span class="w"> </span><span class="kc">null</span><span class="w"> </span><span class="o">||</span><span class="w"> </span><span class="n">uri</span><span class="p">.</span><span class="na">length</span><span class="p">()</span><span class="w"> </span><span class="o">==</span><span class="w"> </span><span class="mi">0</span><span class="p">)</span>
<span class="w">			</span><span class="k">throw</span><span class="w"> </span><span class="k">new</span><span class="w"> </span><span class="n">IllegalArgumentException</span><span class="p">(</span><span class="n">JGitText</span><span class="p">.</span><span class="na">get</span><span class="p">().</span><span class="na">uriNotConfigured</span><span class="p">);</span>

<span class="w">		</span><span class="k">try</span><span class="w"> </span><span class="p">{</span>
<span class="w">			</span><span class="n">SubmoduleValidator</span><span class="p">.</span><span class="na">assertValidSubmoduleName</span><span class="p">(</span><span class="n">path</span><span class="p">);</span>
<span class="w">			</span><span class="n">SubmoduleValidator</span><span class="p">.</span><span class="na">assertValidSubmodulePath</span><span class="p">(</span><span class="n">path</span><span class="p">);</span>
<span class="w">			</span><span class="n">SubmoduleValidator</span><span class="p">.</span><span class="na">assertValidSubmoduleUri</span><span class="p">(</span><span class="n">uri</span><span class="p">);</span>
<span class="w">		</span><span class="p">}</span><span class="w"> </span><span class="k">catch</span><span class="w"> </span><span class="p">(</span><span class="n">SubmoduleValidator</span><span class="p">.</span><span class="na">SubmoduleValidationException</span><span class="w"> </span><span class="n">e</span><span class="p">)</span><span class="w"> </span><span class="p">{</span>
<span class="w">			</span><span class="k">throw</span><span class="w"> </span><span class="k">new</span><span class="w"> </span><span class="n">IllegalArgumentException</span><span class="p">(</span><span class="n">e</span><span class="p">.</span><span class="na">getMessage</span><span class="p">());</span>
<span class="w">		</span><span class="p">}</span>

<span class="w">		</span><span class="k">try</span><span class="w"> </span><span class="p">{</span>
<span class="w">			</span><span class="k">if</span><span class="w"> </span><span class="p">(</span><span class="n">submoduleExists</span><span class="p">())</span>
<span class="w">				</span><span class="k">throw</span><span class="w"> </span><span class="k">new</span><span class="w"> </span><span class="n">JGitInternalException</span><span class="p">(</span><span class="n">MessageFormat</span><span class="p">.</span><span class="na">format</span><span class="p">(</span>
<span class="w">						</span><span class="n">JGitText</span><span class="p">.</span><span class="na">get</span><span class="p">().</span><span class="na">submoduleExists</span><span class="p">,</span><span class="w"> </span><span class="n">path</span><span class="p">));</span>
<span class="w">		</span><span class="p">}</span><span class="w"> </span><span class="k">catch</span><span class="w"> </span><span class="p">(</span><span class="n">IOException</span><span class="w"> </span><span class="n">e</span><span class="p">)</span><span class="w"> </span><span class="p">{</span>
<span class="w">			</span><span class="k">throw</span><span class="w"> </span><span class="k">new</span><span class="w"> </span><span class="n">JGitInternalException</span><span class="p">(</span><span class="n">e</span><span class="p">.</span><span class="na">getMessage</span><span class="p">(),</span><span class="w"> </span><span class="n">e</span><span class="p">);</span>
<span class="w">		</span><span class="p">}</span>

<span class="w">		</span><span class="kd">final</span><span class="w"> </span><span class="n">String</span><span class="w"> </span><span class="n">resolvedUri</span><span class="p">;</span>
<span class="w">		</span><span class="k">try</span><span class="w"> </span><span class="p">{</span>
<span class="w">			</span><span class="n">resolvedUri</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">SubmoduleWalk</span><span class="p">.</span><span class="na">getSubmoduleRemoteUrl</span><span class="p">(</span><span class="n">repo</span><span class="p">,</span><span class="w"> </span><span class="n">uri</span><span class="p">);</span>
<span class="w">		</span><span class="p">}</span><span class="w"> </span><span class="k">catch</span><span class="w"> </span><span class="p">(</span><span class="n">IOException</span><span class="w"> </span><span class="n">e</span><span class="p">)</span><span class="w"> </span><span class="p">{</span>
<span class="w">			</span><span class="k">throw</span><span class="w"> </span><span class="k">new</span><span class="w"> </span><span class="n">JGitInternalException</span><span class="p">(</span><span class="n">e</span><span class="p">.</span><span class="na">getMessage</span><span class="p">(),</span><span class="w"> </span><span class="n">e</span><span class="p">);</span>
<span class="w">		</span><span class="p">}</span>
<span class="w">		</span><span class="c1">// Clone submodule repository</span>
<span class="w">		</span><span class="n">File</span><span class="w"> </span><span class="n">moduleDirectory</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">SubmoduleWalk</span><span class="p">.</span><span class="na">getSubmoduleDirectory</span><span class="p">(</span><span class="n">repo</span><span class="p">,</span><span class="w"> </span><span class="n">path</span><span class="p">);</span>
<span class="w">		</span><span class="n">CloneCommand</span><span class="w"> </span><span class="n">clone</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">Git</span><span class="p">.</span><span class="na">cloneRepository</span><span class="p">();</span>
<span class="w">		</span><span class="n">configure</span><span class="p">(</span><span class="n">clone</span><span class="p">);</span>
<span class="w">		</span><span class="n">clone</span><span class="p">.</span><span class="na">setDirectory</span><span class="p">(</span><span class="n">moduleDirectory</span><span class="p">);</span>
<span class="w">		</span><span class="n">clone</span><span class="p">.</span><span class="na">setGitDir</span><span class="p">(</span><span class="k">new</span><span class="w"> </span><span class="n">File</span><span class="p">(</span><span class="k">new</span><span class="w"> </span><span class="n">File</span><span class="p">(</span><span class="n">repo</span><span class="p">.</span><span class="na">getDirectory</span><span class="p">(),</span>
<span class="w">				</span><span class="n">Constants</span><span class="p">.</span><span class="na">MODULES</span><span class="p">),</span><span class="w"> </span><span class="n">path</span><span class="p">));</span>
<span class="w">		</span><span class="n">clone</span><span class="p">.</span><span class="na">setURI</span><span class="p">(</span><span class="n">resolvedUri</span><span class="p">);</span>
<span class="w">		</span><span class="k">if</span><span class="w"> </span><span class="p">(</span><span class="n">monitor</span><span class="w"> </span><span class="o">!=</span><span class="w"> </span><span class="kc">null</span><span class="p">)</span>
<span class="w">			</span><span class="n">clone</span><span class="p">.</span><span class="na">setProgressMonitor</span><span class="p">(</span><span class="n">monitor</span><span class="p">);</span>
<span class="w">		</span><span class="n">Repository</span><span class="w"> </span><span class="n">subRepo</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="kc">null</span><span class="p">;</span>
<span class="w">		</span><span class="k">try</span><span class="w"> </span><span class="p">(</span><span class="n">Git</span><span class="w"> </span><span class="n">git</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">clone</span><span class="p">.</span><span class="na">call</span><span class="p">())</span><span class="w"> </span><span class="p">{</span>
<span class="w">			</span><span class="n">subRepo</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">git</span><span class="p">.</span><span class="na">getRepository</span><span class="p">();</span>
<span class="w">			</span><span class="n">subRepo</span><span class="p">.</span><span class="na">incrementOpen</span><span class="p">();</span>
<span class="w">		</span><span class="p">}</span>

<span class="w">		</span><span class="c1">// Save submodule URL to parent repository&#39;s config</span>
<span class="w">		</span><span class="n">StoredConfig</span><span class="w"> </span><span class="n">config</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">repo</span><span class="p">.</span><span class="na">getConfig</span><span class="p">();</span>
<span class="w">		</span><span class="n">config</span><span class="p">.</span><span class="na">setString</span><span class="p">(</span><span class="n">ConfigConstants</span><span class="p">.</span><span class="na">CONFIG_SUBMODULE_SECTION</span><span class="p">,</span><span class="w"> </span><span class="n">path</span><span class="p">,</span>
<span class="w">				</span><span class="n">ConfigConstants</span><span class="p">.</span><span class="na">CONFIG_KEY_URL</span><span class="p">,</span><span class="w"> </span><span class="n">resolvedUri</span><span class="p">);</span>
<span class="w">		</span><span class="k">try</span><span class="w"> </span><span class="p">{</span>
<span class="w">			</span><span class="n">config</span><span class="p">.</span><span class="na">save</span><span class="p">();</span>
<span class="w">		</span><span class="p">}</span><span class="w"> </span><span class="k">catch</span><span class="w"> </span><span class="p">(</span><span class="n">IOException</span><span class="w"> </span><span class="n">e</span><span class="p">)</span><span class="w"> </span><span class="p">{</span>
<span class="w">			</span><span class="k">throw</span><span class="w"> </span><span class="k">new</span><span class="w"> </span><span class="n">JGitInternalException</span><span class="p">(</span><span class="n">e</span><span class="p">.</span><span class="na">getMessage</span><span class="p">(),</span><span class="w"> </span><span class="n">e</span><span class="p">);</span>
<span class="w">		</span><span class="p">}</span>

<span class="w">		</span><span class="c1">// Save path and URL to parent repository&#39;s .gitmodules file</span>
<span class="w">		</span><span class="n">FileBasedConfig</span><span class="w"> </span><span class="n">modulesConfig</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="k">new</span><span class="w"> </span><span class="n">FileBasedConfig</span><span class="p">(</span><span class="k">new</span><span class="w"> </span><span class="n">File</span><span class="p">(</span>
<span class="w">				</span><span class="n">repo</span><span class="p">.</span><span class="na">getWorkTree</span><span class="p">(),</span><span class="w"> </span><span class="n">Constants</span><span class="p">.</span><span class="na">DOT_GIT_MODULES</span><span class="p">),</span><span class="w"> </span><span class="n">repo</span><span class="p">.</span><span class="na">getFS</span><span class="p">());</span>
<span class="w">		</span><span class="k">try</span><span class="w"> </span><span class="p">{</span>
<span class="w">			</span><span class="n">modulesConfig</span><span class="p">.</span><span class="na">load</span><span class="p">();</span>
<span class="w">			</span><span class="n">modulesConfig</span><span class="p">.</span><span class="na">setString</span><span class="p">(</span><span class="n">ConfigConstants</span><span class="p">.</span><span class="na">CONFIG_SUBMODULE_SECTION</span><span class="p">,</span>
<span class="w">					</span><span class="n">path</span><span class="p">,</span><span class="w"> </span><span class="n">ConfigConstants</span><span class="p">.</span><span class="na">CONFIG_KEY_PATH</span><span class="p">,</span><span class="w"> </span><span class="n">path</span><span class="p">);</span>
<span class="w">			</span><span class="n">modulesConfig</span><span class="p">.</span><span class="na">setString</span><span class="p">(</span><span class="n">ConfigConstants</span><span class="p">.</span><span class="na">CONFIG_SUBMODULE_SECTION</span><span class="p">,</span>
<span class="w">					</span><span class="n">path</span><span class="p">,</span><span class="w"> </span><span class="n">ConfigConstants</span><span class="p">.</span><span class="na">CONFIG_KEY_URL</span><span class="p">,</span><span class="w"> </span><span class="n">uri</span><span class="p">);</span>
<span class="w">			</span><span class="n">modulesConfig</span><span class="p">.</span><span class="na">save</span><span class="p">();</span>
<span class="w">		</span><span class="p">}</span><span class="w"> </span><span class="k">catch</span><span class="w"> </span><span class="p">(</span><span class="n">IOException</span><span class="w"> </span><span class="n">e</span><span class="p">)</span><span class="w"> </span><span class="p">{</span>
<span class="w">			</span><span class="k">throw</span><span class="w"> </span><span class="k">new</span><span class="w"> </span><span class="n">JGitInternalException</span><span class="p">(</span><span class="n">e</span><span class="p">.</span><span class="na">getMessage</span><span class="p">(),</span><span class="w"> </span><span class="n">e</span><span class="p">);</span>
<span class="w">		</span><span class="p">}</span><span class="w"> </span><span class="k">catch</span><span class="w"> </span><span class="p">(</span><span class="n">ConfigInvalidException</span><span class="w"> </span><span class="n">e</span><span class="p">)</span><span class="w"> </span><span class="p">{</span>
<span class="w">			</span><span class="k">throw</span><span class="w"> </span><span class="k">new</span><span class="w"> </span><span class="n">JGitInternalException</span><span class="p">(</span><span class="n">e</span><span class="p">.</span><span class="na">getMessage</span><span class="p">(),</span><span class="w"> </span><span class="n">e</span><span class="p">);</span>
<span class="w">		</span><span class="p">}</span>

<span class="w">		</span><span class="n">AddCommand</span><span class="w"> </span><span class="n">add</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="k">new</span><span class="w"> </span><span class="n">AddCommand</span><span class="p">(</span><span class="n">repo</span><span class="p">);</span>
<span class="w">		</span><span class="c1">// Add .gitmodules file to parent repository&#39;s index</span>
<span class="w">		</span><span class="n">add</span><span class="p">.</span><span class="na">addFilepattern</span><span class="p">(</span><span class="n">Constants</span><span class="p">.</span><span class="na">DOT_GIT_MODULES</span><span class="p">);</span>
<span class="w">		</span><span class="c1">// Add submodule directory to parent repository&#39;s index</span>
<span class="w">		</span><span class="n">add</span><span class="p">.</span><span class="na">addFilepattern</span><span class="p">(</span><span class="n">path</span><span class="p">);</span>
<span class="w">		</span><span class="k">try</span><span class="w"> </span><span class="p">{</span>
<span class="w">			</span><span class="n">add</span><span class="p">.</span><span class="na">call</span><span class="p">();</span>
<span class="w">		</span><span class="p">}</span><span class="w"> </span><span class="k">catch</span><span class="w"> </span><span class="p">(</span><span class="n">NoFilepatternException</span><span class="w"> </span><span class="n">e</span><span class="p">)</span><span class="w"> </span><span class="p">{</span>
<span class="w">			</span><span class="k">throw</span><span class="w"> </span><span class="k">new</span><span class="w"> </span><span class="n">JGitInternalException</span><span class="p">(</span><span class="n">e</span><span class="p">.</span><span class="na">getMessage</span><span class="p">(),</span><span class="w"> </span><span class="n">e</span><span class="p">);</span>
<span class="w">		</span><span class="p">}</span>

<span class="w">		</span><span class="k">return</span><span class="w"> </span><span class="n">subRepo</span><span class="p">;</span>
<span class="w">	</span><span class="p">}</span>
<span class="p">}</span>
</pre></div>
</code></pre></td></tr></table>
</div> <!-- class=content -->
<div class='footer'>generated by <a href='https://git.zx2c4.com/cgit/about/'>cgit v1.2.3</a> (<a href='https://git-scm.com/'>git 2.39.1</a>) at 2025-08-15 17:16:14 +0000</div>
</div> <!-- id=cgit -->
</body>
</html>
