doc: re-add CodingStyle and SubmittingPatches

Those files got moved to Documentation/process, but as they're very
well known files, add pointers to their new locations.

PS.: I opted to not merge th

doc: re-add CodingStyle and SubmittingPatches

Those files got moved to Documentation/process, but as they're very
well known files, add pointers to their new locations.

PS.: I opted to not merge this patch with the previous one
in order to make the diff of the previous one more consistent,
as it will show only renames.

Signed-off-by: Mauro Carvalho Chehab <[email protected]>

show more ...

docs: rename development-process/ to process/

As we'll type this a lot, after adding CodingStyle & friends,
let's rename the directory name to a shorter one.

Signed-off-by: Mauro Carvalho Chehab <m

docs: rename development-process/ to process/

As we'll type this a lot, after adding CodingStyle & friends,
let's rename the directory name to a shorter one.

Signed-off-by: Mauro Carvalho Chehab <[email protected]>

show more ...

docs-rst: add inter-document cross references

Add cross references for the development process documents
that were converted to ReST:
Documentation/SubmitChecklist
Documentation/SubmittingDrivers

docs-rst: add inter-document cross references

Add cross references for the development process documents
that were converted to ReST:
Documentation/SubmitChecklist
Documentation/SubmittingDrivers
Documentation/SubmittingPatches
Documentation/development-process/development-process.rst
Documentation/stable_kernel_rules.txt

Signed-off-by: Mauro Carvalho Chehab <[email protected]>
Acked-by: Greg Kroah-Hartman <[email protected]>
Signed-off-by: Jonathan Corbet <[email protected]>

show more ...

Documentation/HOWTO: add cross-references to other documents

Add cross references for the documents mentioned at HOWTO and
are under the Documentation/ directory, using the ReST notation.

It should

Documentation/HOWTO: add cross-references to other documents

Add cross references for the documents mentioned at HOWTO and
are under the Documentation/ directory, using the ReST notation.

It should be noticed that HOWTO also mentions the /README file.
We opted to not touch it, for now, as making it build on
Sphinx would require it to be moved to a Documentation/foo
directory.

Signed-off-by: Mauro Carvalho Chehab <[email protected]>
Acked-by: Greg Kroah-Hartman <[email protected]>
Signed-off-by: Jonathan Corbet <[email protected]>

show more ...

Documentation/SubmittingPatches: enrich the Sphinx output

Do a few changes to make the output look better:

- use bullets on trivial patches list;
- use monotonic font for tools name;
- use :manpage

Documentation/SubmittingPatches: enrich the Sphinx output

Do a few changes to make the output look better:

- use bullets on trivial patches list;
- use monotonic font for tools name;
- use :manpage:`foo` for man pages;
- don't put all references to maintainer*html at the same line.

Signed-off-by: Mauro Carvalho Chehab <[email protected]>
Signed-off-by: Jonathan Corbet <[email protected]>

show more ...

Documentation/SubmittingPatches: convert it to ReST markup

- Change the sections to use ReST markup;
- Add cross-references where needed;
- convert aspas to verbatim text;
- use code block tags;
- m

Documentation/SubmittingPatches: convert it to ReST markup

- Change the sections to use ReST markup;
- Add cross-references where needed;
- convert aspas to verbatim text;
- use code block tags;
- make Sphinx happy.

Signed-off-by: Mauro Carvalho Chehab <[email protected]>
Signed-off-by: Jonathan Corbet <[email protected]>

show more ...

SubmittingPatches: fix spelling of "git send-email"

Signed-off-by: Jakub Wilk <[email protected]>
Signed-off-by: Jonathan Corbet <[email protected]>

Documentation/SubmittingPatches: discuss In-Reply-To

Add a paragraph suggesting best practices for when to link patches
to previous LKML messages via In-Reply-To.

Signed-off-by: Chris Metcalf <cmet

Documentation/SubmittingPatches: discuss In-Reply-To

Add a paragraph suggesting best practices for when to link patches
to previous LKML messages via In-Reply-To.

Signed-off-by: Chris Metcalf <[email protected]>
[jc: moved the added text to a separate section]
Signed-off-by: Jonathan Corbet <[email protected]>

show more ...

SubmittingPatches: make Subject examples match the de facto standard

The examples should better match what kernel developers actually expect,
so that they set a good example both for this project an

SubmittingPatches: make Subject examples match the de facto standard

The examples should better match what kernel developers actually expect,
so that they set a good example both for this project and for other
projects with similar development processes.

Signed-off-by: Alex Henrie <[email protected]>
Signed-off-by: Jonathan Corbet <[email protected]>

show more ...

Doc: fix trivial typo in SubmittingPatches

This patch changes the tense of a verb in SubmittingPatches to ensure
grammatical validity of the containing sentence.

Signed-off-by: Benjamin Herr <ben@0

Doc: fix trivial typo in SubmittingPatches

This patch changes the tense of a verb in SubmittingPatches to ensure
grammatical validity of the containing sentence.

Signed-off-by: Benjamin Herr <[email protected]>
Signed-off-by: Jiri Kosina <[email protected]>

show more ...

fix typo in Documentation/SubmittingPatches

This adds a missing letter in Documentation/SubmittingPatches.

Signed-off-by: Nik Nyby <[email protected]>
Signed-off-by: Jiri Kosina <[email protected]>

SubmittingPatches: remove stray quote character

Signed-off-by: Jakub Wilk <[email protected]>
Signed-off-by: Jonathan Corbet <[email protected]>

Doc: fix trivial typo in SubmittingPatches

This patch changes the tense of a verb in SubmittingPatches to ensure
grammatical validity of the containing sentence.

