28 apr. 2016 kl. 16:28 skrev Chris Angelico <rosuav@gmail.com>:

On Fri, Apr 29, 2016 at 12:26 AM, Chris Angelico <rosuav@gmail.com> wrote:

On Tue, Apr 19, 2016 at 4:02 AM, Pontus Östlund <pontus@roxen.com> wrote:

Module refdoc:
http://poppa.github.io/pikedoc/

Just run into a strangeness in the new docs. It appears that a module
that consists of a pmod directory without a module.pmod inside it
doesn't get documented. (I don't have the old docs handy to see if
that was previously the case too, so this may not be a regression.)
Consequently, there's no docs for Protocols.IMAP here:

http://pike.lysator.liu.se/generated/manual/modref/ex/predef_3A_3A/Protocols.html

Creating a tiny file lib/modules/Protocols.pmod/IMAP.pmod/module.pmod
(consisting of one line of docs eg "//! IMAP (Internet Message Access
Protocol)") results in the entire module being documented.

Hmm, correction: The rest of the module isn't documented, still. Will
have to add actual docs to all the classes before that can be called a
bug.