www.digitalmars.com         C & C++   DMDScript  

digitalmars.D - Were comes the web documentation come from?

reply Grzegorz Adam Hankiewicz <fake dont.use> writes:
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?
Feb 11 2006
parent reply Lars Ivar Igesund <larsivar igesund.net> writes:
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.
Feb 11 2006
parent reply Grzegorz Adam Hankiewicz <fake dont.use> writes:
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.
Feb 12 2006
next sibling parent "Derek Parnell" <derek psych.ward> writes:
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
Feb 12 2006
prev sibling parent reply "Walter Bright" <newshound digitalmars.com> writes:
"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.
Feb 12 2006
parent reply Grzegorz Adam Hankiewicz <fake dont.use> writes:
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.
Feb 15 2006
parent "Walter Bright" <newshound digitalmars.com> writes:
"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.
Feb 15 2006