axiom-developer
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: [Axiom-developer] Ping: file removals


From: Waldek Hebisch
Subject: Re: [Axiom-developer] Ping: file removals
Date: Tue, 7 Nov 2006 14:18:59 +0100 (CET)

Gabriel Dos Reis wrote:
> "Bill Page" <address@hidden> writes:
> 
> [...]
> 
> | > Documentation in any form is to be desired and it often cannot be
> | > created "from the source".
> | 
> | True. Documentation is not source code but source code i.e. pamphlet
> | files, can be used to create some of the Axiom documentation.
> 
> Indeed.  Let me expand on this.
> We are talking of pamphlet files.  So, the way I read Waldek's use
> of "documentation" is "the produced PDF format (or any other
> processed) file that explains the system".  I did not realize it could
> be parsed as meaning that the pamphlet should be thrown away.  I could
> be wrong and I cannot speak for Waldek, but I certainly did not read
> it as meaning that the pamphlet should be thrown away.  If axiom is
> suffering from something, it is certainly is from lack or documentation.
> 
> It it my belief that the Axiom source code repository should ideally
> contain all of the system explanation that is needed to reproduce,
> say, a PDF format of all that is needed to know, to understand, to
> use, and to extend the system.  If the source code repository in not
> in a state where that is achievable, then the source code repository
> is incomplete, and must be completed.  Consequently, if the corrected 
> bookvol1 cannot be reproduced with current sources, then someone is hiding
> something.  If the source code is complete, then there is no need to
> maintain the PDF format in the source core repository.  That does not
> necesarily mean information is thrown away.
> 

Exactly.


-- 
                              Waldek Hebisch
address@hidden 




reply via email to

[Prev in Thread] Current Thread [Next in Thread]