[PATCH app/xcursorgen v3] Update README for gitlab migration
Alan Coopersmith
alan.coopersmith at oracle.com
Wed Nov 14 01:12:24 UTC 2018
On 11/13/18 04:57 PM, Alan Coopersmith wrote:
> On 11/13/18 05:41 AM, Julien Cristau wrote:
>> LGTM. Thanks Alan!
>
> Thanks to you, Peter, & Ray for reviews. I merged this, and thought
> "Okay, time to cut a new release." And then I found the mistake.
>
> automake automatically includes a file named "README" in the tarball.
> It does not include a file named "README.md".
>
> So, we seem to have two choices:
>
> 1) Ship with README.md:
> Just add "EXTRA_DIST = README.md" to Makefile.am in every component.
> .
> 2) Ship with README:
> Follow our pattern with Changelog & INSTALL files and add a macro
> to xorg-macros.m4 to define a makefile macro such as:
> README_CMD = cp -f $(top_srcdir)/README.md $(top_srcdir)/README
> and in Makefile.am in every component:
>
> +README:
> + $(README_CMD)
> +
> -dist-hook: ChangeLog INSTALL
> +dist-hook: ChangeLog INSTALL README
>
>
> Anyone have a preference? Shipping README.md seems easier - will it cause
> problems for any distros or packagers?
3rd choice - this seems to work for me, shipping a file named README in the
tarball without any Makefile modifications:
% ln -s README.md README
% git add README
% git commit -m 'ln -s README.md README'
Is checking symlinks into git going to break Windows or any other platforms?
--
-Alan Coopersmith- alan.coopersmith at oracle.com
Oracle Solaris Engineering - https://blogs.oracle.com/alanc
More information about the xorg-devel
mailing list