Universal Ctags Support

The Silk compiler repository ships a Universal Ctags configuration for Silk at its root (.ctags).

What It Tags#

The bundled rules recognize:

• fn declarations (including export fn, export default fn when named, and async/task-modified functions),
• let and var bindings (including export let, export var, and let mut),
• ext declarations (including export ext),
• struct, enum, error, interface, and impl declarations,
• package declarations.

These tags are regex-based and intentionally conservative; they do not perform semantic resolution or scope analysis.

Usage (Project-Local)#

To use the Silk rules in a single project:

1. Copy the Silk .ctags file (from the Silk compiler repository root) into your project root.
2. Run:

ctags -R

Universal Ctags will read .ctags automatically and tag *.slk files as Silk.

If your ctags binary is not Universal Ctags, install it first; Exuberant/etags do not support the same configuration format.

If you are working in the Silk compiler repository itself, .ctags is already present at the repository root; you can run ctags -R directly.

Usage (Global)#

To use the Silk rules across multiple projects:

1. Copy the Silk .ctags rules (from the Silk compiler repository root) into your global config (for example ~/.ctags.d/silk.ctags).
2. Run ctags -R in any Silk project.

If you already maintain a global ctags configuration, merge the Silk rules into it instead.