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/


_______________________________________________
Savane-dev mailing list
[EMAIL PROTECTED]
https://mail.gna.org/listinfo/savane-dev

Reply via email to