BGLTAGS(1)

πŸ“¦ version 4.7a, in arch rolling, fedora 43, fedora 44

πŸŽ€ NAME πŸŽ€

okay so bestie, meet bgltags β€” she makes a tag file for Emacs ✨ that's literally the whole job description and she eats every time πŸ’…


🌸 SYNOPSIS 🌸

bgltags [ options ] [ objfile [ gmon.out ] ]

πŸ¦‹ DESCRIPTION πŸ¦‹

So the way that bgltags works is: she builds you a tag table file, in a format that emacs(1) actually understands. no cap. 🫢

And she's not out here guessing, she understands the syntax of the Bigloo files. periodt. She reads whatever files you hand her on the command line and writes a tag table β€” defaults to TAGS β€” right into the current working directory. 🏠

Now the file-name lore, listen up:

  • Files you specify with relative file names get recorded in the tag table with file names relative to the directory where the tag table resides. so like, she re-homes them 🧚
  • Files you specify with absolute file names get recorded with absolute file names. no relocation, she stays put πŸ’€

Big caveat, don't skip this one: the program does not recognize the language used in an input file based on its file name and contents. nope, she's not psychic πŸ™ˆ

That's what the --language switch is for β€” it forces parsing of the file names following the switch according to the given language, overriding guesses based on file-name extensions. iconic override behaviour, honestly πŸ‘‘

And one more: source files that are not Scheme are actually processed by the etags program. so she outsources those. delegation queen πŸ’…


✨ OPTIONS ✨

  • -a, --append β€” append to an existing tag file instead of starting fresh. no delete-and-redo energy, she's just adding on 🫢
  • -o tagfile, --output=tagfile β€” the explicit name of the file for the tag table. this one overrides the default TAGS. you name it, she writes it πŸ’–
  • -v β€” print the current version of the program. just a little "hi, this is me" moment 🌈
  • -module β€” generate an entry in the table for each module. because normally module identifiers are not indexed in the tags table. so this is the switch that finally puts them on the map πŸ—ΊοΈβœ¨

πŸ‘€ SEE ALSO πŸ‘€

go read these too, they're all in the same friend group:

bigloo(1), bglafile(1), bgldepend(1), etags(1), emacs(1), bglmco(1), xemacs(1)


πŸ’œ AUTHOR πŸ’œ

Manuel SERRANO, Manuel.Serrano@inria.fr β€” the original main character who made all of this happen πŸ‘‘


okay that's the whole page bestie!! this was General Commands Manual material, version BGLTAGS(1), dated Aug 15 1998 β€” yes she's been serving since the 90s and she's still that girl πŸ’…πŸŽ€βœ¨

πŸ“¦ where this page comes from