Received Fri 18 Feb 2005 8:41pm +1100 from Francesco Potorti`: > Package: wajig > Version: 2.0.19-2 > Severity: normal > > Since a few versions ago, wajig has lacked complete documentation. The > README file still reports that complete documentation can be obtained > with `wajig doc', but this is not the case any more. > > This is unfortunate, for many reasons such as: > - I can not access the docs if I am not connected to the network > - access is usually slow from my home, where I have a slow connection > - I can not do a text search on the documentation > - For the future, I have no assurance that the documentation will be > maintained, so I may end up with an undocumented package in the future > > Obviously, these are general reasons why a package should come with > docs, not just a reference to docs available elsewhere. > > Here are possible solutions: > - reinstate the previous situation, where `wajig doc' printed complete > docs > - distribute the package with separate docs
Hi Francesco, Thank you for the comments. All good reasons to keep the documentation with the code. I will migrate to a system of keeping one source for the documentation, but available both on the web and with wajig doc. It will be included in the next release (2.0.24). Regards, Graham -- To UNSUBSCRIBE, email to [EMAIL PROTECTED] with a subject of "unsubscribe". Trouble? Contact [EMAIL PROTECTED]
