Re: tasks overview wishlist: Canonical citing reference
On Thu, Oct 16, 2008 at 11:24:29AM -0400, Adam C Powell IV wrote:
> On Thu, 2008-10-16 at 15:17 +0200, Michael Banck wrote:
> > On Thu, Oct 16, 2008 at 10:40:26AM +0900, Charles Plessy wrote:
> > > - Prepare files named 'reference' of 'citation' in the source package.
> >
> > Did you mean 'reference' *or* 'citation'? As I argued elsewhere, I
> > think both are quite different, and both files have their merit.
> >
> > Also, what format are you now talking about? For the "references" file,
> > bibtex format sounds fine, but as elsewhere discussed, it makes less
> > sense for the "citation" file. Further, would it be possible to have
> > a boilerplate comment at the top which would get ignored by the doc-base
> > stuff, but would be useful for the users browsing
> > /usr/share/doc/<package>? Something like "For more information regarding
> > this package, see the following publications: <bibtex>".
>
> I think the "For more information" can go in the .doc-base file
> abstract, and most bibliographic metadata formats including BibTeX have
> a comment field where a package maintainer can put this information as
> well.
The problem I have with doc-base is that it is underused and not very
accessible. At least that is my impression of it as somebody who
doesn't care a lot about it from a packager's POV. I probably should
care more, though.
So anyway, I'd really like to have something usable for users in
/usr/share/doc/<package> and not just some meta-data stream that's
marked up reasonably somewhere else. Maybe it's best to have a seperate
citation.bib and references.bib file with just the bibtex data?
Michael
Reply to: