LTTng » LTTng-UST

In the manpage, in section BUILDING/LINKING THE TRACEPOINT PROVIDER, the following item is not clear:

- If building a static library for the provider, link the static
  library with "-llttng-ust".

What's the expressed usecase here? It doesn't seem to be possible to link a static library "with" a shared library, and the example doc/examples/hello-static-lib doesn't do this either.

So the steps to build the trace providers as a static library are the same as the ones to embed them into the application, which is the item above this in the manpage:

- Link application with "-ldl".
- If building the provider directly into the application,
  link the application with "-llttng-ust".

Perhaps those three steps should be simplified to:

- Link the application with "-llttng-ust" and "-ldl".

And the example's Makefile specifies this:

LIBS = -ldl -llttng-ust # On Linux
#LIBS = -lc -llttng-ust # On BSD

Maybe this information about BSD should be in the manpage too.

Also, 1.1) and 2) feels weird in this section. Why not 1) and 2)?