This macro - as you might assume because of it's name - displays a counter of all comments of a story. So, using it like this:

<% story.commentcounter %>

will result in "0 comments", "1 comment" or "341 comments", depending on the number of comments of a story. You can change the text following the number by using the following attributes:

- text to display if there's no comment
- text to display if there's just one comment
- text to display if there're more than one comments

so (as a quite silly example) your commentcounter-macro might look like this:

<% story.commentcounter no=", absolultely nothing" one=", solamente uno" more=", quite a bunch, isn't it?" %>

The whole text will be linked to the main view of the story, and there's another attribute that you can (and probably will) use, it's called "anchor". By adding anchor="comments" a user will jump directly to the first comment.

It should say "By adding anchor="comments" a user will jump directly to the first comment." for anchor to work

is it somehow possible to change the word "comments" itsself, that automatically results when you use [ story.commentcounter ]?

let's say "blahs" instead of comments, so that you get "2 blahs", "312 blahs" etc.

because [ story.commentcounter text="blah" ] doesn't seem to work.