<div dir="ltr"><br><div class="gmail_extra"><br><div class="gmail_quote">On Tue, Sep 27, 2016 at 10:39 AM, Loïc Hoguin <span dir="ltr"><<a href="mailto:essen@ninenines.eu" target="_blank">essen@ninenines.eu</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><span class="">On 09/27/2016 09:44 AM, Kenneth Lundin wrote:<br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
Man pages or not?<br>
-------------------------<br>
<br>
I understand that some of you are using the man pages. But the question<br>
is why are you using them?<br>
Is it because it is easy to type "man lists" or "erl -man lists"? What<br>
if "erl -man lists" pops up in a web-browser window of you choice<br>
instead?, Note that it is exactly the same information shown in the<br>
lists.html and in the man page for lists.<br>
</blockquote>
<br></span>
It would be terrible for many reasons:<br>
<br>
* lack of search; command line manual search is very useful (man -k and others)<br></blockquote><div>I don't think the search has to be worse in the html form, it depends on how we do it.</div><div> </div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
* man pages are readable in 80x24 windows; browsers aren't<br></blockquote><div>Have you tried lynx? a text based web-browser I think our html pages looks quite good in that one.</div><div> </div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
* opening in a separate window is awkward; currently I need to do this to have what I need: Menu key (opens a terminal), "man lists"; with what you suggest I need at least a couple more steps<br>
* if i want to have the manual side by side with the code, I need a different browser or browser window; I already fight with Dialyzer because it runs out of memory on some modules, I don't need the waste browsers add on top of that<br>
<br>
Also note that in the absence of man pages, I'd look first into 'info' or PDF formats before I consider local HTML. HTML is just not practical for manuals.<br>
<br>
I'm also wondering why the intent to remove man/PDF formats. They're already working, it doesn't sound like they would need much maintenance to be kept, they have users, so why consider removing them? It doesn't make much sense to me.</blockquote><div><br></div><div>html, pdf and man are 3 different backends for generating documentation of course it will cost more to maintain and develop 3 backends instead of 1 or 2. This is especially true if new features are introduced in the document source format or if we even change the format completely.</div><div><br></div><div>But this is just a possibility (to remove formats that are not so much used) , no decision is taken.</div><div><br></div><div>Interesting would be to know how many % of the users that actually are using the man and pdf pages.</div><div><br></div><div>/Kenneth, Erlang/OTP Ericsson</div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><span class="im HOEnZb"><br>
<br>
-- <br>
Loïc Hoguin<br>
<a href="http://ninenines.eu" rel="noreferrer" target="_blank">http://ninenines.eu</a><br>
Author of The Erlanger Playbook,<br>
A book about software development using Erlang<br></span><div class="HOEnZb"><div class="h5">
______________________________<wbr>_________________<br>
erlang-questions mailing list<br>
<a href="mailto:erlang-questions@erlang.org" target="_blank">erlang-questions@erlang.org</a><br>
<a href="http://erlang.org/mailman/listinfo/erlang-questions" rel="noreferrer" target="_blank">http://erlang.org/mailman/list<wbr>info/erlang-questions</a><br>
</div></div></blockquote></div><br></div></div>