Bug #109586 for Text-BibTeX: Outdated documents of btparse

Tue Nov 24 11:53:13 2015 http://www.hatena.ne.jp/grafi/ - Ticket created

Subject:

Outdated documents of btparse

It seems currently btparse is maintained by Alberto as a part of Text::BibTeX. However its documentation <http://search.cpan.org/~ambs/Text-BibTeX-0.71/btparse/doc/btparse.pod> is quite outdated, having dead link to old web pages. What makes more confusion is the existence of individual btparse package (outdated?) on CPAN <http://search.cpan.org/~ambs/btparse/>. Such inconsistent information quite confuses newbies willing to hack BibTeX tools, like me. Would you like update these documents?

Tue Nov 24 12:11:45 2015 ambs [...] cpan.org - Correspondence added

On Tue Nov 24 11:53:13 2015, http://www.hatena.ne.jp/grafi/ wrote: Show quoted text

> It seems currently btparse is maintained by Alberto as a part of > Text::BibTeX. However its documentation > <http://search.cpan.org/~ambs/Text-BibTeX- > 0.71/btparse/doc/btparse.pod> is quite outdated, having dead link to > old web pages. What makes more confusion is the existence of > individual btparse package (outdated?) on CPAN > <http://search.cpan.org/~ambs/btparse/>. > > Such inconsistent information quite confuses newbies willing to hack > BibTeX tools, like me. Would you like update these documents?

Hi Correct, I should update documentation. But let me clarify: btparse is the original C parser. it is still available in case someone wants to use it from a language other than Perl. Text::BibTeX is the Perl module that uses btparse, and that INCLUDES it. I know this could be made clear in the docs. Will try to do it when time permits. Patches welcome ;) Thank you Alberto

Tue Nov 24 12:11:46 2015 The RT System itself - Status changed from 'new' to 'open'

Wed Dec 02 00:20:53 2015 http://www.hatena.ne.jp/grafi/ - Correspondence added

From:

Shunsuke Shimizu <shunsuke [...] is.s.u-tokyo.ac.jp>

Dear Alberto, Thank you, I got it. I'm sorry I can't send patches, because I don't know situations much (another reason is poor English). Thanks a lot, Shunsuke (http://www.hatena.ne.jp/grafi/). On 2015-11月-24 火 12:11:45, AMBS wrote: Show quoted text

> On Tue Nov 24 11:53:13 2015, http://www.hatena.ne.jp/grafi/ wrote:

> > It seems currently btparse is maintained by Alberto as a part of > > Text::BibTeX. However its documentation > > <http://search.cpan.org/~ambs/Text-BibTeX- > > 0.71/btparse/doc/btparse.pod> is quite outdated, having dead link to > > old web pages. What makes more confusion is the existence of > > individual btparse package (outdated?) on CPAN > > <http://search.cpan.org/~ambs/btparse/>. > > > > Such inconsistent information quite confuses newbies willing to hack > > BibTeX tools, like me. Would you like update these documents?

> > Hi > > Correct, I should update documentation. > But let me clarify: > > btparse is the original C parser. it is still available in case > someone wants to use it from a language other than Perl. > > Text::BibTeX is the Perl module that uses btparse, and that INCLUDES > it. > > I know this could be made clear in the docs. Will try to do it when > time permits. > > Patches welcome ;) > > Thank you > Alberto

Wed Dec 02 09:15:21 2015 ambs [...] perl-hackers.net - Correspondence added

Subject:	Re: [rt.cpan.org #109586] Outdated documents of btparse
Date:	Wed, 2 Dec 2015 14:14:55 +0000
To:	bug-Text-BibTeX [...] rt.cpan.org
From:	Alberto Simoes <ambs [...] perl-hackers.net>

On 02/12/15 05:20, http://www.hatena.ne.jp/grafi/ via RT wrote: Show quoted text

> Queue: Text-BibTeX > Ticket <URL: https://rt.cpan.org/Ticket/Display.html?id=109586 > > > Dear Alberto, > > Thank you, I got it. I'm sorry I can't send patches, because I don't know situations much (another reason is poor English). >

No problem. I have it in my stack. As soon I have some time I'll update the docs :) Best Alberto