BT_MACROS(1)                        btparse                       BT_MACROS(1)


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

<?><?><?><?><?> <?><?><?><?><?> (SYNOPSIS)
          void bt_add_macro_value (AST *  assignment,
                                   btshort options);
          void bt_add_macro_text (char * macro,
                                  char * text,
                                  char * filename,
                                  int    line);

          void bt_delete_macro (char * macro);
          void bt_delete_all_macros (void);

          int bt_macro_length (char *macro);
          char * bt_macro_text (char * macro,
                                char * filename,
                                int line);

<?><?><?><?><?><?><?> (DESCRIPTION)
       btparse <?><?> <?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?> (<?><?><?><?><?><?><?><?><?><?><?><?><?>)
       <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?> BibTeX <?><?><?><?><?><?><?>
       <?><?><?><?><?><?>. <?><?><?> <?><?><?><?> <?><?> <?><?><?><?> <?><?>
       <?><?> <?><?> <?><?><?><?> <<<?><?><?><?><?> <?><?><?><?><?>>>
       (@string) <?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?> <?> <?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?>
       <?><?> <?><?><?><?> <?><?> <?><?><?> <?><?><?> <?> <?><?><?><?> <?><?>
       <?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?>. (<?><?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?>. <?><?> bt_postprocess
       <?><?><?><?><?><?> <?><?><?><?>.) <?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?> btparse<?> <?><?><?><?> bt_cleanup()<?>
       <?><?><?><?><?><?><?><?> <?><?><?>. <?><?><?><?><?><?><?><?><?>
       <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?> bt_delete_macro()
       <?><?> bt_delete_all_macros() <?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?><?> --- <?><?><?><?><?><?><?>
       <?><?><?> <?><?><?> <?><?><?><?><?><?> <?><?><?> --- <?><?><?><?>
       <?><?><?><?><?><?><?><?>.

