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 -- To UNSUBSCRIBE, email to [EMAIL PROTECTED] with a subject of "unsubscribe". Trouble? Contact [EMAIL PROTECTED]
