<div dir="ltr"><div>Hello,</div><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Tue, Dec 14, 2021 at 2:49 PM Sergei Golovan <<a href="mailto:sgolovan@gmail.com">sgolovan@gmail.com</a>> wrote:<br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">Hi Lukas,<br>
<br>
On Mon, Dec 13, 2021 at 2:58 PM Lukas Larsson <<a href="mailto:lukas@erlang.org" target="_blank">lukas@erlang.org</a>> wrote:<br>
><br>
> Hello!<br>
><br>
> Since Erlang/OTP 23 it has been possible to build documentation chunks for use by IDE's to fetch documentation about an Erlang function.<br>
><br>
> I noticed that the debian Erlang packages installs these chunks in /usr/share/doc/erlang-doc/lib/stdlib-*/doc/chunks/.<br>
><br>
> The EEP (<a href="https://www.erlang.org/eeps/eep-0048#part-1-the-docsstorage" rel="noreferrer" target="_blank">https://www.erlang.org/eeps/eep-0048#part-1-the-docsstorage</a>) specifies that the files should be located under app/doc/chunks in the source tree, which for debian would mean /usr/lib/erlang/stdlib-*/doc/chunks/.<br>
><br>
> Can the chunk files be moved to the correct place? And also, I think it would be beneficial for everyone if the chunk files could be installed as part of the erlang-base package instead of the erlang-docs package as then IDEs and similar tools would always have access to them without having to install additional packages.<br>
><br>
<br>
You're right, the chunks are shipped within the erlang-doc package and<br>
are installed into  /usr/share/doc/erlang-doc/lib/*/doc/chunks/ where<br>
* is the library name. But erlang-docs also includes symlink (for<br>
example for stdlib in current stable) /usr/lib/erlang/stdlib-3.14/doc<br>
which points to /usr/share/doc/erlang-doc/lib/stdlib-3.14/doc.<br></blockquote><div><br></div><div>Sorry for the confusion, you are correct. I thought I had triple-checked, but apparently not.</div><div> </div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">
<br>
This means that the chunks should become available to IDEs as long as<br>
the erlang-doc package is installed. I don't think that the chunks<br>
should be included into the packages with libraries themselves, as<br>
they should be kept reasonably minimal, suitable for running code, not<br>
developing it. If you develop code, it seems sensible to me to have<br>
documentation installed.<br></blockquote><div><br></div><div>Yes, maybe you are right. I still think that most users would appreciate the doc chunks being readily available, but maybe the correct place to let them know that they should install it is in the IDE rather than always including it.</div><div> </div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">
<br>
Cheers!<br></blockquote><div><br></div><div>Thanks for your great work with maintaining this package. I'm really looking forward to having Erlang/OTP 24 with doc chunks available in the next debian release!</div><div> </div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">
-- <br>
Sergei Golovan<br>
</blockquote></div></div>