Skip to content

Conversation

@igitur
Copy link
Contributor

@igitur igitur commented Dec 16, 2025

Simpler Filter Syntax and Documentation Updates

Summary

  • Added syntactic sugar for filter field definitions: field name filter filtername instead of field name * * * filtername
  • Updated documentation to Texinfo 6.8 format
  • Added documentation examples for the new filter syntax

Changes

1. Simpler Filter Syntax (e50643c)

  • Modified src/parserc.c to support field name filter filtername syntax
  • This is equivalent to the existing field name * * * filtername syntax
  • Makes configuration files more readable and intuitive

2. Documentation Updates (a14bce7, 7b2c2f2)

  • Updated HTML documentation generated by Texinfo 6.5 → 6.8
  • Added documentation for the new filter syntax in all formats (HTML, Info, TeXinfo)
  • Included practical examples showing usage:
    filter uppercase "tr '[:lower:]' '[:upper:]'"
    filter datefmt "date -f - '+%Y-%m-%d'"
    
    structure data {
        type separated ,
        record entry {
            field id
            field name filter uppercase
            field date filter datefmt
        }
    }

Benefits

  • Improved readability: Clearer syntax for filter definitions
  • Backward compatible: Old syntax still works
  • Better documentation: Updated examples and modern formatting

@igitur
Copy link
Contributor Author

igitur commented Dec 16, 2025

hi @TimoSavi . After many years, I'm still a loyal user of your tool. I'm unsure whether this will break backwards compatibility, but I'm keen to hear your thoughts. Even if you don't like the syntactic sugar change, I'd love to update the documentation with better examples, which would assist an MCP like Context7 more.

@TimoSavi
Copy link
Owner

TimoSavi commented Jan 5, 2026

hi @igitur , I sorry for later answer and thanks for your contribution (very rare these days for ffe). About filter: It could be done but I am little bit confused about the this change because It breaks the overall notation and is only for one config item. Making documentation better is always welcomed.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants