|
| 1 | +opam-version: "2.0" |
| 2 | +homepage: "https://github.com/ocaml/odoc" |
| 3 | +doc: "https://ocaml.github.io/odoc/" |
| 4 | +bug-reports: "https://github.com/ocaml/odoc/issues" |
| 5 | +license: "ISC" |
| 6 | + |
| 7 | +maintainer: [ |
| 8 | + "Daniel Bünzli <daniel.buenzli@erratique.ch>" |
| 9 | + "Jon Ludlam <jon@recoil.org>" |
| 10 | + "Jules Aguillon <juloo.dsi@gmail.com>" |
| 11 | + "Paul-Elliot Anglès d'Auriac <paul-elliot@tarides.com>" |
| 12 | +] |
| 13 | +authors: [ |
| 14 | + "Anton Bachin <antonbachin@yahoo.com>" |
| 15 | + "Daniel Bünzli <daniel.buenzli@erratique.ch>" |
| 16 | + "David Sheets <sheets@alum.mit.edu>" |
| 17 | + "Jon Ludlam <jon@recoil.org>" |
| 18 | + "Jules Aguillon <juloo.dsi@gmail.com>" |
| 19 | + "Leo White <leo@lpw25.net>" |
| 20 | + "Lubega Simon <lubegasimon73@gmail.com>" |
| 21 | + "Paul-Elliot Anglès d'Auriac <paul-elliot@tarides.com>" |
| 22 | + "Thomas Refis <trefis@janestreet.com>" |
| 23 | +] |
| 24 | +dev-repo: "git+https://github.com/ocaml/odoc.git" |
| 25 | + |
| 26 | +synopsis: "OCaml Documentation Generator" |
| 27 | +description: """ |
| 28 | +**odoc** is a powerful and flexible documentation generator for OCaml. It reads *doc comments*, demarcated by `(** ... *)`, and transforms them into a variety of output formats, including HTML, LaTeX, and man pages. |
| 29 | + |
| 30 | +- **Output Formats:** Odoc generates HTML for web browsing, LaTeX for PDF generation, and man pages for use on Unix-like systems. |
| 31 | +- **Cross-References:** odoc uses the `ocamldoc` markup, which allows to create links for functions, types, modules, and documentation pages. |
| 32 | +- **Link to Source Code:** Documentation generated includes links to the source code of functions, providing an easy way to navigate from the docs to the actual implementation. |
| 33 | +- **Code Highlighting:** odoc automatically highlights syntax in code snippets for different languages. |
| 34 | + |
| 35 | +odoc is part of the [OCaml Platform](https://ocaml.org/docs/platform), the recommended set of tools for OCaml. |
| 36 | +""" |
| 37 | + |
| 38 | + |
| 39 | +depends: [ |
| 40 | + "odoc-parser" {= version} |
| 41 | + "astring" |
| 42 | + "cmdliner" {>= "1.3.0"} |
| 43 | + "cppo" {build & >= "1.1.0"} |
| 44 | + "dune" {>= "3.18.0"} |
| 45 | + "fpath" |
| 46 | + "ocaml" {>= "4.08.0" & < "5.5"} |
| 47 | + "tyxml" {>= "4.4.0"} |
| 48 | + "fmt" |
| 49 | + "crunch" {>= "1.4.1"} |
| 50 | + "ocamlfind" {with-test} |
| 51 | + "yojson" {>= "2.1.0" & with-test} |
| 52 | + "sexplib0" {with-test} |
| 53 | + "conf-jq" {with-test} |
| 54 | + "ppx_expect" {with-test} |
| 55 | + "bos" {with-test} |
| 56 | + "bisect_ppx" {with-test & > "2.5.0"} |
| 57 | +] |
| 58 | + |
| 59 | +conflicts: [ "ocaml-option-bytecode-only" ] |
| 60 | + |
| 61 | +x-extra-doc-deps: [ |
| 62 | + "odoc-driver" {= version} |
| 63 | + "sherlodoc" {= version} |
| 64 | + "odig" |
| 65 | +] |
| 66 | + |
| 67 | +build: [ |
| 68 | + ["dune" "subst"] {dev} |
| 69 | + [ |
| 70 | + "dune" |
| 71 | + "build" |
| 72 | + "-p" |
| 73 | + name |
| 74 | + "-j" |
| 75 | + jobs |
| 76 | + "@install" |
| 77 | + "@runtest" {with-test} |
| 78 | + "@doc" {with-doc} |
| 79 | + ] |
| 80 | +] |
| 81 | +x-maintenance-intent: ["(latest)"] |
| 82 | +url { |
| 83 | + src: "https://github.com/ocaml/odoc/releases/download/3.1.0/odoc-3.1.0.tbz" |
| 84 | + checksum: [ |
| 85 | + "sha256=96db61c593364dc140521e5afeb7d8a44bdf9f95dabaf5f24bf6d3b4d8f68ce6" |
| 86 | + "sha512=d6211bfc3edc674756ace424e1b7cb0fcae8d2105a262e1a341b3b282f9665112314e527196e3174f6b35d8ea143013b61c51468266ec201227ab9605e9436dc" |
| 87 | + ] |
| 88 | +} |
| 89 | +x-commit-hash: "d15dd0ef8e31b3e8861cb7f6835fcb030cd4f43a" |
0 commit comments