RE: [boost] printing documentation on A4

From: Paul A. Bristow (boost_at_[hidden])
Date: 2002-10-17 08:02:27

I can't pull an example from Boost docs to mind immediately (though I recall
that I had some trouble with the Test library, perhaps for more complex reasons)

but you are right that it is tables that often cause trouble.

A recent non-Boost example is reading the Sun info on floating point

http://docs.sun.com/source/806-3568/ncg_math.html

where the crucial table of floating point numbers would not print - I had to
ferret in the html source and cut and paste into my favorite text editor.

Of US-authored web pages in general, I would say that about a third fail to
print correctly.  Boost is very much better than most because it Keeps It Simple
Sirs.

But I surmise that a small amount of guidance to authors would achieve
perfection.
Sadly I am not expert enough to know what it is :-(

Paul

> -----Original Message-----
> From: boost-bounces_at_[hidden]
> [mailto:boost-bounces_at_[hidden]]On Behalf Of Victor A. Wagner, Jr.
> Sent: Wednesday, October 16, 2002 6:49 PM
> To: Boost mailing list
> Subject: RE: [boost] printing documentation on A4
>
>
> gee, you wouldn't think that 0.23" would make that much difference.
>
> Paul, have you an example of such a page or so?
>
> At Tuesday 2002/10/15 14:24, you wrote:
> >At 07:28 AM 10/15/2002, Paul A. Bristow wrote:
> >
> > >> Yes. I think it should be part of the boost requirements. A bain
> > >> of mine is the number of boost document pages that won't print
> > >> on A4 paper because <pre> code is too long.
> > >
> > >This is a serious nuisance for International Standard Paper users!
> > >
> > >Please can the Boost documentation guide document how to avoid this please.
> > >I am sure that many authors are oblivous to the nuisance that this causes.
> >
> >Can you suggest wording?
> >
> >Thanks,
> >
> >--Beman
> >
> >
> >_______________________________________________
> >Unsubscribe & other changes:
> http://lists.boost.org/mailman/listinfo.cgi/boost
> >
>
> Victor A. Wagner Jr.      http://rudbek.com
> PGP RSA fingerprint = 4D20 EBF6 0101 B069 3817 8DBF C846 E47A
> PGP D-H fingerprint = 98BC 65E3 1A19 43EC 3908 65B9 F755 E6F4 63BB 9D93
> The five most dangerous words in the English language:
>                "There oughta be a law"
>
> _______________________________________________
> Unsubscribe & other changes: http://lists.boost.org/mailman/listinfo.cgi/boost
>