Urls and a bit of code

Author: ben

en/book/10-git-in-other-environments/chapter10.asc

@@ -27,9 +27,10 @@ This is the tool to use when you're trying to find something that happened in th
 Gitk is easiest to invoke from the command-line.
 Just `cd` into a Git repository, and type:
 
------
+[source,shell]
+----
 $ gitk [git log options]
------
+----
 
 Gitk accepts many command-line options, most of which are passed through to the underlying `git log` action.
 Probably one of the most useful is the `--all` flag, which tells gitk to show commits reachable from _any_ ref, not just HEAD.
@@ -39,14 +40,15 @@ Gitk's interface looks like <<gitk>>.
 .The `gitk` history viewer.
 image::images/gitk.png[The `gitk` history viewer.]
 
-On the top is something that looks a bit like the output of `git log --graph`; each dot represents a commit, and the graph is decorated with refs.
+On the top is something that looks a bit like the output of `git log --graph`; each dot represents a commit, the lines represent parent relationships, and refs are shown as colored boxes.
 The yellow dot represents HEAD, and the red dot represents changes that are yet to become a commit.
 At the bottom is a view of the selected commit; the comments and patch on the left, and a summary view on the right.
 In between is a collection of controls used for searching history.
 
 `git-gui`, on the other hand, is primarily a tool for crafting commits.
 It, too, is easiest to invoke from the command line:
 
+[source,shell]
 -----
 $ git gui
 -----
@@ -69,11 +71,9 @@ Then you can simply stage or unstage some changes, alter the commit message, and
 
 +gitk+ and +git-gui+ are examples of task-oriented tools.
 Each of them is tailored for a specific purpose (viewing history and creating commits, respectively), and omit the features not necessary for that task.
-There are several other graphical tools in this category, such as TODO.
-
-==== GitHub Desktop
 
 
+==== GitHub Desktop
 
 [[github_win]]
 .GitHub for Windows.
@@ -202,11 +202,19 @@ Libgit2 is a dependency-free implementation of Git, with a focus on having a nic
 
 Here's what it looks like to read HEAD's commit message with Libgit2:
 
+[source,c]
 -----
-// TODO
+git_repository *repo;
+int error = git_repository_open(&repo, "/path/to/repository");
+
+git_object *head_commit;
+error = git_revparse_single(&head_commit, repo, "HEAD^{commit}");
+
+git_commit *commit = (git_commit*)head_commit;
+printf("%s", git_commit_message);
 -----
 
-Of course, it isn't very probably that you'll want to write C when using Libgit2.
+Of course, it isn't very probable that you'll want to write C when using Libgit2.
 Fortunately, there are a number of language-specific bindings available that make it fairly easy to work with Git repositories from your specific language and environment.
 
 ===== LibGit2Sharp
@@ -215,8 +223,9 @@ If you're writing a .NET or Mono application, LibGit2Sharp (http://libgit2sharp.
 The bindings are written in C#, and great care has been taken to wrap the raw Libgit2 calls with native-feeling CLR APIs.
 Here's what it looks like to read HEAD's commit message:
 
+[source,csharp]
 -----
-// TODO
+new Repository(@"C:\path\to\repo").Head.Tip.Message;
 -----
 
 For desktop Windows applications, there's a NuGet package that will help you get started quickly.
@@ -228,17 +237,32 @@ If your application is running on an Apple platform, you're likely using Objecti
 Objective-Git (TODO: URL) is the name of the Libgit2 bindings for that environment.
 Again, here's how to read HEAD's commit message:
 
+[source,objc]
 -----
 // TODO
 -----
 
 ===== rugged
 
-For Ruby programs, Rugged (TODO: URL) is the library to use.
+For Ruby programs, Rugged (https://github.com/libgit2/rugged[]) is the library to use.
+Once again, HEAD's commit message:
+
+[source,ruby]
+----
+# TODO
+----
+
 
 ===== pygit2
 
-The bindings for Libgit2 in Python are called Pygit2, and can be found at (TODO: URL).
+The bindings for Libgit2 in Python are called Pygit2, and can be found at http://www.pygit2.org/[].
+As always, HEAD's commit message:
+
+[source,python]
+----
+# TODO
+----
+
 
 ===== Others