Bug 301478

Summary:	Add README/CHANGES to kernel package docs
Product:	Gentoo Linux	Reporter:	Jesse Adelman <jesse>
Component:	New packages	Assignee:	Gentoo Kernel Miscellaneous <kernel-misc>
Status:	RESOLVED FIXED
Severity:	enhancement
Priority:	High
Version:	unspecified
Hardware:	All
OS:	Linux
Whiteboard:
Package list:		Runtime testing required:	---
Attachments:	unipatch_docs.patch

Description Jesse Adelman 2010-01-19 03:43:58 UTC

Howdy. Per a conversation I had with dsd_ on #gentoo-kernel, I'm submitting this request. I'd like to see the patchset associated with a particular ebuild installed either into /usr/share/doc/<kernel>/README or similar file, or in a file "README.gentoo" in /usr/src/<kernel>/Documentation, or other, appropriate location.

Right now, to find the actual patchset descriptions, I either have to:

* Untar the genpatches-* patchset from my distdir, and read 0000_README.
* Wade through Gentoo's CVS and hope I'm in the right place.
* Go to IRC to find out that http://dev.gentoo.org/~dsd/genpatches/ is not the place to go anymore. ;)
* Sign up and monitor the gentoo-kernel mailing list.

This isn't the best method for a user, as it unnecessary obfuscates the contents of the patchset.

dsd_ asked me to assign this bug to kernel-misc. I hope I do the right thing to make that happen, but please adjust this bug so that it goes to the right folks. Thanks.

Comment 1 Jeroen Roovers (RETIRED) gentoo-dev

2010-01-29 05:04:36 UTC

oops

Comment 2 Tom Wijsman (TomWij) (RETIRED) gentoo-dev

2013-04-12 18:01:44 UTC

Created attachment 345402 [details]
unipatch_docs.patch

This patch will be part of a series of patches that will be sent to the mailing lists and committed all at once to the tree in the near future.

Comment 3 Tom Wijsman (TomWij) (RETIRED) gentoo-dev

2013-04-17 13:53:36 UTC

  17 Apr 2013; Tom Wijsman <TomWij@gentoo.org> kernel-2.eclass:
  Added a warning after the variables that modifying other variables in
  the eclass is not supported, there is a chance that we will not fix
  resulting bugs. Fixes bug #421721.
  Clarify the default DESCRIPTION and make it not use versions, a
  directory with ebuilds that inherit this eclass may contain multiple
  versions and we also don't want to give the impression that a new
  directory needs to made if that's not the case. Fixes bug #445110.
  Clarified which patch depths are used in the normal output and error
  output when applying patches. Fixes bug #436402.
  Made sure .tmp_gas_check is created inside the temp folder, it
  accidentally created temp.tmp_gas_check instead. Fixes bug #336732.
  Make UNIPATCH_DOCS work again, install 0000_README document when
  using genpatches. Fixes bug #301478.