Captions and labels in listings are mixed

[DamienCassou]

Both the sbabook documentation and old issue say that listings have 2 mandatory arguments, the caption being the second one:

\begin{listing}[float]{ston}{Export into a specific folder}
{
  "title" : "My first document while reading the 5 minutes Pillar tutorial",
  "outputDirectory" : "result"
}
\end{listing}

but, this does not work. I have the impression that this environment expects a third mandatory argument for the label. With no 3rd argument, the listing content is used as the caption, and Export into a specific folder is used as a label. Indeed, in an sbabook example, this is how listings are used:

\begin{listing}{Smalltalk}{lst:fooNewWith}
{A factory method in class \code{Foo}}
Foo class>>with: parameter
  ^ self new
    initializeWith: parameter
\end{listing}

What should I do?

[DamienCassou]

/cc @cdlm

[cdlm]

Use the source, Luke :) Documentation is by definition out of date…

[DamienCassou]

what should pillar output when the author provides a caption and no label? Previously you said that was fine.