Re: [Rd] faqs
And one other thing. In the GNU docs it says that if your NEWS file gets too big you can create an ONEWS file for the really old stuff. Is ONEWS supported too? On Nov 16, 2007 11:12 PM, Gabor Grothendieck <[EMAIL PROTECTED]> wrote: > > On Nov 15, 2007 10:51 AM, Gabor Grothendieck <[EMAIL PROTECTED]> wrote: > > On Nov 15, 2007 9:57 AM, Simon Urbanek <[EMAIL PROTECTED]> 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. > > > > > > > I agree that that would be desirable. > > Also it would be nice if the HTML files here: > > http://cran.r-project.org/src/contrib/Descriptions/ > > each had a link to the NEWS file so one could get the news on a > package prior to > installing it. > __ R-devel@r-project.org mailing list https://stat.ethz.ch/mailman/listinfo/r-devel
Re: [Rd] faqs
On Nov 15, 2007 10:51 AM, Gabor Grothendieck <[EMAIL PROTECTED]> wrote: > On Nov 15, 2007 9:57 AM, Simon Urbanek <[EMAIL PROTECTED]> 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. > > > > I agree that that would be desirable. Also it would be nice if the HTML files here: http://cran.r-project.org/src/contrib/Descriptions/ each had a link to the NEWS file so one could get the news on a package prior to installing it. __ R-devel@r-project.org mailing list https://stat.ethz.ch/mailman/listinfo/r-devel
Re: [Rd] faqs
On Nov 15, 2007 9:57 AM, Simon Urbanek <[EMAIL PROTECTED]> 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. > I agree that that would be desirable. __ R-devel@r-project.org mailing list https://stat.ethz.ch/mailman/listinfo/r-devel
Re: [Rd] faqs
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. Cheers, Simon > > On Nov 14, 2007 10:15 PM, Duncan Murdoch <[EMAIL PROTECTED]> 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 >>> <[EMAIL PROTECTED]> 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/~rogerRoger Koenker email [EMAIL PROTECTED] Department of Economics vox:217-333-4558University of Illinois fax:217-244-6678Champaign, IL 61820 __ R-devel@r-project.org mailing list https://stat.ethz.ch/mailman/listinfo/r-devel >>> >>> __ >>> R-devel@r-project.org mailing list >>> https://stat.ethz.ch/mailman/listinfo/r-devel >> >> > > __ > R-devel@r-project.org mailing list > https://stat.ethz.ch/mailman/listinfo/r-devel > > __ R-devel@r-project.org mailing list https://stat.ethz.ch/mailman/listinfo/r-devel
Re: [Rd] faqs
Gabor Grothendieck gmail.com> writes: > inst/NEWS would have the advantage of consistency with R itself > which also has a NEWS file. > ... > > My vote is for inst/ChangeLog. I wote for inst/NEWS, while inst/ChangeLog can also be present to show more details such as svn log. Gregor __ R-devel@r-project.org mailing list https://stat.ethz.ch/mailman/listinfo/r-devel
Re: [Rd] faqs
inst/NEWS would have the advantage of consistency with R itself which also has a NEWS file. On Nov 14, 2007 10:15 PM, Duncan Murdoch <[EMAIL PROTECTED]> 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 <[EMAIL PROTECTED]> 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/~rogerRoger Koenker > >> email [EMAIL PROTECTED] Department of Economics > >> vox:217-333-4558University of Illinois > >> fax:217-244-6678Champaign, IL 61820 > >> > >> __ > >> R-devel@r-project.org mailing list > >> https://stat.ethz.ch/mailman/listinfo/r-devel > >> > > > > __ > > R-devel@r-project.org mailing list > > https://stat.ethz.ch/mailman/listinfo/r-devel > > __ R-devel@r-project.org mailing list https://stat.ethz.ch/mailman/listinfo/r-devel
Re: [Rd] faqs
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 <[EMAIL PROTECTED]> 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/~rogerRoger Koenker >> email [EMAIL PROTECTED] Department of Economics >> vox:217-333-4558University of Illinois >> fax:217-244-6678Champaign, IL 61820 >> >> __ >> R-devel@r-project.org mailing list >> https://stat.ethz.ch/mailman/listinfo/r-devel >> > > __ > R-devel@r-project.org mailing list > https://stat.ethz.ch/mailman/listinfo/r-devel __ R-devel@r-project.org mailing list https://stat.ethz.ch/mailman/listinfo/r-devel
Re: [Rd] faqs
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 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. On Nov 14, 2007 8:22 PM, roger koenker <[EMAIL PROTECTED]> 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/~rogerRoger Koenker > email [EMAIL PROTECTED] Department of Economics > vox:217-333-4558University of Illinois > fax:217-244-6678Champaign, IL 61820 > > __ > R-devel@r-project.org mailing list > https://stat.ethz.ch/mailman/listinfo/r-devel > __ R-devel@r-project.org mailing list https://stat.ethz.ch/mailman/listinfo/r-devel
[Rd] faqs
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/~rogerRoger Koenker email [EMAIL PROTECTED] Department of Economics vox:217-333-4558University of Illinois fax:217-244-6678Champaign, IL 61820 __ R-devel@r-project.org mailing list https://stat.ethz.ch/mailman/listinfo/r-devel