From mark.vanderloo at gmail.com  Fri Jun  5 08:53:36 2015
From: mark.vanderloo at gmail.com (Mark van der Loo)
Date: Fri, 5 Jun 2015 08:53:36 +0200
Subject: [Rd] NEWS.md support on CRAN
In-Reply-To: <CAAHES9zb76pGAG-1SrUS=Myqix7TPrMr0rMoMn-3r06qCj7=Ng@mail.gmail.com>
References: <4819669E-8260-47B0-96BF-DC2B29E6BE21@me.com>
	<555FD2FE.8050600@gmail.com>
	<21856.13500.513608.759602@fangorn.hornik.net>
	<B98D36A9-901A-4413-88C0-22D7E923612E@me.com>
	<581D2C19-ED47-4D1D-8FC7-C4B4F368E637@gmail.com>
	<21868.18877.410651.592015@fangorn.hornik.net>
	<21869.50739.349239.728644@max.nulle.part>
	<556DCADA.7060109@gmail.com>
	<21870.40730.965705.219861@fangorn.hornik.net>
	<CAOKDuOhy=P8hYktkXJ2dtRexihc5vzsC44TUqn80j+Nz7oAoxg@mail.gmail.com>
	<CAAHES9y-ztcaK8uqbkR8vuYq4P3kmmJh3TS=Pp+81vSU2_22Xw@mail.gmail.com>
	<55708643.8020703@stats.ox.ac.uk> <557087EC.5020100@gmail.com>
	<CAAHES9zb76pGAG-1SrUS=Myqix7TPrMr0rMoMn-3r06qCj7=Ng@mail.gmail.com>
Message-ID: <CAOKDuOjWOBh-6z9ucdNQnN+mBKMb6DAcSsoGka1GcMJ=k4kExQ@mail.gmail.com>

@Gavin: My aim was to point out that the ability to mix developer-facing
documentation with user-facing documentation is not a good reason to want
to support md.

I agree with Duncan that links to within a package would be useful (not
sure if NEWS.Rd supports this).

I'm not so convinced that package authors that do not even add a plain text
NEWS file will create a NEWS.md file.

Adding NEWS.md means we now have three ways to specify the NEWS:

- a plain text NEWS file; following the GNU recommendations
- NEWS.Rd
- NEWS.md

Would it not be more elegant to have e.g. roxygen2 generate NEWS.Rd?
(perhaps it is already possible, I'm not sure of that). I don't maintain
CRAN, but I know what I would prefer..

Cheers,
Mark



?

	[[alternative HTML version deleted]]



[Rd] NEWS.md support on CRAN
Mark van der Loo