Re: Human unreadable documentation - the ugly seam between simple D and complex D

2015-03-28 Thread anonymous via Digitalmars-d
On Friday, 27 March 2015 at 18:38:32 UTC, rumbu wrote: schwartzSort it's a nice name only if you are German. Hardly. The name's just as meaningless on its own. It may be easier for us Germans to remember the spelling, but even we have to memorize that tz, as schwarz (black) is more common a

Re: Human unreadable documentation - the ugly seam between simple D and complex D

2015-03-28 Thread Tobias Pankrath via Digitalmars-d
D has documented unittests (they appear in the docs as if part of the Examples section). The only excuses for example code in Phobos to be untested are supposed to be that it is an incomplete fragment or that it is old code from before we had the feature. — David I added some just

Re: Human unreadable documentation - the ugly seam between simple D and complex D

2015-03-27 Thread Dominikus Dittes Scherkl via Digitalmars-d
On Thursday, 26 March 2015 at 19:32:53 UTC, Idan Arye wrote: The problem, as Andrei Alexandrescu pointed out(http://forum.dlang.org/thread/mdtago$em9$1...@digitalmars.com?page=6#post-mduv1i:242169:241:40digitalmars.com), is learning how to use them. Ideally you'd want to be able to look at a

Re: Human unreadable documentation - the ugly seam between simple D and complex D

2015-03-27 Thread Panke via Digitalmars-d
On Thursday, 26 March 2015 at 21:36:56 UTC, rumbu wrote: On Thursday, 26 March 2015 at 19:45:19 UTC, Alex Parrill wrote: On Thursday, 26 March 2015 at 19:32:53 UTC, Idan Arye wrote: ...snip... So tl;dr; make the template constraints in ddoc less prominent? The new library reference preview

Re: Human unreadable documentation - the ugly seam between simple D and complex D

2015-03-27 Thread CraigDillabaugh via Digitalmars-d
On Friday, 27 March 2015 at 10:10:37 UTC, Dominikus Dittes Scherkl wrote: On Thursday, 26 March 2015 at 19:32:53 UTC, Idan Arye wrote: But when it comes to heavily templated functions - understanding the signature is HARD. It's hard enough for the top programmers that can handle the complex

Re: Human unreadable documentation - the ugly seam between simple D and complex D

2015-03-27 Thread rumbu via Digitalmars-d
On Friday, 27 March 2015 at 13:07:30 UTC, Panke wrote: On Thursday, 26 March 2015 at 21:36:56 UTC, rumbu wrote: On Thursday, 26 March 2015 at 19:45:19 UTC, Alex Parrill wrote: On Thursday, 26 March 2015 at 19:32:53 UTC, Idan Arye wrote: ...snip... So tl;dr; make the template constraints in

Re: Human unreadable documentation - the ugly seam between simple D and complex D

2015-03-27 Thread CraigDillabaugh via Digitalmars-d
On Friday, 27 March 2015 at 14:02:55 UTC, CraigDillabaugh wrote: clip If the function inputs are trivial (ie. takes an integer or basic string) then this isn't an issue. But for functions taking complex inputs it can be a bit baffling for someone new to the language. I must admit when I was

Re: Human unreadable documentation - the ugly seam between simple D and complex D

2015-03-27 Thread Tobias Pankrath via Digitalmars-d
Looked also in the source code to find out that startsWith is locale sensitive, something ignored in phobos. Why would I need a locale for startsWith? Please file a bug, if that's actually needed for unicode strings.

Re: Human unreadable documentation - the ugly seam between simple D and complex D

2015-03-27 Thread Tobias Pankrath via Digitalmars-d
[skip] I'm not a native English speaker, but a range can start with a needle? Where is the haystack? :) Yes the output is awful, but that does not imply some kind of concepts is needed to make the documentation easier to understand. And Python's startsWith makes no use of a protocol. See

Re: Human unreadable documentation - the ugly seam between simple D and complex D

2015-03-27 Thread Shammah Chancellor via Digitalmars-d
On 2015-03-26 19:32:51 +, Idan Arye said: There is a discussion about D vs Go going on in several threads(yey for multithreading!), and one thread is about an article by Gary Willoughby that claims that Go is not suitable for sophisticated

Re: Human unreadable documentation - the ugly seam between simple D and complex D

2015-03-27 Thread Tobias Pankrath via Digitalmars-d
Regarding the scscscshghshshshhswarzThing, here we discuss the readability and accessibility of the documentation, not the power of the library. Every other language will use a variation of sortBy instead of the scscshwcwscThing. I'm happy that D has in the default lib functions like

Re: Human unreadable documentation - the ugly seam between simple D and complex D

2015-03-27 Thread w0rp via Digitalmars-d
On Thursday, 26 March 2015 at 19:45:19 UTC, Alex Parrill wrote: On Thursday, 26 March 2015 at 19:32:53 UTC, Idan Arye wrote: ...snip... So tl;dr; make the template constraints in ddoc less prominent? The new library reference preview under Resources seems to already have this (example:

Re: Human unreadable documentation - the ugly seam between simple D and complex D

2015-03-27 Thread rumbu via Digitalmars-d
On Friday, 27 March 2015 at 14:39:48 UTC, Tobias Pankrath wrote: Looked also in the source code to find out that startsWith is locale sensitive, something ignored in phobos. Why would I need a locale for startsWith? Please file a bug, if that's actually needed for unicode strings. Because

Re: Human unreadable documentation - the ugly seam between simple D and complex D

2015-03-27 Thread Xavier Bigand via Digitalmars-d
Le 27/03/2015 15:02, CraigDillabaugh a écrit : On Friday, 27 March 2015 at 10:10:37 UTC, Dominikus Dittes Scherkl wrote: On Thursday, 26 March 2015 at 19:32:53 UTC, Idan Arye wrote: But when it comes to heavily templated functions - understanding the signature is HARD. It's hard enough for

Re: Human unreadable documentation - the ugly seam between simple D and complex D

2015-03-27 Thread CraigDillabaugh via Digitalmars-d
On Friday, 27 March 2015 at 19:36:23 UTC, Xavier Bigand wrote: Le 27/03/2015 15:02, CraigDillabaugh a écrit : On Friday, 27 March 2015 at 10:10:37 UTC, Dominikus Dittes Scherkl wrote: clip Just a little point : I find some much examples not tested on Internet, so to me examples have to by

Re: Human unreadable documentation - the ugly seam between simple D and complex D

2015-03-27 Thread David Nadlinger via Digitalmars-d
On Friday, 27 March 2015 at 19:44:10 UTC, CraigDillabaugh wrote: That is a good point. Ideally when building a library all the 'examples' in the documentation should be built too to make sure they are still valid. Example code should be marked as such, extracted and run through the compiler

Re: Human unreadable documentation - the ugly seam between simple D and complex D

2015-03-27 Thread rumbu via Digitalmars-d
On Friday, 27 March 2015 at 16:55:34 UTC, Tobias Pankrath wrote: Regarding the scscscshghshshshhswarzThing, here we discuss the readability and accessibility of the documentation, not the power of the library. Every other language will use a variation of sortBy instead of the

Re: Human unreadable documentation - the ugly seam between simple D and complex D

2015-03-27 Thread CraigDillabaugh via Digitalmars-d
On Friday, 27 March 2015 at 19:47:47 UTC, David Nadlinger wrote: On Friday, 27 March 2015 at 19:44:10 UTC, CraigDillabaugh wrote: That is a good point. Ideally when building a library all the 'examples' in the documentation should be built too to make sure they are still valid. Example code

Re: Human unreadable documentation - the ugly seam between simple D and complex D

2015-03-26 Thread Alex Parrill via Digitalmars-d
On Thursday, 26 March 2015 at 19:32:53 UTC, Idan Arye wrote: ...snip... So tl;dr; make the template constraints in ddoc less prominent? The new library reference preview under Resources seems to already have this (example: http://dlang.org/library/std/algorithm/searching/starts_with.html)

Re: Human unreadable documentation - the ugly seam between simple D and complex D

2015-03-26 Thread Steven Schveighoffer via Digitalmars-d
On 3/26/15 3:45 PM, Alex Parrill wrote: On Thursday, 26 March 2015 at 19:32:53 UTC, Idan Arye wrote: ...snip... So tl;dr; make the template constraints in ddoc less prominent? The new library reference preview under Resources seems to already have this (example:

Human unreadable documentation - the ugly seam between simple D and complex D

2015-03-26 Thread Idan Arye via Digitalmars-d
There is a discussion about D vs Go going on in several threads(yey for multithreading!), and one thread is about an article by Gary Willoughby that claims that Go is not suitable for sophisticated programmers(http://forum.dlang.org/thread/mev7ll$mqr$1...@digitalmars.com). What's interesting

Re: Human unreadable documentation - the ugly seam between simple D and complex D

2015-03-26 Thread H. S. Teoh via Digitalmars-d
On Thu, Mar 26, 2015 at 07:32:51PM +, Idan Arye via Digitalmars-d wrote: [...] uint startsWith(alias pred = a == b)(Range doesThisStart, Needles... withOneOfThese); where: Range is an inferred template argument Needles is a variadic inferred template argument

Re: Human unreadable documentation - the ugly seam between simple D and complex D

2015-03-26 Thread rumbu via Digitalmars-d
On Thursday, 26 March 2015 at 19:45:19 UTC, Alex Parrill wrote: On Thursday, 26 March 2015 at 19:32:53 UTC, Idan Arye wrote: ...snip... So tl;dr; make the template constraints in ddoc less prominent? The new library reference preview under Resources seems to already have this (example:

Re: Human unreadable documentation - the ugly seam between simple D and complex D

2015-03-26 Thread Israel via Digitalmars-d
On Thursday, 26 March 2015 at 21:36:56 UTC, rumbu wrote: On Thursday, 26 March 2015 at 19:45:19 UTC, Alex Parrill wrote: On Thursday, 26 March 2015 at 19:32:53 UTC, Idan Arye wrote: ...snip... So tl;dr; make the template constraints in ddoc less prominent? The new library reference preview

Re: Human unreadable documentation - the ugly seam between simple D and complex D

2015-03-26 Thread H. S. Teoh via Digitalmars-d
On Thu, Mar 26, 2015 at 11:05:28PM +, Israel via Digitalmars-d wrote: On Thursday, 26 March 2015 at 21:36:56 UTC, rumbu wrote: On Thursday, 26 March 2015 at 19:45:19 UTC, Alex Parrill wrote: On Thursday, 26 March 2015 at 19:32:53 UTC, Idan Arye wrote: ...snip... So tl;dr; make the