Tags: ocaml/odoc
Tags
Release 3.2.1 CHANGES: - Fix #1426, which broke docs in packages including `base` in OCaml 5.5.0 (@jonludlam, #1427) - Fix #1429, which broke docs in packages including `merlin-lib` (@jonludlam, #1430) - Fix #1431, a regression introduced in v3.2.0 (#1433, @jonludlam)
Release 3.2.0 CHANGES: - Allow persistent latex macros in HTML/KaTeX backend (@dlesbre, #1391) - `markdown-generate` command now accepts multiple `.odocl` files in a single invocation, eliminating the need for shell scripting (@davesnx, #1387) - Support for OxCaml (@lukemaurer, @art-w, #1399) - OCaml 5.5.0 support (@panglesd, @xvw, #1406) - Fix compile-time crashing bugs #930 and #1385 (@jonludlam, #1400) - Markdown backend assumes ocaml as langId on declarations - Markdown backend collects all code snippets and render a single code block with comments, rather than split the variants/records per constructor/field - Fix URL remapping for page references (@jonludlam, #1395) - Fix #1396, which broke incrememntal builds (@jonludlam, #1402) - Ensure all warnings turn into errors with --warn-error (@jonludlam, #1402) - Fix missing parentheses for polymorphic arguments (@art-w, #1404)
Release 3.1.0 CHANGES: - Exposed sherlodoc libraries for use in other projects (@jonludlam, #1349) - OCaml 5.4.0 support (@Octachron, #1355) - New arguments to LaTeX generator, --shorten-beyond-depth and --remove-functor-arg-link (@Octachron, #1337) - New experimental markdown generator (@davesnx, #1341) - Remove cmdliner compatibility layer, no longer needed (@dbuenzli, #1328) - Drop support for OCaml < 4.08 (@jonludlam, #1300) - Allow referencing libraries from package added in `odoc-config.sexp` (@panglesd, #1343) - Use full path in heading labels in LaTeX backend (@Octachron, #1332) - Separate page from anchor in LaTeX labels to prevent collisions (@Octachron, #1337) - Fix bug in parsing META files when there are no dependencies (@jonludlam, #1352) - Fix #1335 - incorrect rendering when on medium screen size with no global sidebar (@lukemaurer, #1361) - Fixed generation of occurrences for docs CI (@jonludlam, #1362) - Partial fix for #1369 - ensure that we never create a link to a hidden page (@jonludlam, #1370)
Release 3.0.0 CHANGES: - Hierarchical documentation (@jonludlam, @panglesd, @Julow). Pages can now be organized in a directory tree structure. Relative and absolute references are added: `{!./other_page.label}`, `{!//other_page}`. - Improved sidebar and breadcrumbs navigation (@panglesd, @gpetiot). The documentation pages and the libraries of the entire package are shown on the left sidebar. - Added support for images, videos, audio and other assets. The syntax is `{image!/reference/to/asset}` or `{image:URL}` for images. The syntax for `{video...}` and `{audio...}` is the same. (@panglesd, @EmileTrotignon, #1170, #1171, #1184, #1185) - Search using Sherlodoc (@panglesd, @EmileTrotignon, @Julow). A new search bar that supports full-text and type-based search. - Experimental driver (@jonludlam, @panglesd) The driver builds the documentation for a collection of Opam packages using the newer Odoc features. It supports linking external packages to ocaml.org and markdown files. This is experimental and will break in the future. - Cross-package references (@panglesd, @Julow) Pages and modules from other packages can be referenced: `{!/otherpackage/page}`, `{!/otherpackage/Module.t}`. - Option to remap links to other packages to ocaml.org or other site. See the `--remap` option of the driver or the `--remap-file` option of `odoc html-generate`. (@jonludlam, #1189, #1248) - Option to compute occurrences of use of each identifiers The commands `aggregate-occurrences` and `count-occurrences` are added. (@panglesd, #976, #1076, #1206) - Added an `extract-code` subcommand to extract code blocks from mld/mli files (@panglesd, #1326) - Added the `odoc classify` command (@jonludlam, #1121) Helps driver detecting which modules belong to which libraries. - Added `--warnings-tag` options to the CLI to silence warnings from a unit, even if they end up being raised in another unit through expansion (@jonludlam, #1260) - Add clock emoji before `@since` tag (@yawaramin, #1089) - Navigation for the search bar : use '/' to enter search, up and down arrows to select a result, and enter to follow the selected link. (@EmileTrotignon, #1088) - Fix a big gap between the preamble and the content of a page (@EmileTrotignon, #1147) - Add a marshalled search index consumable by sherlodoc (@EmileTrotignon, @panglesd, #1084) - Allow referencing of polymorphic constructors in polymorphic variant type aliases (@panglesd, #1115) - Added a home icon in the breacrumbs (@panglesd, #1251) It can be disabled with a CLI option. - Add a frontmatter syntax for mld pages (@panglesd, #1187, #1193, #1243, #1246, #1251) Allows to specify the title of a page, the order of sub-pages and other behaviors in the sidebar. - Added `odoc-md` to process standalone Markdown pages (@jonludlam, #1234) - Added CSS selectors to style version and and nav links when they appear within page titles, as produced by odig (@katrinafyi, #1290) - Added support for (local) images in the latex backend (@Octachron, #1297) - The command line interface changed to support the new features. + Packages and libraries: `odoc link` must now be aware of packages and libraries with the `-L libname:path` and `-P pkgname:path` options. The module search path should still be passed with the `-I` option. The current package should be specified with `--current-package=pkgname`. + Hierarchy: `odoc compile` now outputs `.odoc` in the directory tree specified with `--output-dir=DIR` and the parent identifier must be specified with `--parent-id=PARENT`. The option `--source-parent-file` is removed. + Source code: Implementations are compiled with `compile-impl` instead of with `compile`. The options `--cmt=..` and `--source-name=..` are removed. Source code pages are generated with `html-generate-source`. + Assets: The commands `compile-asset`, `html-generate-asset` are added. The option `html-generate --asset` is removed. + Sidebar: The index is built using `compile-index`. The sidebar data is extracted from the index with `sidebar-generate` and passed to `html-generate --sidebar=..`. - The syntax for `@tag` is now delimited (@panglesd, #1239) A `@tag` can now be followed by a paragraph or other elements. - Updated colors for code fragments (@EmileTrotignon, #1023) - Fixed complexity of looking up `.odoc` files (@panglesd, #1075) - Normalize whitespaces in codespans (@gpetiot, #1085) A newline followed by any whitespaces is normalized as one space character. - Reduce size of `Odoc_html_frontend` when compiled to javascript (@EmileTrotignon, #1072) - Overhaul of module-type-of expansions and shadowing code (@jonludlam, #1081) - Output file paths and labels in the man and latex backends changed to avoid name clashes (@Julow, #1191) - Added a `header` field to the json output (@panglesd, #1314) - Changed indentation rules for code block and verbatim content (@panglesd, #1317) - odoc-parser: Store raw content in verbatim and code block, and expose a function to process it (@panglesd, #1325) - Fix variant constructors being hidden if they contain hidden types (@jonludlam, #1105) - Fix rare assertion failure due to optional parameters (@jonludlam, #1272, issue #1001) - Fix resolution of module synopses in {!modules} lists that require --open (@jonludlam, #1104} - Fix top comment not being taken from includes often enough (@panglesd, #1117) - Fixed 404 links from search results (@panglesd, #1108) - Fixed title content not being picked up across pages when rendering references (#1116, @panglesd) - Fix wrong links to standalone comments in search results (#1118, @panglesd) - Remove duplicated or unwanted comments with inline includes (@Julow, #1133) - Fix bug where source rendering would cause odoc to fail completely if it encounters invalid syntax (@jonludlam #1208) - Add missing parentheses in 'val (let*) : ...' (@Julow, #1268) - Fix syntax highlighting not working for very large files (@jonludlam, @Julow, #1277) - Fix backtrace on invalid input in compile-deps (@jonludlam, #1313) - Fix bug in our CSS hitting verbatim blocks in tags (@jonludlam, #1312) - Fix issue #610 where `odoc html-fragment` wasn't rendering headings correctly (@jonludlam, #1306)
Release 3.0.0~beta1 CHANGES: - Hierarchical documentation (@jonludlam, @panglesd, @Julow) Pages can now be organized in a directory tree structure. Relative and absolute references are added: `{!./other_page.label}`, `{!//other_page}`. - Improved sidebar and breadcrumbs navigation (@panglesd, @gpetiot) The documentation pages and the libraries of the entire package are shown on the left sidebar. - Added support for images, videos, audio and other assets The syntax is `{image!/reference/to/asset}` or `{image:URL}` for images. The syntax for `{video...}` and `{audio...}` is the same. (@panglesd, @EmileTrotignon, #1170, #1171, #1184, #1185) - Search using Sherlodoc (@panglesd, @EmileTrotignon, @Julow) A new search bar that supports full-text and type-based search. - Experimental driver (@jonludlam, @panglesd) The driver builds the documentation for a collection of Opam packages using the newer Odoc features. It supports linking external packages to ocaml.org and markdown files. This is experimental and will break in the future. - Cross-package references (@panglesd, @Julow) Pages and modules from other packages can be referenced: `{!/otherpackage/page}`, `{!/otherpackage/Module.t}`. - Option to remap links to other packages to ocaml.org or other site. See the `--remap` option of the driver or the `--remap-file` option of `odoc html-generate`. (@jonludlam, #1189, #1248) - Option to compute occurrences of use of each identifiers The commands `aggregate-occurrences` and `count-occurrences` are added. (@panglesd, #976, #1076, #1206) - Added the `odoc classify` command (@jonludlam, #1121) Helps driver detecting which modules belong to which libraries. - Added `--suppress-warnings` to the CLI to remove warnings from a unit, even if they end up being raised in another unit through expansion (@jonludlam, #1260) - Add clock emoji before `@since` tag (@yawaramin, #1089) - Navigation for the search bar : use '/' to enter search, up and down arrows to select a result, and enter to follow the selected link. (@EmileTrotignon, #1088) - Fix a big gap between the preamble and the content of a page (@EmileTrotignon, #1147) - Add a marshalled search index consumable by sherlodoc (@EmileTrotignon, @panglesd, #1084) - Allow referencing of polymorphic constructors in polymorphic variant type aliases (@panglesd, #1115) - Added a home icon in the breacrumbs (@panglesd, #1251) It can be disabled with a CLI option. - Add a frontmatter syntax for mld pages (@panglesd, #1187, #1193, #1243, #1246, #1251) Allows to specify the title of a page, the order of sub-pages and other behaviors in the sidebar. - Added `odoc-md` to process standalone Markdown pages (@jonludlam, #1234) - The command line interface changed to support the new features. + Packages and libraries: `odoc link` must now be aware of packages and libraries with the `-L libname:path` and `-P pkgname:path` options. The module search path should still be passed with the `-I` option. The current package should be specified with `--current-package=pkgname`. + Hierarchy: `odoc compile` now outputs `.odoc` in the directory tree specified with `--output-dir=DIR` and the parent identifier must be specified with `--parent-id=PARENT`. The option `--source-parent-file` is removed. + Source code: Implementations are compiled with `compile-impl` instead of with `compile`. The options `--cmt=..` and `--source-name=..` are removed. Source code pages are generated with `html-generate-source`. + Assets: The commands `compile-asset`, `html-generate-asset` are added. The option `html-generate --asset` is removed. + Sidebar: The index is built using `compile-index`. The sidebar data is extracted from the index with `sidebar-generate` and passed to `html-generate --sidebar=..`. - The syntax for `@tag` is now delimited (@panglesd, #1239) A `@tag` can now be followed by a paragraph or other elements. - Updated colors for code fragments (@EmileTrotignon, #1023) - Fixed complexity of looking up `.odoc` files (@panglesd, #1075) - Normalize whitespaces in codespans (@gpetiot, #1085) A newline followed by any whitespaces is normalized as one space character. - Reduce size of `Odoc_html_frontend` when compiled to javascript (@EmileTrotignon, #1072) - Overhaul of module-type-of expansions and shadowing code (@jonludlam, #1081) - Output file paths and labels in the man and latex backends changed to avoid name clashes (@Julow, #1191) - Fix variant constructors being hidden if they contain hidden types (@jonludlam, #1105) - Fix rare assertion failure due to optional parameters (@jonludlam, #1272, issue #1001) - Fix resolution of module synopses in {!modules} lists that require --open (@jonludlam, #1104} - Fix top comment not being taken from includes often enough (@panglesd, #1117) - Fixed 404 links from search results (@panglesd, #1108) - Fixed title content not being picked up across pages when rendering references (#1116, @panglesd) - Fix wrong links to standalone comments in search results (#1118, @panglesd) - Remove duplicated or unwanted comments with inline includes (@Julow, #1133) - Fix bug where source rendering would cause odoc to fail completely if it encounters invalid syntax (@jonludlam #1208) - Add missing parentheses in 'val (let*) : ...' (@Julow, #1268) - Fix syntax highlighting not working for very large files (@jonludlam, @Julow, #1277)
Release 2.4.3 CHANGES: - Fix missing katex headers (@panglesd, #1096) - Allow `][` in code blocks, fixing issue #1137 (@Julow, #1149) This was interpreted as "code blocks with result", which now mandates a delimiter: `{delim@lang[ code ]delim[ result ]}` - Fix misprinting of type variables from ml files for OCaml 4.14 and later (multiple occurences of the same type variable could be named differently) (@Octachron, #1173)
Release 2.4.0 CHANGES: - Add support for external search engines (@panglesd, @EmileTrotignon, #972) This includes the generation of an index and the display of the results in the UI (HTML only). - Display 'private' keyword for private type extensions (@gpetiot, #1019) - Allow to omit parent type in constructor reference (@panglesd, @EmileTrotignon, #933) - Warn and exit when table(s) is not closed (@lubegasimon, #1050) - Hint when list(s) is not closed (@lubegasimon, #1050) - Fix crash on functors returning an alias (@Julow, #1046) - Fix rendering of polymorphic variants (@wikku, @panglesd, #971) - Add references to extension declarations (@gpetiot, @panglesd, #949) - Style: Adjusted line height in the TOC to improve readability (@sorawee, #1045) - Style: Remove font fallback to Helvetica, Arial (@Julow, #1028) - Style: Preformatted elements fallback to UA monospace (@toastal, #967) - Style: Sidebar is now stuck to the left of the content instead of the left of the viewport (@EmileTrotignon, #999)
PreviousNext