dlang.org Library Reference

[foobar]

On Saturday, 22 December 2012 at 23:04:47 UTC, Andrei 
Alexandrescu wrote:
> On 12/22/12 5:10 PM, foobar wrote:
>> On Friday, 21 December 2012 at 21:58:34 UTC, Jacob Carlborg 
>> wrote:
>>> On 2012-12-21 18:05, Andrei Alexandrescu wrote:
>>>
>>>> s/remove/integrate/
>>>> s/ugly/awesome/
>>>
>>> It's ugly that they are manually created. Over 300 lines of 
>>> comments
>>> that the doc generator should be doing automatically. I would 
>>> say that
>>> is far from awesome.
>>
>> I would add to that that duplicating both the FS and the D 
>> module system
>> by yet another method of grouping symbols is a *horrible* 
>> notion reeks
>> of poor design.
>
> What is FS? File system?
>
> Andrei

Yes, FS is the file system. sorry if it wasn't clear.

Any categorization IMO must be made *within* the language and not 
in comments/documentation just as other attributes such as purity 
and constancy are also better served being *within* the language. 
D has plenty of means to accomplish this: code can be organized 
into packages and modules and within a module, free functions can 
be organized within stateless structs for additional namespace 
categorization.

Using an all encompassing "algorithms" module is also unhelpful 
as all code is essentially an algorithm to accomplish some task. 
This is akin to opening a store called - "A store" or perhaps "A 
place to sell you stuff".
As a client of said shop, I want a better description if I to buy 
at the shop. Even a general "Clothes shop" is already much 
better. For 3rd party it also often makes sense to have a brand 
name - e.g we all know what "vibe.d" is all about.