On Fri, Apr 29, 2016 at 12:26 AM, Chris Angelico <ros...@gmail.com> wrote: > On Tue, Apr 19, 2016 at 4:02 AM, Pontus Östlund <pon...@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. ChrisA
