pldoc and "Failed to translate to HTML"

[Michael Richter]

I'm getting the message "Failed to translate to HTML" when doing anything in pldoc right now (SWI-Prolog version 7.3.19 for x86_64-linux).  I've attached a minimal example which exhibits the problem.  To illustrate the problem, explode the tarball somewhere and in the directory "pldocbug" run "swipl -g '[debug].'"  Then select the src subdirectory in your browser and watch the following spew across the console: "ERROR: [Thread httpd@4040_3] Failed to translate to HTML: \object_name(module('Some random stuff.'),[module(stuff),(public[junk/2]),directory('/home/michael/Development/Playthings/Prolog/pldocbug/src'),edit(true)])"

I've done a lot of rearranging of things in the various files and directories and can't get away from that message.  I'm not sure what the next step would be.

--

"Perhaps people don't believe this, but throughout all of the discussions of entering China our focus has really been what's best for the Chinese people. It's not been about our revenue or profit or whatnot."
--Sergey Brin, demonstrating the emptiness of the "don't be evil" mantra.

[Michael Richter]

Bump.

[Jan Wielemaker]

The problem is that you put the /** <module> ... header _above_ the
module declaration. That must be below. The general structure is

- file header with license info, etc
- :- module(....)
- :- use_module(...)
- /** <module> Title
Description
- Code

You may opt to put the use_modules below the PlDoc comment.

Cheers --- Jan

On 14/04/16 00:28, Michael Richter wrote:
> Bump.
>
> On 12 April 2016 at 20:22, Michael Richter <ttmri...@gmail.com

> --
> You received this message because you are subscribed to the Google
> Groups "SWI-Prolog" group.
> To unsubscribe from this group and stop receiving emails from it, send
> an email to swi-prolog+...@googlegroups.com
> <mailto:swi-prolog+...@googlegroups.com>.
> Visit this group at https://groups.google.com/group/swi-prolog.
> For more options, visit https://groups.google.com/d/optout.

[Michael Richter]

This is me sighing and cradling my face in my palms.

That was the single thing I didn't try in rearranging and retyping the source.  :(