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.

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

Reply via email to