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...
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