Repository navigation
Expand file tree
/
Copy pathmagithub.texi
More file actions
163 lines (125 loc) · 5.49 KB
/
Copy pathmagithub.texi
File metadata and controls
163 lines (125 loc) · 5.49 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
\input texinfo.tex @c -*-texinfo-*-
@c %**start of header
@setfilename magithub.info
@settitle Magithub User Manual
@documentencoding utf-8
@c %**end of header
@dircategory Emacs
@direntry
* Magithub: (magithub). Using GitHub from Emacs with Magit.
@end direntry
@copying
Copyright @copyright{} 2010 Nathan Weizenbaum
@quotation
Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.2 or
any later version published by the Free Software Foundation; with no
Invariant Sections, with no Front-Cover Texts, and with no Back-Cover
Texts.
@end quotation
@end copying
@node Top
@top Magithub User Manual
Magithub is an Emacs interface for GitHub
built on top of the Magit interface to Git.
@menu
* Introduction::
* New Repositories::
* Existing Repositories::
* GitHub Network::
* GitHub Website::
@end menu
@node Introduction
@chapter Introduction
Magithub extends Magit by adding functionality specific to GitHub.
It adds commands for creating and forking GitHub repositories,
tracking forks on GitHub, sending pull requests,
and using the @url{http://gist.github.com, Gist} paste site.
It also provides a strong basis for further Emacs interaction with GitHub.
This manual covers all the user-facing features of Magithub,
which are mostly in the form of additional commands
added to the @code{magit-status} buffer.
It assumes familiarity with Git and GitHub,
and at least some familiarity with Magit.
All Magithub commands accessible in the status buffer
begin with the prefix @kbd{'} (single quote)
to avoid conflicting with built-in Magit commands.
Just as in Magit, these commands will be available in all @code{magit-mode} buffers,
but may not necessarily make sense in all contexts.
@node New Repositories
@chapter New Repositories
@section GitHub Repositories
To push the current Git repository to a new GitHub repository, type @kbd{' C}.
This will prompt for various bits of information (name, description, homepage),
create the GitHub repository, and push.
Once the GitHub repository has been created,
Magithub will make it the default remote repository.
By default, the new GitHub repository is public.
With a prefix arg, it will be private instead.
@section Gists
You can also push the current Git repository
as a @url{http://gist.github.com, Gist} by typing @kbd{' g},
since Gists are just Git repositories.
When a Gist is created, the URL is copied to the kill ring
and it's opened in the browser.
You can disable the latter by setting @code{magithub-view-gist} to @code{nil}.
Magithub does not support pasting snippets of files to Gist.
For that, @url{http://github.com/defunkt/gist.el, gist.el} is more appropriate.
@node Existing Repositories
@chapter Existing Repositories
@section Cloning
You can clone a GitHub repository by typing @kbd{' c}.
This will prompt for the repository to clone (of the form @code{USERNAME/REPONAME})
and the location of the repository,
then clone it and bring up the new Magit status buffer.
With a prefix argument, it will clone from the private URL
(e.g. @code{git@@github.com:nex3/magit.git}
rather than @code{http://github.com/nex3/magit.git}).
You can also clone a GitHub repository outside of the status buffer
by typing @kbd{M-x magithub-clone}.
By default, this isn't bound to a key,
but if you make a lot of clones you might want to bind it.
You can toggle between the private URL and the public URL using @kbd{' S}.
@section Forking
Once you've checked out a GitHub repository, you can fork it by typing @kbd{' f}.
This will create a fork on GitHub and set that fork up as the default remote repository.
@node GitHub Network
@chapter GitHub Network
@section Tracking
You can track a user's fork of your repository by typing @kbd{' t}
and providing the user's name, and the name of the repository
if it's different than your repository's name.
This adds a remote named after the user tracking their fork.
With a prefix argument, it fetches the remote as well.
@node GitHub Website
@chapter GitHub Website
Most Magit and Magithub buffers have direct parallels on the GitHub website.
Magithub makes these all available by typing @kbd{' b}
(or @kbd{C-c ' b} in non-Magit buffers; @pxref{Other Browsable Buffers}).
This opens the relevant GitHub page in your browser using @code{browse-url}
and copies the URL to the kill ring.
@section Browsable Magit Buffers
Typing @kbd{' b} when the point is on a commit
in a log or status buffer will show that commit on GitHub.
Otherwise, browsing the Magit status buffer
will show the main page for the GitHub repo
on the current HEAD.
Typing @kbd{' b} in a commit buffer will also show that commit on GitHub.
If the point is on a particular section of the commit diff,
the browser will open to that section.
Typing @kbd{' b} in a diff buffer will show the corresponding compare page on GitHub.
Like commits, if the point is on a particular section of the diff,
the browser will open to that section.
@node Other Browsable Buffers
@section Other Browsable Buffers
Magithub includes a minor mode that allows it to provide commands
in buffers for files that are checked in to git.
Like in Magit buffers, all Magithub commands are under a single namespace.
In normal files, this is @kbd{C-c '}.
Currently the only command in Magithub minor mode is @code{magithub-browse-file},
which can be run by typing @kbd{C-c ' b}.
This opens the current file in the browser,
to the place where the point is.
If @code{transient-mark-mode} is active,
the highlighted region will also be highlighted on the web page.
@bye