<?><?><?><?><?> (FUNCTIONS)
       <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?>
       <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?>
       <?><?><?><?><?><?> <?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?> --- <?>
       <?><?> <?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?><?> <?><?><?><?> btparse <?><?><?><?><?><?>
       <?><?><?><?><?><?>.

       bt_add_macro_text ()
              void bt_add_macro_text (char * macro,
                                      char * text,
                                      char * filename,
                                      int    line);

           <?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?><?>
           <?><?> <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?>.
           "macro" <?><?><?> <?><?><?><?><?> <?><?><?><?> <?> "text"
           <?><?><?><?> <?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?> <?><?>
           <?><?> <?><?><?> <?><?><?><?>. "filename" <?> "line"
           <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>
           <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
           <?><?> <?><?><?> <?><?><?><?><?><?><?><?> <?><?><?>
           <?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?> "NULL"
           <?><?> <?><?><?><?> "filename" <?> 0 <?><?> <?><?><?><?> "line"
           <?><?><?><?> <?><?><?><?>. <?><?><?><?> <?><?><?><?><?><?> <?><?>
           <?><?><?> <?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?>
           <?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?><?> <?><?>
           <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>: <?><?><?><?><?>
           <?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?>
           bt_add_macro_text() <?><?><?><?><?><?> <?><?><?><?> <?><?>
           <?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>.

           <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
           <?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>:

              @string{fubar = "Fouled Up Beyond All Recognition"}

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

              bt_add_macro_text ("fubar", "Fouled Up Beyond All Recognition",
                                 filename, line);

           <?><?><?> <?><?><?> <?><?> <?><?><?><?> <?><?><?> <?><?><?><?>
           <?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?> <?><?>
           <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> "fubar" <?><?>
           <?><?> <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>
           <?><?> <?><?> <?><?> <?><?><?><?><?> <?><?><?> <?><?><?>.

       bt_add_macro_value ()
              void bt_add_macro_value (AST *  assignment,
                                       btshort options);

           <?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?>
           <?><?><?><?> <?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>
           <?><?> AST <?><?> <?><?><?> <?><?><?><?><?><?> <?><?>
           <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?>
           <?><?><?> <?> <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
           <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?>
           (<?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
           <?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
           <?><?><?> <?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?><?><?><?>
           <?><?><?>)<?> <?><?><?><?> <?><?><?> <?><?> <?><?><?><?><?>
           <?><?><?>. "assignment" <?><?><?><?> <?><?> <?><?><?> AST
           <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?>
           bt_next_field() <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?>.
           <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
           btparse <?><?> <?><?> <?><?><?><?><?><?><?> "options"
           <?><?><?><?><?><?><?><?><?><?> "options" <?><?> <?><?><?><?><?>
           <?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?>
           <?><?><?><?><?> <?><?> "assignment" <?><?><?><?><?>
           <?><?><?><?><?><?><?><?><?> <?><?><?> <?><?><?>. <?><?><?>
           <?><?><?> <?><?> <?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?>
           <?><?> <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?>
           <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?>
           <?><?> <?><?> <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?> <?><?><?> <?><?><?> <?><?><?><?><?> <?><?>
           <?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
           bt_add_macro_value() <?><?> <?><?> <?><?><?><?><?><?><?>
           <?><?><?><?><?> <?><?><?><?><?> <?><?><?>. <?><?><?>
           <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?>
           <?><?><?> <?><?><?><?><?> 0 <?><?> <?><?><?><?> "options"
           <?><?><?><?><?> <?><?><?><?> --- <?><?><?> <?><?><?>
           <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?>
           <?><?><?><?><?><?> <?><?> <<<?><?><?><?> <?><?><?><?>>>
           <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
           <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?>.

           <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?>
           <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?> <?><?>
           <?><?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?> <?><?>
           <?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?>: <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?>
           <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?>
           <?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?> <?><?><?><?>
           <?><?><?><?><?><?><?> <?> <?><?><?><?><?>
           <?><?><?><?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?>
           (<?><?><?><?><?>) <?><?><?><?><?><?><?>. <?><?><?><?>
           <?><?><?><?><?><?> <?><?><?> btparse <?><?><?>
           <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?>:

              @string{and = " and "}
              @string{jim_n_bob = "James Smith" # and # "Bob Jones"}

           <?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?> "jim_n_bob"
           <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?>
           <?><?><?><?><?> "James Smith and Bob Jones" <?><?><?><?>.
           <?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?>
           <?><?><?><?><?><?> btparse <?><?><?><?> <?><?><?><?><?> "and"
           <?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?>
           <?><?><?><?><?><?><?><?> BibTeX <?><?><?><?><?><?> <?><?><?>:
           <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?>
           <?><?><?> <?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?>
           <?><?><?><?><?> <?><?><?><?><?><?><?><?>. <?><?><?><?>
           <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?> " and
           " <?><?><?><?> <?><?><?><?><?> "jim_n_bob" <?><?><?>
           <?><?><?><?><?><?>. <?><?><?><?><?><?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?> <?><?><?><?><?>
           <?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?>
           <?><?><?><?> <?><?><?> <?> <?><?><?><?><?><?><?><?><?><?><?> <?><?>
           <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?>
           <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?>
           <?><?> <?><?><?><?><?> <?><?> <?><?> <?><?><?><?>
           <?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?><?><?>.

           <?><?><?> <?><?><?><?> bt_add_macro_text() <?><?>
           <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
           <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
           <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?> --- <?><?><?><?><?><?> <?><?><?><?> <?><?><?>
           <?> <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?>
           <?><?><?><?><?><?>.

       bt_delete_macro ()
              void bt_delete_macro (char * macro);

           <?><?> <?><?><?><?><?> <?><?> <?><?> <?><?><?><?>
           <?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?><?>. <?><?><?>
           "macro" <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?>
           <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?>.

       bt_delete_all_macros ()
              void bt_delete_all_macros (void);

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

       bt_macro_length ()
              int bt_macro_length (char *macro);

           <?><?><?> <?><?><?> <?><?><?><?><?><?><?><?><?> <?><?>
           <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?><?><?>. <?><?><?>
           <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?> 0 <?><?> <?><?><?><?><?><?><?><?><?><?><?><?>
           <?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>.

       bt_macro_text ()
              char * bt_macro_text (char * macro,
                                    char * filename,
                                    int line);

           <?><?><?> <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?>
           <?><?><?><?><?><?><?><?><?><?><?>. <?><?><?> <?><?><?><?><?>
           <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>
           <?><?><?><?> <?><?><?><?> <?> "NULL"
           <?><?><?><?><?><?><?><?><?><?><?>. "filename" <?> "line"
           <?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?>
           <?><?><?><?><?><?><?> <?><?><?><?><?><?> (<?><?><?><?>
           <?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?>
           <?><?> <?><?> <?><?><?><?><?> <?><?><?>
           <?><?><?><?><?><?><?><?>)<?> <?><?><?><?> "filename"
           <?><?><?><?><?> "NULL" <?> <?><?><?><?> "line" <?><?><?><?><?> 0
           <?><?> <?><?><?><?> <?><?><?><?>.

<?><?><?><?><?><?> <?><?><?><?><?><?> (SEE ALSO)
       btparse

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

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