Skip to content
Projects
Groups
Snippets
Help
This project
Loading...
Sign in / Register
Toggle navigation
M
mpd
Project
Project
Details
Activity
Cycle Analytics
Repository
Repository
Files
Commits
Branches
Tags
Contributors
Graph
Compare
Charts
Issues
0
Issues
0
List
Board
Labels
Milestones
Merge Requests
0
Merge Requests
0
CI / CD
CI / CD
Pipelines
Jobs
Schedules
Charts
Registry
Registry
Wiki
Wiki
Snippets
Snippets
Members
Members
Collapse sidebar
Close sidebar
Activity
Graph
Charts
Create a new issue
Jobs
Commits
Issue Boards
Open sidebar
Иван Мажукин
mpd
Commits
d125567f
Commit
d125567f
authored
Nov 08, 2013
by
Max Kellermann
Browse files
Options
Browse Files
Download
Email Patches
Plain Diff
doc/developer: add text from the wiki
parent
993eca93
Show whitespace changes
Inline
Side-by-side
Showing
1 changed file
with
64 additions
and
1 deletion
+64
-1
developer.xml
doc/developer.xml
+64
-1
No files found.
doc/developer.xml
View file @
d125567f
...
...
@@ -69,12 +69,28 @@ foo(const char *abc, int xyz)
<title>
Hacking The Source
</title>
<para>
MPD sources are managed in a git repository on
<ulink
url=
"http://git.musicpd.org/"
>
git.musicpd.org
</ulink>
.
</para>
<para>
Always write your code against the latest git:
</para>
<programlisting>
git clone git://git.musicpd.org/master/mpd.git
</programlisting>
<para>
If you already have a clone, update it:
</para>
<programlisting>
git pull --rebase git://git.musicpd.org/master/mpd.git master
</programlisting>
<para>
You can do without "--rebase", but we recommend that you rebase
your repository on the "master" repository all the time.
</para>
<para>
Configure with the options
<option>
--enable-debug
--enable-werror
</option>
. Enable as many plugins as possible,
to be sure that you don't break any disabled code.
...
...
@@ -83,8 +99,55 @@ foo(const char *abc, int xyz)
<para>
Don't mix several changes in one single patch. Create a
separate patch for every change. Tools like
<application>
stgit
</application>
help you with that.
<application>
stgit
</application>
help you with that. This way,
we can review your patches more easily, and we can pick the
patches we like most first.
</para>
<section>
<title>
Basic stgit usage
</title>
<para>
stgit allows you to create a set of patches and refine all of
them: you can go back to any patch at any time, and re-edit it
(both the code and the commit message). You can reorder
patches and insert new patches at any position. It encourages
creating separate patches for tiny changes.
</para>
<para>
stgit needs to be initialized on a git repository: stg init
</para>
<para>
Before you edit the code, create a patch: stg new
my-patch-name (stgit now asks you for the commit message).
</para>
<para>
Now edit the code. Once you're finished, you have to "refresh"
the patch, i.e. your edits are incorporated into the patch you
have created: stg refresh
</para>
<para>
You may now continue editing the same patch, and refresh it as
often as you like. Create more patches, edit and refresh them.
</para>
<para>
To view the list of patches, type stg series. To go back to a
specific patch, type stg goto my-patch-name; now you can
re-edit it (don't forget stg refresh when you're finished with
that patch).
</para>
<para>
When the whole patch series is finished, convert stgit patches
to git commits: stg commit
</para>
</section>
</chapter>
<chapter>
...
...
Write
Preview
Markdown
is supported
0%
Try again
or
attach a new file
Attach a file
Cancel
You are about to add
0
people
to the discussion. Proceed with caution.
Finish editing this message first!
Cancel
Please
register
or
sign in
to comment