Signed-off-by: Benjamin Herr <ben@0

Doc: fix trivial typo in SubmittingPatches

This patch changes the tense of a verb in SubmittingPatches to ensure
grammatical validity of the containing sentence.

Signed-off-by: Benjamin Herr <[email protected]>
Signed-off-by: Jonathan Corbet <[email protected]>

show more ...

SubmittingPatches: fix wrong wording

"facilitate easier reviewing" says the same thing twice.

Signed-off-by: Sébastien Hinderer <[email protected]>
[jc: made it "easier review"]
Signe

SubmittingPatches: fix wrong wording

"facilitate easier reviewing" says the same thing twice.

Signed-off-by: Sébastien Hinderer <[email protected]>
[jc: made it "easier review"]
Signed-off-by: Jonathan Corbet <[email protected]>

show more ...

SubmittingPatches: fix wrong wording

Signed-off-by: Sébastien Hinderer <[email protected]>
Signed-off-by: Jonathan Corbet <[email protected]>

SubmittingPatches: update CodingStyle reference

Link to the internal up to date Coding Style document inside the Kernel
sources instead of an external one.

Signed-off-by: Luis de Bethencourt <luis@

SubmittingPatches: update CodingStyle reference

Link to the internal up to date Coding Style document inside the Kernel
sources instead of an external one.

Signed-off-by: Luis de Bethencourt <[email protected]>
Signed-off-by: Jonathan Corbet <[email protected]>

show more ...

SubmittingPatches: fix typo

From 7e0befc8e48a49e2ddf86bbd861027b14ea5a53d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?S=C3=A9bastien=20Hinderer?=
<[email protected]>
Date: Wed, 8 Jul 201

SubmittingPatches: fix typo

From 7e0befc8e48a49e2ddf86bbd861027b14ea5a53d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?S=C3=A9bastien=20Hinderer?=
<[email protected]>
Date: Wed, 8 Jul 2015 21:10:18 +0200
Subject: [PATCH] SubmittingPatches: fix typo
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Content-Type: text/plain; charset="utf-8"

Signed-off-by: Sébastien Hinderer <[email protected]>
Signed-off-by: Jonathan Corbet <[email protected]>

show more ...

SubmittingPatches: Clarify requirements for patches directed toward stable

I misunderstood this section as simply asking me to add an email Cc, and
was unaware of the existence of Documentation/stab

SubmittingPatches: Clarify requirements for patches directed toward stable

I misunderstood this section as simply asking me to add an email Cc, and
was unaware of the existence of Documentation/stable_kernel_rules.txt.
Hopefully this clarification will help save maintainers and new/rare
submitters time in the future.

Signed-off-by: Luke Dashjr <[email protected]>
Signed-off-by: Jonathan Corbet <[email protected]>

show more ...

checkpatch, SubmittingPatches: suggest line wrapping commit messages at 75 columns

Commit messages lines are sometimes overly long.

Suggest line wrapping at 75 columns so the default git commit log

checkpatch, SubmittingPatches: suggest line wrapping commit messages at 75 columns

Commit messages lines are sometimes overly long.

Suggest line wrapping at 75 columns so the default git commit log
indentation of 4 plus the commit message text still fits on an 80 column
screen.

Add a checkpatch test for long commit messages lines too.

Signed-off-by: Joe Perches <[email protected]>
Cc: David Miller <[email protected]>
Cc: Jonathan Corbet <[email protected]>
Cc: Ian Morris <[email protected]>
Signed-off-by: Andrew Morton <[email protected]>
Signed-off-by: Linus Torvalds <[email protected]>

show more ...

Documentation/SubmittingPatches: unify whitespace/tabs for the DCO

The Developers Certificate of Origin has a mixture of tabs and white
spaces which is annoying to view if your editor explicitly vie

Documentation/SubmittingPatches: unify whitespace/tabs for the DCO

The Developers Certificate of Origin has a mixture of tabs and white
spaces which is annoying to view if your editor explicitly views white
space characters.

Also remove any trailing white spaces found in the file.

Signed-off-by: Stefan Beller <[email protected]>
Signed-off-by: Jonathan Corbet <[email protected]>

show more ...

Docs: SubmittingPatches: mention using pull requests as a cover letter

Suggested-by: Mark Brown <[email protected]>
Signed-off-by: Jonathan Corbet <[email protected]>

Docs: Mention device tree binding info

Suggested-by: Frank Rowand <[email protected]>
Signed-off-by: Jonathan Corbet <[email protected]>

Docs: SubmittingPatches: miscellaneous cleanups

Changes to make the formatting a bit more consistent and fix up wording in
various places.

Signed-off-by: Jonathan Corbet <[email protected]>

Docs: SubmittingPatches: update follow-through instructions

SubmittingPatches was written in the "keep sending to Linus until something
shows up in a release" era. Given that we don't do things tha

Docs: SubmittingPatches: update follow-through instructions

SubmittingPatches was written in the "keep sending to Linus until something
shows up in a release" era. Given that we don't do things that way anymore
and the system is far less lossy, update this information and add some
hints on responding to reviewer comments.

Signed-off-by: Jonathan Corbet <[email protected]>

show more ...

Docs: Update recipient information in SubmittingPatches

SubmittingPatches had two sections on selecting recipients; both were
showing their age. Unify them into a single section that more closely
r

Docs: Update recipient information in SubmittingPatches

SubmittingPatches had two sections on selecting recipients; both were
showing their age. Unify them into a single section that more closely
reflects how we do things now.

Signed-off-by: Jonathan Corbet <[email protected]>

show more ...