[Moin-user] Adding a page to a category

[Thomas Waldmann]

> The help on categories (HelpOnCategories) says that to create a category
> you simply write its name on a page. Strictly speaking this is
> sufficient to create a category but it is not sufficient for finding the
> page again by the <<FullSearch(category:CategorySamples)>> macro like it
> is suggested on the help page.
> 
> I took a quick look at the code in queryparser.py and it seems like the
> macro only finds categories if they appear below a horizontal rule and
> possibly some comments.
> 
> Should the help page be changed to indicate the stricter rules of
> queryparser.py or is the help page correct and should the code be changed?

The help page should be changed.

That additinal criteria were introduced to avoid pages just linking to
the category page to be automatically included in the category, e.g. if
you just tell "Look at FooCategory." - that links, but is not
FooCategory itself.