README: explicitly show how to fetch note references

Tweaking fetch references may not be a particularly common activity.

Signed-off-by: W. Trevor King <wking@tremily.us>

README: document borrowed commits and original-repo notes

Signed-off-by: W. Trevor King <wking@tremily.us>

README: document repository branches (roles and contents)

Signed-off-by: W. Trevor King <wking@tremily.us>

Documentation/SubmittingPatches: merge branch 'signed-off-by'

Take my own medicine and merge the signed-off-by branch into the
master.

Signed-off-by: W. Trevor King <wking@tremily.us>

COPYING: merge GPLv2= from the 'copying' branch

Signed-off-by: W. Trevor King <wking@tremily.us>

README: add sales pitch and usage instructions

To avoid licensing issues with this README file itself, I'm releasing
it under the Creative Commons CC0 1.0 Universal license (see the
`license` branch for full text).

Signed-off-by: W. Trevor King <wking@tremily.us>

Update COPYING with GPLv2 with new FSF address

The mailing address of FSF changed quite a while ago.  Also the expansion
of the acronym LGPL (which we don't use) is "Lesser GPL" not "Library GPL"
these days in recent copies of GPLv2.  Update the copy we have with a
fresh download of <http://www.gnu.org/licenses/gpl-2.0.txt>.

This incidentally removes form-feeds in the text we retained for all these
years.

Signed-off-by: Junio C Hamano <gitster@pobox.com>

Add a COPYING notice, making it explicit that the license is GPLv2.

Let's bite the v3 bullet when it comes, although if people want to,
they can just state "or later at discretion of Linus" in their copyright
messages.

SubmittingPatches: adjust content to be project-agnostic

Remove kernel-specific stuff (e.g. maintainers, emailed-patches) and
consolidate things that were treated differently in the kernel and git
versions (e.g. pseudonyms).

The slight-modification paragraph is mostly unchanged.  I just removed
the branch/subsystem maintainer leader and re-wrapped the paragraph.

Signed-off-by: W. Trevor King <wking@tremily.us>

SubmittingPatches: replace tabs with spaces and normalize DCO indent

I replaced each tab with two spaces.  No need for excessive 8-space
indents.

Signed-off-by: W. Trevor King <wking@tremily.us>

remove doubled words, e.g., s/to to/to/, and fix related typos

I found that some doubled words had snuck back into projects from which
I'd already removed them, so now there's a "syntax-check" makefile rule in
gnulib to help prevent recurrence.

Running the command below spotted a few in git, too:

  git ls-files | xargs perl -0777 -n \
    -e 'while (/\b(then?|[iao]n|i[fst]|but|f?or|at|and|[dt])\s+\1\b/gims)' \
    -e '{$n=($` =~ tr/\n/\n/ + 1); ($v=$&)=~s/\n/\\n/g;' \
    -e 'print "$ARGV:$n:$v\n"}'

Signed-off-by: Jim Meyering <meyering@redhat.com>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
[wking@tremily.us: only apply SubmittingPatches portion of the
original patch since I'm pulling out only the D-C-O portion of
SubmittingPatches]
Signed-off-by: W. Trevor King <wking@tremily.us>

SubmittingPatches: Document some extra tags used in commit messages

Document the meanings of the tags "Reported-by:", "Acked-by:",
"Reviewed-by:" and "Tested-by:" clearly. Also mention that the user is
free to use any custom tags.

Helped-by: Jonathan Nieder <jrnieder@gmail.com>
Liked-by: Sverre Rabbelier <srabbelier@gmail.com>
Signed-off-by: Ramkumar Ramachandra <artagnon@gmail.com>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
[wking@tremily.us: removed diff context to merge with Linux kernel
version]
Signed-off-by: W. Trevor King <wking@tremily.us>

SubmittingPatches: mention the usage of real name in Signed-off-by: lines

Especially with something that is supposed to hopefully have some legal
value down the line if somebody starts making noises, it really would be
nice to have a real person to associate things with. Suggest this in the
SubmittingPatches document.

Signed-off-by: Miklos Vajna <vmiklos@frugalware.org>
Signed-off-by: Junio C Hamano <gitster@pobox.com>

Documentation/SubmittingPatches: What's Acked-by and Tested-by?

We used to talk about "internal company procedures", but this
document is about submitting patches to the git mailing list.

More useful information is when to say Acked-by: and Tested-by:.

Signed-off-by: Junio C Hamano <gitster@pobox.com>
[wking@tremily.us: removed diff context to merge with Linux kernel
version]
Signed-off-by: W. Trevor King <wking@tremily.us>

Teach SubmittingPatches about git-commit -s

As discussed on git mailing list let's teach the reader about
the possiblity to have automatically signed off the commit running
the git-commit -s command

Signed-off-by: Paolo Ciarrocchi <paolo.ciarrocchi@gmail.com>
Signed-off-by: Junio C Hamano <junkio@cox.net>
[wking@tremily.us: removed diff context to merge with Linux kernel
version]
Signed-off-by: W. Trevor King <wking@tremily.us>

Documentation: fix spelling error in SubmittingPatches

Fixed a spelling error.

Signed-off-by: Zac Storer <zac.3.14159@gmail.com>
Signed-off-by: Randy Dunlap <rdunlap@xenotime.net>
Signed-off-by: Linus Torvalds <torvalds@linux-foundation.org>

doc: add suggestions about good practises for maintainers

Suggest how to deal with patch modifications caused by
merging or back-porting when you're a maintainer.

Signed-off-by: Willy Tarreau <w@1wt.eu>
Signed-off-by: Linus Torvalds <torvalds@linux-foundation.org>
[wking@tremily.us: removed diff context since I'm pulling out only the
D-C-O portion of SubmittingPatches]
Signed-off-by: W. Trevor King <wking@tremily.us>

We can not allow anonymous contributions to the kernel

The DCO does not mean anything if we allow anonymous contributors to the
kernel.  As this is an open source project, we need to do everything in the
open.

Signed-off-by: Greg Kroah-Hartman <gregkh@suse.de>
Signed-off-by: Andrew Morton <akpm@osdl.org>
Signed-off-by: Linus Torvalds <torvalds@osdl.org>

DCO: use IANA-reserved second level domain name

Signed-off-by: Alexey Dobriyan <adobriyan@gmail.com>
Signed-off-by: Domen Puncer <domen@coderock.org>
Signed-off-by: Andrew Morton <akpm@osdl.org>
Signed-off-by: Linus Torvalds <torvalds@osdl.org>

Update DCO ("signoff") rules to 1.1

This adds a clause that notes explicitly that the person doing the
sign-off knows that the project (and his sign-off) is public and will
possibly get archived and re-distributed.

Start documenting the sign-off procedure in SubmittingPatches

We already have over 200 sign-off lines in the kernel, so
let's document the thing, even if discussion may still be
on-going.

[wking@tremily.us: removed diff context since I'm pulling out only the
D-C-O portion of SubmittingPatches]
Signed-off-by: W. Trevor King <wking@tremily.us>