BTOOL_FAQ(1)                        btparse                       BTOOL_FAQ(1)


<?><?><?> (NAME)
       btool_faq - <?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?> btparse <?> Text::BibTeX

<?><?><?><?><?><?><?> (DESCRIPTION)
       <?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?>
       <?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?>
       <?> <?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?> --
       <?><?><?> <?><?> <?><?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?><?>. <?><?> <?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?> <?> <?><?><?><?> <?><?><?> <?><?><?>
       <?><?><?><?><?> <?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>.
       <?><?> <?><?><?> <?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?><?>
       <?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?> <?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?>
       <?> <?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?>
       <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?> btOOL<?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?> <?><?><?><?><?><?> <?><?>
       <?><?><?> <<<?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?>>> <?><?><?><?><?> <?><?><?>.

<?><?><?><?><?><?><?><?> PERL (PERL LIBRARY)
       <?><?><?> <?><?><?> <?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?>
       "Text::BibTeX"<?> <?><?><?><?><?> <?><?><?><?> btOOL<?> <?><?><?><?>
       <?><?><?><?><?><?><?><?>.

   <?><?><?> <?><?><?><?><?><?><?><?> "month" <?><?> BibTeX <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?> "Text::BibTeX"
       <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?> <?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>. <?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?>
       foo.bib <?><?><?><?><?> (parse) <?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?> <?><?><?> ("jan"<?> "feb" <?> <?><?><?><?>)
       <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?> (style) <?><?><?><?><?><?><?><?><?> BibTeX
       <?><?><?><?><?><?><?> <?><?><?><?><?><?>:

          $bibfile = Text::BibTeX::File->new('foo.bib')    # open file
             or die "foo.bib: $!\n";
          $entry = Text::BibTeX::Entry->new($bibfile);     # parse first entry

       <?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?> <?><?><?><?>
       <?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?> foo.bib <?><?> <?><?><?><?><?>
       <<<?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?>>> (undefined macro)
       <?><?><?><?><?><?> <?><?><?><?>. <?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?>
       <?><?> <?><?><?> <?><?><?><?><?><?><?> --- <?><?> <?><?><?><?><?>
       <?><?><?> <?><?><?><?>.

       <?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?>
       <?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?>. <?><?><?> <?><?> <?><?><?><?> 0.30<?> <?><?><?> <?><?><?>
       <?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?> <?><?><?><?><?> "Text::BibTeX" <?><?>
       <?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?>. <?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?>
       <?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?> <?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?>:

          use Text::BibTeX qw(:macrosubs);
          # ...
          my %month = (jan => 'January', feb => 'February', ... );
          add_macro_text ($macro, $value)
             while (($macro, $value) = each %month);

       <?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?>
       <?><?> <?><?> <?><?><?><?> <?><?><?><?><?> <?><?> BibTeX (<?><?><?><?>
       <?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?>
       <?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>)
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?>:
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?> "Text::BibTeX" <?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> (structure modules)
       <?><?><?><?><?><?> <?><?><?><?><?><?><?>. "Text::BibTeX" <?><?>
       <?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?> "Text::BibTeX::Bib"
       <?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?><?><?> BibTeX 0.99 <?><?> (<?><?>
       <?><?><?>) <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?>
       <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?>.
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?> "set_structure" <?><?> <?><?><?>
       <?><?><?> "Text::BibTeX::File" <?><?><?><?> <?><?><?><?><?><?><?>.
       <?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?> <?><?> "Text::BibTeX"
       <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?>
       <?><?> $bibfile <?><?><?><?> <?><?> <?><?><?><?><?><?> "Bib"
       <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> (<?><?> <?><?><?><?>
       <?><?><?><?><?> "Text::BibTeX::Bib" <?><?><?><?><?><?><?><?><?><?>
       <?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?>):

          $bibfile = Text::BibTeX::File->new('foo.bib')
             or die "foo.bib: $!\n";
          $bibfile->set_structure ('Bib');

       <?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?> <?><?> <?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?> (hardcode) <?><?><?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?> (<?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?> BibTeX <?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>).
       <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?> <?><?>
       <?><?><?><?><?><?> <?><?> <?><?> <?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?> "Bib" <?><?><?><?> (<?><?><?><?> <?><?>
       <?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?> <?><?> <?><?> <?><?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?> <?><?><?>).

   <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?><?>
       <?><?> <?><?><?><?> BibTeX <?><?><?><?><?> (append) <?><?><?><?>
       <?><?><?> <?><?> <?><?> <?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?>
       <?><?><?><?> <?> <?><?><?><?><?><?><?><?> <?><?> <?><?><?>
       <?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?><?><?>. <?><?> <?><?><?>
       <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?> <?><?><?>
       "Text::BibTeX::File" <?><?><?><?><?><?> <?><?> <?><?><?><?> (wrapper)
       <?><?> <?><?><?> <?><?> <?><?><?> "IO::File" <?><?><?><?> <?> <?><?><?>
       "Text::BibTeX::File::open" (<?> <?><?> <?><?><?><?><?> "new" <?><?><?>)
       <?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?> "IO::File::open"
       <?><?><?>. "IO::File::open" <?><?><?> <?><?> <?><?><?><?> <?><?><?>
       <?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?>
       "open" <?><?> <?><?><?> (<?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?> <?><?> <?><?><?><?><?><?><?>) <?><?> "sysopen" (<?><?> <?><?>
       <?><?> <?><?><?><?><?><?><?>) <?><?><?>. <?><?><?><?> <?><?><?><?><?>
       <?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?> <?><?><?> <?><?><?>: <?><?><?> <?><?><?>
       <?><?><?> <?><?><?><?> <?><?> <?><?> <?><?><?> "new" <?><?>
       "Text::BibTeX::File" <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?>
       <?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?><?> "open" <?><?><?> <?><?><?><?><?>
       <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>:

          my $append_file = Text::BibTeX::File->new(">>$filename")
             or die "couldn't open $filename for appending: $!\n";

       <?><?><?><?> $filename <?><?> <?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?> <?><?><?><?><?><?>. <?><?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?> <?><?><?><?> <?><?><?><?>
       (<?><?><?><?><?> $entry) <?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?> <?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?><?><?> $append_file <?><?><?><?><?>
       <?><?><?><?>:

          $entry->write ($append_file);

       <?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?> <?><?>
       "append_entries" <?><?> <?><?><?><?><?><?><?> examples/ <?><?>
       <?><?><?><?><?> "Text::BibTeX" <?><?><?><?><?><?> <?><?><?><?>.

