Re: [Caml-list] [MirageOS-devel] [RE-ANN] From opkg to odig v0.0.1 (was Re: [ANN] opkg v0.0.1 - Documentation access improvements)

[Fabrice Le Fessant <Fabrice.Le_fessant@inria.fr>]

[-- Attachment #1: Type: text/plain, Size: 2458 bytes --]

Hi,

  Looking briefly at the two websites, the differences are not obvious. Could
you describe a little the differences between the two tools ? Is one of
them more precise than the other one ? Is one of them easier to use ?

FWIW, `ocp-browser` can also be used to browse the API/documentation of
installed packages in a terminal: see a screenshot at
https://www.typerex.org/ocp-index.html#ocp-browser

--Fabrice

On Thu, Sep 29, 2016 at 5:14 PM Anil Madhavapeddy <anil@recoil.org> wrote:

> Dear all,
>
> I have deployed an experimental documentation build for MirageOS libraries
> (and dependencies thereof) using odig at:
>
> http://docs.mirage.io
>
> an experimental build using odoc (the new cross-referencing tool that is
> still being worked on, so expected rendering bugs) is available under:
>
> http://docs.mirage.io/odoc/
>
> These URLs are all subject to change, but I thought it might be useful to
> see the generated output for a real project.  The Dockerfile that generates
> this site is at:
> https://github.com/mirage/mirage/blob/master/Dockerfile.doc
>
> regards,
> Anil
>
> > On 27 Sep 2016, at 20:34, Daniel Bünzli <daniel.buenzli@erratique.ch>
> wrote:
> >
> > Hello,
> >
> > Due to concerns over a binary name clash with OpenWRT's package manager
> [1], the opkg project
> > was renamed to odig.
> >
> >  http://erratique.ch/software/odig
> >
> > If you have installed opkg the way out is:
> >
> > opkg cache clear
> > opam remove opkg
> > opam update && opam install odig
> > odig ocamldoc
> > odig doc
> >
> > Thanks to David Kaloper Meršinjak and Peter Zotov for raising
> > the issue.
> >
> > Sorry for the inconvenience and happy doc digging,
> >
> > Daniel
> >
> > P.S. To package devs if there are issues with the way your docs get
> rendered please get in touch on the issue tracker (if that's not due to
> your package install or an ocamldoc issue itself).
> >
> > [1] https://wiki.openwrt.org/doc/techref/opkg
> >
> > _______________________________________________
> > MirageOS-devel mailing list
> > MirageOS-devel@lists.xenproject.org
> > https://lists.xenproject.org/cgi-bin/mailman/listinfo/mirageos-devel
>
>
> --
> Caml-list mailing list.  Subscription management and archives:
> https://sympa.inria.fr/sympa/arc/caml-list
> Beginner's list: http://groups.yahoo.com/group/ocaml_beginners
> Bug reports: http://caml.inria.fr/bin/caml-bugs

[-- Attachment #2: Type: text/html, Size: 4119 bytes --]