BT_INPUT(1)                         btparse                        BT_INPUT(1)


<?><?><?> (NAME)
       bt_input - <?><?><?><?><?> <?><?><?><?><?> <?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?> btparse

<?><?><?><?><?> <?><?><?><?><?> (SYNOPSIS)
          void  bt_set_stringopts (bt_metatype_t metatype, btshort options);
          AST * bt_parse_entry_s (char *    entry_text,
                                  char *    filename,
                                  int       line,
                                  btshort    options,
                                  boolean * status);
          AST * bt_parse_entry   (FILE *    infile,
                                  char *    filename,
                                  btshort    options,
                                  boolean * status);
          AST * bt_parse_file    (char *    filename,
                                  btshort    options,
                                  boolean * overall_status);

<?><?><?><?><?><?><?> (DESCRIPTION)
       <?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?>
       <?><?><?><?><?> <?><?><?><?><?><?><?><?> BibTeX <?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?> <?><?><?> <?><?>
       <?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?> (AST) <?><?>
       <?><?><?> <?><?><?><?><?><?><?>.

       bt_set_stringopts ()
              void bt_set_stringopts (bt_metatype_t metatype, btshort options);

           <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?>
           <?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?>
           <?><?><?><?><?> <?><?><?><?><?><?>. <?><?><?> <?><?><?> <?><?>
           <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?>
           bt_parse_entry_s()<?> bt_parse_entry()<?> <?> bt_parse_file()
           <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?>
           <?><?><?><?><?><?><?><?>. <?><?><?> bt_set_stringopts()
           <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?>
           <?><?> <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
           <?><?><?><?> <?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?>:

              BTE_REGULAR    BTO_CONVERT | BTO_EXPAND | BTO_PASTE | BTO_COLLAPSE
              BTE_COMMENT    0
              BTE_PREAMBLE   0
              BTE_MACRODEF   BTO_CONVERT | BTO_EXPAND | BTO_PASTE

           <?><?><?><?> <?><?><?><?><?>

              bt_set_stringopts (BTE_COMMENT, BTO_COLLAPSE);

           <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
           <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?>
           <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?>
           <?><?><?><?><?><?><?><?> <?><?><?><?><?> (comment) <?><?><?> <?>
           <?><?><?><?><?> <?><?><?><?> AST
           <?><?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?>
           <?><?> <?><?><?><?><?> "bt_parse_*" <?><?><?> <?><?><?><?><?>
           <?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?>.

       bt_parse_entry ()
              AST * bt_parse_entry (FILE *    infile,
                                    char *    filename,
                                    btshort    options,
                                    boolean * status);

           <?><?><?><?> <?><?><?><?> BibTeX <?><?> <?><?> "infile"
           <?><?><?><?> <?> <?><?><?><?><?> <?><?><?><?><?><?>. <?><?><?>
           <?><?><?><?> "filename" <?><?> <?><?><?><?> <?><?><?><?> <?><?>
           <?><?> btparse <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?>
           <?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?><?><?>
           <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?>
           "infile" <?><?> <?><?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
           <?><?><?><?><?> <?><?><?><?> <?><?> <?><?> <?><?> <?><?><?><?><?>
           <?><?><?><?>. <?><?><?><?><?><?><?> "options" <?><?><?><?> <?><?>
           <?><?><?><?><?> <?><?><?><?> (bitmap) <?><?>
           <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?>
           <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> (<?><?> <?><?><?>
           <?><?><?><?><?> "BTO_NOSTORE" <?><?><?><?> <?><?><?><?><?><?><?>
           <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?> <?><?><?> <?><?><?>).
           <?><?> <?><?><?><?><?> <?><?> <?><?><?><?> <?><?>
           <?><?><?><?><?><?> <?><?> <?><?><?> <?><?> <?><?><?><?><?><?><?><?>
           <?><?><?><?> <?><?><?><?><?> <?><?><?><?> *status <?><?><?><?><?>
           <?><?> "TRUE" <?><?><?><?><?> <?><?><?><?><?><?> <?> <?><?>
           <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?>
           <?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?>
           <?><?> "FALSE" <?><?><?><?><?> <?><?><?>. <?><?><?> "status"
           <?><?><?><?><?> <?><?> "NULL" <?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?><?><?>
           <?><?><?>. <?><?> <?><?> <?><?><?> <?><?><?><?><?><?><?><?>
           <?><?><?><?> <?> <?><?><?><?><?><?> <?><?><?> <?><?> "stderr"
           <?><?><?><?><?> <?><?><?><?><?><?><?>.

           <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?>
           <?><?><?><?><?><?><?> (AST) <?><?><?><?><?><?><?><?><?><?><?>
           <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?>
           <?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?>
           <?><?><?><?> <?><?><?><?><?> <?><?> "infile" <?><?><?><?>
           <?><?><?><?><?> "NULL" <?><?><?><?><?><?><?><?><?><?><?> (<?><?><?>
           <?><?><?><?><?><?> "infile" <?><?> <?><?> <?><?><?><?><?>
           <?><?><?><?> <?><?> end-of-file <?><?><?> <?><?><?><?><?><?>).
           <?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?>
           bt_parse_entry() <?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?>
           <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?>
           <?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
           <?><?><?><?><?> <?><?> <?><?> <?><?><?>
           <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>
           <?><?><?><?> <?><?><?> <?><?><?><?><?><?><?>
           <?><?><?><?><?><?><?><?> <?><?><?>.

           <?><?><?><?> bt_parse_entry() <?><?><?><?><?> <?><?>
           <?><?><?><?><?><?><?> <?><?><?> <?><?><?> <?><?> <?><?><?><?>
           <?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>.
           <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?> btparse
           <?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?>
           <?><?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?> <?><?> <?><?>
           <?><?><?><?><?> <?><?><?><?><?> <?><?><?> (<?><?>
           <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?>
           <?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?>
           <?><?><?><?> <?><?><?><?> <?><?><?><?><?>) <?> <?><?> <?><?>
           <?><?><?><?><?> <?><?><?><?><?><?> (<?><?><?><?><?><?><?><?>
           <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
           <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?>
           <?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?>
           <?><?> <?><?><?><?><?><?><?><?> <?><?><?><?> <?> <?><?> <?><?><?>
           <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?>
           <?><?><?><?>). <?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
           <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?> <?><?> <?><?>
           <?><?><?><?> <?><?><?><?><?><?> <?> <?><?><?><?><?><?><?>
           (interleave) <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?>
           <?><?><?><?><?> <?><?><?> <?><?><?> <?><?><?><?> <?><?> <?><?>
           <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?>
           <?><?><?><?><?><?> <?><?><?> <?><?> <?><?><?><?><?>
           <?><?><?><?><?><?> (crash). <?><?><?> <?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?>
           <?><?> <?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?>
           bt_parse_entry() <?><?><?><?><?><?><?><?> <?><?><?><?><?><?>.

           <?><?> <?><?><?><?> <?><?> <?><?><?> <<<?><?><?><?>>>
           <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> bt_parse_entry()
           (<?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?>
           <?><?><?><?><?><?> <?><?><?> <?><?><?> <?><?> <?><?><?><?><?>
           <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>
           <?><?><?><?> <?> <?><?><?> <?><?> <?><?><?><?><?><?> <?><?>
           <?><?><?><?><?><?><?><?><?> <?><?><?> <?><?><?> <?><?> <?><?><?>
           <?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?>
           <?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?>)<?>
           <?><?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?> <?><?> <?><?><?>
           <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?>:

              while (entry = bt_parse_entry (file, filename, options, &ok))
              {
                 if (ok)
                 {
                    /* ... process entry ... */
                 }
              }

           <?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?>
           "feof (file)" <?><?><?><?> (true) <?><?><?><?><?> <?><?><?>.

       bt_parse_entry_s ()
              AST * bt_parse_entry_s (char *    entry_text,
                                      char *    filename,
                                      int       line,
                                      btshort    options,
                                      boolean * status)

           <?><?> <?><?><?><?> <?><?><?><?><?> <?> <?><?><?><?> BibTeX
           <?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?> <?><?><?><?>
           "entry_text"<?> <?><?> <?><?><?><?> <?> <?><?><?><?><?>
           <?><?><?><?><?><?>. <?><?><?> <?><?><?> <?><?><?><?> <?><?> <?><?>
           <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?>
           <?><?> <?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?> <?><?>
           <?><?><?><?><?><?><?> "filename" <?> <?><?><?><?><?> <?><?><?>
           <?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?><?>
           "line"<?> <?><?> btparse <?><?> <?><?><?><?><?>
           <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?>
           <?><?><?><?><?> <?><?> <?><?><?> <?><?><?> <?><?><?><?><?>
           "filename" <?><?> <?><?><?> "NULL" <?> "line" <?><?> <?><?><?> 1
           <?><?><?><?><?> <?><?><?><?><?><?>.
           <?><?><?><?><?><?><?><?><?><?><?> "options" <?> "status"
           <?><?><?><?><?><?> bt_parse_entry() <?><?><?><?><?>.

           <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?>
           <?><?><?><?><?><?><?> (AST) <?><?><?><?><?><?><?><?><?><?><?>
           <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?>
           <?><?><?><?><?><?><?><?><?><?><?><?> <?> <?><?><?> <?><?><?>
           <?><?><?><?><?> <?><?> "entry_text" <?><?><?><?> <?><?><?><?>
           <?><?> "entry_text" <?><?><?><?><?> <?><?> "NULL" <?><?><?><?><?>
           <?><?><?><?><?> "NULL" <?><?> <?><?><?><?><?><?><?><?><?><?><?><?>.

           <?><?><?><?> bt_parse_entry_s() <?><?> <?><?> <?><?><?>
           <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?>
           <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?>
           <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?>
           <?><?><?><?><?><?><?><?><?> "entry_text" <?><?> <?><?><?> "NULL"
           <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?>
           <?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?> <?><?><?>. <?><?><?> <?><?><?><?><?><?><?><?>
           <?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?>
           <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?><?> <?><?> <?><?>
           <?><?> <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?>.
           <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?>
           bt_parse_entry_s() <?><?> <?><?><?> <?><?><?><?>
           <?><?><?><?><?><?><?> <?><?><?><?><?><?>:

              char *  entry_text;
              btshort  options = 0;
              boolean ok;
              AST *   entry_ast;

              while (entry_text = get_more_text ())
              {
                 entry_ast = bt_parse_entry_s (entry_text, NULL, 1, options, &ok);
                 if (ok)
                 {
                    /* ... process entry ... */
                 }
              }

              bt_parse_entry_s (NULL, NULL, 1, options, NULL);    /* cleanup */

           <?><?> <?><?><?> <?><?><?> <?><?> get_more_text()
           <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?> <?><?><?><?>
           <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?>
           <?><?> <?><?><?> <?><?><?> <?><?><?><?><?><?> <?><?>
           <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?> "NULL" <?><?>
           <?><?><?><?><?><?><?><?><?><?><?><?>.

       bt_parse_file ()
              AST * bt_parse_file (char *    filename,
                                   btshort    options,
                                   boolean * status)

           <?><?> <?><?><?><?> <?><?><?><?> BibTeX <?><?> <?><?><?><?> <?>
           <?><?><?><?><?> <?><?><?><?><?><?>. <?><?><?> "filename"
           <?><?><?><?><?> <?><?> "NULL" <?><?> "-" <?><?><?><?><?>
           <?><?><?><?><?> <?><?><?><?><?><?><?><?><?> ("stdin")
           <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?> <?><?><?>
           <?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>
           <?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?>
           <?><?><?>. <?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?><?>
           <?><?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?> "stderr" <?><?><?>
           <?><?><?><?> <?> "NULL" <?><?><?><?><?><?><?><?><?><?><?>.
           <?><?><?><?><?><?><?><?><?><?><?> "options" <?> "status"
           <?><?><?><?><?><?> bt_parse_entry() <?><?><?><?><?>---<?><?><?><?>
           <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?> <?><?>
           <?><?><?><?><?> <?><?> <?><?> <?><?><?><?> <?><?><?><?>
           <?><?><?><?><?> <?><?><?><?><?> *status <?><?><?><?><?> <?><?>
           "FALSE" <?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?><?> <?> <?><?><?><?><?><?><?><?><?>
           <?><?><?><?><?><?> <?><?><?><?> <?><?> bt_parse_entry()
           <?><?><?><?><?><?><?> <?><?><?><?>.

           <?><?><?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?>
           <?><?><?><?><?><?> <?><?> AST<?><?> <?><?> <?><?><?><?><?><?><?><?>
           <?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?><?>
           <?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?>
           <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?> "NULL" <?><?> <?><?><?><?><?><?><?><?><?><?><?>.
           <?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?>
           bt_next_entry() <?><?><?><?><?><?> <?><?><?> <?> <?><?><?>
           <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?>
           <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?>
           <?><?><?> (<?><?> bt_traversal <?><?><?><?><?><?> <?><?><?><?>).

<?><?><?><?><?><?> <?><?><?><?><?><?> (SEE ALSO)
       btparse, bt_postprocess, bt_traversal

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

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