Game Development Community

Argh, the evil pdf format

by Jeremy Read · in Torque Game Builder · 03/12/2005 (11:11 pm) · 6 replies

Is there any chance we could also have the basic documentation in a html file? Why?

Well whenever I try and copy from the pdf tutorial it decides to not copy the line breaks. Giving me a wonderful long line of code to break up.

About the author

Recent Threads


#1
03/13/2005 (1:58 am)
Yeah, that was just the initial "out of the door" documentation for the very first release. I can promise you that the documentation will be in a much nicer format.

This is not an excuse but we're a little raw at the moment with the packaging simply because we are at EA.

Early days. :)

- Melv.
#2
03/13/2005 (6:02 am)
I concur with Robert.. PDF is a pretty great format. Plus, typing out your code is going to help you understand what you're doing, and it'll help you when you apply it in the future!
#3
03/13/2005 (12:47 pm)
.pdf is pretty nearly a world wide standard. It is free, there are a ton of readers, it prints nicely. If we had only included HTML, we would of had complaints because it was hard to print.
#4
03/13/2005 (2:54 pm)
I prefer PDF's for the documentation with the wide-variety of printers and drivers between OS's. Of course, I'm a huge supporter of typing code anytime one is learning. It provides a three-part cognitive process. You read it, your process it, you regurgitate it. Of course, if you simply sight-type it, you'll lost the processing step since you're replicating a teletype machine (which is only slightly better than copy-pasting it as you still have to initially scan it for replication).
#5
03/13/2005 (10:54 pm)
Perhaps I need to put the "also" in bold. PDF is somewhat easier to print than html (depending on your system). However there are also a lot of times when copy/paste is an awful lot quicker retyping it out. I'd be really annoyed if the J5SE SDK help was only in pdf format. Considering how often I have to do searches of directories full of docs (which aren't nearly as easy as to do in pdf format) and as of yet it's quite hard to intergrate pdf documentation into most IDEs.
#6
03/14/2005 (1:45 am)
About page brakes... I had the same issue with apples defult pdf viewer applicaton. However, after switching to abobes viewer it workes like a charm. I would suggest you look at other pdf viewers to see if they help with your problem (sory I don't know any for the pc)

I personly like pdfs because I can zoom in, do fast searches, book marks, notes and the ability to print out good looking documents on the fly.