Re: [Rd] NEWS file (was faqs)

From: Duncan Murdoch <murdoch_at_stats.uwo.ca>
Date: Thu, 15 Nov 2007 10:53:28 -0500

On 11/15/2007 9:57 AM, Simon Urbanek wrote:

> On Nov 14, 2007, at 11:55 PM, Gabor Grothendieck wrote:
> 

>> inst/NEWS would have the advantage of consistency with R itself
>> which also has a NEWS file.
>>
> 
> I vote for NEWS for reasons above plus because that's what I use in my  
> packages already ;).
> IMHO it should be installed automatically if present, i.e. it  
> shouldn't be necessary to have it in inst/NEWS, just plain NEWS should  
> suffice.

And you're volunteering to make that change?

Duncan

> 
> Cheers,
> Simon
> 
> 

>>
>> On Nov 14, 2007 10:15 PM, Duncan Murdoch <murdoch@stats.uwo.ca> wrote:
>>> On 14/11/2007 8:53 PM, Gabor Grothendieck wrote:
>>>> Another possibility is to just place it at the end of the vignette.
>>>> That is where it is in the proto package:
>>>>
>>>> http://cran.r-project.org/doc/vignettes/proto/proto.pdf
>>>>
>>>> Package documentation is already quite scattered and adding
>>>> a faq() command would add just one more thing one has
>>>> to do. Here are some places one might look already for
>>>> documentation:
>>>>
>>>> package?mypackage
>>>
>>> Or just ?mypackage. Writing R Extensions recommends package?
>>> mypackage,
>>> with ?mypackage also working if that name isn't taken. However, the
>>> advice is ignored more than it is followed.
>>>
>>>> vignette(...)
>>>> library(help = mypackage)
>>>> ?mycommand
>>>> home page
>>>> WISHLIST file
>>>> NEWS file
>>>> THANKS file
>>>> svn log
>>>>
>>>> I personally would give a much higher priority to a standardized
>>>> place to find change information. Some packages provide it.
>>>> Some don't which is very frustrating since you see a new version
>>>> and have no idea what has changed. If they do document it you
>>>> often have to download the source just to get at the change
>>>> information.
>>>
>>> Where do you put it? I put it in inst/ChangeLog, which ends up
>>> installed in the package root as ChangeLog.
>>>
>>> Whenever this has come up in the past, there have been several
>>> proposals, but no consensus. So, to encourage consensus, I've got a
>>> proposal:
>>>
>>> Why don't we vote on a location, with every voter agreeing to
>>> follow the
>>> majority? The only condition I'd put on it is that it should be
>>> something that gets installed, hence somewhere in inst, but I'd be
>>> happy
>>> to change the name if ChangeLog doesn't win.
>>>
>>> My vote is for inst/ChangeLog.
>>>
>>> Duncan Murdoch
>>>
>>>
>>>>
>>>>
>>>>
>>>> On Nov 14, 2007 8:22 PM, roger koenker
>>>> <roger_at_ysidro.econ.uiuc.edu> wrote:
>>>>> An extremely modest proposal:
>>>>>
>>>>> It would be nice if packages could have a FAQ and if
>>>>>
>>>>> faq(package.name)
>>>>>
>>>>> would produce this faq. And if, by default
>>>>>
>>>>> faq()
>>>>> FAQ()
>>>>>
>>>>> would produce the admirable R faq... Apologies in advance
>>>>> if there is already a mechanism like this, but help.search()
>>>>> didn't reveal anything.
>>>>>
>>>>> url: www.econ.uiuc.edu/~roger Roger Koenker
>>>>> email rkoenker_at_uiuc.edu Department of
>>>>> Economics
>>>>> vox: 217-333-4558 University of
>>>>> Illinois
>>>>> fax: 217-244-6678 Champaign, IL 61820
>>>>>
>>>>> ______________________________________________
>>>>> R-devel_at_r-project.org mailing list
>>>>> https://stat.ethz.ch/mailman/listinfo/r-devel
>>>>>
>>>>
>>>> ______________________________________________
>>>> R-devel_at_r-project.org mailing list
>>>> https://stat.ethz.ch/mailman/listinfo/r-devel
>>>
>>>
>>
>> ______________________________________________
>> R-devel_at_r-project.org mailing list
>> https://stat.ethz.ch/mailman/listinfo/r-devel
>>
>>


R-devel_at_r-project.org mailing list
https://stat.ethz.ch/mailman/listinfo/r-devel Received on Thu 15 Nov 2007 - 15:53:38 GMT

Archive maintained by Robert King, hosted by the discipline of statistics at the University of Newcastle, Australia.
Archive generated by hypermail 2.2.0, at Thu 15 Nov 2007 - 17:30:20 GMT.

Mailing list information is available at https://stat.ethz.ch/mailman/listinfo/r-devel. Please read the posting guide before posting to the list.