On 14 Aug, GOTO Kentaro wrote:
> Hi, 
> 
> In message "[ruby-talk:00655] Your wish is fulfilled (erhm, almost ;-)"
>     on 99/08/12, Clemens Hintze <c.hintze / gmx.net> writes:
> 

[...]

>>What do you think?
> 
> Well, my favorite is hierarchy by ruby block because the semantics is
> clear and also it can be easily indented. But your proposal is not
> bad, I can agree it.

Perhaps I can allow to give a block to the section command, so it could
be used both, as I like and as you like it?

But please tell me then, what the semantik is? What happens with the
internal counters after reaching the end of the block? As I have
forseen now, the counters will be accumulated until you end all with
`end_tests'. What would happens in that example...

	start_tests
	
	section "Strings" do
	    section "Assignment" do
	        ok ...
	        ok ...
	    end
	    section "Concatenation" do
	        ok ...
	        ok ...
	    end
	end

	end_tests

Here I could forget about the header level, as the level would be clear
from the block. But would you agree, that the counter would accumulated
until reaching `end_tests' or what have you in mind?

I don't think it makes sense to have a summary after every `end'.

[...]

> Today, another version of rd2html was posted. Check it out:
> 
> ftp://ftp.netlab.co.jp/pub/lang/ruby/in.coming/rdtool-0.1.2.tar.gz
> 

Thas was your fault ;-) Now I have seen what is possible with rd2html.
Beginning to write my docs, I was not aware about the possibilities.
Now I have to rewrite my docs to use rd2html's possibilities. So it will
take a little bit time yet :-)))

BTW: Is there any format recommendation for rd-docs? What sections
should contained? What info? What cames first, what last, ... etc. pp.?

[...]

> -- gotoken

\cle