Clarify

Author: Julow

doc/dune

@@ -8,17 +8,8 @@
 
 (documentation
  (package odoc)
- (mld_files
-  contributing
-  driver
-  dune
-  features
-  index
-  interface
-  ocamldoc_differences
-  odoc_for_authors
-  parent_child_spec
-  manpage))
+ (mld_files contributing driver dune features index interface
+   ocamldoc_differences odoc_for_authors parent_child_spec manpage))
 
 (rule
  (alias docgen)

src/odoc/bin/main.ml

@@ -447,8 +447,7 @@ end = struct
     let info ~docs =
       let doc =
         Format.sprintf
-          "Print the files that would be generated by $(i,%s-generate). Works \
-           on both $(i,.odoc) and $(i,.odocl) files."
+          "Print the files that would be generated by $(i,%s-generate)."
           R.renderer.name
       in
       Term.info (R.renderer.name ^ "-targets") ~docs ~doc
@@ -760,12 +759,10 @@ module Depends = struct
     let info ~docs =
       Term.info "link-deps" ~docs
         ~doc:
-          "Lists the packages which need to be in odoc's load path to link the \
-           $(i,.odoc) files in the given directory.\n\
-           The result is not correct in case of forward references. A \
-           conservative approximation is: any link step depends on the result \
-           of all the compile steps that could be targeted by a forward \
-           reference."
+          "Lists a subset of the packages and modules which need to be in \
+           odoc's load path to link the $(i, odoc) files in the given \
+           directory. Additional packages may be required to resolve all \
+           references."
   end
 
   module Odoc_html = struct
@@ -873,12 +870,12 @@ let () =
       Odoc_html.targets ~docs:section_support;
       Odoc_manpage.targets ~docs:section_support;
       Odoc_latex.targets ~docs:section_support;
+      Depends.Compile.(cmd, info ~docs:section_support);
       Targets.Compile.(cmd, info ~docs:section_legacy);
       Html_fragment.(cmd, info ~docs:section_legacy);
       Odoc_html.process ~docs:section_legacy;
       Odoc_manpage.process ~docs:section_legacy;
       Odoc_latex.process ~docs:section_legacy;
-      Depends.Compile.(cmd, info ~docs:section_legacy);
       Depends.Link.(cmd, info ~docs:section_legacy);
       Css.(cmd, info ~docs:section_deprecated);
       Depends.Odoc_html.(cmd, info ~docs:section_deprecated);