As an example of how to document a language, see Borland's documentation for their Turbo C++ language. Every feature had its own explanation, with examples. The examples were not only brilliantly clear, they were often useful chunks of code in their own right.
On 5/16/16, Hans Ginzel <h...@matfyz.cz> wrote: > Hello! > > Add, please, semantic block "=EXAMPLES" to pod. > http://design.perl6.org/S26.html#Semantic_blocks > > Examples are very often missing in classical man pages. > > Thank you, > Hans >