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.
Is this a problem with the docs build system, or with the IMAP module? Is it incorrect to have a module with just .pike files in it?
Also: After messing with the docos, I'm having trouble forcing my browser to refresh - neither F5 nor Ctrl-F5 shows the newly-documented module under Protocols. Using porn mode (incognito/secure browsing/etc/etc) does work, so it's some sort of caching issue. Any ideas?
ChrisA