Return-Path: Mailing-List: contact ant-dev-help@jakarta.apache.org; run by ezmlm Delivered-To: mailing list ant-dev@jakarta.apache.org Received: (qmail 48714 invoked from network); 7 Feb 2001 19:35:39 -0000 Received: from hoemail2.lucent.com (HELO hoemail2.firewall.lucent.com) (192.11.226.163) by h31.sny.collab.net with SMTP; 7 Feb 2001 19:35:39 -0000 Received: from hoemail2.firewall.lucent.com (localhost [127.0.0.1]) by hoemail2.firewall.lucent.com (Pro-8.9.3/8.9.3) with ESMTP id OAA26534 for ; Wed, 7 Feb 2001 14:35:35 -0500 (EST) Received: from nj0117exch001p.wins.lucent.com (h135-5-177-157.lucent.com [135.5.177.157]) by hoemail2.firewall.lucent.com (Pro-8.9.3/8.9.3) with ESMTP id OAA26524 for ; Wed, 7 Feb 2001 14:35:35 -0500 (EST) Received: by nj0117exch001p.wh.lucent.com with Internet Mail Service (5.5.2650.21) id ; Wed, 7 Feb 2001 14:35:34 -0500 Message-ID: From: "Liu, Kenneth Albert (Kenneth)** CTR **" To: ant-dev@jakarta.apache.org Subject: RE: New manual organization - printing is sometimes useful Date: Wed, 7 Feb 2001 14:35:26 -0500 MIME-Version: 1.0 X-Mailer: Internet Mail Service (5.5.2650.21) Content-Type: text/plain; charset="ISO-8859-1" X-Spam-Rating: h31.sny.collab.net 1.6.2 0/1000/N > -----Original Message----- > From: Christoph Wilhelms [mailto:Christoph.Wilhelms@tui.de] > Sent: Wednesday, February 07, 2001 12:46 PM > To: ant-dev@jakarta.apache.org > Subject: AW: New manual organization - printing is sometimes useful > > > Hi Ken > > >I would agree with this. I really don't like reading long documents > >on a computer screen. Electronic versions are pretty useful for > >searching. > > I do not agree! In Conors version it is no "large document" > anymore, but > many small-ones and thats the point: Why do I want to have > everything in one > pice, just for printing? When you read a book, you can only > read ONE page at > a time ;-)! Just to clarify my earlier statements -- I think it's definitely nice to have smaller files (I think I suggested it earlier in the week), especially with frames navigation. Makes it easier to navigate the documentation when using a browser. However, when I have a long document or large documentation set to read it's nice to be able to print it out to read offline. Nothing like curling up under a blanket and reading a programmer's manual :) (Plus, I like to highlight stuff). Some of us have fast, high-capacity printers at work and don't mind printing out 100 page manuals. When I was an Ant newbie I printed out the whole manual and read it straight through, to get a feel for what all the tasks were and what they did. I feel like others might want to do the same, and that there should be some easy way to print the entire documentation set. That doesn't necessarily mean that there should be one large index.html. > printable version would be nice - but just nice and an addition. Agreed. Given a choice I would prefer the documentation be complete and understandable rather than printable.