This mail is an automated notification from the task tracker
of the project: Savane.
/**************************************************************************/
[task #175] Latest Modifications:
Changes by:
Matteo Settenvini <[EMAIL PROTECTED]>
'Date:
Sat 06/26/2004 at 14:36 (GMT)
What | Removed | Added
---------------------------------------------------------------------------
Should Start On | Wed 02/11/2004 at 23:00 | Wed 02/11/2004 at 00:00
Should be Finished on | Sat 02/11/2006 at 23:00 | Sat 02/11/2006 at 00:00
------------------ Additional Follow-up Comments ----------------------------
If I recall correctly, tex2info should do the trick.
Btw, I wasn't purposing to delete the previous existing documentation, but just
to gather it all in one place to produce a complete guide.
Anyway nothing should get deleted/moved until the guide is ready, that's for
sure. The INSTALL.verbose file would be a perfect subject for a "Installing
Savane" chapter, that's why it *could* become redundant after it got written
(if ever :) ).
I could start with something from scratch, but I'll need your help for various
questions I haven't an answer yet.
/**************************************************************************/
[task #175] Full Item Snapshot:
URL: <http://gna.org/task/?func=detailitem&item_id=175>
Project: Savane
Submitted by: Mathieu Roy
On: Fri 02/13/2004 at 18:15
Should Start On: Wed 02/11/2004 at 00:00
Should be Finished on: Sat 02/11/2006 at 00:00
Category: Packaging
Priority: 1 - Later
Resolution: None
Assigned to: None
Percent Complete: 0%
Status: Open
Effort: 0.00
Planned Release:
Summary: real documentation
Original Submission: A real documentation from Savane, site admin oriented,
non-site-specific should be written.. probably from scratch. Maybe still in
texinfo, but I do not find that format so wonderfull...
Follow-up Comments
------------------
-------------------------------------------------------
Date: Sat 06/26/2004 at 14:36 By: Matteo Settenvini <tchernobog>
If I recall correctly, tex2info should do the trick.
Btw, I wasn't purposing to delete the previous existing documentation, but just
to gather it all in one place to produce a complete guide.
Anyway nothing should get deleted/moved until the guide is ready, that's for
sure. The INSTALL.verbose file would be a perfect subject for a "Installing
Savane" chapter, that's why it *could* become redundant after it got written
(if ever :) ).
I could start with something from scratch, but I'll need your help for various
questions I haven't an answer yet.
-------------------------------------------------------
Date: Sat 06/26/2004 at 09:49 By: Mathieu Roy <yeupou>
Hum, in fact I am not personally considering replacing INSTALL and
INSTALL.verbose. This documentation does its job and have been improved by
different persons according to their installation experience. Sure, it can
still be improved but removing it or moving it does not seems necessary right
now.
The problem is the lack of general documentation: the documentation inside
specific directories is fine to explain how making something specific working.
But there is no overview, explaining concepts in general, that's the issue.
Such documentation should be split in two part: one for the savane
administrators, the others for the users.
I like LaTeX and I'm not very confident with texinfo, however texinfo seems
better to create html documentation for software. Would you be ok with texinfo?
Otherwise, indeed, using LaTeX is not a problem.
-------------------------------------------------------
Date: Sat 06/26/2004 at 08:59 By: Matteo Settenvini <tchernobog>
Since it has to be written by scratch, and since I'm interested in it, how
about LaTeX, and then a simple Makefile to generate HTML, txt, PDF and whatever
else?
We could move all the documentation to the /doc directory, and INSTALL should
then point to that dir, imo, while INSTALL.verbose would have to be rewritten...
I noticed that some of the (scarce) informations about installation are
redundant.
For detailed info, follow this link:
<http://gna.org/task/?func=detailitem&item_id=175>
_______________________________________________
Message sent via/by Gna!
http://gna.org/
