After making ocamldoc/stdlib_man, some pages (such as Format.3o) are now missing. They were built previously in 4.01, and the corresponding HTML pages in stdlib_html are still present. This points to an issue in the ocamldoc man page backend.

I bisected this to a surprising result: the faulty change is my own commit
"Use a nominal datatype for CamlinternalFormat.format6"
It seems to breaks manpage generation under either trunk or 4.02 -- while totally unrelated.

-man-mini
Generate man pages only for modules, module types, classes and
class types, instead of pages for all elements.

What all these modules have in common, is that there are data constructors of the same names in other modules. When I remove the constructors from the type declarations in their respective .mli files, the man pages of these modules are output as expected.

I have not looked at the ocamldoc code so I've no idea how to fix it, but this one is clearly for Maxence.

When the -man-mini is not given, ocamldoc generates a .3o file for each value,type,..., name. This file lists the occurrences of this name and the module it belongs to. For example, iter.3o will list Bytes.iter, Array.iter, ...

Of course, when a variant constructor has the same name as a module, both should be listed in a common file, for example Format.3o. But with the -man-mini option, only files corresponding to one class [type] or one module [type] are created, hence the missing files. I say "should" because in fact record fields, variant constructors and modules are not listed in such .3o files. (for example, the Format.3o file generated without -man-mini option does not list any elements). I'll add some code to list them, hoping the resulting man page will not be too unpleasant to read.

Fixed in revisions 14901(version/4.02) and 14902(trunk).
When the -man-mini option is passed, only classes, class types, modules and module types are kept to generate .3o files. The previous filter preventing the generation of .3o files containing more than one element is removed.