Printable Documentation

[Colin D Bennett]

On Sun, 11 Jan 2009 22:07:17 +0900
David Muir <david at davidkmuir.com> wrote:

> A4 would be a bit more international friendly...

No argument there!  I totally agree.  'Letter' is just my automatic
choice right now since ISO sizes are not available locally in the US.
Perhaps if I start using A4 paper myself for academic and professional
work, I can start a trend...

I'm looking at making the images render properly in LaTeX, and if I get
that to work, I'll render for A4 size.

> Printable docs is a great idea. Something like the SVN book would be 
> great. I find it really frustrating having to constantly flip between 
> the user reference and the user guide. Especially when the guide has 
> info about commands that is missing in the reference... But that's a 
> gripe for another day...

Perhaps there should be some re-organization of these documents, then,
so that the information that is most commonly needed is in one place.

Regards,
Colin


> David
> >
> > On Sat, 10 Jan 2009 21:56:38 -0800
> > Colin D Bennett <colin at gibibit.com> wrote:
> >
> >   
> >> On Sat, 10 Jan 2009 19:28:56 -0600
> >> "Richard Fleming" <rfleming at acqusys.com> wrote:
> >>
> >>     
> >>> Hello,
> >>>
> >>> I know that the user documentation is available on the website,
> >>> however I was wondering if there was a "clean to print" version,
> >>> like a PDF or Postscript?
> >>>       
> >> Since the documentation is in reStructuredText format, it can be
> >> rendered to nearly any format, including LaTeX and
> >> OpenOffice-compatible ODT format.
> >>
> >> I rendered the User Guide to PDF on US Letter size paper using
> >> 'rst2pdf.py'. You can find the PDF at
> >> <http://gibibit.com/upload/bzr-user-guide-r3933.en.pdf>.
> >>
> >> If you want to render it yourself, you need docutils and LaTeX
> >> installed, then get and run 'rst2pdf.py' from
> >> <http://svn.berlios.de/viewcvs/docutils/trunk/sandbox/rst2pdf/rst2pdf.py>.
> >>     
> >
> > Ok, clearly the images didn't work too well in that.  For instance,
> > page 8.  They are waaaaaay huge.  I'll take a look at that in the
> > morning.
> >
> > Cheers,
> > Colin
> >   
> 
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 197 bytes
Desc: not available
Url : https://lists.ubuntu.com/archives/bazaar/attachments/20090111/2bbfb889/attachment.pgp