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