News for hackers. Stuff that matters.
Re:Vim PDF Documentation by DrinkWater on Wednesday September 25, 2013 @09:35AM (#6444439)
It's helpful, and also a clever pun: there is not a lot of software that can claim a help document of a approx. 2600 pages. very correlated to the steep learning curve of vim.

I fucking like it :)

Re:Vim PDF Documentation by keithpeter on Wednesday September 25, 2013 @10:34AM (#6444787)
2567 A4 pages in my PDF viewer. Quite neat.

Honest question: why PDF? From within Vim one uses :help and the internal hyperlinks. What do people here think the value added of the PDF is? I won't be printing it!

Re:Vim PDF Documentation by Walkman on Wednesday September 25, 2013 @10:53AM (#6444924)
> why PDF?

I wanted to ask the exact question. Nobody sits down and read it from the beginning, and without links, there is no point of a PDF.

Re:Vim PDF Documentation by steveklabnik on Wednesday September 25, 2013 @11:56AM (#6445337)
PDFs have links, including this one!

> The files are fully cross referenced using interal hyperlinks

Re:Vim PDF Documentation by mheathr on Wednesday September 25, 2013 @02:07PM (#6446235)
I have read it from the beginning, and the individuals who maintain the documentation likely have as well.

What format supports interpage linking, can be displayed both electronically and is print quality, and can be read on virtually every platform?

The only print quality formats are postscript or PDF and from that only PDFs can be viewed electronically as well being print ready.

So, there does not exist a solution that is not PDF in this case, especially if other attributes are desired such as the readers not requiring a costly license to use.

I am not incredibly happy with that being the case, but there are open source readers and exporters for (most) PDFs nowadays so it is more or less a non-issue.

Re:Vim PDF Documentation by pasbesoin on Wednesday September 25, 2013 @04:03PM (#6446938)
I didn't even read the entire blog post yet, but he says right at the start that a primary motivation was wanting to be able to read through it while using his iPad.

Makes sense to me. I enjoy and find useful reading technical documentation while not sitting at a computer. Sometimes, it almost seems most productive when I read a few pages, drift off into a 10 minute nap, and then resume. Things then seem to stick better in my long term memory. (Meaning, when I'm in pure "assimilation" mode as opposed to actively working with/on/using the topic, which is also a great aid to remembering.)