<?><?><?><?><?><?><?><?> C (C LIBRARY)
       <?><?><?> <?><?><?> <?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?> btparse<?> <?><?><?><?><?> C <?><?> btOOL<?>
       <?><?><?><?><?><?><?><?><?>.

   <?><?><?> <?><?><?><?> btparse <?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?>
       <?><?> <?><?><?><?> <?><?> <?><?> <?><?><?><?><?><?><?><?> <?><?><?>.
       <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?>. <?><?><?> <?><?><?>
       <?><?><?> <?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?> <?><?><?><?>.

<?><?><?><?><?><?> <?><?><?><?><?><?> (SEE ALSO)
       btparse, Text::BibTeX

<?><?><?><?><?><?><?><?><?> (AUTHORS)
       Greg Ward <gward@python.net>

<?><?><?><?><?><?><?><?> <?> <?><?><?><?><?> (COPYRIGHT)
       <?><?> <?><?><?>  1997-2000 <?><?><?><?><?> <?><?> Gregory P. Ward
       <?><?><?>. <?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?>.
       <?><?><?> <?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?><?><?>
       Text::BibTeX <?><?><?>. <?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?><?> Perl <?><?><?><?><?><?><?><?> <?><?><?><?><?>
       <?>/<?><?> <?><?><?><?><?> <?><?><?><?>.

btparse, version 0.91             2025-07-14                      BTOOL_FAQ(1)