Displaying 5 results from an estimated 5 matches for "pod2markdown".
2019 Aug 13
2
Re: [PATCH 1/2] Rust bindings: Add long description
> Can you explain which errors did you get? I tried pod2markdown on a
> couple of API longdesc's, and the result seemed OK.
> Most probably we will need to write our own pod2markdown though, as
> pod2markdown does not allow users to customize all the options that
> the Pod::Markdown module has.
Yes. Most of the results seemed OK. But, for exampl...
2019 Aug 13
2
Re: [PATCH 1/2] Rust bindings: Add long description
...n.org/release/Pod-Markdown <https://metacpan.org/release/Pod-Markdown>
> Did you try to use it? What were the results?
Yes. As I mentioned before, it looked pretty good except for some encode-errors.
However, at first, I just translate pod to text by the exisiting function because using
pod2markdown looks a little tricky.
>
>> I did not add the settings of outputting these docs to `/website`.
>> This is because
>> - by publishing this crate to crates.io <http://crates.io/>, users can see the docs in
>> `docs.rs <http://docs.rs/>` like `https://docs.rs/g...
2019 Aug 13
0
Re: [PATCH 1/2] Rust bindings: Add long description
...n <https://metacpan.org/release/Pod-Markdown>
> > Did you try to use it? What were the results?
>
> Yes. As I mentioned before, it looked pretty good except for some encode-errors.
> However, at first, I just translate pod to text by the exisiting function because using
> pod2markdown looks a little tricky.
Can you explain which errors did you get? I tried pod2markdown on a
couple of API longdesc's, and the result seemed OK.
Most probably we will need to write our own pod2markdown though, as
pod2markdown does not allow users to customize all the options that
the Pod::Markdo...
2019 Aug 13
0
Re: [PATCH 1/2] Rust bindings: Add long description
On Tuesday, 13 August 2019 15:02:10 CEST Hiroyuki Katsura wrote:
> > Can you explain which errors did you get? I tried pod2markdown on a
> > couple of API longdesc's, and the result seemed OK.
> > Most probably we will need to write our own pod2markdown though, as
> > pod2markdown does not allow users to customize all the options that
> > the Pod::Markdown module has.
>
> Yes. Most of the resu...
2019 Aug 11
5
[PATCH 1/2] Rust bindings: Add long description
`cargo doc` will generate docs with long descriptions.
I did not add the settings of outputting these docs to `/website`.
This is because
- by publishing this crate to crates.io, users can see the docs in
`docs.rs` like `https://docs.rs/guestfs/<version>/guestfs/`. It is easy
to hold multiple documents corresponding to each version.
- the style of the documents generated by `cargo doc`