Gabriel Dos Reis wrote:
> "Bill Page" <[EMAIL PROTECTED]> 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
[EMAIL PROTECTED]
_______________________________________________
Axiom-developer mailing list
[email protected]
http://lists.nongnu.org/mailman/listinfo/axiom-developer
