Public SourceMage Discussion List

[Benoit PAPILLAULT <benoit.papillault AT sourcemage.org>]

Karsten Behrmann a écrit :

> Hrm. You talking about manpages?
No.

> Those that I rewrote those last days and that were 2 years behind until then? 
> ;)
Good news :-). In which sorcery release are they available. This 
deserves an official annoucement :-)

> Or in-code documentation, which is mostly complete and sucfficient IMHO, but 
> if you want to volunteer...
No.

I'm talking on documenting sorcery as a black box. For instance, I'd 
like to know:

- does resurrect overwrite existing files or not? (The code says no, but 
if there was a documentation that says it should, it would be a bug, 
without a documentation, i just don't know if it is a bug, and since 
nobody is complaining about it, nobody will think its a bug).

- does spell files have to be executable? (The code says yes, but since 
patch applied to grimoire does not handle file rights, some files that 
should be executable according to sorcery source code are not. Maybe its 
a bug again, maybe not).

- does CONFIGURE script is run even if i use "cast -c spell"? (The code 
says yes, ...)

- ... and so on.

That was just the question I had in the top of my head...

Benoit PAPILLAULT, ISO team