pixie-lang / dust

Magic fairy dust for pixie, i.e. tooling around the language.
GNU Lesser General Public License v3.0
93 stars 14 forks source link

`dust doc` improvements #29

Open heyLu opened 8 years ago

heyLu commented 8 years ago

dust doc exists now, thanks to @alekcz. Here are a few possible improvements to it. (Feel free to work on any of these, or add more, just say so in a comment.)

alekcz commented 8 years ago

Strange output? What does the output look like?

heyLu commented 8 years ago

The docstring for the same function is repeated multiple times, but with invalid/strange symbols as the names, seemingly one for each namespace.

$ dust doc 'pixie.csp/put!' -all
  pixie.csp/pixie.csp/put!

    Puts the value into the channel, calling the optional callback when the operation has
   completed.

  pixie.uv/pixie.csp/put!

    Puts the value into the channel, calling the optional callback when the operation has
   completed.

  pixie.repl/pixie.csp/put!

    Puts the value into the channel, calling the optional callback when the operation has
   completed.

  pixie.streams/pixie.csp/put!

    Puts the value into the channel, calling the optional callback when the operation has
   completed.

  pixie.ffi-infer/pixie.csp/put!

    Puts the value into the channel, calling the optional callback when the operation has
   completed.

  pixie.io.common/pixie.csp/put!

    Puts the value into the channel, calling the optional callback when the operation has
   completed.

  pixie.io.tty/pixie.csp/put!

    Puts the value into the channel, calling the optional callback when the operation has
   completed.

  pixie.io.tcp/pixie.csp/put!

    Puts the value into the channel, calling the optional callback when the operation has
   completed.

  pixie.io.uv-common/pixie.csp/put!

    Puts the value into the channel, calling the optional callback when the operation has
   completed.

  pixie.io/pixie.csp/put!

    Puts the value into the channel, calling the optional callback when the operation has
   completed.

  pixie.io-blocking/pixie.csp/put!

    Puts the value into the channel, calling the optional callback when the operation has
   completed.

  pixie.fs/pixie.csp/put!

    Puts the value into the channel, calling the optional callback when the operation has
   completed.

  pixie.set/pixie.csp/put!

    Puts the value into the channel, calling the optional callback when the operation has
   completed.

  pixie.string/pixie.csp/put!

    Puts the value into the channel, calling the optional callback when the operation has
   completed.

  pixie.walk/pixie.csp/put!

    Puts the value into the channel, calling the optional callback when the operation has
   completed.
alekcz commented 8 years ago

@heyLu

dust doc  *
dust help  *
dust run *

This results in "deps" being sent as an argument. Any idea why this happens?