emacs-orgmode@gnu.org archives
 help / color / mirror / code / Atom feed
From: Nick Dokos <nicholas.dokos@hp.com>
To: =?utf-8?Q?Fran=C3=A7ois_Pinard?= <pinard@iro.umontreal.ca>
Cc: emacs-orgmode@gnu.org
Subject: Re: Git mirrors
Date: Tue, 22 May 2012 02:58:19 -0400	[thread overview]
Message-ID: <29626.1337669899@alphaville> (raw)
In-Reply-To: Message from =?utf-8?Q?Fran=C3=A7ois_Pinard?= <pinard@iro.umontreal.ca> of "Tue\, 22 May 2012 01\:22\:26 EDT." <86obpgokml.fsf@mercure.progiciels-bpi.ca>

François Pinard <pinard@iro.umontreal.ca> wrote:

> Hi, Org people.
> 
> GitHub has a few niceties, like easy forking, pull requests and such.  I
> notice https://github.com/jwiegley/org-mode in particular, which does
> not seem to be itself a fork of another GitHub repository, so I presume
> it forked directly from the official Git site for Org mode, which itself
> does not provide the same collaboration facilities as GitHub.
> 
> The GitHub home page for John Wiegly says the org-mode project was
> updated two weeks ago, so I suspect it lags on the official Git site.  A
> message on the mailing list speaks of this repository as the home for
> Org-X, so I also suspect this fork is not genuine, and not a way to get
> on GitHub the real, pure, Org mode.
> 

It does not make any difference from where you get it. You can mirror
the org git repo from orgmode.org on github if you want: nothing is
stopping you. Then use the github collaboration tools.

> In the Org project, how commits are usually transmitted?  I would not
> think maintainers are pulling our various repositories in theirs to then
> consider cherry picking, and it would require that we all set up Git
> servers.  We could use GitHub as a way to avoid servers, but it feel
> strange using GitHub to communicate with Org maintainers while they do
> not themselves choose to keep an "official" mirror of Org on GitHub.
> 

That's up to each maintainer: they can apply patches sent as email, or
they can cherry-pick commits from a remote branch if they want.

There is nothing strange about using github to communicate with the
maintainers: set up your clone, create a branch with your modification
and let the maintainers know about it. That's how many linux maintainers
did things while kernel.org was down last year. All that changed for
Linus was that he pulled from a different repo.

OTOH, some maintainers would prefer emailed patches instead; some
wouldn't care one way or the other. If they don't want to touch your
repo, you can't make them, so the best thing to do is ask which is their
preferred method. Or do as Bernt Hansen was doing: submit a patch in
email and also point to a branch that contains that patch (and that
patch alone) on top of a clone of the official git repo. This last
method has the advantage that it tells the maintainer the exact state of
the tree when the patch was applied, which allows problematic merges
to be resolved more easily (see Linus's comments in

 https://plus.google.com/111049168280159033135/posts/Xmycxn7VwHV

for some details - but that's useful mostly for maintainers, not
for patch contributors; otoh, it's always nice to know more than
the absolute minimum necessary.)

> Commits are going to be sent as email apply-able patches?  Maybe this is
> all documented somewhere already, and I just did not read enough?
> 

``Documented'' is probably too strong a word, but once you've been on
the ML for a while, you start discerning the customs of the people
living there: emailed patches is indeed the standard way (not least
because patchwork captures them, so they don't get lost in some old
email thread).

Nick

Disclaimer: I'm not a maintainer, so if I've got things wrong, I hope
one of them will correct me.

  reply	other threads:[~2012-05-22  6:58 UTC|newest]

Thread overview: 3+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2012-05-22  5:22 Git mirrors François Pinard
2012-05-22  6:58 ` Nick Dokos [this message]
2012-05-22 23:08   ` Bastien

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

  List information: https://www.orgmode.org/

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=29626.1337669899@alphaville \
    --to=nicholas.dokos@hp.com \
    --cc=emacs-orgmode@gnu.org \
    --cc=pinard@iro.umontreal.ca \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
Code repositories for project(s) associated with this public inbox

	https://git.savannah.gnu.org/cgit/emacs/org-mode.git

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).