summaryrefslogtreecommitdiff
path: root/Software/libcdr.mdwn
diff options
context:
space:
mode:
authorDavidTardon <DavidTardon@web>2013-09-03 11:43:54 (GMT)
committerwww <iki-www@freedesktop.org>2013-09-03 11:43:54 (GMT)
commit334e8aaa4e3dfbf2705a21bdb9e20d76f6f143dd (patch)
tree2dc8313883e4b5377404517085d15712a56c8b74 /Software/libcdr.mdwn
parent8a33065abb3045abb64d3c483304e3969b352ea8 (diff)
add gerrit as a preferred way to contribute patches
Diffstat (limited to 'Software/libcdr.mdwn')
-rw-r--r--Software/libcdr.mdwn42
1 files changed, 39 insertions, 3 deletions
diff --git a/Software/libcdr.mdwn b/Software/libcdr.mdwn
index 2d51fb3..de8380a 100644
--- a/Software/libcdr.mdwn
+++ b/Software/libcdr.mdwn
@@ -45,13 +45,49 @@ make install
## Contributing
-Once you have done a change that you are happy with, and that builds with libcdr, contribute it back, we'll be happy to integrate it! Do:
+Once you have done a change that you are happy with, and that builds with libcdr, contribute it back, we'll be happy to integrate it!
+There are two ways to get your contribution to us:
+
+1. submitting it to gerrit (preferred, easier if you already have
+ done the initial setup)
+1. sending a patch
+
+Both methods require that you commit the changes to your local
+repository first:
[[!format txt """
-# commit your changes to your local repository
git commit -a
-# create the patch
+"""]]
+The submission differs by method and is discussed in the following
+sections.
+
+### Gerrit
+This section draws heavily on documentation for libreoffice.
+
+You need to have an account in [[libreoffice
+gerrit|https://gerrit.libreoffice.org/]]. How to do that is discussed in
+length
+[[here|https://wiki.documentfoundation.org/Development/gerrit/setup]]
+(the logerrit tool is in libreoffice repo, but the manual way works).
+After you have done that, you are ready to push your change(s). How to
+do that manually is described
+ [[here|https://wiki.documentfoundation.org/Development/gerrit/SubmitPatch]].
+ Alternatively, there is a tool called
+ [[git-review|https://wiki.documentfoundation.org/Development/GitReview]]
+ that makes it (IMHO) much easier.
+
+As an example, if you are using
+[[git-review|https://wiki.documentfoundation.org/Development/GitReview]],
+you submit you change(s) with plain
+[[!format txt """
+git review
+"""]]
+
+### Sending patches
+[[!format txt """
git format-patch origin/master
"""]]
+will create one or more patch files. You can send these to
+[[libreoffice@lists.freedesktop.org|mailto:libreoffice@lists.freedesktop.org]] .
# Contact