[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Re: Turning debian/upstream into BibTeX (Was: Tasks pages (close to) fixed; Bibref does not seem to be updated automatically)



> > http://git.debian.org/?p=pkg-exppsy/debian-bibliography.git;a=blob;hb=HEAD;f=tools/dbib_collect
> > and make it do the extraction/conversion from /upstream (which will be
> > under /usr/doc/PACKAGE/, right?)

> Ahhh, this assumes that reference information is kept in
> debian/changelog, right?

that was our initial approach, somewhat argued against by others
;-) the point of the script though was more along the lines of your

 >    cat /var/lib/bibref/snippets/* > /var/lib/bibref/debian.bib

i.e. to gather  bibliographic entries for all software installed on the
system.

> The alternative approach could perfectly be to seek for files matching
>     /usr/share/doc/*/upstream
> and do the BibTeX generation afterwards.

yeap -- that was the idea behind dbib_collect -- to gather from
all possible places, but if we converge on /upstream, and it would (or
does already?) allow multiple entries, trigger-generated snippets-cat-er
might be preferable eliminating the need for an additional user-land
tool.

> packages with renamed files).  If you are asking: "Why, this should be
> installed?" I would say:  "You are right, probably nobody has really
> thought about this."  I would fully agree that it could add extra
> information to the doc inside a binary package - so why not installing
> it.

;-)

> Despite this my plan should work with or without the installation of
> the files.  I would like to do something like this:

> debian/control:
> Build-Depends: upstream-to-bibref-helper
> #  for sure the package needs a better name

e.g. debian-bibliography-tools... ? ;-)
or may be the whole debian-bibliography could be abbreviated as
debbib..., then debbib-tools

> database.  Please note that this is just a scetch which should be
> enhanced and perhaps / probably the debian.bib file should end up at a
> better place where bibtex files will be automatically searched for etc -
> but these are implemantation details.

IIRC I have looked for such a place and there were no suitable one (I
could be wrong), so in that preliminary debian-bibliography
package we placed /usr/share/bib/debian.bib  with the intent to seek
adding /usr/share/bib into default BIBINPUTS.

Here debian.bib 
http://anonscm.debian.org/gitweb/?p=pkg-exppsy/debian-bibliography.git;a=blob;hb=HEAD;f=bib/debian.bib
is not a compilation of software bib references but
rather ready-to-use entries for debian documents (e.g. papers) and
some wiki pages.  With http://wiki.debian.org/CategoryPublication
we can now extend it automatically each "release" with relevant
publication entries (script yet TODO).

So, compiled one might better be named debian-software.bib or may be
even more appropriate (since references might be on data packages
etc) debian-packages.bib

Cheers,
-- 
=------------------------------------------------------------------=
Keep in touch                                     www.onerussian.com
Yaroslav Halchenko                 www.ohloh.net/accounts/yarikoptic


Reply to: