/[gentoo]/xml/htdocs/proj/en/overlays/devguide.xml
Gentoo

Diff of /xml/htdocs/proj/en/overlays/devguide.xml

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

Revision 1.7 Revision 1.10
219<body> 219<body>
220<p>If your project overlay is called 'foo', your Trac wiki site will be 220<p>If your project overlay is called 'foo', your Trac wiki site will be
221here: http://overlays.gentoo.org/proj/foo/</p> 221here: http://overlays.gentoo.org/proj/foo/</p>
222 222
223<p>To checkout your Subversion repository, use:</p> 223<p>To checkout your Subversion repository, use:</p>
224<pre caption="Checkout your project overlay">svn co http://overlays.gentoo.org/svn/proj/foo/</pre> 224<pre caption="Checkout your project overlay">svn co https://overlays.gentoo.org/svn/proj/foo/</pre>
225
226<p>While you may perform read-only actions via unsecure HTTP, you must perform
227all commits via HTTPS. If you need to switch between modes, use:</p>
228<pre caption="Switching your project overlay from HTTP to HTTPS">svn sw --relocate http://overlays.gentoo.org/svn/proj/foo/ https://overlays.gentoo.org/svn/proj/foo/</pre>
225 229
226<p>We maintain <uri link="http://overlays.gentoo.org/proj/">a full list of project overlays hosted on overlays.gentoo.org</uri>.</p> 230<p>We maintain <uri link="http://overlays.gentoo.org/proj/">a full list of project overlays hosted on overlays.gentoo.org</uri>.</p>
227</body> 231</body>
228</section> 232</section>
229 233
232<body> 236<body>
233<p>If your Gentoo email address is 'foo@gentoo.org', your Trac wiki site will be 237<p>If your Gentoo email address is 'foo@gentoo.org', your Trac wiki site will be
234here: http://overlays.gentoo.org/dev/foo/</p> 238here: http://overlays.gentoo.org/dev/foo/</p>
235 239
236<p>To checkout your Subversion repository, use:</p> 240<p>To checkout your Subversion repository, use:</p>
237<pre caption="Checkout your developer overlay">svn co http://overlays.gentoo.org/svn/dev/foo/</pre> 241<pre caption="Checkout your developer overlay">svn co https://overlays.gentoo.org/svn/dev/foo/</pre>
242
243<p>While you may perform read-only actions via unsecure HTTP, you must perform
244all commits via HTTPS. If you need to switch between modes, use:</p>
245<pre caption="Switching your developer overlay from HTTP to HTTPS">svn sw --relocate http://overlays.gentoo.org/svn/dev/foo/ https://overlays.gentoo.org/svn/dev/foo/</pre>
238 246
239<p>We maintain <uri link="http://overlays.gentoo.org/dev/">a full list of developer overlays hosted on overlays.gentoo.org</uri>.</p> 247<p>We maintain <uri link="http://overlays.gentoo.org/dev/">a full list of developer overlays hosted on overlays.gentoo.org</uri>.</p>
240</body> 248</body>
241</section> 249</section>
242 250
277<p>Your overlay comes with <uri link="http://subversion.tigris.org">Subversion</uri>, a modern alternative to CVS. The advantages of Subversion over CVS include real versioning of directories, full changeset support, and it's much easier to do branching if you need to. The main disadvantage of Subversion is that it is slower than CVS, and that a local Subversion checkout requires more disk space.</p> 285<p>Your overlay comes with <uri link="http://subversion.tigris.org">Subversion</uri>, a modern alternative to CVS. The advantages of Subversion over CVS include real versioning of directories, full changeset support, and it's much easier to do branching if you need to. The main disadvantage of Subversion is that it is slower than CVS, and that a local Subversion checkout requires more disk space.</p>
278 286
279<p>If you have never used Subversion before, the <uri link="http://svnbook.red-bean.com/">online book</uri> is an excellent way to learn Subversion. You can buy it in dead-tree format too if you prefer.</p> 287<p>If you have never used Subversion before, the <uri link="http://svnbook.red-bean.com/">online book</uri> is an excellent way to learn Subversion. You can buy it in dead-tree format too if you prefer.</p>
280 288
281<p>Here are some basic commands to get you started.</p> 289<p>Here are some basic commands to get you started.</p>
282<pre caption="Checking out your overlay">svn co http://overlays.gentoo.org/proj/php</pre> 290<pre caption="Checking out your overlay">svn co https://overlays.gentoo.org/proj/php</pre>
283<pre caption="Seeing which files need committing">svn status</pre> 291<pre caption="Seeing which files need committing">svn status</pre>
284<pre caption="Adding files to your overlay">svn add my.ebuild</pre> 292<pre caption="Adding files to your overlay">svn add my.ebuild</pre>
285<pre caption="Committing your changes">svn commit -m 'My changelog entry'</pre> 293<pre caption="Committing your changes">svn commit -m 'My changelog entry'</pre>
286 294
287</body> 295</body>
309<p>You need to make sure that the changes made in Portage aren't lost the next 317<p>You need to make sure that the changes made in Portage aren't lost the next
310time you copy your packages from your overlay back into Portage.</p> 318time you copy your packages from your overlay back into Portage.</p>
311 319
312<p>The PHP team have solved this problem by automatically copying their packages 320<p>The PHP team have solved this problem by automatically copying their packages
313from Portage back into a 'portage' branch of their overlay every night. They 321from Portage back into a 'portage' branch of their overlay every night. They
314can then use Subversion (or Trac's timeline) to see what has changed every 322can then use Subversion (or Trac's timeline) to see what has changed every day.</p>
315day. If you'd like to have this feature added to your overlay, contact CHTEKK.</p>
316 323
324</body>
325</section>
326</chapter>
327
328<chapter>
329<title>Using git on overlays</title>
330
331<section>
332<title>Setting up git for committing with webdav</title>
333<body>
334<pre caption="add to your ~/.netrc">
335machine overlays.gentoo.org
336login (your-username)
337password (your-password)
338</pre>
339<p>Source: http://www.kernel.org/pub/software/scm/git/docs/howto/setup-git-server-over-http.txt</p>
340</body>
341</section>
342<section>
343<title>Initializing your overlay</title>
344<body>
345<p>Before uploading you need to locally create a git repository and add all items:</p>
346<pre caption="go to your overlay">cd ~/my-overlay</pre>
347<pre caption="create a new git repo">git init
348git add .
349git commit -m "populate overlay"</pre>
350<p>Note that this commit was only locally, now we get the server into the game. Be sure to add the trailing /</p>
351<pre caption="tell git the url">git-config remote.upload.url http://(your-username)@overlays.gentoo.org/git/(proj or dev)/(name)/</pre>
352<pre caption="finally get it up there">git push upload master</pre>
353<p>Source: http://www.kernel.org/pub/software/scm/git/docs/tutorial.html</p>
354</body></section>
355
356<section>
357<title>Checking out the overlay with git</title>
358<body>
359<pre caption="clone it!">git clone http://overlays.gentoo.org/git/(proj or dev)/(name)/</pre>
317</body> 360</body>
318</section> 361</section>
319</chapter> 362</chapter>
320 363
321<chapter> 364<chapter>

Legend:
Removed from v.1.7  
changed lines
  Added in v.1.10

  ViewVC Help
Powered by ViewVC 1.1.20