Erlang/OTP Forums

Author Message

<  Erlang questions mailing list  ~  online documentation

vladdu
Posted: Fri Nov 27, 2009 1:25 pm Reply with quote
User Joined: 28 Feb 2005 Posts: 397 Location: Gothenburg, Sweden
Hi!

I really like the looks of the new documentation.

There is a small thing that was suggested before and that would help a
lot: a search field (hopefully with autocompletion, too). Typing
"li<TAB>:keys" to go to lists:keysearch would be soooo sweet!...

I realize now that generating this is probably the job of the
docbuilder application, which would mean that I can probably submit a
patch myself (if I get to it). Will check that (but if someone else
has faster fingers, I won't hold a grudge Smile.

BTW, a related question: I see that the issue tracker at github is
being used. What is the current policy for reporting bugs? It would be
nice if there was only a single place instead of three (some people
like me do post bug reports here instead of erlang-bugs anyway), for
example if the github tracker could send email notifications to
erlang-bugs.

best regards,
Vlad

________________________________________________________________
erlang-questions mailing list. See http://www.erlang.org/faq.html
erlang-questions (at) erlang.org

Post received from mailinglist
View user's profile Send private message
Guest
Posted: Fri Nov 27, 2009 2:17 pm Reply with quote
Guest
Hi Vlad,

A search facility will come , we will create an index
for this purpose as part of the docbuilding process.

No need to patch the docbuilder application.

/Kenneth Erlang/OTP Ericsson

On Fri, Nov 27, 2009 at 2:23 PM, Vlad Dumitrescu <vladdu55@gmail.com> wrote:
> Hi!
>
> I really like the looks of the new documentation.
>
> There is a small thing that was suggested before and that would help a
> lot: a search field (hopefully with autocompletion, too). Typing
> "li<TAB>:keys" to go to lists:keysearch would be soooo sweet!...
>
> I realize now that generating this is probably the job of the
> docbuilder application, which would mean that I can probably submit a
> patch myself (if I get to it). Will check that (but if someone else
> has faster fingers, I won't hold a grudge Smile.
>
> BTW, a related question: I see that the issue tracker at github is
> being used. What is the current policy for reporting bugs? It would be
> nice if there was only a single place instead of three (some people
> like me do post bug reports here instead of erlang-bugs anyway), for
> example if the github tracker could send email notifications to
> erlang-bugs.
>
> best regards,
> Vlad
>
> ________________________________________________________________
> erlang-questions mailing list. See http://www.erlang.org/faq.html
> erlang-questions (at) erlang.org
>
>

________________________________________________________________
erlang-questions mailing list. See http://www.erlang.org/faq.html
erlang-questions (at) erlang.org

Post received from mailinglist
Guest
Posted: Fri Nov 27, 2009 3:48 pm Reply with quote
Guest
Great news!

Looking forward.

Yan Yan
2009-11-27



From: Kenneth Lundin
Time: 2009-11-27 06:16:53
To: Vlad Dumitrescu
Fw: erlang-questions
Subject: Re: [erlang-questions] online documentation

Hi Vlad,
A search facility will come , we will create an index
for this purpose as part of the docbuilding process.
No need to patch the docbuilder application.
/Kenneth Erlang/OTP Ericsson
On Fri, Nov 27, 2009 at 2:23 PM, Vlad Dumitrescu <vladdu55@gmail.com> wrote:
> Hi!
>
> I really like the looks of the new documentation.
>
> There is a small thing that was suggested before and that would help a
> lot: a search field (hopefully with autocompletion, too). Typing
> "li<TAB>:keys" to go to lists:keysearch would be soooo sweet!...
>
> I realize now that generating this is probably the job of the
> docbuilder application, which would mean that I can probably submit a
> patch myself (if I get to it). Will check that (but if someone else
> has faster fingers, I won't hold a grudge Smile.
>
> BTW, a related question: I see that the issue tracker at github is
> being used. What is the current policy for reporting bugs? It would be
> nice if there was only a single place instead of three (some people
> like me do post bug reports here instead of erlang-bugs anyway), for
> example if the github tracker could send email notifications to
> erlang-bugs.
>
> best regards,
> Vlad
>
> ________________________________________________________________
> erlang-questions mailing list. See http://www.erlang.org/faq.html
> erlang-questions (at) erlang.org
>
>
________________________________________________________________
erlang-questions mailing list. See http://www.erlang.org/faq.html
erlang-questions (at) erlang.org


Post received from mailinglist
Guest
Posted: Wed Dec 02, 2009 10:58 am Reply with quote
Guest
On Fri, Nov 27, 2009 at 03:15:03PM +0100, Kenneth Lundin wrote:
> Hi Vlad,
>
> A search facility will come , we will create an index
> for this purpose as part of the docbuilding process.
>
> No need to patch the docbuilder application.
>
> /Kenneth Erlang/OTP Ericsson

There is a preliminary version of the search facility
now running on the (perliminary) demo site:
Go to http://demo.erlang.org/doc.html and type e.g "keyse"
in the text field in the grey right column, then click the
looking glass button... Comments are welcome.

The same search application should eventually be
possible to run via the OTP webtool application on
your local Erlang/OTP installation as a HTTP
server on your local host.

/ Raimo


>
> On Fri, Nov 27, 2009 at 2:23 PM, Vlad Dumitrescu <vladdu55@gmail.com> wrote:
> > Hi!
> >
> > I really like the looks of the new documentation.
> >
> > There is a small thing that was suggested before and that would help a
> > lot: a search field (hopefully with autocompletion, too). Typing
> > "li<TAB>:keys" to go to lists:keysearch would be soooo sweet!...
> >
> > I realize now that generating this is probably the job of the
> > docbuilder application, which would mean that I can probably submit a
> > patch myself (if I get to it). Will check that (but if someone else
> > has faster fingers, I won't hold a grudge Smile.
> >
> > BTW, a related question: I see that the issue tracker at github is
> > being used. What is the current policy for reporting bugs? It would be
> > nice if there was only a single place instead of three (some people
> > like me do post bug reports here instead of erlang-bugs anyway), for
> > example if the github tracker could send email notifications to
> > erlang-bugs.
> >
> > best regards,
> > Vlad
> >
> > ________________________________________________________________
> > erlang-questions mailing list. See http://www.erlang.org/faq.html
> > erlang-questions (at) erlang.org
> >
> >
>
> ________________________________________________________________
> erlang-questions mailing list. See http://www.erlang.org/faq.html
> erlang-questions (at) erlang.org

--

/ Raimo Niskanen, Erlang/OTP, Ericsson AB

________________________________________________________________
erlang-questions mailing list. See http://www.erlang.org/faq.html
erlang-questions (at) erlang.org

Post received from mailinglist
Guest
Posted: Wed Dec 02, 2009 11:22 am Reply with quote
Guest
On Wed, Dec 02, 2009 at 03:08:05AM -0800, Jayson Vantuyl wrote:
> When I searched for a fully qualified function (i.e. ets:new), it seemed to have an issue URL-decoding the colon, and the search generally didn't like it even when manually adjusted on the next page. Nice start, though.

Currently it searches for names anywhere (functions, modules and applications),
so you can search for `ets', follow to the ets man page and then
scroll down to the `new' function.

Or you can search for `new'.

You can also search for `ets new', which oddly enough
does not give ets:new higher ranking than any other
Whatever:new function...

It sounds like a very nice idea that either `ets:new' or
`ets new' would give higher ranking for a hit on both
module and function (and application). I will forward
the idea to the developers (hope they read this too).

>
> On Dec 2, 2009, at 2:55 AM, Raimo Niskanen wrote:
>
> > On Fri, Nov 27, 2009 at 03:15:03PM +0100, Kenneth Lundin wrote:
> >> Hi Vlad,
> >>
> >> A search facility will come , we will create an index
> >> for this purpose as part of the docbuilding process.
> >>
> >> No need to patch the docbuilder application.
> >>
> >> /Kenneth Erlang/OTP Ericsson
> >
> > There is a preliminary version of the search facility
> > now running on the (perliminary) demo site:
> > Go to http://demo.erlang.org/doc.html and type e.g "keyse"
> > in the text field in the grey right column, then click the
> > looking glass button... Comments are welcome.
> >
> > The same search application should eventually be
> > possible to run via the OTP webtool application on
> > your local Erlang/OTP installation as a HTTP
> > server on your local host.
> >
> > / Raimo
> >
> >
> >>
> >> On Fri, Nov 27, 2009 at 2:23 PM, Vlad Dumitrescu <vladdu55@gmail.com> wrote:
> >>> Hi!
> >>>
> >>> I really like the looks of the new documentation.
> >>>
> >>> There is a small thing that was suggested before and that would help a
> >>> lot: a search field (hopefully with autocompletion, too). Typing
> >>> "li<TAB>:keys" to go to lists:keysearch would be soooo sweet!...
> >>>
> >>> I realize now that generating this is probably the job of the
> >>> docbuilder application, which would mean that I can probably submit a
> >>> patch myself (if I get to it). Will check that (but if someone else
> >>> has faster fingers, I won't hold a grudge Smile.
> >>>
> >>> BTW, a related question: I see that the issue tracker at github is
> >>> being used. What is the current policy for reporting bugs? It would be
> >>> nice if there was only a single place instead of three (some people
> >>> like me do post bug reports here instead of erlang-bugs anyway), for
> >>> example if the github tracker could send email notifications to
> >>> erlang-bugs.
> >>>
> >>> best regards,
> >>> Vlad
> >>>
> >>> ________________________________________________________________
> >>> erlang-questions mailing list. See http://www.erlang.org/faq.html
> >>> erlang-questions (at) erlang.org
> >>>
> >>>
> >>
> >> ________________________________________________________________
> >> erlang-questions mailing list. See http://www.erlang.org/faq.html
> >> erlang-questions (at) erlang.org
> >
> > --
> >
> > / Raimo Niskanen, Erlang/OTP, Ericsson AB
> >
> > ________________________________________________________________
> > erlang-questions mailing list. See http://www.erlang.org/faq.html
> > erlang-questions (at) erlang.org
> >
>
>
>
> --
> Jayson Vantuyl
> kagato@souja.net
>
>
>
>
>

--

/ Raimo Niskanen, Erlang/OTP, Ericsson AB

________________________________________________________________
erlang-questions mailing list. See http://www.erlang.org/faq.html
erlang-questions (at) erlang.org

Post received from mailinglist
ngocdaothanh
Posted: Thu Dec 03, 2009 2:55 am Reply with quote
User Joined: 06 Dec 2008 Posts: 43
This is an impressive improvement.

Currently I am using gotapi, and its API is not the latest:
http://www.gotapi.com/erlang


On Wed, Dec 2, 2009 at 8:20 PM, Raimo Niskanen
<raimo+erlang-questions@erix.ericsson.se> wrote:
> On Wed, Dec 02, 2009 at 03:08:05AM -0800, Jayson Vantuyl wrote:
>> When I searched for a fully qualified function (i.e. ets:new), it seemed to have an issue URL-decoding the colon, and the search generally didn't like it even when manually adjusted on the next page.  Nice start, though.
>
> Currently it searches for names anywhere (functions, modules and applications),
> so you can search for `ets', follow to the ets man page and then
> scroll down to the `new' function.
>
> Or you can search for `new'.
>
> You can also search for `ets new', which oddly enough
> does not give ets:new higher ranking than any other
> Whatever:new function...
>
> It sounds like a very nice idea that either `ets:new' or
> `ets new' would give higher ranking for a hit on both
> module and function (and application). I will forward
> the idea to the developers (hope they read this too).
>
>>
>> On Dec 2, 2009, at 2:55 AM, Raimo Niskanen wrote:
>>
>> > On Fri, Nov 27, 2009 at 03:15:03PM +0100, Kenneth Lundin wrote:
>> >> Hi Vlad,
>> >>
>> >> A search facility will come , we will create an index
>> >> for this purpose as part of the docbuilding process.
>> >>
>> >> No need to patch the docbuilder application.
>> >>
>> >> /Kenneth Erlang/OTP Ericsson
>> >
>> > There is a preliminary version of the search facility
>> > now running on the (perliminary) demo site:
>> > Go to http://demo.erlang.org/doc.html and type e.g "keyse"
>> > in the text field in the grey right column, then click the
>> > looking glass button... Comments are welcome.
>> >
>> > The same search application should eventually be
>> > possible to run via the OTP webtool application on
>> > your local Erlang/OTP installation as a HTTP
>> > server on your local host.
>> >
>> > / Raimo
>> >
>> >
>> >>
>> >> On Fri, Nov 27, 2009 at 2:23 PM, Vlad Dumitrescu <vladdu55@gmail.com> wrote:
>> >>> Hi!
>> >>>
>> >>> I really like the looks of the new documentation.
>> >>>
>> >>> There is a small thing that was suggested before and that would help a
>> >>> lot: a search field (hopefully with autocompletion, too). Typing
>> >>> "li<TAB>:keys" to go to lists:keysearch would be soooo sweet!...
>> >>>
>> >>> I realize now that generating this is probably the job of the
>> >>> docbuilder application, which would mean that I can probably submit a
>> >>> patch myself (if I get to it). Will check that (but if someone else
>> >>> has faster fingers, I won't hold a grudge Smile.
>> >>>
>> >>> BTW, a related question: I see that the issue tracker at github is
>> >>> being used. What is the current policy for reporting bugs? It would be
>> >>> nice if there was only a single place instead of three (some people
>> >>> like me do post bug reports here instead of erlang-bugs anyway), for
>> >>> example if the github tracker could send email notifications to
>> >>> erlang-bugs.
>> >>>
>> >>> best regards,
>> >>> Vlad
>> >>>
>> >>> ________________________________________________________________
>> >>> erlang-questions mailing list. See http://www.erlang.org/faq.html
>> >>> erlang-questions (at) erlang.org
>> >>>
>> >>>
>> >>
>> >> ________________________________________________________________
>> >> erlang-questions mailing list. See http://www.erlang.org/faq.html
>> >> erlang-questions (at) erlang.org
>> >
>> > --
>> >
>> > / Raimo Niskanen, Erlang/OTP, Ericsson AB
>> >
>> > ________________________________________________________________
>> > erlang-questions mailing list. See http://www.erlang.org/faq.html
>> > erlang-questions (at) erlang.org
>> >
>>
>>
>>
>> --
>> Jayson Vantuyl
>> kagato@souja.net
>>
>>
>>
>>
>>
>
> --
>
> / Raimo Niskanen, Erlang/OTP, Ericsson AB
>
> ________________________________________________________________
> erlang-questions mailing list. See http://www.erlang.org/faq.html
> erlang-questions (at) erlang.org
>
>

________________________________________________________________
erlang-questions mailing list. See http://www.erlang.org/faq.html
erlang-questions (at) erlang.org

Post received from mailinglist
View user's profile Send private message Send e-mail
vladdu
Posted: Thu Dec 03, 2009 8:01 am Reply with quote
User Joined: 28 Feb 2005 Posts: 397 Location: Gothenburg, Sweden
On Wed, Dec 2, 2009 at 11:55, Raimo Niskanen
<raimo+erlang-questions@erix.ericsson.se> wrote:
> There is a preliminary version of the search facility
> now running on the (perliminary) demo site:
> Go to http://demo.erlang.org/doc.html and type e.g "keyse"
> in the text field in the grey right column, then click the
> looking glass button... Comments are welcome.

Looking good!

I look forward to an UI similar to gotapi, where the input box shows
the filtered results in real time.

regards,
Vlad

________________________________________________________________
erlang-questions mailing list. See http://www.erlang.org/faq.html
erlang-questions (at) erlang.org

Post received from mailinglist
View user's profile Send private message
Guest
Posted: Thu Dec 03, 2009 9:52 am Reply with quote
Guest
On Thu, Dec 03, 2009 at 11:53:18AM +0900, Ngoc Dao wrote:
> This is an impressive improvement.
>
> Currently I am using gotapi, and its API is not the latest:
> http://www.gotapi.com/erlang

That is a really cool tool. Annoying that they call modules
"class", but anyway impressive...

This site sets a standard that erldoc should strive to
reach, but with the latest documentation!

>
>
> On Wed, Dec 2, 2009 at 8:20 PM, Raimo Niskanen
> <raimo+erlang-questions@erix.ericsson.se> wrote:
> > On Wed, Dec 02, 2009 at 03:08:05AM -0800, Jayson Vantuyl wrote:
> >> When I searched for a fully qualified function (i.e. ets:new), it seemed to have an issue URL-decoding the colon, and the search generally didn't like it even when manually adjusted on the next page.
Guest
Posted: Thu Dec 03, 2009 10:18 am Reply with quote
Guest
On Thu, Dec 03, 2009 at 08:58:14AM +0100, Vlad Dumitrescu wrote:
> On Wed, Dec 2, 2009 at 11:55, Raimo Niskanen
> <raimo+erlang-questions@erix.ericsson.se> wrote:
> > There is a preliminary version of the search facility
> > now running on the (perliminary) demo site:
> > Go to http://demo.erlang.org/doc.html and type e.g "keyse"
> > in the text field in the grey right column, then click the
> > looking glass button... Comments are welcome.
>
> Looking good!
>
> I look forward to an UI similar to gotapi, where the input box shows
> the filtered results in real time.

Well, when you are in the search page, the search result list
is updated in real time. It is not a drop-down menu, though,
and gotapi feels snappier.

Good enough?

>
> regards,
> Vlad
>
> ________________________________________________________________
> erlang-questions mailing list. See http://www.erlang.org/faq.html
> erlang-questions (at) erlang.org

--

/ Raimo Niskanen, Erlang/OTP, Ericsson AB

________________________________________________________________
erlang-questions mailing list. See http://www.erlang.org/faq.html
erlang-questions (at) erlang.org

Post received from mailinglist
vladdu
Posted: Thu Dec 03, 2009 10:27 am Reply with quote
User Joined: 28 Feb 2005 Posts: 397 Location: Gothenburg, Sweden
On Thu, Dec 3, 2009 at 10:50, Raimo Niskanen
<raimo+erlang-questions@erix.ericsson.se> wrote:
> Well, when you are in the search page, the search result list
> is updated in real time. It is not a drop-down menu, though,
> and gotapi feels snappier.
>
> Good enough?

I didn't notice that. It's good enough for me.

Thanks!

regards,
/Vlad

________________________________________________________________
erlang-questions mailing list. See http://www.erlang.org/faq.html
erlang-questions (at) erlang.org

Post received from mailinglist
View user's profile Send private message
Guest
Posted: Thu Dec 03, 2009 10:30 am Reply with quote
Guest
I prefer
http://erlapi.prepor.ru/docs/

It scrolls to selected function and has pretty style.

On Thu, 2009-12-03 at 10:45 +0100, Raimo Niskanen wrote:
> On Thu, Dec 03, 2009 at 11:53:18AM +0900, Ngoc Dao wrote:
> > This is an impressive improvement.
> >
> > Currently I am using gotapi, and its API is not the latest:
> > http://www.gotapi.com/erlang
>
> That is a really cool tool. Annoying that they call modules
> "class", but anyway impressive...
>
> This site sets a standard that erldoc should strive to
> reach, but with the latest documentation!
>
> >
> >
> > On Wed, Dec 2, 2009 at 8:20 PM, Raimo Niskanen
> > <raimo+erlang-questions@erix.ericsson.se> wrote:
> > > On Wed, Dec 02, 2009 at 03:08:05AM -0800, Jayson Vantuyl wrote:
> > >> When I searched for a fully qualified function (i.e. ets:new), it seemed to have an issue URL-decoding the colon, and the search generally didn't like it even when manually adjusted on the next page. Nice start, though.
> > >
> > > Currently it searches for names anywhere (functions, modules and applications),
> > > so you can search for `ets', follow to the ets man page and then
> > > scroll down to the `new' function.
> > >
> > > Or you can search for `new'.
> > >
> > > You can also search for `ets new', which oddly enough
> > > does not give ets:new higher ranking than any other
> > > Whatever:new function...
> > >
> > > It sounds like a very nice idea that either `ets:new' or
> > > `ets new' would give higher ranking for a hit on both
> > > module and function (and application). I will forward
> > > the idea to the developers (hope they read this too).
> > >
> > >>
> > >> On Dec 2, 2009, at 2:55 AM, Raimo Niskanen wrote:
> > >>
> > >> > On Fri, Nov 27, 2009 at 03:15:03PM +0100, Kenneth Lundin wrote:
> > >> >> Hi Vlad,
> > >> >>
> > >> >> A search facility will come , we will create an index
> > >> >> for this purpose as part of the docbuilding process.
> > >> >>
> > >> >> No need to patch the docbuilder application.
> > >> >>
> > >> >> /Kenneth Erlang/OTP Ericsson
> > >> >
> > >> > There is a preliminary version of the search facility
> > >> > now running on the (perliminary) demo site:
> > >> > Go to http://demo.erlang.org/doc.html and type e.g "keyse"
> > >> > in the text field in the grey right column, then click the
> > >> > looking glass button... Comments are welcome.
> > >> >
> > >> > The same search application should eventually be
> > >> > possible to run via the OTP webtool application on
> > >> > your local Erlang/OTP installation as a HTTP
> > >> > server on your local host.
> > >> >
> > >> > / Raimo
> > >> >
> > >> >
> > >> >>
> > >> >> On Fri, Nov 27, 2009 at 2:23 PM, Vlad Dumitrescu <vladdu55@gmail.com> wrote:
> > >> >>> Hi!
> > >> >>>
> > >> >>> I really like the looks of the new documentation.
> > >> >>>
> > >> >>> There is a small thing that was suggested before and that would help a
> > >> >>> lot: a search field (hopefully with autocompletion, too). Typing
> > >> >>> "li<TAB>:keys" to go to lists:keysearch would be soooo sweet!...
> > >> >>>
> > >> >>> I realize now that generating this is probably the job of the
> > >> >>> docbuilder application, which would mean that I can probably submit a
> > >> >>> patch myself (if I get to it). Will check that (but if someone else
> > >> >>> has faster fingers, I won't hold a grudge Smile.
> > >> >>>
> > >> >>> BTW, a related question: I see that the issue tracker at github is
> > >> >>> being used. What is the current policy for reporting bugs? It would be
> > >> >>> nice if there was only a single place instead of three (some people
> > >> >>> like me do post bug reports here instead of erlang-bugs anyway), for
> > >> >>> example if the github tracker could send email notifications to
> > >> >>> erlang-bugs.
> > >> >>>
> > >> >>> best regards,
> > >> >>> Vlad
> > >> >>>
> > >> >>> ________________________________________________________________
> > >> >>> erlang-questions mailing list. See http://www.erlang.org/faq.html
> > >> >>> erlang-questions (at) erlang.org
> > >> >>>
> > >> >>>
> > >> >>
> > >> >> ________________________________________________________________
> > >> >> erlang-questions mailing list. See http://www.erlang.org/faq.html
> > >> >> erlang-questions (at) erlang.org
> > >> >
> > >> > --
> > >> >
> > >> > / Raimo Niskanen, Erlang/OTP, Ericsson AB
> > >> >
> > >> > ________________________________________________________________
> > >> > erlang-questions mailing list. See http://www.erlang.org/faq.html
> > >> > erlang-questions (at) erlang.org
> > >> >
> > >>
> > >>
> > >>
> > >> --
> > >> Jayson Vantuyl
> > >> kagato@souja.net
> > >>
> > >>
> > >>
> > >>
> > >>
> > >
> > > --
> > >
> > > / Raimo Niskanen, Erlang/OTP, Ericsson AB
> > >
> > > ________________________________________________________________
> > > erlang-questions mailing list. See http://www.erlang.org/faq.html
> > > erlang-questions (at) erlang.org
> > >
> > >
> >
> > ________________________________________________________________
> > erlang-questions mailing list. See http://www.erlang.org/faq.html
> > erlang-questions (at) erlang.org
> >
>



________________________________________________________________
erlang-questions mailing list. See http://www.erlang.org/faq.html
erlang-questions (at) erlang.org

Post received from mailinglist
Guest
Posted: Thu Dec 03, 2009 1:10 pm Reply with quote
Guest
On Thu, Dec 03, 2009 at 01:21:23PM +0300, Dmitry Belyaev wrote:
> I prefer
> http://erlapi.prepor.ru/docs/

Yet another nice one. This seems to be a problem
that many want solutions for.

It is also fast, but I can not readily find a quick
way to search for a function name when I do not
know the module. If I type "new" ets:new comes at least
one page down and there is no possibility to filter
for function names only.

Another nice thing on this site is that you get
Application
Module:Function
Short description
already in the search results.

>
> It scrolls to selected function and has pretty style.
>
> On Thu, 2009-12-03 at 10:45 +0100, Raimo Niskanen wrote:
> > On Thu, Dec 03, 2009 at 11:53:18AM +0900, Ngoc Dao wrote:
> > > This is an impressive improvement.
> > >
> > > Currently I am using gotapi, and its API is not the latest:
> > > http://www.gotapi.com/erlang
> >
> > That is a really cool tool. Annoying that they call modules
> > "class", but anyway impressive...
> >
> > This site sets a standard that erldoc should strive to
> > reach, but with the latest documentation!
> >
> > >
> > >
> > > On Wed, Dec 2, 2009 at 8:20 PM, Raimo Niskanen
> > > <raimo+erlang-questions@erix.ericsson.se> wrote:
> > > > On Wed, Dec 02, 2009 at 03:08:05AM -0800, Jayson Vantuyl wrote:
> > > >> When I searched for a fully qualified function (i.e. ets:new), it seemed to have an issue URL-decoding the colon, and the search generally didn't like it even when manually adjusted on the next page. Nice start, though.
> > > >
> > > > Currently it searches for names anywhere (functions, modules and applications),
> > > > so you can search for `ets', follow to the ets man page and then
> > > > scroll down to the `new' function.
> > > >
> > > > Or you can search for `new'.
> > > >
> > > > You can also search for `ets new', which oddly enough
> > > > does not give ets:new higher ranking than any other
> > > > Whatever:new function...
> > > >
> > > > It sounds like a very nice idea that either `ets:new' or
> > > > `ets new' would give higher ranking for a hit on both
> > > > module and function (and application). I will forward
> > > > the idea to the developers (hope they read this too).
> > > >
> > > >>
> > > >> On Dec 2, 2009, at 2:55 AM, Raimo Niskanen wrote:
> > > >>
> > > >> > On Fri, Nov 27, 2009 at 03:15:03PM +0100, Kenneth Lundin wrote:
> > > >> >> Hi Vlad,
> > > >> >>
> > > >> >> A search facility will come , we will create an index
> > > >> >> for this purpose as part of the docbuilding process.
> > > >> >>
> > > >> >> No need to patch the docbuilder application.
> > > >> >>
> > > >> >> /Kenneth Erlang/OTP Ericsson
> > > >> >
> > > >> > There is a preliminary version of the search facility
> > > >> > now running on the (perliminary) demo site:
> > > >> > Go to http://demo.erlang.org/doc.html and type e.g "keyse"
> > > >> > in the text field in the grey right column, then click the
> > > >> > looking glass button... Comments are welcome.
> > > >> >
> > > >> > The same search application should eventually be
> > > >> > possible to run via the OTP webtool application on
> > > >> > your local Erlang/OTP installation as a HTTP
> > > >> > server on your local host.
> > > >> >
> > > >> > / Raimo
> > > >> >
> > > >> >
> > > >> >>
> > > >> >> On Fri, Nov 27, 2009 at 2:23 PM, Vlad Dumitrescu <vladdu55@gmail.com> wrote:
> > > >> >>> Hi!
> > > >> >>>
> > > >> >>> I really like the looks of the new documentation.
> > > >> >>>
> > > >> >>> There is a small thing that was suggested before and that would help a
> > > >> >>> lot: a search field (hopefully with autocompletion, too). Typing
> > > >> >>> "li<TAB>:keys" to go to lists:keysearch would be soooo sweet!...
> > > >> >>>
> > > >> >>> I realize now that generating this is probably the job of the
> > > >> >>> docbuilder application, which would mean that I can probably submit a
> > > >> >>> patch myself (if I get to it). Will check that (but if someone else
> > > >> >>> has faster fingers, I won't hold a grudge Smile.
> > > >> >>>
> > > >> >>> BTW, a related question: I see that the issue tracker at github is
> > > >> >>> being used. What is the current policy for reporting bugs? It would be
> > > >> >>> nice if there was only a single place instead of three (some people
> > > >> >>> like me do post bug reports here instead of erlang-bugs anyway), for
> > > >> >>> example if the github tracker could send email notifications to
> > > >> >>> erlang-bugs.
> > > >> >>>
> > > >> >>> best regards,
> > > >> >>> Vlad
> > > >> >>>
> > > >> >>> ________________________________________________________________
> > > >> >>> erlang-questions mailing list. See http://www.erlang.org/faq.html
> > > >> >>> erlang-questions (at) erlang.org
> > > >> >>>
> > > >> >>>
> > > >> >>
> > > >> >> ________________________________________________________________
> > > >> >> erlang-questions mailing list. See http://www.erlang.org/faq.html
> > > >> >> erlang-questions (at) erlang.org
> > > >> >
> > > >> > --
> > > >> >
> > > >> > / Raimo Niskanen, Erlang/OTP, Ericsson AB
> > > >> >
> > > >> > ________________________________________________________________
> > > >> > erlang-questions mailing list. See http://www.erlang.org/faq.html
> > > >> > erlang-questions (at) erlang.org
> > > >> >
> > > >>
> > > >>
> > > >>
> > > >> --
> > > >> Jayson Vantuyl
> > > >> kagato@souja.net
> > > >>
> > > >>
> > > >>
> > > >>
> > > >>
> > > >
> > > > --
> > > >
> > > > / Raimo Niskanen, Erlang/OTP, Ericsson AB
> > > >
> > > > ________________________________________________________________
> > > > erlang-questions mailing list. See http://www.erlang.org/faq.html
> > > > erlang-questions (at) erlang.org
> > > >
> > > >
> > >
> > > ________________________________________________________________
> > > erlang-questions mailing list. See http://www.erlang.org/faq.html
> > > erlang-questions (at) erlang.org
> > >
> >
>
>
>
> ________________________________________________________________
> erlang-questions mailing list. See http://www.erlang.org/faq.html
> erlang-questions (at) erlang.org

--

/ Raimo Niskanen, Erlang/OTP, Ericsson AB

________________________________________________________________
erlang-questions mailing list. See http://www.erlang.org/faq.html
erlang-questions (at) erlang.org

Post received from mailinglist
daleharvey
Posted: Thu Dec 03, 2009 1:23 pm Reply with quote
User Joined: 14 Sep 2007 Posts: 18
2009/12/3 Raimo Niskanen
<raimo+erlang-questions@erix.ericsson.se<raimo%2Berlang-questions@erix.ericsson.se>
>

> On Thu, Dec 03, 2009 at 01:21:23PM +0300, Dmitry Belyaev wrote:
> > I prefer
> > http://erlapi.prepor.ru/docs/
>
> Yet another nice one. This seems to be a problem
> that many want solutions for.
>

Quite so, theres also mine Smile

http://erldocs.com/R13B03/


>
> It is also fast, but I can not readily find a quick
> way to search for a function name when I do not
> know the module. If I type "new" ets:new comes at least
> one page down and there is no possibility to filter
> for function names only.
>
> Another nice thing on this site is that you get
> Application
> Module:Function
> Short description
> already in the search results.
>
> >
> > It scrolls to selected function and has pretty style.
> >
> > On Thu, 2009-12-03 at 10:45 +0100, Raimo Niskanen wrote:
> > > On Thu, Dec 03, 2009 at 11:53:18AM +0900, Ngoc Dao wrote:
> > > > This is an impressive improvement.
> > > >
> > > > Currently I am using gotapi, and its API is not the latest:
> > > > http://www.gotapi.com/erlang
> > >
> > > That is a really cool tool. Annoying that they call modules
> > > "class", but anyway impressive...
> > >
> > > This site sets a standard that erldoc should strive to
> > > reach, but with the latest documentation!
> > >
> > > >
> > > >
> > > > On Wed, Dec 2, 2009 at 8:20 PM, Raimo Niskanen
> > > > <raimo+erlang-questions@erix.ericsson.se<raimo%2Berlang-questions@erix.ericsson.se>>
> wrote:
> > > > > On Wed, Dec 02, 2009 at 03:08:05AM -0800, Jayson Vantuyl wrote:
> > > > >> When I searched for a fully qualified function (i.e. ets:new), it
> seemed to have an issue URL-decoding the colon, and the search generally
> didn't like it even when manually adjusted on the next page. Nice start,
> though.
> > > > >
> > > > > Currently it searches for names anywhere (functions, modules and
> applications),
> > > > > so you can search for `ets', follow to the ets man page and then
> > > > > scroll down to the `new' function.
> > > > >
> > > > > Or you can search for `new'.
> > > > >
> > > > > You can also search for `ets new', which oddly enough
> > > > > does not give ets:new higher ranking than any other
> > > > > Whatever:new function...
> > > > >
> > > > > It sounds like a very nice idea that either `ets:new' or
> > > > > `ets new' would give higher ranking for a hit on both
> > > > > module and function (and application). I will forward
> > > > > the idea to the developers (hope they read this too).
> > > > >
> > > > >>
> > > > >> On Dec 2, 2009, at 2:55 AM, Raimo Niskanen wrote:
> > > > >>
> > > > >> > On Fri, Nov 27, 2009 at 03:15:03PM +0100, Kenneth Lundin wrote:
> > > > >> >> Hi Vlad,
> > > > >> >>
> > > > >> >> A search facility will come , we will create an index
> > > > >> >> for this purpose as part of the docbuilding process.
> > > > >> >>
> > > > >> >> No need to patch the docbuilder application.
> > > > >> >>
> > > > >> >> /Kenneth Erlang/OTP Ericsson
> > > > >> >
> > > > >> > There is a preliminary version of the search facility
> > > > >> > now running on the (perliminary) demo site:
> > > > >> > Go to http://demo.erlang.org/doc.html and type e.g "keyse"
> > > > >> > in the text field in the grey right column, then click the
> > > > >> > looking glass button... Comments are welcome.
> > > > >> >
> > > > >> > The same search application should eventually be
> > > > >> > possible to run via the OTP webtool application on
> > > > >> > your local Erlang/OTP installation as a HTTP
> > > > >> > server on your local host.
> > > > >> >
> > > > >> > / Raimo
> > > > >> >
> > > > >> >
> > > > >> >>
> > > > >> >> On Fri, Nov 27, 2009 at 2:23 PM, Vlad Dumitrescu <
> vladdu55@gmail.com> wrote:
> > > > >> >>> Hi!
> > > > >> >>>
> > > > >> >>> I really like the looks of the new documentation.
> > > > >> >>>
> > > > >> >>> There is a small thing that was suggested before and that
> would help a
> > > > >> >>> lot: a search field (hopefully with autocompletion, too).
> Typing
> > > > >> >>> "li<TAB>:keys" to go to lists:keysearch would be soooo
> sweet!...
> > > > >> >>>
> > > > >> >>> I realize now that generating this is probably the job of the
> > > > >> >>> docbuilder application, which would mean that I can probably
> submit a
> > > > >> >>> patch myself (if I get to it). Will check that (but if someone
> else
> > > > >> >>> has faster fingers, I won't hold a grudge Smile.
> > > > >> >>>
> > > > >> >>> BTW, a related question: I see that the issue tracker at
> github is
> > > > >> >>> being used. What is the current policy for reporting bugs? It
> would be
> > > > >> >>> nice if there was only a single place instead of three (some
> people
> > > > >> >>> like me do post bug reports here instead of erlang-bugs
> anyway), for
> > > > >> >>> example if the github tracker could send email notifications
> to
> > > > >> >>> erlang-bugs.
> > > > >> >>>
> > > > >> >>> best regards,
> > > > >> >>> Vlad
> > > > >> >>>
> > > > >> >>>
> ________________________________________________________________
> > > > >> >>> erlang-questions mailing list. See
> http://www.erlang.org/faq.html
> > > > >> >>> erlang-questions (at) erlang.org
> > > > >> >>>
> > > > >> >>>
> > > > >> >>
> > > > >> >>
> ________________________________________________________________
> > > > >> >> erlang-questions mailing list. See
> http://www.erlang.org/faq.html
> > > > >> >> erlang-questions (at) erlang.org
> > > > >> >
> > > > >> > --
> > > > >> >
> > > > >> > / Raimo Niskanen, Erlang/OTP, Ericsson AB
> > > > >> >
> > > > >> > ________________________________________________________________
> > > > >> > erlang-questions mailing list. See
> http://www.erlang.org/faq.html
> > > > >> > erlang-questions (at) erlang.org
> > > > >> >
> > > > >>
> > > > >>
> > > > >>
> > > > >> --
> > > > >> Jayson Vantuyl
> > > > >> kagato@souja.net
> > > > >>
> > > > >>
> > > > >>
> > > > >>
> > > > >>
> > > > >
> > > > > --
> > > > >
> > > > > / Raimo Niskanen, Erlang/OTP, Ericsson AB
> > > > >
> > > > > ________________________________________________________________
> > > > > erlang-questions mailing list. See http://www.erlang.org/faq.html
> > > > > erlang-questions (at) erlang.org
> > > > >
> > > > >
> > > >
> > > > ________________________________________________________________
> > > > erlang-questions mailing list. See http://www.erlang.org/faq.html
> > > > erlang-questions (at) erlang.org
> > > >
> > >
> >
> >
> >
> > ________________________________________________________________
> > erlang-questions mailing list. See http://www.erlang.org/faq.html
> > erlang-questions (at) erlang.org
>
> --
>
> / Raimo Niskanen, Erlang/OTP, Ericsson AB
>
> ________________________________________________________________
> erlang-questions mailing list. See http://www.erlang.org/faq.html
> erlang-questions (at) erlang.org
>
>


Post received from mailinglist
View user's profile Send private message
Guest
Posted: Thu Dec 03, 2009 2:53 pm Reply with quote
Guest
On Dec 3, 2009, at 7:22 AM, Dale Harvey wrote:

> 2009/12/3 Raimo Niskanen
> <raimo+erlang-questions@erix.ericsson.se<raimo%2Berlang-questions@erix.ericsson.se>
>>
>
>> On Thu, Dec 03, 2009 at 01:21:23PM +0300, Dmitry Belyaev wrote:
>>> I prefer
>>> http://erlapi.prepor.ru/docs/
>>
>> Yet another nice one. This seems to be a problem
>> that many want solutions for.
>>
>
> Quite so, theres also mine Smile
>
> http://erldocs.com/R13B03/

Wow, I'm bookmarking that one.

Post received from mailinglist
Guest
Posted: Thu Dec 03, 2009 2:55 pm Reply with quote
Guest
Both http://erlapi.prepor.ru/docs/ and http://erldocs.com/R13B03/
seem to be incomplete. Searching for erl_nif for instance has no results.
Neither do they find any of the driver_* functions in erts.


Sergej


On Thu, Dec 3, 2009 at 2:22 PM, Dale Harvey <dale@arandomurl.com> wrote:

> 2009/12/3 Raimo Niskanen
> <raimo+erlang-questions@erix.ericsson.se<raimo%2Berlang-questions@erix.ericsson.se>
> <raimo%2Berlang-questions@erix.ericsson.se<raimo%252Berlang-questions@erix.ericsson.se>
> >
> >
>
> > On Thu, Dec 03, 2009 at 01:21:23PM +0300, Dmitry Belyaev wrote:
> > > I prefer
> > > http://erlapi.prepor.ru/docs/
> >
> > Yet another nice one. This seems to be a problem
> > that many want solutions for.
> >
>
> Quite so, theres also mine Smile
>
> http://erldocs.com/R13B03/
>
>
> >
> > It is also fast, but I can not readily find a quick
> > way to search for a function name when I do not
> > know the module. If I type "new" ets:new comes at least
> > one page down and there is no possibility to filter
> > for function names only.
> >
> > Another nice thing on this site is that you get
> > Application
> > Module:Function
> > Short description
> > already in the search results.
> >
> > >
> > > It scrolls to selected function and has pretty style.
> > >
> > > On Thu, 2009-12-03 at 10:45 +0100, Raimo Niskanen wrote:
> > > > On Thu, Dec 03, 2009 at 11:53:18AM +0900, Ngoc Dao wrote:
> > > > > This is an impressive improvement.
> > > > >
> > > > > Currently I am using gotapi, and its API is not the latest:
> > > > > http://www.gotapi.com/erlang
> > > >
> > > > That is a really cool tool. Annoying that they call modules
> > > > "class", but anyway impressive...
> > > >
> > > > This site sets a standard that erldoc should strive to
> > > > reach, but with the latest documentation!
> > > >
> > > > >
> > > > >
> > > > > On Wed, Dec 2, 2009 at 8:20 PM, Raimo Niskanen
> > > > > <raimo+erlang-questions@erix.ericsson.se<raimo%2Berlang-questions@erix.ericsson.se>
> <raimo%2Berlang-questions@erix.ericsson.se<raimo%252Berlang-questions@erix.ericsson.se>
> >>
> > wrote:
> > > > > > On Wed, Dec 02, 2009 at 03:08:05AM -0800, Jayson Vantuyl wrote:
> > > > > >> When I searched for a fully qualified function (i.e. ets:new),
> it
> > seemed to have an issue URL-decoding the colon, and the search generally
> > didn't like it even when manually adjusted on the next page. Nice start,
> > though.
> > > > > >
> > > > > > Currently it searches for names anywhere (functions, modules and
> > applications),
> > > > > > so you can search for `ets', follow to the ets man page and then
> > > > > > scroll down to the `new' function.
> > > > > >
> > > > > > Or you can search for `new'.
> > > > > >
> > > > > > You can also search for `ets new', which oddly enough
> > > > > > does not give ets:new higher ranking than any other
> > > > > > Whatever:new function...
> > > > > >
> > > > > > It sounds like a very nice idea that either `ets:new' or
> > > > > > `ets new' would give higher ranking for a hit on both
> > > > > > module and function (and application). I will forward
> > > > > > the idea to the developers (hope they read this too).
> > > > > >
> > > > > >>
> > > > > >> On Dec 2, 2009, at 2:55 AM, Raimo Niskanen wrote:
> > > > > >>
> > > > > >> > On Fri, Nov 27, 2009 at 03:15:03PM +0100, Kenneth Lundin
> wrote:
> > > > > >> >> Hi Vlad,
> > > > > >> >>
> > > > > >> >> A search facility will come , we will create an index
> > > > > >> >> for this purpose as part of the docbuilding process.
> > > > > >> >>
> > > > > >> >> No need to patch the docbuilder application.
> > > > > >> >>
> > > > > >> >> /Kenneth Erlang/OTP Ericsson
> > > > > >> >
> > > > > >> > There is a preliminary version of the search facility
> > > > > >> > now running on the (perliminary) demo site:
> > > > > >> > Go to http://demo.erlang.org/doc.html and type e.g "keyse"
> > > > > >> > in the text field in the grey right column, then click the
> > > > > >> > looking glass button... Comments are welcome.
> > > > > >> >
> > > > > >> > The same search application should eventually be
> > > > > >> > possible to run via the OTP webtool application on
> > > > > >> > your local Erlang/OTP installation as a HTTP
> > > > > >> > server on your local host.
> > > > > >> >
> > > > > >> > / Raimo
> > > > > >> >
> > > > > >> >
> > > > > >> >>
> > > > > >> >> On Fri, Nov 27, 2009 at 2:23 PM, Vlad Dumitrescu <
> > vladdu55@gmail.com> wrote:
> > > > > >> >>> Hi!
> > > > > >> >>>
> > > > > >> >>> I really like the looks of the new documentation.
> > > > > >> >>>
> > > > > >> >>> There is a small thing that was suggested before and that
> > would help a
> > > > > >> >>> lot: a search field (hopefully with autocompletion, too).
> > Typing
> > > > > >> >>> "li<TAB>:keys" to go to lists:keysearch would be soooo
> > sweet!...
> > > > > >> >>>
> > > > > >> >>> I realize now that generating this is probably the job of
> the
> > > > > >> >>> docbuilder application, which would mean that I can probably
> > submit a
> > > > > >> >>> patch myself (if I get to it). Will check that (but if
> someone
> > else
> > > > > >> >>> has faster fingers, I won't hold a grudge Smile.
> > > > > >> >>>
> > > > > >> >>> BTW, a related question: I see that the issue tracker at
> > github is
> > > > > >> >>> being used. What is the current policy for reporting bugs?
> It
> > would be
> > > > > >> >>> nice if there was only a single place instead of three (some
> > people
> > > > > >> >>> like me do post bug reports here instead of erlang-bugs
> > anyway), for
> > > > > >> >>> example if the github tracker could send email notifications
> > to
> > > > > >> >>> erlang-bugs.
> > > > > >> >>>
> > > > > >> >>> best regards,
> > > > > >> >>> Vlad
> > > > > >> >>>
> > > > > >> >>>
> > ________________________________________________________________
> > > > > >> >>> erlang-questions mailing list. See
> > http://www.erlang.org/faq.html
> > > > > >> >>> erlang-questions (at) erlang.org
> > > > > >> >>>
> > > > > >> >>>
> > > > > >> >>
> > > > > >> >>
> > ________________________________________________________________
> > > > > >> >> erlang-questions mailing list. See
> > http://www.erlang.org/faq.html
> > > > > >> >> erlang-questions (at) erlang.org
> > > > > >> >
> > > > > >> > --
> > > > > >> >
> > > > > >> > / Raimo Niskanen, Erlang/OTP, Ericsson AB
> > > > > >> >
> > > > > >> >
> ________________________________________________________________
> > > > > >> > erlang-questions mailing list. See
> > http://www.erlang.org/faq.html
> > > > > >> > erlang-questions (at) erlang.org
> > > > > >> >
> > > > > >>
> > > > > >>
> > > > > >>
> > > > > >> --
> > > > > >> Jayson Vantuyl
> > > > > >> kagato@souja.net
> > > > > >>
> > > > > >>
> > > > > >>
> > > > > >>
> > > > > >>
> > > > > >
> > > > > > --
> > > > > >
> > > > > > / Raimo Niskanen, Erlang/OTP, Ericsson AB
> > > > > >
> > > > > > ________________________________________________________________
> > > > > > erlang-questions mailing list. See
> http://www.erlang.org/faq.html
> > > > > > erlang-questions (at) erlang.org
> > > > > >
> > > > > >
> > > > >
> > > > > ________________________________________________________________
> > > > > erlang-questions mailing list. See http://www.erlang.org/faq.html
> > > > > erlang-questions (at) erlang.org
> > > > >
> > > >
> > >
> > >
> > >
> > > ________________________________________________________________
> > > erlang-questions mailing list. See http://www.erlang.org/faq.html
> > > erlang-questions (at) erlang.org
> >
> > --
> >
> > / Raimo Niskanen, Erlang/OTP, Ericsson AB
> >
> > ________________________________________________________________
> > erlang-questions mailing list. See http://www.erlang.org/faq.html
> > erlang-questions (at) erlang.org
> >
> >
>


Post received from mailinglist

Display posts from previous:  

All times are GMT
Page 1 of 2
Goto page 1, 2  Next
This forum is locked: you cannot post, reply to, or edit topics.

Jump to:  

You cannot post new topics in this forum
You cannot reply to topics in this forum
You cannot edit your posts in this forum
You cannot delete your posts in this forum
You cannot vote in polls in this forum
You cannot attach files in this forum
You cannot download files in this forum