Thread overview
Were comes the web documentation come from?
Feb 11, 2006
Lars Ivar Igesund
Feb 12, 2006
Derek Parnell
Feb 12, 2006
Walter Bright
Feb 15, 2006
Walter Bright
February 11, 2006
I'm looking at http://www.digitalmars.com/d/phobos/std_stdio.html and don't find any of these in the source. I grep for "Arguments are" and only the HTML version shows up, no source code generates this.

Does this happen for other documentation as well?

February 11, 2006
Grzegorz Adam Hankiewicz wrote:

> I'm looking at http://www.digitalmars.com/d/phobos/std_stdio.html and don't find any of these in the source. I grep for "Arguments are" and only the HTML version shows up, no source code generates this.
> 
> Does this happen for other documentation as well?

It's generated by DDoc, the -D switch to DMD.
February 12, 2006
The Sat, 11 Feb 2006 19:53:51 +0100, Lars Ivar Igesund wrote:
>> I'm looking at http://www.digitalmars.com/d/phobos/std_stdio.html
> 
> It's generated by DDoc, the -D switch to DMD.

You don't seem to have read completely my post. Open src/phobos/std/stdio.d and tell me where is the documentation.

February 12, 2006
On Sun, 12 Feb 2006 23:19:11 +1100, Grzegorz Adam Hankiewicz <fake@dont.use> wrote:

> The Sat, 11 Feb 2006 19:53:51 +0100, Lars Ivar Igesund wrote:
>>> I'm looking at http://www.digitalmars.com/d/phobos/std_stdio.html
>>
>> It's generated by DDoc, the -D switch to DMD.
>
> You don't seem to have read completely my post. Open
> src/phobos/std/stdio.d and tell me where is the documentation.

I found this in the documentation about DDOC ...

"
If the .d source file starts with the string "Ddoc" then it is treated as general purpose documentation, not as a D code source file. From immediately after the "Ddoc" string to the end of the file or any "Macros:" section forms the document. No automatic highlighting is done to that text, other than highlighting of D code embedded between lines delineated with --- lines. Only macro processing is done.

Much of the D documentation itself is generated this way, including this page. Such documentation is marked at the bottom as being generated by Ddoc.
"


-- 
Derek Parnell
Melbourne, Australia
February 12, 2006
"Grzegorz Adam Hankiewicz" <fake@dont.use> wrote in message news:pan.2006.02.12.12.19.10.356231@dont.use...
> The Sat, 11 Feb 2006 19:53:51 +0100, Lars Ivar Igesund wrote:
>>> I'm looking at http://www.digitalmars.com/d/phobos/std_stdio.html
>>
>> It's generated by DDoc, the -D switch to DMD.
>
> You don't seem to have read completely my post. Open src/phobos/std/stdio.d and tell me where is the documentation.

It isn't there, because I haven't yet converted it to Ddoc style. See std.path which is converted for how it looks.


February 15, 2006
The Sun, 12 Feb 2006 10:02:47 -0800, Walter Bright wrote:
>> Open src/phobos/std/stdio.d and tell me where is the documentation.
> 
> It isn't there, because I haven't yet converted it to Ddoc style. See std.path which is converted for how it looks.

I am wondering if this is some sort of evil recursive joke on me.

February 15, 2006
"Grzegorz Adam Hankiewicz" <fake@dont.use> wrote in message news:pan.2006.02.15.22.42.21.846490@dont.use...
> The Sun, 12 Feb 2006 10:02:47 -0800, Walter Bright wrote:
>>> Open src/phobos/std/stdio.d and tell me where is the documentation.
>>
>> It isn't there, because I haven't yet converted it to Ddoc style. See std.path which is converted for how it looks.
>
> I am wondering if this is some sort of evil recursive joke on me.

LOL! But with 0.147, I did convert std/stdio.d to use Ddoc, and the doc for it is now generated from it.