[PATCH input-synaptics 2/5] Do not install ChangeLog and README with documentation

Gaetan Nadon memsize at videotron.ca
Tue Jun 14 11:09:55 PDT 2011


On Tue, 2011-06-14 at 15:53 +0200, Diego Elio Pettenò wrote:

> Il giorno mar, 14/06/2011 alle 09.46 -0400, Gaetan Nadon ha scritto:
> > I had not noticed before, on my distro the README (but not ChangeLog)
> > is installed in doc.
> > ChangeLog definitely does not go with docs.
> 
> Why not? If I install an update I might as well want to know what the
> update consisted of. The files are just as well important for the user
> as for the developer.

I am surprised it has never be done for so many years. I looked around
in my distro and it does not seem any one is doing it (ChangeLog). 

> 
> > Let the distro speak up if they want us to install. 
> 
> I'm speaking as a long-time distributor myself.

A big surprise, I have never heard about it before despite a good number
of distro maintainer on the xorg-devel list.


> > If a majority of distro want the README file installed, then let's do
> > it everywhere!
> 
> Having all of xorg using non-recursive make with parallel install would
> indeed be sweet to avoid spending so much time with the cores idle
> waiting for link on modules...
> 

I don't have anything to add on top of what Dan has just written in
another e-mail. I don't have that type of build expertise.

My conclusion is that I am ok with the installation of the README
(distros are doing it), but I would need more convincing for ChangeLog
as I have not seen any on Debian. I am under the impression that distros
totally rearrange packaging so it may not be helpful to do it. Xorg does
not do builds, it is not easy to make consistent changes across 200
modules when many don't have a maintainer.

Just want to throw a good but unrelated example here. A while back, at
the initiative of a distro builder and with the help of a few others, we
have reworked the configuration options for the 20 modules containing
documentation, created a few XORG macros. They now have consistent
options and behaviors which meets the distros requirements where before
every module did it differently which was a pain for distros. 

Thanks for your replies, I did learn a few things in the process. 

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.x.org/archives/xorg-devel/attachments/20110614/10266a5e/attachment.htm>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 198 bytes
Desc: This is a digitally signed message part
URL: <http://lists.x.org/archives/xorg-devel/attachments/20110614/10266a5e/attachment.pgp>


More information about the xorg-devel mailing list